Skip to content

jaxfne v0.3.4

Release date: May 26, 2026
Status: Stable, production-ready
Package: Available on PyPI

Overview

jaxfne v0.3.4 marks the stable v0.3 tutorial-scenario release. The chainable Configuration grammar is validated, and the core tutorials are executable with proper optional dependency handling.

Key theme: v0.3.4 is "tutorial-scenario spine with validated public grammar."

What's New

Chainable Configuration Grammar

The public API uses an intuitive chainable pattern:

cfg = jtfne.Configuration()
cfg = cfg.runtime(seed=7, dtype="float32", duration_ms=1000.0, dt_ms=0.1)
cfg = cfg.column("single_neuron", layers=["L2/3"], n=1)
cfg = cfg.cell_types({"E": 1.0})
cfg = cfg.connectivity()
cfg = cfg.set_emitter("izhikevich", "cortical_eig")
cfg = cfg.probes(["MUA-proxy", "source-proxy", "LFP-proxy"])

model = jtfne.construct(cfg)
signals = jtfne.simulate(model, duration_ms=1000.0, dt_ms=0.1, seed=7)

No private model/cfg introspection required for users.

Validated Tutorials

Three v0.3.x core tutorials are fully validated:

  • v0.3.1: Single-neuron Izhikevich dynamics (1 neuron, voltage, spikes, recovery variable)
  • v0.3.2: Parameter sweep exploration (sensitivity analysis over drive and recovery parameters)
  • v0.3.3: Two-neuron E/I coupling (excitatory-inhibitory network dynamics)

Plus two Suite notebooks: - Suite No. 1: Computational biophysics foundations - Suite No. 2: Spectrolaminar network motifs

Optional Dependencies Handled Correctly

  • matplotlib is optional; core API does not require it
  • Visualization tests skip gracefully if matplotlib is unavailable
  • Install with pip install "jaxfne[viz]" for plotting support
  • Core CI/test suite passes without matplotlib

Documentation Updates

  • README.md updated with v0.3.4 grammar and PyPI links
  • Scope boundaries clarified (proxy readouts, computational scaffold, no biological statements)
  • Installation docs reference v0.3.4
  • Quickstart shows current chainable API

Breaking Changes

None from v0.2.30. v0.3.4 is built on the stable v0.2.30 foundation with new tutorials and public grammar documentation.

Fixed Issues

  • Optional matplotlib dependency: Core tests no longer fail if matplotlib is missing
  • Public API documentation: README and docs now show v0.3.4 chainable grammar
  • Version expectations: All version tests updated to expect 0.3.4

Validation

Test suite: 1062 passed, 37 skipped
PyPI smoke test: PASS (install, import, grammar execution)
Tutorial execution: All 5 release notebooks execute successfully
Twine check: PASS (wheel and sdist)
GitHub Actions: Green on main

Install

pip install -U "jaxfne>=0.3.4"

Or with visualization:

pip install "jaxfne[viz]"

Next Steps

v0.3.4 is a stable checkpoint. Reserved v0.3.x work can focus on: - Additional tutorials (multi-area networks, plasticity) - Advanced visualization (Plotly interactivity) - Optimization workflows - Jaxley bridge enhancements

Scope & Scope

jaxfne v0.3.4 is a computational scaffold, proxy-scoped biological simulator:

  • Proxy readouts only — no solved Maxwell equations
  • No empirical calibration — simulation results are relative metrics
  • Tutorial-scale — examples demonstrate concepts, not biological ground status
  • Optional visualization — figures are instructional aids

All outputs declare run_status: tutorial_scaffold and model_status: computational_scaffold.

Contributors

  • Core development: jaxfne team
  • v0.3.4 release: May 2026
  • Validation: 1062 test cases, 5 tutorial notebooks