Installation
============

Prerequisites
-------------

* Python 3.10.7
* pip (modern version)

Installation
------------

Standard Installation
~~~~~~~~~~~~~~~~~~~~~

Dyn-Analysis is available from a dedicated package repository. You can install it using pip:

.. code:: bash

    pip install dyn-analysis


If you want to install the whole ``dyn`` suite, we recommend installing `dyn-all``:

.. code:: bash

    pip install dyn-all

Installation from Source
~~~~~~~~~~~~~~~~~~~~~~~~

For users who want to access the latest development version or contribute to the project, you can install directly from the source repository:

.. code:: bash

    # Clone the repository (SSH)
    git clone git@gitlab.com:decide.imt-atlantique/dyn/analysis.git

    # Or using HTTPS
    git clone https://gitlab.com/decide.imt-atlantique/dyn/analysis.git

    # Install in development mode
    pip install -e /path/to/analysis

Using Virtual Environments
~~~~~~~~~~~~~~~~~~~~~~~~~~

We recommend using virtual environments for installing Dyn-analysis to avoid conflicts with other packages.

Using `venv <https://docs.python.org/3/library/venv.html>`_:

.. code:: bash

    python -m venv dyn-env
    source dyn-env/bin/activate  # On Windows: dyn-env\Scripts\activate
    # Then install the package as described above

Using pyenv with `virtualenv <https://virtualenv.pypa.io/en/latest/>`_:

.. code:: bash

    pyenv install 3.10.7
    pyenv virtualenv 3.10.7 dyn-env
    pyenv local dyn-env
    # Then install the package as described above

Using `conda <https://docs.conda.io/en/latest/>`_:

.. code:: bash

    conda create -n dyn-env python=[3.10]
    conda activate dyn-env
    # Then install the package as described above

Troubleshooting
---------------

If you encounter issues during installation:

1. Ensure you're using a compatible Python version
2. Check that you have the necessary permissions to install packages
3. If behind a proxy, configure pip appropriately
4. For further assistance, please consult the troubleshoots document or create an issue on our GitLab repository