{"id":40790146,"url":"https://github.com/genomicsstandardsconsortium/mixs","last_synced_at":"2026-01-21T20:01:20.199Z","repository":{"id":22392016,"uuid":"92949248","full_name":"GenomicsStandardsConsortium/mixs","owner":"GenomicsStandardsConsortium","description":"Minimum Information about any (X) Sequence” (MIxS) specification","archived":false,"fork":false,"pushed_at":"2026-01-17T00:30:33.000Z","size":74846,"stargazers_count":55,"open_issues_count":502,"forks_count":22,"subscribers_count":16,"default_branch":"main","last_synced_at":"2026-01-17T07:21:12.730Z","etag":null,"topics":["bioinformatics","contextual-data","genomics","gsc","json-schema","metagenomes","standard"],"latest_commit_sha":null,"homepage":"https://w3id.org/mixs","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GenomicsStandardsConsortium.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-05-31T13:36:20.000Z","updated_at":"2026-01-08T20:31:51.000Z","dependencies_parsed_at":"2023-02-16T13:15:23.923Z","dependency_job_id":"974b6407-fac4-4063-b93c-5345a50f5ac5","html_url":"https://github.com/GenomicsStandardsConsortium/mixs","commit_stats":{"total_commits":328,"total_committers":14,"mean_commits":"23.428571428571427","dds":"0.38109756097560976","last_synced_commit":"fa4899cb7048ecc6e6c5f0521dbc2703ea7381cb"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/GenomicsStandardsConsortium/mixs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenomicsStandardsConsortium%2Fmixs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenomicsStandardsConsortium%2Fmixs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenomicsStandardsConsortium%2Fmixs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenomicsStandardsConsortium%2Fmixs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GenomicsStandardsConsortium","download_url":"https://codeload.github.com/GenomicsStandardsConsortium/mixs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenomicsStandardsConsortium%2Fmixs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28641293,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T18:04:35.752Z","status":"ssl_error","status_checked_at":"2026-01-21T18:03:55.054Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioinformatics","contextual-data","genomics","gsc","json-schema","metagenomes","standard"],"created_at":"2026-01-21T20:00:57.835Z","updated_at":"2026-01-21T20:01:20.188Z","avatar_url":"https://github.com/GenomicsStandardsConsortium.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MIxS: Minimum Information about any (X) Sequence\n\nThis repository contains the source material for the [Genomic Standards Consortium](https://www.gensc.org/) (GSC) [Minimum Information about any (X) Sequence (MIxS) standard](https://www.gensc.org/pages/standards-intro.html).\n\nMIxS, or the Minimum Information about any (X) Sequence is a standard for describing the contextual information about the sampling and sequencing of any genomic sequence. The standard has *Terms* that describe characteristics of a sample that addresses: \n* What is the source of the sequence?\n* In what kind of environment was the sample collected?\n* What methods were utilized to process the sample?\n\nFollowing the release of MIxS v6.0, subsequent releases (e.g. MIxS 6.1) are represented in and maintained using the [LinkML](https://linkml.io/linkml/) framework. LinkML uses YAML to define schemas. The [user-focused](#repository-structure)/[developer-focused](#developer-documentation) sections of the repository structure provide details on where to find these YAML files that are defining the standard.\n\nThe MIxS standards are found at: https://genomicsstandardsconsortium.github.io/mixs/\n\n*Terms* \nThe individual metadata terms are provided in the table: [here](https://genomicsstandardsconsortium.github.io/mixs/term_list/). These *Terms* are attributes or properties that describe samples and their sequence-associated metadata. Broadly, MIxS metadata *Terms* are represented in genomic *Checklists*, environmental *Extensions*, and *Combinations* (of *Checklists* and *Extensions*). \n\n*Checklists*\n[Checklists](https://genomicsstandardsconsortium.github.io/mixs/#checklists) include the required, recommended and optional metadata fields (*Terms*) for a specific type of genomic sequence (e.g. genome, metagenome, microbiome, marker gene, MAG or single cell genome). The MIGS genomic sequences checklist, for example, supports taxa or subcellular structure specific checklists (Eukaryotes, Bacteria, Viruses, Organelle, Plants).\n\n*Extensions*\n[Extensions](https://genomicsstandardsconsortium.github.io/mixs/#extensions) include *Terms* that describe specific environments from which a sample was collected. For example, the Agriculture Extension (MIxS-Ag) includes terms to describe agricultural environments.\n\n*Combinations*\nMIxS Checklists and Extensions are designed to be modular, supporting mix and match combinations of any genomic checklist with terms from any environmental extension, to create MIxS [Combinations](https://genomicsstandardsconsortium.github.io/mixs/combinations/). For example, a Combination of the [MIMS](https://genomicsstandardsconsortium.github.io/mixs/0010007/) *Checklist* and [Agriculture](https://genomicsstandardsconsortium.github.io/mixs/0016018/) *Extension*, called [MIMSAgriculture](https://genomicsstandardsconsortium.github.io/mixs/0010003_0016018/).\n\n## Repository Structure\n\nBelow are descriptions for the various user-facing directories in this repository.\n\n* [examples/](examples/) - examples of different kinds of data files in different data formats in different (JSON, YAML) containing data conformant with MIxS standard\n* [mixs-templates/](mixs-templates/) -  MIxS schema metadata collection templates in the Excel spreadsheet (.xlsx) format. These templates can be utilized for organizing a project's metadata in prepartion for submission to a sequence data archive.\n* [project/](project/) - artifacts autogenerated by the suite of generators in the [linkml](https://github.com/linkml/linkml) library. Artifacts include JSON-LD, OWL, JSON Schema, spreadsheet, etc. representations of the schema\n* [src/](src/)\n  * [src/data/examples/](src/data/examples/) - valid and invalid data examples \n  * The folder structure (*valid* and *invalid* folders), and the corresponding YAML data examples in this directory need to follow guidelines in accordance with the `linkml-run-examples` *testing framework*\n  * [src/mixs/](src/mixs/)\n    * [src/mixs/schema/](src/mixs/schema/)\n      * [src/mixs/schema/mixs.yaml](src/mixs/schema/mixs.yaml) - LinkML YAML schema representing the MIxS standard\n  * [src/docs](src/docs) - markdown files that can be converted to HTML and included in the web documentation pages\n\n## Developer Documentation\nNote: Developer documention is specifically included here for the use of members of the GSC's CIG and TWG committees.\n\u003cdetails\u003e\nUse the `make` command to generate project artefacts:\n\n* `make all`: make everything\n* `make deploy`: deploys site\n\u003c/details\u003e\n\nDocumentation about the contents of the developer-focussed folders/directories in this repository.\n\n* [assets/](assets/) - files consumed by, or generated by maintenance scripts in [src/scripts](src/scripts/)\n* [src/](src/)\n  * [src/mixs/](src/mixs/)\n    * [src/mixs/datamodel/](src/mixs/datamodel/) - Python dataclasses artifact generated by running the LinkML Python generator on MIxS schema file\n    * [src/mixs/schema/](src/mixs/schema/)\n      * [src/mixs/schema/mixs.yaml](src/mixs/schema/mixs.yaml) - LinkML YAML schema representing the MIxS standard\n  * [src/doc-templates/](src/doc-templates/) - jinja2 files that are responsible for the customization of layout and content of web documentation pages\n  * [src/scripts](src/scripts) - Python scripts for specific discovery/exploration/inference based on the MIxS YAML schema\n* [tests/](tests/) - test data files\n* [config.yaml](config.yaml) - config file to custom specify arguments for the LinkML project generator\n* [Makefile](Makefile) - Makefile containing pre-defined linkml-project-cookiecutter targets/rules\n* [project.Makefile](project.Makefile) - file that can be modified to extend pre-defined rules in [Makefile](Makefile)\n\n## LinkML:\n\nThe MIxS utilizes LinkML, see:\n[linkml-project-cookiecutter](https://github.com/linkml/linkml-project-cookiecutter).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenomicsstandardsconsortium%2Fmixs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenomicsstandardsconsortium%2Fmixs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenomicsstandardsconsortium%2Fmixs/lists"}