Schema resources for the National Microbiome Data Collaborative (NMDC)
Project description
National Microbiome Data Collaborative Schema
The NMDC is a multi-organizational effort to integrate microbiome data across diverse areas in medicine, agriculture, bioenergy, and the environment. This integrated platform facilitates comprehensive discovery of and access to multidisciplinary microbiome data in order to unlock new possibilities with microbiome data science.
This repository mainly defines a LinkML schema for managing metadata from the National Microbiome Data Collaborative (NMDC).
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
Background
The NMDC Introduction to metadata and ontologies primer provides some the context for this project.
Maintaining the Schema
New system requirement: Mike Farah's GO-based yq
Some optional components use the Java-based ROBOT or Jena arq. Jena riot is also a part of the MongoDB dumping, repairing and validation workflow, if the user wishes to generate and validate RDF/TTL.
See MAINTAINERS.md for instructions on maintaining and updating 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/
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
Built Distribution
Hashes for nmdc_schema-9.1.0-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 92f19fa866a711da98d7511abfc863314bdef1297c2dc1faf435e39ee674067e |
|
| MD5 | 9f870a71f647c2a6d9be5fcf5c3601bd |
|
| BLAKE2b-256 | 2497c771f793d360dddf3e0702741a46d6aed6fce1030d758446e68d2a9db423 |
