Skip to main content

Utility classes and functions for SpiNNaker projects

Project description

SpiNNUtils

This provides basic utility functions and classes to other parts of SpiNNaker's tooling. Nothing in here knows anything about SpiNNaker functionality.

spinn_utilities.abstract_base

Provides a simplified (and faster) version of the standard Python Abstract Base Class functionality.

spinn_utilities.conf_loader

The structure to handle loading of SpiNNaker-style configuration files.

spinn_utilities.executable_finder

Utility for discovering executables to load onto SpiNNaker nodes.

spinn_utilities.helpful_functions

Miscellaneous bits.

spinn_utilities.ordered_set

A set class where the elements have an order defined by when they were inserted.

spinn_utilities.overrides

Decorator for declaring where a method overrides another method.

spinn_utilities.progress_bar

Generalised progress bar printer.

spinn_utilities.socket_address

Holder for the locations of network resources.

spinn_utilities.timer

General code timer utility.

Generating Aggregated Citation Files

The spinn_utilities.citation.citation_aggregator module can be executed to generate a .cff file consisting of the Citation.cff file from the given top-level module, plus references made up from the dependencies of the top-level module. If these dependencies have .cff files themselves, the references will contain the information from those files, otherwise it will use the version number and name of the module as a reference. The tool can also create a DOI for the version of the tools in use which can then be cited. This makes use of the Zenodo service.

To use the tool, run the following after installing SpiNNUtils:

python -m spinn_utilities.citation.citation_aggregator [-h] [--create_doi] [--publish_doi] [--doi_title DOI_TITLE] [--previous_doi PREVIOUS_DOI] [--zenodo_access_token ZENODO_ACCESS_TOKEN] output_path top_module

positional arguments:
  output_path           The file to store the result in
  top_module            The module to start with

optional arguments:
  -h, --help                                 show this help message and exit
  --create_doi                               Create a DOI from the resulting citation on Zenodo
  --publish_doi                              Publish the DOI created
  --doi_title DOI_TITLE                      The title to give the created DOI
  --previous_doi PREVIOUS_DOI                The DOI this is a newer version of
  --zenodo_access_token ZENODO_ACCESS_TOKEN  Access token for Zenodo

Documentation

SpiNNUtils python documentation

Combined python documentation

Project details


Download files

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

Source Distribution

spinnutilities-1!7.3.0.tar.gz (123.9 kB view details)

Uploaded Source

Built Distribution

SpiNNUtilities-1!7.3.0-py3-none-any.whl (165.4 kB view details)

Uploaded Python 3

File details

Details for the file spinnutilities-1!7.3.0.tar.gz.

File metadata

  • Download URL: spinnutilities-1!7.3.0.tar.gz
  • Upload date:
  • Size: 123.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for spinnutilities-1!7.3.0.tar.gz
Algorithm Hash digest
SHA256 5343004fd2aeec0124267e91c2649356b20bf8f2a5d33c9d7cd5ea6cce7dd86b
MD5 008fe3962dd4585cc4dccff9a9020e28
BLAKE2b-256 ad3feeb132687e88899b5e63287bcef61d337249381e482753f87fc1089ae8cc

See more details on using hashes here.

File details

Details for the file SpiNNUtilities-1!7.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for SpiNNUtilities-1!7.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 053363f17f82bc8005f73691a2f88630e0ac20cf561d00367dfb191855f4e3c8
MD5 bf69b856ec32450360200adf9cb3cb76
BLAKE2b-256 d12573b9a80d7c55a570a025d7c0c3f4ed42ae641dda0c8310bf4a82a086a603

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