Skip to main content
Challenge

Build a District Cooling Primary-Secondary Bypass Flow Validator

Analyze tenant chilled water plate heat exchanger bypass submittals in Arabic and English. Verify decoupling line sizing against EnergyPlus primary-secondary loop guidelines to prevent thermal degradation and preserve network capacity.

EngineeringHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Analyze tenant chilled water plate heat exchanger bypass submittals in Arabic and English. Verify decoupling line sizing against EnergyPlus primary-secondary loop guidelines to prevent thermal degradation and preserve network capacity.

District Cooling Interconnection Specialist

Ingest tenant building cooling plant decoupling line specifications and bypass flow schedules in Arabic and English.

Calculate bypass hydraulic flow ratios against district cooling primary network loop capacities.

Simulate tenant building part-load bypass thermal mixing using EnergyPlus epJSON primary-secondary loop sizing outputs.

Compile an Arabic-English mechanical handover memorandum flagging primary-secondary bypass mixing risks.

Web submission portal displaying tenant submittal tables, decoupling line compliance badges, and parallel language technical findings.

Construct synthetic tenant handover documents, explicitly labeled as simplified synthetic app records, including design tons, bypass flow rates, and heat exchanger curves. Starter examples below are synthetic. They are not downloaded records.

EnergyPlus Extracts cooling coil bypass and decoupling flow sizing guidelines defined in EnergyPlus documentation to audit tenant submittals.

dspy, pydantic, fastapi. DSPy compiles robust prompt programs to extract and translate technical MEP parameters into structured bilingual verification records. Hosted Claude API for consistent technical terminology mapping across Arabic and English.

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.

Calculates mixed_return_temp_c as secondary_return_temp_c minus (bypass_flow_lps multiplied by 0.2) and flags if less than 10.0 degrees Celsius.

Extracts decoupling pipe diameter and flow velocity, comparing against network limits.

Generates a dual-language handover audit memo with explicit acceptance recommendations.

```json [ { "input": { "submittal_ref": "SUB-BP-104", "tenant_name_ar": "شركة الأفق للتجارة", "tenant_name_en": "Al-Ufuq Trading Co", "secondary_return_temp_c": 11, "bypass_flow_lps": 15, "decoupling_pipe_velocity_ms": 2.5 }, "expected_output": { "mixed_return_temp_c": 8, "compliant": false, "flagged_issue_en": "Bypass thermal mixing violation: mixed return temperature too low, minimum is 10.0 C", "flagged_issue_ar": "مخالفة الخلط الحراري: درجة حرارة الماء الراجع المخلوط منخفضة جداً، الحد الأدنى 10.0 مئوية", "status": "REJECTED_WITH_COMMENTS" } }, { "input": { "submittal_ref": "SUB-BP-105", "tenant_name_ar": "مركز الواحة المالي", "tenant_name_en": "Al-Waha Financial Center", "secondary_return_temp_c": 14.5, "bypass_flow_lps": 2, "decoupling_pipe_velocity_ms": 0.8 }, "expected_output": { "mixed_return_temp_c": 14.1, "compliant": true, "flagged_issue_en": "None", "flagged_issue_ar": "لا يوجد", "status": "APPROVED_FOR_COMMISSIONING" } } ] ```

District cooling approvals generated are advisory; final network connection valves must be unlocked only after field testing by utility staff. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

District cooling approvals generated are advisory; final network connection valves must be unlocked only after field testing by utility staff. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Calculates mixed_return_temp_c as secondary_return_temp_c minus (bypass_flow_lps multiplied by 0.2) and flags if less than 10.0 degrees Celsius. Extracts decoupling pipe diameter and flow velocity, comparing against network limits. Generates a dual-language handover audit memo with explicit acceptance recommendations.

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 tenant building cooling plant decoupling line specifications and bypass flow schedules in Arabic and English. Calculate bypass hydraulic flow ratios against district cooling primary network loop capacities. Simulate tenant building part-load bypass thermal mixing using EnergyPlus epJSON primary-secondary loop sizing outputs. Compile an Arabic-English mechanical handover memorandum flagging primary-secondary bypass mixing risks.

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

Calculates mixed_return_temp_c as secondary_return_temp_c minus (bypass_flow_lps multiplied by 0.2) and flags if less than 10.0 degrees Celsius. Extracts decoupling pipe diameter and flow velocity, comparing against network limits. Generates a dual-language handover audit memo with explicit acceptance recommendations.

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

Web submission portal displaying tenant submittal tables, decoupling line compliance badges, and parallel language technical findings.

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

District cooling approvals generated are advisory; final network connection valves must be unlocked only after field testing by utility staff.

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 tenant building cooling plant decoupling line specifications and bypass flow schedules in Arabic and English.

  • Calculate bypass hydraulic flow ratios against district cooling primary network loop capacities.

  • Simulate tenant building part-load bypass thermal mixing using EnergyPlus epJSON primary-secondary loop sizing outputs.

  • Compile an Arabic-English mechanical handover memorandum flagging primary-secondary bypass mixing risks.

Resources and assets

Reference links and supporting material

Dataset notes

Construct synthetic tenant handover documents, explicitly labeled as simplified synthetic app records, including design tons, bypass flow rates, and heat exchanger curves. 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 tenant building cooling plant decoupling line specifications and bypass flow schedules in Arabic and...
  • Calculates mixed_return_temp_c as secondary_return_temp_c minus (bypass_flow_lps multiplied by 0.2) and fla...
  • Web submission portal displaying tenant submittal tables, decoupling line compliance badges, and parallel l...
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 a District Cooling Primary-Secondary Bypass Flow Validator