Skip to content

Main content

Research Item Skip Base Flag Tool

Research form-completion denominators only, without imputing skipped item scores.

Loading tool…

Description

Research form-completion denominators only, without imputing skipped item scores.

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.

Research form-completion denominators only, without imputing skipped item scores.

When to use this tool

Use Research Item Skip Base Flag 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 answered, skipped, inapplicable, includeSkipped. 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 denominator, unfilled, answeredShare, defined. Inspect defined before interpreting the associated values.

Return denominator=answered plus skipped only when includeSkipped, unfilled=skipped+inapplicable, and answeredShare when denominator is positive; otherwise return zero with defined false.1

Input fieldMeaning and unitsAccepted input
answeredAnsweredRequired. Safe integer; minimum 0.
skippedSkippedRequired. Safe integer; minimum 0.
inapplicableInapplicableRequired. Safe integer; minimum 0.
includeSkippedInclude SkippedRequired. Boolean.
Output fieldInterpretationReturned shape
denominatorDenominatorRequired. Safe integer.
unfilledSkipped plus inapplicable; not the selected denominator.Required. Safe integer.
answeredShareAnswered ShareRequired. Finite number.
definedWhether the stated denominator or quantity is defined; inspect before interpreting a placeholder.Required. Boolean.
json
{
  "input": {
    "answered": 8,
    "skipped": 2,
    "inapplicable": 1,
    "includeSkipped": true
  },
  "output": {
    "denominator": 10,
    "unfilled": 3,
    "answeredShare": 0.8,
    "defined": true
  }
}

Limitations and assumptions

  • Inapplicable always contributes to unfilled but never this denominator. This is supplied research completeness bookkeeping, not clinical questionnaire scoring or interpretation.
  • 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-item-skip-base-flag — tool.io

Similar or alternative tools