Skip to main content

An implementation of the rHEALPix discrete global grid system

Project description

rHEALPixDGGS is a Python package that implements the rHEALPix Discrete Global Grid System (DGGS).

Release Note

This package was originally authored in 2013 and has had only minor code updates since then.

0.5.2 - current

0.5.1 with tests that pass. Test fixes where just relating to rounding errors.

0.5.1

Code unchanged from 2013 other than updating to Python 3.7.

Pre-0.5.1

For releases 0.3, 0.4 & 0.5, see the _old folder within the 0.5.1 release on GitHub

Requirements

  • requirements.txt - all the module requirements for operation
  • requirements.opt.txt - Optional comprehensive mathematics package needed only for a few optional graphics methods.
    • Sage >=5.10 - To use the optional graphics methods, start a Sage notebook session and import/attach the Python module that contains the methods. For examples, see the Sage worksheet tests/test_rhealpixdggs.sws.

  • requirements.dev.txt - packages 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!

The .sws files in the tests directory are Sage worksheets. They are not automated tests, but rather supplementary graphical tests. To run these, install Sage, install Pyproj in Sage (download the Pyproj source code, change to the Pyproj directory, start a Sage shell via sage -sh, then type python setup.py build, then python setup.py install; if that doesn’t work, try again but first start in superuser mode via sudo su), start up a Sage notebook session, and open the worksheets.

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 (the main paper)

  • 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 General Public License, v3. See the file LICENSE for a copy of the deed.

Contact

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rHEALPixDGGS-0.5.2.tar.gz (4.5 MB view details)

Uploaded Source

Built Distribution

rHEALPixDGGS-0.5.2-py3-none-any.whl (58.0 kB view details)

Uploaded Python 3

File details

Details for the file rHEALPixDGGS-0.5.2.tar.gz.

File metadata

  • Download URL: rHEALPixDGGS-0.5.2.tar.gz
  • Upload date:
  • Size: 4.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.7.3

File hashes

Hashes for rHEALPixDGGS-0.5.2.tar.gz
Algorithm Hash digest
SHA256 6cf5c196bd55a972bc3aaa856e988810e1682f70e1356d911c5c1d1531933b54
MD5 bc8dfdc9687d44585b4d4b7e59435881
BLAKE2b-256 b90bca49f9d84338fe48b64ccd49151c2bdbe92288b3b0bcc42ca3821b21e6e3

See more details on using hashes here.

Provenance

File details

Details for the file rHEALPixDGGS-0.5.2-py3-none-any.whl.

File metadata

  • Download URL: rHEALPixDGGS-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 58.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.7.3

File hashes

Hashes for rHEALPixDGGS-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 212a8eac6b96c207a8d3f2499616fdcc096c3cfa0f37f082b0514fb7e36b688e
MD5 4428f4c43f301d3ff907f1ca09f025a8
BLAKE2b-256 ef59d3ad83e1d969c5572e6af687bbe31a07d8fdbf6ed63a56b858161a21da04

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page