DGGRID

General Information

DGGRID version 8.1b released January 10, 2024

Southern Terra Cognita Laboratory
www.discreteglobalgrids.org
Kevin Sahr, Director

DGGRID is a command-line application for generating and manipulating icosahedral discrete global grids (DGGs).

Three directories should be included herein:

• src: contains complete source code for DGGRID

  There are two ways that you can build DGGRID: you may use cmake (see INSTALL.md for instructions), or you can use the legacy build system from previous versions of DGGRID (see the text file README.NOCMAKE for instructions).

• examples: contains examples of using DGGRID with pre-computed outputs.

• dockerfiles: contains a DGGRID dockerfile and instructions for use

User documentation for DGGRID is in dggridManualV81b.pdf.

Terms of Use

This documentation is part of DGGRID.

DGGRID is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

DGGRID is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with the DGGRID source code (see the file LICENSE). If not, see https://www.gnu.org/licenses/.

Credits

DGGRID was primarily written in C++ by Kevin Sahr. See the file CHANGELOG.md for additional contributors.

The original DGGRID specifications were developed by (in alphabetical order): A. Ross Kiester, Tony Olsen, Barbara Rosenbaum, Kevin Sahr, Ann Whelan, and Denis White.

DGGRID was made possible in part by funding from the US Environmental Protection Agency, PlanetRisk, Inc., Culmen International, the Ruhr-University Bochum/GeoInsight Project, Turtle Conservancy, and the University of Tartu Landscape Geoinformatics Lab.

Dependencies

DGGRID will make use of the following external library, if available (not included):

• The Open Source Geospatial Foundation’s GDAL translator library for raster and vector geospatial data formats (see http://www.gdal.org)

DGGRID uses the following external libraries (included with the DGGRID source code):

• Angus Johnson’s Clipper library; see http://www.angusj.com.

• George Marsaglia’s multiply-with-carry “Mother-of-all-RNGs” pseudo-random number generation function.

• The gnomonic projection code is adapted from Gerald Evenden’s PROJ.4 library.

• Frank Warmerdam’s Shapelib library