Installing circHiC¶

There are different ways to install circhic:

Install the latest official release. This is the best approach for most users and will provide a stable version.
Building the package from source. This is best for users who want the latest-and-greatest features and aren’t afraid of running brand-new code. This is also needed for users who wish to contribute to the project.

Install the latest release¶

Install a version of Python 3, for instance from https://www.python.org.

Then run:

pip install -U circhic

In order to check your installation you can use:

python -m pip show circhic # to see which version and where circhic is installed
python -m pip freeze # to see all packages installed in the active environment.

Note that in order to avoid potential conflicts with other packages it is strongly recommended to use a virtual environment, e.g. python3 virtualenv or conda environments.

Building the package from source¶

Building from source is required to work on a contribution (bug fix, new feature, code or documentation improvement).

Use Git to check out the latest source from the circhic repository on Github.:
```
git clone git://github.com/tree-timc/circhic.git
cd circhic
```
If you plan on submitting a pull-request, you should clone from your fork instead.
Install the following dependencies if they are not already installed:
- Python (>= 3.7)
- NumPy (>= 1.16),
- SciPy (>= 0.19.1),
- Matplotlib (>= 3.0),
- pandas

Optional (but recommended): create and activate a dedicated virtualenv or conda environment.
Build the project with pip in Editable mode:
```
pip install --verbose --editable .
```
If you run the development version, it is cumbersome to reinstall the package each time you update the sources. Therefore it is recommended that you install in with the pip install –editable . command, which allows you to edit the code in-place. This builds the extension in place and creates a link to the development directory (see the pip docs).

This is fundamentally similar to using the command python setup.py develop (see the setuptool docs). It is however preferred to use pip.

On Unix-like systems, you can equivalently type make in from the top-level folder. Have a look at the Makefile for additional utilities.
Check that the installed circhic has a version number ending with .dev0:
```
python -c "import circhic; circhic.__version__"
```

Additional dependencies for building the documentation¶

In addition to the formentioned dependencies for circHiC, in order to build the documentation you will need:

sphinx (>= 1.0)
sphinx-gallery
numpydoc
pillow

These can be installed with pip using the command:

pip install -U sphinx sphinx-gallery numpydoc

Additional dependencies for running the tests¶

In addition to the formentioned dependencies for circHiC, in order to build the documentation you will need:

pytest
pytest-cov

These can be installed with pip using the following command:

pip install -U pytest pytest-cov