matpower4.0正式版

康奈尔大学Ray D. Zimmerman博士等人编写的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 vector 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  2011-02-16 20:52  matpower4.0\
     目录           0  2011-02-16 20:52  matpower4.0\@opf_model\
     文件        4745  2010-06-09 14:56  matpower4.0\@opf_model\add_constraints.m
     文件        5694  2010-04-26 19:45  matpower4.0\@opf_model\add_costs.m
     文件        3076  2010-04-26 19:45  matpower4.0\@opf_model\add_vars.m
     文件        4365  2010-04-26 19:45  matpower4.0\@opf_model\build_cost_params.m
     文件        4060  2010-04-26 19:45  matpower4.0\@opf_model\compute_cost.m
     文件        3959  2010-04-26 19:45  matpower4.0\@opf_model\display.m
     文件        1657  2010-04-26 19:45  matpower4.0\@opf_model\get.m
     文件        2737  2010-04-26 19:45  matpower4.0\@opf_model\get_cost_params.m
     文件        3012  2010-06-09 14:56  matpower4.0\@opf_model\get_idx.m
     文件        1771  2010-04-26 19:45  matpower4.0\@opf_model\get_lin_N.m
     文件        1450  2010-04-26 19:45  matpower4.0\@opf_model\get_mpc.m
     文件        1781  2010-06-09 14:56  matpower4.0\@opf_model\get_nln_N.m
     文件        1729  2010-04-26 19:45  matpower4.0\@opf_model\get_var_N.m
     文件        2405  2010-06-09 14:56  matpower4.0\@opf_model\getN.m
     文件        2221  2010-04-26 19:45  matpower4.0\@opf_model\getv.m
     文件        2945  2010-04-26 19:45  matpower4.0\@opf_model\linear_constraints.m
     文件        8294  2010-06-09 14:56  matpower4.0\@opf_model\opf_model.m
     文件        2149  2010-05-04 18:44  matpower4.0\@opf_model\userdata.m
     文件        6175  2010-04-26 19:45  matpower4.0\add_userfcn.m
     文件        2998  2010-04-26 19:45  matpower4.0\bustypes.m
     文件       32633  2010-03-10 18:08  matpower4.0\case118.m
     文件        4521  2010-03-10 18:08  matpower4.0\case14.m
     文件      340794  2010-03-10 18:08  matpower4.0\case2383wp.m
     文件        8708  2010-03-10 18:08  matpower4.0\case24_ieee_rts.m
     文件      717636  2010-03-10 18:08  matpower4.0\case2736sp.m
     文件      715220  2010-03-10 18:08  matpower4.0\case2737sop.m
     文件      732898  2010-03-10 18:08  matpower4.0\case2746wop.m
     文件      736274  2010-03-10 18:08  matpower4.0\case2746wp.m
     文件        5119  2010-03-10 18:08  matpower4.0\case30.m
............此处省略232个文件信息