Install instructions#

We generally recommend creating a conda environment to isolate any code from other dependencies. The ISLP package does not have unusual dependencies, but this is still good practice.

Mac OS X / Linux#

To create a conda environment in a Mac OS X or Linux environment run:

conda create --name islp

To run python code in this environment, you must activate it:

conda activate islp

Windows#

On windows, create a Python environment called islp in the Anaconda app. This can be done by selecting Environments on the left hand side of the app’s screen. After creating the environment, open a terminal within that environment by clicking on the “Play” button.

Installing ISLP#

Having completed the steps above, we use pip to install the ISLP package:

pip install ISLP

Frozen environment#

Attention

Python packages change frequently. The labs here are built with specific versions of the various packages.

To ensure you have the same package versions as those built here, run:

pip install -r https://raw.githubusercontent.com/intro-stat-learning/ISLP_labs/v2/requirements.txt

For more specific install instructions go to ISLP_labs.

Torch requirements#

The ISLP labs use torch and various related packages for the lab on deep learning. Most of the requirements are included in the requirements for ISLP though the labs also use torchinfo and torchvision. These will be installed by the requirements.txt above.

Attention

Because torch and related libraries change frequently, you will note that we have pinned the versions at specific versions that were used to make current verisons of the labs.

Jupyter#

Mac OS X#

If JupyterLab is not already installed, run the following after having activated your islp environment:

pip install jupyterlab

Windows#

Either use the same pip command above or install JupyterLab from the Home tab. Ensure that the environment is your islp environment. This information appears near the top left in the Anaconda Home page.

Google Colab#

The notebooks for the labs can be run in Google Colab with a few caveats:

  • Labs that use files in the filesystem will require one to mount your Google Drive. See help

  • The packages will have to be reinstalled each time a new runtime is started. For most labs, inserting pip install ISLP at the top of the notebook will suffice, though Colab will ask you to restart after installation.