XMM-Newton Observation Log Browser Help

Introduction

The Observation Log Browser is devided into two parts: 1) the Search Frame (top part of the browser) and 2) the Output Frame (bottom part of the browser). The Search Frame is used for navigating through the data and also for navigating through different parts of the system. The Output Frame always gives information about the selections made in the top frame.

The Search Frame

The most important part of this frame is the selection box. Observational information can be selected by using one or more selection rules. So combinations are also possible. Some selection rules require a combination, like for instance the search by position on the sky. In this case you have to fill in RA, DEC and Size of Search Box. For some parameters the input is quite strict, on others it is not. Below you'll find a description of the possible formats.
Once you have filled in the selection rules press on the Get Selection button and after a few seconds the result is shown in the bottom frame.
This program is available in a 'standard' version (for usage within VILSPA) and a 'light' version (for the outside world). The normal version also has the possibility to switch to the 'Enter Exposure Information' page. This is used to insert observations and exposures that were not included in the POS (unscheduled or rescheduled observations and exposures). See the online help in that section for more information. Also included in the 'internal' version is the possibility to dump the information from the Observation Database into a CSV file. This is an ASCII file where all the fields are separated by a semicolon. You can read this file into Excel to do your own calculations.
And there is also a switch where you can select if you want to see Engineering information (Full display). The output can become quite large (and it is slow), so by default it is turned off.

Selection Rule Formats

Revolution: a number between the start of mission exposures (0014) and the last available revolution. Numbers can be entered with or without leading zeros. It is also possible to give a range using the minus sign. So -17 means revolutions 0014 to 0017, 53-58 means revolutions 0053 to 0058, 200- means from revolution 0200 until the current revolution.
Observation ID: a 10-digit number. Numbers can be entered with or without leading zeros.
Proposal Number:
RA: Right Ascension in J2000 coordinates. The default format is HH:MM:SS.SS, but the following formats are also supported:
HH:MM:SS, HH:MM, HH, HH.MMSS (decimal format)
DEC: Declination in J2000 coordinates. The default format is sDD:MM:SS.S (with s the sign: + or -), but the following formats are also supported:
DD:MM:SS.S, DD:MM:SS, DD:MM, DD, DD.MMSS (decimal format), all with the sign as optional.
Size of Search Box: size of the Search Box side, expressed in arcminutes. The Search Box is centered around the specified RA and DEC.
Target: name of the source. The format is case insensitive and also partial matches are allowed. For partial matches don't include *.
PI: name of Principle Investigator. The format is case insensitive and also partial matches are allowed. For partial matches don't include *.
Category: selection of observation type.
Observation Start: date and time when the observation started. The default format is YYYY-MM-DD@HH:MM:SS but replacing the @ by a : or a space is also allowed.
Observation End: date and time when the observation ended. The default format is YYYY-MM-DD@HH:MM:SS but replacing the @ by a : or a space is also allowed.
Order By: display order in the Output Frame. Possible sorting possibilities are Observation ID, Revolution, Observation Start, RA, DEC.
Instrument: Selection of one instrument or all.
Mode: Selection of modes depending on the instrument selected.
Filter: Selection of filter depending on the instrument selected.

Further switches

PDF output: generates a PDF file instead of HTML output.
Show slew observations: also include observations that were done during slews.

The Output Frame

The top part of this frame shows in blue how the rest of the output table is organized. The table starts with the Observation ID. If an observation has been rescheduled then the ID will appear as Old ID -> New ID. The next two lines in the table shows general information that is valid for all exposures from that observation (Target Name, Principle Investigator, Right Ascension, Declination, Position Angle, Observation Duration (in sec), Priority (observing period), Proposal Number, Observation Start Time, Observation End Time, Revolution, Prime instrument.
When an observation has been rescheduled an icon will appear in front of the Start and End Time: The Tool Tip shows the Scheduled Time. By putting your mouse cursor on top of the icon a Tool Tip will appear with the Scheduled Time.
Then you'll get all the exposures sorted by instrument. The first line for each exposure contains general information that is present for all instruments like Mode, Exposure Start Time, Exposure End Time, Scheduled Duration and Performed Duration. The quality factor that is inserted via the Insert Exposure Page will show as a color for the Exposure ID (black = n/a, green = good, orange = usable, red = bad). The next lines are instrument specific and can change over time when there is a need for other information. For each exposure a field is present for instrument specific comments.
When an exposure is rescheduled this will show in a similar way to the rescheduled observations. The Exposure ID will look like Old ID -> New ID and the same icon will appear at the Start and End Time.
Restarted exposures will appear with the exposure IDs between brackets.
Then a section is reserved for General Comments (information that is for the whole observation). For instance Telemetry Drops will affect all exposures, so you want to insert these as a general comment.
The last part in the table summarizes the exposures per instrument. The Scheduled Duration and Performed Duration are summed and also a percentage is given.