Vignesh Suresh
65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
# wired3d viewer
|
|
|
|
Interactive 3D viewer for the Beckhoff 5-axis metal-DED NC toolpaths produced by
|
|
`stl_slicer.py`. It reads the machine NC dialect and renders a self-contained,
|
|
offline-capable HTML page: a 3D toolpath scene (rapid moves + per-layer welds),
|
|
an A/B tilt-angle chart, a statistics table, layer isolation, and a
|
|
progressive-reveal print animation.
|
|
|
|
## Layout
|
|
|
|
```
|
|
visualizer/
|
|
├── pyproject.toml # package metadata + the `wired3d` console script
|
|
├── README.md
|
|
├── wired3d_viewer/ # the Python package
|
|
│ ├── __init__.py # lightweight; no heavy imports
|
|
│ ├── __main__.py # CLI: `python -m wired3d_viewer view|serve`
|
|
│ ├── parser.py # NC dialect reader (standard library only)
|
|
│ ├── viewer.py # Plotly figure builder + HTML writer
|
|
│ ├── server.py # drag-and-drop local web front end
|
|
│ └── assets/
|
|
│ └── wired3d.avif # logo, embedded into the HTML as a data URI
|
|
```
|
|
|
|
## Install
|
|
|
|
```bash
|
|
pip install -e . # installs plotly + numpy and the `wired3d` command
|
|
```
|
|
|
|
The package runs fine without installing too — just call the modules directly
|
|
(see below). Only `viewer`/`server` need `plotly` + `numpy`; `parser` is pure
|
|
standard library.
|
|
|
|
## Usage
|
|
|
|
Render an NC file to a standalone HTML viewer:
|
|
|
|
```bash
|
|
python -m wired3d_viewer view path/to/part.nc # writes <stem>_viewer.html
|
|
wired3d view path/to/part.nc # same, if installed
|
|
```
|
|
|
|
Start the drag-and-drop web front end (drop an `.nc` file or a folder onto the
|
|
page):
|
|
|
|
```bash
|
|
python -m wired3d_viewer serve # http://127.0.0.1:8765
|
|
python -m wired3d_viewer serve 9000 # custom port
|
|
wired3d serve # same, if installed
|
|
```
|
|
|
|
Parse only (no visualisation, no third-party deps):
|
|
|
|
```python
|
|
from wired3d_viewer.parser import parse_nc, summarise
|
|
summarise(parse_nc("part.nc"))
|
|
```
|
|
|
|
Run the parser self-test:
|
|
|
|
```bash
|
|
python -m wired3d_viewer.parser
|
|
```
|