National Microbiome Data Collaborative 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 schema for managing metadata from the National Microbiome Data Collaborative (NMDC).
Documentation
The documentation for the NMDC schema can be found at 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 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
- and various other YAML schemas imported by it, like prov.yaml, annotation.yaml, etc. all which you can find in the src/schema folder
- Makefile targets for converting the schema from it's native LinkML YAML format to other artifact like JSON Schema
- Build, deployment and distribution of the schema as a PyPI package
- Automatic publishing of refreshed documentation upon change to the schema, accessible here
Maintaining the Schema
See DEVELOPMENT.md for instructions on setting up a development environment.
See MAINTAINERS.md for instructions on using that development environment to maintain the schema.
Makefiles
Makefiles are text files people can use to tell make (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 cookiecutterproject.Makefile, which contains targets that are specific to this project
Here's an example of using make in this repo:
# Deletes all files in `examples/output`.
make examples-clean
The
examples-cleantarget is defined in theproject.Makefile. In this repo, theMakefileincludes theproject.Makefile. As a result,makehas 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/
1 maintainer
Metadata
1 maintainer
Release files for nmdc-schema 11.24.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nmdc_schema-11.24.0.tar.gz | 806.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nmdc_schema-11.24.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.7 MB
Release files / nmdc_schema-11.24.0.tar.gz
| Download URL | nmdc_schema-11.24.0.tar.gz |
|---|---|
| Size | 806.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3d9f55b8e8434ffe2083bd9d3ae1a8ce74daa602d4ec43b5dae60dddcadfe0e
|
|
BLAKE2b-256 checksum How to use checksums |
d8e85d7c5c55e58688968f31e28a59ca2dd850dd98b7ba92dd48c6e426180109
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency logRelease files / nmdc_schema-11.24.0-py3-none-any.whl
| Download URL | nmdc_schema-11.24.0-py3-none-any.whl |
|---|---|
| Size | 891.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
db6f22d84f611af7ba136a1d27d6163f39a7a2d2db600d00cd27bdc6ed3ff373
|
|
BLAKE2b-256 checksum How to use checksums |
23c68084eb767b4a8ce88433f65b6f3c62be32d6a813eaf60e9ce75f7b5bea5f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency log
