Skip to content

Main content

Pain Diary Scale Step Tool

Express a supplied diary response difference in explicit scale steps without validated severity interpretation.

Loading tool…

Description

Express a supplied diary response difference in explicit scale steps without validated severity interpretation.

Research records distinguish observed, missing, inapplicable, and unverified entries. Those categories affect which denominator or weight a summary uses. A completeness or timing calculation describes the supplied records without assigning a clinical score or interpreting a condition.

Express a supplied diary response difference in explicit scale steps without validated severity interpretation.

When to use this tool

Use it for pain diary scale step when the required inputs and conventions are already available.

How to use the tool and how it works

  1. Enter firstValue, secondValue, suppliedStep, reverseDirection. Use the stated units and boundary conventions.
  2. Run the calculation. Correct any input error before interpreting a result.
  3. Read stepChange. Inspect any known, defined, inclusion, or boundary flags before interpreting numeric values.

Express the diary change as (secondValue-firstValue)/suppliedStep and reverse its sign when reverseDirection is true. The step must be positive.1

Input fieldMeaning and unitsAccepted input
firstValueFirst ValueRequired. Finite number.
secondValueSecond ValueRequired. Finite number.
suppliedStepSupplied StepRequired. Finite number; strictly above 0.
reverseDirectionReverse DirectionRequired. Boolean.
Output fieldInterpretationReturned shape
stepChangeStep ChangeRequired. Finite number.
json
{
  "input": {
    "firstValue": 3,
    "secondValue": 5,
    "suppliedStep": 0.5,
    "reverseDirection": false
  },
  "output": {
    "stepChange": 4
  }
}

Limitations and assumptions

  • The result is a count of supplied scale steps, not a severity category, treatment response, or clinically meaningful change threshold.
  • The field tables describe structural bounds; the mechanics also state cross-field requirements. Malformed input shapes, disallowed keys, and invalid domains cause input errors. Results must remain finite and within the declared output contract. A successful false flag or zero placeholder is distinct from an error.
  • Numeric arithmetic uses binary floating point. Exact comparisons have no hidden tolerance or decimal rounding; negative zero is exported as zero. Decimal-text integer operations retain the exactness specifically stated above.

Alternative or Complementary methods

For pain diary scale step, check the source records and the supplied rule before comparing the result with another method. Use an appropriately validated measurement or analysis method for clinical interpretation.

References

  1. Calculation and input contract: rheumatology/pain-diary-scale-step — tool.io

Similar or alternative tools