Toolbox

Here we give the brief description of the generic OSA tools. More information could be seen in the .txt file or by entering the name of the program with the --h option after it, e.g.

dal_attach --h

Table 6: List of generic tools (more often used part).

Name	Description
barycent	Converts time stamps of events or light curves to barycentered times assuming
	that the data comes from a given source direction.
cat2ds9	Creates DS9 region file from the list of sources. This can be a catalog extract,
	or a list of sources produced by the analysis. See more details in section 6.3.
cat_merge	Merges two source lists, e.g., two extracts from different catalogs.
converttime	Reads input time in a user specified format and converts it to either user
	specified output format or into all formats known by the converttime.
dal_create	Creates a FITS file according to a template.
evts_extract	Creates an instrument independent event list.
evts_pick	Combines event data distributed over several Science Windows and tables
	within the Science Window into a single table. Limited to ISGRI and JEM-X
	in this release.
gti_attitude	Creates a GTI depending on attitude stability, see Science Analysis sections of
	[1], [2],[3],[4] for more details on practical implementations.
gti_create	Generates GTIs depending on housekeeping parameters, see Science Analysis
	sections of [1], [2],[3],[4] for more details on practical implementations.
gti_data_gaps	Generates GTIs depending on the not missing science data packets, see Science
	Analysis sections of [1], [2],[3],[4] for more details on practical implementations.
gti_import	Imports User GTIs into the ISDC GTI index files, see Science Analysis sections
	of [1], [2],[3],[4] for more details on practical implementations.
gti_merge	Merges Good Time Intervals,see Science Analysis sections of [1], [2],[3],[4] for
	more details on practical implementations.
gti_pick	Creates a user GTI file from ISDC GTIs.
gti_user	Creates user GTI table, see 6.2 for more details.
image_mosaic	Combines many count rate sky images into a mosaic count rate image and
	an exposure map.
lc_pick	Selects lightcurves created for a given source and combines them in a single
	file. Either as individual tables combined by an Index (the default) or merged
	together to a single dataset. See Cookbooks of [1] and[3] for examples on
	practical usage.
og_create	Builds the OG from an index of prepared science window groups and observa-
	tion IDs, setting up the complete directory structure; see 6.1 for more details.
og_clean	This executable will clean an OG up to a certain level. To do that, it will erase
	the files from the disk.
	To work properly, the group should not have been used to build another OG
	or groups of higher level.
og_copy	Copies the OG.
q_identify_srcs	Compares sources found by the software with the catalog.
spe_pick	Combines the extracted spectra for a given source across multiple Science Win-
	dows. See Cookbooks of [1] and [3] for examples on practical usage.
src_collect	Combines source data obtained by the imaging analysis for individual Science
	Windows into a single table covering an Observation Group. It is possible to
	retrieve only selected results, e.g., just for a given source.
txt2idx	All DOLs contained in the ASCII list will be added to the index. See Cookbooks
	of [1] and [3] for examples on practical usage.

Table 7: List of generic tools (less often used part).

Name	Description
dal_append	Appends a data structure to a group.
dal_attach	Attaches up to 5 children elements to one DAL group.
dal_attr	Reads, writes or deletes attributes.
dal_attr_copy	Copies an attribute from a DOL to a DOL.
dal_clean	Clean out group tables and children.
dal_copy	Reorganizes group, localizing the given subgroup to a separate FITS file.
dal_detach	Detaches and, upon request, deletes data structures from a group. Data struc-
	tures are only detached (and deleted) when they do not contain any data struc-
	tures from the input object anymore. Data structures that should be deleted
	are deleted only if they are not claimed by another object.
dal_dump	Dumps one column of a FITS table to STDOUT or a log file.
dal_list	Lists all the children of DAL groups.
dal_grp_extract	Creates a new group in a separate FITS file, detaching all the children from
	the old group.
dal_sort	Sorts a table using one or more columns.
dal_verify	Performs simple verification of DAL groups.
ic2dol	Gets the DOLs of the selected element of the INDEX.
ic_find	Selects objects and sorts the rows in an INDEX of IC data.
idx_add	Adds an entry to the index.
idx_collect	Creates a subindex from an existing index using a selection expression based
	on the columns of the index. It is also possible to create a subindex of children
	of the input index which may be of a different data structure; the executable
	will decend into the child objects to find the correct structure specified by the
	output file template.
idx_find	Creates an index of the primary index elements conform to the given criteria.
	The resulting index can be sorted on a set of columns.
idx_merge	Merges two indices.
isdc_dircmp	Examines dir1 and dir2 and generates various tabulated information about
	the contents of the directories.