Skip to main content

Python utilities for NeuroML

Project description

pyNeuroML

GitHub CI Travis CI PyPI PyPI - Python Version GitHub GitHub pull requests GitHub issues Documentation Status GitHub Org's stars Twitter Follow Gitter

A single package in Python unifying scripts and modules for reading, writing, simulating and analysing NeuroML2/LEMS models.

Builds on: libNeuroML & PyLEMS and wraps functionality from jNeuroML.

Installation

Dependencies

pyNeuroML relies on additional software to carry out its functions:

  • Java Runtime environment (JRE)
  • dot (from Graphviz)
  • lxml

On most Linux systems, these can be installed using the default package manager. On Ubuntu based distributions:

sudo apt-get install python-lxml graphviz openjdk-11-jdk

Pip

pyNeuroML can be installed with pip (preferably in a virtual environment):

pip install pyneuroml

Fedora

The NeuroFedora community initiative provides pyNeuroML for use on the Fedora Linux Distribution. Fedora users can install pyNeuroML using the following commands:

sudo dnf copr enable @neurofedora/neurofedora-extra
sudo dnf install python3-pyneuroml

This will also pull in all the necessary dependencies (Java, lxml, graphviz). Please see the project documentation for more information.

Installation from source

Clone the repository:

git clone https://github.com/NeuroML/pyNeuroML.git
cd pyNeuroML

It should be possible to install pyNeuroML using just:

sudo pip install .

You may have to install lxml and the development version of libNeuroML manually:

apt-get install python-lxml
cd ..
git clone https://github.com/NeuralEnsemble/libNeuroML.git
cd libNeuroML
git checkout development
sudo python setup.py install

Current/planned features

1) Single Python package for NeuroML2/LEMS

One Python package which can be installed using pip & a user has everything they need to work with NeuroML2/LEMS files:

  • libNeuroML
  • PyLEMS
  • A bundled version of jNeuroML which can be used to run simulations

2) Run models using jNeuroML or PyLEMS

Ability to run NeuroML2/LEMS models using jLEMS/jNeuroML (with bundled jar) or PyLEMS (todo...)

Uses similar command line interface to jNeuroML, i.e. based on jnml

Try:

pynml -h

to list current options.

3) Access to export & import options of jNeuroML

All export & import options of jNeuroML available through easy command line interface (see here for progress) & through Python methods.

Example of export of NeuroML2/LEMS to NEURON and execution of generated code using single method is here.

4) Helper Python scripts

Lots of helper scripts for commonly used functions, e.g. generating a firing frequency vs injected current plot, generating a LEMS file for use with a NeuroML2 file,

5) Analysis of ion channels

Generation of plots of activation rates for ion channels from NeuroML2 channel file (example):

pynml-channelanalysis NaConductance.channel.nml

Generation of plots of activation rates for ion channels from NEURON mod file (example):

pynml-modchananalysis NaConductance -modFile NaConductance.mod

See here for more.

6) Home for existing functionality distributed in various places

Incorporate ChannelML2NeuroML2beta.xsl for updating ChannelML (coming soon...)

7) NEURON to NeuroML2

Scripts for converting NEURON to NeuroML2

  • Export morphologies (plus channels, soon). See here.

  • mod files - make best guess at initial NeuroML2 form (todo)

8) Export of images/movies from cell/networks

Files can be generated for POV-Ray which can be used to generate high resolution images and even sequences of images for creating movies. try:

pynml-povray -h

9) Tuning cell models in NeuroML 2

Builds on Neurotune and pyelectro. See here for example.

9) Planned functionality

Built in viewer of cells in 3D? Mayavi? More closely tied to PyNN?

Build Status

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyNeuroML-0.5.18.tar.gz (27.7 MB view details)

Uploaded Source

Built Distribution

pyNeuroML-0.5.18-py3-none-any.whl (27.8 MB view details)

Uploaded Python 3

File details

Details for the file pyNeuroML-0.5.18.tar.gz.

File metadata

  • Download URL: pyNeuroML-0.5.18.tar.gz
  • Upload date:
  • Size: 27.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/52.0.0.post20210125 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.7

File hashes

Hashes for pyNeuroML-0.5.18.tar.gz
Algorithm Hash digest
SHA256 1507517b3fd1381db7a5ad1c328f9d2836214107ef47c165ce8fdb52f490be1a
MD5 a356ee3d71779e371480b59358ffb41a
BLAKE2b-256 9fc9b874643d2c939a2405a00633fb6d77025537621461a817a20924dc137ce8

See more details on using hashes here.

File details

Details for the file pyNeuroML-0.5.18-py3-none-any.whl.

File metadata

  • Download URL: pyNeuroML-0.5.18-py3-none-any.whl
  • Upload date:
  • Size: 27.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/52.0.0.post20210125 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.7

File hashes

Hashes for pyNeuroML-0.5.18-py3-none-any.whl
Algorithm Hash digest
SHA256 15fe9fa2039b217d619c03681d5a67cda24b33aabb99b7bb20efe75c121f5c54
MD5 62e93a3484d10a5ba07193cf09de4d77
BLAKE2b-256 a8b33afbe43afe692c7d56a52669d7174ccdd26f518c95cc4d6c431c3038cf95

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page