Metadata-Version: 1.2
Name: NEXRAD-quickplot
Version: 0.6.1
Summary: easily download and plot NEXRAD weather radar reflectivity data
Home-page: https://github.com/scivision/nexrad-quickplot
Author: Michael Hirsch, Ph.D.
Author-email: UNKNOWN
License: UNKNOWN
Description-Content-Type: UNKNOWN
Description: .. image:: https://travis-ci.org/scivision/nexrad-quick-plot.svg?branch=master
            :target: https://travis-ci.org/scivision/nexrad-quick-plot
            :alt: Travis-CI
        
        .. image:: https://coveralls.io/repos/github/scivision/nexrad-quick-plot/badge.svg?branch=master
            :target: https://coveralls.io/github/scivision/nexrad-quick-plot?branch=master
            :alt: Coveralls.io
        
        .. image:: https://ci.appveyor.com/api/projects/status/jmiiyri2xqdvu5wm?svg=true
            :target: https://ci.appveyor.com/project/scivision/nexrad-quick-plot
            :alt: AppVeyor Build Station
            
            
        ===================
        Nexrad Quick-plot
        ===================
        Easy Python download and plot NEXRAD compositive reflectivity.
        Uses the RGB high resolution North American PNG images.
        
        tested with ``pytest``, ``flake8`` and ``mypy`` type checking.
        
        Install
        =======
        ::
        
            python -m pip install -e .
        
        
        Usage
        =====
        
        
        Download NEXRAD data
        --------------------
        
        Get `NEXRAD reflectivity data <https://mesonet.agron.iastate.edu/docs/nexrad_composites/>`_ with parallel download::
        
            python download-nexrad.py start stop outdir
        
        example: download from 2018-01-01 to 2018-01-02 to ``~/data/nexrad``::
        
            python download-nexrad.py 2018-01-01T00 2018-01-03T00 ~/data/nexrad
        
        
        Plot NEXRAD reflectivity data 
        -----------------------------
        (georegistered via Cartopy)
        
        Plot all data in directory::
        
            python plot-nexrad.py ~/data/nexrad/
        
        Plot a specific file::
        
            python plot-nexrad.py ~/data/nexrad/2018-01-01T12:35:00.png
        
        Plot via file glob match::
        
            python plot-nexrad.py ~/data/nexrad/2018-01-01T12*.png
        
        
        Coordinates
        ===========
        
        EPSG:4326 coordinates (WGS84) are in .wld files, which are generally the same for wide time spans of data.
        The `.wld format <https://mesonet.agron.iastate.edu/docs/radmapserver/howto.html#toc3.3>`_ is like::
        
            0.005 (size of pixel in x direction)
            0.0 (rotation of row) (Typically zero)
            0.0 (rotation of column) (Typically zero)
            -0.005 (size of pixel in y direction)
            -126.0 (x coordinate of centre of upper left pixel in map units--here it's WGS84 longitude)
            50.0 (y coordinate of centre of upper left pixel in map units--here it's WGS84 latitude)
        
        
        Notes
        =====
        
        
        Mass image downscaling
        ----------------------
        For initial analysis, the original Nexrad image size of 12200 x 5400 pixels may be too high to complete in a reasonable time.
        I choose to downsize by a factor of 10, which takes a long time, but is a one-time process.
        
        .. code:: bash
        
            mkdir orig
            cp *.png orig
        
           nice mogrify -scale 10% "*.png"
        
        If you have trouble with this being very slow, try::
        
             MAGICK_TEMPORARY_PATH=/run/shm nice mogrify -scale 10% "*.png"
        
        \
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >=3.6
