{ "generatedAt": "2026-10-31T15:21:32.645Z", "describes": "7be26d1", "summary": "gridprims gives screening estimates, not utility studies. No tool has yet been checked against real bills or a utility's own figures. User problem reports are how we find our errors.", "levels": [ { "level": 0, "name": "unvalidated", "meaning": "The method is cited, but nothing independent has checked it yet." }, { "level": 1, "name": "self-checked", "meaning": "Our own worked examples and consistency tests pass, but no independent check has been run yet." }, { "level": 2, "name": "cross-checked", "meaning": "Results agree with an independent implementation or a published worked example within a stated tolerance." }, { "level": 3, "name": "field-verified", "meaning": "Results agree with real bills, utility figures, or practitioner calculations in at least 3 recorded cases." } ], "counts": { "unvalidated": 0, "self-checked": 6, "cross-checked": 7, "field-verified": 0 }, "tools": [ { "id": "calc.energy-units.convert", "title": "Energy unit converter", "version": "0.2.0", "stability": "stable", "validationLevel": 2, "validationName": "cross-checked", "evidence": [ { "kind": "own-examples", "summary": "Five worked examples, built from the cited NIST and EIA constants, pass within their tolerances." }, { "kind": "published-example", "summary": "Btu, watt-hour, kilowatt-hour, therm, and quad conversions agree with NIST SP 811 Appendix B.8 to every figure NIST prints. Fuel conversions reproduce EIA's published averages, which have no independent source." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "Three recorded real-world cases where a utility, a regulator, or a practitioner made the same conversion (for example a gas bill's therm-to-kWh line) would raise it to field-verified.", "claims": [], "limitations": [ "Fuel results use national averages; the gas or oil you buy can differ by a few percent.", "The coal figure is EIA's estimate for coal burned in power plants, not for home or industrial coal.", "Volumes and weights of fuels are not converted to each other except through their energy." ] }, { "id": "calc.energy-units.emissions", "title": "Emissions from electricity use", "version": "0.1.0", "stability": "experimental", "validationLevel": 2, "validationName": "cross-checked", "evidence": [ { "kind": "own-examples", "summary": "A worked example and the spec's 800 lb/MWh case (362.87 metric tons for 1,000 MWh) pass." }, { "kind": "published-example", "summary": "CO₂e computed from each subregion's CO₂, CH₄, and N₂O rates with the technical guide's GWPs matches eGRID's own published CO₂e rate within 0.1% in all 27 subregions." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "Three recorded cases where a utility or an emissions inventory used the same eGRID subregion rate would raise it to field-verified.", "claims": [], "limitations": [ "Average annual rates miss the hour-by-hour changes in the grid's mix; use hourly data when you have it.", "This is location-based accounting; contracts for clean power (market-based accounting) are not reflected.", "Rates are eGRID2023's; a newer edition will change them." ] }, { "id": "calc.power-factor.correct", "title": "Power factor correction", "version": "0.1.0", "stability": "experimental", "validationLevel": 2, "validationName": "cross-checked", "evidence": [ { "kind": "own-examples", "summary": "The spec's 236.8 kVAR, 641.0 and 526.3 kVA, and $1,384.62 penalty cases pass, and a target below the current power factor returns no correction." }, { "kind": "published-example", "summary": "Two published worked examples (DOE and WSU/NEEA) are reproduced within 1 kVAR." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "Three recorded installations where the sized bank and the bill change were checked against a utility's bills would raise it to field-verified.", "claims": [], "limitations": [ "The power factor is entered or derived from one kW and kVAR or kVA pair; a file with reactive readings gives a better basis.", "Only a tariff rule that scales billing demand to a power-factor threshold is priced here; kVA billing and per-kVAR charges are priced in the workbench's bill.", "Harmonics, resonance, and switching transients are not assessed." ] }, { "id": "calc.transformer.size", "title": "Transformer sizing and loading", "version": "0.1.0", "stability": "experimental", "validationLevel": 1, "validationName": "self-checked", "evidence": [ { "kind": "own-examples", "summary": "Hand-computed cases for single-phase, three-phase, and amps from kVA match to 0.1 kVA, and 498.8 kVA converts back to 600 A within 0.1 A. No freely published worked sizing example has been found to register." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "A freely published worked transformer-sizing example from a utility or government source, reproduced within 0.1 kVA, would raise it to cross-checked.", "claims": [], "limitations": [ "Names no standard rating; the standard list is in a paid IEEE standard.", "Does not compute permissible overload time, hot-spot or top-oil temperature, or loss of life.", "Assumes a balanced three-phase load; unbalanced loads need each phase checked." ] }, { "id": "calc.storage.basics", "title": "Battery duration and usable energy", "version": "0.1.0", "stability": "experimental", "validationLevel": 1, "validationName": "self-checked", "evidence": [ { "kind": "own-examples", "summary": "The spec's 5.33 h, 0.1875 C-rate, 360 MWh, and 423.5 MWh cases pass." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "A published battery worked example reproduced with the same convention would raise it to cross-checked.", "claims": [], "limitations": [ "Real duration depends on power level, temperature, and age; these are nameplate figures.", "Auxiliary loads and standby losses are not modeled." ] }, { "id": "calc.cost.lcoe", "title": "Levelized cost of energy", "version": "0.2.0", "stability": "experimental", "validationLevel": 2, "validationName": "cross-checked", "evidence": [ { "kind": "own-examples", "summary": "The spec's $41.10/MWh case passes, with each term shown." }, { "kind": "published-example", "summary": "NLR ATB 2025's published LCOE for nine technologies (utility, commercial, and residential PV, land-based and offshore wind, geothermal, hydropower, biopower, and CSP) is reproduced from each case's own inputs within 1%." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "Three recorded project cases where the LCOE was checked against a developer's or utility's own figure would raise it to field-verified.", "claims": [], "limitations": [ "A simple LCOE: no degradation, construction period, or tax detail beyond what the fixed charge rate carries.", "No defaults are offered; read the ATB for costs and capacity factors by technology." ] }, { "id": "calc.line-rating.ampacity", "title": "Overhead conductor ampacity", "version": "0.1.0", "stability": "experimental", "validationLevel": 2, "validationName": "cross-checked", "evidence": [ { "kind": "own-examples", "summary": "Higher wind raises the rating, 1,000 A at 230 kV is 398.4 MVA, and US and SI inputs agree within 0.01%." }, { "kind": "reference-output", "summary": "50 cases spanning conductor size, surface, temperature limits, weather, elevation, latitude, bearing, date, and hour match two open IEEE 738 implementations, linerate 5.0.0 and pypacity 0.1.3, within 1% (the largest difference is under 0.3%)." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "Three recorded line ratings from a utility's published facility ratings, reproduced under the same assumptions, would raise it to field-verified.", "claims": [], "limitations": [ "Steady state only: no transient or emergency rating.", "Resistance must be entered from the manufacturer's data; no public-domain resistance table exists.", "Clear-sky solar gain; haze, industrial atmosphere, and ground reflection are not modeled." ] }, { "id": "ratepayer.revenue-requirement.explain", "title": "Revenue requirement explainer", "version": "0.1.0", "stability": "experimental", "validationLevel": 1, "validationName": "self-checked", "evidence": [ { "kind": "own-examples", "summary": "The spec's 7.5% cost of capital, $150,000,000 return, $33,333,333 income tax, and $13,333,333 and $0.89 one-point sensitivity pass." } ], "evidencePassed": null, "needsFreshRun": true, "review": "pending", "toRaise": "Reproducing a public rate case order's revenue requirement summary within 0.5% from its own inputs would raise it to cross-checked.", "claims": [], "limitations": [ "A simplified cost-of-service formula: no deferred taxes, tax credits, or riders.", "Figures from FERC Form 1 are total-company and may cover more than one state or service." ] }, { "id": "electrify.service-headroom.check", "title": "Service headroom", "version": "0.1.0", "stability": "experimental", "validationLevel": 2, "validationName": "cross-checked", "evidence": [ { "kind": "own-examples", "summary": "The spec's 480 V scenario (126.3 kVA, 157.9 kVA, 189.9 A, 210.1 A, 174.7 kVA) and a twelve-bill example pass." }, { "kind": "published-example", "summary": "Two published worked examples (EC&M, 2014; Electrical Contractor, 2011) are reproduced to the whole amps they print: 123 A, 173 A, and 27 A spare; 929 A, 1,180 A, and 20 A spare." } ], "evidencePassed": null, "needsFreshRun": true, "review": "pending", "toRaise": "Three recorded cases where an electrician's 30-day recording and our figure from the same site were compared would raise it to field-verified.", "claims": [ "nec-2026-section-120-87" ], "limitations": [ "Not a code compliance decision; conductor sizing and full load calculations are out of scope.", "Sites with solar, wind, a battery, or peak shaving cannot use the 30-day option." ] }, { "id": "electrify.backup-power.size", "title": "Backup power size", "version": "0.1.0", "stability": "experimental", "validationLevel": 1, "validationName": "self-checked", "evidence": [ { "kind": "own-examples", "summary": "The spec's 9.6 kWh load list, 60 kWh usable and 75 kWh nameplate at 12 hours, and 7.0 kW generator with motor start pass, each hand-computed." } ], "evidencePassed": null, "needsFreshRun": true, "review": "pending", "toRaise": "Matching REopt's resilience results for the same critical load and outage would raise it to cross-checked.", "claims": [], "limitations": [ "County outage history means some customers in the county were out, not this address; durations are a typical guide, not a worst case.", "No inverter losses, battery aging, or temperature derating." ] }, { "id": "reliability.outage-log.indices", "title": "Reliability indices", "version": "0.1.0", "stability": "experimental", "validationLevel": 1, "validationName": "self-checked", "evidence": [ { "kind": "own-examples", "summary": "The spec's 1.5 interruptions, 200.0 minutes, 133.33 minutes per interrupted customer, and 99.9619% availability pass, and the momentary split." } ], "evidencePassed": null, "needsFreshRun": true, "review": "pending", "toRaise": "Reproducing a published worked example of the sustained indices to its printed precision would raise it to cross-checked.", "claims": [], "limitations": [ "Indices counting how often each customer was interrupted need per-customer records an event log does not hold; they are reported as unavailable, never estimated.", "Major event days need daily figures over several years: the workbench computes them from a whole log." ] }, { "id": "household.bill-totals.check", "title": "Bill check", "version": "0.1.0", "stability": "experimental", "validationLevel": 1, "validationName": "self-checked", "evidence": [ { "kind": "own-examples", "summary": "Three worked examples from the spec's scenarios, and 21 URDB rates classified and converted by hand, pass to the cent." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "Five published residential bill examples (state regulators' typical-bill tables) reproduced to the cent would raise it to cross-checked.", "claims": [], "limitations": [ "Taxes, local fees, and riders that the tariff data leaves out are not included, so a real bill is usually higher.", "Time-of-use energy is priced only from the kWh in each period as the bill prints them; a tiered time-of-use rate cannot be priced from totals.", "Demand charges need meter data and are not priced here.", "Export credits for net-metered months are not modeled; such a month prices only the charges that do not depend on kWh." ] }, { "id": "household.usage-benchmark.compare", "title": "Is my use high?", "version": "0.1.0", "stability": "experimental", "validationLevel": 2, "validationName": "cross-checked", "evidence": [ { "kind": "own-examples", "summary": "Two worked examples from the spec's scenarios pass, and three utilities' averages computed by hand from their EIA-861 rows match." }, { "kind": "published-example", "summary": "State averages computed from EIA-861 2024 match EIA's published Table 5A average monthly residential consumption in all 51 states." } ], "evidencePassed": "2026-10-31T15:21:53.718Z", "needsFreshRun": false, "review": "pending", "toRaise": "Three recorded real bills compared with their utility's published average would raise it to field-verified.", "claims": [], "limitations": [ "An average includes homes of every size, age, and heating type; a large or all-electric home can be well above it and use energy well.", "EIA-861 publishes no distribution of use, so this shows no percentile, rank, or \"homes like yours\".", "The averages are for the latest EIA-861 year, which may differ from the year of your bills." ] } ], "cannotDo": [ { "id": "circuit-model", "added": "2026-10-31", "title": "Anything that needs a utility's model of the circuit", "detail": "Fault current, interrupting capability, voltage and power quality, and transient stability.", "reason": "These need the utility's own circuit model and device ratings, which are not public and are often protected infrastructure information.", "sources": [ "docs/research/12-der-interconnection-screens.md, screens 2.2.1.4, 2.2.1.5, and 2.2.1.9", "18 CFR 388.113(c)(2)" ], "verified": true }, { "id": "nodal-prices", "added": "2026-10-31", "title": "Nodal or locational prices", "reason": "They need the grid operator's own network model, which we will not publish, and most operators forbid redistributing their price data.", "sources": [ "docs/research/15-browser-grid-modeling.md §6", "docs/research/13-governance-and-deferred-items.md, item 13h" ], "verified": true }, { "id": "adequacy", "added": "2026-10-31", "title": "Resource-adequacy figures", "detail": "Loss-of-load expectation, expected unserved energy, or an adequacy verdict. The reliability indices we compute from your own outage log are a different thing.", "reason": "Unit-level forced-outage data is confidential, the only freely locatable class averages we found are a 2010 vintage, and one operator's otherwise-free feed forbids redistribution.", "sources": [ "docs/research/15-browser-grid-modeling.md §5 (NERC GADS confidential; ISO-NE class averages, 2010 vintage)", "docs/research/13-governance-and-deferred-items.md, item 13f" ], "verified": false, "note": "Whether NERC publishes a current free class-average download could not be confirmed; its pages did not render outside a browser." }, { "id": "interconnection-verdict", "added": "2026-10-31", "title": "A pass or fail interconnection verdict", "reason": "Six of the twelve standard screens, including every screen that needs a model of the circuit, cannot be answered from public data.", "sources": [ "docs/research/12-der-interconnection-screens.md, summary" ], "verified": true }, { "id": "professional-advice", "added": "2026-10-31", "title": "Utility studies, engineering sign-off, or legal, tax, or investment advice", "reason": "gridprims gives screening estimates; a utility study, a licensed engineer, or a professional adviser is the final word.", "sources": [ "PRODUCT.md, Capabilities and Constraints" ], "verified": true }, { "id": "real-time", "added": "2026-10-31", "title": "Real-time or operational grid data", "reason": "Live feeds need servers and most operators restrict redistribution; we publish dated snapshots and link to live sources.", "sources": [ "openspec/changes/plan-launch-and-value-proof/design.md D4" ], "verified": true }, { "id": "forecasts", "added": "2026-10-31", "title": "Forecasts of prices, loads, or peak days", "reason": "Public data can describe what happened but cannot support a forecast we would stand behind.", "sources": [ "PRODUCT.md, Capabilities and Constraints" ], "verified": true }, { "id": "protected-infrastructure", "added": "2026-10-31", "title": "Anything that needs protected infrastructure information", "reason": "We publish only public data and never Critical Energy/Electric Infrastructure Information.", "sources": [ "18 CFR 388.113", "openspec/changes/establish-platform-foundation/specs/platform/data-snapshots/spec.md, CEII screen" ], "verified": true }, { "id": "feeder-or-address", "added": "2026-10-31", "title": "Feeder-level or address-level results that we publish", "detail": "What you compute from your own data on your own device is yours; we do not publish such results.", "reason": "Feeder and address detail can identify customers and infrastructure, and the data behind it is not public in most places.", "sources": [ "docs/research/12-der-interconnection-screens.md, minimum-load data" ], "verified": true } ], "unverifiedClaims": [ { "id": "pge-green-button-csv-layout", "claim": "PG&E's Green Button CSV starts with about five metadata rows, then TYPE, DATE, START TIME, END TIME, USAGE (kWh), COST, NOTES.", "brief": "docs/research/07-methods-and-formats-verification.md §3", "usedBy": [ "/files/ (file intake recognizes this layout)" ], "wouldConfirm": "One real PG&E export, with personal fields removed, sent through a problem report." }, { "id": "smart-meter-texas-columns", "claim": "Smart Meter Texas 15-minute exports carry ESIID, usage date, start and end times, kWh, an estimated flag, and a consumption or surplus column.", "brief": "docs/research/09-audiences-and-data-access.md §1a", "usedBy": [ "/files/ (file intake recognizes this layout)" ], "wouldConfirm": "One real Smart Meter Texas export, with the ESIID removed." }, { "id": "eia-861-release-month", "claim": "EIA posts the next EIA-861 release each August (an inferred date, not a posted one).", "brief": "docs/research/01-data-sources-and-licensing.md, EIA", "usedBy": [ "/data/eia-861/ (the expected next release)" ], "wouldConfirm": "EIA posting a release date for the 2026 data." }, { "id": "nec-2026-section-120-87", "claim": "The 2026 NEC moves 220.87, Determining Existing Loads, to 120.87, with the same 1-year and 30-day options and the same bar on the 30-day option for sites with solar, wind, or peak shaving.", "brief": "docs/derivations/service-headroom.md (Mike Holt's 2026 table of contents; Minnesota's 2026 adoption review)", "usedBy": [ "/tools/electrify/service-headroom/check/ (the 2026 edition option)" ], "wouldConfirm": "Reading 120.87 in the 2026 NEC through NFPA's free access." } ], "problems": { "automation": { "stalled": [ { "id": "heartbeat", "lastSuccess": null, "thresholdHours": 72 } ], "note": "Some scheduled jobs are stalled: data may be as old as their last successful run." }, "lateDatasets": [ { "id": "census-zcta-county", "title": "2020 ZCTA to County Relationship File (U.S. Census Bureau)", "due": "2022-12-09", "posted": false, "lateFrom": "2023-01-08", "late": true, "daysLate": 1422 }, { "id": "egrid", "title": "Emissions & Generation Resource Integrated Database (eGRID)", "due": "2026-01-31", "posted": true, "lateFrom": "2026-03-02", "late": true, "daysLate": 273 } ], "failingDatasets": [], "postureLimited": [], "corrections": { "populated": false, "note": "The corrections log is not yet populated; add-trust-and-continuity fills it." }, "referenceEngineGaps": { "populated": false, "note": "The tariff conformance suite will list the charge types its reference engines cannot check." } } }