Description
Measure the score range within a supplied absolute tolerance of one matching reference.
A similarity term depends on the comparison universe, missing-value policy, treatment of repeated features, and normalization. A score can also have a caller-selected value when its mathematical denominator vanishes. Those conventions matter before interpreting a threshold or comparing methods.
Measure the score range within a supplied absolute tolerance of one matching reference.
When to use this tool
Use Matching Score Tie Width when you need this particular comparison term, normalization, domain condition, or empty-result policy in a larger matching workflow.
How to use the tool and how it works
- Enter scores, reference, tolerance. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read minimum, maximum, width, tied. Use the output convention below.
Select scores within inclusive absolute tolerance of reference, require at least one selected value, and return minimum, maximum, width, and tied count.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| scores | Scores | Required. Array of finite number; maximum items 256. |
| reference | Reference | Required. Finite number. |
| tolerance | Nonnegative absolute tolerance in the tested quantity, unless a different convention is stated. | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| minimum | Minimum | Required. Finite number. |
| maximum | Maximum | Required. Finite number. |
| width | Width | Required. Finite number. |
| tied | Tied | Required. Safe integer. |
{
"input": {
"scores": [
0.7,
0.75,
0.9
],
"reference": 0.75,
"tolerance": 0.1
},
"output": {
"minimum": 0.7,
"maximum": 0.75,
"width": 0.050000000000000044,
"tied": 2
}
}Limitations and assumptions
- Duplicate scores count separately. This is a supplied numeric tie rule, not rank assignment, uncertainty estimation, threshold calibration, or a determination of equivalent real-world matches.
- 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
Compare methods only after aligning feature definitions, missingness, empty policies, multiplicities, and normalizers. Use a complete comparison when the tool returns only one contribution or count check.
References
Similar or alternative tools
- Containment Score Direction Reversal Gap
Calculate firstContainment=intersection/firstSize and secondContainment=intersection/secondSize, then gap=firstContainment-secondContainment.
- Cosine Antiparallel Negative Score Label
Return negative for score<0 and antiparallel when abs(score+1)<=tolerance.