PRDUTIL

Calibration utility for 1-byte PRD image files

Formats

PRDUTIL ADD dataset num type prodlo prodhi britlo brithi unit scale miss
PRDUTIL DEL dataset num type
PRDUTIL LIST dataset

Parameters:

ADD	adds or changes a calibration block segment
DEL	deletes a calibration block segment by number and type
LIST	lists calibration block segments
dataset	ADDE image dataset name; the dataset must be local (i.e., it cannot be on a remote server) and it must be specified as group/descriptor.position or alias.position
num	calibration block segment number (1-12) to add, change or delete
type	1- to 4-character name of the product defined by the segment, e.g., P, RH, TEMP (default=PROD)
prodlo	minimum output product value (default=0)
prodhi	maximum output product value (default=255)
britlo	input brightness value assigned to prodlo (default=0)
brithi	input brightness value assigned to prodhi (default=255)
unit	1- to 4- character name of the units for the product value defined by the segment, e.g., F, MB, %
scale	divisor to apply to the product values when they are accessed by another application, e.g., D or IMGPROBE; thus output_value=product_value/scale (default=0, meaning no scaling)
miss	missing value code to assign to the product when a brightness value is outside the range defined with britlo and brithi; use decimal value -2139062144 for HEX80 (default=0)

Remarks:

Use PRDUTIL to list, add, and delete calibration block segments for a 1-byte PRD image (e.g., an image created with GRDIMG, IMGFILT or IMGOPER commands). Up to 12 segments can be defined using PRDUTIL. Multiple segments can be used to define a single product (type). For example, segments 2 through 6 can define the product values, corresponding brightness values, product units, scale factors and missing value codes for a product named RH while segment 7 can define the settings for a product named MIX.

Examples:

PRDUTIL LIST LOCAL/AREA.4205

This entry lists the calibration block segments for the image in position 4205 in the dataset LOCAL/AREA.

PRDUTIL DEL LOCAL/AREA.2 1 RH

This entry deletes calibration block segment number 1 from the image in position 2 in the dataset LOCAL/AREA. The segment type must be RH; otherwise, the segment is not deleted.

PRDUTIL ADD A/A.4205 6 RH 0 100 0 255 %

This entry adds or changes (if previously defined) calibration segment number 6 for the image in position 4205 in the dataset A/A. The product value is named RH with units %, and has a range of 0 through 100 that maps to image brightness values 0 through 255.

PRDUTIL ADD LOCAL/RAIN.20 1 PCP 0 200 194 255 IN 100

This entry adds or changes (if previously defined) calibration segment number 1 for the image in position 20 in the dataset LOCAL/RAIN. The product value is named PCP with units IN, and has a range of 0 through 200 that maps to image brightness values 194 through 255. The scale value of 100 means that the product values will be divided by 100 when accessed by another application, such as IMGPROBE.