mirror of
https://github.com/openmv/openmv.git
synced 2025-11-04 14:49:50 +08:00
This commit restructures the ml.postprocessing module for better organization: - Moved common utility functions (logit, sigmoid, threshold, quantize, dequantize, mod) from postprocessing.py to utils.py to avoid duplication - Created vendor-specific subpackages: - ultralytics.py: YoloV2, YoloLC, YoloV5, YoloV8 classes - edgeimpulse.py: Fomo class - mediapipe.py: BlazeFace class - Converted postprocessing.py file to postprocessing/ package directory - Updated all class names to follow PascalCase convention - Maintained full backwards compatibility via aliased imports in __init__.py New usage: from ml.postprocessing import ultralytics ultralytics.YoloV2() Backwards compatible: from ml.postprocessing import yolo_v2_postprocess Signed-off-by: iabdalkader <i.abdalkader@gmail.com>
130 lines
5.6 KiB
Python
130 lines
5.6 KiB
Python
# Copyright (C) 2025 OpenMV, LLC.
|
|
#
|
|
# Redistribution and use in source and binary forms, with or without
|
|
# modification, are permitted provided that the following conditions
|
|
# are met:
|
|
#
|
|
# 1. Redistributions of source code must retain the above copyright
|
|
# notice, this list of conditions and the following disclaimer.
|
|
# 2. Redistributions in binary form must reproduce the above copyright
|
|
# notice, this list of conditions and the following disclaimer in
|
|
# the documentation and/or other materials provided with the
|
|
# distribution.
|
|
# 3. Any redistribution, use, or modification in source or binary form
|
|
# is done solely for personal benefit and not for any commercial
|
|
# purpose or for monetary gain. For commercial licensing options,
|
|
# please contact openmv@openmv.io
|
|
#
|
|
# THIS SOFTWARE IS PROVIDED BY THE LICENSOR AND COPYRIGHT OWNER "AS IS"
|
|
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
|
# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE LICENSOR OR COPYRIGHT
|
|
# OWNER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
|
# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
|
|
# OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
from ml.utils import *
|
|
from micropython import const
|
|
from ulab import numpy as np
|
|
|
|
|
|
# This is a lightweight version of the tiny yolo v2 object detection algorithm.
|
|
# It was optimized to work well on embedded devices with limited computational resources.
|
|
class YoloV2:
|
|
_YOLO_V2_TX = const(0)
|
|
_YOLO_V2_TY = const(1)
|
|
_YOLO_V2_TW = const(2)
|
|
_YOLO_V2_TH = const(3)
|
|
_YOLO_V2_SCORE = const(4)
|
|
_YOLO_V2_CLASSES = const(5)
|
|
|
|
def __init__(self, threshold=0.6, anchors=None, nms_threshold=0.1, nms_sigma=0.1):
|
|
self.threshold = threshold
|
|
self.anchors = anchors
|
|
self.anchors_len = len(self.anchors)
|
|
self.nms_threshold = nms_threshold
|
|
self.nms_sigma = nms_sigma
|
|
|
|
if self.anchors is None:
|
|
self.anchors = np.array([[0.98830, 3.36060],
|
|
[2.11940, 5.37590],
|
|
[3.05200, 9.13360],
|
|
[5.55170, 9.30660],
|
|
[9.72600, 11.1422]])
|
|
|
|
def __call__(self, model, inputs, outputs):
|
|
|
|
def softmax(x):
|
|
e_x = np.exp(x - np.max(x, axis=1, keepdims=True))
|
|
return e_x / np.sum(e_x, axis=1, keepdims=True)
|
|
|
|
ob, oh, ow, oc = model.output_shape[0]
|
|
scale = model.output_scale[0]
|
|
t = quantize(model, logit(self.threshold))
|
|
class_count = (oc // self.anchors_len) - _YOLO_V2_CLASSES
|
|
|
|
# Reshape the output to a 2D array
|
|
row_outputs = outputs[0].reshape((oh * ow * self.anchors_len,
|
|
_YOLO_V2_CLASSES + class_count))
|
|
|
|
# Threshold all the scores
|
|
score_indices = row_outputs[:, _YOLO_V2_SCORE]
|
|
score_indices = threshold(score_indices, t, scale)
|
|
if not len(score_indices):
|
|
return _NO_DETECTION
|
|
|
|
# Get the bounding boxes that have a valid score
|
|
bb = dequantize(model, np.take(row_outputs, score_indices, axis=0))
|
|
|
|
# Extract rows, columns, and anchor indices
|
|
bb_rows = score_indices // (ow * self.anchors_len)
|
|
bb_cols = mod(score_indices // self.anchors_len, ow)
|
|
bb_anchors = mod(score_indices, self.anchors_len)
|
|
|
|
# Get the anchor box information
|
|
bb_a_array = np.take(self.anchors, bb_anchors, axis=0)
|
|
|
|
# Get the score information
|
|
bb_scores = sigmoid(bb[:, _YOLO_V2_SCORE])
|
|
|
|
# Get the class information
|
|
bb_classes = np.argmax(softmax(bb[:, _YOLO_V2_CLASSES:]), axis=1)
|
|
|
|
# Compute the bounding box information
|
|
x_center = (bb_cols + sigmoid(bb[:, _YOLO_V2_TX])) / ow
|
|
y_center = (bb_rows + sigmoid(bb[:, _YOLO_V2_TY])) / oh
|
|
w_rel = (bb_a_array[:, 0] * np.exp(bb[:, _YOLO_V2_TW])) / ow
|
|
h_rel = (bb_a_array[:, 1] * np.exp(bb[:, _YOLO_V2_TH])) / oh
|
|
|
|
# Scale the bounding boxes to have enough integer precision for NMS
|
|
ib, ih, iw, ic = model.input_shape[0]
|
|
x_center = x_center * iw
|
|
y_center = y_center * ih
|
|
w_rel = w_rel * iw
|
|
h_rel = h_rel * ih
|
|
|
|
nms = NMS(iw, ih, inputs[0].roi)
|
|
for i in range(bb.shape[0]):
|
|
nms.add_bounding_box(x_center[i] - (w_rel[i] / 2),
|
|
y_center[i] - (h_rel[i] / 2),
|
|
x_center[i] + (w_rel[i] / 2),
|
|
y_center[i] + (h_rel[i] / 2),
|
|
bb_scores[i], bb_classes[i])
|
|
return nms.get_bounding_boxes(threshold=self.nms_threshold, sigma=self.nms_sigma)
|
|
|
|
|
|
# This is a lightweight version of the YOLO (You Only Look Once) object detection algorithm.
|
|
# It is designed to work well on embedded devices with limited computational resources.
|
|
class YoloLC(YoloV2):
|
|
def __init__(self, threshold=0.6, anchors=None, nms_threshold=0.1, nms_sigma=0.1):
|
|
if anchors is None:
|
|
anchors = np.array([[0.076023, 0.258508],
|
|
[0.163031, 0.413531],
|
|
[0.234769, 0.702585],
|
|
[0.427054, 0.715892],
|
|
[0.748154, 0.857092]])
|
|
super().__init__(threshold, anchors, nms_threshold, nms_sigma)
|