McIDAS-X User's Guide
Version 2024.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]


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.


[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]