Description
Normalize a user-stated goal priority within supplied scale endpoints.
Mental-health records preserve instrument versions, recall wording, reporter roles, unknown responses and a person's own priorities. A missing code differs from a symptom rating, and a normalized preference is a scale position rather than a clinical urgency score. Recording these values does not assess mental state, diagnose a condition or choose care.
Normalize a user-stated goal priority within supplied scale endpoints.
When to use this tool
Use Mental Health Goal User Priority when you already have goalId, userPriority, scaleMinimum, scaleMaximum and need to normalize a user-stated goal priority within supplied scale endpoints.
How to use the tool and how it works
- Enter goalId, userPriority, scaleMinimum, scaleMaximum. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read label, normalizedPosition. Use the output convention below.
Require maximum>minimum and rating in [minimum,maximum]; return (priority-minimum)/(maximum-minimum) and preserve the raw priority label.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| goalId | Goal Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| userPriority | User Priority | Required. Finite number. |
| scaleMinimum | Scale Minimum | Required. Finite number. |
| scaleMaximum | Scale Maximum | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| label | Label | Required. Text; maximum UTF-16 length 8192. |
| normalizedPosition | (userPriority-min)/(max-min), a scale coordinate rather than a clinical score. | Required. Finite number. |
{
"input": {
"goalId": "G17",
"userPriority": 4,
"scaleMinimum": 1,
"scaleMaximum": 5
},
"output": {
"label": "G17; user priority=4",
"normalizedPosition": 0.75
}
}Limitations and assumptions
- Normalization preserves a stated scale position, not clinical urgency, treatment value or comparison across different scales.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- 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. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Consult the original instrument, language/version and reporter context for any substantive assessment. Preserve missing responses and user-selected goals explicitly; use the instrument's complete scoring process rather than treating one label or normalized preference as a clinical score.
References
Similar or alternative tools
- Rehab Goal Client Priority
Normalize a client's rehabilitation-goal priority within supplied endpoints.
- Support Goal User Selected Weight
Normalize one user-selected support-goal weight against a supplied total.