56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# Pipeline Network Diagram Editor
|
|
|
|
A desktop editor for drawing **pipeline networks** — water lines, power lines, gas, etc. —
|
|
built with **PyQt6** on the Qt **QGraphicsView** framework.
|
|
|
|
## Features
|
|
|
|
- **Node library** with grouped, draggable vector (SVG) symbols (pump, tank, valve, source, sink, junction…).
|
|
- **Typed ports** with relation semantics (water / power / gas / …) and per-relation color schemes;
|
|
connection compatibility is validated and highlighted.
|
|
- **Orthogonal edge routing** along a rectangular grid, with an optional **arc at line crossings**.
|
|
- **Edge styles**: line styles plus head/tail decorations (arrow, circle, diamond, none).
|
|
- **Grouped property panel** for the selected node/edge — presentation (geometry, title, color) and
|
|
physics (length, diameter, flow rate, flow type). Property types: string, int, float, bool, enum,
|
|
color, catalogue item, catalogue items, value list.
|
|
- **Mock flow calculation** distributing flow across edges, with **animated direction and volume**.
|
|
- Editing UX: drag, multi-select, snap-to-grid, undo/redo, copy/paste, save/open (JSON),
|
|
export to PNG/SVG, configurable grid & color schemes.
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
- Python 3.11+
|
|
- PyQt6 (with QtSvg)
|
|
|
|
On Debian/Ubuntu: `sudo apt install python3-pyqt6 python3-pyqt6.qtsvg`
|
|
or `pip install -r requirements.txt`.
|
|
|
|
## Run
|
|
|
|
```bash
|
|
python -m pipeline_editor
|
|
```
|
|
|
|
## Test
|
|
|
|
Tests run headless:
|
|
|
|
```bash
|
|
QT_QPA_PLATFORM=offscreen python -m pytest
|
|
```
|
|
|
|
## Layout
|
|
|
|
```
|
|
pipeline_editor/
|
|
model/ domain: properties, catalogue, relations, ports, nodes, edges, document
|
|
view/ QGraphicsView canvas, scene, node/port/edge items, routing
|
|
panels/ node library dock, property editor dock
|
|
calc/ mock flow solver + animation
|
|
resources/ SVG node symbols, color schemes
|
|
docs/plan/ actionable implementation plan
|
|
tests/ pytest suites for typical scenarios
|
|
```
|