tagcams2isis

This program will import FITS (Flexible Image Transport System) formatted files from the OSIRIS-REx TAGCAMS instrument suite, NavCam, NFTCam and StowCam, into the ISIS3 cube format.

The instruments use an Aptina MT9P031 1/2.5 inch 5MP Digital Image Sensor where the pixel array consists of a 2752-column by 2004-row matrix of pixels. The manufacturer sets the physical origin of 0, 0 in the upper right corner of the entire array. The active array region consists of 2592-columns and 1944-rows. The NAV team will typicall acquire all pixels in the pixel array (i.e., 2752x2004) during operations. Reference [4] describes the pixel array and details on operations and image acquisition. Note that this application will result in the proper image orientation consistent with the Kinetx system in the output ISIS cube image. The pixel (1,1) at the upper left the ISIS cube is consistent with the Kinetx system.

All three instrument files can be imported by tagcams2isis but the StowCam is not properly converted to 3-color band cube. All instrument data will typically contain boundary data around the borders of the image. These data are comprised of dark pixels and several rows/columns of active boundary pixels to minimize edge effects. These boundary pixels would be removed by calibration processes, but at this time, there is no plan to implement radiometric calibration. As such, the default behaviour is to remove all boundary pixel data. See the REMOVECALPIXELS parameter.

References

1) Bos, Brent, et al. (2018). Touch And Go Camera System (TAGCAMS) for the OSIRIS-REx Asteroid Sample Return Mission. Space Science Reviews. 214. 10.1007/s11214-017-0465-2.

2) Crombie, K, et al. (2017) OSIRIS-REx Touch-and-Go Camera Suite (TAGCAMS) Data Product Software Interface Specification, UA-SIS-9.4.4-322, Rev. 3.0 (03/09/2017)

3) Caplinger, M., et al. (2016) TAGCAMS Users Guide MSSS-TAG-REQ-4401 Final, Malin Space Science Systems, Inc.

4) Aptina Imaging Corporation. (2005) 1/2.5-Inch 5Mp CMOS Digital Image Sensor (MT9P031), https://www.mouser.com/pdfdocs/Leopard_Imaging_Aptina_931LI5M03.pdf

Description

Use this parameter to select the filename of an OSIRIS-REx TAGCAMS file to be converted to an ISIS cube. This is expected to be a FITS formatted file.

Type	filename
File Mode	input
Filter	*.fits

Description

The output cube file that will contain the OSIRIS-REx TAGCAMS image in ISIS format.

Type	cube
File Mode	output
Filter	*.cub

Description

This parameter allows users to remove the boundary calibration pixels from the input image. Raw TAGVCAMS frames will have 2752 samples and 2004 lines. The active region of the image is 2592 samples and 1944 lines.

The border region of TAGCAMS images has 50 dark and 4 boundary pixels (54 total) at the top of the image. The bottom has 2 dark and 4 boundary pixels (6 total). The left side of the image has 134 dark and 10 bounary pixels (144 total). The right side of the imagehas 10 dark and 6 boundary pixels (16 total). All of these pixels will be removed if this parameter is set to TRUE/YES.

The OSIRIS-REx mission provides the TAGCAMs images in raw form so these boundaries are generally present in these images. Due to the lack of a calibration application in ISIS3, it is recommended these pixels be removed on import so that they are conveniently excluded for subsequent processing. For this reason, the default is (TRUE) to remove these pixels.

Type	boolean
Default	True

Description

This parameter may be necessary as some FITS labels do not adequately defined the TARGET keyword in the labels. OSIRIS-REx takes a very long trip to finally arrive at Bennu orbit in 2018. During cruise, several flybys occur. The proper specification of the TARGET is critical to valid instantiation of ISIS camera models.

Type	string
Internal Default	Label Value