ISIS Application Documentation
amicacal | Standard View | TOC | Home |
Calibrates Hayabusa 1 AMICA images
Description
Categories
Groups
History
Variable | Value |
B0 | 3.18x10E02 |
B1 | -4.12x10E-03 |
B2 | 2.00x10E-05 |
Variable | Value | Description |
Ioutput | The observed intensity of the input. | |
Iinput | 1000 DN - 3500 DN | The actual intensity of the input. |
c | 1-5.0x10E-08 | The power index of the output signal. |
L0 | -4.87x10E-11 | Linearity correction term determined empirically. |
L1 | 5.09x10E-03 | Correction for the nonlinearity around the saturation limit (Iinput > 3800 DN) |
Line | Sample | Dark Rate (DN/s) |
407 | 300 |
|
599 | 408 |
|
820 | 14 |
|
930 | 624 |
|
897 | 716 |
|
Variable | Description |
Ismear | The read-out smear. |
Iraw | The intensity of the raw data taken with exposure time texp. |
Isky | The sum of the bias and the dark current (~300 DN). |
tVCT | The vertical charge-transfer period (0.012288 microseconds). |
texp | The exposure time (in microseconds). |
Nv | The number of pixels along the V-direction (1024). |
H | The line number of the pixel. |
L | The sample number of the pixel. |
B | The binning number. |
Variable | Description |
R | The calibrated radiance (w/m2/sr/µm). |
Raw | The raw DN value. |
RadianceStandard | The standard conversion factor from DNs to radiance. |
RadianceScaleFactor | An adjustment factor for each filter. |
Variable | Description |
IoF | The calibrated radiance in units of I over F. |
R | The calibrated radiance (w/m2/sr/µm). |
Rs | The distance in Astronomical Units (AU) between the Sun and the target body. |
F | The solar flux (w/m2/µm) at 1 AU. |
If run on a non-spiceinited cube, this program requires access to local mission-specific SPICE kernels, in order to find the distance between the sun and the target body. When run on a spiceinited cube, this can be determined using the camera model. When run on a non-spiceinited cube, amicacal must have access to Hayabusa's spacecraft clock kernel (SCLK) and several position kernels (SPKs) to run. Using a spiceinited cube as input has the advantage of not requiring that local mission-specific kernels be available. (See spiceinit web=true.)
Name | Description |
---|---|
FROM | Input cube |
TO | Corrected Output cube |
CONFIG | Input AMICA calibration config file |
Name | Description |
---|---|
NULLPOLARPIX | Set polarized pixels to ISIS::Null. |
UNITS | Convert to specified output calibrated units. |
This is the ISIS cube to be calibrated.
Type | cube |
---|---|
File Mode | input |
Filter | *.cub |
This is the output file. The output cube will be a calibrated version of the input cube.
Type | cube |
---|---|
File Mode | output |
Pixel Type | real |
Filter | *.cub |
This is the PVL file containing the input configuration parameters for the amicacal program. Users can modify the parameters as needed.
Type | filename |
---|---|
File Mode | input |
Default | $hayabusa/calibration/amica/amicaCalibration????.trn |
Filter | *.trn |
Four position angle glass polarizers (of dimension 200 x 200 pixels each) are attached to the upper left of the CCD chip. This option sets those pixels to Null in the calibrated image by default.
Type | boolean |
---|---|
Default | True |
Type | string | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | IOF | |||||||||||||||
Option List: |
|
Kris Becker | 2016-01-24 | Original version |
Tyler Wilson | 2016-07-08 | Added calibration correction routines for linearity, PSF, smear removal for binned and unbinned images, and converting to I/F units. Also added hot pixel removal. Updated the application documentation. Added routines for converting a single-band ISIS cube to an OpenCV::OpenMat matrix and vice versa for the purpose of translating and scaling flat-field images so their dimensions match some AMICA images which have been cropped. Fixes #3880. |
Kris Becker | 2016-08-25 | Determined the LOSSY compression images must be scaled by a factor of 16 to match the LOSSLESS mode for proper calibration. Added the UNIT option to specify output calibration units as DN, RADIANCE or I/F. This parameter replaces the IOF parameter. Added option to allow user to determine to apply PSF correction. Added CONFIG parameter that user can provide a version of the calibration parameters to apply in amicacal. |
Tyler Wilson | 2016-11-02 | Added the "APPLYSMEAR" option which will force the smear correction calibration to be applied, and a new test for smear correction. The default is for this option to not be applied except in the case where an image is being processed for which on-board smear correction was not applied. Also made the applyPSF boolean parameter into a global variable for consistency with the applySmear global variable. |
Kristin Berry | 2017-02-07 | Removed the "APPLYSMEAR" option as a user-specifiable parameter. The smear correction will still be applied automatically when an image is being processed for which on-board smear correction was not applied (NSUB <= 1). Also updated application code for conformity with ISIS3 Coding Standards. Backward Compatibility Issue: The APPLYSMEAR parameter was removed. The smear correction will automatically be applied to images with 1 sub-image. |
Kristin Berry | 2017-02-08 | Removed the "PSF" correction option, since the PSF correction is not yet working. Related code has been commented out rather than removed entirely so that this work can potentially be resumed at a later date. Backward Compatibility Issue: The PSF parameter was removed since it is not yet working. The amicacal program cannot apply a PSF correction anymore. |
Jeannie Backer | 2017-11-28 | Updated radiance calibration to divide by exposure duration, as done with reflectance. Updated amicaCalibration????.trn file with latest radiance scale factor for zs (value provided by L. Le Corre, PSI). Updated to use filter V solar flux on all calculations. Brought code closer to ISIS3 coding standards. Fixes #5243 |
Lucille Le Corre | 2018-01-30 | Added DN/S as an output option. Apply dark current current as it was disabled in earlier versions. |
Kaitlyn Lee | 2021-02-24 | Added ability to get the sun distance from the camera. |