Skip to content

GitLab

Commit 30e1e7dd authored by Agata Malgorzata Chadaj's avatar Agata Malgorzata Chadaj
Browse files

Merge branch 'dev' of https://gitlab.cern.ch/LHCData/lhc-sm-hwc into... 

Merge branch 'dev' of https://gitlab.cern.ch/LHCData/lhc-sm-hwc into SIGMON-216_implement_first_notebook_with_the_analysis_result
parents cd7336fa 9fbedc59
Pipeline #3167967 passed with stage
in 26 seconds
Expand all Hide whitespace changes
Inline Side-by-side
600A/AN_600A_RCBXHV_FPA.ipynb
View file @ 30e1e7dd
%% Cell type:markdown id: tags:
<h1><center>Analysis of an FPA in an 600A Circuit - RCBX Family</center></h1>
Figure below shows a generic circuit diagram, equipped with EE and parallel resistor, as well as lead resistances and a quench resistance.
<img src="https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/raw/master/figures/600A/600A_without_EE.png" width=75%>
source: Test Procedure and Acceptance Criteria for the 600 A Circuits, MP3 Procedure, <a href="https://edms.cern.ch/document/874716">https://edms.cern.ch/document/874716</a>
%% Cell type:markdown id: tags:
# Analysis Assumptions
- We consider standard analysis scenarios, i.e., all signals can be queried. Depending on what signal is missing, an analysis can raise a warning and continue or an error and abort the analysis.
- It is recommended to execute each cell one after another. However, since the signals are queried prior to an analysis, any order of execution is allowed. In case an analysis cell is aborted, the following ones may not be executed (e.g. I\_MEAS not present).
# Plot Convention
- Scales are labeled with signal name followed by a comma and a unit in the square bracket, e.g., I_MEAS, [A]
- If a reference signal is present, it is represented with a dashed line
- If the main current is present, its axis is on the left. Remaining signals are attached to the axis on the right. The legend of these signals is located on the lower left and upper right, respectively.
- The grid comes from the left axis
- Title contains timestamp, circuit name, signal name allowing for re-access the signal.
- The plots assigned to the left scale got colors: blue (C0) and orange (C1). Plots presented on the right have colors red (C2) and green (C3).
- Each plot has an individual time-synchronization mentioned explicitly in the description.
- If an axis has a single signal, change color of the label to match the signal's color. Otherwise, the label color is black.
%% Cell type:markdown id: tags:
# 0. Initialise Working Environment
%% Cell type:code id: tags:
``` python
# External libraries
print('Loading (1/15)'); import pandas as pd
print('Loading (2/15)'); import numpy as np
print('Loading (3/15)'); import sys
print('Loading (4/15)'); from IPython.display import display, Javascript, clear_output, HTML
print('Loading (1/16)'); import pandas as pd
print('Loading (2/16)'); import numpy as np
print('Loading (3/16)'); import sys
print('Loading (4/16)'); from IPython.display import display, Javascript, clear_output, HTML
# Internal libraries
print('Loading (5/15)'); import lhcsmapi
print('Loading (6/15)'); from lhcsmapi.Time import Time
print('Loading (7/15)'); from lhcsmapi.Timer import Timer
print('Loading (8/15)'); from lhcsmapi.analysis.R600ACircuitQuery import R600ACircuitQuery
print('Loading (9/15)'); from lhcsmapi.analysis.R600ACircuitAnalysis import R600ACircuitAnalysis
print('Loading (10/15)'); from lhcsmapi.analysis.expert_input import get_expert_decision
print('Loading (11/15)'); from lhcsmapi.analysis.report_template import apply_report_template
print('Loading (12/15)'); from lhcsmapi.gui.DateTimeBaseModule import DateTimeBaseModule
print('Loading (13/15)'); from lhcsmapi.gui.pc.FgcPmSearchModuleMediator import FgcPmSearchModuleMediator
print('Loading (14/15)'); from lhcsmapi.metadata.SignalMetadata import SignalMetadata
print('Loading (15/15)'); from lhcsmnb.parameters import are_all_parameters_injected, NbType
print('Loading (5/16)'); import lhcsmapi
print('Loading (6/16)'); from lhcsmapi.Time import Time
print('Loading (7/16)'); from lhcsmapi.Timer import Timer
print('Loading (8/16)'); from lhcsmapi.analysis.R600ACircuitQuery import R600ACircuitQuery
print('Loading (9/16)'); from lhcsmapi.analysis.R600ACircuitAnalysis import R600ACircuitAnalysis
print('Loading (10/16)'); from lhcsmapi.analysis.expert_input import get_expert_decision
print('Loading (11/16)'); from lhcsmapi.analysis.report_template import apply_report_template
print('Loading (12/16)'); from lhcsmapi.gui.DateTimeBaseModule import DateTimeBaseModule
print('Loading (13/16)'); from lhcsmapi.gui.pc.FgcPmSearchModuleMediator import FgcPmSearchModuleMediator
print('Loading (14/16)'); from lhcsmapi.metadata.SignalMetadata import SignalMetadata
print('Loading (15/16)'); from lhcsmnb.parameters import are_all_parameters_injected, NbType
print('Loading (16/16)'); import lhcsmnb.utils
clear_output()
lhcsmapi.get_lhcsmapi_version()
lhcsmapi.get_lhcsmhwc_version('../__init__.py')
```
%% Cell type:markdown id: tags:
# 1. Select FGC Post Mortem Entry
%% Cell type:markdown id: tags:skip_cell
In order to perform the analysis of a FPA in an RCD/O 600A circuit please:
1. Select circuit name (e.g., RC.A12B1)
2. Choose start and end time
3. Choose analysis mode (Automatic by default)
Once these inputs are provided, click 'Find FGC PM entries' button. This will trigger a search of the PM database in order to provide a list of timestamps of FGC events associated with the selected circuit name for the provided period of time. Select one timestamp from the 'FGC PM Entries' list to be processed by the following cells.
**Note that 24 hours is the maximum duration of a single PM query for an event. To avoid delays in querying events, please restrict your query duration as much as possible.**
%% Cell type:code id: tags:parameters
``` python
fgc_pm_search = FgcPmSearchModuleMediator(DateTimeBaseModule(start_date_time='2021-01-26 00:00:00+01:00',
end_date_time='2021-01-31 00:00:00+01:00'), circuit_type='600A_RCBXHV')
```
%% Cell type:markdown id: tags:
# 2. Query All Signals Prior to Analysis
%% Cell type:code id: tags:skip_output
``` python
with Timer():
if not are_all_parameters_injected(NbType.FGC2, locals()):
author = fgc_pm_search.get_author()
is_automatic = fgc_pm_search.is_automatic_mode()
circuit_type = '600A'
circuit_names = fgc_pm_search.get_fgc_circuit()
timestamps_fgc = fgc_pm_search.get_fgc_timestamp()
timestamp_fgc_rcbxh, timestamp_fgc_rcbxv = timestamps_fgc
query_rcbxh = R600ACircuitQuery(circuit_type, circuit_names[0], max_executions=9)
query_rcbxv = R600ACircuitQuery(circuit_type, circuit_names[1], max_executions=9)
# RCBXH
i_meas_rcbxh_df, i_a_rcbxh_df, i_ref_rcbxh_df, i_earth_rcbxh_df = query_rcbxh.query_pc_pm(timestamp_fgc_rcbxh, timestamp_fgc_rcbxh, signal_names=['I_MEAS', 'I_A', 'I_REF', 'I_EARTH'])
events_action_rcbxh_df, events_symbol_rcbxh_df = query_rcbxh.query_pc_pm_events(timestamp_fgc_rcbxh, signal_names=['ACTION', 'SYMBOL'])
# RCBXV
i_meas_rcbxv_df, i_a_rcbxv_df, i_ref_rcbxv_df, i_earth_rcbxv_df = query_rcbxv.query_pc_pm(timestamp_fgc_rcbxv, timestamp_fgc_rcbxv, signal_names=['I_MEAS', 'I_A', 'I_REF', 'I_EARTH'])
events_action_rcbxv_df, events_symbol_rcbxv_df = query_rcbxv.query_pc_pm_events(timestamp_fgc_rcbxv, signal_names=['ACTION', 'SYMBOL'])
# PIC
# # RCBXH
timestamp_pic_rcbxh = query_rcbxh.find_timestamp_pic(timestamp_fgc_rcbxh, spark=spark)
# # RCBXV
timestamp_pic_rcbxv = query_rcbxv.find_timestamp_pic(timestamp_fgc_rcbxv, spark=spark)
# QDS NXCALS - To check if there was any drift of QDS cards prior to the trigger
# # RCBXH
i_meas_nxcals_rcbxh_df = query_rcbxh.query_pc_nxcals(timestamp_fgc_rcbxh, signal_names=['I_MEAS'], spark=spark)[0]
u_res_nxcals_rcbxh_df = query_rcbxh.query_iqps_nxcals(timestamp_fgc_rcbxh, signal_names=['U_RES'], spark=spark)[0]
# # RCBXV
i_meas_nxcals_rcbxv_df = query_rcbxv.query_pc_nxcals(timestamp_fgc_rcbxv, signal_names=['I_MEAS'], spark=spark)[0]
u_res_nxcals_rcbxv_df = query_rcbxv.query_iqps_nxcals(timestamp_fgc_rcbxv, signal_names=['U_RES'], spark=spark)[0]
# QDS PM
# # RCBXH
source_timestamp_qds_rcbxh_df = query_rcbxh.find_source_timestamp_qds_board_ab(timestamp_fgc_rcbxh, duration=[(2, 's'), (2, 's')])
timestamp_qds_rcbxh = np.nan if source_timestamp_qds_rcbxh_df.empty else source_timestamp_qds_rcbxh_df.loc[0, 'timestamp']
timestamp_qds_rcbxh = lhcsmnb.utils.get_at(source_timestamp_qds_rcbxh_df, 0, 'timestamp', default=np.nan)
i_dcct_rcbxh_df, i_didt_rcbxh_df, u_res_rcbxh_df, u_diff_rcbxh_df = query_rcbxh.query_qds_pm(timestamp_qds_rcbxh, timestamp_qds_rcbxh, signal_names=['I_DCCT', 'I_DIDT', 'U_RES', 'U_DIFF'])
# # RCBXV
source_timestamp_qds_rcbxv_df = query_rcbxv.find_source_timestamp_qds_board_ab(timestamp_fgc_rcbxv, duration=[(2, 's'), (2, 's')])
timestamp_qds_rcbxv = np.nan if source_timestamp_qds_rcbxv_df.empty else source_timestamp_qds_rcbxv_df.loc[0, 'timestamp']
timestamp_qds_rcbxv = lhcsmnb.utils.get_at(source_timestamp_qds_rcbxv_df, 0, 'timestamp', default=np.nan)
i_dcct_rcbxv_df, i_didt_rcbxv_df, u_res_rcbxv_df, u_diff_rcbxv_df = query_rcbxv.query_qds_pm(timestamp_qds_rcbxv, timestamp_qds_rcbxv, signal_names=['I_DCCT', 'I_DIDT', 'U_RES', 'U_DIFF'])
# LEADS
# # RCBXH
leads_name = [x for x in SignalMetadata.get_system_types_per_circuit_name(circuit_type, circuit_names[0]) if 'LEADS' in x][0]
source_timestamp_leads_rcbxh_df = query_rcbxh.find_timestamp_leads(timestamp_fgc_rcbxh, leads_name)
u_hts_leads_rcbxh_dfs = query_rcbxh.query_leads(timestamp_fgc_rcbxh, source_timestamp_leads_rcbxh_df, system=leads_name, signal_names=['U_HTS'], spark=spark, duration=[(300, 's'), (900, 's')])
u_res_leads_rcbxh_dfs = query_rcbxh.query_leads(timestamp_fgc_rcbxh, source_timestamp_leads_rcbxh_df, system=leads_name, signal_names=['U_RES'], spark=spark, duration=[(300, 's'), (900, 's')])
# # RCBXV
leads_name = [x for x in SignalMetadata.get_system_types_per_circuit_name(circuit_type, circuit_names[1]) if 'LEADS' in x][0]
source_timestamp_leads_rcbxv_df = query_rcbxv.find_timestamp_leads(timestamp_fgc_rcbxv, leads_name)
u_hts_leads_rcbxv_dfs = query_rcbxv.query_leads(timestamp_fgc_rcbxv, source_timestamp_leads_rcbxv_df, system=leads_name, signal_names=['U_HTS'], spark=spark, duration=[(300, 's'), (900, 's')])
u_res_leads_rcbxv_dfs = query_rcbxv.query_leads(timestamp_fgc_rcbxv, source_timestamp_leads_rcbxv_df, system=leads_name, signal_names=['U_RES'], spark=spark, duration=[(300, 's'), (900, 's')])
# Create results table - RCBXH/V
results_table = query_rcbxh.create_report_analysis_template_rcbx(timestamp_fgc_rcbxh, timestamp_fgc_rcbxv, '../__init__.py', circuit_names, author=author)
analysis_rcbxh = R600ACircuitAnalysis(circuit_type, results_table, is_automatic=is_automatic)
analysis_rcbxv = R600ACircuitAnalysis(circuit_type, results_table, is_automatic=is_automatic)
```
%% Cell type:markdown id: tags:
# 3. Timestamps
The analysis for MP3 consists of checking the existence of PM file and of consistency of the PM timestamps (PC, QPS). The criterion of passing this test described in detail in 600APIC2.
In short the following criteria should be checked:
- 2 PM DQAMGNA (A+B) files and 1 PM EE file should be generated for 600 A circuits with EE
- Difference between QPS board A and B timestamp = 1 ms
- PC timestamp is QPS timestamp +/- 20 ms
If one or more of these conditions are not fulfilled, then an in-depth analysis has to be performed by the QPS team.
%% Cell type:code id: tags:
``` python
timestamp_dct = {'FGC_RCBXH': timestamp_fgc_rcbxh, 'FGC_RCBXV': timestamp_fgc_rcbxv,
'PIC_RCBXH': timestamp_pic_rcbxh, 'PIC_RCBXV': timestamp_pic_rcbxv,
'QDS_A_RCBXH':source_timestamp_qds_rcbxh_df.loc[0, 'timestamp'] if len(source_timestamp_qds_rcbxh_df) > 0 else np.nan,
'QDS_B_RCBXH':source_timestamp_qds_rcbxh_df.loc[1, 'timestamp'] if len(source_timestamp_qds_rcbxh_df) > 1 else np.nan,
'QDS_A_RCBXV':source_timestamp_qds_rcbxv_df.loc[0, 'timestamp'] if len(source_timestamp_qds_rcbxv_df) > 0 else np.nan,
'QDS_B_RCBXV':source_timestamp_qds_rcbxv_df.loc[1, 'timestamp'] if len(source_timestamp_qds_rcbxv_df) > 1 else np.nan}
'QDS_A_RCBXH':lhcsmnb.utils.get_at(source_timestamp_qds_rcbxh_df, 0, 'timestamp', default=np.nan),
'QDS_B_RCBXH':lhcsmnb.utils.get_at(source_timestamp_qds_rcbxh_df, 1, 'timestamp', default=np.nan),
'QDS_A_RCBXV':lhcsmnb.utils.get_at(source_timestamp_qds_rcbxv_df, 0, 'timestamp', default=np.nan),
'QDS_B_RCBXV':lhcsmnb.utils.get_at(source_timestamp_qds_rcbxv_df, 1, 'timestamp', default=np.nan)}
analysis_rcbxh.create_timestamp_table(timestamp_dct, circuit_name=circuit_names[0])
```
%% Cell type:markdown id: tags:
# 4. PC
## 4.1. Main Current
*ANALYSIS*:
- determination of the source of an FPA trigger based on EVENTS.SYMBOL and EVENTS.ACTION signals
- detection of the start of a quench as a deviation of I_A and I_REF
- calculation of the MIITs
- calculation of the quench current
- calculation of the duration of a plateau / the ramp rate before a quench (based on PM event buffer)
**You may manually adjust the automatically calculated quench start by clicking the right button on a mouse of a plot with current zoom.**
*GRAPHS*:
- dashed blue line denotes the start of a quench (I_A starts to deviate from I_REF)
- t = 0 s corresponds to the FGC timestamp
%% Cell type:code id: tags:
``` python
import matplotlib as mpl
mpl.rcParams['savefig.dpi'] = 80
mpl.rcParams['figure.dpi'] = 80
%matplotlib notebook
analysis_rcbxh.plot_coupled_circuit_current(i_meas_rcbxh_df, i_ref_rcbxh_df, i_meas_rcbxv_df, i_ref_rcbxv_df, timestamp_fgc_rcbxh, timestamp_fgc_rcbxv, circuit_names)
```
%% Cell type:code id: tags:
``` python
analysis_rcbxh.plot_i_meas_pc(circuit_names[0], timestamp_fgc_rcbxh, [i_meas_rcbxh_df, i_a_rcbxh_df, i_ref_rcbxh_df])
```
%% Cell type:code id: tags:
``` python
t_quench = analysis_rcbxh.estimate_quench_start_from_i_ref_i_a(i_ref_rcbxh_df, i_a_rcbxh_df)
t_quench = 0 if t_quench is None else t_quench
t_quench_correction = analysis_rcbxh.plot_i_meas_pc_with_cursor(circuit_names[0], timestamp_fgc_rcbxh, [i_meas_rcbxh_df, i_a_rcbxh_df, i_ref_rcbxh_df], t_quench)
```
%% Cell type:code id: tags:
``` python
t_quench = analysis_rcbxh.choose_quench_time_from_auto_or_manual(t_quench_correction)
analysis_rcbxh.analyze_i_meas_pc_trigger(timestamp_fgc_rcbxh, events_action_rcbxh_df, events_symbol_rcbxh_df)
analysis_rcbxh.calculate_current_miits_i_meas_i_a(i_meas_rcbxh_df, i_a_rcbxh_df, t_quench, col_name='MIITS_H')
analysis_rcbxh.calculate_quench_current(i_meas_rcbxh_df, t_quench, col_name='I_Q_H')
analysis_rcbxh.calculate_current_slope(i_meas_rcbxh_df, col_name=['Ramp rate H', 'Plateau duration H'])
```
%% Cell type:code id: tags:
``` python
analysis_rcbxv.plot_i_meas_pc(circuit_names[1], timestamp_fgc_rcbxv, [i_meas_rcbxv_df, i_a_rcbxv_df, i_ref_rcbxv_df])
```
%% Cell type:code id: tags:
``` python
t_quench = analysis_rcbxv.estimate_quench_start_from_i_ref_i_a(i_ref_rcbxv_df, i_a_rcbxv_df)
t_quench = 0 if t_quench is None else t_quench
t_quench_correction = analysis_rcbxv.plot_i_meas_pc_with_cursor(circuit_names[1], timestamp_fgc_rcbxv, [i_meas_rcbxv_df, i_a_rcbxv_df, i_ref_rcbxv_df], t_quench)
```
%% Cell type:code id: tags:
``` python
t_quench = analysis_rcbxv.choose_quench_time_from_auto_or_manual(t_quench_correction)
analysis_rcbxv.analyze_i_meas_pc_trigger(timestamp_fgc_rcbxv, events_action_rcbxv_df, events_symbol_rcbxv_df)
analysis_rcbxv.calculate_current_miits_i_meas_i_a(i_meas_rcbxv_df, i_a_rcbxv_df, t_quench, col_name='MIITS_V')
analysis_rcbxv.calculate_quench_current(i_meas_rcbxv_df, t_quench, col_name='I_Q_V')
analysis_rcbxv.calculate_current_slope(i_meas_rcbxv_df, col_name=['Ramp rate V', 'Plateau duration V'])
```
%% Cell type:code id: tags:
``` python
analysis_rcbxh.results_table[['Circuit Name', 'Date (FGC)', 'Time (FGC)', 'I_Q_H', 'I_Q_V', 'MIITS_H', 'MIITS_V', 'Ramp rate H', 'Ramp rate V', 'Plateau duration H', 'Plateau duration V']]
```
%% Cell type:markdown id: tags:
### 4.1.1 Angle Calculation
%% Cell type:code id: tags:
``` python
analysis_rcbxv.compute_and_print_current_angle_for_combined_powering()
```
%% Cell type:markdown id: tags:
## 4.2. Earth Current
*ANALYSIS*:
- calculation of the maximum absolute earth current (maintaining the sign)
*GRAPHS*:
- t = 0 s corresponds to the FGC timestamp
%% Cell type:code id: tags:
``` python
analysis_rcbxh.plot_i_earth_pc(circuit_names[0], timestamp_fgc_rcbxh, i_earth_rcbxh_df)
analysis_rcbxh.calculate_max_i_earth_pc(i_earth_rcbxh_df, col_name='I_Earth_max_H')
```
%% Cell type:code id: tags:
``` python
analysis_rcbxv.plot_i_earth_pc(circuit_names[1], timestamp_fgc_rcbxv, i_earth_rcbxv_df)
analysis_rcbxv.calculate_max_i_earth_pc(i_earth_rcbxv_df, col_name='I_Earth_max_V')
```
%% Cell type:markdown id: tags:
# 5. QDS
The quench voltage U_RES is calculated according to the following formula:
\begin{equation}
U_{\text{RES}} = U_{\text{DIFF}} + L d/dt (I+U_{\text{DIFF}}/R).
\end{equation}
Note that I_DCCT is the QPS signal name, even though the current is actually measured not with a DCCT, but with a LEM detector, hence the poorer quality w.r.t. to the FGC I_A/B/MEAS signals that are measured with a DCCT.
It can be seen from the sign convention in the figure below that a resistive voltage always has opposite sign to the measured current.
<img src="https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/raw/master/figures/600A/600A_without_EE.png" width=75%>
As U_DIFF contributes directly to U_RES, the resolution of U_RES is, at least partially, limited by that of U_DIFF. Moreover, U_RES is affected by the noisy time derivative of the current signal.
The QPS signals that are communicated to the post-mortem system have only 12 bit resolution.
## 5.1. Resistive Voltage
*ANALYSIS*:
- Check if the U_RES signal before a quench is increasing for at least one board, which would indicate a QPS trip
- Calculate the initial voltage slope of U_RES signal. The slope is calculated as a ratio of the voltage change from 50 to 200 mV and the corresponding time change.
*GRAPHS*:
First plot (U_RES and I_MEAS prior to a quench)
- t = 0 s corresponds to the FGC timestamp
Second plot (U_RES and the initial slope of U_RES)
- t = 0 s corresponds to the QPS timestamp
%% Cell type:code id: tags:
``` python
analysis_rcbxh.plot_u_res(circuit_names[0], timestamp_qds_rcbxh, u_res_nxcals_rcbxh_df, i_meas_nxcals_rcbxh_df)
```
%% Cell type:code id: tags:
``` python
u_res_rcbxh_slope_df = analysis_rcbxh.calculate_u_res_slope(u_res_rcbxh_df, col_name='dU_QPS/dt_H')
analysis_rcbxh.plot_u_res_slope(circuit_names[0], timestamp_qds_rcbxh, u_res_rcbxh_df, u_res_rcbxh_slope_df)
```
%% Cell type:code id: tags:
``` python
analysis_rcbxv.plot_u_res(circuit_names[1], timestamp_qds_rcbxv, u_res_nxcals_rcbxv_df, i_meas_nxcals_rcbxv_df)
```
%% Cell type:code id: tags:
``` python
u_res_rcbxv_slope_df = analysis_rcbxv.calculate_u_res_slope(u_res_rcbxv_df, col_name='dU_QPS/dt_V')
analysis_rcbxv.plot_u_res_slope(circuit_names[1], timestamp_qds_rcbxv, u_res_rcbxv_df, u_res_rcbxv_slope_df)
```
%% Cell type:code id: tags:
``` python
analysis_rcbxh.results_table[['Circuit Name', 'Date (FGC)', 'Time (FGC)', 'dU_QPS/dt_H', 'dU_QPS/dt_V']]
```
%% Cell type:markdown id: tags:
## 5.2. I_DCCT, I_DIDT Currents; U_RES, U_DIFF Voltages
*ANALYSIS*
- Check the integrity of all four signals (U_DIFF, I_DCCT, I_DIDT and U_RES). If one of the signals (especially U_DIFF or I_DCCT) stays at zero or shows wrong values the cabling of this quench detector could have issues. Compare U_DIFF (measured signal) to U_REF (signal compensated for inductive voltage).
*CRITERIA*
- U_RES < 0.7*100 mV
- noise of U_RES on the plateaus < 20mV
*GRAPHS*:
- t = 0 s corresponds to the QPS timestamp
%% Cell type:code id: tags:
``` python
analysis_rcbxh.plot_qds(circuit_names[0], timestamp_qds_rcbxh, i_dcct_rcbxh_df, i_didt_rcbxh_df, u_diff_rcbxh_df, u_res_rcbxh_df)
```
%% Cell type:code id: tags:
``` python
analysis_rcbxv.plot_qds(circuit_names[1], timestamp_qds_rcbxv, i_dcct_rcbxv_df, i_didt_rcbxv_df, u_diff_rcbxv_df, u_res_rcbxv_df)
```
%% Cell type:markdown id: tags:
## 5.3. LEADS
*ANALYSIS*:
- check if U_HTS for 2 consecutive datapoints is above the threshold 3 mV
- check if U_RES for 2 consecutive datapoints is above the threshold 160 mV
*GRAPHS*:
- t = 0 s corresponds to the FGC timestamp
%% Cell type:code id: tags:
``` python
analysis_rcbxh.analyze_leads_voltage(u_hts_leads_rcbxh_dfs, circuit_names[0], timestamp_fgc_rcbxh, signal='U_HTS', value_min=-0.003, value_max=0.003)
```
%% Cell type:code id: tags:
``` python
analysis_rcbxh.analyze_leads_voltage(u_res_leads_rcbxh_dfs, circuit_names[0], timestamp_fgc_rcbxh, signal='U_RES', value_min=-0.16, value_max=0.16)
```
%% Cell type:code id: tags:
``` python
analysis_rcbxv.analyze_leads_voltage(u_hts_leads_rcbxv_dfs, circuit_names[1], timestamp_fgc_rcbxv, signal='U_HTS', value_min=-0.003, value_max=0.003)
```
%% Cell type:code id: tags:
``` python
analysis_rcbxv.analyze_leads_voltage(u_res_leads_rcbxv_dfs, circuit_names[1], timestamp_fgc_rcbxv, signal='U_RES', value_min=-0.16, value_max=0.16)
```
%% Cell type:code id: tags:
``` python
if not is_automatic:
analysis_rcbxh.results_table['FPA Reason'] = get_expert_decision('Reason for FPA: ', ['QPS trip', 'Converter trip', 'EE spurious opening', 'Spurious heater firing', 'Busbar quench', 'Magnet quench', 'HTS current lead quench' ,'RES current lead overvoltage', 'No quench', 'Unknown'])
analysis_rcbxh.results_table['Type of Quench'] = get_expert_decision('Type of Quench: ', ['Training', 'Heater-provoked', 'Beam-induced', 'GHe propagation', 'QPS crate reset', 'Single Event Upset' ,'Short-to-ground', 'EM disturbance', 'No quench', 'Unknown'])
analysis_rcbxh.results_table['QDS trigger origin'] = get_expert_decision('QDS trigger origin: ', ['QPS', 'HTS current lead', 'RES current lead', 'Busbar', 'No quench'])
analysis_rcbxh.results_table['Quench origin'] = get_expert_decision('Quench origin: ', ['H', 'V'])
```
%% Cell type:markdown id: tags:
# 6. Analysis Comment
%% Cell type:code id: tags:
``` python
if not is_automatic:
analysis_rcbxh.results_table['Comment'] = input('Comment: ')
```
%% Cell type:markdown id: tags:ignore
# 7. Final Report
%% Cell type:code id: tags:ignore
``` python
pd.set_option('display.max_columns', None)
pd.set_option('display.max_rows', None)
circuit_name = circuit_names[0]
analysis_start_time = Time.get_analysis_start_time()
timestamp_fgc = timestamp_fgc_rcbxh if not np.isnan(timestamp_fgc_rcbxh) else timestamp_fgc_rcbxv
date_time_fgc = Time.to_datetime(timestamp_fgc).strftime("%Y-%m-%d-%Hh%M")
prefix_circuit_name = SignalMetadata.parse_600A_circuit_name_to_family_name(circuit_name)
circuit_name_rcbx = circuit_name.replace('RCBXH', 'RCBX') if 'RCBXH' in circuit_name else circuit_name.replace('RCBXV', 'RCBX')
!mkdir -p /eos/project/m/mp3/600A/$prefix_circuit_name/$circuit_name_rcbx/FPA
file_name = "{}_FPA-{}-{}".format(circuit_name_rcbx, date_time_fgc, analysis_start_time)
full_path = '/eos/project/m/mp3/600A/{}/{}/FPA/{}.csv'.format(prefix_circuit_name, circuit_name_rcbx, file_name)
mp3_results_table = analysis_rcbxh.create_mp3_results_table_rcbxhv()
display(HTML(mp3_results_table.T.to_html()))
mp3_results_table.to_csv(full_path, index=False)
print('MP3 results table saved to (Windows): ' + '\\\\cernbox-smb' + full_path.replace('/', '\\'))
apply_report_template()
full_path = '/eos/project/m/mp3/600A/{}/{}/FPA/{}.html'.format(prefix_circuit_name, circuit_name_rcbx, file_name)
print('Compact notebook report saved to (Windows): ' + '\\\\cernbox-smb' + full_path.replace('/', '\\'))
display(Javascript('IPython.notebook.save_notebook();'))
Time.sleep(5)
file_name_html = file_name + '.html'
!{sys.executable} -m jupyter nbconvert --to html $'AN_600A_RCBXHV_FPA.ipynb' --output /eos/project/m/mp3/600A/$prefix_circuit_name/$circuit_name_rcbx/FPA/$file_name_html --TemplateExporter.exclude_input=True --TagRemovePreprocessor.remove_all_outputs_tags='["skip_output"]' --TagRemovePreprocessor.remove_cell_tags='["skip_cell"]'
```
%% Cell type:code id: tags:
``` python
```
......
600A/AN_600A_RCDO_FPA.ipynb
View file @ 30e1e7dd
%% Cell type:markdown id: tags:
<h1><center>Analysis of an FPA in an 600A Circuit - RCD-RCO Family</center></h1>
Figure below shows a generic circuit diagram, equipped with parallel resistance, as well as lead resistances and a quench resistance.
<img src="https://gitlab.cern.ch/LHCData/lhc-sm-hwc/-/raw/master/figures/600A/600A_without_EE.png" width=75%>
source: Test Procedure and Acceptance Criteria for the 600 A Circuits, MP3 Procedure, <a href="https://edms.cern.ch/document/874716">https://edms.cern.ch/document/874716</a>
%% Cell type:markdown id: tags:
# Analysis Assumptions
- We consider standard analysis scenarios, i.e., all signals can be queried. If a signal is missing, an analysis can raise a warning and continue or an error and abort the analysis.
- It is recommended to execute each cell one after another. However, since the signals are queried prior to analysis, any order of execution is allowed. In case an analysis cell is aborted, the following ones may not be executed (e.g. I\_MEAS not present).
# Plot Convention
- Scales are labeled with signal name followed by a comma and a unit in square brackets, e.g., I_MEAS, [A].
- If a reference signal is present, it is represented with a dashed line.
- If the main current is present, its axis is on the left. Remaining signals are attached to the axis on the right. The legend of these signals is located on the lower left and upper right, respectively.
- The grid comes from the left axis.
- The title contains timestamp, circuit name, and signal name allowing to re-access the signal.
- The plots assigned to the left scale have colors: blue (C0) and orange (C1). Plots presented on the right have colors red (C2) and green (C3).
- Each plot has an individual time-synchronization mentioned explicitly in the description.
- If an axis has a single signal, then the color of the label matches the signal's color. Otherwise, the label color is black.
%% Cell type:markdown id: tags:
# 0. Initialise Working Environment
%% Cell type:code id: tags:
``` python
# External libraries
print('Loading (1/15)'); import pandas as pd
print('Loading (2/15)'); import numpy as np
print('Loading (3/15)'); import sys
print('Loading (4/15)'); from IPython.display import display, Javascript, clear_output, HTML
print('Loading (1/16)'); import pandas as pd
print('Loading (2/16)'); import numpy as np
print('Loading (3/16)'); import sys
print('Loading (4/16)'); from IPython.display import display, Javascript, clear_output, HTML
# Internal libraries
print('Loading (5/15)'); import lhcsmapi
print('Loading (6/15)'); from lhcsmapi.Time import Time
print('Loading (7/15)'); from lhcsmapi.Timer import Timer
print('Loading (8/15)'); from lhcsmapi.analysis.R600ACircuitQuery import R600ACircuitQuery
print('Loading (9/15)'); from lhcsmapi.analysis.R600ACircuitAnalysis import R600ACircuitAnalysis
print('Loading (10/15)'); from lhcsmapi.analysis.expert_input import get_expert_decision
print('Loading (11/15)'); from lhcsmapi.analysis.report_template import apply_report_template
print('Loading (12/15)'); from lhcsmapi.gui.DateTimeBaseModule import DateTimeBaseModule
print('Loading (13/15)'); from lhcsmapi.gui.pc.FgcPmSearchModuleMediator import FgcPmSearchModuleMediator
print('Loading (14/15)'); from lhcsmapi.metadata.SignalMetadata import SignalMetadata
print('Loading (15/15)'); from lhcsmnb.parameters import are_all_parameters_injected, NbType
print('Loading (5/16)'); import lhcsmapi
print('Loading (6/16)'); from lhcsmapi.Time import Time
print('Loading (7/16)'); from lhcsmapi.Timer import Timer
print('Loading (8/16)'); from lhcsmapi.analysis.R600ACircuitQuery import R600ACircuitQuery
print('Loading (9/16)'); from lhcsmapi.analysis.R600ACircuitAnalysis import R600ACircuitAnalysis
print('Loading (10/16)'); from lhcsmapi.analysis.expert_input import get_expert_decision
print('Loading (11/16)'); from lhcsmapi.analysis.report_template import apply_report_template
print('Loading (12/16)'); from lhcsmapi.gui.DateTimeBaseModule import DateTimeBaseModule
print('Loading (13/16)'); from lhcsmapi.gui.pc.FgcPmSearchModuleMediator import FgcPmSearchModuleMediator
print('Loading (14/16)'); from lhcsmapi.metadata.SignalMetadata import SignalMetadata
print('Loading (15/16)'); from lhcsmnb.parameters import are_all_parameters_injected, NbType
print('Loading (16/16)'); import lhcsmnb.utils
clear_output()
lhcsmapi.get_lhcsmapi_version()
lhcsmapi.get_lhcsmhwc_version('../__init__.py')
```
%% Cell type:markdown id: tags:
# 1. Select FGC Post Mortem Entry
%% Cell type:markdown id: tags:skip_cell
In order to perform the analysis of a FPA in an RCD/O 600A circuit please:
1. Select circuit name (e.g., RC.A12B1)
2. Choose start and end time
3. Choose analysis mode (Automatic by default)
Once these inputs are provided, click 'Find FGC PM entries' button. This will trigger a search of the PM database in order to provide a list of timestamps of FGC events associated with the selected circuit name for the provided period of time. Select one timestamp from the 'FGC PM Entries' list to be processed by the following cells.
**Note that 24 hours is the maximum duration of a single PM query for an event. To avoid delays in querying events, please restrict your query duration as much as possible.**
%% Cell type:code id: tags:parameters
``` python
fgc_pm_search = FgcPmSearchModuleMediator(DateTimeBaseModule(start_date_time='2021-01-26 00:00:00+01:00',
end_date_time='2021-01-31 00:00:00+01:00'), circuit_type='600A_RCDO')
```
%% Cell type:markdown id: tags:
# 2. Query All Signals Prior to Analysis
%% Cell type:code id: tags:skip_output
``` python