Skip to content

Add pixi.lock and test the locked environment pixi.lock fixes every package for macOS (Intel and Apple Silicon) and Linux (x86-64 and ARM64), including the OpenFPM packages rebuilt against glibc 2.28 (the earlier ones could not be linked on Linux). CI now installs exactly this environment (PIXI_LOCKED), renders the 3D plots on one Linux runner with a virtual display and on the other without, like a server reached via SSH, and shows the errors as annotations. The README explains how the installation is kept working. - #7

Merged
abhinavsns merged 9 commits into
mainfrom
fix/installation
Oct 29, 2026

Conversation

@abhinavsns

Copy link
Copy Markdown
Owner

No description provided.

abhinavsns and others added 9 commits October 27, 2026 22:58
- Provide OpenFPM's generated config.h: the OpenFPM 5.0.1 package does not
  install it, so Active2d and SpringLattice did not compile at all.
- Use eigen@3 when installed: OpenFPM 5.0.1 does not compile with Eigen 5.
- On Linux, record Homebrew's library directories as rpaths (boost@1.85 is
  keg-only, so the binaries could not load their libraries) and build with
  Homebrew's GCC when Homebrew brings its own glibc.
- Compile with -fsigned-char: OpenFPM's DCPSE operators keep a sign in a
  plain char, which breaks all even-order derivatives on Linux/ARM64.
- Make -march=native overridable (ARCH_FLAGS) for binaries that run on other
  machines, e.g. in a Docker image.
- Add `make backend`; remove createbrewenv.sh and monolayer.mk, which
  overwrote tracked files with machine-specific paths.
- Ignore the build products.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- pyproject.toml now ships the modules and has no build side effects. The
  wheel built by setup.py contained no Python code (only the editable install
  worked) and `pip install -e .` skipped its Homebrew/make hook. Remove
  setup.py and the unused __init__.py files.
- The simulators raise clear errors (executable missing, run failed with its
  output) instead of UnboundLocalError, and no longer start a background
  `rm -rf` that races with the simulation's output.
- pandas 3: chained assignments did nothing (the spring lattice thickness was
  ignored, the spring files for the C++ code were empty) and a dtype-changing
  .loc assignment raised. The outputs are byte-identical to pandas 2.
- Sort animation frames numerically, make the vertex model's analysis
  defaults attributes, fall back to a JavaScript player without ffmpeg, and
  do not switch matplotlib to Agg on import.
- Add tests/smoke_test.py, which runs all three simulators briefly.
- Fix the source paths in the notebook texts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- The published image never compiled the simulators: `pip install -e .`
  skipped setup.py's install hook, so it had no OpenFPM, MPI or executables
  and every example failed. The new image installs from Homebrew's
  2025-08-05 snapshot (the one the OpenFPM 5.0.1 bottles were built against),
  compiles the simulators with portable CPU flags, runs the smoke test during
  the build, starts JupyterLab by itself and renders 3D plots off-screen. It
  is built for amd64 and arm64, so Apple Silicon does not need emulation.
- install.sh installs natively with Homebrew (tap trust, eigen@3, Python 3.13).
- CI builds and tests the image on amd64 and arm64, runs all example
  notebooks in it and publishes it; a weekly job runs install.sh on macOS and
  Ubuntu.
- Rewrite the installation instructions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Homebrew keeps only the newest version of each formula, so the native
installation keeps breaking as OpenFPM's dependencies move on. pixi.toml
installs everything (compilers, MPI, OpenFPM from the abhinavsns/homebrew-openfpm
channel, Python packages) from conda channels, which keep old versions;
`pixi run lab` compiles the simulators and starts JupyterLab.

The makefiles use the conda environment when it contains OpenFPM and
Homebrew otherwise. The new pixi workflow runs the smoke test and the
notebooks in the environment on macOS and Linux, weekly as well.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
With the macOS 27 SDK, math.h leaves INFINITY and NAN to float.h when C++20 modules are
available, and the float.h of conda-forge's clang 21 only defines them outside strict mode, so
<random> and <complex> failed to compile with -std=c++20 in the pixi environment.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Without a display, conda-forge's VTK found neither an EGL driver nor OSMesa, so the vertex
model could not be plotted on a server reached via SSH. The pixi environment now includes Mesa
on Linux, and TopoSPAM selects VTK's OSMesa render window when no display is set (otherwise VTK
prints a page of EGL warnings before falling back to it). The hint for missing simulators now
mentions `pixi run build`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
pixi.lock fixes every package for macOS (Intel and Apple Silicon) and Linux (x86-64 and
ARM64), including the OpenFPM packages rebuilt against glibc 2.28 (the earlier ones could not be
linked on Linux). CI now installs exactly this environment (PIXI_LOCKED), renders the 3D plots
on one Linux runner with a virtual display and on the other without, like a server reached via
SSH, and shows the errors as annotations. The README explains how the installation is kept
working.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The OpenFPM formula (5.0.1_1 in abhinavsns/homebrew-openfpm) now depends on Homebrew's boost
instead of the disabled boost@1.85, so the Homebrew builds prefer boost and fall back to
boost@1.85 for older installations. The README says that Intel Macs get no precompiled
dependencies from Homebrew any more, and how to update an existing Homebrew installation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@abhinavsns
abhinavsns merged commit 4d4018a into main Oct 29, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant