Package coral-api

InAccel Coral Python API

import inaccel.coral as inaccel

Functions

def array(object, dtype=None, order='K', ndmin=0)

Create an array.

Parameters

object : array_like
An array, any object exposing the array interface, an object whose array method returns an array, or any (nested) sequence.
dtype : data-type, optional
The desired data-type for the array. If not given, then the type will be determined as the minimum type required to hold the objects in the sequence.
order : {‘K’, ‘A’, ‘C’, ‘F’}, optional
Specify the memory layout of the array. If object is not an array, the newly created array will be in C order (row major) unless ‘F’ is specified, in which case it will be in Fortran order (column major). If object is an array the following holds.
‘K’     F & C order preserved, otherwise most similar order
‘A’     F order if input is F and not C, otherwise C order
‘C’     C order
‘F’     F order
ndmin : int, optional
Specifies the minimum number of dimensions that the resulting array should have. Ones will be pre-pended to the shape as needed to meet this requirement.

Returns

ndarray
An array object satisfying the specified requirements.
def submit(accelerator)

Schedules the request, accelerator, to be executed as accelerator(args…) and returns a session object representing the execution of the request.

Parameters

accelerator : request
The accelerator request to submit

Returns

session
 
def wait(accelerator)

Wait for the session instance given by accelerator to complete.

Parameters

accelerator : session
The accelerator session to wait

Classes

class ndarray (...)

An array object represents a multidimensional, homogeneous array of fixed-size items. An associated data-type object describes the format of each element in the array (its byte-order, how many bytes it occupies in memory, whether it is an integer, a floating point number, or something else, etc.)

Arrays should be constructed using array(). For more information, refer to the numpy module and examine the methods and attributes of an array.

Ancestors

class request (id)

A high-level class to represent accelerated functions.

This class provides an intermediate representation of an accelerator request to Coral FPGA resource manager. You should use this class to form an acceleration request which you will later submit to InAccel Coral. Your interaction with this class should ideally be limited to declaring the accelerator id you wish to execute and populating this function with arguments.

Methods

def arg(self, value, index=None)

Used to set the argument value for a specific argument of an accelerator.

Parameters

value : ndarray or numpy.dtype
Data that should be used as the argument value for argument specified by index. If index is not specified, the value is appended to the end of the argument list.
index : int
The argument index. Arguments to the accelerator are referred by indices that go from 0 for the leftmost argument to n - 1, where n is the total number of arguments declared by an accelerator.

Returns

self
This object
class session

Encapsulates the asynchronous execution of an accelerator request. session instances are created by submit() and should not be created directly.