This page contains instructions for installing the required software on your computer. Please make sure before the course that you have all the required software installed or some other way access to it. For example, the workshop could be done with a remote Jupyter server, as long as you can use the terminal from the Jupyter (you need to be able to access the command line for some lessons).
If you need installation help, show this page to someone around you and they can probably do all you need
Generic list of tools required
Note: The actual installation instructions are below. This is a generic description which will help those who already understand all of the tools.
Python 3 (Anaconda is recommended, it will include everything)
With some extra packages installed. They are all included in Aanconda, and are listed in the
environment.ymlfile you can find under miniconda below.
Text editor (several lessons, can also be done through Jupyterlab)
Command-line shell (several lessons, can also be done through Jupyterlab)
git (not needed, this lesson is usually done as a demo)
Generic instructions with miniconda and an environment file (advanced)
This is the advanced, minimal method of installing the Python packages. For most people, we recommend Anaconda (below). You will actually learn about miniconda during the workshop. This doesn’t provide the graphical Anaconda navigator, so you’ll need to activate the miniconda environment using the command line.
You can read how to install miniconda from the CodeRefinery installation instructions.
Then this environment file contains all packages needed, and can be installed with:
$ conda env create -f https://raw.githubusercontent.com/AaltoSciComp/python-for-scicomp/master/software/environment.yml
Each time you start a new shell, you need to activate miniconda (if
you don’t do run
conda init), and then you need to activate the
proper environment with
conda activate python-for-scicomp.
We might have missed some packages, though, which can be later
We expect you to have a working Python installation with some common libraries. We recommend that you install the Anaconda python distribution. The Anaconda Navigator provides a convenient way to access the software.
We recommend Anaconda, Anaconda Navigator, and JupyterLab in these instructions because it is simple and can be used by everyone. As you advance in your career, we recommend that you explore other options as well, but that can come later.
Any other Python distribution which you can install libraries into would work, but because there are so many different ways to do this, we don’t support them. You would need the extra libraries mentioned in the Miniconda instructions above.
We do most of the lessons from JupyterLab (and JupyterLab provides most of the other tools we need). If you install the full Anaconda distribution, this will be available and can be started either through Anaconda Navigator or command line.
Verification of Python and JupyterLab
Watch the video
See this verification in video form - if you can do this, you are ready to go for day one. Your exact steps may be a bit different.
You should be able to start JupyterLab. You can do this from the Anaconda Navigator (recommended if you have it):
… or you can start JupyterLab from the command line:
$ jupyter-lab (... Jupyter starts in a web browser)
Verify that you can start a Jupyter notebook. We will learn how to
do this in day 1, but you can try running
if you want.
For one portion of the course, you will need a text editor. If you don’t know what to use, you can use the text editor that comes from JupyterLab and it will do everything you need - no extra installation needed.
Because we need to be simple in our teaching, we only teach the most basic editors. We encourage you to try out more advanced ones yourself.
For other editors, see the CodeRefinery instructions. You don’t exactly need a terminal editor - the graphical ones, such as VSCode or whatever you use now, will work as well.
You need access to the command line for some lessons. JupyterLab includes it, so no extra installation is needed. If you want to test in advance:
You can start it from JupyterLab (recommended):
Other ways to access the command line
From the Anaconda Navigator:
From your operating system’s terminal applications, if you activate Anaconda.
Verification of the command line
To verify command line usage, type the following commands (without the
$), and you should see the corresponding output that lists the
$ python -V Python 3.8.3 ## Or python3... $ python3 -V Python 3.8.3
Any version of Python 3 through a recent Anaconda should work for the course.
If this is an online workshop, it might use Zoom. You can see CodeRefinery instructions for it.
If you have access, come to one of the installation help sessions. Or, ask your colleagues: these are standard tools and you can definitely find someone can help you get set up!