*No ducks were punched during the construction of this monkey patch.
Installation
pip install nrn-patch
Minimal requirements
- Python 3.8+
- NEURON 9.0+
Philosophy
Pythonic reinvention of the NEURON Python interface:
- Drop-in replacement: No breaking changes between Patch and NEURON. All your code works as is. Patch automagically fixes bugs and reduces complexity in NEURON by having an opinion, and adds new convenient methods.
- Loud errors: silent failures and gotchas are caught and raise loud errors; so that when it runs, it runs.
- Strong referencing: Objects connected to each other will never disappear until you disconnect them.
- Demystified: The simplest form of each instruction does the most obvious thing. Patch frequently replaces 5 or more undocumented mystical voodoo steps by 1 clearly named function.
- Just add water: Serial or parallel, doesn't matter,
p.run()will run your simulation with no extra steps. Noload_file,finitialize,fadvance,run,continuerun,tstop,set_maxstep,setup_transfer,setgid2node,gid_connect,cell,outputcell,psolverequired.
Basic usage
Use it like you would use NEURON. The wrapper doesn't make any changes to the interface, it just patches up some of the more frequent and ridiculous gotchas.
Patch supplies a new interpreter p, the PythonHocInterpreter which wraps the
standard HOC interpreter h provided by NEURON. Any objects returned will either be
PythonHocObject's wrapping their corresponding NEURON object, or whatever NEURON
returns.
When using just Patch the difference between NEURON and Patch objects is handled
transparently, but if you wish to mix interpreters you can transform all Patch objects
back to NEURON objects with obj.__neuron__(), or the transform function.
Example
from patch import p
import glia as g
section = p.Section()
point_process = g.insert(section, "AMPA")
point_process.stimulate(start=10, number=5, interval=10, weight=0.04)
.stimulate creates both the NetCon and NetStim, and sets their properties, and
stores references to eachother so that Python doesn't garbage collect anything
until we're done with it.
Even when you forget to set values, the Patch defaults have a visible effect. Here we forget to set the duration of a voltage clamp, but by default it will be active the first 100ms of the simulation, so that you can see that the voltage clamp is in fact inserted and working, but you forgot to set the duration:
section.vclamp(holding=-70, voltage=20)
Release files for nrn-patch 7.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nrn_patch-7.6.1.tar.gz | 21.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nrn_patch-7.6.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 44.3 kB
Release files / nrn_patch-7.6.1.tar.gz
| Download URL | nrn_patch-7.6.1.tar.gz |
|---|---|
| Size | 21.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2a08f633ee4522e52ac7c98b9f6d34bb558751bfe7034d89e011ddd8fd1bab7e
|
|
BLAKE2b-256 checksum How to use checksums |
a4007ad81eb6ab337548e6953186ce41a7e01f8d866b039548cf24556236a6a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / nrn_patch-7.6.1-py3-none-any.whl
| Download URL | nrn_patch-7.6.1-py3-none-any.whl |
|---|---|
| Size | 23.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e9ffd748546f1a7f3e7f2fca7c0e187a0c37304e6a53407048219225171ba1ea
|
|
BLAKE2b-256 checksum How to use checksums |
93cd1be7150c8f019e5582d5437cef55b1d280231d4985825599bab79264d003
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
