XTRDATA

Basic Information

Name of Program

XTRDATA

Version-Date

June 2020

Description-Date

August 2003

Catchwords

postprocessor
data conversion
universal direct access format for 2D/3D-data
universal direct access format for profile-data
universal direct access format for data at specific locations
extraction of binary time-series data into ASCII-format
extraction of binary profile-data into ASCII-format (longitudinal profiles)
extraction of binary 3D-data into ASCII-format (vertical profiles)
extraction of cross sectionally averaged or integrated data
time-varying (morpho-) dynamic bathymetry
treatment of several variants for a physical quantity

Short Description of Functionality

The program XTRDATA is a postprocessor which is model-independent. It was designed to extract data at some given locations from binary direct access data files (time-series data as well as profile-data). The input-files can contain either area-, volume-, location- or profile-data (calculated data or results from various data analyses). The following data can be processed:

• results given as time-series data, or
• profile data for

• synoptic data sets,
• results from various data analyses and
• results from comparisons between data analyses for different scenarios.

• cross sectionally averaged or integrated data sets,

• synoptic data sets,
• results from various data analyses and
• results from comparisons between data analyses for different scenarios.

• 3D-data for

• synoptic data sets,
• results from various data analyses and
• results from comparisons between data analyses for different scenarios.

For each physical quantity several variants can be treated (e.g. different fractions of suspended sediment) at the same time. Data can be extracted for any number of locations of varying type, namely:

• 2D-Locations (x,y): for depth-averaged 2D data sets,
• profile master point (2D-location): for cross sectionally averaged or integrated data,
• 3D-Locations (x,y,z): for 3D data sets,
• longitudinal profile-data (at the surface, at the bottom, at a constant depth or in a computational layer): for profile data,
• longitudinal sections of cross sectionally averaged or integrated data (aligned data at so called profile master points), or
• vertical profile-data: for 3D data sets

The extracted data can be later used in one of the following applications:

• graphical display of time series using GKS-programs (filetype boewrt.dat)
• usage inside the spread sheet program EXCEL (filetype excel.dat)
• graphical display and data analysis inside the XY plotting program ACE/gr (filetype xmgr.dat)

Input-Files

1. general input data (filetype xtrdata.dat)
2. result files (filetype dirz.bin.r, dirz.bin.i and dirz.bin))
3. grid for 2D/3D-data (filetype gitter05.dat/bin or filetype untrim_grid.dat)
   or profile-topography for profile-data (filetype profil05.bin)
   or system file for specific locations (filetype location_grid.dat)
4. several other files are necessary to define the 2D-or 3D-Locations or profiles where data shall be extracted (see documentation for the file XtrData.dat)

Output-Files

1. (optional) extracted time-series data in ASCII-format (files of type excel.dat, xmgr.dat or boewrt.dat)
2. (optional) extracted profile-data (longitudinal or vertical profiles) in ASCII-format (files of type excel.dat or xmgr.dat)
3. informative printer file (filetype XtrData.sdr)
4. (optional) trace of program execution (filetype XtrData.trc)

Methodology

For every 2D- or 3D-Location or profile the desired data are extracted from the original binary direct access files. As far as time-series or vertical profiles are concerned, the results are interpolated from the results at the three nearest neighbour nodes. Therefore the output locations need not to coincide with the nodes of the computational grid. Data along profiles are taken as they are stored in the binary data file. Cross sectionally averaged or integrated data are taken directly from the so called profile master point to which data are attached.

Program(s) to run before this Program

ADCP2BDF, ADCP2PROFILE, DATACONVERT, DIDAMINTQ, DIDASPLIT, FRQWF, LZKMF, LZKSF, LZKVF, LZKWF, VTDK, TDKLF, TDKSF, TDKVF, TDKWF, TELEMAC-2D, TIMESHIFT, TRIM-2D, TRIM-3D, UNS, UNTRIM, XTRLQ2, ZEITR

Program(s) to run after this Program

ACE/gr-Applications, EXCEL-Applications, FFT, TIDKEN, TSCALC, DISPLAY_PERCENTILES, PLOTPROFILZEIT

Additional Information

Language

Fortran90

Additional software

-

Original Version

G. Lang

Maintenance

G. Lang

Documentation/Literature

please refer to $PROGHOME/examples/XtrData/

---

back to Program Descriptions

---

Overview