THE ROOT XML ELEMENT
OLX data file must have the root XML element with the tag <ASPENOLXDB>, which contains child XM elements with the OneLiner network data.
<?xml version="1.0"
encoding="UTF-8"?>
<ASPENOLXDB OLRVERSION="15.4" DATETIME="Thu Sep 30
10:18:32 2021">
ADX data file must have the root XML element with the tag <ASPENOLX>, which in turn contains a single child element with the tag <OLXDIFF> where all the change file data elements are found.
The root element can include attributes for the various properties of the file as well as of the OneLiner network model or the file comparison case.
<?xml version="1.0"
encoding="UTF-8"?>
<ASPENOLX>
<OLXDIFF
OLRVERSION="15.4" DATETIME="Thu Sep 30 10:19:25 2021"
FILEA="J:\docu\Man1L_v15\SAMPLE30_B.OLR"
FILEB="J:\docu\Man1L_v15\sample30.olr"
COMP_BUSES="1" COMP_AREAZONES="1" COMP_GENS="1" COMP_LOADS="1"
COMP_SHUNTS="1"
COMP_SVDS="1"
COMP_LINES="1" COMP_SHIFTERS="1" COMP_XFMRS="1"
COMP_BREAKERS="1"
COMP_MUS="1"
COMP_OCRLYS="1" COMP_DSRLYS="1" COMP_SWITCHES="1"
COMP_DCLINE2S="1"
COMP_SCHEMES="1"
COMP_DEVICES="1"
EXTENT="0"
ORRELATE="0"
TIES="0"
AZRANGE="0-999999"
KVRANGE="0-9999"
BOUNDARYID="N"
TAGS=""
CHANGECOUNT="7"
>
THE ADX FILE CHANGESTAT ELEMENT
This XML element contains detailed statistics of the file comparison case in the ADX file.
<CHANGESTAT COUNT="7" DEL_GEN="1" DEL_GENUNIT="1" MOD_LINE="1"
ADD_XFMR="1"
ADD_RLYGROUP="1" ADD_RLYOC="1" MOD_BREAKER="1"/>
THE ADX FILE CHANGEREC ELEMENT
This XML element contains a change action to be applied to a data record in OneLiner network model.
<CHANGEREC ACTION="DELETE" OBJTYPE="GEN"
OLNETID="'NEW HAMPSHR' 33.kV"
OBJGUID="{04cc76bd-46c3-4ffa-8d7f-9b72b142f315}">/>
THE OLX FILE OBJCOUNT ELEMENT
This XML element contains detailed statistics of the OLX data tables.
<OBJCOUNT COUNT="171" BUS="33" LOAD="1" LOADUNIT="1" GEN="6"
GENUNIT="6"
LINE="36" XFMR="4" XFMR3="1" SHIFTER="1"
SERIESRC="1" MULINE="5" AREA="4"
ZONE="2" RLYGROUP="26"
RLYOC="20" RLYDS="15" FUSE="2" SWITCH="2" SCHEME="1"
BREAKER="2" DCLINE2="1"/>
THE OLX FILE SYSTEMPARAMS ELEMENT
This XML element contains various parameters of the OneLiner network model in this OLX file. It also contains a child element FILECOMMENTS with the OLR file comment text.
<SYSTEMPARAMS windowCenterX="-150" windowCenterY="46" nPrefaultV="0"
nIgnoreMOV="1"
nFaultMVAstyle="0" nSlack="-1"
nIterMax="20" wPFoptions="6" nCurRatingL="0"
nCurRatingX="0" nVoltStyle="0" nDataCompat="0" nGenZType="0"
nReferenceBus="1"
wCheckOnFileOpen="0"
nEquivColor="6" nGenILimitOption="0" nSmallR="1"
nUseANSIxrIEC="1"
nScaleI="0" nScaleIEC="0"
wBkrFaults="5" uStudyDate="0" nPFMethod="0" nTagColor="1"
bIgnoreInst="0" bIgnoreLoad="0" bIgnoreShunt="0" bIgnoreLineGB="0"
bRlyPickup1="0"
bUseSmallB="0" bIgnoreShift="0"
bIgnoreXfmrLineShunt="0" bHorzText="1" bSimulateCCGen="0"
bSimulateANSIrx="1" bDoAC="0" bUseZ2XR="1" bIgnore121kV="0"
bIgnore121kVt="1"
bIgnoreReclosing="0"
bUseFlatPU="0" b1LG115Total="0" bShowAllFaults="0"
b1LG115Sym="1"
bIgnoreOOS="1" bUseANSIxr="1"
bSEA_NoReverseZone="0" bSEA_NoPkgA="0" bSEA_NoPkgB="0"
bSEA_NoReclosing="0" bSEA_TransientFault="0" b1LLayoutLocked="0"
bSimulateGenW4="0"
bSimulateGenW3="0"
bRequireBusNo="2000115328" bDoNotSaveJournal="231142308"
baseMVA="100"
cnst1="3" fOlrZoomFactor="0.60653067"
fMinCTI="0.30000001" fMaxCTI="9999"
fSwitchX="0.001"
fSwitchR="0" fAccelFactor="0.40000001" fFlatBusV="1"
fPTolerance="1"
fQTolerance="1" fAdjustP="20"
fAdjustQ="20" fCurPerc="0.79999995" fMinV="0.94999999"
fMaxV="1.05" fBusVoltMult="120" fHzBase="60" fPickupCycles="1"
fSmallX="9.9999997e-005"
fSmallR="9.9999997e-005"
fXR1="10" fXR2="10" fXR3="10" fXR4="10" fKVcutoff="121"
fKVcutoffT="121" dFc1="0.27000001" dFc2="0.15000001" dMuThreshold="0"
Delimiter="39"
ColorTag=""
EquivalentID="N"
CaseGUID="{9948092d-99ee-4264-ac0f-61290d8df2e1}"
BaseVersionGUID="{0dbf3ad0-ac04-40d3-90d7-768e625d3374}">
<FILECOMMENTS> 29-BUS TEST
SYSTEM</FILECOMMENTS>
</SYSTEMPARAMS>
THE OLX FILE UDFTEMPLATE ELEMENT
This XML element contains the user-defined fields templates of various object types in the OLR network model.
<UDFTEMPLATE>
<OLRXOBJ
OBJTYPE="LINE">
<UDFIELD ROWNO="2" FNAME="OWNER" LABEL="Trasmission
Owner"/>
<UDFIELD ROWNO="3" FNAME="INDATE"
LABEL="In-service
date"/>
<UDFIELD ROWNO="1" FNAME="NAME"
LABEL="Name"/>
</OLRXOBJ>
</UDFTEMPLATE>
THE OLX FILE OLXTABLE ELEMENT
Each of this XML element contains children elements with data records for one OLR network model object type.
<OLXDBTABLE NAME="BUS" RECCOUNT="33">
</OLXDBTABLE>
THE OLX/ADX FILE OLNET ELEMENT
This XML element contain data fields that determine the placement of the object in the OLR network bus-branch model.
<OLNET
OBJTYPE="LINE">
<OLNETFIELD NAME="TERMNAME1"
VALUE="KENTUCKY"/>
<OLNETFIELD NAME="TERMKV1"
VALUE="33."/>
<OLNETFIELD NAME="TERMGUID1"
VALUE="{1329043e-90ab-423d-af8e-4f3e398d7b4}"/>
<OLNETFIELD NAME="TERMNAME2" VALUE="NEW
HAMPSHR"/>
<OLNETFIELD NAME="TERMKV2"
VALUE="33."/>
<OLNETFIELD NAME="TERMGUID2"
VALUE="{35669e9b-80e6-4d3f-9bc8-45b665143deb}"/>
<OLNETFIELD NAME="OBJGUID"
VALUE="{1d9a357e-7ff3-408d-af66-be204c92b3dc}"/>
<OLNETFIELD NAME="CKTID"
VALUE="1"/>
</OLNET>
THE ADX FILE OBJSCOPE ELEMENT
This XML element contains data fields that will allow ADX processing application user to filter the CHANGEREC records when desired.
<OBJSCOPE>
<SCOPEFIELD NAME="CKTID"
VALUE="1"/>
<SCOPEFIELD NAME="KV"
VALUE="33.000"/>
<SCOPEFIELD NAME="AREA"
VALUE="3"/>
<SCOPEFIELD NAME="ZONE"
VALUE="1"/>
<SCOPEFIELD NAME="BNO"
VALUE="20"/>
<SCOPEFIELD NAME="BNO"
VALUE="10"/>
</OBJSCOPE>
THE ADX FILE CHANGEFIELD ELEMENT
This XML element contain a change in one data field of the object.
<CHANGEFIELD LABEL="R" NAME="LN_R" VALUEA="0.03222" VALUEB="0.0936"/>
THE OLX FILE
DATAFIELD ELEMENT
This XML element contain one data field of the object.
<DATAFIELD VALUE="0" NAME="BS_HIDEID"/>