Intro

CLI commands are used to run and post-process each scenario. Onscreen help is always availabe with uo -h

REopt Lite optimization happens during the post-processing of each scenario. Two types of REopt optimization are available: scenario-level, which optimizes for the entire district being simulated, and feature-level, which optimizes each building individually.

Workflow

The type of reopt optimization is specified in the CLI call:

This command allows you to post-process a ScenarioReport in aggregate. This is suitable for community-scale optimizations.

  uo -g -t reopt-scenario -s baseline_scenario.csv -f example_project.json  

Alternatively, this command allows you to post-process a Scenario for each of its Feature Reports before aggregating into a summary in the Scenario Report. This runs REopt optimization on each building individually.

  uo -g -t reopt-feature -s baseline_scenario.csv -f example_project.json  

Depending on the type of optimization chosen, REopt Lite runs on a ScenarioReport or FeatureReport. The resulting distributed_generation attributes (including system financial and sizing attributes) are updated as shown in an example below.

  "distributed_generation": {
        "lcc_us_dollars": 100000000.0,
        "npv_us_dollars": 10000000.0,
        "year_one_energy_cost_us_dollars": 7000000.0,
        "year_one_demand_cost_us_dollars": 3000000.0,
        "year_one_bill_us_dollars": 10000000.0,
        "total_energy_cost_us_dollars": 70000000.0,
        "total_solar_pv_kw": 30000.0,
        "total_wind_kw": 0.0,
        "total_generator_kw": 0.0,
        "total_storage_kw": 2000.0,
        "total_storage_kwh": 5000.0,
        "solar_pv": [{
          "size_kw": 30000.0
        }],
        "wind": [{
          "size_kw": 0.0
        }],
        "generator": [{
          "size_kw": 0.0
        }],
        "storage": [{
          "size_kw": 2000.0,
          "size_kwh": 5000.0
        }]
      }

Moreover, the following optimal dispatch fields are added to its timeseries CSV.

NOTE: A REopt Lite solution may contain multiple PV systems. In this case the aggregate generation from all PV systems will be reported in the PV columns.

The figure below describes the workflow that takes place on implementing the run and gather CLI commands.

The following figure represents how Simulation Mapper Classes can be assigned to different Features from the FeatureFile in the Scenario CSV.