Metadata-Version: 2.4
Name: super-neuron-core
Version: 1.0.1
Summary: Standalone frozen Phase 2A scalar Super Neuron core
License-Expression: Apache-2.0
Keywords: neuron,phase2a,rk4,scientific-computing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Requires-Python: <4,>=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# super-neuron-core

`super-neuron-core` is a standalone, dependency-free Python distribution of
the frozen Phase 2A scalar neuron semantics. It is separate from both the
research repository and the existing `superNeuron` runtime.

## Install

```bash
pip install super-neuron-core==1.0.1
```

## Usage

```python
from super_neuron_core import SuperNeuron

neuron = SuperNeuron.reference()
state = neuron.initial_state()
state, output = neuron.step(
    state=state,
    input_current_mA_per_cm2=6.0,
    dt_ms=0.025,
)
print(state.v_mV, output.spike, output.threshold_crossing)
```

The functional API is equivalent:

```python
from super_neuron_core import neuron_step, neuron_step_batch

state, output = neuron_step(state, 6.0, dt_ms=0.025)
states, outputs = neuron_step_batch([state], [6.0], dt_ms=0.025)
```

Only the frozen Phase 2A parameters and `dt_ms=0.025` are exposed. The
threshold is 0 mV and an output is true only for an upward crossing from below
0 mV to at least 0 mV during a step. There is no reset, refractory suppression,
plasticity, routing, network behavior, parameter fitting, or adapter layer.

The batch API intentionally uses deterministic scalar-semantics iteration; it
does not claim vectorized performance.

The supported public-surface and identity rules are documented in
[`INTEROPERABILITY.md`](INTEROPERABILITY.md). The package includes a `py.typed`
marker for static type-checking consumers.

## Release boundary

Version 1.0.1 is a patch release of the standalone Phase 2A scalar core
package. It makes no intentional change to frozen Phase 2A scalar semantics.
Any future semantic correction must be explicitly documented with regression
evidence.

Phase 65 remains bound to the archived immutable
`super-neuron-core==1.0.0` wheel. Version 1.0.1 does not alter, supersede, or
reinterpret Phase 65 evidence.

## Package boundary

This package imports no `bio-neuron`, `superNeuron`, NumPy, Torch, JAX, Brian2,
or NEST code. Version 1.0.0 is the immutable public Phase 2A reference
release. Version 1.0.1 does not change the model parameters, timestep, public
API, state fields, or serialized scientific identity. Runtime replacement,
parameter fitting, framework adapters, and biological-validity claims remain
outside the core release boundary.

The package is licensed under Apache-2.0. Benchmark tooling and performance
probes live in the separate `super-neuron-core-benchmarks` project and are not
runtime dependencies of this distribution.

For a reproducible local dry-run after installing the build tool, use
`python tools/build_release.py --outdir <output-directory> --epoch 1760000000`.
The helper normalizes source-archive metadata; it does not upload or publish
anything.
