IBIS: IRSKY Batch Inquiry System

IBIS is an electronic mail, batch version of IRSKY, the tool primarily intended for planning infrared observations. IBIS will compute the infrared sky background and confusion noise for targets using parameters and positions from the input file that it receives. An estimate of the COBE* flux will be computed. IBIS will also search the IRAS Point Source and Faint Source Catalogs, as well as the Hubble Space Telescope Guide Star Catalog and ISO Observations List for sources in a given area. IBIS will send e-mail directly back to the requester with the results.

* The COBE datasets were developed by the NASA Goddard Space Flight Center under the guidance of the COBE Science Working Group and were provided by the NSSDC. As a user of IBIS, your comments and suggestions will be appreciated. Comments and problem reports should be made to the IRSKY team. < irsky-help@ipac.caltech.edu >

When submitting to the processor via e-mail, it is recommended that the number of target positions be limited to 30-35 to avoid problems with overloading mail queues on some systems. Output for each source takes about a page.

Submitting Processing Requests:

Use Internet Email to send formatted requests to
    ibis@ipac.caltech.edu
Responses will be mailed back to the sender of the request - make sure your e-mail is sent with a correct and interpretable return address!

Input Format:

Sample input for the IBIS processor is available if you'd like an example. The format of the input message is important. The input processing parameters are given by specifying a keyword followed by a blank space, and then a value. For example, the line

			flux_units MJy/Sr
would tell IBIS to use MJy/Sr for the output flux units.

Here is the list of keywords to be specified:

aperture
Observing aperture size. The default is 2.0e-8. Example:
		aperture  1.7e-7 
aperture_units
Units for the aperture size. Options are: steradian (default), arcmin^2, and arcsec^2. Example:
		aperture_units  arcmin^2 
reference_offset
Offset of the reference beam (used by cirrus confusion calculator) given as the ratio offset : aperture diameter Example:
		reference_offset 3 
flux_units
Units for reporting output flux values. Options are: MJy/sr, Jy/arcmin^2, mJy/arcsec^2, or Jy/aperture. Example:
		flux_units Jy/aperture
do_xxxxx yes/no
Processors to be run. Options for "xxx" are: bkgnd (for background estimator), cirrus (for cirrus confusion), galaxy (for galaxy confusion). (Default action: yes) Example:
		do_galaxy  yes   
search_xxx yes/no
Catalogs to be searched. Options for "xxx" are: psc (IRAS Point Source Catalog), fsc (IRAS Faint Source Catalog), gsc (Hubble Guide Star Catalog), or iso (ISO Observations). (Default action: no) Example:
		search_gsc  yes   
xxx_radius N
Radius for catalog search. Options for "xxx" are: psc (IRAS Point Source Catalog), fsc (IRAS Faint Source Catalog), gsc (Hubble Guide Star Catalog), or iso (ISO Observations). Value for "N" should be given in arcminutes, up to 30. If not specified, "N" will default to 30. Any value over 30 will be set to 30. Example:
		gsc_radius  15  
gsc_mag N
Magnitude cutoff for Hubble GSC Catalog searches. Example:
		gsc_mag 10  
input_coordinates xxx
Specify a coordinate system for input positions. Options for "xxx" are: Equatorial, Galactic, Ecliptic. Example:
		input_coordinates Ecliptic 
input_equinox xxx
Specify an equinox for the input coordinates. Options for "xxx"are: J2000 or B1950. If not specified, "xxx" will default to B1950. Example:
		input_equinox J2000 
wavelength yy z xxx
Specify the wavelengths ( yy, z and xxx) of interest, in microns. Up to 25 different wavelengths can be specified. Example:
		wavelength 22 8 100 
x y
Specify the input target position. In the following examples, if the position is given as shown in the left column, the interpretation is in the right column. Any of them are legal input. In some cases of ambiguous input, the output may not be what you intend, so the interpreter returns a warning message before returning its interpretation, for your information.
		
16.3678		16 hr 22 min 04.08 sec (if in "longitude" 
				field with equatorial RA set) 
		or
                16.3678 degrees (otherwise)                                  
                                                                              
16		16 hr (if in "longitude" field 
			with equatorial RA set) 
		or    
                16.0 degrees (otherwise)                                     
                                                                              
6h3m23s		06 hr 03 min 23 sec                                          

26h7m23s	02 hr 07 min 23 sec (where 02 hr = 26 - 24)                  
                                                                              
79d23m90s	+79 deg 24 min 30 sec (with warning message)                 
                                                                              

20d9'50"	+20 deg 09 min 50 sec                                        
                                                                              
20:9:50		20 hr 09 min 50 sec (if in "longitude" 
				field with equatorial RA set)
		or
                20.16388 (otherwise, with warning message)                   
                                                                              

20:9            20 hr 09 min of time (if in "longitude"
                                field with equatorial RA set)
                or
                20.15 deg (if in "longitude" field,
                              with warning message)
                or
                20 deg 09 min  (if in "latitude" field)

With any of the above keywords, if accepting the default, there is no need to enter the keyword and value.

After all the keyword values have been defined, the longitude and latitude positions are specified for all the targets to be processed with those parameters.

Input lines are processed in order so it is possible to change parameters between sources. In the sample files, the first source position is given in galactic coordinates, then the input_coordinates are changed to equatorial and the second source position is given in the new coordinate system, like so:

		input_coordinates  Galactic
		36.62706d  53.02687d
		input_coordinates  Equatorial
		5h32m20.11s -5d02m59.2s

Any of the input parameters may be changed. They effect the IBIS execution when they are encountered in the file, for all subsequent target positions.

Comments can be included in the input file -- just begin the comment with a pound sign (#). Blank lines are treated as comments.

Processing:

Output Format:

Sample output for the IBIS processor is available if you'd like an example. Input lines are echoed to the output, and begin with "> ".

Output lines that begin with # are commentary;

Output lines that begin with a space, contain source specific information or derived information;

Output lines that begin with ! are warnings.

Output for each source begins with the lines:

#*********************************************************
  Source Number: 1
and ends with
  Done Number: 1
#*********************************************************
Warning messages appear with exclamation marks in the first column.

Output Contents:

See Also:


R. Booth Hartley - Infrared Processing and Analysis Center

Last updated 19-February-1999