run_opf

run_opf(varargin)

run_opf() Run an optimal power flow.

run_opf(d, mpopt)
run_opf(d, mpopt, ...)
task = run_opf(...)

This is the main function used to run optimal power flow (OPF) problems via the flexible MATPOWER framework.

This function is a simple wrapper around run_mp(), calling it with the first argument set to @mp.task_opf.

Inputs:

d – data source specification, currently assumed to be a MATPOWER case name or case struct (mpc)
mpopt (struct) – MATPOWER options struct

Additional optional inputs can be provided as <name>, <val> pairs, with the following options:
- 'print_fname' - file name for saving pretty-printed output
- 'soln_fname' - file name for saving solved case
- 'mpx' - MATPOWER extension or cell array of MATPOWER extensions to apply

Output:

task (mp.task_opf) – task object containing the solved run including the data, network, and mathematical model objects.

Solution results are available in the data model, and its elements, contained in the returned task object. For example:

task = run_opf('case9');
lam_p = task.dm.elements.bus.tab.lam_p  % nodal price
pg = task.dm.elements.gen.tab.pg        % generator active dispatch