pacman.model.graphs package

Subpackages

• pacman.model.graphs.application package
  • Subpackages
    • pacman.model.graphs.application.abstract package
      • Module contents
  • Module contents
    • Application2DFPGAVertex
      • Application2DFPGAVertex.atoms_shape
      • Application2DFPGAVertex.get_incoming_slice_for_link()
      • Application2DFPGAVertex.height
      • Application2DFPGAVertex.sub_height
      • Application2DFPGAVertex.sub_width
      • Application2DFPGAVertex.width
    • Application2DSpiNNakerLinkVertex
      • Application2DSpiNNakerLinkVertex.atoms_shape
      • Application2DSpiNNakerLinkVertex.get_incoming_slice()
      • Application2DSpiNNakerLinkVertex.height
      • Application2DSpiNNakerLinkVertex.sub_height
      • Application2DSpiNNakerLinkVertex.sub_width
      • Application2DSpiNNakerLinkVertex.width
    • ApplicationEdge
      • ApplicationEdge.label
      • ApplicationEdge.post_vertex
      • ApplicationEdge.pre_vertex
    • ApplicationEdgePartition
      • ApplicationEdgePartition.add_edge()
    • ApplicationFPGAVertex
      • ApplicationFPGAVertex.get_incoming_slice_for_link()
      • ApplicationFPGAVertex.get_outgoing_link_data()
      • ApplicationFPGAVertex.get_outgoing_slice()
      • ApplicationFPGAVertex.incoming_fpga_connections
      • ApplicationFPGAVertex.n_atoms
      • ApplicationFPGAVertex.n_machine_vertices_per_link
      • ApplicationFPGAVertex.outgoing_fpga_connection
    • ApplicationGraph
      • ApplicationGraph.add_edge()
      • ApplicationGraph.add_vertex()
      • ApplicationGraph.edges
      • ApplicationGraph.get_outgoing_edge_partition_starting_at_vertex()
      • ApplicationGraph.get_outgoing_edge_partitions_starting_at_vertex()
      • ApplicationGraph.n_outgoing_edge_partitions
      • ApplicationGraph.n_vertices
      • ApplicationGraph.outgoing_edge_partitions
      • ApplicationGraph.reset()
      • ApplicationGraph.vertex_by_label()
      • ApplicationGraph.vertices
    • ApplicationSpiNNakerLinkVertex
      • ApplicationSpiNNakerLinkVertex.board_address
      • ApplicationSpiNNakerLinkVertex.get_incoming_slice()
      • ApplicationSpiNNakerLinkVertex.get_max_atoms_per_core()
      • ApplicationSpiNNakerLinkVertex.get_outgoing_link_data()
      • ApplicationSpiNNakerLinkVertex.get_outgoing_slice()
      • ApplicationSpiNNakerLinkVertex.incoming
      • ApplicationSpiNNakerLinkVertex.n_atoms
      • ApplicationSpiNNakerLinkVertex.n_machine_vertices
      • ApplicationSpiNNakerLinkVertex.outgoing
      • ApplicationSpiNNakerLinkVertex.spinnaker_link_id
    • ApplicationVertex
      • ApplicationVertex.add_incoming_edge()
      • ApplicationVertex.atoms_shape
      • ApplicationVertex.get_fixed_key_and_mask()
      • ApplicationVertex.get_key_ordered_indices()
      • ApplicationVertex.get_machine_fixed_key_and_mask()
      • ApplicationVertex.get_max_atoms_per_core()
      • ApplicationVertex.get_max_atoms_per_dimension_per_core()
      • ApplicationVertex.get_raster_ordered_indices()
      • ApplicationVertex.has_fixed_location()
      • ApplicationVertex.has_splitter
      • ApplicationVertex.machine_vertices
      • ApplicationVertex.n_atoms
      • ApplicationVertex.remember_machine_vertex()
      • ApplicationVertex.reset()
      • ApplicationVertex.round_n_atoms()
      • ApplicationVertex.set_max_atoms_per_dimension_per_core()
      • ApplicationVertex.splitter
    • ApplicationVirtualVertex
      • ApplicationVirtualVertex.get_outgoing_link_data()
    • FPGAConnection
      • FPGAConnection.board_address
      • FPGAConnection.chip_coords
      • FPGAConnection.fpga_id
      • FPGAConnection.fpga_link_id
• pacman.model.graphs.common package
  • Submodules
  • pacman.model.graphs.common.edge_traffic_type module
    • EdgeTrafficType
      • EdgeTrafficType.FIXED_ROUTE
      • EdgeTrafficType.MULTICAST
      • EdgeTrafficType.SDRAM
  • Module contents
    • ChipAndCore
      • ChipAndCore.p
      • ChipAndCore.x
      • ChipAndCore.y
    • MDSlice
      • MDSlice.as_slice()
      • MDSlice.dimension
      • MDSlice.end
      • MDSlice.from_string()
      • MDSlice.get_ids_as_slice_or_list()
      • MDSlice.get_raster_ids()
      • MDSlice.get_raster_indices()
      • MDSlice.get_relative_indices()
      • MDSlice.get_slice()
      • MDSlice.hi_atom
      • MDSlice.shape
      • MDSlice.start
    • Slice
      • Slice.as_slice()
      • Slice.dimension
      • Slice.end
      • Slice.from_string()
      • Slice.get_ids_as_slice_or_list()
      • Slice.get_raster_ids()
      • Slice.get_raster_indices()
      • Slice.get_relative_indices()
      • Slice.get_slice()
      • Slice.hi_atom
      • Slice.lo_atom
      • Slice.n_atoms
      • Slice.shape
      • Slice.start
• pacman.model.graphs.machine package
  • Module contents
    • AbstractSDRAMPartition
      • AbstractSDRAMPartition.get_sdram_base_address_for()
      • AbstractSDRAMPartition.get_sdram_size_of_region_for()
      • AbstractSDRAMPartition.sdram_base_address
      • AbstractSDRAMPartition.total_sdram_requirements()
    • ConstantSDRAMMachinePartition
      • ConstantSDRAMMachinePartition.add_edge()
      • ConstantSDRAMMachinePartition.get_sdram_base_address_for()
      • ConstantSDRAMMachinePartition.get_sdram_size_of_region_for()
      • ConstantSDRAMMachinePartition.sdram_base_address
      • ConstantSDRAMMachinePartition.total_sdram_requirements()
    • DestinationSegmentedSDRAMMachinePartition
      • DestinationSegmentedSDRAMMachinePartition.add_edge()
      • DestinationSegmentedSDRAMMachinePartition.get_sdram_base_address_for()
      • DestinationSegmentedSDRAMMachinePartition.get_sdram_size_of_region_for()
      • DestinationSegmentedSDRAMMachinePartition.sdram_base_address
      • DestinationSegmentedSDRAMMachinePartition.total_sdram_requirements()
    • MachineEdge
      • MachineEdge.label
      • MachineEdge.post_vertex
      • MachineEdge.pre_vertex
    • MachineFPGAVertex
      • MachineFPGAVertex.board_address
      • MachineFPGAVertex.fpga_id
      • MachineFPGAVertex.fpga_link_id
      • MachineFPGAVertex.get_link_data()
      • MachineFPGAVertex.incoming
      • MachineFPGAVertex.linked_chip_coordinates
      • MachineFPGAVertex.outgoing
      • MachineFPGAVertex.outgoing_keys_and_masks()
      • MachineFPGAVertex.sdram_required
    • MachineSpiNNakerLinkVertex
      • MachineSpiNNakerLinkVertex.board_address
      • MachineSpiNNakerLinkVertex.get_link_data()
      • MachineSpiNNakerLinkVertex.incoming
      • MachineSpiNNakerLinkVertex.linked_chip_coordinates
      • MachineSpiNNakerLinkVertex.outgoing
      • MachineSpiNNakerLinkVertex.outgoing_keys_and_masks()
      • MachineSpiNNakerLinkVertex.sdram_required
      • MachineSpiNNakerLinkVertex.spinnaker_link_id
    • MachineVertex
      • MachineVertex.app_vertex
      • MachineVertex.get_fixed_location()
      • MachineVertex.get_n_keys_for_partition()
      • MachineVertex.index
      • MachineVertex.iptags
      • MachineVertex.reverse_iptags
      • MachineVertex.sdram_required
      • MachineVertex.vertex_slice
    • MulticastEdgePartition
    • SDRAMMachineEdge
      • SDRAMMachineEdge.sdram_base_address
      • SDRAMMachineEdge.sdram_size
    • SimpleMachineVertex
      • SimpleMachineVertex.iptags
      • SimpleMachineVertex.reverse_iptags
      • SimpleMachineVertex.sdram_required
    • SourceSegmentedSDRAMMachinePartition
      • SourceSegmentedSDRAMMachinePartition.add_edge()
      • SourceSegmentedSDRAMMachinePartition.get_sdram_base_address_for()
      • SourceSegmentedSDRAMMachinePartition.get_sdram_size_of_region_for()
      • SourceSegmentedSDRAMMachinePartition.is_sdram_base_address_defined()
      • SourceSegmentedSDRAMMachinePartition.sdram_base_address
      • SourceSegmentedSDRAMMachinePartition.total_sdram_requirements()

Module contents

class pacman.model.graphs.AbstractEdge

Bases: Generic[V]

A directed edge in a graph between two vertices.

abstract property label: str | None

The label of the edge.

abstract property post_vertex: V

The vertex at the end of the edge.

abstract property pre_vertex: V

The vertex at the start of the edge.

class pacman.model.graphs.AbstractEdgePartition(identifier: str, allowed_edge_types: Type[E] | Tuple[Type[E], ...])

Bases: Generic[E]

A collection of edges which start at a single vertex which have the same semantics and so can share a single key or block of SDRAM (depending on edge type).

Parameters:

• identifier – The identifier of the partition

• allowed_edge_types – The types of edges allowed

add_edge(edge: E) → None

Add an edge to the edge partition.

Parameters:

edge – the edge to add

Raises:

PacmanInvalidParameterException – If the edge does not belong in this edge partition

property edges: Collection[E]

The edges in this edge partition.

Note

The order in which the edges are added is preserved for when they are requested later. If not, please talk to the software team.

property identifier: str

The identifier of this edge partition.

property n_edges: int

The number of edges in the edge partition.

abstract property pre_vertices: Collection[AbstractVertex]

The vertices associated with this partition.

Note

Most edge partitions will be AbstractSingleSourcePartition and therefore provide the pre_vertex method.

class pacman.model.graphs.AbstractMultiplePartition(pre_vertices: Collection[V], identifier: str, allowed_edge_types: Type[E] | Tuple[Type[E], ...])

Bases: AbstractEdgePartition[E], Generic[V, E]

An edge partition that has multiple source vertices.

Parameters:

• pre_vertices – The vertices which send through this partition

• identifier – The identifier of the partition

• allowed_edge_types – The types of edges allowed

add_edge(edge: E) → None

Add an edge to the edge partition.

Parameters:

edge – the edge to add

Raises:

PacmanInvalidParameterException – If the edge does not belong in this edge partition

property pre_vertices: Collection[V]

The vertices associated with this partition.

Note

Most edge partitions will be AbstractSingleSourcePartition and therefore provide the pre_vertex method.

class pacman.model.graphs.AbstractSingleSourcePartition(pre_vertex: V, identifier: str, allowed_edge_types: Type[E] | Tuple[Type[E], ...])

Bases: AbstractEdgePartition, Generic[V, E]

An edge partition that has a single source vertex.

Parameters:

• pre_vertex – The vertex at the start of all the edges

• identifier – The identifier of the partition

• allowed_edge_types – The types of edges allowed

add_edge(edge: E) → None

Add an edge to the edge partition.

Parameters:

edge – the edge to add

Raises:

PacmanInvalidParameterException – If the edge does not belong in this edge partition

property pre_vertex: V

The vertex at which all edges in this outgoing edge partition start.

property pre_vertices: Sequence[V]

The vertices associated with this partition.

Note

Most edge partitions will be AbstractSingleSourcePartition and therefore provide the pre_vertex method.

class pacman.model.graphs.AbstractSupportsSDRAMEdges

Bases: object

Marks a machine vertex that can have SDRAM edges attached to it.

abstractmethod sdram_requirement(sdram_machine_edge: SDRAMMachineEdge) → int

Asks a machine vertex for the SDRAM requirement it needs.

Parameters:

sdram_machine_edge – The SDRAM edge in question ~pacman.model.graphs.machine.SDRAMMachineEdge

Returns:

The size in bytes this vertex needs for the SDRAM edge.

class pacman.model.graphs.AbstractVertex(label: str | None = None)

Bases: object

A vertex in a graph.

Parameters:

label – The optional name of the vertex

get_fixed_location() → ChipAndCore | None

The x, y and possibly p the vertex must be placed on.

Typically None! Does not have the value of a normal placements.

Used instead of ChipAndCoreConstraint.

Returns:

None or the location constraint,

has_been_added_to_graph() → bool

Returns:

True if the vertex has been added to the graph

property label: str | None

The current label to the vertex.

This label could change when the vertex is added to the graph.

set_added_to_graph() → None

Records that the vertex has been added to a graph.

Raises:

PacmanConfigurationException – If there is an attempt to add the same vertex more than once

set_fixed_location(x: int, y: int, p: int | None = None) → None

Set the location where the vertex must be placed.

Note

If called, must be called prior to the placement algorithms.

Parameters:

• x – X coordinate of fixed location

• y – Y coordinate of fixed location

• p – Processor ID of fixed location

Raises:

PacmanConfigurationException – If a fixed location has already been set to a different location.

set_label(label: str) → None

Changes the label for a vertex not yet added to a graph.

Parameters:

label – new value for the label

Raises:

PacmanConfigurationException – If there is an attempt to change the label once the vertex has been added to a graph

class pacman.model.graphs.AbstractVirtual

Bases: object

A vertex which exists outside of the machine, allowing a graph to formally participate in I/O.

Note

Everything that is an instance of AbstractVirtual is also an instance of AbstractVertex.

abstract property board_address: str | None

The IP address of the board to which the device is connected, or None for the boot board, or when using linked chip coordinates.

abstractmethod get_link_data(machine: Machine) → AbstractLinkData

Get link data from the machine.

Parameters:

machine – The machine to get the data from

Returns:

The link of the type used by the specific vertex.

abstract property incoming: bool

Whether this device sends traffic into SpiNNaker.

abstract property linked_chip_coordinates: XY | None

The coordinates of the chip to which the device is connected, or None for the boot board, or when using a board address.

abstract property outgoing: bool

Whether this device receives traffic from SpiNNaker.

abstractmethod outgoing_keys_and_masks() → List[BaseKeyAndMask] | None

Get the keys sent by the device or None if there aren’t any explicitly defined.

Returns:

The keys and masks used by the vertex if any