| About McIDAS McIDAS-V McIDAS-Lite OpenADDE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
McIDAS-X
Version 2005
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operating System |
Mac OS X 10.3 |
Fortran compiler |
g77: 3.4 (available for free at http://hpc.sourceforge.net) |
C compiler |
gcc: 3.3 (packaged with Mac OS X 10.3) |
X Window System |
packaged with Mac OS X 10.3 |
Operating System |
HP-UX 11.11 |
|
Fortran compiler |
vendor: HP Fortran 90 version 2.5.1 |
-or- g77: 3.0.3 |
C compiler |
vendor: HP C/ANSI C 11.11.02 |
-or- gcc: 3.0.3 |
X Window System |
packaged with HP-UX 11.11 |
|
Operating System |
AIX 5L version 5.2 |
|
Fortran compiler |
vendor: XLF 8.1.0 |
-or- g77: 3.3.2 |
C compiler |
vendor: XLC 6.0 |
-or- gcc: 3.3.2 |
X Window System |
AIXwindows 5.2 |
|
Operating System |
Windows XP Professional with Service Pack 1 and Services for Unix 3.5 |
|
Fortran compiler |
g77: 3.3 |
|
C compiler |
gcc: 3.3 |
|
X Server |
see below |
|
Windows XP Notes:
|
||
Operating System |
Enterprise Linux 3.0 |
Fortran compiler |
g77: 3.4.3 |
C compiler |
gcc: 3.4.3 |
X Window System |
packaged with Enterprise Linux 3.0 |
Operating System |
Enterprise Linux 4.0 on 64 bit |
Fortran compiler |
g77: 3.4.3 |
C compiler |
gcc: 3.4.3 |
X Window System |
packaged with Enterprise Linux 4.0 |
Linux Notes:
|
|
Operating System |
IRIX 6.5.21 |
|
Fortran compiler |
vendor: SGI Fortran 77 7.4.2m |
-or- g77: 3.3.2 |
C compiler |
vendor: ANSI C 7.4.2m |
-or- gcc: 3.3.2 |
X Window System |
packaged with IRIX 6.5.21 |
|
Operating System |
Solaris 9 OS SPARC Platform Edition |
|
Fortran compiler |
vendor: Forte Developer 7 |
-or- g77: 3.3.2 |
C compiler |
vendor: Forte Developer 7 |
-or- gcc: 3.3.2 |
X Window System |
packaged with Solaris 9 |
|
Operating System |
Solaris 9 OS x86 Platform Edition |
|
Fortran compiler |
g77: 3.3.2 |
|
C compiler |
gcc: 3.3.2 |
|
X Window System |
packaged with Solaris 9 |
|
Complete all Required Actions below.
Review the changes to core software before installing McIDAS-X 2005. Section IV lists some of the significant changes since the last upgrade. Two ASCII text files, MAY05PRG.TXT and MAY05INQ.TXT, list all software changes made to McIDAS-X since the previous upgrade. A third file, MAY05OPN.TXT, lists all software bugs known at the time this upgrade was distributed. These three files are available on the McIDAS Website (http://www.ssec.wisc.edu/mcidas/) and are provided with the upgrade CD for sites that receive their software that way. After installing McIDAS-X 2005, the files are in the ~mcidas/data directory.
See Section IV of this document to review the significant changes made to core software. You can also place the three text files in the ~mcidas directory before installing the upgrade. To do so, complete the instructions in Obtaining McIDAS-X 2005 in Chapter 1 of the McIDAS User’s Guide (revised 5/05).
Beginning with this upgrade, the following changes were made to operating system and compiler versions that McIDAS-X is supported on.
See the table in Section I, Supported Software Configurations, for the complete list of operating system and compiler versions that McIDAS-X 2005 is supported on. We recommend that you update the operating systems and/or compiler versions on your McIDAS-X workstation(s) to those listed in the table.
McIDAS-X 2005 can run in a stand-alone mode. However, many commands can access data on other workstations (remote servers). Therefore, your McIDAS-X client workstations and the remote servers they access must be running compatible versions in order for all features to work as expected.
For example, the items below are dependent upon the McIDAS-X version that the client and/or server is running.
Coordinate upgrading your site’s McIDAS-X and -XCD systems according to your needs, considering the compatibility requirements listed above.
McIDAS-X disk space requirements increased, mainly due to the addition of new servers.
The overall disk space requirements for obtaining, building and installing McIDAS-X 2005 are listed in the table below. The disk space requirements for 2004 are listed for comparison. The compiler type (vendor or gcc/g77) used for each build are also listed.
Operating system |
Compilers |
McIDAS-X 2004 |
McIDAS-X 2005 |
AIX 5L version 5.2 |
vendor |
395 MB |
405 MB |
HP-UX 11.11 |
vendor |
435 MB |
450 MB |
IRIX 6.5.21 |
vendor |
455 MB |
470 MB |
Enterprise Linux 3.0 |
gcc/g77 |
370 MB |
375 MB |
Enterprise Linux 4.0 |
gcc/g77 |
n/a |
420 MB |
Mac OS X 10.3 |
gcc/g77 |
410 MB |
400 MB |
Solaris 9 SPARC |
vendor |
430 MB |
445 MB |
Solaris 9 x86 |
gcc/g77 |
355 MB |
365 MB |
Windows XP Pro |
gcc/g77 |
295 MB |
315 MB |
Verify that you have sufficient disk space available to obtain, build, and install McIDAS-X 2005.
If you need assistance with the upgrade or want to know if any problems that might affect your site were noted since this upgrade was mailed, call the McIDAS Help Desk at (608) 262-2455 or send email to the Help Desk.
Obtain and install McIDAS-X 2005 using the instructions in Chapter 1, Installing and Configuring McIDAS-X, in the McIDAS User’s Guide (revised 5/05).
Complete all Required Actions below. Optional Actions are only for your consideration.
This 2005 upgrade contains the final set of changes for McIDAS ADDE data transfer methods. The changes were required because the ports that were initially used (500 and 503) are now registered for uses other than McIDAS. In order to maintain a permanent port for ADDE data transfers, port 112 was registered for McIDAS use and phased into McIDAS-X over the 2003, 2004 and 2005 upgrades. The transition from ports 500 and 503 to port 112 was spread over three upgrades to allow ADDE remote servers to maintain compatibility with client workstations running older upgrade versions as well as those running the current upgrade version.
On the client side:
In McIDAS-X 2003, clients sent their requests for gzip-compressed
data to server port 112, compressed data to server port 503, and uncompressed
data to server port 500. In McIDAS-X 2004 and later (including this
2005 upgrade), clients send all remote data requests, regardless of
the transfer method, to server port 112.
On the server side:
The 2003 and 2004 versions of the ADDE remote server (installed using
the mcinet2003.sh and mcinet2004.sh scripts)
opened ports 112, 500 and 503 so that requests from clients running
version 2003 or older were accepted. Beginning with this 2005 upgrade,
the ADDE remote server (mcinet2005.sh) opens only
port 112 (ports 500 and 503 are no longer opened). Therefore, 2005
ADDE remote servers will respond only to data requests from clients
running version 2005 or 2004 (and also 2003 if the
client’s MCCOMPRESS environment variable is
set to "gzip"). Thus, commands sent to server port 500 or
503 from clients running older versions will fail on the client (eventually
timeout because of no response).
Client workstation users:
If your client workstation accesses data on remote servers you must
upgrade it to at least McIDAS-X version 2004 (preferably 2005) if any
of the remote servers it accesses are running version 2005.
Remote server workstation administrators:
Before installing the McIDAS-X 2005 ADDE remote server (using the mcinet2005.sh script),
you should give your users sufficient notice that they need to upgrade
their client workstations to version 2004 or 2005 (or 2003 if their MCCOMPRESS environment
variable is set to "gzip") in order to access the data on
your server.
The McIDAS-X GUI was modified to include the changes listed below.
Use the GUI by starting it with the GUI command, selecting the Start GUI upon McIDAS startup option in the mcidas -config GUI’s Miscellaneous tab, or automatically start the GUI with each McIDAS-X session by adding a -c GUI command in the Run commands at startup section of your .mcidasrc file.
The McIDAS-X startup script was modified to start the McIDAS-X Configuration GUI if the user does not have a preexisting .mcidasrc file (e.g., when McIDAS-X is started for the first time in a new account). It also, by default, adds the new -config flag to the .mcidasrc file so the Configuration GUI appears each time McIDAS-X is started in future sessions. A checkbox on the Configuration GUI's front tab gives the choice of declining that option (in which case the -config flag is commented out). As with previous versions, the Configuration GUI can also be started by running the command mcidas -config at the Unix prompt.
Read the sections Configuring McIDAS-X Sessions with .mcidasrc in Chapter 1 and Starting McIDAS-X in Chapter 2 of the McIDAS User's Guide (revised 5/05) for more information about the -config flag and the Configuration GUI.
The “NIR” option in the channel parameter of the GEO and LEO commands was changed to “SW” to more accurately reflect the description for the ~3.9µm shortwave infrared channel. The names of the other channel options are the same as before, but their descriptions were updated.
Check all occurrences of GEO and LEO commands in your macros, scripts, BATCH files, F Key Menus, McBASI programs and SKE entries to see if they specify the NIR option. If any do, change "NIR" to "SW" so they continue to work with McIDAS-X 2005.
In the IMGOPER command, the ZERO=DATA/MISS keyword was removed and replaced with the new MISS=m1..mn keyword that lets you specify missing data values for each source image, e.g., MISS=0 -1 0 or MISS=NONE. Use of the ZERO=DATA/MISS keyword is still allowed for backward compatibility, but it is no longer documented and supported so you should switch to the new keyword as described in the Required Action section below.
Replace all uses of the ZERO keyword with the corresponding MISS keyword in your IMGOPER commands. In addition to changing your interactive command line entries, check all occurrences of IMGOPER commands in your macros, scripts, BATCH files, F Key Menus, McBASI programs and SKE entries to see if they contain ZERO=DATA or ZERO=MISS. If any do, change ZERO=DATA to MISS=NONE, and change ZERO=MISS to MISS=0.
The IMGCHA and IMGCOPY commands were modified to zero out the original source type (word 56) if it's equal to PRD and STYPE=VISR is specified. This change fixes a problem in displaying product images created with the IMGFILT or IMGOPER commands. A new keyword, OTYPE, was added to IMGCHA to update the original source type. The keyword is unlikely to be needed except for certain cases of sophisticated multi-step image processing.
If temperature information is needed but was unexpectedly lost during multi-step image processing, use the IMGCHA command with the OTYPE keyword to reset the original source type back to its original value.
In previous versions of McIDAS-X, every call to the Meteosat Second Generation (MSG) server resulted in a trce file being written on the server. This problem has been corrected to write the file only if requested.
If your site serves MSG data in the raw format, check your server workstation for trce files and remove them.
The modifications below require no special action.
Command / Topic |
Modification |
DSSERVE |
updated to allow file masking of McIDAS grid files with the DIRFILE keyword and updated to use the same RESOLV.SRV file locking method as servers (both now lock on the full path name of RESOLV.SRV), so there should be no more problems of one overwriting the file while the other should have had it locked |
FRMLABEL |
added (MDY), (WL), (WN) and (FREQ) placeholders to allow use of a different date format (mon dd yy) and the displayed image's wavelength, wave number and frequency in the image label |
GRDDISP |
updated COLOR keyword to allow choice of plot color based on parameter value; for example, PAR=T UNIT=F FORMAT=I2 COLOR=2[50-89B10] plots 50-59°F temperatures in graphics color level 2, 60-69°F in level 3, 70-79°F in level 4 and 80-89°F in level 5; temperatures less than 50°F are in level 1, and temperatures greater than 89°F are in level 6 |
IMGCOPY |
modified BAND keyword to allow copying of selected bands (not just one band or ALL bands) if the source image is real-time segmented Meteosat Second Generation Level 1.5 files transmitted by EUMETSAT; copying of selected bands is also available with GVAR raw data on an SDI server or MODIS Level 1b data in HDF format |
IMGCOPY, IMGDISP, IMGREMAP |
added NAVTYPE=LALO keyword to allow use of lat/lon navigation instead of the regular (native) navigation; this keyword is valid only if the source image is area format and the server supplying the image is running version 2005 |
IMGFILT |
added new FILTER keyword options MERGE and SPOT; the SPOT filter lets you darken or lighten brightness values inside of or outside of one or more circles defined by a center point and radius |
IMGREMAP |
added DIST keyword to restrict the remap to a specified distance from the subpoint of the satellite; this enhancement was funded by the Aviation Weather Center |
MAP |
added new keyword LLINSET that draws latitude and longitude lines within a specified inset region; also changed the LABEL=360 option to 360E or 360W to let you specify which direction the longitude label values should increase (360E to the east, 360W to the west); note that 360, which does the same thing as 360W, is still allowed for backward compatibility |
MOSRPT |
updated for the NCEP NAM (North American Mesoscale) forecast model that replaced the ETA forecast model effective 25 January 2005; the changes include replacing TYPE=ETA with TYPE=NAM and updating the DATASET keyword defaults for TYPE=NAM and TYPE=NGM to match the new McIDAS-XCD default MOS datasets |
PLAX |
added output line that indicates the ground position error in kilometers at the cursor location, based on the parallax correction for a feature 10 kilometers above the earth |
REDIRECT |
updated to allow characters between a wildcard and a period in the file name (e.g., *GFS.TXT), and added lock to file LWPATH.NAM so it can no longer be modified by more than one session at a time |
STNLIST, STNPLOT |
added new option NAMMOS to the TYPE keyword for listing or plotting NAM MOS stations |
Upper-Air Commands |
updated ALTIM, HODO, UALIST and UAPLOT commands to set the LFC equal to the LCL when an extremely unstable sounding results in the LFC being below the LCL in the initial calculation |
ZA |
added FRMLABEL command's frame directory placeholders (which are replaced with the corresponding information from the frame, dataset and displayed image) to ZA command for use with graphics labels |
ADDE Dataset Access Restrictions |
added methods for ADDE Remote Server administrators to restrict access (by user name, project number or IP address) to all datasets on a server, or to specific datasets identified by group or group/descriptor; see Appendix I, McIDAS-X Site Administration and Management, of the McIDAS User's Guide (revised 5/05) for instructions |
Default Number of Frames |
increased default number of frames set in the .mcidasrc file from four to ten |
GOES-13 |
updated the calibration module with the latest changes for GOES-13, and updated the SDI servers for GOES-13, -14 and -15 |
Installation Script |
updated McIDAS-X 2005 installation script (mcidas2005.sh) to check that the required X11 components exist, and to send third party library configure and make output to mclog with the rest of the McIDAS build output |
New MODIS Product Servers |
added MODIS product servers to McIDAS-X to allow creation of datasets containing MODIS Level 2 MOD04 (aerosol) or MOD28 (sea surface temperature) data in HDF format on local and remote servers, and display or manipulation of the data using the IMG* commands; see the DSSERVE command's online help or its documentation in the McIDAS User's Guide (revised 5/05) for information about creating the datasets |
The following changes were made to files in the ~mcidas/data directory.
File name |
Change |
CORE.SAT |
added entries for GOES-13, -14 and –15 |
DCGFSMOS |
increased the capacity for the number of runs per day from two to four |
DCNAMMOS |
new MD file schema for Model Output Statistics (MOS) data from the NCEP NAM (North American Mesoscale) forecast model that replaced the ETA forecast model effective 25 January 2005 |
DCNGMMOS |
new MD file schema for Model Output Statistics (MOS) data from the NCEP NGM (Nested Grid Model); this file, which is the same as DCFO14, was created because it's a more logical name than DCFO14 and follows the naming convention of the other MOS schemas (DCGFSMOS and DCNAMMOS) |
GEODATA.CORE, LEODATA.CORE |
updated channel lists for current satellites; in LEODATA.CORE also removed NOAA-12 and NOAA-14 from the list of default datasets used by the LEO command since they are no longer available on SSEC Data Center real-time servers |
MCCMDHIST.TXT |
updated to include a line indicating each time a new McIDAS session is started; see Entering and Editing Commands in Chapter 2 of the McIDAS User's Guide (revised 5/05) for more information |
OUTLHRES |
corrected location of Christmas Island (near 2.0° N, 157.5° W) |
SATANNOT |
added sensor source numbers 104,
114, 128, 138 for TERRA-AER, AQUA-AER, TERRA-SST and AQUA-SST;
added sensor source numbers |
SATBAND |
added DESC=, WL=, WN= and FREQ= fields (where appropriate) so FRMLABEL and ZA commands can display those values; corrected central wavelength of band 2 AVHRR for NOAA-15 and later (was 0.91µm, now 0.86µm); added band information for GOES-13, GOES-14, GOES-15 and AMSR-E |
STNDB.CORE |
added state code for station 74546 (Hillsboro, KS); corrected elevations of NEXRAD stations; added new NEXRAD station VWX (Evansville, IN); added new data types NAMMOS and NGMMOS |
USCOUNTY.MAP, USZONE.MAP |
updated to most recent NWS versions as of 01 April 2005 |
XRD2005.TXT |
updated with list of commands, servers and data files in McIDAS-XRD version 2005 sidecar package; run McIDAS‑X command SEE XRD2005.TXT to view the list |
Merge these modifications with all local copies of the data files.
Beginning with this upgrade, the suite of McIDAS manuals (McIDAS User's Guide, McIDAS Learning Guide, McIDAS Programmer's Manual, McIDAS-XCD Administrator's Guide and SDI Operator's Manual) will be available only in HTML format. As before, you will be able to view a manual on the McIDAS Website, or download a compressed tar file containing the manual in HTML format and make it available on your local web server. But you will no longer be able to download a manual in PDF, PS and FM (Portable Document Format, PostScript and FrameMaker) formats.
These changes are mainly due to switching of our main publishing software from Adobe FrameMaker to Macromedia Dreamweaver. Moving to Dreamweaver provides future benefits in that the manuals will be easier to maintain and update in a timely manner. Also, as part of the move we changed to a more logical naming convention for the McIDAS User's Guide and McIDAS-XCD Administrator Guide files. For example, in previous versions of the User's Guide, files were sequentially named from McHTML‑1.HTML through McHTML‑354.HTML and McHTML‑1.gif through McHTML‑79.gif. They have been renamed with this upgrade to more descriptive names like install‑1.html, intro‑1.html, grdcopy.html, imgdisp.html and image_window.gif. In particular, the URLs of the commands (e.g., http://www.ssec.wisc.edu/mcidas/doc/users_guide/2005/ptdisp.html) are easy to remember, and thus easy to link from other HTML documents.
Make version 2005 of the McIDAS User's Guide and/or McIDAS-XCD Administrator's Guide available on your local web server by downloading the compressed tar file from the McIDAS Website. To do so, go to http://www.ssec.wisc.edu/mcidas/doc/ and select the appropriate manual (either McIDAS User's Guide or McIDAS-XCD Administrator's Guide), then select the Download HTML link and complete its instructions.
Compile and link all local code after installing the upgrade. Listed below are some of the software and structural changes most likely to affect your local code.
| wwdisp.c | wwlist.c | wwmisc.c |
| daytime.c | mccomp.sh | ncdfks.c |
| zlm.pgm | mcidas.h | sfcmg.c |
| mcts.c | mcts.h |
| modsaget.cp | kbxmods.dlm | mcaput.for |
| mcaget.for | aputserv.fp |
| altim.c | ualist.c | uaplot.c |
| hodo.c | mcsndanl.c | sndskewt.pgm |
| sndaltim.pgm | sndplot.pgm | sndlist.pgm |
| sndhodo.pgm |
| altim.c | ualist.c | uaplot.c |
| hodo.c | mcsndanl.c | sndskewt.pgm |
| sndaltim.pgm | sndplot.pgm | sndlist.pgm |
| sndhodo.pgm |
| isgfmt.for | igget.for | mcfndgrd.for |
| mcglast_.c | gputserv.fp | gdirserv.fp |
| ggetserv.fp | grdcopy.pgm | mcgput.for |
| igopen.for | iggmax.for | igmakx.for |
| igopen.for | igquit.for | readsort.for |
| igget.for | igput.for | gridparm.inc |
| igfilename.for |
| database.c | gribgget.cp | gbtbpds001.0v1 |
| mcgrib.h | mcncdf.h | gbtbpds001.4v1 |
| gribfunc.c | gribgdir.cp | gbtbpds001.2v1 |
| ncdffunc.c | ncdfgdir.cp | gbtbpds001.2v2 |
| ncdfgget.cp | xcdgrib.c | gbtbpds001.2v3 |
| gbtbpds001.a34v1 | gbtbpds001.a60v1 | gbtbpds001.a74v1 |
| gbtbpds001.a98v1 | gbtbpds001.av1 | gbtbpds001.b98v1 |
| gbtbpds001.bv1 | gbtbpds001.2v128 |
A new version of the McIDAS-XRD optional sidecar is available with this upgrade. The new version, 2005, contains 14 new commands, 13 new data files, and six new servers. These changes bring the total number of -XRD 2005 commands to 88, servers to six, and data files to 18. This is the first version of -XRD that contains servers. The servers are placed into the ~mcidas/bin directory.
The list of -XRD 2005 software is available on the McIDAS Website (at http://www.ssec.wisc.edu/mcidas/software/xrd/upgrade2005unix.html and http://www.ssec.wisc.edu/mcidas/software/xrd/upgrade2005xp.html) or in the file ~mcidas/data/XRD2005.TXT that’s distributed with -X 2005. To view the file, run the command SEE XRD2005.TXT after -X 2005 is installed.
The -XRD 2005 package can only be used in combination with -X and must be installed after -X 2005 has been installed. The -XRD package contains research and development commands, servers and data files that are not part of -X. The -XRD software is provided on an “as is” basis, meaning it is not MUG-supported. The software in -XRD comes from programmers at various MUG sites. The software is added to the package if it may be useful to other sites and it meets some basic code standards.
SSEC McIDAS User Services packages and distributes the -XRD software, but does little or no testing of it and does not provide any documentation. Each command’s on-line help is all that’s available for documentation. McIDAS User Services will forward all bug reports to the programmer that submitted the software. However, there is no guarantee that bugs will be fixed, as it’s up to the programmer to decide whether or not to fix them.
Install McIDAS-XRD 2005 by obtaining the files and completing the installation instructions on the McIDAS Website. Select McIDAS-XRD in the Download Software menu along the left side of the page.