** DRAFT ** DRAFT ** ** DRAFT ** DRAFT ** ** DRAFT **
This section of the tutorial will explain how to display a color image of a specific parameter and date and how to display a color animation of a specific parameter for a range of dates. You will learn how to use:
You may wish to display a color image of a specific parameter for a given date, with map and graticule overlays. You can do this using PPP_SHOW, which is similar to PPP_STATS in that it only has one required argument, the sds_name, one of the strings that you select from the parameter listing from PPP_TOC. You can specify the date of the file to read by using the DATE keyword (either a string or integer of the form yyyydoy). Once again, the date parameter is not required because you might wish to display one of the static, ancillary parameters.
P-cube Example
TOVS Path-P Example
PPP_SHOW accepts a number of other keywords that allow you to set the displayed label or legend title, force a new window to be opened, or to return the actual data array or its associated metadata in named variables. Please refer to the Extended Help Documentation for details on the other keywords to PPP_SHOW.
Now that you are familiar with the way temperature data can be displayed for a single day, you can use PPP_ANIMATE to extract a 3-D time series of a given parameter and a range of dates. Like PPP_STATS and PPP_SHOW, PPP_ANIMATE has sds_name as one required argument, and a number of keywords for flexibility.
Note to Win95 users: although it was our intention to provide the full set of tools to run in a similar fashion across platforms, PPP_ANIMATE only works as it is described here on IDL 5.x. Users of IDL 4.x on Win95 systems should skip this section of the tutorial, and avoid using PPP_ANIMATE.
Like PPP_STATS, PPP_ANIMATE accepts keywords for a date range (START_DATE and END_DATE), or an array of interesting dates (DATES). The defaults are the beginning and end of all P-Cube or TOVS Path-P data found under the current directory, however, since this routine is very memory intensive, and animating, for example, the two-year time series of data on the P-Cube CD would require opening over 700 files on the CD, it is recommended that you limit the dates that you wish to animate according to your system's memory. For example, a movie of only 100 days would require 670 columns x 670 rows x 100 days = almost 45 Mb of memory. Since each user's system is different, there are no safeguards built in to PPP_ANIMATE to limit the number of dates you may include, so use this routine with care.
P-cube Example
TOVS Path-P Example
Please refer to the Extended Help Documentation for details on the other keywords to PPP_ANIMATE.