Description
Subtract excluded amounts from part and whole, then return their share when remainingWhole is positive, otherwise zero with defined false.
A ratio compares quantities under a stated numerator and denominator. Fractions, percentage numerals, and percentage-point changes use different conventions, and changing a part can also change its whole. Unit consistency, zero denominators, rounding, and the order of adjustments determine the result.
Subtract excluded amounts from part and whole, then return their share when remainingWhole is positive, otherwise zero with defined false.
When to use this tool
Use Part Share After Exclusion when you need this specific ratio, allocation, transformation, interval, or adjustment-order calculation with an explicit base.
How to use the tool and how it works
- Enter part, whole, excludedFromWhole, excludedFromPart. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read remainingPart, remainingWhole, share, defined. Inspect defined before interpreting the associated values.
Subtract excluded amounts from part and whole, then return their share when remainingWhole is positive, otherwise zero with defined false. Require nonnegative feasible nested part and exclusion quantities.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| part | Part | Required. Finite number; minimum 0. |
| whole | Whole | Required. Finite number; minimum 0. |
| excludedFromWhole | Excluded From Whole | Required. Finite number; minimum 0. |
| excludedFromPart | Excluded From Part | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| remainingPart | Remaining Part | Required. Finite number. |
| remainingWhole | Remaining Whole | Required. Finite number. |
| share | Dimensionless fraction using the stated denominator; not a percentage numeral. | Required. Finite number. |
| defined | Whether the stated denominator or quantity is defined; inspect before interpreting a placeholder. | Required. Boolean. |
{
"input": {
"part": 30,
"whole": 100,
"excludedFromWhole": 20,
"excludedFromPart": 10
},
"output": {
"remainingPart": 20,
"remainingWhole": 80,
"share": 0.25,
"defined": true
}
}Limitations and assumptions
- The caller supplies both exclusions and their overlap relationship. Undefined share is a placeholder; no category membership, missing-data adjustment, or appropriate denominator is independently 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
Check numerator, denominator, units, and adjustment order before comparing results. Use a complete allocation or physical mixture model when a single arithmetic term leaves relevant constraints unspecified.
References
Similar or alternative tools
- Weighted Composition One Part Perturbation
Calculate newFraction=(part+change)/(total+change) and fractionChange=newFraction-part/total.
- Chained Retention Log Loss Term
Sum natural logarithms of retentionFractions for logRetention and exponentiate for retainedFraction.