vtkToolbox

版本 1.0.0 (87.6 MB) 作者: Steffen Schuler
A MEX interface to the VTK library. It provides MATLAB functions to read and write VTK files and to apply VTK filters to datasets.
3.0
(2)
2.2K 次下载
更新时间 2022/1/18
在 GitHub 上查看许可证

vtkToolbox for MATLAB

Overview

vtkToolbox is a MEX interface to the VTK library. It provides functions to read and write VTK files and to apply VTK filters to VTK datasets. Currently, two types of datasets are supported: vtkPolyData and vtkUnstructuredGrid (both represented as vtkPointSet). The toolbox is based on two functions for converting a vtkPointSet into a MATLAB struct and vice versa: vtkToStruct() and structToVtk().

Format of the MATLAB struct

The following format is used to represent a VTK dataset as a MATLAB struct:

myStruct.points:    [numPoints x numDim double/single/(u)intN], numDim <= 3
myStruct.cells:     [numCells x maxNumPointsPerCell int32]
myStruct.cellTypes: [numCells x 1 uint8] (see https://vtk.org/doc/nightly/html/vtkCellType_8h_source.html)
myStruct.pointData: [1 x 1 struct of point data arrays] (optional)
myStruct.cellData:  [1 x 1 struct of cell data arrays]  (optional)
myStruct.fieldData: [1 x 1 struct of field data arrays] (optional)

File input/output

The functions vtkRead() and vtkWrite() can be used to read and write various types of files supported by the VTK library.

Filters

The general procedure used by filters in the toolbox is:

  • A MATLAB struct is passed to the MEX function and converted into a vtkPointSet using structToVtk().
  • Desired VTK filters are applied to the vtkPointSet.
  • The vtkPointSet is converted back to a MATLAB struct using vtkToStruct() and returned by the MEX function.

Building the MEX functions

Before you can use the toolbox, you first have to compile the MEX functions for your platform:

  • Install VTK (either using a package manager or from source – see https://vtk.org/Wiki/VTK/Configure_and_Build)
  • Compile the MEX functions using CMake. In the folder "vtkToolbox", run: 
    mkdir build
cd build
cmake ..
make

Adding new functions

The functionality of the toolbox can easily be extended by creating and compiling new functions:

  • Duplicate the folder vtkTEMPLATE and replace "TEMPLATE" in file names and the cxx file.

  • Adapt the cxx file by parsing the needed inputs and adding the desired operation(s) or filter(s) to the section "Apply operations to pointSet".

  • Rerun CMake after adjusting "CMakeLists.txt" as follows:

    • Add a new line with all C++ source files of your MEX function to the section "Build MEX functions".
    • You might have to add more VTK components under the section "Set up VTK dependency".

  • Duplicate MATLAB/vtkTEMPLATE.m and adapt it accordingly. This script is only needed for providing a function help and a function hint.

License

All source code is subject to the terms of the Mozilla Public License, v. 2.0.
Copyright 2020 Steffen Schuler, Karlsruhe Institute of Technology.

Contact

Steffen Schuler
Institute of Biomedical Engineering
Karlsruhe Institute of Technology
www.ibt.kit.edu

引用格式

Steffen Schuler (2024). vtkToolbox (https://github.com/KIT-IBT/vtkToolbox), GitHub. 检索来源 .

MATLAB 版本兼容性
创建方式 R2021a
兼容任何版本
平台兼容性
Windows macOS Linux
标签 添加标签

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

MATLAB

MATLAB/S2-Sampling-Toolbox

无法下载基于 GitHub 默认分支的版本

版本 已发布 发行说明
1.0.0

要查看或报告此来自 GitHub 的附加功能中的问题，请访问其 GitHub 仓库。
要查看或报告此来自 GitHub 的附加功能中的问题，请访问其 GitHub 仓库。