archetypal.template.GlazingMaterial

class archetypal.template.GlazingMaterial(Name, Density=2500, Conductivity=0.9, SolarTransmittance=0, SolarReflectanceFront=0, SolarReflectanceBack=0, VisibleTransmittance=0, VisibleReflectanceFront=0, VisibleReflectanceBack=0, IRTransmittance=0, IREmissivityFront=0, IREmissivityBack=0, DirtFactor=1.0, Cost=0.0, **kwargs)[source]

Glazing Materials class.

../_images/materials-glazing.png

Initialize a GlazingMaterial object.

Parameters

  • Name (str) – The name of the GlazingMaterial.

  • Density (float) – A number representing the density of the material in kg/m3. This is essentially the mass of one cubic meter of the material.

  • Conductivity (float) – Thermal conductivity (W/m-K).

  • SolarTransmittance (float) – Transmittance at normal incidence averaged over the solar spectrum.

  • SolarReflectanceFront (float) – Front-side reflectance at normal incidence averaged over the solar spectrum.

  • SolarReflectanceBack (float) – Back-side reflectance at normal incidence averaged over the solar spectrum.

  • VisibleTransmittance (float) – Transmittance at normal incidence averaged over the solar spectrum and weighted by the response of the human eye.

  • VisibleReflectanceFront (float) – Front-side reflectance at normal incidence averaged over the solar spectrum and weighted by the response of the human eye.

  • VisibleReflectanceBack (float) – Back-side reflectance at normal incidence averaged over the solar spectrum and weighted by the response of the human eye.

  • IRTransmittance (float) – Long-wave transmittance at normal incidence.

  • IREmissivityFront (float) – Front-side long-wave emissivity.

  • IREmissivityBack (float) – Back-side long-wave emissivity.

  • DirtFactor (float) – This is a factor that corrects for the presence of dirt on the glass. Using a material with dirt correction factor < 1.0 in the construction for an interior window will result in an error message.

  • **kwargs – keywords passed to the MaterialBase constructor. For more info, see MaterialBase.

property Conductivity

Get or set the conductivity of the material [W/m-K].

property Density

Get or set the density of the material [J/kg-K].

property DirtFactor

Get or set the dirt correction factor [-].

property IREmissivityBack

Get or set the infrared emissivity of the back side [-].

property Category

Get or set the Category attribute.

property Comments

Get or set the object comments.

property Cost

Get or set the cost of the material [$].

property DataSource

Get or set the datasource of the object.

property EmbodiedCarbon

Get or set the embodied carbon of the material [kgCO2/kg].

property EmbodiedEnergy

Get or set the embodied energy of the material [MJ/kg].

property IREmissivityFront

Get or set the infrared emissivity of the front side [-].

property Name

Get or set the name of the object.

property SubstitutionRatePattern

Get or set the substitution rate pattern of the material.

property SubstitutionTimestep

Get or set the substitution timestep of the material.

property TransportCarbon

Get or set the transportation carbon of the material [kgCO2/kg/km].

property TransportDistance

Get or set the transportation distance of the material [km].

property TransportEnergy

Get or set the transporation energy of the material [MJ/kg/km].

property allow_duplicates

Get or set the use of duplicates [bool].

duplicate()

Get copy of self.

extend(other, allow_duplicates)

Append other to self. Modify and return self.

Parameters

other (UmiBase) –

Returns

self

Return type

UmiBase

float_mean(other, attr, weights=None)

Calculates the average attribute value of two floats. Can provide weights.

Parameters

  • other (UmiBase) – The other UmiBase object to calculate average value with.

  • attr (str) – The attribute of the UmiBase object.

  • weights (iterable, optional) – Weights of [self, other] to calculate weighted average.

get_unique()

Return first object matching equality in the list of instantiated objects.

property id

Get or set the id.

property predecessors

Get or set the predecessors of self.

Of which objects is self made of. If from nothing else then self, return self.

rename(name)

renames self as well as the cached object

Parameters

name (str) – the name.

to_ref()

Return a ref pointer to self.

validate()

Validate object and fill in missing values.

property IRTransmittance

Get or set the infrared transmittance [-].

property VisibleReflectanceBack

Get or set the visible reflectance of the back side [-].

property VisibleReflectanceFront

Get or set the visible reflectance of the front side [-].

property VisibleTransmittance

Get or set the visible transmittance [-].

property SolarReflectanceBack

Get or set the solar reflectance of the back side [-].

property SolarReflectanceFront

Get or set the solar reflectance of the front side [-].

property SolarTransmittance

Get or set the solar transmittance [-].

combine(other, weights=None, allow_duplicates=False)[source]

Combine two GlazingMaterial objects together.

Parameters

other (GlazingMaterial) – The other GlazingMaterial object to combine with.

Returns

the combined GlazingMaterial object.

Return type

(GlazingMaterial)

to_dict()[source]

Return GlazingMaterial dictionary representation.

to_epbunch(idf, thickness) → geomeppy.patches.EpBunch[source]

Convert self to an EpBunch given an idf model and a thickness.

Parameters

  • idf (IDF) – An IDF model.

  • thickness (float) – the thickness of the material.

WindowMaterial:Glazing,
    B_Glass_Clear_3_0.003_B_Dbl_Air_Cl,    !- Name
    SpectralAverage,          !- Optical Data Type
    SpectralAverage,          !- Window Glass Spectral Data Set Name
    0.003,                    !- Thickness
    0.83,                     !- Solar Transmittance at Normal Incidence
    0.07,                     !- Front Side Solar Reflectance at Normal Incidence
    0.07,                     !- Back Side Solar Reflectance at Normal Incidence
    0.89,                     !- Visible Transmittance at Normal Incidence
    0.08,                     !- Front Side Visible Reflectance at Normal Incidence
    0.08,                     !- Back Side Visible Reflectance at Normal Incidence
    0,                        !- Infrared Transmittance at Normal Incidence
    0.84,                     !- Front Side Infrared Hemispherical Emissivity
    0.84,                     !- Back Side Infrared Hemispherical Emissivity
    0.9,                      !- Conductivity
    1;                        !- Dirt Correction Factor for Solar and Visible Transmittance
Returns

The EpBunch object added to the idf model.

Return type

EpBunch

mapping(validate=True)[source]

Get a dict based on the object properties, useful for dict repr.

Parameters

validate (bool) – If True, try to validate object before returning the mapping.

classmethod from_dict(data, **kwargs)[source]

Create a GlazingMaterial from a dictionary.

Parameters

data – The python dictionary following the format below.

{'$id': '1',
 'DirtFactor': 1.0,
 'IREmissivityBack': 0.0,
 'IREmissivityFront': 0.0,
 'IRTransmittance': 0.0,
 'SolarReflectanceBack': 0.0,
 'SolarReflectanceFront': 0.0,
 'SolarTransmittance': 0.0,
 'VisibleReflectanceBack': 0.0,
 'VisibleReflectanceFront': 0.0,
 'VisibleTransmittance': 0.0,
 'Conductivity': 0.0,
 'Cost': 0.0,
 'Density': 2500,
 'EmbodiedCarbon': 0.0,
 'EmbodiedEnergy': 0.0,
 'SubstitutionRatePattern': [1.0],
 'SubstitutionTimestep': 100.0,
 'TransportCarbon': 0.0,
 'TransportDistance': 0.0,
 'TransportEnergy': 0.0,
 'Category': 'Uncategorized',
 'Comments': '',
 'DataSource': None,
 'Name': 'A'}