 |
OpenStudioCore:utilities |
|
OpenStudioCore:utilities |
#include "IdfFile.hpp"
Public Member Functions | |
| IdfFile (IddFileType iddFileType=IddFileType("OpenStudio")) | |
| IdfFile (const IddFile &iddFile) | |
| std::string | header () const |
| VersionString | version () const |
| IddFile | iddFile () const |
| IddFileType | iddFileType () const |
| boost::optional< IdfObject > | versionObject () const |
| boost::optional< IdfObject > | getObject (unsigned index) const |
| boost::optional< IdfObject > | getObject (const Handle &handle) const |
| std::vector< IdfObject > | objects () const |
| std::vector< IdfObject > | getObjectsByType (IddObjectType objectType) const |
| std::vector< IdfObject > | getObjectsByType (const IddObject &objectType) const |
| std::vector< IdfObject > | getObjectsByName (const std::string &name) const |
| void | setHeader (const std::string &header) |
| void | addObject (const IdfObject &object) |
| void | addObjects (const std::vector< IdfObject > &objects) |
| void | insertObjectByIddObjectType (const IdfObject &object) |
| bool | removeObject (const IdfObject &object) |
| int | removeObjects (const std::vector< IdfObject > &objects) |
| bool | empty () const |
| unsigned | numObjects () const |
| unsigned | numObjectsOfType (IddObjectType objectType) const |
| unsigned | numObjectsOfType (const IddObject &objectType) const |
| bool | isValid (StrictnessLevel level) const |
| ValidityReport | validityReport (StrictnessLevel level) const |
Protected Member Functions | |
| IddFileAndFactoryWrapper | iddFileAndFactoryWrapper () const |
| void | setIddFileAndFactoryWrapper (const IddFileAndFactoryWrapper &iddFileAndFactoryWrapper) |
Serialization | |
| std::ostream & | print (std::ostream &os) const |
| bool | save (const openstudio::path &p, bool overwrite=false) |
| static boost::optional< IdfFile > | load (std::istream &is, const IddFileType &iddFileType, ProgressBar *progressBar=nullptr) |
| static boost::optional< IdfFile > | load (std::istream &is, const IddFile &iddFile, ProgressBar *progressBar=nullptr) |
| static boost::optional< IdfFile > | load (const path &p, ProgressBar *progressBar=nullptr) |
| static boost::optional< IdfFile > | load (const path &p, const IddFileType &iddFileType, ProgressBar *progressBar=nullptr) |
| static boost::optional< IdfFile > | load (const path &p, const IddFile &iddFile, ProgressBar *progressBar=nullptr) |
| static boost::optional < VersionString > | loadVersionOnly (std::istream &is) |
| static boost::optional < VersionString > | loadVersionOnly (const path &p) |
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.
| boost::optional<IdfObject> openstudio::IdfFile::getObject | ( | const Handle & | handle | ) | const |
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).