Function Function Run1LPFCommand( sInput$ ) As Long
Purpose: Run OneLiner command: Fault | Arc-flash Hazard Calculator | Arc-flash Hazard Calculator (IEEE 1584-2018).
Works in: OneLiner.
Parameters:
sInput [in] XML string, or full path name to XML file, containing XML node as described in Remarks section below.
Return value:
1 Success
0 Failure
Remarks: sInput must include XML node ARCFLASHCALCULATOR attributes in the list below (* denotes required entries, [] denotes default value).
REPORTPATHNAME or
REPFILENAME (*) full valid path to report file
APPENDREPORT [0] Append to existing report 0-No;1-Yes
OUTFILETYPE [2] Output file type 1- TXT; 2- CSV
SELECTEDOBJ Arcflash bus. Must have one of following values
“PICKED “ the highlighted bus on the 1-line diagram
“'BNAME1',KV1;’BNAME2’,KV2;…” Bus name and nominal kV.
TIERS [0] Number of tiers around selected object. This attribute is ignored if SELECTEDOBJ is not found.
AREAS [0-9999] Comma delimited list of area numbers and ranges to check relaygroups agains backup. This attribute is ignored if SELECTEDOBJ is found.
ZONES [0-9999] Comma delimited list of zone numbers and ranges to check relaygroups agains backup. This attribute is ignored if AREAS or SELECTEDOBJ are found.
KVS [0-999] Comma delimited list of KV levels and ranges to check relaygroups agains backup. This attribute is ignored if SELECTEDOBJ is found.
TAGS Comma delimited list of bus tags. This attribute is ignored if SELECTEDOBJ is found.
ELECTRODECFG (*) Electrode configuration: 0-VCB: vertical, inside metal enclosure; 1- VCBB: vertical, inside metal enclosure, with insulating barrier; 2- HCB: Horizontal, insibe metal enclosure; 3- VOA: Vertical, in open air; 4- HOA: Horizontal, in open air;
BOXH Enclosure height in inches. Required for electrode configurations VCB, VCBB, HCB.
BOXW Enclosure width in inches. Required for electrode configurations VCB, VCBB, HCB.
BOXD Enclosure depth in inches. Required for electrode configurations VCB, VCBB, HCB at voltage level of 600 or lower.
CONDUCTORGAP (*) Conductor gap in mm
WORKDIST (*) Working distance in inches
ARCDURATION Arc duration calculation method. Must have one of following values:
“FIXED“ Use fixed duration
“FUSE “ Use fuse curve
“FASTEST“ Use fastest trip time of device in vicinity
“DEVICE“ Use trip time of specified device
ARCTIME Arc duration in second. Must be present when ARCDURATION=”FIXED”
FUSECURVE Fuse LibraryName:CurveName for arc duration calculation. Must be present when ARCDURATION=” FUSECURVE”
BRKINTTIME Breaker interrupting time in cycle. Must be present when ARCDURATION=” FASTEST” and “DEVICE”
DEVICETIERS [1] Number of tiers. Must be present when ARCDURATION=” FASTEST” and =”SEA”
DEVICE String with location of the relaygroup and the relay name “BNO1;'BNAME1';KV1;BNO2;'BNAME2';KV2;'CKT';BTYP; RELAY_ID; ”. Format description of these fields are is in OneLiner help section 10.2.
Example:
Sub main()
sInput$ = "<ARCFLASHCALCULATOR2018 " & _
"REPFILENAME=""c:\\000tmp\\arcflash.csv"" " & _
"OUTFILETYPE=""2"" " & _
"SELECTEDOBJ=""'DOT BUS',13.8"" " & _
"ELECTRODECFG=""0"" " & _
"BOXH=""36"" " & _
"BOXW=""24"" " & _
"CONDUCTORGAP=""153"" " & _
"WORKDIST=""36"" " & _
"ARCDURATION=""FUSE"" " & _
"FUSECURVE=""ABB:CLE1-15-030"" " & _
" />"
Print sInput
If Run1LPFCommand( sInput ) Then
Print "Success"
Else
Print ErrorString()
End If
End Sub