Image calibratiuon and conversion must be performed before a satellite image can be visualized using IVICS. The calibration conversion process consists of the following steps:
Decode and extract information from the original data file
Calibrate channel count values to brightness temperature or reflectance (albedo) scales
Convert to GSF file for use with IVICS
A set of programs which decode, calibrate, and convert to GSF format is provided. Programs prefixed with gsf_ are for creation and manipulation of GSF format files to be used with the IVICS visualization program.
Here is a description of the GSF calibration executable files in the bin directory:
Calibrates a NOAA AVHRR GAC LAC or HRPT level 1B file and writes it out as a GSF file
Usage: gsf_calibrate_avhrr [-i <level 1B input file>] [-o <GSF output file>] [-one_bye] [-two_bytes]
-i <level 1B input file>
-o <GSF output file name>
-one_byte (default) scale output channels to one byte precision
-two_bytes scale output channels to two byte precision
Note: works on data from NOAA 14 and before. Does not yet support NOAA 15 data.
Calibrates a 50 channel Modis Airborne Sensor hdf file and writes it out as a GSF file
Usage: gsf_calibrate_mas [-i <HDF level 1B input file>] [-o <GSF output file>] [-one_bye] [-two_bytes]
-i <HDF level 1B input file>
-o <GSF output file name>
-one_byte (default) scale output channels to one byte precision
-two_bytes scale output channels to two byte precision
Calibrates MODIS level 1b data at 1km, 500m or 250m (or any combination) resolution.
Usage: gsf_calibrate_modis [-i | -ib <HDF level 1B input file>] [-o <GSF output file name>]
[-one_byte] [-two_bytes] [-sc]
[-vis_one_byte] [-vis_two_bytes]
[-tir_one_byte] [-tir_two_bytes]
[-sc_one_byte] [-sc_two_bytes]
[-check_latlon]
[-full_res_only]
[-keep_all_res]
[-multi_res]
[-same_res]
[-save_temp]
[-overwrite]
-i <HDF level 1B input file> (must specify at least one)
-o <GSF output file name>
-ib <HDF level 1B input file> file to use for base resolution (default first -i file)
-one_byte scale all output channels to one byte precision
-two_bytes (default) scale all output channels to two byte precision
-vis_one_byte scale all output channels to one byte precision
-vis_two_bytes (default) scale all output channels to two byte precision
-tir_one_byte scale all output channels to one byte precision
-tir_two_bytes (default) scale all output channels to two byte precision
-sc or -sc_two_bytes include special difference and ratio channels (1km only)
in output scaled to two byte precision
-sc_one_byte include special channels in output scaled to one byte precision (1km only)
-check_latlon exit if too many lat/lons are invalid (currently 10)
-full_res_only only write full resolution bands to output file - i. e. do not write
500 m or 250 m degraded bands in 1km file (default for multiple input files)
-keep_all_res write all bands (even degraded) to output file (default for 1 input file)
-multi_res output channels are written as a composite multi-resolution GSF file (default)
-same_res all output channels are written at resolution of base GSF file
-save_temp save temporary files used to create multi-resolution or composite
-overwrite do not prompt for overwrite of existing output file
Calibrates a VIRS hdf file and writes it out as a GSF file
Usage: gsf_calibrate_virs [-i <HDF level 1B input file>] [-o <GSF output file>] [-one_bye] [-two_bytes]
-i <HDF level 1B input file>
-o <GSF output file name>
-one_byte (default) scale output channels to one byte precision
-two_bytes scale output channels to two byte precision
Calibrates an ASTER hdfeos file and writes it out as a GSF file.
Usage: gsf_calibrate_aster [-i <HDF level 1B input file>] [-o <GSF output file name>]
[-tir_one_byte] [-tir_two_bytes] [-sc]
[-sc_one_byte] [-sc_two_bytes]
[-15] or [-30] or [-90] or [-multi]
[-overwrite]
-i <HDF level 1B input file>
-o <GSF output file name>
-tir_one_byte (default) scale TIR output channels to one byte precision
-tir_two_bytes scale TIR output channels to two byte precision
-sc or -sc_two_bytes include special difference and ratio channels
in output scaled to two byte precision
-sc_one_byte include special channels in output scaled to one byte precision
User may select one of the following three spatial resolution options:
-15 output all channels at 15 m resolution
-30 (default)output all channels at 30 m resolution
-90 output all channels at 90 m resolution
-multi output all channels at native resolution into composite GSF file
note: base resolution is specified by -15 -30(default) or -90
-keep_temp keep temporary swir, vnir, and tir files (-multi only)
-overwrite do not prompt to overwrite output file(s)
Note: Unless -multi is specified, pixels are averaged to "degrade" channels to a lower spatial resolution. Pixels are duplicated to "upgrade" to higher resolutions.
Reads a CloudVis format file and writes it out as a GSF file
Usage: gsf_calibrate_cloudvis [-i <CloudVis input file>] [-o <GSF output file name>] [-c <CloudVisChannels filename>]
-i <CloudVis input file>
-o <GSF output file name>
-c <CloudVisChannels filename> specify this if you want to override the default file
Note: gsf_calibrate_cloudvis requires a setup file for configuration of the channels. You can edit the following file to change the channel configuration or default LUT and Colormaps for each channel:
<Wherever you installed ivics>/data/ivics/CloudVisChannels
The CloudVisChannels file contains documentation on the format for channel entries.
Note: This program currently only works on SGI.
Calibrates a set of GOES McIdas files and writes them out as a GSF file. Input files are assumed to be of the form:
prefix.vis.suffix = channel 1 file
prefix.ir2.suffix = channel 2 file
prefix.ir3.suffix = channel 3 file
prefix.ir4.suffix = channel 4 file
prefix.ir5suffix = channel 5 file
Usage: gsf_calibrate_goes [-ip <input file name prefix>] [-is <input file name suffix>] [-o <GSF output file>] [-one_bye] [-two_bytes]
-ip <input file name prefix>
-is <input file name suffix>
-o <GSF output file>
OR the following may be used to specify input files:
-1 <channel 1 filename>
-2 <channel 2 filename>
-3 <channel 3 filename>
-4 <channel 4 filename>
-5 <channel 5 filename (All GOES except 12)>
-6 <channel 6 filename (GOES 12)>
-one_byte (default) scale output channels to one byte precision
-two_bytes scale output channels to two byte precision
Calibrates a Landsat MSS or TM file and writes it out as a GSF file. Only NLAPS and GEOTIFF formats are currently supported. If GEOTIFF format is used, the NLAPS file header must also be present.
Usage: gsf_calibrate_landsat [-h <nlaps header file>] [-f <input file name list file>] [-o <GSF output file>] [-one_bye] [-two_bytes]
Required parameters:
-h <nlaps header file>
-o <GSF output file name>
Optional Parameters:
-f <input file name list file>
filenames are listed in band order in file
-nlaps (default) channels are NLAPS format
-tiff channels are GEOTIFF format
-one_byte (default) scale output channels to one byte precision
-two_bytes scale output channels to two byte precision
This program extracts the MODIS cloud mask product MOD035 and saves it as a GSF file.
Usage: gsf_mask_mod35 [-i <HDF MOD035 input file>] [-o <GSF output file name>]
[-overwrite]
Required parameters:
-i <HDF level 1B input file> (must specify at least one)
-o <GSF output file name>
Optional Parameters:
-overwrite do not prompt for overwrite of existing output file