Skip to main content

NineML Python Library

Unit Test Status Unit Test Coverage Supported Python versions Latest Version Documentation Status

NineML (9ML) is a language for describing the dynamics and connectivity of neuronal network simulations (http://nineml.net), which is defined by the NineML specification.

The NineML Python Library is a software package written in Python, which maps the NineML object model onto Python classes for convenient creation, manipulation and validation of NineML models, as well as handling their serialisation to and from XML, JSON, YAML, and HDF5.

Relation to the NineML Specification

The layout of the Python modules and classes in the NineML Python Library relates closely to the structure of the NineML specification (v1.0). However, there are notable exceptions where the NineML Python Library uses names and relationships that are planned to be changed in v2.0 of the specification (the NineML Python Library will be backwards compatible), such as the renaming of ComponentClass elements to separate Dynamics, ConnectionRule and RandomDistribution elements (see https://github.com/INCF/nineml/issues/94). A full list of changes planned for NineML v2.0 can be found at https://github.com/INCF/nineml/milestone/3. When serializing 9ML models the version 1.0 syntax is used unless the version=2 keyword argument is provided.

In addition to classes that directly correspond to the 9ML object model, a range of shorthand notations (“syntactic sugar”) exist to make writing 9ML models by hand more convenient (see the nineml.sugar module). These notations are frequently demonstrated in the examples directory of the repository.

The NineML Catalog

The NineML Catalog contains a collection of validated NineML models, which can be loaded and maninpulated with the NineML Python Library. If you create a model that you believe will be of wider use to the computational neuroscience community please consider contributing to the catalog via a pull request.

Installation

HDF5 (dev)

To add support to read or write HDF5 serialisations you must first install a HDF5 dev library (i.e. with the C headers).

On macOS HDF5 can be installed using Homebrew:

$ brew install hdf5

On Ubuntu/Debian HDF5 can be installed by one of the following packages:

  • libhdf5-serial-dev (serial)

  • libhdf5-openmpi-dev (parallel with Open MPI)

  • libhdf5-mpich-dev (parallel with MPICH)

If you don’t install HDF5 the other serialisation formats can still be used but you will need to install the package manually (i.e. not use pip).

Pip

The NineML Python Library can be installed using pip:

$ pip install nineml
copyright:

Copyright 20011-2017 by the NineML Python Library team, see AUTHORS.

license:

BSD 3, see LICENSE for details.

Metadata

Release files for nineml 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nineml 1.0.1
File Size Uploaded
nineml-1.0.1.tar.gz 3.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for nineml 1.0.1
File Interpreter ABI Platform
nineml-1.0.1-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 3.9 MB

Release files / nineml-1.0.1.tar.gz

Download URL nineml-1.0.1.tar.gz
Size 3.8 MB
Tags Source
SHA-256 checksum
How to use checksums
5a41b7a77941c051e5b0aff719dd0d39943ccd2d91ad88c6c19d3fa121cc501b
BLAKE2b-256 checksum
How to use checksums
15c254e68ec9c3e48a48e8286f71183db180aa41b172ac80de8116b8be457ae8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.23.3 CPython/2.7.15

Release files / nineml-1.0.1-py2.py3-none-any.whl

Download URL nineml-1.0.1-py2.py3-none-any.whl
Size 181.7 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
6c807fc0a6295c07f0fb85d5f8c9ea3d536815edc9d5a96e4cd603a3982eb3b5
BLAKE2b-256 checksum
How to use checksums
8d8c7220e71b255e9439c6f91f0147d9006e0d4c138c3d6d7877794c1e979bc4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.23.3 CPython/2.7.15

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0

2 release files

0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page