Skip to main content

Schema resources for the National Microbiome Data Collaborative (NMDC)

Project description

Long NMDC logo

National Microbiome Data Collaborative Schema

PyPI - License PyPI version

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
  • 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 cookiecutter
  • project.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-clean target is defined in the project.Makefile. In this repo, the Makefile includes 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/

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nmdc_schema-11.1.0.tar.gz (461.8 kB view details)

Uploaded Source

Built Distribution

nmdc_schema-11.1.0-py3-none-any.whl (497.1 kB view details)

Uploaded Python 3

File details

Details for the file nmdc_schema-11.1.0.tar.gz.

File metadata

  • Download URL: nmdc_schema-11.1.0.tar.gz
  • Upload date:
  • Size: 461.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for nmdc_schema-11.1.0.tar.gz
Algorithm Hash digest
SHA256 c3047507fcb9526d5bfa8f2bae80d438e05688995ad110956152ad74d7c8ebb2
MD5 2f9ac38bc5b5bb8c4d2d6165a5f91532
BLAKE2b-256 f06d79b3beb4523e985fce662922178d9e6a4cd17da38a4136cfaae85b34995a

See more details on using hashes here.

Provenance

The following attestation bundles were made for nmdc_schema-11.1.0.tar.gz:

Publisher: pypi-publish.yaml on microbiomedata/nmdc-schema

Attestations:

File details

Details for the file nmdc_schema-11.1.0-py3-none-any.whl.

File metadata

  • Download URL: nmdc_schema-11.1.0-py3-none-any.whl
  • Upload date:
  • Size: 497.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for nmdc_schema-11.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5694721db42876a3fe04f701717787eff18d023a4427c6cf100f9ff1418380a1
MD5 6fc0dd6a710f95e8d3d8e0e0de9d9de8
BLAKE2b-256 a90b23eb58777bc007443bb93a766b784cc5a1e4d8b5e86c6b000796eba52850

See more details on using hashes here.

Provenance

The following attestation bundles were made for nmdc_schema-11.1.0-py3-none-any.whl:

Publisher: pypi-publish.yaml on microbiomedata/nmdc-schema

Attestations:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page