Description
Compare valueUnit and uncertaintyUnit literally; return a shared-unit suffix when equal or an explicit separate-unit suffix otherwise.
Measurement uncertainty notation needs a declared numerical scale, unit and interpretation. Parenthesized digits can refer to the last written places, while a coverage-factor suffix is only a label unless an uncertainty calculation supports it.
Compare valueUnit and uncertaintyUnit literally; return a shared-unit suffix when equal or an explicit separate-unit suffix otherwise.
When to use this tool
Use Measurement Uncertainty Parenthesis Unit Gap when you need the specified uncertainty-text layout or last-place conversion.
How to use the tool and how it works
- Enter valueUnit, uncertaintyUnit, uncertaintyDigits. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read sharesUnit, displaySuffix. Inspect sharesUnit before interpreting the associated values.
Require unsigned uncertaintyDigits. Compare valueUnit and uncertaintyUnit literally; return a shared-unit suffix when equal or an explicit separate-unit suffix otherwise.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| valueUnit | Value Unit | Required. Text; maximum UTF-16 length 8192. |
| uncertaintyUnit | Uncertainty Unit | Required. Text; maximum UTF-16 length 8192. |
| uncertaintyDigits | Uncertainty Digits | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| sharesUnit | Literal equality of unit strings, not physical equivalence. | Required. Boolean. |
| displaySuffix | Display Suffix | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"valueUnit": "m",
"uncertaintyUnit": "m",
"uncertaintyDigits": "12"
},
"output": {
"sharesUnit": true,
"displaySuffix": "(12) m"
}
}Limitations and assumptions
- String equality is not unit equivalence. The digits are not scaled, an uncertainty is not estimated, and the value itself is not formatted.
- 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.
Alternative or Complementary methods
Use an appropriate uncertainty analysis and reporting convention for real measurements. Verify units, decimal alignment, uncertainty type and coverage meaning separately from formatting.
References
Similar or alternative tools
- Plusminus Uncertainty Unit Sharing
Use (value ± uncertainty) unit when shared, otherwise repeat the unit after each supplied text.
- Interval Endpoint Unit Sharing Flag
Set canShare only when shareRequested and left/right unit strings match exactly; return the unit as suffix then, otherwise an empty suffix.