Honeybee logo
Documentation Powered by Redocly

Honeybee Model Schema (1.59.2)

Download OpenAPI specification:Download

Ladybug Tools: info@ladybug.tools URL: https://github.com/ladybug-tools/honeybee-schema License: BSD

Documentation for Honeybee model schema

OpenAPI Specification with Inheritance

_AllAirBase

type
string (Type) ^_AllAirBase$
Default: "_AllAirBase"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Default: "NoEconomizer"
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy" "DifferentialDryBulbAndEnthalpy" "FixedDryBulb" "FixedEnthalpy" "ElectronicEnthalpy"

An enumeration.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the Rooms.

{
  • "type": "_AllAirBase",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "economizer_type": "NoEconomizer",
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "demand_controlled_ventilation": false
}

_DOASBase

type
string (Type) ^_DOASBase$
Default: "_DOASBase"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the Rooms.

doas_availability_schedule
string (Doas Availability Schedule) [ 1 .. 100 ] characters

An optional On/Off discrete schedule to set when the dedicated outdoor air system (DOAS) shuts off. This will not only prevent any outdoor air from flowing thorough the system but will also shut off the fans, which can result in more energy savings when spaces served by the DOAS are completely unoccupied. If None, the DOAS will be always on.

{
  • "type": "_DOASBase",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "demand_controlled_ventilation": false,
  • "doas_availability_schedule": "string"
}

_EquipmentBase

type
string (Type) ^_EquipmentBase$
Default: "_EquipmentBase"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by equipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "type": "_EquipmentBase",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts_per_area": 0,
  • "schedule": "string",
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

_FaceSubSet

type
string (Type) ^_FaceSubSet$
Default: "_FaceSubSet"

A base class to use when there is no baseclass available to fall on.

interior_construction
object (Interior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

exterior_construction
object (Exterior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

ground_construction
object (Ground Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

{
  • "type": "_FaceSubSet",
  • "interior_construction": {
    },
  • "exterior_construction": {
    },
  • "ground_construction": {
    }
}

_FaceSubSetAbridged

type
string (Type) ^_FaceSubSetAbridged$
Default: "_FaceSubSetAbridged"

A base class to use when there is no baseclass available to fall on.

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Surface or Adiabatic boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with an Outdoors boundary condition.

ground_construction
string (Ground Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Ground boundary condition.

{
  • "type": "_FaceSubSetAbridged",
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "ground_construction": "string"
}

_HeatCoolBase

type
string (Type) ^_HeatCoolBase$
Default: "_HeatCoolBase"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

{
  • "type": "_HeatCoolBase",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019"
}

_OpenAPIGenBaseModel

type
string (Type)
Default: "InvalidType"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "InvalidType"
}

_PropertiesBaseAbridged

type
string (Type) ^_PropertiesBaseAbridged$
Default: "_PropertiesBaseAbridged"

A base class to use when there is no baseclass available to fall on.

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

{
  • "type": "_PropertiesBaseAbridged",
  • "modifier": "string",
  • "modifier_blk": "string"
}

_RadianceAsset

type
string (Type) ^_RadianceAsset$
Default: "_RadianceAsset"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

room_identifier
string (Room Identifier) [ 1 .. 100 ] characters ^[.A-Za-z0-9_-]+$

Optional text string for the Room identifier to which this object belongs. This will be used to narrow down the number of aperture groups that have to be run with this sensor grid. If None, the grid will be run with all aperture groups in the model.

light_path
Array of strings (Light Path) [ items ]

Get or set a list of lists for the light path from the object to the sky. Each sub-list contains identifiers of aperture groups through which light passes. (eg. [["SouthWindow1"], ["static_apertures", "NorthWindow2"]]).Setting this property will override any auto-calculation of the light path from the model and room_identifier upon export to the simulation.

{
  • "type": "_RadianceAsset",
  • "identifier": "string",
  • "display_name": "string",
  • "room_identifier": "string",
  • "light_path": [
    ]
}

_TemplateSystem

type
string (Type) ^_TemplateSystem$
Default: "_TemplateSystem"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

{
  • "type": "_TemplateSystem",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019"
}

Adiabatic

type
string (Type) ^Adiabatic$
Default: "Adiabatic"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "Adiabatic"
}

AFNCrack

type
string (Type) ^AFNCrack$
Default: "AFNCrack"

A base class to use when there is no baseclass available to fall on.

flow_coefficient
required
number <double> (Flow Coefficient) > 0

A number in kg/s-m at 1 Pa per meter of crack length at the conditions defined in the ReferenceCrack condition; required to run an AirflowNetwork simulation. The DesignBuilder Cracks template defines the flow coefficient for a tight, low-leakage wall to be 0.00001 and 0.001 for external and internal constructions, respectively. Flow coefficients for a very poor, high-leakage wall are defined to be 0.0004 and 0.019 for external and internal constructions, respectively.

flow_exponent
number <double> (Flow Exponent) [ 0.5 .. 1 ]
Default: 0.65

An optional dimensionless number between 0.5 and 1 used to calculate the crack mass flow rate; required to run an AirflowNetwork simulation. This value represents the leak geometry impact on airflow, with 0.5 generally corresponding to turbulent orifice flow and 1 generally corresponding to laminar flow. The default of 0.65 is representative of many cases of wall and window leakage, used when the exponent cannot be measured.

{
  • "type": "AFNCrack",
  • "flow_coefficient": 0,
  • "flow_exponent": 0.65
}

AirBoundaryConstruction

type
string (Type) ^AirBoundaryConstruction$
Default: "AirBoundaryConstruction"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

air_mixing_per_area
number <double> (Air Mixing Per Area) >= 0
Default: 0.1

A positive number for the amount of air mixing between Rooms across the air boundary surface [m3/s-m2]. Default: 0.1 corresponds to average indoor air speeds of 0.1 m/s (roughly 20 fpm), which is typical of what would be induced by a HVAC system.

ScheduleRuleset (object) or ScheduleFixedInterval (object) (Air Mixing Schedule)

A fractional schedule as a ScheduleRuleset or ScheduleFixedInterval for the air mixing schedule across the construction. If unspecified, an Always On schedule will be assumed.

{
  • "type": "AirBoundaryConstruction",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "air_mixing_per_area": 0.1,
  • "air_mixing_schedule": {
    }
}

AirBoundaryConstructionAbridged

type
string (Type) ^AirBoundaryConstructionAbridged$
Default: "AirBoundaryConstructionAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

air_mixing_per_area
number <double> (Air Mixing Per Area) >= 0
Default: 0.1

A positive number for the amount of air mixing between Rooms across the air boundary surface [m3/s-m2]. Default: 0.1 corresponds to average indoor air speeds of 0.1 m/s (roughly 20 fpm), which is typical of what would be induced by a HVAC system.

air_mixing_schedule
string (Air Mixing Schedule) [ 1 .. 100 ] characters

Identifier of a fractional schedule for the air mixing schedule across the construction. If unspecified, an Always On schedule will be assumed.

{
  • "type": "AirBoundaryConstructionAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "air_mixing_per_area": 0.1,
  • "air_mixing_schedule": "string"
}

AllAirEconomizerType

string (AllAirEconomizerType)
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy" "DifferentialDryBulbAndEnthalpy" "FixedDryBulb" "FixedEnthalpy" "ElectronicEnthalpy"

An enumeration.

"NoEconomizer"

Aperture

type
string (Type) ^Aperture$
Default: "Aperture"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[.A-Za-z0-9_-]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

geometry
required
object (Geometry) Recursive

A single planar face in 3D space.

required
Outdoors (object) or Surface (object) (Boundary Condition)
properties
required
object (Properties) Recursive

Extension properties for particular simulation engines (Radiance, EnergyPlus).

is_operable
boolean (Is Operable)
Default: false

Boolean to note whether the Aperture can be opened for ventilation.

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object (eg. window sill, light shelf).

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. mullions, louvers).

{
  • "type": "Aperture",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "geometry": {
    },
  • "boundary_condition": {
    },
  • "properties": {
    },
  • "is_operable": false,
  • "indoor_shades": [
    ],
  • "outdoor_shades": [
    ]
}

ApertureConstructionSet

type
string (Type) ^ApertureConstructionSet$
Default: "ApertureConstructionSet"

A base class to use when there is no baseclass available to fall on.

WindowConstruction (object) or WindowConstructionShade (object) or WindowConstructionDynamic (object) (Interior Construction)

A WindowConstruction for all apertures with a Surface boundary condition.

WindowConstruction (object) or WindowConstructionShade (object) or WindowConstructionDynamic (object) (Window Construction)

A WindowConstruction for apertures with an Outdoors boundary condition, False is_operable property, and a Wall face type for their parent face.

WindowConstruction (object) or WindowConstructionShade (object) or WindowConstructionDynamic (object) (Skylight Construction)

A WindowConstruction for apertures with a Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

WindowConstruction (object) or WindowConstructionShade (object) or WindowConstructionDynamic (object) (Operable Construction)

A WindowConstruction for all apertures with an Outdoors boundary condition and True is_operable property.

{
  • "type": "ApertureConstructionSet",
  • "interior_construction": {
    },
  • "window_construction": {
    },
  • "skylight_construction": {
    },
  • "operable_construction": {
    }
}

ApertureConstructionSetAbridged

type
string (Type) ^ApertureConstructionSetAbridged$
Default: "ApertureConstructionSetAbridged"

A base class to use when there is no baseclass available to fall on.

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all apertures with a Surface boundary condition.

window_construction
string (Window Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for apertures with an Outdoors boundary condition, False is_operable property, and a Wall face type for their parent face.

skylight_construction
string (Skylight Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for apertures with a Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

operable_construction
string (Operable Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all apertures with an Outdoors boundary condition and True is_operable property.

{
  • "type": "ApertureConstructionSetAbridged",
  • "interior_construction": "string",
  • "window_construction": "string",
  • "skylight_construction": "string",
  • "operable_construction": "string"
}

ApertureEnergyPropertiesAbridged

type
string (Type) ^ApertureEnergyPropertiesAbridged$
Default: "ApertureEnergyPropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

construction
string (Construction) [ 1 .. 100 ] characters

Identifier of a WindowConstruction for the aperture. If None, the construction is set by the parent Room construction_set or the Model global_construction_set.

vent_opening
object (Vent Opening) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

{
  • "type": "ApertureEnergyPropertiesAbridged",
  • "construction": "string",
  • "vent_opening": {
    }
}

ApertureModifierSet

type
string (Type) ^ApertureModifierSet$
Default: "ApertureModifierSet"

A base class to use when there is no baseclass available to fall on.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Window Modifier)

A modifier object for apertures with an Outdoors boundary condition, False is_operable property, and Wall parent Face.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A modifier object for apertures with a Surface boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Skylight Modifier)

A modifier object for apertures with an Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Operable Modifier)

A modifier object for apertures with an Outdoors boundary condition and a True is_operable property.

{
  • "type": "ApertureModifierSet",
  • "window_modifier": {
    },
  • "interior_modifier": {
    },
  • "skylight_modifier": {
    },
  • "operable_modifier": {
    }
}

ApertureModifierSetAbridged

type
string (Type) ^ApertureModifierSetAbridged$
Default: "ApertureModifierSetAbridged"

A base class to use when there is no baseclass available to fall on.

window_modifier
string (Window Modifier)

Identifier of modifier object for apertures with an Outdoors boundary condition, False is_operable property, and Wall parent Face.

interior_modifier
string (Interior Modifier)

Identifier of modifier object for apertures with a Surface boundary condition.

skylight_modifier
string (Skylight Modifier)

Identifier of modifier object for apertures with an Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

operable_modifier
string (Operable Modifier)

Identifier of modifier object for apertures with an Outdoors boundary condition and a True is_operable property.

{
  • "type": "ApertureModifierSetAbridged",
  • "window_modifier": "string",
  • "interior_modifier": "string",
  • "skylight_modifier": "string",
  • "operable_modifier": "string"
}

AperturePropertiesAbridged

type
string (Type) ^AperturePropertiesAbridged$
Default: "AperturePropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

energy
object (ApertureEnergyPropertiesAbridged) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

radiance
object (ApertureRadiancePropertiesAbridged) Recursive

Base class of Abridged Radiance Properties.

{
  • "type": "AperturePropertiesAbridged",
  • "energy": {
    },
  • "radiance": {
    }
}

ApertureRadiancePropertiesAbridged

type
string (Type) ^ApertureRadiancePropertiesAbridged$
Default: "ApertureRadiancePropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

dynamic_group_identifier
string (Dynamic Group Identifier)

An optional string to note the dynamic group ' 'to which the Aperture is a part of. Apertures sharing the same ' 'dynamic_group_identifier will have their states change in unison. ' 'If None, the Aperture is assumed to be static. (default: None).

Array of objects (States)

An optional list of abridged states (default: None).

{
  • "type": "ApertureRadiancePropertiesAbridged",
  • "modifier": "string",
  • "modifier_blk": "string",
  • "dynamic_group_identifier": "string",
  • "states": [
    ]
}

Autocalculate

type
string (Type) ^Autocalculate$
Default: "Autocalculate"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "Autocalculate"
}

Autosize

type
string (Type) ^Autosize$
Default: "Autosize"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "Autosize"
}

Baseboard

type
string (Type) ^Baseboard$
Default: "Baseboard"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (BaseboardEquipmentType)
Default: "ElectricBaseboard"
Enum: "ElectricBaseboard" "BoilerBaseboard" "ASHPBaseboard" "DHWBaseboard"

An enumeration.

{
  • "type": "Baseboard",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "ElectricBaseboard"
}

BaseboardEquipmentType

string (BaseboardEquipmentType)
Enum: "ElectricBaseboard" "BoilerBaseboard" "ASHPBaseboard" "DHWBaseboard"

An enumeration.

"ElectricBaseboard"

BaseModifierSet

type
string (Type) ^BaseModifierSet$
Default: "BaseModifierSet"

A base class to use when there is no baseclass available to fall on.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

{
  • "type": "BaseModifierSet",
  • "exterior_modifier": {
    },
  • "interior_modifier": {
    }
}

BaseModifierSetAbridged

type
string (Type) ^BaseModifierSetAbridged$
Default: "BaseModifierSetAbridged"

A base class to use when there is no baseclass available to fall on.

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

{
  • "type": "BaseModifierSetAbridged",
  • "exterior_modifier": "string",
  • "interior_modifier": "string"
}

BSDF

type
string (Type) ^BSDF$
Default: "BSDF"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

bsdf_data
required
string (Bsdf Data)

A string with the contents of the BSDF XML file.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"Void"}

Material modifier.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers.

up_orientation
Array of numbers <double> (Up Orientation) = 3 items [ items <double > ]
Default: [0.01,0.01,1]

Vector as sequence that sets the hemisphere that the BSDF material faces.

thickness
number <double> (Thickness)
Default: 0

Optional number to set the thickness of the BSDF material Sign of thickness indicates whether proxied geometry is behind the BSDF surface (when thickness is positive) or in front (when thickness is negative).

function_file
string (Function File) [ 1 .. 100 ] characters
Default: "."

Optional input for function file. Using "." will ensure that BSDF data is written to the root of wherever a given study is run.

transform
string (Transform) [ 1 .. 100 ] characters

Optional transform input to scale the thickness and reorient the up vector.

front_diffuse_reflectance
Array of numbers <double> (Front Diffuse Reflectance) = 3 items [ items <double > ]

Optional additional front diffuse reflectance as sequence of three RGB numbers.

back_diffuse_reflectance
Array of numbers <double> (Back Diffuse Reflectance) = 3 items [ items <double > ]

Optional additional back diffuse reflectance as sequence of three RGB numbers.

diffuse_transmittance
Array of numbers <double> (Diffuse Transmittance) = 3 items [ items <double > ]

Optional additional diffuse transmittance as sequence of three RGB numbers.

{
  • "type": "BSDF",
  • "identifier": "string",
  • "display_name": "string",
  • "bsdf_data": "string",
  • "modifier": {
    },
  • "dependencies": [
    ],
  • "up_orientation": [
    ],
  • "thickness": 0,
  • "function_file": ".",
  • "transform": "string",
  • "front_diffuse_reflectance": [
    ],
  • "back_diffuse_reflectance": [
    ],
  • "diffuse_transmittance": [
    ]
}

BuildingType

string (BuildingType)
Enum: "LowRise" "HighRise"

An enumeration.

"LowRise"

Color

type
string (Type) ^Color$
Default: "Color"

A base class to use when there is no baseclass available to fall on.

r
required
integer <int32> (R) [ 0 .. 255 ]

Value for red channel.

g
required
integer <int32> (G) [ 0 .. 255 ]

Value for green channel.

b
required
integer <int32> (B) [ 0 .. 255 ]

Value for blue channel.

a
integer <int32> (A) [ 0 .. 255 ]
Default: 255

Value for the alpha channel, which defines the opacity as a number between 0 (fully transparent) and 255 (fully opaque).

{
  • "type": "Color",
  • "r": 255,
  • "g": 255,
  • "b": 255,
  • "a": 255
}

ConstructionSet

type
string (Type) ^ConstructionSet$
Default: "ConstructionSet"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

wall_set
object (Wall Set) Recursive

A set of constructions for wall assemblies.

floor_set
object (Floor Set) Recursive

A set of constructions for floor assemblies.

roof_ceiling_set
object (Roof Ceiling Set) Recursive

A set of constructions for roof and ceiling assemblies.

aperture_set
object (Aperture Set) Recursive

A set of constructions for aperture assemblies.

door_set
object (Door Set) Recursive

A set of constructions for door assemblies.

shade_construction
object (Shade Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

AirBoundaryConstruction (object) or OpaqueConstruction (object) (Air Boundary Construction)

An AirBoundaryConstruction or OpaqueConstruction to set the properties of Faces with an AirBoundary type.

{
  • "type": "ConstructionSet",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "wall_set": {
    },
  • "floor_set": {
    },
  • "roof_ceiling_set": {
    },
  • "aperture_set": {
    },
  • "door_set": {
    },
  • "shade_construction": {
    },
  • "air_boundary_construction": {
    }
}

ConstructionSetAbridged

type
string (Type) ^ConstructionSetAbridged$
Default: "ConstructionSetAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

wall_set
object (Wall Set) Recursive

A set of constructions for wall, floor, or roof assemblies.

floor_set
object (Floor Set) Recursive

A set of constructions for wall, floor, or roof assemblies.

roof_ceiling_set
object (Roof Ceiling Set) Recursive

A set of constructions for wall, floor, or roof assemblies.

aperture_set
object (Aperture Set) Recursive

A set of constructions for aperture assemblies.

door_set
object (Door Set) Recursive

A set of constructions for door assemblies.

shade_construction
string (Shade Construction) [ 1 .. 100 ] characters

The identifier of a ShadeConstruction to set the reflectance properties of all outdoor shades of all objects to which this ConstructionSet is assigned.

air_boundary_construction
string (Air Boundary Construction) [ 1 .. 100 ] characters

The identifier of an AirBoundaryConstruction or OpaqueConstruction to set the properties of Faces with an AirBoundary type.

{
  • "type": "ConstructionSetAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "wall_set": {
    },
  • "floor_set": {
    },
  • "roof_ceiling_set": {
    },
  • "aperture_set": {
    },
  • "door_set": {
    },
  • "shade_construction": "string",
  • "air_boundary_construction": "string"
}

ControlType

string (ControlType)
Enum: "AlwaysOn" "OnIfHighSolarOnWindow" "OnIfHighHorizontalSolar" "OnIfHighOutdoorAirTemperature" "OnIfHighZoneAirTemperature" "OnIfHighZoneCooling" "OnNightIfLowOutdoorTempAndOffDay" "OnNightIfLowInsideTempAndOffDay" "OnNightIfHeatingAndOffDay"

Choices for how the shading device is controlled.

"AlwaysOn"

DatedBaseModel

type
string (Type) ^DatedBaseModel$
Default: "DatedBaseModel"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "DatedBaseModel"
}

DaylightingControl

type
string (Type) ^DaylightingControl$
Default: "DaylightingControl"

A base class to use when there is no baseclass available to fall on.

sensor_position
required
Array of numbers <double> (Sensor Position) = 3 items [ items <double > ]

A point as 3 (x, y, z) values for the position of the daylight sensor within the parent Room. This point should lie within the Room volume in order for the results to be meaningful.

illuminance_setpoint
number <double> (Illuminance Setpoint) > 0
Default: 300

A number for the illuminance setpoint in lux beyond which electric lights are dimmed if there is sufficient daylight.

control_fraction
number <double> (Control Fraction) [ 0 .. 1 ]
Default: 1

A number between 0 and 1 that represents the fraction of the Room lights that are dimmed when the illuminance at the sensor position is at the specified illuminance. 1 indicates that all lights are dim-able while 0 indicates that no lights are dim-able. Deeper rooms should have lower control fractions to account for the face that the lights in the back of the space do not dim in response to suitable daylight at the front of the room.

min_power_input
number <double> (Min Power Input) [ 0 .. 1 ]
Default: 0.3

A number between 0 and 1 for the the lowest power the lighting system can dim down to, expressed as a fraction of maximum input power.

min_light_output
number <double> (Min Light Output) [ 0 .. 1 ]
Default: 0.2

A number between 0 and 1 the lowest lighting output the lighting system can dim down to, expressed as a fraction of maximum light output.

off_at_minimum
boolean (Off At Minimum)
Default: false

Boolean to note whether lights should switch off completely when they get to the minimum power input.

{
  • "type": "DaylightingControl",
  • "sensor_position": [
    ],
  • "illuminance_setpoint": 300,
  • "control_fraction": 1,
  • "min_power_input": 0.3,
  • "min_light_output": 0.2,
  • "off_at_minimum": false
}

DetailedHVAC

type
string (Type) ^DetailedHVAC$
Default: "DetailedHVAC"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

specification
required
object (Specification)

A JSON-serializable dictionary representing the full specification of the detailed system. This can be obtained by calling the ToJson() method on any IronBug HVAC system and then serializing the resulting JSON string into a Python dictionary using the native Python json package. Note that the Rooms that the HVAC is assigned to must be specified as ThermalZones under this specification in order for the resulting Model this HVAC is a part of to be valid.

{
  • "type": "DetailedHVAC",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "specification": { }
}

Door

type
string (Type) ^Door$
Default: "Door"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[.A-Za-z0-9_-]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

geometry
required
object (Geometry) Recursive

A single planar face in 3D space.

required
Outdoors (object) or Surface (object) (Boundary Condition)
properties
required
object (Properties) Recursive

Extension properties for particular simulation engines (Radiance, EnergyPlus).

is_glass
boolean (Is Glass)
Default: false

Boolean to note whether this object is a glass door as opposed to an opaque door.

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object.

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. entryway awning).

{
  • "type": "Door",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "geometry": {
    },
  • "boundary_condition": {
    },
  • "properties": {
    },
  • "is_glass": false,
  • "indoor_shades": [
    ],
  • "outdoor_shades": [
    ]
}

DoorConstructionSet

type
string (Type) ^DoorConstructionSet$
Default: "DoorConstructionSet"

A base class to use when there is no baseclass available to fall on.

interior_construction
object (Interior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

exterior_construction
object (Exterior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

overhead_construction
object (Overhead Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

WindowConstruction (object) or WindowConstructionShade (object) or WindowConstructionDynamic (object) (Exterior Glass Construction)

A WindowConstruction for all glass doors with an Outdoors boundary condition.

WindowConstruction (object) or WindowConstructionShade (object) or WindowConstructionDynamic (object) (Interior Glass Construction)

A WindowConstruction for all glass doors with a Surface boundary condition.

{
  • "type": "DoorConstructionSet",
  • "interior_construction": {
    },
  • "exterior_construction": {
    },
  • "overhead_construction": {
    },
  • "exterior_glass_construction": {
    },
  • "interior_glass_construction": {
    }
}

DoorConstructionSetAbridged

type
string (Type) ^DoorConstructionSetAbridged$
Default: "DoorConstructionSetAbridged"

A base class to use when there is no baseclass available to fall on.

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for all opaque doors with a Surface boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for opaque doors with an Outdoors boundary condition and a Wall face type for their parent face.

overhead_construction
string (Overhead Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for opaque doors with an Outdoors boundary condition and a RoofCeiling or Floor type for their parent face.

exterior_glass_construction
string (Exterior Glass Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all glass doors with an Outdoors boundary condition.

interior_glass_construction
string (Interior Glass Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all glass doors with a Surface boundary condition.

{
  • "type": "DoorConstructionSetAbridged",
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "overhead_construction": "string",
  • "exterior_glass_construction": "string",
  • "interior_glass_construction": "string"
}

DoorEnergyPropertiesAbridged

type
string (Type) ^DoorEnergyPropertiesAbridged$
Default: "DoorEnergyPropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

construction
string (Construction) [ 1 .. 100 ] characters

Identifier of an OpaqueConstruction or WindowConstruction for the door. Note that the host door must have the is_glass property set to True to assign a WindowConstruction. If None, the construction is set by the parent Room construction_set or the Model global_construction_set.

vent_opening
object (Vent Opening) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

{
  • "type": "DoorEnergyPropertiesAbridged",
  • "construction": "string",
  • "vent_opening": {
    }
}

DoorModifierSet

type
string (Type) ^DoorModifierSet$
Default: "DoorModifierSet"

A base class to use when there is no baseclass available to fall on.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Glass Modifier)

A modifier object for glass with a Surface boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Glass Modifier)

A modifier object for glass with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Overhead Modifier)

A window modifier object for doors with an Outdoors boundary condition and a RoofCeiling or Floor face type for their parent face.

{
  • "type": "DoorModifierSet",
  • "exterior_modifier": {
    },
  • "interior_modifier": {
    },
  • "interior_glass_modifier": {
    },
  • "exterior_glass_modifier": {
    },
  • "overhead_modifier": {
    }
}

DoorModifierSetAbridged

type
string (Type) ^DoorModifierSetAbridged$
Default: "DoorModifierSetAbridged"

A base class to use when there is no baseclass available to fall on.

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

interior_glass_modifier
string (Interior Glass Modifier)

Identifier of modifier object for glass with a Surface boundary condition.

exterior_glass_modifier
string (Exterior Glass Modifier)

Identifier of modifier object for glass with an Outdoors boundary condition.

overhead_modifier
string (Overhead Modifier)

Identifier of a modifier object for doors with an Outdoors boundary condition and a RoofCeiling or Floor face type for their parent face.

{
  • "type": "DoorModifierSetAbridged",
  • "exterior_modifier": "string",
  • "interior_modifier": "string",
  • "interior_glass_modifier": "string",
  • "exterior_glass_modifier": "string",
  • "overhead_modifier": "string"
}

DoorPropertiesAbridged

type
string (Type) ^DoorPropertiesAbridged$
Default: "DoorPropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

energy
object (DoorEnergyPropertiesAbridged) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

radiance
object (DoorRadiancePropertiesAbridged) Recursive

Base class of Abridged Radiance Properties.

{
  • "type": "DoorPropertiesAbridged",
  • "energy": {
    },
  • "radiance": {
    }
}

DoorRadiancePropertiesAbridged

type
string (Type) ^DoorRadiancePropertiesAbridged$
Default: "DoorRadiancePropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

dynamic_group_identifier
string (Dynamic Group Identifier)

An optional string to note the dynamic group ' 'to which the Door is a part of. Doors sharing the same ' 'dynamic_group_identifier will have their states change in unison. ' 'If None, the Door is assumed to be static. (default: None).

Array of objects (States)

An optional list of abridged states (default: None).

{
  • "type": "DoorRadiancePropertiesAbridged",
  • "modifier": "string",
  • "modifier_blk": "string",
  • "dynamic_group_identifier": "string",
  • "states": [
    ]
}

EconomizerType

string (EconomizerType)
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

"NoEconomizer"

ElectricEquipment

type
string (Type) ^ElectricEquipment$
Default: "ElectricEquipment"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by equipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "type": "ElectricEquipment",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts_per_area": 0,
  • "schedule": {
    },
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

ElectricEquipmentAbridged

type
string (Type) ^ElectricEquipmentAbridged$
Default: "ElectricEquipmentAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by equipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "type": "ElectricEquipmentAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts_per_area": 0,
  • "schedule": "string",
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

ElectricLoadCenter

type
string (Type) ^ElectricLoadCenter$
Default: "ElectricLoadCenter"

A base class to use when there is no baseclass available to fall on.

inverter_efficiency
number <double> (Inverter Efficiency) ( 0 .. 1 ]
Default: 0.96

A number between 0 and 1 for the load center inverter nominal rated DC-to-AC conversion efficiency. An inverter converts DC power, such as that output by photovoltaic panels, to AC power, such as that distributed by the electrical grid and is available from standard electrical outlets. Inverter efficiency is defined as the inverter rated AC power output divided by its rated DC power output.

inverter_dc_to_ac_size_ratio
number <double> (Inverter Dc To Ac Size Ratio) > 0
Default: 1.1

A positive number (typically greater than 1) for the ratio of the inverter DC rated size to its AC rated size. Typically, inverters are not sized to convert the full DC output under standard test conditions (STC) as such conditions rarely occur in reality and therefore unnecessarily add to the size/cost of the inverter. For a system with a high DC to AC size ratio, during times when the DC power output exceeds the inverter rated DC input size, the inverter limits the power output by increasing the DC operating voltage, which moves the arrays operating point down its current-voltage (I-V) curve. In EnergyPlus, this is accomplished by simply limiting the system output to the AC size as dictated by the ratio. The default value of 1.1 is reasonable for most systems. A typical range is 1.1 to 1.25, although some large-scale systems have ratios of as high as 1.5. The optimal value depends on the system location, array orientation, and module cost.

{
  • "type": "ElectricLoadCenter",
  • "inverter_efficiency": 0.96,
  • "inverter_dc_to_ac_size_ratio": 1.1
}

EnergyBaseModel

type
string (Type) ^EnergyBaseModel$
Default: "EnergyBaseModel"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

{
  • "type": "EnergyBaseModel",
  • "identifier": "string",
  • "display_name": "string"
}

EnergyMaterial

type
string (Type) ^EnergyMaterial$
Default: "EnergyMaterial"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

thickness
required
number <double> (Thickness) ( 0 .. 3 ]

Thickness of the material layer in meters.

conductivity
required
number <double> (Conductivity) > 0

Thermal conductivity of the material layer in W/m-K.

density
required
number <double> (Density) > 0

Density of the material layer in kg/m3.

specific_heat
required
number <double> (Specific Heat) >= 100

Specific heat of the material layer in J/kg-K.

roughness
string (Roughness)
Default: "MediumRough"
Enum: "VeryRough" "Rough" "MediumRough" "MediumSmooth" "Smooth" "VerySmooth"

Relative roughness of a particular material layer.

thermal_absorptance
number <double> (Thermal Absorptance) ( 0 .. 0.99999 ]
Default: 0.9

Fraction of incident long wavelength radiation that is absorbed by the material. Default: 0.9.

solar_absorptance
number <double> (Solar Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident solar radiation absorbed by the material. Default: 0.7.

visible_absorptance
number <double> (Visible Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident visible wavelength radiation absorbed by the material. Default: 0.7.

{
  • "type": "EnergyMaterial",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "thickness": 3,
  • "conductivity": 0,
  • "density": 0,
  • "specific_heat": 100,
  • "roughness": "MediumRough",
  • "thermal_absorptance": 0.9,
  • "solar_absorptance": 0.7,
  • "visible_absorptance": 0.7
}

EnergyMaterialNoMass

type
string (Type) ^EnergyMaterialNoMass$
Default: "EnergyMaterialNoMass"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

r_value
required
number <double> (R Value) >= 0.001

The thermal resistance (R-value) of the material layer [m2-K/W].

roughness
string (Roughness)
Default: "MediumRough"
Enum: "VeryRough" "Rough" "MediumRough" "MediumSmooth" "Smooth" "VerySmooth"

Relative roughness of a particular material layer.

thermal_absorptance
number <double> (Thermal Absorptance) ( 0 .. 0.99999 ]
Default: 0.9

Fraction of incident long wavelength radiation that is absorbed by the material. Default: 0.9.

solar_absorptance
number <double> (Solar Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident solar radiation absorbed by the material. Default: 0.7.

visible_absorptance
number <double> (Visible Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident visible wavelength radiation absorbed by the material. Default: 0.7.

{
  • "type": "EnergyMaterialNoMass",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "r_value": 0.001,
  • "roughness": "MediumRough",
  • "thermal_absorptance": 0.9,
  • "solar_absorptance": 0.7,
  • "visible_absorptance": 0.7
}

EnergyMaterialVegetation

type
string (Type) ^EnergyMaterialVegetation$
Default: "EnergyMaterialVegetation"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

roughness
string (Roughness)
Default: "MediumRough"
Enum: "VeryRough" "Rough" "MediumRough" "MediumSmooth" "Smooth" "VerySmooth"

Relative roughness of a particular material layer.

thickness
number <double> (Thickness) ( 0 .. 3 ]
Default: 0.1

Thickness of the soil layer in meters.

conductivity
number <double> (Conductivity) > 0
Default: 0.35

Thermal conductivity of the dry soil in W/m-K.

density
number <double> (Density) > 0
Default: 1100

Density of the dry soil in kg/m3.

specific_heat
number <double> (Specific Heat) >= 100
Default: 1200

Specific heat of the dry soil in J/kg-K.

soil_thermal_absorptance
number <double> (Soil Thermal Absorptance) ( 0 .. 0.99999 ]
Default: 0.9

Fraction of incident long wavelength radiation that is absorbed by the soil. Default: 0.9.

soil_solar_absorptance
number <double> (Soil Solar Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident solar radiation absorbed by the soil. Default: 0.7.

soil_visible_absorptance
number <double> (Soil Visible Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident visible wavelength radiation absorbed by the material. Default: 0.7.

plant_height
number <double> (Plant Height) [ 0.005 .. 1 ]
Default: 0.2

The height of plants in the vegetation in meters.

leaf_area_index
number <double> (Leaf Area Index) [ 0.001 .. 5 ]
Default: 1

The projected leaf area per unit area of soil surface (aka. Leaf Area Index or LAI). Note that the fraction of vegetation cover is calculated directly from LAI using an empirical relation.

leaf_reflectivity
number <double> (Leaf Reflectivity) [ 0.005 .. 0.5 ]
Default: 0.22

The fraction of incident solar radiation that is reflected by the leaf surfaces. Solar radiation includes the visible spectrum as well as infrared and ultraviolet wavelengths. Typical values are 0.18 to 0.25.

leaf_emissivity
number <double> (Leaf Emissivity) [ 0.8 .. 1 ]
Default: 0.95

The ratio of thermal radiation emitted from leaf surfaces to that emitted by an ideal black body at the same temperature.

min_stomatal_resist
number <double> (Min Stomatal Resist) [ 50 .. 300 ]
Default: 180

The resistance of the plants to moisture transport [s/m]. Plants with low values of stomatal resistance will result in higher evapotranspiration rates than plants with high resistance.

sat_vol_moist_cont
number <double> (Sat Vol Moist Cont) [ 0.1 .. 0.5 ]
Default: 0.3

The saturation moisture content of the soil by volume.

residual_vol_moist_cont
number <double> (Residual Vol Moist Cont) [ 0.01 .. 0.1 ]
Default: 0.01

The residual moisture content of the soil by volume.

init_vol_moist_cont
number <double> (Init Vol Moist Cont) [ 0.05 .. 0.5 ]
Default: 0.01

The initial moisture content of the soil by volume.

moist_diff_model
string (MoistureDiffusionModel)
Default: "Simple"
Enum: "Simple" "Advanced"

Acceptable values for the moisture diffusion model for vegetation.

{
  • "type": "EnergyMaterialVegetation",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "roughness": "MediumRough",
  • "thickness": 0.1,
  • "conductivity": 0.35,
  • "density": 1100,
  • "specific_heat": 1200,
  • "soil_thermal_absorptance": 0.9,
  • "soil_solar_absorptance": 0.7,
  • "soil_visible_absorptance": 0.7,
  • "plant_height": 0.2,
  • "leaf_area_index": 1,
  • "leaf_reflectivity": 0.22,
  • "leaf_emissivity": 0.95,
  • "min_stomatal_resist": 180,
  • "sat_vol_moist_cont": 0.3,
  • "residual_vol_moist_cont": 0.01,
  • "init_vol_moist_cont": 0.01,
  • "moist_diff_model": "Simple"
}

EnergyWindowFrame

type
string (Type) ^EnergyWindowFrame$
Default: "EnergyWindowFrame"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

width
required
number <double> (Width) ( 0 .. 1 ]

Number for the width of frame in plane of window [m]. The frame width is assumed to be the same on all sides of window..

conductance
required
number <double> (Conductance) > 0

Number for the thermal conductance of the frame material measured from inside to outside of the frame surface (no air films) and taking 2D conduction effects into account [W/m2-K].

edge_to_center_ratio
number <double> (Edge To Center Ratio) ( 0 .. 4 ]
Default: 1

Number between 0 and 4 for the ratio of the glass conductance near the frame (excluding air films) divided by the glass conductance at the center of the glazing (excluding air films). This is used only for multi-pane glazing constructions. This ratio should usually be greater than 1.0 since the spacer material that separates the glass panes is usually more conductive than the gap between panes. A value of 1 effectively indicates no spacer. Values should usually be obtained from the LBNL WINDOW program so that the unique characteristics of the window construction can be accounted for.

outside_projection
number <double> (Outside Projection) [ 0 .. 0.5 ]
Default: 0

Number for the distance that the frame projects outward from the outside face of the glazing [m]. This is used to calculate shadowing of frame onto glass, solar absorbed by the frame, IR emitted and absorbed by the frame, and convection from frame.

inside_projection
number <double> (Inside Projection) [ 0 .. 0.5 ]
Default: 0

Number for the distance that the frame projects inward from the inside face of the glazing [m]. This is used to calculate solar absorbed by the frame, IR emitted and absorbed by the frame, and convection from frame.

thermal_absorptance
number <double> (Thermal Absorptance) ( 0 .. 0.99999 ]
Default: 0.9

Fraction of incident long wavelength radiation that is absorbed by the frame material.

solar_absorptance
number <double> (Solar Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident solar radiation absorbed by the frame material.

visible_absorptance
number <double> (Visible Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident visible wavelength radiation absorbed by the frame material.

{
  • "type": "EnergyWindowFrame",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "width": 1,
  • "conductance": 0,
  • "edge_to_center_ratio": 1,
  • "outside_projection": 0,
  • "inside_projection": 0,
  • "thermal_absorptance": 0.9,
  • "solar_absorptance": 0.7,
  • "visible_absorptance": 0.7
}

EnergyWindowMaterialBlind

type
string (Type) ^EnergyWindowMaterialBlind$
Default: "EnergyWindowMaterialBlind"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

slat_orientation
string (SlatOrientation)
Default: "Horizontal"
Enum: "Horizontal" "Vertical"

An enumeration.

slat_width
number <double> (Slat Width) ( 0 .. 1 ]
Default: 0.025

The width of slat measured from edge to edge in meters.

slat_separation
number <double> (Slat Separation) ( 0 .. 1 ]
Default: 0.01875

The distance between the front of a slat and the back of the adjacent slat in meters.

slat_thickness
number <double> (Slat Thickness) ( 0 .. 0.1 ]
Default: 0.001

The distance between the faces of a slat in meters. The default value is 0.001.

slat_angle
number <double> (Slat Angle) [ 0 .. 180 ]
Default: 45

The angle (degrees) between the glazing outward normal and the slat outward normal where the outward normal points away from the front face of the slat (degrees). The default value is 45.

slat_conductivity
number <double> (Slat Conductivity) > 0
Default: 221

The thermal conductivity of the slat in W/(m-K). Default: 221.

beam_solar_transmittance
number <double> (Beam Solar Transmittance) [ 0 .. 1 )
Default: 0

The beam solar transmittance of the slat, assumed to be independent of angle of incidence on the slat. Any transmitted beam radiation is assumed to be 100% diffuse (i.e., slats are translucent). The default value is 0.

beam_solar_reflectance
number <double> (Beam Solar Reflectance) [ 0 .. 1 )
Default: 0.5

The beam solar reflectance of the front side of the slat, it is assumed to be independent of the angle of incidence. Default: 0.5.

beam_solar_reflectance_back
number <double> (Beam Solar Reflectance Back) [ 0 .. 1 )
Default: 0.5

The beam solar reflectance of the back side of the slat, it is assumed to be independent of the angle of incidence. Default: 0.5.

diffuse_solar_transmittance
number <double> (Diffuse Solar Transmittance) [ 0 .. 1 )
Default: 0

The slat transmittance for hemispherically diffuse solar radiation. Default: 0.

diffuse_solar_reflectance
number <double> (Diffuse Solar Reflectance) [ 0 .. 1 )
Default: 0.5

The front-side slat reflectance for hemispherically diffuse solar radiation. Default: 0.5.

diffuse_solar_reflectance_back
number <double> (Diffuse Solar Reflectance Back) [ 0 .. 1 )
Default: 0.5

The back-side slat reflectance for hemispherically diffuse solar radiation. Default: 0.5.

beam_visible_transmittance
number <double> (Beam Visible Transmittance) [ 0 .. 1 )
Default: 0

The beam visible transmittance of the slat, it is assumed to be independent of the angle of incidence. Default: 0.

beam_visible_reflectance
number <double> (Beam Visible Reflectance) [ 0 .. 1 )
Default: 0.5

The beam visible reflectance on the front side of the slat, it is assumed to be independent of the angle of incidence. Default: 0.5.

beam_visible_reflectance_back
number <double> (Beam Visible Reflectance Back) [ 0 .. 1 )
Default: 0.5

The beam visible reflectance on the back side of the slat, it is assumed to be independent of the angle of incidence. Default: 0.5.

diffuse_visible_transmittance
number <double> (Diffuse Visible Transmittance) [ 0 .. 1 )
Default: 0

The slat transmittance for hemispherically diffuse visible radiation. This value should equal “Slat Beam Visible Transmittance.”

diffuse_visible_reflectance
number <double> (Diffuse Visible Reflectance) [ 0 .. 1 )
Default: 0.5

The front-side slat reflectance for hemispherically diffuse visible radiation. This value should equal “Front Side Slat Beam Visible Reflectance.” Default: 0.5.

diffuse_visible_reflectance_back
number <double> (Diffuse Visible Reflectance Back) [ 0 .. 1 )
Default: 0.5

The back-side slat reflectance for hemispherically diffuse visible radiation. This value should equal “Back Side Slat Beam Visible Reflectance. Default: 0.5.”

infrared_transmittance
number <double> (Infrared Transmittance) [ 0 .. 1 )
Default: 0

The slat infrared hemispherical transmittance. It is zero for solid metallic, wooden or glass slats, but may be non-zero in some cases such as for thin plastic slats. The default value is 0.

emissivity
number <double> (Emissivity) [ 0 .. 1 )
Default: 0.9

Front side hemispherical emissivity of the slat. Default is 0.9 for most materials. The default value is 0.9.

emissivity_back
number <double> (Emissivity Back) [ 0 .. 1 )
Default: 0.9

Back side hemispherical emissivity of the slat. Default is 0.9 for most materials. The default value is 0.9.

distance_to_glass
number <double> (Distance To Glass) [ 0.01 .. 1 ]
Default: 0.05

The distance from the mid-plane of the blind to the adjacent glass in meters. The default value is 0.05.

top_opening_multiplier
number <double> (Top Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the top of the shade, divided by the horizontal area between glass and shade.

bottom_opening_multiplier
number <double> (Bottom Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the bottom of the shade, divided by the horizontal area between glass and shade.

left_opening_multiplier
number <double> (Left Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the left side of the shade, divided by the vertical area between glass and shade.

right_opening_multiplier
number <double> (Right Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the right side of the shade, divided by the vertical area between glass and shade.

{
  • "type": "EnergyWindowMaterialBlind",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "slat_orientation": "Horizontal",
  • "slat_width": 0.025,
  • "slat_separation": 0.01875,
  • "slat_thickness": 0.001,
  • "slat_angle": 45,
  • "slat_conductivity": 221,
  • "beam_solar_transmittance": 0,
  • "beam_solar_reflectance": 0.5,
  • "beam_solar_reflectance_back": 0.5,
  • "diffuse_solar_transmittance": 0,
  • "diffuse_solar_reflectance": 0.5,
  • "diffuse_solar_reflectance_back": 0.5,
  • "beam_visible_transmittance": 0,
  • "beam_visible_reflectance": 0.5,
  • "beam_visible_reflectance_back": 0.5,
  • "diffuse_visible_transmittance": 0,
  • "diffuse_visible_reflectance": 0.5,
  • "diffuse_visible_reflectance_back": 0.5,
  • "infrared_transmittance": 0,
  • "emissivity": 0.9,
  • "emissivity_back": 0.9,
  • "distance_to_glass": 0.05,
  • "top_opening_multiplier": 0.5,
  • "bottom_opening_multiplier": 0.5,
  • "left_opening_multiplier": 0.5,
  • "right_opening_multiplier": 0.5
}

EnergyWindowMaterialGas

type
string (Type) ^EnergyWindowMaterialGas$
Default: "EnergyWindowMaterialGas"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

thickness
number <double> (Thickness) > 0
Default: 0.0125

Thickness of the gas layer in meters. Default: 0.0125.

gas_type
string (GasType)
Default: "Air"
Enum: "Air" "Argon" "Krypton" "Xenon"

An enumeration.

{
  • "type": "EnergyWindowMaterialGas",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "thickness": 0.0125,
  • "gas_type": "Air"
}

EnergyWindowMaterialGasCustom

type
string (Type) ^EnergyWindowMaterialGasCustom$
Default: "EnergyWindowMaterialGasCustom"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

conductivity_coeff_a
required
number <double> (Conductivity Coeff A)

The A coefficient for gas conductivity in W/(m-K).

viscosity_coeff_a
required
number <double> (Viscosity Coeff A) > 0

The A coefficient for gas viscosity in kg/(m-s).

specific_heat_coeff_a
required
number <double> (Specific Heat Coeff A) > 0

The A coefficient for gas specific heat in J/(kg-K).

specific_heat_ratio
required
number <double> (Specific Heat Ratio) > 1

The specific heat ratio for gas.

molecular_weight
required
number <double> (Molecular Weight) [ 20 .. 200 ]

The molecular weight for gas in g/mol.

thickness
number <double> (Thickness) > 0
Default: 0.0125

Thickness of the gas layer in meters. Default: 0.0125.

conductivity_coeff_b
number <double> (Conductivity Coeff B)
Default: 0

The B coefficient for gas conductivity in W/(m-K2).

conductivity_coeff_c
number <double> (Conductivity Coeff C)
Default: 0

The C coefficient for gas conductivity in W/(m-K3).

viscosity_coeff_b
number <double> (Viscosity Coeff B)
Default: 0

The B coefficient for gas viscosity in kg/(m-s-K).

viscosity_coeff_c
number <double> (Viscosity Coeff C)
Default: 0

The C coefficient for gas viscosity in kg/(m-s-K2).

specific_heat_coeff_b
number <double> (Specific Heat Coeff B)
Default: 0

The B coefficient for gas specific heat in J/(kg-K2).

specific_heat_coeff_c
number <double> (Specific Heat Coeff C)
Default: 0

The C coefficient for gas specific heat in J/(kg-K3).

{
  • "type": "EnergyWindowMaterialGasCustom",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "conductivity_coeff_a": 0,
  • "viscosity_coeff_a": 0,
  • "specific_heat_coeff_a": 0,
  • "specific_heat_ratio": 2,
  • "molecular_weight": 20,
  • "thickness": 0.0125,
  • "conductivity_coeff_b": 0,
  • "conductivity_coeff_c": 0,
  • "viscosity_coeff_b": 0,
  • "viscosity_coeff_c": 0,
  • "specific_heat_coeff_b": 0,
  • "specific_heat_coeff_c": 0
}

EnergyWindowMaterialGasMixture

type
string (Type) ^EnergyWindowMaterialGasMixture$
Default: "EnergyWindowMaterialGasMixture"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

gas_types
required
Array of strings (GasType) [ 2 .. 4 ] items
Items Enum: "Air" "Argon" "Krypton" "Xenon"

List of gases in the gas mixture.

gas_fractions
required
Array of numbers <double> (Gas Fractions) [ 2 .. 4 ] items [ items <double > ( 0 .. 1 ) ]

A list of fractional numbers describing the volumetric fractions of gas types in the mixture. This list must align with the gas_types list and must sum to 1.

thickness
number <double> (Thickness) > 0
Default: 0.0125

The thickness of the gas mixture layer in meters.

{
  • "type": "EnergyWindowMaterialGasMixture",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "gas_types": [
    ],
  • "gas_fractions": [
    ],
  • "thickness": 0.0125
}

EnergyWindowMaterialGlazing

type
string (Type) ^EnergyWindowMaterialGlazing$
Default: "EnergyWindowMaterialGlazing"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

thickness
number <double> (Thickness) > 0
Default: 0.003

The surface-to-surface thickness of the glass in meters. Default: 0.003.

solar_transmittance
number <double> (Solar Transmittance) [ 0 .. 1 ]
Default: 0.85

Transmittance of solar radiation through the glass at normal incidence. Default: 0.85 for clear glass.

solar_reflectance
number <double> (Solar Reflectance) [ 0 .. 1 ]
Default: 0.075

Reflectance of solar radiation off of the front side of the glass at normal incidence, averaged over the solar spectrum. Default: 0.075 for clear glass.

Autocalculate (object) or Solar Reflectance Back (number) (Solar Reflectance Back)
Default: {"type":"Autocalculate"}

Reflectance of solar radiation off of the back side of the glass at normal incidence, averaged over the solar spectrum.

visible_transmittance
number <double> (Visible Transmittance) [ 0 .. 1 ]
Default: 0.9

Transmittance of visible light through the glass at normal incidence. Default: 0.9 for clear glass.

visible_reflectance
number <double> (Visible Reflectance) [ 0 .. 1 ]
Default: 0.075

Reflectance of visible light off of the front side of the glass at normal incidence. Default: 0.075 for clear glass.

Autocalculate (object) or Visible Reflectance Back (number) (Visible Reflectance Back)
Default: {"type":"Autocalculate"}

Reflectance of visible light off of the back side of the glass at normal incidence averaged over the solar spectrum and weighted by the response of the human eye.

infrared_transmittance
number <double> (Infrared Transmittance) [ 0 .. 1 ]
Default: 0

Long-wave transmittance at normal incidence.

emissivity
number <double> (Emissivity) [ 0 .. 1 ]
Default: 0.84

Infrared hemispherical emissivity of the front (outward facing) side of the glass. Default: 0.84, which is typical for clear glass without a low-e coating.

emissivity_back
number <double> (Emissivity Back) [ 0 .. 1 ]
Default: 0.84

Infrared hemispherical emissivity of the back (inward facing) side of the glass. Default: 0.84, which is typical for clear glass without a low-e coating.

conductivity
number <double> (Conductivity) > 0
Default: 0.9

Thermal conductivity of the glass in W/(m-K). Default: 0.9, which is typical for clear glass without a low-e coating.

dirt_correction
number <double> (Dirt Correction)
Default: 1

Factor that corrects for the presence of dirt on the glass. A default value of 1 indicates the glass is clean.

solar_diffusing
boolean (Solar Diffusing)
Default: false

If False (default), the beam solar radiation incident on the glass is transmitted as beam radiation with no diffuse component.If True, the beam solar radiation incident on the glass is transmitted as hemispherical diffuse radiation with no beam component.

{
  • "type": "EnergyWindowMaterialGlazing",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "thickness": 0.003,
  • "solar_transmittance": 0.85,
  • "solar_reflectance": 0.075,
  • "solar_reflectance_back": {
    },
  • "visible_transmittance": 0.9,
  • "visible_reflectance": 0.075,
  • "visible_reflectance_back": {
    },
  • "infrared_transmittance": 0,
  • "emissivity": 0.84,
  • "emissivity_back": 0.84,
  • "conductivity": 0.9,
  • "dirt_correction": 1,
  • "solar_diffusing": false
}

EnergyWindowMaterialShade

type
string (Type) ^EnergyWindowMaterialShade$
Default: "EnergyWindowMaterialShade"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

solar_transmittance
number <double> (Solar Transmittance) [ 0 .. 1 )
Default: 0.4

The transmittance averaged over the solar spectrum. It is assumed independent of incidence angle. Default: 0.4.

solar_reflectance
number <double> (Solar Reflectance) [ 0 .. 1 )
Default: 0.5

The reflectance averaged over the solar spectrum. It us assumed same on both sides of shade and independent of incidence angle. Default value is 0.5

visible_transmittance
number <double> (Visible Transmittance) [ 0 .. 1 )
Default: 0.4

The transmittance averaged over the solar spectrum and weighted by the response of the human eye. It is assumed independent of incidence angle. Default: 0.4.

visible_reflectance
number <double> (Visible Reflectance) [ 0 .. 1 )
Default: 0.4

The transmittance averaged over the solar spectrum and weighted by the response of the human eye. It is assumed independent of incidence angle. Default: 0.4

emissivity
number <double> (Emissivity) ( 0 .. 1 )
Default: 0.9

The effective long-wave infrared hemispherical emissivity. It is assumed same on both sides of shade. Default: 0.9.

infrared_transmittance
number <double> (Infrared Transmittance) [ 0 .. 1 )
Default: 0

The effective long-wave transmittance. It is assumed independent of incidence angle. Default: 0.

thickness
number <double> (Thickness) > 0
Default: 0.005

The thickness of the shade material in meters. Default: 0.005.

conductivity
number <double> (Conductivity) > 0
Default: 0.1

The conductivity of the shade material in W/(m-K). Default value is 0.1.

distance_to_glass
number <double> (Distance To Glass) [ 0.001 .. 1 ]
Default: 0.05

The distance from shade to adjacent glass in meters. Default value is 0.05

top_opening_multiplier
number <double> (Top Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the top of the shade, divided by the horizontal area between glass and shade. Default: 0.5.

bottom_opening_multiplier
number <double> (Bottom Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the bottom of the shade, divided by the horizontal area between glass and shade. Default: 0.5.

left_opening_multiplier
number <double> (Left Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the left side of the shade, divided by the vertical area between glass and shade. Default: 0.5.

right_opening_multiplier
number <double> (Right Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the right side of the shade, divided by the vertical area between glass and shade. Default: 0.5.

airflow_permeability
number <double> (Airflow Permeability) [ 0 .. 0.8 ]
Default: 0

The fraction of the shade surface that is open to air flow. If air cannot pass through the shade material, airflow_permeability = 0. Default: 0.

{
  • "type": "EnergyWindowMaterialShade",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "solar_transmittance": 0.4,
  • "solar_reflectance": 0.5,
  • "visible_transmittance": 0.4,
  • "visible_reflectance": 0.4,
  • "emissivity": 0.9,
  • "infrared_transmittance": 0,
  • "thickness": 0.005,
  • "conductivity": 0.1,
  • "distance_to_glass": 0.05,
  • "top_opening_multiplier": 0.5,
  • "bottom_opening_multiplier": 0.5,
  • "left_opening_multiplier": 0.5,
  • "right_opening_multiplier": 0.5,
  • "airflow_permeability": 0
}

EnergyWindowMaterialSimpleGlazSys

type
string (Type) ^EnergyWindowMaterialSimpleGlazSys$
Default: "EnergyWindowMaterialSimpleGlazSys"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

u_factor
required
number <double> (U Factor) ( 0 .. 12 ]

The overall heat transfer coefficient for window system in W/m2-K. Note that constructions with U-values above 5.8 should not be assigned to skylights as this implies the resistance of the window is negative when air films are subtracted.

shgc
required
number <double> (Shgc) ( 0 .. 1 )

Unit-less quantity for the Solar Heat Gain Coefficient (solar transmittance + conduction) at normal incidence and vertical orientation.

vt
number <double> (Vt) ( 0 .. 1 )
Default: 0.54

The fraction of visible light falling on the window that makes it through the glass at normal incidence.

{
  • "type": "EnergyWindowMaterialSimpleGlazSys",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "u_factor": 12,
  • "shgc": 0,
  • "vt": 0.54
}

EvaporativeCooler

type
string (Type) ^EvaporativeCooler$
Default: "EvaporativeCooler"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (EvaporativeCoolerEquipmentType)
Default: "EvapCoolers_ElectricBaseboard"
Enum: "EvapCoolers_ElectricBaseboard" "EvapCoolers_BoilerBaseboard" "EvapCoolers_ASHPBaseboard" "EvapCoolers_DHWBaseboard" "EvapCoolers_Furnace" "EvapCoolers_UnitHeaters" "EvapCoolers"

An enumeration.

{
  • "type": "EvaporativeCooler",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "EvapCoolers_ElectricBaseboard"
}

EvaporativeCoolerEquipmentType

string (EvaporativeCoolerEquipmentType)
Enum: "EvapCoolers_ElectricBaseboard" "EvapCoolers_BoilerBaseboard" "EvapCoolers_ASHPBaseboard" "EvapCoolers_DHWBaseboard" "EvapCoolers_Furnace" "EvapCoolers_UnitHeaters" "EvapCoolers"

An enumeration.

"EvapCoolers_ElectricBaseboard"

Face3D

type
string (Type) ^Face3D$
Default: "Face3D"

A base class to use when there is no baseclass available to fall on.

boundary
required
Array of numbers (Boundary) >= 3 items [ items <double > = 3 items [ items <double > ] ]

A list of points representing the outer boundary vertices of the face. The list should include at least 3 points and each point should be a list of 3 (x, y, z) values.

holes
Array of numbers (Holes) [ items >= 3 items [ items <double > = 3 items [ items <double > ] ] ]

Optional list of lists with one list for each hole in the face.Each hole should be a list of at least 3 points and each point a list of 3 (x, y, z) values. If None, it will be assumed that there are no holes in the face.

plane
object (Plane) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

{
  • "type": "Face3D",
  • "boundary": [
    ],
  • "holes": [
    ],
  • "plane": {
    }
}

Face

type
string (Type) ^Face$
Default: "Face"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[.A-Za-z0-9_-]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

geometry
required
object (Geometry) Recursive

A single planar face in 3D space.

face_type
required
string (FaceType)
Enum: "Wall" "Floor" "RoofCeiling" "AirBoundary"

An enumeration.

required
Ground (object) or Outdoors (object) or Adiabatic (object) or Surface (object) or OtherSideTemperature (object) (Boundary Condition)
properties
required
object (Properties) Recursive

Extension properties for particular simulation engines (Radiance, EnergyPlus).

Array of objects (Apertures)

Apertures assigned to this Face. Should be coplanar with this Face and completely within the boundary of the Face to be valid.

Array of objects (Doors)

Doors assigned to this Face. Should be coplanar with this Face and completely within the boundary of the Face to be valid.

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object.

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. balcony, overhang).

{
  • "type": "Face",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "geometry": {
    },
  • "face_type": "Wall",
  • "boundary_condition": {
    },
  • "properties": {
    },
  • "apertures": [
    ],
  • "doors": [
    ],
  • "indoor_shades": [
    ],
  • "outdoor_shades": [
    ]
}

FaceEnergyPropertiesAbridged

type
string (Type) ^FaceEnergyPropertiesAbridged$
Default: "FaceEnergyPropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

construction
string (Construction) [ 1 .. 100 ] characters

Identifier of an OpaqueConstruction for the Face. If None, the construction is set by the parent Room construction_set or the Model global_construction_set.

vent_crack
object (Vent Crack) Recursive

Properties for airflow through a crack.

{
  • "type": "FaceEnergyPropertiesAbridged",
  • "construction": "string",
  • "vent_crack": {
    }
}

FacePropertiesAbridged

type
string (Type) ^FacePropertiesAbridged$
Default: "FacePropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

energy
object (FaceEnergyPropertiesAbridged) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

radiance
object (FaceRadiancePropertiesAbridged) Recursive

Base class of Abridged Radiance Properties.

{
  • "type": "FacePropertiesAbridged",
  • "energy": {
    },
  • "radiance": {
    }
}

FaceRadiancePropertiesAbridged

type
string (Type) ^FaceRadiancePropertiesAbridged$
Default: "FaceRadiancePropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

{
  • "type": "FaceRadiancePropertiesAbridged",
  • "modifier": "string",
  • "modifier_blk": "string"
}

FaceType

string (FaceType)
Enum: "Wall" "Floor" "RoofCeiling" "AirBoundary"

An enumeration.

"Wall"

FCU

type
string (Type) ^FCU$
Default: "FCU"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (FCUEquipmentType)
Default: "FCU_Chiller_Boiler"
Enum: "FCU_Chiller_Boiler" "FCU_Chiller_ASHP" "FCU_Chiller_DHW" "FCU_Chiller_ElectricBaseboard" "FCU_Chiller_GasHeaters" "FCU_Chiller" "FCU_ACChiller_Boiler" "FCU_ACChiller_ASHP" "FCU_ACChiller_DHW" "FCU_ACChiller_ElectricBaseboard" "FCU_ACChiller_GasHeaters" "FCU_ACChiller" "FCU_DCW_Boiler" "FCU_DCW_ASHP" "FCU_DCW_DHW" "FCU_DCW_ElectricBaseboard" "FCU_DCW_GasHeaters" "FCU_DCW"

An enumeration.

{
  • "type": "FCU",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "FCU_Chiller_Boiler"
}

FCUEquipmentType

string (FCUEquipmentType)
Enum: "FCU_Chiller_Boiler" "FCU_Chiller_ASHP" "FCU_Chiller_DHW" "FCU_Chiller_ElectricBaseboard" "FCU_Chiller_GasHeaters" "FCU_Chiller" "FCU_ACChiller_Boiler" "FCU_ACChiller_ASHP" "FCU_ACChiller_DHW" "FCU_ACChiller_ElectricBaseboard" "FCU_ACChiller_GasHeaters" "FCU_ACChiller" "FCU_DCW_Boiler" "FCU_DCW_ASHP" "FCU_DCW_DHW" "FCU_DCW_ElectricBaseboard" "FCU_DCW_GasHeaters" "FCU_DCW"

An enumeration.

"FCU_Chiller_Boiler"

FCUwithDOASAbridged

type
string (Type) ^FCUwithDOASAbridged$
Default: "FCUwithDOASAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the Rooms.

doas_availability_schedule
string (Doas Availability Schedule) [ 1 .. 100 ] characters

An optional On/Off discrete schedule to set when the dedicated outdoor air system (DOAS) shuts off. This will not only prevent any outdoor air from flowing thorough the system but will also shut off the fans, which can result in more energy savings when spaces served by the DOAS are completely unoccupied. If None, the DOAS will be always on.

equipment_type
string (FCUwithDOASEquipmentType)
Default: "DOAS_FCU_Chiller_Boiler"
Enum: "DOAS_FCU_Chiller_Boiler" "DOAS_FCU_Chiller_ASHP" "DOAS_FCU_Chiller_DHW" "DOAS_FCU_Chiller_ElectricBaseboard" "DOAS_FCU_Chiller_GasHeaters" "DOAS_FCU_Chiller" "DOAS_FCU_ACChiller_Boiler" "DOAS_FCU_ACChiller_ASHP" "DOAS_FCU_ACChiller_DHW" "DOAS_FCU_ACChiller_ElectricBaseboard" "DOAS_FCU_ACChiller_GasHeaters" "DOAS_FCU_ACChiller" "DOAS_FCU_DCW_Boiler" "DOAS_FCU_DCW_ASHP" "DOAS_FCU_DCW_DHW" "DOAS_FCU_DCW_ElectricBaseboard" "DOAS_FCU_DCW_GasHeaters" "DOAS_FCU_DCW"

An enumeration.

{
  • "type": "FCUwithDOASAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "demand_controlled_ventilation": false,
  • "doas_availability_schedule": "string",
  • "equipment_type": "DOAS_FCU_Chiller_Boiler"
}

FCUwithDOASEquipmentType

string (FCUwithDOASEquipmentType)
Enum: "DOAS_FCU_Chiller_Boiler" "DOAS_FCU_Chiller_ASHP" "DOAS_FCU_Chiller_DHW" "DOAS_FCU_Chiller_ElectricBaseboard" "DOAS_FCU_Chiller_GasHeaters" "DOAS_FCU_Chiller" "DOAS_FCU_ACChiller_Boiler" "DOAS_FCU_ACChiller_ASHP" "DOAS_FCU_ACChiller_DHW" "DOAS_FCU_ACChiller_ElectricBaseboard" "DOAS_FCU_ACChiller_GasHeaters" "DOAS_FCU_ACChiller" "DOAS_FCU_DCW_Boiler" "DOAS_FCU_DCW_ASHP" "DOAS_FCU_DCW_DHW" "DOAS_FCU_DCW_ElectricBaseboard" "DOAS_FCU_DCW_GasHeaters" "DOAS_FCU_DCW"

An enumeration.

"DOAS_FCU_Chiller_Boiler"

FloorConstructionSet

type
string (Type) ^FloorConstructionSet$
Default: "FloorConstructionSet"

A base class to use when there is no baseclass available to fall on.

interior_construction
object (Interior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

exterior_construction
object (Exterior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

ground_construction
object (Ground Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

{
  • "type": "FloorConstructionSet",
  • "interior_construction": {
    },
  • "exterior_construction": {
    },
  • "ground_construction": {
    }
}

FloorConstructionSetAbridged

type
string (Type) ^FloorConstructionSetAbridged$
Default: "FloorConstructionSetAbridged"

A base class to use when there is no baseclass available to fall on.

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Surface or Adiabatic boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with an Outdoors boundary condition.

ground_construction
string (Ground Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Ground boundary condition.

{
  • "type": "FloorConstructionSetAbridged",
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "ground_construction": "string"
}

FloorModifierSet

type
string (Type) ^FloorModifierSet$
Default: "FloorModifierSet"

A base class to use when there is no baseclass available to fall on.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

{
  • "type": "FloorModifierSet",
  • "exterior_modifier": {
    },
  • "interior_modifier": {
    }
}

FloorModifierSetAbridged

type
string (Type) ^FloorModifierSetAbridged$
Default: "FloorModifierSetAbridged"

A base class to use when there is no baseclass available to fall on.

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

{
  • "type": "FloorModifierSetAbridged",
  • "exterior_modifier": "string",
  • "interior_modifier": "string"
}

ForcedAirFurnace

type
string (Type) ^ForcedAirFurnace$
Default: "ForcedAirFurnace"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (FurnaceEquipmentType)
Default: "Furnace"
Enum: "Furnace" "Furnace_Electric"

An enumeration.

{
  • "type": "ForcedAirFurnace",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "Furnace"
}

FuelTypes

string (FuelTypes)
Enum: "Electricity" "NaturalGas" "Propane" "FuelOilNo1" "FuelOilNo2" "Diesel" "Gasoline" "Coal" "Steam" "DistrictHeating" "DistrictCooling" "OtherFuel1" "OtherFuel2" "None"

Designates the acceptable fuel types for process loads.

"Electricity"

FurnaceEquipmentType

string (FurnaceEquipmentType)
Enum: "Furnace" "Furnace_Electric"

An enumeration.

"Furnace"

GasEquipment

type
string (Type) ^GasEquipment$
Default: "GasEquipment"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by equipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "type": "GasEquipment",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts_per_area": 0,
  • "schedule": {
    },
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

GasEquipmentAbridged

type
string (Type) ^GasEquipmentAbridged$
Default: "GasEquipmentAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by equipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "type": "GasEquipmentAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts_per_area": 0,
  • "schedule": "string",
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

GasType

string (GasType)
Enum: "Air" "Argon" "Krypton" "Xenon"

An enumeration.

"Air"

GasUnitHeater

type
string (Type) ^GasUnitHeater$
Default: "GasUnitHeater"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (GasUnitHeaterEquipmentType)
Default: "GasHeaters"
Value: "GasHeaters"

An enumeration.

{
  • "type": "GasUnitHeater",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "GasHeaters"
}

GasUnitHeaterEquipmentType

string (GasUnitHeaterEquipmentType)
Value: "GasHeaters"

An enumeration.

"GasHeaters"

Glass

type
string (Type) ^Glass$
Default: "Glass"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"Void"}

Material modifier.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers.

r_transmissivity
number <double> (R Transmissivity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel transmissivity.

g_transmissivity
number <double> (G Transmissivity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel transmissivity.

b_transmissivity
number <double> (B Transmissivity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel transmissivity.

refraction_index
number <double> (Refraction Index) > 1
Default: 1.52

A value greater than 1 for the index of refraction. Typical values are 1.52 for float glass and 1.4 for ETFE.

{
  • "type": "Glass",
  • "identifier": "string",
  • "display_name": "string",
  • "modifier": {
    },
  • "dependencies": [
    ],
  • "r_transmissivity": 0,
  • "g_transmissivity": 0,
  • "b_transmissivity": 0,
  • "refraction_index": 1.52
}

GlobalConstructionSet

type
string (Type) ^GlobalConstructionSet$
Default: "GlobalConstructionSet"

A base class to use when there is no baseclass available to fall on.

Array of EnergyMaterial (object) or EnergyMaterialNoMass (object) or EnergyWindowMaterialGlazing (object) or EnergyWindowMaterialGas (object) (Materials)
Default: [{"identifier":"Generic Roof Membrane","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.01,"conductivity":0.16,"density":1120,"specific_heat":1460,"thermal_absorptance":0.9,"solar_absorptance":0.65,"visible_absorptance":0.65},{"identifier":"Generic Acoustic Tile","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumSmooth","thickness":0.02,"conductivity":0.06,"density":368,"specific_heat":590,"thermal_absorptance":0.9,"solar_absorptance":0.2,"visible_absorptance":0.2},{"identifier":"Generic 25mm Wood","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumSmooth","thickness":0.0254,"conductivity":0.15,"density":608,"specific_heat":1630,"thermal_absorptance":0.9,"solar_absorptance":0.5,"visible_absorptance":0.5},{"identifier":"Generic HW Concrete","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.2,"conductivity":1.95,"density":2240,"specific_heat":900,"thermal_absorptance":0.9,"solar_absorptance":0.8,"visible_absorptance":0.8},{"identifier":"Generic Window Air Gap","display_name":null,"user_data":null,"type":"EnergyWindowMaterialGas","thickness":0.0127,"gas_type":"Air"},{"identifier":"Generic Gypsum Board","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumSmooth","thickness":0.0127,"conductivity":0.16,"density":800,"specific_heat":1090,"thermal_absorptance":0.9,"solar_absorptance":0.5,"visible_absorptance":0.5},{"identifier":"Generic Wall Air Gap","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"Smooth","thickness":0.1,"conductivity":0.667,"density":1.28,"specific_heat":1000,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Ceiling Air Gap","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"Smooth","thickness":0.1,"conductivity":0.556,"density":1.28,"specific_heat":1000,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Brick","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.1,"conductivity":0.9,"density":1920,"specific_heat":790,"thermal_absorptance":0.9,"solar_absorptance":0.65,"visible_absorptance":0.65},{"identifier":"Generic 50mm Insulation","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.05,"conductivity":0.03,"density":43,"specific_heat":1210,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Low-e Glass","display_name":null,"user_data":null,"type":"EnergyWindowMaterialGlazing","thickness":0.006,"solar_transmittance":0.45,"solar_reflectance":0.36,"solar_reflectance_back":0.36,"visible_transmittance":0.71,"visible_reflectance":0.21,"visible_reflectance_back":0.21,"infrared_transmittance":0,"emissivity":0.84,"emissivity_back":0.047,"conductivity":1,"dirt_correction":1,"solar_diffusing":false},{"identifier":"Generic Painted Metal","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"Smooth","thickness":0.0015,"conductivity":45,"density":7690,"specific_heat":410,"thermal_absorptance":0.9,"solar_absorptance":0.5,"visible_absorptance":0.5},{"identifier":"Generic LW Concrete","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.1,"conductivity":0.53,"density":1280,"specific_heat":840,"thermal_absorptance":0.9,"solar_absorptance":0.8,"visible_absorptance":0.8},{"identifier":"Generic 25mm Insulation","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.025,"conductivity":0.03,"density":43,"specific_heat":1210,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Clear Glass","display_name":null,"user_data":null,"type":"EnergyWindowMaterialGlazing","thickness":0.006,"solar_transmittance":0.77,"solar_reflectance":0.07,"solar_reflectance_back":0.07,"visible_transmittance":0.88,"visible_reflectance":0.08,"visible_reflectance_back":0.08,"infrared_transmittance":0,"emissivity":0.84,"emissivity_back":0.84,"conductivity":1,"dirt_correction":1,"solar_diffusing":false}]

Global Honeybee Energy materials.

Array of OpaqueConstructionAbridged (object) or WindowConstructionAbridged (object) or ShadeConstruction (object) or AirBoundaryConstructionAbridged (object) (Constructions)
Default: [{"identifier":"Generic Interior Door","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 25mm Wood"]},{"identifier":"Generic Single Pane","display_name":null,"user_data":null,"type":"WindowConstructionAbridged","materials":["Generic Clear Glass"],"frame":null},{"identifier":"Generic Shade","display_name":null,"user_data":null,"type":"ShadeConstruction","solar_reflectance":0.35,"visible_reflectance":0.35,"is_specular":false},{"identifier":"Generic Context","display_name":null,"user_data":null,"type":"ShadeConstruction","solar_reflectance":0.2,"visible_reflectance":0.2,"is_specular":false},{"identifier":"Generic Interior Ceiling","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic LW Concrete","Generic Ceiling Air Gap","Generic Acoustic Tile"]},{"identifier":"Generic Interior Wall","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Gypsum Board","Generic Wall Air Gap","Generic Gypsum Board"]},{"identifier":"Generic Exposed Floor","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Painted Metal","Generic Ceiling Air Gap","Generic 50mm Insulation","Generic LW Concrete"]},{"identifier":"Generic Interior Floor","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Acoustic Tile","Generic Ceiling Air Gap","Generic LW Concrete"]},{"identifier":"Generic Ground Slab","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 50mm Insulation","Generic HW Concrete"]},{"identifier":"Generic Roof","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Roof Membrane","Generic 50mm Insulation","Generic LW Concrete","Generic Ceiling Air Gap","Generic Acoustic Tile"]},{"identifier":"Generic Exterior Wall","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Brick","Generic LW Concrete","Generic 50mm Insulation","Generic Wall Air Gap","Generic Gypsum Board"]},{"identifier":"Generic Underground Wall","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 50mm Insulation","Generic HW Concrete","Generic Wall Air Gap","Generic Gypsum Board"]},{"identifier":"Generic Air Boundary","display_name":null,"user_data":null,"type":"AirBoundaryConstructionAbridged","air_mixing_per_area":0.1,"air_mixing_schedule":"Always On"},{"identifier":"Generic Underground Roof","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 50mm Insulation","Generic HW Concrete","Generic Ceiling Air Gap","Generic Acoustic Tile"]},{"identifier":"Generic Double Pane","display_name":null,"user_data":null,"type":"WindowConstructionAbridged","materials":["Generic Low-e Glass","Generic Window Air Gap","Generic Clear Glass"],"frame":null},{"identifier":"Generic Exterior Door","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Painted Metal","Generic 25mm Insulation","Generic Painted Metal"]}]

Global Honeybee Energy constructions.

wall_set
object (Wall Set) Recursive
Default: {"interior_construction":"Generic Interior Wall","exterior_construction":"Generic Exterior Wall","ground_construction":"Generic Underground Wall","type":"WallConstructionSetAbridged"}

A set of constructions for wall, floor, or roof assemblies.

floor_set
object (Floor Set) Recursive
Default: {"interior_construction":"Generic Interior Floor","exterior_construction":"Generic Exposed Floor","ground_construction":"Generic Ground Slab","type":"FloorConstructionSetAbridged"}

A set of constructions for wall, floor, or roof assemblies.

roof_ceiling_set
object (Roof Ceiling Set) Recursive
Default: {"interior_construction":"Generic Interior Ceiling","exterior_construction":"Generic Roof","ground_construction":"Generic Underground Roof","type":"RoofCeilingConstructionSetAbridged"}

A set of constructions for wall, floor, or roof assemblies.

aperture_set
object (Aperture Set) Recursive
Default: {"type":"ApertureConstructionSetAbridged","interior_construction":"Generic Single Pane","window_construction":"Generic Double Pane","skylight_construction":"Generic Double Pane","operable_construction":"Generic Double Pane"}

A set of constructions for aperture assemblies.

door_set
object (Door Set) Recursive
Default: {"type":"DoorConstructionSetAbridged","interior_construction":"Generic Interior Door","exterior_construction":"Generic Exterior Door","overhead_construction":"Generic Exterior Door","exterior_glass_construction":"Generic Double Pane","interior_glass_construction":"Generic Single Pane"}

A set of constructions for door assemblies.

shade_construction
string (Shade Construction)
Default: "Generic Shade"

Global Honeybee Construction for building-attached Shades.

context_construction
string (Context Construction)
Default: "Generic Context"

Global Honeybee Construction for context Shades.

air_boundary_construction
string (Air Boundary Construction)
Default: "Generic Air Boundary"

Global Honeybee Construction for AirBoundary Faces.

{
  • "type": "GlobalConstructionSet",
  • "materials": [
    ],
  • "constructions": [
    ],
  • "wall_set": {
    },
  • "floor_set": {
    },
  • "roof_ceiling_set": {
    },
  • "aperture_set": {
    },
  • "door_set": {
    },
  • "shade_construction": "Generic Shade",
  • "context_construction": "Generic Context",
  • "air_boundary_construction": "Generic Air Boundary"
}

GlobalModifierSet

type
string (Type) ^GlobalModifierSet$
Default: "GlobalModifierSet"

A base class to use when there is no baseclass available to fall on.

Array of Plastic (object) or Glass (object) or Trans (object) (Modifiers)
Default: [{"identifier":"generic_floor_0.20","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.2,"g_reflectance":0.2,"b_reflectance":0.2,"specularity":0,"roughness":0},{"identifier":"generic_wall_0.50","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.5,"g_reflectance":0.5,"b_reflectance":0.5,"specularity":0,"roughness":0},{"identifier":"generic_ceiling_0.80","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.8,"g_reflectance":0.8,"b_reflectance":0.8,"specularity":0,"roughness":0},{"identifier":"generic_opaque_door_0.50","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.5,"g_reflectance":0.5,"b_reflectance":0.5,"specularity":0,"roughness":0},{"identifier":"generic_interior_shade_0.50","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.5,"g_reflectance":0.5,"b_reflectance":0.5,"specularity":0,"roughness":0},{"identifier":"generic_exterior_shade_0.35","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.35,"g_reflectance":0.35,"b_reflectance":0.35,"specularity":0,"roughness":0},{"identifier":"generic_context_0.20","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.2,"g_reflectance":0.2,"b_reflectance":0.2,"specularity":0,"roughness":0},{"identifier":"generic_interior_window_vis_0.88","display_name":null,"type":"Glass","modifier":null,"dependencies":[],"r_transmissivity":0.9584154328610596,"g_transmissivity":0.9584154328610596,"b_transmissivity":0.9584154328610596,"refraction_index":null},{"identifier":"generic_exterior_window_vis_0.64","display_name":null,"type":"Glass","modifier":null,"dependencies":[],"r_transmissivity":0.6975761815384331,"g_transmissivity":0.6975761815384331,"b_transmissivity":0.6975761815384331,"refraction_index":null},{"identifier":"air_boundary","display_name":null,"type":"Trans","modifier":null,"dependencies":[],"r_reflectance":1,"g_reflectance":1,"b_reflectance":1,"specularity":0,"roughness":0,"transmitted_diff":1,"transmitted_spec":1}]

Global Honeybee Radiance modifiers.

wall_set
object (Wall Set) Recursive
Default: {"exterior_modifier":"generic_wall_0.50","interior_modifier":"generic_wall_0.50","type":"WallModifierSetAbridged"}

Base class for the abridged modifier sets assigned to Faces.

floor_set
object (Floor Set) Recursive
Default: {"exterior_modifier":"generic_floor_0.20","interior_modifier":"generic_floor_0.20","type":"FloorModifierSetAbridged"}

Base class for the abridged modifier sets assigned to Faces.

roof_ceiling_set
object (Roof Ceiling Set) Recursive
Default: {"exterior_modifier":"generic_ceiling_0.80","interior_modifier":"generic_ceiling_0.80","type":"RoofCeilingModifierSetAbridged"}

Base class for the abridged modifier sets assigned to Faces.

aperture_set
object (Aperture Set) Recursive
Default: {"type":"ApertureModifierSetAbridged","window_modifier":"generic_exterior_window_vis_0.64","interior_modifier":"generic_interior_window_vis_0.88","skylight_modifier":"generic_exterior_window_vis_0.64","operable_modifier":"generic_exterior_window_vis_0.64"}

Abridged set containing radiance modifiers needed for a model's Apertures.

door_set
object (Door Set) Recursive
Default: {"exterior_modifier":"generic_opaque_door_0.50","interior_modifier":"generic_opaque_door_0.50","type":"DoorModifierSetAbridged","interior_glass_modifier":"generic_interior_window_vis_0.88","exterior_glass_modifier":"generic_exterior_window_vis_0.64","overhead_modifier":"generic_opaque_door_0.50"}

Base class for the abridged modifier sets assigned to Faces.

shade_set
object (Shade Set) Recursive
Default: {"exterior_modifier":"generic_exterior_shade_0.35","interior_modifier":"generic_interior_shade_0.50","type":"ShadeModifierSetAbridged"}

Base class for the abridged modifier sets assigned to Faces.

air_boundary_modifier
string (Air Boundary Modifier)
Default: "air_boundary"

Global Honeybee Modifier for AirBoundary Faces.

context_modifier
string (Context Modifier)
Default: "generic_context_0.20"

Global Honeybee Modifier for context Shades.

{
  • "type": "GlobalModifierSet",
  • "modifiers": [
    ],
  • "wall_set": {
    },
  • "floor_set": {
    },
  • "roof_ceiling_set": {
    },
  • "aperture_set": {
    },
  • "door_set": {
    },
  • "shade_set": {
    },
  • "air_boundary_modifier": "air_boundary",
  • "context_modifier": "generic_context_0.20"
}

Glow

type
string (Type) ^Glow$
Default: "Glow"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"Void"}

Material modifier.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers.

r_emittance
number <double> (R Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel of the modifier.

g_emittance
number <double> (G Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel of the modifier.

b_emittance
number <double> (B Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel of the modifier.

max_radius
number <double> (Max Radius)
Default: 0

Maximum radius for shadow testing. Objects with zero radius are permissable and may participate in interreflection calculation (though they are not representative of real light sources). Negative values will never contribute to scene illumination.

{
  • "type": "Glow",
  • "identifier": "string",
  • "display_name": "string",
  • "modifier": {
    },
  • "dependencies": [
    ],
  • "r_emittance": 0,
  • "g_emittance": 0,
  • "b_emittance": 0,
  • "max_radius": 0
}

Ground

type
string (Type) ^Ground$
Default: "Ground"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "Ground"
}

IDdBaseModel

type
string (Type) ^IDdBaseModel$
Default: "IDdBaseModel"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[.A-Za-z0-9_-]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

{
  • "type": "IDdBaseModel",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { }
}

IDdEnergyBaseModel

type
string (Type) ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

{
  • "type": "IDdEnergyBaseModel",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { }
}

IDdRadianceBaseModel

type
string (Type) ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

{
  • "type": "IDdRadianceBaseModel",
  • "identifier": "string",
  • "display_name": "string"
}

IdealAirSystemAbridged

type
string (Type) ^IdealAirSystemAbridged$
Default: "IdealAirSystemAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

economizer_type
string (EconomizerType)
Default: "DifferentialDryBulb"
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the zone.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

heating_air_temperature
number <double> (Heating Air Temperature) ( 0 .. 100 )
Default: 50

A number for the maximum heating supply air temperature [C].

cooling_air_temperature
number <double> (Cooling Air Temperature) ( -100 .. 50 )
Default: 13

A number for the minimum cooling supply air temperature [C].

Autosize (object) or NoLimit (object) or Heating Limit (number) (Heating Limit)
Default: {"type":"Autosize"}

A number for the maximum heating capacity in Watts. This can also be an Autosize object to indicate that the capacity should be determined during the EnergyPlus sizing calculation. This can also be a NoLimit object to indicate no upper limit to the heating capacity.

Autosize (object) or NoLimit (object) or Cooling Limit (number) (Cooling Limit)
Default: {"type":"Autosize"}

A number for the maximum cooling capacity in Watts. This can also be an Autosize object to indicate that the capacity should be determined during the EnergyPlus sizing calculation. This can also be a NoLimit object to indicate no upper limit to the cooling capacity.

heating_availability
string (Heating Availability) [ 1 .. 100 ] characters

An optional identifier of a schedule to set the availability of heating over the course of the simulation.

cooling_availability
string (Cooling Availability) [ 1 .. 100 ] characters

An optional identifier of a schedule to set the availability of cooling over the course of the simulation.

{
  • "type": "IdealAirSystemAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "economizer_type": "DifferentialDryBulb",
  • "demand_controlled_ventilation": false,
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "heating_air_temperature": 50,
  • "cooling_air_temperature": 13,
  • "heating_limit": {
    },
  • "cooling_limit": {
    },
  • "heating_availability": "string",
  • "cooling_availability": "string"
}

Infiltration

type
string (Type) ^Infiltration$
Default: "Infiltration"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

flow_per_exterior_area
required
number <double> (Flow Per Exterior Area) >= 0

Number for the infiltration per exterior surface area in m3/s-m2.

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the infiltration over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the flow_per_exterior_area to yield a complete infiltration profile.

constant_coefficient
number <double> (Constant Coefficient) >= 0
Default: 1
temperature_coefficient
number <double> (Temperature Coefficient) >= 0
Default: 0
velocity_coefficient
number <double> (Velocity Coefficient) >= 0
Default: 0
{
  • "type": "Infiltration",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "flow_per_exterior_area": 0,
  • "schedule": {
    },
  • "constant_coefficient": 1,
  • "temperature_coefficient": 0,
  • "velocity_coefficient": 0
}

InfiltrationAbridged

type
string (Type) ^InfiltrationAbridged$
Default: "InfiltrationAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

flow_per_exterior_area
required
number <double> (Flow Per Exterior Area) >= 0

Number for the infiltration per exterior surface area in m3/s-m2.

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the infiltration over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the flow_per_exterior_area to yield a complete infiltration profile.

constant_coefficient
number <double> (Constant Coefficient) >= 0
Default: 1
temperature_coefficient
number <double> (Temperature Coefficient) >= 0
Default: 0
velocity_coefficient
number <double> (Velocity Coefficient) >= 0
Default: 0
{
  • "type": "InfiltrationAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "flow_per_exterior_area": 0,
  • "schedule": "string",
  • "constant_coefficient": 1,
  • "temperature_coefficient": 0,
  • "velocity_coefficient": 0
}

InternalMassAbridged

type
string (Type) ^InternalMassAbridged$
Default: "InternalMassAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

construction
required
string (Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction that represents the material that the internal thermal mass is composed of.

area
required
number <double> (Area) > 0

A number representing the surface area of the internal mass that is exposed to the Room air. This value should always be in square meters regardless of what units system the parent model is a part of.

{
  • "type": "InternalMassAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "construction": "string",
  • "area": 0
}

Light

type
string (Type) ^Light$
Default: "Light"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"Void"}

Material modifier.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers.

r_emittance
number <double> (R Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel of the modifier.

g_emittance
number <double> (G Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel of the modifier.

b_emittance
number <double> (B Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel of the modifier.

{
  • "type": "Light",
  • "identifier": "string",
  • "display_name": "string",
  • "modifier": {
    },
  • "dependencies": [
    ],
  • "r_emittance": 0,
  • "g_emittance": 0,
  • "b_emittance": 0
}

Lighting

type
string (Type) ^Lighting$
Default: "Lighting"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts_per_area
required
number <double> (Watts Per Area) >= 0

Lighting per floor area as [W/m2].

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the use of lights over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete lighting profile.

visible_fraction
number <double> (Visible Fraction) [ 0 .. 1 ]
Default: 0.25

The fraction of heat from lights that goes into the zone as visible (short-wave) radiation. (Default: 0.25).

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.32

The fraction of heat from lights that is long-wave radiation. (Default: 0.32).

return_air_fraction
number <double> (Return Air Fraction) [ 0 .. 1 ]
Default: 0

The fraction of the heat from lights that goes into the zone return air. (Default: 0).

baseline_watts_per_area
number <double> (Baseline Watts Per Area) >= 0
Default: 11.84029

The baseline lighting power density in [W/m2] of floor area. This baseline is useful to track how much better the installed lights are in comparison to a standard like ASHRAE 90.1. If set to None, it will default to 11.84029 W/m2, which is that ASHRAE 90.1-2004 baseline for an office.

{
  • "type": "Lighting",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts_per_area": 0,
  • "schedule": {
    },
  • "visible_fraction": 0.25,
  • "radiant_fraction": 0.32,
  • "return_air_fraction": 0,
  • "baseline_watts_per_area": 11.84029
}

LightingAbridged

type
string (Type) ^LightingAbridged$
Default: "LightingAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts_per_area
required
number <double> (Watts Per Area) >= 0

Lighting per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of lights over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete lighting profile.

visible_fraction
number <double> (Visible Fraction) [ 0 .. 1 ]
Default: 0.25

The fraction of heat from lights that goes into the zone as visible (short-wave) radiation. (Default: 0.25).

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.32

The fraction of heat from lights that is long-wave radiation. (Default: 0.32).

return_air_fraction
number <double> (Return Air Fraction) [ 0 .. 1 ]
Default: 0

The fraction of the heat from lights that goes into the zone return air. (Default: 0).

baseline_watts_per_area
number <double> (Baseline Watts Per Area) >= 0
Default: 11.84029

The baseline lighting power density in [W/m2] of floor area. This baseline is useful to track how much better the installed lights are in comparison to a standard like ASHRAE 90.1. If set to None, it will default to 11.84029 W/m2, which is that ASHRAE 90.1-2004 baseline for an office.

{
  • "type": "LightingAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts_per_area": 0,
  • "schedule": "string",
  • "visible_fraction": 0.25,
  • "radiant_fraction": 0.32,
  • "return_air_fraction": 0,
  • "baseline_watts_per_area": 11.84029
}

Mesh3D

type
string (Type) ^Mesh3D$
Default: "Mesh3D"

A base class to use when there is no baseclass available to fall on.

vertices
required
Array of numbers (Vertices) >= 3 items [ items <double > = 3 items [ items <double > ] ]

A list of points representing the vertices of the mesh. The list should include at least 3 points and each point should be a list of 3 (x, y, z) values.

faces
required
Array of integers (Faces) non-empty [ items <int32 > [ 3 .. 4 ] items [ items <int32 > >= 0 ] ]

A list of lists with each sub-list having either 3 or 4 integers. These integers correspond to indices within the list of vertices.

Array of objects (Colors)

An optional list of colors that correspond to either the faces of the mesh or the vertices of the mesh.

{
  • "type": "Mesh3D",
  • "vertices": [
    ],
  • "faces": [
    ],
  • "colors": [
    ]
}

Metal

type
string (Type) ^Metal$
Default: "Metal"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"Void"}

Material modifier.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers.

r_reflectance
number <double> (R Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel reflectance.

g_reflectance
number <double> (G Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel reflectance.

b_reflectance
number <double> (B Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel reflectance.

specularity
number <double> (Specularity) [ 0 .. 1 ]
Default: 0.9

A value between 0 and 1 for the fraction of specularity. Specularity fractions lower than 0.9 are not realistic for metallic materials.

roughness
number <double> (Roughness) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the roughness, specified as the RMS slope of surface facets. Roughness greater than 0.2 are not realistic.

{
  • "type": "Metal",
  • "identifier": "string",
  • "display_name": "string",
  • "modifier": {
    },
  • "dependencies": [
    ],
  • "r_reflectance": 0,
  • "g_reflectance": 0,
  • "b_reflectance": 0,
  • "specularity": 0.9,
  • "roughness": 0
}

Mirror

type
string (Type) ^Mirror$
Default: "Mirror"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"Void"}

Material modifier.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers.

r_reflectance
number <double> (R Reflectance) [ 0 .. 1 ]
Default: 1

A value between 0 and 1 for the red channel reflectance.

g_reflectance
number <double> (G Reflectance) [ 0 .. 1 ]
Default: 1

A value between 0 and 1 for the green channel reflectance.

b_reflectance
number <double> (B Reflectance) [ 0 .. 1 ]
Default: 1

A value between 0 and 1 for the blue channel reflectance.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Alternate Material)

An optional material (like the illum type) that may be used to specify a different material to be used for shading non-source rays. If None, this will keep the alternat_material as mirror. If this alternate material is given as Void, then the mirror surface will be invisible. Using Void is only appropriate if the surface hides other (more detailed) geometry with the same overall reflectance.

{
  • "type": "Mirror",
  • "identifier": "string",
  • "display_name": "string",
  • "modifier": {
    },
  • "dependencies": [
    ],
  • "r_reflectance": 1,
  • "g_reflectance": 1,
  • "b_reflectance": 1,
  • "alternate_material": {
    }
}

Model

type
string (Type) ^Model$
Default: "Model"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[.A-Za-z0-9_-]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

properties
required
object (Properties) Recursive

Extension properties for particular simulation engines (Radiance, EnergyPlus).

version
string (Version) ([0-9]+)\.([0-9]+)\.([0-9]+)
Default: "0.0.0"

Text string for the current version of the schema.

Array of objects (Rooms)

A list of Rooms in the model.

Array of objects (Orphaned Faces)

A list of Faces in the model that lack a parent Room. Note that orphaned Faces are not acceptable for Models that are to be exported for energy simulation.

Array of objects (Orphaned Shades)

A list of Shades in the model that lack a parent.

Array of objects (Orphaned Apertures)

A list of Apertures in the model that lack a parent Face. Note that orphaned Apertures are not acceptable for Models that are to be exported for energy simulation.

Array of objects (Orphaned Doors)

A list of Doors in the model that lack a parent Face. Note that orphaned Doors are not acceptable for Models that are to be exported for energy simulation.

Array of objects (Shade Meshes)

A list of ShadeMesh in the model.

units
string (Units)
Default: "Meters"
Enum: "Meters" "Millimeters" "Feet" "Inches" "Centimeters"

An enumeration.

tolerance
number <double> (Tolerance) >= 0
Default: 0.01

The maximum difference between x, y, and z values at which vertices are considered equivalent. This value should be in the Model units and it is used in a variety of checks, including checks for whether Room faces form a closed volume and subsequently correcting all face normals point outward from the Room. A value of 0 will result in bypassing all checks so it is recommended that this always be a positive number when such checks have not already been performed on a Model. The default of 0.01 is suitable for models in meters.

angle_tolerance
number <double> (Angle Tolerance) >= 0
Default: 1

The max angle difference in degrees that vertices are allowed to differ from one another in order to consider them colinear. This value is used in a variety of checks, including checks for whether Room faces form a closed volume and subsequently correcting all face normals point outward from the Room. A value of 0 will result in bypassing all checks so it is recommended that this always be a positive number when such checks have not already been performed on a given Model.

{
  • "type": "Model",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "properties": {
    },
  • "version": "0.0.0",
  • "rooms": [
    ],
  • "orphaned_faces": [
    ],
  • "orphaned_shades": [
    ],
  • "orphaned_apertures": [
    ],
  • "orphaned_doors": [
    ],
  • "shade_meshes": [
    ],
  • "units": "Meters",
  • "tolerance": 0.01,
  • "angle_tolerance": 1
}

ModelDoe2Properties

type
string (Type) ^ModelDoe2Properties$
Default: "ModelDoe2Properties"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "ModelDoe2Properties"
}

ModelEnergyProperties

type
string (Type) ^ModelEnergyProperties$
Default: "ModelEnergyProperties"

A base class to use when there is no baseclass available to fall on.

global_construction_set
object (Global Construction Set) Recursive
Default: {"type":"GlobalConstructionSet","materials":[{"identifier":"Generic Roof Membrane","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.01,"conductivity":0.16,"density":1120,"specific_heat":1460,"thermal_absorptance":0.9,"solar_absorptance":0.65,"visible_absorptance":0.65},{"identifier":"Generic Acoustic Tile","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumSmooth","thickness":0.02,"conductivity":0.06,"density":368,"specific_heat":590,"thermal_absorptance":0.9,"solar_absorptance":0.2,"visible_absorptance":0.2},{"identifier":"Generic 25mm Wood","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumSmooth","thickness":0.0254,"conductivity":0.15,"density":608,"specific_heat":1630,"thermal_absorptance":0.9,"solar_absorptance":0.5,"visible_absorptance":0.5},{"identifier":"Generic HW Concrete","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.2,"conductivity":1.95,"density":2240,"specific_heat":900,"thermal_absorptance":0.9,"solar_absorptance":0.8,"visible_absorptance":0.8},{"identifier":"Generic Window Air Gap","display_name":null,"user_data":null,"type":"EnergyWindowMaterialGas","thickness":0.0127,"gas_type":"Air"},{"identifier":"Generic Gypsum Board","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumSmooth","thickness":0.0127,"conductivity":0.16,"density":800,"specific_heat":1090,"thermal_absorptance":0.9,"solar_absorptance":0.5,"visible_absorptance":0.5},{"identifier":"Generic Wall Air Gap","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"Smooth","thickness":0.1,"conductivity":0.667,"density":1.28,"specific_heat":1000,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Ceiling Air Gap","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"Smooth","thickness":0.1,"conductivity":0.556,"density":1.28,"specific_heat":1000,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Brick","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.1,"conductivity":0.9,"density":1920,"specific_heat":790,"thermal_absorptance":0.9,"solar_absorptance":0.65,"visible_absorptance":0.65},{"identifier":"Generic 50mm Insulation","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.05,"conductivity":0.03,"density":43,"specific_heat":1210,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Low-e Glass","display_name":null,"user_data":null,"type":"EnergyWindowMaterialGlazing","thickness":0.006,"solar_transmittance":0.45,"solar_reflectance":0.36,"solar_reflectance_back":0.36,"visible_transmittance":0.71,"visible_reflectance":0.21,"visible_reflectance_back":0.21,"infrared_transmittance":0,"emissivity":0.84,"emissivity_back":0.047,"conductivity":1,"dirt_correction":1,"solar_diffusing":false},{"identifier":"Generic Painted Metal","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"Smooth","thickness":0.0015,"conductivity":45,"density":7690,"specific_heat":410,"thermal_absorptance":0.9,"solar_absorptance":0.5,"visible_absorptance":0.5},{"identifier":"Generic LW Concrete","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.1,"conductivity":0.53,"density":1280,"specific_heat":840,"thermal_absorptance":0.9,"solar_absorptance":0.8,"visible_absorptance":0.8},{"identifier":"Generic 25mm Insulation","display_name":null,"user_data":null,"type":"EnergyMaterial","roughness":"MediumRough","thickness":0.025,"conductivity":0.03,"density":43,"specific_heat":1210,"thermal_absorptance":0.9,"solar_absorptance":0.7,"visible_absorptance":0.7},{"identifier":"Generic Clear Glass","display_name":null,"user_data":null,"type":"EnergyWindowMaterialGlazing","thickness":0.006,"solar_transmittance":0.77,"solar_reflectance":0.07,"solar_reflectance_back":0.07,"visible_transmittance":0.88,"visible_reflectance":0.08,"visible_reflectance_back":0.08,"infrared_transmittance":0,"emissivity":0.84,"emissivity_back":0.84,"conductivity":1,"dirt_correction":1,"solar_diffusing":false}],"constructions":[{"identifier":"Generic Interior Door","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 25mm Wood"]},{"identifier":"Generic Single Pane","display_name":null,"user_data":null,"type":"WindowConstructionAbridged","materials":["Generic Clear Glass"],"frame":null},{"identifier":"Generic Shade","display_name":null,"user_data":null,"type":"ShadeConstruction","solar_reflectance":0.35,"visible_reflectance":0.35,"is_specular":false},{"identifier":"Generic Context","display_name":null,"user_data":null,"type":"ShadeConstruction","solar_reflectance":0.2,"visible_reflectance":0.2,"is_specular":false},{"identifier":"Generic Interior Ceiling","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic LW Concrete","Generic Ceiling Air Gap","Generic Acoustic Tile"]},{"identifier":"Generic Interior Wall","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Gypsum Board","Generic Wall Air Gap","Generic Gypsum Board"]},{"identifier":"Generic Exposed Floor","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Painted Metal","Generic Ceiling Air Gap","Generic 50mm Insulation","Generic LW Concrete"]},{"identifier":"Generic Interior Floor","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Acoustic Tile","Generic Ceiling Air Gap","Generic LW Concrete"]},{"identifier":"Generic Ground Slab","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 50mm Insulation","Generic HW Concrete"]},{"identifier":"Generic Roof","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Roof Membrane","Generic 50mm Insulation","Generic LW Concrete","Generic Ceiling Air Gap","Generic Acoustic Tile"]},{"identifier":"Generic Exterior Wall","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Brick","Generic LW Concrete","Generic 50mm Insulation","Generic Wall Air Gap","Generic Gypsum Board"]},{"identifier":"Generic Underground Wall","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 50mm Insulation","Generic HW Concrete","Generic Wall Air Gap","Generic Gypsum Board"]},{"identifier":"Generic Air Boundary","display_name":null,"user_data":null,"type":"AirBoundaryConstructionAbridged","air_mixing_per_area":0.1,"air_mixing_schedule":"Always On"},{"identifier":"Generic Underground Roof","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic 50mm Insulation","Generic HW Concrete","Generic Ceiling Air Gap","Generic Acoustic Tile"]},{"identifier":"Generic Double Pane","display_name":null,"user_data":null,"type":"WindowConstructionAbridged","materials":["Generic Low-e Glass","Generic Window Air Gap","Generic Clear Glass"],"frame":null},{"identifier":"Generic Exterior Door","display_name":null,"user_data":null,"type":"OpaqueConstructionAbridged","materials":["Generic Painted Metal","Generic 25mm Insulation","Generic Painted Metal"]}],"wall_set":{"interior_construction":"Generic Interior Wall","exterior_construction":"Generic Exterior Wall","ground_construction":"Generic Underground Wall","type":"WallConstructionSetAbridged"},"floor_set":{"interior_construction":"Generic Interior Floor","exterior_construction":"Generic Exposed Floor","ground_construction":"Generic Ground Slab","type":"FloorConstructionSetAbridged"},"roof_ceiling_set":{"interior_construction":"Generic Interior Ceiling","exterior_construction":"Generic Roof","ground_construction":"Generic Underground Roof","type":"RoofCeilingConstructionSetAbridged"},"aperture_set":{"type":"ApertureConstructionSetAbridged","interior_construction":"Generic Single Pane","window_construction":"Generic Double Pane","skylight_construction":"Generic Double Pane","operable_construction":"Generic Double Pane"},"door_set":{"type":"DoorConstructionSetAbridged","interior_construction":"Generic Interior Door","exterior_construction":"Generic Exterior Door","overhead_construction":"Generic Exterior Door","exterior_glass_construction":"Generic Double Pane","interior_glass_construction":"Generic Single Pane"},"shade_construction":"Generic Shade","context_construction":"Generic Context","air_boundary_construction":"Generic Air Boundary"}

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

Array of ConstructionSetAbridged (object) or ConstructionSet (object) (Construction Sets)

List of all unique ConstructionSets in the Model.

Array of OpaqueConstructionAbridged (object) or WindowConstructionAbridged (object) or WindowConstructionShadeAbridged (object) or AirBoundaryConstructionAbridged (object) or OpaqueConstruction (object) or WindowConstruction (object) or WindowConstructionShade (object) or WindowConstructionDynamicAbridged (object) or WindowConstructionDynamic (object) or AirBoundaryConstruction (object) or ShadeConstruction (object) (Constructions)

A list of all unique constructions in the model. This includes constructions across all Faces, Apertures, Doors, Shades, Room ConstructionSets, and the global_construction_set.

Array of EnergyMaterial (object) or EnergyMaterialNoMass (object) or EnergyMaterialVegetation (object) or EnergyWindowMaterialGlazing (object) or EnergyWindowMaterialSimpleGlazSys (object) or EnergyWindowMaterialGas (object) or EnergyWindowMaterialGasMixture (object) or EnergyWindowMaterialGasCustom (object) or EnergyWindowFrame (object) or EnergyWindowMaterialBlind (object) or EnergyWindowMaterialShade (object) (Materials)

A list of all unique materials in the model. This includes materials needed to make the Model constructions.

Array of IdealAirSystemAbridged (object) or VAV (object) or PVAV (object) or PSZ (object) or PTAC (object) or ForcedAirFurnace (object) or FCUwithDOASAbridged (object) or WSHPwithDOASAbridged (object) or VRFwithDOASAbridged (object) or RadiantwithDOASAbridged (object) or FCU (object) or WSHP (object) or VRF (object) or Baseboard (object) or EvaporativeCooler (object) or Residential (object) or WindowAC (object) or GasUnitHeater (object) or Radiant (object) or DetailedHVAC (object) (Hvacs)

List of all unique HVAC systems in the Model.

Array of objects (Shws)

List of all unique Service Hot Water (SHW) systems in the Model.

Array of ProgramTypeAbridged (object) or ProgramType (object) (Program Types)

List of all unique ProgramTypes in the Model.

Array of ScheduleRulesetAbridged (object) or ScheduleFixedIntervalAbridged (object) or ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedules)

A list of all unique schedules in the model. This includes schedules across all HVAC systems, ProgramTypes, Rooms, and Shades.

Array of objects (Schedule Type Limits)

A list of all unique ScheduleTypeLimits in the model. This all ScheduleTypeLimits needed to make the Model schedules.

ventilation_simulation_control
object (Ventilation Simulation Control) Recursive

The global parameters used in the ventilation simulation.

electric_load_center
object (Electric Load Center) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

{
  • "type": "ModelEnergyProperties",
  • "global_construction_set": {
    },
  • "construction_sets": [
    ],
  • "constructions": [
    ],
  • "materials": [
    ],
  • "hvacs": [
    ],
  • "shws": [
    ],
  • "program_types": [
    ],
  • "schedules": [
    ],
  • "schedule_type_limits": [
    ],
  • "ventilation_simulation_control": {
    },
  • "electric_load_center": {
    }
}

ModelProperties

type
string (Type) ^ModelProperties$
Default: "ModelProperties"

A base class to use when there is no baseclass available to fall on.

energy
object (ModelEnergyProperties) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

radiance
object (ModelRadianceProperties) Recursive

Radiance Properties for Honeybee Model.

doe2
object (ModelDoe2Properties) Recursive

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

{
  • "type": "ModelProperties",
  • "energy": {
    },
  • "radiance": {
    },
  • "doe2": {
    }
}

ModelRadianceProperties

type
string (Type) ^ModelRadianceProperties$
Default: "ModelRadianceProperties"

A base class to use when there is no baseclass available to fall on.

global_modifier_set
object (Global Modifier Set) Recursive
Default: {"type":"GlobalModifierSet","modifiers":[{"identifier":"generic_floor_0.20","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.2,"g_reflectance":0.2,"b_reflectance":0.2,"specularity":0,"roughness":0},{"identifier":"generic_wall_0.50","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.5,"g_reflectance":0.5,"b_reflectance":0.5,"specularity":0,"roughness":0},{"identifier":"generic_ceiling_0.80","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.8,"g_reflectance":0.8,"b_reflectance":0.8,"specularity":0,"roughness":0},{"identifier":"generic_opaque_door_0.50","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.5,"g_reflectance":0.5,"b_reflectance":0.5,"specularity":0,"roughness":0},{"identifier":"generic_interior_shade_0.50","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.5,"g_reflectance":0.5,"b_reflectance":0.5,"specularity":0,"roughness":0},{"identifier":"generic_exterior_shade_0.35","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.35,"g_reflectance":0.35,"b_reflectance":0.35,"specularity":0,"roughness":0},{"identifier":"generic_context_0.20","display_name":null,"type":"Plastic","modifier":null,"dependencies":[],"r_reflectance":0.2,"g_reflectance":0.2,"b_reflectance":0.2,"specularity":0,"roughness":0},{"identifier":"generic_interior_window_vis_0.88","display_name":null,"type":"Glass","modifier":null,"dependencies":[],"r_transmissivity":0.9584154328610596,"g_transmissivity":0.9584154328610596,"b_transmissivity":0.9584154328610596,"refraction_index":null},{"identifier":"generic_exterior_window_vis_0.64","display_name":null,"type":"Glass","modifier":null,"dependencies":[],"r_transmissivity":0.6975761815384331,"g_transmissivity":0.6975761815384331,"b_transmissivity":0.6975761815384331,"refraction_index":null},{"identifier":"air_boundary","display_name":null,"type":"Trans","modifier":null,"dependencies":[],"r_reflectance":1,"g_reflectance":1,"b_reflectance":1,"specularity":0,"roughness":0,"transmitted_diff":1,"transmitted_spec":1}],"wall_set":{"exterior_modifier":"generic_wall_0.50","interior_modifier":"generic_wall_0.50","type":"WallModifierSetAbridged"},"floor_set":{"exterior_modifier":"generic_floor_0.20","interior_modifier":"generic_floor_0.20","type":"FloorModifierSetAbridged"},"roof_ceiling_set":{"exterior_modifier":"generic_ceiling_0.80","interior_modifier":"generic_ceiling_0.80","type":"RoofCeilingModifierSetAbridged"},"aperture_set":{"type":"ApertureModifierSetAbridged","window_modifier":"generic_exterior_window_vis_0.64","interior_modifier":"generic_interior_window_vis_0.88","skylight_modifier":"generic_exterior_window_vis_0.64","operable_modifier":"generic_exterior_window_vis_0.64"},"door_set":{"exterior_modifier":"generic_opaque_door_0.50","interior_modifier":"generic_opaque_door_0.50","type":"DoorModifierSetAbridged","interior_glass_modifier":"generic_interior_window_vis_0.88","exterior_glass_modifier":"generic_exterior_window_vis_0.64","overhead_modifier":"generic_opaque_door_0.50"},"shade_set":{"exterior_modifier":"generic_exterior_shade_0.35","interior_modifier":"generic_interior_shade_0.50","type":"ShadeModifierSetAbridged"},"air_boundary_modifier":"air_boundary","context_modifier":"generic_context_0.20"}

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifiers)

A list of all unique modifiers in the model. This includes modifiers across all Faces, Apertures, Doors, Shades, Room ModifierSets, and the global_modifier_set.

Array of ModifierSet (object) or ModifierSetAbridged (object) (Modifier Sets)

A list of all unique Room-Assigned ModifierSets in the Model.

Array of objects (Sensor Grids)

An array of SensorGrids that are associated with the model.

Array of objects (Views)

An array of Views that are associated with the model.

{
  • "type": "ModelRadianceProperties",
  • "global_modifier_set": {
    },
  • "modifiers": [
    ],
  • "modifier_sets": [
    ],
  • "sensor_grids": [
    ],
  • "views": [
    ]
}

ModifierBase

type
string (Type) ^ModifierBase$
Default: "ModifierBase"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

{
  • "type": "ModifierBase",
  • "identifier": "string",
  • "display_name": "string"
}

ModifierSet

type
string (Type) ^ModifierSet$
Default: "ModifierSet"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

wall_set
object (Wall Set) Recursive

Set containing radiance modifiers needed for a model's Walls.

floor_set
object (Floor Set) Recursive

Set containing radiance modifiers needed for a model's Floors.

roof_ceiling_set
object (Roof Ceiling Set) Recursive

Set containing radiance modifiers needed for a model's roofs.

aperture_set
object (Aperture Set) Recursive

Set containing radiance modifiers needed for a model's Apertures.

door_set
object (Door Set) Recursive

Set containing radiance modifiers needed for a model's Doors.

shade_set
object (Shade Set) Recursive

Set containing radiance modifiers needed for a model's Shade.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Air Boundary Modifier)

An optional Modifier to be used for all Faces with an AirBoundary face type. If None, it will be the honeybee generic air wall modifier.

{
  • "type": "ModifierSet",
  • "identifier": "string",
  • "display_name": "string",
  • "wall_set": {
    },
  • "floor_set": {
    },
  • "roof_ceiling_set": {
    },
  • "aperture_set": {
    },
  • "door_set": {
    },
  • "shade_set": {
    },
  • "air_boundary_modifier": {
    }
}

ModifierSetAbridged

type
string (Type) ^ModifierSetAbridged$
Default: "ModifierSetAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

wall_set
object (Wall Set) Recursive

Base class for the abridged modifier sets assigned to Faces.

floor_set
object (Floor Set) Recursive

Base class for the abridged modifier sets assigned to Faces.

roof_ceiling_set
object (Roof Ceiling Set) Recursive

Base class for the abridged modifier sets assigned to Faces.

aperture_set
object (Aperture Set) Recursive

Abridged set containing radiance modifiers needed for a model's Apertures.

door_set
object (Door Set) Recursive

Base class for the abridged modifier sets assigned to Faces.

shade_set
object (Shade Set) Recursive

Base class for the abridged modifier sets assigned to Faces.

air_boundary_modifier
string (Air Boundary Modifier)

Optional Modifier to be used for all Faces with an AirBoundary face type. If None, it will be the honeybee generic air wall modifier.

{
  • "type": "ModifierSetAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "wall_set": {
    },
  • "floor_set": {
    },
  • "roof_ceiling_set": {
    },
  • "aperture_set": {
    },
  • "door_set": {
    },
  • "shade_set": {
    },
  • "air_boundary_modifier": "string"
}

ModuleType

string (ModuleType)
Enum: "Standard" "Premium" "ThinFilm"

An enumeration.

"Standard"

MoistureDiffusionModel

string (MoistureDiffusionModel)
Enum: "Simple" "Advanced"

Acceptable values for the moisture diffusion model for vegetation.

"Simple"

MountingType

string (MountingType)
Enum: "FixedOpenRack" "FixedRoofMounted" "OneAxis" "OneAxisBacktracking" "TwoAxis"

An enumeration.

"FixedOpenRack"

NoLimit

type
string (Type) ^NoLimit$
Default: "NoLimit"

A base class to use when there is no baseclass available to fall on.

{
  • "type": "NoLimit"
}

OpaqueConstruction

type
string (Type) ^OpaqueConstruction$
Default: "OpaqueConstruction"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

required
Array of EnergyMaterial (object) or EnergyMaterialNoMass (object) or EnergyMaterialVegetation (object) (Materials) [ 1 .. 10 ] items

List of opaque material definitions. The order of the materials is from exterior to interior.

{
  • "type": "OpaqueConstruction",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "materials": [
    ]
}

OpaqueConstructionAbridged

type
string (Type) ^OpaqueConstructionAbridged$
Default: "OpaqueConstructionAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

materials
required
Array of strings (Materials) [ 1 .. 10 ] items [ items [ 1 .. 100 ] characters ]

List of strings for opaque material identifiers. The order of the materials is from exterior to interior.

{
  • "type": "OpaqueConstructionAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "materials": [
    ]
}

OtherSideTemperature

type
string (Type) ^OtherSideTemperature$
Default: "OtherSideTemperature"

A base class to use when there is no baseclass available to fall on.

heat_transfer_coefficient
number <double> (Heat Transfer Coefficient) >= 0
Default: 0

A value in W/m2-K to indicate the combined convective/radiative film coefficient. If equal to 0, then the specified temperature above is equal to the exterior surface temperature. Otherwise, the temperature above is considered the outside air temperature and this coefficient is used to determine the difference between this outside air temperature and the exterior surface temperature.

Autocalculate (object) or Temperature (number) (Temperature)
Default: {"type":"Autocalculate"}

A temperature value in Celsius to note the temperature on the other side of the object. This input can also be an Autocalculate object to signify that the temperature is equal to the outdoor air temperature.

{
  • "type": "OtherSideTemperature",
  • "heat_transfer_coefficient": 0,
  • "temperature": {
    }
}

Outdoors

type
string (Type) ^Outdoors$
Default: "Outdoors"

A base class to use when there is no baseclass available to fall on.

sun_exposure
boolean (Sun Exposure)
Default: true

A boolean noting whether the boundary is exposed to sun.

wind_exposure
boolean (Wind Exposure)
Default: true

A boolean noting whether the boundary is exposed to wind.

Autocalculate (object) or View Factor (number) (View Factor)
Default: {"type":"Autocalculate"}

A number for the view factor to the ground. This can also be an Autocalculate object to have the view factor automatically calculated.

{
  • "type": "Outdoors",
  • "sun_exposure": true,
  • "wind_exposure": true,
  • "view_factor": {
    }
}

People

type
string (Type) ^People$
Default: "People"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

people_per_area
required
number <double> (People Per Area) >= 0

People per floor area expressed as [people/m2]

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Occupancy Schedule)

A schedule for the occupancy over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the people_per_area to yield a complete occupancy profile.

ScheduleRuleset (object) or ScheduleFixedInterval (object) (Activity Schedule)

A schedule for the activity of the occupants over the course of the year. The type of this schedule should be ActivityLevel and the values of the schedule equal to the number of Watts given off by an individual person in the room. If None, a default constant schedule with 120 Watts per person will be used, which is typical of awake, adult humans who are seated.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.3

The radiant fraction of sensible heat released by people. (Default: 0.3).

Autocalculate (object) or Latent Fraction (number) (Latent Fraction)
Default: {"type":"Autocalculate"}

Number for the latent fraction of heat gain due to people or an Autocalculate object.

{
  • "type": "People",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "people_per_area": 0,
  • "occupancy_schedule": {
    },
  • "activity_schedule": {
    },
  • "radiant_fraction": 0.3,
  • "latent_fraction": {
    }
}

PeopleAbridged

type
string (Type) ^PeopleAbridged$
Default: "PeopleAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

people_per_area
required
number <double> (People Per Area) >= 0

People per floor area expressed as [people/m2]

occupancy_schedule
required
string (Occupancy Schedule) [ 1 .. 100 ] characters

Identifier of a schedule for the occupancy over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the people_per_area to yield a complete occupancy profile.

activity_schedule
string (Activity Schedule) [ 1 .. 100 ] characters

Identifier of a schedule for the activity of the occupants over the course of the year. The type of this schedule should be ActivityLevel and the values of the schedule equal to the number of Watts given off by an individual person in the room. If None, a default constant schedule with 120 Watts per person will be used, which is typical of awake, adult humans who are seated.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.3

The radiant fraction of sensible heat released by people. (Default: 0.3).

Autocalculate (object) or Latent Fraction (number) (Latent Fraction)
Default: {"type":"Autocalculate"}

Number for the latent fraction of heat gain due to people or an Autocalculate object.

{
  • "type": "PeopleAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "people_per_area": 0,
  • "occupancy_schedule": "string",
  • "activity_schedule": "string",
  • "radiant_fraction": 0.3,
  • "latent_fraction": {
    }
}

Plane

type
string (Type) ^Plane$
Default: "Plane"

A base class to use when there is no baseclass available to fall on.

n
required
Array of numbers <double> (N) = 3 items [ items <double > ]

Plane normal as 3 (x, y, z) values.

o
required
Array of numbers <double> (O) = 3 items [ items <double > ]

Plane origin as 3 (x, y, z) values

x
Array of numbers <double> (X) = 3 items [ items <double > ]

Plane x-axis as 3 (x, y, z) values. If None, it is autocalculated.

{
  • "type": "Plane",
  • "n": [
    ],
  • "o": [
    ],
  • "x": [
    ]
}

Plastic

type
string (Type) ^Plastic$
Default: "Plastic"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) non-empty ^[.A-Za-z0-9_-]+$

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"Void"}

Material modifier.

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers.

r_reflectance
number <double> (R Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel reflectance.

g_reflectance
number <double> (G Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel reflectance.

b_reflectance
number <double> (B Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel reflectance.

specularity
number <double> (Specularity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the fraction of specularity. Specularity fractions greater than 0.1 are not realistic for non-metallic materials.

roughness
number <double> (Roughness) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the roughness, specified as the RMS slope of surface facets. Roughness greater than 0.2 are not realistic.

{
  • "type": "Plastic",
  • "identifier": "string",
  • "display_name": "string",
  • "modifier": {
    },
  • "dependencies": [
    ],
  • "r_reflectance": 0,
  • "g_reflectance": 0,
  • "b_reflectance": 0,
  • "specularity": 0,
  • "roughness": 0
}

ProcessAbridged

type
string (Type) ^ProcessAbridged$
Default: "ProcessAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

watts
required
number <double> (Watts) >= 0

A number for the process load power in Watts.

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of the process over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts to yield a complete equipment profile.

fuel_type
required
string (FuelTypes)
Enum: "Electricity" "NaturalGas" "Propane" "FuelOilNo1" "FuelOilNo2" "Diesel" "Gasoline" "Coal" "Steam" "DistrictHeating" "DistrictCooling" "OtherFuel1" "OtherFuel2" "None"

Designates the acceptable fuel types for process loads.

end_use_category
string (End Use Category) [ 1 .. 100 ] characters
Default: "Process"

Text to indicate the end-use subcategory, which will identify the process load in the end use output. For example, “Cooking”, “Clothes Drying”, etc. A new meter for reporting is created for each unique subcategory.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by the process load. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by the process load. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by the process load. The default value is 0.

{
  • "type": "ProcessAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "watts": 0,
  • "schedule": "string",
  • "fuel_type": "Electricity",
  • "end_use_category": "Process",
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

ProgramType

type
string (Type) ^ProgramType$
Default: "ProgramType"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

people
object (People) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

lighting
object (Lighting) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

electric_equipment
object (Electric Equipment) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

gas_equipment
object (Gas Equipment) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

service_hot_water
object (Service Hot Water) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

infiltration
object (Infiltration) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

ventilation
object (Ventilation) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

setpoint
object (Setpoint) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

{
  • "type": "ProgramType",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "people": {
    },
  • "lighting": {
    },
  • "electric_equipment": {
    },
  • "gas_equipment": {
    },
  • "service_hot_water": {
    },
  • "infiltration": {
    },
  • "ventilation": {
    },
  • "setpoint": {
    }
}

ProgramTypeAbridged

type
string (Type) ^ProgramTypeAbridged$
Default: "ProgramTypeAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

people
object (People) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

lighting
object (Lighting) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

electric_equipment
object (Electric Equipment) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

gas_equipment
object (Gas Equipment) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

service_hot_water
object (Service Hot Water) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

infiltration
object (Infiltration) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

ventilation
object (Ventilation) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

setpoint
object (Setpoint) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

{
  • "type": "ProgramTypeAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "people": {
    },
  • "lighting": {
    },
  • "electric_equipment": {
    },
  • "gas_equipment": {
    },
  • "service_hot_water": {
    },
  • "infiltration": {
    },
  • "ventilation": {
    },
  • "setpoint": {
    }
}

PSZ

type
string (Type) ^PSZ$
Default: "PSZ"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Default: "NoEconomizer"
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy" "DifferentialDryBulbAndEnthalpy" "FixedDryBulb" "FixedEnthalpy" "ElectronicEnthalpy"

An enumeration.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the Rooms.

equipment_type
string (PSZEquipmentType)
Default: "PSZAC_ElectricBaseboard"
Enum: "PSZAC_ElectricBaseboard" "PSZAC_BoilerBaseboard" "PSZAC_DHWBaseboard" "PSZAC_GasHeaters" "PSZAC_ElectricCoil" "PSZAC_GasCoil" "PSZAC_Boiler" "PSZAC_ASHP" "PSZAC_DHW" "PSZAC" "PSZAC_DCW_ElectricBaseboard" "PSZAC_DCW_BoilerBaseboard" "PSZAC_DCW_GasHeaters" "PSZAC_DCW_ElectricCoil" "PSZAC_DCW_GasCoil" "PSZAC_DCW_Boiler" "PSZAC_DCW_ASHP" "PSZAC_DCW_DHW" "PSZAC_DCW" "PSZHP"

An enumeration.

{
  • "type": "PSZ",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "economizer_type": "NoEconomizer",
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "demand_controlled_ventilation": false,
  • "equipment_type": "PSZAC_ElectricBaseboard"
}

PSZEquipmentType

string (PSZEquipmentType)
Enum: "PSZAC_ElectricBaseboard" "PSZAC_BoilerBaseboard" "PSZAC_DHWBaseboard" "PSZAC_GasHeaters" "PSZAC_ElectricCoil" "PSZAC_GasCoil" "PSZAC_Boiler" "PSZAC_ASHP" "PSZAC_DHW" "PSZAC" "PSZAC_DCW_ElectricBaseboard" "PSZAC_DCW_BoilerBaseboard" "PSZAC_DCW_GasHeaters" "PSZAC_DCW_ElectricCoil" "PSZAC_DCW_GasCoil" "PSZAC_DCW_Boiler" "PSZAC_DCW_ASHP" "PSZAC_DCW_DHW" "PSZAC_DCW" "PSZHP"

An enumeration.

"PSZAC_ElectricBaseboard"

PTAC

type
string (Type) ^PTAC$
Default: "PTAC"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (PTACEquipmentType)
Default: "PTAC_ElectricBaseboard"
Enum: "PTAC_ElectricBaseboard" "PTAC_BoilerBaseboard" "PTAC_DHWBaseboard" "PTAC_GasHeaters" "PTAC_ElectricCoil" "PTAC_GasCoil" "PTAC_Boiler" "PTAC_ASHP" "PTAC_DHW" "PTAC" "PTHP"

An enumeration.

{
  • "type": "PTAC",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "PTAC_ElectricBaseboard"
}

PTACEquipmentType

string (PTACEquipmentType)
Enum: "PTAC_ElectricBaseboard" "PTAC_BoilerBaseboard" "PTAC_DHWBaseboard" "PTAC_GasHeaters" "PTAC_ElectricCoil" "PTAC_GasCoil" "PTAC_Boiler" "PTAC_ASHP" "PTAC_DHW" "PTAC" "PTHP"

An enumeration.

"PTAC_ElectricBaseboard"

PVAV

type
string (Type) ^PVAV$
Default: "PVAV"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Default: "NoEconomizer"
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy" "DifferentialDryBulbAndEnthalpy" "FixedDryBulb" "FixedEnthalpy" "ElectronicEnthalpy"

An enumeration.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the Rooms.

equipment_type
string (PVAVEquipmentType)
Default: "PVAV_Boiler"
Enum: "PVAV_Boiler" "PVAV_ASHP" "PVAV_DHW" "PVAV_PFP" "PVAV_BoilerElectricReheat"

An enumeration.

{
  • "type": "PVAV",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "economizer_type": "NoEconomizer",
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "demand_controlled_ventilation": false,
  • "equipment_type": "PVAV_Boiler"
}

PVAVEquipmentType

string (PVAVEquipmentType)
Enum: "PVAV_Boiler" "PVAV_ASHP" "PVAV_DHW" "PVAV_PFP" "PVAV_BoilerElectricReheat"

An enumeration.

"PVAV_Boiler"

PVProperties

type
string (Type) ^PVProperties$
Default: "PVProperties"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

rated_efficiency
number <double> (Rated Efficiency) ( 0 .. 1 )
Default: 0.15

A number between 0 and 1 for the rated nameplate efficiency of the photovoltaic solar cells under standard test conditions (STC). Standard test conditions are 1,000 Watts per square meter solar irradiance, 25 degrees C cell temperature, and ASTM G173-03 standard spectrum. Nameplate efficiencies reported by manufacturers are typically under STC. Standard poly- or mono-crystalline silicon modules tend to have rated efficiencies in the range of 14-17%. Premium high efficiency mono-crystalline silicon modules with anti-reflective coatings can have efficiencies in the range of 18-20%. Thin film photovoltaic modules typically have efficiencies of 11% or less. (Default: 0.15 for standard silicon solar cells).

active_area_fraction
number <double> (Active Area Fraction) ( 0 .. 1 ]
Default: 0.9

The fraction of the parent Shade geometry that is covered in active solar cells. This fraction includes the difference between the PV panel (aka. PV module) area and the active cells within the panel as well as any losses for how the (typically rectangular) panels can be arranged on the Shade geometry. When the parent Shade geometry represents just the solar panels, this fraction is typically around 0.9 given that the framing elements of the panel reduce the overall active area. (Default: 0.9, assuming parent Shade geometry represents only the PV panel geometry).

module_type
string (ModuleType)
Default: "Standard"
Enum: "Standard" "Premium" "ThinFilm"

An enumeration.

mounting_type
string (MountingType)
Default: "FixedOpenRack"
Enum: "FixedOpenRack" "FixedRoofMounted" "OneAxis" "OneAxisBacktracking" "TwoAxis"

An enumeration.

system_loss_fraction
number <double> (System Loss Fraction) [ 0 .. 1 ]
Default: 0.14

A number between 0 and 1 for the fraction of the electricity output lost due to factors other than EPW weather conditions, panel efficiency/type, active area, mounting, and inverter conversion from DC to AC. Factors that should be accounted for in this input include soiling, snow, wiring losses, electrical connection losses, manufacturer defects/tolerances/mismatch in cell characteristics, losses from power grid availability, and losses due to age or light-induced degradation. Losses from these factors tend to be between 10-20% but can vary widely depending on the installation, maintenance and the grid to which the panels are connected..

{
  • "type": "PVProperties",
  • "identifier": "string",
  • "display_name": "string",
  • "rated_efficiency": 0.15,
  • "active_area_fraction": 0.9,
  • "module_type": "Standard",
  • "mounting_type": "FixedOpenRack",
  • "system_loss_fraction": 0.14
}

RadianceShadeStateAbridged

type
string (Type) ^RadianceShadeStateAbridged$
Default: "RadianceShadeStateAbridged"

A base class to use when there is no baseclass available to fall on.

modifier
string (Modifier)

A Radiance Modifier identifier (default: None).

modifier_direct
string (Modifier Direct)

A Radiance Modifier identifier (default: None).

Array of objects (Shades)

A list of StateGeometryAbridged objects (default: None).

{
  • "type": "RadianceShadeStateAbridged",
  • "modifier": "string",
  • "modifier_direct": "string",
  • "shades": [
    ]
}

RadianceSubFaceStateAbridged

type
string (Type) ^RadianceSubFaceStateAbridged$
Default: "RadianceSubFaceStateAbridged"

A base class to use when there is no baseclass available to fall on.

modifier
string (Modifier)

A Radiance Modifier identifier (default: None).

modifier_direct
string (Modifier Direct)

A Radiance Modifier identifier (default: None).

Array of objects (Shades)

A list of StateGeometryAbridged objects (default: None).

vmtx_geometry
object (Vmtx Geometry) Recursive

A single planar face in 3D space.

dmtx_geometry
object (Dmtx Geometry) Recursive

A single planar face in 3D space.

{
  • "type": "RadianceSubFaceStateAbridged",
  • "modifier": "string",
  • "modifier_direct": "string",
  • "shades": [
    ],
  • "vmtx_geometry": {
    },
  • "dmtx_geometry": {
    }
}

Radiant

type
string (Type) ^Radiant$
Default: "Radiant"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (RadiantEquipmentType)
Default: "Radiant_Chiller_Boiler"
Enum: "Radiant_Chiller_Boiler" "Radiant_Chiller_ASHP" "Radiant_Chiller_DHW" "Radiant_ACChiller_Boiler" "Radiant_ACChiller_ASHP" "Radiant_ACChiller_DHW" "Radiant_DCW_Boiler" "Radiant_DCW_ASHP" "Radiant_DCW_DHW"

An enumeration.

radiant_face_type
string (RadiantFaceTypes)
Default: "Floor"
Enum: "Floor" "Ceiling" "FloorWithCarpet" "CeilingMetalPanel" "FloorWithHardwood"

An enumeration.

minimum_operation_time
number <double> (Minimum Operation Time) > 0
Default: 1

A number for the minimum number of hours of operation for the radiant system before it shuts off.

switch_over_time
number <double> (Switch Over Time) > 0
Default: 24

A number for the minimum number of hours for when the system can switch between heating and cooling.

{
  • "type": "Radiant",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "Radiant_Chiller_Boiler",
  • "radiant_face_type": "Floor",
  • "minimum_operation_time": 1,
  • "switch_over_time": 24
}

RadiantEquipmentType

string (RadiantEquipmentType)
Enum: "Radiant_Chiller_Boiler" "Radiant_Chiller_ASHP" "Radiant_Chiller_DHW" "Radiant_ACChiller_Boiler" "Radiant_ACChiller_ASHP" "Radiant_ACChiller_DHW" "Radiant_DCW_Boiler" "Radiant_DCW_ASHP" "Radiant_DCW_DHW"

An enumeration.

"Radiant_Chiller_Boiler"

RadiantFaceTypes

string (RadiantFaceTypes)
Enum: "Floor" "Ceiling" "FloorWithCarpet" "CeilingMetalPanel" "FloorWithHardwood"

An enumeration.

"Floor"

RadiantwithDOASAbridged

type
string (Type) ^RadiantwithDOASAbridged$
Default: "RadiantwithDOASAbridged"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the Rooms.

doas_availability_schedule
string (Doas Availability Schedule) [ 1 .. 100 ] characters

An optional On/Off discrete schedule to set when the dedicated outdoor air system (DOAS) shuts off. This will not only prevent any outdoor air from flowing thorough the system but will also shut off the fans, which can result in more energy savings when spaces served by the DOAS are completely unoccupied. If None, the DOAS will be always on.

equipment_type
string (RadiantwithDOASEquipmentType)
Default: "DOAS_Radiant_Chiller_Boiler"
Enum: "DOAS_Radiant_Chiller_Boiler" "DOAS_Radiant_Chiller_ASHP" "DOAS_Radiant_Chiller_DHW" "DOAS_Radiant_ACChiller_Boiler" "DOAS_Radiant_ACChiller_ASHP" "DOAS_Radiant_ACChiller_DHW" "DOAS_Radiant_DCW_Boiler" "DOAS_Radiant_DCW_ASHP" "DOAS_Radiant_DCW_DHW"

An enumeration.

radiant_face_type
string (RadiantFaceTypes)
Default: "Floor"
Enum: "Floor" "Ceiling" "FloorWithCarpet" "CeilingMetalPanel" "FloorWithHardwood"

An enumeration.

minimum_operation_time
number <double> (Minimum Operation Time) > 0
Default: 1

A number for the minimum number of hours of operation for the radiant system before it shuts off.

switch_over_time
number <double> (Switch Over Time) > 0
Default: 24

A number for the minimum number of hours for when the system can switch between heating and cooling.

{
  • "type": "RadiantwithDOASAbridged",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "demand_controlled_ventilation": false,
  • "doas_availability_schedule": "string",
  • "equipment_type": "DOAS_Radiant_Chiller_Boiler",
  • "radiant_face_type": "Floor",
  • "minimum_operation_time": 1,
  • "switch_over_time": 24
}

RadiantwithDOASEquipmentType

string (RadiantwithDOASEquipmentType)
Enum: "DOAS_Radiant_Chiller_Boiler" "DOAS_Radiant_Chiller_ASHP" "DOAS_Radiant_Chiller_DHW" "DOAS_Radiant_ACChiller_Boiler" "DOAS_Radiant_ACChiller_ASHP" "DOAS_Radiant_ACChiller_DHW" "DOAS_Radiant_DCW_Boiler" "DOAS_Radiant_DCW_ASHP" "DOAS_Radiant_DCW_DHW"

An enumeration.

"DOAS_Radiant_Chiller_Boiler"

Residential

type
string (Type) ^Residential$
Default: "Residential"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[^,;!\n\t]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

vintage
string (Vintages)
Default: "ASHRAE_2019"
Enum: "ASHRAE_2019" "ASHRAE_2016" "ASHRAE_2013" "ASHRAE_2010" "ASHRAE_2007" "ASHRAE_2004" "DOE_Ref_1980_2004" "DOE_Ref_Pre_1980"

An enumeration.

equipment_type
string (ResidentialEquipmentType)
Default: "ResidentialAC_ElectricBaseboard"
Enum: "ResidentialAC_ElectricBaseboard" "ResidentialAC_BoilerBaseboard" "ResidentialAC_ASHPBaseboard" "ResidentialAC_DHWBaseboard" "ResidentialAC_ResidentialFurnace" "ResidentialAC" "ResidentialHP" "ResidentialHPNoCool" "ResidentialFurnace"

An enumeration.

{
  • "type": "Residential",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "vintage": "ASHRAE_2019",
  • "equipment_type": "ResidentialAC_ElectricBaseboard"
}

ResidentialEquipmentType

string (ResidentialEquipmentType)
Enum: "ResidentialAC_ElectricBaseboard" "ResidentialAC_BoilerBaseboard" "ResidentialAC_ASHPBaseboard" "ResidentialAC_DHWBaseboard" "ResidentialAC_ResidentialFurnace" "ResidentialAC" "ResidentialHP" "ResidentialHPNoCool" "ResidentialFurnace"

An enumeration.

"ResidentialAC_ElectricBaseboard"

RoofCeilingConstructionSet

type
string (Type) ^RoofCeilingConstructionSet$
Default: "RoofCeilingConstructionSet"

A base class to use when there is no baseclass available to fall on.

interior_construction
object (Interior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

exterior_construction
object (Exterior Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

ground_construction
object (Ground Construction) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

{
  • "type": "RoofCeilingConstructionSet",
  • "interior_construction": {
    },
  • "exterior_construction": {
    },
  • "ground_construction": {
    }
}

RoofCeilingConstructionSetAbridged

type
string (Type) ^RoofCeilingConstructionSetAbridged$
Default: "RoofCeilingConstructionSetAbridged"

A base class to use when there is no baseclass available to fall on.

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Surface or Adiabatic boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with an Outdoors boundary condition.

ground_construction
string (Ground Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Ground boundary condition.

{
  • "type": "RoofCeilingConstructionSetAbridged",
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "ground_construction": "string"
}

RoofCeilingModifierSet

type
string (Type) ^RoofCeilingModifierSet$
Default: "RoofCeilingModifierSet"

A base class to use when there is no baseclass available to fall on.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

{
  • "type": "RoofCeilingModifierSet",
  • "exterior_modifier": {
    },
  • "interior_modifier": {
    }
}

RoofCeilingModifierSetAbridged

type
string (Type) ^RoofCeilingModifierSetAbridged$
Default: "RoofCeilingModifierSetAbridged"

A base class to use when there is no baseclass available to fall on.

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

{
  • "type": "RoofCeilingModifierSetAbridged",
  • "exterior_modifier": "string",
  • "interior_modifier": "string"
}

Room

type
string (Type) ^Room$
Default: "Room"

A base class to use when there is no baseclass available to fall on.

identifier
required
string (Identifier) [ 1 .. 100 ] characters ^[.A-Za-z0-9_-]+$

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

required
Array of objects (Faces) >= 4 items

Faces that together form the closed volume of a room.

properties
required
object (Properties) Recursive

Extension properties for particular simulation engines (Radiance, EnergyPlus).

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object (eg. partitions, tables).

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. trees, landscaping).

multiplier
integer <int32> (Multiplier) >= 1
Default: 1

An integer noting how many times this Room is repeated. Multipliers are used to speed up the calculation when similar Rooms are repeated more than once. Essentially, a given simulation with the Room is run once and then the result is multiplied by the multiplier.

exclude_floor_area
boolean (Exclude Floor Area)
Default: false

A boolean for whether the Room floor area contributes to Models it is a part of. Note that this will not affect the floor_area property of this Room itself but it will ensure the Room floor area is excluded from any calculations when the Room is part of a Model, including EUI calculations.

zone
string (Zone)

Text string for for the zone identifier to which this Room belongs. Rooms sharing the same zone identifier are considered part of the same zone in a Model. If the zone identifier has not been specified, it will be the same as the Room identifier in the destination engine. Note that this property has no character restrictions.

story
string (Story)

Text string for the story identifier to which this Room belongs. Rooms sharing the same story identifier are considered part of the same story in a Model. Note that this property has no character restrictions.

{
  • "type": "Room",
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "faces": [
    ],
  • "properties": {
    },
  • "indoor_shades": [
    ],
  • "outdoor_shades": [
    ],
  • "multiplier": 1,
  • "exclude_floor_area": false,
  • "zone": "string",
  • "story": "string"
}

RoomDoe2Properties

type
string (Type) ^RoomDoe2Properties$
Default: "RoomDoe2Properties"

A base class to use when there is no baseclass available to fall on.

Autocalculate (object) or Assigned Flow (number) (Assigned Flow)
Default: {"type":"Autocalculate"}

A number for the design supply air flow rate for the zone the Room is assigned to (cfm). This establishes the minimum allowed design air flow. Note that the actual design flow may be larger. If Autocalculate, this parameter will not be written into the INP.

Autocalculate (object) or Flow Per Area (number) (Flow Per Area)
Default: {"type":"Autocalculate"}

A number for the design supply air flow rate to the zone per unit floor area (cfm/ft2). If Autocalculate, this parameter will not be written into the INP.

Autocalculate (object) or Min Flow Ratio (number) (Min Flow Ratio)
Default: {"type":"Autocalculate"}

A number between 0 and 1 for the minimum allowable zone air supply flow rate, expressed as a fraction of design flow rate. Applicable to variable-volume type systems only. If Autocalculate, this parameter will not be written into the INP.

Autocalculate (object) or Min Flow Per Area (number) (Min Flow Per Area)
Default: {"type":"Autocalculate"}

A number for the minimum air flow per square foot of floor area (cfm/ft2). This is an alternative way of specifying the min_flow_ratio. If Autocalculate, this parameter will not be written into the INP.

Autocalculate (object) or Hmax Flow Ratio (number) (Hmax Flow Ratio)
Default: {"type":"Autocalculate"}

A number between 0 and 1 for the ratio of the maximum (or fixed) heating airflow to the cooling airflow. The specific meaning varies according to the type of zone terminal. If Autocalculate, this parameter will not be written into the INP.

space_polygon_geometry
object (Space Polygon Geometry) Recursive

A single planar face in 3D space.

{
  • "type": "RoomDoe2Properties",
  • "assigned_flow": {
    },
  • "flow_per_area": {
    },
  • "min_flow_ratio": {
    },
  • "min_flow_per_area": {
    },
  • "hmax_flow_ratio": {
    },
  • "space_polygon_geometry": {
    }
}

RoomEnergyPropertiesAbridged

type
string (Type) ^RoomEnergyPropertiesAbridged$
Default: "RoomEnergyPropertiesAbridged"

A base class to use when there is no baseclass available to fall on.

construction_set
string (Construction Set) [ 1 .. 100 ] characters

Identifier of a ConstructionSet to specify all default constructions for the Faces, Apertures, and Doors of the Room. If None, the Room will use the Model global_construction_set.

program_type
string (Program Type) [ 1 .. 100 ] characters

Identifier of a ProgramType to specify all default schedules and loads for the Room. If None, the Room will have no loads or setpoints.

hvac
string (Hvac) [ 1 .. 100 ] characters

An optional identifier of a HVAC system (such as an IdealAirSystem) that specifies how the Room is conditioned. If None, it will be assumed that the Room is not conditioned.

shw
string (Shw) [ 1 .. 100 ] characters

An optional identifier of a Service Hot Water (SHW) system that specifies how the hot water load of the Room is met. If None, the hot water load will be met with a generic system that only measures thermal loadand does not account for system efficiencies.

people
object (People) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

lighting
object (Lighting) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

electric_equipment
object (Electric Equipment) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.

gas_equipment
object (Gas Equipment) Recursive

Base class for all objects requiring a valid EnergyPlus identifier.