plcviz 0.2.1

PLC code visualization - graphs, dependencies, and documentation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# plcviz

PLC code visualization tool - generate SVG diagrams from L5X files.

## Example Output

![Example combined graph](img/example.svg)

## Features

- **Structure graphs**: Program → Routine containment hierarchy
- **Call graphs**: JSR (Jump to Subroutine) relationships between routines
- **Combined graphs**: Structure + call edges together
- **Multiple export types**: Controller, Program, and AOI exports

## Installation

```bash
cargo install --path .
```

## Usage

```bash
# Generate structure graph (default)
plcviz project.L5X > structure.svg

# Generate call graph
plcviz -t call project.L5X > calls.svg

# Generate combined graph (structure + calls)
plcviz -t combined project.L5X > combined.svg

# Include AOIs in the graph
plcviz -a project.L5X > with_aois.svg

# Generate example graph (no L5X file needed)
plcviz example > example.svg
```

## Graph Types

| Type | Description |
|------|-------------|
| `structure` | Containment hierarchy (Programs → Routines) |
| `call` | JSR calls between routines |
| `dataflow` | Tag read/write relationships (example only) |
| `combined` | Structure + call edges |

## Supported L5X Export Types

- **Controller**: Full project exports (multiple programs)
- **Program**: Single program exports  
- **AddOnInstructionDefinition**: AOI exports with internal routines

## License

MIT