RGBDISP

Displays a color image using three frames or datasets as RGB components.

Format

RGBDISP red green blue frame [keywords]
RGBDISP rgb_dataset frame [keywords]

Parameters

red green blue	red, green and blue inputs, respectively, to use for the output color image; specify the values as either three image frame numbers or as three ADDE datasets in alias.position or group/descriptor.position format; see the Remarks (no default for frame numbers or ADDE dataset names, default=0 for ADDE dataset position)
rgb_dataset	single ADDE dataset to use as the red, green and blue inputs for the output color image; specify the dataset as alias.position or group/descriptor.position (no default for alias or group/descriptor, default=0 for position)
frame	destination frame to display the output color image (default=current frame)

Keywords

BANd=	red green blue		band number to use for the image(s) specified in the red, green and blue datasets (default=existing band for single-band images; no default for multiband images)
DAY=	day of the image(s) to select in the red, green and blue datasets
ECHo=	YES	show the IMGDISP commands that are run by RGBDISP (default=NO)
LATlon=	red green blue		latitude and longitude of the image(s) specified in the red, green and blue datasets to place at the frame location specified in the PLACE= keyword; see the Remarks for how to specify the values
LINele=	red green blue sys		line and element of the image(s) specified in the red, green and blue datasets to place at the frame location specified in the PLACE= keyword; sys is the coordinate system of the line and element values - either F for file, or I for image coordinates (no default for red, green, blue; sys default=F); see the Remarks for how to specify the values
MAG=	red green blue		line and element magnifications to use for the image(s) specified in the red, green and blue datasets and BAND= keyword; specify each of the three values as either an unquoted single number or a quoted pair of numbers; see the Remarks (default=1 red red)
PLAce=	location on the frame to place the point(s) specified in the LATLON, STATION or LINELE keyword; valid options are ULEFT and CENTER for upper-left corner & center of the frame, respectively (default=ULEFT when LINELE is used; default=CENTER when LATLON or STATION is used)
STAtion=	station ID to place at the image location specified in the PLACE keyword; specify as the ID, e.g., KMSN or YSSY, optionally followed by station type in brackets, e.g., ARX[N] or ARX[V]; see the TYPE keyword in STNLIST command for details
TIMe=	btime etime	time of the image(s) to select in the red, green and blue datasets; if a btime etime range is specified and multiple images are within the range, the latest image is displayed (btime default=none; etime default=btime)

Remarks

The RGBDISP command uses the brightness (BRIT) values of the three input frames or datasets to calculate the red, green and blue components, respectively, of the output color image that is displayed in the frame parameter. RGBDISP works only with single-panel frames, so should not be used with multipanel frames.

The BAND=, DAY=, LATLON=, LINELE=, MAG=, PLACE=, STATION= and TIME= keywords are used only when specifying ADDE datasets, not frame numbers, for the three inputs (red, green and blue parameters or rgb_dataset parameter).

When using the red green blue frame command format (with either frame numbers or datasets), you can exclude one of the three inputs from the analysis so the output color image is created using only two input images. To do so, specify a 0 (zero) for the corresponding input (red, green or blue parameter) you want to exclude. For example, RGBDISP 0 5 6 10 displays an output color image in frame 10 that was created using only the image displayed frame 5 for its green component and the image displayed in frame 6 for its blue component. If you are also using the BAND=, LATLON=, LINELE= or MAG= keyword(s), specify an X as a placeholder in the positional parameter(s) of the input you are excluding. For example, RGBDISP GOES16/M1 0 GOES16/M1 21 BAND=11 X 15 displays an output color image in frame 21 that was created using only the GOES16/M1 band 11 image for its red component and GOES16/M1 band 15 for its blue component.

The LATlon= and LINele= keywords specify the latitude/longitude or line/element position of the image(s) specified in the red, green and blue datasets to place at the frame location specified in the PLACE= keyword. To use the same position for all three images, specify a single pair of numbers. To use different positions for two or all three images, specify three pairs of numbers (six total). In both cases, single quotes surrounding the pair(s) of numbers is optional. The two examples below both specify lat/lon coordinate 45,80 for all three images.
      LATLON=45 80
      LATLON='45 80'
The two examples below both specify lat/lon coordinates 30.1,95.1 for the first image, 30.0,95.0 for the second, and 29.9,94.9 for the third.
      LATLON=30.1 95.1 30.0 95.0 29.9 94.9
      LATLON='30.1 95.1' '30.0 95.0' '29.9 94.9'
The two examples below both specify file coordinates 1000,2000 for all three images.
      LINELE=1000 2000 F
      LINELE='1000 2000' F
The two examples below both specify image coordinates 1000,2000 for the first image, 1500,3000 for the second, and 1000,2000 for the third.
      LINELE=1000 2000 1500 3000 1000 2000 I
      LINELE='1000 2000' '1500 3000' '1000 2000' I

The MAG=red green blue keyword specifies the line and element magnifications to use for the images specified in the red, green and blue datasets (or rgb_dataset) and BAND= keyword. Specify each of the three values as either an unquoted single number (if the line and element magnification values are the same) or a quoted pair of numbers (if they are different). If just one or two values are specified, they are used for the red input and are also the default for the green and blue inputs. You must specify values for all three images or just the first image. Examples:

   MAG=2              2x2 blowup of all three images
   MAG=-2             2x2 blowdown of all three images
   MAG=2 3            2x3 blowup of all three images
   MAG='2 3'          2x3 blowup of all three images
   MAG=1 -3           1x3 blowdown of all three images
   MAG=2 4 2          2x2 blowup of 1st, 4x4 blowup of 2nd, 2x2 blowup of 3rd
   MAG=2 '2 3' 2      2x2 blowup of 1st, 2x3 blowup of 2nd, 2x2 blowup of 3rd
   MAG='2 3' 2 '3 2'  2x3 blowup of 1st, 2x2 blowup of 2nd, 3x2 blowup of 3rd
   MAG='2 3' '1 -2' '1 -2'    2x3 blowup of 1st, 1x2 blowdown of 2nd and 3rd

If RGBDISP's output image is not what you expect (e.g., colors are missing or incorrect), you may be able to correct it by changing the visual mode / Pseudocolor settings in your X server configuration or by enabling (uncommenting) the -displayVisualMode flag in the $HOME/.mcidasrc file. As noted in the .mcidasrc file, setting the flag may also result in a slowdown in commands that write image or graphic output.

Examples:

RGBDISP 3 2 1 4

This entry displays a color image in frame 4 that is created by using the brightness (BRIT) values of the images displayed in frames 3, 2 and 1 for its red, green and blue components, respectively.

RGBDISP GOES16/FD 1 DAY=2018107 TIME=17:45 17:46 BAND=3 2 1 MAG=-12 -24 -12

This entry displays a color image in frame 1 that is created using three bands of the image in the GOES16/FD dataset with day 2018107 and time between 17:45 and 17:46 UTC. The band 3, 2 and 1 brightness data are used for the output image's red, green and blue components, respectively. The -24 value specified for band 2 in MAG= is twice that of the other bands because of it being 2x higher resolution (0.5 km for band 2 versus 1.0 km for bands 3 and 1).

RGBDISP HIMAWARI/FD 10 DAY=#Y TIME=02:00 BAND=3 2 1 MAG=-12 -6 -6 STA=YSSY

This entry displays a color image in frame 10 that is created using three bands of today's 02:00 UTC image in the HIMAWARI/FD dataset. The band 3, 2 and 1 brightness data are used for the output image's red, green and blue components, respectively. The -12 value specified for band 3 in MAG= is twice that of the other bands because of it being 2x higher resolution (0.5 km for band 3 versus 1.0 km for bands 2 and 1). The output image is centered on station YSSY (Sydney Intl Airport).

RGBDISP MSG/HRV MSG/HRV MSG/FD TIME=15:00 BAND=12 12 9 MAG=-3 -3 1 STA=LEMD

This entry displays the EUMETSAT Low Level Water Clouds RGB product (http://www.eumetrain.org/resources/MSG_HRVcloudRGB_yellow_cloud.html) in the current frame using the brightness values of the 15:00 UTC band 12 image in the MSG/HRV dataset for the red and green components of the output color image and the band 9 image in the MSG/FD dataset for the blue component of the output color image. The band 12 MSG/HRV data is 1 km resolution and the band 9 MSG/FD data is 3 km resolution, so MAG=-3 -3 1 is specified to use the same resolution (3 km) in all three input images. The output image is centered on station LEMD (Madrid/Barajas).

RGBDISP G16RGBST/RED-CONUS G16RGBST/GRN-CONUS G16RGBST/BLU-CONUS STA=KATL MAG=-5

This entry displays a color image in the current frame that is created using the brightness values of the most current image in datasets G16RGBST/RED-CONUS, G16RGBST/GRN-CONUS and G16RGBST/BLU-CONUS for the output image's red, green and blue components, respectively. The three input images are blown down by a factor of 5, and the output image is centered on station KATL (Atlanta, Georgia).

RGBDISP DAYNITE/RGB BAND=1 2 3 STA=KSTL MAG=-2

This entry displays a color image in the current frame that is created using three bands of the most current image in the DAYNITE/RGB dataset. The band 1, 2 and 3 brightness data are used for the output image's red, green and blue components, respectively. The three input images are blown down by a factor of 2, and the output image is centered on station KSTL (St. Louis, Missouri).