A set of basic CALIPSO data product readers has been developed to aid users in their ability to read the HDF formatted files. This set of readers is written using the Interactive Data Language (IDL) available through ITT Visual Information Systems at URL: http://www.ittvis.com/
and go hand in hand with either the CALIPSO Data Products Catalog (DPC) Release 3.4 or the CALIPSO DPC Release 2.4. A ... list of the major data products, their associated readers, commons, check programs, and the corresponding DPC Table numbers are contained in the tables below.
Due to the nature of the HDF formatting and the need to assign each parameter to the appropriately named variable, there must be an exact match between variable names stored in the file and the command parameter used to retrieve that variable. These readers are written to provide users with the greatest flexibility to select only those parameters that are necessary for their applications. They were not written for efficiency as much as simplicity. There is a one-line call for each parameter, that can be commented out by placing a ‘;’ at the beginning of the line. Already commented out in each program, but left available for the users, are print statements that will provide more detailed information about each parameter contained in the HDF file. Each reader takes as input two quoted string parameters, PATH and FILE NAME. The PATH name contains the directory path to the folder that contains the data, and the FILE NAME contains the full name of the file to be read.
The commons associated with each data product reader contain abbreviated names for each parameter. If the user chooses not to read every data product, these variables will not be filled, but will not present any problems if left in the common. Of course, the user may change these names to match the desired names for their application, but care should be taken to ensure that names are changed in the IDL code as well as the associated common. In some cases, single dimension arrays are read as two dimensional with the initial dimension being set to 1. This does not affect the data in any way, but may need to be considered later when working with the arrays. In order to correct this issue, a simple call to the IDL REFORM function will adjust the array to a single dimension. For example, ArrayA is created with dimensions of (1,50). Issuing the command ArrayA = REFORM(ArrayA, /OVERWRITE) returns ArrayA with a single dimension of (50), and the actual data remains unchanged.
Simple check programs are also provided for each of the readers. These check programs are called at the end of each reader program, and are a double check to ensure that all variables are filled. The calls to the check programs can be commented out once the user is certain that all parameters of interest are read correctly. The check programs issue a ‘HELP, Variable’ for each of the common variables. The HELP command provides common, format, dimension and static value information for all variables. The output from the HELP command is sent to STDOUT, unless otherwise redirected.
[Summary provided by the Langley Research Center Distributed Active Archive Center.]