Crack open RiSCAN PRO xml project files.
Switch branches/tags
Clone or download
Latest commit c4af70b Oct 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Search through each scanpos when finding Oct 18, 2017
src Add POP and SOP export options Jan 29, 2018
.gitignore v0.2.0 Oct 13, 2017
.travis.yml Initial commit with Project::from_path Aug 29, 2016
Cargo.toml upgrade nalgebra Oct 28, 2018
LICENSE.txt Add some basic metadata stuff Jan 19, 2017
README.md Update README Jan 29, 2018
clippy.toml Clippy Oct 13, 2017
rustfmt.toml Complete rewrite Jan 19, 2017

README.md

riscan-pro

Read information from RiSCAN PRO project files.

Build Status riscan-pro

RiSCAN Pro is software developed by Riegl for terrestrial LiDAR scanning. RiSCAN Pro stores most project metadata, e.g. calibration and transformation matrices, in a xml file inside of the RiSCAN Pro project directory. This is a Rust library and executable for reading these xml files and extracting the good bits.

This project is not created by Riegl and no support from them is provided or implied. Please do not contact Riegl about this software.

Installing the binary

To use riscan-pro from the command line, you'll need to get Rust. Once you've got that, installation is simple:

cargo install riscan-pro

In case there's changes on Github that haven't been pushed to crates.io yet, you can also install straight from Github:

cargo install --git https://github.com/gadomski/riscan-pro

Using the binary

As of this writing, the binary can do three things.

1. Print some project information as json

This can be useful in case you want in ingest the project information downstream and don't want to parse all that icky xml:

riscan-pro path/to/myproject json

2. Save all the SOP matrices to .dat files

Exporting the SOP matrices from a giant project is a pain, so this command does it all in one step:

riscan-pro path/to/myproject sop where/to/save/the/files

Note that each file will be named after its scan position, with a .dat extension. To only export "frozen" SOPs, use the --frozen flag.

3. Save the POP matrix to a .dat files

Just like the sop subcommand, pop saves the POP matrix to a file, named after the project and with a .dat extension:

riscan-pro path/to/myproject pop where/to/save/the/file