#include <PlanarSurface.hpp>
Public Member Functions | |
double | azimuth () const |
Returns the surface's azimuth measured clockwise as angle between outward normal and local North (radians). More... | |
Point3d | centroid () const |
Return the centroid of this planar surface's vertices. More... | |
bool | equalVertices (const PlanarSurface &other) const |
Check if this planar surface's vertices are equal to the other's in the building coordinate system. More... | |
boost::optional< double > | exteriorVisibleAbsorbtance () const |
boost::optional< double > | exteriorVisibleAbsorptance () const |
Returns exterior visible absorptance (unitless), if available. More... | |
std::vector < GeneratorPhotovoltaic > | generatorPhotovoltaics () const |
Returns any generator photovoltaics associated with this surface. More... | |
double | grossArea () const |
Computes the surface's gross area (m^2). More... | |
boost::optional< double > | heatCapacity () const |
Returns the heat capacity of this surface in J/m^2*K, if available. More... | |
boost::optional< double > | interiorVisibleAbsorbtance () const |
boost::optional< double > | interiorVisibleAbsorptance () const |
Returns interior visible absorptance (unitless), if available. More... | |
bool | isAirWall () const |
Checks if this surface is an air wall, returns true if the Construction includes a single layer of type MaterialAirWall. More... | |
double | netArea () const |
Computes the surface's net area (m^2). More... | |
Vector3d | outwardNormal () const |
Returns the outward normal vector in local coordinates. More... | |
Plane | plane () const |
Get the plane, throws openstudio::Exception if cannot compute plane for this surface. More... | |
bool | reverseEqualVertices (const PlanarSurface &other) const |
Check if this planar surface's vertices are reverse equal to the other's in the building coordinate system. More... | |
bool | setThermalConductance (double value) |
Sets the conductance of this surface in W/m^2*K, if possible. More... | |
bool | setUFactor (double value) |
Sets the u-factor of this surface in W/m^2*K, if possible. More... | |
std::vector< ModelObject > | solarCollectors () const |
Returns any solar hot water collectors associated with this surface. More... | |
bool | subtractFromGrossArea () const |
Reports if user should subtract this surface's net area from parent's gross area to compute parent's net area (e.g. More... | |
std::vector < SurfacePropertyConvectionCoefficients > | surfacePropertyConvectionCoefficients () const |
Returns any SurfacePropertyConvectionCoefficients associated with this surface, does not return SurfacePropertyConvectionCoefficientsMultipleSurface. More... | |
boost::optional< double > | thermalConductance () const |
Returns the thermal conductance of this surface in W/m^2*K. More... | |
double | tilt () const |
Returns the surface's tilt measured as angle between outward normal and local up (radians). More... | |
virtual std::vector < std::vector< Point3d > > | triangulation () const |
Get a triangulation of this surface, subsurfaces will be replaced by holes in the triangulation. More... | |
boost::optional< double > | uFactor () const |
Returns the u-factor of this surface. More... | |
boost::optional< double > | visibleTransmittance () const |
Returns visible transmittance (unitless), if available. More... | |
Getters | |
boost::optional< ConstructionBase > | construction () const |
Returns the construction object. More... | |
boost::optional< std::pair < ConstructionBase, int > > | constructionWithSearchDistance () const |
Returns the construction object and the search distance that was needed to find the construction. More... | |
bool | isConstructionDefaulted () const |
Returns true if the construction is not directly referenced by this surface . More... | |
boost::optional < PlanarSurfaceGroup > | planarSurfaceGroup () const |
Returns the containing PlanarSurfaceGroup if available. More... | |
boost::optional< Space > | space () const |
Returns the containing Space if available. More... | |
std::vector< Point3d > | vertices () const |
Returns the vertices. More... | |
Setters | |
bool | setVertices (const std::vector< Point3d > &vertices) |
Sets the vertices. More... | |
bool | setConstruction (const ConstructionBase &construction) |
Sets the construction object. More... | |
void | resetConstruction () |
Resets the construction object. More... | |
Public Member Functions inherited from openstudio::model::ParentObject | |
std::vector< IddObjectType > | allowableChildTypes () const |
Returns a vector of allowable children types. More... | |
std::vector< ModelObject > | children () const |
Return direct child objects in the Model. More... | |
virtual | ~ParentObject () |
Public Member Functions inherited from openstudio::model::ModelObject | |
virtual | ~ModelObject () |
ModelObject | clone () const |
Creates a deep copy of this object, placing it in this object's model(). More... | |
ModelObject | clone (Model model) const |
Creates a deep copy of this object, placing it in model. More... | |
Component | createComponent () const |
Method for creating sharable Model snippets. More... | |
Model | model () const |
Returns the Model that contains this object. More... | |
boost::optional< ParentObject > | parent () const |
Return this object's parent in the hierarchy, if it has one. More... | |
std::vector< ResourceObject > | resources () const |
Get the resources directly used by this ModelObject. More... | |
template<typename T > | |
std::vector< T > | getModelObjectSources () const |
Get all objects of type T that point to this object. More... | |
template<typename T > | |
std::vector< T > | getModelObjectSources (IddObjectType iddObjectType) const |
Get all objects of type T that point to this object. More... | |
template<typename T > | |
boost::optional< T > | getModelObjectTarget (unsigned index) const |
Get the object of type T pointed to by this object from field index. More... | |
template<typename T > | |
std::vector< T > | getModelObjectTargets () const |
Get all objects of type T to which this object points. More... | |
const std::vector< std::string > & | outputVariableNames () const |
Get all output variables names that could be associated with this object. More... | |
std::vector< OutputVariable > | outputVariables () const |
Get all output variables associated with this object, must run simulation to generate data. More... | |
boost::optional < openstudio::TimeSeries > | getData (const OutputVariable &variable, const std::string &envPeriod) const |
Get data associated with this output variable and this object. More... | |
std::vector< LifeCycleCost > | lifeCycleCosts () const |
Returns the list of all LifeCycleCosts that refer to this object. More... | |
std::vector< IdfObject > | removeLifeCycleCosts () |
Removes all LifeCycleCosts that refer to this object. More... | |
IddObjectType | iddObjectType () const |
This is a virtual function that will tell you the type of iddObject you are dealing with. More... | |
AdditionalProperties | additionalProperties () const |
Returns this object's additional properties, constructing a new object if necessary. More... | |
bool | hasAdditionalProperties () const |
Returns true if this object has additional properties. More... | |
std::vector< IdfObject > | removeAdditionalProperties () |
Removes all additional properties that refer to this object. More... | |
bool | setParent (ParentObject &newParent) |
set the parent, child may have to call non-const methods on the parent More... | |
bool | operator< (const ModelObject &right) const |
bool | operator== (const ModelObject &other) const |
equality test More... | |
bool | operator!= (const ModelObject &other) const |
inequality test More... | |
std::vector< ScheduleTypeKey > | getScheduleTypeKeys (const Schedule &schedule) const |
Return the ScheduleTypeKeys indicating how schedule is used in this object. More... | |
boost::optional< double > | getAutosizedValue (std::string valueName, std::string unitString) const |
Gets the autosized component value from the sql file. More... | |
virtual std::vector < EMSActuatorNames > | emsActuatorNames () const |
Return the names of the available ems actuators. More... | |
virtual std::vector< std::string > | emsInternalVariableNames () const |
Return the names of the available ems internal variables. More... | |
boost::optional< ModelObject > | connectedObject (unsigned port) const |
boost::optional< unsigned > | connectedObjectPort (unsigned port) const |
Public Member Functions inherited from openstudio::WorkspaceObject | |
bool | canBeSource () const |
bool | canBeSource (unsigned index, const std::vector< std::string > &refLists=std::vector< std::string >()) const |
std::vector< std::string > | canBeTarget () const |
std::vector< unsigned > | getSourceIndices (const Handle &targetHandle) const |
std::vector< WorkspaceObject > | getSources (IddObjectType type) const |
boost::optional< WorkspaceObject > | getTarget (unsigned index) const |
IdfObject | idfObject () |
IdfObject | idfObject () const |
bool | initialized () const |
bool | isSource () const |
bool | isTarget () const |
unsigned | numSources () const |
bool | objectListFieldsEqual (const WorkspaceObject &other) const |
bool | objectListFieldsNonConflicting (const WorkspaceObject &other) const |
bool | operator< (const WorkspaceObject &right) const |
std::ostream & | operator<< (std::ostream &os, const WorkspaceObject &workspaceObject) |
std::vector < openstudio::IdfObject > | remove () |
bool | setPointer (unsigned index, const Handle &targetHandle) |
std::vector< WorkspaceObject > | sources () const |
std::vector< WorkspaceObject > | targets () const |
Workspace | workspace () const |
virtual | ~WorkspaceObject () |
Public Member Functions inherited from openstudio::IdfObject | |
std::string | briefDescription () const |
T | cast () const |
std::vector< T > | castVector (const std::vector< U > &objects) |
std::vector< std::vector < std::string > > | clearExtensibleGroups () |
IdfObject | clone (bool keepHandle=false) const |
std::string | comment () const |
boost::optional< std::string > | createName (bool overwrite=true) |
std::vector< unsigned > | dataFields () const |
bool | dataFieldsEqual (const IdfObject &other) const |
std::vector< std::string > | eraseExtensibleGroup (unsigned groupIndex) |
std::vector< IdfExtensibleGroup > | extensibleGroups () const |
boost::optional< std::string > | fieldComment (unsigned index, bool returnDefault=false) const |
boost::optional< double > | getDouble (unsigned index, bool returnDefault=false) const |
IdfExtensibleGroup | getExtensibleGroup (unsigned groupIndex) const |
std::vector< Handle > | getHandles (const std::vector< T > &objects) |
boost::optional< int > | getInt (unsigned index, bool returnDefault=false) const |
OSOptionalQuantity | getQuantity (unsigned index, bool returnDefault=false, bool returnIP=false) const |
boost::optional< std::string > | getString (unsigned index, bool returnDefault=false, bool returnUninitializedEmpty=false) const |
boost::optional< unsigned > | getUnsigned (unsigned index, bool returnDefault=false) const |
boost::optional< QUrl > | getURL (unsigned index, bool returnDefault=false) const |
Handle | handle () const |
IddObject | iddObject () const |
IdfObject (IddObjectType type, bool fastName=false) | |
IdfObject (const IddObject &, bool fastName=false) | |
IdfObject (const IdfObject &other) | |
IdfExtensibleGroup | insertExtensibleGroup (unsigned groupIndex) |
IdfExtensibleGroup | insertExtensibleGroup (unsigned groupIndex, const std::vector< std::string > &values) |
bool | isDataField (unsigned index) const |
bool | isEmpty (unsigned index) const |
bool | isObjectListField (unsigned index) const |
bool | isValid (StrictnessLevel level, bool checkNames=false) const |
boost::optional< unsigned > | maxExtensibleGroups () const |
boost::optional< unsigned > | maxFields () const |
unsigned | minExtensibleGroups () const |
unsigned | minFields () const |
boost::optional< std::string > | name (bool returnDefault=false) const |
std::string | nameString (bool returnDefault=false) const |
unsigned | numExtensibleGroups () const |
unsigned | numFields () const |
unsigned | numNonextensibleFields () const |
std::vector< unsigned > | objectListFields () const |
bool | objectListFieldsEqual (const IdfObject &other) const |
bool | objectListFieldsNonConflicting (const IdfObject &other) const |
bool | operator!= (const IdfObject &other) const |
std::ostream & | operator<< (std::ostream &os, const IdfObject &IdfObject) |
bool | operator== (const IdfObject &other) const |
boost::optional< T > | optionalCast () const |
std::vector< std::string > | popExtensibleGroup () |
std::ostream & | print (std::ostream &os) const |
std::ostream & | printField (std::ostream &os, unsigned index, bool isLastField=false) const |
std::ostream & | printName (std::ostream &os, bool hasFields=true) const |
IdfExtensibleGroup | pushExtensibleGroup () |
IdfExtensibleGroup | pushExtensibleGroup (const std::vector< std::string > &values) |
std::vector< unsigned > | requiredFields () const |
void | setComment (const std::string &msg) |
bool | setDouble (unsigned index, double value) |
bool | setFieldComment (unsigned index, const std::string &cmnt) |
bool | setInt (unsigned index, int value) |
boost::optional< std::string > | setName (const std::string &newName) |
bool | setQuantity (unsigned index, const Quantity &q) |
bool | setString (unsigned index, const std::string &value) |
bool | setUnsigned (unsigned index, unsigned value) |
std::vector< T > | subsetCastVector (const std::vector< U > &original) |
ValidityReport | validityReport (StrictnessLevel level, bool checkNames=false) const |
virtual | ~IdfObject () |
Static Public Member Functions | |
static double | filmResistance (const FilmResistanceType &type) |
Film resistances from ASHRAE Fundamentals, Chapter 25, Table 1 for non-reflective surfaces. More... | |
static std::vector< PlanarSurface > | findPlanarSurfaces (const std::vector< PlanarSurface > &planarSurfaces, boost::optional< double > minDegreesFromNorth, boost::optional< double > maxDegreesFromNorth, boost::optional< double > minDegreesTilt, boost::optional< double > maxDegreesTilt, double tol=1) |
Find PlanarSurfaces within angular range, specified in degrees in the site coordinate system, an unset optional means no limit. More... | |
static double | stillAirFilmResistance (double tilt) |
Film resistance of still air on surface with tilt (rad). More... | |
Static Public Member Functions inherited from openstudio::IdfObject | |
static boost::optional< IdfObject > | load (const std::string &text) |
static boost::optional< IdfObject > | load (const std::string &text, const IddObject &iddObject) |
static int | printedFieldSpace () |
Related Functions | |
(Note that these are not member functions.) | |
typedef boost::optional < PlanarSurface > | OptionalPlanarSurface |
typedef std::vector < PlanarSurface > | PlanarSurfaceVector |
Related Functions inherited from openstudio::model::ParentObject | |
std::vector< ModelObject > | getRecursiveChildren (const ParentObject &object, bool includeLifeCycleCostsAndAdditionalProperties=false) |
Returns object and all other objects accessible by calling children() on encountered ParentObjects . More... | |
std::vector< ModelObject > | getRecursiveChildrenAndResources (const ModelObject &object) |
Returns object and all other objects accessible by calling children() and resources() on encountered ModelObjects . More... | |
Related Functions inherited from openstudio::model::ModelObject | |
std::vector< ResourceObject > | getRecursiveResources (const ModelObject &object) |
Returns all ResourceObjects accessible by recursively calling .resources() starting from object. More... | |
typedef std::pair< std::string, std::string > | ScheduleTypeKey |
Typedef for ScheduleTypeRegistry key. More... | |
Constructors and Destructors | |
virtual | ~PlanarSurface () |
PlanarSurface (IddObjectType type, const std::vector< Point3d > &vertices, const Model &model) | |
Constructs a new PlanarSurface object in the model. More... | |
Additional Inherited Members | |
Public Types inherited from openstudio::WorkspaceObject | |
typedef boost::optional < WorkspaceObject > | OptionalWorkspaceObject |
typedef std::vector < WorkspaceObject > | WorkspaceObjectVector |
Public Types inherited from openstudio::IdfObject | |
typedef std::pair< IdfObject, IdfObject > | IdfObjectPair |
typedef std::vector< IdfObject > | IdfObjectVector |
typedef boost::optional < IdfObject > | OptionalIdfObject |
Protected Types inherited from openstudio::model::ModelObject | |
typedef detail::ModelObject_Impl | ImplType |
Protected Types inherited from openstudio::WorkspaceObject | |
typedef detail::WorkspaceObject_Impl | ImplType |
Protected Types inherited from openstudio::IdfObject | |
typedef detail::IdfObject_Impl | ImplType |
Protected Member Functions inherited from openstudio::model::ParentObject | |
ParentObject (IddObjectType type, const Model &model) | |
Constructs a new ParentObject object in the model. More... | |
Protected Member Functions inherited from openstudio::model::ModelObject | |
ModelObject (IddObjectType type, const Model &model, bool fastName=false) | |
ModelObject (std::shared_ptr< detail::ModelObject_Impl > impl) | |
Protected Member Functions inherited from openstudio::WorkspaceObject | |
WorkspaceObject (std::shared_ptr< detail::WorkspaceObject_Impl > impl) | |
Protected Member Functions inherited from openstudio::IdfObject | |
IdfObject (std::shared_ptr< detail::IdfObject_Impl > impl) | |
PlanarSurface is an abstract class derived from ParentObject.
PlanarSurface is a pure virtual class to consolodate functions dealing with surface geometry.
|
inlinevirtual |
|
protected |
Constructs a new PlanarSurface object in the model.
double openstudio::model::PlanarSurface::azimuth | ( | ) | const |
Returns the surface's azimuth measured clockwise as angle between outward normal and local North (radians).
Throws openstudio::Exception if cannot compute outward normal for this surface.
Point3d openstudio::model::PlanarSurface::centroid | ( | ) | const |
Return the centroid of this planar surface's vertices.
boost::optional<ConstructionBase> openstudio::model::PlanarSurface::construction | ( | ) | const |
Returns the construction object.
If the planar surface is paired with an adjacent planar surface, attempts to resolve any surface matching conflict.
boost::optional<std::pair<ConstructionBase, int> > openstudio::model::PlanarSurface::constructionWithSearchDistance | ( | ) | const |
Returns the construction object and the search distance that was needed to find the construction.
Does not consider adjacent planar surfaces.
bool openstudio::model::PlanarSurface::equalVertices | ( | const PlanarSurface & | other | ) | const |
Check if this planar surface's vertices are equal to the other's in the building coordinate system.
boost::optional<double> openstudio::model::PlanarSurface::exteriorVisibleAbsorbtance | ( | ) | const |
boost::optional<double> openstudio::model::PlanarSurface::exteriorVisibleAbsorptance | ( | ) | const |
Returns exterior visible absorptance (unitless), if available.
Attribute name: exteriorVisibleAbsorptance
|
static |
Film resistances from ASHRAE Fundamentals, Chapter 25, Table 1 for non-reflective surfaces.
Units of m^2*K/W.
|
static |
Find PlanarSurfaces within angular range, specified in degrees in the site coordinate system, an unset optional means no limit.
Values for degrees from North are between 0 and 360 and for degrees tilt they are between 0 and 180. Note that maxDegreesFromNorth may be less than minDegreesFromNorth, e.g. to search between NorthWest and NorthEast set minDegreesFromNorth = 315 and maxDegreesFromNorth = 45. The value of maxDegreesTilt must be greater than or equal to minDegreesTilt. A tolerance of one degree is applied by default.
std::vector<GeneratorPhotovoltaic> openstudio::model::PlanarSurface::generatorPhotovoltaics | ( | ) | const |
Returns any generator photovoltaics associated with this surface.
double openstudio::model::PlanarSurface::grossArea | ( | ) | const |
Computes the surface's gross area (m^2).
Attribute name: grossArea
boost::optional<double> openstudio::model::PlanarSurface::heatCapacity | ( | ) | const |
Returns the heat capacity of this surface in J/m^2*K, if available.
Attribute name: heatCapacity
boost::optional<double> openstudio::model::PlanarSurface::interiorVisibleAbsorbtance | ( | ) | const |
boost::optional<double> openstudio::model::PlanarSurface::interiorVisibleAbsorptance | ( | ) | const |
Returns interior visible absorptance (unitless), if available.
Attribute name: interiorVisibleAbsorptance
bool openstudio::model::PlanarSurface::isAirWall | ( | ) | const |
Checks if this surface is an air wall, returns true if the Construction includes a single layer of type MaterialAirWall.
bool openstudio::model::PlanarSurface::isConstructionDefaulted | ( | ) | const |
Returns true if the construction is not directly referenced by this surface .
double openstudio::model::PlanarSurface::netArea | ( | ) | const |
Computes the surface's net area (m^2).
Attribute name: netArea
Vector3d openstudio::model::PlanarSurface::outwardNormal | ( | ) | const |
Returns the outward normal vector in local coordinates.
Throws openstudio::Exception if cannot compute outward normal for this surface.
boost::optional<PlanarSurfaceGroup> openstudio::model::PlanarSurface::planarSurfaceGroup | ( | ) | const |
Returns the containing PlanarSurfaceGroup if available.
Plane openstudio::model::PlanarSurface::plane | ( | ) | const |
Get the plane, throws openstudio::Exception if cannot compute plane for this surface.
void openstudio::model::PlanarSurface::resetConstruction | ( | ) |
Resets the construction object.
bool openstudio::model::PlanarSurface::reverseEqualVertices | ( | const PlanarSurface & | other | ) | const |
Check if this planar surface's vertices are reverse equal to the other's in the building coordinate system.
bool openstudio::model::PlanarSurface::setConstruction | ( | const ConstructionBase & | construction | ) |
Sets the construction object.
Relationship name: construction
bool openstudio::model::PlanarSurface::setThermalConductance | ( | double | value | ) |
Sets the conductance of this surface in W/m^2*K, if possible.
Value should not include any film coefficients. Attribute name: thermalConductance
bool openstudio::model::PlanarSurface::setUFactor | ( | double | value | ) |
Sets the u-factor of this surface in W/m^2*K, if possible.
Value should already include appropriate standard film coefficients, assuming still air indoors and 15 mph outdoor air speed. Does not consider any custom SurfacePropertyConvectionCoefficients Attribute name: uFactor
bool openstudio::model::PlanarSurface::setVertices | ( | const std::vector< Point3d > & | vertices | ) |
Sets the vertices.
std::vector<ModelObject> openstudio::model::PlanarSurface::solarCollectors | ( | ) | const |
Returns any solar hot water collectors associated with this surface.
boost::optional<Space> openstudio::model::PlanarSurface::space | ( | ) | const |
Returns the containing Space if available.
|
static |
Film resistance of still air on surface with tilt (rad).
Horizontal roof has tilt of 0 rad; horizontal floor/slab has tilt of pi rad.
bool openstudio::model::PlanarSurface::subtractFromGrossArea | ( | ) | const |
Reports if user should subtract this surface's net area from parent's gross area to compute parent's net area (e.g.
true for a window).
std::vector<SurfacePropertyConvectionCoefficients> openstudio::model::PlanarSurface::surfacePropertyConvectionCoefficients | ( | ) | const |
Returns any SurfacePropertyConvectionCoefficients associated with this surface, does not return SurfacePropertyConvectionCoefficientsMultipleSurface.
boost::optional<double> openstudio::model::PlanarSurface::thermalConductance | ( | ) | const |
Returns the thermal conductance of this surface in W/m^2*K.
Does not include film coefficients. Attribute name: thermalConductance
double openstudio::model::PlanarSurface::tilt | ( | ) | const |
Returns the surface's tilt measured as angle between outward normal and local up (radians).
Throws openstudio::Exception if cannot compute outward normal for this surface.
|
virtual |
Get a triangulation of this surface, subsurfaces will be replaced by holes in the triangulation.
boost::optional<double> openstudio::model::PlanarSurface::uFactor | ( | ) | const |
Returns the u-factor of this surface.
Includes standard film coefficients, does not consider any custom SurfacePropertyConvectionCoefficients. Attribute name: uFactor
std::vector<Point3d> openstudio::model::PlanarSurface::vertices | ( | ) | const |
Returns the vertices.
boost::optional<double> openstudio::model::PlanarSurface::visibleTransmittance | ( | ) | const |
Returns visible transmittance (unitless), if available.
May require EnergyPlus simulation output. Attribute name: visibleTransmittance
|
related |
|
related |