Actions

PLOTPROFILZEIT

From BAWiki

Revision as of 14:12, 13 September 2018 by imported>Zorndt Anna Christina (Created page with "{{ProgramDescription |name_de=plotProfilZeit |name=plotProfilZeit |version=Juli 2018 |version_descr=Juli 2018 |catchwords= Profile<br /> Aggregation<br /> Perzentile<br /> Hov...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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

  1. Steering file (example in $PROGHOME/examples/plotProfilZeit, type plotProfilZeit_steer.dat)
  2. UNTRIM results in above mentioned formats.

Output-Files

  1. Figures (*.pdf, *.png, *.eps or *.fig)
  2. 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

MATLABFIGVIEWER

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

A. Zorndt

Maintenance

A. Zorndt

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


Overview