How to Configure an OpenStudio Model

Obtain OpenStudio Model

First, it is necessary to obtain an OpenStudio model (.osm) for configuration in Alfalfa. Models may be developed with the OpenStudio application or existing reference models may be used. Please see the OpenStudio User Documentation for more information on developing models using OpenStudio and the DoE Prototype Building Models for examples of reference models that may be used.

Note: If your model is in Energy Plus Input File Format (.idf) additional steps may be required to convert your model to an .osm file.

Determine Required Inputs and Outputs

Determine the inputs and outputs relevant for your use case. All points that are documented in "List of Automatically Generated Energyplus Points" will be automatically generated upon upload to Alfalfa, and no additional steps are required in order to expose these points.

However, if additional points are required, follow the steps documented in "Creating Inputs and Outputs With Measures" to expose additional points in your model.

Configure Model for Upload

Once you have obtained a .osm model, configured any OpenStudio measures required for your use case, and obtained a weather file to run your model against, put all relevant files in "Required Structure of OpenStudio Workflow" for upload to Alfalfa.