Home

pdf-file

1. d myActionDataln wcxoitcACTION_MYDATA_IN Diagram name raoite Author Creation date 2 13 09 2 53 PM Modification date 2 17 09 11 49 AM 4 Replace action myActionDataln Init actionid ngcoitcACTION_ID_DATA_IN gt Init ral as Ss es EN ES sees suen a A e gt myActionSetup xxxoitcACTION_MYSETUP Replace action myActionSetup Init actionid ngcoitcAQTION_ID_SETUP gt Init D Fu 4 Figure 4 Post Processing Image Transfer Client sequence diagram VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 53 of 76 10 Synchronisation Synchronization points can be inserted at any place in any clock pattern executed by the sequencer program i e set the wait for trigger bit in the particular state When reaching such a point the pattern execution is suspended until the arrival of an external trigger signal see RD9 and RD8 for signal timing and accuracy Via this external trigger input it is possible to synchronize exposures on multiple NGCOSW instances The external trigger signal is also used to synchronize detector read outs with external devices Using the VLT TIM for generating the trigger pulse s synchronization at absolute times is possible Some signal lines are available to i
2. Assuming lt xxdcfg gt be the name of the instrument module install it cmmCopy lt xxdcfg gt cd lt xxdcfg gt src make all install then populate the INS_ROOT ngcoDcsInstall config lt xxdcfg gt lt options gt 2 5 1 INS ROOT population for multi DCS instruments For instruments using more DCSs see 5 ngcoDcsInstal1 must be called for each instrument detector For instance assuming to have four DCSs myCcCD1 myCcD2 myCCD3 myCCD4 whose configuration is defined by xxdcfgA xxdcfgB xxdcfgC xxdcfgD controlled by a Super Control process my INSTRUMENT whose configuration is defined xxdcfgSdcs ngcoDcsInstall config lt xxdcfgA gt instance myCCD1 lt options gt ngcoDcsInstall config lt xxdcfgB gt instance myCCD2 lt options gt ngcoDcsInstall config lt xxdcfgC gt instance myCCD3 lt options gt ngcoDcsInstall config lt xxdcfgD gt instance myCCD4 lt options gt ngcoDcsInstall config lt xxdcfgSdcs gt instance myINSTRUMENT lt options gt Manpage of ngcoDcsInstall is available in 16 1 2 VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 16 of 76 3 Startup Shutdown Procedure 3 1 System Configuration NGCOSW usually see section 3 1 1 runs partly on the IWS and partly on the NGC LLCU where the physical interface s to the NGC detector fr
3. Operational state ONLINE CCDLENYV wodt6 Startup Shutdown HW sim Normal Online Standby off ngcoDesStop instance muse env wodt6 leny wodt6 kill ngcoDesStart xterm T instance muse eny wodt6 leny wodt6 opmode NORMAL autonlin F gui NONE kill msgSend wodt6 ngcocon_muse STANDBY msgSend wodt6 ngcocon_muse ONLINE Help Reload config Eng Interface Start End Exposure Type Normal 9 Pot EFGH 500kLG Interval lt gt Exposures Num of Frames Image File Name jo Wipe time before Exp 0 fa JdeFault Windows Exposure Configuration Exposure Status Abort Mode Description 9 Port EFGH 500k LG Status INACTIVE Pause Exposure type Normal Shutter Status SHUTTER CLOSED Continue Repetitions 1 Remaining Time 0 sec End Loop Time D sec Wipe Disabled Readout Time 0 sec Wipe Percentage D Per Wipe File Name Transfer Time 0 sec Stop Wipe Exposure Setup Number of exposures 1 X Binning E Save Setup Exposure Mode Integration Time Io YBinning ft Load Setup Mut Exposures 9 Port EFGH 500k LG DET MODE9 WCLDFIL1 muse_psyche v DET MODE9 WCLKFIL1 muse_ACS bclk IDET MODE9 WPRGFIL1 mode9 seq DET MODE9 WCLDFILZ muse_psyche v IDET MODES W
4. sssssssssnnrnseerrneeereerssrrrrnerrnn 42 Table 8 Setup keywords for multistep evposures s nssssseseeeseneerssttrrseernntrrnrnressrrrn nerne 42 Table 9 Setup keywords for windowing not yet implemented ssnnssssseseeseneeessrrrseren n 42 Table 10 Setup keywords for image display ssssessssnrssserneeettressrtrnrerennersteressrrrnnnrennee 43 Table 11 Errors common to all NGCOSW modules sssnnneseeneeeeeeeennnnnnnnseeernnnnnnnnsnneeeeena 55 Table 12 Errors specific to the ngcoit module eceececeeeeeeeeeeeeeeeeeeeneeeeseeeesneneeeeeeeeees 55 VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 7 of 76 1 Introduction The software described in this manual is intended to be used in the ESO VLT project by ESO and authorized external contractors only While every precaution has been taken in the development of the software and in the preparation of this documentation ESO assumes no responsibility for errors or omissions or for damage resulting from the use of the software or of the information contained herein 1 1 Purpose This document is the User Manual of the Next Generation detector Controller NGC Control Software for optical instruments NGCOSW It is intended to provide people who intend to use the NGC Controller for optical Instruments with all the necessary information to install from scratch the NGCOSW
5. DCS configuration FEAE TE FE TE AE RE EE HERE EE REE RE EE HEHE EE FEE EEE HERE HERE EE EERE EEE HEHE EE HH DET CON SYSCFG ngcoptDCS cfg HW system configuration file HEE HEE HE HEE HEE HE HEE HE HE EEE EE HE EEE EE EEE EE HEE EEE EE EEE CHIP description HEHE TE HE EEE TE HE FE TE HE FE E HE FE HE EEE EE HEE HEE dd E E E E E E E EE E EEE EEE EE EEH DET CHIP1 ID SER NO 053 Detector chip identification DET CHIP1 NAME Marlene Detector chip name DET CHIP1 DATE 2006 L1 22 Date of installation YYYY MM DD Ca EN SIS O at New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 6 0 04 05 2010 Page 27 of 76 DET CHIP1 NX 2048 DET CHIP1 NY 4096 DET CHIP1 PRSCX 50 DET CHIP1 PRSCY 0 DET CHIP1 OVSCX 50 DET CHIP1 OVSCY 0 DET CHIP1 PSZX T50 DET CHIP1 PSZY LS OF DET CHIP1 OUTPUTS 2 DET CHIP1 X S DET CHIP1 Y Is DET CHIP1 XGAP 0 0 DET CHIP1 YGAP Ke DET CHIP1 RGAP 0 0 DET CHIP1 INDEX SE DET CHIP1 LIVE T DET CHIP1 TYPE CCDs DET CHIP1 PXSPACE 1E 6 DET CHIP1 OUT1 NAME NOL DET CHIP1 OUT1 INDEX 1 DET CHIP1 OUT1 ID EdOL DET CHIP1 OUT1 X 1 DET CHIP1 OUT1 Y 1 DET CHIP1 OUT1 READX 1 DET CHIP1 OUT1 READY 1 DET CHIP
6. Optical DCS User Manual 04 05 2010 Page 14 of 76 Verify that the needed processes are running in the CCS environment by using ccsPerfMon A view similar to the following should be displayed Process Name PNUM PID UID GID MSGID MONPID 0 00000000000000000000000000000000000000000000000000000000000000000000 ccsScheduler 1 4224 3227 300 1 ek ccsSHManager 2 4228 3227 300 1582563329 1 qsemu 3 4231 3227 300 1583415311 a evtEventConfg 4 4239 3227 300 1583087623 Sd timsTimeKeeper 5 4233 3227 300 1582825475 L scanMngr 6 4248 300 300 1583284234 1 ccsScan 7 4259 300 300 1583480856 Sch ccsCmdServer 8 4243 3227 300 1583153160 all alrmServer 9 4247 3227 300 1583218697 cmdManager 12 4236 3227 300 1582891012 el msgServer 13 4237 3227 300 1582956549 I logManager 14 4238 3227 300 1583022086 1 alrmLogger 16 4268 3227 300 1583677452 Sch hisDHMngr 17 4269 300 300 1583743004 4270 ccsPerfMon 22 6532 3227 300 1589313576 sl dbMQDBM 58 4232 3227 300 1582759938 i 2 3 4 Online database automatic startup On both the IWS and the LLCU the online database environment start automatically at boot by adding the following line to the file etc rc local su lt myUser gt c rm f VLTDATA ENVIRONMENTS RTAPENV RTAPENV lock vecEnvStart e SRTAPENV where lt myUser gt is the user managing the online database 2 3 5 Detector user In order for the online database to function cor
7. CRTE NAME ccumani Name of creator PAF CRTE DAYTIM 2007 08 31 Civil Time for creation PAF LCHG NAME W W ame of person appl changing PAF LCHG DAYTIM ue Timestamp of last change PAF CHCK NAME NW WE ame of appl checking PAF HDR END End of PAF Header HEE EE EH E EE EEE EE HEH HE EE EEE EE HE HE EE EEE EE HE HE HE EEE EE HE HE EE RE EE HE HH Global info HEE E HEHE EE EEE EE HEH HE EE EEE EE HE FE FE E HE EEE EE HE E E EERE E E HE E EE E E ERE EE HE HH DET ID NGCOPT Detector system Id DEI DATE 2009 05 18 Installation date DET NAME NGC OPT DCS Name of detector system DET CHIPS 1 Number of chips in the mosaic BITPIX 16 Number of bits per pixel CTYPE1 PIXEL Pixel coordinate system CRVAL1 1 Coordinate value of ref pixel CTYPE2 PIXEL Pixel coordinate system CRVAL2 1 Coordinate value of ref pixel He HE HERE HE HEH HE HE ERE HE HE HE HE EE EE HE HE EE ERE EE EEE HE EEE RE HE HEH HE HE HE DET configuration HEHE HEE RE HE HE HE HE ERE EE HE HE EE RE EH EEE HE ER EE HE HE HE RE HE HH HE HEH DET CON GUI ngcoui GUI Name DET CON ITCPROC muditc Image Transfer Client DET DEV1 NUMBOARD 1 Number of boards DET DEV1 BOARD1 TYPE FEB Board type DET DEV1 BOARD1 VERSION 1 Board version sub type PEPPER EEE HEHE EE EERE HEH EERE EE EEE EEE HERE PEER EEE EEE EE HH HEE EE HH
8. NGCOSW operational mode Valid values are default NORMAL NORMAL Normal Operational Mode Default NGC HW is used NGC SW runs on Instrument Workstation IWS and NGC LCU HW SIM HW is simulated Launch the specified grafical user interface If lt guiname gt NONE no gui is started If no lt guiname gt is given the default ngcouiPanel is used At the moment only the default program ngcouiPanel is used independently from the process name which is specified When set to T all processes are started in new xterminals Default is F When set to T the detector system automatically goes to ONLINE at startup Default is F Verbose level Prints out system messages to the standard output The level gives the detail of the messages Default value is 0 no verbose output Name of the image transfer client process to be launched in alternative to NGC Image Transfer Client Default is ngcoitc is used Name of the super control process to be launched in alternative to NGC Super Control Process Default is ngcosc is used VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 67 of 76 subsys Start the system as a subsystem of a multi DCS instrument By default NOT NOTE This option shall NOT be explicitely used it is used only internally when the utility calls itself to start multi DCS systems kill kill al
9. Shutter unique identifier DET SHUT1 MODE Normal Shutter operational mode DET SHUT1 OPACTHI T Open active high DET SHUT1 EVTEDG1 F Event rising edge DET SHUT1 EVTEDG2 T Event rising edge DET SHUT1 EVTEDG3 Event rising edge DET SHUT1 EVTEDG4 T Event rising edge 000 VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 30 of 76 3 2 3 4 Super Control Process Configuration Set PAF HDR START Start of PAF Header PAF TYPE Configuration Type of PAF PAP Ip SUPER DCS ID for PAF PAF NAME SUPER DCS ame of PAF PAF DESC SUPER DCS Configuration Short description of PAF PAF CRTE NAM ccumani ame of creator PAF CRTE DAYTIM 2009 12 01 Civil Time for creation PAF LCHG NAME W Ze ame of person appl changing PAF LCHG DAYTIM va Timestamp of last change PAF CHCK NAME NW WE ame of appl checking PAF HDR END End of PAF Header System configuration DET CON INSTANCE myInst DET CON EN
10. interact programmatically with the NGCOSW operate an optical camera as a simple standalone instrument The manual assumes that the reader has some knowledge of C C and Tcl Tk languages UNIX Operating System VLT Software in particular CCS It is not intended to be an introduction to optical CCD cameras and therefore it uses common terminology in this field e g pixel binning readout frame transfer chip etc without further explanation The control software for infrared applications NGCIRSW is described in a separate manual RD77 Basically the NGC electronics AD8 is the same for both infrared and optical applications Nevertheless there are many differences concerning the usage of the controller and the data acquisition and data handling procedures To cover both applications in an effective way and also to have a certain backwards compatibility with the predecessors FIERA and IRACE different SW architectures have been chosen which are described in detail in the NGC SW design documents AD9 AD10 and AD11 The following paragraph summarizes the main differences e Detector Read Out Schemes For an infrared detector CMOS non destructive readout the clock pattern generation runs in an infinite loop and the detector is read out reset all the times An optical detector CCD destructive readout is read out just once at the end of an exposure Data Handling The optical application delivers one frame at the end of the
11. DET MODE2 OUT1 INDEX 1 Output index on the chip DET MODE2 OUT1 XIMA 1 Horizontal location of data in image DET MODE2 OUT1 YIMA 1 Vertical location of data in image DET MODE2 OUT1 NX 1024 Output data pixels in X DET MODE2 OUT1 NY 500 Output data pixels in X DET MODE2 OUT1 PRSCX 50 Output prescan pixels in X DET MODE2 OUT1 PRSCY 0 Output prescan pixels in Y DET MODE2 OUT1 OVSCX 0 Output overscan pixels in X DET MODE2 OUT1 OVSCY 0 Output overscan pixels in Y DET MODE2 OU GAIN 0 3 Conversion from electrons to ADU DET MODE2 OUT1 CONAD 3 33 Conversion from ADUs to electrons DET MODE2 OUT1 RON 100 Readout noise per output e DET MODE2 OUT2 CHIP 1 Index of chip the output belongs to DET MODE2 OUT2 INDEX 2 Output index on the chip DET MODE2 OUT2 XIMA 23 Horizontal location of data in image DET MODE2 OUT2 YIMA E Vertical location of data in image DE ODE2 OUT2 GAIN 043 Conversion from electrons to ADU DET MODE2 O0UT2 CONAD 3 33 Conversion from ADUs to electrons DET MODE2 OUT2 RON 200 Readout noise per output e DET MODE2 SHACTHI Ey Open active high DET MODE2 SHMODE Sequencer1 Shutter operational mode HP HE EH RE HE HE HE EAR HEH EE HE EE RE EE RAIER EE RE EE EA EA RE EE EA HEH SHUT description HP HE EERE HE HH HE HEE RE HEH EE HE HEE RE EE HE HE EE RE EE EE EE HEE RE EE HEH HE HEH DET SHUT1 AVAIL T Shutter available or not DET SHUT1 CTRL pech Shutter controller DET SHUT1 TYPE nostatus Shutter type DET SHUT1 ID eso 0O1
12. E E e e 61 VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 6 of 76 VG ANTM SS iiciin seneti a aeriene sel tents Gai daa a Gaa naaadik 62 161 1 ACSI EEN 62 Ree e EE 64 gS ei Pes e ee EE 66 16 14 e e Re EE 68 16 1 5 ngcoGetProc NUM E 70 16 1 6 ngcoDesClean EE 71 16 1 7 DEE ETag eee 72 17 Example of NGCOSW usage E 73 List of Figures Figure 1 Optical NGC software Architecture ssssesssssesssssrnenernresssrrrnerrennerrrrrnsserrnnerennnt 17 Figure 2 Operational states and state transitions cccsecccceeeceeeeeeeeeeeeeeeeeeeeessesenaaees 32 Figure 3 Post Processing Image Transfer Client dass 51 Figure 4 Post Processing Image Transfer Client sequence diagram cccceseeeees 52 Figure 5 Optical NGC Control Panel sssssssesssneesneesssrrrnsrernrrtrnrrsserrnntrrennntsrernssernnnnnennne 59 Figure 6 NGC Engineer Fame dtegeregdeugeeg aset den tee Eden EES 60 List of Tables Table 1 Startup Configuration K V Words wiiicsscsccescsicsenssasasdsnanensnsieraasassneeaedeoendssadinensnioanenes 21 Table 2 Gommandi EE 34 Table 3 Special command let 35 Table 4 Online database attributes for detector system monitoring ssssssssseessrrrssereeee 39 Table 5 Online database attributes for TC 39 Table 6 Basic Setup keywords for single exposure EE 41 Table 7 Additional Setup keywords for loops Of exvposures
13. ARCHIVE NAME NGCOSW CONFIG ARCHIVE USER ee CONFIG ARCHIVE MODULE opdcfg CONFIG ARCHIVE FILE1 opdcfg cfg CONFIG ARCHIVE FILE2 opdcfg 000 VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 24 of 76 3 2 3 2 Configuration Set lt label gt DCS cfg PAF HDR START Start of PAF Header PAF TYPE Configuration Type of PAF PAF ID Ditz ID for PAF PAF NAME NGCOSW Name of PAF PAF DESC NGCOSW Startup Configuration Short description of PAF PAF CRTE NAME ccumani Name of creator PAF CRTE DAYTIM 2007 08 31 Civil Time for creation PAF LCHG NAME W W ame of person appl changing PAF LCHG DAYTIM ue Timestamp of last change PAF CHCK NAME NW WE ame of appl checking PAF HDR END End of PAF Header HEE FE E TE FE FE EE EEE EE HEH HE EE EEE EEE FE HE E EE EEE EE E EE E E E E E E E E E E HE E E E E E EEE EE HE HH System configuration HEHEHE HE EE EEE EE HEH HE EE ANE EA HE HE EEE EE HE EH HE ERE EE ERE HE RE EA A DET CON INSTANCE ngcopt Instance label DET CON ENV myrtap Local online database environment DET CON LENV mylenv Remote online database environment DET CON OPMODE NORMAL Operational mode DET CON AUTONLIN F Go online after start DET CON GUI ngcoui GUI Name DET CON DICT NGCDCS NGCCON Dictionary list DET CON
14. MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 9 of 76 The bold and italic styles are also used to highlight words 1 8 Naming Conventions This implementation follows the naming conventions as outlined in AD27 1 9 Problem Reporting Change Request The form described in AD72 shall be used 1 10 Acknowledgments Special thanks to Andrea Balestra for his fundamental contribution to the development of the NGCOSW and Luigi Andolfato for his precious support and suggestions on wsf VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 10 of 76 2 Installation and configuration NGCOSW runs on ESO standard Instrument Workstations IWS and NGC LLCUs The VLTSW version 2008 or more recent must have been already installed on the hosts 2 1 Software Modules All software modules are under CMM configuration control Before installing the NGC optical detector control software package NGCOSW the NGC base software package must be installed see RD9 and AD10 The NGCOSW package consists of e ngco This module contains all required scripts for system startup and shutdown plus a set of utilities e ngcocon The NGC system coordination module for optical applications This includes all required scripts for system startup and shutdown e ncgoctr The NGC exposure Control module for optical applicati
15. Setup keywords for multistep exposures Keyword Type Description DET WIN lt i gt STRX II Integer First lower left window pixel in X direction DET WIN lt i gt STRY Integer First lower left window pixel in Y direction DET WIN lt i gt NX Integer Number of pixels along X DET WIN lt i gt NY Integer Number of pixels along Y Table 9 Setup keywords for windowing not yet implemented NOTE in the actual version of N COWS windowing is not implemented New General Detector Controller Issue 6 0 Optical DCS User Manual VLT MAN ESO 13660 4086 04 05 2010 Page 43 of 76 Keyword Type Description Real Time image display 1 no display BEES EE Integer o full frame display 16 bits 1 rapid frame display 16 bits DET CHIP lt i gt CRPIX lt i gt Integer Reference pixel in lt i gt direction DET FRAM SAMPLE TI Integer Image sampling on workstation f Defines how many sequential image data shall DET READ NFRAM Integer be stored inside a single FITS file Default is 1 Data storage method Possible values 0 none image is not saved on disk DET FRAM FITSMTD Integer 1 compressed 2 uncompressed 3 both DET FRAN FILENAME String Define the base filename for the data files produced during the exposure Table 10 Setup keywords for image display Arguments of the SETUP command can be file containing set
16. defined in AD28 If the command START has no exposure Id parameter the exposure Id is defined by NGCOSW The exposure Id is returned as a reply parameter to the command START 9 1 5 Changes with respect to FIERA NGCOSW implements the same exposure and status types of the FIERASW NGCOSW defines the same exposure status numerical values of the FIERASW a part from the one labelling the WIPING status see ngco h NOT YET IMPLEMENTED Has a new feature it will be possible to start a new exposure when the data of the previous one have been transmitted to the IWS but not stored on disk yet although this will NOT be the default behavior 9 2 Commands Exposures are prepared using the SETUP command and started using the START command A timed exposure start can be done using the at option START at lt YYYY MM DD gt T lt hh mm ss gt The value of the at parameter defines an absolute time UTC for the opening of the shutter an absolute time for a dark exposure has no sense Until the actual start time is reached the exposure status is set to pending which will limit the set of accepted commands during that time An exposure can be paused using the command PAUSE note that the time the exposure is PAUSE d will be added to the dark s time see RD63 The shutter is closed and the counting of the remaining exposure time suspended The exposure is then restarted by the command CONTINUE The exposure can be aborted u
17. for tat tests FILES Source files SVLTTOP config dcfgCONFIG cfg ctoo configuration file for the optical NGC detector SVLTTOP config dcfgDCS cfg DCS configuration file for the optical NGC detector SVLTTOP config dcfgCAMERA cfg system configuration file for the optical NGC detector SVLTTOP config dcfgCAMERA_TARGET cfg target configuration file for the optical NGC detector SVLTTOP config dcfg Files defining the detector voltages clock patterns and sequences VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 65 of 76 Optical detector template files SVLTTOP templates forNGC xxopt xxoptCONFIG cfg ctoo configuration file for the optical NGC detector SVLTTOP templates forNGC xxopt xxoptDCS cfg DCS configuration file for the optical NGC detector SVLTTOP templates forNGC xxopt xxoptCAMERA cfg system configuration file for the optical NGC detector SVLTTOP templates forNGC xxopt xxoptCAMERA_TARGET cfg target configuration file for the optical NGC detector SVLTTOP templates forNGC xxopt xxopt Files defining the detector voltages clock patterns and sequences Destination files lt ins_root gt SYSTEM COMMON CONFIGFILES S CCDNAME CONFIG cfg lt ins_root gt SYSTEM COMMON CONFIGFILES CCDNAME DCS cfg lt ins_root gt SYSTEM COMMON CONFIGFILES S CCDNAME CAMERA cfg lt ins_root g
18. post processing The possibility of performing customized post processing is implemented by means of a virtual PostProcessing method added to the DATA_IN action class of the Image Transfer Client process module ngcoitc The application that needs to implement some specific post processing must define a class that inherits from ngcoitcACTION_DATA_IN and that overrides the Post Processing method The new class must then substitute the default action manager for the DATA_IN event Among procedures that can be implemented in this way are e g centroiding and bias subtraction Figure 3 and Figure 4 describe the class and the sequence diagrams of the mechanism 9 6 1 Creating a module which implements post processing Instructions and a template are provided in the xxxoitc module which is installed in the SVLTTOP templates forNGc directory To create a module for instance newoitc which implements post processing go into the appropriate directory and run ngcoDcsTemplate sh template xxxoitc module newoitc In the local directory anewoitc module is then created VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 50 of 76 By running cd newoitc sre make man the documentation concerning the implementation of post processing is the installed in the newoitc doc directory in MagicDrawXML and html format Shortly e Inthe newoitc ACTION_MYDATA_IN C f
19. state and the additional shutter control whereas the infrared control server mainly reacts passively on incoming data frames once the exposure is started So basically the demands on process concurrency are very different in both cases A conscious effort has been made to maintain a certain degree of backwards compatibility of NGCOSW with FIERASW Where applicable a hint to the major changes with respect to FIERASW can be found at the end of each section 1 2 Scope Scope of this document is the NGC Control Software for optical instruments NGCOSW 1 3 Applicable Documents Applicable documents used in the NGC project are listed in the document VLT LIS ESO 13660 3906 NGC Project Documentation 1 4 Reference Documents Reference documents used in the NGC project are listed in the document VLT LIS ESO 13660 3906 NGC Project Documentation 1 5 Abbreviations and Acronyms Abbreviations and acronyms used in the NGC project are listed in RD64 1 6 Glossary All the relevant concepts used within the NGC project are listed in RD63 1 7 Stylistic Conventions The following styles are used bold in the text for commands filenames pre suffixes as they have to be typed italic in the text for parts that have to be substituted with the real content before typing courier for examples commands filenames as they have to be typed lt name gt in the examples for parts that have to be substituted with the real content VLT
20. the option instance option starts the coordination control process and waits with a default timeout until the coordination control process is active i e it responds to PING commands options can be used to overwrite the values of the parameters in the configuration set keywords instance overwrites DET CON INSTANCE env overwrites DET CON ENV lenv overwrites DET CON LENV opmode overwrites DET CON OPMODE VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 22 of 76 dfemode overwrites DET CON DFEMODE autonlin overwrites DET CON AUTONLI gui overwrites DET CON GUI dict overwrites DET CON DIcT xterm overwrites DET CON XTERM log overwrites DET CON LOG ite overwrites DET CON ITCPROC osc overwrites DET CON OSCPROC Further special options are ill kill existing NGCOSW processes if any before starting 3 2 3 Changes with respect to FIERA FIERAsw configuration was online database driven i e the configuration of a detector was described within a dbcfg database configuration file which was loaded at startup NGCOSW uses ctoo the dbcfg file is now substituted by the startup configuration file and the configuration set The script ngcoDcsStart replaces the script fcdDcsStart If the startup script of NGCOSW is used w
21. 1 OUT2 NAME NO2 DET CHIP1 OUT2 INDEX 2 DET CHIP1 OUT2 ID Titele DET CHIP1 OUT2 X 2048 DET CHIP1 OUT2 Y 1 DET CHIP1 OUT2 READX 1 DET CHIP1 OUT2 READY 1 DET CHIP1 CRPIX1 SE DET CHIP1 CRPIX2 i HEHEHE FE FE FE FE FE FE FE FE FE EERE EEE EEE EEE EEE EEE MODE description FETE TE FE FE TE TE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE EEE EEE HEH MODE1 DET MODE1 NAME Testl DET MODE1 DESC Test mode 1 DET MODE1 TRIGGER F DET MODE3 GAIN1 13 DET MODE3 GAIN2 13 DET MODE3 GAIN3 13 DET MODE3 GAIN4 13 DET MODE3 BNDWTH1 0 DET MODE3 BNDWTH2 0 DET MODE3 BNDWTH3 0 DET MODE3 BNDWTH4 0 DET MODE1 WREP 1 Physical Physical Physical Physical active pixels in X active pixels in Y prescan pixels in X prescan pixels in Y Physical overscan pixels in X Physical overscan pixels in Y Size of pixel in X mu Size of pixel in Y mu umber of outputs per chip X location in array Y location in array Gap between chips along x mu Gap between chips along Y mu Angle of gap between chips Chip index Detector alive The Type of detector chip Pixel Pixel Spacing Description of output Output index Output ID as from manufacturer X location of output Y location of output Horizontal readout direction Vertical readout direction Description of output Output index Output ID as from manufacturer X location of output Y location of output H
22. 9 1 1 Exposure types macros are defined in ngco h 9 1 2 Description of exposure status values improved 9 1 2 Exposure status macros are defined in ngco h 9 1 4 NGCOSW creates exposure Id if not passed at START 9 1 5 Description of differences with FIERA corrected 3 0 18 06 2008 1 Reference to DOORS obsolete 2 Removed NGC base package modules 2 1 Updated list of NGCOSW modules 2 4 Online database environment generation added 2 5 INS_ ROOT population added 3 1 1 Configuration Set updated 3 2 1 Software Test mode removed 3 2 1 DET CON GUI follows IR definition 3 2 1 DET CON XTERM added 3 2 3 2 xterm option added 3 2 3 2 kill option removed 3 2 3 2 Local Software Test mode removed 4 Command interface table updated 4 1 Changes with respect to FIERA updated 7 1 Complete Setup chapter removed obsolete 7 1 prev 7 2 List of changes updated 13 rtd interface description updated 14 Description of GUIs added 15 2 Evaluation of T P implementation added 16 STANDBY and exposure status readout added VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 3 of 76 4 0 30 10 2008 2 3 prev 2 4 Oldb generation split btw IWS and LLCU cases 2 3 1 Online database environment generation added 2 3 2 Online database environment generation added 2 3 3 Online database verification added 2 3 4 Online database startup added 2 3 5 Detector user description added 2 4 Lo
23. Accepted by ESO Technical Archive 04 05 10 EUROPEAN SOUTHERN OBSERVATORY Organisation Europ enne pour des Recherches Astronomiques dans I H misph re Austral Europ ische Organisation f r astronomische Forschung in der s dlichen Hemisphare VERY LARGE TELESCOPE INSTRUMENTATION DIVISION New General detector Controller Optical DCS User Manual Document Number VLT MAN ESO 13660 4086 Document Issue 6 0 Date of Issue 04 05 2010 Prepared by Name Date Signature Claudio Cumani ON E Zolo Uc l Approved by Name Date Signature Dietrich Baade 04 05 2910 Deh Baa ok Released by Name Date Signature k Mark Casali ls io MX ful e VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 2 of 76 CHANGE RECORD ISSUE DATE SECTIONS REASON INITIATION AFFECTED DOCUMENTS REMARKS 22 09 2006 First draft basic information for optical prototype f II 31 07 2007 A Document widely rewritten on the base of the comments to the first draft and of the NGCOSW implementation 2 0 31 08 2007 1 1 Optical exposure loop description corrected 2 1 ngcoctr module added 3 1 1 Local Hardware Test renamed Local Software Test 3 1 1 Operational mode macros are defined in ngco h 3 2 3 2 Configuration values updated 4 Command interface table updated 6 1 List of public online database attributes updated 6 1 NOTE added 7 SETUP can be issued also for paused exposure
24. CLKFIL2 muse_ACS belk IDET MODES WPRGFIL2 mode9 seq Name of CLDCi FILE for wipe Name of SEQi CLKFILE for wipe Name of SEQi PRGFILE for wipe Name of CLDCi FILE for wipe Name of SEQi CLKFILE for wipe Name of SEQi PRGFILE for wipe Figure 5 Optical NGC Control Panel 14 2 Engineering Interface A GUI panel is provided to help engineers in case of trouble see Figure 6 It is evoked from the Control Panel and enables the most common operations needed for engineering The panel gives freedom to do actions at a low level and must be used with care VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 ES Optical DCS User Manual 04 05 2010 Page 60 of 76 It is assumed that the user knows the NGC sw and the VLT sw environment and is fully aware of the actions associated to each button and possible consequences Die NGC HW Control Panel wodt6 Instance_muse File Mode Online ONLINE idle Mode NORMAL Detector Configuration Read Mode cLDC 1 VoltageFile i PARAM PREAMP AO HISTORY Status disabled Output Disable Save Restore All Voltages Bias DC Telemetry 0 0000 CC Restore 9 0000 93 0000 ea set 0 000 Telemetry PA Off Mon 1 1 Mon2 1 Diode Output Disable ail Instance Sequencer 1 Start Stop 1 Continuous Mode J Trigger Mode SES Status i
25. E E E E E E E E HE HE HE HE HE HE HE HE H HE H HHH HE E E E HE HH associated device index route to module optional name Run control active External convert active FE E E E HE E E E E E HE HE HE HE HE HE HE HE H HE HE HE H E E E E E HE HH E E E E E E E E E E HE E HE HE HE E HE HE H HE H EHH E HHH HE HH associated device index route to module optional name offset value for ADC volt number of ADCs on board ADC bits per pixel ADC channel to monitor simulation level of ADCs operational mode of ADC module first in chain convert on strobe 2 convert on strobe 1 packet routing length packet size Filter 0 0 5068 1 Analog Clamp and Sample Number of enabled ADCs on board 5us PEE HHT HE EH EE EEE AE FE HE EH HE E FE H HEE EEHEHE E EE EE HEHEHE HEHEHE EE HH HF Device index Route to module Optional module name Preamp revision FE AEE EE HE HE HE FE AE FE EEE AE FE HE EE HE HEH E E E E FE E E AE E E HE E HE EEE EEE HEHE EHH HE HH Device index Route to module Optional module name E VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 26 of 76 3 2 3 3 Configuration Set lt label gt CAMERA cfg PAF HDR START Start of PAF Header PAF TYPE Configuration Type of PAF PAF ID Ditz ID for PAF PAF NAME NGCOSW Name of PAF PAF DESC NGCOSW Startup Configuration Short description of PAF PAF
26. E HEHEHE EHH EVIDX OUTE j D R NAME We R 0 0 00g NNnNNNW yj E Ge Q Q EQ Q Q 1 CVTE D D ET J HEHE HEH HHH ADC description HEEHH HEH HHH ET ET ADC1 lt ADCI ADC1 DEVIDX ROUTE W NAME ET ADC1 ET ADC1 ET ADC1 e e ei Gi ET ADC1 ET ADC1 ET ADC1 ET ADC1 ET ADC1 N Hy ET ADC1 ET ADC1 ET ADC1 F ET ADC1 ET ADC1 weve ee eee BHONO ET ADC1 HERE R EEE HEE HEE E Preamp description HEE FE E FE AE HEE HEE PREAMP 1 DEVIDX PREAMP1 ROUTE PREAMP 1 NAME EI EI EI HHHH PREAMP1 REV Z SHUT HEPEEREEE HEE description EERE EHEHEH ET SHUT1 DEVIDX ET SHUT1 ROUTE ET SHUT1 NAME 000 UNCTRL T XT F 1 D HEH ETE HEE HE HEE HH HEHE HEE EH HE HH tr 20 Sequencer 1 F D HEHE HEE HEHEHE H H HEHE THEE HE HEE H H DH GH ADC Module 1 Ne NE Ne Ne Ne Ne Ne Ne o e HEHE THEE HE HEE H H HEHE TE AE FE TE HE HEE EH 1 Zs Preamp 1 s03 HEPHHEEEEHEEEH EEE HHEPHHEEEEHEEE HEHE 1 M Shutter 1 Issue 6 0 04 05 2010 Page 25 of 76 E E E E E E E E E E E E HE EEE ESE EHH HE HH HH HH FE E
27. EXIT 3 Try to terminate NGC optical processes in a hard way kill optional instance lt ccdname gt detector name default CCDNAME env lt env gt name of workstation online database environment default SRTAPENV If value is FALSE no action on WS part of NGCOSW is taken lenv lt lenv gt name of remote online database environment default SCCDLENV If value is FALSE no action on LCU part of NGCOSW is taken kill kill all processes killpulpo kill also pulpo server ENVIRONMENT CCDNAME default for camera name e g myccd RTAPENV default for WS local environment e g myws CCDLENV default for LCU environment e g myngc RETURN VALUES 0 if SUCCESS 1 if FAILURE CAUTIONS a rhosts file on LCU system must contain user and hostname where this script runs since it performs remote shell commands b The kill options should be used with care By killing processes blindly the system could remain in a dangerous state To be used only to recover when the system gets stuck EXAMPLES gt ngcDcsStop instance myccd env myws lenv myngc Terminate in a soft way the NGCOSW both at WS and LCU level for camera myccd WS environment myws LCU environment myngc gt ngcDcsStop instance myccd env myws lenv myngc kill Terminate in a hard way the NGCOSW both at WS and LCU level for camera myccd WS environment myws LCU environment myngc gt ngcDcsStop instance myccd env myws lenv FALSE kill Term
28. GCROOT2 Appl_data lt myPATH gt DCSNAME CCDNAME2 define ngcdcsINSTANCE2 ngcdcs_ lt myCCDNAME2 gt define CCDNAME3 lt myCCDNAME3 gt define NGCROOT3 Appl_data lt myPATH gt DCSNAME CCDNAME3 define ngcdcsINSTANCE3 ngcdcs_ lt myCCDNAME3 gt define CCDNAME4 lt myCCDNAME4 gt define NGCROOT4 Appl_data lt myPATH gt DCSNAME CCDNAME4 define ngcdcsINSTANCE4 ngcdcs_ lt myCCDNAME4 gt IMPORTANT Take care to define CCDNAMEi and ngcdcsINSTANCHi consistently i e with the same myCCDNAMEi String Once the DATABASE db and USER db files have been properly edited generate the environment in SVLTDATA ENVIRONMENTS S RTAPENV db1 run make clean db To initialize and start the environment run vecEnvinit e SRTAPENV vecEnvStart e SRTAPENV 2 3 2 NGC LLCU online database generation On the NGC LLCU the RTAPENV online database environment is automatically generated and started by running ngcoDcsOldb renv lt IWS_RTAPENV gt host LLCU Manpage of ngcoDcsOldb is available in 16 1 1 2 3 3 Online database verification On both the IWS and the LLCU verify that the environment has been generated dbRead lt alias gt lt myCCDNAME gt exposure control state replacing lt myCCDNAME gt with the name of the camera e g SCCDNAME VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0
29. GGER F Enable trigger DET MODE2 GAIN1 13 Gain used DET MODE2 GAIN2 13 Gain used DET MODE2 GAIN3 T3 Gain used DET MODE2 GAIN4 13 Gain used DET MODE2 BNDWTH1 D Bandwidth used DET MODE2 BNDWTH2 D Bandwidth used DE ODE2 BNDWTH3 D Bandwidth used DE ODE2 BNDWTH4 0 Bandwidth used DET MODE2 WREP 4 Wipe sequence repetition number DET MODE2 WCLDFIL1 wipel v ame of CLDCi FILE for wipe DET MODE2 WCLKFIL1 wipel bclk ame of SEQi CLKFILE for wipe DET MODE2 WPRGFIL1 wipel seq ame of SEQi PRGFILE for wipe DET MODE2 PREP 1 Preint sequence repetition number DET MODE2 PCLDFIL1 preintl v ame of CLDCi FILE for preintegration DET MODE2 PCLKFIL1 preintl bclk ame of SEQi CLKFILE for preintegration DET MODE2 PPRGFIL1 preintl seq ame of SEQi PRGFILE for preintegration DET MODE2 RREP 1 Readout sequence repetition number DET MODE2 RCLDFIL1 readl v ame of CLDCi FILE for readout DET MODE2 RCLKFIL1 readl bclk ame of SEQi CLKFILE for readout VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 29 of 76 DET MODE2 RPRGFIL1 readl seq Name of SEQi PRGFILE for readout DET MODE2 ADCSAMPL lt Be ADC data sampling factors DE ODE2 OUTPUTS 2 Number of outputs used for readout DE ODE2 ADC1 ADCS NA Outputs used for readout DET MODE2 OUT1 CHIP 1 Index of chip the output belongs to
30. IRONMENT RTAPENV default for oldb environment RETURN VALUES 0 if SUCCESS 1 if FAILURE EXAMPLES gt ngcoDcsClean VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 72 of 76 16 1 7 ngcoDcsTemplate NAME ngcoDcsTemplate sh Install and generate template module SYNOPSIS ngcoDcsTemplate template lt template gt module lt module gt DESCRIPTION Generate a new module from a template To be used to generate a new image transfer process implementing image data post processing or a super control process implementing new actions for standard commands template lt template gt Template to start from It must exist in VLTTOP templates forNGC module lt module gt Module to be generated from template FILES SVLTTOP templates forNGC template RETURN VALUES 0 if SUCCESS 1 if FAILURE EXAMPLES Create module to implement image data post processing gt ngcoDcsTemplate template xxxoitc module newoitc Create new super control process gt ngcoDcsTemplate template xxxosc module newosc VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 73 of 76 17 Example of NGCOSW usage Assuming that we are using an xx system xxdcfg instrument module and that we want to pass relevant parameters using environment variables a la FIERASW in the following example the NGCOSW is started and some
31. Id pulpo cfg v 1 44 2004 05 10 22 47 31 vltsccm Exp Pulpo configuration format is Pulpo_Unit_Number Full_Device_Path 1 dev ttyc 2 dev ttyd 15 2 Temperature pressure Monitoring At the moment the way the temperature pressure monitoring will be handled by NGC is under evaluation 15 2 1 Changes with respect to FIERA If NGCOSW will provide facilities to monitor temperature and pressure values from the detector no changes are foreseen with respect to the monitoring interface provided by the FIERASW 15 3 Adaptive Optics TBD New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 62 of 76 By VLT MAN ESO 13660 4086 der 16 Manpages 16 1 1 ngcoDcsOldb NAME ngcoDcsOldb sh Install and generate the online database environment SYNOPSIS ngcoDcsOldb host lt IWS LLCU gt renv lt renv gt lt renv2 gt lt renv3 gt lt gt instance lt ccdname gt env lt env gt user lt user gt DESCRIPTION On both the Instrument Workstation IWS and the NGC Linux LCU LLCU this shell script preliminary performs a system check definition of environment variables definition of local and remote environments on the local machine and in the ACC server scanning user running the software etc On an IWS this shell script then installs in the directory SVLTDATA ENVIRONMENTS SRTAPENV db1 the template files DATABASE db NGCOSW and USER db NGCOSW
32. PENV ngcocon_SCCDNAME START 12 Wait until the last exposure has been completed msgSend SRTAPENV ngcocon_SCCDNAME WAIT VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 74 of 76 13 14 15 16 17 18 19 20 21 22 Check the exposure status dbRead lt alias gt CCDNAME exposure control state Prepare the next exposure single exposure msgSend SRTAPENV ngcocon_SCCDNAME SETUP function DET1 EXP NREP 1 Start the exposure 4 nsgSend SRTAPENV ngcocon_SCCDNAME START Pause the exposure 4 nsgSend SRTAPENV ngcocon_SCCDNAME PAUSE Modify the exposure time 4 nasgSend SRTAPENV ngcocon_SCCDNAME SETUP function DET1 WIN1 UIT1 60 Continue the exposure msgSend SRTAPENV ngcocon_SCCDNAME CONT Wait until the exposure has been completed msgSend SRTAPENV ngcocon_SCCDNAME WAIT Check the exposure status dbRead lt alias gt CCDNAME exposure control state Stop periodic wiping msgSend SRTAPENV ngcocon_S CCDNAME STOPWP Exit ngcoDcsStop kill VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 75 of 76 VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 76 of 76
33. SO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 64 of 76 16 1 2 ngcoDcsinstall NAME ngcoDcsInstall sh Install NGCOSW files in INS_ROOT SYNOPSIS ngcoDcsInstall config lt detector_module gt root lt ins_root gt usr lt ins_usr gt instance lt ccdname gt env lt rtapenv gt lenv lt ccdlenv gt opmode lt NORMAL HW SIM gt keep DESCRIPTION This shell script installs all files needed to run an optical NGC system configuration files CCD voltages clock patterns and sequences in the instrument directory lt ins_root gt SYSTEM COMMON CONFIGFILES config lt detector_module gt Name of the detector module containing the detector configuration xxopt is the optical detector template root lt ins_root gt Root directory for the instrument the NGCOWS belongs to Default SINS_ROOT env variable usr lt ins_user gt User directory for the instrument the NGCOWS belongs to Default SINS_USER env variable instance lt ccdname gt detector name Default SCCDNAME env variable env lt rtapenv gt Local online database environment to be used Default SRTAPENV env variable lenv lt ccdlenv gt Remote online database environment to be used Default SCCDLENV env variable opmode lt opmode gt NGCOSW operational mode Default NORMAL keep do not resolve environment variables defined in config files if any Normally used only
34. Start osc lt newosc gt New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 6 0 04 05 2010 Page 38 of 76 6 Database Interface Some attributes of the NGCOSW online database are made public for direct read operations from external software note they are read only When accessing NGCOSW database attributes with direct CCS db calls applications are requested to use the macros defined in ngcoDbPublic h see section 6 4 in this way any change in name or location of the attribute only requires a new compilation All database paths below are meant to be relative to the root point for the NCG database branch 6 1 Interface between NGCOSW and the external environment Point Attribute Type Description system opmode dbINT32 Camera operational mode system state dbINT32 System operational state exposure contig id dbINT32 Exposure identification number exposure contig expMode dbINT32 Exposure mode index exposure contig expModeDescr dbBYTES32 Exposure mode description exposure conftig wipeSeq dbBYTES128 Name of the wipe sequence exposure contig wipeClock dbBYTES128 Name of the wipe clock pattern exposure conftig wipeVolt dbBYTES128 Name of the wipe voltage set exposure contig wipeRep dbINT32 Wipe sequence repetition factor exposure config preintSeq dbBYTES128 Name of the preintegration sequence exposure contig p
35. V myEnv DET CON LENV myLenv DET CON OPMODE NORMAL DET CON AUTONLIN Ss DET CON GUI ngcouiPanel DET CON DICT NGCDCS NGCCON DET CON XTER F DET CON LOG D DET CON ITCPROC WS DET CON OSCPROC Ss DET CON INST1 myCCD1 DET CON INST2 myCCD2 DET CON INST3 myCCD3 DET CON INST4 myCCD4 DET FRAM MERGE E ies Instance label Local online database environment Remote online database environment Operational mode Go online after start GUI Name Dictionary list Start in new terminal Logging level Image Transfer Client Super Control Process Sub system label Sub system label Sub system label Sub system label Merge multiple files VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 31 of 76 3 3 NGCOSW operational states The NGCOSW can be in the following operational states see AD28 e OFF The NGCOSW is OFF when it is not running Consequently the N COSW can never reply when it is in the OFF state e LOADED When the NGCOSW goes to LOADED state the database is loaded and all processes are activated Anyway the access to hardware is not allowed This is the state at the end of a successful startup e STANDBY The software and the hardware interfaces are initialized all hardware components are checked This is the state at the end of a successful STANDBY command In detail all actions need
36. XTERM E Start in new terminal DET CON LOG 0 Logging level Hat Ht HH HE at aE HE EE HE aE aE EE HE aE aE EE EE HE aE aE EE HE aE aE EEE HE aE EEE aE EE EE HEE EEE aE EE EE HEE EOE DEV description Hat oH a He aE aE HE HE aE HE EE EE HE aE aE EE EE HE aE EE HE aE aE HE EE HE aE EE EE EEE aE HE aE EE aE EE aE HEE EE N DET DEV1 NAME dev ngcO_com associated device nam DET DEV1 HOST SHOST host where interface resides DET DEV1 ENV myrtap server environment name DET DEV1 SRV ee optional server name DET DEV1 TYPE wis optional type HH HH HERE HE HH HE HE ERE HE HE HE EER EE HE HE EE ER EE EEE HE EE ERE HE HEE EE HE HE CLDC description HEHE HEH RE HEH EH HE HE ERE EE HE HE EE RE EE EE HE EE ER EE HE HE ERE EE HEH HE HEH DET CLDC1 DEVIDX 13 associated device index DET CLDC1 ROUTE Mas route to module DET CLDC1 NAME CLD 1m7 optional name DET CLDC1 AUTOENA F auto enable at online DET CLDC1 DCG 2 007 bias gain DET CLDC1 CLKGN 1 0 clock gain DET CLDC1 TELCLKGN 1 0 telemetry gain DET CLDC1 TELDCGN 3 0 telemetry gain ES o New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 HEHE EE HERE EE L L HEEE HEEE D D D HEHEHE HE HEHEHE HE HEH EQ description HEHEHE H
37. at startup see section 3 2 1 Valid values are defined in ngco h 3 1 2 NGC General Purpose Control Server operational modes NGCOSW interacts with the NGC back end boards through the NGC General Purpose Control Server ngcdcsEvh see AD72 Within NGCOSW the server operates in the following different modes e Normal mode In Normal mode the NGC detector electronics is connected This is the normal operational mode default e Hardware Simulation mode In Hardware Simulation mode the NGC detector electronics is simulated see VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 19 of 76 section 3 1 3 e LCU Simulation mode For NGCOWS this mode is equivalent to Hardware Simulation Server operational mode is set by the DET CON DFEMODE setup keyword in the camera configuration set see section 3 2 3 2 or defined at startup see section 3 2 1 Valid values are defined in ngco h 3 1 3 Simulation of the NGC detector electronics When the NGC detector electronics is simulated the images produced by NGCOSW contain a predefined pattern 3 2 System Startup 3 2 1 Startup Configuration The startup procedure is based on the common VLTSW configuration tool ctoo RD75 For each instrument detector the installation procedure described in section 2 5 has to be performed For each instrument detector as well as for the Super Control process for systems c
38. d with a SETUP command see section 7 and executed with a START command Schematically starting an exposure means to wipe a chip depending on setup the exposure status will be wiping wait for the time to open the shutter depending on START at parameter usually is now the exposure status will be pending open a shutter depending on setup the exposure status will be integrating collect the radiation on the chip VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 46 of 76 e close a shutter depending on setup e read the chip the exposure status will be reading e transfer the data to the IWS the exposure status will be transferring When the image data have been stored on disk the exposure status goes to completed If an error occurred during the exposure the status goes to failed If the exposure was aborted the status goes to aborted Generally the field of view can already be changed e g telescope can be moved when the exposure status changes to transferring all data for this exposure have been read out By default with NGCOSW it is possible to start an exposure only when one of the completion states success failure aborted have been reached i e after the image data produced by the previous exposure have been saved on disk If the time between end of detector readout and availability of the FITS file on disk bec
39. dle Read out Window Time Factor SX 1 nx H Mon 1 36 Start All Time Add TI sl Ciel eer EET Stop All Clock File J Program I DIT 1 0000000 s I External Convert W Run Ctrl European Southerin Observatory a 3 ou L re e N New General Detector Controller Command ADC Module 1 Units Offset V 3 5 Delay Mode Normal ene Pkt Size sim Numbers Mon 2 Pkt Cnt W Col J Cvt2 Filter W Clamp lt VE Abort Clear Dump Figure 6 NGC Engineer Panel VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 61 of 76 15 Special functionalities for Optical Instruments 15 1 Shutter Control Shutter configuration for each system is stored within the instrument specific configuration module lt xx gt dcfg which is under CMM control At the moment shutter control is performed via the Pulpo Server although this should change in a near future The device used to physically connect to the shutter is defined in the file SINS_ROOT SSYSTEM COMMON CONFIGFILES SCCDNAME pulpo cfg which must correctly set Here is a self explanatory example of a pulpo cfg file for a system with 2 shutters connected via ttyc and ttyd
40. e ACC server is defined and running if local and remote environments are defined on the local computer and in the ACC server if the scanning has been properly configured if the user which shall run the software is defined on the local and the remote computer etc manpage of ngcoDcsOldb is available in 16 1 1 The same script then handles the online database generation acting in different ways on the IWS see 2 3 1 and the LLCU see 2 3 2 New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 6 0 04 05 2010 Page 12 of 76 2 3 1 IWS online database generation On the IWS the DATABASE db NGCOSW and USER db NGCOSswW templates for the online database environment are installed in the SVLTDATA ENVIRONMENTS SRTAPENV db1l directory by running ngcoDcsOldb renv SCCDLENV host IWS manpage of ngcoDcsOldb is available in 16 1 1 Use the DATABASE db NGCOSW and USER db NGCOSW templates to edit the DATABASE db and USER db files In the template DATABASE db NGCOSw it is described how to describe different configurations instrument controlling only one camera instrument controlling more cameras Examples e Instrument controlling one camera Add in the DATABASE db the following replacing lt myCCDNAME gt with the name of the camera e g CCDNAME lt myPATH gt with the preferred oldb location eg DR optical u
41. e EE EE ee 46 IR PP eet EE 46 9 1 5 Changes with respect to EIER teen Sestak ededeEEEE ASSEN 47 9 2 OTIS eege santa e AEE EP r E E E AEAEE EE 47 9 2 1 Changes with respect to FIERA wisc ccsissecicccessincceecnesennedersustenesiageesstreseneeessnesenee 48 9 3 File den E 48 9 3 1 Changes with respect to PIER sicsisctecigencitsnesdetctaiaiteeectsanssiueiatadetetinensceeee nites 48 9 4 Naming Geetbets 48 9 4 1 Changes with respect to FIERA wsssisccssiscstacess teestreesdentaceciaen ceenandeae tacsateiaenedeveneees 48 9 5 FITS Header RE 48 9 5 1 Changes with respect to FIERA vices iicccisnterccseisencisacensnancedsauecenmessceecennaiseentanniedere 49 9 6 Image post processing EE 49 9 6 1 Creating a module which implements post processing ccceeeeeeeeeeeeetteeees 49 9 6 2 How to run the process which implements post processing eeeeeeesseeeeeeee 50 10 Synchronisation EE 53 KW Error NL E 54 12 Error and Logging lear GAG EE 56 13 Real Time Display EE Eege 57 13 1 Changes with Ee EE 57 14 Graphical User Interface iesen EERNEEEE 58 14 1 Control EE 58 14 2 e Wale te 59 15 Special functionalities for Optical Instruments 0 0 0 2 cece eeeeeeeeeeeeeeeeeeetteeeeeeeeeeeeteeaes 61 Eeer 61 15 2 Temperature pressure Monitoring ccceeeeecceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneeees 61 15 2 1 Changes with respect to FIERA wisssscaccevcscncsecassuteenetactienseastocensanselicexaraeedeaeeavens 61
42. e integration 0 integration time shutter if any closed Flat one integration shutter if any open DEE SE Led one integration shutter if any closed LED light source on LedShut one integration shutter if any open LED light source on Multiple DET WIN lt i gt NDIT sub integrations shutter if any open for each integration Burst Multiple frames are read out shutter if any always open DET WIN lt i gt UIT1 Double Integration time in seconds DET WIN lt i gt BINX Integer Binning factor along X DET WIN lt i gt BINY Integer Binning factor along Y Table 6 Basic Setup keywords for single exposure New General Detector Controller VLT MAN ESO 13660 4086 Issue 6 0 Optical DCS User Manual 04 05 2010 Page 42 of 76 Keyword Type Description Number of repeated exposures DET EXP NREP Integer 0 means forever DET EXP TIMEREP Double Time between two repeated exposures DET EXP WIPETIM Integer Wipe or not before starting exposure in a loop Table 7 Additional Setup keywords for loops of exposures Keyword Type Description DET WIN lt i gt NDIT Integer Number of sub integrations DET WIN lt i gt UIT lt j gt Double Subintegration time in seconds DET READ SHIFT lt i gt 1 Integer Lines shifted between integrations Line shift type alternate DET READ SHIFTYP String oo E e list as defined in list SHIFTi Table 8
43. ector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 21 of 76 Keyword Type Description Defines a list of dictionaries to be loaded The common ESO VLT DIC NGCDCS is always loaded into the system and needs not to be specified The entries are separated by whit space Only the last descriptor of the full dictionary name is needed here e g NGCDCS STOO_CFG DET CON DICT String DET CON XTERM Logical Start all sub processes in new terminal Logging level Logs system messages in the standard log file so that they can be seen in the CCS logMonitor DET CON LOG Integer The level gives the detail of the messages Default value is 0 no debugging only error logging in case the keyword is not present Defines the name of the Image Transfer Client process DET CON ITCPROC String which implements image post processing If not defined ngcoitc is used Defines the name of the Super Control process used to DET CON OSCPROC String coordinate multi DCS systems If not defined ngcosc is used Table 1 Startup Configuration Keywords The startup configuration file assigns a name and some access right attributes to the configuration set 3 2 2 Startup Procedure The system startup is performed through a startup script ngcoDcsStart options The startup scripts loads the startup configuration defined by the CCDNAME environment variable or by
44. ed in 9 6 The name of the new Image Transfer Client process to be used for image post processing can be defined in the lt xx gt dcfgCAMERA cfg configuration set DET CON ITCPROC keyword 6 4 ngcoDbPublic h For all the above attributes a macro is defined in the ngcoDbPublic h When accessing NGCOSW database attributes with direct CCS db calls applications are requested to use the macros defined in ngcoDbPublic h in this way any change in name or location of the attribute only requires a new compilation 6 5 Changes with respect to FIERA NGCOSW keeps the same public online database attributes of the FIERASW New General Detector Controller Issue 6 0 Optical DCS User Manual VLT MAN ESO 13660 4086 04 05 2010 Page 41 of 76 7 Setup Command All the parameters which are relevant for an exposure are set via a SETUP Command which must therefore be issues before starting an exposure unless the new exposure is a perfect copy of the previous one i e no parameter needs to be modified or while an exposure is paused Here is a selection of the most important setup keywords to be completed where means that their usage is not yet implemented Keyword Type Description Index of mode used for an exposure wipe DET MODE CURID Integer integrate readout Exposure type Normal one integration shutter if any open Dark one integration shutter if any closed Bias on
45. ed to bring the whole camera to STANDBY state are very dependent on the system hardware architecture and therefore cannot be defined in this document for all cameras Typically the following actions are implemented a Detector disconnected voltages not applied b Shutter control hardware is switched off whenever the hardware architecture allows it c Temperature monitoring remains active d LAN connection active command reception enabled e ONLINE This is the only state where the NGCOSW can perform exposures All software and hardware is loaded initialized and active All voltages have been loaded Telemetry has been acquired and checked All the voltage switches are closed This is the state at the end of a successful ONLINE command VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 32 of 76 Figure 2 illustrates the NGCOSW operational states and the commands to switch between them see AD28 OFF ngcoDcsStart LOADED lt lt EXIT STANDBY OFF STANDBY STANDBY p CS ONLINE g STANDBY ONLINE Figure 2 Operational states and state transitions 3 3 1 Changes with respect to FIERA NGCOSW implements the same operational states of the FIERASW 3 4 System Shutdown The system is shutdown by sending an EXIT command see section 4 to the coordination control process ngcocon_ lt label1 gt The coordination control proces
46. exposure and the only processing to be done is pixel sorting centroiding and possibly and offset correction if not yet done in HW The infrared data require some pre processing depending on the read out mode of the detector in use The read out modes the pre processing algorithms and the setup parameters for these algorithms are manifold and require a very high degree of flexibility The pre processing task produces an arbitrary number of different result frame types which all have to be transferred and or displayed on demand This also has an impact on the RTD interface VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 8 of 76 e Exposure Loops For infrared applications starting an exposure basically means starting to transfer the acquired data to a FITS file i e the server has to attach to and keep step with a running procedure The end of exposure condition is flexible and depends on both the requested frame types and on the number of frames of each type to be produced and stored The optical exposure always terminates with the saving of the data which are read at the end of the exposure and follows a much more rigid scheme inactive wiping pending integrating reading transferring inactive This scheme implies an active intervention of the control server during the exposure like the application of new voltages in each
47. exposures are performed 1 Start N COSW from the Instrument Workstation ngcoDcsStart instance SCCDNAME env SRTAPENV lenv SCCDLENV A kill 2 Put NGCOSW in STANDBY nsgSend SRTAPENV ngcocon_SCCDNAME STANDBY 3 Put NGCOSW ONLINE nsgSend SRTAPENV ngcocon_SCCDNAME ONLINE 4 4 4 Perform periodic wiping 4 nsgSend SRTAPENV ngcocon_ CCDNAME STARTWP 5 Prepare the next exposure set exposure mode type time and binning 4 asgSend SRTAPENV ngcocon_SCCDNAME SETUP function DET MODE CURID 1 DET1 EXP TYPE Normal DET1L WIN1 UIT1 10 DET1 WIN1 BINX 1 DET1 WIN1 BINY 1 6 Start the exposure msgSend SRTAPENV ngcocon_SCCDNAME START 7 Wait until the exposure has been completed msgSend SRTAPENV ngcocon_SCCDNAME WAIT 8 Check the exposure status dbRead lt alias gt CCDNAME exposure control state 9 Prepare the next exposure change exposure mode type time and binning msgSend SRTAPENV ngcocon_SCCDNAME SETUP function DET1 MODE CURID 3 DET1 EXP TYPE Dark DET1 WIN1L UIT1 20 DET1 WIN1 BINX 2 DET1 WINI1 BINY 2 10 Prepare the next exposure define a loop of exposures msgSend SRTAPENV ngcocon_SCCDNAME SETUP function DET1 EXP NREP 10 11 Start the loop of exposures msgSend SRTA
48. gging configuration added 2 5 INS_ ROOT population description improved 3 2 3 2 Example updated 16 Manpage Chapter added 17 prev 16 Minor corrections 5 0 26 02 2010 1 10 Acknowledgments added NGCOSW module list updated Startup option for image post processing added lt xx gt dcfgCONFIG cfg updated lt xx gt dcfgDCS cfg added lt xx gt dcfgCAMERA cfg updated Customization of Super Control process added Image post processing interface description added Image post processing description added Fig 5 Optical NGC Control Panel updated Fig 6 NGC Engineer Panel updated Manpages updated ngcoDcsTemplate manpage added 05 05 2010 2 Info for pkgin configuration added Description improved Multi DCS instrument case adedd Startup Configuration chapter added Super Control example configuration file added NOTE for the instrument configuration file added Startup of customized Super Control process added Usage of DET FRAM MERGE added ngcoDcsInstall manpage updated ngcoDcsStart manpage updated VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 4 of 76 Table of contents aris 0 y Reese rerge er eereen ere ert E ee ee eer 7 LEHNEN 7 Eege deer 8 1 3 Applicable Documents Ee 8 1 4 Reference Documents E 8 1 5 Abbreviations and ACIONYING vac c5 ha ho cite ea eee 8 Eeer 8 1 75 SUV Enn VE 8 1 8 Naming Conventions asics ccsic seecaeiysacent
49. iguration Set Jabel DC cho 24 3 2 3 3 Configuration Set Jabel CAMERA cho 26 3 2 3 4 Super Control Process Configuration Gei 30 3 3 NGCOSW operational eeler eege 31 3 3 1 Changes witt respect 10 FIERA E 32 3 4 System lge E 32 3 4 1 Changes with respect to EIERA 32 SGCOMMAN INTEMACC EE 33 VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 5 of 76 4 1 Changes with respect to FIERA AAA 35 5 Multiple Instances of DCS cccscacccceccsctenascesencasss ccnsnevavixeorascabinecsanventedeetoncsaaveseoneaanescnenneas 36 5 1 Customization of the Super Control process AEN 36 5 2 Startup of a system using multiple instances Of DCH 37 5 2 1 How to run the standard Super Control Drorcess 37 5 2 2 How to run the customized Super Control process 37 6 Database Interface eege Eege Eege 38 6 1 Interface between NGCOSW and the external emvironment 38 6 2 Interface between NGCOSW and TCS ENEE 39 6 3 Image post processing Bee 40 6 4 DEE 40 6 5 Changes with respect to FIERA siccccacnccszeassannestssesheesandsadeannasQetmcetausdacsbideedegeasetenaneees 40 7 Setup MANN EE 41 7 1 Changes with respect ioEIERA AAA 43 8 Status Command E 44 8 1 Changes with respect to FIERA sss teiscetcccasscchatenrcdadeastsetdinenstheeestarcieensieneeeenels 44 9 Exposure Handling stege esedesteebet aere aa ieee tes ea tener 45 Cha Re EE 45 9 1 1 EXPOSUYE Oe 45 9 1 2 EE EE Eege 45 S
50. ile implement your PostProcessing method e Inthe newoitcControl c file check which actions should be overridden and which should not be overridden eg do you need or not to override the SETUP command e Inthe Makefile file remove from newoitcControl_OBJECTS the actions that you do NOT want to override e g SETUP 9 6 2 How to run the process which implements post processing Assuming newoitc to be the name of the module containing the post processing implementation in order to use the new newoitc process two possibilities are offered 3 define the DET CON ITCPROC setup keyword in the lt xx gt dcfgCAMERA cfg configuration set DET CON ITCPROC newoitc 4 launch the startup script with the itc lt newoitc gt option ngcoDcsStart itc lt newoitc gt VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 51 of 76 AE package Class Diagram LS xxxoite excite o 2 1 7 09 11 59 AM Figure 3 Post Processing Image Transfer Client class eyt VLT MAN ESO 13660 4086 New General Detector Controller Optical DCS User Manual Issue 6 0 04 05 2010 Page 52 of 76 interaction xxxoitc h xxxoite main xxxoitcControl GetActionMar k _ _actionMgr Lo eg app ngcoitcAPPLICATION Joint el actionMgr ngcoitcACTION_MGR
51. inate in a hard way the NGCOSW at WS level only VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 69 of 76 for camera myccd WS environment myws gt ngcDcsStop instance myccd env FALSE lenv myngc Terminate in a soft way the NGCOSW at LCU level only for camera myccd LCU environment myngc SEE ALSO ngcoDcsStart VLT MAN ESO 13660 4086 Sis New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 70 of 76 16 1 5 ngcoGetProcNum NAME ngcoGetProcNum get process number SYNOPSIS ngcoGetProcNum lt envName gt lt procName gt DESCRIPTION Utility to retrieve the process number for the indicated process from the environment in which it is running It is used by the script ngcoDcsStart lt envName gt environment name lt procName gt process name RETURN VALUES Process number if SUCCESS O if FAILURE EXAMPLES gt ngcoGetProcNum SRTAPENV ngcoexp_SCCDNAME echo SEE ALSO ngcoDcsStart VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 71 of 76 16 1 6 ngcoDcsClean NAME ngcoDcsClean Clean oldb envirionment and shared memory SYNOPSIS ngcoDcsClean DESCRIPTION This shell script performs a shutdown of the online database environment defined by S RTAPENV removing shared memory segments and zombie processes ENV
52. ithout the options NGCOSW will be started using the CCDNAME RTAPENV CCDLI ENV INS_ROOT followed by the FIERASW INS_USER similar to the procedure Ne VLT MAN ESO 13660 4086 w General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 23 of 76 3 2 4 Configuration Examples 3 2 3 1 Startup Configuration file lt label gt CONFIG cfg Startup Configuration File PAF HDR START PAF TYPE Configuration Type of PAF PAF ID Id PAF NAME NGCOSW Name of PAF PAF DESC NGCOSW Test Camera Startup Configuration PAF CRTE NAM ocumani Name of creator PAF CRTE DAYTIM 2006 08 21 Civil Time for creation PAF LCHG NAME W He Name of person appl changing PAF LCHG DAYTIM W Timestamp of last change PAF CHCK NAME P WI Name of appl checking PAF HDR END GENERAL CONFIG Keywords optional CONFIG CON LOG T CONFIG CON BACKUP T CONFIG CON BAKDIR SVLIDATA config CAMERA CONFIG SET CONFIG SET1 NAME opd CONFIG SET1 DICT NGCDCS NGCCON CONFIG SET1 FILE1 opdDCS cfg CONFIG SET1 PERM1 644 CONFIG SET1 FILE2 opdCAMERA cfg CONFIG SET1 PERM2 644 CONFIG SET1 FILE2 opdCAMERA_TARGET cfg CONFIG SET1 PERM2 664 ctooConfigArchive CONFIG CONF IG
53. l already running processes before starting ENVIRONMENT CCDNAME default for camera name e g myccd RTAPENV default for WS local environment e g myws CCDLENV default for LCU environment e g myngc INS_ROOT default root directory for instrument data RETURN VALUES 0 if SUCCESS 1 if FAILURE CAUTIONS rhosts file on LCU system must contain user and hostname where this script runs since it performs remote shell commands EXAMPLES gt ngcDcsStart instance myccd env myws lenv myngc Start the NGCOSW for camera myccd WS environment myws LCU environment myngc gt ngcDcesStart instance myccd env myws lenv 0 Start only the NGCOSW LCU processes for camera myccd WS environment myws gt ngcDcsStart instance myccd env myws lenv myngc kill gui Kill and restart the NGCOSW for camera myccd WS environment myws LCU environment myngc Gui is also started SEE ALSO ngcoDcsStop ngcoGetProcNum VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 O Optical DCS User Manual 04 05 2010 Page 68 of 76 16 1 4 ngcoDcsStop NAME ngcoDcsStop shut down optical NGC DCS SYNOPSIS ngcoDcsStop instance lt ccdname gt env lt env gt lenv lt lenv gt kill DESCRIPTION This shell script performs a shut down of NGC optical DCS It does the following steps 1 Verify if the main process is running 2 Try to terminate NGC optical processes in a soft way command
54. ling more DCSs appears to a VLT instrument as a single detector whose name is label The instrument configuration file e g lt xx gt mcfgINS cfg would then contain the keyword OCS DET1 CCDNAME label 5 1 Customization of the Super Control process The possibility of performing customized actions at STANDBY ONLINE OFF EXIT SETUP is implemented by means of a virtual Execute method added to the corresponding action classes of the Super Control process The application that needs to implement a specific Super Control process must define a class that inherits from the corresponding ngcoscACTION_Xxx and that overrides the Execute method The new class must then substitute the default action manager for the event A template is provided in the xxxosc module which is installed in the SVLTTOP templates forNGc directory To create a module for instance newosc which customizes actions of the Super Control process go into the appropriate directory and run ngcoDcsTemplate sh template xxxosc module newosc In the local directory a newosc module is then created Shortly e Inthe appropriate newosc ACTION_XXxX C file where Xxx can be any of STANDBY ONLINE OFF EXIT SETUP implement your Execute method e Inthe newoscControl c file check which actions should be overridden and which should not be overridden e Inthe Makefile file remove from newoscC
55. lmage 2 fits third exposure 9 4 1 Changes with respect to FIERA NGCOSW implements the same naming scheme of the FIERASW 9 5 FITS Header Contents Basic and mandatory primary FITS keywords are included from the dictionary dicFITS CMM module ESO VLT DIC PRIMARY FITS VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 49 of 76 NGC specific FITS keywords are defined within the ESO VLT DIC NGCDCS dictionary dicNGC CMM module Apart from the image raw data NGCOSW is also responsible for providing keywords for the FITS header Depending on their type keywords are treated in two different ways e Standard keywords Some basic keywords needed by any image analysis system to read the FITS file are written at the beginning of the file e Hierarchical keywords They are not strictly needed to interpret the pixel values and normally do not appear at the beginning of the FITS header NOTE at the moment NGCOSW writes all the information directly in the FITS file removing the usage of an intermediate det file to be merged with the FITS file by OS as was done by FIERA This implementation is still under discussion 9 5 1 Changes with respect to FIERA NGCOSW implements the same FITS structure of the FIERASW If actual scheme is accepted no more separate det files are created NGCOSW writes all the information directly in the FITS file 9 6 Image
56. more detailed description Normal exposure single integration shutter opened and closed Dark exposure single integration shutter kept closed Bias exposure 0 integration time Dark Flat Field exposure normal exposure chip exposed to a uniform flux of radiation LedAndShutter exposure normal exposure chip exposed to the radiation generated by a LED which is located between the chip and the shutter NOTE this kind of exposure will be supported or not depending on the capability of the hardware that will be finally chosen Led exposure dark exposure chip exposed to the radiation generated by a LED which is located between the chip and the shutter NOTE this kind of exposure will be supported or not depending on the capability of the hardware that will be finally chosen Multiple or Multi step exposure single exposure consisting of more integrations with same or different duration After each integration the exposure is paused During pauses rows may be shifted on chip Burst or Drift Scanning exposure during the integration the charges on the CCD are continuously shifted along the parallel registers and read out The exposure type is defined by setting the DET EXP TYPE setup keyword see section 7 Accepted values for the DET EXP TYPE setup keyword are listed in macros which are defined in ngco h 9 1 2 Exposure status When the detector system is ONLINE an exposure can be prepare
57. n turn trigger external devices e g tell another device that a read out has finished If several sequencers are installed in the same system i e the same instance of NGCOSW then the exposure start can be synchronized by using the global run signal which is raised by one sequencer instance and is propagated to all other sequencer instances having the external run control enabled DET SEQi RUNCTRL T in the detector configuration file see RD77 If no high accuracy is needed the synchronization can be also done at command interface level e g issue an exposure start command at the proper time or use the command START at lt start time gt VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 54 of 76 11 Error Definitions The CCS error mechanism RD32 provides a classification scheme for application specific errors The meaning of the error class and the possibly needed interactions are described in a help file h1p which can be displayed with the standard CCS tools also with the logMonitor The detailed error reason eg command which failed wrong parameter issued and boundary values etc is given in an associated error message string NGCOSW uses the errors defined by ngcb see RD77 In addition N COSW modules define their own errors The errors which are common to all the modules are listed in the following table E
58. ndef CCDNAME Zundert ngcdcsINSTANCE undef NGCROOT define CCDNAME lt myCCDNAME gt define ngcdcsINSTANCE ngcdcs_ lt myCCDNAME gt define NGCROOT Appl_data lt myPATH gt CCDNAME e Instrument controlling four cameras Add in the DATABASE db the following replacing o lt myINSTRUMENT gt with the instrument name e the name of the branch for the Super Control process which can be defined with keyword o lt myCCDNAME1 gt lt myCCDNAME2 gt lt myCCDNAMI DET CON OSCPROC in the instrument configuration see 5 E3 gt lt myCCDNAM I FA with the camera names i e the values of SCCDNAME on the different LLCUs lt myPATH gt with the preferred oldb location e g DCS optical undef DCSNAME undef CCDNAME undef ngcdcsINSTANCE undef CCDNAME2 Zundert ngcdcsINSTANCE2 undef CCDNAME3 Zundert ngcdcsINSTANCE3 undef CCDNAME4 VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 13 of 76 Zundert ngcdcsINSTANCE4 undef NGCROOT define DCSNAME lt myINSTRUMENT gt define DCSROOT Appl_data lt myPATH gt DCSNAME define CCDNAME1 lt myCCDNAME1 gt define NGCROOT1 Appl_data lt myPATH gt DCSNAME CCDNAME1 define ngcdcsINSTANCE1 ngcdcs_ lt myCCDNAME1 gt define CCDNAME2 lt myCCDNAME2 gt define N
59. nnssaceasnvatoncnaabaancencastystios deasssedessicedendeadsnaudveaancaens 9 1 9 Problem Reporting Change Heouest AAA 9 TEE EE 9 Installation and configuration EE 10 2 l Software Mod le S criin E E E E ENRE a RE Ei 10 2 2 TE 10 2 2 1 Using installation scripts E 10 2 2 2 USING le UE 11 2 3 Online database emvironment en 11 2 3 1 IWS online database generation EEN 12 2 3 2 NGC LLCU online database generation ccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeestaaeeees 13 2 3 3 Online database verification EEN 13 2 3 4 Online database automatic StartUp cceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneeees 14 EE e 14 2 4 NGC LLCU logging system Configuration ceceeeeeeeeeeeeeeeeeeeeeeeeeneeeeeeeetaeeeeenes 14 2s ANS ROOT POP Ula Du saines desy daar aea a a AEA deat ieee EEA aea 15 2 5 1 INS_ROOT population for multi DCS mstruments 15 Startup Shutdown EProeedure is scccccesesscceaseccctacesssconadeccstecasisdesseensssctesnecossaceedeceesanneceesedadee 16 3 1 System Configuration EE 16 3 1 1 NGCOSW operational modes AEN 18 3 1 2 NGC General Purpose Control Server operational modes ssssesssseessereee 18 3 1 3 Simulation of the NGC detector electronics ANEN 19 3 2 System Start P EE 19 3 2 1 Stell e N tt EE 19 3 2 2 EECHER 21 3 2 3 Changes with respect to EIERA ENEE 22 3 2 4 EENEG eee er eer eee ene eee eee re ee 23 3 2 3 1 Startup Configuration file Jabet CONFEIG cho 23 3 2 3 2 Conf
60. oOo
61. ode will be installed in the VLTROOT Therefore these scripts must be run by a user with the appropriate read write privileges 2 2 2 Using pkgin The ngcins software module contains a pkgin installation configuration for both NGC IR and OPT software cmmCopy ngcins pkginBuild ngcins Module ngcins contains a number of modules and keyword OPTIONS in the pkgin configuration has to be set to LIBRARY as shown in the following example INSTALL MODULES5 NAME ngcins INSTALL MODULES5 SUBPKG NGC INSTALL MODULE5 VERSION lt number gt INSTALL MODULE5 OPTIONS LIBRARY 2 3 Online database environment To automatically generate the online database the environment variables RTAPENV CCDLENV and CCDNAME must be defined e RTAPENV defines the name of the local online database environment e CCDLENV on the IWS defines the name of the remote online database environment on the NGC LLCU it must be set to 0 e CCDNAME defines the name of the detector camera NOTE on the NGC LLCU the environment variables are defined in the files etc pecs releases 000 etc locality apps all env etc pecs releases 000 etc locality apps HOST env On the IWS you could define them in the same files or in pecs apps HOST env The script ngcoDcsOldb performs a preliminary system check if the environment variables are defined if th
62. of the specified function s SETUP file Setup for the next exposure or the running but PAUSEd one function VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 34 of 76 Parameters Format Description STANDBY none Bring the system to operational state STANDBY START Integer Exposure ID String Start an exposure or an exposure lt YYYY MM DD gt T lt hh mm ss gt _ loop depending on the value of or now DET EXP NREP keyword see section 7 at a given time default now STARTTL period Integer Start monitoring of telemetry values logperiod Integer STARTWP periodic Integer Wipe chip s once or periodically STOPLP none Stop a loop of repeated exposures at the end of the running exposure STOPTL Stop monitoring of telemetry values VERBOSE on Set verbose mode on off off If on the level of the logging is defined by the logging level value which can be set modified through the setup keyword DET CON LOG VERSION none Return current version of the NGCOSW WAIT waitMode String Wait for exposure completion Single Global T e f wo replies are issued one immediate with the exposure status one at the end of the exposure Table 2 Command list VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 35 of 76 Special commands
63. omes a significant overhead NGCOSW can be instructed to start an exposure right after the end of the transmission of the image date of the previous exposure to the IWS by using the setup keyword TBD The current exposure status value is stored in the database attribute lt alias gt CCDNAME exposure control state The value of the current exposure status can be INACTIVE PENDING WIPING INTEGRATING PAUSED i e shutter temporary closed READING PROCESSING i e processing image data if requested by SETUP TRANSFERRING i e transferring image data to IWS COMPLETED i e completed successfully FAILED i e completed with error ABORTED i e completed without data readout on request Macros for the exposure status values and descriptions are defined in ngco h 9 1 3 Image data Image data are provided by N GCOSW in two ways e Raw data for Real time display see section 13 e FITS files See section 9 3 Whenever a new data file is created the full path name is written into the database attribute lt alias gt CCDNAME exposure config fileName 9 1 4 Exposure Id In order to be able to uniquely identify an exposure an identification number exposure Id VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 47 of 76 is associated to each exposure The exposure Id should be passed to the NGCOSW as a parameter of the command START as
64. ons e ncgoexp The NGC Exposure Coordination module for optical applications e ncgoits The NGC Image Transfer Server module for optical applications e ncgoitc The NGC Image Transfer Client module for optical applications e ngcosc The NGC Super Control module for optical applications This process is needed only for instruments controlling multiple DCS instances see 5 e ngcoui Engineering GUI used for direct system interaction and data acquisition e ngcoarc Installation scripts for the overall NGCOSW software package 2 2 Installation 2 2 1 Using installation scripts Before installing the NGCOSW package via the installation scripts be sure that the NGC base software package has been already installed see RD9 Installation scripts for the software package are provided in the ngcoarc software module and work on both the IWS and on the NGC LLCU The procedure to create the package consists of the following steps 1 Retrieve from the archive and install the module ngcoarc mkdir lt NGCOROOT gt cd lt NGCOROOT gt cmmCopy ngcoarc ESO Standard hardware is described in http websqa hq eso org sdd bin view SDDInfo LinuxStandardHw VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 11 of 76 2 Retrieve all needed modules from the archive and install them cd ngcoarc src make all install Note unless a INTROOT is defined all the NGCOSW c
65. ont end reside see Figure 1 From now on we will call IWSENV the online database environment which usually runs on the IWS and LCUENV the online database environment which usually runs on the NGC LLCU see section 3 1 1 VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 17 of 76 Commands Configuration Files FITS Files Files Exposure Coord k Transfer Server Transfer Server Figure 1 Optical NGC software Architecture For each detector system the configuration files are kept in a separate instrument specific configuration module lt xx gt dcfg which is under CMM control The configuration module will take care of installing all files at the proper location i e INS_ROOT INS_USER COMMON CONFIGFILES In addition to the system and detector configuration file s there are still various other files to be maintained in such a VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 18 of 76 module e g voltage tables clock pattern definitions sequencer programs and the startup configuration as described in section 3 2 1 3 1 1 NGCOSW operational modes NGCOSW operates in the following different modes e Normal mode In Normal mode the NGC detector electronics is connected The NGCOSW can either be distributed on both the IWS where the IWSENV online databa
66. ontrol_OBJECTS the actions that you do NOT want to override VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 37 of 76 5 2 Startup of a system using multiple instances of DCS Proper configuration files are needed also for the startup of the Super Control process In particular the lt labe1l gt CAMERA cfg file must contain the DET CON INSTi keywords defining the DCSs which are used see 3 2 3 4 The lt label gt CAMERA cfg file can also contain the DET FRAM MERGE keyword defining if the images produced by the different DCSs should or not be merged at the end of each exposure see 3 2 3 4 If this keyword does not exist the default behavior is that the files are NOT merged 5 2 1 How to run the standard Super Control process The standard procedure described in 3 2 applies also to the startup of a system using multiple instances of DCS controlled by a standard Super Control process 5 2 2 How to run the customized Super Control process Assuming newosc to be the name of the module containing the customized Super Control process implementation in order to use the new newosc process two possibilities are offered 1 define the DET CON OSCPROC setup keyword in the lt xx gt dcfgCAMERA cfg configuration set DET CON OSCPROC newosc 2 launch the startup script with the osc lt newosc gt option ngcoDcs
67. ontrolling more detectors see 5 the procedure creates and installs e in SINS_ROOT SINS_USER COMMON CONFIGFILES o lt label gt CONFIG cfg defining the system configuration o lt label gt DCS cfg configuration set containing the fixed physical DCS configuration front end electronics description shutter etc o lt label gt CAMERA cfg configuration set containing the configurable DCS configuration front end electronics configuration readout modes etc o lt label gt directory containing all the files needed to drive the detectors voltages clock patterns sequences e iN SINS_ROOT INS_USER COMMON SETUPFILES DET o lt label gt SetupComplete det with the minimum SETUP needed to configure an exposure The configuration sets describe an instance of the NGCOSW in short FITS format where means that their usage is not yet implemented New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 VLT MAN ESO 13660 4086 Page 20 of 76 Keyword Type Description DET CON INSTANCE DET CON ENV String String Defines the instance label for the control server and the database Used to define the database branch and the appendix Jabel for the Control Coordination Process registered with the CCS environment If the keyword is not present and not passed as a parameter to the startup scrip
68. orizontal readout direction Vertical readout direction Ref Ref pixel in axis direction pixel in axis direction FE FEE HET EE AE FE FE AE FE AE AE EH HE EH HE HEH FE FEE HEE FE AE EE AE FE FE AE FE AE E TE AE FE FE AE HEE EN Exposure mode name Exposure mode description Enable trigger Gain used Gain used Gain used Gain used Bandwidth Bandwidth Bandwidth Bandwidth used used used used Wipe sequence repetition number VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 6 0 Im Optical DCS User Manual 04 05 2010 Page 28 of 76 DET MODE1 WCLDFI wipel v ame of CLDCi FILE for wipe DET MODE1 WCLKFIL wipel bclk ame of SEQi CLKFILE for wipe DET MODE1 WPRGFIL wipel seq ame of SEQi PRGFILE for wipe DE ODE1 PREP 1 Preint sequence repetition number DET MODE1 PCLDFI preintl v ame of CLDCi FILE for preintegration DET MODE1 PCLKFIL preintl bclk ame of SEQi CLKFILE for preinteg
69. ration DET MODE1 PPRGFIL1 preintl seq ame of SEQi PRGFILE for preintegration DET MODE1 RREP 1 Readout sequence repetition number DET MODE1 RCLDFI readl v ame of CLDCi FILE for readout DET MODE1 RCLKFI readl bclk ame of SEQi CLKFILE for readout DET MODE1 RPRGFIL readl seq ame of SEQi PRGFILE for readout DET MODE3 RTYPE Standard Readout type Standard or FastACS DET MODE1 ADCSAMPL aed Dk ADC data sampling factors DET MODE1 OUTPUTS 1 umber of outputs used for readout DET MODE1 ADC1 ADCS Was Outputs used for readout DET MODE1 OUT1 CHIP 1 Index of chip the output belongs to DET MODE1 OUT1 INDEX 1 Output index on the chip DET MODE1 OUT1 XIMA 1 Horizontal location of data in image DET MODE1 OUT1 YIMA 1 Vertical location of data in image DET MODE1 OUT1 NX 2048 Output data pixels in X DET MODE1 OUT1 NY 500 Output data pixels in X DET MODE1 OUT1 PRSCX 50 Output prescan pixels in X DET MODE1 OUT1 PRSCY 0 Output prescan pixels in Y DET MODE1 OUT1 OVSCX 50 Output overscan pixels in X DET MODE1 OUT1 OVSCY 0 Output overscan pixels in Y DET MODE1 OUT1 GAIN 0 3 Conversion from electrons to ADU DET MODE1 OUT1 CONAD 3 33 Conversion from ADUs to electrons DET MODE1 OUT1 RON 123 Readout noise per output e DET MODE2 SHACTHI EF Open active high DET MODE2 SHMODE Direct Shutter operational mode MODE2 DET MODE2 NAME Test2 Exposure mode name DET MODE2 DESC Test mode 2 Exposure mode description DET MODE2 TRI
70. rectly the user which runs NGCOSW must be defined on both the IWS and the LLCU with the same user id 2 4 NGC LLCU logging system configuration To configure the LLCU to log messages onto the IWS edit the file etc syslog conf while logged in as the user root The following three lines configure the VLT logging system info mail locall local2 none var adm messages locall warning vltdata tmp logFile VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 15 of 76 local2 warning vltdata tmp logAuto info mail locall local2 none mylIws locall warning mylIws local2 warning myIws Substitute the IWS hostname for my Iws IMPORTANT use tabs for spacing This change will take effect after rebooting the LLCU or run kill HUP ps C syslogd o pid to restart the loggin daemon 2 5 INS_ROOT population To automatically populate the INS_ROOT instrument directory the environment variable INS_ROOT must be defined the directory INS_ROOT must exist and the instrument module must have been installed instrument module is the cmm module containing the detector startup configuration file lt xx gt dcfgCONFIG cfg and the configuration sets lt xx gt dcfgDCS cfg and lt xx gt dcfgCAMERA cfg see 3 2 3 1 and 3 2 3 2 and the voltages patterns and sequences to drive the detector
71. red by chip each CCD corresponds to an extension A primary header sits on the top of the file NOT YET IMPLEMENTED To enable data cubes i e saving n successive frames into a single FITS file the setup parameter DET READ NFRAM must be set to a value different form TBD see section 7 Currently the formats supported for pixels values are 16 bits and 32 bits Independently from the readout mode used the complete physical image is stored in one single FITS file per camera head provision for one single FITS file per instrument is under development Multiple windows are also stored in different IMAGE extensions of a single FITS file Different frames in data cube files are also stored in different IMAGE extensions of a single FITS file see RD37 9 3 1 Changes with respect to FIERA NGCOSW implements the same file format of the FIERASW 9 4 Naming Schemes FITS file names are defined by the setup keyword DET FRAM FILENAME see section 7 In case the number of FITS file to be produced is more than one DET EXP NREP setup parameter see section 7 NGCOSW assumes that all files will have the same name followed by a sequential integer index starting from 0 Example if DET EXP NREP is set to 3 and DET FRAM FILENAME is set to mylmage fits NGCOSW will look for files mylmage fits first exposure mylmage 1 fits second exposure and my
72. reintClock dbBYTES128 Name of the preintegration clock pattern exposure contig preintVolt dbBYTES128 Name of the preintegration voltage set exposure contig preintRep dbINT32 Preintegration sequence repetition factor exposure contig durintSeq dbBYTES128 Name of the during integration sequence exposure conftig durintClock dbBYTES128 Name of the during integr clock pattern exposure config durintVolt dbBYTES128 Name of the during integration voltage set exposure conftig durintRep dbINT32 During integr sequence repetition factor exposure contig readSeq dbBYTES128 Name of the readout sequence exposure contig readClock dbBYTES128 Name of the readout clock pattern exposure conftig readVolt dbBYTES128 Name of the readout voltage set exposure contig readRep dbINT32 Readout sequence repetition factor New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 6 0 04 05 2010 Page 39 of 76 Point Attribute Type Description exposure contig expType dbBYTES32 Exposure type Normal Bias Dark etc exposure contig expRepeat dbINT32 Number of exposure repetitions exposure conftig expTime dbDOUBLE Exposure time exposure contig pWipeEnabled dbLOGICAL Periodic wipe enabled or not exposure config pWipePeriod dbINT32 Wipe period exposure conftig fileName dbBYTES128 Name of FITS file with image exposure control state dbINT32 Current state of exposure e
73. rror Severity Description ngco lt mod gt ERR_FATAL fatal Fatal internal error 40s ngco lt mod gt ERR_CREATE serious Failure creating 40s ngco lt mod gt ERR_INIT serious Failure initializing 40s ngco lt mod gt ERR_FUNCTION serious Failure invoking function 40s ngco lt mod gt ERR_NULL_POINTER warning Pointer to 40s is NULL ngco lt mod gt ERR_ZERO warning Division by zero while 20s ngco lt mod gt ERR_NOT_FOUND warning Object 20s ID d not found Failed to read from DB 35s ngco lt mod gt ERR_DB_READ SeNOUS o 3560 355 Failed to write to DB 35s ngco lt mod gt ERR_DB_WRITE SENOUS o 3560 355 Failed to send command 20s to ngco lt mod gt ERR_SEND_ COMMAND serious OG As Failed to send 20s reply for ngco lt mod gt ERR_SEND_REPLY serious command 20s to 40s Error reply to command 20s ngco lt mod gt ERR_REPLY serious erer from 40s New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 6 0 04 05 2010 Page 55 of 76 Error Severity Description ngco lt mod gt ERR_TIMEOUT serious Command 20s sent to 40s timed out ngco lt mod gt ERR_PARAMETER warning Parameter 20s has invalid value ngco lt mod gt ERR_ABORTED warning Command 20s aborted ngco lt modsERR_STATE serous Command 20s not allowed in state 40S ngco lt mod gt ERR_ACTION
74. s of keywords file option or keywords function option For example msgSend SRTAPENV ngcocon_ lt label Wo file mysetup det msgSend SRTAPENV ngcocon_ lt label function DET1 WINI gt SETUP gt SETUP sULTL 25 7 1 Changes with respect to FIERA The setup keyword DET MODE CURI The setup keyword DET FRAM FI L The setup keyword or rau ri D replaces DET READ CLKIND ENAME replaces DET FRAM FITSUNC TSMTD is obsolete and not accepted any more VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 44 of 76 8 Status Command The STATUS command issued to the coordination control process ngcocon_ lt label gt returns the status of all the processes For debugging the STATUS command can also be sent to the NGC general Purpose Control Server ngcdscEvh_ lt label gt see section 3 1 2 using the parameters described in RD77 8 1 Changes with respect to FIERA The STATUS command was not implemented in the FIERASW VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 45 of 76 9 Exposure Handling 9 1 Description 9 1 1 Exposure types NGCOSW distinguishes among the different types of exposure defined in the Glossary see AD63 for a
75. s will then shutdown all sub processes A shutdown script is also available ngcoDcsStop option The option is kill kill NGCOSW processes not terminated by EXIT command 3 4 1 Changes with respect to FIERA NGCOSW is still shutdown by an EXIT commana like the FIERASW The script ngcoDcsStop replaces the script fcdDcsStop VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 33 of 76 4 Command Interface The coordination control process ngcocon_ lt label gt is the only command interface between ICS and NGCOSW The commands which can be issued to the coordination control process are listed in the following table where means that they are not yet implemented Command Parameters Format Description ABORT none S Abort running exposure CONT String Continue a paused exposure at a lt YYYY MM DD gt T lt hh mm ss gt given time default now or now END none End the current exposure s and read out the data EXIT none S Bring the system to operational state OFF and terminate it INIT none Initialize the system The system status goes to LOADED OFF none Bring the system to operational state LOADED ONLINE none Bring the system to operational state ONLINE PAUSE String Pause exposure at a given time lt YYYY MM DD gt T lt hh mm ss gt default now or now SELFTST function String Execute a self test sw and hw
76. se environment is active and the NGC LLCU where the LCUENV online database environment is active or run completely on the NGC LLCU where both the IWSENV and the LCUENV online database environments are active e Hardware Simulation mode In Hardware Test mode the NGC detector electronics is simulated see section 3 1 3 The NGCOSW can either be distributed on both the IWS where the IWSENV online database environment is active and the NGC LLCU where the LCUENV online database environment is active or run on a single host where both the IWSENV and the LCUENV online database environments are active This mode can be used by the higher level OS software to test the interface with the NGCOSW when no NGC detector electronics is available By using the ESO VLT message system the system configuration e where the NGCOSW processes are running is completely transparent to the actors instrument software operator engineer etc because the communications between the different processes are performed through the online database environments IWSENV and LCUENV independently from the host where these are active In this way always the same software is used in all the different scenarios in order to guarantee system robustness and behavior consistency NGCOSW operational mode is set by the DET CON OPMODE setup keyword in the camera configuration set see section 3 2 3 2 or defined
77. serous Action 20s 15s failed in state 40S ngco lt mod gt ERR_EVENT sanois Event 20s not handled in state 40S ngco lt mod gt ERR_ASSERT serious Assertion Failed 20s 40s d Table 11 Errors common to all NGCOSW modules The errors which are specific to certain modules of the NGCOSW are listed in the following tables Error Severity Description ngcoittERR_NOT_DEFINED serious Variable 20s not defined ngcoitcERR_RTD serious Error communicating to RTD 40s NOTE it is under investigation the usage of an error definition file common to all modules Table 12 Errors specific to the ngcoit module the VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 56 of 76 12 Error and Logging Handling Error and system logging is performed using the standard CCS error and logging systems see RD32 NOT YET IMPLEMENTED Additionally the verbose output can be logged in a detail depending on the given log level see setup keyword DET CON LOG in section 3 2 1 and command VERBOSE in section 4 for maintenance and debugging purposes Operational logs are TBD VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 57 of 76 13 Real Time Display Interface NGCOSW provides raw data for the VLTSW real time display utility rtd The mechanism to deli
78. sing the command ABORT In this case no data file is generated unless a frame was already received at the time when the command was issued The command END makes the acquisition process terminate the exposure as soon as possible and generate a data file The command WAIT can be used to wait for an exposure to complete A reply message with the current exposure status is sent immediately When the exposure status is or becomes completed i e success failure or aborted NGCOSW sends the last reply which again contains the actual exposure status A running exposure always has to be waited for completion before starting the next one or before issuing a new setup Typical command sequences are a START WAIT b START PAUSE CONTINUE WAIT c START END WAIT VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 48 of 76 d START ABORT WAIT Alternatively the exposure status attribute in the database see section 6 1 may be used to wait for a specific state e g transferring 9 2 1 Changes with respect to FIERA NGCOSW implements the same exposure commands of the FIERASW 9 3 File Formats If data storage is enabled images are saved in the INS_ROOT SINS_USER DETDATA directory as FITS files compliant with RD37 i e using the image extension per chip format In this format data are orde
79. t SYSTEM COMMON CONFIGFILES S CCDNAME CAMERA_TARGET cfg lt ins_root gt SYSTEM COMMON CONFIGFILES S CCDNAME ENVIRONMENT CCDNAME CCD camera name INS_ROOT default instrument root directory INS_USER default to SYSTEM RETURN VALUES 0 if SUCCESS 1 if FAILUREd EXAMPLES gt ngcoDcsInstall config opdcfg Install all what needed for scientific CCD whose configuration files are stored in the opdcfg module New General Detector Con Optical DCS User Man VLT MAN ESO 13660 4086 Issue 6 0 04 05 2010 Page 66 of 76 troller ual 16 1 3 ngcoDcsStart NAME ngcoDcsStart startup of optical SYNOPSIS ngcoDcsStart instance lt ccdname gt opmode lt opmode gt autonlin lt T F gt osc lt oscproc gt k DESCRIPTION This shell script performs a star instance lt ccdname gt detector name verbose lt level gt NGC DCS lenv lt lenv gt xterm lt T F gt ite lt itcproc gt env lt env gt gui lt guiname gt ZEIL tup of NGC optical DCS default SCCDNAME env lt env gt lenv lt lenv gt opmode lt opmode gt lt guiname gt gui xterm lt T F gt autonlin lt T F gt verbose lt level gt ite lt itcproc gt 080 lt oscproc gt name of workstation online database environment default RTAPENV name of remote online database environment default SCCDLENV If lenv 0 only the NGC LCU processes are started
80. t the value of the CCDNAME environment variable is used Defines the local online database environment under which the N GCOSW instance must run If the keyword is not present and not passed as a parameter to the startup script the value of the RTAPENV environment variable is used DET CON LENV String Defines the remote online database environment under which the NGC LLCU part of N GCOSW instance must run If the keyword is not present and not passed as a parameter to the startup script the value of the CCDLENV environment variable is used DET CON OPMODE String Defines the operational mode after starting up Valid values are NORMAL HW TEST HW SIM or LOCAL HW SIM Default is NORMAL in case the keyword is not present DET CON DFEMODE String Defines the operational mode of the NGC General Purpose Control Server after starting up Valid values are NORMAL LCU SIM or HW SIM Default is NORMAL in case the keyword is not present DET CON AUTONLIN Logical When set to 7 the detector system automatically goes to ONLINE at startup Default is F in case the keyword is not present DET CON GUI String Launch graphical user interface with the specified process name At the moment only the default program ngcouiPanel is used independently from the process name which is specified VLT MAN ESO 13660 4086 New General Det
81. ver raw data is the same as defined in RD40 Raw data are written in shared memory as they come out from the Detector Electronics namely with full resolution 16 or 32 bits unsigned integer No reduction e g to 8 bits is done by NGCOSW In addition to the display of the raw data NGCOSW supports also the display of World Coordinates through rtd One point in the NGC branch of the online database is dedicated to this feature see section 6 2 13 1 Changes with respect to FIERA NGCOSW provides the same interface to rtd of the FIERASW VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 58 of 76 14 Graphical User Interface 14 1 Control Panel A graphical user interface is provided to operate NGCOSW in standalone mode One single panel shown in Figure 5 provides all functionality needed to startup shutdown the NGC software define an exposure setup start and control an exposure display an image as result of an exposure The same panel is used independently if and which parts of the CCD system used are simulated To startup the optical NGC Control Panel run ngcouiPanel amp New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 6 0 04 05 2010 Page 59 of 76 D ngcouiPanel wodt6 File Std Options Operational Mlode System Status and Control CCDNAME muse NORMAL
82. which can be issued directly to the different processes are listed in the following table where means that they are not yet implemented Command Parameters Format Description KILL none Kill the process The system status goes to OFF PING none Verify whether the process is able to send or receive messages SIM SIMULAT none Put the process into simulation mode Table 3 Special command list 4 1 Changes with respect to FIERA NGCOSW implements the same commands of the FIERASW To keep backward compatibility with the FIERASW as much as possible but reducing at the same time differences with the NGC software for the infrared detectors some command aliases have been provided e g SIM SIMULAT The command STOPLP replaces STOP VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 36 of 76 5 Multiple Instances of DCS For instruments controlling a single DCS the system coordination control process ngcocon_ lt CCDNAME gt is the only command interface between ICS and NGCOSW see section 4 If multiple instances of DCS are used e g for instruments which control more than one NGC LLCU a super system coordination control process briefly Super Control process ngcocon_ lt label gt is the only command interface between ICS and NGCOSW The Super Control process is contained in the ngcosc module Note a system control
83. which can be used to generate the online database for an optical NGC system On a LLCU this shell script generates and starts the online database environment host lt IWS LLCU gt Defines if the database must be generated on an IWS or on A NGC LLCU renv lt renv gt name of remote online database environment on the IWS this is CCDLENV on the NGC LLCU this is the S RTAPENV of the IWS ONLY IN THE IWS CASE more lt renv gt can be given to check if they are all known by the ACC server instance lt ccdname gt detector name default CCDNAME env lt env gt name of local online database environment default SRTAPENV user lt user gt name of the user running NGCOSW FILES Source files SVLTTOP ENVIRONMENTS ngco DATABASE db SVLTTOP ENVIRONMENTS ngco USER db Generated files on IWS SVLTDATA ENVIRONMENTS SRTAPENV db1 DATABASE db NGCOSW SVLTDATA ENVIRONMENTS SRTAPENV db1 USER dbNGCOSW Generated files on LLCU SVLTDATA ENVIRONMENTS SRTAPENV db1 DATABASE db SVLTDATA ENVIRONMENTS SRTAPENV db1 USER db ENVIRONMENT CCDNAME CCD camera name RTAPENV Online database environment name VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 63 of 76 RETURN VALUES 0 if SUCCESS 1 if FAILURE EXAMPLES gt ngcoDcsOldb host LLCU renv wte98 gt ngcoDcsOldb host IWS renv wodt8 gt ngcoDcsOldb host IWS renv wodt6 wodt8 ccdname mycam user myuser VLT MAN E
84. xposure control stateDescr dbBYTES32 Description of current state of exposure exposure control shutter dbINT32 Shutter status exposure control shutterDescr dbBYTES32 Description of shutter status exposure control remTime dbDOUBLE Remaining time to complete exposure exposure control readTime dbDOUBLE Time to read image data from detector exposure control tranPercent dbINT32 Percentage of image transferred to WS exposure control tranTime dbDOUBLE Time to transfer image to WS telemetry config enabled dbLOGICAL Telemetry enabled or not telemetry control state dbINT32 Current state of telemetry monitoring telemetry data current vector of Current telemetry values dbDOUBLE Table 4 Online database attributes for detector system monitoring NOTE the interface with BOSS is still under verification therefore the attributes above could be modified and the definitions in ngcoDbPublic h will be updated 6 2 Interface between NGCOSW and TCS Point Attribute Type Description wes ra dbDOUBLE Centre right ascension in degrees for World Coordinates display wes dec dbDOUBLE Centre declination in degrees for World Coordinates display Table 5 Online database attributes for TCS VLT MAN ESO 13660 4086 New General Detector Controller Issue 6 0 Optical DCS User Manual 04 05 2010 Page 40 of 76 6 3 Image post processing interface The way image post processing can be implemented is describ

pdf-file

Contents

Download Pdf Manuals

Related Search

Related Contents