noaadem 0.0.16
A python library that simplify the access to the NOAA digitalelevation map.
License: MIT

noaadem
=======

|Gitter|

|License| |Downloads| |Build Status| |Coverage Status| |Code Health|
|PyPI version| |Stories in Ready|

A python library that simplifies the access to the NOAA digital
elevation map.

Requirements
============

If you want to use this library on any GNU/Linux or OSX system you just
need to execute:

::

    $ pip install noaadem

If you want to improve this library, you should download the `github
repository <https://github.com/gersolar/noaadem>`__ and execute:

::

    $ make deploy

On Ubuntu Desktop there are some other libraries not installed by
default (zlibc libbz2-dev) which may need to be installed to use these
library. Use the next command to automate the installation of the
additional C libraries:

::

    $ make ubuntu deploy

Testing
=======

To test all the project you should use the command:

::

    $ make test

If you want to help us or report an issue join to us through the `GitHub
issue tracker <https://github.com/gersolar/noaadem/issues>`__.

Example
=======

There are 3 methods to obtain the NOAA digital elevation map matrix:

1. obtain
2. obtain\_to
3. persist

The **obtain** method accepts 2 parameters the latitude and longitude
numpy matrix:

.. code:: python

        from noaadem import instrument
        from datetime import datetime

        dem_matrix = instrument.obtain(lat, lon)

Next, the **obtain\_to** method needs a standard NOAA CLASS netcdf
filename to parse:

.. code:: python

        from noaadem import instrument
        from datetime import datetime

        dem_matrix = instrument.obtain_to('data/goes13.2014.124.123422.BAND_01.nc')

Last, the **persist** method needs a standard NOAA CLASS netcdf filename
to save the variables:

.. code:: python

        from noaadem import instrument
        from datetime import datetime
        from netcdf import netcdf as nc

        instrument.persist('data/goes13.2014.124.123422.BAND_01.nc')
        with nc.loader('data/goes13.2014.124.123422.BAND_01.nc') as root:
            print nc.getvar(root, 'dem')[:]

About
=====

This software is developed by
`GERSolar <http://www.gersol.unlu.edu.ar/>`__. You can contact us to
gersolar.dev@gmail.com.

.. |Gitter| image:: https://badges.gitter.im/Join%20Chat.svg
   :target: https://gitter.im/gersolar/noaadem?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
.. |License| image:: https://img.shields.io/pypi/l/noaadem.svg
   :target: https://raw.githubusercontent.com/limiear/noaadem/master/LICENSE
.. |Downloads| image:: https://img.shields.io/pypi/dm/noaadem.svg
   :target: https://pypi.python.org/pypi/noaadem/
.. |Build Status| image:: https://travis-ci.org/gersolar/noaadem.svg?branch=master
   :target: https://travis-ci.org/gersolar/noaadem
.. |Coverage Status| image:: https://coveralls.io/repos/gersolar/noaadem/badge.png
   :target: https://coveralls.io/r/gersolar/noaadem
.. |Code Health| image:: https://landscape.io/github/gersolar/noaadem/master/landscape.png
   :target: https://landscape.io/github/gersolar/noaadem/master
.. |PyPI version| image:: https://badge.fury.io/py/noaadem.svg
   :target: http://badge.fury.io/py/noaadem
.. |Stories in Ready| image:: https://badge.waffle.io/gersolar/noaadem.png?label=ready&title=Ready
   :target: https://waffle.io/gersolar/noaadem