kp value


class kp.DdrManageAttributes(model_size=0, input_buffer_size=0, input_buffer_count=0, result_buffer_size=0, result_buffer_count=0)

DDR memory management descriptor of Kneron device.

get_member_variable_dict()

Represent member variables with Dict format.

property input_buffer_count(: int)

int: Input buffer count for FIFO queue.

property input_buffer_size(: int)

int: Input buffer size for FIFO queue.

property model_size(: int)

int: DDR space for model.

property result_buffer_count(: int)

int: Result buffer count for FIFO queue.

property result_buffer_size(: int)

int: Result buffer size for FIFO queue.


Information of one connected device from USB perspectives.

property firmware(: str)

str: Firmware description.

get_member_variable_dict()

Represent member variables with Dict format.

property is_connectable(: bool)

bool: Indicate if this device is connectable.

property kn_number(: int)

int: KN number.

UsbSpeed: Enum for USB speed mode.

property product_id(: int)

int: USB PID (Product ID).

property usb_port_id(: int)

int: An unique ID representing for a Kneron device, can be used as input while connecting devices.

property usb_port_path(: str)

str: “busNo-hub_portNo-device_portNo” (ex: “1-2-3”, means bus 1 - (hub) port 2 - (device) port 3)

property vendor_id(: int)

int: Supposed to be 0x3231.


class kp.DeviceDescriptorList(device_descriptor_list=[])

Information of connected devices from USB perspectives.

property device_descriptor_list(: List[kp.KPValue.DeviceDescriptor])

List[kp.DeviceDescriptor]: DeviceDescriptor objects list, contain information of connected devices from USB perspectives.

property device_descriptor_number(: int)

int: Number of connected devices.

get_member_variable_dict()

Represent member variables with Dict format.


class kp.DeviceGroup(address)

A handle represent connected Kneron device.

property address(: int)

int: Memory address of connected Kneron device handler.

property content(: kp.KPValue.DeviceGroupContent)

DeviceGroupContent: A DeviceGroup descriptor.

get_member_variable_dict()

Represent member variables with Dict format.


class kp.FirmwareVersion(reserved=0, major=0, minor=0, update=0, build=0)

Information of firmware version.

get_member_variable_dict()

Represent member variables with Dict format.

property reserved(: int)

int: Reserved version number for backward compatibility.


class kp.GenericDataInferenceDescriptor(inference_number=0, model_id=0, input_node_data_list=[])

Multiple input inference descriptor for bypass pre-processing inference.

get_member_variable_dict()

Represent member variables with Dict format.

property inference_number(: int)

int: Inference sequence number.

property input_node_data_list(: List[kp.KPValue.GenericInputNodeData])

List[GenericInputNodeData]: Multiple input inference data descriptors (The data order must be mapping model input tensor order as shown in ModelNefDescriptor).

property input_node_data_num(: int)

int: Number of multiple input inference data descriptors in input_node_data_list.

property model_id(: int)

int: Target inference model ID.


class kp.GenericDataInferenceResult(buffer_size)

Multiple input bypass pre-processing inference raw result.

get_member_variable_dict()

Represent member variables with Dict format.

property header(: kp.KPValue.GenericDataInferenceResultHeader)

kp.GenericDataInferenceResultHeader: Multiple input bypass pre-processing inference raw output descriptor.

property raw_result(: kp.KPValue.GenericRawResultNDArray)

kp.GenericRawResultNDArray: Inference raw result buffer.


class kp.GenericDataInferenceResultHeader(inference_number=0, crop_number=0, num_output_node=0, product_id=0)

Multiple input bypass pre-processing inference raw output descriptor.

property crop_number(: int)

int: Crop box sequence number.

get_member_variable_dict()

Represent member variables with Dict format.

property inference_number(: int)

int: Inference sequence number.

property num_output_node(: int)

int: Total number of output nodes.

property product_id(: int)

int: USB PID (Product ID).


class kp.GenericImageInferenceDescriptor(inference_number=0, model_id=0, input_node_image_list=[])

Multiple input inference descriptor for images.

get_member_variable_dict()

Represent member variables with Dict format.

property inference_number(: int)

int: Inference sequence number.

property input_node_image_list(: List[kp.KPValue.GenericInputNodeImage])

List[kp.GenericInputNodeImage]: Multiple input inference image data descriptors (Max number of input image is 5) (The image data order must be mapping model input tensor order as shown in ModelNefDescriptor).

property input_node_image_num(: int)

int: Number of multiple input inference image data descriptors in input_node_image_list.

property model_id(: int)

int: Target inference model ID.


class kp.GenericImageInferenceResult(buffer_size)

Generic multiple input inference raw result.

get_member_variable_dict()

Represent member variables with Dict format.

property header(: kp.KPValue.GenericImageInferenceResultHeader)

kp.GenericImageInferenceResultHeader: Multiple input image inference raw output descriptor.

property raw_result(: kp.KPValue.GenericRawResultNDArray)

kp.GenericRawResultNDArray: Inference raw result buffer.


class kp.GenericImageInferenceResultHeader(inference_number=0, crop_number=0, num_output_node=0, product_id=0, hw_pre_proc_info_list=[])

Multiple input image inference raw output descriptor.

property crop_number(: int)

int: Crop box sequence number.

get_member_variable_dict()

Represent member variables with Dict format.

property hw_pre_proc_info_list(: List[kp.KPValue.HwPreProcInfo])

List[kp.HwPreProcInfo]: Hardware pre-process information for each input node.

property inference_number(: int)

int: Inference sequence number.

property num_hw_pre_proc_info(: int)

int: Number of hardware pre-process information.

property num_output_node(: int)

int: Total number of output nodes.

property product_id(: int)

int: USB PID (Product ID).


class kp.GenericInputNodeData(buffer=b'')

Single data descriptor for bypass pre-processing inference.

property buffer(: bytes)

bytes: The data bytes contains the inference data.

property buffer_size(: int)

int: Inference data buffer size.

get_member_variable_dict()

Represent member variables with Dict format.


class kp.GenericInputNodeImage(image=array([], shape=(0, 0, 2), dtype=uint8), width=0, height=0, image_format=ImageFormat.KP_IMAGE_FORMAT_RGB565, resize_mode=ResizeMode.KP_RESIZE_ENABLE, padding_mode=PaddingMode.KP_PADDING_CORNER, normalize_mode=NormalizeMode.KP_NORMALIZE_KNERON, inference_crop_box_list=[])

Single inference image data descriptor.

property crop_count(: int)

int: Number of crop box.

get_member_variable_dict()

Represent member variables with Dict format.

property height(: int)

int: Inference image height (Must apply when using bytes image data).

property image(: numpy.ndarray)

numpy.ndarray: The data bytes or numpy.ndarray (dtype=numpy.uint8, dim=3) contains the image.

property image_format(: kp.KPEnum.ImageFormat)

kp.ImageFormat: Inference image format, refer to ImageFormat.

property inference_crop_box_list(: List[kp.KPValue.InferenceCropBox])

List[kp.InferenceCropBox]: Box information to crop.

property normalize_mode(: kp.KPEnum.NormalizeMode)

kp.NormalizeMode: Inference normalization, refer to NormalizeMode.

property padding_mode(: kp.KPEnum.PaddingMode)

kp.PaddingMode: Preprocess padding mode, none or auto refer to PaddingMode.

property resize_mode(: kp.KPEnum.ResizeMode)

kp.ResizeMode: Preprocess resize mode, refer to ResizeMode.

property width(: int)

int: Inference image width (Must apply when using bytes image data).


class kp.GenericRawResultNDArray(buffer_size)

Inference raw result buffer.

property buffer_size(: int)

int: Size of generic inference raw result buffer.

get_member_variable_dict()

Represent member variables with Dict format.


class kp.HwPreProcInfo(img_width=0, img_height=0, resized_img_width=0, resized_img_height=0, pad_top=0, pad_bottom=0, pad_left=0, pad_right=0, model_input_width=0, model_input_height=0, crop_area={'crop_box_index': 0, 'x': 0, 'y': 0, 'width': 0, 'height': 0})

Information of Hardware Pre Process.

property crop_area(: kp.KPValue.InferenceCropBox)

InferenceCropBox: Information of crop area. (may not be the same as input due to hardware limitation)

get_member_variable_dict()

Represent member variables with Dict format.

property img_height(: int)

int: Image height before hardware pre-process.

property img_width(: int)

int: Image width before hardware pre-process.

property model_input_height(: int)

int: Model required input height.

property model_input_width(: int)

int: Model required input width.

property pad_bottom(: int)

int: Pixels padding on bottom.

property pad_left(: int)

int: Pixels padding on left.

property pad_right(: int)

int: Pixels padding on right.

property pad_top(: int)

int: Pixels padding on top.

property resized_img_height(: int)

int: Image height after resize.

property resized_img_width(: int)

int: Image width after resize.


class kp.InferenceConfiguration(enable_frame_drop=False)

Inference configurations.

property enable_frame_drop(: bool)

bool: Enable this to keep inference non-blocking by dropping oldest and unprocessed frames.

get_member_variable_dict()

Represent member variables with Dict format.


class kp.InferenceCropBox(crop_box_index=0, x=0, y=0, width=0, height=0)

Class for an image crop region.

property crop_box_index(: int)

int: Index number of crop box.

get_member_variable_dict()

Represent member variables with Dict format.

property height(: int)

int: Height coordinate of crop box.

property width(: int)

int: Width coordinate of crop box.

property x(: int)

int: X coordinate of crop box top-left corner.

property y(: int)

int: Y coordinate of crop box top-left corner.


class kp.InferenceFixedNodeOutput(width=0, height=0, channel=0, radix=0, scale=0, factor=0, dtype=FixedPointDType.KP_FIXED_POINT_DTYPE_UNKNOWN, num_data=0, data=array([], dtype=float64), channels_ordering=ChannelOrdering.KP_CHANNEL_ORDERING_CHW)

Generic inference node output in fixed-point format.

property channel(: int)

int: Channel of output node.

property channels_ordering(: kp.KPEnum.ChannelOrdering)

kp.ChannelOrdering: Channel ordering of feature map. (Options: KP_CHANNEL_ORDERING_HCW, KP_CHANNEL_ORDERING_CHW)

property dtype(: kp.KPEnum.FixedPointDType)

FixedPointDType: fixed-point data type.

property factor(: float)

float: Conversion factor for fixed-point to floating-point conversion - formulation: scale * (2 ^ radix).

get_member_variable_dict()

Represent member variables with Dict format.

property height(: int)

int: Height of output node.

property ndarray(: numpy.ndarray)

numpy.ndarray: N-dimensional numpy.ndarray of feature map.

property num_data(: int)

int: Total number of fixed-point values.

property radix(: int)

int: Radix for fixed/floating point conversion.

property scale(: float)

float: Scale for fixed/floating point conversion.

to_float_node_output()

Convert fixed-point node output to floating-point node output.

property width(: int)

int: Width of output node.


class kp.InferenceFloatNodeOutput(width=0, height=0, channel=0, num_data=0, data=array([], dtype=float64), channels_ordering=ChannelOrdering.KP_CHANNEL_ORDERING_CHW)

Generic inference node output in floating-point format.

property channel(: int)

int: Channel of output node.

property channels_ordering(: kp.KPEnum.ChannelOrdering)

kp.ChannelOrdering: Channel ordering of feature map. (Options: KP_CHANNEL_ORDERING_HCW, KP_CHANNEL_ORDERING_CHW)

get_member_variable_dict()

Represent member variables with Dict format.

property height(: int)

int: Height of output node.

property ndarray(: numpy.ndarray)

numpy.ndarray: N-dimensional numpy.ndarray of feature map.

property num_data(: int)

int: Total number of floating-point values.

property width(: int)

int: Width of output node.


class kp.ModelNefDescriptor(magic=0, metadata={'kn_number': '0x0', 'toolchain_version': '', 'compiler_version': '', 'nef_ ..., target_chip=ModelTargetChip.KP_MODEL_TARGET_CHIP_UNKNOWN, crc=0, models=[])

A basic descriptor for NEF.

property crc(: int)

int: CRC of NEF models.

get_member_variable_dict()

Represent member variables with Dict format.

property magic(: int)

int: Magic number for model_nef_descriptor (0x5AA55AA5).

property metadata(: kp.KPValue.ModelNefMetadata)

ModelNefMetadata: NEF metadata.

property models(: List[kp.KPValue.SingleModelDescriptor])

List[SingleModelDescriptor]: Model descriptors.

property target_chip(: kp.KPEnum.ModelTargetChip)

ModelTargetChip: Target chip of all models.


class kp.ModelNefMetadata(kn_number=0, toolchain_version='', compiler_version='', nef_schema_version={'version': '0.0.0'}, platform='')

A basic descriptor for a model NEF metadata.

property compiler_version(: str)

str: Compiler version of all models.

get_member_variable_dict()

Represent member variables with Dict format.

property kn_number(: int)

int: Target KN number device of encrypted all models.

property nef_schema_version(: kp.KPValue.NefSchemaVersion)

NefSchemaVersion: Schema version of nef.

property platform(: str)

str: Target device platform USB dongle, 96 board, etc.

property toolchain_version(: str)

str: Toolchain version of all models.


class kp.NefSchemaVersion(major=0, minor=0, revision=0)

A NEF schema version object.

get_member_variable_dict()

Represent member variables with Dict format.

property major(: int)

int: Major number.

property minor(: int)

int: Minor number.

property revision(: int)

int: Revision number.


class kp.QuantizationParameters(quantized_fixed_point_descriptor_list=[])

Quantization parameters for tensor.

get_member_variable_dict()

Represent member variables with Dict format.

property quantized_fixed_point_descriptor_list(: List[kp.KPValue.QuantizedFixedPointDescriptor])

List[QuantizedFixedPointDescriptor]: (a) List length = 1 for all-channel fixed-point quantization parameter, (b) List length > 1 for per-channel fixed-point quantization parameter.


class kp.QuantizedFixedPointDescriptor(scale=0, radix=0)

Quantization parameters for fixed-point value.

get_member_variable_dict()

Represent member variables with Dict format.

property radix(: int)

int: Radix for fixed/floating point conversion.

property scale(: float)

float: Scale for fixed/floating point conversion.


class kp.SetupFileSchemaVersion(major=0, minor=0, revision=0)

A setup information file version object.

get_member_variable_dict()

Represent member variables with Dict format.

property major(: int)

int: Major number.

property minor(: int)

int: Minor number.

property revision(: int)

int: Revision number.


class kp.SetupSchemaVersion(major=0, minor=0, revision=0)

A setup information schema version object.

get_member_variable_dict()

Represent member variables with Dict format.

property major(: int)

int: Major number.

property minor(: int)

int: Minor number.

property revision(: int)

int: Revision number.


class kp.SingleModelDescriptor(target_chip=ModelTargetChip.KP_MODEL_TARGET_CHIP_UNKNOWN, version=0, id=0, input_nodes=[], output_nodes=[], setup_schema_version={'version': '0.0.0'}, setup_file_schema_version={'version': '0.0.0'}, max_raw_out_size=0)

A basic descriptor for a model.

get_member_variable_dict()

Represent member variables with Dict format.

property id(: int)

int: Model ID.

property input_nodes(: List[kp.KPValue.TensorDescriptor])

List[TensorDescriptor]: List of model input node tensor information.

property max_raw_out_size(: int)

int: Needed raw output buffer size for this model.

property output_nodes(: List[kp.KPValue.TensorDescriptor])

List[TensorDescriptor]: List of model output node tensor information.

property setup_file_schema_version(: kp.KPValue.SetupFileSchemaVersion)

SetupFileSchemaVersion: File schema version of setup.

property setup_schema_version(: kp.KPValue.SetupSchemaVersion)

SetupSchemaVersion: Schema version of setup.

property target_chip(: kp.KPEnum.ModelTargetChip)

ModelTargetChip: Target chip of model.

property version(: int)

int: Version of model.


class kp.SystemInfo(kn_number=0, firmware_version={'firmware_version': '0.0.0-build.0'})

System Information of Kneron device.

property firmware_version()

kp.FirmwareVersion: Firmware version of Kneron device.

get_member_variable_dict()

Represent member variables with Dict format.

property kn_number()

int: Unique Kneron device ID.


class kp.TensorDescriptor(index=0, name='', shape_npu=[], shape_onnx=[], data_layout=ModelTensorDataLayout.KP_MODEL_TENSOR_DATA_LAYOUT_UNKNOWN, quantization_parameters={'quantized_fixed_point_descriptor_list': {}})

Tensor information.

property data_layout(: kp.KPEnum.ModelTensorDataLayout)

ModelTensorDataLayout: NPU data layout of the tensor.

get_member_variable_dict()

Represent member variables with Dict format.

property index(: int)

int: Index number of the tensor.

property name(: str)

str: Name of the tensor.

property quantization_parameters(: kp.KPValue.QuantizationParameters)

QuantizationParameters: Quantization parameters f the tensor.

property shape_npu(: List[int])

List[int]: NPU shape of the tensor.

property shape_onnx(: List[int])

List[int]: ONNX shape of the tensor.