ApacheSim

class iesve.ApacheSim

Bases: object

Interface for running Apache Simulations.

Basic usage:

s = iesve.ApacheSim()
s.show_simulation_dialog()

# or

s = iesve.ApacheSim()
s.save_options({'results_filename' : 'abc.aps'})
s.run_simulation()

get_options() → dict

Get the simulation options currently in effect. Return type is a dictionary with the current options. Available options are:

Option	Description
aux_ventilation:	(Bool) defaults to True
cooling_end_month:	(int) 1-12
cooling_start_month:	(int) 1-12
end_day:	(int) 1-31
end_month:	(int) 1-12
HVAC:	(Bool) include HVAC
HVAC_filename:	(string) HVAC network filename, used if HVAC is True
macroflo:	(Bool) setting this to True requires a macroflo input file (.mfo) to be present. Setting this to True is required for opening-level results
nat_ventilation:	(Bool) defaults to True
preconditioning_days	(int) 0-365
radiance:	(Bool) setting this to True will automatically run Radiance if queue_to_tasks is True when running simulations. It will not run automatically if a blocking simulation is run, in which case an existing Radiance results file (.ill) is required
reporting_interval:	(int) 0=6, 1=10, 2=30, 3=60 minutes
results_filename:	(string) file will be located in Vista folder
simulation_timestep:	(int) 0=1, 1=2, 2=6, 3=10, 4=30 minutes
start_day:	(int) 1-31
start_month:	(int) 1-12
suncast:	(Bool) setting this to True will run Suncast if required
suncast_filename:	(string) shading file filename

Output options. These correspond to the Apache Simulation Output Options dialog and apply to all rooms:

Option	Description
output_conduction_gains	(Bool) defaults to False
output_HVAC_components	(Bool) defaults to False
output_HVAC_systems	(Bool) defaults to True
output_latent_internal_gains	(Bool) defaults to False
output_latent_ventilation_gains	(Bool) defaults to False
output_sensible_internal_gains	(Bool) defaults to True
output_standard_outputs	(Bool) defaults to True

Detailed output options. These correspond to the Apache Simulation Output Options dialog and apply only to the rooms indicated in detailed_rooms. Note that detailed output per room can significantly increase APS file size if a large number of rooms are included.

Option	Description
detailed_conduction_gains	(Bool) defaults to False
detailed_convective_gains	(Bool) defaults to True
detailed_external_solar	(Bool) defaults to False. Setting this for a room enables Surface level results for that room
detailed_HVAC_systems	(Bool) defaults to True
detailed_internal_solar	(Bool) defaults to False. Setting this for a room enables Surface level results for that room
detailed_latent_internal_gains	(Bool) defaults to True
detailed_latent_ventilation_gains	(Bool) defaults to True
detailed_microflo	(Bool) defaults to True
detailed_rooms	(list of strings) each string holds a room ID
detailed_sensible_internal_gains	(Bool) defaults to True
detailed_standard_outputs	(Bool) defaults to True
detailed_surface_temps	(Bool) defaults to True. Setting this for a room enables Surface level results for that room

Note that setting Suncast and Radiance to True will only auto-run suncast when using batch operation. When using the blocking run, suncast and radiance will not be automatically run when set to True, but if corresponding data files are available (shd and ill files) they will be used in simulation. Absence of data files may cause simulation to fail.

reset_options() → bool

Reset the simulation options file to defaults.

Returns:

True if the options file was saved successfully

Return type:

bool

run_compliance_simulation() → bool

Run compliance simulation with the currently active settings. Parallel Simulation Manager (BETA) will be used.

Returns:

true indicates that simulation was run / queued, false indicates error.

Return type:

bool

run_loads_sizing() → None

Run a HVAC system loads & sizing simulation

run_room_zone_loads() → None

Run a Room loads simulation OR Run a Room and HVAC Zone loads simulation

run_simulation(queue_to_tasks: bool) → bool

Run Apache thermal simulation with the currently active settings.

Parameters:

queue_to_tasks (bool) – True, Parallel Simulation Manager (BETA) will be used (if licensed and activated). The task will be queued and script operation will continue immediately. When not using queueing, the simulation will run and the VE is blocked until simulation is complete.

Returns:

true indicates that simulation was run / queued, false indicates error

Return type:

bool

set_hvac_network(network_name: str) → None

Set the HVAC network.

Parameters:

network_name (str) – name of hvac network to set

set_options(**kwds)

Helper for @overload to raise when called.

show_simulation_dialog() → bool

Show the Apache Simulation dialog

Returns:

True if dialog was shown and simulation was run

Return type:

bool

stitch(output_file_path: str, files_to_stitch: list[str]) → None

Stitch together a list of APS files into a single APS file.

Parameters:

• output_file_path (str) – path to aps file

• files_to_stitch (list[str]) – ordered list of APS files to stitch