The pipeline
The pipeline turns one sentence into a folder of fab files. Each stage reports what it could not do.
The command line prints the stages in order as they run. The app runs the same
code, workspace.realise(), and shows each stage in the build log.
The stages, in order
| Stage | What it does | Modules | |
|---|---|---|---|
| 1 | Design | A model turns the prompt into parts, nets and a board size | design.py, schema.py, priors.py |
| 2 | Parts and packages | Finds a real LCSC part and a footprint for each component | resolve.py, parts.py, packages.py, easyeda.py |
| 3 | Symbols and pins | Turns pin function names into pad numbers | symbols.py |
| 4 | Simulation | Switches the rails on in ngspice and reads what settles | spice.py |
| 5 | Electrical rule check | Checks the netlist against electrical rules. It changes nothing. | erc.py, electrical.py |
| 6 | Placement and routing | Places the parts, routes the copper and pours ground | placer.py, mounting.py, keepout.py, escape.py, pour.py, planes.py, pairs.py, widen.py, fillet.py, dsn.py, ses.py |
| 7 | Routers | Lightcycle routes and ranks every placement; the A* router routes when named | router.py, tandem.py, astar.py |
| 8 | Fab files | Writes the Gerbers, drill, BOM and CPL, then reads them back | gerber.py, assembly.py |
| 9 | Stock and pricing | Checks stock and price at 1, 10, 25 and 100 boards | inventory.py |
| 10 | KiCad and 3D models | Writes the KiCad files, fetches 3D models, and runs KiCad's DRC | kicad.py, models3d.py, kicadcli.py |
| 11 | Reviews and verdict | Grades the layout, checks JLCPCB's limits, writes the schematic and stamps the verdict | rubric.py, physics.py, layout_rules.py, fabrules.py, kicad_sch.py, repair.py |
If the copper alone fails, the build runs again with the power nets poured. It keeps whichever build has fewer copper failures. See Power pours.
A board imported from a KiCad file skips stages 1 to 5. Its parts, nets and outline come from the file, and no simulation or ERC runs.
Everything the build made is then saved as one version that never changes.
Around the stages
- Routability: the model that rates a placement's chance of routing. In a default build it ranks nothing, because Lightcycle ranks the placements by routing them. It lives with the research.
- Repair loop and evaluation: the pass rule every board is judged by, and the benchmark suite.
- What is not guaranteed: every limit of the pipeline, in one place.
The instruments that ask whether routing can be predicted rather than run are not stages. They are under Research.