#parser #writer #io #mesh #vtk

vtkio

Parser and writer for the legacy VTK file format

13 releases

✓ Uses Rust 2018 edition

new 0.2.4 Sep 10, 2019
0.2.3 Aug 7, 2019
0.2.1 Apr 6, 2019
0.2.0 Mar 11, 2019
0.1.3 Aug 28, 2018

#4 in #writer

Download history 21/week @ 2019-06-02 20/week @ 2019-06-09 25/week @ 2019-06-16 125/week @ 2019-06-23 50/week @ 2019-06-30 51/week @ 2019-07-07 10/week @ 2019-07-28 48/week @ 2019-08-04 21/week @ 2019-08-11 2/week @ 2019-08-18 17/week @ 2019-08-25 26/week @ 2019-09-01

132 downloads per month

MIT/Apache

86KB
2K SLoC

vtkio

A parser and writer for the Visualization Toolkit (VTK) legacy file format.

On crates.io On docs.rs Build status

This is meant to be a feature complete parser of the legacy VTK file format. However, I have only used this parser for tetrahedral and triangle meshes, and I am still lacking real world tests. Pull requests welcome.

This parser is written using nom.

Examples

There are many sample files can be found in the assets directory. For the following example, we will load a VTK file named tet.vtk, modify it and write it back in ASCII VTK format.

extern crate vtkio;
use vtkio::model::*; // import model definition of a VTK file
use vtkio::{import, export_ascii};
fn main() {
    use std::path::PathBuf;
    let file_path = PathBuf::from("tet.vtk");
    
    let mut vtk_file = import(&file_path)
        .expect(&format!("Failed to load file: {:?}", file_path));
    
    vtk_file.version = Version::new((4,2)); // arbitrary change

    export_ascii(vtk_file, &file_path)
        .expect(&format!("Failed to save file: {:?}", file_path));
}

Notes

If you are working with binary files produced by ParaView, it is likely that they will be written in big endian format regardless of your platform. To load binary files in a specific endianness, use the import_le and import_be functions for little and big endian files respectively.

License

This repository is licensed under either of

at your option.

Dependencies

~2MB
~44K SLoC