NAME
r.out.vtk - Converts raster maps into the VTK-Ascii format
SYNOPSIS
r.out.vtk
r.out.vtk help
r.out.vtk [-stv] input=string[,string,...] [elevation=string] [rgbmaps=string[,string,...]] [output=string] [null=float] [elevscale=float]
Flags:
- -s
- Use structured grid for elevation (not recommended)
- -t
- Use polydata-trianglestrips for elevation grid creation
- -v
- Use polydata-vertices for elevation grid creation (to use with vtkDelauny2D)
Parameters:
- input=string[,string,...]
- Raster map(s) to be converted to VTK-ASCII data format
- elevation=string
- Raster map that represents the elevation, used for the 3D information
- rgbmaps=string[,string,...]
- 3 raster maps (r,g,b) which are used to create rgb values [redmap,greenmap,bluemap]
- output=string
- Name for VTK-ASCII output file
- null=float
- Value to represent no data cell
- Default: -10.0
- elevscale=float
- Scale factor for elevation
- Default: 1.0
DESCRIPTION
Outputs Raster maps in VTK-ASCII format. Map's are
valid Raster map's in the current mapset. output is the name of
an VTK-ASCII file which will be written in the current working directory.
If output is not specified then stdout is used.
The module is sensitive to region settings (set with g.region).
Special features are, that elevation and RGB Data are supported.
The data and rgb values are mapped to the created 2.5D grid.
The RGB input requires 3 raster maps: red, green, blue - in this order.
The maps must! have values between 0 and 255, if not you will get lots of warnings!
More than 1 RGB Dataset (3 maps) is not supported. For now, RGB is only supported if
you choose an input map too, that may be changed in the future.
NOTES
This filter generates structured points with celldata if no elevationfile is given
and a structured grid (not recommendet) or a polydataset (default) with pointdata if an elevationfile is given and put
this in a simple VTK-ASCII file. Nor XML or
binary output are supported. It is possible to choose more then one raster map
to be written in the VTK-ASCII file. Each cell-/pointdata is named like the raster map it represents.
You can visualize this file with the
VTK Toolkit,
Paraview and
MayaVi which are based on VTK.
If you have a raster map with partly no data, use the threshold filter in paraview to
visualize the valid data. Just filter all data which is greater/lesser than the
choosen null value in the VTK-ASCII file.
If elevation is choosen, a polygonal grid is created with quads, but the user can choose triangle strips and
vertices. These dataformats a documented at VTK Toolkit.
SEE ALSO
r3.out.vtk
r.out.ascii
g.region
AUTHORS
Soeren Gebbert
Last changed: $Date: 2005/08/31 09:10:15 $
Main index - raster index - Full index