Skip to content

Esri/ggxf

Repository files navigation

GGXF (Gridded Geodetic data eXchange Format)

Motivation

The use of gridded data in geodetic applications is increasing. For some geodetic datum transformations the Natural Resources Canada NTv2 format is widely used although other national and ad hoc formats are also in use. There is no global standard for these and other geodetic data such as geoid grids, position displacement grids and numerous others. Producers often define a proprietary or some other convenient format. The adoption of a standard file format will facilitate the creation and use of gridded data sets. It would relieve grid producers of the necessity for producing file readers and will assist application developers to incorporate new grids with minimal effort. Users will benefit from quicker access to the data. GGXF is a proposed standard format for the exchange of gridded geodetic data.

Development History

GGXF is an Esri research and development project to define a standardized format for the exchange of gridded geodetic data. The project began in 2013 and has progressed in fits and starts since then. The requirements of GGXF are as follows:

  • Multi-dimensional
  • Multi-resolution
  • Self-defining (metadata/header)
  • Applicable to any datatype defined on a graticular grid
  • Binary data storage structure
  • Open-source GGXF reader/writers from commonly used existing formats

We quickly realized the formidible scope of this task. We also questioned the rationale of creating yet another standard format. After a fairly cursory review of existing geodetic data grid formats coupled with the fact that Esri already had capability to work with NetCDF/HDF5, we focused on leveraging the latter widely used, robust and mature format for GGXF. The fact that NetCDF was already an OGC standard bolstered our decision to proceed in this direction.

Having decided to adapt NetCDF/HDF5, we created a set of attribute and variable names relevant to GGXF based on the CF Conventions and Metadata guidelines. Currently, the set of attribute and variable names we use to describe the NetCDF file comprises a combination of NetCDF Attribute Convention for Dataset Discovery attributes to define those attributes of a GGXF file common to all grids in the file, along with our newly developed attribute and variable names to define specific attributes of any grid within the file. These GGXF standard attributes and variables define the metadata/header file needed to ensure the format is self-describing.

Using these parameters we can create a Common Data Form Language File (CDL) which is a human-readable notation for NetCDF objects and data. We tested this by creating a CDL file of a multi-resolution, nested NTv2 grid file and applied the ncgen function from the NetCDF library to convert the CDL file into binary NetCDF format. We successfully recovered the original CDL from the binary NetCDF file using the ncdump function. This process gave us confidence that NetCDF could possibly serve as a platform for GGXF.

A more complete background of the development of GGXF and an example of a GGXF format grid can be found in the files uploaded above. The table below describes the content of each of these files.

File Description
6.OGC standarization of gridded geodetic data.pptx Lott, R.M., M. Kennedy, K.M. Kelly, R. Juergens, D. Burrows and K. Ryden, 2015, Standard file format for the exchange of gridded geodetic data, OGC TC/PC Meeting, Barcelona, Spain, 9-13 March 2015
7.ggxf-standard-names-v1.0.pdf CF Convention style attribute and varialbe standard names developed for use in GGXF
G69442_Gridded_Geodetic_Data _Format_poster_6-15_v8.pdf Kelly, K.M., R. Juergens, M. Kennedy, D. Burrows and R. Lott, 2015, A Standard File Format For Gridded Geodetic Data (G01p-252), Poster, 6th General Assembly of the International Union of Geodesy and Geophysics (IUGG), June 22 to July 2, 2015, Prague, Czech Republic
GGXF-OGC-Toulouse-18-Nov-2019.pptx Kelly, K.M. and R.M. Lott, 2019, Standard file format for the exchange of gridded geodetic data, OGC TC/PC Meeting, Toulouse, France, 12-18 November, 2019
IAGS-S-15-00075.pdf Kelly, K.M., R. Juergens, M. Kennedy, D. Burrows and R. Lott, 2015, A Standard File Format For Gridded Geodetic Data, Unpublished paper submitted to IAG Proceedings, 6th General Assembly of the International Union of Geodesy and Geophysics (IUGG), June 22 to July 2, 2015, Prague, Czech Republic
sample_ggxf_nested_grid.cdl Excerpt of CDL file created from a multi-resolution, nested NTv2 grid file and used to generate a binary NetCDF file (see text for details).

Future Work

  • Continue to vet GGXF throughout the community
  • Develop a more comprehensive list of metadata/header standard attriute and variable names and their definitions
  • Incorporate GGXF into the Esri Projection Engine (PE)
  • Develop code samples to read/write GGXF files
  • Develop code samples to convert between GGXF and some commonly used existing formats

About

Gridded Geodetic data eXchange Format

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published