analyze_efficiency
Calculate brewhouse efficiency for recent batches using measured OG, volume, and grain bill potential. Get per-batch breakdowns and aggregate statistics (mean, median, SD) to spot trends.
Instructions
Compute brewhouse efficiency across recent batches.
For each batch: potential points from the grain bill, measured OG points,
and the measured volume, combined as
(og_points * volume_gal) / potential_points.
Per-fermentable potential comes from Brewfather's stored potential field
when present (the figure the app itself calculates with), falling back to
46 * yield/100.
Args: limit: How many recent completed/archived batches to consider. Default 15. grain_only: Skip batches containing extract, sugar or other non-mashed fermentables, which inflate the figure. Default True. volume_basis: "fermenter" (default, matches Brewfather's own Brew House Efficiency — volume into the fermenter, so kettle losses count against you) or "post_boil" (kettle volume at flameout, which reads higher by exactly the transfer loss).
Returns: Per batch: name, brew date, target vs measured OG, target vs measured volume, computed efficiency, and Brewfather's stored figure with the delta between them. Then aggregates: mean, median, standard deviation, overall and split by batch size.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| grain_only | No | ||
| volume_basis | No | fermenter |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||