Installation and Setup

Installing the package

ACID_v2 has been tested in Python 3.13 and 3.14, running fastest on 3.14. It is recommended to install ACID in a new conda environment to avoid dependency conflicts.

In this example we create an environment named ‘acid’ and activate it using:

conda create -n acid python=3.14
conda activate acid

Once the environment has been activated ACID can be installed using pip:

pip install ACID_code_v2

This will install ACID into your environment with all of its dependencies.

Cloning the repository

In order to use the example data (for the tutorials) or the test suite, ACID will need to be installed from the source (i.e. directly from the GitHub repository). This can be done by cloning the source repository. All examples and tests attempt first to import from your pip installation. If this fails they will attempt to import from the local source directory instead.

git clone https://github.com/Benjamin-Cadell/ACID_v2.git
cd ACID_v2

Testing the installation

Test your installation by running our test file in the test directory. This may take a while (~1-2 min) but should run without any errors if the installation has gone smoothly. The test file will attempt to run all of the methods and functions in ACID. If any of these fail and you believe that this is due to the source code and not your installation, please raise an issue on GitHub.

conda install pytest
python tests/tests.py