Class: DatasetRelationship

Typed relationship to another dataset, enabling precise specification of how datasets relate to each other (e.g., supplements, derives from, is version of). Supports RO-Crate-style dataset interlinking.

__

URI: data_sheets_schema:DatasetRelationship

classDiagram class DatasetRelationship click DatasetRelationship href "../DatasetRelationship/" DatasetProperty <|-- DatasetRelationship click DatasetProperty href "../DatasetProperty/" DatasetRelationship : description DatasetRelationship : id DatasetRelationship : name DatasetRelationship : notes DatasetRelationship : relationship_type DatasetRelationship --> "1" DatasetRelationshipTypeEnum : relationship_type click DatasetRelationshipTypeEnum href "../DatasetRelationshipTypeEnum/" DatasetRelationship : source_caveats DatasetRelationship : target_dataset DatasetRelationship : used_software DatasetRelationship --> "*" Software : used_software click Software href "../Software/"

Inheritance

DatasetProperty
- DatasetRelationship

Slots

Name	Cardinality and Range	Description	Inheritance
target_dataset	1 String	The identifier or URL of the dataset this relationship points to	direct
relationship_type	1 DatasetRelationshipTypeEnum	The type of relationship (e	direct
description	0..1 String	Free-text description providing additional context about the relationship	direct
id	0..1 Uriorcurie	An optional identifier for this property	DatasetProperty
name	0..1 String	A human-readable name for this property	DatasetProperty
notes	0..1 String	Residual content only, after every fitting slot is used (#385): structured sl...	DatasetProperty
source_caveats	0..1 String	Commentary on the evidence behind this object's values — source conflicts, wh...	DatasetProperty
used_software	* Software	What software was used as part of this dataset property?	DatasetProperty

Usages

used by	used in	type	used
Dataset	related_datasets	range	DatasetRelationship
DataSubset	related_datasets	range	DatasetRelationship

Identifier and Mapping Information

Schema Source

from schema: https://w3id.org/bridge2ai/data-sheets-schema

Mappings

Mapping Type	Mapped Value
self	data_sheets_schema:DatasetRelationship
native	data_sheets_schema:DatasetRelationship

LinkML Source

Direct

name: DatasetRelationship
description: 'Typed relationship to another dataset, enabling precise specification
  of how datasets relate to each other (e.g., supplements, derives from, is version
  of). Supports RO-Crate-style dataset interlinking.

  '
from_schema: https://w3id.org/bridge2ai/data-sheets-schema
is_a: DatasetProperty
attributes:
  target_dataset:
    name: target_dataset
    description: The identifier or URL of the dataset this relationship points to.
    comments:
    - 'A reference, not an inline dataset. The description used to promise "identifier,
      URL, or Dataset object" while the range permitted only the first, and LinkML
      cannot express the union: its JSON Schema generator always emits a top-level
      type or $ref from the slot''s range, which ANDs with `any_of`, so whichever
      branch the range names the other one fails. Verified both ways on VOICE (#297).'
    - 'A related dataset with its own DOI, protocol and approval is its own datasheet
      and is referenced from here by identifier. That is the resolution of #292 for
      VOICE, whose pediatric companion has all three.'
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/composition
    rank: 1000
    slot_uri: dcterms:relation
    domain_of:
    - DatasetRelationship
    range: string
    required: true
  relationship_type:
    name: relationship_type
    description: The type of relationship (e.g., derives_from, supplements, is_version_of).
      Uses DatasetRelationshipTypeEnum for standardized relationship types.
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/composition
    rank: 1000
    slot_uri: schema:additionalType
    domain_of:
    - DatasetRelationship
    range: DatasetRelationshipTypeEnum
    required: true
  description:
    name: description
    description: Free-text description providing additional context about the relationship.
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/composition
    domain_of:
    - NamedThing
    - Organization
    - DatasetProperty
    - Grant
    - DatasetRelationship
    range: string

Induced

name: DatasetRelationship
description: 'Typed relationship to another dataset, enabling precise specification
  of how datasets relate to each other (e.g., supplements, derives from, is version
  of). Supports RO-Crate-style dataset interlinking.

  '
from_schema: https://w3id.org/bridge2ai/data-sheets-schema
is_a: DatasetProperty
attributes:
  target_dataset:
    name: target_dataset
    description: The identifier or URL of the dataset this relationship points to.
    comments:
    - 'A reference, not an inline dataset. The description used to promise "identifier,
      URL, or Dataset object" while the range permitted only the first, and LinkML
      cannot express the union: its JSON Schema generator always emits a top-level
      type or $ref from the slot''s range, which ANDs with `any_of`, so whichever
      branch the range names the other one fails. Verified both ways on VOICE (#297).'
    - 'A related dataset with its own DOI, protocol and approval is its own datasheet
      and is referenced from here by identifier. That is the resolution of #292 for
      VOICE, whose pediatric companion has all three.'
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/composition
    rank: 1000
    slot_uri: dcterms:relation
    alias: target_dataset
    owner: DatasetRelationship
    domain_of:
    - DatasetRelationship
    range: string
    required: true
  relationship_type:
    name: relationship_type
    description: The type of relationship (e.g., derives_from, supplements, is_version_of).
      Uses DatasetRelationshipTypeEnum for standardized relationship types.
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/composition
    rank: 1000
    slot_uri: schema:additionalType
    alias: relationship_type
    owner: DatasetRelationship
    domain_of:
    - DatasetRelationship
    range: DatasetRelationshipTypeEnum
    required: true
  description:
    name: description
    description: Free-text description providing additional context about the relationship.
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/composition
    alias: description
    owner: DatasetRelationship
    domain_of:
    - NamedThing
    - Organization
    - DatasetProperty
    - Grant
    - DatasetRelationship
    range: string
  id:
    name: id
    annotations:
      d4d:docExample:
        tag: d4d:docExample
        value: https://example.org/dataset/property-001
    description: An optional identifier for this property.
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/base
    slot_uri: schema:identifier
    alias: id
    owner: DatasetRelationship
    domain_of:
    - NamedThing
    - Organization
    - DatasetProperty
    - Grant
    range: uriorcurie
  name:
    name: name
    description: A human-readable name for this property.
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/base
    slot_uri: schema:name
    alias: name
    owner: DatasetRelationship
    domain_of:
    - NamedThing
    - Organization
    - DatasetProperty
    - Grant
    range: string
  notes:
    name: notes
    description: 'Residual content only, after every fitting slot is used (#385):
      structured slots first, description as the default home for narrative, notes
      last — solely for content description cannot hold. Never a restatement of a
      sibling slot''s value, and never a substitute for inventing keys the schema
      does not declare (#380).'
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/base
    slot_uri: schema:comment
    alias: notes
    owner: DatasetRelationship
    domain_of:
    - NamedThing
    - Organization
    - DatasetProperty
    - Grant
    range: string
  source_caveats:
    name: source_caveats
    description: 'Commentary on the evidence behind this object''s values — source
      conflicts, what a value was transcribed from, questions the source material
      leaves unanswered (#385). A trust annotation about the sibling slots, not dataset
      content: content belongs in the structured slots, description or notes.'
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/base
    slot_uri: dcterms:provenance
    alias: source_caveats
    owner: DatasetRelationship
    domain_of:
    - NamedThing
    - Organization
    - DatasetProperty
    - Grant
    range: string
  used_software:
    name: used_software
    description: What software was used as part of this dataset property?
    from_schema: https://w3id.org/bridge2ai/data-sheets-schema/base
    rank: 1000
    slot_uri: d4d:usedSoftware
    alias: used_software
    owner: DatasetRelationship
    domain_of:
    - DatasetProperty
    range: Software
    multivalued: true
    inlined: true
    inlined_as_list: true