How wulffern/cicpy works
cicpy is a Python toolbox for compiling ciccreator object definitions and translating .cic IC designs into other design formats. The main workflow is command-line input → design loading/compilation → layout and routing operations as needed → format-specific output. Separate capabilities include route analysis, a Qt design viewer, and an MCP server. The graph preserves README-documented commands; several implementation links are omitted because their source was not sampled.
Main entry points: cic.py CLI commands · layoutcell.py Layout cells · mazerouter.py Maze routing · builder.py Object compiler
Components 21
Entry points
- CLI commands
src/cicpy/cic.py - Object compiler
src/cicpy/compiler/builder.py - Compile dispatch
src/cicpy/compiler/dispatch.py - Cell registry
src/cicpy/compiler/registry.py
Design model
- Cell design model
src/cicpy/core/cell.py - Cell groups
src/cicpy/core/cellgroup.py - Layout cells
src/cicpy/core/layoutcell.py - Technology rules
src/cicpy/core/rules.py - Geometry primitives
src/cicpy/core/rect.py
Layout and routing
- Maze routing
src/cicpy/core/mazerouter.py - Route geometry
src/cicpy/core/route.py - Track analysis
src/cicpy/core/trackmap.py - Via cuts
src/cicpy/core/cut.py
Format outputs
- Format printers
src/cicpy/printer - Printer base
src/cicpy/printer/designprinter.py - Magic integration
src/cicpy/eda/magic.py - Xschem integration
src/cicpy/eda/xschem.py
User interfaces
- Qt viewer
src/cicpy/gui/mainwindow.py - GUI launcher
src/cicpy/gui/app.py - MCP server
src/cicpy/mcp_server.py
Other components
- IC designer
Connections 23
- IC designer → CLI commands: runs commands
README.md - IC designer → GUI launcher: opens viewer
README.md - CLI commands → Object compiler: compiles definitions
README.md - Object compiler → Compile dispatch: uses dispatch
src/cicpy/compiler/builder.py - Object compiler → Cell registry: registers cells
src/cicpy/compiler/builder.py - CLI commands → Cell design model: loads `.cic`
README.md - CLI commands → Format printers: transpiles to formats
README.md - Format printers → Printer base: shares printer base
src/cicpy/printer/skillschprinter.py - CLI commands → Magic integration: places and routes
README.md - CLI commands → Xschem integration: netlists schematic
README.md - CLI commands → Maze routing: searches routes
src/cicpy/cic.py - CLI commands → Track analysis: reports track use
README.md - CLI commands → Via cuts: reports stack order
README.md - Cell groups → Cell design model: groups cells
src/cicpy/core/cellgroup.py - Cell groups → Layout cells: uses layout cells
src/cicpy/core/cellgroup.py - Layout cells → Cell design model: uses cells
src/cicpy/core/layoutcell.py - Layout cells → Geometry primitives: uses geometry
src/cicpy/core/layoutcell.py - Layout cells → Technology rules: queries rules
src/cicpy/core/layoutcell.py - Maze routing → Track analysis: searches track grid
src/cicpy/core/mazerouter.py - Maze routing → Route geometry: plans routes
src/cicpy/core/mazerouter.py - Maze routing → Via cuts: accounts for cuts
src/cicpy/core/mazerouter.py - GUI launcher → Qt viewer: launches window
src/cicpy/gui/app.py - MCP server → CLI commands: invokes operations
src/cicpy/mcp_server.py