McIDAS-X User's Guide
Version 2023.1
[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]
This keyword specifies whether to request the expanded stretch option with image data. The keyword can also be specified as MCS= (as well as MCSTRETCH=).
|
MCSTRETCH= |
EXP |
requests use of the expanded stretch option to increase the detail shown in specific visible, water vapor and short-wave infrared imagery when displayed with IMGDISP or copied to a 1-byte Area file using commands like IMGCOPY with STYPE=VISR or IMGREMAP; this option is available in McIDAS-X versions 2017.2 and later, and requires that the image matches one of the satellite and band combinations in the file MCSTRETCH.TXT (run command SEE MCSTRETCH.TXT to view the file) |
|
|
ORIG |
requests use of the original stretch option that was used in all McIDAS-X versions prior to 2017.2; see the file MCSTRETCH.TXT for the ranges used in both the ORIG and EXP options |
The default (if you don't specify this keyword) is to use the method set in the MCSTRETCH environment variable; if it is not set, EXP is assumed. So unless you set the environment variable to MCSTRETCH=ORIG or specify it as a keyword in your IMG* command, the expanded stretch option is used. Likewise, if you change the environment variable setting to MCSTRETCH=ORIG you must specify keyword MCSTRETCH=EXP in your IMG* command to request the expanded stretch option. See Setting the Expanded Stretch Option for more information.
Below are two examples.
IMGDISP GOES16/CONUS BAND=9 MCSTRETCH=EXP
This entry displays band 9 of image GOES16/CONUS while also requesting use of the expanded stretch option. The satellite and band combination matches an entry in the MCSTRETCH.TXT file so if GOES16/CONUS is a local file or is on a server running McIDAS-X 2017.2 or later it is displayed using the expanded stretch option to provide more detail in both the colder and warmer temperatures of this water vapor band. If you replace MCSTRETCH=EXP with MCSTRETCH=ORIG the image is displayed using the original stretch option so it appears the same as it would if displayed in McIDAS-X 2017.1 or earlier.
IMGCOPY HIMAWARI/FD LOCAL/HIM8 BAND=3 STYPE=VISR MCS=EXP
This entry copies band 3 of image HIMAWARI/FD to local dataset LOCAL/HIM8 while also requesting use of the expanded stretch option. The satellite and band combination matches an entry in the MCSTRETCH.TXT file so if HIMAWARI/FD is a local file or is on a server running McIDAS-X 2017.2 or later it is copied using the expanded stretch option to provide more detail in the higher reflectances by expanding the range of those data values over a larger range of 8-bit brightness values. If you replace MCS=EXP with MCS=ORIG the image is copied using the original stretch option so the output Area file has the same data values as it would if IMGCOPYed in McIDAS-X 2017.1 or earlier.
[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]