Difference between revisions of "HOW TOs"

Revision as of 16:43, 22 October 2021

This is the place for task-specific instructions like rebooting ROC XX, starting the High Voltage GUI or bringing up the Alarm Handler.

CODA and DAQ

Stopping and starting a run

Shift Checklist Guide

Shift Checklist HowTos

Setting prescales and trigger

The Trigger Supervisor (TS) makes all triggers available at any time. The triggers that actually are included in the datastream are controlled by the prescale factors set at run time. To set the prescales, from any terminal on an hadesk computer log in to either adaq1 or adaq2 as follows:

ssh -Y sbs-onl@adaq1
prescale

Trigger supervisor (TS) inputs and corresponding prescales are shown in the table below. Note that PSX=-1 turns off trigger X. Otherwise, the prescale factor is approximately 2^PS.

Analyzing the data

Instruction for shift crew

• 1) Login to a-onl@aonlX (X=1, 2, 3, 4)
• 2) once logged in, type gosbs => this takes you to the directory where the analysis should be done, and sets up the correct environment variables.
• 3) type ./run_gmn_50k.sh runnum splitnum with runnum (integer) the run number you want to analyze, and splitnum the split number you want to analyze;
• This analyses the first 50000 events and produces plots that need to be checked.
• 4) Please review all produced plots of each GUI, and click on "Exit GUI", this will pop the next GUI.
• 5) After you're reviewed all plots, they will be saved as PDFs, which can be checked at the following web link:

https://hallaweb.jlab.org/halog/screen_snapshots/replays/

if instructed by RC/run plan to replay a different number of events, follow the same instructions as above, substitute step 3) with:

• 3') ./run_gmn.sh runnum nevents with runnum (integer) the run number you want to analyze amd nevents' (integer) the number of events to analyze

• for specific instruction for analysis experts only check this link

Monitor and Control GUIs

Most beam/accelerator related GUIs are accessible via jmenu. To bring up jmenu log in from a Counting House computer as adaq@adaq1 then type "jmenu" at the command prompt. Alternately you can access jmenu via the OPS account "hacuser", for example by running ssh -X hacuser@hlal00.acc.jlab.org 'jmenu' which will require a password unless you are logged in as adaq on one of the adaq machines. The jmenu search feature is pretty good at finding relevant GUIs. Use "halla" in your search to include only variables relevant to Hall A.

Opening Specific jmenu GUIs

Bringing Up Main GUIs

To bring the main GUIs we want to monitor on the TV in the counting house (hatv1), in a terminal type:

ssh -Y aslow@adaqsc
start_all_vnc

Now the VNC service is running. We can connect to these on hatv1. In a terminal on hatv1 type vncviewer (see sheet in CH for passcode). Minimize the terminal now to prevent other users from inadvertently killing all the VNC screens. This will bring up a window with icons for all VNC viewer windows, each one sized specifically for the GUI that it is intended to show. Click each icon to start the vncviewer for that GUI, then inside the vncviewer bring up a terminal and type:

start_tool_screens [option]

where [option] is:

• VNC window 1: GeneralTools (accelerator overview)
• VNC window 2: HallATools (LHRS, beam line, gas systems, etc)
• VNC window 3: Raster
• VNC window 4: BB (BigBite magnet current, voltage, etc)
• VNC window 5: SBS (Super BigBite magnet current, magnetic field, and corrector magnets)
• VNC window 6: Beam (beam energy, trajectories, positions)

Resize screens to your liking.

Bringing Up Scaler GUI

To bring up the Hall A Scaler GUI, which displays the scalers from the BigBite SHower Trigger sums, beam line, and trigger, ssh to a-onl@adaqX (X = 1, 2, 3, etc) type:

goxscaler

Then type ./xscaler SBS or ./xscaler Left.

Plotting EPICS variables with MyaPlot or LivePlot

For more information see Strip Chart

1. From the jmenu GUI select Plots>>MyaPlot or Plots>>LivePlot
2. Type into the plot the name of the EPICS variable(s) you wish to view. If you can't recall the name, you can always search jmenu for a GUI where such a variable might be displayed. For example, the Hall A Moller target position can be obtained from jmenu by searching for "halla moller target". Clicking the middle mouse button on the control or display variable located on the GUI copies the variable name into the buffer. Middle clicking again on the MyaViewer where the EPICS variable is entered will paste it into the plot.

Procedure for Ramping the BigBite Magnet

The steps to ramp the BigBite magnet are as follows. The nominal current is 750 A. The nominal polarity is NEGATIVE.

1. Obtain permission from the Run Coordinator to ramp the BB magnetic field.
2. Make a post in the HALOG indicating that the BigBite magnetic field will be ramped to the desired current setting.
3. Bring up the BigBite operational GUI. From any adaq machine, type start_control_screens BBctrl
4. In the GUI, in the SETPOINT field, type the desired current value and press the enter/return key.
5. Conform that the READBACK field reports desired current value
6. Make a follow-up HALOG post indicating that the BB magnet ramp is complete.

Hall Transition Procedures

REMINDER: The Run Coordinator will work with the Hall A Work Coordinator (Jessie Butler) to implement a hall transition.

The Super BigBite (SBS) magnet produces large fringe magnetic fields. When a radiation survey is performed, the RadCon team will use devices that can be compromised by magnetic fields, yielding incorrect readings. In magnetic fields stronger than 30 Gauss, ferrous materials like steel hand tools and other devices will experience a magnetic force and have the potential to become projectiles which can damage equipment and possibly cause serious injury to personnel. To mitigate this risk, Ops/Accelerator will use their procedure to ramp the SBS magnet and the corrector magnets down to zero current prior to personnel entering the hall under controlled access. We will additionally ramp the BigBite magnetic field down to zero current when personnel need to enter the Hall.

Procedure for Hall Transition to Controlled Access

The steps to ramp the BigBite magnet to zero field are as follows:

1. Obtain permission from the Run Coordinator to ramp the BB magnetic field down to zero.
2. Call MCC to confirm that they will ramp down the SBS magnet and communicate that you will ramp down the BB magnet.
3. Make a post in the HALOG indicating that the BigBite magnetic field will be ramped to zero.
4. Follow the directions above to ramp the BB field down to zero current.
5. Make a follow-up HALOG post indicating that the BB magnet is at zero current.

Procedure for Hall Transition to Power/Beam Permit

To prepare the hall to receive beam and take data, we need to ramp the SBS and BB magnets to their full nominal currents. For SBS, the current is 2100 A. For BB, the current is 750 A. Ops/Accelerator will ramp up the SBS magnet and corrector magnets using their procedures. We ramp up the BigBite magnet with the following steps:

1. Obtain permission from the Run Coordinator to ramp the BB magnetic field to its nominal current.
2. Call MCC to confirm that they will ramp up the SBS and corrector magnets and communicate that you will ramp up the BB magnet.
3. Make a post in the HALOG indicating that the BigBite magnetic field will be ramped to full field.
4. Follow the directions above to ramp the BB magnet to 750 A.
5. Make a follow-up HALOG post indicating that the BB magnet is at full current.

Making a Halog entry

You can either

1. From a terminal on any of the desktop computers type "halog" and fill out the fields. You can include screenshots and attachments if useful.
2. Navigate to the HALOG click "Add Content". Fill out the fields as necessary and submit it. This requires you to log in with you CUE username and password. Don't forget to log out.

Alarms

There are a number of alarms that shifters must respond to in Hall A in both the Counting House and the Hall. For information on how to respond to various alarms, click the links below

• The Fire alarm. If this sounds and danger is imminent, immediately leave the building, call 911 and notify the guard shack 757-269-5822. If danger is not imminent, call for beam off and notify the crew chief, set the experiment in a safe state (if the target is moving for example, terminate the move), leave the building as soon as possible and notify the guard shack 757-269-5822.
• VESDA (Very Early Smoke Detection Alarms). These are used to detect fire/smoke in the experimental hall. If they go off, check the hall camera for fire and notify the crew chief and the RC.
• Python Alarm Handler (Not utilized so far by GMn) The Python-based alarm handler is administered by experts in the experiment (David Flay, Don Jones) and can be edited at our convenience to include or exclude variables and change thresholds etc.
• Target Alarm Handler The EPICS-based Target Alarm Handler is used to service only alarms specific to critical target function such as target movement, temperature and vacuum level. It is managed by Hall A staff (Silviu Covrig, Greg Smith, Jian-Ping Chen) and can only be changed upon request.
• HallA Alarm Handler This EPICS-based Target Alarm Handler has the same underlying mechanics as the target alarm handler and is typically used to service critical hardware like spectrometer currents. It is managed by Hall A staff (Bob Michaels) and can only be changed upon request.

Filling out BTA

• Login to the BTA webpage with your CUE username. Notice the Help menu.
• Move the mouse to "File". Don't click. Let mouse hover.
• A dialog comes up. Select "Open Timesheet".
• Select the Hall (A), and the shift, etc.
• As a convenience feature, you may "Load from Epics" (button at bottom right) which automatically fills the fields. Note, the shift worker must click the little pencil-looking thing in the Edit column and MUST click the check mark that appears..
• Note, automated numbers from EPICS works ONLY FOR PRODUCTION RUNNING with either HRS DAQ, i.e. it does not account for beam used by a variety of other tasks, such as energy measurements or HARP scans. The experimenters have final say over the numbers; you can edit the fields when you click Edit. (And don't forget to click the check mark whether you have edited or not; you MUST acknowledge.) Common sense: If the beam is used by the experiment it is ``ABU.
• Submit on the "Signatures" tab.

Beam Line

• Monitoring the Beam Line
• Hall A beam line drawing (to be updated)
• SBS spot++ (raster size and beam position verification)
• Establishing beam in the Hall

LHRS Information

LHRS for SBS

BigBite Spectrometer (BB)

• GEMs

All GEM procedures and trouble shooting are located in this document GEM HOW TO

1. GEM HV controls
2. HOW-TO for generating new GEM pedestals using the analyzer (NOTE: Need a separate how-to for using these pedestals and common-mode files to configure the DAQ)
3. As of 15 October, we are using the premixed gas bottles and do not have EPICS monitoring of the bottle pressures. Shift crews should go to the gas shed about every 2 hours, and note the supply pressures of the two premix gas bottles in this spreadsheet

• GRINCH

1. Monitoring and setting the high voltage
2. GRINCH scalars and event monitoring
3. GRINCH Gas Panel Camera

• Timing Hodoscope

1. High and low voltage and troubleshooting tips
2. Online Analysis How To

• Preshower and Shower
  • Monitoring and setting the high voltage (needs checked after move to Hall).
  • How to adjust discriminator threshold on BBCAL DAC
  • How to run the scalers script to monitor trigger sum scalers
  • How to run Panguin for BBCAL PS and SH plots

Super BigBite Spectrometer (SBS)

• GEMs
• HCAL
  • HCal Overview
  • Setting the HCal and BB thresholds