NCAUTO

Basic Information

Name of Program

NCAUTO

Version-Date

August 2020

Description-Date

September 2022

Catchwords

data analysis
postprocessor
classification of variables in cf-netcdf.nc data files
minimum, mean and maximum value as well as number of valid data
automatic adjustment of number of READ data to chunk size of data
optional use of Message Passing Interface (MPI, MPI Forum)

Acknowledgment: This project took advantage of netCDF software developed by UCAR/Unidata (www.unidata.ucar.edu/software/netcdf/).

Short Description of Functionality

Program NCAUTO classifies and determines extreme and mean values for data stored in cf-netcdf.nc files:

1. classification of (geophysical) variables based on dimension name as well as dependence on time (as defined in CF attribute cell_methods);
2. minimum, mean and maximum value as well as number of valid data for all variables (all time steps);
3. locations of minimum as well as maximum;
4. time serie of minimum, mean and maximum values as well as number of valid data for all time-dependent variables.

For 2 and 3 the number of analysed variables can be (optionally) influenced through ASCII files include_only_variables.dat or exclude_variables.dat.

Just in case HDF error is detected during read of a data record, the program tries to reconstruct the wanted data set from adjacent (in time) records for the same variable. This type of repair works for time dependent variables only.

Input-Files

1. UGRID CF NetCDF data set (file type CF-NETCDF.NC);
2. (optional) list of variables to be included (file with fixed name include_only_variables.dat);
3. (optional) list of variables to be excluded (file with fixed name exclude_variables.dat).

Only one of files 2 and 3 is allowed to be present in the working directory. Invalid variable names are ingored.

Output-Files

1. classification of variables (file type all_class.<nc-inputfilename>.sdr)
2. (optional) file with minimum, mean and maximum value for all variables (file type all_stats.<nc-inputfilename>.sdr)
3. (optional) file with time serie of minimum, mean and maximum values as well as number of valid data for each variable (and fraction) of a file (file type var_stats.<nc-inputfilename>.<fraction-name>.sdr)
4. informative printer file of program execution (file type ncauto.sdr) with some useful informations about minimum, maximum, mean as well as locations of minimum and maximum.
5. trace of program execution (file type ncauto.trc)

Methodology

All variables contained in a file are read (time step by time step). Minimum, mean and maximum values as well as number of valid data are determined. Furthermore a classification for all geophysical variables is performed based on dimension names as well as their dependence on the time coordinate.

Program(s) to run before this Program

DATACONVERT, GRIDCONVERT, NCANALYSE, NCAGGREGATE, NCCUTOUT, NCDELTA, NCDVAR, NCMERGE, NetCDF Operators, UNTRIM2007, UNTRIM2

Program(s) to run after this Program

text editor

Additional Information

Language

Fortran95

Additional software

---

Original Version

G. Lang

Maintenance

Working group POS

Documentation/Literature

template files available in $PROGHOME/examples/ncauto

---

back to Program Descriptions

---

Overview