INSTALL.rst

Installation Instructions

Here's a minimal set of instructions to get up and running with the PLAsTiCC starter kit.

0. Install python:

We recommend using the anaconda python distribution to run this package. If you don't have it already, follow the instructions here

Make sure you added the conda/bin dir to your path!

1. Get the code:

Clone this repository

git clone https://github.com/LSSTDESC/plasticc-kit.git
cd plasticc-kit/

2. Install everything:

1. Create a new environment from the YAML specification

   conda env create -f conda_env_py36_[osx64|i686].yml

or

2. Create a new environment from scratch and let pip figure out dependencies and you sort out potential issues

   conda create -n plasticc
   source activate plasticc
   [pip install six] # you might need this if you get errors about six not being available
   pip install -r requirements.txt

3. Run the notebooks:

Start the notebook

jupyter notebook plasticc_astro_starter_kit.ipynb

4. Troubleshooting:

If you still get errors about missing packages when you run the notebook

• make sure you executed the source activate plasticc command in step 2.
• check that jupyter is using the right kernel with the Kernel > Change Kernel menu item and selecting the one with plasticc in the name

If for some reason you can't find a kernel with plasticc in the name, then inside the plasticc environment:

1. install ipykernel and register the plasticc environment:

   conda install ipykernel
   python -m ipykernel install --user --name plasticc --display-name "Python (plasticc)"

or

2. install the nb_conda package and let conda manage integration with Jupyter

   source deactivate
   conda install nb_conda
   source activate plasticc