************
rHEALPixDGGS
************
Introduction
============
rHEALPixDGGS is a Python package that implements the rHEALPix Discrete Global Grid System (DGGS).
Release Notes
-------------
This package was originally authored in 2013 and has had only minor code updates since then.
0.5.4 - current
^^^^^^^^^^^^^^^
Code unchanged from 0.5.3 other than updating to Python 3.11
Refer to file CHANGES.rst for a more detailed history of changes.
Requirements
-------------
* ``requirements.txt`` - all the module requirements for operation
- `NumPy >=1.7 <http://www.numpy.org/>`_ Base N-dimensional array package
- `SciPy >=0.12 <http://www.scipy.org/>`_ Fundamental library for scientific computing
- `Matplotlib >=1.2.1 <http://matplotlib.org/>`_ Comprehensive 2D Plotting
- `Pyproj >=1.9.3 <http://code.google.com/p/pyproj/>`_ Python interface to the PROJ.4 cartographic library
* ``requirements.dev.txt`` - packages needed for developing this package
Installation
--------------
This package is available on PyPI, the Python Package Index from where it can be installed as follows:
::
pip install rhealpixdggs
rHEALPixDGGS is also available for download from the github repository `<https://github.com/manaakiwhenua/rhealpixdggs-py>`_ from where the latest version can be cloned.
Tests
------
The files in the ``tests`` directory test the rHEALPixDGGS modules. These files are plain ``unittest`` files (the Python testing framework contained within the standard distribution). Tests for examples in documents need the ``doctest`` module installed (see ``requirements.dev.txt``).
Two UNIX shell scripts are included in this repository to run all unit and doc tests:
* ``run_doctests.sh``
* ``run_unittests.sh``
Running the command ``python tests/test_<foo>.py`` performs a sequence of automated tests of ``<foo>.py``.
For example, ``tests/test_distortion.py`` automatically tests ``distortion.py``.
If you update a module, then update its test file to test the changes you made!
Test early, test often, test automatically!
There are a couple of files in the main package directory that can be used to run all tests, starting ``run_...``.
Documentation
--------------
Documentation can be found at:
- `The rHEALPix Discrete Global Grid System <https://datastore.landcareresearch.co.nz/dataset/rhealpix-discrete-global-grid-system>`_ - The rHEALPix Discrete Global Grid System
- ``docs/build/latex/rHEALPixDGGS.pdf`` - The rHEALPixDGGS manual
- ``docs/build/html/index.html`` - The rHEALPixDGGS manual in HTML format
The latter two documents are generated automatically from the source code of the ``rhealpixdggs`` package modules.
To automatically build these yourself, install the Python package `Sphinx <http://sphinx-doc.org/>`_ (but do not run ``sphinx-quickstart``, because the make file ``Makefile`` and the configuration file ``docs/source/conf.py`` already exist) and then from the ``docs`` directory run the command ``make latexpdf`` to make the PDF documentation or ``make html`` to make the HTML documentation.
For the PDF documentation, you might also need to install `LaTeX <http://www.latex-project.org/>`_.
The ``source`` and ``build`` directories contain all the Sphinx source and build files, respectively.
License
-------
This code is licensed under the `GNU Lesser General Public License v3.0, <http://www.gnu.org/licenses/lgpl-3.0.html>`_. See the file ``LICENSE`` for a copy of the deed.
Contact
-------
| *Maintainer*:
| **Robert Gibb**
| `Manaaki Whenua – Landcare Research <https://www.landcareresearch.co.nz/>`_
| `Gibbr@landcareresearch.co.nz <mailto:Gibbr@landcareresearch.co.nz>`_
|
| *Release Manager*:
| **Dr Nicholas J. Car**
| `SURROUND Australia Pty Ltd <https://surround.com>`_
| `nicholas.car@surroundaustralia.com <mailto:nicholas.car@surroundaustralia.com>`_
|
| *Original author*:
| **Alexander Raichev**
| `<https://raichev.net/>`_
| `alex@raichev.net <mailto:alex@raichev.net>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/manaakiwhenua/rhealpixdggs-py",
"name": "rHEALPixDGGS",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "DGGS,Discreet Global Grid System,reference system,spatial,geospatial",
"author": "Alexander Raichev",
"author_email": "alex@raichev.net",
"download_url": "https://files.pythonhosted.org/packages/d3/f8/6c2347db2132476cca36a66b8e6a9dddd3f2e08731148b7403473f49f0a4/rHEALPixDGGS-0.5.4.tar.gz",
"platform": null,
"description": "************\nrHEALPixDGGS\n************\n\nIntroduction\n============\nrHEALPixDGGS is a Python package that implements the rHEALPix Discrete Global Grid System (DGGS).\n\nRelease Notes\n-------------\nThis package was originally authored in 2013 and has had only minor code updates since then.\n\n0.5.4 - current\n^^^^^^^^^^^^^^^\nCode unchanged from 0.5.3 other than updating to Python 3.11\n\nRefer to file CHANGES.rst for a more detailed history of changes.\n\nRequirements \n-------------\n* ``requirements.txt`` - all the module requirements for operation\n - `NumPy >=1.7 <http://www.numpy.org/>`_ Base N-dimensional array package\n - `SciPy >=0.12 <http://www.scipy.org/>`_ Fundamental library for scientific computing\n - `Matplotlib >=1.2.1 <http://matplotlib.org/>`_ Comprehensive 2D Plotting\n - `Pyproj >=1.9.3 <http://code.google.com/p/pyproj/>`_ Python interface to the PROJ.4 cartographic library\n* ``requirements.dev.txt`` - packages needed for developing this package\n\nInstallation\n--------------\nThis package is available on PyPI, the Python Package Index from where it can be installed as follows:\n\n::\n\n pip install rhealpixdggs\n\nrHEALPixDGGS is also available for download from the github repository `<https://github.com/manaakiwhenua/rhealpixdggs-py>`_ from where the latest version can be cloned.\n \nTests\n------\nThe files in the ``tests`` directory test the rHEALPixDGGS modules. These files are plain ``unittest`` files (the Python testing framework contained within the standard distribution). Tests for examples in documents need the ``doctest`` module installed (see ``requirements.dev.txt``).\n\nTwo UNIX shell scripts are included in this repository to run all unit and doc tests:\n\n* ``run_doctests.sh``\n* ``run_unittests.sh``\n\nRunning the command ``python tests/test_<foo>.py`` performs a sequence of automated tests of ``<foo>.py``.\n\nFor example, ``tests/test_distortion.py`` automatically tests ``distortion.py``.\n\nIf you update a module, then update its test file to test the changes you made!\n\nTest early, test often, test automatically!\n\nThere are a couple of files in the main package directory that can be used to run all tests, starting ``run_...``.\n\nDocumentation\n--------------\nDocumentation can be found at:\n\n- `The rHEALPix Discrete Global Grid System <https://datastore.landcareresearch.co.nz/dataset/rhealpix-discrete-global-grid-system>`_ - The rHEALPix Discrete Global Grid System\n- ``docs/build/latex/rHEALPixDGGS.pdf`` - The rHEALPixDGGS manual\n- ``docs/build/html/index.html`` - The rHEALPixDGGS manual in HTML format\n\nThe latter two documents are generated automatically from the source code of the ``rhealpixdggs`` package modules.\nTo automatically build these yourself, install the Python package `Sphinx <http://sphinx-doc.org/>`_ (but do not run ``sphinx-quickstart``, because the make file ``Makefile`` and the configuration file ``docs/source/conf.py`` already exist) and then from the ``docs`` directory run the command ``make latexpdf`` to make the PDF documentation or ``make html`` to make the HTML documentation.\nFor the PDF documentation, you might also need to install `LaTeX <http://www.latex-project.org/>`_.\n\nThe ``source`` and ``build`` directories contain all the Sphinx source and build files, respectively. \n\nLicense\n-------\nThis code is licensed under the `GNU Lesser General Public License v3.0, <http://www.gnu.org/licenses/lgpl-3.0.html>`_. See the file ``LICENSE`` for a copy of the deed.\n\nContact\n-------\n| *Maintainer*:\n| **Robert Gibb**\n| `Manaaki Whenua \u2013 Landcare Research <https://www.landcareresearch.co.nz/>`_\n| `Gibbr@landcareresearch.co.nz <mailto:Gibbr@landcareresearch.co.nz>`_\n|\n| *Release Manager*:\n| **Dr Nicholas J. Car**\n| `SURROUND Australia Pty Ltd <https://surround.com>`_\n| `nicholas.car@surroundaustralia.com <mailto:nicholas.car@surroundaustralia.com>`_\n|\n| *Original author*:\n| **Alexander Raichev**\n| `<https://raichev.net/>`_\n| `alex@raichev.net <mailto:alex@raichev.net>`_\n",
"bugtrack_url": null,
"license": "LICENSE.txt",
"summary": "An implementation of the rHEALPix discrete global grid system",
"version": "0.5.4",
"project_urls": {
"Bug Reports": "https://github.com/manaakiwhenua/rhealpixdggs-py/issues",
"Download": "https://github.com/manaakiwhenua/rhealpixdggs-py/archive/v0.5.4.tar.gz",
"Homepage": "https://github.com/manaakiwhenua/rhealpixdggs-py",
"Source": "https://github.com/manaakiwhenua/rhealpixdggs-py"
},
"split_keywords": [
"dggs",
"discreet global grid system",
"reference system",
"spatial",
"geospatial"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f02e69f33e4abec0111c0cc861bd446d5a65f028cd0952638493fcb10701530c",
"md5": "9b89ebb0bccf6f23cbead0377928d7c7",
"sha256": "5a8191fe5d4586d3965ab0a4d93735ff304f88db267d4af1010a7a14f870da48"
},
"downloads": -1,
"filename": "rHEALPixDGGS-0.5.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9b89ebb0bccf6f23cbead0377928d7c7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 47440,
"upload_time": "2023-12-18T01:25:11",
"upload_time_iso_8601": "2023-12-18T01:25:11.415190Z",
"url": "https://files.pythonhosted.org/packages/f0/2e/69f33e4abec0111c0cc861bd446d5a65f028cd0952638493fcb10701530c/rHEALPixDGGS-0.5.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d3f86c2347db2132476cca36a66b8e6a9dddd3f2e08731148b7403473f49f0a4",
"md5": "c222907e01856e9b24fe556ac831154d",
"sha256": "57712493da6643df33f89b793c24f4248260c9db4eb08c7dd3a32e2950464ffe"
},
"downloads": -1,
"filename": "rHEALPixDGGS-0.5.4.tar.gz",
"has_sig": false,
"md5_digest": "c222907e01856e9b24fe556ac831154d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1262688,
"upload_time": "2023-12-18T01:25:14",
"upload_time_iso_8601": "2023-12-18T01:25:14.609475Z",
"url": "https://files.pythonhosted.org/packages/d3/f8/6c2347db2132476cca36a66b8e6a9dddd3f2e08731148b7403473f49f0a4/rHEALPixDGGS-0.5.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-18 01:25:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "manaakiwhenua",
"github_project": "rhealpixdggs-py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "rhealpixdggs"
}
JSON
