TRIMKACH: Difference between revisions
From BAWiki
imported>BAWiki 3 mNo edit summary |
Günther Lang (talk | contribs) (working group POS) |
||
| (2 intermediate revisions by one other user not shown) | |||
| Line 3: | Line 3: | ||
|name=TRIMKACH | |name=TRIMKACH | ||
|version=V 2.x | |version=V 2.x | ||
|version_descr= | |version_descr=September 2022 | ||
|catchwords=postprocessor<br /> | |catchwords=postprocessor<br /> | ||
finite difference method<br /> | finite difference method<br /> | ||
| Line 57: | Line 57: | ||
A short help is available executing "trimkach.[ext] h" on the commandline. | A short help is available executing "trimkach.[ext] h" on the commandline. | ||
|preprocessor=[[TRIM-2D]], [[TRIM-3D]] | |preprocessor=[[TRIM-2D]], [[TRIM-3D]] | ||
|postprocessor=[[TR2DIDA]], [[TR3DIDA, [[TR2GEOM]] | |postprocessor=[[TR2DIDA]], [[TR3DIDA]], [[TR2GEOM]] | ||
|language=UNIX-commands | |language=UNIX-commands | ||
AWK | AWK | ||
|add_software=AWK | |add_software=AWK | ||
|contact_original= | |contact_original=P. Schade | ||
|contact_maintenance=[mailto: | |contact_maintenance=[mailto:pos.proghome@baw.de Working group POS] | ||
|documentation= | |documentation=$PROGHOME/examples/trimkach/ | ||
}} | }} | ||
Latest revision as of 11:45, 6 September 2022
Basic Information
Name of Program
TRIMKACH
Version-Date
V 2.x
Description-Date
September 2022
Catchwords
postprocessor
finite difference method
numerical model TRIM-2D
numerical model TRIM-3D
extraction of data
diskspace
Short Description of Functionality
The shell-script TRIMKACH is a postprocessor for the numerical models TRIM-2D and TRIM-3D. It permanently looks for resultfiles. If it finds at least one file, the suitable extraction-program will be started, either TR2KACHEL or TR3KACHEL. They will extract bathymetry, index-arrays and model results inside of rectangular tiles and optionally delete the results of the overall area. This deletion is recommended in order to reduce the diskspace used by the model results. Only the smaller extracted resultfiles remain. Furthermore you can start TRIMKACH before the model has terminated execution. TRIMKACH is able to extract data while the model is still running and producing new results.
Input-Files
Input-Files for extracting TRIM-2D-data:
- general input data (filetype tr2kachel.dat)
- on SGI a batch-file of type tr2kachel.qsub
- bathymetry and TRIM-2D-index-arrays (filetype tr2.topo.bin.ind)
- model results (filetype tr2.result)
Input-Files for extracting TRIM-3D-data:
- general input data (filetype tr3kachel.dat)
- on SGI a batch-file of type tr3kachel.qsub
- bathymetry and TRIM-2D-index-arrays (filetype tr2.topo.bin.ind)
- TRIM-3D-index-arrays (filetype tr2.topo.bin.i3d)
- (optional) model results (filetype tr3.result)
Output-Files
Output-Files after extraction of TRIM-2D-data:
- bathymetry and TRIM-2D-index-arrays for the tile(s) (filetype tr2.topo.bin.ind)
- model results for the tile(s) (filetype tr2.result)
- informative printer file (filetype tr2kachel.sdr)
- (optional) trace of program execution (filetype tr2kachel.trc)
Output-Files after extraction of TRIM-3D-data:
- bathymetry and TRIM-2D-index-arrays for the tile(s) (filetype tr2.topo.bin.ind)
- TRIM-3D-index-arrays for the tile(s) (filetype tr2.topo.bin.i3d)
- (optional) model results for the tile(s) (filetype tr3.result)
- informative printer file (filetype tr3kachel.sdr)
- (optional) trace of program execution (filetype tr3kachel.trc)
Methodology
At first you have to start trimkach_inst.sh to copy trimkach.[ext] and some input files into the working directory. Then you are able to edit the input files and to adapt the specified parameters in trimkach.[ext]. The extension [ext] can be "SGI" or "hp". An important parameter is TRIM23 which decides whether TRIMKACH processes 2D- or 3D-data. The parameter LOESCH should be handled with care. After setting LOESCH="LOESCHEN" and successful extraction of data the overall resultfiles are deleted. The user should watch the processing in the beginning because wrong parameters do not stop the script.
Similar to a "daemon" the shell-script starts a process whenever it finds a result file. Opposite to a "daemon" TRIMKACH can be stopped automatically. There are two ways to terminate the script:
- the product of WARTE_S * MAXSUCH determines the runtime in seconds;
- LETZTE_RES contains a string with the time of the last TRIM-2D- or TRIM-3D-result that should be processed.
A short help is available executing "trimkach.[ext] h" on the commandline.
Program(s) to run before this Program
Program(s) to run after this Program
Additional Information
Language
UNIX-commands AWK
Additional software
AWK
Original Version
P. Schade
Maintenance
Documentation/Literature
$PROGHOME/examples/trimkach/
back to Program Descriptions