Skip to content

kForth/E57-Tools

Repository files navigation

E57-Tools

GitHub GitHub License

Basic command line tools for parsing large .e57 files.

Installation

Clone this git repository then install locally with pip:

pip install -e .

Usage

Scan Info

Print basic info about the scan file.

Usage: python -m e57_tools.info [OPTIONS] SRCFILE

Options:
  --help  Show this message and exit.

Example:

python -m e57_tools.info "C:\3d_scan.e57"

Processing "3d_scan.e57"
Contains 29 Scans...
el 120000mm - RM B-102 - NE - 01
el 120000mm - RM B-102 - NE - 02
el 120000mm - RM B-102 - NE - 03
...

Split Point clouds

Split a large scan into separate point cloud files.

Usage: python -m e57_tools.split [OPTIONS] SRCFILE

Options:
  -o, --outdir DIRECTORY  Output directory for point clouds, defaults to the directory containing the scan file.
  -f, --format [e57|xyz]  Output format for point clouds.  [default: xyz]
  -t, --template TEXT     Point cloud filename template.  [default: {basename}\Clouds\{scanname} ({i}).{ext}]
  -d, --delimiter TEXT    Delimiter for 'xyz' format point clouds.  [default: ,]
  --help                  Show this message and exit.

Example:

python -m e57_tools.images "C:\3d_scan.e57" -o "C:\point clouds" -f xyz

Extract Images

Extract all images from the scans.

Usage: python -m e57_tools.images [OPTIONS] SRCFILE OUTDIR

Options:
  --help  Show this message and exit.

Example:

python -m e57_tools.images "C:\3d_scan.e57" "C:\scan images"

License

E57-Tools (C) 2026 Kestin Goforth

This project is licensed under the MIT License - see the LICENSE file for details.

About

Basic command line tools for parsing large .e57 files.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages