jaxfne
JAX-based simulation of Tensor-Field Neural Equations — emitter-to-source-to-field readouts for computational electrophysiology. Define a circuit (single column or multi-area hierarchy), run it, and inspect population activity, layer-targeted drive, and field readouts in one pipeline.
jaxfne works at the population/field scale — layer-resolved circuits, spectrolaminar readouts, a tensor-algebraic source-to-sensor-proxy chain. For single/multi-compartment biophysical detail, Jaxley is the natural complement, not a competing tool: Jaxley models plug directly into jaxfne as emitters (see the Jaxley bridge in Quickstart).
Install
pip install jaxfne
pip install "jaxfne[viz]" # matplotlib/plotly readouts
Development checkout: pip install -e ".[dev,viz]" after cloning.
Minimal example
import jaxfne as jtfne
jtfne.enable_x64()
tensor = jtfne.load_canonical_neuronal_tensor("canonical-v1-column-1000n")
model = jtfne.construct(tensor, jtfne.RuntimeConfiguration(seed=0, duration_ms=1000.0, dt_ms=0.5))
signals = jtfne.simulate(model)
jtfne.vis.raster(signals) # population raster
jtfne.vis.spectrolaminar_suite(signals) # laminar PSD readout
Canonical import: import jaxfne as jtfne. More paths (fluent Configuration,
multi-trial sweeps, HDP plasticity, Jaxley bridge): Quickstart.
Scope & status
Every jaxfne output is labeled Relative or Absolute. Relative values are the default and require no external evidence; Absolute (physically calibrated) values require an explicit, evidenced calibration step. Reference: Scope & status.
Exported but not yet implemented: GLIFEmitter, LIFEmitter, write_nwb, read_nwb.
Documentation
| Resource | Link |
|---|---|
| Quickstart (three build paths, canonical column, Jaxley) | docs/quickstart.md |
| Full docs site | jaxfne.readthedocs.io |
| Tutorials & études | docs/tutorials/ |
| Changelog | docs/changelog.md |
| Contributing | docs/contributing.md |
| AI agents | docs/for_ai_agents.md |
Documentation for AI coding agents (skills/, docs/for_ai_agents.md) is a deliberate design choice, not incidental repo clutter — it's verified against the same source of truth as the human-facing docs above, not a separate, drifting spec.
Citation
Machine-readable metadata: CITATION.cff (GitHub Cite this repository).
BibTeX and Zenodo DOI setup: docs/citation.md.
Release files for jaxfne 0.4.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jaxfne-0.4.7.tar.gz | 16.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jaxfne-0.4.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.7 MB
Release files / jaxfne-0.4.7.tar.gz
| Download URL | jaxfne-0.4.7.tar.gz |
|---|---|
| Size | 16.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eed1f787d699c4148d7aa3cfe49b26dcda95c33f975e3a77df9a01876d7172f2
|
|
BLAKE2b-256 checksum How to use checksums |
a1988aff27c23cdc65d85670afe18b2bf1ca728b88532ba9113d863129ef676e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / jaxfne-0.4.7-py3-none-any.whl
| Download URL | jaxfne-0.4.7-py3-none-any.whl |
|---|---|
| Size | 447.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
07a66ba8e0f250f14c459fa6853840ec0e603be1c3664fdc74c3093a3176eda6
|
|
BLAKE2b-256 checksum How to use checksums |
8113ce409f9d31c92c2f8eea45058eabc0c186e1aa4ec037d0b4eaf91cb6e209
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|