[![Run unit tests and build Python package](https://github.com/nansencenter/py-thesaurus-interface/actions/workflows/tests_build.yml/badge.svg)](https://github.com/nansencenter/py-thesaurus-interface/actions/workflows/tests_build.yml)
[![Coverage Status](https://coveralls.io/repos/github/nansencenter/py-thesaurus-interface/badge.svg?branch=master)](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
Raw data
{
"_id": null,
"home_page": "https://github.com/nansencenter/py-thesaurus-interface",
"name": "pythesint",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "metadata standards thesaurus vocabulary",
"author": "Morten W. Hansen, Anton A. Korosov, Aleksander Vines",
"author_email": "morten.hansen@nersc.no",
"download_url": "https://files.pythonhosted.org/packages/17/a1/8e7db256345a7d7db990aa7771ce14c606d1fac4a91f46e7b104a01913c6/pythesint-1.6.6.tar.gz",
"platform": null,
"description": "[![Run unit tests and build Python package](https://github.com/nansencenter/py-thesaurus-interface/actions/workflows/tests_build.yml/badge.svg)](https://github.com/nansencenter/py-thesaurus-interface/actions/workflows/tests_build.yml)\n[![Coverage Status](https://coveralls.io/repos/github/nansencenter/py-thesaurus-interface/badge.svg?branch=master)](https://coveralls.io/github/nansencenter/py-thesaurus-interface?branch=master)\n\n## py-thesaurus-interface\nAn interface to metadata vocabularies for geospatial and other geophysical data\n\n## Install\n```\npip install https://github.com/nansencenter/py-thesaurus-interface/archive/master.tar.gz\n```\n## Usage\n```\nimport pythesint as pti\npti.get_gcmd_instrument('MERIS')\npti.get_gcmd_platform('ENVISAT')\npti.get_gcmd_provider('NERSC')\n```\n\nFor JSON vocabularies, it is possible to update the local files using a specific version.\nThe format of the version depends on the provider.\nIf no version is provided, the latest version is retrieved.\n\n```python\nimport pythesint as pti\npti.update_gcmd_instrument(version='9.1.5')\npti.update_cf_standard_name(version='20210119T185509')\npti.update_mmd_platform_type(version='a5c8573')\n```\n\nor\n\n```python\nimport pythesint as pti\npti.update_all_vocabularies(versions={\n 'gcmd_instrument': '9.1.5',\n 'cf_standard_name': '20210119T185509',\n 'mmd_platform_type': 'a5c8573'\n})\n```\n\n## Standards\n\nThe 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.\n\n## Directory Interchange Format (DIF)\n\nThe 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.\n\nSee: Directory Interchange Format (DIF) Writer's Guide, 2015. Global Change Master Directory. National Aeronautics and Space Administration. [http://gcmd.nasa.gov/add/difguide/].\n\n## Controlled keyword vocabularies from GCMD\n\nSee: 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\n\n\n\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "A Python interface to various metadata vocabularies",
"version": "1.6.6",
"split_keywords": [
"metadata",
"standards",
"thesaurus",
"vocabulary"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "f644a08448fca22e7739afda8fc289b5",
"sha256": "5c2bd6de33e4f4ec2ee5d7ad8a6236bfb3bf392c238c2426e41cc4a4daf4cd74"
},
"downloads": -1,
"filename": "pythesint-1.6.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f644a08448fca22e7739afda8fc289b5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 34259,
"upload_time": "2022-06-09T08:45:59",
"upload_time_iso_8601": "2022-06-09T08:45:59.784105Z",
"url": "https://files.pythonhosted.org/packages/43/1f/d0fd8b1bf7e92f89f32faa8549c8286e8ac05240a3d4d6bf06470501dc2c/pythesint-1.6.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "fc82b1b0da44bb41bbf3a2c0c86dc793",
"sha256": "1896d2c362cdadf950bef54f0b9332b378b57c4e3c69f014ef53d37b98c27b86"
},
"downloads": -1,
"filename": "pythesint-1.6.6.tar.gz",
"has_sig": false,
"md5_digest": "fc82b1b0da44bb41bbf3a2c0c86dc793",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 27528,
"upload_time": "2022-06-09T08:46:01",
"upload_time_iso_8601": "2022-06-09T08:46:01.372997Z",
"url": "https://files.pythonhosted.org/packages/17/a1/8e7db256345a7d7db990aa7771ce14c606d1fac4a91f46e7b104a01913c6/pythesint-1.6.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-06-09 08:46:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "nansencenter",
"github_project": "py-thesaurus-interface",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pythesint"
}