Home

VLT-MAN-ESO-13660-40..

1. 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 config 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 preintClock 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 contig readVolt dbBYTES128 Name of the readout voltage set exposure contig readRep dbINT32
2. INY 2 10 Prepare the next exposure define a loop of exposures msgSend SRTAPENV ngcocon_SCCDNAME EXP NREP 10 D RTL function 11 Start the loop of exposures msgSend SRTAPENV ngcocon_SCCDNAME START 12 Wait until the last exposure has been completed msgSend SRTAPENV ngcocon_SCCDNAME S ETUP WAL T New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 64 of 66 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 _function DET1 EXP NREP 1 Start the exposure 4 Pause the exposure 4 Modify the exposure time 4 function DET1 WIN1 UITI Continue the exposure nsgSend S RTAPENV ngcocon_SCCl nsgSend SRTAPENV ngcocon_SCCl nsgSend SRTAPENV ngcocon_S CCDNAME 60 msgSend SRTAPENV ngcocon_SCCDNAME Wait until the exposure has been completed msgSend SRTAPENV ngcocon_ SCCDNAME Check the exposure status dbRead lt alias gt CCDNAME expos Stop periodic wiping SETUP START PAUSE SETUP CONT wee WA T T woe ure control state msgSend SRTAPENV ngcocon_S CCDNAME STOPWP Exi
3. Optical DCS User Manual 30 10 2008 Page 53 of 66 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 Id pulpo cfg v 1 44 2004 05 10 22 47 31 vlitsccm 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 i VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 54 of 66 New General Detector Controller Optical DCS User Manual 16 Manpages
4. su lt myUser gt c rm f S VLTDATA ENVIRONMENTS S RTAPENV S 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 correctly 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 vlitdata tmp logFile local2 warning vitdata tmp logAuto info mail locall local2 none mylIws locall warning myIws 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 dcfgCON
5. 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 ccdname lt ccdname gt env lt env gt lt renv3 gt lt 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 user running the On an IWS this s SVLTDATA ENVI the local machine and in the ACC server software etc hell script then installs in the directory RONMENTS SRTAPENV db1 scanning the template files DATABASE db NGCOSW and USER db NGCOSW 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 remote online database environment IWS this is SCCDLENV 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 name of on the Cem lt renv gt ccdname lt ccdname gt detector name default SCCDNAME name of local online database environment default SRTAPENV env lt env gt user lt user gt name of the user running NGCOS
6. lt myCCDNAMI Verify that the needed processes are running in the CCS environment by using E gt with the name of the camera e g CCDNAMI E gt exposure control s ccsPerfMon A view similar to the following should be displayed UID CI tate ye oooooooooo0oo0o0o000000000000000000000000000000000000000000000000000000000 Process Name PNUM PID ccsScheduler I 4224 ccsSHManager 2 4228 qsemu 3 4231 evtEventConfg 4 4239 timsTimeKeeper 5 4233 scanMngr 6 4248 ecsScan 7 4259 ccsCmdServer 8 4243 alrmServer 9 4247 cmdManager 12 4236 msgServer 13 4237 logManager 14 4238 alrmLogger 16 4268 hisDHMngr 17 4269 ccsPerfMon 22 6532 dbMQDBM 58 4232 3227 3227 3227 3227 3227 300 300 3227 3227 3227 3227 3227 3227 300 3227 3227 GID MSGID MONPID 300 1 1 300 1582563329 1 300 1583415311 1 300 1583087623 1 300 1582825475 1 300 1583284234 1 300 1583480856 1 300 1583153160 1 300 1583218697 1 300 1582891012 1 300 1582956549 1 300 1583022086 1 300 1583677452 1 300 1583743004 4270 300 1589313576 1 300 1582759938 1 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 14 of 66 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
7. FE AE HE EE EE FE FE AE FE EE EEE EEE EE EEE EE E EH DETi keywords DET ID NGC TEST Detector system Id DET DATE 2006 11 22 Installation date DET NAME NGC TEST 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 l Coordinate value of ref pixel CTYPE2 PIXEL Pixel coordinate system CRVAL2 1 Coordinate value of ref pixel HRT E HEEERE HE H H HE HE ERE EE EA HEER E EA EAR IEOEA E EA R IF EA H H CHIP description HP HE EERE HEH HE HE EERE HEH EE HE EE RE EE HE HE EE ERE EE HE HE EERE HE HEH EE HH DET CHIP1 ID SER NO 053 Detector chip identification DET CHIP1 NAME Marlene Detector chip name DET CHIP1 DATE 2006 11 22 Date of installation YYYY MM DD DET CHIP1 NX 2048 Physical active pixels in X DET CHIP1 NY 4096 Physical active pixels in Y DET CHIP1 PRSCX 503 Physical prescan pixels in X DET CHIP1 PRSCY 0 Physical prescan pixels in Y DET CHIP1 OVSCX 50 Physical overscan pixels in X DET CHIP1 OVSCY 0 Physical overscan pixels in Y DET CHIP1 PSZX 195 03 Size of pixel in X mu DET CHIP1 PSZY 15 03 Size of pixel in Y mu DET CHIP1 OUTPUTS ER umber of outputs per chip 007 at New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 408
8. MODE2 OUT1 PRSCY 0 ET MODE2 OUT1 OVSCX 0 ET MODE2 OUT1 OVSCY 0 ET MODE2 OUT1 GAIN 0 3 ET MODE2 OUT1 CONAD 3 33 F ODE2 OUT1 RON 100 ET MODE2 OUT2 CHIP 1 ET MODE2 OUT2 INDEX 2 ET MODE2 OUT2 XIMA KS ET MODE2 OUT2 YIMA 1 F ODE2 OUT2 NX 1024 ET MODE2 OUT2 NY 500 ET MODE2 OUT2 PRSCX 50 ET MODE2 0OUT2 PRSCY 0 ET MODE2 OUT2 OVSCX 0 JE Sh SHE SE ROE HE Output prescan pixels in X Output prescan pixels in Y Output overscan pixels in X Output overscan pixels in Y Conversion from electrons to ADU Conversion from ADUs to electrons Readout noise per output e Exposure mode name Exposure mode description Enable trigger Gain used Wipe sequence repetition number ame of CLDCi FILE for wipe ame of SEQi CLKFILE for wipe ame of SEQi PRGFILE for wipe Preint sequence repetition number ame of CLDCi FILE for preintegration ame of SEQi CLKFILE for preintegration ame of SEQi PRGFILE for preintegration During int sequence repetition number ame of CLDCi FILE during integration ame of SEQi CLKFILE during integration ame of SEQi PRGFILE during integration Readout sequence repetition number ame of CLDCi FILE for readout ame of SEQi CLKFILE for readout ame of SEQi PRGFILE for readout ADC data sampling factors umber of outputs used for readout Outputs used for readout Index of chip the output belongs to
9. Output index on the chip Horizontal location of data in image Vertical location of data in image Output data pixels in X Output data pixels in X Output prescan pixels in X Output prescan pixels in Y Output overscan pixels in X Output overscan pixels in Y Conversion from electrons to ADU Conversion from ADUs to electrons Readout noise per output e Index of chip the output belongs to Output index on the chip Horizontal location of data in image Vertical location of data in image Output data pixels in X Output data pixels in X Output prescan pixels in X Output prescan pixels in Y Output overscan pixels in X New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 27 of 66 Output overscan pixels in Y Conversion from elec Conversion from ADUs Readout noise per ou Het Het Shu Shu Shu Shu HEHE EHH EEE THEE RE HEE EE EE EH EE tter controller tter type Device index Rou te to module Optional module name trons to ADU to electrons tput e HEREHERE HEHE SH tter available or not tter unique identifier EK KK ee A I kk DET MODE2 OUT2 OVSCY 0 DET MODE2 OUT2 GAIN 0 3 DE MODE2 OUT2 CONAD 3 33 DET MODE2 OUT2 RON 200 HHEHFHEEEHEREEEREEEREE EEE HEHE HEH HE HHH HE HH SHUT descri
10. 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 4 0 Optical DCS User Manual 30 10 2008 Page 42 of 66 is associated to each exposure The exposure Id should be passed to the NGCOSW as a parameter of the command START as 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 a
11. 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 4 0 Optical DCS User Manual 30 10 2008 Page 8 of 66 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 state and the additional shutter control whereas the infrared control server mainly reacts passively on
12. electronics is simulated see VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 19 of 66 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 Procedure The startup procedure is based on the common VLTSW configuration tool ctoo RD75 Among the other files an instrument module lt xx gt dcfg see section 3 1 contains e a startup configuration file lt xx gt dcfgCONFIG cfg e one configuration set lt xx gt dcfgCAMERA cfg The configuration set describes an instance of the NGCOSW in short FITS format where means that their usage is not yet implemented Keyword Type Description 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 DET CON INSTANCE String Process registered with the CCS environment If the keyword is not present and not passed as a parameter to the startup script
13. 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 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
14. in the following table Error 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 Serious Io 355 35s Failed to write to DB 35s ngco lt mod gt ERR_DB_WRITE SEHR o 355 35s Failed to send command 20s to ngco lt mod gt ERR_SEND_COMMAND serious 40s 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 received from 40s VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 47 of 66 Error Severity Description Command 20s sent to 40s timed ngco lt mod gt ERR_TIMEOUT serious WS 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 sta
15. 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 MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2
16. 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 one integration 0 integration time shutter if any closed Flat one integration shutter if any open DEE String 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 Optical DCS User Manual New General Detector Controller VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 37 of 66 Keyword Type Description Number of repeated exposures DET EXP NREP Integer 0 means forever DET EXP TIMEREP Double Time between two repeated exposures DE
17. the value of the CCDNAME environment variable is used Defines the local online database environment under which the NGCOSW instance must run DET CON ENV String 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 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 VLT MAN ESO 13660 4086 Page 20 of 66 Keyword Type Description DET CON LENV String Defines the remote online database environment under which the NGC LLCU part of NGCOSW 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 use
18. time default now STARTTL period Integer Start monitoring of telemetry values logperiod Integer at the end of the running exposure 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 4 0 Optical DCS User Manual 30 10 2008 Page 31 of 66 Special commands 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 be
19. 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 becomes 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
20. with care New General Detector Controller Optical DCS User Manual AE VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 52 of 66 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 File Mode Online LOADED idle Mode HW SIM Detector Configuration ene 1 SERIT Status disabled Disable een Vol tages Clocks CLOCK_1_LO Save 0 000 wins 20 000 20 000 set 0 000 Telemetry 0 000 Restore Restore a Mon t 1 Monz 1 Pa 0 Diode CLDC Disable All CLDC 1 Sequencer 1 Status idle Help Read Mode Start Stop Break 1 Continuous Made Read out Window Trigger Mode Time Factor sx 2 nx 0 Time ada 0 SE E Nv e Clock File Program DIT 5 0000000 s P Run Ctrl Syne Start Stop All Break All SEQ 1 ADC Module 1 Units Offset _ADC 1 Command Delay Mode Normal Monitori r PKt Size Sim Numbers monitore 1 Pkt Cnt W Cut 1Cu 1 Filter 1 Clamp N New General Detector Controller Abort Reset Figure 4 NGC Engineer Panel Clear Dump VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0
21. xx gt dcfgCAMERA cfg PAF HDR START Start of PAF Header PAF TYPE Configuration Type of PAF PAF ID vee 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 Y Ss Name of person appl changing PAF LCHG DAYTIM d Timestamp of last change PAF CHCK NAME Das Name of appl checking VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 4 0 Im Optical DCS User Manual 30 10 2008 Page 23 of 66 PAF HDR END End of PAF Header FE EAE EE HEE EH EE EE AE E FE EEE EE EE EE HEE EEE EEE EE EEE EEE EE NGCCON DICTIONARY FE E E E HE E HE E E E FE E FE EERE EAE EAE EAE ERE ERE EGE EGE EGE EGE HHH HHH E E E E HHH System configuration DET CON INSTANCE SCCDNAME Instance label DET CON ENV SRTAPENV Local online database environment DET CON LENV SCCDLENV Remote online database environment DET CON OPMODE HW SIM Operational mode DET CON AUTONLIN F Go online after start DET CON GUI ngcouiPanel GUI Name DET CON DICT NGCDCS NGCCON Dictionary list DET CON XTERM F Start in new terminal DET CON LOG D Logging level ee NGCDCS DICTIONARY FE HE E HE ET EE FE AE FE FE FE FE FE AE
22. 008 Page 9 of 66 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 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 10 of 66 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 N GCOSW package consists of 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 applications 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 ncgotm The NGC Telemetry module for optical applications e ngcoui Engineering GUI used for direct system interaction and data acquis
23. 6 Issue 4 0 30 10 2008 Page 24 of 66 DET CHIP1 X 1 X location in array DET CHIP1 Y 1 Y location in array DET CHIP1 XGAP 0 0 Gap between chips along x mu DET CHIP1 YGAP 0 0 Gap between chips along Y mu DET CHIP1 RGAP 0 0 Angle of gap between chips DET CHIP1 INDEX 1 Chip index DET CHIP1 LIVE Te Detector alive DET CHIP1 TYPE CCD The Type of detector chip DET CHIP1 PXSPACE 1E 6 Pixel Pixel Spacing DET CHIP1 OUT1 NAME NOW Description of output DET CHIP1 OUT1L INDEX 1 Output index DET CHIP1 OUT1 ID WEE ele WEE Output ID as from manufacturer DET CHIP1 OUT1 X 1 X location of output DET CHIP1 OUT1 Y 1 Y location of output DET CHIP1 OUT1 READX 1 Horizontal readout direction DET CHIP1 OUT1 READY 1 Vertical readout direction DET CHIP1 OUT2 NAME END Description of output DET CHIP1 OUT2 INDEX 2 Output index DET CHIP1 OUT2 ID WEE ele E Output ID as from manufacturer DET CHIP1 OUT2 X 2048 X location of output DET CHIP1 OUT2 Y 1 Y location of output DET CHIP1 OUT2 READX 1 Horizontal readout direction DET CHIP1 OUT2 READY 1 Vertical readout direction HGH HE HE EH HE HE HE HE ERE HEH EE HE EE EE EE EE HE EERE EH EE HE EERE EH EH EE HEH DEV description HP HE EERE HE HEHE HERE EE HEE HE EE RE EE HE HE EE EE EE HEE E
24. Accepted by ESO Technical Archive 06 11 08 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 4 0 Date of Issue 30 10 2008 Prepared by Name Date Signature Claudio Cumani 30 10 200 lee gt Andrea Balestra DA WH Approved by Name Date Signature Dietrich Baade 3 4 2908 Dich Bac ok Released by Name Date Signature Mark Casali al u og AE A H VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 2 of 66 CHANGE RECORD ISSUE DATE SECTIONS REASON INITIATION AFFECTED DOCUMENTS REMARKS 22 09 2006 Se First draft basic information for optical prototype draft basic information for optical prototype E D 31 07 2007 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 databa
25. BASE db NGCOSW and USER db NGCOSW templates to edit the DATABASE db and USER db files New General Detector Controller Optical DCS User Manual Page VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 12 of 66 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 SCCDNAME lt myPATH gt with the preferred oldb location eg 2DCS Optical undef 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 lt my 1 instrument name lt myCCDNAME gt lt myCCDNAMI INSTRUMENT gt with the E2 gt lt myCCDNAME3 gt lt myCCDNAME4 gt with the camera names the values of CCDNAME on the different LLCUs lt myPATH gt with the preferred oldb location eg DCS optical undef DCSNAME undef CCDNAME Zundert ngcdcsINSTANCE undef CCDNAME2 Zundert ngc
26. Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 26 of 66 EI EI Ooo oe U U VIII U G U iss G iss G Wel ET MODE1 OUT1 PRSCX 50 ET MODE1 OUT1 PRSCY 0 ET MODE1 OUT1 OVSCX 50 F ODE1 OUT1L OVSCY 0 F ODE1 OUT1 GAIN 0 3 ET MODE1 OUT1 CONAD 3 33 ET MODE1 OUT1 RON 123 MODE2 ET MODE2 NAME Test2 ET MODE2 DESC Test mode 2 ET MODE2 TRIGGER F ET MODE2 GAI Wei ET MODE2 WREP 4 ET MODE2 WCLDFI wipel v ET MODE2 WCLKFI wipel bclk ET MODE2 WPRGFIL wipel seq ET MODE2 PREP 1 ET MODE2 PCLDFI preintl v ET MODE2 PCLKFI preintl bclk ET MODE2 PPRGFIL preintl seq ET MODE2 DREP 0 ET MODE2 DCLDFIL ws ET MODE2 DCLKFI ws ET MODE2 DPRGFIL s ET MODE2 RREP 1 ET MODE2 RCLDFIL readl v ET MODE2 RCLKFI readl bclk ET MODE2 RPRGFIL readl seq ET MODE2 ADCSAMPL Wet F DE2 OUTPUTS 2 F DE2 ADC1 ADCS WL 5 3 3 ET MODE2 OUT1 CHIP E ET MODE2 OU INDEX 1 ET MODE2 OUT1 XIMA La ET MODE2 OUT1 YIMA E ET MODE2 OUT1 NX 1024 ET MODE2 OUT1 NY 500 ET MODE2 OUT1 PRSCX 50 ET
27. E E E E EE HEHE EE RHEE EH DET ADC1 DEVIDX 1 DET ADC1 ROUTE WEN DET ADC1 NAME ADC Module 1 DET ADC1 SIMMODE D DET ADC1 OPMODE D DET ADC1 OFFSET Zoe DET ADC1 NUM 4 DET ADC1 FIRST Tq DET ADC1 PKTCNT D DET ADC1 PKTSIZE 4 DET ADC1 CONVERT1 T DET ADC1 CONVERT2 E DET ADC1 BITPIX 16 DET ADC1 MON1 SE DET ADC1 CLAMP Es PEPER RE HE EEE EE EEE RE HE EEE EE EEE EEE MODE description PERERA RE HE HEE EE EEE RE HE EEE THEE EH MODEL DET MODE1 NAME Test1l DET MODE1 DESC Test mode 1 DET MODE1 TRIGGER F DET MODE1 GAI n DET MODE1 BNDWTH nn DET MODE1 WREP 1 DE ODE1 WCLDFI wipel v DE ODE1 WCLKFIL1 wipel bclk DET MODE1 WPRGFIL1 wipel seq DET MODE1 PREP 1 DET MODE1 PCLDFIL1 preintl v DET MODE1 PCLKFIL1 preintl bclk DET MODE1 PPRGFIL1 preintl seq DET MODE1 DREP 0 DET MODE1 DCLDFIL1 wn DET MODE1 DCLKFIL1 nn DEI MODE1 DPRGFIL1 n DET MODE1 RREP 1 DET MODE1 RCLDFI readl v DET MODE1 RCLKFIL1 readl bclk DET MODE1 RPRGFIL1 readl seq DE ODE1 ADCSAMPL 1 1 DET DE1 OUTPUTS 1 DET MODE1 ADC1 ADCS W DET MODE1 OUT1 CHIP 1 DE ODE1 OUT1 INDEX 1 DET MODE1 OUT1 XIMA 1 DET MODE1 OUT1 YIMA 1 DET MODE1 OUT1 NX 2048 DET MODE1 OUT1 NY 500 PE EE HHT EH EE EH AE FE EEE AE FE HE EEE HHH FE EAE TE AE FE FE AE FE AE HEE FE HHH EEE AE FE HE HEE HEH associated device index route to module optional name simulation level of ADCs operation
28. E HEE RE EE HEH HE HEH DET DEV1 NAME dev ngc0O_com associated device nam DET DEV1 HOST SHOST host where interface resides DET DEV1 ENV SRTAPENV server environment name DET DEV1 SRV mn optional server name DET DEV1 TYPE es optional type HHH HE EEE RE HE HE HE HE HEE RE EE HE HE HE ER EE HE EE EERE EE HEHE HEE RE HE HEE EE HEH CLDC description HEHEHE HE HERE HE HEH HE HE ERE HEH EE HE EER EE HE EE ER EE HE HE EE ERE HE HEH EE HE HE DET CLDC1 DEVIDX 1 associated device index DET CLDC1 ROUTE Ng route to module DET CLDC1 NAME CLDC 1 optional name DET CLDC1 AUTOENA F auto enable at online HH HE HE EE HE HH HE HE ER HEH EE HE HE ER EE HE EE aE ER EH EE HE EE RE HE HEH HE HH SEQ description HPT HE HERE EE HH HE HE RE HEH EE HE HEE RE EE HE HE EERE EE HE EE HE RE HE HEH HE HH DET SEQ1 DEVIDX 1 associated device index DET SEQ1 ROUTE va route to module DET SEQ1 NAME Sequencer 1 optional name VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 4 0 Im Optical DCS User Manual 30 10 2008 Page 25 of 66 PEER EE EE HE TEE EEE EERE HE TEE EEE EEE ADC description PERERA RE HE HEHE
29. FIG cfg and the configuration set 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 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 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 15 of 66 then populate the INS_ROOT ngcoDcsInstall config lt xxdcfg gt Manpage of ngcoDcsInstall is available in 16 1 2 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 16 of 66 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 front 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 4 0 Optical DCS User Manual 30 10 2008 Page 17 of 66 Commands Configuration Files FITS Files Files Exposure Coord k Transfer Server Transfer Server Figure 1 Optical NGC software Architectur
30. File Std Options Help System Status and Control CCDNAME opd Load config Operational Mode HW SIM Operational state LOADED CCDBLENY wodt17 Eng Interface Startup Shutdown HW sim Normal Online Standby Off IngeoDesStart xterm instance opd env wodtl lenv wodt17 opmode HW SIM autonlin F kill Exposure Mode Rane Integration Time fo Y Binning fa Load Setup E Interval lt gt Exposures fo Wipe time before Exp fo Normal Image File Name defaut Rtd HGe Exp Control Start End Exposure Configuration Exposure Status Abort Mode Description Status INACTIVE Pause Exposure type Shutter Status SHUTTER CLOSED Continue Repetitions 0 Remaining Time D sec End Loop Time 0 sec Wipe Disabled Readout Time D sec Wipe Percentage D Per Wipe File Name Transfer Time 0 sec Stop Wipe Exposure Setup Number of exposures 1 x Binning fa Save Setup d vi BS Figure 3 Optical NGC Control Panel 14 2 Engineering Interface A GUI panel is provided to help engineers in case of trouble see Figure 4 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
31. NV 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 mynge 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 Terminate in a hard way the NGCOSW at WS level only for camera myccd WS environment myws New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 60 of 66 gt ngcDcsStop instance myccd env FALSE lenv myngc Terminate in a soft way the NGCOSW at LCU level only for
32. Readout sequence repetition factor New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 34 of 66 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 exposure 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 mo
33. T 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 1 Double Subintegration time in seconds DET READ SHIFT lt i gt Integer Lines shifted between integrations Line shift type alternate DET READ SHIFTYP String E eee list as defined in list SHIFTi Table 8 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 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 38 of 66 Keyword Type Description Real Time image display 1 no display SERES cl 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 Im
34. W 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 RTAPENV CCD camera name Online database environment name RETURN VALUES New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 55 of 66 EXAMPLES gt gt gt if SUCCESS if FAILURE ngcoDcsOldb host LLCU renv wte98 ngcoDcsOldb host IWS renv wodt8 ngcoDcsOldb host IWS renv wodt6 wodt8 ccdname mycam user myuser VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 4 0 O Optical DCS User Manual 30 10 2008 Page 56 of 66 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 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 whose files in VLTTOP config contain the detector configur
35. a for the VLTSW real time display utility rtd The mechanism to deliver 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 4 0 Optical DCS User Manual 30 10 2008 Page 50 of 66 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 3 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 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 ES Q Optical DCS User Manual 30 10 2008 Page 51 of 66
36. age 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 FRAM 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 sets 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 4 0 Optical DCS User Manual 30 10 2008 Page 39 of 66 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
37. ailable to in 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 4 0 Optical DCS User Manual 30 10 2008 Page 46 of 66 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 h 1p 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 ooch see RD77 In addition N COSW modules define their own errors The errors which are common to all the modules are listed
38. al mode of ADC module offset value for ADC volt number of ADCs on board first in chain packet routing length packet size convert on strobe 1 convert on strobe 2 ADC bits per pixel ADC channel to monitor Analog Clamp and Sample FE EAE TE AE FE FE AE FE AE AE FE AE FE FE AE FE FE AE FE AE FE TE AE EE HE HEH FE EAE TE AE HHT EH HE FE FE AE FE FE AE FE AE FE HE FE FE FE FEE EN Exposure mode name Exposure mode description Enable trigger Gain used Bandwidth used Wipe sequence repetition number ame of CLDCi FILE for wipe ame of SEQi CLKFILE for wipe ame of SEQi PRGFILE for wipe Preint sequence repetition number ame of CLDCi FILE for preintegration ame of SEQi CLKFILE for preintegration ame of SEQi PRGFILE for preintegration During int sequence repetition number ame of CLDCi FILE during integration ame of SEQi CLKFILE during integration ame of SEQi PRGFILE during integration Readout sequence repetition number C S S ame of DCi FILE for readout ame of SEQi CLKFILE for readout ame of SEQi PRGFILE for readout ADC data sampling factors umber of outputs used for readout Outputs used for readout Index of chip the output belongs to Output index on the chip Horizontal location of data in image Vertical location of data in image Output data pixels in X Output data pixels in X eyt at New General
39. 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 4 0 Optical DCS User Manual 30 10 2008 Page 40 of 66 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 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 durat
40. 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 exposure and the only processing to be done is pixel sorting centroiding and possibly and offset correction if not yet
41. atabase startup added Detector user description added Logging configuration added INS_ROOT population description improved Example updated Manpage Chapter added Minor corrections VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 4 of 66 Table of contents dE 7 1 1 Gi el 7 t2 ONS E 8 1 3 Applicable Ren 8 1 4 Reference Documents eigene Sege eege Eeer 8 1 5 Abbreviations and en 8 kO GISSA sea E E Ore eee eee ee 8 1 7 Stylistic CONVENTIONS E 8 1 8 Naming Conventions EE 9 1 9 Problem Reporting Change Heouest 9 2 Installation and configuration EE 10 2 SoftWare TEE 10 2 2 EE 10 2 2 1 Using installation Ee 10 2 2 2 USING RUN EE 11 2 3 Online database emvironment Aen 11 2 3 1 IWS online database generation ENEE 11 2 3 2 NGC LLCU online database generation cccceeeeeeeeeeeeeeeeeeeeeeeeeneeeeeestaneeees 13 2 3 3 Online database verification E 13 2 3 4 Online database automatic startup cccceceeeeeeneeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneeees 14 2 3 5 Detector E 14 2 4 NGC LLCU logging system configuration cccceeeeeeeeeeeeeeeeeeneeeeeteeeeeeeeetaeeeeenee 14 2 5 ING REENEN See 14 3 Startup Shutdown Ge 16 Os te ube ue VT ue EE 16 3 1 1 NGCOSW operational modes 18 3 1 2 NGC General Purpose Control Server operational modes ssssessssenssrree 18 3 1 3 Simulation of the NGC detector e
42. ation root lt ins_root gt Root directory for the instrument the NGCOWS belongs to Default SINS_ROOT env variable FILES Source files SVLTTOP config dcfgCONFIG cfg ctoo configuration file for the optical NGC detector SVLTTOP config dcfgCAMERA cfg system configuration file for the optical NGC detector SVLTTOP config dcfg Files defining the detector voltages clock patterns and sequences Destination files lt ins_root gt SYSTEM COMMON CONFIGFILES CCDNAME CONFIG cfg lt ins_root gt SYSTEM COMMON CONFIGFILES S CCDNAME CAMERA cfg lt ins_root gt SYSTEM COMMON CONFIGFILES S CCDNAME ENVIRONMENT CCDNAME CCD camera name RTAPENV Online database environment name INS_ROOT default instrument root directory INS_USER default to SYSTEM RETURN VALUES 0 if SUCCESS 1 if FAILURE EXAMPLES gt ngcoDcsInstall config opdcfg Install all what needed for scientific CCD whose configuration files are stored in the opdcfg module VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 4 0 O Optical DCS User Manual 30 10 2008 Page 57 of 66 16 1 3 ngcoDcsStart NAME ngcoDcsStart startup of optical NGC DCS SYNOPSIS ngcoDcsStart instance lt ccdname gt env lt env gt lenv lt lenv gt opmode lt opmode gt gui lt T F gt xterm lt T F gt autonlin lt T F gt kill DESCRIPTION This shell script performs a startup of NGC optical DCS in
43. camera myccd LCU environment myngc SEE ALSO ngcoDcsStart VLT MAN ESO 13660 4086 Si New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 61 of 66 16 1 5 ngcGetProcNum NAME ngcGetProcNum get process number SYNOPSIS ngcGetProcNum 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 D if FAILURE EXAMPLES gt ngcGetProcNum SRTAPENV ngcoexp_S CCDNAME echo SEE ALSO ngcoDcsStart VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 62 of 66 16 1 6 ngcoClean NAME ngcoClean Clean oldb envirionment and shared memory SYNOPSIS ngcoClean DESCRIPTION This shell script performs a shutdown of the online database environment defined by S RTAPENV removing shared memory segments and zombie processes ENVIRONMENT RTAPENV default for oldb environment RETURN VALUES 0 if SUCCESS 1 if FAILURE EXAMPLES gt ngcoClean New General Detector Controller Optical DCS User Manual Issue VLT MAN ESO 13660 4086 4 0 30 10 2008 Page 63 of 66 17 Example of NGCOSW usage Assumi
44. dcsINSTANCE2 undef CCDNAME3 undef ngcdcsINSTANCE3 undef CCDNAME4 Zundert ngcdcsINSTANCE4 undef NGCROOT define DCSNAME lt INSTRUMENT gt define CCDNAME lt myCCDNAME gt define ngcdcsINSTANCE ngcdcs_ lt myCCDNAME gt define CCDNAME2 lt myCCDNAME2 gt define ngcdcsINSTANCE2 ngcdcs_ lt myCCDNAME2 gt define CCDNAME3 lt myCCDNAME3 gt define ngcdcsINSTANCE3 ngcdcs_ lt myCCDNAME3 gt define CCDNAME4 lt myCCDNAME4 gt define ngcdcsINSTANCE4 ngcdcs_ lt myCCDNAME4 gt define NGCROOT Appl_data lt myPATH gt DCSNAME New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 13 of 66 Once the DATABAS T D db and USER db files have been properly edited generate the environment in SVLTDATA ENVIRONM make clean db To initialize and start the environment run vcc VCC Envinit EnvStart e SRTAPENV e SRTAPENV ENTS SRTAPI ENV dbl run 2 3 2 NGC LLCU online database generation On the NGC LLCU the RTAP and started by running ngcoDcsOldb renv lt WS_RTAPENV gt ENV online database environment is automatically generated 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 myCCDNAMI replacing
45. e 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 4 0 Optical DCS User Manual 30 10 2008 Page 18 of 66 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 database 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
46. em 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 ngcDesStart 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 ngcGetProcNum VLT MAN ESO 13660 4086 RENI New General Detector Controller Issue 4 0 O Optical DCS User Manual 30 10 2008 Page 59 of 66 16 1 4 ngcoDcsStop 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 EXIT 3 Try to terminate NGC optical processes in a hard way kill optional instance lt ccdname gt detector name default SCCDNAME 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 S CCDLE
47. en provided e g SIM SIMULAT The command STOPLP replaces STOP VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 32 of 66 5 Multiple Instances of DCS The coordination control process ngcocon_ lt label 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 the coordination control process of the master DCS is the only command interface between ICS and NGCOSW Image format is defined in 9 3 Image transfer and merging for this configuration case are however still TBD New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 33 of 66 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
48. 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 amp XP 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 mylmage 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 4 0 Optical DCS User Manual 30 10 2008 Page 44 of 66 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 H
49. ierarchical 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 processing TBD VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 45 of 66 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 av
50. ion 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 prepared 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 4 0 Optical DCS User Manual 30 10 2008 Page 41 of 66 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
51. ition 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 2 Retrieve all needed modules from the archive and install them cd ngcoarc srec make all install 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 4 0 Optical DCS User Manual 30 10 2008 Page 11 of 66 Note unless a INTROOT is defined all the NGCOSW code 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 2 3 Online database environment To automatically generate the online database the environment variables RTAPENV CCDLENV and CCDNAME mu
52. l 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 dfemode overwrites DET CON DFEMODE autonlin overwrites DET CON AUTONLIN gui overwrites DET CON GUI dict overwrites DET CON DICT 1 xterm overwrites DET CON XTERM log overwrites DET CON LOG If no configuration set is given only the options are used If no configuration is defined and no options are given the system startup is performed using the environment variables CCDNAME RTAPENV CCDLENV INS_ROOT INS_USER in the same way as in the case of the FIERA controller Further special options are kill kill existing NGCOSW processes if any before starting 3 2 2 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 without the options NGCOSW will be star
53. lectronics 0 0 2 cee eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneeeees 19 E System Starp ee Reece ee ene mec ny eee ete ee ee ere he eee ee ee 19 3 2 ic Startup tel 19 3 2 2 Changes with respect to FIERA sss eens accede euenstitennevaenicivcrseernteane Eet 21 3 2 3 Configuration EXAIMpPleS icciicscccedcsdencescsdssesenecanecsancedsnedeadescssecateveenteiaavantecteesanees 22 3 2 3 1 Startup Configuration file lt xx gt dcfgCONFIG cfg ecceeeeeeeeeeeeeeeeneeeees 22 3 2 3 2 Configuration Set do AMERDA cho 22 3 3 NGCOSW operational EN 27 3 3 1 Changes with respect to FIERA E 28 3 4 System SHUTOOWN sc cccawccoehdenanctecnuesanuctcnntassuceesna diceddenss inadas EES 28 3 4 1 Changes with respect to EIERA 28 4 Command Mear 29 4 1 Changes with respect to FIERA EE 31 5 Multiple Instances eteeeeeeE E 32 6 Database nterface eedgegdeteeggebesdenre guer dee EEN 33 6 1 Interface between NGCOSW and the external emironment 33 6 2 Interface between NGCOSW and TC 34 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 5 of 66 6 3 Image processing INtCrACE ccccceeeeeeeeeeeeee eter ee eeeeeeeeeeeneeeeeeseaaaaaaeeeeeeeseenensesensees 35 6 4 ICO len D 35 6 5 Changes with respect to FIERA ricci dtc intsctaccaicenoicdnerseareishivintentiaiartereeiainetdeanicenieidaxe 35 T SUS COMMANA E 36 7 1 Changes with respect TEEN 38 8 Status Co
54. mand reception enabled has been acquired and checked All the voltage switches are closed VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 28 of 66 This is the state at the end of a successful ONLINE command Figure 2 illustrates the NGCOSW operational states and the commands to switch between them see AD28 OFF ngcoDesStart LOADED lt lt EXIT STANDBY STANDBY STANDBY _ p E S 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 labe1 gt The coordination control process 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 command like the FIERASW The script ngcoDcsStop replaces the script fcdDcsStop VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 29 of 66 4 Command Interface The coordination control process ngcocon_ lt label gt is the
55. mmand TE 39 8 1 Changes with respect to FIERA AAA 39 9 Exposure Handling EE 40 91 DESCTIPIO E 40 9 E EN EXPOSUTE e A0 9 1 2 ee E A0 9 1 3 an Ee re cctesuereacsateucesuaiedadeesvabianaeenentens gens ai a A a ai 41 9 14 Exposure d siisii a agaa eege ees deeg 41 9 1 5 Changes with respect to EIERA Aan 42 92 COMMANAS EEN 42 9 2 1 Changes with respect to FIERA getererergeggeregeet gees Drees rege Ee 43 9 3 Cu ET 43 9 3 1 Changes with respect to EIERA un 43 9 4 Naming SCHOM CS sis cones ck eebe D eg Eed Ee 43 9 4 1 Changes with respect to EIERA Aan 43 9 5 FITS Header e csc teers ie ei eee nenene 43 9 5 1 Changes with de NEE 44 9 6 Image tee SING seis cree terrace renane ai iaaa E E a A EA Aa aD a aKa 44 10 Synchronisation BE 45 11 Error Definitio E 46 12 Error and Logging Handling GE 48 13 Real Time Display Interface seenen eege Eege 49 13 1 Changes with respect to FIERA sssssssessssneesonrrnoterrnrrrnnnrsorrrnnntrnnnrstnnrnserrrnnrrennnt 49 TA Graphical User IMS MAC ysccc cicisserdecardsnrceceassteceednncnacnagei bob eneededeexaniveteerauncenbersisnermceadauees 50 14 1 Control Panel E 50 14 2 Engineering We nennt 51 15 Special functionalities for Optical Instruments nene 53 15 1 Shutt r E 53 15 2 Temperature pressure Monitoring ccseeecceceeeeeeeeeeeeeeeeee sense eeeeeeeeeeeeeeeeeeseeees 53 15 2 1 Changes with respect ioEIERA 53 E Pe Adaptive e e 53 16 TATA SS ct cere essce cess cast se
56. ng 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 exposures are performed 1 Start NGCOSW from the Instrument Workstation ngcoDcsStart instance SCCDNAME env SRTAPENV lenv SCCDLENV kill 2 Put NGCOSW in STANDBY msgSend SRTAPENV ngcocon_SCCDNAME STANDBY 3 Put NGCOSW ONLINE msgSend SRTAPENV ngcocon_SCCDNAME ONLINE 4 Perform periodic wiping msgSend SRTAPENV ngcocon_SCCDNAME STARTWP 5 Prepare the next exposure set exposure mode type time and binning msgSend SRTAPENV ngcocon_SCCDNAME SETUP function DET MODE CURID 1 DET1 EXP TYPE Normal DET1 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 D DET1 WIN1 UITI N1 20 DET1 WI ET1 MODE CURID 3 D BI ET1 EXP TYP NX 2 DET1 WI IN1 B E Dark
57. nitoring 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 4 0 Optical DCS User Manual 30 10 2008 Page 35 of 66 6 3 Image processing interface TBD 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 4 0 Optical DCS User Manual VLT MAN ESO 13660 4086 30 10 2008 Page 36 of 66 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
58. 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 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 4 0 Optical DCS User Manual 30 10 2008 Page 30 of 66 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
59. ption HEHEHE EHEREEEEEEEEEE EEE HEHE HEH HE HHH HE HH DET SHUT1 AVAIL H DET SHUT1 CTRL ngc DET SHUT1 TYPE Saudis s DET SHUT1 I1D eso 01 DET SHUT1 DEVIDX l DET SHUT1 ROUTE aa DET SHUT1 NAME Shutter 1 000 3 3 NGCOSW operational states The NGCOSW can be in the following operational states see AD28 In detail all actions needed to bring the whole camera to STANDBY state are very dependent on the system hardware architecture and therefore cannot be defined in this OFF The NGCOSW is OFF when it is not running Consequently the NGCOSW can never reply when it is in the OFF state 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 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 document for all cameras Typically the following actions are implemented 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 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 com
60. r interface with the specified process name At the moment only the default program ngcouiPanel is used independently from the process name which is specified DET CON DICT String 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 XTERM Logical Start all Sub processes in new terminal DET CON LOG Integer Logging level Logs system messages in the standard log file so that they can be seen in the CCS ogMonitor The level gives the detail of the messages Default value is 0 no debugging only error logging in case the keyword is not present Table 1 Startup Configuration Keywords VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 21 of 66 The startup configuration file assigns a name and some access right attributes to the configuration set 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 the option instance option starts the coordination control process and waits with a default timeout until the coordination contro
61. r multistep evposures EEN 37 Table 9 Setup keywords for windowing not yet implemented cccceeeeeeeeeeeeenneeees 37 Table 10 Setup keywords for image display ssssessssenssesreeeseneresserrrrerrennrsnnrnsserrnnnrennet 38 Table 11 Errors common to all NGCOSW modules ssonsseeeennneesseernreeennersenereserrrnnrrrn 47 Table 12 Errors specific to the ngcoit module cccccceeeeeeeeeeeeeeeeeeeeeeeeteeeeseeeeeneeeeeees 47 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 7 of 66 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 interact programmatically with the NGCOSW operate an optical camera as a simple standalone instrument The manual
62. rge cts os tne tastes nesses eee ANE A aaea 54 i eRe ee pete Onc D E 54 TGA TCO DES WS E 56 16 13 MOCODCS EE 57 16 1 4 ngcoDesStop EE 59 16 1 5 ngcGetProcNuUmM eege ege 61 ELE aahi 62 17 Example of NGCOSW usage EE 63 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 6 of 66 List of Figures Figure 1 Optical NGC software Architecture 0 ccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeaeeeeensnaeeeeeenaes 17 Figure 2 Operational states and state transitions ccceseeeecceeeeeeeeeseeeeeeeeeeeeeeeseeesaaaes 28 Figure 3 Optical NGC Control Panel egguuegeuseeesrgenegtessguenssssgugt eeesseegegeCrseceesste geg eEEAEapet 51 Figure 4 NGC Engineer Panel sssseeesseereseernerrenresssrrrnertrnnrtsttrrsstrrnnttrnnntrsrennnsennnnrenent 52 List of Tables Table 1 Startup Configuration Keywords c ccceeesscceeeeesseceeeeeseeeeeesaaeeeeeneneeeeeeeneaaens 20 Table 2 Command liS EE 30 Table 3 Special command Ikea enee a EE aa E Ea e R aai 31 Table 4 Online database attributes for detector system monitoring ssssesssseesssrrrrrereree 34 Table 5 Online database attributes for TC 34 Table 6 Basic Setup keywords for single exposure ssssseesssseessssrrrrerrrntrrrrtressrrrnnnrrnne 36 Table 7 Additional Setup keywords for loops Of exvposures ssnessssnnessereneerrrereserrrr reren 37 Table 8 Setup keywords fo
63. se attributes updated 6 1 NOTE added 7 SETUP can be issued also for paused exposure 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 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 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 New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 3 of 66 4 0 2 3 prev 2 4 2 3 1 Oldb generation split btw IWS and LLCU cases Online database environment generation added Online database environment generation added Online database verification added Online d
64. st 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 the 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 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 DATA
65. stance lt ccdname gt detector name default CCDNAME env lt env gt name of workstation online database environment default SRTAPENV lenv lt lenv gt name of remote online database environment default SCCDLENV If lenv 0 only the NGC LCU processes are started opmode lt opmode gt NGCOSW operational mode default NORMAL Valid values are NORMAL Normal Operational Mode Default NGC HW is used NGC SW runs on Instrument Workstation IWS and NGC LCU HW SIM HW is simulated gui lt guiname gt Launch the specified grafical user interface 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 xterm lt T F gt When set to T all processes are started in new xterminals Default is F autonlin lt T F gt When set to T the detector system automatically goes to ONLINE at startup Default is F kill kill all 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 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 58 of 66 CAUTIONS rhosts file on LCU syst
66. t ngcoDcsStop kill New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 65 of 66 VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 66 of 66 oOo
67. t 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 using 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 Detec
68. te 40S ngco lt mod gt ERR_ACTION serous Action 20s 15s failed in state 40S ngco lt mod gt ERR_EVENT sarng 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 ngcoittERR_RTD serious Error communicating to RTD 40s Table 12 Errors specific to the ngcoit module NOTE it is under investigation the usage of an error definition file common to all the modules New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 48 of 66 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 New General Detector Controller Optical DCS User Manual VLT MAN ESO 13660 4086 Issue 4 0 30 10 2008 Page 49 of 66 13 Real Time Display Interface NGCOSW provides raw dat
69. ted using the CCDNAME RTAPENV CCDLENV INS_ROOT INS_USER similar to the procedure followed by the FIERASW VLT MAN ESO 13660 4086 New General Detector Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 22 of 66 3 2 3 Configuration Examples 3 2 3 1 Startup Configuration file lt xx gt dcfgCONFIG 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 ccumani Name of creator PAF CRTE DAYTIM 2006 08 21 Civil Time for creation PAF LCHG NAME y Mg Name of person appl changing PAF LCHG DAYTIM W Timestamp of last change PAF CHCK NAME W 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 Topa CONFIG SET1 DICT NGCDCS NGCCON CONFIG SET1 FILE1 opdCAMERA cfg CONFIG SET1 PERM1 644 ctooConfigArchive CONFIG CONF IG ARCHIVE NAME NGCOSW CONFIG ARCHIVE USER wus CONFIG ARCHIVE MODULE opdcfg CONFIG ARCHIVE FILE1 opdcfg cfg CONFIG ARCHIVE FILE2 opdeftg 000 3 2 3 2 Configuration Set lt
70. tor Controller Issue 4 0 Optical DCS User Manual 30 10 2008 Page 43 of 66 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 ordered 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

VLT-MAN-ESO-13660-40..

Contents

Download Pdf Manuals

Related Search

Related Contents