<p align="center">
<img src="https://raw.githubusercontent.com/microbiomedata/nmdc-schema/main/images/nmdc_logo_long.jpeg" width="119" height="40"/>
</p>
# National Microbiome Data Collaborative Schema
[](https://github.com/microbiomedata/nmdc-schema/blob/main/LICENSE)
[](https://badge.fury.io/py/nmdc-schema)
The mission of the NMDC is to build a FAIR microbiome data sharing network, through infrastructure, data standards,
and community building, that addresses pressing challenges in environmental sciences. The NMDC platform is built on
top of a unified data model (schema) that weaves together existing standards and ontologies to provide a systematic
representation of all aspects of the microbiome data life cycle.
This repository mainly defines a [LinkML](https://github.com/linkml/linkml) schema for managing metadata from
the [National Microbiome Data Collaborative (NMDC)](https://microbiomedata.org/).
## Documentation
The documentation for the NMDC schema can be found at [https://microbiomedata.github.io/nmdc-schema/](https://microbiomedata.github.io/nmdc-schema/).
This documentation is aimed at consumers of NMDC data and metadata, it describes the different data elements used to describe studies, samples,
sample processing, data generation, workflows, and downstream data objects.
The NMDC [Introduction to metadata and ontologies](https://microbiomedata.org/introduction-to-metadata-and-ontologies/)
primer provides some the context for this project.
The remainder of this page is primary for the internal maintainers and contributors to the NMDC schema
## Repository Contents Overview
Some products that are maintained, and tasks orchestrated within this repository are:
- Maintenance of LinkML YAML that specifies the NMDC Schema
- [src/schema/nmdc.yaml](src/schema/nmdc.yaml)
- and various other YAML schemas imported by it,
like [prov.yaml](src/schema/prov.yaml), [annotation.yaml](src/schema/annotation.yaml), etc. all which you can find
in the [src/schema](src/schema/) folder
- Makefile targets for converting the schema from it's native LinkML YAML format to other artifact
like [JSON Schema](project/jsonschema/nmdc.schema.json)
- Build, deployment and distribution of the schema as a PyPI package
- Automatic publishing of refreshed documentation upon change to the schema,
accessible [here](https://microbiomedata.github.io/nmdc-schema/)
## Maintaining the Schema
See [DEVELOPMENT.md](DEVELOPMENT.md) for instructions on setting up a development environment.
See [MAINTAINERS.md](MAINTAINERS.md) for instructions on using that development environment to maintain the schema.
## Makefiles
Makefiles are text files people can use to tell [`make`](https://www.gnu.org/software/make/manual/make.html#Introduction) (a computer program) how it can _make_ things (or—in general—_do_ things). In the world of Makefiles, those _things_ are called _targets_.
This repo contains 2 Makefiles:
- `Makefile`, based on the generic Makefile from the [LinkML cookiecutter](https://github.com/linkml/linkml-project-cookiecutter)
- `project.Makefile`, which contains _targets_ that are specific to this project
Here's an example of using `make` in this repo:
```shell
# Deletes all files in `examples/output`.
make examples-clean
```
> The `examples-clean` _target_ is defined in the `project.Makefile`. In this repo, the `Makefile` `include`s the `project.Makefile`. As a result, `make` has access to the _targets_ defined in both files.
## Data downloads
The NMDC's metadata about biosamples, studies, bioinformatics workflows, etc. can be obtained from our nmdc-runtime API.
Try entering "biosample_set" or "study_set" into the `collection_name` box
at https://api.microbiomedata.org/docs#/metadata/list_from_collection_nmdcschema__collection_name__get
Or use the API programmatically! Note that some collections are large, so the responses are paged.
You can learn about the other available collections at https://microbiomedata.github.io/nmdc-schema/Database/
Raw data
{
"_id": null,
"home_page": "https://microbiomedata.github.io/nmdc-schema/",
"name": "nmdc_schema",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "NMDC, schema, metadata, microbiome",
"author": "Bill Duncan",
"author_email": "wdduncan@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/2f/68/3626a37f31faece00d07ab3befca414b7b4cb155e80d2989e1b9bb1421ab/nmdc_schema-10.2.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/microbiomedata/nmdc-schema/main/images/nmdc_logo_long.jpeg\" width=\"119\" height=\"40\"/>\n</p>\n\n# National Microbiome Data Collaborative Schema\n\n[](https://github.com/microbiomedata/nmdc-schema/blob/main/LICENSE)\n[](https://badge.fury.io/py/nmdc-schema)\n\nThe mission of the NMDC is to build a FAIR microbiome data sharing network, through infrastructure, data standards,\nand community building, that addresses pressing challenges in environmental sciences. The NMDC platform is built on\ntop of a unified data model (schema) that weaves together existing standards and ontologies to provide a systematic\nrepresentation of all aspects of the microbiome data life cycle.\n\nThis repository mainly defines a [LinkML](https://github.com/linkml/linkml) schema for managing metadata from\nthe [National Microbiome Data Collaborative (NMDC)](https://microbiomedata.org/).\n\n## Documentation\n\nThe documentation for the NMDC schema can be found at [https://microbiomedata.github.io/nmdc-schema/](https://microbiomedata.github.io/nmdc-schema/).\nThis documentation is aimed at consumers of NMDC data and metadata, it describes the different data elements used to describe studies, samples,\nsample processing, data generation, workflows, and downstream data objects.\n\nThe NMDC [Introduction to metadata and ontologies](https://microbiomedata.org/introduction-to-metadata-and-ontologies/)\nprimer provides some the context for this project.\n\nThe remainder of this page is primary for the internal maintainers and contributors to the NMDC schema\n\n## Repository Contents Overview\n\nSome products that are maintained, and tasks orchestrated within this repository are:\n\n- Maintenance of LinkML YAML that specifies the NMDC Schema\n - [src/schema/nmdc.yaml](src/schema/nmdc.yaml)\n - and various other YAML schemas imported by it,\n like [prov.yaml](src/schema/prov.yaml), [annotation.yaml](src/schema/annotation.yaml), etc. all which you can find\n in the [src/schema](src/schema/) folder\n- Makefile targets for converting the schema from it's native LinkML YAML format to other artifact\n like [JSON Schema](project/jsonschema/nmdc.schema.json)\n- Build, deployment and distribution of the schema as a PyPI package\n- Automatic publishing of refreshed documentation upon change to the schema,\n accessible [here](https://microbiomedata.github.io/nmdc-schema/)\n\n## Maintaining the Schema\n\nSee [DEVELOPMENT.md](DEVELOPMENT.md) for instructions on setting up a development environment.\n\nSee [MAINTAINERS.md](MAINTAINERS.md) for instructions on using that development environment to maintain the schema.\n\n## Makefiles\n\nMakefiles are text files people can use to tell [`make`](https://www.gnu.org/software/make/manual/make.html#Introduction) (a computer program) how it can _make_ things (or\u2014in general\u2014_do_ things). In the world of Makefiles, those _things_ are called _targets_.\n\nThis repo contains 2 Makefiles:\n- `Makefile`, based on the generic Makefile from the [LinkML cookiecutter](https://github.com/linkml/linkml-project-cookiecutter)\n- `project.Makefile`, which contains _targets_ that are specific to this project\n\nHere's an example of using `make` in this repo:\n\n```shell\n# Deletes all files in `examples/output`.\nmake examples-clean\n```\n> The `examples-clean` _target_ is defined in the `project.Makefile`. In this repo, the `Makefile` `include`s the `project.Makefile`. As a result, `make` has access to the _targets_ defined in both files.\n\n## Data downloads\n\nThe NMDC's metadata about biosamples, studies, bioinformatics workflows, etc. can be obtained from our nmdc-runtime API.\nTry entering \"biosample_set\" or \"study_set\" into the `collection_name` box\nat https://api.microbiomedata.org/docs#/metadata/list_from_collection_nmdcschema__collection_name__get\n\nOr use the API programmatically! Note that some collections are large, so the responses are paged.\n\nYou can learn about the other available collections at https://microbiomedata.github.io/nmdc-schema/Database/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Schema resources for the National Microbiome Data Collaborative (NMDC)",
"version": "10.2.0",
"project_urls": {
"Documentation": "https://microbiomedata.github.io/nmdc-schema/",
"Homepage": "https://microbiomedata.github.io/nmdc-schema/",
"Repository": "https://github.com/microbiomedata/nmdc-schema"
},
"split_keywords": [
"nmdc",
" schema",
" metadata",
" microbiome"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3076e9f82dc29c5c7b5e175bbc5e109bae43fd7078dd40ac39cdd48e2a6cd9c4",
"md5": "d73fa48e954a143c5edf25fa7adb89b7",
"sha256": "d34f1274eb153781fc85caaead349523bd32b688e39a8acb2724bee6e0e9bd4e"
},
"downloads": -1,
"filename": "nmdc_schema-10.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d73fa48e954a143c5edf25fa7adb89b7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 700908,
"upload_time": "2024-04-18T15:35:48",
"upload_time_iso_8601": "2024-04-18T15:35:48.210852Z",
"url": "https://files.pythonhosted.org/packages/30/76/e9f82dc29c5c7b5e175bbc5e109bae43fd7078dd40ac39cdd48e2a6cd9c4/nmdc_schema-10.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2f683626a37f31faece00d07ab3befca414b7b4cb155e80d2989e1b9bb1421ab",
"md5": "99cb112374cb76b15f28bb06c6ada388",
"sha256": "da2299827a0d190838bbc06ebc16eeb0e4b4fc1ddd0c18839f805f757957e177"
},
"downloads": -1,
"filename": "nmdc_schema-10.2.0.tar.gz",
"has_sig": false,
"md5_digest": "99cb112374cb76b15f28bb06c6ada388",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 676288,
"upload_time": "2024-04-18T15:36:00",
"upload_time_iso_8601": "2024-04-18T15:36:00.643470Z",
"url": "https://files.pythonhosted.org/packages/2f/68/3626a37f31faece00d07ab3befca414b7b4cb155e80d2989e1b9bb1421ab/nmdc_schema-10.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-18 15:36:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "microbiomedata",
"github_project": "nmdc-schema",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nmdc_schema"
}
JSON
