Introduced documentation for IPDs

.idea/lhc-sm-hwc.iml

@@ -2,6 +2,7 @@
 <module type="PYTHON_MODULE" version="4">
   <component name="NewModuleRootManager">
     <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="Python 3.7 (lhc-sm-hwc)" jdkType="Python SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
   </component>
 </module>
\ No newline at end of file

README.ipynb

@@ -137,15 +137,193 @@
     "|HWC|PIC|~|Powering Interlock Controller check with standby current|AN\\_IT\\_PIC|-|\n",
     "|HWC|PNO.D12|10% of I\\_PNO|Powering Failure at +10% of nominal current|AN\\_IT\\_PNO.D12|-|\n",
     "|HWC|PNO.D13|10% of I\\_PNO|Powering Failure at -10% of nominal current|AN\\_IT\\_PNO.D13|-|\n",
-    "|HWC|PLI3.F6|I_PLI3|Heater Discharge Request at 2nd intermediate current (Note that I\\_RTQX1=0A|AN\\_IT\\_PNO.F6|-|\n",
-    "|HWC|PNO.D14|50% of I\\_PNO|Powering Failure at +50% of nominal current during a SPA|AN\\_IT\\_PNO.D14|-|\n",
+    "|HWC|PLI3.F6|I_PLI3|Heater Discharge Request at 2nd intermediate current (Note that I\\_RTQX1=0A|[AN\\_IT\\_PLI3.F6](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PLI3.F6.ipynb)|-|\n",
+    "|HWC|PNO.D14|50% of I\\_PNO|Powering Failure at +50% of nominal current during a SPA|[AN\\_IT\\_PNO.D14](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PNO.D14.ipynb)|-|\n",
     "|HWC|PNO.D15|50% of I\\_PNO|Powering Failure at -50% of nominal current|AN\\_IT\\_PNO.D15|-|\n",
-    "|HWC|PNO.A9|I\\_PNO+I\\_DELTA|Training and plateau at nominal current|AN\\_IT\\_PNO.A9|-|\n",
-    "|HWC|PNO.D16|90% of I\\_PNO|Powering Failure at +90% of nominal current|AN\\_IT\\_PNO.D16|-|\n",
+    "|HWC|PNO.A9|I\\_PNO+I\\_DELTA|Training and plateau at nominal current|[AN\\_IT\\_PNO.A9](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PNO.A9.ipynb)|-|\n",
+    "|HWC|PNO.D16|90% of I\\_PNO|Powering Failure at +90% of nominal current|[AN\\_IT\\_PNO.D16](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PNO.D16.ipynb)|-|\n",
     "|HWC|PNO.D17|90% of I\\_PNO|Powering Failure at -90% of nominal current|AN\\_IT\\_PNO.D17|-|\n",
     "|Operation|FPA|I\\_PNO|FPA during operation with magnets quenching|[AN\\_IT\\_FPA](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_FPA.ipynb)|-|\n"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# 5. IPD - Beam Separation Dipoles D1-D4\n",
+    "This section is a copy of a document created by Alexandre Erokhin (https://twiki.cern.ch/twiki/pub/MP3/General_Info_IPD/separation_dipole.pdf)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "|Magnets in the Circuit|Temperature|Position|General information|\n",
+    "|----------------------|-----------|--------|-------------------|\n",
+    "|MBX (D1)|1.9 K| RD1.R2, RD1.R8|I Nominal: 5800A, I_Ultimate: 6100A|\n",
+    "| | | |L tot: 26 mH, L per aperture: 26 mH|\n",
+    "| | | |max(di/dt): 17.453 A/s|\n",
+    "|MBRC (D2)|4.5 K| RD2.L1, RD2.R1, RD2.L5, RD2.R5|I Nominal: 4400A, I_Ultimate: 4670A|\n",
+    "| | | RD2.L2, RD2.R2, RD2.L8, RD2.R8|I Nominal: 6000A, I_Ultimate: 6500A|\n",
+    "| | | |L tot: 52 mH, L per aperture: 26 mH|\n",
+    "| | | |max(di/dt): 18.147 A/s|\n",
+    "|MBRS (D3)|4.5 K| RD3.L4, RD3.R4|I Nominal: 5520A, I_Ultimate: 6000A|\n",
+    "| | | |L tot: 26 mH, L per aperture: 26 mH|\n",
+    "| | | |max(di/dt): 18.147 A/s|\n",
+    "|MBRB (D4)|4.5 K| RD4.L4, RD4.R4|I Nominal: 5520A, I_Ultimate: 6000A|\n",
+    "| | | |L tot: 26 mH, L per aperture: 26 mH|\n",
+    "| | | |max(di/dt): 18.147 A/s|"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Superconducting beam separation dipoles of four different types are required in the Experimental Insertions (IR 1, 2, 5 and 8) and the RF insertion (IR 4). Single aperture dipoles D1 (MBX) and twin aperture dipoles D2 (MBRC) are utilized in the Experimental Insertions. They bring the two beams of the LHC into collision at four separate points then separate the beams again beyond the collision point. In the RF Insertions two types of twin aperture dipoles, each type with two different aperture spacings are used: D3 (MBRS) and D4 (MBRB). The D3 and D4 magnets increase the separation of the beams in IR 4 from the nominal spacing 194 mm to 420 mm. D2 and D4 are the twin apertures magnets with common iron core for both apertures. D3 is a twin apertures magnet with independent iron cores for each aperture.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The MBRC dipole consists of two individually powered apertures assembled in a common yoke structure."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "- MBX – D1  \n",
+    "Single aperture of the magnet powered with one power supply.\n",
+    "<img src=\"figures/ipd/IPD_MBX_D1.png\" width=75%>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "- MBRC – D2  \n",
+    "Apertures B1 and B2 of the magnet are powered in series with one power supply.\n",
+    "<img src=\"figures/ipd/IPD_MBRC_D2_MBRB_D4.png\" width=75%>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "- MBRS - D3  \n",
+    "Apertures B1 and B2 of the magnet are powered in series with one power supply but series connection done in the DFBA.\n",
+    "<img src=\"figures/ipd/IPD_MBRS_D3.png\" width=75%>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "- MBRB – D4  \n",
+    "Apertures B1 and B2 of the magnet are powered in series with one power supply.\n",
+    "<img src=\"figures/ipd/IPD_MBRC_D2_MBRB_D4.png\" width=75%>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quench Detection System"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "**Quench Detector Type**  \n",
+    "DQQDC - current leads quench detector  \n",
+    "DQAMG - controller attached to global protection  "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "**Current Leads:**\n",
+    "- Typical resistance for U_RES: 7 uOhm\n",
+    "- Threshold for U_HTS: 3 mV, 1s\n",
+    "- Polarity convention: Arrows show how signals are measured. If I > 0, LD1: U_RES > 0, LD2: U_RES < 0\n",
+    "- PM file\n",
+    "  - Buffer range 0 to 250, event at point 50\n",
+    "  - Time range: -10 to 40 s\n",
+    "  - Frequency: 5 Hz (dt = 200 ms)\n",
+    "  \n",
+    "**Magnet:**\n",
+    "- See polarity convention in the circuit schematics\n",
+    "- U_RES_B1 = U_1_B1 + U_2_B1\n",
+    "- Threshold on U_RES_B1: 100 mV, 10 ms\n",
+    "- U_RES_B2, U_1_B2, U_2_B2 and U_INDUCT_B2 are given for diagnostics only\n",
+    "- Signals are measured with -2.5 V offset and with the gain factor = 0.0012\n",
+    "- *Attention: B1 signals and B2 singals can be shifted by 4 ms from each other*\n",
+    "- If pure inductive signal and di/dt < 0:\n",
+    "  - U_1_B1 = L di/dt < 0\n",
+    "  - U_2_B1 = -L di/dt < 0\n",
+    "  \n",
+    "- PM file\n",
+    "  - Buffer range 501 to 1500, event at point 1000\n",
+    "  - Time range: -2 to 2 s\n",
+    "  - Frequency: 250 Hz (dt = 4 ms)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quench Heaters"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The protection of the separation dipoles during a quench is assured by strip quench heaters placed on the outer layer of each coil quadrant (Figs. 5.1, 5.3 and 5.5). For redundancy, the heaters are connected in two circuits, such that each circuit covers both coils and powered by independent power supplies (Figs. 5.2, 5.4 and 5.6)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img src=\"figures/ipd/QH_topology_D1.png\" width=50%>\n",
+    "<center>Fig. 5.1. Quench heaters topology for D1</center>\n",
+    "<img src=\"figures/ipd/QH_powering_D1.png\" width=50%>\n",
+    "<center>Fig. 5.2. Quench heaters powering for D1</center>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img src=\"figures/ipd/QH_topology_D2_D4.png\" width=75%>\n",
+    "<center>Fig. 5.3. Quench heaters topology for D2 and D4</center>\n",
+    "<img src=\"figures/ipd/QH_powering_D1.png\" width=50%>\n",
+    "<center>Fig. 5.4. Quench heaters powering for D2 and D4</center>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img src=\"figures/ipd/QH_topology_D3.png\" width=75%>\n",
+    "<center>Fig. 5.4. Quench heaters topology for D3</center>\n",
+    "<img src=\"figures/ipd/QH_powering_D3.png\" width=50%>\n",
+    "<center>Fig. 5.5. Quench heaters powering for D3</center>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "|Type|Test|Current|Description|Notebook|Example report|\n",
+    "|----|----|-------|-----------|--------|--------------|\n",
+    "|Operation|FPA|I\\_PNO|FPA during operation with magnets quenching|[AN\\_IPD\\_FPA](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/ipd/AN_IPD_FPA.ipynb)|-|"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -292,7 +470,17 @@
     "\n",
     "### Notebook Output\n",
     "\n",
-    "The notebook creates three output files in the folder //cern.ch/eos/project/l/lhcsm/operation/RB/circuit_name/\\*}, e.g., //cern.ch/eos/project/l/lhcsm/operation/RB/RB.A12/\\*:\n",
+    "\n",
+    "\n",
+    "The notebook creates three output files in the folder (path with Windows convention)\n",
+    "```\n",
+    "\\\\cernbox-smb\\eos\\project\\l\\operation\\$circuit_type$\\$circuit_name$\\\n",
+    "```\n",
+    "e.g., \n",
+    "```\n",
+    "\\\\cernbox-smb\\eos\\project\\l\\lhcsm\\operation\\RB\\RB.A12\\\n",
+    "```\n",
+    "\n",
     "- HTML report file with the snapshot of the entire notebook - [fgc-timestamp]-[analysis-execution-date]-[notebook-name]\\_report.html;\n",
     "- CSV file with MP3 results table with a subset analysis results - [fgc-timestamp]-[analysis-execution-date]-[notebook-name]\\_mp3\\_results\\_table.csv};\n",
     "- CSV file with full results table - [fgc-timestamp]-[analysis-execution-date]-[notebook-name]\\_results_table.csv};\n"
@@ -319,13 +507,13 @@
     "\n",
     "## Notebook Output\n",
     "\n",
-    "The notebook creates three output files in the folder \n",
+    "The notebook creates three output files in the folder (path with Windows convention)\n",
     "```\n",
-    "//cern.ch/eos/project/l/lhcsm/hwc/RB/ circuit_name/hwc_test/hwc_campaign/*, \n",
+    "\\\\cernbox-smb\\eos\\project\\l\\lhcsm\\hwc\\$circuit_type$\\$circuit_name$\\$hwc_test$\\$hwc_campaign$\\, \n",
     "```\n",
     "e.g., \n",
     "```\n",
-    "//cern.ch/eos/project/l/lhcsm/hwc/ RB/RB.A12/PNO.b2/HWC_2014/*:\n",
+    "\\\\cernbox-smb\\eos\\project\\l\\lhcsm\\hwc\\RB\\RB.A12\\PNO.b2\\HWC_2014\\:\n",
     "```\n",
     "\n",
     "- HTML report file with the snapshot of the entire notebook - [test-start]-[test-end]\\_report.html;\n"

README.md

@@ -97,7 +97,7 @@ The main quadrupole magnet circuits of the 8 Inner Triplet (IT) systems in the L
 <img src="https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/raw/master/figures/it/IT.png" width=75%>
 Main quadrupole magnet circuit of the Inner Triplet system for IT’s at points 1 and 5 (left) and IT’s at points 2 and 8 (right).
 
-Note that the configuration for the IT’s in points 1 and 5 is different from the configuration in points 2 and 8. An earth detection system is present at the minus of the RTQX2 converter. Detailed information concerning the converters is given in EDMS 1054483.
+Note that the configuration for the IT’s in points 1 and 5 is different from the configuration in points 2 and 8. An earth detection system is present at the minus of the RTQX2 converter. Detailed information concerning the converters is given in EDMS 1054483. 
 
 The two magnets Q1 and Q3 are type MQXA and the two combined magnets Q2a and Q2b are type MQXB. Q1 is located towards the interaction point.
 
@@ -121,11 +121,11 @@ source: Test Procedure and Acceptance Criteria for the Inner Triplet Circuits in
 |HWC|PIC|~|Powering Interlock Controller check with standby current|AN\_IT\_PIC|-|
 |HWC|PNO.D12|10% of I\_PNO|Powering Failure at +10% of nominal current|AN\_IT\_PNO.D12|-|
 |HWC|PNO.D13|10% of I\_PNO|Powering Failure at -10% of nominal current|AN\_IT\_PNO.D13|-|
-|HWC|PLI3.F6|I_PLI3|Heater Discharge Request at 2nd intermediate current (Note that I\_RTQX1=0A|AN\_IT\_PNO.F6|-|
-|HWC|PNO.D14|50% of I\_PNO|Powering Failure at +50% of nominal current during a SPA|AN\_IT\_PNO.D14|-|
+|HWC|PLI3.F6|I_PLI3|Heater Discharge Request at 2nd intermediate current (Note that I\_RTQX1=0A|[AN\_IT\_PLI3.F6](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PLI3.F6.ipynb)|-|
+|HWC|PNO.D14|50% of I\_PNO|Powering Failure at +50% of nominal current during a SPA|[AN\_IT\_PNO.D14](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PNO.D14.ipynb)|-|
 |HWC|PNO.D15|50% of I\_PNO|Powering Failure at -50% of nominal current|AN\_IT\_PNO.D15|-|
-|HWC|PNO.A9|I\_PNO+I\_DELTA|Training and plateau at nominal current|AN\_IT\_PNO.A9|-|
-|HWC|PNO.D16|90% of I\_PNO|Powering Failure at +90% of nominal current|AN\_IT\_PNO.D16|-|
+|HWC|PNO.A9|I\_PNO+I\_DELTA|Training and plateau at nominal current|[AN\_IT\_PNO.A9](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PNO.A9.ipynb)|-|
+|HWC|PNO.D16|90% of I\_PNO|Powering Failure at +90% of nominal current|[AN\_IT\_PNO.D16](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_PNO.D16.ipynb)|-|
 |HWC|PNO.D17|90% of I\_PNO|Powering Failure at -90% of nominal current|AN\_IT\_PNO.D17|-|
 |Operation|FPA|I\_PNO|FPA during operation with magnets quenching|[AN\_IT\_FPA](https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/blob/master/it/AN_IT_FPA.ipynb)|-|
 
@@ -267,7 +267,17 @@ The RQ analysis notebook follows the same structure except for the lack of schem
 
 ### Notebook Output
 
-The notebook creates three output files in the folder //cern.ch/eos/project/l/lhcsm/operation/RB/circuit_name/\*}, e.g., //cern.ch/eos/project/l/lhcsm/operation/RB/RB.A12/\*:
+
+
+The notebook creates three output files in the folder (path with Windows convention)
+```
+\\cernbox-smb\eos\project\l\operation\$circuit_type$\$circuit_name$\
+```
+e.g., 
+```
+\\cernbox-smb\eos\project\l\lhcsm\operation\RB\RB.A12\
+```
+
 - HTML report file with the snapshot of the entire notebook - [fgc-timestamp]-[analysis-execution-date]-[notebook-name]\_report.html;
 - CSV file with MP3 results table with a subset analysis results - [fgc-timestamp]-[analysis-execution-date]-[notebook-name]\_mp3\_results\_table.csv};
 - CSV file with full results table - [fgc-timestamp]-[analysis-execution-date]-[notebook-name]\_results_table.csv};
@@ -290,13 +300,13 @@ The remainder of each notebook depends on the particular test to be performed. A
 
 ## Notebook Output
 
-The notebook creates three output files in the folder 
+The notebook creates three output files in the folder (path with Windows convention)
 ```
-//cern.ch/eos/project/l/lhcsm/hwc/RB/ circuit_name/hwc_test/hwc_campaign/*, 
+\\cernbox-smb\eos\project\l\lhcsm\hwc\$circuit_type$\$circuit_name$\$hwc_test$\$hwc_campaign$\, 
 ```
 e.g., 
 ```
-//cern.ch/eos/project/l/lhcsm/hwc/ RB/RB.A12/PNO.b2/HWC_2014/*:
+\\cernbox-smb\eos\project\l\lhcsm\hwc\RB\RB.A12\PNO.b2\HWC_2014\:
 ```
 
 - HTML report file with the snapshot of the entire notebook - [test-start]-[test-end]\_report.html;

ipd/AN_IPD_FPA.ipynb

+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

ipd/IPD_Run2.txt

+,Circuit name,Date,Time,Status
+RD2.R8,31/01/2015,08:45:08,
+RD2.R8,31/01/2015,16:51:10,
+RD2.R2,31/01/2015,10:06:31,
+RD2.L1,10/02/2015,20:52:00,
+RD1.R2,10/02/2015,21:55:16,
+RD1.L2,15/02/2015,08:00:22,
+RD2.R1,14/02/2015,17:38:22,
+RD2.L8,15/02/2015,10:24:41,
+RD2.L1,14/02/2015,08:25:38,
+RD2.L2,27/02/2015,08:17:58,
+RD4.L4,27/02/2015,20:46:40,
+RD3.L4,28/02/2015,07:59:06,
+RD3.L4,28/02/2015,12:23:47,
+RD4.L4,28/02/2015,14:22:45,
+RD1.R8,28/02/2015,16:19:30,
+RD3.L4,28/02/2015,21:09:40,
+RD4.R4,07/03/2015,01:48:29,
+RD2.L5,15/03/2015,08:15:58,
+RD4.R4,09/03/2015,23:23:14,
+RD2.R5,10/03/2015,17:00:20,
+RD2.R8,25/04/2015,04:46:41,
+RD2.L5,15/06/2015,14:28:29,
+RD2.L1,15/06/2015,14:28:29,
+RD2.R5,15/06/2015,14:28:29,
+RD4.R4,06/03/2016,10:53:39,
+RD2.R8,29/04/2016,05:32:16,
+RD2.R5,08/08/2017,13:42:07,
+RD2.L8,03/12/2018,13:13:07,
+RD3.R4,03/12/2018,13:59:59,
\ No newline at end of file

it/AN_IT_PLI3.F6.ipynb

@@ -32,10 +32,12 @@
     "### PLI3.F6: RQX and RTQX2, Heater Discharge Request\n",
     "The aim of this test is to check the performance of the QPS system during a heater induced quench. In 2-converter configuration the test is done with current in the RQX and RTQX2 converters, while the RTQX1 converter is not connected, but turned ON in voltage mode. In 3-converter configuration the RTQX1 converter is connected but not powered, see figures below.\n",
     "\n",
-    "<img src=\"../figures/it/PLI3.F6_current_pcs.png\" width=75%>\n",