McIDAS-X User's Guide
Version 2023.1

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

EU

Enhancement utility.

Formats

EU COLORS
EU DEL name
EU LIST string
EU MAKE inlo inhi bcolor ecolor bframe eframe [keywords]
EU MAKE inlo inhi 1lo 1hi 2lo 2hi 3lo 3hi bframe eframe [keywords]
EU REST name bframe eframe [keywords]
EU SAVE name
EU TABLE name [keywords]
EU CONV name img_type

Parameters

Keywords

Remarks

Parameters 1lo, 2lo, 3lo and 1hi, 2hi, 3hi are the intensities (0-255) of the three color components that make up the final color applied to the inlo and inhi input brightness values. The RGB keyword determines the order in which the three color components are specified:

• If RGB=YES is specified, then the color order is red, green, blue (1lo and 1hi are RED intensities, 2lo and 2hi are GREEN intensities, and 3lo and 3hi are BLUE intensities).
• If RGB=NO (the default), then the color order is blue, green, red (1lo and 1hi are BLUE intensities, 2lo and 2hi are GREEN intensities, and 3lo and 3hi are RED intensities).

Brightness values are only listed with EU TAB when they vary from the default table, i.e., brightness values 0 to 255 have intensities 0 to 255 for blue, green and red. For example, EU MAKE 20 120 20 120 20 120 20 120 lists nothing because the blue, green and red intensities have not altered the default range.

Occasionally, a brightness range will contain a value that will not need to change as the new values are assigned by command EB. In the example below, the data's brightness value of 104 happens to match the value assigned during the EB stretch. Since value 104 did not need to change, it becomes a breakpoint in the EU TABLE listing and is not shown on the output below. Command EB 62 164 2 250 produces the following output from EU TABLE.

Brightness      Blue        Green        Red
 min  max     min  max    min  max     min  max
 ---  ---     ---  ---    ---  ---     ---  ---
  62  103       2  102      2  102       2  102 
 105  164     107  250    107  250     107  250

Multipanel frames (created with the PANEL command) use a single color table. So when you apply an enhancement to a frame (with the EU or EB command), the enhancement is applied to all panels on the frame. That is, you cannot have EU or EB apply one enhancement to one panel, and a different enhancement to another panel.

However, you can simulate different enhancements on each panel by displaying the image on each panel with its own set of brightness values. To do so, use the SU command to make the stretch tables, then display the images using IMGDISP with the SU= and PAN= keywords to select the appropriate stretch table for each image/panel. Then use EU to create separate enhancements specifically for each panel so that only its colors change when the enhancement is applied.

For example, if you have a four-panel frame you can make four SU tables, each stretching a different ranges of brightness values with commands like these:
SU INI PAN1; SU MAKE PAN1 0 255 0 63
SU INI PAN2; SU MAKE PAN2 0 255 64 127
SU INI PAN3; SU MAKE PAN3 0 255 128 191
SU INI PAN4; SU MAKE PAN4 0 255 192 255
Then display the imagery with commands like IMGDISP dataset PAN=1 SU=PAN1, IMGDISP dataset PAN=2 SU=PAN2, etc. You can then use EU to make an enhancement table for each of the images/panels. Enhancements for brightnesses 0-63 (e.g., EU MAKE 0 63 BLUE PURPLE) will apply to panel 1, enhancements for brightnesses 64-127 will apply to panel 2, enhancements for brightnesses 128-191 will apply to panel 3, and enhancements for brightnesses 192-255 will apply to panel 4.

McIDAS-X 2017.2 was updated with a new expanded stretch option that displays more detail in images that match the satellite and band combinations in the file MCSTRETCH.TXT. Run command SEE MCSTRETCH.TXT to view the file and see Setting the Expanded Stretch Option for more information about the option, which increases the detail by using stretch tables to expand the range of data values over a larger range of 8-bit brightness values. The EU command's CONV option converts an existing enhancement table to use the new ranges so that when it's applied to an image displayed with the expanded stretch option, it maps the same image values to the same display colors/shades as it did without the expanded stretch. The CONV option makes a backup of the original enhancement table in NAME_OLD.ET. For example, command EU CONV SPECTRUM copies the current SPECTRUM.ET to SPECTRUM_OLD.ET then updates SPECTRUM.ET as described above.

See Also

Use command EB for interactive, mouse-controlled contrast stretching.

Examples

EU

This entry restores the default enhancement to the current frame.

EU LIST

This entry lists all the saved enhancement tables on the workstation.

EU LIST VAP

This entry lists all the saved enhancement tables beginning with VAP.

EU MAKE 20 75 255 255 0 0 255 255

This entry color enhances all image pixels with brightness values between 20 and 75 to solid magenta.

EU MAKE 100 200 RED YELLOW 1 3

This entry color enhances the image pixel brightness values between 100 and 200 on image frames 1 to 3 from red to yellow.

EU SAVE VAPOR

This entry saves the enhancement on the current frame to a file named VAPOR.

EU REST VAPOR LOOP=YES

This entry restores an enhancement called VAPOR to all frames defined in a loop.

EU TABLE

This entry lists the values of the current enhancement.

EU CONV VAPOR WV

This entry converts an enhancement table named VAPOR that was created and used in McIDAS-X version 2017.1 or earlier to apply the same enhancement (same image values mapped to the same display colors/shades) when a water vapor image is displayed in McIDAS-X 2017.2 or later using the expanded stretch option. A backup copy of the original enhancement table is saved in VAPOR_OLD.ET.

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