Installation

We recommend using a virtual environment to keep your dependencies isolated. We strongly suggest installing pyCO2 in a Conda Environment.

Step 1: Installing Anaconda

First, install Anaconda for your OS.

Step 2: Installing PyCO2stats

To create a new environment in the anaconda prompt write and run, row by row:

conda create -n pyco2env python=3.10
conda activate pyco2env

Now, there are two recommended ways to install pyco2stats: via the Python Package Index (PyPI) or directly from the source repository on GitHub.

Step 2.1: Installing from PyPi

The easiest way to install the latest stable release of pyco2stats is the following. In the anaconda or command prompt write and run:

pip install pyco2stats

This will also install all required dependencies (NumPy, SciPy, pandas, matplotlib, plotly, etc.).

Step 2.2: Installing from source

If you want the latest development version, in the anaconda or command prompt write and run:

pip install git+https://github.com/AIVolcanoLab/pyco2stats.git

Alternatively, clone the repository manually and install in editable mode. In the anaconda or command prompt write and run, row by row:

git clone https://github.com/AIVolcanoLab/pyco2stats.git
cd pyco2stats
pip install -e .

This setup allows you to track changes to the source code without reinstalling.

Troubleshooting

Upgrade pip, setuptools, and wheel to avoid most build issues:

pip install --upgrade pip setuptools wheel