csobsselect

Selects observations from an observation definition XML file.

Synopsis

This script selects all observations from an observation definition XML file that have pointings within a specified selection region and time interval and writes these observations into a new observation definition XML file. Possible selection regions are a circle and a box, given either in Galactic or Celestial coordinates.

General parameters

inobs [file]

Input event list or observation definition XML file.

outobs [file]

Output observation definition XML file.

pntselect <CIRCLE|BOX> [string]

Pointing selection region shape.

coordsys <CEL|GAL> [string]

Coordinate system (CEL - celestial, GAL - galactic).

ra [real]

Right Ascension of pointing selection centre (J2000, in degrees).

dec [real]

Declination of pointing selection centre (J2000, in degrees).

glon [real]

Galactic longitude of pointing selection centre (degrees).

glat [real]

Galactic latitude of pointing selection centre (degrees).

rad [real]

Radius of selection circle (degrees).

width [real]

Width of selection box (degrees).

height [real]

Height of selection box (degrees).

tmin [time]

Start time for observation selection (UTC string, JD, MJD or MET in seconds). Start times given in MET seconds are counted with respect to the time reference of the input observation(s). If INDEF, NONE, UNDEF or UNDEFINED is passed as value, no time selection will be performed.

tmax [time]

Stop time for observation selection (UTC string, JD, MJD or MET in seconds). Stop times given in MET seconds are counted with respect to the time reference of the input observation(s). If INDEF, NONE, UNDEF or UNDEFINED is passed as value, no time selection will be performed.

Standard parameters

(chatter = 2) [integer]
Verbosity of the executable:

chatter = 0: no information will be logged

chatter = 1: only errors will be logged

chatter = 2: errors and actions will be logged

chatter = 3: report about the task execution

chatter = 4: detailed report about the task execution

(clobber = yes) [boolean]

Specifies whether an existing output model file should be overwritten

(debug = no) [boolean]

Enables debug mode. In debug mode the executable will dump any log file output to the console

(mode = ql) [string]

Mode of automatic parameters (default is ql, i.e. “query and learn”)

(logfile = csobsselect.log) [filename]

Log filename