Installation

ACBICI is provided as a python package with documentation. Before installing ACBICI, you need to install make, git and one of the tested Python versions (3.9, 3.12, 3.13, 3.14). As of time of this document (jan 2026), ACBICI has been tested with the latter Python versions.

To run ACBICI, the program makes use of existing python packages, all of them freely available. The file requirements.txt collects all the necessary modules which are installed automatically with the package. To install ACBICI simply clone or download the repository and then install it via the following commands:

If using Python for other purposes than ACBICI, it is recommended to use a virtual environment, you can create one for example via: - python3 -m venv acbici_env or: - virtualenv acbici_env Then activate the virtual environment by: - source acbici_env/bin/activate

Upgrade packaging tools (recommended): pip install –upgrade pip setuptools wheel

or with Anaconda (Windows) in the Anaconda prompt to create a virtual environment: - conda create -n myenv python=3.14 Then to activate it: - conda activate myenv

Next you can install ACBICI in this virtual environment: Either: Go to the folder where you want to install it via: cd “installation_directory” Clone and install the repo into that folder in the following way: - git clone https://gitlab.com/schenkch/ACBICI.git - cd ACBICI - pip install -e . Or: Install as an already built pip package via: pip install ACBICI (pending)

In addition to the source code, ACBICI is distributed with html documentation that is also published on readthedocs at https://acbici.readthedocs.io/. This documentation provides information regarding the theory behind the calibration and also describes the examples in detail. Alternatively to the readthedocs link, the complete documentation can be generated by running the command make html inside the directory docs as described in the ReadmeDoc file inside the docs folder.