# coding=utf-8
"""Module for running IDF files through EnergyPlus."""
from __future__ import division
import os
import sys
import json
import subprocess
import xml.etree.ElementTree as ET
if (sys.version_info < (3, 0)):
readmode = 'rb'
writemode = 'wb'
else:
readmode = 'r'
writemode = 'w'
from ladybug.futil import write_to_file, preparedir
from honeybee.model import Model
from honeybee.boundarycondition import Surface
from honeybee.config import folders as hb_folders
from .config import folders
from .measure import Measure
from .result.osw import OSW
[docs]def from_gbxml_osw(gbxml_path, model_path=None, osw_directory=None):
"""Create a .osw to translate gbXML to a HBJSON file.
Args:
gbxml_path: File path to the gbXML to be translated to HBJSON.
model_path: File path to where the Model HBJSON will be written. If None, it
will be output right next to the input file and given the same name.
osw_directory: The directory into which the .osw should be written. If None,
it will be written into the a temp folder in the default simulation folder.
"""
return _import_model_osw(gbxml_path, 'gbxml', model_path, osw_directory)
[docs]def from_osm_osw(osm_path, model_path=None, osw_directory=None):
"""Create a .osw to translate OSM to a HBJSON file.
Args:
osm_path: File path to the OSM to be translated to HBJSON.
model_path: File path to where the Model HBJSON will be written. If None, it
will be output right next to the input file and given the same name.
osw_directory: The directory into which the .osw should be written. If None,
it will be written into the a temp folder in the default simulation folder.
"""
return _import_model_osw(osm_path, 'openstudio', model_path, osw_directory)
[docs]def from_idf_osw(idf_path, model_path=None, osw_directory=None):
"""Create a .osw to translate IDF to a HBJSON file.
Args:
idf_path: File path to the IDF to be translated to HBJSON.
model_path: File path to where the Model HBJSON will be written. If None, it
will be output right next to the input file and given the same name.
osw_directory: The directory into which the .osw should be written. If None,
it will be written into the a temp folder in the default simulation folder.
"""
return _import_model_osw(idf_path, 'idf', model_path, osw_directory)
[docs]def measure_compatible_model_json(
model_file_path, destination_directory=None, simplify_window_cons=False,
triangulate_sub_faces=True, triangulate_non_planar_orphaned=False,
enforce_rooms=False):
"""Convert a Model JSON to one that is compatible with the honeybee_openstudio_gem.
This includes the re-serialization of the Model to Python, which will
automatically ensure that all Apertures and Doors point in the same direction
as their parent Face. If the Model tolerance is non-zero and Rooms are closed
solids, this will also ensure that all Room Faces point outwards from their
parent's volume. If the Model units are not Meters, the model will be scaled
to be in Meters. Geometries with holes will have the vertices re-specified
in a manner that they are translated to EnergyPlus as a single list. Lastly,
apertures and doors with more than 4 vertices will be triangulated to ensure
EnergyPlus accepts them.
Args:
model_file_path: File path to a Honeybee Model as a HBJSON or HBpkl.
destination_directory: The directory into which the Model JSON that is
compatible with the honeybee_openstudio_gem should be written. If None,
this will be the same location as the input model_json_path. (Default: None).
simplify_window_cons: Boolean to note whether window constructions should
be simplified during the translation. This is useful when the ultimate
destination of the OSM is a format that does not supported layered
window constructions (like gbXML). (Default: False).
triangulate_sub_faces: Boolean to note whether sub-faces (including
Apertures and Doors) should be triangulated if they have more than
4 sides (True) or whether they should be left as they are (False).
This triangulation is necessary when exporting directly to EnergyPlus
since it cannot accept sub-faces with more than 4 vertices. (Default: True).
triangulate_non_planar_orphaned: Boolean to note whether any non-planar
orphaned geometry in the model should be triangulated upon export.
This can be helpful because OpenStudio simply raises an error when
it encounters non-planar geometry, which would hinder the ability
to save gbXML files that are to be corrected in other
software. (Default: False).
enforce_rooms: Boolean to note whether this method should enforce the
presence of Rooms in the Model, which is as necessary prerequisite
for simulation in EnergyPlus. (Default: False).
Returns:
The full file path to the new Model JSON written out by this method.
"""
# check that the file is there
assert os.path.isfile(model_file_path), \
'No file found at {}.'.format(model_file_path)
# get the directory and the file path for the new Model JSON
directory, _ = os.path.split(model_file_path)
dest_dir = directory if destination_directory is None else destination_directory
dest_file_path = os.path.join(dest_dir, 'in.hbjson')
# serialize the Model to Python
parsed_model = Model.from_file(model_file_path)
if enforce_rooms:
assert len(parsed_model.rooms) != 0, \
'Model contains no Rooms and therefore cannot be simulated in EnergyPlus.'
# remove degenerate geometry within native E+ tolerance of 0.01 meters
original_model = parsed_model
parsed_model.convert_to_units('Meters')
try:
parsed_model.remove_degenerate_geometry(0.01)
except ValueError:
error = 'Failed to remove degenerate Rooms.\nYour Model units system is: {}. ' \
'Is this correct?'.format(original_model.units)
raise ValueError(error)
if triangulate_non_planar_orphaned:
parsed_model.triangulate_non_planar_quads(0.01)
# get the dictionary representation of the Model and add auto-calculated properties
model_dict = parsed_model.to_dict(triangulate_sub_faces=triangulate_sub_faces)
parsed_model.properties.energy.add_autocal_properties_to_dict(model_dict)
if simplify_window_cons:
parsed_model.properties.energy.simplify_window_constructions_in_dict(model_dict)
# write the dictionary into a file
preparedir(dest_dir, remove_content=False) # create the directory if it's not there
if (sys.version_info < (3, 0)): # we need to manually encode it as UTF-8
with open(dest_file_path, writemode) as fp:
model_str = json.dumps(model_dict, ensure_ascii=False)
fp.write(model_str.encode('utf-8'))
else:
with open(dest_file_path, writemode, encoding='utf-8') as fp:
json.dump(model_dict, fp, ensure_ascii=False)
return os.path.abspath(dest_file_path)
[docs]def to_gbxml_osw(model_path, output_path=None, osw_directory=None):
"""Create a .osw to translate HBJSON to a gbXML file.
Args:
model_path: File path to Honeybee Model (HBJSON).
output_path: File path to where the gbXML will be written. If None, it
will be output right next to the input file and given the same name.
osw_directory: The directory into which the .osw should be written. If None,
it will be written into the a temp folder in the default simulation folder.
"""
# create the dictionary with the OSW steps
osw_dict = {'steps': []}
model_measure_dict = {
'arguments': {
'model_json': model_path
},
'measure_dir_name': 'from_honeybee_model_to_gbxml'
}
if output_path is not None:
model_measure_dict['arguments']['output_file_path'] = output_path
osw_dict['steps'].append(model_measure_dict)
# add measure paths
osw_dict['measure_paths'] = []
if folders.honeybee_openstudio_gem_path: # include honeybee-openstudio measure path
measure_dir = os.path.join(folders.honeybee_openstudio_gem_path, 'measures')
osw_dict['measure_paths'].append(measure_dir)
# write the dictionary to a workflow.osw
if osw_directory is None:
osw_directory = os.path.join(
hb_folders.default_simulation_folder, 'temp_translate')
if not os.path.isdir(osw_directory):
os.mkdir(osw_directory)
osw_json = os.path.join(osw_directory, 'translate_honeybee.osw')
if (sys.version_info < (3, 0)): # we need to manually encode it as UTF-8
with open(osw_json, writemode) as fp:
workflow_str = json.dumps(osw_dict, indent=4, ensure_ascii=False)
fp.write(workflow_str.encode('utf-8'))
else:
with open(osw_json, writemode, encoding='utf-8') as fp:
workflow_str = json.dump(osw_dict, fp, indent=4, ensure_ascii=False)
return os.path.abspath(osw_json)
[docs]def to_openstudio_osw(osw_directory, model_path, sim_par_json_path=None,
additional_measures=None, base_osw=None, epw_file=None,
schedule_directory=None, strings_to_inject=None,
report_units=None, viz_variables=None):
"""Create a .osw to translate honeybee JSONs to an .osm file.
Args:
osw_directory: The directory into which the .osw should be written and the
.osm will eventually be written into.
model_path: File path to the Model as either a HBJSON or an OSM.
sim_par_json_path: Optional file path to the SimulationParameter JSON.
If None, the resulting OSM will not have everything it needs to be
simulate-able in EnergyPlus. (Default: None).
additional_measures: An optional array of honeybee-energy Measure objects
to be included in the output osw. These Measure objects must have
values for all required input arguments or an exception will be
raised while running this function. (Default: None).
base_osw: Optional file path to an existing OSW JSON be used as the base
for the output .osw. This is another way that outside measures
can be incorporated into the workflow. (Default: None).
epw_file: Optional file path to an EPW that should be associated with the
output energy model. If None, no EPW file will be written into the
OSW. (Default: None).
schedule_directory: An optional file directory to which all file-based
schedules should be written to. If None, all ScheduleFixedIntervals
will be translated to Schedule:Compact and written fully into the
IDF string instead of to Schedule:File. (Default: None).
strings_to_inject: An additional text string to get appended to the IDF
before simulation. The input should include complete EnergyPlus objects
as a single string following the IDF format.
report_units: A text value to set the units of the OpenStudio Results report
that can optionally be included in the OSW. If set to None, no report
will be produced. (Default: None). Choose from the following.
* si - all units will be in SI
* ip - all units will be in IP
viz_variables: An optional list of EnergyPlus output variable names to
be visualized on the geometry in an output view_data HTML report.
If None or an empty list, no view_data report is produced. See below
for an example.
.. code-block:: python
viz_variables = [
"Zone Air System Sensible Heating Rate",
"Zone Air System Sensible Cooling Rate"
]
Returns:
The file path to the .osw written out by this method.
"""
# create a dictionary representation of the .osw with steps to run
# the model measure and the simulation parameter measure
if base_osw is None:
osw_dict = {'steps': []}
else:
assert os.path.isfile(base_osw), 'No base OSW file found at {}.'.format(base_osw)
with open(base_osw, readmode) as base_file:
osw_dict = json.load(base_file)
# add the model json serialization into the steps
if model_path.lower().endswith('.osm'): # use the OSM as a seed file
osw_dict['seed_file'] = model_path
else: # assume that it is a HBJSON
model_measure_dict = {
'arguments': {
'model_json': model_path
},
'measure_dir_name': 'from_honeybee_model'
}
if schedule_directory is not None:
model_measure_dict['arguments']['schedule_csv_dir'] = schedule_directory
osw_dict['steps'].insert(0, model_measure_dict)
# add a simulation parameter step if it is specified
if sim_par_json_path is not None:
sim_par_dict = {
'arguments': {
'simulation_parameter_json': sim_par_json_path
},
'measure_dir_name': 'from_honeybee_simulation_parameter'
}
osw_dict['steps'].insert(0, sim_par_dict)
# assign the measure_paths to the osw_dict
if 'measure_paths' not in osw_dict:
osw_dict['measure_paths'] = []
if folders.honeybee_openstudio_gem_path: # include honeybee-openstudio measure path
measure_dir = os.path.join(folders.honeybee_openstudio_gem_path, 'measures')
osw_dict['measure_paths'].append(measure_dir)
# assign the schedule_directory to the file_paths if it is specified
if schedule_directory is not None:
if 'file_paths' not in osw_dict:
osw_dict['file_paths'] = [schedule_directory]
else:
osw_dict['file_paths'].append(schedule_directory)
# load the inject IDF measure if strings_to_inject have bee specified
if strings_to_inject is not None and strings_to_inject != '':
assert folders.inject_idf_measure_path is not None, \
'Additional IDF strings input but the inject_idf measure is not installed.'
idf_measure = Measure(folders.inject_idf_measure_path)
inject_idf = os.path.join(osw_directory, 'inject.idf')
with open(inject_idf, "w") as idf_file:
idf_file.write(strings_to_inject)
units_arg = idf_measure.arguments[0]
units_arg.value = inject_idf
if additional_measures is None:
additional_measures = [idf_measure]
else:
additional_measures = list(additional_measures)
additional_measures.append(idf_measure)
# load the OpenStudio Results measure if report_units have bee specified
if report_units is not None and report_units.lower() != 'none':
assert folders.openstudio_results_measure_path is not None, 'OpenStudio report' \
' requested but the openstudio_results measure is not installed.'
report_measure = Measure(folders.openstudio_results_measure_path)
units_arg = report_measure.arguments[0]
units_arg.value = report_units.upper()
if additional_measures is None:
additional_measures = [report_measure]
else:
additional_measures = list(additional_measures)
additional_measures.append(report_measure)
# load the OpenStudio view_data measure if outputs have been requested
if viz_variables is not None and len(viz_variables) != 0:
assert folders.view_data_measure_path is not None, 'A visualization variable' \
'has been requested but the view_data measure is not installed.'
viz_measure = Measure(folders.view_data_measure_path)
if len(viz_variables) > 3:
viz_variables = viz_variables[:3]
for i, var in enumerate(viz_variables):
var_arg = viz_measure.arguments[i + 2]
var_arg.value = var
if additional_measures is None:
additional_measures = [viz_measure]
else:
additional_measures = list(additional_measures)
additional_measures.append(viz_measure)
# add any additional measures to the osw_dict
if additional_measures:
measure_paths = set() # set of all unique measure paths
# ensure measures are correctly ordered
m_dict = {'ModelMeasure': [], 'EnergyPlusMeasure': [], 'ReportingMeasure': []}
for measure in additional_measures:
m_dict[measure.type].append(measure)
sorted_measures = m_dict['ModelMeasure'] + m_dict['EnergyPlusMeasure'] + \
m_dict['ReportingMeasure']
# add the measures and the measure paths to the OSW
for measure in sorted_measures:
measure.validate() # ensure that all required arguments have values
measure_paths.add(os.path.dirname(measure.folder))
osw_dict['steps'].append(measure.to_osw_dict()) # add measure to workflow
for m_path in measure_paths:
osw_dict['measure_paths'].append(m_path)
# if there were reporting measures, add the ladybug adapter to get sim progress
adapter = folders.honeybee_adapter_path
if len(m_dict['ReportingMeasure']) != 0 and adapter is not None:
if 'run_options' not in osw_dict:
osw_dict['run_options'] = {}
osw_dict['run_options']['output_adapter'] = {
'custom_file_name': adapter,
'class_name': 'HoneybeeAdapter',
'options': {}
}
# assign the epw_file to the osw if it is input
if epw_file is not None:
osw_dict['weather_file'] = epw_file
# write the dictionary to a workflow.osw
osw_json = os.path.join(osw_directory, 'workflow.osw')
if (sys.version_info < (3, 0)): # we need to manually encode it as UTF-8
with open(osw_json, writemode) as fp:
workflow_str = json.dumps(osw_dict, indent=4, ensure_ascii=False)
fp.write(workflow_str.encode('utf-8'))
else:
with open(osw_json, writemode, encoding='utf-8') as fp:
workflow_str = json.dump(osw_dict, fp, indent=4, ensure_ascii=False)
return os.path.abspath(osw_json)
[docs]def to_sdd_osw(model_path, output_path=None, osw_directory=None):
"""Create a .osw to translate HBJSON to a SDD file.
Args:
model_path: File path to Honeybee Model (HBJSON).
output_path: File path to where the SDD will be written. If None, it
will be output right next to the input file and given the same name.
osw_directory: The directory into which the .osw should be written. If None,
it will be written into the a temp folder in the default simulation folder.
"""
# create the dictionary with the OSW steps
osw_dict = {'steps': []}
model_measure_dict = {
'arguments': {
'model_json': model_path
},
'measure_dir_name': 'from_honeybee_model_to_sdd'
}
if output_path is not None:
model_measure_dict['arguments']['output_file_path'] = output_path
osw_dict['steps'].append(model_measure_dict)
# add measure paths
osw_dict['measure_paths'] = []
if folders.honeybee_openstudio_gem_path: # include honeybee-openstudio measure path
measure_dir = os.path.join(folders.honeybee_openstudio_gem_path, 'measures')
osw_dict['measure_paths'].append(measure_dir)
# write the dictionary to a workflow.osw
if osw_directory is None:
osw_directory = os.path.join(
hb_folders.default_simulation_folder, 'temp_translate')
if not os.path.isdir(osw_directory):
os.mkdir(osw_directory)
osw_json = os.path.join(osw_directory, 'translate_honeybee.osw')
if (sys.version_info < (3, 0)): # we need to manually encode it as UTF-8
with open(osw_json, writemode) as fp:
workflow_str = json.dumps(osw_dict, indent=4, ensure_ascii=False)
fp.write(workflow_str.encode('utf-8'))
else:
with open(osw_json, writemode, encoding='utf-8') as fp:
workflow_str = json.dump(osw_dict, fp, indent=4, ensure_ascii=False)
return os.path.abspath(osw_json)
[docs]def run_osw(osw_json, measures_only=True, silent=False):
"""Run a .osw file using the OpenStudio CLI on any operating system.
Args:
osw_json: File path to a OSW file to be run using OpenStudio CLI.
measures_only: Boolean to note whether only the measures should be
applied in the running of the OSW (True) or the resulting model
should be run through EnergyPlus after the measures are applied
to it (False). (Default: True).
silent: Boolean to note whether the OSW should be run silently.
This only has an effect on Windows simulations since Unix-based
simulations always use shell and are always silent (Default: False).
Returns:
The following files output from the CLI run
- osm -- Path to a .osm file representing the output model.
Will be None if no file exists.
- idf -- Path to a .idf file representing the model.
Will be None if no file exists.
"""
# run the simulation
if os.name == 'nt': # we are on Windows
directory = _run_osw_windows(osw_json, measures_only, silent)
else: # we are on Mac, Linux, or some other unix-based system
directory = _run_osw_unix(osw_json, measures_only)
# output the simulation files
return _output_openstudio_files(directory)
[docs]def prepare_idf_for_simulation(idf_file_path, epw_file_path=None):
"""Prepare an IDF file to be run through EnergyPlus.
This includes checking that the EPW file and IDF file exist and renaming the
IDF to in.idf (if it is not already named so). A check is also performed to
be sure that a valid EnergyPlus installation was found.
Args:
idf_file_path: The full path to an IDF file.
epw_file_path: The full path to an EPW file. Note that inputting None here
is only appropriate when the simulation is just for design days and has
no weather file run period. (Default: None).
Returns:
directory -- The folder in which the IDF exists and out of which the EnergyPlus
simulation will be run.
"""
# check the energyplus directory
if not folders.energyplus_path:
raise OSError('No EnergyPlus installation was found on this machine.\n'
'Install EnergyPlus to run energy simulations.')
# check the input files
assert os.path.isfile(idf_file_path), \
'No IDF file found at {}.'.format(idf_file_path)
if epw_file_path is not None:
assert os.path.isfile(epw_file_path), \
'No EPW file found at {}.'.format(epw_file_path)
# rename the idf file to in.idf if it isn't named that already
directory = os.path.split(idf_file_path)[0]
idf_file_name = os.path.split(idf_file_path)[-1]
if idf_file_name != 'in.idf':
old_file_name = os.path.join(directory, idf_file_name)
new_file_name = os.path.join(directory, 'in.idf')
# ensure that there isn't an in.idf file there already
if os.path.isfile(new_file_name):
os.remove(new_file_name)
os.rename(old_file_name, new_file_name)
return directory
[docs]def run_idf(idf_file_path, epw_file_path=None, expand_objects=True, silent=False):
"""Run an IDF file through energyplus on any operating system.
Args:
idf_file_path: The full path to an IDF file.
epw_file_path: The full path to an EPW file. Note that inputting None here
is only appropriate when the simulation is just for design days and has
no weather file run period. (Default: None).
expand_objects: If True, the IDF run will include the expansion of any
HVAC Template objects in the file before beginning the simulation.
This is a necessary step whenever there are HVAC Template objects in
the IDF but it is unnecessary extra time when they are not
present. (Default: True).
silent: Boolean to note whether the simulation should be run silently.
This only has an effect on Windows simulations since Unix-based
simulations always use shell and are always silent (Default: False).
Returns:
A series of file paths to the simulation output files
- sql -- Path to a .sqlite file containing all simulation results.
Will be None if no file exists.
- zsz -- Path to a .csv file containing detailed zone load information
recorded over the course of the design days. Will be None if no
file exists.
- rdd -- Path to a .rdd file containing all possible outputs that can be
requested from the simulation. Will be None if no file exists.
- html -- Path to a .html file containing all summary reports.
Will be None if no file exists.
- err -- Path to a .err file containing all errors and warnings from the
simulation. Will be None if no file exists.
"""
# rename the stat file to ensure EnergyPlus does not find it and error
stat_file, renamed_stat = None, None
if epw_file_path is not None:
epw_folder = os.path.dirname(epw_file_path)
for wf in os.listdir(epw_folder):
if wf.endswith('.stat'):
stat_file = os.path.join(epw_folder, wf)
renamed_stat = os.path.join(epw_folder, wf.replace('.stat', '.hide'))
try:
os.rename(stat_file, renamed_stat)
except Exception: # STAT file in restricted location (Program Files)
stat_file = None # hope that it is not a OneBuilding EPW
break
# run the simulation
if os.name == 'nt': # we are on Windows
directory = _run_idf_windows(
idf_file_path, epw_file_path, expand_objects, silent)
else: # we are on Mac, Linux, or some other unix-based system
directory = _run_idf_unix(idf_file_path, epw_file_path, expand_objects)
# put back the .stat file
if stat_file is not None:
os.rename(renamed_stat, stat_file)
# output the simulation files
return output_energyplus_files(directory)
[docs]def output_energyplus_files(directory):
"""Get the paths to the EnergyPlus simulation output files given the idf directory.
Args:
directory: The path to where the IDF was run.
Returns:
A tuple with four elements
- sql -- Path to a .sqlite file containing all simulation results.
Will be None if no file exists.
- zsz -- Path to a .csv file containing detailed zone load information
recorded over the course of the design days. Will be None if no
file exists.
- rdd -- Path to a .rdd file containing all possible outputs that can be
requested from the simulation. Will be None if no file exists.
- html -- Path to a .html file containing all summary reports.
Will be None if no file exists.
- err -- Path to a .err file containing all errors and warnings from the
simulation. Will be None if no file exists.
"""
# generate paths to the simulation files
sql_file = os.path.join(directory, 'eplusout.sql')
zsz_file = os.path.join(directory, 'epluszsz.csv')
rdd_file = os.path.join(directory, 'eplusout.rdd')
html_file = os.path.join(directory, 'eplustbl.htm')
err_file = os.path.join(directory, 'eplusout.err')
# check that the simulation files exist
sql = sql_file if os.path.isfile(sql_file) else None
zsz = zsz_file if os.path.isfile(zsz_file) else None
rdd = rdd_file if os.path.isfile(rdd_file) else None
html = html_file if os.path.isfile(html_file) else None
err = err_file if os.path.isfile(err_file) else None
return sql, zsz, rdd, html, err
def _import_model_osw(model_path, extension, output_path=None, osw_directory=None):
"""Base function used for OSW translating from various formats to HBJSON.
Args:
model_path: File path to the file to be translated to HBJSON.
extension: Name of the file type to be translated (eg. gbxml).
output_path: File path to where the Model HBJSON will be written.
osw_directory: The directory into which the .osw should be written.
"""
# create the dictionary with the OSW steps
osw_dict = {'steps': []}
model_measure_dict = {
'arguments': {
'{}_model'.format(extension): model_path
},
'measure_dir_name': 'from_{}_model'.format(extension)
}
if output_path is not None:
model_measure_dict['arguments']['output_file_path'] = output_path
osw_dict['steps'].append(model_measure_dict)
# add measure paths
osw_dict['measure_paths'] = []
if folders.honeybee_openstudio_gem_path: # include honeybee-openstudio measure path
measure_dir = os.path.join(folders.honeybee_openstudio_gem_path, 'measures')
osw_dict['measure_paths'].append(measure_dir)
# write the dictionary to a workflow.osw
if osw_directory is None:
osw_directory = os.path.join(
hb_folders.default_simulation_folder, 'temp_translate')
if not os.path.isdir(osw_directory):
os.mkdir(osw_directory)
osw_json = os.path.join(osw_directory, 'translate_{}.osw'.format(extension))
if (sys.version_info < (3, 0)): # we need to manually encode it as UTF-8
with open(osw_json, writemode) as fp:
workflow_str = json.dumps(osw_dict, indent=4, ensure_ascii=False)
fp.write(workflow_str.encode('utf-8'))
else:
with open(osw_json, writemode, encoding='utf-8') as fp:
workflow_str = json.dump(osw_dict, fp, indent=4, ensure_ascii=False)
return os.path.abspath(osw_json)
def _check_osw(osw_json):
"""Prepare an OSW file to be run through OpenStudio CLI.
This includes checking for a valid OpenStudio installation and ensuring the
OSW file exists.
Args:
osw_json: The full path to an OSW file.
epw_file_path: The full path to an EPW file.
Returns:
The folder in which the OSW exists and out of which the OpenStudio CLI
will operate.
"""
# check the openstudio directory
if not folders.openstudio_path:
raise OSError('No OpenStudio installation was found on this machine.\n'
'Install OpenStudio to run energy simulations.')
# check the input files
assert os.path.isfile(osw_json), 'No OSW file found at {}.'.format(osw_json)
return os.path.split(osw_json)[0]
def _run_osw_windows(osw_json, measures_only=True, silent=False):
"""Run a .osw file using the OpenStudio CLI on a Windows-based operating system.
A batch file will be used to run the simulation.
Args:
osw_json: File path to a OSW file to be run using OpenStudio CLI.
measures_only: Boolean to note whether only the measures should be applied
in the running of the OSW (True) or the resulting model should be run
through EnergyPlus after the measures are applied to it (False).
Default: True.
silent: Boolean to note whether the OSW should be run silently (without
the batch window). If so, the simulation will be run using subprocess
with shell set to True. (Default: False).
Returns:
Path to the folder out of which the OSW was run.
"""
# check the input file
directory = _check_osw(osw_json)
if not silent:
# write a batch file to call OpenStudio CLI; useful for re-running the sim
working_drive = directory[:2]
measure_str = '-m ' if measures_only else ''
batch = '{}\n"{}" -I "{}" run {}-w "{}"'.format(
working_drive, folders.openstudio_exe, folders.honeybee_openstudio_gem_path,
measure_str, osw_json)
if all(ord(c) < 128 for c in batch): # just run the batch file as it is
batch_file = os.path.join(directory, 'run_workflow.bat')
write_to_file(batch_file, batch, True)
os.system('"{}"'.format(batch_file)) # run the batch file
return directory
# given .bat file restrictions with non-ASCII characters, run the sim with subprocess
cmds = [folders.openstudio_exe, '-I', folders.honeybee_openstudio_gem_path,
'run', '-w', osw_json]
if measures_only:
cmds.append('-m')
process = subprocess.Popen(cmds, shell=silent)
process.communicate() # prevents the script from running before command is done
return directory
def _run_osw_unix(osw_json, measures_only=True):
"""Run a .osw file using the OpenStudio CLI on a Unix-based operating system.
This includes both Mac OS and Linux since a shell will be used to run
the simulation.
Args:
osw_json: File path to a OSW file to be run using OpenStudio CLI.
measures_only: Boolean to note whether only the measures should be applied
in the running of the OSW (True) or the resulting model should be run
through EnergyPlus after the measures are applied to it (False).
Default: True.
Returns:
Path to the folder out of which the OSW was run.
"""
# check the input file
directory = _check_osw(osw_json)
# Write the shell script to call OpenStudio CLI
measure_str = '-m ' if measures_only else ''
shell = '#!/usr/bin/env bash\n"{}" -I "{}" run {}-w "{}"'.format(
folders.openstudio_exe, folders.honeybee_openstudio_gem_path,
measure_str, osw_json)
shell_file = os.path.join(directory, 'run_workflow.sh')
write_to_file(shell_file, shell, True)
# make the shell script executable using subprocess.check_call
# this is more reliable than native Python chmod on Mac
subprocess.check_call(['chmod', 'u+x', shell_file])
# run the shell script
subprocess.call(shell_file)
return directory
def _output_openstudio_files(directory):
"""Get the paths to the OpenStudio simulation output files given the osw directory.
Args:
directory: The path to where the OSW was run.
Returns:
- osm -- Path to a .osm file containing all simulation results.
Will be None if no file exists.
- idf -- Path to a .idf file containing properties of the model, including
the size of HVAC objects. Will be None if no file exists.
"""
# generate and check paths to the OSM and IDF files
osm_file = os.path.join(directory, 'run', 'in.osm')
osm = osm_file if os.path.isfile(osm_file) else None
# check the pre-process idf and replace the other in.idf with it
idf_file_right = os.path.join(directory, 'run', 'pre-preprocess.idf')
idf_file_wrong = os.path.join(directory, 'run', 'in.idf')
if os.path.isfile(idf_file_right) and os.path.isfile(idf_file_wrong):
os.remove(idf_file_wrong)
os.rename(idf_file_right, idf_file_wrong)
idf = idf_file_wrong
else:
idf = None
return osm, idf
def _run_idf_windows(idf_file_path, epw_file_path=None, expand_objects=True,
silent=False):
"""Run an IDF file through energyplus on a Windows-based operating system.
A batch file will be used to run the simulation.
Args:
idf_file_path: The full path to an IDF file.
epw_file_path: The full path to an EPW file. Note that inputting None here
is only appropriate when the simulation is just for design days and has
no weather file run period. (Default: None).
expand_objects: If True, the IDF run will include the expansion of any
HVAC Template objects in the file before beginning the simulation.
This is a necessary step whenever there are HVAC Template objects in
the IDF but it is unnecessary extra time when they are not
present. (Default: True).
silent: Boolean to note whether the simulation should be run silently
(without the batch window). If so, the simulation will be run using
subprocess with shell set to True. (Default: False).
Returns:
Path to the folder out of which the simulation was run.
"""
# check and prepare the input files
directory = prepare_idf_for_simulation(idf_file_path, epw_file_path)
if not silent: # write a batch file; useful for re-running the sim
# generate various arguments to pass to the energyplus command
epw_str = '-w "{}"'.format(os.path.abspath(epw_file_path)) \
if epw_file_path is not None else ''
idd_str = '-i "{}"'.format(folders.energyplus_idd_path)
expand_str = ' -x' if expand_objects else ''
working_drive = directory[:2]
# write the batch file
batch = '{}\ncd "{}"\n"{}" {} {}{}'.format(
working_drive, directory, folders.energyplus_exe, epw_str,
idd_str, expand_str)
if all(ord(c) < 128 for c in batch): # just run the batch file as it is
batch_file = os.path.join(directory, 'in.bat')
write_to_file(batch_file, batch, True)
os.system('"{}"'.format(batch_file)) # run the batch file
return directory
# given .bat file restrictions with non-ASCII characters, run the sim with subprocess
cmds = [folders.energyplus_exe, '-i', folders.energyplus_idd_path]
if epw_file_path is not None:
cmds.append('-w')
cmds.append(os.path.abspath(epw_file_path))
if expand_objects:
cmds.append('-x')
process = subprocess.Popen(cmds, cwd=directory, shell=silent)
process.communicate() # prevents the script from running before command is done
return directory
def _run_idf_unix(idf_file_path, epw_file_path=None, expand_objects=True):
"""Run an IDF file through energyplus on a Unix-based operating system.
This includes both Mac OS and Linux since a shell will be used to run
the simulation.
Args:
idf_file_path: The full path to an IDF file.
epw_file_path: The full path to an EPW file. Note that inputting None here
is only appropriate when the simulation is just for design days and has
no weather file run period. (Default: None).
expand_objects: If True, the IDF run will include the expansion of any
HVAC Template objects in the file before beginning the simulation.
This is a necessary step whenever there are HVAC Template objects in
the IDF but it is unnecessary extra time when they are not present.
Default: True.
Returns:
Path to the folder out of which the simulation was run.
"""
# check and prepare the input files
directory = prepare_idf_for_simulation(idf_file_path, epw_file_path)
# generate various arguments to pass to the energyplus command
epw_str = '-w "{}"'.format(os.path.abspath(epw_file_path))\
if epw_file_path is not None else ''
idd_str = '-i "{}"'.format(folders.energyplus_idd_path)
expand_str = ' -x' if expand_objects else ''
# write a shell file
shell = '#!/usr/bin/env bash\n\ncd "{}"\n"{}" {} {}{}'.format(
directory, folders.energyplus_exe, epw_str, idd_str, expand_str)
shell_file = os.path.join(directory, 'in.sh')
write_to_file(shell_file, shell, True)
# make the shell script executable using subprocess.check_call
# this is more reliable than native Python chmod on Mac
subprocess.check_call(['chmod', 'u+x', shell_file])
# run the shell script
subprocess.call(shell_file)
return directory
[docs]def add_gbxml_space_boundaries(base_gbxml, honeybee_model, new_gbxml=None):
"""Add the SpaceBoundary and ShellGeometry to a base_gbxml of a Honeybee model.
Note that these space boundary geometry definitions are optional within gbXML and
are essentially a duplication of the required non-manifold geometry within a
valid gbXML. The OpenStudio Forward Translator does not include such duplicated
geometries (hence, the reason for this method). However, these closed-volume
boundary geometries are used by certain interfaces and gbXML viewers.
Args:
base_gbxml: A file path to a gbXML file that has been exported from the
OpenStudio Forward Translator.
honeybee_model: The honeybee Model object that was used to create the
exported base_gbxml.
new_gbxml: Optional path to where the new gbXML will be written. If None,
the original base_gbxml will be overwritten with a version that has
the SpaceBoundary included within it.
"""
# get a dictionary of rooms in the model
room_dict = {room.identifier: room for room in honeybee_model.rooms}
# register all of the namespaces within the OpenStudio-exported XML
ET.register_namespace('', 'http://www.gbxml.org/schema')
ET.register_namespace('xhtml', 'http://www.w3.org/1999/xhtml')
ET.register_namespace('xsi', 'http://www.w3.org/2001/XMLSchema-instance')
ET.register_namespace('xsd', 'http://www.w3.org/2001/XMLSchema')
# parse the XML and get the building definition
tree = ET.parse(base_gbxml)
root = tree.getroot()
gbxml_header = r'{http://www.gbxml.org/schema}'
building = root[0][1]
# loop through surfaces in the gbXML so that we know the name of the interior ones
surface_set = set()
for room_element in root[0].findall(gbxml_header + 'Surface'):
surface_set.add(room_element.get('id'))
# loop through the rooms in the XML and add them as space boundaries to the room
for room_element in building.findall(gbxml_header + 'Space'):
room_id = room_element.get('zoneIdRef')
if room_id:
room_id = room_element.get('id')
shell_element = ET.Element('ShellGeometry')
shell_element.set('id', '{}Shell'.format(room_id))
shell_geo_element = ET.SubElement(shell_element, 'ClosedShell')
hb_room = room_dict[room_id[:-6]] # remove '_Space' from the end
for face in hb_room:
face_xml, face_geo_xml = _face_to_gbxml_geo(face, surface_set)
if face_xml is not None:
room_element.append(face_xml)
shell_geo_element.append(face_geo_xml)
room_element.append(shell_element)
# write out the new XML
new_xml = base_gbxml if new_gbxml is None else new_gbxml
tree.write(new_xml, xml_declaration=True)
return new_xml
def _face_to_gbxml_geo(face, face_set):
"""Get an Element Tree of a gbXML SpaceBoundary for a Face.
Note that the resulting string is only meant to go under the "Space" tag and
it is not a Surface tag with all of the construction and boundary condition
properties assigned to it.
Args:
face: A honeybee Face for which an gbXML representation will be returned.
face_set: A set of surface identifiers in the model, used to evaluate whether
the geometry must be associated with its boundary condition surface.
Returns:
A tuple with two elements.
- face_element: The element tree for the SpaceBoundary definition of the Face.
- loop_element: The element tree for the PolyLoop definition of the Face,
which is useful in defining the shell.
"""
# create the face element and associate it with a surface in the model
face_element = ET.Element('SpaceBoundary')
face_element.set('isSecondLevelBoundary', 'false')
obj_id = None
if face.identifier in face_set:
obj_id = face.identifier
elif isinstance(face.boundary_condition, Surface):
bc_obj = face.boundary_condition.boundary_condition_object
if bc_obj in face_set:
obj_id = bc_obj
if obj_id is None:
return None, None
face_element.set('surfaceIdRef', obj_id)
# write the geometry of the face
geo_element = ET.SubElement(face_element, 'PlanarGeometry')
loop_element = ET.SubElement(geo_element, 'PolyLoop')
for pt in face.vertices:
pt_element = ET.SubElement(loop_element, 'CartesianPoint')
for coord in pt:
coord_element = ET.SubElement(pt_element, 'Coordinate')
coord_element.text = str(coord)
return face_element, loop_element
def _parse_os_cli_failure(directory):
"""Parse the failure log of OpenStudio CLI.
Args:
directory: Path to the directory out of which the simulation is run.
"""
log_osw = OSW(os.path.join(directory, 'out.osw'))
raise Exception(
'Failed to run OpenStudio CLI:\n{}'.format('\n'.join(log_osw.errors)))