The rdals utility gives users access to enhanced metadata that provides titles for RDA directories in /glade/collections/rda/data as well as descriptions for files in the /glade/collections/rda/data/dsnnn.n subdirectories. Some data sets may contain incomplete metadata or file list information due to ongoing development.
The rdals utility can be found in the /glade/u/apps/contrib direcotry. Enter rdals -h at your command line for a description of how to use the utility.
The utility displays four columns of information. When listing directories, the columns are:
Directory Name, Data Volume, File Count, Brief Description
When listing files, they are:
File Name, Data Size, Data Format, Brief Description
A leading letter is displayed on each line to indicate what type of item is listed:
- D indicates a whole data set.
- G indicates a group or subgroup in a data set.
- F indicates a data file.
Here is a sample of the output from cd /glade/collections/rda/data; rdals:
Dds351.0 3.35T 179381 NCEP ADP Global Upper Air Observational Weather Data, October 1999 - continuing Dds351.1 549.47G 256574 NCEP ADP ETA/NAM Upper Air Observation Subsets, October 2000 - continuing Dds353.4 180.17G 2004 NCEP ADP Operational Global Upper Air Observations, December 1972 - February 2007 Dds358.0 0B 0 Ptarmigan Dropsondes (Arctic reconnaissance) for 1950-1961 Dds359.0 2.93M 7 NOAA Profiler Network (NPN) Observations, 1992 May-continuing Dds365.0 0B 0 Sadler's Global Aircraft Observations, daily 1960-1973 Dds366.0 407.77G 2162 ERA-40 Global Upper Air Radiosonde Observation Feedback Record Reports Dds367.0 5.22G 1129 ERA-40 Global Upper Air Satellite Wind Observation Feedback Record Reports
Usage options
Usage: rdals [-d] [-f] [-N] [-h] [-r] [-D DelimitSymbols] [-R RecursiveLevel] [Directory/File List]
- Option -d, list directory information only. Directory information is included as default. Add this option to exclude file information;
- Option -f, list file information only. File information is included as default. Add this option to exclude directory information;
- Option -N, list files unformatted;
- Option -h, display this help document;
- Option -r, list directories and files recursively;
- Option -R, list directories and files recursively up to the level provided with this Option;
- Option -D, specify delimiting symbols for dividing the columns. It defaults to " " for formatted output and '|' for unformatted output. Make sure quote the symbols if any character in the symbols has Unix meaning, for example -D '<:>';
- Directory/File List is optional; without specification, all directories and files in the current directory. Unix command line wildcards are supported.
Nothing is displayed if neither directory nor file information matches information stored in the RDA database.
Examples
To check directories and files in data set dsnnn.n:
Change to the data set directory.
cd /glade/collections/rda/data
Execute rdals, adding the recursive option -r to check directories and files further in the subdirectories (or cd to a subdirectory to check the files).
rdals -r dsnnn.n
If your current directory is in another data set directory, such as /glade/p/rda/data/ds277.7, you can pass a relative path to the target directory.
rdals ../dsnnn.n/ or rdals ../dsnnn.n/*