Skip to content

Main content

Research Episode Overlap Share Tool

Intersect explicitly annotated research episode intervals without diagnosing an episode.

Loading tool…

Description

Intersect explicitly annotated research episode intervals without diagnosing an episode.

Research questionnaires and interview records distinguish answered, declined, omitted, unpresented, and inapplicable items. Timing and support annotations also affect their denominators. A completeness measure or scale transformation describes those records without establishing an instrument score or a mental-health assessment.

Intersect explicitly annotated research episode intervals without diagnosing an episode.

When to use this tool

Use Research Episode Overlap Share when you need the particular completeness, timing, polarity, or bookkeeping term for supplied research and interview records.

How to use the tool and how it works

  1. Enter firstStart, firstEnd, secondStart, secondEnd. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read overlap, firstShare, defined. Inspect defined before interpreting the associated values.

Calculate overlap between two ordered time intervals and firstShare=overlap/(firstEnd-firstStart). Use zero with defined false when the first interval has zero length.1

Input fieldMeaning and unitsAccepted input
firstStartFirst StartRequired. Finite number.
firstEndFirst EndRequired. Finite number.
secondStartSecond StartRequired. Finite number.
secondEndSecond EndRequired. Finite number.
Output fieldInterpretationReturned shape
overlapOverlapRequired. Finite number.
firstShareFirst ShareRequired. Finite number.
definedWhether the stated denominator or quantity is defined; inspect before interpreting a placeholder.Required. Boolean.
json
{
  "input": {
    "firstStart": 10,
    "firstEnd": 20,
    "secondStart": 15,
    "secondEnd": 25
  },
  "output": {
    "overlap": 5,
    "firstShare": 0.5,
    "defined": true
  }
}

Limitations and assumptions

  • The share is relative to the first interval only. Timing records and episode definitions are supplied, without diagnostic episode classification, symptom severity, or inferred causality.
  • The field tables state structural bounds; the mechanics also specify cross-field constraints. Malformed inputs and unsupported domains cause errors. A successful false flag, empty branch value, or zero placeholder has the meaning stated above and is distinct from an input error.
  • Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Signed zero is exported as zero.

Alternative or Complementary methods

Use the relevant validated instrument and its documented missing-response and scoring procedures when the task requires an assessment. Verify research annotations and timing before combining record terms.

References

  1. Calculation and input contract: psychiatry/research-episode-overlap-share — tool.io

Similar or alternative tools