Notebooks for Circuit Analysis of HWC Tests and Events during Operation

Although, as the project name indicates, our primary goal is the development of signal monitoring applications, we realized that the analysis modules developed so far can be pieced together into HWC test and operation analysis notebooks.

The monitoring applications are organized system by system. Each analysis has been developed in a general way to account for all circuits in which the system was present.

In particular, those notebooks are suited for HWC tests and operational analysis (FPA):

• can be adjusted on-the-fly for new requirements while performing a test;
• can immediately generate a report for storage and distribution among a team of domain experts;
• provide a sequential way of testing each system in a given order.

Access the notebooks

The easiest way to access those notebooks is through SWAN. You can access the documentation on how to execute those notebooks by following this link.

FPA Notebooks

FPA Analysis Workflow

An FPA analysis workflow consists of four steps:

• finding an FGC Post Mortem timestamp;
• executing analysis cells on the cluster;
• plotting and validating the analysis results;
• storing output files on EOS; see Figure below.

FPA Notebook Structure

The RB FPA Analysis notebook is organized into 10 chapters (Note that for the remaining circuits, some analyses may not be present.):

0. Initialize the working environment

   Loads external packages as well as lhcsmapi classes required to perform analysis and plot results.

1. Select FGC Post Mortem Entry

   After executing this cell, a FGC Post Mortem GUI with default settings is displayed. The GUI consists of 8 widgets described in Table below.

   Widget	Description
   Circuit name	Circuit name
   Start	Start date and time
   End	End date and time
   Analysis	Automatic (each cell executed without user input); Manual (some analysis steps take expert comment)
   Done by	NICE login of a person executing the analysis
   Find FGC PM entries	Button triggering a search of FGC PM entries
   Query progress bar	Displays progress of querying days in between indicated dates
   FGC PM Entries	List of FGC PM timestamps

   Please note that in order to execute any of the following cells, there should be at least one entry in the FGC PM Entries list. The list is populated after clicking [Find FGC PM entries button].

   Figure below shows the GUI after clicking the button [Find FGC PM entries] with the default settings. Note that the list only contains FGC PM timestamps surrounded by QPS timestamps (1 minute before and 5 minutes after an FGC PM timestamp).

   

2. Query All Signals Prior to Analysis

   In order to avoid delays between analyses, the necessary signals are queried prior to performing the analysis.

3. Timestamps

   Table of timestamps main systems representing the sequence of events for a given analysis.

4. Schematic

   Interactive schematic of the RB circuit composed of: power converter, two energy extraction systems, current leads, magnets, and nQPS crates. Hovering a mouse over a center of a box representing a system provides additional pieces of information. Location of quenched magnets is highlighted. Slider below the schematic enables its scrolling.

   

5. PIC

   Check of PIC timestamps

6. Power Converter

   Analysis of the main power converter as well as earth currents.

7. Energy Extraction Analysis of the energy extraction voltage and temperature

8. Quench Protection System Analysis of the quench detection system, quench heaters, diode, voltage feelers, diode leads resistance, current leads voltage (resistive and HTS).

9. Plot of Energy Extraction after 3 h from an FPA

10. Final Report

    Saving of the CSV results table and HTML report to EOS folder. The RQ analysis notebook follows the same structure except for the lack of schematic. Typically, there is only a single main quadrupole magnet quenching and the schematic does not provide more information as compared to the timestamps table in point 3. For the remaining circuits the analysis cells reflect the presence of particular hardware.

FPA Notebook Output

The notebook creates two output files in the folder (path with Windows convention)

\\eosproject-smb\eos\project\m\mp3\$circuit_type$\$circuit_name$\FPA

e.g.,

\\eosproject-smb\eos\project\m\lhcsm\operation\RB\RB.A12\FPA

• HTML report file with the snapshot of the entire notebook - [circuit-name]_FPA-[fgc-timestamp]-[analysis-execution-date].html;
• CSV file with MP3 results table with a subset analysis results - [circuit-name]_FPA-[fgc-timestamp]-[analysis-execution-date].csv;

FPA MP3 Quench Database

Update quench file in repository with the new .csv file in case of quenches and QH firing with significant current (> 3 kA for RB, RQ, IT; > 1 kA for IPD, IPQ; > 70 A for 600A; > 10 A for 60, 80, 120 A circuits).

1. Open MP3 Quench repository at https://cern.ch/MP3-onedrive/QuenchData

2. Open the Excel (in this example IT for Inner Triplets)

3. Edit the file locally by clicking Edit Workbook

   

4. Import the .csv file with Excel

   

   • Select a file from EOS circuit folder

   • The file uses tab as column separator and has a header

5. After import:

   • Check that the extra imported header matches the one in the Excel file
   • Remove the extra header and any blank rows in-between existing and new data
   • Sort by FGC date and time

HWC Notebooks

Based on EDMS acceptance criteria, HWC notebooks are conceived to visually display key information for experts to determine if a test was successful or not.

To run the notebook, one needs to copy the input parameters from acctesting and paste them in the dedicated notebook cell, as shown in the figure below.

One can then execute the different cells, providing useful insights, mainly logs, tables and plots to compare the test results with the acceptance criteria at the top of the notebook.

By the end, the user will be prompted to determine if the analysis was successful or not. Then, a cell to enter when requested by the notebook if the analysis was successful or not. Then, the next cell will export the content of the notebook to EOS for archiving purposes. This report can later be accessed on CERNBox here, or directly from windows by browsing the following path:

\\eosproject-smb\eos\project\m\mp3\<circuit_type>\<circuit_name>\<hwc_test>\