Introduction

It is recommanded to copy the Toolbox first in your Matlab working directory and then start Matlab in for example ../matlab/work/Toolbox_Anaflame typing the command Matlab. In order to run your skripts you have to set search pathes. At present all tools are included in a relative search path. To define new search pathes use the Matlab commmand addpath('..name') in the Command window or File - Set Path - Add Folder in the menu bar.

To import foreign data for example data coming from tecplot use the Import Wizard. To call the Import Wizard type the Matlab command uiimport in the Command Window or use File - Import Data in the menu bar. In the Wizard you can select the data you want to import from your data set. For example you only want to import the variables but not the text data. By default all variables are selected. Save your data as name.mat.

The toolbox needs variables given in square or cube matrix form. If your variables are given as a column vector (VTP) for example when coming from tecplot use the matlab tool reshape (VTP,L,C) or reshape (VTP, L,C,P) in order to produce a matrix, where L is the number of lines, C is the number of columns, and P is the number of pages.

The toolbox developed in this project is intended for post-processing data produced on a rectangular or cubic monotonic grid. Values obtained on an irregular grid must be interpolated on a monotonic grid before continuing for example using the Matlab tools interp2 and interp3.

The toolbox further expects a domain with axes defined by vectors and not a domain given in meshgrid form. If your domain is given in meshgrid form use the toolbox tool meshtovect in order to obtain the corresponding vectors.

The post-processing toolbox consists of two main groups.

  • The first group contains the tools for post-processing 2d-results.

  • The second group contains the tools for post-processing 3d-results

Each group can be divided into six sub-groups:

  • tools for a direct geometrical analysis of the raw data:

    • for example to define and locate the flame front,
    • to compute important parameters like flamelength, flame surface and flame thickness,
    • to find crestlines or crest-surfaces
    • and to find normal vectors.

  • tools to investigate the flame structure:

    • for example to extract the computed variables along the flame front
    • to draw linear or non-linear cuts through the flame front,

    • to extract the variables along these cuts,

    • to compute integral values along these cuts,

    • tools to compute the flame index to distinguish between premixed and non premixed types of flames,

    • to compute mixture fractions for non-premixed flames

    • or reaction progress variables for premixed flames

  • tools for the statistical investigation of variables of interest:

    • for example tools to compute moments of order one to four,

    • tools to plot univariate histograms and pdf's of the distributions of one variable,

    • tools to plot bivariate histograms and pdf's of the distributions of two variables,

    • tools to compute conditional mean and rms values,

    • tools to compute correlations of variables extracted along the flamefront or along cuts

  • tools to investigate the interaction between flames and turbulence

    • for example tools to compute strain-rate

    • tools to calculate 2D or 3D-curvatures

    • a tool to calculate the shape factor

  • tools to investigate velocity fields and turbulence

    • for example tools to visualize stream lines,

    • tools to calculate the turbulent kinetic energy,

    • tools to calculate velocity fluctuations,

    • tools to calculate the dissipation rate of the turbulent kinetic energy,

    • tools to calculate the energy spectrum,

    • tools to calculate and plot vorticity fields,

    • tools to calculate turbulent scales,

    • tools to calculate velocity correlation functions,

    • an LES filter tool

  • tools to investigate manifold dimensions

    • for example tools to find nearest neighbours in composition space,

    • a tool for singular value decompositions and lower dimensional reconstructions,

    • a tool to determine correlations between original and reconstructed values,

    • a tool to determine normalized deviations between original and reconstructed values,

  • Some tools running in a batch modus (for example the calculation of flame thickness or integral values along the flame front) are very time consuming. In order to reduce computing time for such cases these scripts are parallelized.

Do not hesitate to have a look in the Example_2D or in the Example_3D to get to know how to use the toolbox.

Letzte Änderung: 11.03.2020 - Ansprechpartner: Dominique Thevenin