mirror of
https://github.com/Unidata/python-awips.git
synced 2025-02-23 22:57:56 -05:00
380948c858
- added a link in the table of contents that points directly to our grid parameters page in our regular AWIPS documentation, so we don't have to maintain that list in two different places.
76 lines
2.4 KiB
ReStructuredText
76 lines
2.4 KiB
ReStructuredText
==================================
|
|
Python AWIPS Data Access Framework
|
|
==================================
|
|
|
|
The python-awips package provides a data access framework for requesting meteorological and geographic datasets from an `EDEX <http://unidata.github.io/awips2/#edex>`_ server.
|
|
|
|
`AWIPS <http://unidata.github.io/awips2>`_ is a weather display and analysis package developed by the National Weather Service for operational forecasting. UCAR's `Unidata Program Center <http://www.unidata.ucar.edu/software/awips2/>`_ supports a non-operational open-source release of the AWIPS software (`EDEX <http://unidata.github.io/awips2/#edex>`_, `CAVE <http://unidata.github.io/awips2/#cave>`_, and `python-awips <https://github.com/Unidata/python-awips>`_).
|
|
|
|
.. _Jupyter Notebook: http://nbviewer.jupyter.org/github/Unidata/python-awips/tree/master/examples/notebooks
|
|
|
|
|
|
Pre-requisite Software
|
|
----------------------
|
|
|
|
In order to effictively use python-awips you'll need to have these installed already:
|
|
- python3
|
|
- conda
|
|
- git *(for the source code and examples installation)*
|
|
|
|
Package-Only Install
|
|
--------------------
|
|
|
|
If you already work with Python, you might just be interested in how to install the python-awips pacakge.
|
|
The package can be installed with either of the two well known package managers: **pip** and **conda**.
|
|
|
|
Pip Install
|
|
~~~~~~~~~~~
|
|
|
|
::
|
|
|
|
pip install python-awips
|
|
|
|
|
|
Conda Install
|
|
~~~~~~~~~~~~~
|
|
|
|
::
|
|
|
|
conda install -c conda-forge python-awips
|
|
|
|
|
|
|
|
Source Code with Examples Install
|
|
---------------------------------
|
|
|
|
Below are instructions on how to install the source code of python-awips, with all included example notebooks. This will create a new conda environment called ``python3-awips`` and start up a browser for the jupyter notebook examples.
|
|
|
|
::
|
|
|
|
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
|
|
|
|
|
|
Questions -- Contact Us!
|
|
------------------------
|
|
|
|
Please feel free to reach out to us at our support email at **support-awips@unidata.ucar.edu**
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:hidden:
|
|
|
|
api/index
|
|
datatypes
|
|
examples/index
|
|
dev
|
|
AWIPS Grid Parameters <http://unidata.github.io/awips2/appendix/appendix-grid-parameters/>
|
|
about
|