#gmsh #cli #medical #physics #eg-snrc

bin+lib dose2gmsh

Convert EGSnrc 3ddose files to Gmsh mesh files

3 releases (stable)

1.0.1 Oct 2, 2020
0.1.0 Feb 9, 2020

#367 in Visualization


277 lines


Crates Docs

Convert EGSnrc 3ddose files for visualization in Gmsh.

Check out the API documentation.


# convert input.3ddose to msh
$ dose2gmsh input.3ddose

# convert input.3ddose to csv
$ dose2gmsh input.3ddose --format=csv

# specify the output file name
$ dose2gmsh input.3ddose  --output-file=doses

$ dose2gmsh --help 

dose2gmsh 1.0.1
Max Orok <maxwellorok@gmail.com>
Convert dosxyznrc 3ddose files to Gmsh msh files

    dose2gmsh [OPTIONS] <input-file>

    -h, --help       Prints help information
    -V, --version    Prints version information

    -f, --format <format>              The output format (msh2 or csv) [default: msh2]
    -o, --output-file <output-file>    The output file name, defaults to <input_file>

Supported formats

  • Gmsh mesh version 2 [.msh]
  • csv [.csv]


You'll need cargo, the Rust package manager to get started.

Install using cargo install.

$ cargo install dose2gmsh

You can update your installation with cargo install --force.

Adding output formats

dose2gmsh parses 3ddose files into a intermediate DoseBlock structure. After parsing, it writes the DoseBlock data to an output file.

You can add an output format by implementing a new DoseBlock::write* method. Use DoseBlock::write_msh2 as a starting point.

If you'd like help implementing a new output format, open an issue.


~55K SLoC