Function Function Run1LPFCommand( sInput$ ) As Long
Purpose: Run OneLiner command: Fault | Arc-flash Hazard Calculator | Arc-flash Hazard Calculator (IEEE 1584-2011).
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 pathname of 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.
EQUIPMENTCAT (*) Equipment category: 0-Switch gear; 1- Cable; 2- Open air; 3- MCC's and panelboards 1kV or lower
GROUNDED (*) Is the equipment grounded 0-No; 1-Yes
ENCLOSED (*) Is the equipment inside enclosure 0-No; 1-Yes
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
“SEA“ Use stepped-event analysis
ARCTIME Arc duration in second. Must be present when ARCDURATION=”FIXED”
FUSECURVE Fuse curve 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.
ARCTIMELIMIT
[1] Perform no energy calculation when arc duration time is longer than 2
seconds
Example:
Sub main()
sInput$ = "< ARCFLASHCALCULATOR " & _
"REPFILENAME=""c:\\000tmp\\arcflash.csv"" " & _
"OUTFILETYPE=""2"" " & _
"SELECTEDOBJ= ""'DOT BUS',13.8"" " & _
"EQUIPMENTCAT=""0"" " & _
"GROUNDED=""1"" " & _
"ENCLOSED=""0"" " & _
"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