Metadata-Version: 1.1
Name: geonum
Version: 1.1.1
Summary: Toolbox for 3D geonumerical calculations
Home-page: https://github.com/jgliss/geonum
Author: Jonas Gliss
Author-email: jg@nilu.no
License: GPLv3
Description: geonum provides functionality for 3D geo numerical calculations
        including online access and handling of topography data. The module is based on two fundamental classes "GeoPoint" and "GeoVector3D" which are inherited from the respective base classes of the `LatLon module <https://pypi.python.org/pypi/LatLon>`_ and were expanded for the 3rd (elevation) dimension.
        Topography access is supported for SRTM data, which is handled by the 
        `SRTM module <https://pypi.python.org/pypi/SRTM.py/>`_, and the `Etopo1 Dataset <https://www.ngdc.noaa.gov/mgg/global/global.html>`_ for which the data needs to be downloaded and stored locally.
        
        Requirements
        ------------
        
        It is recommended to use the package manager `Anaconda <https://www.continuum.io/downloads>`_ since it includes many of the required dependencies and makes life easier when it comes to installation or upgrade of non-straight forward installations of additional requirements (e.g. opencv, basemap)
        
          - numpy
          - matplotlib >= 1.4.3
          - matplotlib `basemap <https://pypi.python.org/pypi/basemap/1.0.7>`_ (*installation of this module may not be straight forward - especially on Windows machines -, please follow the instructions provided on the web page*) 
          - `LatLon <https://pypi.python.org/pypi/LatLon>`_
          
            - LatLon requires installation of `pyproj <https://pypi.python.org/pypi/pyproj/>`_
            
          - Scipy (including `scipy.ndimage <https://docs.scipy.org/doc/scipy-0.18.1/reference/ndimage.html>`_)
        
        **Optional dependencies (to use extra features)**
        
          - OpenCV (used for changing resolution of topographic elevation maps, for installation remarks, see `here <http://opencv-python-tutroals.readthedocs.io/en/latest/py_tutorials/py_setup/py_setup_in_windows/py_setup_in_windows.html>`_)
          - netCDF4 (needed in case `Etopo1 <https://www.ngdc.noaa.gov/mgg/global/global.html>`_ data acess is required).
        
        Installation
        ------------
        
        geonum can be installed from `PyPi <https://pypi.python.org/pypi/geonum>`_ using::
        
          pip install geonum
          
        or from source by downloading and extracting the latest release. After navigating to the source folder (where the setup.py file is located) call::
        
          python setup.py install
          
        If the installation fails make sure, that all dependencies (see above) are installed correctly. geonum is tested for Python 2.7.
        
        Instructions and code documentation
        -----------------------------------
        
        The code documentation of geonum is hosted on `Read The Docs <http://geonum.readthedocs.io/en/latest/index.html>`_
        
        Get started
        -----------
        
        After installation try running the `example scripts <http://geonum.readthedocs.io/en/latest/examples.html>`_ in order to test the installation. The scripts are also meant to provide an easy start into the main features of geonum.
        
        Supported Etopo1 files
        ----------------------
        In order to use topography data from the Etopo1 dataset, please download and unzip one of the following files to the package folder *geonum/local_topo_data/*.
        Tested and supported are the following two files (grid registered):
        
          1. Ice surface: ETOPO1_Ice_g_gmt4.grd (download `here <https://www.ngdc.noaa.gov/mgg/global/relief/ETOPO1/data/ice_surface/grid_registered/netcdf/ETOPO1_Ice_g_gmt4.grd.gz>`__)
          2. Bedrock: ETOPO1_Bed_g_gmt4.grd (download `here <https://www.ngdc.noaa.gov/mgg/global/relief/ETOPO1/data/bedrock/grid_registered/netcdf/ETOPO1_Bed_g_gmt4.grd.gz>`__)
          
        The local installation folder can be accessed via::
        
          import geonum
          print geonum.LOCAL_TOPO_PATH
          
        If a valid data file is stored in this folder, it will be detected automatically. It is also possible to store the topodata at another location (e.g. <data_path>). In this case, the local path to the folder containing the topograph files needs to be provided, e.g.::
        
          import geonum
          access = geonum.topodata.TopoDataAccess(mode = "etopo1", local_path = <data_path>)
          
        If the path is valid, it will be added to the installation file *LOCAL_TOPO_PATHS.txt*
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 2.7
