 |
OpenStudio:utilities |
|
OpenStudio:utilities |
#include <IdfFile.hpp>
Public Member Functions | |
Constructors | |
| IdfFile (IddFileType iddFileType=IddFileType("OpenStudio")) | |
| Default constructor with optional IddFileType argument (default is IddFileType::OpenStudio). More... | |
| IdfFile (const IddFile &iddFile) | |
| Construct from iddFile. More... | |
Getters | |
| std::string | header () const |
| Returns the file header, that is, the comment block at the top of the file. More... | |
| VersionString | version () const |
| Returns the version of this model, as determined by the IddFile header. More... | |
| IddFile | iddFile () const |
| Returns the underlying IddFile (the schema for this IdfFile). More... | |
| IddFileType | iddFileType () const |
| Returns the underlying IddFile's IddFileType. More... | |
| boost::optional< IdfObject > | versionObject () const |
| Returns the version IdfObject in this file, if it exists and is unique. More... | |
| boost::optional< IdfObject > | getObject (unsigned index) const |
| Returns the object at index. More... | |
| boost::optional< IdfObject > | getObject (const Handle &handle) const |
| Returns the object with .handle() == handle, if such an object exists in this file. More... | |
| std::vector< IdfObject > | objects () const |
| Returns all the objects in this file, excluding versionObject(). More... | |
| std::vector< IdfObject > | getObjectsByType (IddObjectType objectType) const |
| Returns all objects of objectType (e.g. More... | |
| std::vector< IdfObject > | getObjectsByType (const IddObject &objectType) const |
| Returns all objects in this file for which .iddObject() == objectType. More... | |
| std::vector< IdfObject > | getObjectsByName (const std::string &name) const |
| Returns all objects named name (case insensitive). More... | |
Setters | |
| void | setHeader (const std::string &header) |
| Set the header for this file. More... | |
| void | addObject (const IdfObject &object) |
| Append object to the end of this file. More... | |
| void | addObjects (const std::vector< IdfObject > &objects) |
| Append objects to the end of this file. More... | |
| void | insertObjectByIddObjectType (const IdfObject &object) |
| Insert object immediately before the first object in this file whose IddObjectType value is greater than object's. More... | |
| bool | removeObject (const IdfObject &object) |
| Removes object from this file if it is in this file. More... | |
| int | removeObjects (const std::vector< IdfObject > &objects) |
| Attempts to remove each element of objects from this file, returning the number of successfully removed objects. More... | |
Queries | |
| bool | empty () const |
| Returns true if there is no header and no objects. More... | |
| unsigned | numObjects () const |
| Returns the number of non-version objects in this file. More... | |
| unsigned | numObjectsOfType (IddObjectType objectType) const |
| Returns the number of objects of objectType in this file. More... | |
| unsigned | numObjectsOfType (const IddObject &objectType) const |
| Returns the number of objects of objectType in this file. More... | |
| bool | isValid (StrictnessLevel level) const |
| Returns true if this IdfFile is valid, that is, has no DataErrors at or below level. More... | |
| ValidityReport | validityReport (StrictnessLevel level) const |
| Returns a ValidityReport for this IdfFile containing all DataErrors at or below level. More... | |
Protected Member Functions | |
| IddFileAndFactoryWrapper | iddFileAndFactoryWrapper () const |
| void | setIddFileAndFactoryWrapper (const IddFileAndFactoryWrapper &iddFileAndFactoryWrapper) |
Serialization | |
| std::ostream & | print (std::ostream &os) const |
| Print this file to std::ostream os. More... | |
| bool | save (const openstudio::path &p, bool overwrite=false) |
| Save this file to path p. More... | |
| static boost::optional< IdfFile > | load (std::istream &is, const IddFileType &iddFileType, ProgressBar *progressBar=nullptr) |
| Load an IdfFile from std::istream using the IDD defined by IddFactory and iddFileType, if possible. More... | |
| static boost::optional< IdfFile > | load (std::istream &is, const IddFile &iddFile, ProgressBar *progressBar=nullptr) |
| Load an IdfFile from std::istream using iddFile, if possible. More... | |
| static boost::optional< IdfFile > | load (const path &p, ProgressBar *progressBar=nullptr) |
| Load an IdfFile from path using the IddFactory, and choosing iddFileType based on file extension, if possible. More... | |
| static boost::optional< IdfFile > | load (const path &p, const IddFileType &iddFileType, ProgressBar *progressBar=nullptr) |
| Load an IdfFile from path using the IddFactory and iddFileType, if possible. More... | |
| static boost::optional< IdfFile > | load (const path &p, const IddFile &iddFile, ProgressBar *progressBar=nullptr) |
| Load an IdfFile from path using iddFile, if possible. More... | |
| static boost::optional < VersionString > | loadVersionOnly (std::istream &is) |
| Quick load method that uses the IddFile::catchallIddFile and stops parsing once a version identifier is found. More... | |
| static boost::optional < VersionString > | loadVersionOnly (const path &p) |
| Quick load method that uses the IddFile::catchallIddFile and stops parsing once a version identifier is found. More... | |
IdfFile provides parsing and printing of text files in EnergyPlus Input Data File (IDF) format.
This class can be used for ready-to-simulate EnergyPlus .idf files, OpenStudio .osm files, and partial idf/osm/osc files. This class expects to be constructed with the appropriate IddFile. An instance of the IddFileType enumeration class can be used to specify the latest EnergyPlus or OpenStudio IDD files. Previous versions of these IDD files, or IDD files of a different origin altogether, can be specified by explicitly calling IddFile::load, and then using that IddFile instance to load or construct an IdfFile.
IdfFile is not a shared object. It is composed of an ordered list of IdfObjects, each of which is a shared object.
| openstudio::IdfFile::IdfFile | ( | IddFileType | iddFileType = IddFileType("OpenStudio") | ) |
Default constructor with optional IddFileType argument (default is IddFileType::OpenStudio).
Initializes the file by adding a version IdfObject.
| openstudio::IdfFile::IdfFile | ( | const IddFile & | iddFile | ) |
Construct from iddFile.
Typically, iddFile is of IddFileType::UserCustom, that is, loaded from disk. Legacy OpenStudio IDD files back through Version 0.7.0 are available through the IddFactory. If possible, a version IdfObject is added.
| void openstudio::IdfFile::addObject | ( | const IdfObject & | object | ) |
Append object to the end of this file.
| void openstudio::IdfFile::addObjects | ( | const std::vector< IdfObject > & | objects | ) |
Append objects to the end of this file.
| bool openstudio::IdfFile::empty | ( | ) | const |
Returns true if there is no header and no objects.
(A versionObject does not count against emptiness.)
| boost::optional<IdfObject> openstudio::IdfFile::getObject | ( | unsigned | index | ) | const |
Returns the object at index.
Returns the object with .handle() == handle, if such an object exists in this file.
| std::vector<IdfObject> openstudio::IdfFile::getObjectsByName | ( | const std::string & | name | ) | const |
Returns all objects named name (case insensitive).
| std::vector<IdfObject> openstudio::IdfFile::getObjectsByType | ( | IddObjectType | objectType | ) | const |
Returns all objects of objectType (e.g.
IddObjectType("Zone"), IddObjectType("OS:Space")) in this file.
Returns all objects in this file for which .iddObject() == objectType.
| std::string openstudio::IdfFile::header | ( | ) | const |
Returns the file header, that is, the comment block at the top of the file.
| IddFile openstudio::IdfFile::iddFile | ( | ) | const |
|
protected |
| IddFileType openstudio::IdfFile::iddFileType | ( | ) | const |
Returns the underlying IddFile's IddFileType.
| void openstudio::IdfFile::insertObjectByIddObjectType | ( | const IdfObject & | object | ) |
Insert object immediately before the first object in this file whose IddObjectType value is greater than object's.
| bool openstudio::IdfFile::isValid | ( | StrictnessLevel | level | ) | const |
Returns true if this IdfFile is valid, that is, has no DataErrors at or below level.
|
static |
Load an IdfFile from std::istream using the IDD defined by IddFactory and iddFileType, if possible.
|
static |
Load an IdfFile from std::istream using iddFile, if possible.
|
static |
Load an IdfFile from path using the IddFactory, and choosing iddFileType based on file extension, if possible.
(IddFileType::OpenStudio if extension is modelFileExtension() or componentFileExtension(), IddFileType::EnergyPlus otherwise.)
|
static |
Load an IdfFile from path using the IddFactory and iddFileType, if possible.
Will attempt to complete the path by tacking on .osm or .idf as appropriate.
|
static |
Load an IdfFile from path using iddFile, if possible.
If no file extension is provided, will try "idf".
|
static |
Quick load method that uses the IddFile::catchallIddFile and stops parsing once a version identifier is found.
Used to determine the appropriate IddFile to use for a full load.
|
static |
Quick load method that uses the IddFile::catchallIddFile and stops parsing once a version identifier is found.
Used to determine the appropriate IddFile to use for a full load.
| unsigned openstudio::IdfFile::numObjects | ( | ) | const |
Returns the number of non-version objects in this file.
| unsigned openstudio::IdfFile::numObjectsOfType | ( | IddObjectType | objectType | ) | const |
Returns the number of objects of objectType in this file.
| unsigned openstudio::IdfFile::numObjectsOfType | ( | const IddObject & | objectType | ) | const |
Returns the number of objects of objectType in this file.
| std::vector<IdfObject> openstudio::IdfFile::objects | ( | ) | const |
Returns all the objects in this file, excluding versionObject().
| std::ostream& openstudio::IdfFile::print | ( | std::ostream & | os | ) | const |
Print this file to std::ostream os.
| bool openstudio::IdfFile::removeObject | ( | const IdfObject & | object | ) |
Removes object from this file if it is in this file.
Otherwise returns false.
Attempts to remove each element of objects from this file, returning the number of successfully removed objects.
| bool openstudio::IdfFile::save | ( | const openstudio::path & | p, |
| bool | overwrite = false |
||
| ) |
Save this file to path p.
Will construct the parent folder if necessary and if its parent folder already exists. Will only overwrite an existing file if overwrite==true. If no extension is provided will use modelFileExtension() for files using IddFileType::OpenStudio, and 'idf' otherwise. Returns true if the save operation is successful; false otherwise.
| void openstudio::IdfFile::setHeader | ( | const std::string & | header | ) |
Set the header for this file.
Will be printed as a comment block at the top of the file, before the objects. Automatically prefixes comment characters as needed.
|
protected |
| ValidityReport openstudio::IdfFile::validityReport | ( | StrictnessLevel | level | ) | const |
Returns a ValidityReport for this IdfFile containing all DataErrors at or below level.
| VersionString openstudio::IdfFile::version | ( | ) | const |
Returns the version of this model, as determined by the IddFile header.
| boost::optional<IdfObject> openstudio::IdfFile::versionObject | ( | ) | const |
Returns the version IdfObject in this file, if it exists and is unique.
Typically, the OS_ASSERT below will pass (but is not a trivial test).