https://github.com/nansencenter/py-thesaurus-interface
An interface to metadata conventions for geospatial data
https://github.com/nansencenter/py-thesaurus-interface
dif earth-observations gcmd geospaas keyword nasa standards
Last synced: 8 months ago
JSON representation
An interface to metadata conventions for geospatial data
- Host: GitHub
- URL: https://github.com/nansencenter/py-thesaurus-interface
- Owner: nansencenter
- License: gpl-3.0
- Created: 2016-02-05T14:22:11.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-10-01T09:00:27.000Z (9 months ago)
- Last Synced: 2025-10-03T17:58:42.754Z (9 months ago)
- Topics: dif, earth-observations, gcmd, geospaas, keyword, nasa, standards
- Language: Python
- Homepage:
- Size: 1.31 MB
- Stars: 2
- Watchers: 10
- Forks: 3
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/nansencenter/py-thesaurus-interface/actions/workflows/ci.yml)
[](https://coveralls.io/github/nansencenter/py-thesaurus-interface?branch=master)
## py-thesaurus-interface
An interface to metadata vocabularies for geospatial and other geophysical data
## Install
```
pip install https://github.com/nansencenter/py-thesaurus-interface/archive/master.tar.gz
```
## Usage
```
import pythesint as pti
pti.get_gcmd_instrument('MERIS')
pti.get_gcmd_platform('ENVISAT')
pti.get_gcmd_provider('NERSC')
```
For JSON vocabularies, it is possible to update the local files using a specific version.
The format of the version depends on the provider.
If no version is provided, the latest version is retrieved.
```python
import pythesint as pti
pti.update_gcmd_instrument(version='9.1.5')
pti.update_cf_standard_name(version='20210119T185509')
pti.update_mmd_platform_type(version='a5c8573')
```
or
```python
import pythesint as pti
pti.update_all_vocabularies(versions={
'gcmd_instrument': '9.1.5',
'cf_standard_name': '20210119T185509',
'mmd_platform_type': 'a5c8573'
})
```
## Standards
The package follows the standards defined at NASA's Global Change Master Directory (GCMD) (http://gcmd.gsfc.nasa.gov) and the NetCDF-CF conventions (http://cfconventions.org/), plus possibly others that will be added as needs emerge... The standards are mapped in Python dictionaries and saved to json-files.
## Directory Interchange Format (DIF)
The DIF format is a descriptive and standardized format for exchanging information about scientific data sets. The py-thesaurus-interface package provides an interface to the keywords and formats defined at GCMD.
See: Directory Interchange Format (DIF) Writer's Guide, 2015. Global Change Master Directory. National Aeronautics and Space Administration. [http://gcmd.nasa.gov/add/difguide/].
## Controlled keyword vocabularies from GCMD
See: Global Change Master Directory (GCMD). 2015. GCMD Keywords, Version 8.1. Greenbelt, MD: Global Change Data Center, Science and Exploration Directorate, Goddard Space Flight Center (GSFC) National Aeronautics and Space Administration (NASA). URL:http://gcmd.nasa.gov/learn/keywords.html