Repository navigation
v0.4.0
The release that lets the sheet survey the building, not just solve it. E-02 cuts a ground through the desk out of real EnergyPlus runs, the sheet reads in SI or IP, and overheating is read against CIBSE TM59's moving comfort line. No breaking changes: every v0.3.0 permalink still decodes to the same building.
Features
-
A survey of the design space, on a second drawing (#54, #59): choose two controls and a reading, and E-02 cuts a ground through the desk from a real EnergyPlus run at every grid position, contoured on a plan and drawn in relief. Standing on a measured point moves E-01 to that design, and a ranking beside it names which of the ninety sweepable controls actually move the reading here. The contours between runs are declared as interpolation and no figure is read off them; a run that failed is a hole with its reason on it. Axes can be narrowed and swapped, visited designs restored, and a link carries the whole ground for the recipient to re-measure.
-
The sheet reads in SI or IP (#71): one control in the header stamp re-letters every figure on the page without moving the model. The IDF and every link are byte-identical either side of a switch, and a shared link carries no unit system, so one URL opens the same building for every reader. Eleven controls take a finer step that divides the old one exactly, so whole IP figures can be reached and existing links still land on the grid.
-
Overheating read against CIBSE TM59 (#46): a Room type on the Gains strip writes the method's occupancy, equipment and lighting profiles, and the scoreboard counts hours above a comfort line that moves with the outdoor running mean rather than a fixed number. It letters how many criteria were cleared out of how many it could read, never a pass or fail, since one zone on attached weather is not the method's assessment.
-
Studies plot the quantity you choose (#47): every open study shares one of eleven quantities, from temperature and TEDI/CEDI to cost, carbon and the TM59 criteria. A quantity the desk cannot produce stays listed with the reason and the action that enables it, and links now carry the chosen quantity and the open studies.
-
Study and survey the plant and the tariff (#81): seasonal efficiency, both COPs, the two prices and the grid intensity now carry Study and are axes on E-02, at no run beyond the one each shape needs. A reading a priced control cannot move is refused, with the readings it can.
-
Report a problem from the sheet (#64): a Report button gathers the link, build, engine errors, refusals in view and the last twenty actions into a slip the reader reads before one press opens a prefilled GitHub issue. That press is the only moment anything leaves their machine, and it works even when the engine fails to load. New issues are then sorted by Claude and labelled by idfkit-bot, which applies only what survives a check against the repository and never overrides a maintainer's label.
Fixes
-
A window-to-wall ratio now includes its frame, and a large framed window no longer stops the run (#58). The ratio is the rough opening, as ASHRAE 90.1 measures it, so a wider frame means less glass rather than a window bigger than its wall. Desks without a frame write the same file.
-
A heating setpoint above the cooling one no longer kills the run (#57). The System strip is blocked until the two are level or apart, instead of failing in the first warmup timestep.
-
Shades and rooflights too small to build are refused (#58, #62). Fins, overhangs and curbs 1 cm deep, and linear rooflight bands under 1 cm at the lowest skylight ratio, were deleted by EnergyPlus while the drawing still showed them.
-
A study no longer mixes a building with a system and one without (#57). A position where the swept control takes its own channel out of the model is refused and drawn as a gap with its reason, rather than measured.
-
The title block's Timestep cell follows the Solver strip (#77). It was lettered once at boot and never updated.
Changes to how the sheet reads
-
The sheet reads at a glance (#56): every reading, verdict, absence and refusal stays in view, while method notes, derivations and citations sit one press away in a fold under what they explain. Visible prose falls from about 2,700 words to under 600.
-
The idfkit libraries move to 0.3.0 (#53, #79):
@idfkit/core,@idfkit/schemasand@idfkit/weatherare pinned exactly, and every IDF and run bundle stamps the new version. Eight desk positions hold the same objects field for field; the file differs only in comment alignment and the order of eleven types, which run to byte-identical results under EnergyPlus 26.1.0.