dragonfly_energy.des.junction module

Thermal junction in a District Energy System (DES).

class dragonfly_energy.des.junction.ThermalJunction(identifier, geometry, system_identifier=None, building_identifier=None)[source]

Bases: _GeometryBase

Represents an thermal junction connecting two objects in a DES.

Parameters

  • identifier – Text string for a unique thermal junction ID. Must contain only characters that are acceptable in a DED. This will be used to identify the object across the exported geoJSON and DES files.

  • geometry – A LineSegment2D or Polyline2D representing the geometry of the thermal junction.

  • system_identifier – An optional text string for the identifier of a district system object associated with the junction. District system objects include Ground Heat Exchangers. (Default: None).

  • building_identifier – An optional text string for the identifier of a Building object associated with the junction. (Default: None).

Properties:

  • identifier

  • display_name

  • geometry

  • system_identifier

  • building_identifier

ToString()
duplicate()

Get a copy of this object.

move(moving_vec)

Move this object along a vector.

Parameters

moving_vec – A ladybug_geometry Vector3D with the direction and distance to move the object.

reflect(plane)

Reflect this object across a plane.

Parameters

plane – A ladybug_geometry Plane across which the object will be reflected.

rotate_xy(angle, origin)

Rotate this object counterclockwise in the XY plane by a certain angle.

Parameters

  • angle – An angle in degrees.

  • origin – A ladybug_geometry Point3D for the origin around which the object will be rotated.

scale(factor, origin=None)

Scale this object by a factor from an origin point.

Parameters

  • factor – A number representing how much the object should be scaled.

  • origin – A ladybug_geometry Point3D representing the origin from which to scale. If None, it will be scaled from the World origin (0, 0, 0).

to_geojson_dict(origin_lon_lat, conversion_factors)[source]

Get an ThermalJunction dictionary as it appears in an URBANopt geoJSON.

Parameters

  • origin_lon_lat – An array of two numbers in degrees. The first value represents the longitude of the scene origin in degrees (between -180 and +180). The second value represents latitude of the scene origin in degrees (between -90 and +90). Note that the “scene origin” is the (0, 0) coordinate in the 2D space of the input polygon.

  • conversion_factors – A tuple with two values used to translate between meters and longitude, latitude.

property building_identifier

Get or set a text string for the ID of a dragonfly Building.

property display_name

Get or set a string for the object name without any character restrictions.

If not set, this will be equal to the identifier.

property geometry

Get a Point2D representing the ThermalJunction.

property identifier

Get or set the text string for unique object identifier.

property system_identifier

Get or set a text string for the ID of a Transformer or Substation.