Build an EnergyPlus Thermal Envelope Material Specifier
Evaluate commercial building envelope materials in EnergyPlus epJSON files. Generate optimized thermal conductivity and insulation thickness values to comply with building energy efficiency targets.
What you are building
The core problem, expected build, and operating context for this challenge.
Evaluate commercial building envelope materials in EnergyPlus epJSON files. Generate optimized thermal conductivity and insulation thickness values to comply with building energy efficiency targets.
Building envelope retrofit engineer
Ingest EnergyPlus epJSON building model containing Material and Construction object groups.
Analyze baseline thermal resistance and layer thickness of exterior wall assemblies.
Propose insulation layer thickness adjustments and updated thermal conductivity parameters.
Generate a revised epJSON Material block ready for simulated thermal performance runs.
Side-by-side assembly visualizer showing material layers, thermal resistance calculator, and epJSON export button.
Use public EnergyPlus sample epJSON models distributed under BSD-3 license in the NREL EnergyPlus repository. Starter examples below are synthetic. They are not downloaded records.
EnergyPlus Leverages EnergyPlus epJSON input schema conventions for Material and Construction objects described in documentation guides.
dspy, pydantic, fastapi. DSPy compiles robust prompt pipelines to extract and optimize material thermal parameters according to strict schema formats. Requires an LLM capable of numerical reasoning and JSON formatting, hosted remotely or locally via Ollama.
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.
Parses epJSON Material definitions including thickness, conductivity, density, and specific heat.
Ensures proposed retrofits decrease overall wall assembly thermal transmittance (U-factor).
Exports strictly valid epJSON syntax matching EnergyPlus schema definitions.
Provides human-in-the-loop review for material fire and moisture performance metrics.
```json [ { "input": { "material_name": "ExteriorWallInsulation", "current_properties": { "thickness": 0.05, "conductivity": 0.04, "density": 30, "specific_heat": 1400 }, "target_r_value_si": 2.5 }, "expected_output": { "material_name": "ExteriorWallInsulation", "recommended_properties": { "thickness": 0.08, "conductivity": 0.032, "density": 35, "specific_heat": 1450 }, "achieved_r_value_si": 2.5, "epjson_patch": { "Material": { "ExteriorWallInsulation": { "roughness": "MediumRough", "thickness": 0.08, "conductivity": 0.032, "density": 35, "specific_heat": 1450 } } } } }, { "input": { "material_name": "ExteriorWallInsulation", "current_properties": { "thickness": -0.02, "conductivity": 0 }, "target_r_value_si": 2.5 }, "expected_output": { "material_name": "ExteriorWallInsulation", "recommended_properties": null, "achieved_r_value_si": 0, "epjson_patch": null, "error": "Invalid material properties: thickness and conductivity must be positive" } } ] ```
Calculates simulated thermal property adjustments; does not execute physical construction or override professional mechanical designs. Use mock external writes. Require human review before any real deployment.
Participation guide
Calculates simulated thermal property adjustments; does not execute physical construction or override professional mechanical designs. Use mock external writes and human review.
How work is evaluated
Parses epJSON Material definitions including thickness, conductivity, density, and specific heat. Ensures proposed retrofits decrease overall wall assembly thermal transmittance (U-factor). Exports strictly valid epJSON syntax matching EnergyPlus schema definitions. Provides human-in-the-loop review for material fire and moisture performance metrics.
Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.
Challenge datasets
Public datasets, plus the private datasets you have access to.
How submissions are scored
These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.
Complete workflow
Ingest EnergyPlus epJSON building model containing Material and Construction object groups. Analyze baseline thermal resistance and layer thickness of exterior wall assemblies. Propose insulation layer thickness adjustments and updated thermal conductivity parameters. Generate a revised epJSON Material block ready for simulated thermal performance runs.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Correctness and evidence
Parses epJSON Material definitions including thickness, conductivity, density, and specific heat. Ensures proposed retrofits decrease overall wall assembly thermal transmittance (U-factor). Exports strictly valid epJSON syntax matching EnergyPlus schema definitions. Provides human-in-the-loop review for material fire and moisture performance metrics.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Review interface
Side-by-side assembly visualizer showing material layers, thermal resistance calculator, and epJSON export button.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Safe execution
Calculates simulated thermal property adjustments; does not execute physical construction or override professional mechanical designs.
This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.
What you should walk away with
Ingest EnergyPlus epJSON building model containing Material and Construction object groups.
Analyze baseline thermal resistance and layer thickness of exterior wall assemblies.
Propose insulation layer thickness adjustments and updated thermal conductivity parameters.
Generate a revised epJSON Material block ready for simulated thermal performance runs.
Reference links and supporting material
Use public EnergyPlus sample epJSON models distributed under BSD-3 license in the NREL EnergyPlus repository. Supplied starter examples are synthetic, not source extracts.
Challenge setup
Configuration summary for this challenge.
Challenge input
Input details are not configured.
DSPy
Prompt and LM program optimization framework.
Evaluated output
No output checks are configured.
- Ingest EnergyPlus epJSON building model containing Material and Construction object groups. Analyze baselin...
- Parses epJSON Material definitions including thickness, conductivity, density, and specific heat. Ensures p...
- Side-by-side assembly visualizer showing material layers, thermal resistance calculator, and epJSON export...
- 2 public reference cases
- 3 configured tools
Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.
View technical recipe
Configured tools
- DSPy · Optional
- DSPy · Optional
- DSPy · Optional
Evaluation contract
- Complete workflow · Weight 40
- Correctness and evidence · Weight 30
- Review interface · Weight 20
- Safe execution · Weight 10
Reference cases
- 2 public reference cases
Workflow tasks
No workflow tasks are configured.
Recipe freeze marker
No recipe freeze time is recorded.