# 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
```