From 383978e71b5e3743afe6f90cddfafafe5c401d98 Mon Sep 17 00:00:00 2001 From: Bill Ladwig Date: Fri, 28 Apr 2017 11:35:07 -0600 Subject: [PATCH] Added yellowstone installation instructions to documentation --- doc/source/installation.rst | 38 +++++++++++++++++++++++++++++++++---- 1 file changed, 34 insertions(+), 4 deletions(-) diff --git a/doc/source/installation.rst b/doc/source/installation.rst index 7967251..15b0cc4 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -32,12 +32,42 @@ Installing via Conda The easiest way to install wrf-python is using `Conda `_:: - $ conda install -c conda-forge wrf-python + conda install -c conda-forge wrf-python -While some bugs are currently being ironed out with the conda-forge -installation, wrf-python is also available at:: +.. note:: + + If you use conda to install wrf-python on a supercomputer like + Yellowstone or Cheyenne, we recommend that you do not load any python + related modules via the 'module load' command. The packages installed + by the 'module load' system will not play nicely with packages installed + via conda. + + Further, some systems will install python packages to a ~/.local directory, + which will be found by the miniconda python interpreter and cause various + import problems. If you have a ~/.local directory, we strongly suggest + renaming it (mv ~/.local ~/.local_backup). + + +Installing on Yellowstone +---------------------------- + +On Yellowstone, wrf-python can also be installed using the module load system, +if this is preferred over using conda. + +Unfortunately, because wrf-python requires newer dependencies, it is not +available using the 'all-python-libs' module, so many of the dependencies +need to be manually installed (most are for xarray). + +Also, make sure you are running in the gnu/4.8.2 compiler environment or +you will get import errors for a missing libquadmath library when you +go to import wrf-python. + +To install:: - $ conda install -c bladwig wrf-python + module load gnu/4.8.2 or module swap intel gnu/4.8.2 + module load python/2.7.7 + module load numpy/1.11.0 wrapt/1.10.10 scipy/0.17.1 bottleneck/1.1.0 numexpr/2.6.0 pyside/1.1.2 matplotlib/1.5.1 pandas/0.18.1 netcdf4python/1.2.4 xarray/0.8.2 + module load wrf-python/1.0.1 Installing via Source Code