Show/Hide Toolbars

HOMER Grid 1.9

Navigation: Design > Project > Controller > MATLAB Link

MatlabEndSimulation Function

Scroll Prev Top Next More

HOMER Logo


HOMER calls MatlabEndSimulation after all time steps have been simulated.

myErrs = MatlabEndSimulation(simulation_parameters, custom_variables)

The MatlabEndSimulation function generates errors and/or warnings, and returns them in the myErrs variable. The myErrs variable has two fields, simulation_errors and simulation_warnings. Both of these fields are cell arrays of strings. If you set warnings in simulation_warnings, they appear in the HOMER Optimization table on the Results page with a warning icon next to a simulation.

shots_components_controller_matlab_simulation_warning

Click on the entry in the Optimization table to see the Simulation Results pop-up window. In the Simulation Results, the warning also appears as a larger yellow warning symbol at the bottom of the page. If you set any errors in the simulation_errors, the simulation is not feasible and does not appear in the results.

The following table contains examples of commands you might use in the MatlabEndSimulation function.

Command

Description

myErrs.simulation_warnings = {'This is a MATLAB test warning.'};

Adds an example warning to the myErrs variable.

if custom_variables.total_energy < 1e4

 myErrs.simulation_warnings =

   [myErrs.simulation_warnings

   {'Not very much energy.'}];

end

You can use values set in custom_variables (in the MatlabDispatch function, for example) to trigger various warnings or errors.

myErr.severity_code = 'DISPATCH_CRITICAL_ERROR';

Setting this severity code skips the rest of the calculation.

See also

Controller

The Homer Support site has a searchable knowledgebase and additional support options. HOMER Online contains the latest information on model updates, as well as sample files, resource data, and contact information.UL LLC © 2022