Skip to content

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

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