Skip to main content
Challenge

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.

EngineeringHosted by Vera
Challenge brief

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.

Rules

Participation guide

Calculates simulated thermal property adjustments; does not execute physical construction or override professional mechanical designs. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

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.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

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.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

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.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Side-by-side assembly visualizer showing material layers, thermal resistance calculator, and epJSON export button.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Calculates simulated thermal property adjustments; does not execute physical construction or override professional mechanical designs.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

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.

Resources and assets

Reference links and supporting material

Dataset notes

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.

Evaluation checks
  • 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...
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 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

Action Space
  • DSPy · Optional
Training Infra
  • DSPy · Optional
Orchestration
  • 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.

Frequently Asked Questions about Build an EnergyPlus Thermal Envelope Material Specifier