|
|
|||
|
||||
Complete all Required Actions below.
Review the changes to core software before installing McIDAS-X 2004. McIDAS-X Significant Changes lists some of the significant changes since the last upgrade. Two ASCII text files, MAY04PRG.TXT and MAY04INQ.TXT, list all software changes made to McIDAS-X since the previous upgrade. A third file, MAY04OPN.TXT, lists all software bugs known at the time this upgrade was distributed.
Required Action:
Beginning with this upgrade, the following changes were made to operating system and compiler versions that McIDAS-X is supported on.
McIDAS-X 2004 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, use of the three items below is dependent upon the McIDAS-X version that the client and/or server is running.
The FOUSRPT command was deleted from McIDAS-X beginning with this upgrade. It was deleted because its functionality is available in the command MOSRPT (which was added in version 2003, and can list ETA and GFS, as well as NGM, MOS forecasts).
Required Action:
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 2004 are listed in the table below. The disk space requirements for 2003 are listed for comparison. The compiler type (vendor or gcc/g77) used for each build are also listed.
| Operating system | Compilers | McIDAS-X 2003 | McIDAS-X 2004 |
| AIX 5L version 5.1 | vendor | 345 MB | 395 MB |
| Fedora Core 1 Linux | gcc/g77 | 320 MB | 328 MB |
| FeeBSD 4.[89] | gcc/g77 | 320 MB | 328 MB |
| HP-UX 11.11 | vendor | 390 MB | 435 MB |
| IRIX 6.5 | vendor | 455 MB | 455 MB |
| Mac OS X | gcc/g77 | n/a | 410 MB |
| Solaris 9 SPARC | vendor | 420 MB | 395 MB |
| Solaris 9 x86 | vendor | 355 MB | 355 MB |
| True64 Unix | vendor | 420 | 421 MB |
| Windows XP Pro | gcc/g77 | n/a | 295 MB |
Required Action:
If you need assistance with the upgrade, please send email to <support@unidata.ucar.edu&tg;.
Complete all Required Actions below. Optional Actions are only for your consideration.
In McIDAS-X versions 2003 and later, you can request data from ADDE remote servers using three different transfer methods. The methods are gzip- compressed, compressed, and uncompressed.
The default method is determined by the MCCOMPRESS environment variable. In this upgrade, a new global keyword that overrides the environment variable was added. The new global keyword is named MCCOMPRESS=, which can also be specified as MCC=. For example, IMGDISP GOES/EAST 5 BAND=4 STA=KATL MCC=GZIP overrides the environment variable setting and requests that the remote server use gzip to compress the specified image data, then send it to your workstation, which uses gunzip to uncompress it then displays it in frame 5.
In McIDAS-X 2003, requests for gzip-compressed data are sent to server port 112, compressed to server port 503, and uncompressed to server port 500. Beginning with this upgrade, all requests, regardless of the data transfer method, are sent to server port 112. In all cases, after receiving the client's request, the remote server gathers the requested data and uses the appropriate compression method to package the data, then sends it to the client through the same port.
Important Notes:
Required Action:
After installing McIDAS-X 2004 on their ADDE remote servers, administrators must install the McIDAS-X 2004 ADDE remote server (using the mcinet2004.sh script). This step is required because the script was modified to work better with newer versions of xinetd. See Installing the McIDAS-X 2004 ADDE Remote Server and Updating Clients to Use Compressed Data Transfers in the Unidata McIDAS User's Guide for more information and the installation instructions.
The McIDAS-X GUI was modified to include the changes listed below.
The PRDUTIL command was modified to use the IMGLIST command to generate its output, instead of using an internal version. It was also modified to no longer allow its file specification as an area number (i.e., you must specify an ADDE dataset name and position number instead of an area number).
Required Action:
The AXFORM command was modified to left- or right- justify the values in its HDR output file. Therefore, values in fields like Band, Lines and Elements are usually in different columns than in previous versions.
Required Action:
The modifications below require no special action.
| Command / Topic | Modification |
| FRMSAVE | fixed to save what you see on the display; so if the image or graphics is toggled off (with K or W commands) it will not be included in the file created with FRMSAVE |
| GEO | added DAY and TIME keywords to select an earlier image |
| LWCON | added FLIP keyword to control when words containing ASCII text are byte flipped |
| LWU | added bword and eword parameters to COPY option to specify a range of words to copy from the source file |
| MAP | added options to the LABEL keyword to choose the latitude and longitude label formats, and added LLMARK keyword to draw reference symbols (e.g., plus signs (+)) at the specified latitude and longitude intervals |
| NAVCALC | added IMC keyword to choose whether to list the actual GVAR (GOES-8 and later) satellite subpoint, or that corrected by the Image Motion Compensator |
| PTDISP, RAOBPLOT, SFCPLOT | updated COLOR keyword to allow choice of plot color based on parameter value; for example, SFCPLOT T USA 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 |
| PTLIST | added DM and DMS options to FORMAT keyword to list latitude and longitude values in degrees:minutes and degrees:minutes:seconds, respectively; the default format for latitude and longitude values is decimal (which can be altered with the keyword's F option) |
| SFCCON, SFCPLOT | modified the equations that calculate station pressure to, by default, use altimeter setting instead of sea-level pressure; this affects the PSTN, MIX, THA and THAE options because they are calculated using station pressure |
| ZA | replaced the L, C and R options in the justify parameter with new options that allow vertical, as well as horizontal, positioning; the new options are LA, LC, LB, CA, CC, CB, RA, RC and RB, where L means left, C means center, R means right, A means above and B means below the center of the cursor; to retain backward compatibility, entering L, C or R for the 'justify' parameter will work the same as it did in previous versions |
| WL and WN Keywords | added WL and WN keywords to IMGCOPY, IMGDISP, IMGFILT, IMGLIST, IMGPROBE and IMGREMAP commands that allow you to select Aqua AIRS data based on wavelength and wave number |
| WMO Weather Symbol Fonts | updated GRDDISP, PTDISTP, SFCMG and SFCPLOT commands to use the new WMO weather symbol fonts listed in the Data Files section; the most significant change is that the calm wind symbol plotted with commands like SFCPLOT WINDB or PTDISP PAR=WIND FORMAT=VECT has been changed from a plus sign (+) to a small bullseye (two concentric circles) |
| AIRS HDF Servers | added AIRS HDF servers to McIDAS-X to allow creation of datasets containing AIRS 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/04) for information about creating the datasets |
| GeoTIFF Servers | added GeoTIFF servers to McIDAS-X to allow creation of GeoTIFF files with the IMGCOPY, IMGFILT, IMGOPER or IMGREMAP commands; see the DSSERVE command's online help or its documentation in the McIDAS User's Guide (revised 5/04) for information about creating the datasets |
| MODIS HDF Servers | updated to allow use of files with names that follow the MODIS Direct Broadcast file naming conventions, as well as those that follow the Goddard DAAC file naming conventions |
| netCDF Image Server | modified to allow use of the DIRFILE keyword in the DSSERVE command for determining where to write newly-created files |
| POES Level 1b Servers | added option to use the SAA Level 1b file's line-by-line lat/lon navigation (rather than the orbital navigation at the beginning of the file) by specifying INFO=LALO in the DSSERVE command; also added new servers to write POES/NOAA KLM AVHRR area data to SAA Level 1b file format; see the DSSERVE command's online help or its documentation in the McIDAS User's Guide (revised 5/04) for more information |
The following changes were made to files in the ~mcidas/data directory.
| File name | Change |
| AIRSBAND.DOC | new text file containing information about each of the 2378 bands (channels) in AIRS data |
| AIRSBANDINFO | new binary file created from AIRSBAND.DOC that the AIRS server uses to map wavelength and wave number to band number |
| CORE.SAT | changed MSG-1, MSG-2 and MSG-3 entries to Meteosat-8, Meteosat-9 and Meteosat-10 |
| DCETAMOS | increased number of rows from 38 to 42 and number of columns from 350 to 2000; added category FW (for "few") to CLD field; added seven new fields (CIG, OBV, POS, POZ, SNW, TYP, VIS) |
| DCGFSMOS | increased number of rows from 38 to 42 and number of columns from 350 to 2000; added category FW (for "few") to CLD field; added new field SNW |
| DCISFC | increased number of columns from 3500 to 7000 |
| MAP.CORE | added new global keyword LLMARK to draw reference symbols, e.g., plus signs (+), at the specified latitude and longitude intervals; the global default value is set to NO |
| netcdfgrid.cfg | added new comments to make it more informative |
| netcdfbuoy.nc | new sample netCDF point file containing buoy data; netcdfpoint.cfg is a sample configuration file for this type of data |
| OUTLHRES | updated to remove an extra line that was extending off the Ross Ice Shelf in Antarctica |
| SATANNOT | changed sensor source numbers 51, 52 and 53 from MSG-1, MSG-2 and MSG-3 to Meteosat-8, Meteosat-9 and Meteosat-10 |
| SATBAND | added band information for AIRS (2378 channels) and reordered MSG bands to match Eumetsat's ascending-wavelength order |
| SFCPLOT.CORE | changed the format of VIS plots from F4.1 to F5.1 to accommodate triple-digit visibilities |
| STNDB.CORE | updated to contain state codes for countries other than the United States (e.g., BC for stations in British Columbia, Canada); changed state field from CA to TX for station KBYY (Bay City, Texas); updated lists of ETA MOS and GFS MOS stations |
| USCOUNTY.MAP, USZONE.MAP | updated to most recent versions as of 14 April 2004 |
| WXSYM.FFD, wxsymr*.bdf | updated WMO weather symbol font package so there is consistency across all sizes |
| XRD2004.TXT | updated with list of commands and data files in McIDAS-XRD version 2004 sidecar package; run McIDAS-X command SEE XRD2004.TXT to view the list |
Required Action:
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.
| makefile | mccomp.sh | mcinst.sh |
| m0util.c | mct_winc.c | mct_winx.c |
Required Action:
If you need assistance with the upgrade
send email to
<support@unidata.ucar.edu>.
Required Action:
This section lists the changes made to McIDAS-XCD
since the last upgrade (version 2003) and the
Required and Optional actions to perform
immediately after installing McIDAS-XCD 2004.
The total number of SAO/METAR stations has increased beyond the prior maximum limit of 6500. Complete the required actions below to increase the maximum number of SAO/METAR stations to 7000.
Required Actions:
The following actions need to be completed.
Required Actions:
Note: This procedure will retain the old datasets (RTGRIDS/AVN and RTGRIDS/MRF) so that your users will not have to switch to the new dataset (RTGRIDS/GFS) immediately. When all of your users have switched to the new dataset you may delete the old ones.
The resulting lines should be similar to these:
N1=RTGRIDS,N2=MRF,TYPE=GRID,RT=Y,K=GRID,R1=5701,R2=5900,C=Real-Time MRF Grids,
N1=RTGRIDS,N2=AVN,TYPE=GRID,RT=Y,K=GRID,R1=5701,R2=5900,C=Real-Time AVN Grids,
N1=RTGRIDS,N2=GFS,TYPE=GRID,RT=Y,K=GRID,R1=5701,R2=5900,C=Real-Time GFS Grids,
Note that all three of these datasets point to the same grid file range.
The following actions need to be completed.
Required Actions:
The following actions need to be completed.
Required Actions:
A new optional dataset naming configuration for real-time grids is included in this upgrade.
Optional Action:
The table below lists changes to McIDAS-XCD source modules since the previous upgrade (version 2003).
| File name | Modification |
| m0dcdsfc.for | changed country code for Canada from CN to CA |
| m0etamos.for | added 7 new fields and increased forecast hours by 12 |
| m0gfsmos.for | added Snowfall Amount field and fixed several bugs |
| m0mdrdec.for | added Generating Process ID to mcrtgdf call |
| m0pirdec.for | removed check for KTS in wind speed decoder |
| m0saodec.for | increased maximum number of stations from 6500 to 7000 |
| mccmpgrd.for | added Generating Process ID to list of criteria used to determine if two grid headers are considered equivalent |
| obtgserv.c | increased size of two arrays to fix memory allocation errors that occurred with large data requests |
| sigco.pgm | added SIGCO ADD ALL and SIGCO DEL ALL options; changed country code for Canada from CN to CA in the initialization subroutine; changed some array declarations to eliminate compiling problems on Solaris 9 for Intel |
| File name | Modification |
| ETAMOS.CFG | added OCONUS WMO headers; changed number of rows from 38 to 42 and number of columns from 1400 to 2000 |
| gbtbpds001.av1 | added model #99 (Significant Height of Wind Waves) and model #191 (Current Icing Potential); changed all AVN and MRF references to GFS |
| GFSMOS.CFG | changed number of rows from 38 to 42 and number of columns from 1400 to 2000 |
| GRIBDEC.CFG | increased value for SEARCHBACK from 400 to 5000 so that all grids in a grid file will be searched for matching headers |
| ISFCDEC.CFG | increased number of columns from 6500 to 7000 |
| _mcidasxcd.mk | set ETAMOS.CFG and GFSMOS.CFG so that they are copied to ~mcidas/workdata only during a new installation |
| MDRDEC.CFG | set default behavior for MDR decoder to use RTMODELS.CFG to determine the grid file range |
| NEXRID.CFG | updated version and date |
| NOGRIB.CFG | set default behavior for grid decoder to decode all grids |
| RTGRIDS.TXT | new data file that describes new RTGRIDS default dataset configuration |
| RTMODELS.CFG | new default grid dataset configuration |
| xcd_init | updated version number |
| XCD.BAT | removed redirection command for RTMODELS.CFG |
| XCDADDE.BAT | changed DSSERVE commands to conform to new default RTGRIDS dataset configuration |
| XCDDEC.BAT | removed REDIRECT REST XCD command |
| XCDDEC.VER | updated version number and date |
| Contact Us Site Map Search Terms and Conditions Privacy Policy Participation Policy | ||||||
|
||||||