readme.txt

一种基于MATLAB的多目标最优化仿真工具箱

================================================
 MINOPF - A MINOS-based OPF Solver for MATPOWER
================================================

Version:    3.2

Home Page:  http://www.pserc.cornell.edu/minopf/

Author:     Carlos E. Murillo-Sanchez   <[e-mail]>

            Fri, Sep 21, 2007

$Id: README.txt,v 1.17 2007/09/22 00:44:49 ray Exp $
Copyright (c) 1997-2007 by Power System Engineering Research Center (PSERC)
See http://www.pserc.cornell.edu/minopf/ for more info.


--------------
 INTRODUCTION
--------------

MINOPF is MINOS-based optimal power flow solver for use with MATPOWER
<http://www.pserc.cornell.edu/matpower/>, a Matlab power system
simulation package. MINOPF is for educational and research use only. It
is typically much faster than MATPOWER's other OPF solvers.

When MINOPF is installed, it becomes the default optimal power flow
solver for MATPOWER. Documentation on the generalized OPF formulation
used by MINOPF can be found in the MATPOWER User's Manual
<http://www.pserc.cornell.edu/matpower/manual.pdf>, or by typing:
'help genform' at the Matlab prompt. Additional options for MINOPF
can be set using mpoption (see 'help mpoption' for details).

MINOS* is a Fortran-based software package, developed at the Systems
Optimization Laboratory <http://www.stanford.edu/group/SOL/> at Stanford
University, for solving large-scale optimization problems.

MINOPF can be downloaded from the MINOPF home page above. Pre-compiled
versions are available for HPUX, Linux, Mac OS X, Solaris and Windows.
NOTE: We are required, as part of our MINOS sublicensing agreement, to
report the names and e-mail addresses of all MINOPF sublicensees to
Stanford.


--------------
 TERMS OF USE
--------------

* MINOPF is free of charge. 

* The use of MINOPF under this license is restricted to non-commercial
  education/research use with MATPOWER only. Commercial use requires
  licensing MINOS directly from Stanford.

* We make no warranties, express or implied. Specifically, we make no
  guarantees regarding the correctness MINOPF's code or its fitness for
  any particular purpose.

* Any publications derived from the use of MINOPF must acknowledge
  MINOS. (Please cite: B. A. Murtagh & M. A. Saunders, "MINOS 5.5 User's
  Guide", Stanford University Systems Optimization Laboratory Technical
  Report SOL 83-20R.)

* MINOPF may not be redistributed. Each user must obtain it directly
  from the MINOPF web site. As part of our MINOS sublicense agreement we
  are required to report names and e-mail addresses of MINOPF sublicensees
  to Stanford.

* MINOPF may not be modified or reverse engineered.    


---------------------
 SYSTEM REQUIREMENTS
---------------------

    - Matlab version 6 or later
    - MATPOWER 3.2 or later <http://www.pserc.cornell.edu/matpower/>
    - BPMPD_MEX <http://www.pserc.cornell.edu/bpmpd/>
      (needed only to precondition problem if initial OPF fails)


--------------
 INSTALLATION
--------------

    1.  Unzip the downloaded file. 
    2.  Place the files in a location on your Matlab path. 


---------------------------
 WHAT'S NEW IN VERSION 3.2
---------------------------

Below is a summary of the changes since version 3.0.0 of MINOPF. See the
CHANGES file for all the gory details.

* New features:
  - new generalized cost model
  - piece-wise linear generator PQ capability curves
  - branch angle difference constraints
  - simplified interface for specifying additional linear constraints
  - ability to specify initial value and bounds on user variables z
  - access to all constraint shadow prices
  - support for new (v. 2) case file format
  - printing of version info unless MNS_VERBOSITY is 0
  - handling of multiple reference buses

* Bugs fixed:
  - No longer trust return codes 9 and 13 as being successful.
  - Phase shifters shifted the wrong direction.
  - Improved initialization of basic/superbasic variables and
    increased the allowed size for the reduced Hessian.
  - Fixed bug in calculation of cost gradients.
  - Linear constraint coefficients below the theta, V columns of
    nonlinear Jacobian would unsynchronize Jacobian elements order.
 
* INCOMPATIBLE CHANGES:
  - User supplied A matrix for general linear constraints in OPF no
    longer includes columns for helper variables for piecewise linear
    gen costs, and now requires columns for all x (OPF) variables.
  - Changed the sign convention used for phase shifters to be consistent
    with PTI, PowerWorld, PSAT, etc. E.g. A phase shift of 10 deg now
    means the voltage at the "to" end is delayed by 10 degrees.


-----------
 FILE LIST
-----------

  CHANGES        A detailed change history, with Unix line endings
  CHANGES.txt    A detailed change history, with DOS line endings (for Windows
                 users)
  minopf.m       Help for the MEX file
  minopf.mexglx  MEX file for Linux
  minopf.mexmac  MEX file for Mac OS X (PowerPC)
  minopf.mexmaci MEX file for Mac OS X (Intel)
  minopf.mexw32  MEX file for Windows
  minopfver.m    Prints or returns version information
  mopf.m         Top level OPF routine which sets up the problem and calls
                 minopf()
  README         This file, but with Unix line endings
  README.txt     This file
  sqppf.m        Called by mopf to precondition the problem if minopf() 
                 has trouble initially


---------
 SUPPORT
---------

Questions about MINOPF can be addressed to Carlos E. Murillo-Sanchez via
the MATPOWER mailing list
(see <http://www.pserc.cornell.edu/matpower/#mailinglist>).

--------------------------------------------
MINOS is a trademark of Stanford University and is copyright 1983-1998
by Stanford University.