# Custom Simulation Output

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9N5K8lMbAhbyBVgms%2Fuploads%2Fgit-blob-494ebd8b082c9685ea92590b45ad1e8ce5649f7d%2FCustom_Simulation_Output.png?alt=media)

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9N5K8lMbAhbyBVgms%2Fuploads%2Fgit-blob-c7d317d4e3f438c441cb50330253f49413f804b2%2FCustom_Simulation_Output.png?alt=media) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-energy/blob/master/honeybee_grasshopper_energy/src/HB%20Custom%20Simulation%20Output.py)

Create a custom simulation output object by plugging in one or more names of EnergyPlus simulation ouputs. The resulting object can be used to request output variables from EnergyPlus.

### Inputs

* **base\_sim\_output**

An optional simulation output object to serve as the starting point for the sim\_output object returned by this component. All of the output names will simply be appended to this initial starting object.

* **output\_names**

A list of EnergyPlus output names as strings (eg. 'Surface Window System Solar Transmittance'. These outputs will be requested from the simulation.

* **report\_frequency**

Text for the frequency at which the outputs are reported. Default: 'Hourly'. Choose from the following:

```
* Annual

* Monthly

* Daily

* Hourly

* Timestep
```

* **summary\_reports**

An optional list of EnergyPlus summary report names as strings. If None, only the 'AllSummary' report will be requested from the simulation and will appear in the HTML report output by EnergyPlus. See the Input Output Reference SummaryReports section for a full list of all reports that can be requested. <https://bigladdersoftware.com/> epx/docs/9-1/input-output-reference/output-table-summaryreports.html

* **unmet\_setpt\_tol**

A number in degrees Celsius for the difference that the zone conditions must be from the thermostat setpoint in order for the setpoint to be considered unmet. This will affect how unmet hours are reported in the output. ASHRAE 90.1 uses a tolerance of 1.11C, which is equivalent to 1.8F. (Default: 1.11C).

### Outputs

* **report**

Report!

* **sim\_output**

A SimulationOutput object that can be connected to the "HB Simulation Parameter" component in order to specify which types of outputs should be written from EnergyPlus.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ladybug.tools/hb-energy-primer/components/5_simulate/custom_simulation_output.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
