Difference between revisions of "Compton DAQ HOWTO"

From PREX Wiki
Jump to: navigation, search
m (Opening the VNC & CODA)
m (Compton Background Rates)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<br><br>
 
<br><br>
[[Main_Page|<B>PREX Main</B>]] << [[HOW TOs]]
+
[[Main_Page|<B>CREX Main</B>]] << [[HOW TOs]]
 +
 
 +
[[Compton DAQ HOWTO PREXII|PREX II Version]], [[Compton_Counting_Mode_DAQ|Electron detector/Counting Mode DAQ]]
  
 
This page is intended for PREX-II/CREX shift crew and instructs the correct usage of the compton DAQ, as well as some troubleshooting procedures.
 
This page is intended for PREX-II/CREX shift crew and instructs the correct usage of the compton DAQ, as well as some troubleshooting procedures.
  
 
== Things to Check Before Running Compton ==
 
== Things to Check Before Running Compton ==
[[File:ComptonPowerSupply.jpeg|thumb|The power supply sits just behind the glass next to the shift leader station and has a big sign pointing to it on the lower shelf of the rack.]]
+
Check that the Compton laser table rates (look for ComptonUSbg and ComptonDSbg on the EPICS computer strip charts) are acceptable.
# Check that the black BNC cable is plugged into the module labeled "Compton PMT Power Supply." This module is located in the room with the DAQ crates, on the rack furthest from the door, facing the front room.
+
# Check that the power supply is set to '''exactly 5.13 V.'''
+
# Check that the Compton laser table rates (look for ComptonUSbg and ComptonDSbg on the EPICS computer strip charts) are acceptable.
+
# After verifying all of the above, then follow the instructions to start compton CODA.
+
  
== Compton DAQ CODA ==
+
Values will be alarmed and will go off in case of quick spikes. If you don't know what the "acceptable" values are, then ask at the start of your shift.
  
All compton runs and analysis are taken through a VNC session on the compton machine. The VNC acts as a remote desktop for the compton machine in the counting house. Having the VNC allows compton experts to centralize control over the compton DAQ, offer that control to shifters, and still allow off-site monitoring.
+
== Compton DAQ CODA ==
  
[[File:ComptonCODA-Annotated.png|thumb|500px|right|Annotated window of what the compton VNC should look like when open to workspace 1. Note the fact that both the compton CODA and analysis links exists entirely in one window, and shifters should be careful not to enter commands intended for adaq1 in the VNC.]]
+
[[File:ComptonCODA-Annotated.png|thumb|500px|right|Annotated window of the compton CODA. Note that this picture if of a VNC that shifters don't need to use anymore. Simply running CODA and analysis from a terminal shell will be enough.]]
  
=== Opening the VNC & CODA ===
+
=== Opening CODA ===
  
* Log in to the compton machine with ''ssh compton@compton'' (PW can be found from the paper next to the CH white board)
+
* Log in to compton vnc port 9 with <code>vncviewer compton:9 --shared</code>. Passwd is in the usual place.
* Once logged in run ''vncviewer :9 -shared''
+
* If CODA is not open in the vnc, then in the ssh terminal, and run ''kcoda'' (to be safe) and then ''startcoda''
** This will open a window in which a second desktop will appear.
+
* If CODA is not open, then open a terminal window, and run ''kcoda'' (to be safe) and then ''startcoda''
+
 
** The Compton CODA looks almost exactly like the parity DAQ CODA with one extra window: the blue terminal window titled "ROC6." When you start up the Compton CODA if ROC6 keeps spitting out an error called ''udpSend: write failure'' then you've done it correctly.
 
** The Compton CODA looks almost exactly like the parity DAQ CODA with one extra window: the blue terminal window titled "ROC6." When you start up the Compton CODA if ROC6 keeps spitting out an error called ''udpSend: write failure'' then you've done it correctly.
 
* With the compton CODA opened in the VNC window, first click ''Platform -> Connect.''
 
* With the compton CODA opened in the VNC window, first click ''Platform -> Connect.''
Line 31: Line 27:
 
** If ROC6 begins showing errors other than the ones mentioned above, then '''contact the RC immediately.'''
 
** If ROC6 begins showing errors other than the ones mentioned above, then '''contact the RC immediately.'''
  
'''How the VNC Works:''' There are a few important features about the VNC, the most important of which is: '''the same VNC can be open in multiple windows at one time!''' If someone else has the same VNC window open then you will both have simultaneous control over the mouse pointer, keyboards, etc. If you open the VNC window and you see it moving on its own then '''contact either the compton expert on-site or the RC to determine if the compton experts need the VNC.''' Generally it is the experts' responsibility to maintain control over the VNC. If an expert asks you to close your VNC window then it is safe to close without interrupting the current compton run.
+
=== IMPORTANT: Before Starting a Compton Production Run ===
 
+
* Check the EPICS plot of the variable "ComptonCentralRate"
Also important: '''if you close the VNC window it will not kill CODA or stop the compton run!''' However you last closed the VNC window will be the state in which it will be opened.
+
* If this rate is exactly zero then the photon detector high voltage is off.  
 
+
* If a compton expert is present, ask them for permission to turn it on
Also also important: '''Make sure you are only using the VNC for compton CODA and analysis! Any other work should be done through terminals on the adaq machines!'''
+
* If no compton expert is present then call Adam to have them help determine if it is safe to turn on
 +
* '''VERY IMPORTANT: do not turn on photon detector without authorization from a compton expert.'''
 +
* If photon detector HV is already on, then it's okay to proceed.
  
 
=== Starting and Stopping a Compton Run ===
 
=== Starting and Stopping a Compton Run ===
Line 41: Line 39:
 
* Once CODA is open, configured, and the ROCs downloaded to, simply click "Start" to start a compton run.
 
* Once CODA is open, configured, and the ROCs downloaded to, simply click "Start" to start a compton run.
 
* Comment with the run configuration, and the current status of the beam.
 
* Comment with the run configuration, and the current status of the beam.
* '''If possible have all compton runs last approximately 90 minutes. At 240 Hz that means once every three parity runs that you start, you should also start a new compton run.'''
+
* '''If possible have all compton runs last approximately 120 minutes. At 120 Hz that means once every other parity run that you start, you should also start a new compton run.'''
 
* To stop a compton run, simply click "Stop."
 
* To stop a compton run, simply click "Stop."
 
* After stopping each run, follow the steps to analyze it below:
 
* After stopping each run, follow the steps to analyze it below:
Line 49: Line 47:
 
# Open a new terminal window.
 
# Open a new terminal window.
 
# Enter command <code>gocompton</code>
 
# Enter command <code>gocompton</code>
# Enter command <code>source online.csh -r <run_num> --webupload</code>
+
# Enter command <code>./online.sh -r <run_num></code>
#* The <code>--webupload</code> flag will automatically place plot PDFs in the hallaweb comptonPlots directory, but they won't appear on the webpage until the compton shifter later decides which group they're in.
+
#* The script run without any flags will automatically place plot PDFs in the hallaweb comptonPlots directory, but they won't appear on the webpage until the compton shifter later decides which snail they're in.
 +
#* Not necessary but if you're curious you can run <code>./online.sh --help</code> to learn what the flags are and what they do.
  
 
That's it! If you see any errors that indicate replaying did not end successfully, then inform the compton expert on-call.
 
That's it! If you see any errors that indicate replaying did not end successfully, then inform the compton expert on-call.
Line 72: Line 71:
 
Have the RC contact the compton laser expert on call. This reboot should be entirely expert-driven.
 
Have the RC contact the compton laser expert on call. This reboot should be entirely expert-driven.
  
== Strip Tool Monitoring ==
+
== Compton Monitoring ==
[[File:ComptonStripTools.PNG|thumb|500px|right|What the compton strip tools should look like when opened. NOTE: this screenshot was taken without beam so the BPM and rate numbers with beam should be different. Use the numbers in the table, and not the ones in this screenshot.]]
+
Shifters are tasked with - at the start of every new compton run - briefly checking the strip charts to ensure that there are no technical issues.
+
  
=== Starting StripTool ===
+
[[File:ComptonCentralRateExamplePlot.png|thumb|500px|right|An example plot of what it looks like when you load configuration CREX/ComptonRatesAJZ in LivePlot. Note the behavior of the ComptonCentralRate with respect to beam current and laser power. EPICS variable explanations are in the attached table.]]
If the StripTool isn't running follow these instructions:
+
# Click into the VNC window. Open a new terminal.
+
# Enter <code>cd</code>
+
# Then enter the command <code>StripTool ~/compton/shift_crew.stp</code>. This will open up a window with plots of eight different EPICS variables.
+
  
=== Nominal Values ===
+
Monitoring a device as sensitive as the compton polarimeter can be a daunting task, but we've done as much as possible to streamline the process for shifters. Monitoring the compton simply means paying occasional attention to our StripCharts on the EPICS computer. The EPICS variables to monitor are in the following table:
At the start of each compton run, briefly check that the Strip tool values reported are approximately what they should be in the following table:
+
 
{| class="wikitable"
+
{|class="wikitable"
!Variable Name
+
!EPICS Name
!Explanation
+
!Variable Explanation
!Correct Behavior
+
!Alarmed?
!If Incorrect...
+
 
|-
 
|-
|COMPTON_PW1PCAV_ca
+
|IBC1H04CRCUR2
|Cavity laser power
+
|Hall A Beam Current
|When laser is on, should be >2000 W. When laser is off should be <5 W.
+
|
Should be flipping semi-periodically between off and on.
+
|-
|Contact RC, tell them to contact on-call laser expert
+
|ComptonUSbg1
 +
|Upstream background detector 1
 +
|Yes
 +
|-
 +
|ComptonUSbg2
 +
|Upstream background detector 2
 +
|Yes
 +
|-
 +
|ComptonDSbg1
 +
|Downstream background detector 1
 +
|Yes
 +
|-
 +
|ComptonDSbg2
 +
|Downstream background detector 2
 +
|Yes
 
|-
 
|-
 
|ComptonCentralRate
 
|ComptonCentralRate
|Trigger rate in main detector
+
|Photon detector rate
|When both beam and detector are on, should be ~200 kHz. Otherwise 0.&#42;
+
|No
|If rate is high immediately unplug photon detector,
+
and contact compton DAQ expert on-call.
+
 
|-
 
|-
|IPM1P02A.XPOS
+
|COMPTON_PW1PCAV_ca
|BPM 2A X position
+
|In-cavity laser power
|Should be approx. 0.35
+
|Parity Alarms
|Call MCC tell them to enable compton lock
+
 
|-
 
|-
|IPM1P02A.YPOS
+
|MCP1P01M
|BPM 2A Y position
+
|The compton dipole current
|Should be approx. -0.41
+
|No
|Call MCC tell them to enable compton lock
+
|-
 +
|IPM1P02A.XPOS
 +
|BPM 2A x position
 +
|No
 
|-
 
|-
 
|IPM1P02B.XPOS
 
|IPM1P02B.XPOS
|BPM 2B X position
+
|BPM 2B x position
|Should be approx. 0.27
+
|No
|Call MCC tell them to enable compton lock
+
|-
 +
|IPM1P02A.YPOS
 +
|BPM 2A y position
 +
|Parity Alarms
 
|-
 
|-
 
|IPM1P02B.YPOS
 
|IPM1P02B.YPOS
|BPM 2B Y position
+
|BPM 2B y position
|Should be approx. -0.22
+
|Parity Alarms
|Call MCC tell them to enable compton lock
+
 
|-
 
|-
|COM_DETPH_XCPOSai
+
|}
|Compton photon det table X position
+
 
|Should be approx. 70
+
=== Compton Background Rates ===
|Contact RC, have them call compton DAQ expert
+
 
 +
These are simply the rates of background radiation on our laser table. The lower the better, but we can't possibly expect zero. They're set to alarm if they exceed 7 kHz, so if they go off that'll be the primary indicator of a problem. A couple of things:
 +
* The rates will spike when starting a new compton run because the scaler gets cleared. If this happens just clear alarms, it's not a problem. It's perfectly normal behavior. Just clear the alarms and continue.
 +
* The rates will spike during a harp scan along the 1C line. These are normal, alarms from this can be cleared.
 +
** '''NOTE:''' MCC has been told to warn us before doing harp scans on the 1C line. If you get such a warning you should shut off the photon detector until they are done.
 +
 
 +
If rates are too high call MCC to get them brought back down.
 +
 
 +
=== Compton Photon Detector Rate ===
 +
 
 +
The metric we use is ComptonCentralRate which tracks roughly as beamCurrent*(laserPower + someBackground). So you should see ComptonCentralRate track with the laser power while the beam is up, and when it's down you should see it fall to approximately 0. There are a number of problems that can impact this measure, and as such, ruin our data. They are:
 +
* Beam is going through the chicane without position lock on or locked in a bad position such that we miss the laser
 +
* The laser autolock has failed
 +
* Photon detector has been pulled out of the path of the photon beam
 +
* The beam tune going through the chicane is not tight enough
 +
 
 +
If you suspect something is wrong with ComptonCentralRate first ask: is the central rate very clearly tracking with laser state? If yes, then you are not missing the laser. Has the laser increased to at least 2 kW in the past ten minutes? If yes, the laser cycling is fine. Consider this handy table when deciding if something is wrong with the beam configuration in the chicane:
 +
 
 +
{|class="wikitable"
 +
!If ComptonCentralRate is...
 +
!then I should...
 
|-
 
|-
|COM_DETPH_YCPOSai
+
|>200 kHz when laser is locked
|Compton photon det table Y position
+
|not worry.
|Should be approx. 32
+
|Contact RC, have them call compton DAQ expert
+
 
|-
 
|-
|ComptonDSbg1
+
|170-200 kHz when laser is locked
|Rate in laser scintillator DS 1
+
|not take any action yet, but continue to monitor to see if it gets worse.
|Should be approx. 2000 Hz
+
|-
|Contact RC, have them call compton laser expert
+
|140-170 kHz when laser is locked
 +
|attempt a steering only if you are familiar with the procedure and you have the RC's permission. Otherwise, continue to monitor.
 +
|-
 +
|<140 kHz when laser is locked
 +
|call compton expert immediately to request an investigation/potential steering.
 +
|-
 +
|not tracking with laser state at all
 +
|call compton expert immediately to request an investigation/potential steering.
 +
|-
 +
|exactly zero regardless of laser or beam state
 +
|check the compton HV settings to see if the photon detector is off.
 
|-
 
|-
|ComptonDSbg2
 
|Rate in laser scintillator DS 2
 
|Should be approx. 2000 Hz
 
|Contact RC, have them call compton laser expert
 
 
|}
 
|}
&#42; While both beam and laser is running the ComptonCentralRate should be noticeably higher than when either is off. The numbers in this table are assuming beam is on, lead target is in, and the laser is off.
+
 
 +
=== Compton Positions & HallAComLock ===
 +
 
 +
The compton has two BPMs on the laser table: IPM1P02A and IPM1P02B. During production both these BPMs should have a steady position lock engaged. The y-position is much more critical for production running than the x-position.
 +
 
 +
The name of the position lock we run for production is HallAComLock and it locks ONLY to IPM1P02B.YPOS. Because the other three BPM positions are allowed to drift we will expect the optimal position for HallAComLock to change over long time intervals, or when coming back from long downs/re-tuning. IF this lock is not engaged, or is in a bad position then the beam may partially, or wholly miss the laser.
 +
 
 +
2By appears to drift, call MCC and ask that HallAComLock be re-engaged. If HallAComLock is already engaged then it's probably running at a bad position, and you should call a compton expert for advice. In that case they will ask you to lower the current to 10 uA or something similar and enter a new value for HallAComLock and monitor ComptonCentralRate to see if it improves. Shifters should generally not attempt this without a compton expert guiding them, but may be allowed to under exceptional circumstances or if the RC gives their explicit permission.
 +
 
 +
=== Compton Laser ===
 +
 
 +
The laser cavity locks itself on and off automatically for brief intervals. Laser off periods lasting greater than 10 minutes (while taking production) should be cause for concern. If that is the case contact compton expert immediately. Untrained people should not attempt to do any laser operations.
 +
 
 +
=== Compton HV ===
 +
 
 +
The HV is controlled with a GUI similar to the main detectors. Instructions for accessing it are found at [[Compton Doc Portal#Compton HV GUI Guide|this wiki page here]]. IF you're even slightly unsure if the PMT is supposed to be on or off please call Adam immediately.
 +
 
 +
And that's it! Rates and position locks are the most critical. Keep a sharp eye out!
  
 
== Troubleshooting Common Problems ==
 
== Troubleshooting Common Problems ==
  
 
A few common problems have occurred when running the compton and should have easy fixes. A few of them are:
 
A few common problems have occurred when running the compton and should have easy fixes. A few of them are:
 +
 +
'''"udpSend: write failure" shows up in the ROC6 terminal'''
 +
* "udpSend: write failure" is actually a good thing, because it means your telnet connection has succeeded, but the ROC recognizes that you have not yet restarted a new run and hasn't initiated the normal protocol with CODA.
 +
* See for reference a Compton DAQ restart that looks bad, but is actually just a CODA session in need of an extra try on the start buttons: https://logbooks.jlab.org/entry/3806858
 +
* Coming from a Compton DAQ crash which was recovered just with kcoda and startcoda: https://logbooks.jlab.org/entry/3806857
  
 
'''CODA is saying something disconnected and is asking me if I want to reset.'''
 
'''CODA is saying something disconnected and is asking me if I want to reset.'''
Line 160: Line 214:
 
* First, make sure you can still ssh into the compton computer. If yes, then it's likely just a network hiccup and you can start running again. If you can't, briefly walk over to the compton terminal (the one farthest from the door in the counting house back room) to make sure it's still running. If not, then contact the RC who should then contact a compton expert.
 
* First, make sure you can still ssh into the compton computer. If yes, then it's likely just a network hiccup and you can start running again. If you can't, briefly walk over to the compton terminal (the one farthest from the door in the counting house back room) to make sure it's still running. If not, then contact the RC who should then contact a compton expert.
  
[[Category:Control GUIs]][[Category:DAQ]][[Category:HOW TO]]
+
'''The CentralRate and/or the background rates are stuck at 0 or they don't seem to be updating!'''
 +
* This is probably just ROC6 getting stuck in a bad state. Power cycle it with the above instructions. If problem persists contact compton expert.
 +
 
 +
'''The compton rates are too low/not tracking with laser state!'''
 +
* See [[#Compton Photon Detector Rate]] for advice.
 +
 
 +
'''The background rates are too high at full current and they won't go down!'''
 +
* Call RC. Tell them what the background rates are at full current. They may decide to lower the current for the time being. They may request a re-tune. Follow the RC's instructions.
 +
 
 +
[[Category:Control GUIs]][[Category:DAQ]][[Category:HOW TO]][[Category:Compton]]

Latest revision as of 17:45, 7 September 2020



CREX Main << HOW TOs

PREX II Version, Electron detector/Counting Mode DAQ

This page is intended for PREX-II/CREX shift crew and instructs the correct usage of the compton DAQ, as well as some troubleshooting procedures.

Things to Check Before Running Compton

Check that the Compton laser table rates (look for ComptonUSbg and ComptonDSbg on the EPICS computer strip charts) are acceptable.

Values will be alarmed and will go off in case of quick spikes. If you don't know what the "acceptable" values are, then ask at the start of your shift.

Compton DAQ CODA

Annotated window of the compton CODA. Note that this picture if of a VNC that shifters don't need to use anymore. Simply running CODA and analysis from a terminal shell will be enough.

Opening CODA

  • Log in to compton vnc port 9 with vncviewer compton:9 --shared. Passwd is in the usual place.
  • If CODA is not open in the vnc, then in the ssh terminal, and run kcoda (to be safe) and then startcoda
    • The Compton CODA looks almost exactly like the parity DAQ CODA with one extra window: the blue terminal window titled "ROC6." When you start up the Compton CODA if ROC6 keeps spitting out an error called udpSend: write failure then you've done it correctly.
  • With the compton CODA opened in the VNC window, first click Platform -> Connect.
  • Afterwards click "Configure."
    • The final line in the ROC6 window should be an error message saying callbackControl: Do not understand the command: session/control/setSession. If you see this error, then you've done it correctly.
  • Then click "Download."
    • If you've done it correctly, then ER1, EB6, and ROC6 will all read "downloaded" as a state.
    • If ROC6 begins showing errors other than the ones mentioned above, then contact the RC immediately.

IMPORTANT: Before Starting a Compton Production Run

  • Check the EPICS plot of the variable "ComptonCentralRate"
  • If this rate is exactly zero then the photon detector high voltage is off.
  • If a compton expert is present, ask them for permission to turn it on
  • If no compton expert is present then call Adam to have them help determine if it is safe to turn on
  • VERY IMPORTANT: do not turn on photon detector without authorization from a compton expert.
  • If photon detector HV is already on, then it's okay to proceed.

Starting and Stopping a Compton Run

  • Once CODA is open, configured, and the ROCs downloaded to, simply click "Start" to start a compton run.
  • Comment with the run configuration, and the current status of the beam.
  • If possible have all compton runs last approximately 120 minutes. At 120 Hz that means once every other parity run that you start, you should also start a new compton run.
  • To stop a compton run, simply click "Stop."
  • After stopping each run, follow the steps to analyze it below:

Analyzing Compton Data

The compton has a much simpler and faster analysis procedure than the parity DAQ. To analyze a compton run:

  1. Open a new terminal window.
  2. Enter command gocompton
  3. Enter command ./online.sh -r <run_num>
    • The script run without any flags will automatically place plot PDFs in the hallaweb comptonPlots directory, but they won't appear on the webpage until the compton shifter later decides which snail they're in.
    • Not necessary but if you're curious you can run ./online.sh --help to learn what the flags are and what they do.

That's it! If you see any errors that indicate replaying did not end successfully, then inform the compton expert on-call.

ROC6 Hard Reboot

The following instructions detail how to restart ROC6 if/when it dies during compton operation:

  1. In either the vnc or on the compton machine open a Firefox window. Go to the page hareboot4.jlab.org or [follow this link].
  2. Login with the correct hlauser credentials.
  3. Go to outlet 8 and do "Immediate off."
  4. Wait at least 30 seconds
  5. Select "Immediate On" for outlet 8.
  6. Check CODA to see if ROC6 is responding.

EXPERTS ONLY

  1. Enter the command telnet hatsv5 2005 after selecting "Immediate On" to monitor ROC6 startup.
  2. If you see the VXWorks logo in ascii-art pop up, startup is proceeding regularly.
  3. Exit the environment with "Ctrl+]" and quit.

IOC hacp Reboot

Have the RC contact the compton laser expert on call. This reboot should be entirely expert-driven.

Compton Monitoring

An example plot of what it looks like when you load configuration CREX/ComptonRatesAJZ in LivePlot. Note the behavior of the ComptonCentralRate with respect to beam current and laser power. EPICS variable explanations are in the attached table.

Monitoring a device as sensitive as the compton polarimeter can be a daunting task, but we've done as much as possible to streamline the process for shifters. Monitoring the compton simply means paying occasional attention to our StripCharts on the EPICS computer. The EPICS variables to monitor are in the following table:

EPICS Name Variable Explanation Alarmed?
IBC1H04CRCUR2 Hall A Beam Current
ComptonUSbg1 Upstream background detector 1 Yes
ComptonUSbg2 Upstream background detector 2 Yes
ComptonDSbg1 Downstream background detector 1 Yes
ComptonDSbg2 Downstream background detector 2 Yes
ComptonCentralRate Photon detector rate No
COMPTON_PW1PCAV_ca In-cavity laser power Parity Alarms
MCP1P01M The compton dipole current No
IPM1P02A.XPOS BPM 2A x position No
IPM1P02B.XPOS BPM 2B x position No
IPM1P02A.YPOS BPM 2A y position Parity Alarms
IPM1P02B.YPOS BPM 2B y position Parity Alarms

Compton Background Rates

These are simply the rates of background radiation on our laser table. The lower the better, but we can't possibly expect zero. They're set to alarm if they exceed 7 kHz, so if they go off that'll be the primary indicator of a problem. A couple of things:

  • The rates will spike when starting a new compton run because the scaler gets cleared. If this happens just clear alarms, it's not a problem. It's perfectly normal behavior. Just clear the alarms and continue.
  • The rates will spike during a harp scan along the 1C line. These are normal, alarms from this can be cleared.
    • NOTE: MCC has been told to warn us before doing harp scans on the 1C line. If you get such a warning you should shut off the photon detector until they are done.

If rates are too high call MCC to get them brought back down.

Compton Photon Detector Rate

The metric we use is ComptonCentralRate which tracks roughly as beamCurrent*(laserPower + someBackground). So you should see ComptonCentralRate track with the laser power while the beam is up, and when it's down you should see it fall to approximately 0. There are a number of problems that can impact this measure, and as such, ruin our data. They are:

  • Beam is going through the chicane without position lock on or locked in a bad position such that we miss the laser
  • The laser autolock has failed
  • Photon detector has been pulled out of the path of the photon beam
  • The beam tune going through the chicane is not tight enough

If you suspect something is wrong with ComptonCentralRate first ask: is the central rate very clearly tracking with laser state? If yes, then you are not missing the laser. Has the laser increased to at least 2 kW in the past ten minutes? If yes, the laser cycling is fine. Consider this handy table when deciding if something is wrong with the beam configuration in the chicane:

If ComptonCentralRate is... then I should...
>200 kHz when laser is locked not worry.
170-200 kHz when laser is locked not take any action yet, but continue to monitor to see if it gets worse.
140-170 kHz when laser is locked attempt a steering only if you are familiar with the procedure and you have the RC's permission. Otherwise, continue to monitor.
<140 kHz when laser is locked call compton expert immediately to request an investigation/potential steering.
not tracking with laser state at all call compton expert immediately to request an investigation/potential steering.
exactly zero regardless of laser or beam state check the compton HV settings to see if the photon detector is off.

Compton Positions & HallAComLock

The compton has two BPMs on the laser table: IPM1P02A and IPM1P02B. During production both these BPMs should have a steady position lock engaged. The y-position is much more critical for production running than the x-position.

The name of the position lock we run for production is HallAComLock and it locks ONLY to IPM1P02B.YPOS. Because the other three BPM positions are allowed to drift we will expect the optimal position for HallAComLock to change over long time intervals, or when coming back from long downs/re-tuning. IF this lock is not engaged, or is in a bad position then the beam may partially, or wholly miss the laser.

2By appears to drift, call MCC and ask that HallAComLock be re-engaged. If HallAComLock is already engaged then it's probably running at a bad position, and you should call a compton expert for advice. In that case they will ask you to lower the current to 10 uA or something similar and enter a new value for HallAComLock and monitor ComptonCentralRate to see if it improves. Shifters should generally not attempt this without a compton expert guiding them, but may be allowed to under exceptional circumstances or if the RC gives their explicit permission.

Compton Laser

The laser cavity locks itself on and off automatically for brief intervals. Laser off periods lasting greater than 10 minutes (while taking production) should be cause for concern. If that is the case contact compton expert immediately. Untrained people should not attempt to do any laser operations.

Compton HV

The HV is controlled with a GUI similar to the main detectors. Instructions for accessing it are found at this wiki page here. IF you're even slightly unsure if the PMT is supposed to be on or off please call Adam immediately.

And that's it! Rates and position locks are the most critical. Keep a sharp eye out!

Troubleshooting Common Problems

A few common problems have occurred when running the compton and should have easy fixes. A few of them are:

"udpSend: write failure" shows up in the ROC6 terminal

  • "udpSend: write failure" is actually a good thing, because it means your telnet connection has succeeded, but the ROC recognizes that you have not yet restarted a new run and hasn't initiated the normal protocol with CODA.
  • See for reference a Compton DAQ restart that looks bad, but is actually just a CODA session in need of an extra try on the start buttons: https://logbooks.jlab.org/entry/3806858
  • Coming from a Compton DAQ crash which was recovered just with kcoda and startcoda: https://logbooks.jlab.org/entry/3806857

CODA is saying something disconnected and is asking me if I want to reset.

  • This is a common occurrence. Proceed with the reset. Re-configure and re-download when you're done. If CODA still doesn't behave after that, then run kcoda and startcoda (up to five times if necessary) to attempt to recover.

CODA hangs at the end of a run in a "Waiting for..." state indefinitely.

  • Reset CODA if the option is available to you. If the reset works, try configuring and downloading again. If that doesn't work, or you cannot reset CODA, then simply run kcoda (multiple times if necessary) and then startcoda.

CODA says it can't communicate with ROC6.

  • First attempt a reset. If that fails, click on the blue "ROC6" window. Press enter a few times. If a new line pops up, simply kcoda and startcoda again. If you cannot get a new line on that window then call the RC and instruct them to call Adam Zec and tell them that ROC6 needs a manual power cycle.

The VNC crashed on me!

  • First, make sure you can still ssh into the compton computer. If yes, then it's likely just a network hiccup and you can start running again. If you can't, briefly walk over to the compton terminal (the one farthest from the door in the counting house back room) to make sure it's still running. If not, then contact the RC who should then contact a compton expert.

The CentralRate and/or the background rates are stuck at 0 or they don't seem to be updating!

  • This is probably just ROC6 getting stuck in a bad state. Power cycle it with the above instructions. If problem persists contact compton expert.

The compton rates are too low/not tracking with laser state!

The background rates are too high at full current and they won't go down!

  • Call RC. Tell them what the background rates are at full current. They may decide to lower the current for the time being. They may request a re-tune. Follow the RC's instructions.