PYTHEOS

Installation

This section describes how to download pytheos from GitHub and install it using conda. The procedure is suitable for macOS and Linux.

1. Clone the GitHub repository

Clone the repository and enter the source directory:

git clone https://github.com/SHDShim/pytheos.git
cd pytheos

2. Create a dedicated conda environment

Create a clean conda environment to avoid dependency conflicts:

conda create -n pytheos python=3.11 -y
conda activate pytheos

Python version 3.9 or newer is recommended.

3. Install core dependencies

Install numerical and scientific dependencies from conda-forge:

conda install -c conda-forge numpy scipy matplotlib sympy pandas jupyter -y

If you plan to run the example notebooks, also install Jupyter support:

conda install -c conda-forge ipykernel nbconvert -y
python -m ipykernel install --user --name pytheos

4. Install pytheos

From the repository root (where setup.py or pyproject.toml is located), install pytheos:

pip install .

Verify the installation:

python - <<EOF
import pytheos
print(pytheos.__version__)
EOF

5. Test the installation

Run a simple test to confirm that core functionality works:

python - <<EOF
from pytheos import bm3_p, vinet_p
print(bm3_p(10.0, 160.0, 4.0, 4.0))
print(vinet_p(10.0, 160.0, 4.0))
EOF

6. Updating pytheos

To update pytheos to the latest version from GitHub:

cd pytheos
git pull origin master
pip install .

7. Clean removal

To completely remove pytheos and its conda environment:

conda deactivate
conda remove -n pytheos --all