About McIDAS         McIDAS-V         McIDAS-Lite         OpenADDE        
   Advanced
   

Optional Change to RTGRIDS Dataset Structure
Software and Instructions

13 November 2003

This is the second addendum to the May 2003 McIDAS-XCD upgrade, version 2003. The first addendum was dated 30 May 2003.

With the massive growth of grids in the NOAAPORT datastream over the past couple years, many users have had difficulty in locating the grids they want, or in finding out which grids are available. Because of those issues and the recent merging of the MRF and AVN into the GFS, we have created a new default dataset naming and file location structure for real-time grids that makes the task of locating and using the grids easier and more efficient.

Specifically, we identified all grid types that are currently available through the NOAAPORT datastream and created datasets for each of them in the group RTGRIDS. The new dataset names are assigned by model in a way that indicates the coverage, projection and other attributes. This results in a much larger number of datasets in the RTGRIDS group (71 instead of the current 11), but makes the use of grid data easier for the user by clarifying the availability and location of specific data.

As part of the change, the default real-time grid file range was moved from 5001-6000 to 50001-100000. This increase in available grid files makes room for the new datasets as well as for future expansion of grid data.

Three important notes:

  • You do not have to install this addendum. It is optional, however, the new RTGRIDS dataset structure is being used by the SSEC Data Center and it will become the default for future versions of McIDAS-XCD.
  • If you elect to install this addendum, you must install McIDAS-XCD 2003 and the 30 May 2003 Addendum before proceeding with this addendum.
  • If you elect to install this addendum, you should give your users several days or weeks notice (whatever is appropriate for your site) before installing this addendum. The long notice is necessary because users of real-time grids will need sufficient time to change and test use of the new RTGRIDS/* datasets in their GRD* commands (GRDCOPY, GRDDISP, GRDIMG, GRDINFO and GRDLIST). The changes must be done in all GRD* commands in scripts, BATCH files, F-Key menus, McBASI programs and SKE entries as well as commands entered by hand. See the SSEC Data Center user announcement and description of the new RTGRIDS naming scheme for the documents provided to its users.

Optional Action:

Complete the steps below to obtain and install the addendum.

  1. Login to the McIDAS-XCD workstation as user oper.
  2. From a McIDAS-X session running under the oper account, inactivate the grid data monitor, DMGRID.
    Type: DECINFO SET DMGRID INACTIVE
  3. Download the file RTMODELS.CFG to the~mcidas/data directory on your McIDAS-XCD workstation. It will replace the existing version of the file.
  4. Change the oper account's redirections for the new grid files so McIDAS-XCD knows where to write the files.
    1. From a McIDAS-X session running under the oper account, add the file redirections for the new grid files.
      Type: REDIRECT ADD GRI5* "<full path to your grid data>
      Type: REDIRECT ADD GRI6* "<full path to your grid data>
      Type: REDIRECT ADD GRI7* "<full path to your grid data>
      Type: REDIRECT ADD GRI8* "<full path to your grid data>
      Type: REDIRECT ADD GRI9* "<full path to your grid data>
    2. From a McIDAS-X session running under the oper account, remove the file redirection for the old grid files.
      Type: REDIRECT DEL GRID5*
  5. If you want to ingest all grid data, then edit the file ~oper/mcidas/data/NOGRIB.CFG and comment out all active lines by placing a pound sign (#) at the beginning of each line.
  6. From a McIDAS-X session running under the oper account, reactivate the grid data monitor, DMGRID.
    Type: DECINFO SET DMGRID ACTIVE
  7. Add the new datasets to your remote server.
    1. Login to the McIDAS-XCD workstation as user mcadde.
    2. Edit the file ~mcadde/mcidas/data/RESOLV.SRV and remove all of its references to RTGRIDS datasets.
    3. Download the file NEWDATASETS.BAT to the ~mcadde/mcidas/data directory.
    4. Start a McIDAS-X session (with command mcidas).
    5. From the McIDAS-X session, run the BATCH file to add the new datasets.
      Type: BATCH NEWDATASETS.BAT
  8. Change the mcadde account's redirections for the new grid files so the remote server knows where to find the files.
    1. From a McIDAS-X session running under the mcadde account, add the file redirections for the new grid files.
      Type: REDIRECT ADD GRI5* "<full path to your grid data>
      Type: REDIRECT ADD GRI6* "<full path to your grid data>
      Type: REDIRECT ADD GRI7* "<full path to your grid data>
      Type: REDIRECT ADD GRI8* "<full path to your grid data>
      Type: REDIRECT ADD GRI9* "<full path to your grid data>
    2. From a McIDAS-X session running under the mcadde account, remove the file redirection for the old grid files.
      Type: REDIRECT DEL GRID5*
    3. End the McIDAS-X session running under the mcadde account.
      Type: EXIT
  9. If you have cron jobs or scheduler entries that call the QRTMDG command to remove old grid files, you will need to modify them to reflect the change to the real-time grid file range.
    For example, if your cron job or scheduler entry contains this command:
    QRTMDG GRID 5001 6000 5
    change it to this:
    QRTMDG GRID 50001 100000 5
  10. If you decode MDR (Manually Digitized Radar) grids, change the starting grid file number in MDRDEC.CFG to match that in RTMODELS.CFG.


This completes the instructions. If you have any questions, send email to the McIDAS Help Desk.
McIDAS Home