NCMERGE

Basic Information

Name of Program

NCMERGE

Version-Date

March 2024

Description-Date

September 2022

Catchwords

postprocessor
Merge contents of various netcdf.nc files
Change of time step for optional time-equidistant data records
Storage of the content of the ASCII input control files in netcdf.nc (as a variable)
Storage of the MD5 hash values of input files in netcdf.nc (as a variable)
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

The program enables merging variables from multiple netcdf.nc input files into one single netcdf.nc output file.

Input-Files

1. general input data (file type ncmerge.dat);
2. Input data, multiple files (file type cf-netcdf.nc).

Output-Files

1. Output data (file type netcdf.nc)
2. (optional) informative printer file of program execution (file type ncmerge.sdr)
3. (optional) trace of program execution (file type ncmerge.trc)

Methodology

The program is subdivided into the following sections:

1. Read, check and print the control data of the user;
2. Read metadata of the input data;
3. Transfer metadata into internal data objects;
4. Classification of all variables of the input files;
5. Determine transfer operations for primary variables;
6. Determine transfer operations for all other variables;
7. Comparison of the input data specified by the user with the data available in the input file;
8. Create common time coordinate variables for all output variables;
9. (optional) Adjustment of MD5 hash values between all input data files;
10. Copy the variables to be transferred from the input files to the output file.

Program(s) to run before this Program

DATACONVERT, BOE2NC, NCAGGREGATE, NCCHUNKIE, NCCUTOUT, NCRCATMAT, NetCDF Operators, UNK, UNTRIM2007, UNTRIM2

Program(s) to run after this Program

DAVIT, NCAUTO, NCAGGREGATE, NCANALYSE, NCCHUNKIE, NCCUTOUT, NCPLOT, NCPOLO, NC2TABLE, UNK, UNTRIM2007, UNTRIM2

Additional Information

Language

Fortran95

Additional software

none

Original Version

G. Lang, S. Spohr

Maintenance

Working group POS

Documentation/Literature

• IZW-Campus (Podcast, available in German only)
  • 2022-02-14: NCMERGE - Anwendung, Struktur, Code-Beispiele.
• Template Files:
  • template files available in $PROGHOME/examples/ncmerge

---

back to Program Descriptions

---

Overview