@@ -24,9 +24,11 @@ Limitations:
24
24
Installation
25
25
============
26
26
27
- **From version 2.37.0, the ecCodes Python bindings additionally provide the ecCodes binary library, and will
27
+ **From version 2.37.0, the ecCodes Python bindings on PyPi additionally provide the ecCodes binary library, and will
28
28
follow the version numbering of the ecCodes binary library. See below for details. **
29
29
30
+ Installation from PyPI
31
+ ----------------------
30
32
31
33
The package can be installed from PyPI with::
32
34
@@ -40,30 +42,37 @@ set the following environment variable before you import eccodes::
40
42
41
43
If this is set, the ecCodes' Python bindings will use the `findlibs <https://github.com/ecmwf/findlibs >`_ package
42
44
to locate the binary library (findlibs was the only mechanism used before version 2.37.0).
43
-
44
- In order to gain insights into the search for the binary library, set the following environment variable before
45
- importing eccodes::
46
-
47
- $ export ECCODES_PYTHON_TRACE_LIB_SEARCH=1
48
45
49
46
You may also install a version of ecCodes' Python interface that does not include a binary library at all,
50
47
in which case the findlibs mechanism will be used as before::
51
48
52
49
$ pip install eccodes --no-binary eccodes
53
50
51
+ See also 'Debugging the library search', below.
52
+
53
+
54
+ Installation from conda
55
+ -----------------------
56
+
57
+ ecCodes' Python bindings can be installed from the `conda-forge <https://conda-forge.org/ >`_ channel with::
58
+
59
+ $ conda install -c conda-forge python-eccodes
60
+
61
+ This will install the Python bindings (`python-eccodes `) and also the ecCodes binary library (`eccodes `) on which they depend.
62
+
54
63
55
64
System dependencies
56
65
-------------------
57
66
58
- The Python module depends on the ECMWF *ecCodes * library. From version 2.37.0, this is supplied with
59
- the Python module. If you wish to install and use a separate binary library (see above), it
60
- must be installed on the system and accessible as a shared library.
67
+ The Python module depends on the ECMWF *ecCodes * binary library. From version 2.37.0, this library is supplied with
68
+ the Python module on both PyPi and conda, as described above . If you wish to install and use a separate binary library
69
+ (see above), it must be installed on the system and accessible as a shared library.
61
70
62
71
On a MacOS with HomeBrew use::
63
72
64
73
$ brew install eccodes
65
74
66
- Or if you manage binary packages with *Conda * use::
75
+ Or if you manage binary packages with *Conda * but use Python bindings from elsewhere, use::
67
76
68
77
$ conda install -c conda-forge eccodes
69
78
@@ -78,6 +87,15 @@ You may run a simple selfcheck command to ensure that your system is set up corr
78
87
Your system is ready.
79
88
80
89
90
+ Debugging the library search
91
+ ----------------------------
92
+
93
+ In order to gain insights into the search for the binary library, set the following environment variable before
94
+ importing eccodes::
95
+
96
+ $ export ECCODES_PYTHON_TRACE_LIB_SEARCH=1
97
+
98
+
81
99
Usage
82
100
-----
83
101
0 commit comments