Package: arcflash-calc
AboutThis is a Python library for doing arc flash calculations.This includes:AC arc flash calculations to IEEE 1584 (for 3-phase AC systems, 208 V - 15,000 V)Future planned efforts will include:AC arc flash calculations using the Lee method, for 3-phase AC systems above 15,000 V.DC arc flash calculations using the Doan and Ammerman methodsNot currently included:Any user interface for running calculationsAny integrations with power system studies softwareWhy did I write this?There are many arc flash calculator software packages and spreadsheets in the wild.The spreadsheets are done with Excel formulas or VBA code, both of which are difficult to write, maintain, and verify.
Spreadsheets also have the problem that they are hard to protect from inadvertent changes over time, which can lead to
errors in calculations.The software packages are usually closed-source commercial software, whose workings can't be independently verified.Therefore, my contribution to this field is an arc flash calculator library whose workings areeasy to understandandeasy to verify.VerificationThe engineers using this library must beconfidentthat it will produce correct results.Theieee_1584module includes unit tests which replicate the example calculations from Annex D1 and D2 of IEEE
1584, checking that all intermediate calculations, and final calculated results,exactlymatch the examples in
the standard. These calculations are verified to as many significant figures as are shown in the standard.As far as possible, I have written the calculator code so that it obviously corresponds to the way the formulas are
set out in the printed documents (standards, papers, etc.) It should (hopefully) be obvious from visual inspection
that the formulas are correct.Basic checks are included to help check if calculation parameters are within applicable bounds.Theieee_1584module includes 144,000 "additional test cases" which were calculated from the "official" IEEE
1584-2018 calculator spreadsheets, available at link [1].The 144,000 cases involve every combination of a number of possibilities for each input variable.The operation of theieee_1584python code for each of the 144,000 cases is then verified against the official
spreadsheet results to within (at most) 0.1%.Note 2022-02-14:There are currently some errors in the spreadsheetIEEE ExcelCalculator_V 2.6.6_M_mm_08_29_2019.xlsm. I have
attempted to contact the spreadsheet author(s) about this. Details are in theadditional_test_casesfolder.UnitsThe first version of this package (2022-02-22) required data to be entered in specific units of mm, kA, kV and J/cm². This left users vulnerable to unit conversion mishaps (e.g. entering times in sec instead of ms), which would result in severe calculation errors.As of the second major version of this package (2023-03-21) the code has been converted to usepintfor automatic unit tracking in calculations. This allows users to enter data in whatever unit they want (e.g. mm, metres, or inches) - the data will be automatically converted to the right unit.A unit test has been added which uses the exact same data as the example from Annex D2 of the standard, but with different input units (e.g. 480 V instead of 0.48 kV, and 610000 micrometres instead of 610 mm) to ensure the unit conversion code works correctly.Note that some formulas in IEEE 1584 use a factor of 1 mm = 0.03937 inch, which is a truncated value and thus introduces a small unit conversion error. I have chosen to match the printed text of IEEE 1584 exactly, rather than use the actual conversion factor of 5/127 (approx. 0.03937007874015748).LicenseThis software is released under the MIT License.DisclaimerUsers of the software should note the disclaimer included in the MIT License.In short - if you don't know what you are doing with this software - consult with an electrical engineer who does.References[1] :https://ieee-dataport.org/open-access/arc-flash-ie-and-iarc-calculators