idx_cost

IDX_COST   Defines constants for named column indices to gencost matrix.
   Example:

   [PW_LINEAR, POLYNOMIAL, MODEL, STARTUP, SHUTDOWN, NCOST, COST] = idx_cost;

   Some examples of usage, after defining the constants using the line above,
   are:

    start = gencost(4, STARTUP);       % get startup cost of generator 4
    gencost(2, [MODEL, NCOST:COST+1]) = [ POLYNOMIAL 2 30 0 ];
    % set the cost of generator 2 to a linear function COST = 30 * Pg
 
   The index, name and meaning of each column of the gencost matrix is given
   below:
 
   columns 1-5
    1  MODEL       cost model, 1 = piecewise linear, 2 = polynomial
    2  STARTUP     startup cost in US dollars
    3  SHUTDOWN    shutdown cost in US dollars
    4  NCOST       number of cost coefficients to follow for polynomial cost
                   function, or number of data points for piecewise linear
    5  COST        parameters defining total cost function begin in this col
                  (MODEL = 1) : p0, f0, p1, f1, ..., pn, fn
                       where p0 < p1 < ... < pn and the cost f(p) is defined
                       by the coordinates (p0,f0), (p1,f1), ..., (pn,fn) of
                       the end/break-points of the piecewise linear cost
                  (MODEL = 2) : cn, ..., c1, c0
                       n+1 coefficients of an n-th order polynomial cost fcn,
                       starting with highest order, where cost is
                       f(p) = cn*p^n + ... + c1*p + c0
 
   additional constants, used to assign/compare values in the MODEL column
    1  PW_LINEAR   piecewise linear generator cost model
    2  POLYNOMIAL  polynomial generator cost model

   See also DEFINE_CONSTANTS.

0001 function [PW_LINEAR, POLYNOMIAL, MODEL, STARTUP, SHUTDOWN, NCOST, COST] = idx_cost
0002 %IDX_COST   Defines constants for named column indices to gencost matrix.
0003 %   Example:
0004 %
0005 %   [PW_LINEAR, POLYNOMIAL, MODEL, STARTUP, SHUTDOWN, NCOST, COST] = idx_cost;
0006 %
0007 %   Some examples of usage, after defining the constants using the line above,
0008 %   are:
0009 %
0010 %    start = gencost(4, STARTUP);       % get startup cost of generator 4
0011 %    gencost(2, [MODEL, NCOST:COST+1]) = [ POLYNOMIAL 2 30 0 ];
0012 %    % set the cost of generator 2 to a linear function COST = 30 * Pg
0013 %
0014 %   The index, name and meaning of each column of the gencost matrix is given
0015 %   below:
0016 %
0017 %   columns 1-5
0018 %    1  MODEL       cost model, 1 = piecewise linear, 2 = polynomial
0019 %    2  STARTUP     startup cost in US dollars
0020 %    3  SHUTDOWN    shutdown cost in US dollars
0021 %    4  NCOST       number of cost coefficients to follow for polynomial cost
0022 %                   function, or number of data points for piecewise linear
0023 %    5  COST        parameters defining total cost function begin in this col
0024 %                  (MODEL = 1) : p0, f0, p1, f1, ..., pn, fn
0025 %                       where p0 < p1 < ... < pn and the cost f(p) is defined
0026 %                       by the coordinates (p0,f0), (p1,f1), ..., (pn,fn) of
0027 %                       the end/break-points of the piecewise linear cost
0028 %                  (MODEL = 2) : cn, ..., c1, c0
0029 %                       n+1 coefficients of an n-th order polynomial cost fcn,
0030 %                       starting with highest order, where cost is
0031 %                       f(p) = cn*p^n + ... + c1*p + c0
0032 %
0033 %   additional constants, used to assign/compare values in the MODEL column
0034 %    1  PW_LINEAR   piecewise linear generator cost model
0035 %    2  POLYNOMIAL  polynomial generator cost model
0036 %
0037 %   See also DEFINE_CONSTANTS.
0038 
0039 %   MATPOWER
0040 %   Copyright (c) 1996-2016, Power Systems Engineering Research Center (PSERC)
0041 %   by Ray Zimmerman, PSERC Cornell
0042 %
0043 %   This file is part of MATPOWER.
0044 %   Covered by the 3-clause BSD License (see LICENSE file for details).
0045 %   See http://www.pserc.cornell.edu/matpower/ for more info.
0046 
0047 %% define cost models
0048 PW_LINEAR   = 1;
0049 POLYNOMIAL  = 2;
0050 
0051 %% define the indices
0052 MODEL       = 1;    %% cost model, 1 = piecewise linear, 2 = polynomial
0053 STARTUP     = 2;    %% startup cost in US dollars
0054 SHUTDOWN    = 3;    %% shutdown cost in US dollars
0055 NCOST       = 4;    %% number breakpoints in piecewise linear cost function,
0056                     %% or number of coefficients in polynomial cost function
0057 COST        = 5;    %% parameters defining total cost function begin in this col
0058                     %% (MODEL = 1) : p0, f0, p1, f1, ..., pn, fn
0059                     %%      where p0 < p1 < ... < pn and the cost f(p) is defined
0060                     %%      by the coordinates (p0,f0), (p1,f1), ..., (pn,fn) of
0061                     %%      the end/break-points of the piecewise linear cost
0062                     %% (MODEL = 2) : cn, ..., c1, c0
0063                     %%      n+1 coefficients of an n-th order polynomial cost fcn,
0064                     %%      starting with highest order, where cost is
0065                     %%      f(p) = cn*p^n + ... + c1*p + c0