Skip to content

Slot: Reason Value Is Missing (missing_reason)

Controlled reason a nullable slot is null. Every nullable slot in the EnVar schemas should be paired with a *_missing_reason slot taking this range. CF-Conventions "missing_value with reason" pattern lifted to the metadata layer.

Tier: optional

Why this slot matters

An unexplained empty field is ambiguous: it could be a terminal gap in the source product, a fixable extraction gap, or a pipeline bug that dropped data. Recording the reason lets completeness checkers and roadmap planning tell these apart instead of treating every blank as equally hopeless.

In plain terms

When a box on a form is left empty, it helps to know why — was the question not applicable, did nobody ask it, or did the answer get lost on the way? This slot records that "why" instead of leaving a silent blank.

URI: envar:slot/missing_reason

Properties

Type and Range

Property Value
Range MissingReasonEnum

Cardinality and Requirements

Property Value

Examples

Value
not_provided_by_source

See Also

Identifier and Mapping Information

Annotations

property value
tier optional
justification An unexplained empty field is ambiguous: it could be a terminal gap in the source product, a fixable extraction gap, or a pipeline bug that dropped data. Recording the reason lets completeness checkers and roadmap planning tell these apart instead of treating every blank as equally hopeless.
explanation When a box on a form is left empty, it helps to know why — was the question not applicable, did nobody ask it, or did the answer get lost on the way? This slot records that "why" instead of leaving a silent blank.

Schema Source

Mappings

Mapping Type Mapped Value
self envar:missing_reason
native envar:missing_reason

LinkML Source

name: missing_reason
annotations:
  tier:
    tag: tier
    value: optional
  justification:
    tag: justification
    value: 'An unexplained empty field is ambiguous: it could be a terminal gap in
      the source product, a fixable extraction gap, or a pipeline bug that dropped
      data. Recording the reason lets completeness checkers and roadmap planning tell
      these apart instead of treating every blank as equally hopeless.'
  explanation:
    tag: explanation
    value: When a box on a form is left empty, it helps to know why — was the question
      not applicable, did nobody ask it, or did the answer get lost on the way? This
      slot records that "why" instead of leaving a silent blank.
description: Controlled reason a nullable slot is null. Every nullable slot in the
  EnVar schemas should be paired with a *_missing_reason slot taking this range. CF-Conventions
  "missing_value with reason" pattern lifted to the metadata layer.
title: Reason Value Is Missing
examples:
- value: not_provided_by_source
  description: the source product genuinely does not produce this information
from_schema: https://w3id.org/linkml/microschemas/envar
see_also:
- https://cfconventions.org/
rank: 1000
range: MissingReasonEnum