2. Installing

The code has been tested with the March 2019 release of Python:

The packages listed below are required to run ASteCA.

The code also uses the packages:

but these two are included in the ASteCA download.

2.1. Working environment

We use the conda package and environment manager to install all the necessary dependencies to run ASteCA in an isolated Python environment. To install it:

  1. Go to https://conda.io/miniconda.html and download the appropriate version for your system. I recommend using the Python 3.x version and will assume in what follows that you are running a 64 bit Linux system.

  2. Install with

    $ bash Miniconda3-latest-Linux-x86_64.sh
    

    Select yes when asked: Do you whish the installer to prepend the Miniconda3 install location to PATH in your ~/path?

  3. Close and re-open your terminal window for the changes to take effect. Move inside the directory where you extracted the ASteCA package.

  4. Create a virtual environment with

    $ conda create --name asteca python=3.7.3 matplotlib=3.1.0 numpy=1.16.14 scipy=1.2.1 astropy=3.1.2
    
  5. Activate the environment

    $ conda activate asteca
    

    (for Windows users the command is $ activate asteca)

    Important

    You can tell that the environment is activated because its name is now shown in the terminal before the $ symbol as:

    (asteca) $
    

    You need to activate this environment each time before attempting to run ASteCA, otherwise no installed packages will be detected.

2.2. Download

The latest packaged release (zip or tarball) can be downloaded from Github. After downloading, extract the compressed file wherever you want the code to exist. Alternatively the entire project can be cloned via git with (Linux command):

$ git clone https://github.com/asteca/ASteCA.git

which will create a sub-folder named /ASteCA.

2.3. Running

With the environment properly created (and activated) and the code downloaded, you can run ASteCA with:

(asteca) $ python asteca.py