make printable

New: v1.2: ingest do_class in database depending on RAW_TYPE v1.1: ingest PRO.CATG in database depending on RAW_TYPE

The tool is distributed through the utilities package (utilPack). tools related to calSelector: calselManager | createCalibMap | verifyAB | writeBreakpoint general overview of calSelector here OCA: rules | syntax databases QC1 table calsel_breakpoints dfos tools uses qc1Ingest output entry in $DFO_LST_DIR/CALSEL_BP upload/download

writeBreakpoint

Description

This tool manages new entries in the QC1 database table calsel_breakpoints, for a given instrument. Breakpoints are instrumental events (defined by mjd_obs and per instrument and raw_type) that are "fundamental" in the sense that no association between a science file and a calibration file is allowed that would cross the breakpoint. The OCA rules either have no time preference (then the closest-in-time match is chosen), or relative time preferences (PREVIOUS or NEXT), but they cannot cope with singular events. This is the purpose of the breakpoints.

Breakpoints are stored in the QC1 database table calsel_breakpoints. The tool writeBreakpoint guides the user in a dialogue through the ingestion process.

You need to specify in a dialogue:

• mjd_obs
• a comment (which should be indicative enough to document the breakpoint even after years)
• the raw_type for which the breakpoint is applicable: could be 'ANY' for all data types, or a specific selection (multiple values permitted).

After confirmation, the tool determines from the specified RAW_TYPEs the affected PRO.CATGs by usage of the latest calSelector OCA rule set. It is possible to specify a different set in the tool dialogue in case historic breakpoints are inserted. With version 1.2, it also determines the affected DO class(es) with the operational OCA classification rule. Then, the tool uses 'qc1Ingest' and writes all fields into calsel_breakpoints.

Output

How to use

Type writeBreakpoint -h for on-line help, writeBreakpoint -v for the version number. Type

writeBreakpoint

to open the dialog.

How to install

The tool comes as part of utilPack.

Configuration file

None.

Operational aspects:

• The breakpoint table is read by the calSelector tool.
• You can hide entries with the qc1Hide interface, accessible from here.
• You can use the file $DFO_LST_DIR/CALSEL_BP/list_ingest_breakpoints.txt to modify entries, or call the dialog from scratch.