NAME

mitsim2fits - Convert from MIT (simulated events lists) from arv format to an ACIS level 0 format. This program was previously named arv2fits.

SYNOPSIS

  mitsim2fits 
    --ccdid the_ccd_id
    --detname | -D name_of_detector 
    [ --datamode | -d the_FITS_DATAMODE_keyword (default: FAINT) ]
    [ --date-end | the_ending_date_of_observation (default: today's date) ]
    [ --date-obs | the_begin_date_of_observation (default: today's date) ]
    [ --filter | -f filter_used (default: NONE) ]
    [ --grating | -g grating_used (default: NONE) ]
    [ --help | -h ]
    [ --input | -i the_input_filename ]
    [ --mission | -m the_mission_name (CHANDRA) ]
    [ --output | -o the_output_filename ]
    [ --readmode | -r the_FITS_READMODE_keyword (default: TIMED) ]
    [ --src_spec | -s the_FITS_SRC_SPEC_keyword (default: MONO) ]
    [ --telescope | -t the_name_of_the_telescope (default:CHANDRA) ]
    [ --time-end the_end_time_of_observation (default: current time) ]
    [ --time-obs the_begin_time_of_observation (default: current time) ]
    [ --version | -v ]

DESCRIPTION

The program converts an ARV format to an ACIS FITS level 0 format. The ARV format is a C-struct with the following definition:


                struct ARV {
                  short nframe;
                  short exposure;
                  long acistime;
                  short nodenum,x,y,data[9];
                 }


Each row of the Fits Row to be output is defined as:


                struct AcisFits {
                  short ccd_id;
                  short chipx, chipy;
                  short phas[ 9 ];
                  long expno;
                  double time;
                }


Where the transformations from ARV to FITS are given below:


        ccd_id = comand_line_option( "ccdid" );
        chipx  = x;
        chipy  = y;
        expno  = nframe;
        time   = double( acistime );
        for ( int ii = 0; ii < 9; ++ii )
          phas[ i ] = data[ i ];

OPTIONS

Options may be abbreviated. Options which take values may be separated from their values either by white space.

The options are :

--ccdid integer

The CCD_ID column in the fits file. The ccdid keyword is required. For example, to set the ccdid to 3:

 mitsim2fits --detname ACIS-3 --ccdid 3 < foo.arv > foo.fits

--detname string

The name of the detector. This argument is required. For example, to set the detname to ACIS-3:

 mitsim2fits --detname ACIS-3 --ccdid 3 < foo.arv > foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 < foo.arv > foo.fits

--datamode string

The FITS datamode keyword. The datamode keyword is optional, its default value is FAINT. For example, to set the datamode as NOTFAINT:

 mitsim2fits --detname ACIS-3 --ccdid 3 --datamode NOTFAINT < foo.arv > foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 -d NOTFAINT < foo.arv >  foo.fits

--date-end string

The ending date of observation, format is of the form YYYY-MM-DD. The default value is today's date. For example, to set the ending date of observation as Oct 9, 2001:

 mitsim2fits --detname ACIS-3 --ccdid 3 --date-end 2001-10-09 < foo.arv > foo.fits

--date-obs string

The beginning date of observation, format is of the form YYYY-MM-DD. The default value is today's date. For example, to set the starting date of observation as Oct 9, 2001:

 mitsim2fits --detname ACIS-3 --ccdid 3 --date-obs 2001-10-09 < foo.arv > foo.fits

--filter string

The type of filter used. The default value is NONE. For example, to set the filter as junk:

 mitsim2fits --detname ACIS-3 --ccdid 3 --filter junk < foo.arv > foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 -f junk < foo.arv >  foo.fits

--grating string

The grating used. The default value is NONE. For example, to set the grating as junk:

 mitsim2fits --detname ACIS-3 --ccdid 3 --grating junk < foo.arv > foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 -g junk < foo.arv >  foo.fits

--input string

The input ARV filename. The default value is stdin. For example, to set the input file as foo.arf

 mitsim2fits --detname ACIS-3 --ccdid 3 --input foo.arv --output foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 -i foo.arv -o foo.fits

--mission string

The name of the mission. The default value is CHANDRA. For example, to set the name of the mission to AXAF:

 mitsim2fits --detname ACIS-3 --ccdid 3 --mission AXAF < foo.arv > foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 -m AXAF < foo.arv >  foo.fits

--output string

The output FITS filename. The default value is stdout. For example:

 mitsim2fits --detname ACIS-3 --ccdid 3 --input foo.arv --output foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 -i foo.arv -o foo.fits

--readmode string

The FITS readmode keyword. The readmode keyword is optional, its default value is TIMED. For example, to set the readmode as NOTTIMED

 mitsim2fits --detname ACIS-3 --ccdid 3 --readmode NOTTIMED < foo.arv > foo.fits

 mitsim2fits -D ACIS-3 --ccdid 3 -r NOTTIMED < foo.arv >  foo.fits

--src_spec string

The FITS src_spec keyword. The src_spec keyword is optional, its default value is TIMED. For example, to set the src_spec to MONO:

 mitsim2fits --detname ACIS-3 --ccdid 3 --src_spec MONO < foo.arv >  foo.fits

 mitsim2fits --detname ACIS-3 --ccdid 3 -s MONO < foo.arv >  foo.fits

--telescope string

The name of the telescope, the default value is CHANDRA. For example to set the value to AXAF:

 mitsim2fits --detname ACIS-3 --ccdid 3 --telescope AXAF < foo.arv > foo.fits

 mitsim2fits --detname ACIS-3 --ccdid 3 -t AXAF < foo.arv > foo.fits

--time-end string

The ending time of observation, format is of the form HH:MM:SS. The default value is 12:59:59. For example, to set the end time of observation as 04:04:00

 mitsim2fits --detname ACIS-3 --ccdid 3 --time-end 04:04:00 < foo.arv > foo.fits

--time-obs string

The beginning time of observation, format is of the form HH:MM:SS. The default value is 00:00:01. For example, to set the begin time of observation as 03:04:00

 mitsim2fits --detname ACIS-3 --ccdid 3 --time-obs 03:04:00 < foo.arv > foo.fits

--usage

To see a detailed instructions on how to use this program. For example:

 mitsim2fits --usage

--version

Print the program version number.

For example:

 mitsim2fits --version

 mitsim2fits -v