Actions

DIDASPLIT

From BAWiki

Basic Information

Name of Program

DIDASPLIT

Version-Date

V3.x / January 2001

Description-Date

September 2002

Catchwords

postprocessor
finite element grid
splitting of bathymetry (defined on a finite element grid)
splitting of data files (BDF-format) with respect to different spatial criteria
universal direct access format for 2D/3D-data
synoptic data
time-series data
analyses data

Short Description of Functionality

The program DIDASPLIT is a postprocessor for different numerical models (e.g. TRIM-2D, TRIM-3D, TELEMAC-2D, UNTRIM etc.). DIDASPLIT was designed to split results and/or bathymetry which are stored in

  • BDF-formatted files (see dirz.bin, description of the BDF file format is available in German only), where processed data can be either 2D or 3D synoptic data, time-series data or results from data analyses, and/or
  • splitting of a finite element grid file with bathymetric data.

The following criteria can be applied:

  1. sorting of data and/or topographic points which are either lying inside or outside an arbitrary polygon;
  2. sorting of data and/or topographic points which belong to a grid-cell of a regular raster grid.

For every subdomain (polygon or grid-cell) the corresponding data and/or topographic points are collected into a separate file in BDF-format or into a separate finite element grid file. If data given in BDF-format shall be splitted a grid file (for bathymetry) is generated for each subdomain in any case.

During one application of DIDASPLIT several sorting areas as well as data files can be handled at the same time.

Sorted results may be post processed in the same manner as this is the case for the overall original data set.

Input-Files

  1. general input data (filetype didasplit.dat)
  2. grid for the overall domain (filetype gitter05.dat/bin or filetype selafin or filetype untrim_grid.dat)
  3. (optional) original data for the overall domain (filetype dirz.bin.r, dirz.bin.i and dirz.bin)

Output-Files

  1. grids for subdomains (filetype gitter05.dat/bin)
    Notice: if on input a grid file of type selafin or untrim_grid.dat was specified by the user on output the grid files for the subdomains will be automatically of type gitter05.dat/bin.
  2. (optional) data for subdomains (filetype dirz.bin.r, dirz.bin.i and dirz.bin)
  3. informative printer file (filetype didamerge.sdr)
  4. (optional) trace of program execution (filetype didamerge.trc)
    Notice: In situations when DIDASPLIT was terminated before the normal end of the program was reached the job can be submitted again. Outputfiles for subdomains which are already present will not be generated a second time. Missing outputfiles will be newly generated. It is recommended to remove outputfiles from the working directory which have been generated immediately before abnormal program termination took place.

Methodology

In dependence of the input data specified by the user a list of nodes which are lying inside or outside the subdomain of interest (specified as a polygon or grid-cell of a regular grid) is generated first. To this list some nodes may be added which do belong to triangles which have intersections with segments of the polygon defining the subdomain.

From these points a new grid is generated for the subdomain which is stored subsequently in a file. Later all data sets which are belonging to the sorted nodes are copied into the output data file for the subdomain area if desired.

Program(s) to run before this Program

DATACONVERT, DIDAMERGE, DIDAMINTZ, DIDARENAME, ENERF, FRQWF, LZKAF, LZKMF, LZKSF, LZKVF, LZKWF, METDIDA, PGCALC, TELEMAC-2D, TM2DIDA, TR2DIDA, TR3DIDA, TDKLF, TDKSF, TDKVF, TDKWF, TRIM-2D, TRIM-3D, UNS, UNTRIM, VTDK, ZEITR

Program(s) to run after this Program

ABDF, DIDAMERGE, DIDAMINTZ, DIDARENAME, ENERF, FRQWF, GVIEW2D, HVIEW2D, IO_VOLUME, LZKAF, LZKMF, LZKSF, LZKVF, LZKWF, PGCALC, TDKLF, TDKSF, TDKVF, TDKWF, UNS, VTDK, XTRDATA, XTRLQ2, ZEITR

Additional Information

Language

Fortran90

Additional software

-

Original Version

G. Lang

Maintenance

G. Lang, E. Rudolph

Documentation/Literature

for template files see $PROGHOME/examples/DidaSplit/

If you are going to display your DidaSplitted results using e.g. the program HVIEW2D you may profit from reading the article Das Skript SplitScript published in No. 3/1998 of Supercomputing News (available in German only) before proceeding with your work.


back to Program Descriptions


Overview