Skip to main content

​
Classes

​
List

Internal Instances of the List class are used to represent lists of values in TopK. Usually created using data constructors such as f32_list(), i32_list(), etc.

​
SparseVector

Internal Instances of the SparseVector class are used to represent sparse vectors in TopK. Usually created using data constructors such as f32_sparse_vector() or u8_sparse_vector().

​
Matrix

Internal Instances of the Matrix class are used to represent matrices in TopK. Usually created using data constructors such as matrix().

​
Struct

Internal Instances of the Struct class are used to represent nested object values in TopK. Usually created using the struct() helper.

​
Functions

​
f8_vector()

f8_vector(data: list[float]) -> List
Create a List type containing a 8-bit float vector. Example: 
from topk_sdk.data import f8_vector

f8_vector([0.12, 0.67, 0.82, 0.53])
Parameters
ParameterType
datalist[float]
Returns List

​
f16_vector()

f16_vector(data: list[float]) -> List
Create a List type containing a 16-bit float vector. Example: 
from topk_sdk.data import f16_vector

f16_vector([0.12, 0.67, 0.82, 0.53])
Parameters
ParameterType
datalist[float]
Returns List

​
f32_vector()

f32_vector(data: list[float]) -> List
Create a List type containing a 32-bit float vector. This function is an alias for f32_list(). Example: 
from topk_sdk.data import f32_vector

f32_vector([0.12, 0.67, 0.82, 0.53])
Parameters
ParameterType
datalist[float]
Returns List

​
u8_vector()

u8_vector(data: list[int]) -> List
Create a List type containing an 8-bit unsigned integer vector. This function is an alias for u8_list(). Example: 
from topk_sdk.data import u8_vector

u8_vector([0, 255, 1, 2, 3])
Parameters
ParameterType
datalist[int]
Returns List

​
i8_vector()

i8_vector(data: list[int]) -> List
Create a List type containing an 8-bit signed integer vector. Example: 
from topk_sdk.data import i8_vector

i8_vector([-128, 127, -1, 0, 1])
Parameters
ParameterType
datalist[int]
Returns List

​
binary_vector()

binary_vector(data: list[int]) -> List
Create a List type containing a binary vector. Example: 
from topk_sdk.data import binary_vector

binary_vector([0, 1, 1, 0])
Parameters
ParameterType
datalist[int]
Returns List

​
f32_sparse_vector()

f32_sparse_vector(data: dict[int, float]) -> SparseVector
Create a SparseVector type containing a 32-bit float sparse vector. Example: 
from topk_sdk.data import f32_sparse_vector

f32_sparse_vector({0: 0.12, 6: 0.67, 17: 0.82, 97: 0.53})
Parameters
ParameterType
datadict[int, float]
Returns SparseVector

​
u8_sparse_vector()

u8_sparse_vector(data: dict[int, int]) -> SparseVector
Create a SparseVector type containing an 8-bit unsigned integer sparse vector. Example: 
from topk_sdk.data import u8_sparse_vector

u8_sparse_vector({0: 12, 6: 67, 17: 82, 97: 53})
Parameters
ParameterType
datadict[int, int]
Returns SparseVector

​
bytes()

bytes(data: list[int] | bytes) -> List
Create a List type containing bytes data. Example: 
from topk_sdk.data import bytes

bytes([0, 1, 1, 0])
Parameters
ParameterType
datalist[int] | bytes
Returns List

​
u32_list()

u32_list(data: list[int]) -> List
Create a List type containing a list of 32-bit unsigned integers. Example: 
from topk_sdk.data import u32_list

u32_list([0, 1, 2, 3])
Parameters
ParameterType
datalist[int]
Returns List

​
i32_list()

i32_list(data: list[int]) -> List
Create a List type containing a list of 32-bit signed integers. Example: 
from topk_sdk.data import i32_list

i32_list([0, 1, 2, 3])
Parameters
ParameterType
datalist[int]
Returns List

​
i64_list()

i64_list(data: list[int]) -> List
Create a List type containing a list of 64-bit signed integers. Example: 
from topk_sdk.data import i64_list

i64_list([0, 1, 2, 3])
Parameters
ParameterType
datalist[int]
Returns List

​
f32_list()

f32_list(data: list[float]) -> List
Create a List type containing a list of 32-bit floating point numbers. Example: 
from topk_sdk.data import f32_list

f32_list([0.12, 0.67, 0.82, 0.53])
Parameters
ParameterType
datalist[float]
Returns List

​
f64_list()

f64_list(data: list[float]) -> List
Create a List type containing a list of 64-bit floating point numbers. Example: 
from topk_sdk.data import f64_list

f64_list([0.12, 0.67, 0.82, 0.53])
Parameters
ParameterType
datalist[float]
Returns List

​
string_list()

string_list(data: list[str]) -> List
Create a List type containing a list of strings. Example: 
from topk_sdk.data import string_list

string_list(["foo", "bar", "baz"])
Parameters
ParameterType
datalist[str]
Returns List

​
struct()

struct(fields: dict[str, Any]) -> Struct
Create a Struct type containing nested object values. Example: 
from topk_sdk.data import struct

struct({"author": "alice", "year": 2024})
Parameters
ParameterType
fieldsdict[str, Any]
Returns Struct

​
matrix()

matrix(values: list[list[float]] | list[list[int]] | numpy.ndarray, value_type: Optional[Literal['f32', 'f16', 'f8', 'u8', 'i8']] = None) -> Matrix
Create a Matrix type containing matrix values. The values parameter can be a list of lists or a numpy array. When passing a numpy array, the matrix type is inferred from the array’s dtype (float32, float16, uint8, int8). When passing a list of lists, the optional value_type parameter specifies the matrix type. If value_type is not provided, the matrix defaults to f32. 
from topk_sdk.data import matrix
import numpy as np

# List of lists with explicit type
matrix([[1.0, 2.0, 3.0], [4.0, 5.0, 6.0]], "f32")

# List of lists defaults to f32
matrix([[1.0, 2.0], [3.0, 4.0]])

# Numpy array infers type from dtype
matrix(np.array([[1.0, 2.0], [3.0, 4.0]], dtype=np.float16))
Parameters
ParameterType
valueslist[list[float]] | list[list[int]] | numpy.ndarray
value_typeOptional[Literal[‘f32’, ‘f16’, ‘f8’, ‘u8’, ‘i8’]]
Returns Matrix