https://github.com/dancergraham/e57-python

e57 file reading
https://github.com/dancergraham/e57-python

Last synced: 7 months ago
JSON representation

e57 file reading

• Host: GitHub
• URL: https://github.com/dancergraham/e57-python
• Owner: dancergraham
• License: mit
• Created: 2023-05-31T19:10:11.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-12-19T18:26:40.000Z (11 months ago)
• Last Synced: 2025-03-21T03:06:15.582Z (8 months ago)
• Language: Python
• Size: 404 KB
• Stars: 9
• Watchers: 1
• Forks: 2
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![PyPI](https://img.shields.io/pypi/v/e57.svg)](https://pypi.org/project/e57)

![GitHub](https://img.shields.io/github/actions/workflow/status/dancergraham/e57-python/CI.yml?branch=main)

![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https://raw.githubusercontent.com/dancergraham/e57-python/main/pyproject.toml)

# E57 Python Library

E57 is a compact, non-proprietary point cloud format that's defined by the ASTM E2807 standard. This format is widely adopted by 3D design applications.

This python library wraps the [rust e57 library](https://github.com/cry-inc/e57) to provide file reading

- [x] Proof of concept xml reading

- [x] Read e57 point coordinates to numpy array - see `read_points` method.

- [x] Read color field to numpy array.

- [x] Read intensity to numpy array.

- [ ] Read other fields to numpy array.

- [ ] Write to e57 (format ?)

## Getting Started

`pip install e57`

```python

>>> import e57

>>> pc = e57.read_points(r"pointcloud.e57")

>>> pc.points

array([[-23.25304444, -28.17607415, -13.44830654],

       [-23.28290139, -28.02118905, -13.44237764],

       [-23.26799723, -27.9039115 , -13.43430738],

       ...,

       [ 23.2458152 ,  25.4866642 ,  12.45043932],

       [ 23.22830673,  25.58055374,  12.49285875],

       [ 23.25270363,  25.45909652,  12.54284554]])

>>> pc.color

array(([0.3019608 , 0.3529412 , 0.23137255],

       [0.21176471, 0.26666668, 0.12941177],

       [0.21960784, 0.27058825, 0.13333334],

       ...,

       [0.5803922 , 0.58431375, 0.49019608],

       [0.41568628, 0.43529412, 0.33333334],

       [0.21568628, 0.25882354, 0.1254902 ]], dtype=float32)

```

We need a tutorial - could you write one based on our tests?

## Contributing

All contributions welcome - feature requests, bug reports, documentation, sample files, tests, rust code, python code, sharing the project online / via social media, ...

## Testing

`python -m pytest`