Added US af template

blank-memo.rst

@@ -9,6 +9,10 @@
 
 .. This changes for section numbers, remove is "typical" numbering is good.
     .. section-numbering::
+.. raw:: latex
+
+    \usepackage{lipsum}
+
 
 .. This sets the page counter to roman
 .. raw:: pdf
@@ -114,3 +118,6 @@
 Common
 ======
 
+.. raw:: latex
+
+    \lipsum

tempates/Arc_Flash_Memo/af-memo-template-USA.rst

@@ -0,0 +1,287 @@
+..
+    This is the template file for an Arc Flash Analysis Memo in the USA. Use the Canadian verison if the project is located in Canada.
+
+.. Here are some notes about setting up the files
+.. rst2pdf -s "styles\jmk.yaml" <this document>.rst
+
+.. ==== -> Heading 1
+.. ---- -> Heading 2
+.. ~~~~ -> Heading 3
+.. ^^^^ -> Heading 4
+.. """" -> Heading 5
+
+.. This changes for section numbers, remove is "typical" numbering is good.
+    .. section-numbering::
+
+.. This sets the page counter to roman
+.. raw:: pdf
+
+    SetPageCounter 1 lowerroman
+
+.. This is the setup for the header substitutions. Sometimes there will be a second logo
+.. |logo| image:: logos/logo.jpg
+    :width: 20mm
+
+.. |Revision| replace:: A
+.. |Client| replace:: JMK Engineering Inc.
+.. |Date| replace:: Dec 14, 2023
+.. |Project| replace:: Project Title or site name
+.. |ProjectNum| replace:: num.
+
+
+.. header::
+
+    .. class:: headertable
+
+    .. list-table:: 
+        :widths: 20 50 20
+
+        *   - 
+            - **###Title###**
+            - |Date| 
+        *   - 
+            - CLIENT: |Client|
+            - Rev: |Revision|
+        *   - |logo|
+            - Proj. Num: |ProjectNum|
+            - Page ###Page###
+
+.. footer::
+
+    JMK Engineering Inc.
+
+
+.. This is where I will be adding any other text and image substitutions that will be needed throughout the "typical" specification
+.. |Title| replace:: Arc Flash Analysis Memo
+.. .. |SubTitle| replace:: Bretton Woods Lift Station
+
+
+===========
+|Title|
+===========
+
+--------------
+|Project|
+--------------
+
+..
+    --------------
+    |SubTitle|
+    --------------
+
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+|
+
+.. For a simply memo or living project document, the revision history is likely not needed, remove if necessary.
+
+
+.. list-table:: Revision History
+    :widths: 15 50 20 15
+
+    *   - A
+        - Issued for Consideration
+        - Dec 14, 2023
+        - 
+    *   - **Number**
+        - **Description**
+        - **Date**
+        - **Approved**
+
+
+.. Page break after the title page
+.. raw:: pdf
+
+    PageBreak
+
+
+.. This sets up the page break and re-set the page numbering - Only if I figure out how to do a table of contents
+.. .. raw:: pdf
+
+    PageBreak
+    SetPageCounter 1 arabic
+
+
+
+Executive Summary
+=====================================
+
+.. Start with an abbreviated scope
+
+The scope of this analysis is to determine the Arc Flash Incident Energy (cal/cm2) that will be available from an arc fault at any equipment from the incoming to the mains of any 277/480V or 120/240V panels. 
+
+.. Then, who has completed it, was it 100% JMK or where there other companies involved. Include the client if they assisted with gathering the source data.
+
+What is Arc Flash?
+-----------------------
+
+An arc flash is a dangerous conditions associated with the possible release of energy caused by an electric arc. [#]_
+
+.. [#]  National Fire Protection Association, NFPA 70E: standard for electrical safety in the workplace.   
+
+Arc flash labeling is a code requirement, however without proper training the labels aren't adequate to keep personnel safe. Arc flash labels are intended to be an integral part of an electrical safety program including risk analysis, training, PPE, etc. Employers have a legal obligation to familiarize all personnel with the requirements to enter electrical equipment. 
+
+The employer must provide the appropriate PPE to qualified workers based upon the labels provided and guidelines in NFPA 70E, if no labels are present. We highly recommend the owner secure a copy of NFPA 70E 2018 and OSHA 29 (Sub S) for use at the facility. 
+
+Analysis Method
+---------------------
+
+.. Make sure to update with the ETAP and calculation method that was used.
+
+The studies were performed with ETAP 21.0.2. The Arc Flash calculation method used is IEEE 1584-2018. The maximum clearing time was set at 10 seconds.
+
+
+.. If the client has a different standard, list them here.
+
+.. csv-table:: Incident Energy Levels
+    :header: Level ID, Cal/cm2
+    :width: 50%
+
+    Level A,< 2
+    Level B,< 4
+    Level C,< 8
+    Level D,< 25
+    Level E,< 40
+    Level F,< 100
+
+
+
+
+.. raw:: pdf
+
+    PageBreak
+    SetPageCounter 1 arabic
+
+Project Configuration
+========================
+
+.. 
+    Briefly describe the project configuration. Below is an example that can be used to start with.
+
+The expected utility transformer is a 150kVA. The utility provided a AIC letter dated xxxxxxxx stating that - 
+
+    The available short-circuit duty from the PG&E system will not exceed 14,000 RMS symmetrical amps at the service location.
+
+Assuming that the PGE distribution voltage is 12.47kV at the lowest, this represents a system capability of over 300MVA as the maximum. We feel this is unrealistic.
+
+Assuming that the 14kA is on the secondary system, the transformer serving this load would need to be around 500kVA, 3 times larger than the 200A service would require.
+
+To ensure that the system is modelled in a reasonable manner, we have assumed a 300kVA and a 150kVA padmount padmount PGE transformer with a range of short circuit levels from 5 - 100 MVA, the results below represent the worst case results.
+
+The model was developed based on Romtec Utilities drawing, Electrical Sheet 22 of 22 Motor Control Center (MCC) One-Line Diagram and the Eaton MCC detailed bill of material.
+
+There was no site drawing or utility layout drawings provided and all cable lengths have been assumed at 49' for the utility service and 29' for all motor feeds.
+
+.. 
+    Always include a SLD of the affected system. If its too large to fit nicely on a letter page, then it is probably a system that is too large to be using this template. 
+    Use the proper report style template.
+
+.. figure:: static/sld.png
+    :width: 90%
+
+    System ONE-LINE Diagram
+
+.. .. figure:: attach/cablelist.png
+    :width: 90%
+
+    Partial Cable and Conduit Schedule
+
+.. raw:: pdf
+
+    PageBreak
+
+.. 
+    Always include a SLD of the ETAP model to show that it is the same.
+
+.. figure:: static/etapsld.png
+    :width: 90%
+
+    ETAP SLD
+
+.. raw:: pdf
+
+    PageBreak
+
+
+Arc Flash Anaysis Results
+===============================
+
+This analysis and report has been developed following the guidelines of IEEE 1584.12.
+
+
+.. 
+    To make sure that the table looks right, make sure that you remember to remove the bottom part from the csv file.
+.. csv-table:: Incident Energy Levels
+    :file: static/results.csv
+    :width: 50%
+
+.. 
+    Write up the findings.
+
+
+.. raw:: pdf
+
+    PageBreak
+
+.. 
+    Include all the TCC that you think are necessary to properly describe how the system is operating.
+
+.. figure:: static/tcc.png
+    :width: 95%
+
+    TCC
+
+.. raw:: pdf
+
+    PageBreak
+
+.. figure:: static/tcc-lp.png
+    :width: 95%
+
+    TCC - 1-ph System
+
+
+
+
+.. raw:: pdf
+
+    PageBreak
+
+
+
+
+Recommendations
+=================
+
+There are no recommendations to assist in lowering the incident energy levels at this site.
+
+
+If you or the owner has any questions about the information covered in this letter, please feel free to contact ____________________ at JMK Engineering Inc.
+
+|
+
+JMK Engineering Inc.
+
+|
+|
+|
+
+BY ____________________________
+Title

tempates/Arc_Flash_Memo/static/results.csv

@@ -0,0 +1,16 @@
+ID,kV,Electrode Configuration,Output Rpt.,Configuration,Total Energy (cal/cm²),AFB (ft-in),Energy Levels,Final FCT (sec),Source PD ID
+LP,0.208,VCB,AF-20MVA,20MVA,0.037342,"0'2""",Level A,0.02,CB-MCC-M
+MCC,0.208,VCB,AF-100MVA,100MVA,0.034799,"0'3""",Level A,0.019,CB-MCC-M
+,,,,,,,,,
+,,,,,,,,,
+,,,,,,,,,
+,,ETAP,,,,,,,
+,,,,,,,,,
+,,,,,,,,,
+Project : Granite Terrace Lift Station,,,"Engineer : Samuel Terry, PE",,,,,,
+"Location : Rocklin, CA",,,Date :  ,,,,,,
+Contract # : ,,,Serial # : ETAP-OTI,,,,,,
+Filename : C:\Users\jeff\JMK Engineering Inc\Engineering - Documents\Active\ECS Engineering\PumpStation Arc Flash\2228_Granite_Terrace\eng\model\2228_Granite_Terrace.oti,,,,,,,,,
+,,,,,,,,,
+,,,,,,,,,
+,,,,,,,,,