Class: Contig collection (ContigCollection)
A set of contigs that belong together, such as one isolate genome, one metagenome-assembled genome (MAG) bin, or one whole assembly.
URI: bfs:class/ContigCollection
classDiagram
class ContigCollection
click ContigCollection href "../../classes/ContigCollection/"
ContigCollection : collection_id
ContigCollection : collection_type
ContigCollection --> "0..1" ContigCollectionTypeEnum : collection_type
click ContigCollectionTypeEnum href "../../enums/ContigCollectionTypeEnum/"
ContigCollection : generated_by
ContigCollection : name
ContigCollection : source_files
ContigCollection : taxonomic_lineage
Slots
| Name | Cardinality and Range | Description | Inheritance |
|---|---|---|---|
| collection_id | 1 String |
Identifier of the genome, bin or assembly, from the system that defined it | direct |
| collection_type | 0..1 ContigCollectionTypeEnum |
What kind of contig collection this is | direct |
| name | 0..1 String |
Human-readable name, not an identifier and not unique: for a contig collectio... | direct |
| taxonomic_lineage | * String |
Ranked lineage path, domain to strain, one string per rank | direct |
| generated_by | 0..1 String |
The workflow execution (or tool run) that produced this ContigCollection, Con... | direct |
| source_files | * uri |
Source artifact URLs supporting this record, including any annotation sidecar... | direct |
Usages
| used by | used in | type | used |
|---|---|---|---|
| Dataset | contig_collections | range | ContigCollection |
| Contig | member_of | range | ContigCollection |
Notes
- Added for https://github.com/turbomam/feature-table-corpus/issues/41, so that "same organism" can be asked of features through their contigs. Mapped to the KBase CDM class of the same name (kbase/cdm-schema src/linkml/cdm_bioentity.yaml, commit c1a59b9, read 2026-09-25). CDM records the same membership in its Contig_x_ContigCollection table, defined in src/linkml/cdm_join_tables.yaml.
- Only isolate, mag, sag and virus collections stand for one organism. A metagenome or metatranscriptome collection is a whole community, so a same-organism query filters on collection_type.
- Assembly and bin statistics (N50, CheckM completeness and contamination) are left to CDM and source catalogues; this model only records membership.
Identifier and Mapping Information
Schema Source
- from schema: https://w3id.org/ber-data/feature-schemas
Mappings
| Mapping Type | Mapped Value |
|---|---|
| self | bfs:ContigCollection |
| native | bfs:ContigCollection |
| exact | kb_cdm:ContigCollection |
LinkML Source
Direct
name: ContigCollection
description: A set of contigs that belong together, such as one isolate genome, one
metagenome-assembled genome (MAG) bin, or one whole assembly.
title: Contig collection
notes:
- Added for https://github.com/turbomam/feature-table-corpus/issues/41, so that "same
organism" can be asked of features through their contigs. Mapped to the KBase CDM
class of the same name (kbase/cdm-schema src/linkml/cdm_bioentity.yaml, commit c1a59b9,
read 2026-09-25). CDM records the same membership in its Contig_x_ContigCollection
table, defined in src/linkml/cdm_join_tables.yaml.
- Only isolate, mag, sag and virus collections stand for one organism. A metagenome
or metatranscriptome collection is a whole community, so a same-organism query filters
on collection_type.
- Assembly and bin statistics (N50, CheckM completeness and contamination) are left
to CDM and source catalogues; this model only records membership.
from_schema: https://w3id.org/ber-data/feature-schemas
exact_mappings:
- kb_cdm:ContigCollection
slots:
- collection_id
- collection_type
- name
- taxonomic_lineage
- generated_by
- source_files
slot_usage:
collection_id:
name: collection_id
identifier: true
Induced
name: ContigCollection
description: A set of contigs that belong together, such as one isolate genome, one
metagenome-assembled genome (MAG) bin, or one whole assembly.
title: Contig collection
notes:
- Added for https://github.com/turbomam/feature-table-corpus/issues/41, so that "same
organism" can be asked of features through their contigs. Mapped to the KBase CDM
class of the same name (kbase/cdm-schema src/linkml/cdm_bioentity.yaml, commit c1a59b9,
read 2026-09-25). CDM records the same membership in its Contig_x_ContigCollection
table, defined in src/linkml/cdm_join_tables.yaml.
- Only isolate, mag, sag and virus collections stand for one organism. A metagenome
or metatranscriptome collection is a whole community, so a same-organism query filters
on collection_type.
- Assembly and bin statistics (N50, CheckM completeness and contamination) are left
to CDM and source catalogues; this model only records membership.
from_schema: https://w3id.org/ber-data/feature-schemas
exact_mappings:
- kb_cdm:ContigCollection
slot_usage:
collection_id:
name: collection_id
identifier: true
attributes:
collection_id:
name: collection_id
description: Identifier of the genome, bin or assembly, from the system that defined
it.
title: Collection ID
notes:
- Examples are an NMDC assembly workflow execution (nmdc:wfmgas-...), an NMDC
MAG bin name, or a JGI IMG taxon or Data Portal record. Use a CURIE when the
identifier has one.
from_schema: https://w3id.org/ber-data/feature-schemas
rank: 1000
identifier: true
owner: ContigCollection
domain_of:
- ContigCollection
range: string
required: true
collection_type:
name: collection_type
description: What kind of contig collection this is.
title: Collection type
from_schema: https://w3id.org/ber-data/feature-schemas
rank: 1000
owner: ContigCollection
domain_of:
- ContigCollection
range: ContigCollectionTypeEnum
name:
name: name
description: 'Human-readable name, not an identifier and not unique: for a contig
collection an organism and strain or a bin label; for a feature the GFF3 Name,
its display name.'
title: Name
from_schema: https://w3id.org/ber-data/feature-schemas
rank: 1000
owner: ContigCollection
domain_of:
- ContigCollection
- SequenceFeature
range: string
taxonomic_lineage:
name: taxonomic_lineage
description: Ranked lineage path, domain to strain, one string per rank.
title: Taxonomic lineage
notes:
- Left as a list rather than named rank slots (domain, phylum, class, ...), because
forcing a fixed depth breaks on any lineage reported at a different resolution.
Confirmed 2026-09-18 on one real run, per-contig lineage (Scaffold Lineage tsv)
and per-gene lineage (Gene Phylogeny tsv) for the same organism were reported
at different depths, 2 ranks versus 8.
from_schema: https://w3id.org/ber-data/feature-schemas
rank: 1000
list_elements_ordered: true
owner: ContigCollection
domain_of:
- Contig
- ContigCollection
range: string
multivalued: true
generated_by:
name: generated_by
description: The workflow execution (or tool run) that produced this ContigCollection,
Contig or SequenceFeature.
title: Generated by
notes:
- Confirmed 2026-09-18 against a real biosample's full sequencing, a Contig and
the Features on it typically come from two DIFFERENT workflow executions, not
one. A metagenome assembly workflow (e.g. nmdc:wfmgas-11-19jh9v28.1) produces
the Contig; a separate annotation workflow run against that assembly (e.g. nmdc:wfmgan-11-5xxrm214.2)
produces the SequenceFeature rows on it. Do not assume one workflow execution
id covers both.
from_schema: https://w3id.org/ber-data/feature-schemas
rank: 1000
owner: ContigCollection
domain_of:
- Contig
- ContigCollection
- SequenceFeature
range: string
source_files:
name: source_files
description: Source artifact URLs supporting this record, including any annotation
sidecars used.
title: Source files
notes:
- A sidecar may come from a different workflow than generated_by, for example
annotation lineage on an assembled Contig. Preserve each artifact's workflow
in its URL or manifest.
from_schema: https://w3id.org/ber-data/feature-schemas
rank: 1000
owner: ContigCollection
domain_of:
- Contig
- ContigCollection
- SequenceFeature
range: uri
multivalued: true