eplus_funcs¶
Functions related to under-the-hood interactions with energyplus.
-
eplus_funcs.
get_ep_path
(idf_version, ep_path=None)[source]¶ get EnergyPlus installation path by idf_version :param idf_version: idf_version of EnergyPlus :param ep_path: Optional - path to EnergyPlus if installed in different location then expected :returns: (path to EnergyPlus executable, path to EnergyPlus)
-
eplus_funcs.
get_idf_version
(building)[source]¶ Get energyplus version from idf or json building :param building: IDF object to find version of. :returns: String of version (ex. ‘9.3.0’)
-
eplus_funcs.
get_idf_version_pth
(path)[source]¶ Get energyplus version from idf or epJSON path :param path: Path to idf to epJSON file. :returns: String of version (ex. ‘9.3.0’)
-
eplus_funcs.
has_hvac_templates
(building) → bool[source]¶ Returns whether or not the building contains HVACTemplate objects https://bigladdersoftware.com/epx/docs/8-0/input-output-reference/page-061.html
Parameters: building – Returns: True if at leas one HVACTemplate object is present in the building.
-
eplus_funcs.
run_building
(building, out_dir=None, version=None, **eplus_args)[source]¶ Run energy plus on a building object and return results :param building_path: Path to building file :param out_dir: Path to store EnergyPlus output files, if out_dir is not defined the results will not be saved :param version: Version of building file :param ep_path: Path to EnergyPlus if installed in unexpected directory :param expand_objects: Boolean if ‘–expandobjects’ option to be appended to command :returns: A dictionary of EnergyPlus outputs
-
eplus_funcs.
run_energyplus
(building_path: Union[os.PathLike, str], out_dir: Union[os.PathLike, str] = None, epw: Union[os.PathLike, str] = '/home/docs/checkouts/readthedocs.org/user_builds/besos/envs/stable/lib/python3.7/site-packages/besos/data/example_epw.epw', err_dir: Union[os.PathLike, str] = PosixPath('/home/docs/checkouts/readthedocs.org/user_builds/besos/checkouts/stable/docs/BESOS_Errors'), schema_file=None, error_mode='Silent', version=None, ep_path=None, expand_objects: bool = False)[source]¶ Run EnergyPlus. This method is intended to work as similar to the cli tool as possible :param building_path: Path to building file :param out_dir: Path to store EnergyPlus output files :param epw: Path to epw file :param err_dir: Path to store EnergyPlus error files :param schema_file: Path to data dictionary for EnergyPlus :param error_mode: Error mode selection :param version: Version of building file :param ep_path: Path to EnergyPlus if installed in unexpected directory :param expand_objects: Boolean if ‘–expandobjects’ option to be appended :returns: None