Switching from version 1 (PyPopStar) to version 2 (SPISEA)

Version 1 of this software package was called PyPopStar. Due to a naming conflict, we have renamed the package of SPISEA for version 2 and beyond. For reference, v2.0.0 has the same functionality as v1.0.1. If you already downloaded v1.0.0 or v1.0.1, the steps required to upgrade to v2.0.0 are described below.

Step 1: Get Updated Package from Github

To get the updated package from Github, you need to pull down the updated code respository. In your PyPopStar directory, run the following command from the terminal:

git pull

The correct branch to be on is “main”. You can check which branch you are on by running git status in the terminal. If necessary, you can change to the main branch by:

git checkout main

Step 2: Make Sure PYTHONPATH Points to Top-Level Directory

Make sure your PYTHONPATH points to the top-level SPISEA directory. This is the directory that contains the spisea sub-directory with all of the code files (e.g. synthetic.py, evolution.py, etc). Note that the top-level directory might still be named “PyPopStar”, as a left-over when you cloned version 1 of the repository. You can manually change this to “SPISEA”, but make sure that change gets reflected in your PYTHONPATH.

Step 3: Change Environment Variable Name

Update the name of the environment variable POPSTAR_MODELS to the new name SPISEA_MODELS. If you are using bash, this line in your .bash_profile would be:

export SPISEA_MODELS=/<path_to_models_directory>

Step 4: Test the Package to Make Sure It Is Working

To make sure everything is working, go through the instructions on Testing Your SPISEA Setup.

Step 5: Change Import Statements in Subsequent Code

In all code that calls SPISEA functions (e.g. synthetic.py), you will need to change the import statements from:

from popstar import synthetic

to::

from spisea import synthetic