Getting Started with Conda
This page outlines the fundamentals in using the
conda package manager.
Conda has its own cheat sheet available for download
Choosing a Conda Flavour
When using the conda package manager, you have two options to choose from:
Python 3.X version of the installer must be chosen. Python 2 has reached its End Of Life (EOL) and therefore we do not support it, and do not plan to.
The following table summarises the differences between available installers. We recommend you to choose what you feel most comfortable with.
Conda Package Manager
Bundled Packages [info]
Graphical User Interface
The Graphical User Interface (Anaconda Navigator) can be installed separately in Miniconda.
For students of Numerical Astrodynamics it is recommended that you install Anaconda.
Please see the Installation guide provided by the Anaconda documentation.
Command-line & GUI use
On Unix system (Linux and Mac), conda should be integrated with the terminal. On Windows, you can find
a program called
Anaconda Navigator and
Anaconda Prompt in the Windows search. The
Anaconda Prompt is
equivalent to the terminal use of
conda on Unix. Some Unix commands are made available in this prompt, although
most usage is equivalent to the Windows shell. On Unix you can start
Anaconda Navigator with the following command:
anaconda-navigator # base environment should be active
Verify Conda is Installed via
Create a new environment
Generally Python 3.7 is preferred when using the
conda create --name myenv python=3.7
Create an environment from an environment.yml file
An environment can be defined in an
environment.yml file as:
name: tudat-space channels: - conda-forge - tudat-team dependencies: # these are available on anaconda.org - tudatpy - matplotlib - pip # pip can be added as a dependency! - pip: # packages only available on PyPi can be added: - rtcat_sphinx_theme - sphinxcontrib-contentui
Create the environment from the
environment.ymlfile in the current directory:
conda env create -f environment.yml
Activate the environment (the name of the environment is defined on the first line of the
conda activate tudat-space
Verify the installation of the packages listed in
conda env list
Export an environment
Your current active environment can be exported into the current directory as follows:
conda env export > environment.yml
Delete an environment
The following command is not reversible unless the environment has been exported beforehand.
Remove the environment and all its packages:
conda remove --name myenv --all
Verify that the environment has been removed:
conda env list
Installling a package
Add the channel indexing the package (if required):
conda config --append channels tudat-team
Install the package:
conda install tudatpy
Alternatively, if you do not want to add a channel and potentially cause package conflicts, if available on multiple sources, you can isolate the channel for the package serach as follows:
(1&2). Install a package from a specific channel:
conda install tudatpy -c tudat-team