matpower5.0

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  2014-12-17 20:01  matpower5.0
     目录           0  2014-12-17 20:01  matpower5.0@opf_model
     文件        1723  2012-05-03 12:59  matpower5.0@opf_modeldisplay.m
     文件        1446  2012-05-03 12:59  matpower5.0@opf_modelget_mpc.m
     文件        3223  2014-06-09 17:11  matpower5.0@opf_modelopf_model.m
     目录           0  2014-12-17 20:01  matpower5.0@opt_model
     文件        8574  2013-03-29 18:52  matpower5.0@opt_modeladd_constraints.m
     文件        9870  2013-10-14 16:34  matpower5.0@opt_modeladd_costs.m
     文件        6008  2012-06-26 19:12  matpower5.0@opt_modeladd_vars.m
     文件        7229  2013-03-29 18:52  matpower5.0@opt_modeluild_cost_params.m
     文件        4162  2012-05-03 12:59  matpower5.0@opt_modelcompute_cost.m
     文件        3051  2012-10-01 16:53  matpower5.0@opt_modeldescribe_idx.m
     文件        6189  2012-07-20 20:33  matpower5.0@opt_modeldisplay.m
     文件        1653  2012-05-03 12:59  matpower5.0@opt_modelget.m
     文件        3216  2012-05-03 12:59  matpower5.0@opt_modelget_cost_params.m
     文件        3180  2012-05-03 12:59  matpower5.0@opt_modelget_idx.m
     文件        2634  2012-05-03 12:59  matpower5.0@opt_modelgetN.m
     文件        2882  2012-05-03 12:59  matpower5.0@opt_modelgetv.m
     文件        4507  2013-03-29 18:52  matpower5.0@opt_modellinear_constraints.m
     文件        8712  2013-10-11 20:19  matpower5.0@opt_modelopt_model.m
     文件        2145  2012-05-03 12:59  matpower5.0@opt_modeluserdata.m
     文件        6207  2014-11-18 21:37  matpower5.0add_userfcn.m
     文件        2993  2010-04-26 19:45  matpower5.0ustypes.m
     文件       33590  2014-10-15 20:39  matpower5.0case118.m
     文件        4661  2014-10-15 20:39  matpower5.0case14.m
     文件      340738  2014-10-22 20:41  matpower5.0case2383wp.m
     文件        8635  2014-10-22 20:41  matpower5.0case24_ieee_rts.m
     文件      717580  2014-10-22 20:41  matpower5.0case2736sp.m
     文件      715164  2014-10-22 20:41  matpower5.0case2737sop.m
     文件      732842  2014-10-22 20:41  matpower5.0case2746wop.m
     文件      736218  2014-10-22 20:41  matpower5.0case2746wp.m
............此处省略325个文件信息