PL42MAT REL. 4.0 (nov 2000)
PL42MAT is a freeware routines created in Pisa (Italy) by:
-> M. Ceraolo of university of Pisa and
-> R. Salutari of 3E Ingegneria srl.
The purpose of the routine is to convert binary outputs of the Electro-
Magnetic Transient program ATP (obtainable from www.EEUG.de and others)
into binary files readable by the program MATLAB (from Mathworks)
The routines is able to convert C-like binary ATP files, no matter what the
value of the value of variable NEWPL4 in ATP STARTUP file.
The program is a Win32 Console program. Therefore it wworks in any Win32-compatible
environment (Windows 9x, Windows 2000, Windows ME).
To know how to use the program, just execute it launching "pl42mat.exe".
NAMES OF THE VARIABLES OF ATP MATLAB, AND PL42MAT CONVERSION
Every ATP user knows that the program offers great freedoom in chosing the
names of the network nodes, and therefore of the variable stored in the PL4
file.
MATLAB, on the contrary is much more restrictive: only letters, digits and
the underscore character are allowed.
Therefore a conversion program can choice either to discard files containing
names non compatible with the destination format (i.e. with MATLAB naming
conventions), or convert the characters allowed by ATP but invalid in MATLAB
into valid MATLAB characters according to a conventional translation rule.
It is not difficult to understand that the second choice, while improving
compatibility, greatly reduces the readability of the MATLAB names.
The choice made by PL42MAT program authors was a compromise:
- blanks and dashes are accepted; blanks at the beginning or at the
end of names are discarded, while blanks and '-' inside names are
converted into the underscore character: '_'; however, the node
name " " (used as one of the node pair defining a branch
voltage, power or current) is translated into "Terra " before any
further processing;
- all the characters different from letters, digits or ' ' or '-' or '_'
are considered invalid. The user that wants to display its ATP
results in MATLAB using PL42MAT is then requested to avoid the use
of invalid characters within his ATP names.
If a file does not contain names with invalid characters, the MATLAB
names are generated by pl42mat according to the following rules:
0. Time is simply indicated as "t"
1. All the .PL4 node names and TACS, MODELS, Universal Machine and Synchronous
Machine variable names are converted into lowercase, except the first
characters that are converted into uppercase
2. If the names contain dashes or embedded blanks, they are converted into
underscores ('_'); blanks at beginning or end of names are discarded
3.
- The names for node voltages are obtained adding at the beginning of the
node names as they are after step 2 the character 'v'
- The names for branch voltages and currents are obtained combining the two
node names into a unique name and then adding at the beginning of the resulting
string the character 'v' or 'i' respectively; if one of the nodes is " ",
it is changed into "Terra "
- Names of TACS or MODELS variables are obtained adding at the beginning of the
names as they are after step 1 the characters 't' or 'm' respectively
- Names of Universal Machine and Synchronous Machine variables are obtained
adding at the beginning of the names as they are after step 1 the characters
'u' or 's' respectively, followed by a digit indicating the corresponding
machine number (so, up to 9 UMs and 9 SMs are supported).
Examples:
(from DC5)
Node of Voltage ' GENT ': vGent
Voltage Difference between 'TRANFF' and 'OPEN ': iTranffOpen
Current between 'GEN ' and ' GENT ': iGenGent
Current between 'LOAD ' and ' ': iLoad
(from DCn12)
UM variable 'UM-1 ' - 'TQGEN': u1Tqgen
(other)
Voltage Difference between 'UMPOS ' and ' ': vUmposTerra
Voltage Difference between ' ' and 'UMNEG ': vTerraUmneg
SM variable 'MACH 1' - 'ID ': s1Id
SM variable 'MACH 1' - 'TQ GEN': s1Tq_gen
SM variable 'MACH 1' - 'ANG 1 ': s1Ang_1
SM variable 'MACH 2' - 'ANG 1 ': s2Ang_1
MODELS variable 'MODELS' - 'SOC ': mSoc
MODELS variable 'MODELS' - 'Iw ': mIw
One of the main inprovements of rel. 3.0 and above is the addition of the possibility
of combining several PL4 files into a unique MAT file. Given that the names of
variables from different files can be the same, the program takes care of adding a
digit at the end of all the names, indicating the progressive number of the file which
each variable comes from.
Please send any comments to Massimo Ceraolo: m.ceraolo@ing.unipi.it
