Skip to content

nivalis-studio/e57-to-las

Repository files navigation

E57 to LAS conversion

Crates.io No Unsafe Documentation License: MIT Dependencies

A utility to convert E57 point cloud files to LAS format. It is based on the E57 crate and the LAS crate.

About

e57-to-las is an open-source tool designed to convert point cloud files in the E57 format to the LAS format. The conversion retains all the relevant point data and associated metadata, making it easier for users to work with point cloud data in environments that primarily support LAS. We use is to convert E57 files to LAS for use in Potree for web-based point cloud visualization.

Features

  • Parallel processing using rayon for faster conversion.
  • Error handling to ensure corrupted or unsupported files do not halt the process.
  • Optional pointclouds splitting in distinct LAS files and generation of station file (stations.json), containing spatial coordinates of station points. This is activated by adding the --stations flag, and the station points are calculated based on the transformation translations of the point clouds.

Usage

e57_to_las [OPTIONS]

To use this as a crate in your own project, add the following to your Cargo.toml:

[dependencies]
e57-to-las = "0.7.0"

You can then use it in your code as follows:

use e57_to_las::{e57_to_las, LasVersion};

fn main() {
    let input_path = String::from("path/to/input.e57");
    let output_path = String::from("path/to/output/directory");
    let number_of_threads = 0; // 0 = max possible
    let as_stations = true;
    let las_version = LasVersion::new(1, 4).unwrap(); // 1.0 to 1.4
    convert_file(input_path, output_path, number_of_threads, as_stations, las_version);
}

Options

  • -p, --path <path>: The path to the input E57 file.
  • -o, --output <output>: The output directory for the converted LAS files (default: ./).
  • -T, --threads <threads>: Number of threads for parallel processing (default: 0 = max possible).
  • -S, --stations <stations>: Whether to convert e57 file in distinct stations (default: false).
  • -L, --las_version <las_version>: Version of LAS format used for output file. Default one is (1, 4). Currently possible: (1, 0) to (1, 4).

Contribution

If you'd like to contribute to the development of this tool, please create an issue or pull request on our GitHub repository. All contributions are welcome!

Dependencies

Here are some of the main dependencies used:

  • rayon: Parallelism
  • clap: Command-line argument parsing
  • e57: E57 file format reader
  • las: LAS file format writer
  • uuid: For GUID processing
  • serde: For serialization and deserialization of data

License

Open-source MIT. See LICENSE for details.