Overview | All Modules | Tutorial | User's Guide | Programming Guide

COVISE Online Documentation


Module category: IO



ReadTascflowTDI

The module reads data sets written by CFX-TASCflow versions 2.7-2.10. It needs the informations contained in the grid (GRD), block-off and boundary condition (BCF) and results (RSO) files.

ReadTascflowTDI.png

ReadTascflowTDI is available for COVISE snapvir-2001-01 and higher. It's tested on SGI systems.

SGI and HP only - no LINUX support

Parameters

Name Type Description
steprsopath Browser The first timestep results (RSO) file location. This parameter is optional and it should contain at least one digit. The following timesteps results files will be detected and read automatically during the execution and the number of them should be set in 'timesteps' parameter.
gridpath Browser The basic grid (GRD) file location. Immediately after the grid file was selected, ReadTascflowTDI starts reading the 'database' to gain information. This might take some time for large data sets. The parameters region_names, vector_data, scalar_data are updated and you can select the data you want to have at the corresponding output ports after the 'database' is completely indicated (you have introduced all desired input files: GRD,RSO,BCF).
rsopath Browser The results (RSO) file location. This parameter is optional. Immediately after the results file was selected, ReadTascflowTDI starts reading the 'database' to gain information. This might take some time for large data sets. The parameters region_names, vector_data, scalar_data are updated and you can select the data you want to have at the corresponding output ports after the 'database' is completely indicated (you have introduced all desired input files: GRD,RSO,BCF).
bcfpath Browser The block-off and boundary condition (BCF) file location. This parameter is optional. Immediately after the BCF file was selected, ReadTascflowTDI starts reading the 'database' to gain information. This might take some time for large data sets. The parameters region_names, vector_data, scalar_data are updated and you can select the data you want to have at the corresponding output ports afterthe 'database' is completely indicated (you have introduced all desired input files: GRD,RSO,BCF).
timesteps Scalar The desired number of timesteps. This parameter is optional, but when it is used, you should indicate also the first timesteps results file in 'steprsopath' parameter.
skipped_files Scalar The desired number of skipped timesteps files. This parameter is optional and it's useful when you have a big number of timesteps files and you want to skip some of them.
region_names Choice The name of the region to be highlighted.
show_region Choice The color to be used to highlight the region.
vector_data_1 Choice The first vector data for the corresponding output port.
vector_data_1 Choice The second vector data for the corresponding output port.
scalar_data_1 Choice The first scalar data for the corresponding output port.
scalar_data_2 Choice The second scalar data for the corresponding output port.
scalar_data_3 Choice The third scalar data for the corresponding output port.

Output Ports

Name Type Description
outputgrid StructuredGrid The grid: a (set of) structured grids
outputblock IntArr Block off information: a set of integer arrays.
outputregion Lines
StructuredGrid
The region: a set of lines which emphasize the region.

outputvector1

Vec3 The vector data set as selected with 'vector_data_1' parameter.
outputvector2 Vec3 The vector data set as selected with 'vector_data_2' parameter.
outputdata1 Float The scalar data set as selected with 'scalar_data_1' parameter.
outputdata2 Float The scalar data set as selected with 'scalar_data_2' parameter.
outputdata3 Float
Float
The scalar data set as selected with 'scalar_data_3' parameter.
outputbcf_polygons Polygons The polygons read from the BCF file to be removed.

Examples

Figure: covise/net/examples/ReadTascflowTDI.net
ReadTascflowMap.png

ReadTascflowTDI reads a dataset from 3 files /covise/data/examples/general/tascflow/grd for the grid, /covise/data/examples/general/Tascflow/rso for the results file and /covise/data/ examples/general/Tascflow/bcf for block-off and boundary condition. With the choise parameter vector_data_1 we have selected _UVW_ (velocity) for the output port vector1 and P (pressure) for output port scalar1. DomainSurfaceStr is connected to the output port grid and computes the outer surface of the set of structered grids. The EliminatePolygons module is connected with the bcf_polygons of the ReadTascflowTDI module and surface output port of the DomainSurfaceStr module and eliminates the walls between the surfaces of the grid.

If you want to eliminate the block off regions, the second output port (block) should be connected to StoU module which will do the conversion from structured to unstructured objects. This objects will be connected to SelectUsg module and its parameter Selection will be set to 0.

The module Color maps the selected data to colors and through the Collect module which is connected to the Renderer, the colored surface is displayed in the Renderer. For visualizing the selected vector data we use the TracerStr module which computes particle traces as lines. The particle traces starts on a line defined with startpoint_1 and startpoint_2. (Hint: To see these particle traces, cut off part of the geometry by using the Renderer option Viewing » clipping plane with Point (0.000,0.1500,0.000) and Normal (0.000,1.000,0.000))

For highlighting the regions, you should connect the third port (region) directly to the Renderer after selecting the desired region in region_names parameter (for example PIP_S). You can select also the color in region_color parameter. (Hint: To see this highlighted region as shown in the second renderer image, cut off part of the geometry by Viewing » clipping plane with Point (0.000,0.0500,0.000) and Normal (0.000,1.000,0.000) and select color=white)

If the data set contains timesteps files and you want to use them, then select the first file of timesteps in steprsopath and write the desired number of steps in timesteps parameter. If you would like to skip some files, indicate the desired number of skipped files for each step in skipped_files parameter (if you write 1, for example, then every second file will be read).

The resulting grid and data can be observed in the next pictures of the Renderer. The second picture shows an interface between grids and a highlighted region.

ReadTascflowTDIRenderer1.png

ReadTascflowTDIRenderer2.png

If there are some memory allocation problems which can occur in the TDI routines because of some large data sets, you could increase the value of RWK, IWK and CWK in the section ReadTascflowTDI of covise.config file.


Authors: Martin Aumüller, Ruth Lang, Daniela Rainer, Jürgen Schulze-Döbold, Andreas Werner, Peter Wolf, Uwe Wössner
Copyright © 1993-2016 HLRS, 2004-2014 RRZK, 2005-2014 Visenso
COVISE Version 2016.3