spinn_front_end_common.interface.ds package

Module contents

class spinn_front_end_common.interface.ds.DataRowWriter(x, y, p, targets)

Bases: io.RawIOBase

close()

Closes the writer if not already closed.

fileno()

Returns underlying file descriptor if one exists.

OSError is raised if the IO object does not use a file descriptor.

readable()

Return whether object was opened for reading.

If False, read() will raise OSError.

seekable()

Return whether object supports random access.

If False, seek(), tell() and truncate() will raise OSError. This method may need to do a test seek().

truncate(size=None)

Truncate file to size bytes.

File pointer is left unchanged. Size defaults to the current IO position as reported by tell(). Returns the new size.

writable()

Return whether object was opened for writing.

If False, write() will raise OSError.

write(data)

class spinn_front_end_common.interface.ds.DsSqlliteDatabase(init=None)

Bases: spinn_front_end_common.utilities.sqlite_db.SQLiteDB

Parameters:init (bool or None) –

app_items()

Yields the keys and values for the DS data for application cores.

Note

Do not use the database for anything else while iterating.

Returns:Yields the (x, y, p) and saved ds pairs Return type:iterable(tuple(tuple(int,int,int),RawIOBase, int))

clear_write_info()

Clears the provenance for all rows.

create_data_spec(x, y, p)

Parameters:

• x (int) –
• y (int) –
• p (int) –

Return type:

DataRowWriter

classmethod default_database_file()

ds_get_app_id(x, y, p)

Gets the app_id set for this core.

Parameters:

• x (int) – core x
• y (int) – core y
• p (int) – core

Return type:

int

ds_mark_as_system(core_list)

Flags a list of processors as running system binaries.

Parameters:core_list (iterable(tuple(int,int,int))) – list of (core x, core y, core p)

ds_n_app_cores()

Returns the number for application cores there is a ds saved for.

Return type:int Raises:DsDatabaseException –

ds_n_cores()

Returns the number for cores there is a ds saved for.

Return type:int Raises:DsDatabaseException –

ds_n_system_cores()

Returns the number for system cores there is a ds saved for.

Return type:int Raises:DsDatabaseException –

get_ds(x, y, p)

Retrieves the data spec as byte code for this core.

Parameters:

• x (int) – core x
• y (int) – core y
• p (int) – core p

Returns:

data spec as byte code

Return type:

bytearray

get_write_info(x, y, p)

Gets the provenance returned by the Data Spec executor.

Parameters:

• x (int) – core x
• y (int) – core y
• p (int) – core p

Returns:

start_address, memory_used, memory_written

Return type:

DataWritten

info_iteritems()

Yields the keys and values for the Info data.

Note

A DB transaction may be held while this iterator is processing. Reentrant use of this class is not supported.

Returns:Yields the (x, y, p), start_address, memory_used and memory_written Return type:iterable(tuple(tuple(int, int, int), int, int, int))

info_n_cores()

Returns the number for cores there is a info saved for.

Return type:int Raises:DsDatabaseException –

items()

Yields the keys and values for the DS data.

Note

Do not use the database for anything else while iterating.

Returns:Yields the (x, y, p) and saved ds pairs Return type:iterable(tuple(tuple(int,int,int),RawIOBase))

keys()

Yields the keys.

Note

Do not use the database for anything else while iterating.

Returns:Yields the (x, y, p) Return type:iterable(tuple(int,int,int))

mark_system_cores(core_subsets)

Parameters:core_subsets (CoreSubsets) –

set_app_id(app_id)

Sets the same app_id for all rows that have ds content.

Parameters:app_id (int) – value to set

set_size_info(x, y, p, memory_used)

set_write_info(x, y, p, start, used, written)

Sets the provenance returned by the Data Spec executor.

Parameters:

• x (int) – core x
• y (int) – core y
• p (int) – core p
• start (int) – base_address:
• used (int) – size_allocated:
• written (int) – bytes_written:

system_items()

Yields the keys and values for the DS data for system cores.

Note

Do not use the database for anything else while iterating.

Returns:Yields the (x, y, p), saved ds and region_size triples Return type:iterable(tuple(tuple(int,int,int),RawIOBase, int))

write_data_spec(core_x, core_y, core_p, ds)

Parameters:

• core_x (int) – x of the core ds applies to
• core_y (int) – y of the core ds applies to
• p (int) – p of the core ds applies to
• ds (bytearray) – the data spec as byte code

write_session_credentials_to_db()

Write Spalloc session credentials to the database if in use