docs: install, index, config file updates
This commit is contained in:
Michael James
mjames-upc
parent
870df0651d
commit
9dd591a7cd
6 changed files with 43 additions and 245 deletions
|
|
@ -1,69 +1,69 @@
|
|||
|
||||
# MSLP and Precipitation
|
||||
## MSLP and Precipitation
|
||||
|
||||
|
||||
|
||||
# Sfc Temperature and Wind
|
||||
## Sfc Temperature and Wind
|
||||
|
||||
|
||||
|
||||
# Sfc Dewpoint Temperature
|
||||
## Sfc Dewpoint Temperature
|
||||
|
||||
|
||||
|
||||
# Sfc Relative Humidity
|
||||
## Sfc Relative Humidity
|
||||
|
||||
|
||||
|
||||
# 30mb Mean Dewpoint
|
||||
## 30mb Mean Dewpoint
|
||||
|
||||
|
||||
|
||||
# Precipitable Water
|
||||
## Precipitable Water
|
||||
|
||||
|
||||
|
||||
# Simulated Reflectivity (REFC)
|
||||
## Simulated Reflectivity (REFC)
|
||||
|
||||
|
||||
|
||||
# Lightning Threat
|
||||
## Lightning Threat
|
||||
|
||||
|
||||
# Precip Type / Moisture Transport
|
||||
## Precip Type / Moisture Transport
|
||||
|
||||
|
||||
|
||||
# Vorticity (500mb)
|
||||
## Vorticity (500mb)
|
||||
|
||||
|
||||
|
||||
# Vertical Velocity (500mb, 700mb, 850mb)
|
||||
## Vertical Velocity (500mb, 700mb, 850mb)
|
||||
|
||||
|
||||
|
||||
# Thickness / Vorticity Advection (Trenberth)
|
||||
## Thickness / Vorticity Advection (Trenberth)
|
||||
|
||||
|
||||
|
||||
# Wind / Height (850mb, 700mb, 500mb, 300mb, 250mb)
|
||||
## Wind / Height (850mb, 700mb, 500mb, 300mb, 250mb)
|
||||
|
||||
|
||||
|
||||
# Potential Vorticity (250mb)
|
||||
## Potential Vorticity (250mb)
|
||||
|
||||
# Helicity / Storm-Relative Flow
|
||||
## Helicity / Storm-Relative Flow
|
||||
|
||||
|
||||
# Hail Parameters
|
||||
## Hail Parameters
|
||||
|
||||
|
||||
|
||||
# MCS Parameters
|
||||
## MCS Parameters
|
||||
|
||||
|
||||
|
||||
# Isentopic Analysis (270K-320K)
|
||||
## Isentopic Analysis (270K-320K)
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,181 +0,0 @@
|
|||
A little known fact in the world of AWIPS(II) is just how dependent the system still is on NAWIPS-GEMPAK. The entire National Centers Perspective is dependent on pre-built shared object files for 64-bit Linux, which means that all of the D2D plugins which extend NSHARP (for bufr obs, NPP profiles, forecast models, etc.) also depend on these libraries.
|
||||
|
||||
This dependency has prevented use of the NSHARP plugin in the first release (15.1.1) of the [OS X CAVE client](https://www.unidata.ucar.edu/downloads/awips2/awips2-cave.dmg). These are the steps taken to build NSHARP and GEMPAK libraries for OS X AWIPS 16.2.2.
|
||||
|
||||
You will need the [https://github.com/Unidata/awips2-gemlibs](https://github.com/Unidata/awips2-gemlibs) repository on your Mac, as well as gcc and gfortran (from XCode). Pay attention to any version-specific include path or linked files, such as `/usr/local/Cellar/gcc/4.9.2_1/lib/gcc/4.9/`, always account for the correct versions and locations on your own system.
|
||||
|
||||
## NSHARP pre-built libraries
|
||||
|
||||
> libbignsharp.dylib
|
||||
|
||||
Using the script below, the NSHARP dynamic library is built from C and FORTRAN source files (and their required include files supplied by the `awips2-gemlibs` repository, and as linked against `$GEMINC`, meaning that GEMPAK for OS X must be built and installed).
|
||||
|
||||
git clone https://github.com/Unidata/awips2-gemlibs.git
|
||||
cd awips2-gemlibs/nsharp/
|
||||
|
||||
An optional step, which can be performed in a separate script or within the build script below, is to create *ld-style* *.a files in `$OS_LIB` which can then be referenced with `-l` flags (e.g. `-lgemlib`):
|
||||
|
||||
libs=(snlist sflist nxmlib gemlib gplt cgemlib rsl device xwp xw ps gn nsharp netcdf textlib)
|
||||
for file in ${libs[@]}
|
||||
do
|
||||
if [ ! -f $OS_LIB/lib$file.a ]; then
|
||||
echo "$OS_LIB/lib$file.a does not exist"
|
||||
if [ -f $OS_LIB/$file.a ]; then
|
||||
cp $OS_LIB/$file.a $OS_LIB/lib$file.a
|
||||
echo "copied OS_LIB/$file.a to OS_LIB/lib$file.a for linking"
|
||||
fi
|
||||
fi
|
||||
done
|
||||
|
||||
|
||||
Build libbignsharp.dylib with the following script (Note the GEMPAK includes and links `-I$NSHARP`, `-I$GEMPAK/include`, `-L$OS_LIB`, etc.).
|
||||
|
||||
#!/bin/bash
|
||||
cd ~/awips2-gemlibs/nsharp/
|
||||
. $NAWIPS/Gemenviron.profile
|
||||
CC=gcc
|
||||
FC=gfortran
|
||||
|
||||
export NSHARP=$GEMPAK/source/programs/gui/nsharp
|
||||
export NWX=$GEMPAK/source/programs/gui/nwx
|
||||
|
||||
myLibs="$OS_LIB/ginitp_alt.o $OS_LIB/gendp_alt.o"
|
||||
|
||||
myCflags="$CFLAGS -I. -I./Sndglib -I$NSHARP -I$GEMPAK/include -I$OS_INC -I$NWX \
|
||||
-I/opt/X11/include/X11 -I/usr/include/Xm -I/opt/local/include -I/usr/include/malloc -Wcomment -Wno-return-type -Wincompatible-pointer-types -DUNDERSCORE -fPIC -DDEBUG -c"
|
||||
|
||||
myFflags="-I. -I$OS_INC -I$GEMPAK/include -I$NSHARP -fPIC -g -c -fno-second-underscore -fmax-errors=200 -std=f95"
|
||||
|
||||
myLinkflags="-L/usr/local/Cellar/gcc/4.9.2_1/lib/gcc/4.9/ -L/opt/local/lib -L$OS_LIB -L. -L./Sndglib -L/usr/X11R6/lib \
|
||||
-shared -Wl -Wcomment -Wincompatible-pointer-types -Wimplicit-function-declaration -Wno-return-type,-install_name,libbignsharp.dylib -o libbignsharp.dylib"
|
||||
|
||||
myLibsInc="$OS_LIB/ginitp_alt.o $OS_LIB/gendp_alt.o $OS_LIB/libnxmlib.a $OS_LIB/libsnlist.a \
|
||||
$OS_LIB/libsflist.a $OS_LIB/libgemlib.a $OS_LIB/libcgemlib.a $OS_LIB/libgplt.a $OS_LIB/libdevice.a \
|
||||
$OS_LIB/libxwp.a $OS_LIB/libxw.a $OS_LIB/libps.a $OS_LIB/libgn.a $OS_LIB/libcgemlib.a $OS_LIB/libgemlib.a \
|
||||
$OS_LIB/libnetcdf.a $OS_LIB/libtextlib.a $OS_LIB/libxml2.a $OS_LIB/libxslt.a \
|
||||
$OS_LIB/libgemlib.a $OS_LIB/libcgemlib.a $OS_LIB/librsl.a $OS_LIB/libbz2.a"
|
||||
|
||||
myLinktail="-I$OS_INC \
|
||||
-I$GEMPAK/include -I$NWX -I$NSHARP -I. -I./Sndglib -I/opt/X11/include/X11 -I/usr/include -I/usr/include/Xm -I/opt/local/include/ -I/opt/local/include -lhdf5 -lgfortran -ljasper -lpng -liconv -lc -lXt -lX11 -lz -lm -lXm"
|
||||
|
||||
$CC $myCflags *.c Sndglib/*.c
|
||||
$FC $myFflags *.f
|
||||
$CC $myLinkflags *.o $myLibsInc $myLinktail
|
||||
|
||||
cp libbignsharp.dylib ~/awips2-ncep/viz/gov.noaa.nws.ncep.ui.nsharp.macosx/
|
||||
|
||||
|
||||
## GEMPAK pre-built libraries
|
||||
|
||||
> libgempak.dylib
|
||||
|
||||
libgempak.dylib is built in a similar way as libbignsharp.dylib:
|
||||
|
||||
#!/bin/bash
|
||||
cd ~/awips2-gemlibs/gempak/
|
||||
. $NAWIPS/Gemenviron.profile
|
||||
CC=gcc
|
||||
FC=gfortran
|
||||
|
||||
myCflags="$CFLAGS -I. -I$GEMPAK/source/diaglib/dg -I$GEMPAK/source/gemlib/er \
|
||||
-I/opt/X11/include/X11 -I/usr/include/Xm -I/opt/local/include -I/usr/include/malloc -fPIC -DDEBUG -c"
|
||||
|
||||
myFflags="-I. -I$OS_INC -I$GEMPAK/include -fPIC -g -c -Wtabs -fno-second-underscore"
|
||||
|
||||
myLinkflags="-L/usr/local/Cellar/gcc/4.9.2_1/lib/gcc/4.9/ -L/opt/local/lib -L$OS_LIB -L. \
|
||||
-shared -Wl -Wno-return-type,-install_name,libgempak.dylib -o libgempak.dylib"
|
||||
|
||||
myLibs="$OS_LIB/ginitp_alt.o $OS_LIB/gendp_alt.o $OS_LIB/libcgemlib.a \
|
||||
$OS_LIB/libsflist.a $OS_LIB/gdlist.a $OS_LIB/libcgemlib.a $OS_LIB/libgemlib.a \
|
||||
$OS_LIB/libcgemlib.a $OS_LIB/libgplt.a $OS_LIB/libdevice.a $OS_LIB/libcgemlib.a \
|
||||
$OS_LIB/libgn.a $OS_LIB/libgemlib.a $OS_LIB/libcgemlib.a $OS_LIB/libnetcdf.a \
|
||||
$OS_LIB/libcgemlib.a $OS_LIB/libtextlib.a $OS_LIB/libxml2.a $OS_LIB/libxslt.a \
|
||||
$OS_LIB/libcgemlib.a $OS_LIB/libgemlib.a $OS_LIB/libcgemlib.a $OS_LIB/libcgemlib.a \
|
||||
$OS_LIB/librsl.a $OS_LIB/libcgemlib.a $OS_LIB/libbz2.a"
|
||||
|
||||
myLinktail="-I$OS_INC -I$GEMPAK/include -I. -I/opt/X11/include/X11 -I/usr/include \
|
||||
-I/usr/include/Xm -I/opt/local/include/ -I/opt/local/include \
|
||||
-lhdf5 -lgfortran -ljasper -lpng -liconv -lc -lXt -lX11 -lz -lm -lXm"
|
||||
|
||||
$CC $myCflags *.c
|
||||
$FC $myFflags *.f
|
||||
$CC $myLinkflags *.o $myLibs $myLinktail
|
||||
|
||||
cp libgempak.dylib ~/awips2-ncep/viz/gov.noaa.nws.ncep.viz.gempak.nativelib.macosx/
|
||||
|
||||
|
||||
> libcnflib.dylib
|
||||
|
||||
|
||||
#!/bin/bash
|
||||
cd ~/awips2-gemlibs/cnflib/
|
||||
. $NAWIPS/Gemenviron.profile
|
||||
CC=gcc
|
||||
FC=gfortran
|
||||
|
||||
myCflags="$CFLAGS -I/opt/X11/include/X11 -I/usr/include/Xm -I/opt/local/include \
|
||||
-I/usr/include/malloc -Wno-return-type -DUNDERSCORE -fPIC -DDEBUG -g -c"
|
||||
|
||||
myLinkflags="-L/usr/local/Cellar/gcc/4.9.2_1/lib/gcc/4.9/ -L/opt/local/lib \
|
||||
-shared -Wl -Wno-return-type,-install_name,libcnflib.dylib -o libcnflib.dylib"
|
||||
|
||||
myLinktail="-lgfortran -lc"
|
||||
|
||||
myLibs="$OS_LIB/ginitp_alt.o $OS_LIB/gendp_alt.o $OS_LIB/gdlist.a $OS_LIB/gdcfil.a \
|
||||
$OS_LIB/libgemlib.a $OS_LIB/libgplt.a $OS_LIB/libdevice.a $OS_LIB/libgn.a \
|
||||
$OS_LIB/libcgemlib.a $OS_LIB/libgemlib.a $OS_LIB/libnetcdf.a $OS_LIB/libtextlib.a \
|
||||
$OS_LIB/libxslt.a $OS_LIB/libxml2.a -liconv \
|
||||
$OS_LIB/libz.a $OS_LIB/librsl.a -lbz2"
|
||||
|
||||
$CC $myCflags *.c
|
||||
$CC $myLinkflags *.o $myLibs $myLinktail
|
||||
|
||||
cp libcnflib.dylib ~/awips2-ncep/viz/gov.noaa.nws.ncep.viz.gempak.nativelib.macosx/
|
||||
|
||||
|
||||
> libaodtv64.dylib
|
||||
|
||||
#!/bin/bash
|
||||
CC=gcc
|
||||
FC=gfortran
|
||||
|
||||
cd ~/awips2-gemlibs/aodt/AODTLIB/
|
||||
|
||||
gcc -fPIC -g -c -Wall *.c *.h
|
||||
gcc -shared -Wl,-Wno-return-type,-install_name,libaodtv64.dylib -o libaodtv64.dylib *.o -lc
|
||||
|
||||
cp libaodtv64.dylib ~/awips2-ncep/viz/gov.noaa.nws.ncep.viz.gempak.nativelib.macosx/
|
||||
|
||||
|
||||
|
||||
> libg2g.dylib
|
||||
|
||||
#!/bin/bash
|
||||
cd ~/awips2-gemlibs/g2g/
|
||||
. $NAWIPS/Gemenviron.profile
|
||||
CC=gcc
|
||||
FC=gfortran
|
||||
|
||||
myCflags="$CFLAGS -I$GEMPAK/include -I. -I$GEMPAK/source/diaglib/dg \
|
||||
-I$GEMPAK/source/gemlib/er -I/opt/X11/include/X11 -I/usr/include/Xm \
|
||||
-I/opt/local/include -I/usr/include/malloc -Wno-return-type -DUNDERSCORE \
|
||||
-fPIC -DDEBUG -c"
|
||||
|
||||
myFflags="-I. -I$OS_INC -I$GEMPAK/include -fPIC -g -c -Wtabs -fno-second-underscore"
|
||||
|
||||
myLinkflags="-L/usr/local/Cellar/gcc/4.9.2_1/lib/gcc/4.9/ -L/opt/local/lib \
|
||||
-L/usr/X11R6/lib -shared -Wl -Wno-return-type,-install_name,libg2g.dylib -o libg2g.dylib"
|
||||
|
||||
myLinktail="-lgfortran $OS_LIB/libjasper.a -lpng -lc"
|
||||
|
||||
myLibs="$OS_LIB/ginitp_alt.o $OS_LIB/gendp_alt.o $OS_LIB/gdlist.a \
|
||||
$OS_LIB/gdcfil.a $OS_LIB/libgemlib.a $OS_LIB/libgplt.a $OS_LIB/libdevice.a \
|
||||
$OS_LIB/libgn.a $OS_LIB/libcgemlib.a $OS_LIB/libgemlib.a $OS_LIB/libnetcdf.a \
|
||||
$OS_LIB/libtextlib.a $OS_LIB/libxslt.a $OS_LIB/libxml2.a \
|
||||
-liconv $OS_LIB/libz.a $OS_LIB/librsl.a -lbz2"
|
||||
|
||||
$CC $myCflags *.c
|
||||
$FC $myFflags *.f
|
||||
$CC $myLinkflags *.o $myLibs $myLinktail
|
||||
|
||||
cp libg2g.dylib ~/awips2-ncep/viz/gov.noaa.nws.ncep.viz.gempak.nativelib.macosx/
|
||||
|
|
@ -23,50 +23,21 @@ AWIPS takes a unified approach to data ingest, and most data types follow a path
|
|||
|
||||
Unidata supports two visualization frameworks for rendering data: [CAVE](install/install-cave), and the Python Data Access Framework ([python-awips](http://python-awips.readthedocs.io)).
|
||||
|
||||
---
|
||||
|
||||
## Download and Install CAVE
|
||||
|
||||
> [Release 18.1.1-1, September 19, 2018](https://www.unidata.ucar.edu/blogs/news/category/AWIPS)
|
||||
|
||||
| | |
|
||||
|:----------------------------------------:|:--|
|
||||
| <h1><i class="fa fa-linux"></i> Linux </h1> | <h4>[install.sh --cave <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/software/awips2/install.sh) </h4> <p>For CentOS/Red Hat 6 and 7. Installs to /awips2/cave and writes files to ~/caveData.</p> <tt><code>chmod 755 install.sh<br>sudo ./install.sh --cave</code></tt><p>Run CAVE from the Linux Desktop menu Applications > Internet > AWIPS CAVE, or from the command line as simply `cave`.</p> <p><img src="images/cave_linux_menu.png" style="width:300px;"></p><div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>OpenGL 2.0 capable device</li><li>4GB RAM</li><li><a href="http://www.nvidia.com/Download/index.aspx?lang=en-us">Latest NVIDIA driver</a></li><li>approx. 2GB disk space for data caching (~/caveData)</li></ul></div><p>You can reset CAVE at any time by removing the **~/caveData** directory (on macOS **~/Library/caveData**) and reconnecting to an EDEX server. </p> |
|
||||
|
||||
| | |
|
||||
|:----------------------------------------:|:--|
|
||||
| <h1><i class="fa fa-apple"></i> macOS </h1>|<h4> Download and install both<br>[awips2-cave-18.1.1-1.dmg <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips2-cave-18.1.1-1.dmg)<br>[awips-python.pkg <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips-python.pkg)</h4> <p>**Supported Graphics Devices for macOS**<li>Intel HD Graphics</li><li>Intel Iris</li><li>NVIDIA GeForce</li></p><p>**Unsupported Graphics Devices for macOS**<li>AMD Radeon R9</li><li>AMD Radeon Pro</li><li>AMD FirePro D300</li></p> <p>Writes and syncs files to ~/Library/caveData.</p> <p>**awips-python.pkg** is not a prerequisite, and CAVE will still run and display data without it, but to use any derived parameter functions such as wind barbs/arrows and grid parameters on various vertical coordinates, jep must be installed in some way (it is assumed in /Library/Python/2.7/site-packages/jep/)</p>|
|
||||
|
||||
|
||||
| | |
|
||||
|:----------------------------------------:|:--|
|
||||
| <h1><i class="fa fa-windows"></i> Windows </h1> | <h4> [awips-cave-18.1.1-1.amd64.msi <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.amd64.msi)</h4><p>Writes files to **~/caveData** (in your user home directory)</p> <p>Requires <b>Python 3</b>, <b>Numpy</b>, and <b>Jep</b> be installed</p> <p>Requires **PYTHONHOME** be defined</p>
|
||||
|
||||
### Windows-Specific Instructions
|
||||
|
||||
<div class="admonition note">
|
||||
<h4>1) Download and install <strong><a href="https://conda.io/miniconda.html">Miniconda Python 3.7 for Windows</a></strong><a class="headerlink" href="#1-download-and-install-miniconda-python-37-for-windows" title="Permanent link"></a></h4><ul><li>Allow Miniconda3 to set <strong>PATH</strong> and other environment variables.</li><li><p>Ensure that <strong>PYTHONHOME</strong> is set to the Miniconda3 location.</p><p><img alt="" src="../../images/windows_envvars.png" /></p><p>If <strong>PYTHONHOME</strong> is not set, the <strong>gridslice</strong> Python module will not be installed or available.</p></li></ul><h4>2) Install dependent Python packages</h4><ul><li><code>pip install numpy==1.15.1 jep==3.8.2</code></li></ul><h4>3) Run <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.amd64.msi">awips-cave-18.1.1-1.amd64.msi <i class="fa fa-download"></i></a><a class="headerlink" href="#3-run-awips-cave-1811-1amd64msi" title="Permanent link"></a></h4>
|
||||
</div>
|
||||
|
||||
> [Read full CAVE install instructions](install/install-cave)
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Download and Install EDEX
|
||||
## [Download and Install CAVE](install/install-cave)
|
||||
|
||||
> [Release 18.1.1-1, September 19, 2018](https://www.unidata.ucar.edu/blogs/news/category/AWIPS)
|
||||
---
|
||||
|
||||
| | |
|
||||
|:----------------------------------------:|:--|
|
||||
| <h1><i class="fa fa-linux"></i> Linux </h1> | <h4>[install.sh --edex <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/software/awips2/install.sh) </h4> <p>Installs to /awips2/ directories.</p> <tt><code>chmod 755 install.sh<br>sudo ./install.sh --edex</code></tt><p>Start and Stop:</p><p><tt>edex start<br>edex stop</tt></p><div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>16+ CPU cores (each CPU core is one more decoder which can run in parallel)</li><li>24GB RAM</li><li>700GB+ disk space</li>|
|
||||
|
||||
> [Read full EDEX install instructions](install/install-edex)
|
||||
## [Download and Install EDEX](install/install-edex)
|
||||
|
||||
---
|
||||
|
||||
## License
|
||||
|
||||
Unidata AWIPS source code and binaries (RPMs) are considered to be in the public domain, meaning there are no restrictions on any download, modification, or distribution in any form (original or modified). Unidata AWIPS contains no proprietery content and is therefore not subject to export controls as stated in the [Master Rights](https://github.com/Unidata/awips2/blob/unidata_16.2.2/rpms/legal/Master_Rights_File.pdf) licensing file.
|
||||
Unidata AWIPS source code and binaries (RPMs) are considered to be in the public domain, meaning there are no restrictions on any download, modification, or distribution in any form (original or modified). Unidata AWIPS contains no proprietery content and is therefore not subject to export controls as stated in the [Master Rights](https://github.com/Unidata/awips2/blob/unidata_18.1.1/rpms/legal/Master_Rights_File.pdf) licensing file.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -110,7 +81,6 @@ Common AWIPS Visualization Environment. The data rendering and visualization too
|
|||
|
||||
* [Read More: How to Install CAVE](install/install-cave)
|
||||
|
||||
|
||||
|
||||
### LDM
|
||||
|
||||
|
|
|
|||
|
|
@ -2,22 +2,30 @@
|
|||
|
||||
> [Release 18.1.1-1, September 19, 2018](https://www.unidata.ucar.edu/blogs/news/category/AWIPS)
|
||||
|
||||
## Linux
|
||||
| | |
|
||||
|:----------------------------------------:|:--|
|
||||
| <h1><i class="fa fa-linux"></i> Linux </h1> | <h4>[install.sh --cave <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/software/awips2/install.sh) </h4> <p>For CentOS/Red Hat 6 and 7. Installs to /awips2/cave and writes files to ~/caveData.</p> <tt><code>chmod 755 install.sh<br>sudo ./install.sh --cave</code></tt><p>Run CAVE from the Linux Desktop menu Applications > Internet > AWIPS CAVE, or from the command line as simply `cave`.</p> <div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>OpenGL 2.0 capable device</li><li>4GB RAM</li><li><a href="http://www.nvidia.com/Download/index.aspx?lang=en-us">Latest NVIDIA driver</a></li><li>approx. 2GB disk space for data caching (~/caveData)</li></ul></div><p>You can reset CAVE at any time by removing the **~/caveData** directory (on macOS **~/Library/caveData**) and reconnecting to an EDEX server. </p> |
|
||||
| <h1><i class="fa fa-linux"></i></h1> | <h4>[install.sh --cave <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/software/awips2/install.sh) </h4> <p>For CentOS/Red Hat 6 and 7. Installs to /awips2/cave and writes files to ~/caveData.</p> <tt><code>chmod 755 install.sh<br>sudo ./install.sh --cave</code></tt><p>Run CAVE from the Linux Desktop menu Applications > Internet > AWIPS CAVE, or from the command line as simply `cave`.</p> <div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>OpenGL 2.0 capable device</li><li>4GB RAM</li><li><a href="http://www.nvidia.com/Download/index.aspx?lang=en-us">Latest NVIDIA driver</a></li><li>approx. 2GB disk space for data caching (~/caveData)</li></ul></div><p>You can reset CAVE at any time by removing the **~/caveData** directory (on macOS **~/Library/caveData**) and reconnecting to an EDEX server. </p> |
|
||||
|
||||
## macOS
|
||||
| | |
|
||||
|:----------------------------------------:|:--|
|
||||
| <h1><i class="fa fa-apple"></i> macOS </h1>|<h4> Download and install both<br>[awips2-cave-18.1.1-1.dmg <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips2-cave-18.1.1-1.dmg)<br>[awips-python.pkg <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips-python.pkg)</h4> <p>**Supported Graphics Devices for macOS**<li>Intel HD Graphics</li><li>Intel Iris</li><li>NVIDIA GeForce</li></p><p>**Unsupported Graphics Devices for macOS**<li>AMD Radeon R9</li><li>AMD Radeon Pro</li><li>AMD FirePro D300</li></p> <p>Writes and syncs files to ~/Library/caveData.</p> <p>**awips-python.pkg** is not a prerequisite, and CAVE will still run and display data without it, but to use any derived parameter functions such as wind barbs/arrows and grid parameters on various vertical coordinates, jep must be installed in some way (it is assumed in /Library/Python/2.7/site-packages/jep/)</p>|
|
||||
| <h1><i class="fa fa-apple"></i></h1>|<h4> Download and install both<br>[awips-cave-18.1.1-1.dmg <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.dmg)<br>[awips-python.pkg <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips-python.pkg)</h4> <p>**Supported Graphics Devices for macOS**<li>Intel HD Graphics</li><li>Intel Iris</li><li>NVIDIA GeForce</li></p><p>**Unsupported Graphics Devices for macOS**<li>AMD Radeon R9</li><li>AMD Radeon Pro</li><li>AMD FirePro D300</li></p> <p>Writes and syncs files to ~/Library/caveData.</p> <p>**awips-python.pkg** is not a prerequisite, and CAVE will still run and display data without it, but to use any derived parameter functions such as wind barbs/arrows and grid parameters on various vertical coordinates, jep must be installed in some way (it is assumed in /Library/Python/2.7/site-packages/jep/)</p>|
|
||||
|
||||
|
||||
## Windows
|
||||
| | |
|
||||
|:----------------------------------------:|:--|
|
||||
| <h1><i class="fa fa-windows"></i> Windows </h1> | <h4> [awips-cave-18.1.1-1.amd64.msi <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.amd64.msi)</h4><p>Writes files to **~/caveData** (in your user home directory)</p> <p>Requires <b>Python 3</b>, <b>Numpy</b>, and <b>Jep</b> be installed</p> <p>Requires **PYTHONHOME** be defined</p>
|
||||
| <h1><i class="fa fa-windows"></i> </h1> | <h4> [awips-cave-18.1.1-1.msi <i class="fa fa-download"></i>](https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.msi)</h4><p>Writes files to **~/caveData** (in your user home directory)</p> <p>Requires <b>Python 3</b>, <b>Numpy</b>, and <b>Jep</b> be installed</p> <p>Requires **PYTHONHOME** be defined</p> <p>In addition to the application directory, the MSI installer will attempt to copy the *[gridslice](https://github.com/mjames-upc/gridslice)* shared library to `$PYTHONHOME/Dlls`. If the `$PYTHONHOME` environmental variable is not defined, *gridslice* will not be installed. You can always rerun the installer after defining `$PYTHOMHOME` and then check that the file `gridslice.pyd` is installed in `$PYTHONHOME/Dlls`.</p> <p>CAVE will still run without gridslice, but certain bundles which use derived parameters, such as [isentropic analyses](../cave/d2d-grids/#isentopic-analysis-270k-320k), will not load. </p> |
|
||||
|
||||
|
||||
|
||||
<p><b>Windows-Specific Instructions</b></p>
|
||||
|
||||
|
||||
### Windows-Specific Instructions
|
||||
|
||||
<div class="admonition note">
|
||||
<h4>1) Download and install <strong><a href="https://conda.io/miniconda.html">Miniconda Python 3.7 for Windows</a></strong><a class="headerlink" href="#1-download-and-install-miniconda-python-37-for-windows" title="Permanent link"></a></h4><ul><li>Allow Miniconda3 to set <strong>PATH</strong> and other environment variables.</li><li><p>Ensure that <strong>PYTHONHOME</strong> is set to the Miniconda3 location.</p><p><img alt="" src="../../images/windows_envvars.png" /></p><p>If <strong>PYTHONHOME</strong> is not set, the <strong>gridslice</strong> Python module will not be installed or available.</p></li></ul><h4>2) Install dependent Python packages</h4><ul><li><code>pip install numpy==1.15.1 jep==3.8.2</code></li></ul><h4>3) Run <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.amd64.msi">awips-cave-18.1.1-1.amd64.msi <i class="fa fa-download"></i></a><a class="headerlink" href="#3-run-awips-cave-1811-1amd64msi" title="Permanent link"></a></h4>
|
||||
<h4>1) Download and install <strong><a href="https://conda.io/miniconda.html">Miniconda Python 3.7 for Windows</a></strong><a class="headerlink" href="#1-download-and-install-miniconda-python-37-for-windows" title="Permanent link"></a></h4><ul><li>Allow Miniconda3 to set <strong>PATH</strong> and other environment variables.</li><li><p>Ensure that <strong>PYTHONHOME</strong> is set to the Miniconda3 location.</p><p><img alt="" src="../../images/windows_envvars.png" /></p><p>If <strong>PYTHONHOME</strong> is not set, the <strong>gridslice</strong> Python module will not be installed or available.</p></li></ul><h4>2) Install dependent Python packages</h4><ul><li><code>pip install numpy==1.15.1 jep==3.8.2</code></li></ul><h4>3) Run <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.msi">awips-cave-18.1.1-1.msi <i class="fa fa-download"></i></a><a class="headerlink" href="#3-run-awips-cave-1811-1amd64msi" title="Permanent link"></a></h4>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
|
@ -30,12 +38,13 @@ Unidata and XSEDE Jetstream have partnered to offer a EDEX data server in the cl
|
|||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
## caveData Directory
|
||||
|
||||
**Localization Preferences Error**
|
||||
After connecting to an EDEX server, you will have a local directory named **caveData** which contains files synced from EDEX as well as a client-side cache for data and map resources.
|
||||
|
||||
You can reset CAVE by removing the **~/caveData** directory (on macOS **~/Library/caveData**) and then run `cave` again to connect to an EDEX server. Your local files have been removed, but if you are re-connecting to an EDEX server you have used before, the remote files will sync again to your local **~/caveData** (bundles, colormaps, etc.).
|
||||
You can reset CAVE by removing the **caveData** directory and reconnecting to an EDEX server. Your local files have been removed, but if you are re-connecting to an EDEX server you have used before, the remote files will sync again to your local **~/caveData** (bundles, colormaps, etc.).
|
||||
|
||||
**No Images Displayed**
|
||||
* Linux: `/home/<user>/caveData`
|
||||
* macOS: `/Users/<user>/Library/caveData`
|
||||
* Windows: `C:\Users\<user>\caveData`
|
||||
|
||||
If you are able to load wire-frame contours but not images, [update your video driver](http://www.nvidia.com/Download/index.aspx?lang=en-us).
|
||||
|
|
|
|||
|
|
@ -6,5 +6,6 @@ dependencies:
|
|||
- python=2.7
|
||||
- pip
|
||||
- pip:
|
||||
- mkdocs==0.17.5
|
||||
- mkdocs-unidata==1.5.7
|
||||
- fontawesome_markdown
|
||||
|
|
|
|||
|
|
@ -83,7 +83,6 @@ pages:
|
|||
- Surface Obs Plot with MetPy: python/surface-obs-plot-metpy.md
|
||||
- Development:
|
||||
- AWIPS Development Environment (ADE): dev/awips-development-environment.md
|
||||
- Building NSHARP for macOS: dev/build-nsharp-macos.md
|
||||
- Appendix:
|
||||
- AWIPS Grid Parameters: appendix/appendix-grid-parameters.md
|
||||
- Acronyms and Abbreviations: appendix/appendix-acronyms.md
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue