Class: DefinedTerm¶

A controlled-vocabulary term (topic, biological scale, type-or-record, educational term, ...). It has a dual type set to the SKOS Concept type. The SKOS crosswalks below are INSTANCE-LEVEL — each term carries its own exactMatch/broadMatch IRI — which is exactly why they are slots on this class and NOT slot-level exact/broad_mappings on the referring properties. (The source class carries a code comment stating the same.)_

URI: schema:DefinedTerm

 classDiagram
    class DefinedTerm
    click DefinedTerm href "../../classes/DefinedTerm/"
      Thing <|-- DefinedTerm
        click Thing href "../../classes/Thing/"

      DefinedTerm : broadMatch

      DefinedTerm : description

      DefinedTerm : displayName

      DefinedTerm : exactMatch

      DefinedTerm : id

      DefinedTerm : identifier

      DefinedTerm : inDefinedTermSet

      DefinedTerm : name

      DefinedTerm : sameAs

      DefinedTerm : url

Inheritance¶

Thing
- DefinedTerm

Class Properties¶

Property	Value
Class URI	schema:DefinedTerm

Slots¶

Name	Cardinality and Range	Description	Inheritance
displayName	0..1 String	Human-readable display label for the term.	direct
exactMatch	0..1 Uriorcurie	SKOS exact-match crosswalk IRI. Instance-level (per term), not a slot-level mapping.	direct
broadMatch	0..1 Uriorcurie	SKOS broad-match crosswalk IRI. Instance-level (per term), not a slot-level mapping.	direct
inDefinedTermSet	1 Uriorcurie	Which MIDAS controlled-vocabulary axis this term fills — NOT the ontology the term is drawn from (that is the term's own id). Exactly one of four MIDAS axis IRIs: midas2 (topic), midas10 (digital object type / type-or-record), midas03 (geographic resolution), midas5 (biological scale). Required so every term declares which field it is for; the per-axis rules below then constrain the term id to that axis's accepted ontologies.	direct
id	1 Uriorcurie	Unique identifier (IRI/URL) for this resource. In JSON-LD, @id represents the globally unique identifier. (Maps to @id; the identifier slot is bound to @id by gen-jsonld-context.)	Thing
identifier	0..1 recommended String	Primary persistent identifier for this resource (e.g., DOI, Handle, ARK, or persistent URL). Can be a simple string or PropertyValue object.	Thing
name	0..1 String	Title or name of the digital object, page, or resource.	Thing
description	0..1 String	Brief description of the data. For datasets: what is included (variables, measurements), method/origin. For software: what it does, access requirements, supported languages.	Thing
url	0..1 Uri	URL to the website that contains and/or describes the digital object or person.	Thing
sameAs	0..1 Uri	URL of a reference web page that unambiguously indicates the item's identity (e.g., ORCID profile, Wikidata entry). NOTE: deliberately NOT mapped to dcat:landingPage — although CreativeWork populates sameAs from the landing page, this is a generic Thing slot (a Person's sameAs is an ORCID, not a landing page), so the landing-page equivalence is builder behavior, not a slot-level fact.	Thing

Usages¶

used by	used in	type	used
CreativeWork	about	range	DefinedTerm
DataCatalog	about	range	DefinedTerm
RelatedData	about	range	DefinedTerm
PropertyValue	valueReference	range	DefinedTerm
Dataset	about	range	DefinedTerm
SoftwareApplication	about	range	DefinedTerm
Dashboard	about	range	DefinedTerm
Repository	about	range	DefinedTerm
Literature	about	range	DefinedTerm
ModelingStudy	about	range	DefinedTerm
DiseaseSpecificCollection	about	range	DefinedTerm
LearningResource	educationalLevel	range	DefinedTerm
LearningResource	educationalUse	range	DefinedTerm
LearningResource	audience	range	DefinedTerm
LearningResource	educationalObjective	range	DefinedTerm
LearningResource	competencyRequired	range	DefinedTerm
LearningResource	teaches	range	DefinedTerm
LearningResource	learningResourceType	range	DefinedTerm
LearningResource	dataRequirement	range	DefinedTerm
LearningResource	about	range	DefinedTerm
Course	educationalLevel	range	DefinedTerm
Course	educationalUse	range	DefinedTerm
Course	audience	range	DefinedTerm
Course	educationalObjective	range	DefinedTerm
Course	competencyRequired	range	DefinedTerm
Course	teaches	range	DefinedTerm
Course	learningResourceType	range	DefinedTerm
Course	dataRequirement	range	DefinedTerm
Course	about	range	DefinedTerm

Rules¶

¶

Rule Applied	Preconditions	Postconditions	Elseconditions
slot_conditions	`{'inDefinedTermSet': {'equals_string': 'http://w3id.org/midas-metadata/midas10'}}`	`{'id': {'pattern': '^(http://purl\\.obolibrary\\.org/obo/\|http://w3id\\.org/midas-metadata/).+$'}}`

¶

Rule Applied	Preconditions	Postconditions	Elseconditions
slot_conditions	`{'inDefinedTermSet': {'equals_string': 'http://w3id.org/midas-metadata/midas03'}}`	`{'id': {'pattern': '^(http://rdfs\\.co/juso/\|https://www\\.wikidata\\.org/wiki/\|http://www\\.geonames\\.org/ontology#\|https?://schema\\.org/\|http://w3id\\.org/midas-metadata/).+$'}}`

¶

Rule Applied	Preconditions	Postconditions	Elseconditions
slot_conditions	`{'inDefinedTermSet': {'equals_string': 'http://w3id.org/midas-metadata/midas5'}}`	`{'id': {'pattern': '^http://w3id\\.org/midas-metadata/.+$'}}`

¶

Rule Applied	Preconditions	Postconditions	Elseconditions
slot_conditions	`{'inDefinedTermSet': {'equals_string': 'http://w3id.org/midas-metadata/midas2'}}`	`{'id': {'pattern': '^(http://purl\\.obolibrary\\.org/obo/\|http://w3id\\.org/midas-metadata/\|http://edamontology\\.org/\|http://www\\.ontodm\\.com/OntoDM-core/\|http://vocabs\\.lter-europe\\.net/EnvThes/).+$'}}`

Identifier and Mapping Information¶

Schema Source¶

from schema: https://w3id.org/midas-catalog/schema

Mappings¶

Mapping Type	Mapped Value
self	schema:DefinedTerm
native	midas:DefinedTerm
exact	skos:Concept

LinkML Source¶

Direct¶

name: DefinedTerm
description: A controlled-vocabulary term (topic, biological scale, type-or-record,
  educational term, ...). It has a dual type set to the SKOS Concept type. The SKOS
  crosswalks below are INSTANCE-LEVEL — each term carries its own exactMatch/broadMatch
  IRI — which is exactly why they are slots on this class and NOT slot-level exact_/broad_mappings
  on the referring properties. (The source class carries a code comment stating the
  same.)
from_schema: https://w3id.org/midas-catalog/schema
exact_mappings:
- skos:Concept
is_a: Thing
slots:
- displayName
- exactMatch
- broadMatch
- inDefinedTermSet
slot_usage:
  inDefinedTermSet:
    name: inDefinedTermSet
    description: 'Which MIDAS controlled-vocabulary axis this term fills — NOT the
      ontology the term is drawn from (that is the term''s own id). Exactly one of
      four MIDAS axis IRIs: midas2 (topic), midas10 (digital object type / type-or-record),
      midas03 (geographic resolution), midas5 (biological scale). Required so every
      term declares which field it is for; the per-axis rules below then constrain
      the term id to that axis''s accepted ontologies.'
    required: true
    pattern: ^http://w3id\.org/midas-metadata/(midas2|midas10|midas03|midas5)$
class_uri: schema:DefinedTerm
rules:
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas10
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^(http://purl\.obolibrary\.org/obo/|http://w3id\.org/midas-metadata/).+$
  description: 'Digital-object-type (type-or-record, midas10) terms: id from an accepted
    ontology — OBO Library or the MIDAS metadata vocabulary. Specific term open.'
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas03
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^(http://rdfs\.co/juso/|https://www\.wikidata\.org/wiki/|http://www\.geonames\.org/ontology#|https?://schema\.org/|http://w3id\.org/midas-metadata/).+$
  description: 'Geographic-resolution (midas03) terms: id from JUSO, Wikidata, the
    GeoNames ontology, or schema.org. Specific term open.'
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas5
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^http://w3id\.org/midas-metadata/.+$
  description: 'Biological-scale (midas5) terms: id from the MIDAS metadata vocabulary.
    Specific term open.'
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas2
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^(http://purl\.obolibrary\.org/obo/|http://w3id\.org/midas-metadata/|http://edamontology\.org/|http://www\.ontodm\.com/OntoDM-core/|http://vocabs\.lter-europe\.net/EnvThes/).+$
  description: 'Topic (midas2) terms: id from an accepted ontology — OBO Library,
    the MIDAS metadata vocabulary, EDAM, OntoDM-core, or LTER-Europe EnvThes. Specific
    term open. (Topic vocabulary is under active re-work; widen this list as new source
    ontologies appear — a non-breaking minor bump.)'

Induced¶

name: DefinedTerm
description: A controlled-vocabulary term (topic, biological scale, type-or-record,
  educational term, ...). It has a dual type set to the SKOS Concept type. The SKOS
  crosswalks below are INSTANCE-LEVEL — each term carries its own exactMatch/broadMatch
  IRI — which is exactly why they are slots on this class and NOT slot-level exact_/broad_mappings
  on the referring properties. (The source class carries a code comment stating the
  same.)
from_schema: https://w3id.org/midas-catalog/schema
exact_mappings:
- skos:Concept
is_a: Thing
slot_usage:
  inDefinedTermSet:
    name: inDefinedTermSet
    description: 'Which MIDAS controlled-vocabulary axis this term fills — NOT the
      ontology the term is drawn from (that is the term''s own id). Exactly one of
      four MIDAS axis IRIs: midas2 (topic), midas10 (digital object type / type-or-record),
      midas03 (geographic resolution), midas5 (biological scale). Required so every
      term declares which field it is for; the per-axis rules below then constrain
      the term id to that axis''s accepted ontologies.'
    required: true
    pattern: ^http://w3id\.org/midas-metadata/(midas2|midas10|midas03|midas5)$
attributes:
  displayName:
    name: displayName
    description: Human-readable display label for the term.
    from_schema: https://w3id.org/midas-catalog/schema
    exact_mappings:
    - schema:alternateName
    rank: 1000
    slot_uri: schema:alternateName
    owner: DefinedTerm
    domain_of:
    - DefinedTerm
    range: string
  exactMatch:
    name: exactMatch
    description: SKOS exact-match crosswalk IRI. Instance-level (per term), not a
      slot-level mapping.
    from_schema: https://w3id.org/midas-catalog/schema
    rank: 1000
    slot_uri: skos:exactMatch
    owner: DefinedTerm
    domain_of:
    - DefinedTerm
    range: uriorcurie
  broadMatch:
    name: broadMatch
    description: SKOS broad-match crosswalk IRI. Instance-level (per term), not a
      slot-level mapping.
    from_schema: https://w3id.org/midas-catalog/schema
    rank: 1000
    slot_uri: skos:broadMatch
    owner: DefinedTerm
    domain_of:
    - DefinedTerm
    range: uriorcurie
  inDefinedTermSet:
    name: inDefinedTermSet
    description: 'Which MIDAS controlled-vocabulary axis this term fills — NOT the
      ontology the term is drawn from (that is the term''s own id). Exactly one of
      four MIDAS axis IRIs: midas2 (topic), midas10 (digital object type / type-or-record),
      midas03 (geographic resolution), midas5 (biological scale). Required so every
      term declares which field it is for; the per-axis rules below then constrain
      the term id to that axis''s accepted ontologies.'
    from_schema: https://w3id.org/midas-catalog/schema
    rank: 1000
    slot_uri: schema:inDefinedTermSet
    owner: DefinedTerm
    domain_of:
    - DefinedTerm
    range: uriorcurie
    required: true
    pattern: ^http://w3id\.org/midas-metadata/(midas2|midas10|midas03|midas5)$
  id:
    name: id
    description: Unique identifier (IRI/URL) for this resource. In JSON-LD, @id represents
      the globally unique identifier. (Maps to @id; the identifier slot is bound to
      @id by gen-jsonld-context.)
    from_schema: https://w3id.org/midas-catalog/schema
    rank: 1000
    identifier: true
    owner: DefinedTerm
    domain_of:
    - Thing
    - ConformsTo
    - ProvActivity
    - ProvEntity
    - ProvAgent
    - MediaType
    - WebResource
    range: uriorcurie
    required: true
  identifier:
    name: identifier
    description: Primary persistent identifier for this resource (e.g., DOI, Handle,
      ARK, or persistent URL). Can be a simple string or PropertyValue object.
    from_schema: https://w3id.org/midas-catalog/schema
    rank: 1000
    slot_uri: schema:identifier
    owner: DefinedTerm
    domain_of:
    - Thing
    - ProvEntity
    range: string
    recommended: true
  name:
    name: name
    description: Title or name of the digital object, page, or resource.
    from_schema: https://w3id.org/midas-catalog/schema
    exact_mappings:
    - dcterms:title
    rank: 1000
    slot_uri: schema:name
    owner: DefinedTerm
    domain_of:
    - Thing
    - ConformsTo
    - ProvEntity
    - ProvAgent
    - PropertyValue
    range: string
  description:
    name: description
    description: 'Brief description of the data. For datasets: what is included (variables,
      measurements), method/origin. For software: what it does, access requirements,
      supported languages.'
    from_schema: https://w3id.org/midas-catalog/schema
    exact_mappings:
    - dcterms:description
    rank: 1000
    slot_uri: schema:description
    owner: DefinedTerm
    domain_of:
    - Thing
    - ConformsTo
    range: string
  url:
    name: url
    description: URL to the website that contains and/or describes the digital object
      or person.
    from_schema: https://w3id.org/midas-catalog/schema
    rank: 1000
    slot_uri: schema:url
    owner: DefinedTerm
    domain_of:
    - Thing
    - ConformsTo
    - ProvAgent
    - DataDownload
    range: uri
  sameAs:
    name: sameAs
    description: 'URL of a reference web page that unambiguously indicates the item''s
      identity (e.g., ORCID profile, Wikidata entry). NOTE: deliberately NOT mapped
      to dcat:landingPage — although CreativeWork populates sameAs from the landing
      page, this is a generic Thing slot (a Person''s sameAs is an ORCID, not a landing
      page), so the landing-page equivalence is builder behavior, not a slot-level
      fact.'
    from_schema: https://w3id.org/midas-catalog/schema
    rank: 1000
    slot_uri: schema:sameAs
    owner: DefinedTerm
    domain_of:
    - Thing
    - Location
    range: uri
class_uri: schema:DefinedTerm
rules:
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas10
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^(http://purl\.obolibrary\.org/obo/|http://w3id\.org/midas-metadata/).+$
  description: 'Digital-object-type (type-or-record, midas10) terms: id from an accepted
    ontology — OBO Library or the MIDAS metadata vocabulary. Specific term open.'
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas03
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^(http://rdfs\.co/juso/|https://www\.wikidata\.org/wiki/|http://www\.geonames\.org/ontology#|https?://schema\.org/|http://w3id\.org/midas-metadata/).+$
  description: 'Geographic-resolution (midas03) terms: id from JUSO, Wikidata, the
    GeoNames ontology, or schema.org. Specific term open.'
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas5
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^http://w3id\.org/midas-metadata/.+$
  description: 'Biological-scale (midas5) terms: id from the MIDAS metadata vocabulary.
    Specific term open.'
- preconditions:
    slot_conditions:
      inDefinedTermSet:
        name: inDefinedTermSet
        equals_string: http://w3id.org/midas-metadata/midas2
  postconditions:
    slot_conditions:
      id:
        name: id
        pattern: ^(http://purl\.obolibrary\.org/obo/|http://w3id\.org/midas-metadata/|http://edamontology\.org/|http://www\.ontodm\.com/OntoDM-core/|http://vocabs\.lter-europe\.net/EnvThes/).+$
  description: 'Topic (midas2) terms: id from an accepted ontology — OBO Library,
    the MIDAS metadata vocabulary, EDAM, OntoDM-core, or LTER-Europe EnvThes. Specific
    term open. (Topic vocabulary is under active re-work; widen this list as new source
    ontologies appear — a non-breaking minor bump.)'