How to

From Hall A Wiki
Jump to: navigation, search

This page is a copy of E03-104

This page is based on a similar how-to page of the LEDEX experiment.

Spectrometer how-to

How to change the spectrometer angle

First, do a visual survey of the Hall to make sure nothing is in the spectrometer's path. Also, make sure you are not exceeding the minimum (typically 14 degrees) or maximum (experiment dependent) spectrometer angle.

Second, on hacsbc2, click the red "tool box" icon on the linux taskbar, as above. Choose bogies_SetSpec so that you can determine the angle and vernier setting for the spectrometer.
Bogies SetSpec.window.gif
See the window displayed to the right. Enter the spectrometer (L or R), and the angle, and you will get two options for the floor mark and the vernier. Generally choose the vernier closer to zero. Center the cameras on the desire vernier using the Move+/Move- buttons on the Hall A General Tools screen. The TV monitors for these cameras are on the middle shelf, in rack CH01A05.

Third, choose bogies_Left (or bogies_Right) in the tool box to bring up the bogies control screen. [image:bogies_RIGHT.window.gif] Click PSM enable and wait a few seconds for PSM OK to read YES. Click DM enable and wait a few seconds for DM OK to read YES.

Make sure the velocity is set to 0 and the direction is CW or CCW as desired. Click on Brake Release and wait for Brakes OK to read YES.

Click on ClampRelease, set the velocity to 700. Once you see the spectrometer start to move in the floor angle camera - you cannot see the spectrometer move in the Hall overview camera, as it only moves a few degrees per minute at maximum speed. For the left arm, to move to a larger angle, the direction should be CCW, while for the right arm CW moves the spectrometer to larger angle. The direction of the spectrometer is reversed by using a negative rpm. Watch the spectrometer motion on the cameras. When you are getting close to the desired angle, slow down to about 300 rpm. To stop, click on the Clamp Release button and the Brake button. Disable DM and PSM, and disconnect to close the GUI. Read off the floor angle mark and vernier, and input the values into the appropriate fields in the Alignment section of the Hall A General Tools GUI.

How to change the momentum setting of HRS

From the HAC 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 new momentum value. To raise the momentum setting, you need to cycle the Q2 and Q3 magnets first and then enter the desired momentum setting. See the instructions for the cycling procedure on the instruction sheet to the right of the white board in the counting house.

New Momentum Control Instructions with information on:

 * Momentum Regulation
 * Momentum Tolerance Alarms
 * Q2 & Q3 Degaussing
 * Troubleshooting

How to change HRS-R Dipole Setting (a delicate art)

These instructions are taken from John Lerose's document. Due to the fact that there is a short in one of the coils of the right dipole there are special considerations that must be taken into account when setting it. The short imposes two limits on operational use of the magnet.

The ramp rate is limited (~0.1 Amps sec-1) in order to keep the current induced in the short low enough to ensure safe operation of the magnet. This alone makes changing the field a slow process. Once current is induced in the short, then, left to itself, that current dies off exponentially, which affects the magnetic field, with a time constant close to 20 minutes. If one ignores this 2nd factor it can take a very long time to get a stable field in the magnet.

There’s nothing, short of taking the magnet apart and fixing it, that can be done about #1 above. However, with a little patience and forethought, #2 can be dealt with fairly easily. The trick is to use the inductive coupling between the shorted and not shorted coil to bring the current in the short to zero. This is done by always overshooting the desired current change and then going back. Use Figure 1 to determine the amount of overshoot you need for a given change in current (Δi) or you can use the spreadsheet calculator.

HRS-R Overshoot.png

For example, if the right dipole is set for 0.3616 GeV/c the output current is about 126.0 Amps (with a set current of about 123.8) and the desired field is -0.13268 T. To change to +10% higher, p = 0.3978 GeV/c, should require about 10% more current or 12.6 Amps more. Instead of just typing in iset = 136.4 (123.8+12.6), do the following:

  • type in iset = 153.3 (29.5 Amps more than you think you need)
  • wait for the magnet to stop ramping
  • type in iset = 136.4 (the setting you think you want based on the previous setting)
  • Observe the field reading and its rate of change. A strip chart helps
  • make small (<1 Amp), slow (>3 minutes apart) adjustments to compensate as needed.

Re the overshoot: Figure 1 is based on a model of the shorted coil with inductive coupling to the not shorted coil. As we get more experience we may refine that. In general for bigger changes more overshoot is needed. For changes less than 3 Amps just make the change and then make small adjustments. Also remember when going down the “overshoot” really is an undershoot. Always go past and then come back.

A final note: This assumes that the current in the short was zero when you started.

How to change the HRS collimator

How to reset the quadrupoles

The reset for Q2 is simple, on the front of the power supply there are red lights on when the power supply is tripped. At the bottom of the board that has the red light there is a blue reset button. There may be more than one light on so there may be more than one blue button that needs to be pushed. Push blue buttons until all of the red lights are out. Once all of the lights are out, lower the large lever on the lower right side of the power supply and lift it back into position. this will reset the Q2 and Q3 power supplies locally. For Q1, it's simpler : there is a large sign in the back of the Q1 equipment rack on the power supply balcony that says the blue reset button is here. you press the button and the magnet resets.

How to cycle the power on the NMR meters

HALOG entry 186341 by J. Segal: Sometimes the NMR meters need to be power cycled. Most likely when the meters do not respond to GPIB commands. To check if the meter is responding one can try to change the units on the NMR GUI. It's the GUI you get to from the "FIELDS" button and selecting "D1 NMR". Try changing units from "MHz" to "Tesla". If the units on the display change, the meter is responsive and does not need to be power cycled. If the units do not change it would be good to power cycle the meter.

  • The AC Power Switch for the Left Arm is hareboot17, port 8.
  • The AC Power Switch for the Right Arm is hareboot27, port 8.

(Username and password for IOC reboot are available in the counting house).

Halog entry 188657 by E. Brash: The IOC reboot is generally straightforward, but we had some problems getting the NMR to lock. I had some success with just setting the DAC manually to an appropriate value, and then turning the auto search on once it got close. I found that the following worked pretty well:

Right arm -> DAC=2400 Probe=B Left arm -> DAC=1319 Probe=B

Settings for NMR to lock:

Units : Tesla

Mode : Auto

Field : polarity of particule ( negative for electrons )

Search : Off


How to reboot HRS magnet IOC

Go to the hall A main menu screen.

Click "IOCS". Note that the left HRS magnet IOC's (iocha14) are accessible at http://hareboot10 and the right HRS magnet IOC's(iocha16) are accessible at http://hareboot25 (Username and password for IOC reboot are available in the counting house). Close the "Hall A IOC Systems" window.

To reboot:

  • the left HRS magnet IOC's, go to http://hareboot10 and from the pull-up menu next to iocha14, select "immediate reboot".
  • the right HRS magnet IOC's, go to http://hareboot25, click on control, select iocha16, from the pull-up menu select "immediate reboot".

After the IOC reboot, please make sure that the spectrometer-angle information is reentered into the Hall A General Tools GUI.

What/where to check VDC

VDC status can be checked on the HAC Main Control Window. High Voltages and Gas Flows are constantly being monitored in the VDC HV and Gas Flow sections.

How to set / reset phototube high voltage

From the Hall A Main Menu on hacsbc2, click on LeCroy HV. Choose the appropriate spectrometer, and then the appropriate detector. Usually the voltages are already plateaued, and you should only need to turn HV on. All voltage numbers are in Volts.

How to reset the VDC high voltage

Bring up the HAC control window per the above instructions. In the "Miscellaneous" section, click on the "Crate Resets" button then select "Beamline Crates Resets". This will bring up the "Hall A Slow Controls" window. In the bottom left and right of this window are the reset buttons for the spectrometer subsystems. Click on the relevant "VDC high voltage" reset button. You then need to go back to the main HAC GUI and reset the tripped VDC to 4 kV by entering 4 in the VDC HV window. If the VDC trips again, reset the supply then try to ramp up the voltage slowly. If there are repeated trips, call an expert.

Left arm sodium iodide calorimeter how-to

HV control

Basic remote control

The main HV is provided by a LECROY 1440 crate for 253 channels of detectors. It is controlled via the serial interface which is accessible on hatsv4 port 6.

telnet hatsv4 2006

If you get a connection refused message, it means it is already connected. Login as root on the portserver

telnet hatsv4

and type

kill tty=6

This will free port 6 of the portserver

A few useful commands :

M01 to select the crate, only needed at power up

R E A display all HV

ON to turn HV ON

OFF to turn HV OFF

ST to get status of crate

R E C[channel] read HV from the channel

R E A to display all values of HV, note there is a space between the letters

W [HV value] C[channel] Write the HV value

The rest of the HV is on the left arm HV crate in the CSR slots and can be controlled using the usual Hall A HV GUI

Server control

For easier communication with the HV crate, we have a small telnet server using Python which forward commands to the crate. All software is in ../HV after a goonlana. ( /adaqfs/home/adaq/e05110/HV/c )

If the server is not running, launch it on logged adaql2 by typing in scripts/1440/HV/ :


The server is tcp, it will forward any command it receives to the crate.

A few simple C program are locate in the C directory, they allow to write or read a value and can serve as a base for more advanced program.

gethv [channel] display the HV of channel

chhv [channel] [HV value] write HV value in channel

loadhv [textfile] load values in the text file in the crate, format is channel number and requested value

comhv [1440 command] sends the command to the crate

Bad HV channels

channels 4 8 19 are bad and not used

channel for PMT 66 (HV 69)and 150 ( HV 152 ) are off since the PMT are bad

Data acquisition, CODA how-to

How to run CODA

This assumes that runcontrol is running. If not, see the section Cold Start below.

  • At present we have two independent DAQs for the two HRS spectrometers.
  • The run coordinator should know the passwords, which are also posted on the wall on a paper near the whiteboard.
  • Normally, runcontrol will be already running. If not, see section on Cold Start below. To start and stop runs, push the buttons "Start Run" and "End Run". Start Run is the same as the sequence prestart, go.
  • To change configurations, use the "Run Type" button. If you've been running, you will first have to push "Abort" button. Choose the configuration from the dialog box, then press "Download". The relevant configurations include:
 * 2-daq mode: 
      LeftHRS:  The Left HRS runs on adaql2 on the a-onl account.  
      RightHRS: The Right HRS runs on adaql1 on the adev account. 
 * pedrun:      Used to obtain pedestal files used by fastbus for pedestal suppression. 

Generally adaql1 and adaql2 should be reserved for CODA / data acquisition. Replay is particularly resource intensive and will interfere with DAQ, but more generally nothing should be done on these machines except CODA and an ssh to bring up a halog window.

More details about the Hall-A DAQ and trigger can be found in Bob Michaels' guide and guide2.

How to Take a Pedestal Run

If you've been running the normal spectrometer DAQ configuration, you'll need to press "Abort", then "RunTypes" and select the PEDRUN configuration. Download, StartRun. Run for about 5000 events, then EndRun. You may check the pedestal files in ~/ped (pedN.dat corresponding to ROC #N). See README there for more details. After pedestal run, change back to the running configuration.

NOTE: DONT try to use PEDRUN for anything other than pedestal determination -- its confusing since the prescale factors are in a different file, etc. If you want a run with pedestal suppression turned off, see the README.

Quick Resets

See the Bob Michael's guide2 (section III, Quick Resets) for more details.

Cold start

See the Bob Michael's guide2 (section III, Cold Start) for more details.

How to start xscaler (HRS) / view the scalers and trigger rates

xscaler is the GUI that displays scaler data online. Normally xscaler is running on the hapc5 screen which is above the adaql2 console (in rack CH01A09).

If not running:

  • login as adaq on adaql4
  • type "xscaler Left" for left DAQ scalers
  • and "xscaler Right" for right DAQ scalers

The displayed scalers can be changed by clicking on the tabs at the top of the GUI. There are instructions at the bottom of the GUI explaining how to plot scaler channels versus time and to switch the display from rates to counts.

How to check if there's a problem with DAQ (data acquisition)

Usually if there is a problem, it is noticed because no data is coming in, or because the system fails to stop or start runs. Check that the ROCs (Read Out Controllers) are up and if not reboot them. For more information see Bob Michaels DAQ guide. If you are not a coda expert, it might be fastest to simply exit the coda runControl window, and then restart coda as above.

How to download and check the trigger

To change the trigger:

  • Logon to an adaq Linux box like "adaql1" or "adaql2" as user "atrig".
  • Run
> trigsetup

A self-explanatory graphical user interface pops up and you should do what it says and press "Download" and WAIT for it to finish and do not press Ctrl-C. The user should look for suspicious error messages in the window from which trigsetup was launched, e.g. to check if connection to the crate is ok.

How to check the dead time

If it is not already running, type datamon in a terminal on adaql2 in the a-onl account for the left arm and on adaql1 in the adev account for the right arm.

How to Get xterm Windows for Components

As adev on adaql1 or a-onl on adaql2 type :


This will open 3 xterms for either the right or left DAQ, respectively. In the name of these xterms is the portserver port where you can connect via RS232 (portserver instructions are at

In the "components" workspace, login to all the frontend computers by typing "telnet hallasfi1" where the name of the computer like hallasfi1 is in the name of the xterm window. An example name may be an xterm with title "ROC2--hallasfi2--hatsv3-port-8" meaning ROC2 is IP address hallasfi2 and on portserver hatsv3 at port 8.

For example to log on hatsv3 port 8 type :

telnet hatsv3 2008

Beam line how-to

What/where to check raster

Use spot++ as described below. Also, the raster pattern should be displayed on the Tektronix oscilloscope mounted in rack CH01B05, in the middle room of the counting house. This can give you a rough idea that the raster is on, but spot++ is needed to check actual dimensions. Also see this page for more.

How to start spot++

* Start a CODA run on L-arm or R-arm DAQ
* Log onto "adaql1" as user "adaq"
* Type "spot_L" ("spot_R") for L-arm (R-arm)

A few notes:

  • The old notation "spot++" or "raster" or "raster++" are all synonymous with spot_R at the moment.
  • The beam must be on ( > 1 uA) for some time in the first 5000 events !!


 * Type "spot_L" or "spot_R" with no arguments   --> to analyze the most recent run.
 * Type "spot_L 1062"   --> to analyze run 1062 (if it's still on adaq disks).
 * Type "spot help"   --> to get help (note, there are other command line options, which "help" will explain). 

Please see for more details.

How to run a Harp Scan

Please follow the directions at the Harp Scan Page (Need better instructions!) [Harp Scan page]

Logbook, monitoring and accounting

How to bring up HAC control window

The machine which runs the HAC GUI is hacsbc2. The monitor is located in the Hall A Counting House in rack CH01A02, just below the NMR dipole oscilloscopes. Click here to see the screen. At the bottom of the screen is the linux taskbar, in the middle of the taskbar is the "toolbox" icon. Pressing on that icon will open a menu with the following choices : vdcs_off, T2.stp, StripTool, Snapshot, etc; as shown on the picture aside. Click the entry called "Menu_HallA", or "hlamain". You can also issue the command "hlamain" from the terminal.

A sub-screen entitled "Hall A Main Menu" will appear. One of the entries is labeled "Tools". Clicking on the "Tools" button opens the "Hall A General Tools" screen, which is often referred to as the HAC window.

How to bring up the Alarm Handler

From the "toolbox" icon in the taskbar, press the "Alarm Handler" label. Alarms are indicated by a beep and the alarm handler button flashing. The color red indicates values far out of range, while the color white indicates a communication failure. Clicking on the alarm handler button will bring up an alarm handler list. A detailed list is given in the left panel, and clicking on items here brings up a more detailed list in the right panel. The alarm can be acknowledged and silenced by clicking on the button beside the alarm indicator.

You can plot time dependencies of EPICS variables

Pressing the "toolbox" icon and launch "StripTool", which enables you to plot any EPICS variable(s) versus time. To find out the name of a particular EPICS variable, click on it with the middle mouse button on the MEDM GUI.

How to bring up the Beamtime Time Accounting Table

  • Logon to "adaql1" as user "adaq"
  • type "bta"

See for more information.

How to start HALOG

If no halog guis are up and running, log in as user "adaq" on any "adaq.." machine. Type halog a yellow and blue and gray window will appear Enter text in the large message area, your name in the User area, and a title in the Keywords area. Remember that experiments tend to suffer from too little documentation, not too much. Also, halog entries allow people to remotely check on the experiment progress without bothering you with phone calls. When complete, after pressing the "Make entry" button, the text in the message center to the lower right corner of the window should read 'Entry Complete', otherwise something is wrong. It often takes several minutes for entries to show up in halog.

To enter 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. By moving the cursor you can select any window to be selected, by clicking 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, and then make a second screen grab. The images are in GIF format.

Shift check list and Run sheets

This list has to be filled in every shift: Shift Check List.

Run Sheets

How to check NaI detector fans and bubbler.

Bubbler web cam

NaI Fan PDU username: hlauser, password is the same as for "ioc-reboots".

Data analysis

Detector and Physics replay

Online Run analysis:

  • Login to one of the adaq machines (adaql[3,4,5,6,7]) as user adaq, if you do not know the password ask the shift leader or check the counting house whiteboard for the list of accounts and current passwords.
  • Do not do replay analysis on adaql1 or adaql2, since these machines are used for the left and right DAQ.
  • Type

this will take you to the online analysis directory.

  • Type
   replay (Run number) (Event number) (Overwrite flag)

where 'Run number', 'Event number', and 'Overwrite flag' are optional. Overwrite flag can be either of 0(do not overwrite) or 1(overwrite). For example,

   replay 20150 20000 1

will replay the run 20150 of the R-HRS with 20000 events, and will overwrite the previous '.root' file if exited. You can also try

   replay left(Left)
   replay Right(right)

then you will be asked for run number. If you need any assistance, you can type

   replay help

then it will show the usage.


What does the data structure look like?

Please see the data structure page:

What/where to check target temperature and pressure

The target temperature and pressure is displayed on the target GUIs running on cryotarg as well as on the camera monitors in the rack (CH01A06) left of the target computer. Look at the camera monitor on the top right of rack CH01A06. 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. The adjacent camera displays the JT valve controller readings and tachometers.