1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
.. _installation:
Installation
============
This section provides instructions on how to install and set up the Sigima project, including dependencies and environment configuration.
How to install
--------------
Sigima is available in several forms:
- As a :ref:`install_conda`.
- As a Python package, which can be installed using the :ref:`install_pip`.
- As a precompiled :ref:`install_wheel`, which can be installed using ``pip``.
- As a :ref:`install_source`, which can be installed using ``pip`` or manually.
.. seealso::
Impatient to try the next version of Sigima? You can also install the
latest development version of Sigima from the master branch of the
Git repository. See :ref:`install_development` for more information.
.. _install_conda:
Conda package
^^^^^^^^^^^^^
:octicon:`info;1em;sd-text-info` :bdg-info-line:`GNU/Linux` :bdg-info-line:`Windows` :bdg-info-line:`macOS`
To install ``sigima`` package from the `conda-forge` channel (https://anaconda.org/conda-forge/sigima), run the following command:
.. code-block:: console
$ conda install conda-forge::sigima
.. _install_pip:
Package manager ``pip``
^^^^^^^^^^^^^^^^^^^^^^^
:octicon:`info;1em;sd-text-info` :bdg-info-line:`GNU/Linux` :bdg-info-line:`Windows` :bdg-info-line:`macOS`
Sigima's package ``sigima`` is available on the Python Package Index (PyPI)
on the following URL: https://pypi.python.org/pypi/sigima.
Installing Sigima from PyPI is as simple as running this command
(you may need to use ``pip3`` instead of ``pip`` on some systems):
.. code-block:: console
$ pip install sigima
.. note::
If you already have a previous version of Sigima installed, you can
upgrade it by running the same command with the ``--upgrade`` option:
.. code-block:: console
$ pip install --upgrade sigima
.. _install_wheel:
Wheel package
^^^^^^^^^^^^^
:octicon:`info;1em;sd-text-info` :bdg-info-line:`GNU/Linux` :bdg-info-line:`Windows` :bdg-info-line:`macOS`
On any operating system, using pip and the Wheel package is the easiest way to
install sigima on an existing Python distribution:
.. code-block:: console
$ pip install --upgrade Sigima-0.3.0-py2.py3-none-any.whl
.. _install_source:
Source package
^^^^^^^^^^^^^^
:octicon:`info;1em;sd-text-info` :bdg-info-line:`GNU/Linux` :bdg-info-line:`Windows` :bdg-info-line:`macOS`
Installing Sigima directly from the source package may be done using ``pip``:
.. code-block:: console
$ pip install --upgrade sigima-0.3.0.tar.gz
Or, if you prefer, you can install it manually by running the following command
from the root directory of the source package:
.. code-block:: console
$ pip install --upgrade .
Finally, you can also build your own Wheel package and install it using ``pip``,
by running the following command from the root directory of the source package
(this requires the ``build`` and ``wheel`` packages to be installed):
.. code-block:: console
$ pip install build wheel # Install build and wheel packages (if needed)
$ python -m build # Build the wheel package
$ pip install --upgrade dist/sigima-0.3.0-py2.py3-none-any.whl # Install the wheel package
.. _install_development:
Development version
^^^^^^^^^^^^^^^^^^^
:octicon:`info;1em;sd-text-info` :bdg-info-line:`GNU/Linux` :bdg-info-line:`Windows` :bdg-info-line:`macOS`
If you want to try the latest development version of Sigima, you can install
it directly from the master branch of the Git repository.
The first time you install Sigima from the Git repository, enter the following
command:
.. code-block:: console
$ pip install git+https://github.com/DataLab-Platform/Sigima.git
Then, if at some point you want to upgrade to the latest version of Sigima,
just run the same command with options to force the reinstall of the package
without handling dependencies (because it would reinstall all dependencies):
.. code-block:: console
$ pip install --force-reinstall --no-deps git+https://github.com/DataLab-Platform/Sigima.git
.. note::
If dependencies have changed, you may need to execute the same command as above,
but without the ``--no-deps`` option.
Dependencies
------------
.. include:: ../requirements.rst
|
