| Name | Add_and_apply_load_and_schedule_from_file |
|---|
| Display Name | Add And Apply Load And Schedule From File |
|---|
| uuid | f97be49a-a272-41e9-9d92-c2b2a082d556 |
|---|
| Type | Measure |
|---|
| Language | Ruby |
|---|
| Tags | Whole Building.Whole Building Schedules |
|---|
| Description | This measure imports electric or lighting load data from a CSV file and applies it to a selected load in the OpenStudio model as a ScheduleInterval. The measure offers options to normalize the data by floor area, invert the data if it represents energy consumption as negative values, and replace the existing power or power intensity with the maximum value from the CSV data. |
|---|
| Modeler's Description | This measure enhances the flexibility of energy modeling by allowing users to apply real-world load data to their OpenStudio models. It reads a specified column of electric or lighting load data from a CSV file and processes it to create a ScheduleInterval for a selected load object (either ElectricEquipment or Lights). Key features include the ability to normalize the data by the maximum value in the CSV column, adjust for floor area (either the whole building or a specific level), and replace existing design-level values with the maximum value from the CSV.
Additionally, the measure provides an option to invert the load data, which is particularly useful if the data is reported as negative values when the load is consuming energy, such as in some sub-metered data sets. The measure handles various data intervals, such as hourly, 15-minute, or 1-minute data, and includes comprehensive error handling and logging to ensure the user is informed of any issues or actions taken during the measure's execution.
The measure also supports the reuse of file paths and names across multiple runs by storing user-defined paths and filenames in a JSON file, making it easier to apply consistent settings across different projects or scenarios. |
|---|
| Measure Type | ModelMeasure |
|---|
| Measure Language | Ruby |
|---|
| Intended Software Tool | Apply Measure Now |
|---|
| Intended Software Tool | OpenStudio Application |
|---|
| Intended Software Tool | Parametric Analysis Tool |
|---|
| Intended Use Case | Model Articulation |
|---|
| Intended Use Case | Calibration |
|---|
| Intended Use Case | Sensitivity Analysis |
|---|
| OpenStudio Version | 3.7.0 |
|---|
| Minimum Compatible OpenStudio Version | 3.7.0 |
|---|
| README File | View README File |
|---|
| GitHub Repo Link | View on GitHub |
|---|
