dragonfly_trace.exp module

Methods to generate EXP templates for Trane TRACE.

dragonfly_trace.exp.airflow_from_exp(exp_str)

“Get Infiltration, Ventilation and ExhaustAir from TRACE 700 AirflowTemplate.

Parameters:

exp_str – A TRACE 700 AirflowTemplate entry string.

Returns:

A tuple with three elements.

• infiltration: A Honeybee Infiltration object if the infiltration is non-zero and defined per exterior area. None otherwise.

• ventilation: A Honeybee Ventilation object if ventilation is non-zero and is either “Sum of Outdoor Air” or “ASHRAE 62.1.” None otherwise.

• exhaust: A Honeybee ExhaustAir object if exhaust air is non-zero and defined per floor area or as an absolute flow rate. None otherwise.

dragonfly_trace.exp.airflow_to_exp(program, si_units=False, ventilation_method='Sum of Outdoor Air')

Get an EXP string containing only the airflow template for a ProgramType.

Parameters:

• program – A Honeybee ProgramType object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

• ventilation_method –

  Optional text for the ventilation method to be used in the airflow template. Choose from the following.

  • Sum of Outdoor Air

  • ASHRAE 62.1

Returns:

Text string of an EXP file for TRACE 700 containing the airflow template.

dragonfly_trace.exp.construction_set_from_exp(exp_str, constructions)

Get a ConstructionSet from a TRACE 700 ConstructionTemplate.

Parameters:

• exp_str – A TRACE 700 ConstructionTemplate entry string.

• constructions – A dictionary with identifiers of constructions as keys and Pythonconstruction objects as values.

Returns:

A Honeybee ConstructionSet object.

dragonfly_trace.exp.construction_set_to_trace700_template(construction_set, si_units=False)

Translates a Honeybee ConstructionSet into a TRACE 700 Construction Template line.

dragonfly_trace.exp.construction_sets_from_exp(exp_file_content)

Get a list of Honeybee ConstructionSets from the content of an EXP file.

Parameters:

exp_file_content – Text string for the contents of an EXP file.

Returns:

A tuple with three elements.

• materials: A list of Honeybee materials.

• constructions: A list of Honeybee OpaqueConstructions and WindowConstructions.

• construction_sets: A list of Honeybee ConstructionSets.

dragonfly_trace.exp.construction_sets_to_exp(construction_sets, si_units=False)

Get a single combined EXP string for a list of Honeybee ConstructionSets.

dragonfly_trace.exp.equipment_to_exp(equipment, si_units=False, watts_per_area=None)

Get a TRACE 700 “T.LOAD_MISEQUIP” entry string from a Honeybee Equipment object.

Parameters:

• equipment – A Honeybee ElectricEquipment or GasEquipment object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

• watts_per_area – Optional float for total W/m2 override to represent a combined electric + gas equipment load density. If None, equipment.watts_per_area will be used. (Default: None).

Returns:

A text string for a TRACE 700 T.LOAD_MISEQUIP library entry.

dragonfly_trace.exp.internal_loads_from_exp(exp_str)

Get Honeybee People, Lighting and Equipment from a TRACE 700 InternalLoadTemplate.

Parameters:

exp_str – A TRACE 700 InternalLoadTemplate entry string.

Returns:

A tuple with three elements.

• people: A Honeybee People object if people are non-zero and defined per floor area. None otherwise.

• lighting: A Honeybee Lighting object if lights are non-zero and defined per floor area. None otherwise.

• equipment: A Honeybee ElectricEquipment or GasEquipment object if miscellaneous loads are non-zero and defined per floor area. None otherwise.

dragonfly_trace.exp.internal_loads_to_exp(program, si_units=False)

Get an EXP string containing internal load library entries and templates for a ProgramType.

Parameters:

• program – A Honeybee ProgramType object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

Returns:

Text string of an EXP file for TRACE 700 containing internal load definitions.

dragonfly_trace.exp.lighting_to_exp(lighting, fixture_type='SUSFLUOR')

Get a TRACE 700 “T.LOAD_LIGHTS” entry string from a Honeybee Lighting object.

Parameters:

• lighting – A Honeybee Lighting object.

• fixture_type – Optional text string for the lighting fixture type. (Default: ‘SUSFLUOR’).

Returns:

A text string for a TRACE 700 T.LOAD_LIGHTS library entry.

dragonfly_trace.exp.material_from_exp(exp_str)

Get an EnergyMaterial or EnergyMaterialNoMass from a TRACE 700 MATR_MATERIAL.

Parameters:

exp_str – A TRACE 700 MATR_MATERIAL entry string.

Returns:

A Honeybee EnergyMaterial or EnergyMaterialNoMass object.

dragonfly_trace.exp.material_to_exp(material, si_units=False, id=999)

Converts a Honeybee EnergyMaterial or EnergyMaterialNoMass to a T.MATR_MATERIAL entry.

dragonfly_trace.exp.opaque_construction_from_exp(exp_str, materials)

Get an OpaqueConstruction from a TRACE 700 CNST_WALL, CNST_ROOF, CNST_FLOOR, etc.

Parameters:

• exp_str – A TRACE 700 CNST_WALL, CNST_ROOF, CNST_FLOOR, CNST_EXFLOOR, or CNST_PART entry string.

• materials – A dictionary with identifiers of materials as keys and Python material objects as values.

Returns:

A Honeybee OpaqueConstruction object.

dragonfly_trace.exp.opaque_construction_to_exp(construction, const_type='Wall', si_units=False, starting_material_id=500, material_id_map=None)

Converts a Honeybee OpaqueConstruction to a TRACE 700 construction entry.

dragonfly_trace.exp.people_to_exp(people, si_units=False)

Get a TRACE 700 “T.LOAD_PEOPLE” entry string from a Honeybee People object.

Parameters:

• people – A Honeybee People object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

Returns:

A text string for a TRACE 700 T.LOAD_PEOPLE library entry.

dragonfly_trace.exp.program_from_exp(room_exp_str, internal_loads, airflows, setpoints)

Get a complete Honeybee ProgramType from the EXP string of a RoomTemplate.

Parameters:

• exp_str – A TRACE 700 RoomTemplate entry string.

• internal_loads – A dictionary of Honeybee internal loads objects with the identifiers of the TRACE 700 InternalLoadTemplate as keys and tuples of 3 Honeybee load objects as values (people, lighting, equipment).

• airflows – A dictionary of Honeybee airflow objects with the identifiers of the TRACE 700 AirflowTemplate as keys and tuples of 3 airflow objects as values (infiltration, ventilation, exhaust).

• setpoints – A dictionary of Honeybee Setpoint objects with the identifiers of the TRACE 700 ThermostatTemplate as keys and Honeybee Setpoint objects as values.

Returns:

A Honeybee ProgramType object from the RoomTemplate string.

dragonfly_trace.exp.program_to_exp(program, si_units=False, ventilation_method='Sum of Outdoor Air')

Get a complete EXP string for a Honeybee ProgramType.

Parameters:

• program – A Honeybee ProgramType object for which the TRACE 700 EXP string will be generated.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

• ventilation_method –

  Optional text for the ventilation method to be used in the airflow template. Choose from the following.

  • Sum of Outdoor Air

  • ASHRAE 62.1

Returns:

Text string of a complete EXP file for TRACE 700.

dragonfly_trace.exp.program_to_trace700_airflow_template(program, si_units=False, ventilation_method='Sum of Outdoor Air')

Get a TRACE 700 “T.AirflowTemplate” entry string from a Honeybee ProgramType.

Parameters:

• program – A Honeybee ProgramType object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

• ventilation_method –

  Optional text for the ventilation method to be used in the airflow template. Choose from the following.

  • Sum of Outdoor Air

  • ASHRAE 62.1

Returns:

A text string for a TRACE 700 T.AirflowTemplate entry.

dragonfly_trace.exp.program_to_trace700_internal_load_template(program, si_units=False)

Get a TRACE 700 “T.InternalLoadTemplate” entry string from a Honeybee ProgramType.

Parameters:

• program – A Honeybee ProgramType object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

Returns:

A text string for a TRACE 700 T.InternalLoadTemplate entry.

dragonfly_trace.exp.program_to_trace700_room_template(program)

Get a TRACE 700 “T.RoomTemplate” entry string from a Honeybee ProgramType.

Parameters:

program – A Honeybee ProgramType object.

Returns:

A text string for a TRACE 700 T.RoomTemplate entry.

dragonfly_trace.exp.program_to_trace700_thermostat_template(program, si_units=False)

Get a TRACE 700 “T.ThermostatTemplate” entry string from a Honeybee ProgramType.

Parameters:

• program – A Honeybee ProgramType object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

Returns:

A text string for a TRACE 700 T.ThermostatTemplate entry.

dragonfly_trace.exp.programs_from_exp(exp_file_content)

Get a list of Honeybee ProgramTypes from the content of an EXP file.

Parameters:

exp_file_content – Text string for the contents of an EXP file.

Returns:

A list of Honeybee ProgramTypes.

dragonfly_trace.exp.programs_to_exp(programs, si_units=False, ventilation_method='Sum of Outdoor Air')

Get a single combined EXP string for a list of Honeybee ProgramTypes.

Parameters:

• programs – A list of Honeybee ProgramType objects.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

• ventilation_method –

  Optional text for the ventilation method to be used in the airflow template. Choose from the following.

  • Sum of Outdoor Air

  • ASHRAE 62.1

Returns:

Text string of a combined EXP file for TRACE 700.

dragonfly_trace.exp.setpoint_from_exp(exp_str)

Get a Honeybee Setpoint from a TRACE 700 ThermostatTemplate.

Parameters:

exp_str – A TRACE 700 ThermostatTemplate entry string.

Returns:

A Honeybee Setpoint object.

dragonfly_trace.exp.thermostat_to_exp(program, si_units=False)

Get an EXP string containing only the thermostat template for a ProgramType.

Parameters:

• program – A Honeybee ProgramType object.

• si_units – Boolean to note whether the units of the values in the resulting matrix are in SI (True) instead of IP (False). (Default: False).

Returns:

Text string of an EXP file for TRACE 700 containing the thermostat template.

dragonfly_trace.exp.window_construction_from_exp(exp_str)

Get a WindowConstruction (or OpaqueConstruction) from a TRACE 700 GLAS_GLASS.

Parameters:

exp_str – A TRACE 700 GLAS_GLASS entry string.

Returns:

A Honeybee WindowConstruction object (or an OpaqueConstruction object if the GLAS_GLASS refers to a door construciton with zero solar transmittance).

dragonfly_trace.exp.window_construction_to_exp(construction, si_units=False, is_door=False)

Converts a Honeybee WindowConstruction object to a T.GLAS_GLASS entry.

dragonfly_trace.exp.uvalue_dt = U Value

____________TRANSLATORS TO EXP____________