Description
Return exact decimal numerator twice overlap and denominator firstSize+secondSize using BigInt, plus numeric dice.
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 exact decimal numerator twice overlap and denominator firstSize+secondSize using BigInt, plus numeric dice.
When to use this tool
Use Dice Overlap Count Contribution 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 overlap, firstSize, secondSize. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read numeratorDecimal, denominatorDecimal, dice, defined. Inspect defined before interpreting the associated values.
Return exact decimal numerator twice overlap and denominator firstSize+secondSize using BigInt, plus numeric dice. Use dice zero with defined false for a zero denominator; require feasible nonnegative integer counts.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| overlap | Overlap | Required. Safe integer; minimum 0. |
| firstSize | First Size | Required. Safe integer; minimum 0. |
| secondSize | Second Size | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| numeratorDecimal | Exact decimal twice-overlap count. | Required. Text; maximum UTF-16 length 8192. |
| denominatorDecimal | Exact decimal sum of support sizes. | Required. Text; maximum UTF-16 length 8192. |
| dice | Dice | Required. Finite number. |
| defined | Whether the stated denominator or quantity is defined; inspect before interpreting a placeholder. | Required. Boolean. |
{
"input": {
"overlap": 2,
"firstSize": 3,
"secondSize": 5
},
"output": {
"numeratorDecimal": "4",
"denominatorDecimal": "8",
"dice": 0.5,
"defined": true
}
}Limitations and assumptions
- The decimal terms preserve count exactness while dice uses floating-point division. No actual sets, duplicates policy, or meaningful match decision is verified.
- 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
- Similarity: Dice Jaccard Scalar Crosswalk
Crosswalk compatible set Dice and Jaccard scalar scores using their exact algebraic relation, preserving which score is the target.
- similarity/jaccard
Compare two sets using the size of their intersection and union.