Matpower6.0

iEEE学会推荐电力系统matlab仿真包，附带说明手册

function mpc = add_userfcn（mpc stage fcn args allow_multiple）
%ADD_USERFCN   Appends a userfcn to the list to be called for a case.
%
%   MPC = ADD_USERFCN（MPC STAGE FCN）
%   MPC = ADD_USERFCN（MPC STAGE FCN ARGS）
%   MPC = ADD_USERFCN（MPC STAGE FCN ARGS ALLOW_MULTIPLE）
%
%   A userfcn is a callback function that can be called automatically by
%   MATPOWER at one of various stages in a simulation.
%
%   MPC   : the case struct
%   STAGE : the name of the stage at which this function should be
%           called: ext2int formulation int2ext printpf
%   FCN   : the name of the userfcn
%   ARGS  : （optional） the value to be passed as an argument to the
%           userfcn （typically a struct）
%   ALLOW_MULTIPLE : （optional） if TRUE allows the same function to
%          be added more than once.
%
%   Currently there are 5 different callback stages defined. Each stage has
%   a name and by convention the name of a user-defined callback function
%   ends with the name of the stage. The following is a description of each
%   stage when it is called and the input and output arguments which vary
%   depending on the stage. The reserves example （see RUNOPF_W_RES） is used
%   to illustrate how these callback userfcns might be used.
%
%   1. ext2int
%
%   Called from EXT2INT immediately after the case is converted from
%   external to internal indexing. Inputs are a MATPOWER case struct （MPC）
%   freshly converted to internal indexing and any （optional） ARGS value
%   supplied via ADD_USERFCN. Output is the （presumably updated） MPC. This is
%   typically used to reorder any input arguments that may be needed in
%   internal ordering by the formulation stage.
%
%   E.g. mpc = userfcn_reserves_ext2int（mpc args）
%
%   2. formulation
%
%   Called from OPF after the OPF Model （OM） object has been initialized
%   with the standard OPF formulation but before calling the solver. Inputs
%   are the OM object and any （optional） ARGS supplied via ADD_USERFCN.
%   Output is the OM object. This is the ideal place to add any additional
%   vars constraints or costs to the OPF formulation.
%
%   E.g. om = userfcn_reserves_formulation（om args）
%
%   3. int2ext
%
%   Called from INT2EXT immediately before the resulting case is converted
%   from internal back to external indexing. Inputs are the RESULTS struct
%   and any （optional） ARGS supplied via ADD_USERFCN. Output is the RESULTS
%   struct. This is typically used to convert any results to external
%   indexing and populate any corresponding fields in the RESULTS struct.
%
%   E.g. results = userfcn_reserves_int2ext（results args）
%
%   4. printpf
%
%   Called from PRINTPF after the pretty-printing of the standard OPF
%   output. Inputs are the RESULTS struct the file descriptor to write to
%   a MATPOWER options struct and any （optional） ARGS supplied via
%   ADD_USERFCN. Output is the RESULTS struct. This is typically used for
%   any additional pretty-printing of results.
%
%   E.g. result

 属性            大小     日期    时间   名称
----------- ---------  ---------- -----  ----
     目录           0  2016-12-16 17:34  matpower6.0\
     目录           0  2016-12-16 17:34  matpower6.0\@opf_model\
     文件         711  2016-12-16 17:34  matpower6.0\@opf_model\display.m
     文件         434  2016-12-16 17:34  matpower6.0\@opf_model\get_mpc.m
     文件        2226  2016-12-16 17:34  matpower6.0\@opf_model\opf_model.m
     目录           0  2016-12-16 17:34  matpower6.0\@opt_model\
     文件        8151  2016-12-16 17:34  matpower6.0\@opt_model\add_constraints.m
     文件        9467  2016-12-16 17:34  matpower6.0\@opt_model\add_costs.m
     文件        6060  2016-12-16 17:34  matpower6.0\@opt_model\add_vars.m
     文件        6993  2016-12-16 17:34  matpower6.0\@opt_model\build_cost_params.m
     文件        3145  2016-12-16 17:34  matpower6.0\@opt_model\compute_cost.m
     文件        2293  2016-12-16 17:34  matpower6.0\@opt_model\describe_idx.m
     文件        5177  2016-12-16 17:34  matpower6.0\@opt_model\display.m
     文件         645  2016-12-16 17:34  matpower6.0\@opt_model\get.m
     文件        2196  2016-12-16 17:34  matpower6.0\@opt_model\get_cost_params.m
     文件        2168  2016-12-16 17:34  matpower6.0\@opt_model\get_idx.m
     文件        1625  2016-12-16 17:34  matpower6.0\@opt_model\getN.m
     文件        4465  2016-12-16 17:34  matpower6.0\@opt_model\getv.m
     文件        4191  2016-12-16 17:34  matpower6.0\@opt_model\linear_constraints.m
     文件        7901  2016-12-16 17:34  matpower6.0\@opt_model\opt_model.m
     文件        1132  2016-12-16 17:34  matpower6.0\@opt_model\userdata.m
     文件        5191  2016-12-16 17:34  matpower6.0\add_userfcn.m
     文件       17385  2016-12-16 17:34  matpower6.0\apply_changes.m
     文件         319  2016-12-16 17:34  matpower6.0\AUTHORS
     文件        2065  2016-12-16 17:34  matpower6.0\bustypes.m
     文件       33539  2016-12-16 17:33  matpower6.0\case118.m
     文件      214629  2016-12-16 17:33  matpower6.0\case1354pegase.m
     文件     2258871  2016-12-16 17:33  matpower6.0\case13659pegase.m
     文件        4611  2016-12-16 17:33  matpower6.0\case14.m
     文件       60070  2016-12-16 17:33  matpower6.0\case145.m
     文件      290087  2016-12-16 17:33  matpower6.0\case1888rte.m
............此处省略493个文件信息