rHEALPixDGGS 0.5.4

Description:

rHEALPixDGGS 0.5.4

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 Base N-dimensional array package
SciPy >=0.12 Fundamental library for scientific computing
Matplotlib >=1.2.1 Comprehensive 2D Plotting
Pyproj >=1.9.3 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 - 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 (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.
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,. See the file LICENSE for a copy of the deed.


Contact

Maintainer:
Robert Gibb
Manaaki Whenua – Landcare Research
[email protected]

Release Manager:
Dr Nicholas J. Car
SURROUND Australia Pty Ltd
[email protected]

Original author:
Alexander Raichev
https://raichev.net/
[email protected]