The postprocessor mb_post may be used
to reformat the flow solution to
the TECPLOT, EnSight, MATLAB or GENERIC format or
it can be used to "probe" the flowfield at specified points.
The program is controlled via command-line arguments.
% mb_post.exe [-fp parameter_file] [-fg grid_file]
[-fs solution_file] [-fo output_file]
[-t time] [-all]
[-tecplot|-generic|-vtk|-ensight|-matlab|-save|-split]
[-rb] [-wb] [-rsplit]
[-mirror] [-logrho] [-logp]
[-xmin xmin] [-xmax xmax]
[-ymin ymin] [-ymax ymax]
[-nx nx] [-ny ny]
[-probe x y]
[-help]
The command-line options include...
- -fp parameter_file
- Input parameter file name.
Default is "default.p".
- -fg grid_file
- Grid file name.
Default is "default.g".
- -fs solution_file
- Flow solution file name.
Default is "default.s".
- -fo output_file
- The reformatted data is written to files whose names
have been constructed from this string.
Default is "post_out".
- -t time
- Solution time that is desired.
Default value is 0.0
If there are multiple times in the solution file,
solutions will be read and either discarded or written
until this specified time is exceeded.
- -all
- Request that all solutions be written up until the
specified final time.
To distinguish different solutions, a time tag is included
in the output file name. This tag is of the form
_0000nnnn where nnnn represents the time in microseconds.
There are 8 digits in the time tag which is zero-filled
from the left.
This should allow the written files to be easily sorted
in time order.
If the -all flag is not specified, solutions will be simply
discarded and no time tags will be added to the output name.
- -tecplot|-generic|-vtk|-ensight|-matlab|-save|-split
- Format for the output; choose one.
Default is none.
For -vtk,-tecplot and -generic, all of the flow data is
kept together.
For -matlab and -ensight,
each flow property is written to a separate file.
The MATLAB files contain data on a regular grid,
with the file for each flow variable
contains an matrix of values written in ASCII.
All other formats write the flow data at the centres of the
original (body-fitted) cells.
The -save option writes the data out in the same
format as found in the solution file.
This option is useful for extracting a single solution time
for restarting the integration process.
To output the solution, one block per file, use -split.
Individual blocks will be written to files with names
output_file.block.jb where jb is
the block index.
- -rb
- Read binary (unformatted) data from the grid and solution file.
By default, ASCII formatted data will be assumed.
- -wb
- Write the "saved" file as binary data.
By default, ASCII formatted data will be written.
Data formatted for the plotting packages are always in ASCII.
- -rsplit
- Read data from split grid and solution files.
By default, data will be assumed to come from the one (unsplit) file.
- -mirror
- Copy the data to produce a mirror image.
Default is not to produce a mirror image.
- -logrho
- Take log10 of density field.
Default is to retain the linear density range.
- -logp
- Take log10 of pressure field.
The default is to retain the linear pressure range.
- -probe x y
- Print (to standard output) flowfield data for the point
(x,y). Several points may be specified, but only one per
-probe flag.
For -matlab, the following options have meaning:
- -xmin xmin -xmax xmax
-ymin ymin -ymax ymax
- The limits for generating sample points.
Any combination may be specified.
Limits that are not specified by the user will be inferred
from the grid data.
- -nx nx -ny ny
- Number of increments in each of the x- and y-directions
for the MATLAB data.
The default is 10 for each.
- -q
- Print the usage hints to the console and the log_file.
The usual application of mb_post is for reformatting data
for subsequent plotting,
however, it can be used to extract (and save)
a particular solution time so that a simulation can be restarted.
MB_CNS (C) P. A. Jacobs
Last Updated 15-May-1999, 16-Jan-2002, 21-Oct-02, 11-Sep-04.