dragonfly_trace.exp module¶

Methods to generate EXP templates for Trane TRACE.

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

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_to_trace700_template(construction_set, si_units=False)[source]¶: Translates a Honeybee ConstructionSet into a TRACE 700 Construction Template line.

dragonfly_trace.exp.construction_sets_to_exp(construction_sets, si_units=False)[source]¶: Get a single combined EXP string for a list of Honeybee ConstructionSets.

dragonfly_trace.exp.energy_material_to_trace700_material(material, si_units=False, id=999)[source]¶: Converts a Honeybee EnergyMaterial or EnergyMaterialNoMass to a T.MATR_MATERIAL entry.

dragonfly_trace.exp.equipment_to_trace700_miscellaneous(equipment, si_units=False, watts_per_area=None)[source]¶

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_to_exp(program, si_units=False)[source]¶

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_trace700_lighting(lighting, fixture_type='SUSFLUOR')[source]¶

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.opaque_construction_to_trace700_construction(construction, const_type='Wall', si_units=False, starting_material_id=500, material_id_map=None)[source]¶: Converts a Honeybee OpaqueConstruction to a TRACE 700 construction entry.

dragonfly_trace.exp.people_to_trace700_people(people, si_units=False)[source]¶

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_to_exp(program, si_units=False, ventilation_method='Sum of Outdoor Air')[source]¶

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')[source]¶

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)[source]¶

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)[source]¶

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)[source]¶

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_to_exp(programs, si_units=False, ventilation_method='Sum of Outdoor Air')[source]¶

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.thermostat_to_exp(program, si_units=False)[source]¶

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_to_trace700_glass(construction, si_units=False, is_door=False)[source]¶: Converts a Honeybee WindowConstruction object to a T.GLAS_GLASS entry.