Description
Return order=sign(left-right) and scaledGap=(left-right)/temperature for bounded cosine scores and positive temperature.
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.
Return order=sign(left-right) and scaledGap=(left-right)/temperature for bounded cosine scores and positive temperature.
When to use this tool
Use Cosine Temperature Ranking Order Flag 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 left, right, temperature. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read order, scaledGap. Use the output convention below.
Return order=sign(left-right) and scaledGap=(left-right)/temperature for bounded cosine scores and positive temperature.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| left | Left | Required. Finite number. |
| right | Right | Required. Finite number. |
| temperature | Temperature | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| order | Ordering sign or index under the specific convention stated above. | Required. Safe integer. |
| scaledGap | Scaled Gap | Required. Finite number. |
{
"input": {
"left": 0.75,
"right": 0.25,
"temperature": 0.5
},
"output": {
"order": 1,
"scaledGap": 1
}
}Limitations and assumptions
- Temperature changes gap magnitude but not the mathematical ranking. The tool does not compute cosines, normalize logits, calculate softmax probabilities, or select a calibration temperature.
- 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
- Cosine Antiparallel Negative Score Label
Return negative for score<0 and antiparallel when abs(score+1)<=tolerance.
- Cosine Dot Product Roundoff Clamp
Clamp cosine to minus one through one when it is within the supplied tolerance outside that interval.