Difference between revisions of "CODA"

From PREX Wiki
Jump to navigationJump to search
Line 4: Line 4:
  
 
== Starting Parity DAQ CODA ==
 
== Starting Parity DAQ CODA ==
[[File:DAQ_firstStart.png|thumb|600px|right|Figure 1 - Main CODA window when first started.]]
+
=== Starting the GUI ===
[[File:DAQ_CoolScreen.png|thumb|600px|right|Image 2]]
+
 
[[File:DAQ_Running.png|thumb|600px|right|Image 3]]
+
[[File:startcoda.png|thumb|600px|right|Figure 1 - Main CODA window when first started.]]
 +
[[File:Grey_icons.png|thumb|400px|right|Figure 2 - Icons at the top of the GUI, before loading a configuration.]]
 +
[[File:Green_configure.png|thumb|400px|right|Figure 3 - After loading the configuration, you can now press ''Configure''.]]
 +
[[File:Green_prestart.png|thumb|400px|right|Figure 4 - After configuring, you can now press ''Download'', then ''Prestart''.]]
 +
[[File:Green_start.png|thumb|400px|right|Figure 5 - After a successful prestart, you can now press ''Go'' and then ''End''.]]
 +
[[File:Start_success.png|thumb|600px|right|Figure 6 - CODA window after a successful run start.]]
 +
 
 
* Log in as '''apar@adaq1'''
 
* Log in as '''apar@adaq1'''
* On the terminal type '''startcoda''': 4 xterms will appear as well as the main CODA window (see Figure 1). CODA will automatically load the last configuration used. If you are ok with this then just go to '''Platform->Connect'''
+
* In a terminal type '''startcoda'''
* To change the configuration, choose '''Configuration->Cool'''
+
** 4 xterms will appear (red, orange, green and yellow) as well as the main CODA window (see Figure 1)
** Select the desired configuration. It will automatically connect the selected configuration.
+
** CODA will automatically load the last configuration used. If you are ok with this then just go to ''Platform->Connect''
**  
+
* To change the configuration, choose ''Configurations->Cool''
* '''Configure''' (the work tool icon top left)
+
** Select the desired configuration from the dropdown list
* '''Download''' (second icon top left)
+
** Production running would be ''ALL_PREX''
* '''Prestart''' (third icon): In the previous steps, warnings about waiting for a roc can be ignored if it does not take too long to respond (~10s). Do watch for Error messages. ''Those cannot be ignored!''
+
** Once you have loaded a configuration, some of the icons (see descriptions below) will change from ''grey'' (see Figure 2) to ''green'' (Figures 3-5)
* '''Start''' (4th icon)
+
* Press the configure icon (see Figure 3)
 +
** Warnings about waiting for a ROC can be ignored if it does not take too long to respond (~10s) and things are eventually successful
 +
** Error messages should be taken seriously
 +
*** You can try a ''Reset'' and re-''Configure''
 +
*** If that doesn't work - see [[DAQ Troubleshooting#For shiftworkers|DAQ Troubleshooting]]
 +
* Press the ''Download'' icon (see Figure 4)
 +
 
 +
 
 +
=== Starting a run ===
 +
 
 +
* After starting the GUI and loading a configuration (see above)  
 +
* Press the ''Prestart'' icon (see Figure 4)
 +
** a window will pop up where you can add notes if necessary (not yet implemented for PREX)
 +
** submit or save the notes if applicable
 +
** As above, warnings about waiting for a ROC can be ignored (if it does not take too long to respond, ~10s) and things are eventually successful
 +
** Error messages should be taken seriously!
 +
*** You can try a ''Reset'' and re-''Configure''
 +
*** If that doesn't work - see [[DAQ Troubleshooting#For shiftworkers|DAQ Troubleshooting]]
 +
* Press ''Go'' (see Figure 5)
 +
** the event counter should start incrementing (see Figure 6)
 +
** the event rates should be expected values
 +
 
 +
 
 +
=== Ending a run ===
 +
 
 +
* Press ''End''
 +
** if this was a normal end of the run, and it ends successfully
 +
*** all the states should change to ''downloaded''
 +
*** the ''Prestart'' icon should be green
 +
* If the run ends because of a problem with CODA - see [[DAQ Troubleshooting#For shift workers|DAQ Troubleshooting]]
 +
 
 +
== Description of the GUI ==
 +
 
 +
Numbered from the top left of the GUI window (see any of the Figures):
 +
 
 +
# '''Configure''' (tools) - this opens a drop-down menu to choose the configuration
 +
# '''Download''' (floppy disk) - this loads the chosen configuration to the crates
 +
# '''Prestart''' () - this will prepare to start a run
 +
# '''Go''' (triangle with point to right) - this starts a run
 +
# '''End''' (square) - this ends a run
 +
# ''' Fast Start''' (double-triangle pointing right) tries to go through all the steps (can be used as long as things aren't changing)
 +
# ''' Reset''' (double-triangle pointing left) configured, but not downloaded (if you need to change configuration or GUI is wonky)
 +
# ''' Pause ''' (two vertical bars) - pauses a run (rarely used - to quote Paul King ''"Nothing good can come of this."'')
  
* '''End''' (5th icon)
 
  
 
== Instructions for shift checklist ==
 
== Instructions for shift checklist ==

Revision as of 14:32, 9 June 2019

In the process of editing and updating this page. Please contact Juliette Mammei crowder@jlab.org with questions or suggestions.

PREX Main

Starting Parity DAQ CODA

Starting the GUI

Figure 1 - Main CODA window when first started.
Figure 2 - Icons at the top of the GUI, before loading a configuration.
Figure 3 - After loading the configuration, you can now press Configure.
Figure 4 - After configuring, you can now press Download, then Prestart.
Figure 5 - After a successful prestart, you can now press Go and then End.
Figure 6 - CODA window after a successful run start.
  • Log in as apar@adaq1
  • In a terminal type startcoda
    • 4 xterms will appear (red, orange, green and yellow) as well as the main CODA window (see Figure 1)
    • CODA will automatically load the last configuration used. If you are ok with this then just go to Platform->Connect
  • To change the configuration, choose Configurations->Cool
    • Select the desired configuration from the dropdown list
    • Production running would be ALL_PREX
    • Once you have loaded a configuration, some of the icons (see descriptions below) will change from grey (see Figure 2) to green (Figures 3-5)
  • Press the configure icon (see Figure 3)
    • Warnings about waiting for a ROC can be ignored if it does not take too long to respond (~10s) and things are eventually successful
    • Error messages should be taken seriously
  • Press the Download icon (see Figure 4)


Starting a run

  • After starting the GUI and loading a configuration (see above)
  • Press the Prestart icon (see Figure 4)
    • a window will pop up where you can add notes if necessary (not yet implemented for PREX)
    • submit or save the notes if applicable
    • As above, warnings about waiting for a ROC can be ignored (if it does not take too long to respond, ~10s) and things are eventually successful
    • Error messages should be taken seriously!
  • Press Go (see Figure 5)
    • the event counter should start incrementing (see Figure 6)
    • the event rates should be expected values


Ending a run

  • Press End
    • if this was a normal end of the run, and it ends successfully
      • all the states should change to downloaded
      • the Prestart icon should be green
  • If the run ends because of a problem with CODA - see DAQ Troubleshooting

Description of the GUI

Numbered from the top left of the GUI window (see any of the Figures):

  1. Configure (tools) - this opens a drop-down menu to choose the configuration
  2. Download (floppy disk) - this loads the chosen configuration to the crates
  3. Prestart () - this will prepare to start a run
  4. Go (triangle with point to right) - this starts a run
  5. End (square) - this ends a run
  6. Fast Start (double-triangle pointing right) tries to go through all the steps (can be used as long as things aren't changing)
  7. Reset (double-triangle pointing left) configured, but not downloaded (if you need to change configuration or GUI is wonky)
  8. Pause (two vertical bars) - pauses a run (rarely used - to quote Paul King "Nothing good can come of this.")


Instructions for shift checklist

  • Latest run type (Test, Physics,..)
  • Is the auto replay script running (ask the analysis expert)?
  • Is the PREX run list (in a white binder) completed? (are we going to do this?)
  • Please attach the left/right HV and Scalers Screenshots to the shift report
  • Time of beginning of latest run (RHRS)
  • Latest run number
  • Dead time (%)