Class: EvidenceItem

name: EvidenceItem
description: 'One piece of evidence for a claim: which publication it comes from,
  an exact quote from that publication, whether the quote supports or refutes the
  claim, and what kind of study produced it.

  It also records where in the paper the supporting data sits: article_section says
  which section the quote was taken from (a dose quoted from Methods storage boilerplate
  is much weaker provenance than one quoted from Results), and figure_reference names
  the figure or table that reports the underlying data, so a reviewer can find values
  the extraction could not read out of a chart or image.'
from_schema: https://w3id.org/EHS-Data-Standards/soma
slots:
- reference
- reference_title
- supports
- evidence_source
- snippet
- explanation
- article_section
- figure_reference

name: EvidenceItem
description: 'One piece of evidence for a claim: which publication it comes from,
  an exact quote from that publication, whether the quote supports or refutes the
  claim, and what kind of study produced it.

  It also records where in the paper the supporting data sits: article_section says
  which section the quote was taken from (a dose quoted from Methods storage boilerplate
  is much weaker provenance than one quoted from Results), and figure_reference names
  the figure or table that reports the underlying data, so a reviewer can find values
  the extraction could not read out of a chart or image.'
from_schema: https://w3id.org/EHS-Data-Standards/soma
attributes:
  reference:
    name: reference
    implements:
    - linkml:authoritative_reference
    description: The cited publication's PubMed ID, e.g. "PMID:12345678".
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: reference
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    - PublicationReference
    range: PMID
    pattern: ^PMID:\d+$
  reference_title:
    name: reference_title
    implements:
    - dcterms:title
    description: The title of the cited publication, copied from the cached reference
      record (references_cache/), never typed from memory.
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: reference_title
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    - PublicationReference
    range: string
    recommended: true
  supports:
    name: supports
    description: 'Which way the quoted evidence points: does it support the claim,
      contradict it, or turn out not to bear on it at all.'
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: supports
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    range: EvidenceItemSupportEnum
  evidence_source:
    name: evidence_source
    description: What kind of study the cited publication reports — classify the paper,
      not the person doing the extraction.
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: evidence_source
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    range: EvidenceSourceEnum
  snippet:
    name: snippet
    implements:
    - linkml:excerpt
    description: 'An exact quote from the cited publication that supports or refutes
      the claim. Checked automatically: the text must appear word-for-word in the
      cached copy of the publication.'
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: snippet
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    range: string
  explanation:
    name: explanation
    description: One or two sentences on how the quoted passage supports the specific
      claim it is attached to.
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: explanation
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    range: string
  article_section:
    name: article_section
    description: 'The section of the publication the quoted passage comes from (abstract,
      methods, results, a figure caption, a table, ...). Recording the section makes
      provenance reviewable: a dose or response value quoted from Results carries
      more weight than one quoted from a Methods sentence about how a compound was
      stored.'
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: article_section
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    range: ArticleSectionEnum
  figure_reference:
    name: figure_reference
    description: The figure or table in the publication that reports the data behind
      this claim, written the way the paper labels it, e.g. "Figure 10", "Figure 3B",
      "Table 2". Use this whenever the quantitative result lives in a figure or chart
      — even when no exact value could be read from it — so a reviewer knows exactly
      where to look.
    from_schema: https://w3id.org/EHS-Data-Standards/soma
    rank: 1000
    alias: figure_reference
    owner: EvidenceItem
    domain_of:
    - EvidenceItem
    range: string