Installation

Note

As soon as we get this thing into a reasonable shape, we will publish it on PyPI and you will be able to install it with pip. In the meantime, go ahead and follow the instructions below.

Pre-requisites

f you are installing aptapy from PyPI using pip, you do not particularly care about pre-requisites, as pip will take care of installing any required dependency automatically. In any event, here is the relevant portion of the pyproject.toml file listing the required dependencies:

dependencies = [
    "matplotlib",
    "numpy",
    "scipy",
    "uncertainties",
  ]

[project.optional-dependencies]
web = [
    "panel",
    "bokeh",
  ]
dev = [
    "packaging",
    "pytest",
    "ruff",
    "pylint",
    "nox",
  ]
docs = [
    "sphinx",
    "sphinxawesome-theme",
    "sphinx-gallery",
    "sphinxcontrib-programoutput",
  ]

Note

We do test aptapy on Python 3.7 and later in our continuous integration. We cannot exclude that the thing might work on earlier versions of Python, but if your Python predates 3.7, you should definitely consider upgrading—aptapy is probably not your biggest problem in this case.

Editable Installation

If you plan on contributing to the development of aptapy, or just want to explore the codebase, you may want to install it in “editable” mode. To do so, first clone the repository from GitHub:

git clone ssh://git@codeberg.org/physics-labs-unipi/physlab-hub.git

and then do a pip editable install from within the repository directory:

cd physlab-hub
pip install -e .[web,dev,docs]

(Invoking pip with the -e command-line switch will place a special link in the proper folder pointing back to your local version of the source files—instead of copying the source tree—so that you will always see the last version of the code as you modify it, e.g., in the local copy of your git repository.)