dragonfly_energy.des.connector module¶
Thermal connector in a District Energy System.
- class dragonfly_energy.des.connector.HorizontalPipeParameter(buried_depth=1.5, diameter_ratio=11, pressure_drop_per_meter=300, insulation_conductivity=3.0, insulation_thickness=0.2, heat_capacity=2139000, roughness=1e-06)[source]¶
Bases:
object
Represents the properties of horizontal pipes contained within ThermalConnectors.
- Parameters:
buried_depth – The buried depth of the pipes in meters. (Default: 1.5)
diameter_ratio – A number for the ratio of pipe outer diameter to pipe wall thickness. (Default: 11).
pressure_drop_per_meter – A number for the pressure drop in pascals per meter of pipe. (Default: 300).
insulation_conductivity – A positive number for the conductivity of the pipe insulation material in W/m-K. If no insulation exists, this value should be a virtual insulation layer of soil since this value must be greater than zero. (Default: 3.0).
insulation_thickness – A positive number for the thickness of pipe insulation in meters. If no insulation exists, this value should be a virtual insulation layer of soil since this value must be greater than zero. (Default: 0.2)
heat_capacity – A number for the volumetric heat capacity of the pipe wall material in J/m3-K. (Default: 2,139,000).
roughness – A number for the linear dimension of bumps on the pipe surface in meters. (Default: 1e-06)
- Properties:
buried_depth
diameter_ratio
pressure_drop_per_meter
insulation_conductivity
insulation_thickness
heat_capacity
roughness
- classmethod from_dict(data)[source]¶
Create a HorizontalPipeParameter object from a dictionary
- Parameters:
data – A dictionary representation of an HorizontalPipeParameter object in the format below.
{ 'type': 'HorizontalPipeParameter', 'buried_depth': 2.0, # float for buried depth in meters 'diameter_ratio': 11, # float for diameter ratio 'pressure_drop_per_meter': 250, # float for pressure drop in Pa/m 'insulation_conductivity': 0.6, # float in W/m2-K 'insulation_thickness': 0.3, # float for thickness in meters 'heat_capacity': 1542000, # float in J/m3-K 'roughness': 1e-06 # float for the dimension of the surface bumps in meters }
- property buried_depth¶
Get or set a number for the buried depth of the pipes in meters.
- property diameter_ratio¶
Get or set a number for the ratio of pipe outer diameter to pipe wall thickness.
- property heat_capacity¶
Get or set a number for the volumetric heat capacity of the pipe in J/m3-K.
- property insulation_conductivity¶
Get or set a number for the conductivity of the insulation material in W/m-K.
- property insulation_thickness¶
Get or set a number for the thickness of the insulation material in meters.
- property pressure_drop_per_meter¶
Get or set a number for the pressure drop in pascals per meter of pipe.
- property roughness¶
Get or set a number for the dimension of the pipe surface bumps in meters.
- class dragonfly_energy.des.connector.ThermalConnector(identifier, geometry)[source]¶
Bases:
_GeometryBase
Represents a thermal connector carrying hot, chilled or ambient water in a DES.
- Parameters:
identifier – Text string for a unique thermal connector ID. Must contain only characters that are acceptable in a DES. 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 connector.
- Properties:
identifier
display_name
geometry
- ToString()¶
- duplicate()¶
Get a copy of this object.
- classmethod from_dict(data)[source]¶
Initialize an ThermalConnector from a dictionary.
- Parameters:
data – A dictionary representation of an ThermalConnector object.
- classmethod from_dict_abridged(data)[source]¶
Initialize an ThermalConnector from an abridged dictionary.
- Parameters:
data – A ThermalConnector dictionary.
- classmethod from_geojson_dict(data, origin_lon_lat, conversion_factors)[source]¶
Get a ThermalConnector from a dictionary as it appears in a GeoJSON.
- Parameters:
data – A GeoJSON dictionary representation of an ThermalConnector feature.
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.
- 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.
- reverse()[source]¶
Reverse the direction of this object’s geometry.
This is useful when trying to orient the connector to the direction of flow within a larger loop.
- 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(start_id, end_id, origin_lon_lat, conversion_factors, start_feature_id=None, end_feature_id=None)[source]¶
Get ThermalConnector dictionary as it appears in an URBANopt geoJSON.
- Parameters:
start_id – Identifier of the junction at the start of the pipe.
end_id – Identifier of the junction at the end of the pipe.
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.
start_feature_id – Optional identifier for a feature (Building or GHE field) at the start of the pipe.
end_feature_id – Optional identifier for a feature (Building or GHE field) at the end of the pipe.
- 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 LineSegment2D or Polyline2D representing the thermal connector.
- property identifier¶
Get or set the text string for unique object identifier.