HAPPEX How To Page

• Troubleshooting

• HAPPEX Data Acquisition

  • Use the checklist when switching DAQs
  • Cold start
  • Monitoring HAPPEX systems
  • Rebooting HAPPEX crates
  • Running CODA

• HAPPEX Data Analysis

  • Starting Online Data Monitor
  • Starting prompt analysis

• Q² Scanner Data Taking

  • Profile Scan How To

• Spectrometer

  • Bringing up the Alarm Handler
  • Bringing up the HAC control window
  • Changing momentum setting of HRS and Septum
  • Reset Q1 of Left or Right HRS

• Target

  • Checking target temperature
  • For the Target Operator: Hall-A Cryogenic Target Operation Guide (PostScript,PDF).   (version 2)
  • Target How To (quick and friendly overview)
  • New procedure for target IOC reboot (New!)

• Spectrometer Data Acquisition

  • Use the checklist when switching DAQs
  • Cold start
  • Mapping of ROCs to portserver and IP
  • Spectr. DAQ Triggers for HAPPEX
  • Rebooting HRS crates
  • Running CODA
  • Starting xscaler (HRS) and checking trigger rate

• Spectrometer Data Analysis

  • Online analysis

• Hall A Detectors

  • List of Detectors
  • Detector High Voltages
  • VDC check and HV

• Compton Polarimeter

  • Compton Polarimeter Home page.
  • Compton Data-Taking instructions.
  • Compton Logbook (analysis results)

• Helicity Controls

  • Changing the Half-Wave Plate

• Miscellaneous

  • Bringing up the Beamtime Counting Table
  • Plotting time dependences of EPICS variables
  • Printing in the counting house
  • Starting HALOG
  • Starting spot++ and checking the raster

• Other Problems

  • If you can't solve a problem

HAPPEX Data Acquisition

HAPPEX DAQ cold start

Note: This is for HAPPEX DAQ. If you want to cold start spectrometer DAQ see Spectrometer DAQ cold start.

• If switching from Spectrometer to HAPPEX DAQ, you must turn off detectors that can be damaged by high rate before turning on high current beam; use checklist when making this switch.

• Do the following at a shell prompt on adaql1 on the apar account:

  > kcoda
> rcServer &
> runcontrol
  

• The Runcontrol GUI will start up. Now click on the Connect button.

• Wait 10 seconds, then click on Configure. A dialog box pops up and you must choose the configuration you want, which is presumably happex2.

• Wait for configuration to finish (see messages in text box at lower left), then click Download.

• Wait for that to finish. Now you can click Start Run to start a run (see section on Running CODA).

• In another workspace, open up xterms for monitoring the ROCs by starting the ROC IT GUI:

  > roc_it

  Click on OPEN ALL. An xterm should open for each IOC. If you are asked for a login name, use adaq as the user. The password is the same as in the counting house computers.

Monitoring HAPPEX systems

• Log in if necessary to adaql1 on the apar account

• To check status of feedback system and polarized source, type at shell prompt:

  > runbird

  Help is available using the Help button at the bottom. Settings and numbers to expect can be found in the White Bound Shift Worker Folder.

• To check status of HAPPEX ADCs and timing, type at shell prompt:

  > greenmonster

  Click on tabs at top to examine ADCs in different crates or timing.

Rebooting HAPPEX crates

• If a run is in progress, end it.

• There should be xterms open for each roc in the ROCS workspace. In the desired xterm, click ENTER a few times to check communication to the IOC. Then type:

  > reboot

• The IOC will then proceed through its booting sequence. It is ready when either of these messages appear (e.g. for ROC23/halladaq6):

  "ROC23" state now "booted"
Done executing startup script /adaqfs/halla/apar/vxworks/halladaq6.boot

• In the runcontrol GUI,

  click Abort
  click Reset
  click Download

• Start a new run.

Running CODA for HAPPEX DAQ

Note: This is for HAPPEX DAQ. If you want to run CODA for spectrometer DAQ see Running CODA for spectrometer DAQ.

• If switching from Spectrometer to HAPPEX DAQ, you must turn off detectors that can be damaged by high rate before turning on high current beam; use checklist when making this switch.

• Log in, if necessary, to adaql1 as user apar

• The Runcontrol GUI may be already running. If not, see section HAPPEX DAQ cold start. To start and stop runs, click on the buttons Start Run and End Run. Start Run is the same as the sequence Prestart, Go.

  Be sure to enable the online data monitor before starting the run, if you wish to use it during the run.

• Start a new run EVERY hour. Runs without beam are important for Electronics Crosstalk Analysis.

HAPPEX Data Analysis

Online Data Monitor

• HAPPEX online data monitor (PANGUIN) normally starts up at start of run. To disable this "background process" enter at a shell prompt:

  > panguin off

  To re-enable it enter:

  > panguin on

  These commands have no immediate effect on analysis, but govern whether or not analysis will start at the start of the next run.

• To monitor data online, log into adaql1 with the apar account and type at a shell prompt:

  > gopan
> pan
  

  Then at the ROOT prompt enter:

  root [0] online("happex")

  A fairly self-evident GUI will appear. Select various pages of plots using the buttons on the left.

Starting prompt analysis

• The HAPPEX Prompt analysis is comparable to the Detector and Physics replay that is done with the Hall-A Analyzer.

  • Log into adaql5 or adaql6 with the apar account.
    DO NOT PERFORM PROMPT ANALYSIS ON ADAQL1
    
  • At the shell prompt, type:

    > gopan
> prompt.pl runnumber

  • Prompt Analysis will then proceed with decoding the raw CODA data into Helicity Correlated Asymmetries and Position Differences, done by the Parity ANalyzer (PAN). This is followed by the Regression and Dithering Analysis (REDANA), which corrects the raw asymmetries for detector sensitivities to beam parameters.
  • The Online GUI will open a window presenting histograms and stripcharts for the requested runnumber. Check these versus the sample Prompt Analysis plots (should be in a white bound folder). Any strange deviations from the sample plots should be brought to someone's attention (Shift Leader, Run Coordinator) and shown in the HALOG.
  • Once in a while, print out the text output files and put them in the binder (taking advantage of the opportunity to look them over and compare them to previous runs, of course). The print command is (after doing $ gopan) e.g.

    $ chaprint_text prompt_output/*_224*

    to print outputs from runs 2240 to 2249.

Spectrometer

Bringing up the Alarm Handler

• In the HAC control window, press the "Alarm Handler" label in the tools launcher. When an alarm is triggered, the bottom "Alarm Handler" will flash, then you can press there to see where the problem is.

Bringing up the HAC control window

• The machine to run HAC is hacsbc2, the second machine from left. At the bottom of the screen is the Linux taskbar. The sixth symbol is tools launcher. Pressing the arrowhead opens a menu which has:

  • Alarm Handler, bogies_LEFT, bogies_RIGHT, bogies_SetSpec, JavaArchiverClient,
  • Menu_Accelerator, Menu_ESR, Menu_HallA, snapshot, StripTool

  Pressing the "Menu_HallA" label launches a subscreen titled "Hall A Main Menu". One of the entries is labelled "Tools". Pressing on the "Tool" button opens the "Hall A General Tools" screen as follows, which is often referred to as the HAC window. The old version of HAC can be found at http://hallaweb.jlab.org/document/OPMAN/node179.html.

  

Changing momentum setting of HRS and Septum

• From the HAC control window, there is a P0 SET field for each spectrometer in which you can enter the desired momentum setting. To change to a lower momentum from a higher previous setting, you just need to enter the momentum value. To bring the momentum setting up, you need to recycle the magnets for Q2 and Q3 of either arm. That is increase the current of Q2/Q3 to 1600 A for the Left arm or 1400 for the Right arm, wait for 2 minutes after they reach max, then tune down the value to the desired setting. More detailed instructions are on the white board of the counting house. There's no need to recycle magnets for Q1, Dipole and Septum.

• Procedure to reset the dipole momenta (eg. after a reboot of the magnet controls IOC):
  1. Look up (in the runsheets or the whiteboard) the desired SET current in the dipole magnet power supply.
  2. Turn OFF the field regulator in the dipole nmr field control gui.
  3. Set the desired momentum in the hall A tools screen (set the "P0").
  4. Enter the desired SET current in the dipole magnet power supply.
  5. Wait for the momentum setting of the dipole to reach within ~0.5% of the desired momentum.
  6. Turn ON the field regulator.
  7. Eventually, the regulator will automatically enter a new set current that will take the dipole directly to the desired momentum.
        Note:

     left dipole SET current ≅ (left dipole READ current)/(0.944)

     right dipole SET current ≅ (right dipole READ current)/(1.005)
     
  [This is a modified version of HAlog entry 129538]

• The septum currents are not any longer automatically determined by the controls software when you enter P0 (momentum in GeV) into the Hall A controls GUI. Independent of whether you have set P0 for the HRS, you will need to set the septa currents by hand, since we are running the septa 10% higher than their nominal setpoints. For the record, here are the formulas:

  Right Septum set current = 92.58 * P0 (GeV/c)  
  Left Septum set current = 94.22 * P0 (GeV/c) 
  

  John LeRose provides up-do-date info in a detailed septum controls manual.

Reset Q1 of Left or Right HRS

• Go to Hall A tools screen and press the blue button next to "I(A)" for left or right HRS (depending on which one is having problems). Click on "Q1 power supply", this will pop up the window for power supply control.
• Usually after a trip, the Q1 current will drop to zero, some fault messages will show in red, and the power supply is off. Press the "Reset" button to clear the faults and wait, for an example see halog 152379. Note that "MAGNET MISMATCH" will remain on because the current readback does not match the set point.
• Try to turn on the power supply by clicking on "POWER ON". If it does not turn itself on, try the following:
• Go to the middle room, look for a "Reset switch box #1" in rack CH01B04, press the green button labeled "left Q1 local control reset" or "right Q1 local control reset";
• Go back to the control window and click on "POWER ON" again. If it still does not turn itself on, a controlled access is needed. In this case, consult the run coordinator first, and then go down to the hall.
  1. Go to Q1 power supply, put into local mode (a button).
  2. Press "reset", then "power on", then press local mode button again to go into remote (its a 2-state button). This might suffice. Ask shift crew to turn on magnet... see if it works.
  3. If this doesn't work, which happens all the time, then:
     • Go to the key panel on row of equipment behind Q1 PS (toward target), press yellow button under key switch.
     • And press tiny blue reset on back of this panel. There is a big sign pointing to this tiny button.
     • Repeat step 2.
• Now the power supply should be on. If it is not, you didn't do the above procedure correctly. In the control window, enter set current. If a set current is already there, check if it is the same as previous runs (check the runsheets). Wait for the magnet to ramp up.

Target

Checking target temperature

• The target temperature is displayed on the target GUIs,tgtcharts running on cryotarg as well as on the camera monitors on the shelves above the computers. Look at the camera monitor labeled "Control Rack", third top little monitor. It displays the temperatures for the three loops on three white temperature controllers, with loop 1 at the top and loop 3 on the bottom. Ask the TO for help if you can't find the temperature or it doesn't make sense.

New Procedure on target IOC reboot

• The green reset button in the counting house middle room should no longer be used. To reboot the IOC:
• Type "http://hareboot7" in a web browser and enter the username/passwd (they should be labeled next to the TO's computer);
• Select "Immediate Reboot" under "Control Action" for outlet 3 (iocha13);
• Click "Apply", wait for IOC to come back, and be patient;
• If the IOC stills behaves odd, consult the target on-call.
• In any case, do not press the green button!

Spectrometer Data Acquisition

Spectrometer DAQ cold start

Note: This is for spectrometer DAQ. If you want to cold start HAPPEX DAQ see HAPPEX DAQ cold start.

• Do the following at a shell prompt on adaql2 on the a-onl account:

  > startcoda
  

• "startcoda" will run "kcoda", and will start all the components for you (a nice simplification over last year, thanks A. Camsonne).

• Run Type = TWOARM.

• Details about Hall A Spectrometer DAQ and trigger see Bob Michaels's guide.html and guide2.html.

Mapping of ROCs to Portserver and IP for Spectr. DAQ

        HRS-DAQ CODA Configrations 

        TWOARM             Two spectrometers
        pedrun             Pedestal run for TWOARM

Triggers for HAPPEX

We will sometimes run the spectrometer DAQ for optics, alignment check, Q² measurement, background studies, etc.

Here are the triggers:

• T1,T3 = main scint. trigger = "AND" of two S0 PMTs. S0 is new in 2005. S1 is removed.

• T2,T4 = HAPPEX trigger = Saclay electron calorimeter detector above a threshold.

• T5,T6 = UMass Profile scanner.

• T7,T8 = S2 trigger = "OR" of S2 paddles. Used to checkout S0.

• T9 = 10 Hz pulser trigger for pedrun. Cannot be prescaled.

Rebooting HRS crates

• Short hint: Type "reboot" at vxWorks prompts of ROC logins.

• For details about Hall A spectrometer DAQ including reboot procedure see Bob Michaels' guide.html and guide2.html.

Running CODA on Spectrometer DAQ

Note: This is for spectrometer DAQ. If you want to run CODA for HAPPEX DAQ see Running CODA for HAPPEX DAQ.

• Important: Use the checklist when switching between spectrometer and HAPPEX DAQ.

• Log in, if necessary, to adaql2 as user a-onl

• The Runcontrol GUI may be already running. If not, see section Spectrometer DAQ cold start. To start and stop runs, click on the buttons Start Run and End Run. Start Run is the same as the sequence Prestart, Go.

• For more details about Hall A DAQ and trigger see Bob Michaels's guide.html and guide2.html.

Starting xscaler (HRS) and checking trigger rate

• Use hapc5 which is the PC on the top at the far right of counting room console. Normally xscaler will be running, but if not, log on as adaq, type "xscaler" and do what is commanded of you.

• To start xscaler (though usually it is already running):

  xscaler

• You can find all trigger rates in Left-Arm xcaler window: T1-T5 in Page6 and T6-T9 in Page 7.

• Trigger types: T1  =  R-arm Scint S0   /   T2  =  R-arm HAPPEX   /   T3  =   L-arm Scint S0   /   T4  =   L-arm HAPPEX   /   T5  =   R-arm Profile Scanner   /   T6  =   L-arm Profile Scanner   /   T7  =   S2 R-arm   /   T8  =   S2 L-arm   /   T9  =   pulser (10 Hz)

Spectrometer Data Analysis

Analysis for Spectrometer DAQ data

We will do infrequent spectrometer-DAQ runs for the following purposes:

• HAPPEX Detector Alignment.
• Optics Calibration.
• Q² Distribution.
• Use new XYQ cavity BPM at 50 nanoamps where striplines may not work (need low current for Q² since rates are high)
• HAPPEX Detector Attenutation (variation of amplitude) and consequent weighting of Q² by amplitude.
• Background Analysis from Aluminum End Caps.
• Background analysis using field scan to simulate trajectories from inelastics and from pole-tip scattering.
• Alignment of UMass Q² Profile Scanner

Important: Use the checklist when switching between spectrometer and HAPPEX DAQs.

Instructions for online checks:

• Login to adaq account and type goonlana This should take you to ~adaq/happexsp/onlana. The "sp" means spectrometer DAQ.
• Type analyzer and use the script .x onlana.C.
• The script will tell you what to do next. Typically you must run online GUI configurations to check data quality. Examples:

  • .x online.C+("detectorL")   L-HRS detector checkout (detectorR for R-HRS)

  • .x online.C+("optics")   optics data taking check

  • .x online.C+("physics")   physical quantities including Q²

  • .x online.C+("align_happex")   align HAPPEX detector

• To achieve the other goals, e.g. background study, will require work by the analysis team.

Hall A Detectors

List of Detectors

• HAPPEX Specific Detectors
  • Saclay Electron Calorimeter Detector -- our main detectors which integrate electrons in the focal plane
  • UMass Q² Profile Scanner -- used to scan the focal plane particle distributions at high rate.
  • S0 Scintillators (new in 2005). (the HV must be turned off during high rate running)
  • A whole host of beamline instrumentation too numerous to mention here.

• Standard Detectors used for Infrequent Spectrometer DAQ Runs
  • VDCs (the HV must be turned off during high rate running)
  • S2 Scintillators (S1 is removed). (the HV must be turned off during high rate running)
  • Leadglass on both arms (the HV must be turned off during high rate running)

Detector High Voltages

High Voltage screens are located within the Hall-A Main Menu screen, under Lecroy HV
Here is a few screen captures indicating the location of each High Voltage channel, used by HAPPEX: (Click to Zoom)

Left Arm:


Right Arm Top:


Right Arm Bottom:

VDC check and high voltage

• VDC Status

  • VDC status can be checked on the HAC control window (see below). High Voltages and Gas Flows are constantly being monitored.

• VDC HV (IMPORTANT: HV must be turned off during high rate running, i.e. HAPPEX production running.)

  • Bring up the HAC control window (see below)

  • In the "VDC HV" section, set HV to 0

  • In the "Miscellaneous" section, click on the Crate Resets button.

  • In the "Hall A Slow Controls" window, press the "Reset" button associated with the tripped HV crate.

  • Go back to set HV values to 4.0 kV

Helicity Controls

Changing the Half Wave Plate

1. End the current HAPPEX run and the current Compton Run.
2. Call MCC and ask them to change the state of the Insertable Half-Wave Plate (IHWP) from In to Out or Out to In as appropriate.
3. When you see the state of the IHWP change in the HAPPEX feedback monitor, type in an xterm (logged in as apar):
        flipper
4. The new setpoints should now appear in the HAPPEX feedback monitor.. the Rotatable Half-wave Plate (RHWP) takes a minute or two to change (so be patient!).
      DO NOT START A NEW RUN UNTIL YOU HAVE VERIFIED THE NEW SETPOINTS.
5. Start a new HAPPEX run and a new Compton Run.
6. Make a halog entry, saying you've changed the IHWP, and include a screen capture of the HAPPEX feedback monitor (the "runbird" GUI).
7. Write the new half-wave plate configuration on the white board.

Below is a sample of what the output looks like (from flipper).

Miscellaneous

Bringing up the Beamtime Counting Table

• Log in to adaql1 as user adaq

• Type "bta"

• An attempt is made to automate the entries, but the shift leader should check it based on their own estimates of ABU, BANU, etc.

Plotting time dependences of EPICS variables

• In the HAC control window, press the "StripTool" label in tools launcher, which allows you to plot any EPICS variables versus time.

Printing in the counting house

• On hopefully all adaq computers the command print should work. Type print filename for a file named filename and it will print out on the cha2hp printer in the back room. If you want to print to another printer, type print filename otherprinter. If that doesn't work try the command line below.

  rlpr -Pcha2hp -Hjlabprt file.ps

  Printing from Mozilla:

  • Use

    File->Print...

  • Choose to print to printer, not file

  • Click on Properties (or Configuration?) of printer

  • In the field for Print command, enter:

    /apps/bin/rlpr -Pcha2hp -Hjlabprt

    (you should only have to do this once for each account)

  • Click Print

  Alternatively, you can have Mozilla print to a Postscript file, which you can then print from the command line.

  Trying to print to cha2hp from a CUE machine (e.g. jlabl1) using pdq will also fail. This is not a problem specific to the counting house computers. Only lpr and rlpr will work with this printer.

Starting HALOG

• As user adaq on any adaq.. machine, simply type

  > halog

• Entering text is easy and straightforward. After submitting the entry, the white text on blue background in the lower right corner of the window should read 'Entry complete', otherwise something is wrong.

• Entering graphics: Click Grab Screen in the bottom button row of the halog window. The halog window will disappear, and the window the cursor is in will become the active window, its outline flashing. You can select any window by clicking in it on the left mouse button. You also can select an arbitrary part of the screen by holding down the left mouse button and dragging the cursor along. All the time a rectangle will flash that indicates the selected area. Releasing the mouse button will then cause this screen area to be included into the entry. It will show up as a thumbnail picture in the halog window, where you can discard it or accept it, or go for a second screen grab. The images are in GIF format.

• For more details about HALOG see halog HOWTO and FAQ page.

Starting spot++ and checking the raster

• Log in to as adaq on adaql4 or any other adaq Linux computer.

• Make sure CODA is running with beam on. Of course, that's the spectrometer DAQ, not the HAPPEX DAQ. You'll need some triggers (adjust prescale factors to get at least 50 Hz of something, if possible).

• Type spot++ from any directory, after about 30 seconds, plots will pop up.

• Hint: Type "spot help" to learn more options.

Other Problems

If you can't solve a problem

• Call Run Coordinator A.S.A.P.
  Cell phone: 876-1787. Generic pager: 584-5411, but the RC might have his own pager, see white board.
• Techs:  See the white board. They normally want to be paged before phoned at home. Always contact the Tech-on-call first; never call any other Tech without permission from Tech-on-call.
• Computers:   Page Ole Hansen (7627) or Bob Michaels (7410).
• HAPPEX DAQ:  Page Bryan Moffit (5637) or Bob Michaels (7410).
• Spectrometer DAQ:   Page Bob Michaels (7410) or Bodo Reitz (5064).

HAPPEX Home

Rich Holmes, Last modified: Fri Jul 29 12:21:09 EDT 2005