spinn_front_end_common.interface package

Subpackages

• spinn_front_end_common.interface.buffer_management package
  • Subpackages
    • spinn_front_end_common.interface.buffer_management.buffer_models package
      • Module contents
    • spinn_front_end_common.interface.buffer_management.storage_objects package
      • Module contents
  • Module contents
• spinn_front_end_common.interface.ds package
  • Module contents
• spinn_front_end_common.interface.interface_functions package
  • Module contents
• spinn_front_end_common.interface.profiling package
  • Module contents
• spinn_front_end_common.interface.provenance package
  • Module contents
• spinn_front_end_common.interface.simulation package
  • Module contents
• spinn_front_end_common.interface.splitter_selectors package
  • Module contents

Submodules

spinn_front_end_common.interface.abstract_spinnaker_base module

main interface for the SpiNNaker tools

class spinn_front_end_common.interface.abstract_spinnaker_base.AbstractSpinnakerBase(data_writer_cls=None)

Bases: spinn_front_end_common.interface.config_handler.ConfigHandler

Main interface into the tools logic flow.

Parameters:

• n_chips_required (int) – Overrides the number of chips to allocate from spalloc
• n_boards_required (int) – Overrides the number of boards to allocate from spalloc
• data_writer_cls (FecDataWriter) – The Global data writer class

continue_simulation()

Continue a simulation that has been started in stepped mode.

exception_handler(exctype, value, traceback_obj)

Handler of exceptions.

Parameters:

• exctype (type) – the type of exception received
• value (Exception) – the value of the exception
• traceback_obj (traceback) – the trace back stuff

get_number_of_available_cores_on_machine

The number of available cores on the machine after taking into account preallocated resources.

Returns:number of available cores Return type:int

reset()

Puts the simulation back at time zero.

run(run_time, sync_time=0)

Run a simulation for a fixed amount of time.

Parameters:

• run_time (int) – the run duration in milliseconds.
• sync_time (float) – If not 0, this specifies that the simulation should pause after this duration. The continue_simulation() method must then be called for the simulation to continue.

run_until_complete(n_steps=None)

Run a simulation until it completes.

Parameters:n_steps (int) – If not None, this specifies that the simulation should be requested to run for the given number of steps. The host will still wait until the simulation itself says it has completed

stop()

End running of the simulation.

stop_run()

Request that the current infinite run stop.

Note

This will need to be called from another thread as the infinite run call is blocking.

Raises:SpiNNUtilsException – If the stop_run was not expected in the current state.

spinn_front_end_common.interface.config_handler module

class spinn_front_end_common.interface.config_handler.ConfigHandler(data_writer_cls=None)

Bases: object

Superclass of AbstractSpinnakerBase that handles function only dependent of the config and the order its methods are called.

Parameters:data_writer (FecDataWriter) – The Global data writer object

write_errored_file()

Writes a errored file that allows file removal to only remove folders that are errored if requested to do so

write_finished_file()

Write a finished file that allows file removal to only remove folders that are finished.

spinn_front_end_common.interface.java_caller module

class spinn_front_end_common.interface.java_caller.JavaCaller

Bases: object

Support class that holds all the stuff for running stuff in Java. This includes the work of preparing data for transmitting to Java and back.

This separates the choices of how to call the Java batch vs streaming, jar locations, parameters, etc from the rest of the python code.

Creates a java caller and checks the user/config parameters.

Raises:ConfigurationException – if simple parameter checking fails.

execute_app_data_specification(use_monitors)

Writes all the data specs for application cores, uploading the result to the machine.

Note

May assume that system cores are already loaded and running if use_monitors is set to True.

Parameters:use_monitors (bool) – Raises:PacmanExternalAlgorithmFailedToCompleteException – On failure of the Java code.

execute_data_specification()

Writes all the data specs, uploading the result to the machine.

Raises:PacmanExternalAlgorithmFailedToCompleteException – On failure of the Java code.

execute_system_data_specification()

Writes all the data specs for system cores, uploading the result to the machine.

Raises:PacmanExternalAlgorithmFailedToCompleteException – On failure of the Java code.

get_all_data()

Gets all the data from the previously set placements and put these in the previously set database.

Raises:PacmanExternalAlgorithmFailedToCompleteException – On failure of the Java code.

set_advanced_monitors()

Create information describing what’s going on with the monitor cores.

set_placements(used_placements)

Passes in the placements leaving this class to decide pass it to Java.

Currently the extra information extracted is recording region base address but this could change if recording region saved in the database.

Currently this method uses JSON but that may well change to using the database.

Parameters:used_placements (Placements) – Placements that are recording. May not be all placements

Module contents