Instrument Control Software User`s Manual
Contents
1. Shows the current state of the LASER diode ON OFF 15 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference 2 18 STANDBY When ON the indicator is solid blue When in OFF or STANDBY state the indicator blinks to warn the user about a status non useful for normal operation When a fault condition had been detected the indicator turns solid red Selector State String Indicator Shows the current state of the LASER selector mechanism IN or OUT When OUT the indicator is solid blue When IN or moving the indicator blinks to warn the user about a status non useful for normal operation When a fault condition had been detected the indicator turns solid red If the mechanism has been disabled the indicator turns gray Power WATT Numerical Indicator Total output power When a fault condition has been detected the indicator turns solid red Chiller Temperature C Numerical Indicator The chiller working temperature When a fault condition has been detected the indicator turns solid red Box Temperature C Numerical Indicator The temperature inside the LASER box When the temperature is out of its normal range of operation 25 C 10 the indicator turns red LASER Shutter LED Indicator The indicator is solid green when the shutter is OPEN Otherwise it blinks to warn the user about a status non useful for normal operation When a fault the word ERR is set Box Heater LED Indicator The indicator is solid green when the2. The box stays red and displaying the error messages even if the fault condition is fixed To refresh ICSOFT User Manual 3 4 June 2011 4 Chapter 2 GUI Reference the box contents and color press the Clear Alarms button see section 2 3 below To gather more information based on the current condition of this box the user should always look at the instrument diagram in the Operation Tab see section 2 13 2 below and at the faults table in the Maintenance Tab see section 2 20 below 2 3 MAIN gt General Control Pane Clear Alarms Button Clears the alarm signal Note that if an error condition is still present in the system the alarm condition will be signaled again Maintenance Button Currently DISABLED EXIT Button Prompts the user to terminate the application 2 4 MAIN gt AO Loop Compensation and Atm Parameters Pane DM Loop LED Indicates the AO control loop status open or closed M3 Loop LED Indicates the M3 control loop status open or closed This indicator goes ON when the Probes TT Loop is closed Mount Loop LED Indicates the Mount control loop status open or closed This indicator goes ON when the Probes TT Loop is closed 2 5 MAIN gt Selector Mirror Pane Selector Mirror String Indicator Shows the currently selected instrument SAMI or VI The selected instrument defines the output selector mirror position When the output selector mechanism is active the indicator blinks When a fault condition has been d
3. Zoom Factor 10 100 6 2 Configuration File A single configuration file acqcam ini is available The file is in sub directory bin pc x86 under directory home ao Prosilica_GigE_SDK CROSS HAIR XPOS YPOS 35 ICSOFT User Manual 3 4 June 2011 Chapter 7 Troubleshooting Chapter 7 Troubleshooting 7 1 Can t Find Guide Stars 7 1 1 1 2 NGS Mode Check using the WFS Acquisition Camera that the natural guide star is in the WFS sensor Check using GMAP that the natural guide star is in the center of the field If not use the FC button to correct the field center offsets Remember to press Tel to refresh the screen 7 2 Tweaking Quad Sensor Offsets 1 DS dai cio Da N Lock the star using M3 and then manually move the guide probe making M3 follow until you get the natural guide star right in the WFS Record the guide probe position Now acquire the guide star using the Acquire GS button and record the guide probe position Subtract the recorded values to obtain the amount to add to the current quad sensor offsets Hand edit the icsoft ini file to enter the new values Re start the application to grab the new values 37 ICSOFT User Manual 3 4 June 2011 Chapter 8 Glossary Chapter 8 Glossary AO Adaptive Optics DM Deformable Mirror DSP Digital Signal Processing DAQ Data Acquisition Effective Compensation Maximum order compensation for a given reconstructor matrix FITS Flexible Image Transport Fo
4. below aom The ICSOFT starts with the AOM manager disabled Im The ICSOFT starts with the LM manager disabled rtc The ICSOFT starts with the RTC manager disabled tcs The ICSOFT starts with the TCS manager disabled For example to start the ICSOFT with all outgoing connections turned off you would type samics aom lm rtc tcs 1 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference Chapter 2 GUI Reference When the application starts the user is presented with a single window containing the most relevant system status variables Figure 1 If the boot process ended with no failures then the operational state is signaled and the application is ready to receive commands SAM iInstumenticontto Sotiware 3 9 Ro tom are otros As visos A a KO O MS Static um Totalfum Initializing Log Module Laser Power Shutter Loop r Laser LGSTT DC Risg I HRCAM anit initialize history ibrary Carit initialize the command parser ibrary Carit initialize the comm servers Error while executing irit macro RTC COMM LINK ADM COMM LINK Canit connect to the LM sybsystem Error while reading ADM status L somam Can t read configuration fie Can t connect to TCS Error while reading TCS info NO FAULTS Can t read telemetry file NO FAULTS Can t read instruments file NO FAULTS Can t start AOM Manager NO FAULTS Can t start ATC Manager NO FAULTS Can t start LGSM Manager NO FAULTS Can
5. Files and Macros 4 4 2 stacklist dat The stacklist dat file is the file that holds the stack data saved by the user Whenever the user save the stack this file is overwritten with the current stack contents Each line has 6 fields index RA Dec Epoch Probe Number and Weight 1 06 55 40 41 30 16 23 8 2000 0 10 5 2 06 55 46 70 30 12 35 0 2000 0 2 0 5 3 06 55 42 32 30 14 53 7 2000 0 1 0 5 4 06 55 46 65 30 11 43 4 2000 0 2 0 5 31 ICSOFT User Manual 3 4 June 2011 Chapter 5 Log Files Chapter 5 Log Files When the ICSOFT first runs it opens a regulartext file to save log messages describing run time events Events can be of several types including type alarm type command type status and type simple event For details on the implementation of the logging mechanism read the ICSPM The events and the conditions in which a log message is generated is hard coded into the ICSOFT but certain flexibility exists when it comes to define error messages associated to error codes A configuration file called faults ini section 4 1 10 above exists that serves as a look up table between error codes and error messages The logging engine when given an error code searches the right error message and then produces the corresponding log message The actual log file can be found under directory home ao ICsoft logs which is typically a link to a user defined directory Each line in the log file starts with a time stamp that includes date and ti
6. Min 0 3 Average 1 0 Figure 6 Clicking on a device picture Guide Probes DM TURSIM ADC FP WES Shutter and OSM brings up a pop up menu with available actions Operation Mode Selector Box Selects the operation mode NGS TSNGS LGS or TSLGS by running the associated configuration script NGS lua TSNGS lua LGS lua and TSLGS lua Set Operation Mode Button Control Use this button to execute the script associated to the selected operation mode Instrument Selector Box Selects between dedicated science CCD and visitor instrument The box lists the instruments defined in the instrument ini file see section 4 1 5 below When an instrument is selected the script associated to that instrument in the configuration file is used to set the SAM module Set Instrument Button Control Use this button to execute the script associated to the selected instrument ICSOFT User Manual 3 4 June 2011 8 Chapter 2 GUI Reference LGS Configuration Combo Box Use this drop down menu two select between three available configurations 7 Km 10 Km and 13 Km Each selection will run associated Lua script LGS7KM lua LGS10KM lua and LGS13KM lua Look for the scripts in the ICsoft scripts directory Set Distance Button Control Use this button to execute the script associated to the LGS configuration selected using the LGS Distance combo box 2 13 1 Scripts Controls The ICSOFT includes a LUA scripting engine When a script is executed the out
7. for M2 in mm M2 Focus mm Shows the current focus position for M2 in mm Move M2 Button Commands the M2 focus control to move to the user defined focus position M3 PZT1 V Shows the current high voltage applied to LLT M3 PZT 1 M3 PZT2 V Shows the current high voltage applied to LLT M3 PZT 2 M3 PZT3 V Shows the current high voltage applied to LLT M3 PZT 3 LLT Cover String Indicator Show the current state of the environmental cover of the LLT When OPEN the indicator is solid blue When CLOSED or MOVING the indicator blinks to warn the user about a status non useful for normal operation When a fault condition had been detected the indicator turns solid red LLT Temperature Numerical Indicator Show the current temperature of the LLT When a fault condition had been detected the indicator turns solid red OPEN COVER Button Commands the environmental cover to move to the OPEN position CLOSE COVER Button Commands the environmental cover to move to the CLOSE position ATP Camera Power LED Indicator Shows the current state of the ATP camera ON green or OFF black When a fault the word ERR is set LLT Laser Diode LED Indicator Shows the current state of the LLT LASER diode ON green or OFF black When a fault the word ERR is set ATP Camera Button Press this button to open the ATP camera interface ATP Camera Power Toggle Switch Use this switch to turn the ATP camera ON or OFF Diode State String Indicator
8. heater is ON Otherwise it blinks to warn the user about a status non useful for normal operation When a fault the word ERR is set Interlock LED Indicator The indicator is solid red when the interlock is engaged and it blinks to warn the user about a status non useful for normal operation When a fault the word ERR is set LASER Shutter Toggle Control Open Close the LASER shutter LASER Diode Toggle Control ON OFF LASER diode Reset Interlock Push Button Reset the LASER interlocks The interlock will be cleared only if the interlock condition engaged has been cleared MAIN gt ADC TCS ADC Mode Radio Button Use this radio button control to select if the inner and outer element positions will be calculated using the zenith distance and rotator angle as informed by the TCS or user defined values ZD deg Box User defined Zenith distance in deg To be used when Manual Mode has been selected Rotation deg User defined rotator angle in deg To be used when Manual Mode has been selected SET ADC Button Use this button to command the inner and outer elements of the ADC to ICSOFT User Manual 3 4 June 2011 16 2 19 Chapter 2 GUI Reference move to the position that will compensate for the given Zenith distance and rotation Depending on the mode selected AUTO MANUAL the Zenith distance and rotation will be obtained from the TCS or from user defined values Inner Indicator deg The current inner element absolu
9. instrument and will adjust the WFS focus position if needed An example follows depicting SAMI the dedicated science CCD cat ICsoft scripts sami lua sam command LOG SAMI setup Adjust WFS focus sam command LOG Adjusting WFS focus sam wait until end AOM WFS FOCUS MOVE 80 3 15000 Select SAMI port sam command LOG Moving Output Selector Mirror Out sam wait until end AOM OUTSEL MOVE OUT 15000 sam command LOG SAMI setup done Other commands can be included here as needed 4 3 3 User defined scripts User defined scripts should be placed in the ICsoft scripts directory They will be automatically displayed in the scripts list box in the Operation Tab see section 2 13 1 above 4 4 Catalog Files 4 4 1 User Guide Star Files The user can load and pick up guide stars from its own list To do that he must provide a file containing the target coordinates and its relative weight for calculating the tip tilt error Each line of the file corresponds to a guide star and it should include six fields a unique index RA Dec Epoch the probe number and the relative weight 0 1 This is TBD because is not clear to me if the user will have decided in advance the couples so their weights add one 1 06 55 40 41 30 16 23 8 2000 0 1 0 5 2 06 55 46 70 30 12 35 0 2000 0 2 0 5 3 06 55 42 32 30 14 53 7 2000 0 1 0 5 4 06 55 46 65 30 11 43 4 2000 0 2 0 5 ICSOFT User Manual 3 4 June 2011 30 Chapter 4 Configuration
10. star candidates 1 Select the radio button labeled Yale Bright Star Catalog 2 Select the source of the reference coordinates Select Telescope Coordinates to use the current RA Dec coordinates of the telescope as informed by the TCS Select User Coordinates to manually enter the coordinates in the selected system RA Dec Az El HA Dec 3 Press the Closest Bright Stars buttons The guide stars table gets updated with a list of near by stars 4 Click on the table line corresponding to the guide star candidate 5 Press the Check P1 P2 button to make sure the coordinates of the guide star candidate are 23 ICSOFT User Manual 3 4 June 2011 Chapter 3 Common Operations 3 15 within range of the current guide field If the coordinates are not within range an information message is showed at the Events amp Commands list box Press Set P1 P2 to set the selected guide star coordinates as the target coordinates for the next guide star acquisition The coordinates are copied to the target P1 P2 indicators Selecting a Guide Star Interactively Using GMAP Guide star candidates can be interactively selected using the GMAP sky map For details read the GMAP User Manual 3 15 1 NGS Mode 1 Point the telescope to the science field and put the natural guide star on the WFS Use the WFS acquisition camera to aid in that task If not already running GS3 this is a good time to launch the GS3 program
11. step size in mm Large step size in mm Laser Telescope focal length in mm Observatory Latitude in deg Observatory Longitude in deg s ys yes ye Ne Ne Ss ys Ne Ne Ne Na Ne Ne Ne Ne we ee Guide probes offset due to optics in x mm Guide probes offset due to optics in y mm Offset between mount and field center in x mm Offset between mount and field center in y mm Offset between encoder and quad sensor in x mm Offset between encoder and quad sensor in y mm Offset between encoder and quad sensor in x mm Offset between encoder and quad sensor in y mm owe we Field center location in SAMI in x pixels Field center location in SAMI in y pixels SAMI rotation SAMI scale in arcsec pixel we we we ICSOFT User Manual 3 4 June 2011 26 Chapter 4 Configuration Files and Macros 4 1 2 soar comms ini The ICSOFT communication infrastructure is built upon the SOAR communication library SCLN The SCLN is an implementation of a network communication layer that suites the interoperability requirements of the SOAR telescope environment Each section in the configuration file for this software module defines a client server pair with the corresponding listening port CommLib Version Version for which this configuration is usable RTC IP Server IP address of the server IP Client IP address of the client IP Port Remote port number For more information on the SCLN and its prot
12. telemetry table and charts see section 2 19 above 4 1 5 instruments ini The instrument ini file is used to populate the Instrument Selector Box Control see section 2 13 above It include multiple sections one for each instrument defining a label and a configuration macro 27 ICSOFT User Manual 3 4 June 2011 Chapter 4 Configuration Files and Macros Right now the configuration macro selects the right FOLD2 mirror position for the instrument INTRUMENT NUMBER unique number for this section ID unique number uses as the instrument ID Name text string with the instrument name Macro instrument macro to configure SAM For example to add SAMI to the instrument ini file edit the file defining an ID then Name SAMI as the name and finally Macro sami mc as the initialization macro 4 1 6 Iltfoc ini This is TBD but after conversations with RT he most probably will gave me a polynomial fit to the function relating LGS distance in Km to LLT focus position in mm The lltfoc ini file includes a single section with the coefficients of a 9th order polynomial To use a lower order just set the upper order coefficients to zero GENERAL a0 2 0 al 2 0 a2 0 a3 0 a4 0 a5 0 a6 0 a 0 a8 0 a9 0 00000000 4 1 7 rgatedelay ini This is TBD but probably a polynomial fit will be used to relate the LGS distance in Km to the range gate delay in ns The rgatedelay ini file includes a single section with t
13. 1 40
14. Instrument Control Software User s Manual SOAR Adaptive Module SAM Revision 3 4 June 2011 Contents Getting Things Running 1 1 Starting the Instrument Control Software cccsscssscssessessccescesecssnscessccsssecessnsceessseesesssneeeenes 1 1 2 Stopping the Instrument Control Software csscccessssscsssrcessccsessesecessccesscssnnsesscesnscesscsonseeses 1 1 3 Environment Variable ICSOFT HOME cccccccccccsccecececeecscceseseeeeesesesesesesessseseseseeeeeens 1 1 4 Command Eme Options se qua aco Mass eee nanda ar aai dane a do E STS rg 1 GUI Reference 2 MAINE Mi RA RD SER DESA OES 3 2 1 1 MAIN gt Menu Bar gt AO Loop Menu siii did 3 2 1 2 MAIN gt Menu Bar gt TT Loop Ment id ia 4 2 1 3 MAIN gt Menu Bar gt WFS Ment a a ES RA TR Pa E 4 2 2 MAIN gt General Stats PM 4 2 2 1 MAIN gt General Status gt Comm LinkS acaso ganda assine ais 4 2 2 2 MAIN gt General Status gt Last Error Message BoX sscsssccsscssescsssssenscessscesscesssssnsceseeees 4 2 3 MAIN gt General Control Pane iii inn ai irritada 5 2 4 MAIN gt AO Loop Compensation and Atm Parameters PAN oooonnccnoccnoccoonnoncnnncnnnccnoncccnnnncnonano gt 2 5 MAIN gt Events amp Commands BOE AA ad is 5 2 6 MAIN gt Guide Probes Status Parameters Pane c cccsccsssecesscesseeeseceseeceseceeeceeeeeseecessaeeeeeeeeees 6 2 7 MAINS WES Status PANOS gana a E DR DES weaves 6 2 8 MAIN gt ADC Status PM tan
15. OFF Range Gate Toggle Control Use this control to ARM DISARM the range gate synchronization Acquisition Camera LED Indicator Lit when the WFS acquisition camera is turned ON When ON the indicator blinks to warn the user about a thermal source inside the SAM main module When a fault the word ERR is set Acquisition Camera Button Use this button to open the Acquisition Camera Viewer program Acquisition Camera Power Toggle Control Use this switch to turn the camera ON OFF TURSIM Dimmer String Indicator Reports the current TURSIM light source intensity from 1 100 Note that this is NO indicator of the light source being ON or OFF When a fault the indicator background turns red and the word ERR is set When the dimmer is disabled the indicators turns gray L R U D Offset Buttons Offset the guide probe position by a user defined step size The step size is defined by the value Step control ICSOFT User Manual 3 4 June 2011 14 2 17 Chapter 2 GUI Reference MAIN gt LLT amp LASER Tab M1 X mm Shows the current X coordinate of LLT M1 in mm M1 Y mm Shows the current Y coordinate of LLT M1 in mm L R U D Offset Buttons Offset the LLT M1 position by a user defined step size The step size is defined by the value in the Step control Step mm Use this control to set the size of the step when doing and offset with the LRUD offset buttons M2 Focus mm Shows the current focus position
16. age in mm Blinks when moving Solid red when fault Grayed when disabled GP1 GP2 Z mm Shows the current focus position for guide probe 1 2 in mm Blinks when moving Solid red when fault Grayed when disabled GP1 GP2 RA Shows the current RA coordinate of guide probe 1 2 GP1 GP2 Dec Shows the current Dec coordinate of guide probe 1 2 GP1 GP2 Epoch Shows the epoch of the current RA Dec coordinates of guide probe 1 2 L R U D Offset Buttons Offset the guide probe position by a user defined step size The step size is defined by the value Step Selector control small medium large Step Selector Use this control to set the size of the step when doing and offset with the LRUD Offset buttons The three step sizes are predefined in the icsoft ini file by the SLOW MEDIUM and FAST keywords Link Selector Use this control to select a single guide probe or link their actions The position of this selector affects the actions of offsetting the guide probes resetting the APDs toggling the APDs high voltage and calibrating the APD bias levels APD HV Use this switch to turn ON and OFF the high voltage to the APDs When turned ON 11 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference the over current protection will be activated regardless of a real over current condition Use the Reset APD control to clear that condition Reset APD Control Use this button to clear the over curr
17. ailed description of the configuration files macros and their parameters follows E pu telemetry ltfoc ini icsoft ini ow stacklist dat soar viserver ini comms ini Figure 8 Configurationfiles and script dependencies 4 1 Configuration Files Most configuration files follow a common format Files are divided in multiple sections each one beginning with a keyword enclosed in square brackets Each section lists a parameter name followed by an equal sign and its value A semicolon marks the beginning of a short parameter description Section Keyword Parameter Value this is the parameter description Other files are ordinary text files containing a list of space separated fields Table 1 lists the core set of configuration files The name and relative path of these files is fixed and can not be modified since they arehard coded in the ICSOFT Some of these files have keywords to point to other configuration files which can have user defined names All configuration files are expected to live in the directory home ao ICsoft config Table 1 Parameter files and their description File Name Description icsoft ini ICSOFT parameters soar comms ini SOAR communication library parameters faults ini Faults definitions instruments ini List of instruments and their location lltfoc ini Polynomial coefficients relating focus to LGS distance 25 ICSOFT User Manual 3 4 June 2011 Chapter 4 Conf
18. codes and their corresponding error messages 0 ID Fault identification number What The fault label Help Brief description of the fault Limit Number of occurrences to raise an alarm LogAlways TRUE or FALSE The error code assignment to a certain fault condition is hard coded in the software and the configuration file makes possible to hand edit the error message content If the Limit keyword is set to 1 then fault condition gets ignored If the LogAlways keyword is set to TRUE then the event will be logged independent of if there was an error or not 4 2 Macros The ICSOFT executes an initialization macro when it first starts The macro is the AO software initialization macro initics mc This macro is the last initialization done by the AO software before it enters operational mode So it is the appropriate place to set parameters or override some default parameter values Right now the initics mc macro is empty 29 ICSOFT User Manual 3 4 June 2011 Chapter 4 Configuration Files and Macros 4 3 Scripts 4 3 1 Coded Names 4 3 2 Instrument Initialization Scripts For each instrument to be used with SAM and initialization script is provided The script name is defined in the instrument ini file and it is executed when an instrument gets selected using the Instrument Selector Box see section 2 13 above Typically this script will command the output selector mirror to move to the position that will feed light to the
19. d gt velocity Wait for the velocity indicator to reach the desired value 3 6 Adjusting TURSIM light source 1 2 Select the WFS ADC TURSIM Tab from the main GUI window Use the L R U D Offset Buttons section Error Reference source not found to move the light source while looking at the tilt residual section 2 9 Repeat until the tilt error is typically in the range 0 1 0 1 3 7 Flattening the DM 1 2 3 Select the Operation Tab from the main GUI window Right click over the DM picture The DM pop up menu is displayed Select STATIC FLAT from the menu 3 8 Flattening the DM taking rotation into account T 2 3 Select the Operation Tab from the main GUI window Right click over the DM picture The DM pop up menu is displayed Select ROTFLAT from the menu 3 9 Recording a new Flatten DM file 1 2 3 4 3 10 Close and open the loop on a suitable source TURSIM will do Select the Operation Tab from the main GUI window Right click over the DM picture The DM pop up menu is displayed Select SAVE AS FLATTEN Resetting the WFS Select the Operation Tab from the main GUI window 2 Right click over the WFS picture The WFS pop up menu is displayed Select Reset WFS from the menu ICSOFT User Manual 3 4 June 2011 22 Chapter 3 Common Operations 3 11 Tracking with the ADC 1 Select the Operation Tab from the main GUI window 2 Right click over the ADC picture The ADC pop up m
20. e Guide Probe picture The Guide Probe pop up menu is displayed 3 Select Park Probe from the menu 3 3 Guide Probe APD Activation 1 Select the Guide Probes Tab from the main GUI window 2 Select the guide probe to operate guide probe 1 2 or both with Link Selector control 3 Toggle the APD HV control See the APD HV and APD Overcurrent indicators go on 4 Reset the protection with the Reset APD control See the APD Overcurrent indicator go off 3 4 Guide Probe APD Bias Calibration 1 Select the Guide Probes Tab from the main GUI window 2 Select the guide probe to operate guide probe 1 2 or both with Link Selector control 3 Press the BIAS button to start a calibration sequence See the RTC indicator go TBD 3 5 Using TURSIM 1 Select the Operation Tab from the main GUI window 2 Right click over the TURSIM picture The TURSIM pop up menu is displayed Select Injection Arm gt In from the menu Wait for the injection arm picture to appear in the diagram Right click over the TURSIM picture w Select Dimmer gt On Wait for the light indicator to go yellow Right click over the TURSIM picture D oou E Select Dimmer gt Intensity gt value 21 ICSOFT User Manual 3 4 June 2011 Chapter 3 Common Operations 8 9 Right click over the TURSIM picture Select Phase Screen 1 2 gt In Wait for the phase screen icon to move in 10 Right click over the TURSIM picture 11 Select Phase Screen gt Spee
21. either manually or from the ICSOFT Catalogs Tab Select the Skymap menu option from the File menu in the main GUI window The skymap windows shows up Press the Tel button in the sky map window to grab the field coordinates The window contents get updated Press the PA button in the sky map window to update the position angle The window contents get updated again Assuming that the natural guide star is now on the sky map right click on the star and press the FC button to grab the offset between the mount and the center of the SAM field The offsets are sent automatically to the ICSOFT Press the Tel button in the sky map window to refresh the screen and reflect the new field center offsets Left click on a star inside the patrol field to select a guide star A white circle around the star signals that the star has been selected Press P1 P2 button to send the coordinates of the selected star to the ICSOFT The guide star candidate coordinates are loaded into the target indicators in the Guide Probes Tab of the ICSOFT main GUI window ICSOFT User Manual 3 4 June 2011 24 Chapter 4 Configuration Files and Macros Chapter 4 Configuration Files and Macros Configuration files provide a mean to set multiple system parameters to some predefined value Some of the parameters can be changed by the user during run time others will remain fixed and can only be changed by editing the files and restarting the ICSOFT application A det
22. ent state condition On success the APD over current indicator should be turned off see section 2 8 above BIAS Button Use this button to estimate the bias for the guide probe APDs The bias calibration is then subtracted before doing centroid calculations GP1 GP2 Target RA Presents the RA coordinate of the guide star candidate to be acquired with guide probe GP1 GP2 Target Dec Presents the Dec coordinate of the guide star candidate to be acquired with probe GP1 GP2 Epoch Presents the epoch of the RA Dec coordinates of the guide star candidate to be acquired with the guide probe GP1 GP2 Weight Set the relative weight assigned to the guide probe This weight defines the relative contribution of the probe to the total tilt error Acquire GS1 GS2 Button Use this button to move the guide probe stages to the position indicated in the Target indicators Move GP1 GP2 Buttons Commands the P1 P2 stage to move to the X Y user defined positions Move F1 F2 Button Commands the P1 P2 focus control to move to the user defined focus position STOP Button Command the stages to stop PARK Button Command the stages to move to the park position by executing the GP lt N gt park lua script GP1 GP2 To Stack Buttons Move the current GP1 GP2 RA Dec Epoch coordinates to the stack Use this button to grab the current probe coordinates and save them for later use GP1 GP2 Weight Box Use t
23. enu is displayed 3 Select In from the menu Wait for the ADC icon to move in The ADC state LED indicator flashes indicating the motion is active 4 Select the WFS ADC TURSIM Tab from the main GUI window 5 Switch ON the ADC Compensation Control 3 12 Selecting the output port 1 Select the Operation Tab from the main GUI window 2 Click on the Instrument selector box and select the instrument attached to the desired port 3 Wait for the associated script to finish The currently selected port is indicated by the Selector Mirror indicator 3 13 Selecting a Guider Star From a User Defined Catalog 1 Enter the name of the user catalog in the catalog input box or use the browse button to select the file 2 Press the Load Catalog button to load the contents of the file into the guide stars table 3 Click on the table line corresponding to the guide star candidate 4 Press the Check P1 P2 button to make sure the coordinates of the guide star candidate are within range of the current guide field If the coordinates are not within range an information message is showed at the Events amp Commands list box 5 Press Set P1 P2 to set the selected guide star coordinates as the target coordinates for the next guide star acquisition The coordinates are copied to the target P1 P2 indicators 3 14 Selecting a Guide Star From the Yale Bright Star Catalog The Yale Bright Star Catalog is available to peek a list of close by guide
24. erage flux per sub aperture in the WFS WES Focus mm String Indicator Shows the current WFS focus position in mm When the mechanism is moving it blinks When the mechanism has been disabled the indicator turns grey When a fault had been detected the background color turns to red and the word ERR is set Residual Only Check Box Uncheck this box to show the total aberrations residuals DM Zernike Coefficients Table Modal estimation of the first three Zernike Modes tilt in x and y plus defocus MAIN gt ADC Status Pane ADC Compensation LED Indicates whether the ADC is tracking or not ADC Stage LED Indicates whether the ADC stage is moving or not Use the instrument diagram pop up menu to move the ADC in and out FP Stage LED Indicates whether the Fabri Perot state is moving or not Use the instrument diagram pop up menu to move the FP in and out 7 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference 2 11 2 12 2 13 MAIN gt Loop Control Buttons AO Loop Button Open Close the AO control loop M3 Loop Button Open Close the Probes TT control loop The control loop include both the M3 and the Mount Lock GP1 GP2 Button Use this button to lock the guide star on the probe When locked the tilt error signal coming from the probe will be used for compensating the tilt MAIN gt Operation Tab TURSIM EN NARARARNS DM Triplet VISITOR WFS Fold INSTRUMENT QA N
25. etected the indicator background color turns red and the word ERR appears 2 6 rO m Wind m s Var C M rad2 Operation Mode Figure 2 The RTSOFT produce estimates once every few seconds for r0 wind speed and the variance of the corrected modes r0 m Indicator Seeing estimate produced by the RTSOFT once every few seconds Wind m s Indicator Wind speed estimate produced by the RTSOFT once every few seconds VAR C M rad2 Indicator Variance of the corrected modes in rad2 produced by the 5 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference RTSOFT once every few seconds Operation Mode Indicates what operation mode is active TSNGS NGS TSLGS or LGS 2 7 MAIN gt Events amp Commands Box gt Initializing Log Module gt Initializing Command Parser gt Reading Configuration File gt Initializing Comm Server gt Executing Init Macro gt WARNING RTC might need to be synchronized after last reconnection gt WARNING 40M might need to be synchronized after last reconnection gt Al Figure 3 Scripts can redirect their output to this box by using the LOG command This box serves as an information window to display commands executed in the system the result of certain operations events recorded by the ICS etc Scripts also can direct their output to this box by using the LOG command see section 2 8 MAIN gt Guide Probes Status Parameters Pane Figure 4 D
26. he coefficients of a 9th order polynomial To use a lower order just set the upper order coefficients to zero GENERAL a0 2 0 al 2 0 a2 0 a3 0 a4 0 a5 0 a6 0 a 0 a8 0 a9 0 OO0OO0OO0OOOOO 4 1 8 wfsfoc ini This is TBD but after conversations with RT he most probably will gave me a polynomial fit to the function relating LGS distance in Km to WFS focus position in mm The wfsfoc ini file includes two sections the GENERAL section includes the coefficients of a 9th order polynomial for the fit To use a lower order just set the upper order coefficients to zero ICSOFT User Manual 3 4 June 2011 28 Chapter 4 Configuration Files and Macros For example the section labeled NGS set the nominal WFS position in mm when under NGS and TSNGS operation modes GENERAL a0 2 0 al 2 0 a2 0 a3 0 a4 0 a5 0 a6 0 a 0 a8 0 a9 0 NGS FOCUS WFS focus under NGS mode in mm SoOoooooo o 4 1 9 Dmflat_rot1 txt Text file containing the coefficients to adjust the flat DM voltages The file is 60 lines long and each line correspond to DM actuator line number Each line in turn contains three coefficient to calculate the actuator voltage as Voltate P P cos ROT P sin ROT 1 Where ROT is the current Nasmyth rotator angle 4 1 10 faults ini The ICSOFT logging and error handling infrastructure is built upon the FaultsLib software module The configuration file for that module defines error
27. hen a fault condition in the mechanism has been detected the indicator background turns solid red When the mechanism has been disabled the indicator turns gray WES F 10 mm String Indicator Show the current position of the WFS f 10 adjustment mechanism When the mechanism is ACTIVE the indicator blinks When a fault condition in the mechanism has been detected the indicator background turns solid red When the mechanism has been disabled the indicator turns gray Bias Subtraction LED Indicator Indicates wether WFS bias subtraction is enabled or disabled When a fault the word ERR is set Bgnd Subtraction LED Indicator Indicates wether WFS background subtraction is enabled or disabled When a fault the word ERR is set WES Focus mm Numeric Control Use this control to change the WFS focus WES Focus Move Button Press this button to actually move the WFS focus stage to the value entered in the WFS Focus mm numeric control LGS Distance Km String Indicator Shows the range gate setting for the artificial star distance This is effectively the delay between the LASER pulse and the moment in which the Pockels Cell is open If a fault is found the indicator turns red and the word ERR is set Gate Km String Indicator Shows the range gate setting for the gate width This is effectively the time the Pockels Cell stays open If a fault is found the indicator turns red and the word ERR is set RGate Sync Mode String Indicator Sh
28. his box to define the relative weight 0 1 to assign to the guide star candidate The value entered here will set the target weight for the probe GP1 GP2 Light Indicator Show the current 0 100 dimmer setting When a fault condition has been found the background is solid red and the word ERR is set GP1 GP2 Light Control Use this control to turn the guider probe reference light ON OFF The intensity of the light can be adjusted from the guide probe pop up menu in the picture diagram in the Operation Tab see section 2 13 2 above GP1 GP2 Light LED Indicator The indicator reports the light is ON or OFF When a fault ICSOFT User Manual 3 4 June 2011 12 2 16 Chapter 2 GUI Reference condition has been found the word ERR is set MAIN gt WES TURSIM Tab WES Frame Time ms Numeric Indicator Shows the time between frames in the WES If a WES fault is detected in the RTC the indicator background turns solid red WFS Dimmer String Indicator Reports the current WES reference light intensity from 1 100 Note that this is NO indicator of the reference light being ON or OFF When a fault it turns red and the word ERR is set When the dimmer has been disabled the indicator turns gray WES Ref Beam String Indicator Show the current position of the reference beam arm stage IN or OUT When the mechanism is ACTIVE or IN the indicator blinks to to warn the user about a status not useful for normal operation W
29. iguration Files and Macros File Name Description rgatedelay ini Polynomial coefficients relating range gate delay to LGS distance telemetry ini Multiple sections describing test point viserver ini Labview remote panel definitions wfsfoc ini Polynomial coefficients relating WFS focus and LGS distance 4 1 1 icsoft ini The file has only one section General The user can hand edit this file to modify parameters values The following is an example of how this file looks like Some of the parameters values will be replaced when the application program exists GENERAL FLENGTH 65666 INSTRUMENT VISITOR MODE LGS LGSDISTANCE 11 0 P1XUP 0 P1XDOWN 50 P1YUP 50 P1YDOWN 50 P2XUP 50 P2XDOWN 0 P2YUP 50 P2YDOWN 50 SLOW 0 20 MEDIUM 0 30 FAST 10 00 LLTFLENGTH 1000 OBSLATITUDE 30 238 OBSLONGITUDE 70 734 OPOFFSETX 0 0 OPOFFSETY 0 0 GPOFFSETX 0 0 GPOFFSETY 0 0 GP1APDX 0 55 GP1APDY 0 10 GP2APDX 0 80 GP2APDY 0 30 SAMIFCX 1946 SAMIFCY 2077 6 SAMIROT 0 SAMISCALE 0 0453825 Telescope focal Length in mm Current instrument label Current operation mode TSNGS NGS TSLGS LGS Current LGS distance in Km P1 stage right limit in mm P1 stage left limit in mm P1 stage up limit in mm P1 stage down limit in mm P2 stage right limit in mm stage left limit in mm P2 stage up limit in mm P2 stage down limit in mm Short step size in mm Medium
30. me in YYMMDD HH MM SS format Then a label describes what type of event alarm status etc the log message refers to A second label states the name of the originator that is the piece of software code that produced the event This second label is most useful for debug purposes The line ends with the log message describing the event This last message does not follow a predefined format We use the system utility log rotate to manage the ICS log file The configuration file is in etc logrotate d icsoft cat etc logrotate d icsoft home ao ICsoft logs log compress daily rotate 30 The above keeps the last thirty days logs in compressed format The Logrotate utility is executed as a crontab job by the cron daemon on a daily basis see etc cron daily directory for logrotate We adjusted it to run at midday cat etc crontab run parts 01 root run parts etc cron hourly 00 12 root run parts etc cron daily 22 12 0 root run parts etc cron weekly 42 12 1 root run parts etc cron monthly Note The whatis database update has to be removed 5 1 Type Alarm Events Events of type alarm produced by the ICSOFT can trigger the alarm flag Each error code defined in the faults ini configuration file has an associated counter that keeps track of consecutive type alarm events When three alarm messages in a row for a given error code are detected the global alarm flag is 33 ICSOFT User Manual 3 4 Ju
31. n DM Ne ds 20 3 100 Reset the WES a O E E A E K end AREE wet 20 3 11 Tracking with the ADG sg ea oh ca hata ad a A a EEE E A ad 21 3 12 Selecting the output DOR ay sssini AAA ST a 21 3 13 Selecting a Guider Star From a User Defined Catalog rea 21 3 14 Selecting a Guide Star From the Yale Bright Star Catalog 0 00 0 ee eesceeeseeeseeeeeceteeeeeeeeeeeeaes 21 3 15 Selecting a Guide Star Interactively Using GMAP ooconnccnnoconococonnnnonnnonccnnnnconnnnnnnconccnonaconannnnnnos 22 A 22 Configuration Files and Macros Al CONES tratos li E MR 23 ALAS ii EE E ntc 24 AA OCA A A a 25 ALI ii 25 ALARCON e rc 25 A A isons EE a RO 25 4 1 6 GG A AERC oS area eaa Ege TZ ET mr eR CoP Ne iy Pe en ERE O 26 AL Tica MATI o a RR 26 4 1 8 WS LOG iMi sph fle cts Pa SN le ets an ee ee a ae RR 26 ALO DM TOA aia ade E 27 A110 ra 27 Ad MACIOS r erien eneinio ai a e a i i a 27 4 3 SCEUPES az ninata NPR DRE RU ee aaa E ea E EE NR 28 AS Coded Names cvs cases es aS Baigent RR a a a a a a 28 4 3 2 Instrument Initialization Scripts Ea 28 4 3 3 User defined ScriptS sares e aee aeoe access ae Ee ae EES Dae RAS tesa DERRIERS 28 4A Catalog Filesi nena e ORAR te 28 4 4 1 User Guide Star Files amina cane A A a go estaa 28 A ALD STACKS tdi 29 Log Files de Type Alarm VOUS is Sa DR ents i E a Rc 31 Acquisition Camera Software 6 1 User Interface At i 33 GMR dd Ra ab 33 6 1 2 Image DISDIAV sacar RA aa a O A a 33 61 21 Gross is 33 A A O A ate cated ma
32. ne 2011 Chapter 2 GUI Reference 2 14 WES Reference Light WES Label The label blinks to indicate that a mechanism focus reference beam arm stage f 10 adjustment is ACTIVE When a fault condition has been detected in at least one of the mechanisms besides blinking the label background color turns solid red and the label text changes to ERR MAIN gt Catalogs Tab Catalog Use this box to enter the name of a user defined list of guide stars Load Catalog Button Put the contents of the user list in the table To enable select the User Catalog radio button Closest Bright Star List of TBD stars that are close to the telescope mount position The user can select from its list or the Yale bright star catalog Type of Coordinate When the user coordinate radio button is selected the coordinates in the input box are interpreted as of this type Ra Az Ha User coordinate input box for Right Ascension Azimuth or Hour Angle Dec El Dec User coordinate input box for Declination or Elevation Star Number number of star to look for in either catalog User Catalog Radio Button Yale Catalog Radio Button Use the Yale Bright Star Catalog as the source of guide stars Check P1 P2 Buttons Check if the selected star is OK with the mount telescope position Set P1 P2 Buttons Check and apply to target P1 P2 the selected guide star coordinates USNO Catalog Button Open GMAP to select the star interactively For detailed information on
33. ne 2011 Chapter 5 Log Files raised The number of type alarm events in a row is actually configurable in the faults ini configuration file See section 4 1 10 above ICSOFT User Manual 3 4 June 2011 34 Chapter 6 Acquisition Camera Software Chapter 6 Acquisition Camera Software 6 1 User Interface 6 1 1 Main GUI 6 1 2 Image Display 6 1 2 1 Cross Hair A green cross hair is available for helping defining a reference position e g field stop position in NGS mode and laser guide star in LGS mode When the program first starts the last stored position is used to draw the cross hair Left clicking in the image display moves the cross hair to the cursor position Options for controlling the cross hair attributes are available via a pop up menu 6 1 2 2 Pop Up Menu By right clicking in the image display area a pop up menu is opened The available options are described below Save to Disk Use this option to save a snapshot to disk in FITS file format Force Mono Scale Lock Cross Hair When the cross hair is locked left clicking in the image display does not change its position Show Cross Hair Toggles between showing and hiding the cross hair Cross Hair Set Record the current cross hair position The coordinates get saved to the configuration file acqcam ini Cross Hair Recall Re position the cross hair to the last recorded position The software reads the coordinates stored in the configuration file acqcam ini
34. ocol read the document SOAR Communication Library New available at the SAM web site archive 4 1 3 viserver ini The ICSOFT uses Labview remote panels to display some interfaces and charts The remote panel technology allows to open a GUI located in another computer as it has been opened locally The viserver ini file includes multiple sections with information regarding the name and location of the remote GUI The ICSOFT invokes the remote panel using the section labels in this file NAME unique label identifying the remote panel VINAME name of the remote VI of the GUI ADDRESS remote machine IP address PORT remote machine listening port 4 1 4 telemetry ini The ICSOFT use the telemetry ini file to format the telemetry test points and figure out the sampling period for logging telemetry data The file includes multiple sections each one corresponding to a different test point The ICSOFT hard wires the ID to the test point to link it to a section TESPOINT NUMBER unique number for this section ID unique number used as the test point ID Label string test point name Units test point measurement units Help brief test point description Stime Sampling time in seconds Min minimum legal value for the test point Max maximum legal value for the test point The ICSOFT will save every St ime seconds the test point value to the ICSOFT log file The Label and Units keyword will be used to format the
35. op data recorder GUI window MAIN gt Menu Bar gt WFS Menu Show WES GUI Opens a Labview remote panel presenting the RTC WFS GUI window Show WES Display Opens a Labview remote panel presenting the RTC WFS Display window Slopes Statistics Opens a Labview remote panel presenting the RTC Slopes Statistics GUI window Subapertures Flux and FWHM Opens a Labview remote panel presenting the RTC Subapertures Flux and FWHM GUI window Histogram Opens a Labview remote panel presenting the RTC Frame Histogram GUI window Bias Calibration Opens a Labview remote panel presenting the RTC Bias Calibration Tool window Static Aberrations Opens a Labview remote panel presenting the RTC Static Aberrations Tool window 2 2 MAIN gt General Status Pane 2 2 1 MAIN gt General Status gt Comm Links The comm link indicators uses a color code to represent the status of the connection RED Problems WHITE No Conn GREEN OK Clients Indicator Indicates the status of the connections to remote systems AOM LGSM RTC and TCS Servers Indicator Indicates the status of incoming connections to the ICS SAMI and VISITOR 2 2 2 MAIN gt General Status gt Last Error Message Box The box displays the last warning or error message produced by the system When no warnings or errors are present the box is solid green When a warning message is produced the box goes yellow Finally when an error messages is produced the box goes red
36. ows the current synchronization mode for the Pockels Cell LASER or AUTO The indicator blinks if LASER is not selected to warn the user about a status not useful for normal operation If a fault is found the indicator turns red and the word ERR is set Pockels Cell Set Point KV String Indicator Show the output high voltage setting for the 13 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference Pockels cell driver When a fault condition has been detected the indicator background turns solid red and the word ERR is set If the Pockels cell high voltage is off the indicator blinks to warn the user about a status not useful for normal operation Pockels Cell High Voltage LED Indicator Lit when the Pockels Cell high voltage is ON When the high voltage is off the LED blinks to warn the user of state non useful for normal operation When a fault has been detected the word ERR is set Range Gate Armed LED Indicator Lit when the range gate has been armed When not armed the LED blinks to warn the user of a state not useful for normal operation When a fault has been detected the word ERR is set LGS Distance Km Numeric Control Set Distance Button Control The control stays disabled while the Range Gate is armed LGS Gate Km Numeric Control Set Gate Button Control The control stays disabled while the Range Gate is armed Pockels Cell High Voltage Toggle Control Use this control to turn the Pockel Cell high voltage ON
37. put is presented at the Events amp Commands Box Scripts Use this control to select a script from the scripts directory RUN Execute the selected macro STOP Abort the current macro execution Pause Allows to pause and resume the execution of a macro 2 13 2 Graphic View The user is presented with a graphic view showing the current instrument setup including light path light sources and element positions The display area of the picture control is context sensitive so when the mouse pointer is placed over a certain device the correspondent label and information pane are lighted Clicking on a device picture Guide Probes DM TURSIM ADC FP WFS Shutter and OSM brings up a pop up menu with available actions When a device is not initialized or faulted its device label blinks indicating its current state DM MENU ROTFLAT Flattens the DM based on a previously saved list of voltages including a correction factor based on the current rotator angle STATIC FLAT Flattens the DM based on a previously saved list of voltages ZERODM Set all DM voltages to zero SAVE AS FLATTEN Save the currently applied DM voltages to disk as the new set of voltages to flatten the DM WES MENU Reset re start WFS readout Calibrate Bias Obtain an averaged bias to be used when doing bias subtraction Calibrate References Reset all references to current average spot x y position WES Reference Arm 9 ICSOFT User Manual 3 4 Ju
38. rmat FWHM Full Width at Half Max GLC Ground Layer Compensation G Matrix Slopes in x and y are related to aberrations by the gradient matrix G G Matrix Inverse of the gradient matrix G H Matrix Interaction matrix H Matrix Reconstructor matrix ICSOFT Instrument Control Software Supervisory control application that handles the business logic of the SAM instrument Integrator Digital controller Measured residuals are added to the previous signal with some gain Interaction Matrix The relation between the WFS and the DM in an AO system is characterized by the interaction matrix H Kolmogorov Law The Kolmogorov model of the turbulence distortions prescribes the specific form of the phase structure function for the optical wave LGS Laser Guide Star LLT Laser Launch Telescope Modal Coefficients Zernike mode coefficients Modal Reconstructor Error signal delivered by the WFS is converted into modal amplitudes by matrix G Amplitudes are weighted and transformed to voltages by ICSOFT User Manual 3 4 June 2011 38 NGS Noise Propagation Optimal G Reconstructor P Matrix P Matrix PXI Reconstructor Matrix Regularization Parameter RTC RTCORE RTSOFT RTSPM SAM Slope Smith Predictor SVD SVD Reconstructor TTP TURSIM Chapter 8 Glossary matrix P Natural Guide Star Noise propagation is described by the covariancematrix of Zernike noise coefficients Optimal modal reconstructor Take
39. rting to update the Telemetry Chart 17 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference 2 20 MAIN gt Maintenance Faults Table This sheet presents the list of known faults as defined in the faults ini file The column labeled Alarms shows the date and hour at which an alarm event was caught Use the Refresh button to update the sheet entries Refresh Button Use this button to refresh the Faults Table entries Last Faults Last five warnings and errors encountered by the application Command Box Input box to enter string commands For a complete list of the available string commands read the ICSOFT Programmer Manual Send Write the command entered in the Command input box to a software hardware module Response Reply to the last command sent to a software hardware module 2 20 1 MAIN gt Maintenance gt RTC AOM LM TCS Manager Connected LED Indicates that the manager is connected CLOSE Use this button to close the manager window Name This is the name of the server as declared in the soar comms ini file Address This is the IP address of the server as declared in the soar_comms ini file Port This the port in which the server listen to incoming connections as defined in the soar comms ini file Fetch Status Turn this switch ON to enable the continuous poll for status updates to the server Update Turn this switch ON to see the messages interchanged between the manager and the server CLEAR Press
40. s into account the information on the statistics of the input disturbance contained in the Noll covariance matrix and correlated centroid noise Aberrations are related to DM voltages by the projection matrix P Inverse of the protection matrix P modular instrumentation standard based on CompactPCI developed by National Instruments with enhancements for instrumentation Inverse of the interaction matrix H Setting this parameter gt 0 helps balancing the noise and input signal in case when the noise is strong The reconstructor with the right choice of this parameter gives the smallest RMS wavefront error Real Time Computer Real Time Core Real Time Software Real Time Software Programmer Manual SOAR Adaptive Module Gradient averaged within the sub aperture and expressed in units of phase difference between the edges of sub aperture Digital controller that counter acts the effect of delay in the loop Singular Value Decomposition The interaction matrix is inverted using SVD Singular values below some threshold are set to zero Tip Tilt Probe Turbulence Simulator 39 ICSOFT User Manual 3 4 June 2011 Chapter 8 Glossary WES Wavefront Sensor WCoG Method Weighted Center of Gravity Improved center of gravity with different weight to each pixel depending on their flux Input disturbance correction and residuals are represented as Zemike Goetticients coefficients of Zernike modes ICSOFT User Manual 3 4 June 201
41. t start TCS Manager NO FAULTS REFRESH No Fouts Figure 1 Main GUI The most relevant status variables are displayed 2 1 MAIN gt Menu Bar At the very top of the main window is the menu bar It includes several menu options and most of them just open a Labview remote panel to the desired graphic interface running in a different processor For details on the actual remote panel functionality please refer to the corresponding subsystem user manual For example to get information on the RTC Loop GUI see the RTSOFT user manual 2 1 1 MAIN gt Menu Bar gt AO Loop Menu Show AO Loop GUI Opens a Labview remote panel to the RTC Loop GUI window Reconstructor Error Opens a Labview remote panel presenting the RTC Reconstructor Error Analysis window Show DM GUI Opens a Labview remote panel presenting the RTC DM GUI window AO Loop Data Recorder Opens a Labview remote panel presenting the RTC AO Loop Data Recorder GUI window 3 ICSOFT User Manual 3 4 June 2011 Chapter 2 GUI Reference 2 1 2 2 1 3 MAIN gt Menu Bar gt TT Loop Menu Show TT Loop GUI Opens a Labview remote panel presenting the RTC TT GUI window TT Probes Flux Opens a Labview remote panel presenting the RTC TT flux charts window Statistics Opens a Labview remote panel presenting the RTC probes error signal GUI window TT Loop Data Recorder Opens a Labview remote panel presenting the RTC TT lo
42. te position in deg Outer Indicator deg The current outer element absolute position in deg Inner Control deg Box Use this box to enter a target position angle in deg for the inner element Outer Control deg Box Use this box to enter a target position angle in deg for the outer element Set Inner amp Outer Button This button commands the ADC inner and outer elements to the target positions in the Inner and Outer input boxes STOP Button Stop the ADC motion in both the inner and outer elements ADC Compensation Control Use this switch to turn the ADC compensation ON OFF Mount AZ deg MOUNT EL deg Rotator Angle deg SAM PA deg MOUNT HA MOUNT RA MOUNT DEC LST MAIN gt Telemetry Tab Telemetry Table The telemetry table presents a snapshot of the telemetry test points available By double clicking on each line the Telemetry Chart will start plotting the selected testpoint See the telemetry ini file description in section Error Reference source not found Error Reference source not found for details on the test points format Telemetry Chart This chart get updated with data coming from the currently selected test point in the telemetry table When a test point is selected the chart is first initialized with the historical data available in the log file From then on the chart is updated with the new values Sample Length Control Indicates how many points should be read from the log file before sta
43. tes E Rg 33 iii 6 2 Configuration iii 33 Troubleshooting TL Gant End Guide ni 35 TA ENGS MA oa 35 7 2 Tweaking Quad Sensor Ost lidia 35 Glossary Chapter 1 Getting Things Running Chapter 1 Getting Things Running This user manual is intended to describe the use of the SAM Instrument Control Software ICSOFT from a user s point of view It is not a programming manual For implementation details please read the IC Software Programmer Manual ICSPM 1 1 Starting the Instrument Control Software a Turn on the instrument control computer an wait for the system to boot b Log on as user ao c Open a shell window and invoke the instrument control application with the following command cd home ao ICsoft Bin Labview ICsoft vi lt options gt d Optionally you can press the button labeled ICSOFT in the task bar 1 2 Stopping the Instrument Control Software To stop the ICSOFT application click the EXIT button A dialog box will prompt for confirmation Select YES 1 3 Environment Variable ICSOFT HOME The location of the ICSOFT is defined by an environment variable included in the cshrc file Right now this variable is pointed to the home ao ICsoft directory To check its value type at the command prompt of your favorite terminal the following command setenv ICSOFT HOME home ao ICsoft 1 4 Command Line Options The ICSOFT accepts a few command line options to customize its behavior Valid options are listed
44. the GMAP operation read the GMAP user Manual available at TBD Stack List List of visited objects Stack List Load Load the specified file stacklist dat Stack List Save Save e current stack to the special file stacklist dat Stack List Refresh Refresh the list of stack objects TBD with O Estay Stack List Clear Erase the stack contents Stack List Set P1 P2 Check and apply to target the selected stack object Target Value RA Dec Epoch User defined target value in RA Dec Epoch coordinates Target Value Check P1 P2 Check the user defined target candidate coordinates Result is showed in the Events amp Commands messages box Target Value Set P1 P2 Check and apply the defined target candidate coordinates Result ICSOFT User Manual 3 4 June 2011 10 Chapter 2 GUI Reference is showed at the Events amp Commands messages box 2 15 MAIN gt Guide Probes Tab al R 0 000 0 000 0 000 0 000 0 000 0 000 L Ri 00 000000 _ 00 00 00 0 _ o0 99000000 0000000 oo 9 Acquire BIAS Acquire BIAS AA Gsi GP1 me ee Gs2 GP2 0 000 0000 sr d sor fame f ce Figure 7 Turn the APD high voltage ON and the reset the over current condition to start using the guide probes GP1 GP2 X mm Shows the current X coordinate of guide probe 1 2 stage in mm Blinks when moving Solid red when fault Grayed when disabled GP1 GP2 Y mm Shows the current Y coordinate of guide probe 1 2 st
45. this button to clear the contents of the messages list Messages When the Update Option has been selected this list box presents the messages exchanged between the manager and the remote server 2 20 2 MAIN gt Maintenance gt Sync RTC AOM By pressing this buttons the ICSOFT synchronize the remote application to the current local parameters RTC 1 The operation mode is set to the ICSOFT operation mode TSNGS NGS LGS or TSLGS 2 The Range Gate Delay is set using the LASER altitude set in the ICSOFT The Delay is calculated using the coefficients in the rgatedelay ini file see section 4 1 7 AOM ICSOFT User Manual 3 4 June 2011 18 Chapter 2 GUI Reference The attached instrument setup script is executed see section 4 1 5 The WES focus is adjusted depending on the current operation mode using the values in the wfsfoc ini file see section 4 1 8 Note that this override focus adjustments done by the instrument script The TURSIM injection arm is moved IN or OUT depending on the current operation mode 19 ICSOFT User Manual 3 4 June 2011 Chapter 3 Common Operations Chapter 3 Common Operations 3 1 Centering a Guide Probe 1 Select the Operation Tab from the main GUI window 2 Right click over the Guide Probe picture The Guide Probe pop up menu is displayed 3 Select Center Probe from the menu 3 2 Parking a Guide Probe 1 Select the Operation Tab from the main GUI window 2 Right click over th
46. uring normal operation the Over Current LED has to be off To clear an over current condition use the Reset control in the Guide Probes Tab GP1 GP2 Flux K e sec Shows the average total flux received by guide probe 1 2 in K e sec GP1 GP2 X Y Centroid error in x and Y Weight Shows the current relative weight 0 1 assigned to the probe in the total tilt error GP1 GP2 APD HV LED Indicator Shows if the high voltage is being applied to the APDs ICSOFT User Manual 3 4 June 2011 6 Chapter 2 GUI Reference When a fault condition has been detected the word ERR is set GP1 GP2 APD Over Current LED Indicator Shows is the over current protection has been activated During normal operation this LED has to be off To clear an over current condition use the Reset control in the Guide Probes Tab see section 2 15 below When a fault condition has been detected the word ERR is set 2 9 MAIN gt WES Status Pane 2 10 WES Mini Frame WFS 5 4 Flux Ke sec 4 a 5 WFS Focus mm 2 Residual Only Mode Coef um Static um Total um ee 0 519 0 000 0 519 Te 33 0 686 0 000 0 686 Defocus 34 9 O89 0 000 0 089 Figure 5 Uncheck the Residual Only check box to show the total aberrations for each mode residual DM WES Mini Frame Display Picture indicator presenting a preview of the current WFS display updated every second WES Flux Ke sec Indicator Presents the av
47. ya ieee Beas ad 7 2 9 MAIN gt Selector Mirror Pane ea mamas assa ganas caga Saab RR at ota 7 2 10 MAIN gt Loop Control BITONS AAA AA AAA AA edad 7 2 11 MAIN gt Operation Tadeo 8 21 Scripts ONTOS a tesao sai A O 9 ZE 2 Grape VIC io EA SRA RO eeu E q elds 9 212 MAIN gt Cataloos Talitas cla cada iiO 10 2 13 MAIN gt G id Probes DADE catia ae 10 2 14 MAINS ADC TURSIM WES Taba ne road Gusieuede cacti Ga aa ca 12 ALADO AA RR 12 A A O 13 2143 WES a A A ad id 14 215 MAIN gt LEF A a e gn ds e Ea 15 ZA MAIN STCS Tabios tee Gua Sah E EA AE AAA 16 217 MAIN gt Telemetry Tabir eerie oie i E E E E A 16 ZO NLAT Maintenance ads 17 2 18 1 MAIN gt Maintenance gt RTC AOM LM TCS Manager 17 2 18 2 MAIN gt Maintenance gt Sync RTC AOM cc ceecescessecsnecsseeceseceseeceeeeeeeesseeeeeeeeeaes 17 Common Operations 3 1 Centering a G ide PROD ae E ATA Di A acs 19 3 2 Parking a Guide Probe dar 19 3 3 Guide Probe APD Activation ccc ccccsssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssccceeaessssces 19 3 4 Guide Probe APD Bias Calibration cccsscsssccssscesssssensesscesscsesscesacssnccesacsenssesacssnscesaceeseaees 19 3 5 Using TURSIM a eere Anis ioga cis 19 3 6 Adjusting TURSIM UNESCO e iii 20 3 7 laten the DM E A A A a AS 20 3 8 Flattening the DM taking rotation into ACCOUNL le eeeeseeeseceeeeeeeseeeeeaeeeseesseeceseesesaeeenaeeesaes 20 3 9 Recording a new Flatte
Download Pdf Manuals
Related Search