Skip to content

Main content

Blend Share Complement Gap Tool

Calculate blend share complement gap from explicit caller-supplied inputs.

Loading tool…

Description

Return expectedComplement=1-firstShare and gap=suppliedComplement-expectedComplement, requiring both supplied shares between zero and one.

A component share uses a stated whole and measurement basis. Complement shares should sum to one, while a concentration balance compares material amounts against a target composition. Fractions such as 0.25 represent 25 percent; an amount multiplied by a concentration difference is a signed material contribution.

Return expectedComplement=1-firstShare and gap=suppliedComplement-expectedComplement, requiring both supplied shares between zero and one.

When to use this tool

Use Blend Share Complement Gap when you need to check a two-share complement or one ingredient's signed contribution to a target composition.

How to use the tool and how it works

  1. Enter firstShare, suppliedComplement. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read expectedComplement, gap. Use the output convention below.

Return expectedComplement=1-firstShare and gap=suppliedComplement-expectedComplement, requiring both supplied shares between zero and one.1

Input fieldMeaning and unitsAccepted input
firstShareFirst ShareRequired. Finite number; minimum 0; maximum 1.
suppliedComplementSupplied ComplementRequired. Finite number; minimum 0; maximum 1.
Output fieldInterpretationReturned shape
expectedComplementExpected ComplementRequired. Finite number.
gapSupplied complement minus implied complement, in fraction units.Required. Finite number.
json
{
  "input": {
    "firstShare": 0.25,
    "suppliedComplement": 0.7
  },
  "output": {
    "expectedComplement": 0.75,
    "gap": -0.050000000000000044
  }
}

Limitations and assumptions

  • Gap is a signed fraction difference, not a percentage numeral. The calculation does not check whether the components describe an actual two-part blend.
  • 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.
  • 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

For a complete blend, assemble every component on one amount and concentration basis and solve the full material balance. Check whether the physical mixing process requires density or nonadditive-volume corrections.

References

  1. Calculation and input contract: proportions/blend-share-complement-gap — tool.io

Similar or alternative tools

  • Blend One Ingredient Target Contribution

    Return excessSolute=amount*(concentration-targetConcentration), requiring nonnegative amount and both concentrations as fractions between zero and one.

  • Conditional Event Complement Gap

    Return conditionalProbability=jointProbability/conditioningProbability, impliedComplement=1-conditionalProbability, and gap=suppliedComplement-impliedComplement.