SU

Image data stretching utility.

Formats

SU INI name type unit [keywords]
SU MAKE name inlo inhi blo bhi
SU LIST string
SU TABLE name

Parameters

INI	initializes the stretch table defining the type of calibration, calibration units and initial breakpoint settings; must be used when making a new stretch table
MAKE	enters breakpoints in the table using brightness levels
LIST	lists the saved stretch tables (default=lists all stretch tables on the workstation)
TABLE	lists the breakpoints stored in a stretch table
name	name of the stretch table; eight alphanumeric characters maximum
string	lists the stretch tables beginning with this character string
type	AAA	uses 2-byte GOES data calibration for the input table
	GMS	uses GMS data calibration
	GVAR	uses 2-byte GVAR calibration
	MSAT	uses METEOSAT data calibration
	QTIR	uses POES data quick calibration
	TIRO	uses POES data calibration
	VAS	uses 2-byte GOES data calibration (for pre-1987 data only)
	VISR	uses 1-byte GOES data calibration
	WSI	uses WSI radar data calibration
	(default=use on any calibration type)
unit	RAW	raw data calibration units of the input data
	BRIT	brightness (default)
	RAD	radiance
	ALB	albedo
	TEMP	temperature
	user-defined	user-defined units; use IMGPROBE to list the available units for an image
inlo	low value of the breakpoint for input values; specify in units input with the unit parameter (no default)
inhi	high value of the breakpoint for input values; specify in units input with the unit parameter (no default)
blo	low value of the breakpoint for output brightness values; the range is 0 to 255 (no default)
bhi	high value of the breakpoint for output brightness values; the range is 0 to 255 (no default)

Keywords

BAND=	band number for the input data calibration type (default=ALL)
RANGE=	min max	minimum and maximum values of the input data; these values define the boundary of input values that can later be stretched; the range is 0 to 255

Remarks

Use command SU to make the tables specified with keyword SU in the IMGDISP command. SU sets the tables to stretch raw, radiance, temperature, albedo or brightness values (depending on calibration) to a user-defined brightness value. Then you can use command EU to color the brightness ranges corresponding to the new values.

If you specify keyword RANGE, all input values less than or equal to min are assigned an output value of zero; all input values greater than or equal to max are assigned an output value of 255.

Any additional breakpoints specified with the MAKE option that fall outside of min and max are assigned 0 or 255, accordingly. If you don't specify RANGE, the stretches' slope previous to the first breakpoint is a continuation of the line formed by the first two breakpoints. Likewise, the slope following the last breakpoint is a continuation of the line formed by the last two breakpoints.

Examples

SU LIST

This entry lists all stretch tables saved on the workstation.

SU INI TIRORAD3 TIRO RAD BAND=3

This entry initializes table TIRORAD3 for use on the radiance values of TIROS band 3 images. Each new stretch table must be initialized.

SU MAKE TIRORAD3 0 1.2 20 220

This entry sets the breakpoint values in the above table TIRORAD3. Input 0 corresponds to output 20; input 1.2 corresponds to output 220.

SU TABLE TIRORAD3

This entry lists the breakpoints in table TIRORAD3 and information on BAND, calibration type and units.

SU INI MSATEMP1 MSAT TEMP BAND=1

This entry initializes the table MSATEMP1 to contain breakpoints in temperature for Meteosat band 1 data.

SU MAKE MSATEMP1 240 260 20 240

This entry stretches the temperature values from 240 to 260 in table MSATEMP1, over brightness values 20 to 240.

SU INI GENBRIT X BRIT RANGE=100 200

This entry initializes the table GENBRIT to be used on any calibration type with brightness units. The brightness values from 100 to 200 are stretched to brightness values 0 to 255. Brightness values entered with SU MAKE that are less than 100 or over 200 are assigned 0 or 255, respectively.

SU LIST GEN

This entry lists all the saved stretch tables that begin with GEN.

Contact Us • Site Map • Search • Terms and Conditions • Privacy Policy • Participation Policy

Unidata is a member of the UCAR Office of Programs, is managed by the University Corporation for Atmospheric Research, and is sponsored by the National Science Foundation.

P.O. Box 3000 • Boulder, CO 80307-3000 USA • Tel: 303-497-8643 • Fax: 303-497-8690