make printable	New:	The tool is distributed through the utilities package (utilPack).
	v2.0: - old PANL2 database turned off, replaced by a local database - tool self-configuration simplified, default for new instruments - comments truncated after 400 chars.	databases 'associations' for old format, NLT for new format dfos tools none output tmp files being used by createReport, calChecker upload/download none

getObInfo

Description

This tool provides queries for OB related information. Since this information is used by various other tools (createReport, calChecker etc.), these queries have been centralized in this helper tool. The situation for the information sources is the following:

instruments	switch	information source
fors2, crires	2012-10-02	before: associations db; after: NLT
flames, uves, xshooter	2012-04-01	before: associations db; after: NLT
isaac, vimos, visir	2012-09-30	before: associations db; after: NLT
hawki, naco, sinfoni	2012-10-02	before: associations db; after: NLT
amber, midi	2012-10-02	before: associations db; after: NLT
omegacam	begin of ops	NLT
vircam	begin of ops	NLT
kmos and all later instruments	begin of ops	NLT

"Switch" means that OB information before that date is stored in 'associations' database, while after that date it is stored in the nightlog database (NLT). The instrument names with switch dates during their lifetime are hard-coded in the tool. omegacam and vircam were always supported by NLT, as all instruments coming to life later than 2012-10. These are not listed in the tool.

Output. Queries and OB information output files in $TMP_DIR. Call the tool from the command line with option -V and inspect the output. Otherwise the tool works silently as called from createReport or calChecker.

How to use

Type getObInfo -h for on-line help, getObInfo -v for the version number. On the command line, type

getObInfo -d <date> to call it for the local instrument and the specified date, using $DFO_FILE_NAME for queries before the switch, and $PANL_INSTRUMENT after;

getObInfo -C to call it for all dates currently in the calChecker date list ("CAL mode", used internallt by calChecker).

Use option -V [verbose] to get more information.

Use -i <$PANL_INSTRUMENT> to see results from other instruments (but only for dates after the switch!).

Usually the tool works silently if called from createReport or calChecker.

How to install

The tool comes as part of utilPack.

Configuration file

None.

Notes

The comments are truncated after 400 characters. Calls for instruments with dates before the switch are only possible on the parent account (because there is automatic matching of $DFO_FILE_NAME and $PANL_INSTRUMENT).