goes16 doc, nsharp for mac doc, other minor updates

This commit is contained in:
Michael James 2017-06-14 22:06:09 -06:00 committed by mjames-upc
parent fab8fbc87e
commit e4db082f4c
14 changed files with 333 additions and 15 deletions

View file

@ -17,6 +17,10 @@ Frame control, map projection, image properties, and a few featured applications
At bottom-right of the map window the the Resource Stack, which displays all loaded resources and map overlays, and allows for interaction and customization with the resource via a **right-click menu**.
There are three available views of the Resource Stack, the default will show all Product Resources. **Right Click** the mouse on the map background to switch to a Simple View. **Right Click** again to show all Map Resources. **Right Click** again to toggle back to Product Resources.
It's important to understand that Product Resources and Map Resources are handled differently given the time-based nature of Products, compared to the static nature of maps. Selecting the **Clear** button will remove all Products but not remove any Map Products.
> Left-Click Resource Name to Hide
A left click on any resource in the stack will hide the resource and turn the label gray. Clicking the name again makes the resource visible.

View file

@ -1,27 +1,32 @@
# VIIRS
## NOAAport GINI imagery
## Uniwisc McIDAS AREA files
## VIIRS
VIIRS is one of five instruments onboard the NPP satellite. VIIRS' mission is to collect radiometric imagery in visible and infrared wavelengths of the Earth's surface; this includes observing fires, ice, ocean color, vegetation, clouds, and land and sea surface temperatures, and supplying high-resolution images and data used by meteorologists to assess climate change and improve short-term weather forecasting.
The VIIRS submenu option provides VIIRS imagery and moderate band satellite displays for the
CONUS, Alaska, and Pacific regions. In addition to accessing the NPP Product VIIRS data via the Satellite menu, the VIIRS Imagery data can also be accessed using the **Product Browser**.
# GOES and POES Sounding Data
## GOES and POES Sounding Data
GOES and POES Sounding Data Availability Plots displays the locations where GOES and POES temperature and moisture profiles are available. These soundings are displayed on a Skew-T/log P chart using the Points tool and the Volume Browser. Soundings from the GOES satellites are made only in relatively cloud-free areas, whereas POES systems produce temperature and moisture soundings in clear and cloudy atmospheres. Each hour, NESDIS provides the latest soundings from GOES East and West. Although the GOES East and West sounders yield soundings over a broad area, the default AWIPS configuration retains soundings only from within each site's Regional CAVE scale domain. POES soundings are generated approximately every 12 hours and have more global coverage.
# POES Imagery
## POES Imagery
The POES Imagery section of the Satellite menu contains selectors for IR Window, Visible, 3.7µ, and 11-3.7µ products. These are viewable on all scales.
# Sounder Imagery
## Sounder Imagery
The products available from the Sounder Imagery submenu are based purely on the imager instruments aboard the GOES East (GE) and GOES West (GW) satellites.
# Derived Products Imagery
## Derived Products Imagery
A variety of precipitation products are accessible from the Derived Products submenu. These products are derived from one or more of the various satellites (e.g., DMPS, POES, GOES, and GPS). Descriptions of the products follow.
@ -48,20 +53,20 @@ forecasters can predict the chances of having a below average, normal, or above
precipitation in the upcoming months.
# SSM/I Point Data
## SSM/I Point Data
SSM/I Point Data plot displays data collected over the course of a day for calculating ocean wind speeds.
# GOES High Density Winds
## GOES High Density Winds
GOES High Density Winds submenu has options to display satellite-derived multi-layer winds plots from the IR, Visible, and three Water Vapor channels. In addition, you can display individual layers that display a composite of all the satellite channels.
# MTSAT High Density Winds
## MTSAT High Density Winds
MTSAT High Density Winds cover the Western Pacific.
# ASCAT winds (25 km)
## ASCAT winds (25 km)
Scatterometer Winds are obtained from the ASCAT instrument on EUMETSAT's MetOP-A polar orbiting satellite. This instrument sends pulses of radiation to the ocean surface and measures the amount of energy, called backscatter, it receives back. When you sample these observations, the time, satellite ID, wind direction, and wind speed are provided. With the polar orbiting scanning, a given region will generally be sampled about every 12 hours.

View file

@ -0,0 +1,120 @@
AWIPS ingest and display of GOES-16 (GOES-R) products is handled by contributions from the **[awips2-goesr](https://github.com/Unidata/awips2-goesr)** plugin repository. As of Unidata AWIPS 17.1.1, the GOES-R decoder supports the ingest and display of NOAAport provisional products (currently on the NOTHER feed), as well as Level 2b netCDF files. A GOES-R Lightning Mapper (GLM) decoder is also provided to handle sensor lightning observations.
GOES-R products are accessible in the menu **Satellite** > **GOES-16 Provisional Products**
![](../images/goes_16_menu.png)
---
## NOAAport Provisional Products
### LDM Pattern Action
NOTHER ^(TI[RS]...) (KNES) (......) (...)
FILE -close -edex
/awips2/data_store/satellite/goes16/\1_\2_\3_\4_(seq).gini
### Puerto Rico sector (PRREGI)
![](../images/goes_16_pr.png)
### CONUS 1km
![](../images/goes_16_conus.png)
### Full Disk 6km
![](../images/goes_16_fd.png)
### Mesoscale Sectors (TMESO-1, TMESO-2)
Two floating mesoscale sectors (will vary from image shown)
![](../images/goes_16_meso.png)
### Icing Composite
Channels 5,3,2 (1.61u, 0.87u, 0.64u)
![](../images/goes_16_comp1.png)
### Daytime Composite 1
Channels 2,5,14 (0.64u, 1.61u, 11.20u)
![](../images/goes_16_comp2.png)
### Daytime Composite 2
Channels 2,3,2 (0.64u, 0.87u, 0.64u)
![](../images/goes_16_comp3.png)
!!! warning "GOES-16 Composite Imagery NOT SUPPORTED on macOS"
OpenGL Scripting Language limitations on Mac prevent multi-channel imagery from shading:
* Icing (1.61, 0.87, 0.64)
* Daytime Composite (0.64, 1.61, 11.20)
* Daytime Composite (0.64, 0.87, 0.64)
To display multi-channel composites requires CAVE for Linux or Windows.
### HDF5 Data Store
Decoded GOES-R satellite images are stored in `/awips2/edex/data/hdf5/satellite/` under sector subdirectories:
drwxr-xr-x 18 awips fxalpha PRREGI
drwxr-xr-x 18 awips fxalpha TCONUS
drwxr-xr-x 18 awips fxalpha TFD
drwxr-xr-x 18 awips fxalpha TMESO-1
drwxr-xr-x 18 awips fxalpha TMESO-2
---
## Level 2+ Products
Level 2+ products are described as derived environmental variables which will be created and disseminated when GOES-16 is used operationally (compared to **Level 0**, described as unprocessed instrument data at full resolution, and **Level 1b** products, described as radiometric and geometric correction applied to produce parameters in physical units).
Unidata does not currently have access to these products, but EDEX 17.1.1 can support their ingest if made available.
[Read more about GOES-R data levels...](http://www.goes-r.gov/ground/overview.html)
### Level 2+ Decoder Regular Expression
From `/awips2/edex/data/utility/common_static/base/distribution/goesr.xml`
^OR_ABI-L2-\w{3,5}(C|F|M1|M2)-M[34]_G\d\d_s\d{14}_e\d{14}_c\d{14}.nc$
---
## GOES Lightning Mapper (GLM)
NASA's SPoRT MSFC Earth Science Office has contributed plugins to decode GLM level2 products, which displayed as point data in CAVE.
Though Unidata is currently not distributing GLM products, you can [download a sample netCDF file](http://www.unidata.ucar.edu/software/awips2/OR_GLM-L2-LCFA_G16_s20170402339144_e20170402339307_c20170402339509.nc) and copy it to `/awips2/data_store/ingest/` in order to test the decoding and display of GOES-R lightning data.
### Ingest Sample Data
Run the single command from your EDEX server to ingest a single-time sample data set:
wget http://www.unidata.ucar.edu/software/awips2/OR_GLM-L2-LCFA_G16_s20170402339144.nc -P /awips2/data_store/ingest/
### Display GLM Lightning Data
And then access the GLM data in **Satellite** > **GOES-16 Provisional** > **GLM-Lightning**. Data are displayable as **Flash**, **Event**, and **Group**.
![](../images/goes_16_glmmenu.png)
![](../images/goes_16_glm.png)

View file

@ -13,10 +13,10 @@ Quick instructions on how to deploy CAVE from Eclipse.
2. `yum clean all && yum groupinstall awips2-ade`
This will install Eclipse (4.5), Java (1.8), Ant, Maven, Groovy, Python (2.7) and its modules (Numpy, Matplotlib, Shapely, and others).
This will install Eclipse (4.5), Java (1.8), Ant, Maven, Python 2.7 and its modules (Numpy, Matplotlib, Shapely, others).
3. git clone https://github.com/Unidata/awips2.git
3. `git clone https://github.com/Unidata/awips2.git`
The full list of repositories required as of release 17.1.1:
@ -47,14 +47,14 @@ Quick instructions on how to deploy CAVE from Eclipse.
You'll want to import **~/awips2** in three parts to ensure a clean and error-free Eclipse build:
1. Import **awips2/cave** > Select All Projects > Import/Finish
2. Import **awips2/edexOsgi** > Select All Projects > Import/Finish
3. Import **awips2/Radar** > Select All Projects > Import/Finish
1. Import **awips2/cave** > Select All Projects > Finish
2. Import **awips2/edexOsgi** > Select All Projects > Finish
3. Import **awips2/Radar** > Select All Projects > Finish
> The **Radar** folder contains the EDEX Radar Server plugins. Though the Unidata release does not build or use the radar server, the common libraries are required for other AWIPS radar processing and visualization plugins.
Now import all other repositories fully:
Select **awips2-core**, **awips2-core-foss**, **awips2-foss**, **awips2-ncep**, etc. > Select All Projects > Import/Finish
Select **awips2-core**, **awips2-core-foss**, **awips2-foss**, **awips2-ncep**, etc. > Select All Projects > Finish
* Project > Clean

View file

@ -0,0 +1,181 @@
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](http://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/

View file

@ -16,3 +16,7 @@
pngg2gini -vl logs/pngg2gini.log
/awips2/data_store/ingest/nexrcomp_\1_\4_\3_\2_(seq).rad
## WSR-88D Localizations
WFO

Binary file not shown.

After

Width:  |  Height:  |  Size: 504 KiB

BIN
docs/images/goes_16_fd.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 278 KiB

BIN
docs/images/goes_16_glm.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 91 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 338 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 330 KiB

BIN
docs/images/goes_16_pr.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 188 KiB

View file

@ -38,6 +38,7 @@ pages:
- NCP Perspective: cave/ncp-perspective.md
- NSHARP: cave/nsharp.md
- WarnGen: cave/warngen.md
- GOES-16 (GOES-R): cave/goes-16-satellite.md
- GIS and Shapefiles: cave/d2d-gis-shapefiles.md
- Volume Browser: cave/d2d-gridded-models.md
- Display Tools: cave/d2d-tools.md
@ -63,6 +64,9 @@ pages:
- Python:
- Derived Parameters: python/derived-parameters.md
- Python AWIPS API: python/python-awips-data-access.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