Rig is a Python library which contains a collection of complementary tools for
developing applications for the massively-parallel
First and foremost, Rig aims to present a light-weight, well tested and well
documented interface for SpiNNaker application developers.
The latest stable release can be installed from the Python Package
pip install rig
You could then use Rig to write a Python one-liner to count the number of cores
in your SpiNNaker super computer:
>>> from rig.machine_control import MachineController
>>> sum(chip.num_cores for chip in
To find out how to do something useful, head over to the Rig documentation on
See DEVELOP.md for information on how to get involved in Rig development
or install the latest development version.
Rig does not mandate any particular application work flow but rather provides a
set of common utilities with well-defined, composable interfaces. Developers
are encouraged to use whatever subset of these tools they consider useful.
The utilities provided by Rig can be broken down approximately as follows:
- Data packaging for SpiNNaker
- type_casts: conversion functions between common
Python and Numpy data types and the fixed-point types used by SpiNNaker.
- bitfield.BitField: an abstraction for flexibly defining routing keys
for SpiNNaker applications ranging from the trivial to those involving
multiple external devices with conflicting routing key formats.
- Graph-to-machine mapping
- place_and_route: a suite of algorithms for mapping graph-like problems
onto the SpiNNaker hardware, allocating on-chip resources and generating
- routing_table: a suite of algorithms for minimising and analysing
SpiNNaker’s multicast routing tables.
- geometry: utility functions for working with SpiNNaker’s hexagonal
- Execution control and machine management
- machine_control.MachineController: a high-level interface to SpiNNaker
machines. Can be used to boot machines, load and control applications,
- machine_control.BMPController: a high-level interface to the
Board Management Processors (BMPs) found in large SpiNNaker
installations. Can be used to control system power and read diagnostic
information such as temperature and FPGA status.
- Standalone utility applications
- rig-boot: No-nonsense command line utility for booting SpiNNaker
- rig-power: No-nonsense command line utility for power-cycling SpiNNaker
- rig-info: No-nonsense command line utility to get high-level
information about a SpiNNaker system, e.g. “what is it running, is it on
- rig-discover: No-nonsense command line utility for discovering the IP of
connected, unbooted SpiNNaker boards.
- rig-iobuf: No-nonsense command line utility for reading IOBUF messages
from a SpiNNaker application.
- rig-ps: No-nonsense command line utility for listing all applications
(and their locations) in a SpiNNaker machine.
- rig-counters: No-nonsense command line utility which can
non-intrusively monitor a SpiNNaker system for dropped packets.
Python Version Support
Rig is tested against the following versions of Python:
Other versions may or may not work.
See CONTRIBUTORS.md for a list of all the folk who’ve
contributed to Rig.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.