/*
* @(#)PSSEDcLine2TDataParser.java
*
* Copyright (C) 2006-2013 www.interpss.org
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU LESSER GENERAL PUBLIC LICENSE
* as published by the Free Software Foundation; either version 2.1
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* @Author Mike Zhou
* @Version 1.0
* @Date 04/11/2013
*
* Revision History
* ================
*
*/
package org.ieee.odm.adapter.psse.parser.aclf;
import java.util.StringTokenizer;
import org.ieee.odm.adapter.psse.PSSEAdapter.PsseVersion;
import org.ieee.odm.common.ODMException;
/**
* Class for processing IEEE CDF bus data line string
*
* @author mzhou
*
*/
public class PSSEDcLine2TDataParser extends BasePSSEDataParser {
public PSSEDcLine2TDataParser(PsseVersion ver) {
super(ver);
}
@Override public String[] getMetadata() {
/*
* Format V30
*
Line-1:
I,MDC,RDC, SETVL, VSCHD, VCMOD, RCOMP, DELTI, METER, DCVMIN,CCCITMX,CCCACC
1,1, 13.7500, 552.00, 410.00, -1.00, 13.7500, 0.10000,'I', 0.00, 20, 1.00000
MDC Control mode: 0 for blocked, 1 for power, 2 for current. MDC = 0 by default.
SETVL Current (amps) or power (MW) demand. When MDC is one, a positive value of
SETVL specifies desired power at the rectifier and a negative value specifies
desired inverter power. No default allowed.
RDC The dc line resistance; entered in ohms. No default allowed.
VSCHD Scheduled compounded dc voltage; entered in kV. No default allowed.
METER Metered end code of either �R� (for rectifier) or �I� (for inverter). METER = �I� by default.
VCMOD Mode switch dc voltage; entered in kV. When the inverter dc voltage falls below
this value and the line is in power control mode (i.e., MDC = 1), the line switches
to current control mode with a desired current corresponding to the desired power
at scheduled dc voltage. VCMOD = 0.0 by default.
RCOMP Compounding resistance; entered in ohms. Gamma and/or TAPI is used to attempt
to hold the compounded voltage (VDCI + DCCUR*RCOMP) at VSCHD. To control
the inverter end dc voltage VDCI, set RCOMP to zero; to control the rectifier
end dc voltage VDCR, set RCOMP to the dc line resistance, RDC; otherwise, set
RCOMP to the appropriate fraction of RDC. RCOMP = 0.0 by default.
DELTI Margin entered in per unit of desired dc power or current. This is the fraction by
which the order is reduced when ALPHA is at its minimum and the inverter is controlling
the line current. DELTI = 0.0 by default.
DCVMIN Minimum compounded dc voltage; entered in kV. Only used in constant gamma
operation (i.e., when GAMMX = GAMMN) when TAPI is held constant and an ac
transformer tap is adjusted to control dc voltage (i.e., when IFI, ITI, and IDI specify
a two-winding transformer). DCVMIN = 0.0 by default.
Line-2: IPR,NBR,ALFMX,ALFMN,RCR,XCR,EBASR,TRR,TAPR,TMXR,TMNR,STPR,ICR,IFR,ITR,IDR,XCAPR
Line-3: IPI,NBI,GAMMX,GAMMN,RCI,XCI,EBASI,TRI,TAPI,TMXI,TMNI,STPI,ICI,IFI,ITI,IDI,XCAPI
IPR Rectifier converter bus number, or extended bus name enclosed in single quotes
(see Section 4.1.2). No default allowed.
NBR Number of bridges in series (rectifier). No default allowed.
ALFMX Nominal maximum rectifier firing angle; entered in degrees. No default allowed.
ALFMN Minimum steady-state rectifier firing angle; entered in degrees. No default allowed.
EBASR Rectifier primary base ac voltage; entered in kV. No default allowed.
ICR Rectifier firing angle measuring bus number, or extended bus name enclosed in
single quotes (see Section 4.1.2). The firing angle and angle limits used inside the
dc model are adjusted by the difference between the phase angles at this bus and
the ac/dc interface (i.e., the converter bus, IPR). ICR = 0 by default.
*/
return new String[] {
// 0-----------1-----------2-----------3-----------4
"I", "MDC", "RDC", "SETVL", "VSCHD", // Line-1
// 5 6 7 8 9
"VCMOD", "RCOMP", "DELTI", "METER", "DCVMIN",
// 10 11 12 13 14
"CCCITMX", "CCCACC",
"IPR", "NBR", "ALFMX", // Line-2
// 15 16 17 18 19
"ALFMN", "RCR", "XCR", "EBASR", "TRR",
// 20 21 22 23 24
"TAPR", "TMXR", "TMNR", "STPR", "ICR",
// 25 26 27 28 29
"IFR", "ITR", "IDR", "XCAPR",
"IPI", // Line-3
// 30 31 32 33 34
"NBI", "GAMMX", "GAMMN", "RCI", "XCI",
// 35 36 37 38 39
"EBASI", "TRI", "TAPI", "TMXI", "TMNI",
// 40 41 42 43 44
"STPI", "ICI", "IFI", "ITI", "IDI",
// 45
"XCAPI"
};
}
@Override public void parseFields(final String[] lineStrAry) throws ODMException {
StringTokenizer st = new StringTokenizer(lineStrAry[0], ",");
int cnt = 0;
while (st.hasMoreTokens())
this.setValue(cnt++, st.nextToken().trim());
st = new StringTokenizer(lineStrAry[1], ",");
cnt = 12;
while (st.hasMoreTokens())
this.setValue(cnt++, st.nextToken().trim());
st = new StringTokenizer(lineStrAry[2], ",");
cnt = 29;
while (st.hasMoreTokens())
this.setValue(cnt++, st.nextToken().trim());
}
}