neuronal-rs 0.1.0__tar.gz

neuronal_rs-0.1.0/Cargo.lock

@@ -0,0 +1,177 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.190"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ce5d3ddc6d3fa000eb1536d85e147bfe31aacaba692ed6a876f95cb7c855be78"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "neuronal-core"
+version = "0.1.0"
+
+[[package]]
+name = "neuronal-python"
+version = "0.1.0"
+dependencies = [
+ "neuronal-core",
+ "pyo3",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.27.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ab53c047fcd1a1d2a8820fe84f05d6be69e9526be40cb03b73f86b6b03e6d87d"
+dependencies = [
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.27.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b455933107de8642b4487ed26d912c2d899dec6114884214a0b3bb3be9261ea6"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.27.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1c85c9cbfaddf651b1221594209aed57e9e5cff63c4d11d1feead529b872a089"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.27.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0a5b10c9bf9888125d917fb4d2ca2d25c8df94c7ab5a52e13313a07e050a3b02"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.27.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "03b51720d314836e53327f5871d4c0cfb4fb37cc2c4a11cc71907a86342c40f9"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.26"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

neuronal_rs-0.1.0/Cargo.toml

@@ -0,0 +1,13 @@
+[workspace]
+members = ["crates/neuronal-core", "crates/neuronal-python"]
+resolver = "2"
+
+[workspace.package]
+version = "0.1.0"
+edition = "2021"
+license = "MIT"
+repository = "https://github.com/ze-gois/neuronal"
+
+[workspace.dependencies]
+neuronal-core = { path = "crates/neuronal-core" }
+pyo3 = { version = "0.27", features = ["abi3-py310"] }

neuronal_rs-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 José Henrique Targino Dias Gois
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

neuronal_rs-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: neuronal-rs
+Version: 0.1.0
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering
+Requires-Dist: pytest>=8 ; extra == 'dev'
+Provides-Extra: dev
+License-File: LICENSE
+Summary: Neural simulation in Rust, accessible from Python
+Keywords: neuroscience,simulation,rust
+Author: José Henrique Targino Dias Gois
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Issues, https://github.com/ze-gois/neuronal/issues
+Project-URL: Repository, https://github.com/ze-gois/neuronal
+
+# neuronal
+
+Distribuição Python: `neuronal-rs`. Importação: `import neuronal`.
+
+Pacote Python com núcleo numérico escrito em Rust. Esqueleto inicial para
+simulação neuronal e, posteriormente, geração de registros extracelulares sintéticos.
+Ainda não implementa neurônios LIF nem spike sorting.
+
+## Estrutura
+
+- `crates/neuronal-core`: núcleo Rust sem dependência de Python.
+- `crates/neuronal-python`: interface PyO3; extensão `neuronal._native`.
+- `python/neuronal`: API pública Python e tipos.
+- `examples`: exemplos executáveis.
+- `tests`: verificação da integração Python–Rust.
+
+## Desenvolvimento
+
+Requisitos: Rust estável (cargo/rustc), Python 3.10+ e compilador/linker do sistema.
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install 'maturin>=1.9,<2' 'pytest>=8'
+maturin develop
+python examples/time_axis.py
+pytest
+cargo fmt --all --check
+cargo check --workspace
+```
+
+Exemplo:
+
+```python
+import neuronal
+
+print(neuronal.time_axis(samples=5, dt_ms=0.1))
+```
+
+A função retorna uma lista Python; NumPy não é obrigatório nesta primeira etapa.
+O número de amostras é explícito: o último instante é `(samples - 1) * dt_ms`.
+Zero amostras produz uma lista vazia. O passo deve ser finito e positivo.
+
+## Distribuição local
+
+```bash
+maturin build --release --out dist
+python -m pip install dist/*.whl
+```
+
+A distribuição no PyPI se chama `neuronal-rs`; o módulo Python permanece
+`neuronal` (`import neuronal`). A aceitação do nome será confirmada no upload.
+Nenhum pacote foi publicado. Licença de distribuição: [MIT](LICENSE).
+
+## Próxima entrega
+
+Implementar LIF determinístico no núcleo, validar contra solução analítica e
+expor potencial de membrana e tempos de disparo ao Python. Depois: populações,
+entradas estocásticas e registros extracelulares com ground truth.
+
+## Publicação
+
+Veja [o guia de publicação](docs/publishing.md) para validar e publicar no PyPI.
+

neuronal_rs-0.1.0/README.md

@@ -0,0 +1,63 @@
+# neuronal
+
+Distribuição Python: `neuronal-rs`. Importação: `import neuronal`.
+
+Pacote Python com núcleo numérico escrito em Rust. Esqueleto inicial para
+simulação neuronal e, posteriormente, geração de registros extracelulares sintéticos.
+Ainda não implementa neurônios LIF nem spike sorting.
+
+## Estrutura
+
+- `crates/neuronal-core`: núcleo Rust sem dependência de Python.
+- `crates/neuronal-python`: interface PyO3; extensão `neuronal._native`.
+- `python/neuronal`: API pública Python e tipos.
+- `examples`: exemplos executáveis.
+- `tests`: verificação da integração Python–Rust.
+
+## Desenvolvimento
+
+Requisitos: Rust estável (cargo/rustc), Python 3.10+ e compilador/linker do sistema.
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install 'maturin>=1.9,<2' 'pytest>=8'
+maturin develop
+python examples/time_axis.py
+pytest
+cargo fmt --all --check
+cargo check --workspace
+```
+
+Exemplo:
+
+```python
+import neuronal
+
+print(neuronal.time_axis(samples=5, dt_ms=0.1))
+```
+
+A função retorna uma lista Python; NumPy não é obrigatório nesta primeira etapa.
+O número de amostras é explícito: o último instante é `(samples - 1) * dt_ms`.
+Zero amostras produz uma lista vazia. O passo deve ser finito e positivo.
+
+## Distribuição local
+
+```bash
+maturin build --release --out dist
+python -m pip install dist/*.whl
+```
+
+A distribuição no PyPI se chama `neuronal-rs`; o módulo Python permanece
+`neuronal` (`import neuronal`). A aceitação do nome será confirmada no upload.
+Nenhum pacote foi publicado. Licença de distribuição: [MIT](LICENSE).
+
+## Próxima entrega
+
+Implementar LIF determinístico no núcleo, validar contra solução analítica e
+expor potencial de membrana e tempos de disparo ao Python. Depois: populações,
+entradas estocásticas e registros extracelulares com ground truth.
+
+## Publicação
+
+Veja [o guia de publicação](docs/publishing.md) para validar e publicar no PyPI.

neuronal_rs-0.1.0/crates/neuronal-core/Cargo.toml

@@ -0,0 +1,7 @@
+[package]
+name = "neuronal-core"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+description = "Numerical core for neuronal simulation"

neuronal_rs-0.1.0/crates/neuronal-core/src/lib.rs

@@ -0,0 +1,18 @@
+//! Numerical core, independent of Python.
+
+/// Sample instants in milliseconds: t[i] = i * dt_ms.
+/// The caller chooses the exact sample count; no endpoint is inferred.
+pub fn time_axis(samples: usize, dt_ms: f64) -> Result<Vec<f64>, &'static str> {
+    if !dt_ms.is_finite() || dt_ms <= 0.0 {
+        return Err("dt_ms must be finite and positive");
+    }
+    if samples > 0 && !((samples - 1) as f64 * dt_ms).is_finite() {
+        return Err("time axis exceeds the finite range");
+    }
+    let mut times = Vec::new();
+    times
+        .try_reserve_exact(samples)
+        .map_err(|_| "cannot allocate time axis")?;
+    times.extend((0..samples).map(|i| i as f64 * dt_ms));
+    Ok(times)
+}

neuronal_rs-0.1.0/crates/neuronal-python/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "neuronal-python"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+description = "Python bindings for neuronal simulation"
+
+[lib]
+name = "_native"
+crate-type = ["cdylib"]
+
+[dependencies]
+neuronal-core.workspace = true
+pyo3.workspace = true

neuronal_rs-0.1.0/crates/neuronal-python/src/lib.rs

@@ -0,0 +1,16 @@
+use pyo3::exceptions::PyValueError;
+use pyo3::prelude::*;
+
+/// Return sample instants in milliseconds as a Python list.
+#[pyfunction]
+fn time_axis(py: Python<'_>, samples: usize, dt_ms: f64) -> PyResult<Vec<f64>> {
+    py.detach(|| neuronal_core::time_axis(samples, dt_ms))
+        .map_err(PyValueError::new_err)
+}
+
+#[pymodule]
+fn _native(m: &Bound<'_, PyModule>) -> PyResult<()> {
+    m.add("__version__", env!("CARGO_PKG_VERSION"))?;
+    m.add_function(wrap_pyfunction!(time_axis, m)?)?;
+    Ok(())
+}

neuronal_rs-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["maturin>=1.9,<2"]
+build-backend = "maturin"
+
+[project]
+name = "neuronal-rs"
+version = "0.1.0"
+description = "Neural simulation in Rust, accessible from Python"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "José Henrique Targino Dias Gois" }]
+keywords = ["neuroscience", "simulation", "rust"]
+classifiers = ["Development Status :: 2 - Pre-Alpha", "Programming Language :: Python :: 3", "Programming Language :: Rust", "Topic :: Scientific/Engineering"]
+requires-python = ">=3.10"
+
+[project.urls]
+Repository = "https://github.com/ze-gois/neuronal"
+Issues = "https://github.com/ze-gois/neuronal/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[tool.maturin]
+manifest-path = "crates/neuronal-python/Cargo.toml"
+python-source = "python"
+module-name = "neuronal._native"
+features = ["pyo3/extension-module"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

neuronal_rs-0.1.0/python/neuronal/__init__.py

@@ -0,0 +1,4 @@
+"""Neural simulation backed by Rust."""
+from ._native import __version__, time_axis
+
+__all__ = ["__version__", "time_axis"]

neuronal_rs-0.1.0/python/neuronal/_native.pyi

@@ -0,0 +1,5 @@
+__version__: str
+
+def time_axis(samples: int, dt_ms: float) -> list[float]:
+    """Return samples instants t[i] = i * dt_ms; dt_ms must be positive and finite."""
+    ...