Python AWIPS Data Access Framework¶
The python-awips package provides a data access framework for requesting grid and geometry datasets from an EDEX server.
AWIPS is a weather display and analysis package developed by the National Weather Service for operational forecasting. UCAR’s Unidata Program Center supports a non-operational open-source release of the AWIPS software (EDEX, CAVE, and python-awips).
Pip Install¶
pip install python-awips
Conda Environment Install¶
To install the latest version of python-awips, with all required and optional packages:
git clone https://github.com/Unidata/python-awips.git
cd python-awips
conda env create -f environment.yml
conda activate python3-awips
python setup.py install --force
jupyter notebook examples
If you are experiencing issues, and have previously setup the conda environment, you may need to run:
conda update --all
Requirements¶
These are specified in the environment.yml file that is used to create the ‘python3-awips’ conda environment:
python 3
numpy
nomkl
matplotlib
cartopy
jupyter
netcdf4
owslib
metpy
pint
h5py
nbconvert 4.1+
siphon
xarray
ffmpeg
pytest
shapely
six
pip
Quick Example¶
from awips.dataaccess import DataAccessLayer
DataAccessLayer.changeEDEXHost("edex-cloud.unidata.ucar.edu")
dataTypes = DataAccessLayer.getSupportedDatatypes()
list(dataTypes)
['acars',
'binlightning',
'bufrmosavn',
'bufrmoseta',
'bufrmosgfs',
'bufrmoshpc',
'bufrmoslamp',
'bufrmosmrf',
'bufrua',
'climate',
'common_obs_spatial',
'gfe',
'gfeeditarea',
'grid',
'maps',
'modelsounding',
'obs',
'practicewarning',
'profiler',
'radar',
'radar_spatial',
'satellite',
'sfcobs',
'topo',
'warning']
request = DataAccessLayer.newDataRequest()
request.setDatatype("satellite")
availableSectors = DataAccessLayer.getAvailableLocationNames(request)
availableSectors.sort()
for sector in availableSectors:
print sector
request.setLocationNames(sector)
availableProducts = DataAccessLayer.getAvailableParameters(request)
availableProducts.sort()
for product in availableProducts:
print " - " + product
ECONUS
- ACTP
- ADP
- AOD
- CAPE
- CH-01-0.47um
- CH-02-0.64um
- CH-03-0.87um
- CH-04-1.38um
...
EFD
- ACTP
- ADP
- AOD
- CAPE
- CH-01-0.47um
- CH-02-0.64um
- CH-03-0.87um
- CH-04-1.38um
...
See the API Documentation for more information.
Read The Docs Contents¶
- API Documentation
- Available Data Types
- Data Plotting Examples
- AWIPS Grids and Cartopy
- Colored Surface Temperature Plot
- Forecast Model Vertical Sounding
- GOES Geostationary Lightning Mapper
- Grid Levels and Parameters
- METAR Station Plot with MetPy
- Map Resources and Topography
- Model Sounding Data
- NEXRAD Level3 Radar
- Precip Accumulation-Region Of Interest
- Regional Surface Obs Plot
- Satellite Imagery
- Upper Air BUFR Soundings
- Watch and Warning Polygons
- Development Guide
- Writing a New Factory
- Registering the Factory with the Framework
- Retrieving Data Using the Factory
- Development Background
- Design/Implementation
- How users of the framework retrieve and use the data
- How plugin developers contribute support for new datatypes
- How the framework works when it receives a request
- Request interfaces
- Grid Parameters
- About Unidata AWIPS