Install

Install Python

Before installing samplepackagename, ensure you have Python 3.11 or greater downloaded. If you don’t, we recommend setting up Python with Miniforge. See the install instructions here.

Install samplepackagename Locally

There are 3 main ways to install samplepackagename. We show them here in order of simplest to hardest.

Conda / Mamba

Note

conda and mamba are interchangeable

The easiest way to install this package and it’s dependencies is with conda or mamba into a new virtual environment:

mamba create --name samplepackagename --yes --force samplepackagename --channel conda-forge

Activate the environment:

mamba activate samplepackagename

Pip

Instead, you can use pip to install samplepackagename, but first you maybe need to install a few dependencies first with conda. This is because a few dependencies rely on C packages, which can only be install with conda/mamba and not with pip.

Create a new virtual environment:

mamba create --name samplepackagename --yes --force <<add conda packages here>> --channel conda-forge

activate the environment and use pip to install samplepackagename:

conda activate samplepackagename
pip install samplepackagename

Note

to install the optional dependencies, use this instead: pip install samplepackagename[all]

Development version

You can use pip, with the above created environment, to install the latest source from GitHub:

pip install git+https://github.com/organizationname/samplepackagename.git

Or you can clone the git repository and install:

git clone https://github.com/organizationname/samplepackagename.git
cd samplepackagename
pip install .

Test your install

Run the following inside a Python interpreter:

import samplepackagename

samplepackagename.__version__

This should tell you which version was installed.

To further test, you can clone the GitHub repository and run the suite of tests, see the Contributors Guide.

A simpler method to ensure the basics are working would be to download any of the jupyter notebooks from the documentation and run them locally. On the documentation, each of the examples should have a drop down button in the top right corner to download the .ipynb.