The setup section and platform notes claimed all three OSes work; the Linux and macOS statements come from a dependency/code audit only - nobody has run the plugin there. Say so and ask for reports. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -30,9 +30,12 @@ SWIG API. Requires KiCad **10.0.1+**.
|
|||||||
|
|
||||||
## Setup (one-time)
|
## Setup (one-time)
|
||||||
|
|
||||||
The plugin runs on **Windows, Linux and macOS** — KiCad builds it a
|
The plugin is developed and tested on **Windows**. **Linux and macOS
|
||||||
private Python venv from `requirements.txt` on every platform, from
|
are expected to work but are untested so far** — the code and the
|
||||||
pre-built wheels only (no compiler needed). Steps 1–4 are the same
|
dependency stack have been audited for all three OSes (KiCad builds
|
||||||
|
the plugin a private Python venv from `requirements.txt` on every
|
||||||
|
platform, from pre-built wheels only, no compiler needed), but nobody
|
||||||
|
has run the plugin there yet. Reports welcome! Steps 1–4 are the same
|
||||||
everywhere; OS specifics are spelled out per step and in *Platform
|
everywhere; OS specifics are spelled out per step and in *Platform
|
||||||
notes* below.
|
notes* below.
|
||||||
|
|
||||||
@@ -72,20 +75,23 @@ notes* below.
|
|||||||
|
|
||||||
### Platform notes
|
### Platform notes
|
||||||
|
|
||||||
- **Windows** is the development and test platform. KiCad's bundled
|
- **Windows** is the development and test platform — everything in
|
||||||
Python is 3.13, so the venv gets the current dependency stack.
|
this README was exercised here. KiCad's bundled Python is 3.13, so
|
||||||
- **macOS** (12+, KiCad's own minimum; Intel and Apple Silicon —
|
the venv gets the current dependency stack.
|
||||||
the dmg is universal): KiCad's bundled Python is **3.9**, so pip
|
- **macOS** — **untested** (audited only: dependency wheels, paths and
|
||||||
resolves an older but fully functional stack (numpy 2.0,
|
Python-version compatibility were checked, the plugin was never run
|
||||||
scipy 1.13, matplotlib 3.9, PySide6 6.9/6.10). The plugin code is
|
on a Mac). Requires macOS 12+ (KiCad's own minimum; Intel and Apple
|
||||||
kept 3.9-compatible. Plot and dialog windows may open **behind**
|
Silicon — the dmg is universal). KiCad's bundled Python is **3.9**,
|
||||||
|
so pip resolves an older stack (numpy 2.0, scipy 1.13,
|
||||||
|
matplotlib 3.9, PySide6 6.9/6.10) that the plugin code is kept
|
||||||
|
compatible with. Expect plot and dialog windows to open **behind**
|
||||||
the KiCad window (they are raised best-effort) — check the Dock if
|
the KiCad window (they are raised best-effort) — check the Dock if
|
||||||
nothing seems to appear after a solve.
|
nothing seems to appear after a solve.
|
||||||
- **Linux**: the venv uses the system Python (3.9+), so the stack
|
- **Linux** — **untested** (audited only, same caveat). The venv uses
|
||||||
matches your distribution. On **ARM64 (aarch64)** there are no
|
the system Python (3.9+), so the stack matches your distribution.
|
||||||
pyamg wheels — `requirements.txt` skips pyamg there and the solver
|
On **ARM64 (aarch64)** there are no pyamg wheels —
|
||||||
falls back to Jacobi-CG: same results, noticeably slower on large
|
`requirements.txt` skips pyamg there and the solver falls back to
|
||||||
grids.
|
Jacobi-CG: same results, noticeably slower on large grids.
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user