Education Center | Photo Gallery

Data Advanced Data Search More Data Discovery & Access Easy-to-use Data Products Data Collections Data Software & Programming Tools Data Submission Data News Centers & Programs Antarctic Glaciological Data Center Arctic System Science Data (ARCSS) IARC Frozen Ground Data Center International Polar Year Data & Information Service (IPYDIS) NOAA at NSIDC NASA's Distributed Active Archive Center at NSIDC (NSIDC DAAC) U.S. Antarctic Data Coordination Center World Data Center for Glaciology, Boulder Science Scientists Research Projects Publications NSIDC Notes Glaciological Data Series Special Reports Posters & Presentations Annual Reports Education Resources News & Events Press Room NSIDC In the News Data News Events About Expertise Data & Services NSIDC Sponsors Contacts Jobs Related Organizations

** DRAFT ** DRAFT ** ** DRAFT ** DRAFT ** ** DRAFT **

Tutorial:

1. Displaying general information and statistics about the P-Cube or TOVS Path-P files.

This section of the tutorial will explain how to extract a table of contents of the P-Cube or TOVS Path-P files, and how to extract a table of statistics for a specific parameter and range of dates. You will learn how to use:

• PPP_TOC - Displays a Table of Contents of P-Cube/TOVS Path-P files
• PPP_STATS - Displays statistics for one parameter and range of dates

PPP_TOC - Displaying a Table of Contents

The first step in browsing the P-Cube or TOVS Path-P data is to display a table of contents using PPP_TOC ("P-Cube Table of Contents"). PPP_TOC has two required arguments:

1. sds_desc will be returned with an array of structures that contain metadata pertaining to each HDF Scientific Data Set (SDS) included in the data. Metadata will include the SDS name, a longer descriptive label, the units and the fill value used for this SDS.
2. dates will be returned with an array of dates, one for each daily file included on the P-Cube CD or in your TOVS Path-P data directory.

ppp_toc will traverse the current directory structure, looking for all P-Cube or TOVS Path-P files contained there, and will display an informational message that summarizes what it has found. For example, change your current directory to the base directory for the data and run PPP_TOC like this (P-cube users remember that your CD drive may be slightly different from the placeholder "CDROM" we're using here):
P-cube Example
TOVS Path-P Example

Please refer to index.html in the HTML documentation, for more information about these tools, including extended help documentation.

The list of parameter names, which is returned to you in the array sds_desc.name, is the list of strings that will be considered valid input values to all other routines that accept an argument or keyword called SDS_NAME. The list of dates, returned to you in the dates array, can be used (or subsetted, for a particular range of dates) in all other routines that accept an argument called DATES.

Note that PPP_TOC splits the parameter information into two groups: those parameters that change over time and are included in each daily file, and those parameters that are not dynamic, and are included only once, in the ancillary data file.

Please refer to the Extended Help Documentation for details on the other keywords to PPP_TOC.

PPP_STATS - Displaying statistics for one parameter and range of dates

Now that you know which parameters are included in the P-Cube or TOVS Path-P files, you may want to use PPP_STATS to extract some statistics for a given parameter and range of dates. PPP_STATS has one required argument and a number of keywords for flexibility. The required argument is sds_name, which is a string that you select from the parameter listing you just displayed with PPP_TOC.

PPP_STATS also accepts keywords for a date range (START_DATE and END_DATE), or an array of specific dates (DATES). Any dates entered as keywords in this way can be either integers or strings of the form yyyydoy (4-digit year and 3-digit day of year). (Other functions that behave similarly are PPP_ANIMATE, PPP_EXTRACT, and PPP_PLOT, which will be covered later in the tutorial.) These keywords are not required arguments, because PPP_STATS can also be used to display statistics for the ancillary parameters, which are static data, and therefore have no associated dates.

P-cube Example
TOVS Path-P Example

Please refer to the Extended Help Documentation for details on the other keywords to PPP_STATS.

Next tutorial section