ReadVis5DTopography

Synopsis

This module reads a Vis5D Topography file and creates the ground surface that covers the area of the corresponding data file.

Input Ports

Name Type Description

Vis5Dfile string Name of the Vis5D data file.
Vis5Dxform group Field structure that is used to align the Topography information on.

Parameters

ReadVis5DTopographyParams
Name Type Description UI Control

topofile string Name of the Vis5D Topography file to read. File Dialog
subsampling int Factor to reduce the number of points of the resulting grid. Slider
show_topo boolean Decides if the topography output is shown. Toggle
min_height float minimum height of the output field. UIField

Output Ports

Name Type Description

fld Mesh+group The terrain that covers the same area of the Vis5D data file.
obj DataObject directly renderable object of the terrain.

Description

This module reads a Vis5D Topography file using the Vis5D data-file to specify the area to read.

Inputs

Vis5Dfile

Name of the Vis5D data file the Topography file should be attached to. This input port can be connected to the filename output port available on the ReadVis5D user macro.

Vis5Dxform

This Field structure is used to align the Topography information on. This input port can be connected to the vars3d_out output of the ReadVis5D user macro. The xform information is used in the output field of the ReadVis5DTopography macro.

Parameters

ReadVis5DTopographyParams

topofile

String parameter that specifies which Vis5D Topography file should be read. The filename string should contain the full path name of the file and can contain any of the AVS/Express environment variables (e.g. $XP_PATH<1>)

subsampling

This int value contains the factor to reduce the number of points of the resulting grid.

show_topo

This boolean value decides if the topogrphy output is shown or not. If this value is 0 the ReadVis5DTopography does not output any data.

min_height

This float value sets the minimum height value of the output field. All height values below this are lifted to this value.

Outputs

fld

This mesh contains the geometry and node data information for the Topography of the terrain that covers the same area as the Vis5D data file.

obj

Directly renderable object of the data stored in fld.

Utility Macros

The ReadVis5DTopographyFunc functional macro uses the low-level ReadTopoCore module. The macro takes as input the parameter block ReadVis5DTopographyParams. The macro outputs the data read from the Vis5D Topography file as Field Structures and directly renderable objects.

The ReadVis5DTopographyFunc functional macro and the ReadVis5DTopographyUI user interface macro are both used by the ReadVis5DTopography user macro. All of these macros use the ReadVis5DTopographyParams parameter block to communicate.

Example

The project includes an example application that demonstrates the use of the ReadVis5DTopography macro. The ReadVis5DTopographyEg application uses the ReadVis5D macro to read a Vis5D file and a ReadVis5DTopography to read the Vis5D Topography file. The Example contains two isosurface modules a bounds and an orthoslice module to show the inner structure of the fields array which is read by the ReadVis5D and ReadVis5DTopography macro.

Files

iac_proj/rd_vis5d/rv5dmods.v contains the V definitions of the ReadTopoCore module and the ReadVis5DTopographyParams parameter block.

iac_proj/rd_vis5d/rv5dmacs.v contains the V definitions of the ReadVis5DTopographyUI UI macro, the ReadVis5DTopographyFunc functional macro and the ReadVis5DTopography user macro.

iac_proj/rd_tecpl/rv5dapps.v contains the V definition of the ReadVis5DTopographyEg and ReadVis5DStreamlinesEg example applications.

Other Notes

The low-level ReadVis5DMods library containing the low-level module ReadTopoCore does not specify a process. By default the express process will be used.

Author

Mario Valle, AVS Italy
Dr. Jean M. Favre, 
CSCS, Swiss Center for Scientific Computing 

Modifications

Tobias Schiebeck,
International AVS Centre

Contact

International AVS Centre
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL

See Also

Vis5D website

ReadVis5D