 |
OpenStudio:model |
|
OpenStudio:model |
#include <PlanarSurface.hpp>
Inheritance diagram for openstudio::model::PlanarSurface: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 > | 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 |
| boost::optional< double > | interiorVisibleAbsorptance () const |
| bool | isAirWall () const |
| Checks if this surface is an air wall, returns true if it's a ConstructionAirBoundary. More... | |
| bool | isConvex () const |
| 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) |
| 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 |
| 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 |
| 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... | |
| ParentObject & | operator= (const ParentObject &)=default |
| ParentObject & | operator= (ParentObject &&)=default |
| ParentObject (const ParentObject &other)=default | |
| ParentObject (ParentObject &&other)=default | |
| virtual | ~ParentObject ()=default |
| Public Member Functions inherited from openstudio::model::ModelObject | |
| virtual | ~ModelObject ()=default |
| ModelObject (const ModelObject &other)=default | |
| ModelObject (ModelObject &&other)=default | |
| ModelObject & | operator= (const ModelObject &)=default |
| ModelObject & | operator= (ModelObject &&)=default |
| 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... | |
| boost::optional< std::string > | cadObjectId () const |
| bool | setCADObjectId (const std::string &cadObjectId) |
| boost::optional< std::string > | gbXMLId () const |
| bool | setGBXMLId (const std::string &gbXMLId) |
| boost::optional< std::string > | displayName () const |
| bool | setDisplayName (const std::string &displayName) |
| 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 (const std::string &valueName, const std::string &units) 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) |
| WorkspaceObject & | operator= (WorkspaceObject &&)=default |
| WorkspaceObject & | operator= (const WorkspaceObject &)=default |
| 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 |
| WorkspaceObject (const WorkspaceObject &other)=default | |
| WorkspaceObject (WorkspaceObject &&other)=default | |
| virtual | ~WorkspaceObject ()=default |
| 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 |
| boost::optional< std::string > | getField (unsigned index, bool returnDefault=false) 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 |
| Handle | handle () const |
| IddObject | iddObject () const |
| IdfObject (IddObjectType type, bool fastName=false) | |
| IdfObject (const IdfObject &other) | |
| IdfObject (const IddObject &, bool fastName=false) | |
| IdfObject (IdfObject &&other) noexcept | |
| 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) |
| IdfObject & | operator= (IdfObject &&other) noexcept |
| IdfObject & | operator= (const IdfObject &other) |
| 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 (const std::vector< std::string > &values) |
| IdfExtensibleGroup | pushExtensibleGroup () |
| 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 ()=default |
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.) | |
| using | OptionalPlanarSurface = boost::optional< PlanarSurface > |
| using | PlanarSurfaceVector = std::vector< PlanarSurface > |
| Related Functions inherited from openstudio::model::ParentObject | |
| std::vector< ModelObject > | getRecursiveChildren (const ParentObject &object, bool includeLifeCycleCostsAndAdditionalProperties=false, bool includeUsedResources=true) |
| 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... | |
Constructors and Destructors | |
| virtual | ~PlanarSurface ()=default |
| PlanarSurface (const PlanarSurface &other)=default | |
| PlanarSurface (PlanarSurface &&other)=default | |
| PlanarSurface & | operator= (const PlanarSurface &)=default |
| PlanarSurface & | operator= (PlanarSurface &&)=default |
| 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 | |
| using | ImplType = detail::ModelObject_Impl |
| 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.
|
virtualdefault |
|
default |
|
default |
|
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::exteriorVisibleAbsorptance | ( | ) | const |
Returns exterior visible absorptance (unitless), if available.
|
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).
| boost::optional<double> openstudio::model::PlanarSurface::heatCapacity | ( | ) | const |
| boost::optional<double> openstudio::model::PlanarSurface::interiorVisibleAbsorptance | ( | ) | const |
| bool openstudio::model::PlanarSurface::isAirWall | ( | ) | const |
Checks if this surface is an air wall, returns true if it's a ConstructionAirBoundary.
| bool openstudio::model::PlanarSurface::isConstructionDefaulted | ( | ) | const |
Returns true if the construction is not directly referenced by this surface .
| bool openstudio::model::PlanarSurface::isConvex | ( | ) | const |
| double openstudio::model::PlanarSurface::netArea | ( | ) | const |
Computes the surface's net area (m^2).
|
default |
|
default |
| 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.
| bool openstudio::model::PlanarSurface::setThermalConductance | ( | double | value | ) |
| 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
| 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 |
| 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 |
| 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.
|
related |
|
related |