argmsin [ parameter=value ] [ outputfile ... ] argmsin [ parameter=value ] [ directory ]
Parameters are: tape_device, channel, delta_line, delta_sample, use_master, master_file, v_percent_start, v_percent_size, h_percent_start, h_percent_size, calibrate, byte_output, temperature, lut_range, assign_bad.
argmsin creates TeraScan datasets from GMS VISSR archive data. The dataset contains one, two-dimensional image from either infrared or visible sensors.
The archive data can be read from a tape or from a disk file.
The overall spatial subset of data to be extracted can be specified in one of two ways:
1) the smallest rectangular area required to cover a region defined by a master dataset (see master).
2) a rectangular area of a specified size, determined by its vertical (line) and horizontal (pixel) position on the full-disk image.
There are no input TeraScan datasets. The sources for input telemetry data are described above. Output is either to a user-supplied directory or a user-supplied dataset name. If a directory name is entered, output name will be generated and the file will reside in the specified directory. A name will automatically generate and look like: g#.yyddd.hhmm, where # is the GMS satellite number, yyddd is the year and julian date, and time.
Output data may optionally be calibrated. The visible data is calibrated from raw counts values (0-63) into percent albedo. The infrared data is from raw count values (0-255) into either radiance (W/cm,sr) or brightness temperature in degrees Celsius. The calibration is taken from the lookup tables stored in input datafile.
When calibrated, output datasets may be 1 or 2-byte data depending on the setting of byte_output.
See gmsin for more information on GMS satellite.
The name of the input tape device or disk file. Tape device names are machine-specific.
This must be a valid UNIX tape device name or existing disk file.
The channel to be extracted. Valid answers are ir for infrared and vis for visible.
The valid answers are ir and vis. There is no default.
The rate of image subsampling in vertical direction. The value 4 specifies that every fourth line will be used for the output.
The valid answers are [1 .. 32]. The default is 1.
The rate of image subsampling in horizontal direction. The value 4 specifies that every fourth pixel will be used for the output.
The valid answers are [1 .. 32]. The default is 1.
Answer yes if the data is to be selected from the intersection of a master dataset ( 1 in the description above - or see master). Answer no if subsets are to be specified by their position on the full-globe image ( 2 in description above).
Valid responses are [yes or no]. The default is yes.
Only if use_master=yes. The name of the master dataset used to specify a region for data extraction (See master).
Valid responses are any TeraScan dataset that contains an Earth transform. The default is Master.
Only if use_master=no. The percentage of the image to skip in the step direction (i.e top to bottom) before saving data. Thus if v_percent_start=50, the retrieved image will begin at middle of the Earth, and consist of data to the south of this starting line.
Valid responses are [0..100]. The default is 0.
Only if use_master=no. The percentage of the image to retrieve beyond the v_percent_start. Thus if v_percent_start=50 and v_percent_size=50 then the bottom half of the image will be retrieved.
Valid responses are [0..100-v_percent_start]. The default is 100-v_percent_start.
Only if use_master=no. The percentage of the image to skip in the scan direction (i.e left to right) before saving data. Thus if h_percent_start=50, the retrieved image will begin at middle of the Earth, and consist of data to the east of this starting pixel.
Valid responses are [0..100]. The default is 0.
Only if use_master=no. The percentage of the image to retrieve beyond the h_percent_start. Thus if h_percent_start=50 and h_percent_size=50 then the right (eastern) half of the image will be retrieved.
Valid responses are [0..100-v_percent_start]. The default is 100-v_percent_size.
Specifies whether the output datasets should be calibrated as described above.
Valid responses are [yes or no]. The default is yes.
Only if calibrate=yes. Specifies whether the output datasets should be 1- or 2-byte data.
Valid responses are [yes or no]. The default is yes.
Only if channel=ir and calibrate=yes. Specifies whether the output infrared data should be calibrated to brightness temperature or radiance.
Valid responses are [yes or no]. The default is yes.
Only if calibrate=yes. These two real values specify the valid range of values in a lookup table used for calibration.
Valid responses depend on the output data. If channel=vis, this range is [0 .. 100] percent albedo which is also the default. If channel=ir and temperature=yes, the range is [0 .. 500] Kelvins with the default of [170 .. 320]. If channel=ir and temperature=no, there is no default.
Only if calibrate=yes. Specify whether the calibration lookup table should be truncated, i.e. limited by lut_range values (no) or all values outside this range should be marked as the bad ones (yes).
Valid responses are [yes or no]. The default is no.
[1] % [1] % argmsin output file(s) : char(255) ? [.] tape_device : char(255) ? [/dev/nrht0] gms4_ir.adat channel : char( 3) ? ir delta_line : int ? [1] 8 delta_sample : int ? [1] 16 use_master : char( 3) ? [yes] n v_percent_start: real ? [0] v_percent_size : real ? [100] h_percent_start: real ? [0] h_percent_size : real ? [100] calibrate : char( 3) ? [yes] byte_output : char( 3) ? [yes] temperature : char( 3) ? [yes] lut_range : real( 2) ? [170 320] assign_bad : char( 3) ? [no] Writing ./g4.93221.0031::svissr_ir(temp_deg_c) [344 x 418] [2] % [2] % argmsin output file(s) : char(255) ? [.] tape_device : char(255) ? [/dev/nrht0] channel : char( 3) ? ir delta_line : int ? [1] 8 delta_sample : int ? [1] 16 use_master : char( 3) ? [yes] n v_percent_start: real ? [0] v_percent_size : real ? [100] h_percent_start: real ? [0] h_percent_size : real ? [100] calibrate : char( 3) ? [yes] n Writing ./g4.93221.0031::svissr_ir(raw_counts) [344 x 418] [3] % [3] % argmsin output file(s) : char(255) ? [.] tape_device : char(255) ? [/dev/nrht0] channel : char( 3) ? vis delta_line : int ? [1] 32 delta_sample : int ? [1] 32 use_master : char( 3) ? [yes] n v_percent_start: real ? [0] v_percent_size : real ? [100] h_percent_start: real ? [0] h_percent_size : real ? [100] calibrate : char( 3) ? [yes] byte_output : char( 3) ? [yes] lut_range : real( 2) ? [0 100] assign_bad : char( 3) ? [no] Writing ./g4.93213.0424::svissr_vis(albedo*100%) [344 x 418] [4] %
none
gmsin, datasets, etx, master, xcapcon.
1) Since archive data contains only one channel, the same output names can be generated for infrared and visible data with the same observation starting time. The names conflict can be avoided by saving infrared and visible data into different directories.
2) Lookup tables are saved to the output as albedo_lut, rad_lut, and temp_lut for albedo, radiance, and temperature respectively. They can be displayed from xvu.
3) For more detailed documentation on the GMS satellite, telemetries and the VISSR
sensor, see "The GMS User's Guide" 2nd Ed., Meteorlogical Satellite Center,
Tokyo, Japan. March, 1989.
Last Update: $Date: 1999/05/10 20:12:33 $