PLOTPROFILZEIT
From BAWiki
Basic Information
Name of Program
plotProfilZeit
Version-Date
Juli 2018
Description-Date
Juli 2018
Catchwords
Profile
Aggregation
Perzentile
Hovmoeller
ProfilZeit
MATLAB Kategorie:MATLAB stand-alone application
Short Description of Functionality
The application plotProfilZeit can be used to display data on profiles and time. Data can also be based on profiles in terms of adjascent control volumes.
plotProfilZeit is the predecessor of DISPLAY_PERCENTILES und DISPLAY_HOVMOELLER. DISPLAY_PERCENTILES and DISPLAY_HOVMOELLER had previously been developed to display data along a profile. However, both used the same data types and were different only in the way they presented the data. Therefore, to simplify application maintenance, both functionalities were incorporated into one application, plotProfilZeit. DISPLAY_PERCENTILES is still available, but will not be further developed. DISPLAY_HOVMOELLER not available anymore.
Possible ways to display data:
- Type = Hovmoeller: Data is displayed along the profile (x-axis) and along time (y-axis), by means of a hovmoeller plot.
- Type = Percentiles: Temporal variation of values on a profile can be shown by giving an average value (e. g. as a black solid line) and a confidence interval (grey area in background).
- Type = Allevents: All timesteps are being displayed as single lines.
- Type = Multidata: All events are displayed as single lines in the same graph.
Input formats:
- Input_Format = Xtrdata: Output of XTRDATA, available as single events along a profile, format being excel.dat
- Input_Format = CVMesh2 for Netcdf analysis results fuer Netcdf as well as aggregated but not analysed simulation results
- Input_Format = Mesh1 for Netcdf simulation output on profiles (DATACONVERT result of BDF profile file)
- Input_Format = Mesh0 for Netcdf results on profiles (Profile output of UnTRIM2009)
Error handling: In contrast to the prior version, this program does not yet include a check of the steering file by Fortran-Modul dictionary_ui. Therefore, wrong keywords can lead to uncontrolled crashes withou understandable error messages.
Input-Files
- Steering file (example in $PROGHOME/examples/plotProfilZeit, type plotProfilZeit_steer.dat)
- UNTRIM results in above mentioned formats.
Output-Files
- Figures (*.pdf, *.png, *.eps or *.fig)
- Excel sheet (optional)
Methodology
Visualization with MATLAB.
Further, some statistic values are calculated by the program in case of Type = Percentiles. This used the following Matlab functions:
- percentiles: prctile
- mean: nanmean (nan meaning that NaNs are not taken into account)
- median: nanmedian
- maximum: nanmax
- minimum: nanmin
Program(s) to run before this Program
XTRDATA, DATACONVERT, NCAGGREGATE, NCANALYSE, UNTRIM
Program(s) to run after this Program
Additional Information
Language
MATLAB (erstellt mit Version R2016b)
Additional software
Needs installation of MATLAB Compiler Runtime (under linux: /usr/local/MATLAB/MATLAB_Runtime/v85)
Original Version
Maintenance
Documentation/Literature
Examples can be found unter $PROGHOME/examples/plotProfilZeit/.
Descriptions of the method can be found here:
http://de.mathworks.com/help/stats/descriptive-statistics.html .
Thanks to Tabea Brodhagen, Marissa Albers und Jens Jürges.
back to Program Descriptions