RDD
Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.
EnergyPlus Report Data Dictionary.
At a glance
| Original creator | EnergyPlus (U.S. Department of Energy) |
| Purpose | The EnergyPlus report data dictionary: every output variable a run could report, the list a modeller picks Output:Variable objects from. |
| Extensions | .rdd |
| Poka parser | poka-rdd |
| Viewer | poka-table-viewer |
| Depth tier | Parser with a shared viewer (see Depth tiers) |
| Breadth tier | B1 Complete (see Breadth tiers) |
How much Poka reads
B1 Complete. Everything the format defines that a reader would see is decoded, in every version Poka claims. Anything not decoded is immaterial and listed.
Confidence: high (the reviewer read the code and a test that proves the claim). Basis: Reviewed 2026-10-16: parsers/poka-rdd/src/lib.rs, tests/samples.rs; corpus oracle_1zone.rdd (real IDF style, EnergyPlus 26.2) and regular-style-from-oracle_1zone.rdd (re-encoded by the project, not real engine output). Both styles are read; variable type and units come from the trailing comment in IDF style.
What Poka does not read
- The reporting frequency in the IDF-style object is not shown (immaterial: it is the default hourly)
Background
The EnergyPlus documentation describes the RDD as the list of report variables with their availability; the simulation has to run before the list is known. Like the MDD it comes in IDF style or as a regular table, chosen by Output:VariableDictionary. Poka reads both styles. In IDF style the variable type and units are only in the trailing !- comment, so they are taken from there.
Versions
| Version | Identifier | Poka | Note |
|---|---|---|---|
| IDF style | Read | ||
| Regular style | Read |
Libraries
Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.
- honeybee-energy (RDD class) (reference; AGPL-3.0; Python; https://github.com/ladybug-tools/honeybee-energy/blob/master/honeybee_energy/result/rdd.py) — copyleft; RDD class parses a .rdd file into output names, with keyword filtering. Strong copyleft.
- eplusr (read_rdd) (candidate; MIT; R; https://github.com/hongyuanjia/eplusr) — read_rdd() parses a .rdd into a table (variable, units, report type); read_mdd() for .mdd. The read_rdd documentation was loaded on search.r-project.org.
Sources
- https://bigladdersoftware.com/epx/docs/24-1/output-details-and-examples/eplusout-rdd.html
- parsers/poka-rdd/src/lib.rs