id: https://concepts.datalad.org/s/flat-study/unreleased
name: flat-study-schema
version: UNRELEASED
status: eunal:concept-status/DEPRECATED
title: FLAT study schema
description: |
  FLAT stands for Flexbile Low-complexity Annotation Technique.
  The FLAT-study schema contains classes to describe scientific studies.

  More information may be available on the schema's [about page](about).

  The schema definition is available as

  - [JSON-LD context](../unreleased.context.jsonld)
  - [LinkML YAML](../unreleased.yaml)
  - [LinkML YAML (static/resolved)](../unreleased.static.yaml)
  - [OWL TTL](../unreleased.owl.ttl)
  - [SHACL TTL](../unreleased.shacl.ttl)

comments:
  - ALL CONTENT HERE IS UNRELEASED AND MAY CHANGE ANY TIME

license: MIT

prefixes:
  dash: http://datashapes.org/dash#
  dcterms: http://purl.org/dc/terms/
  dlflat: https://concepts.datalad.org/s/flat/unreleased/
  dlflatstudy: https://concepts.datalad.org/s/flat-study/unreleased/
  dlidentifiers: https://concepts.datalad.org/s/identifiers/unreleased/
  dlcommonmx: https://concepts.datalad.org/s/common-mixin/unreleased/
  dlprovmx: https://concepts.datalad.org/s/prov-mixin/unreleased/
  dlquantmx: https://concepts.datalad.org/s/quantities-mixin/unreleased/
  dlrelationsmx: https://concepts.datalad.org/s/relations-mixin/unreleased/
  dlstudymx: https://concepts.datalad.org/s/study-mixin/unreleased/
  dlschemas: https://concepts.datalad.org/s/
  dlthings: https://concepts.datalad.org/s/things/v1/
  dltypes: https://concepts.datalad.org/s/types/v1/
  eunal: http://publications.europa.eu/resource/authority/
  foaf: http://xmlns.com/foaf/0.1/
  FRAPO: http://purl.org/cerif/frapo/
  linkml: https://w3id.org/linkml/
  obo: http://purl.obolibrary.org/obo/
  owl: http://www.w3.org/2002/07/owl#
  prov: http://www.w3.org/ns/prov#
  rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns#
  rdfs: http://www.w3.org/2000/01/rdf-schema#
  sh: http://www.w3.org/ns/shacl#
  skos: http://www.w3.org/2004/02/skos/core#
  w3ctr: https://www.w3.org/TR/
  xsd: http://www.w3.org/2001/XMLSchema#

default_prefix: dlflatstudy

emit_prefixes:
  - dlflat
  - dlflatstudy
  - dlidentifiers
  - dlcommonmx
  - dlprovmx
  - dlquantmx
  - dlrelationsmx
  - dlstudymx
  - dlthings
  - dltypes
  - rdf
  - rdfs
  - skos
  - xsd

imports:
  - dlschemas:flat/unreleased
  - dlschemas:common-mixin/unreleased
  - dlschemas:study-mixin/unreleased
  - dlschemas:prov-mixin/unreleased
  - dlschemas:relations-mixin/unreleased

classes:
  Study:
    is_a: FlatThing
    description: >-
      A planned process that consists of parts: planning, study design
      execution, documentation and which produce conclusion(s). An investigational
      endeavour that involves research, enabled by a project. The study
      relates to the scholarly and practical aspects of conducting the research
      itself, including the hypotheses being investigated, the data being
      gathered and analysed, the interpretations being drawn from the data,
      and the results obtained. In contrast, a project that enables it
      encompasses the administrative aspects of undertaking the endeavour,
      including the funding obtained, the people involved, and the management
      of the project in terms of deadlines and deliverables.
    exact_mappings:
      - obo:OBI_0000066
      - sio:SIO_001066
      - FRAPO:Investigation
    narrow_mappings:
      - sio:SIO_000994
      - obo:NCIT_C15206
    broad_mappings:
      - prov:Activity
      - obo:BFO_0000015
    slots:
      - associated_with
      - dimensions
      - factors
      - instruments
      - name
      - part_of
    slot_usage:
      name:
        annotations:
          sh:order: 1
      factors:
        annotations:
          sh:order: 2
      instruments:
        range: Thing
        annotations:
          sh:order: 3
      dimensions:
        annotations:
          sh:order: 4
      part_of:
        range: Study
        multivalued: true
        annotations:
          sh:order: 5
      associated_with:
        multivalued: true
        annotations:
          sh:order: 6
      description:
        annotations:
          sh:order: 7
          dash:singleLine: false

  Subject:
    is_a: FlatThing
    description: >-
      A subject is an entity being investigated in a study. This is a
      contextual entity. One and the same entity can be different
      subjects in two different studies.
    slots:
      - derived_from
      - kind
      - name
      - study
    slot_usage:
      study:
        range: Study
        annotations:
          sh:order: 1
      name:
        annotations:
          sh:order: 2
      kind:
        title: Type
        description: >-
          A classifier that identifies the nature/type of a subject.
          For specimen (a subject derived/taken from another subject),
          this classifier should be more precise than the classifier
          of the source subject.
        annotations:
          sh:order: 3
      description:
        annotations:
          sh:order: 4
          dash:singleLine: false
      derived_from:
        range: Subject
        annotations:
          sh:order: 5