OpenStudio:measure
 All Classes Namespaces Functions Typedefs Enumerations Enumerator Pages
Protected Member Functions | List of all members
openstudio::measure::ModelMeasure Class Reference

#include <ModelMeasure.hpp>

+ Inheritance diagram for openstudio::measure::ModelMeasure:

Public Member Functions

Constructors and Destructors
virtual ~ModelMeasure ()
 
Getters
virtual std::vector< OSArgumentarguments (const openstudio::model::Model &model) const
 Returns the arguments for this script. More...
 
virtual std::vector< OSOutputoutputs () const
 Returns the outputs for this script. More...
 
Actions
virtual bool run (openstudio::model::Model &model, OSRunner &runner, const std::map< std::string, OSArgument > &user_arguments) const
 Run the script on the given model with the given runner and user_arguments. More...
 
- Public Member Functions inherited from openstudio::measure::OSMeasure
virtual ~OSMeasure ()
 
virtual std::string name () const
 user facing name of this measure, defaults to empty More...
 
virtual std::string description () const
 user facing description of this measure, defaults to empty More...
 
virtual std::string taxonomy () const
 user facing BCL taxonomy of this measure, defaults to empty More...
 
virtual std::string modeler_description () const
 user facing technical description of this measure, defaults to empty More...
 
virtual OS_DEPRECATED bool registerWithSketchUp () const
 Register this script with SketchUp. More...
 
virtual OS_DEPRECATED bool registerWithApplication () const
 Register this script with an Application. More...
 

Protected Member Functions

 ModelMeasure ()
 
- Protected Member Functions inherited from openstudio::measure::OSMeasure
 OSMeasure ()
 

Additional Inherited Members

Detailed Description

ModelMeasure is an abstract base class for UserScripts that operate on OpenStudio Models.

Constructor & Destructor Documentation

virtual openstudio::measure::ModelMeasure::~ModelMeasure ( )
virtual
openstudio::measure::ModelMeasure::ModelMeasure ( )
inlineprotected

Member Function Documentation

virtual std::vector<OSArgument> openstudio::measure::ModelMeasure::arguments ( const openstudio::model::Model &  model) const
virtual

Returns the arguments for this script.

In interactive applications, an OSRunner presents these arguments to the user to produce an OSArgumentMap of user_arguments that it then passes to this script's run method. The same basic steps should happen in applications with non- interactive scripts, but in that case an entity other than an OSRunner may be in charge of collecting user arguments. The base class implementation returns an empty vector.

virtual std::vector<OSOutput> openstudio::measure::ModelMeasure::outputs ( ) const
virtual

Returns the outputs for this script.

The base class implementation returns an empty vector.

virtual bool openstudio::measure::ModelMeasure::run ( openstudio::model::Model &  model,
OSRunner runner,
const std::map< std::string, OSArgument > &  user_arguments 
) const
virtual

Run the script on the given model with the given runner and user_arguments.

The base class implementation calls runner.prepareForMeasureRun(*this) and should be called at the beginning of derived class implementations of this method. (In C++, that call looks like ModelMeasure::run(model, runner, user_arguments). In Ruby that call looks like super(model, runner, user_arguments).