Guide star selection software user`s manual
Contents
1. GMAPCONFIG Defines the path to the configuration files 1 Rtsoft User Manual Rev 2 1 November 2010 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 SAM GMap v2 60 SOAR SAMGDR SAMI Tel Gdr SAM GDR o Cam SAMI o AM 1 000 UT 14 36 22 ST 13 39 39 Parallactic Angle 90 04 Cass Angle 89 96 RA Equinox Dee PosAngi 000 TTP1 rafoo dec o 00 x 0 00 y 0 00 TTP2 rafoo dec o 00 x 0 00 y 0 00 Figure 2 1 Main GUI Use the File menu to open the skymap window 2 1 MAIN gt File Menu 2 1 1 Skymap Menu Option Open and close the sky map window Read section 2 1 1 below Airmass Menu Option Open the air mass window Read section 2 1 2 below Exit Menu Option Terminates the application MAIN gt File gt Skymap Window Set Button Centers the field to the star just selected P1 P2 Button Send the coordinates of the star just selected to the ICSOFT The coordinates will be displayed in the target P1 P2 indicator of the Guide Probes Tab in the ICSOFT GUI Tel Button Use this button to retrieve the current telescope mount coordinates Guide probes coordinates get updated as well PA Button Use this button to retrieve the current SAM position angle Guide probe coordinates get updated as well Zoom Arrows Button Use the arrow buttons to zoom in and out the skymap Catalo2. SAM each APD can be think of as a pixel of size TBD arcseconds 2X2 in total nguider Is the number of guide probes for the guider mode lt N gt N is the guider number Mode 0 for rectangular coordinates and 1 for polar coordinates scale Guide probe scale in mm arcsec Used to calculate the x y coordinates in mm displayed in the sky map Only valid when nguider has been defined xlo lt N gt ylo lt N gt xhi lt n gt yhi lt N gt Range of motion for guide probe N in units of arcseconds Only valid when nguider has been defined psize lt N gt Is the size of each pixel in arc seconds Only valid when nguider has been defined Only valid when nguider has been defined 4 1 2 4 Server section The GS3 communication infrastructure is built upon the SOAR communication library SCLN The Rtsoft User Manual Rev 2 1 November 2010 10 Chapter 4 Configuration Files and Macros SCLN is an implementation of a network communication layer that suites the interoperability requirements of the SOAR telescope environment Each section starting with the server keyword defines a client server pair with the corresponding listening port server ICS ip server X X X X ip _client X X X X ip port xxxxx For more information on the SCLN and its protocol read the document SOAR Communication Library New available at the SAM web site archive 11 Rtsoft User Manual Rev 2 1 November 2010
3. User Manual Rev 2 1 November 2010 4 Chapter 2 GUI Reference show the label SAM GDR Gtap sky esc o vial Sei ae J e dedo oco dado fato c nto N an to a Ad a g I 1 1 i i iL i 1 1 i 1 I i H i ni I E i j 1 1 I j i 1 j 1 i ne E J j pet i f i i ee AS an O e i it i i L a i i j t i 1 i j 1 1 I 1 1 i i iT j 1 1 i 1 j j i i 1 aly 1 I 1 1 i it i i Hn bat 1 i 1 k Boat e i i i 1 1 j i 1 j i 1 POSE eee ee ee eS jell ee a ee eI e Figure 2 3 The skymap window Use the TEL and PA buttons to update the field coordinates and rotation The yellow boxes represent the guide probes GP1 to the right and GP2 to the left 5 Rtsoft User Manual Rev 2 1 November 2010 Chapter 3 Common Operations Chapter 3 Common Operations 3 1 Interactively Selecting a Guide Star Using GS3 1 2 3 Point the telescope to the science field If not already running GS3 this is a good time to launch the GS3 program 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 skymap window to grab the field coordinates The window contents gets updated Press the PA button in the skymap window to update the position angle The window contents gets updated again Left click on a star inside the patrol field to select a guide star A white circle around the s
4. Guide Star Selection Software User s Manual SOAR Adaptive Module SAM Revision 2 1 November 2010 gt oO Sono TAR Contents Getting Things Running 1 1 Starting the GMAP Software ssseeseeessesersssessessesssessesseeseessesseessessesseesseseee 1 1 1 Launching GS3 from ICSOFT ssesseeesseseesseessesseeseesresseeseessesseeseesseesee 1 1 2 Launching GS3 from the command line ese eeeeeseeseeeeeeneeeeeeeeeeeeees 1 2 Stopping the GMAP Softwal ccscccssssssssescessccsnssescessccesscesnssenscesaces 1 3 Environment Variabless 3dcieaseuscecsiaedeceandtasdansptherbeindencavareedioandeseesseevieaseenuers GUI Reference 2 cL MAIN Bie Meninin wth tases Aten sec DE docu sa ATA DD 2 1 1 MAIN gt File gt Skymap Window ccssssccsscesessecsssteceeeeceseeecesteeeenes 2 1 2 MAIN gt File gt Airmass WindOW cscssscsscssessosestteocessseseeoetssseares 2 2 MAIN gt Telescope Selector BoX sccsssssssscssscesrsoncesoserssoncesscearssaneoosenss 23 MAIN gt G der ot ccd esac cic adbeast a a Da DIA o o este salud stews dias Common Operations 3 1 Interactively Selecting a Guide Star Using GS3 ee eeeeseeeneeeeeeneeeeeenees Configuration Files and Macros 4 1 Configuration Piles ieren ine ided enn da e E E ene 7 ASM ISS SU AA E ed E o AO cn A A 41 2 CEMAP dati AA eS a R DEITA Telescop sec AA R E E ET ee Camera SOCHON mia a ada dta GNA Lea an A S Po
5. g Menu Use this menu to select among the available catalogs Right now the application will crash if a catalog is selected having not installed the correspondent database Features Menu 3 Rtsoft User Manual Rev 2 1 November 2010 Chapter 2 GUI Reference N vector Two arrow vectors are displayed in the upper right corner of the sky map window The long arrow represents the north direction The short arrow represents east To refresh the icon press the PA button so the position angle gets updated from the ICSOFT Up vector An arrow is displayed pointing in the Up direction Z dot A red amp white dot showing the current zenith position Random offset Pan center Star colors Toggles on off the color code assignment for each star in the map Prin Guider Shows Hide guide probe one Sec Guider Shows Hide guide probe two Ctr Guider Camera FOV Shows Hide the science camera field of view Youar A P E North East Pd w IE i gt Xema Figure 2 2 The position angle PA is the angle between Ycmar axis and the North axis 2 1 2 MAIN gt File gt Airmass Window This window will show an air mass extinction graph 2 2 MAIN gt Telescope Selector Box Use this selector box to select the observatory parameters to use When using SAM this box should always show the label SOAR 2 3 MAIN gt Guider Use this selector box to select the guider subsystem to use When using SAM this box should always Rtsoft
6. pot representing a 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 7 Rtsoft User Manual Rev 2 1 November 2010 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 o f 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 GS3 program 4 1 Configuration Files The environment variable GMAPCONFIG defines the place where the configuration files live 4 1 1 gs3rc By default this file is installed in the home directory as gs3rc note the dot at the beginning Though not strictly necessary it is advisable to include this file in the login shell startup script so the environment variables in it get defined when the user login into the account When the start_gs3 command is executed the gs3rc file gets sourced to ensure the environment variables are defined and only then the application starts This is the GMAP program home directory setenv GMAPHOME GS3 This is where the catalogs live setenv GMAPCATS GS3 catalogs This is where the configuration files live setenv GMAPCONFIG GMAPHOME config Bi
7. s eae AGUA Bnet ke Ne EUA G ider SOCIO viu eases DA patas ITA EN AULA ASDO AU TU ab NS Hise Server TELD EERTE A A Ase Aa EAA APA ai as Chapter 1 Getting Things Running Chapter1 Getting Things Running This user manual is intended to describe th e use o f the SAM Guide Star Selection Software GS3 from the user s point of view It is not a programming manual 1 1 Starting the GMAP Software You can either launch the GS3 utility program from the Instrument Control Software ICSOFT or from your favorite terminal Both ways will be described here 1 1 1 Launching GS3 from ICSOFT 1 With the ICSOFT running select the Catalogs Tab from the main GUI window 2 Press the button labeled USNO Catalog The button is the last button to the right of the pane 1 1 2 Launching GS3 from the command line Open a shell window and invoke the GS3 software with the following command cd home GS3 bin start_gs3 options Normally you will invoke GS3 with no options Valid option values are listed below h Prints a usage message c catalog A catalog name SAO PPM USNO SA USNO AO f font name Set font used 1 2 Stopping the GMAP Software To stop the GS3 application select EXIT from the File menu 1 3 Environment Variables GMAP reads some environment variables to locate some special files that are normally handled by the initialization script start_gs3 GMAPCATS Defines the place where the star catalogs are installed
8. tmaps setenv BMPDIR GMAPHOME share bitmaps 4 1 2 egmap dat This file is composed of multiple sections The user can hand edit this file to modify parameter values By including the word default in the line following the section name the entry is set as the default one A detailed description of each section follows 4 1 2 1 Telescope section name Label with the observatory name This name is showed in the Telescope selector box in the main GUI window longitude Observatory longitude in deg East is positive latitude Observatory latitude in deg North is positive 9 Rtsoft User Manual Rev 2 1 November 2010 Chapter 4 Configuration Files and Macros 4 1 2 2 Camera section name Camera displayed identification This label will be used in the camera selector box in the main GUI window nchips Number of CCD chips in the science camera choffx1 1 n x offset choffy1 1 n y offset dimx Number of pixels in x dimy Number of pixels in y pixscale Size of each pixel in arcseconds 4 1 2 3 Guider section name Displayed identification offaxis x Displacement in x offaxis y Displacement in y field w Field width of camera in x field h Field width of camera in y unit x Size of x unit in arcseconds Only valid when nguider has NOT been defined unit y Size of y unix in arcseconds Only valid when nguider has NOT been defined center x center y px Is the size of the guide box in pixels For
Download Pdf Manuals
Related Search