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

Scaling, Batching & Yield Calculations

Formulation is a weight-first formulation engine designed to scale recipes 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)

To scale by a batch multiplier:

1. Open the recipe in view mode or edit mode.
2. In the Batch field, enter a multiplier value (such as 0.5, 2, 5, or 10).
3. Every ingredient quantity scales proportionally by the exact factor.

B. Target Yield Scaling

To scale to a specific finished yield target:

1. Open the recipe.
2. In the Yield field, enter the target finished quantity.
3. Select the desired yield unit from the unit list.
4. Formulation computes the required scale factor based on total recipe weight and updates all ingredient quantities immediately.

---

2. Weight-Based Auto-Yield Calculation

To enable automatic total yield calculation:

1. Open the recipe in edit mode.
2. Turn on the Auto calculate total yield toggle.
3. Formulation calculates the weight in grams for every ingredient using standard conversion factors or ingredient-specific density measurements.
4. The total recipe yield quantity updates automatically to equal the exact sum of all ingredient weights.
5. If an ingredient lacks a volume-to-weight equivalency, a notice appears: "Auto yield excludes N ingredient amounts without a weight equivalency."

---

3. Unit Conversion Safety

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