Files
formulation/docs/help/recipes/scaling-and-yields.md
T

1.8 KiB

Scaling, Batching & Yield Calculations

Formulation is a weight-first formulation engine designed to scale recipes accurately across commercial batch sizes without calculation rounding drift.


1. Batch Multipliers vs. Yield-Target Scaling

Recipes can be scaled in two primary modes:

A. Batch Multiplier (x factor)

  • Entering a batch multiplier (e.g. 0.5x, 2x, 5x, 10x) multiplies every ingredient quantity by the exact factor.
  • Pre-configured quick buttons allow instant one-tap scaling during active kitchen prep.

B. Target Yield Scaling

  • Specify an exact required total batch yield (e.g., scale a sauce recipe to yield exactly 1,500 grams or 4.5 quarts).
  • Formulation calculates the precise scale factor required to produce that yield based on total recipe weight.

2. Weight-Based Auto-Yield Calculation

When Auto-Calculate Total Yield is toggled ON:

  1. Formulation calculates the weight in grams for every ingredient in the recipe using canonical unit conversion factors or ingredient-specific density measurements.
  2. The total recipe yield quantity is automatically updated as the exact sum of all ingredient weights.
  3. If an ingredient cannot be converted to weight (due to a missing UoM volume-to-weight equivalency), an informative notice displays: "Auto yield excludes N ingredient amounts without a weight equivalency."

3. Unit Conversion Safety

  • Ingredients measured in mass (e.g. g, kg, oz, lb) convert losslessly across all mass units.
  • Ingredients measured in volume (e.g. cup, tbsp, tsp, liter, ml) require an ingredient density measurement (e.g. 1 cup = 120g) to convert to mass.
  • Cross-dimensional universal conversions without density data are intentionally rejected to maintain strict culinary accuracy.