Job File Format¶
Job files follow oshe-pnp-job/1, defined in Software/pnpvision/JOB_FORMAT.md. It is the
contract between the slicer and the machine: any program that writes this format can feed the
machine.
The board frame¶
- Seen from above the side being placed.
- Origin at the lower-left corner of the outline's bounding box; +X right, +Y up; millimetres.
- Bottom-side jobs are mirrored so they read as if the bottom were the top.
- Angles in degrees, counter-clockwise positive, from the footprint's library orientation.
Fields¶
| Field | Contents |
|---|---|
format |
always "oshe-pnp-job/1" |
source |
optional: generator, input files, date |
board |
name, side, outline_mm, thickness_mm |
alignment |
2 - 4 pads: name, x, y, shape, size, optional ref / pad |
placements |
in order: ref, value, package, x, y, rot, height_mm, optional skip, feeder, nozzle |
No machine coordinates, Z heights, feeder positions or G-code: those depend on where the board lands and on the machine's calibration.
Example¶
{
"format": "oshe-pnp-job/1",
"source": {"generator": "pnpslice 0.1.0", "inputs": ["Test PCB.kicad_pcb"], "date": "2026-11-11T23:14:46+00:00"},
"board": {"name": "Test PCB", "side": "top",
"outline_mm": [[0.0, 0.0], [0.0, 54.0], [46.51, 54.0], [46.51, 0.0]], "thickness_mm": 1.6},
"alignment": [
{"name": "A", "x": 25.9662, "y": 24.7098, "shape": "roundrect", "w": 1.025, "h": 1.4, "rot": 120.0, "ref": "R0805_21", "pad": "1"}
],
"placements": [
{"ref": "R0603_1", "value": "R_0603_1608Metric", "package": "R_0603_1608Metric", "x": 2.01, "y": 15.0, "rot": 0.0, "height_mm": 0.45}
]
}
Results files¶
Each run writes results/job_<time>.json: the job path, the board pose used, timing (placed,
attempted, seconds per part, parts per hour) and one result per placement. All events also go into
the SQLite log pnp_events.sqlite, which report exports as CSV.