Show/Hide Toolbars

HOMER Pro 3.16

Navigation: Design > Components Tab > Controller > MATLAB Link

Listing of simulation_state

Scroll Prev Top Next More

HOMER Logo


Rows marked with a * asterisk should be set in the MatlabDispatch function.


simulation_state.generators(i).power_available

double

kW, max generator power output

*

simulation_state.generators(i).power_setpoint

double

kW, commanded power output


simulation_state.generators(i).current_state

string

See description below


simulation_state.wind_turbines(i).power_available

double

kW, max wind turbines power output

*

simulation_state.wind_turbines(i).power_setpoint

double

kW, commanded power output


simulation_state.wind_turbines(i).current_state

string

See description below

The value of current_state are set to one of the following by HOMER: DISPATCH_DECIDES, FORCED_OFF_FOR_MAINTENANCE_EVENT, FORCED_OFF_FOR_SCHEDULE, FORCED_OFF_OUT_OF_FUEL, FORCED_ON_FOR_MINIMUM_RUNTIME, FORCED_ON_FOR_SCHEDULE


simulation_state.pvs(i).power_available

double

kW, pv generation available

*

simulation_state.pvs(i).power_setpoint

double

kW, optional curtailing

*

simulation_state.converters(i).inverter_power_input

double

kW

*

simulation_state.converters(i).inverter_power_output

double

kW

*

simulation_state.converters(i).rectifier_power_input

double

kW

*

simulation_state.converters(i).rectifier_power_output

double

kW

*

simulation_state.batteries(i).dedicated_converter.inverter_power_input

double

kW

*

simulation_state.batteries(i).dedicated_converter.inverter_power_output

double

kW

*

simulation_state.batteries(i).dedicated_converter.recifier_power_input

double

kW

*

simulation_state.batteries(i).dedicated_converter.rectifier_power_output

double

kW


simulation_state.batteries(i).energy_cost

double

cost/kWh, i.e. $/kWh


simulation_state.batteries(i).max_charge_power

double

kW


simulation_state.batteries(i).max_discharge_power

double

kW

*

simulation_state.batteries(i).power_setpoint

double

DC kW, positive is charging


simulation_state.batteries(i).state_of_charge_kwh

double

kWh


simulation_state.batteries(i).state_of_charge_percent

double

%


simulation_state.flywheels(i).flywheel_state

bool

true is on, false is off

*

simulation_state.flywheels(i).load_served

double

kW, MATLAB controller should set this equal to the parasitic load if possible


simulation_state.custom_components(i).power_available

double

kW, generation available

*

simulation_state.custom_components(i).power_setpoint

double

kW, optional curtailing


simulation_state.primary_loads(i).load_requested

double

kW

*

simulation_state.primary_loads(i).load_served

double

kW, MATLAB controller should set this equal to load_requested unless there is unmet load

*

simulation_state.ac_bus.capacity_shortage

double

kW, operating_capacity_requested - operating_capacity_served, >=0

*

simulation_state.ac_bus.excess_electricity

double

load_served - load_requested, >=0


simulation_state.ac_bus.load_requested

double

kW

*

simulation_state.ac_bus.load_served

double

kW, sum of all AC generation plus inverter output power, minus rectifier input power, <= load_requested


simulation_state.ac_bus.operating_capacity_requested

double

kW

*

simulation_state.ac_bus.operating_capacity_served

double

sum of maximum capacity of all operating generators, batteries, plus renewable output

*

simulation_state.ac_bus.unmet_load

double

load_requested - load_served, >=0

*

simulation_state.dc_bus.capacity_shortage

double

kW, operating_capacity_requested - operating_capacity_served, >=0

*

simulation_state.dc_bus.excess_electricity

double

load_served - load_requested, >=0


simulation_state.dc_bus.load_requested

double

kW

*

simulation_state.dc_bus.load_served

double

kW, sum of all DC generation plus rectifier output power, minus inverter input power, <= load_requested


simulation_state.dc_bus.operating_capacity_requested

double

kW

*

simulation_state.dc_bus.operating_capacity_served

double

sum of maximum capacity of all operating generators, batteries, plus renewable output

*

simulation_state.dc_bus.unmet_load

double

load_requested - load_served, >=0


simulation_state.current_timestep

int

Increments in each time step of the simulation, i.e. with a one-hour time step, the value will increment from zero to 8759 over the course of the simulation

*

simulation_state.grids(i).grid_purchases

double

Set to the energy purchased from the grid this time step, kW

*

simulation_state.grids(i).grid_sales

double

Set to the energy sold to the grid, kW


simulation_state.grids(i).grid_state

GridState (see simulation_parameters)

Defines the current state of the grid, as dictated by the model


simulation_state.grids(i).max_grid_purchases

double

Maximum power in kW that the grid can supply. grid_purchases can't exceed this value. This is also the operating reserve supplied by the grid.


simulation_state.grids(i).max_grid_sales

double

Maximum power in kW that can be sold to the grid. Maximum value for grid_sales


simulation_state.grids(i).power_price

double

Price paid for grid purchases, cost/kWh


simulation_state.grids(i).sellback_rate

double

Revenue for grid sales, income/kWh

See also

Controller

MATLAB Link