og_create

The first step in the data analysis is the creation of an Observation Group (OG) from the list of prepared Science Window Group DOLs you want to analyze. To create an Observation Group you use the og_create program. It also creates the standard obs branch of the directory tree, where the following analysis will be performed, and the high-level science window groups will be produced.

To follow the example given in the IBIS cookbook you create an ASCII file dith.lst with four lines in it:

scw/0044/004400540010.001/swg.fits 
scw/0044/004400550010.001/swg.fits 
scw/0044/004400560010.001/swg.fits 
scw/0044/004400570010.001/swg.fits

This list can also look as simple as:

004400540010.001 
004400550010.001 
004400560010.001 
004400570010.001

In Table 8 the parameters of the program are listed. Query parameters are marked in boldface.

Table 8: og_create parameters.

Name	Type	Description
Parameters defining the name, contents and location of the OG
idxSwg	string	Index of science window groups or ASCII list of SWG DOLs, or
		just ASCII list of SWGs even without a path.
ogid	string	Observation group ID (used to build the path).
baseDir	string	Base directory from which the obs branch is built. This parame-
		ter should be a relative path from where og_create is run. If not
		defined, the executable will use the REP_BASE_PROD environ-
		ment variable.
instrument	string	Comma separated list of instruments. This will create several
		OGs in the same repository.
		possible values:
		``INTEGRAL'' all data,
		``SPI'', ``IBIS'', ``JMX1'', ``JMX2'', ``OMC'' instrument specific
		data
Additional parameters
obs_id	string	ISOC observation ID (copied to keyword OBS_ID in OG).
		(Optional)
scwVer	string	If the idxSwg is an ASCII list of just ScWIDs, this is appended
		to the end of the ScWID, unless there already is a version there.
		(Optional)
		default: ``001'' (as in: 001000010010.001)
purpose	string	Scientific purpose of the OG. (Optional)
swgName	string	The name that will be given to a science window group.
		(Optional)
		default: ``swg'' (as in: swg.fits)
versioning	integer	Add a version to the ogid directory (0 = NO, 1 = YES).
		default: 0

The command

og_create idxSwg=dith.lst ogid=dith baseDir="./" instrument=IBIS

creates a directory obs/dith with an Observation Group og_ibis.fits in it.

Note that if the file name passed as idxSwg includes a ``+'' or ``['' sign, og_create automatically interprets that file as a FITS file.