File: installation.rst

package info (click to toggle)
python-rioxarray 0.19.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 7,304 kB
  • sloc: python: 7,893; makefile: 93
file content (62 lines) | stat: -rw-r--r-- 1,625 bytes parent folder | download | duplicates (3)
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
.. highlight:: shell

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


Stable release
--------------

1. Use pip to install package from `PyPI <https://pypi.org/project/rioxarray/>`__:

  .. code-block:: bash

      pip install rioxarray


2. Use `conda <https://conda.io/en/latest/>`__ with the `conda-forge <https://conda-forge.org/>`__ channel:

  .. code-block:: bash

      conda config --prepend channels conda-forge
      conda config --set channel_priority strict
      conda create -n rioxarray_env rioxarray
      conda activate rioxarray_env

  - `rioxarray` `conda-forge repository <http://github.com/conda-forge/rioxarray-feedstock>`__

  .. note::
      "... we recommend always installing your packages inside a
      new environment instead of the base environment from
      anaconda/miniconda. Using envs make it easier to
      debug problems with packages and ensure the stability
      of your root env."
        -- https://conda-forge.org/docs/user/tipsandtricks.html

  .. warning::
      Avoid using `pip install` with a conda environment. If you encounter
      a python package that isn't in conda-forge, consider submitting a
      recipe: https://github.com/conda-forge/staged-recipes/


From source
-----------

The source for rioxarray can be installed from the `GitHub repo`_.

.. code-block:: bash

    python -m pip install git+git://github.com/corteva/rioxarray.git#egg=rioxarray


To install for local development:

.. code-block:: bash

    git clone git@github.com:corteva/rioxarray.git
    cd rioxarray
    python -m pip install -e .[dev]


.. _GitHub repo: https://github.com/corteva/rioxarray