Myst

E57 point cloud converter.

Command line

myst [options]

Options

--verbose : show the processing messages
--progress : show the processing progress
--axis-format <component format> : set the left, up and forward component names
--swap-xy : swap the Y and Z position components
--swap-xz : swap the Y and Z position components
--swap-yz : swap the Y and Z position components
--position-offset <x> <y> <z> : set the loading position offset
--position-scaling <x> <y> <z> : set the loading position scaling
--position-rotation <x> <y> <z> : set the loading position rotation
--position-translation <x> <y> <z> : set the loading position translation
--color-offset <r> <g> <b> : set the loading color offset
--color-scaling <r> <g> <b> : set the loading color scaling
--color-translation <r> <g> <b> : set the loading color translation
--intensity-offset <i> : set the loading intensity offset
--intensity-scaling <i> : set the loading intensity scaling
--intensity-translation <i> : set the loading intensity translation
--apply-intensity : apply the intensity to the color components
--point-decimation <decimation count> : decimate points
--ignore-scan <scan name> : ignore a scan
--select-scan <scan name> : select a scan
--read-e57-cloud <file path> : read an E57 point cloud
--write-xyz-cloud <file path> <component format> : write an XYZ point cloud
--write-pts-cloud <file path> <component format> : write a PTS point cloud
--write-ptx-cloud <file path> <component format> : write a PTX point cloud
--write-pcf-cloud <file path> <component format> <position bit count> <position precision> : write a PCF point cloud

Component format

x : -X
X : +X
y : -Y
Y : +Y
z : -Z
Z : +Z
n : intensity (from -2048 to 2047)
i : intensity (from 0 to 1)
I : intensity (from 0 to 255)
r : red (from 0 to 1)
R : red (from 0 to 255)
g : green (from 0 to 1)
G : green (from 0 to 255)
b : blue (from 0 to 1)
B : blue (from 0 to 255)

Installation

Linux

• run update.sh
• run get.sh
• run make.sh

Windows

• install Visual C++ 2019 Community
• install Cmake 3.21
• run update.bat
• run make_xerces.bat
• run make.bat

Dependencies

• Boost 1.76.0
• Xerces 3.2.3
• PCF

Examples

myst --progress --read-e57-cloud cloud.e57 --write-xyz-cloud cloud.xyz XYZRGB
myst --progress --read-e57-cloud cloud.e57 --write-pts-cloud cloud.pts XYZRGB
myst --progress --read-e57-cloud cloud.e57 --write-pcf-cloud cloud.pcf XYZRGB 8 0.001

Version

0.3

Limitations

• Spherical point positions are converted to cartesian coordinates.

Author

Eric Pelzer (ecstatic.coder@gmail.com).

License

This project is licensed under the GNU General Public License version 3.

See the LICENSE.md file for details.