Here - Integral
Contents
1. INTEGRAL Science Operations Centre Software User Manual AO 6 KP Observation Tools Software User Manual INT SDG 07 0286 Dc Issue 1 0 22 October 2007 Prepared by P Balm and G B langer Authorised by P Kretschmar Doc No INT SDG 07 0277 Dc INTEGRAL Issue Issue 1 0 Integral AO Tools Date 22 October 2007 Software User Manual Page il Document Status Sheet AO 6 KP Observation Tools Software User Manual 22 October 2007 Issue for AO 6 KP Doc No INT SDG 07 0277 Dc INTEGRAL Issue Issue 1 0 Integral AO Tools Date 22 October 2007 Software User Manual Page iii Table of Contents E O O E E E E T 4 2 POPOL Gn rao TOO ne E EE E 4 DM E a E E EE E A E E E 4 NM AEN E E e a A E E E E T E ss 4 2 1 2 The Admin Proposal and Observation Details Panels 20 0 0 cccccccccccccssseeeeeeeeeeeeeeaeeeeees 5 2 2 Saving loading and printing cccccccccsssssssseecccceecceessseecccceeesauecseeeccceeesseeeeseseeeeesessauanseceess 8 Dele My ANNU E E E seein EE ee eget easter nee eee cease eae nc mementos cons 8 DZD MOAI a E eos aaaaeastcmtednsasaasttedendvouseannsaeneemtecnacnnasdeeiantuons EAE 8 Dali P E E E E E S 8 Zs SU ind ra PONa LTO OCE 9 231 WMI Tor ihe TiS TO sasesana E E E EAE 9 2 5 2 Res bmittine PEOPOGAl ocxcceevecscessaveiieiaescepwasouastacnesseow ate secon a E EErEE a 11 2 3 3 Obtaining a copy of a submitted proposal from ISOC ec ceccccccccssseseeeeeeeeeeeaeeeeees 1 gt Observi2. Print Proposal in the menu of the Main Panel A Print dialogue will appear and allow you to select a destination printer or file and start the print job The exact appearance of this dialogue will depend on the platform you are using The administrative details and the proposal details can be printed individually by selecting Panel Print in the menu bar of the corresponding panel Observation details can be printed by selecting Panel Print All Observations to print all the observations or by selecting Panel Print Current Observation to print an individual observation To print a summary of all the observations in the proposal one observation per line select Panel Print Summary 2 3 Submitting a proposal to ISOC The PGT allows you to send your proposal electronically to the ISOC To do this your computer must be connected to the Internet 2 3 1 Submitting for the first time Clicking the Submit Proposal to ISOC button in the lower part of the Main Panel see Figure 1 starts the submission process PGT will first check your proposal If it fails any checks the submission process will be aborted and you will need to correct the errors shown in the Failed Checks Panel If it passes the checks a panel is displayed showing a summary of the proposal Click Submit to send the proposal Cancel to abort the submission Doc No INT SDG 07 0277 Dc INTEGRAL S a m Issue Issue 1 0 Integral AO Tools Software
3. FAQ at http integral esac esa int FAQ If you do not find the answer to your question please contact the INTEGRAL Helpdesk mailto inthelp sciops esa int 2 Proposal Generation Tool PGT can be downloaded from http integral esac esa int isoc operations html pgtao6kp Installation instructions and answers to FAQ are also provided there Once PGT has been successfully installed it 1s launched by running an executable script called pet on UNIX like platforms or by double clicking on the desktop icon on Windows systems 2 1 Entering data 2 1 1 The Main Panel When the PGT is launched the Main Panel is displayed Figure 1 This panel serves as the parent to the Admin Details Panel the Proposal Details Panel and the Observation Details Panel all of which can be accessed by clicking the appropriate button found in the top half of the Main Panel ISOC PGT Ma gue 0b s File Help esa Admin Details Panel Proposal Details Panel These buttors open other panels in the PGT Observation Details Panel Use this button to check your proposal Check Proposal Submission Submit Proposal to BOC Proposal ID Using this section you can subrat your proposal Figure 1 The Main Panel of PGT INT SDG 07 0277 De INTEGRAL ee N Vi Issue Issue 1 0 MA Integral AO Tools Software pate 22 October 2007 User Manual Page 5 of 15 Below these three buttons there is a Check Proposal button that init
4. pate 22 October 2007 User Manual Page 10 of 15 nal Summary Panel EE Ea The requirements are described in detail in section 2 2 1 of the Announcement of Opportunity for Key Programme Observing Proposals for the AO 6 Cycle of Observations available for download from http integralLesacesaint AGHKP If any of these items are missing from the attached justification or you have not yet attached the latest version please re attach a correct version of your justification Summary of observations Total Observation Duration 1000000 Total Number of Observations 1 Observation 1 Observation Duration 1000000 Target Name Mrk 4271 RA Dec 2000 16h im 12 945 22d 59m 28 55 Observation Type Normal Dither Pattern a5 Warning Only the above observations will be considered for approval Figure 6 The Summary Panel By clicking Submit PGT will attempt to establish a connection with a computer at ISOC that has been set up to receive proposals Once it is established the proposal will be sent If the proposal was sent successfully the following dialogue will be displayed Submit Proposal Proposal submitted successfully Please allow some time 20 min for the confirmation e mail to be sent If you do not receive e mail confirmation within 24 hours please contact the SOC Helpdesk at inthelp sciops es aint k a Figure 7 Successful Submission dialogue Upon receipt of a proposal the compute
5. skybin is visible Each line in the list contains start and end times UTC and duration of visibility seconds Gaps of eight hours between successive visibility periods are usually due to Van Allen belt transit Shorter gaps are due to Earth or Moon constraints and longer gaps to Sun anti Sun constraints
6. the total number of observations in the proposal The name is not checked with Simbad sources as it is intended to identify your field of interest The pattern centre is required for any of the available dither pattern types If Custom Dither is chosen as the pattern type pattern details must be provided in the scientific justification a ISOC PGT Observation Details Panel _ 5 iE jix i Panel Observation Help iP INTEGRAL Cc esa Science Operations Centre ae 1 of 1 Observation details pia Duration Dither Pattern D ks Pattern Centre RA d2000 oa gt _k o DEC j 2000 r Bega Are Min Are Sec Figure 3 The Observation Details Panel The Observation Details Panel has an additional menu named Observation The menu entries should be self explanatory to add a new observation select Add the display will show the new observation to remove the currently displayed observation select Delete to copy the currently displayed observation select Duplicate the display will show the copied observation to check the currently displayed observation select Check to display a particular observation select Go To To copy n observations from the current displayed observation select Copy n and to delete a range of observations select Delete n INT SDG 07 0277 Dc Issue 1 0 22 October 2007 8 of 15 ISOC TAr Observation Details Panel j a el ave INTEGRAL N K D
7. ds and assuming a power law spectrum with the flux and spectral index as user inputs calculates the flux within each sub band It then performs individual calculations on these sub bands of the S N or observation duration and finally combines these results into a global figure for the entire input energy band 3 3 Hints and warnings 1 Units Please be careful with units e Input and ouput time are in kiloseconds e All fluxes both for lines and continua should be given in units of photons cm s 11 Prospective IBIS users should also note the following e The continuum range of interest can straddle the energy ranges of ISGRI and PICsIT and be only partially inside the energy range of one or both If only one calculation is done for the entire range of interest both sub instruments might report a poorer response than is truly available If one does go beyond the energy range of a sub instrument a warning is given e In such a case we recommend calculating the broad band flux for the energy range of interest covered by ISGRI and by PICsIT separately and combining the results later 111 The contributions of Compton photons to the S N or observing time are not considered Doc No INT SDG 07 0277 Dc INTEGRAL MUU Issue Issue 1 0 Integral AO Tools Software Date 22 October 2007 User Manual Page 14 of 15 4 Target Visibility Predictor TVP The Target Visibility Predictor TVP is a web based tool running at t
8. elete Science Operations Centre d E Duplicate aif Check Eel 7 Total Time GoTo xi d booo ks Copy n Delete n Figure 4 The Observation Menu 2 2 Saving loading and printing 2 2 1 Saving To save a proposal at any time select File Save in the menu of the Main Panel see Figure 1 2 2 2 Loading To load a saved proposal select File Open in the menu of the Main Panel 2 2 3 Printing To print a proposal or parts of it first choose the printing options by selecting File Print Options in the menu of the Main Panel This will open the Print Options dialog box see Figure 6 Print Options Eo ETR Paper Size gt r ij Ad O US letter Available Fonts Luxi Mono Luxi Sans Luxi Serif Monospaced SansSerit Serif Utopia Font Sample The quick brown fox jumps over the lazy dog Figure 5 The Print Options dialogue INT SDG 07 0277 De INTEGRAL ee UU Issue Issue 1 0 WN Integral AO Tools Software pate 22 October 2007 User Manual Page 9 of 15 Two paper sizes are supported A4 and US letter Click on the appropriate button at the top of the dialogue to choose the paper size The list of fonts from which you can select will appear below After having selected the paper size and font set them by clicking OK or Cancel to disregard de selection and close the dialogue To print the entire proposal select File
9. fore slightly conservative The results are stored in a Data Base of Observable Bins DBOB which contains the open and close times for every skybin during the mission and the resulting available duration This open interval never crosses revolution boundaries since science operations are not performed in the Van Allen belts around perigee 4 3 Using TVP 4 3 1 Input e RA and Dec J2000 In either of the formats shown on the web page e Dither pattern For hexagonal or 5x5 dither patterns the TVP checks whether all points in the dither pattern are visible not just the centre e Start and End date For the period of interest Defaults are start and end dates in the DBOB which cover the interval to beyond the end of the AO cycle It is recommended to cover only the period of interest Input should be in the format shown on the web page INT SDG 07 0277 De INTEGRAL ee U 7 Issue Issue 1 0 Integral AO Tools Software Date 22 October 2007 SS User Manual Page 15 of 15 e Minimum Duration In seconds TVP will only return visibility of bins open for longer than this value In the DBOB bins can be open for as short as one second if the bin is at the edge of the Earth or Moon constraint However the scheduling system would never attempt to use such a bin We suggest 1800 seconds as a reasonable value 4 3 2 Output The output of TVP is a summary of the input parameters and a time ordered list of when the source
10. given observing time or conversely the integration time needed to achieve a desired S N OTE can currently be used only for INTEGRAL s main instruments SPI and IBIS Not for JEM X and OMC interested users should refer to the JEM X and OMC Observer s manual for details All INTEGRAL proposers should use OTE in determining the duration of their proposed observations These values are used by ISOC in the proposal s technical feasibility assessment used by the TAC INT SDG 07 0277 De INTEGRAL ne NUU Issue Issue 1 0 Integral AO Tools Software Date 22 October 2007 User Manual Page 12 of 15 OTE is accessed via the ISOC web site http integral esac esa int by clicking on Observation Tools under INTEGRAL Announcement of Opportunity AQO 3 1 Using OTE 3 1 1 Input Select an instrument SPI or IBIS Select a continuum or line source For a continuum calculation the user must set the lower and upper energies The allowed range is 15 keV 10 MeV OTE assumes a power law spectrum and the photon spectral index must be specified in the GUI If you wish to perform calculations for a continuum source please make sure to read section 3 4 For a line source input the central energy and line width FWHM If the line is unresolved a line width of 0 1 keV 1s sufficient Specify the S N or the exposure time Specify the source flux This is the broad band flux in units of photons cms in either t
11. he INTEGRAL Science Operations Centre at ESAC and made available to potential observers TVP is used to determine when a source is visible to INTEGRAL This is especially useful in determining whether INTEGRAL observations can be coordinated with other observatories and if phase dependent observations of binary systems for example can be performed TVP is accessed via the ISOC web site http integral esac esa int by clicking on Observations tools under INTEGRAL Announcement of Opportunity AOV 4 1 Viewing constraints INTEGRAL celestial viewing constraints are defined by power and thermal constraints Sun as well as star tracker blinding constraints Sun Earth Moon The constraints used in this tool are that the spacecraft cannot point within 50 of the Sun more than 130 away from the Sun within 15 of the Earth s limb or within 10 of the Moon s limb Since the Earth and Lunar orbits can be predicted very accurately it is also possible to predict when any part of the celestial sphere is visible to INTEGRAL 4 2 How visibility is calculated Sky visibility is calculated by dividing the sky into approximately rectangular cells of 10 x 10 degrees referred to as skybins The visibility of each corner of a skybin is determined for every revolution in the mission whenever INTEGRAL is above the Van Allen belts If all four corners are simultaneously visible that area of sky is deemed visible The calculation is there
12. he selected energy range for the continuum or integrated over the full width at zero intensity FWZD for a line Beware The continuum sensitivity curves in the SPI and IBIS Observer s manuals are presented using different units monochromatic flux density i e photons cms keV Enter the source position optional in either degrees or sexagesimal notation J2000 OTE accesses the 2 ISGRI catalogue and warns the user if there are any nearby bright sources a bright source in the partially coded field of view can severely deteriorate image quality Select the desired dither pattern This will take into account the off axis response of the instruments as INTEGRAL dithers a very important effect for SPI but not for IBIS staring is not recommended We generally recommend the 5x5 dither pattern see the IBIS and SPI observer s manuals Click the Query button 3 1 2 Output OTE returns The original input values Any nearby bright source information coordinates from the 2 ISGRI catalogue Warnings if part of the selected energy band for the source calculation is outside the energy range of the selected instrument Doc No INT SDG 07 0277 Dc INTEGRAL N Vi Issue Issue 1 0 MA Integral AO Tools Software pate 22 October 2007 User Manual Page 13 of 15 e For continuum sources the calculated exposure time or S N for the individual sub bands used in the back end calculations These may be useful for exam
13. iates a series of checks on the proposal and lists anything that is wrong or incomplete This check can be performed at any time The lower half of the Main Panel controls proposal submission or resubmission Clicking the Submit Proposal to ISOC button will send an electronic version of the proposal to the ISOC 2 1 2 The Admin Proposal and Observation Details Panels PGT provides three details panels that encompass all the information about the proposal These include administrative details proposal details and observation details and are accessed by clicking the corresponding button in the Main Panel All fields in any panel that have a light yellow background are mandatory and cannot be left blank 2 1 2 1 Admin Details Panel This panel serves to enter contact information for the principal investigator 2 1 2 2 Proposal Details Panel This panel serves to enter the title and abstract of the proposal its scientific category and to attach the scientific justification Scientific Justification At the bottom of the Proposal Details Panel there is a button marked New Attachment Use this button to attach the scientific justification of your proposal in PDF or PostScript format Doc No INT SDG 07 0277 Dc INTEGRAL MU T Lr E Issue Issue 1 0 TAS OOA Integral AO Tools Software Date 22 October 2007 S User Manual Page 6 of 15 ISOC PGT Proposal Details Panel Proposal Details Proposal Title Proposal Abstract Prop
14. ng Time Es matot OTE Jesica i a e aiian ba 11 A U O ea E E E E E 12 Ikl DDOE eeren E A E E OR E E E E EE R EIE A E EE EAT 12 IE OD a E EA EER E E T E 12 3 2 Continuum calculations a note on energy ranges eeessssssseeerrssssssseceeerssssssseerersssssssees 13 Io Pon AC Wy ANN e E E E E EE E E N 13 a Target Visibilty Predictor TVP esea EE 14 ie VINE COSTE S e e E E E E E E E EE E E EA 14 42 TOW visibility is calcmated diceto sseasteusasvnesbesecnseseasiosebe saeessueapsinacbevadadsusasnnsebesavidsssarvendbverdadsesaaie 14 To O TT e E EE E E 14 ToL EP E E E E E sae 14 Meee O e E E E aeanseenpesateteusoees 15 INT SDG 07 0277 De INTEGRAL ne i ws 3 WI p Issue Issue 1 0 Integral AO Tools Software Date 22 October 2007 User Manual Page 4 of 15 1 Introduction The purpose of this document is to describe the use of the software tools made available to observers who wish to submit a proposal for an INTEGRAL Key Programme KP observation The INTEGRAL KP Announcement of Opportunity AO Tools provided by the INTEGRAL Science Operations Centre ISOC include the Proposal Generation Tool PGT the Observation Time Estimator OTE and the Target Visibility Predictor TVP The latest version of these tools together with the associated documentation is available from the ISOC web page http integral esac esa int If you discover a problem with any of those tools please read the Frequently Asked Questions
15. oposer from submitting by mistake the same proposal multiple times as new proposals A new Proposal ID will be generated for each new submission Therefore be cautious when resubmitting a modified version of the same proposal 2 3 3 Obtaining a copy of a submitted proposal from ISOC After submitting a proposal it should be saved see section 2 2 for future reference and to allow for the possibility of resubmitting the proposal at a later date You can also request a copy of your proposal by sending an email to the ISOC Helpdesk mailto inthelp sciops esa int stating that you would like a copy of your proposal referring to it with the corresponding Proposal ID It will be emailed to you at the address specified in the Admin Details Panel of PGT If another email address should be used specify this in the message 3 Observing Time Estimator OTE The Observing Time Estimator OTE is a web based tool running at the INTEGRAL Science Operations Centre at ESAC and made available to potential observers Below is a description of OTE version 5 Improvements over the previous version includes a considerable increase in speed and slight changes in presentation However the underlying response data is unaltered The purpose of the OTE is to give users a reliable guide as to the feasibility of their proposed observation For example given specific source characteristics spectrum flux OTE computes the signal to noise ratio S N achievable in a
16. osal Category Scientific Justification Figure 2 Adding Attachments Having selected the attachment the name of the file will be shown in the Current Attachment box of the Proposal Details Panel Saving the proposal also saves the attachment in compressed form Hence there is no need to re attach the file every time the proposal is loaded Clearly if you make changes to the scientific justification after the file has been attached to the proposal you must override the previous attachment by attaching the new version There is no need to ever remove an attachment only the last attachment is used Selecting Panel Reset will clear all fields and remove the attachment There are differences in the requirements on the scientific justification between normal AO s and Key Programme AO s The requirements for Key Programme AO s are detailed in the document Announcement of Opportunity for Key Programme Observing Proposals for the AO 6 Observing Cycle paragraph 2 2 1 2 1 2 3 Observation Details Panel This panel serves to enter the technical details of each observation included in the proposal Doc No INT SDG 07 0277 Dc Issue Issue 1 0 Date 22 October 2007 User Manual Page 7 of 15 Each observation in a proposal is numbered sequentially as shown in the Number field on the left of the tool bar at the top of the Observation Details Panel Here you can see the number of the currently displayed observation and
17. ple for determining the energy above which the source fades into the background e Calculated exposure time or S N for the entire input energy range for continuum sources or for the FWZI line sources 3 2 Continuum calculations a note on energy ranges While a broad energy range is allowed in the OTE input the OTE back end calculations themselves do not allow the use of a broad energy band e g 20 keV to 10 MeV The underlying algorithm in OTE calculates the average performance across a user defined continuum energy band given the flux of the source in that band However the sensitivity of the instruments can vary enormously over their energy ranges In addition the gamma ray instruments can have very rapid changes in sensitivity in a comparatively small range of energies especially around 511 keV Also many most gamma ray sources exhibit steep spectra so that they are very much fainter at higher energies Even for hard sources including the highest energies will result in very low S N due to the relatively high background at MeV energies compared to the source flux For these reasons in previous AOs OTE was restricted to energy bands which are narrower than the entire instrumental bandpass Of course the prospective observer may be in a situation where the continuum range of interest is rather wide To allow this the front end GUI of OTE allow the user to specify a wider band OTE splits the input energy range into narrower sub ban
18. r at the ISOC performs further checks and sends a receipt confirmation email message This e mail can take some time around 20 min If the proposal passes the checks a Proposal ID will be assigned to it and included in the message If it does not this will be stated in the email INT SDG 07 0277 De INTEGRAL ee UU Issue Issue 1 0 WN Integral AO Tools Software Date 22 October 2007 User Manual Page 11 of 15 2 3 2 Resubmitting a proposal If you realise you have made a mistake or simply want to make changes to a proposal you have already submitted you can resubmit a proposal using the Proposal ID Make the changes you wish to make to the proposal and enter the Proposal ID in the box provided at the bottom of the Main Panel see Figure 1 The Resubmit Proposal to ISOC button will be enabled and the Submit Proposal to ISOC button will be disabled When you click the Resubmit Proposal to ISOC button PGT will repeat the proposal submission process described above The computer at ISOC will use the Proposal ID entered to find the previous version of the proposal in the ISOC database If it is found the resubmitted proposal will replace the previous one If it is not found the receipt confirmation email message will inform you of that fact make sure the Proposal ID is correct The PI e mail is also checked with regarding to ISOC database proposal re submission is not accepted 1f this check fails PGT cannot prevent a pr
Download Pdf Manuals
Related Search