From c88c01235a551966fc03406a34d152d56b183192 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sat, 7 Dec 2024 22:05:58 -0600
Subject: [PATCH 01/17] utility functions

---
 frigate/util/velocity.py | 111 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 111 insertions(+)
 create mode 100644 frigate/util/velocity.py

diff --git a/frigate/util/velocity.py b/frigate/util/velocity.py
new file mode 100644
index 000000000..96f342d17
--- /dev/null
+++ b/frigate/util/velocity.py
@@ -0,0 +1,111 @@
+import math
+
+import numpy as np
+
+unit_system = "imperial"
+magnitude = "mph"
+
+
+def create_ground_plane(zone_points, distances):
+    """
+    Create a ground plane that accounts for perspective distortion using
+    real-world dimensions for each side of the zone.
+
+    :param zone_points: Array of zone corner points in pixel coordinates
+                        [[x1, y1], [x2, y2], [x3, y3], [x4, y4]]
+    :param distances: Real-world dimensions ordered by top, bottom left, right
+    :return: Function that calculates real-world distance per pixel at any coordinate
+    """
+    # Sort points by y coordinate to get top and bottom lines
+    sorted_points = zone_points[np.argsort(zone_points[:, 1])]
+    top_width, bottom_width, left_depth, right_depth = map(float, distances)
+
+    top_line = sorted_points[:2]
+    bottom_line = sorted_points[2:]
+
+    # Sort left to right for consistent indexing
+    top_line = top_line[np.argsort(top_line[:, 0])]
+    bottom_line = bottom_line[np.argsort(bottom_line[:, 0])]
+
+    # Calculate pixel lengths of each side
+    top_width_px = np.linalg.norm(top_line[1] - top_line[0])
+    bottom_width_px = np.linalg.norm(bottom_line[1] - bottom_line[0])
+    left_depth_px = np.linalg.norm(bottom_line[0] - top_line[0])
+    right_depth_px = np.linalg.norm(bottom_line[1] - top_line[1])
+
+    top_scale = top_width / top_width_px
+    bottom_scale = bottom_width / bottom_width_px
+    left_scale = left_depth / left_depth_px
+    right_scale = right_depth / right_depth_px
+
+    def distance_per_pixel(x, y):
+        """
+        Calculate the real-world distance per pixel at a given (x, y) coordinate.
+
+        :param x: X-coordinate in the image
+        :param y: Y-coordinate in the image
+        :return: Real-world distance per pixel at the given (x, y) coordinate
+        """
+        # Normalize x and y within the zone
+        x_norm = (x - top_line[0][0]) / (top_line[1][0] - top_line[0][0])
+        y_norm = (y - top_line[0][1]) / (bottom_line[0][1] - top_line[0][1])
+
+        # Interpolate scales horizontally and vertically
+        top_to_bottom_scale = top_scale + (bottom_scale - top_scale) * y_norm
+        left_to_right_scale = left_scale + (right_scale - left_scale) * x_norm
+
+        # Combine horizontal and vertical scales
+        return (top_to_bottom_scale + left_to_right_scale) / 2
+
+    return distance_per_pixel
+
+
+def calculate_real_world_speed(
+    zone_contour,
+    distances,
+    velocity_pixels,
+    position,
+    camera_fps,
+):
+    """
+    Calculate the real-world speed of a tracked object, accounting for perspective,
+    directly from the zone string.
+
+    :param zone_contour: Array of absolute zone points
+    :param distances: Comma separated distances of each side, ordered by top, bottom, left, right
+    :param velocity_pixels: List of tuples representing velocity in pixels/frame
+    :param position: Current position of the object (x, y) in pixels
+    :param camera_width: Width of the camera frame in pixels
+    :param camera_height: Height of the camera frame in pixels
+    :return: speed in the specified unit system (m/s for metric, ft/s for imperial) and velocity direction
+    """
+    ground_plane = create_ground_plane(zone_contour, distances)
+
+    if not isinstance(velocity_pixels, np.ndarray):
+        velocity_pixels = np.array(velocity_pixels)
+
+    avg_velocity_pixels = velocity_pixels.mean(axis=0)
+
+    # get the real-world distance per pixel at the object's current position and calculate real speed
+    scale = ground_plane(position[0], position[1])
+    speed_real = avg_velocity_pixels * scale * camera_fps
+
+    # euclidean speed in real-world units/second
+    speed_magnitude = np.linalg.norm(speed_real)
+
+    # movement direction
+    dx, dy = avg_velocity_pixels
+    angle = math.degrees(math.atan2(dy, dx))
+    if angle < 0:
+        angle += 360
+
+    if unit_system == "metric":
+        if magnitude == "kmh":
+            # Convert m/s to km/h
+            speed_magnitude *= 3.6
+    elif unit_system == "imperial":
+        if magnitude == "mph":
+            # Convert ft/s to mph
+            speed_magnitude *= 0.681818
+
+    return speed_magnitude, angle

From ae797a5c7c911abd02cc1035b6ed1d2fe819450c Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sat, 7 Dec 2024 22:06:41 -0600
Subject: [PATCH 02/17] backend config

---
 frigate/config/camera/zone.py | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/frigate/config/camera/zone.py b/frigate/config/camera/zone.py
index 65b34a049..f2e92f3a8 100644
--- a/frigate/config/camera/zone.py
+++ b/frigate/config/camera/zone.py
@@ -16,6 +16,10 @@ class ZoneConfig(BaseModel):
     coordinates: Union[str, list[str]] = Field(
         title="Coordinates polygon for the defined zone."
     )
+    distances: Optional[Union[str, list[str]]] = Field(
+        default_factory=list,
+        title="Real-world distances for the sides of quadrilateral for the defined zone.",
+    )
     inertia: int = Field(
         default=3,
         title="Number of consecutive frames required for object to be considered present in the zone.",
@@ -49,6 +53,24 @@ class ZoneConfig(BaseModel):
 
         return v
 
+    @field_validator("distances", mode="before")
+    @classmethod
+    def validate_distances(cls, v):
+        if v is None:
+            return None
+
+        if isinstance(v, str):
+            distances = list(map(str, map(float, v.split(","))))
+        elif isinstance(v, list):
+            distances = [str(float(val)) for val in v]
+        else:
+            raise ValueError("Invalid type for distances")
+
+        if len(distances) != 4:
+            raise ValueError("distances must have exactly 4 values")
+
+        return distances
+
     def __init__(self, **config):
         super().__init__(**config)
 

From f191dfc5974e9e9fc16d11eea248e696143ccabc Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sat, 7 Dec 2024 22:07:20 -0600
Subject: [PATCH 03/17] backend object speed tracking

---
 frigate/track/tracked_object.py | 36 ++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/frigate/track/tracked_object.py b/frigate/track/tracked_object.py
index 65e7a2ed5..e695e7e63 100644
--- a/frigate/track/tracked_object.py
+++ b/frigate/track/tracked_object.py
@@ -21,6 +21,7 @@ from frigate.util.image import (
     is_better_thumbnail,
 )
 from frigate.util.object import box_inside
+from frigate.util.velocity import calculate_real_world_speed
 
 logger = logging.getLogger(__name__)
 
@@ -57,6 +58,9 @@ class TrackedObject:
         self.frame = None
         self.active = True
         self.pending_loitering = False
+        self.estimated_speed = 0
+        self.max_estimated_speed = 0
+        self.velocity_angle = 0
         self.previous = self.to_dict()
 
     def _is_false_positive(self):
@@ -107,6 +111,7 @@ class TrackedObject:
                     "region": obj_data["region"],
                     "score": obj_data["score"],
                     "attributes": obj_data["attributes"],
+                    "estimated_speed": self.estimated_speed,
                 }
                 thumb_update = True
 
@@ -152,6 +157,26 @@ class TrackedObject:
                 if 0 < zone_score < zone.inertia:
                     self.zone_presence[name] = zone_score - 1
 
+            # update speed
+            if zone.distances and name in self.entered_zones:
+                self.estimated_speed, self.velocity_angle = (
+                    calculate_real_world_speed(
+                        zone.contour,
+                        zone.distances,
+                        self.obj_data["estimate_velocity"],
+                        bottom_center,
+                        self.camera_config.detect.fps,
+                    )
+                    if self.active
+                    else 0
+                )
+                logger.debug(
+                    f"Camera: {self.camera_config.name}, zone: {name}, tracked object ID: {self.obj_data['id']}, estimated speed: {self.estimated_speed:.1f}"
+                )
+
+                if self.estimated_speed > self.max_estimated_speed:
+                    self.max_estimated_speed = self.estimated_speed
+
         # update loitering status
         self.pending_loitering = in_loitering_zone
 
@@ -232,6 +257,14 @@ class TrackedObject:
             "attributes": self.attributes,
             "current_attributes": self.obj_data["attributes"],
             "pending_loitering": self.pending_loitering,
+            "pixel_velocity": str(
+                tuple(
+                    np.round(self.obj_data["estimate_velocity"]).flatten().astype(int)
+                )
+            ),
+            "estimated_speed": self.estimated_speed,
+            "max_estimated_speed": self.max_estimated_speed,
+            "velocity_angle": self.velocity_angle,
         }
 
         if include_thumbnail:
@@ -316,7 +349,8 @@ class TrackedObject:
                 box[2],
                 box[3],
                 self.obj_data["label"],
-                f"{int(self.thumbnail_data['score']*100)}% {int(self.thumbnail_data['area'])}",
+                f"{int(self.thumbnail_data['score']*100)}% {int(self.thumbnail_data['area'])}"
+                + (f" {self.estimated_speed:.1f}" if self.estimated_speed != 0 else ""),
                 thickness=thickness,
                 color=color,
             )

From 6a3a519be6d6b8513693a5ab1110e052f6fda232 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sat, 7 Dec 2024 22:07:36 -0600
Subject: [PATCH 04/17] draw speed on debug view

---
 frigate/object_processing.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/frigate/object_processing.py b/frigate/object_processing.py
index ef23c3de3..a718ef2c7 100644
--- a/frigate/object_processing.py
+++ b/frigate/object_processing.py
@@ -162,7 +162,12 @@ class CameraState:
                     box[2],
                     box[3],
                     text,
-                    f"{obj['score']:.0%} {int(obj['area'])}",
+                    f"{obj['score']:.0%} {int(obj['area'])}"
+                    + (
+                        f" {float(obj['estimated_speed']):.1f}"
+                        if obj["estimated_speed"] != 0
+                        else ""
+                    ),
                     thickness=thickness,
                     color=color,
                 )

From 23133c403216eae77ae1a9876f3bb180da9448e7 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sat, 7 Dec 2024 22:08:05 -0600
Subject: [PATCH 05/17] basic frontend zone editor

---
 web/src/components/settings/ZoneEditPane.tsx | 161 ++++++++++++++++++-
 web/src/types/canvas.ts                      |   5 +
 web/src/types/frigateConfig.ts               |   1 +
 3 files changed, 166 insertions(+), 1 deletion(-)

diff --git a/web/src/components/settings/ZoneEditPane.tsx b/web/src/components/settings/ZoneEditPane.tsx
index 54799db72..a7a568b01 100644
--- a/web/src/components/settings/ZoneEditPane.tsx
+++ b/web/src/components/settings/ZoneEditPane.tsx
@@ -80,6 +80,17 @@ export default function ZoneEditPane({
     }
   }, [polygon, config]);
 
+  const [topWidth, bottomWidth, leftDepth, rightDepth] = useMemo(() => {
+    const distances =
+      polygon?.camera &&
+      polygon?.name &&
+      config?.cameras[polygon.camera]?.zones[polygon.name]?.distances;
+
+    return Array.isArray(distances)
+      ? distances.map((value) => parseFloat(value) || 0)
+      : [0, 0, 0, 0];
+  }, [polygon, config]);
+
   const formSchema = z.object({
     name: z
       .string()
@@ -138,6 +149,35 @@ export default function ZoneEditPane({
     objects: z.array(z.string()).optional(),
     review_alerts: z.boolean().default(false).optional(),
     review_detections: z.boolean().default(false).optional(),
+    speedEstimation: z.boolean().default(false),
+    topWidth: z.coerce
+      .number()
+      .min(0.1, {
+        message: "Distance must be greater than or equal to 0.1",
+      })
+      .optional()
+      .or(z.literal("")),
+    bottomWidth: z.coerce
+      .number()
+      .min(0.1, {
+        message: "Distance must be greater than or equal to 0.1",
+      })
+      .optional()
+      .or(z.literal("")),
+    leftDepth: z.coerce
+      .number()
+      .min(0.1, {
+        message: "Distance must be greater than or equal to 0.1",
+      })
+      .optional()
+      .or(z.literal("")),
+    rightDepth: z.coerce
+      .number()
+      .min(0.1, {
+        message: "Distance must be greater than or equal to 0.1",
+      })
+      .optional()
+      .or(z.literal("")),
   });
 
   const form = useForm<z.infer<typeof formSchema>>({
@@ -155,6 +195,11 @@ export default function ZoneEditPane({
         config?.cameras[polygon.camera]?.zones[polygon.name]?.loitering_time,
       isFinished: polygon?.isFinished ?? false,
       objects: polygon?.objects ?? [],
+      speedEstimation: !!(topWidth || bottomWidth || leftDepth || rightDepth),
+      topWidth,
+      bottomWidth,
+      leftDepth,
+      rightDepth,
     },
   });
 
@@ -165,6 +210,11 @@ export default function ZoneEditPane({
         inertia,
         loitering_time,
         objects: form_objects,
+        speedEstimation,
+        topWidth,
+        bottomWidth,
+        leftDepth,
+        rightDepth,
       }: ZoneFormValuesType, // values submitted via the form
       objects: string[],
     ) => {
@@ -261,9 +311,19 @@ export default function ZoneEditPane({
         loiteringTimeQuery = `&cameras.${polygon?.camera}.zones.${zoneName}.loitering_time=${loitering_time}`;
       }
 
+      let distancesQuery = "";
+      const distances = [topWidth, bottomWidth, leftDepth, rightDepth].join(
+        ",",
+      );
+      if (speedEstimation) {
+        distancesQuery = `&cameras.${polygon?.camera}.zones.${zoneName}.distances=${distances}`;
+      } else {
+        distancesQuery = `&cameras.${polygon?.camera}.zones.${zoneName}.distances`;
+      }
+
       axios
         .put(
-          `config/set?cameras.${polygon?.camera}.zones.${zoneName}.coordinates=${coordinates}${inertiaQuery}${loiteringTimeQuery}${objectQueries}${alertQueries}${detectionQueries}`,
+          `config/set?cameras.${polygon?.camera}.zones.${zoneName}.coordinates=${coordinates}${inertiaQuery}${loiteringTimeQuery}${distancesQuery}${objectQueries}${alertQueries}${detectionQueries}`,
           { requires_restart: 0 },
         )
         .then((res) => {
@@ -456,6 +516,105 @@ export default function ZoneEditPane({
             />
           </FormItem>
 
+          <Separator className="my-2 flex bg-secondary" />
+          <FormField
+            control={form.control}
+            name="speedEstimation"
+            render={({ field }) => (
+              <FormItem>
+                <div className="flex items-center space-x-2">
+                  <FormControl>
+                    <div className="my-2.5 flex w-full items-center justify-between">
+                      <FormLabel
+                        className="cursor-pointer text-primary"
+                        htmlFor="allLabels"
+                      >
+                        Speed Estimation
+                      </FormLabel>
+                      <Switch
+                        checked={field.value}
+                        onCheckedChange={(checked) => {
+                          if (
+                            checked &&
+                            polygons &&
+                            activePolygonIndex &&
+                            polygons[activePolygonIndex].points.length !== 4
+                          ) {
+                            toast.error(
+                              "Zones with speed estimation must have exactly 4 points",
+                            );
+                            return;
+                          }
+                          field.onChange(checked);
+                        }}
+                      />
+                    </div>
+                  </FormControl>
+                </div>
+                <FormDescription>
+                  Enable speed estimation for objects in this zone. The zone
+                  must have exactly 4 points.
+                </FormDescription>
+              </FormItem>
+            )}
+          />
+
+          {form.watch("speedEstimation") &&
+            polygons &&
+            activePolygonIndex &&
+            polygons[activePolygonIndex].points.length === 4 && (
+              <>
+                <FormField
+                  control={form.control}
+                  name="topWidth"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>Top Width</FormLabel>
+                      <FormControl>
+                        <Input {...field} placeholder="Enter top width..." />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+                <FormField
+                  control={form.control}
+                  name="bottomWidth"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>Bottom Width</FormLabel>
+                      <FormControl>
+                        <Input {...field} placeholder="Enter bottom width..." />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+                <FormField
+                  control={form.control}
+                  name="leftDepth"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>Left Depth</FormLabel>
+                      <FormControl>
+                        <Input {...field} placeholder="Enter left depth..." />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+                <FormField
+                  control={form.control}
+                  name="rightDepth"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>Right Depth</FormLabel>
+                      <FormControl>
+                        <Input {...field} placeholder="Enter right depth..." />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+              </>
+            )}
+
           <FormField
             control={form.control}
             name="isFinished"
diff --git a/web/src/types/canvas.ts b/web/src/types/canvas.ts
index f623e8b48..0710a51df 100644
--- a/web/src/types/canvas.ts
+++ b/web/src/types/canvas.ts
@@ -18,6 +18,11 @@ export type ZoneFormValuesType = {
   loitering_time: number;
   isFinished: boolean;
   objects: string[];
+  speedEstimation: boolean;
+  topWidth: number;
+  bottomWidth: number;
+  leftDepth: number;
+  rightDepth: number;
 };
 
 export type ObjectMaskFormValuesType = {
diff --git a/web/src/types/frigateConfig.ts b/web/src/types/frigateConfig.ts
index 5c5971fc0..63295d86e 100644
--- a/web/src/types/frigateConfig.ts
+++ b/web/src/types/frigateConfig.ts
@@ -214,6 +214,7 @@ export interface CameraConfig {
   zones: {
     [zoneName: string]: {
       coordinates: string;
+      distances: string;
       filters: Record<string, unknown>;
       inertia: number;
       loitering_time: number;

From d263026ab4882bbb7fc71d7b1e4608eeefb93082 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sun, 8 Dec 2024 12:01:58 -0600
Subject: [PATCH 06/17] remove line sorting

---
 frigate/util/velocity.py | 51 +++++++++++++++++-----------------------
 1 file changed, 21 insertions(+), 30 deletions(-)

diff --git a/frigate/util/velocity.py b/frigate/util/velocity.py
index 96f342d17..276c9815c 100644
--- a/frigate/util/velocity.py
+++ b/frigate/util/velocity.py
@@ -8,35 +8,27 @@ magnitude = "mph"
 
 def create_ground_plane(zone_points, distances):
     """
-    Create a ground plane that accounts for perspective distortion using
-    real-world dimensions for each side of the zone.
+    Create a ground plane that accounts for perspective distortion using real-world dimensions for each side of the zone.
 
-    :param zone_points: Array of zone corner points in pixel coordinates
+    :param zone_points: Array of zone corner points in pixel coordinates in circular order
                         [[x1, y1], [x2, y2], [x3, y3], [x4, y4]]
-    :param distances: Real-world dimensions ordered by top, bottom left, right
+    :param distances: Real-world dimensions ordered by A, B, C, D
     :return: Function that calculates real-world distance per pixel at any coordinate
     """
-    # Sort points by y coordinate to get top and bottom lines
-    sorted_points = zone_points[np.argsort(zone_points[:, 1])]
-    top_width, bottom_width, left_depth, right_depth = map(float, distances)
-
-    top_line = sorted_points[:2]
-    bottom_line = sorted_points[2:]
-
-    # Sort left to right for consistent indexing
-    top_line = top_line[np.argsort(top_line[:, 0])]
-    bottom_line = bottom_line[np.argsort(bottom_line[:, 0])]
+    A, B, C, D = zone_points
 
     # Calculate pixel lengths of each side
-    top_width_px = np.linalg.norm(top_line[1] - top_line[0])
-    bottom_width_px = np.linalg.norm(bottom_line[1] - bottom_line[0])
-    left_depth_px = np.linalg.norm(bottom_line[0] - top_line[0])
-    right_depth_px = np.linalg.norm(bottom_line[1] - top_line[1])
+    AB_px = np.linalg.norm(np.array(B) - np.array(A))
+    BC_px = np.linalg.norm(np.array(C) - np.array(B))
+    CD_px = np.linalg.norm(np.array(D) - np.array(C))
+    DA_px = np.linalg.norm(np.array(A) - np.array(D))
 
-    top_scale = top_width / top_width_px
-    bottom_scale = bottom_width / bottom_width_px
-    left_scale = left_depth / left_depth_px
-    right_scale = right_depth / right_depth_px
+    AB, BC, CD, DA = map(float, distances)
+
+    AB_scale = AB / AB_px
+    BC_scale = BC / BC_px
+    CD_scale = CD / CD_px
+    DA_scale = DA / DA_px
 
     def distance_per_pixel(x, y):
         """
@@ -47,15 +39,15 @@ def create_ground_plane(zone_points, distances):
         :return: Real-world distance per pixel at the given (x, y) coordinate
         """
         # Normalize x and y within the zone
-        x_norm = (x - top_line[0][0]) / (top_line[1][0] - top_line[0][0])
-        y_norm = (y - top_line[0][1]) / (bottom_line[0][1] - top_line[0][1])
+        x_norm = (x - A[0]) / (B[0] - A[0])
+        y_norm = (y - A[1]) / (D[1] - A[1])
 
         # Interpolate scales horizontally and vertically
-        top_to_bottom_scale = top_scale + (bottom_scale - top_scale) * y_norm
-        left_to_right_scale = left_scale + (right_scale - left_scale) * x_norm
+        vertical_scale = AB_scale + (CD_scale - AB_scale) * y_norm
+        horizontal_scale = DA_scale + (BC_scale - DA_scale) * x_norm
 
         # Combine horizontal and vertical scales
-        return (top_to_bottom_scale + left_to_right_scale) / 2
+        return (vertical_scale + horizontal_scale) / 2
 
     return distance_per_pixel
 
@@ -72,11 +64,10 @@ def calculate_real_world_speed(
     directly from the zone string.
 
     :param zone_contour: Array of absolute zone points
-    :param distances: Comma separated distances of each side, ordered by top, bottom, left, right
+    :param distances: Comma separated distances of each side, ordered by A, B, C, D
     :param velocity_pixels: List of tuples representing velocity in pixels/frame
     :param position: Current position of the object (x, y) in pixels
-    :param camera_width: Width of the camera frame in pixels
-    :param camera_height: Height of the camera frame in pixels
+    :param camera_fps: Frames per second of the camera
     :return: speed in the specified unit system (m/s for metric, ft/s for imperial) and velocity direction
     """
     ground_plane = create_ground_plane(zone_contour, distances)

From 9be1454f108b0afbe2b1731de81759852a1c283b Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sun, 8 Dec 2024 12:02:24 -0600
Subject: [PATCH 07/17] fix types

---
 web/src/types/canvas.ts        | 1 +
 web/src/types/frigateConfig.ts | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/web/src/types/canvas.ts b/web/src/types/canvas.ts
index 0710a51df..045d5897d 100644
--- a/web/src/types/canvas.ts
+++ b/web/src/types/canvas.ts
@@ -8,6 +8,7 @@ export type Polygon = {
   objects: string[];
   points: number[][];
   pointsOrder?: number[];
+  distances: number[];
   isFinished: boolean;
   color: number[];
 };
diff --git a/web/src/types/frigateConfig.ts b/web/src/types/frigateConfig.ts
index 63295d86e..45bb39475 100644
--- a/web/src/types/frigateConfig.ts
+++ b/web/src/types/frigateConfig.ts
@@ -214,7 +214,7 @@ export interface CameraConfig {
   zones: {
     [zoneName: string]: {
       coordinates: string;
-      distances: string;
+      distances: string[];
       filters: Record<string, unknown>;
       inertia: number;
       loitering_time: number;

From bb2a1e12cc75d08fa01ed58f6488b67c04e447d1 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sun, 8 Dec 2024 12:03:18 -0600
Subject: [PATCH 08/17] highlight line on canvas when entering value in zone
 edit pane

---
 web/src/components/settings/PolygonCanvas.tsx |  6 ++
 web/src/components/settings/PolygonDrawer.tsx | 78 ++++++++++++++++++-
 web/src/components/settings/ZoneEditPane.tsx  | 34 ++++++--
 web/src/views/settings/MasksAndZonesView.tsx  |  8 ++
 4 files changed, 117 insertions(+), 9 deletions(-)

diff --git a/web/src/components/settings/PolygonCanvas.tsx b/web/src/components/settings/PolygonCanvas.tsx
index e6851b63c..d2a0a46b5 100644
--- a/web/src/components/settings/PolygonCanvas.tsx
+++ b/web/src/components/settings/PolygonCanvas.tsx
@@ -17,6 +17,7 @@ type PolygonCanvasProps = {
   activePolygonIndex: number | undefined;
   hoveredPolygonIndex: number | null;
   selectedZoneMask: PolygonType[] | undefined;
+  activeLine?: number;
 };
 
 export function PolygonCanvas({
@@ -29,6 +30,7 @@ export function PolygonCanvas({
   activePolygonIndex,
   hoveredPolygonIndex,
   selectedZoneMask,
+  activeLine,
 }: PolygonCanvasProps) {
   const [isLoaded, setIsLoaded] = useState(false);
   const [image, setImage] = useState<HTMLImageElement | undefined>();
@@ -281,12 +283,14 @@ export function PolygonCanvas({
                 stageRef={stageRef}
                 key={index}
                 points={polygon.points}
+                distances={polygon.distances}
                 isActive={index === activePolygonIndex}
                 isHovered={index === hoveredPolygonIndex}
                 isFinished={polygon.isFinished}
                 color={polygon.color}
                 handlePointDragMove={handlePointDragMove}
                 handleGroupDragEnd={handleGroupDragEnd}
+                activeLine={activeLine}
               />
             ),
         )}
@@ -298,12 +302,14 @@ export function PolygonCanvas({
               stageRef={stageRef}
               key={activePolygonIndex}
               points={polygons[activePolygonIndex].points}
+              distances={polygons[activePolygonIndex].distances}
               isActive={true}
               isHovered={activePolygonIndex === hoveredPolygonIndex}
               isFinished={polygons[activePolygonIndex].isFinished}
               color={polygons[activePolygonIndex].color}
               handlePointDragMove={handlePointDragMove}
               handleGroupDragEnd={handleGroupDragEnd}
+              activeLine={activeLine}
             />
           )}
       </Layer>
diff --git a/web/src/components/settings/PolygonDrawer.tsx b/web/src/components/settings/PolygonDrawer.tsx
index 966aad2ca..1ae3d4601 100644
--- a/web/src/components/settings/PolygonDrawer.tsx
+++ b/web/src/components/settings/PolygonDrawer.tsx
@@ -6,7 +6,7 @@ import {
   useRef,
   useState,
 } from "react";
-import { Line, Circle, Group } from "react-konva";
+import { Line, Circle, Group, Text, Rect } from "react-konva";
 import {
   minMax,
   toRGBColorString,
@@ -20,23 +20,27 @@ import { Vector2d } from "konva/lib/types";
 type PolygonDrawerProps = {
   stageRef: RefObject<Konva.Stage>;
   points: number[][];
+  distances: number[];
   isActive: boolean;
   isHovered: boolean;
   isFinished: boolean;
   color: number[];
   handlePointDragMove: (e: KonvaEventObject<MouseEvent | TouchEvent>) => void;
   handleGroupDragEnd: (e: KonvaEventObject<MouseEvent | TouchEvent>) => void;
+  activeLine?: number;
 };
 
 export default function PolygonDrawer({
   stageRef,
   points,
+  distances,
   isActive,
   isHovered,
   isFinished,
   color,
   handlePointDragMove,
   handleGroupDragEnd,
+  activeLine,
 }: PolygonDrawerProps) {
   const vertexRadius = 6;
   const flattenedPoints = useMemo(() => flattenPoints(points), [points]);
@@ -113,6 +117,33 @@ export default function PolygonDrawer({
     stageRef.current.container().style.cursor = cursor;
   }, [stageRef, cursor]);
 
+  // Calculate midpoints for distance labels based on sorted points
+  const midpoints = useMemo(() => {
+    const midpointsArray = [];
+    for (let i = 0; i < points.length; i++) {
+      const p1 = points[i];
+      const p2 = points[(i + 1) % points.length];
+      const midpointX = (p1[0] + p2[0]) / 2;
+      const midpointY = (p1[1] + p2[1]) / 2;
+      midpointsArray.push([midpointX, midpointY]);
+    }
+    return midpointsArray;
+  }, [points]);
+
+  // Determine the points for the active line
+  const activeLinePoints = useMemo(() => {
+    if (
+      activeLine === undefined ||
+      activeLine < 1 ||
+      activeLine > points.length
+    ) {
+      return [];
+    }
+    const p1 = points[activeLine - 1];
+    const p2 = points[activeLine % points.length];
+    return [p1[0], p1[1], p2[0], p2[1]];
+  }, [activeLine, points]);
+
   return (
     <Group
       name="polygon"
@@ -158,6 +189,14 @@ export default function PolygonDrawer({
           }
         />
       )}
+      {isActive && activeLinePoints.length > 0 && (
+        <Line
+          points={activeLinePoints}
+          stroke="white"
+          strokeWidth={6}
+          hitStrokeWidth={12}
+        />
+      )}
       {points.map((point, index) => {
         if (!isActive) {
           return;
@@ -195,6 +234,43 @@ export default function PolygonDrawer({
           />
         );
       })}
+      {isFinished && (
+        <Group>
+          {midpoints.map((midpoint, index) => {
+            const [x, y] = midpoint;
+            const distance = distances[index];
+            if (distance === undefined) return null;
+
+            const squareSize = 22;
+
+            return (
+              <Group
+                key={`distance-group-${index}`}
+                x={x - squareSize / 2}
+                y={y - squareSize / 2}
+              >
+                <Rect
+                  width={squareSize}
+                  height={squareSize}
+                  fill={colorString(true)}
+                  stroke="white"
+                  strokeWidth={1}
+                />
+                <Text
+                  text={`${distance}`}
+                  width={squareSize}
+                  y={4}
+                  fontSize={16}
+                  fontFamily="Arial"
+                  fill="white"
+                  align="center"
+                  verticalAlign="middle"
+                />
+              </Group>
+            );
+          })}
+        </Group>
+      )}
     </Group>
   );
 }
diff --git a/web/src/components/settings/ZoneEditPane.tsx b/web/src/components/settings/ZoneEditPane.tsx
index a7a568b01..abdc90e93 100644
--- a/web/src/components/settings/ZoneEditPane.tsx
+++ b/web/src/components/settings/ZoneEditPane.tsx
@@ -40,6 +40,7 @@ type ZoneEditPaneProps = {
   setIsLoading: React.Dispatch<React.SetStateAction<boolean>>;
   onSave?: () => void;
   onCancel?: () => void;
+  setActiveLine: React.Dispatch<React.SetStateAction<number | undefined>>;
 };
 
 export default function ZoneEditPane({
@@ -52,6 +53,7 @@ export default function ZoneEditPane({
   setIsLoading,
   onSave,
   onCancel,
+  setActiveLine,
 }: ZoneEditPaneProps) {
   const { data: config, mutate: updateConfig } =
     useSWR<FrigateConfig>("config");
@@ -569,9 +571,13 @@ export default function ZoneEditPane({
                   name="topWidth"
                   render={({ field }) => (
                     <FormItem>
-                      <FormLabel>Top Width</FormLabel>
+                      <FormLabel>Line A distance</FormLabel>
                       <FormControl>
-                        <Input {...field} placeholder="Enter top width..." />
+                        <Input
+                          {...field}
+                          onFocus={() => setActiveLine(1)}
+                          onBlur={() => setActiveLine(undefined)}
+                        />
                       </FormControl>
                     </FormItem>
                   )}
@@ -581,9 +587,13 @@ export default function ZoneEditPane({
                   name="bottomWidth"
                   render={({ field }) => (
                     <FormItem>
-                      <FormLabel>Bottom Width</FormLabel>
+                      <FormLabel>Line B distance</FormLabel>
                       <FormControl>
-                        <Input {...field} placeholder="Enter bottom width..." />
+                        <Input
+                          {...field}
+                          onFocus={() => setActiveLine(2)}
+                          onBlur={() => setActiveLine(undefined)}
+                        />
                       </FormControl>
                     </FormItem>
                   )}
@@ -593,9 +603,13 @@ export default function ZoneEditPane({
                   name="leftDepth"
                   render={({ field }) => (
                     <FormItem>
-                      <FormLabel>Left Depth</FormLabel>
+                      <FormLabel>Line C distance</FormLabel>
                       <FormControl>
-                        <Input {...field} placeholder="Enter left depth..." />
+                        <Input
+                          {...field}
+                          onFocus={() => setActiveLine(3)}
+                          onBlur={() => setActiveLine(undefined)}
+                        />
                       </FormControl>
                     </FormItem>
                   )}
@@ -605,9 +619,13 @@ export default function ZoneEditPane({
                   name="rightDepth"
                   render={({ field }) => (
                     <FormItem>
-                      <FormLabel>Right Depth</FormLabel>
+                      <FormLabel>Line D distance</FormLabel>
                       <FormControl>
-                        <Input {...field} placeholder="Enter right depth..." />
+                        <Input
+                          {...field}
+                          onFocus={() => setActiveLine(4)}
+                          onBlur={() => setActiveLine(undefined)}
+                        />
                       </FormControl>
                     </FormItem>
                   )}
diff --git a/web/src/views/settings/MasksAndZonesView.tsx b/web/src/views/settings/MasksAndZonesView.tsx
index ab2646b5f..5c74a121b 100644
--- a/web/src/views/settings/MasksAndZonesView.tsx
+++ b/web/src/views/settings/MasksAndZonesView.tsx
@@ -61,6 +61,7 @@ export default function MasksAndZonesView({
   );
   const containerRef = useRef<HTMLDivElement | null>(null);
   const [editPane, setEditPane] = useState<PolygonType | undefined>(undefined);
+  const [activeLine, setActiveLine] = useState<number | undefined>();
 
   const { addMessage } = useContext(StatusBarMessagesContext)!;
 
@@ -161,6 +162,7 @@ export default function MasksAndZonesView({
       ...(allPolygons || []),
       {
         points: [],
+        distances: [],
         isFinished: false,
         type,
         typeIndex: 9999,
@@ -238,6 +240,7 @@ export default function MasksAndZonesView({
             scaledWidth,
             scaledHeight,
           ),
+          distances: zoneData.distances.map((distance) => parseFloat(distance)),
           isFinished: true,
           color: zoneData.color,
         }),
@@ -267,6 +270,7 @@ export default function MasksAndZonesView({
           scaledWidth,
           scaledHeight,
         ),
+        distances: [],
         isFinished: true,
         color: [0, 0, 255],
       }));
@@ -290,6 +294,7 @@ export default function MasksAndZonesView({
           scaledWidth,
           scaledHeight,
         ),
+        distances: [],
         isFinished: true,
         color: [128, 128, 128],
       }));
@@ -316,6 +321,7 @@ export default function MasksAndZonesView({
                 scaledWidth,
                 scaledHeight,
               ),
+              distances: [],
               isFinished: true,
               color: [128, 128, 128],
             };
@@ -391,6 +397,7 @@ export default function MasksAndZonesView({
                 setIsLoading={setIsLoading}
                 onCancel={handleCancel}
                 onSave={handleSave}
+                setActiveLine={setActiveLine}
               />
             )}
             {editPane == "motion_mask" && (
@@ -653,6 +660,7 @@ export default function MasksAndZonesView({
                   activePolygonIndex={activePolygonIndex}
                   hoveredPolygonIndex={hoveredPolygonIndex}
                   selectedZoneMask={selectedZoneMask}
+                  activeLine={activeLine}
                 />
               ) : (
                 <Skeleton className="size-full" />

From e163a2f178b4d534e3ff1e62454f28e7bd68cfad Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sun, 8 Dec 2024 12:27:12 -0600
Subject: [PATCH 09/17] rename vars and add validation

---
 web/src/components/settings/ZoneEditPane.tsx | 220 ++++++++++---------
 web/src/types/canvas.ts                      |   8 +-
 2 files changed, 120 insertions(+), 108 deletions(-)

diff --git a/web/src/components/settings/ZoneEditPane.tsx b/web/src/components/settings/ZoneEditPane.tsx
index abdc90e93..aee16ec60 100644
--- a/web/src/components/settings/ZoneEditPane.tsx
+++ b/web/src/components/settings/ZoneEditPane.tsx
@@ -82,7 +82,7 @@ export default function ZoneEditPane({
     }
   }, [polygon, config]);
 
-  const [topWidth, bottomWidth, leftDepth, rightDepth] = useMemo(() => {
+  const [lineA, lineB, lineC, lineD] = useMemo(() => {
     const distances =
       polygon?.camera &&
       polygon?.name &&
@@ -93,94 +93,107 @@ export default function ZoneEditPane({
       : [0, 0, 0, 0];
   }, [polygon, config]);
 
-  const formSchema = z.object({
-    name: z
-      .string()
-      .min(2, {
-        message: "Zone name must be at least 2 characters.",
-      })
-      .transform((val: string) => val.trim().replace(/\s+/g, "_"))
-      .refine(
-        (value: string) => {
-          return !cameras.map((cam) => cam.name).includes(value);
-        },
-        {
-          message: "Zone name must not be the name of a camera.",
-        },
-      )
-      .refine(
-        (value: string) => {
-          const otherPolygonNames =
-            polygons
-              ?.filter((_, index) => index !== activePolygonIndex)
-              .map((polygon) => polygon.name) || [];
+  const formSchema = z
+    .object({
+      name: z
+        .string()
+        .min(2, {
+          message: "Zone name must be at least 2 characters.",
+        })
+        .transform((val: string) => val.trim().replace(/\s+/g, "_"))
+        .refine(
+          (value: string) => {
+            return !cameras.map((cam) => cam.name).includes(value);
+          },
+          {
+            message: "Zone name must not be the name of a camera.",
+          },
+        )
+        .refine(
+          (value: string) => {
+            const otherPolygonNames =
+              polygons
+                ?.filter((_, index) => index !== activePolygonIndex)
+                .map((polygon) => polygon.name) || [];
 
-          return !otherPolygonNames.includes(value);
-        },
-        {
-          message: "Zone name already exists on this camera.",
-        },
-      )
-      .refine(
-        (value: string) => {
-          return !value.includes(".");
-        },
-        {
-          message: "Zone name must not contain a period.",
-        },
-      )
-      .refine((value: string) => /^[a-zA-Z0-9_-]+$/.test(value), {
-        message: "Zone name has an illegal character.",
+            return !otherPolygonNames.includes(value);
+          },
+          {
+            message: "Zone name already exists on this camera.",
+          },
+        )
+        .refine(
+          (value: string) => {
+            return !value.includes(".");
+          },
+          {
+            message: "Zone name must not contain a period.",
+          },
+        )
+        .refine((value: string) => /^[a-zA-Z0-9_-]+$/.test(value), {
+          message: "Zone name has an illegal character.",
+        }),
+      inertia: z.coerce
+        .number()
+        .min(1, {
+          message: "Inertia must be above 0.",
+        })
+        .or(z.literal("")),
+      loitering_time: z.coerce
+        .number()
+        .min(0, {
+          message: "Loitering time must be greater than or equal to 0.",
+        })
+        .optional()
+        .or(z.literal("")),
+      isFinished: z.boolean().refine(() => polygon?.isFinished === true, {
+        message: "The polygon drawing must be finished before saving.",
       }),
-    inertia: z.coerce
-      .number()
-      .min(1, {
-        message: "Inertia must be above 0.",
-      })
-      .or(z.literal("")),
-    loitering_time: z.coerce
-      .number()
-      .min(0, {
-        message: "Loitering time must be greater than or equal to 0.",
-      })
-      .optional()
-      .or(z.literal("")),
-    isFinished: z.boolean().refine(() => polygon?.isFinished === true, {
-      message: "The polygon drawing must be finished before saving.",
-    }),
-    objects: z.array(z.string()).optional(),
-    review_alerts: z.boolean().default(false).optional(),
-    review_detections: z.boolean().default(false).optional(),
-    speedEstimation: z.boolean().default(false),
-    topWidth: z.coerce
-      .number()
-      .min(0.1, {
-        message: "Distance must be greater than or equal to 0.1",
-      })
-      .optional()
-      .or(z.literal("")),
-    bottomWidth: z.coerce
-      .number()
-      .min(0.1, {
-        message: "Distance must be greater than or equal to 0.1",
-      })
-      .optional()
-      .or(z.literal("")),
-    leftDepth: z.coerce
-      .number()
-      .min(0.1, {
-        message: "Distance must be greater than or equal to 0.1",
-      })
-      .optional()
-      .or(z.literal("")),
-    rightDepth: z.coerce
-      .number()
-      .min(0.1, {
-        message: "Distance must be greater than or equal to 0.1",
-      })
-      .optional()
-      .or(z.literal("")),
-  });
+      objects: z.array(z.string()).optional(),
+      review_alerts: z.boolean().default(false).optional(),
+      review_detections: z.boolean().default(false).optional(),
+      speedEstimation: z.boolean().default(false),
+      lineA: z.coerce
+        .number()
+        .min(0.1, {
+          message: "Distance must be greater than or equal to 0.1",
+        })
+        .optional()
+        .or(z.literal("")),
+      lineB: z.coerce
+        .number()
+        .min(0.1, {
+          message: "Distance must be greater than or equal to 0.1",
+        })
+        .optional()
+        .or(z.literal("")),
+      lineC: z.coerce
+        .number()
+        .min(0.1, {
+          message: "Distance must be greater than or equal to 0.1",
+        })
+        .optional()
+        .or(z.literal("")),
+      lineD: z.coerce
+        .number()
+        .min(0.1, {
+          message: "Distance must be greater than or equal to 0.1",
+        })
+        .optional()
+        .or(z.literal("")),
+    })
+    .refine(
+      (data) => {
+        if (data.speedEstimation) {
+          return !!data.lineA && !!data.lineB && !!data.lineC && !!data.lineD;
+        }
+        return true;
+      },
+      {
+        message: "All distance fields must be filled to use speed estimation.",
+        path: ["speedEstimation"],
+      },
+    );
 
   const form = useForm<z.infer<typeof formSchema>>({
     resolver: zodResolver(formSchema),
@@ -197,11 +210,11 @@ export default function ZoneEditPane({
         config?.cameras[polygon.camera]?.zones[polygon.name]?.loitering_time,
       isFinished: polygon?.isFinished ?? false,
       objects: polygon?.objects ?? [],
-      speedEstimation: !!(topWidth || bottomWidth || leftDepth || rightDepth),
-      topWidth,
-      bottomWidth,
-      leftDepth,
-      rightDepth,
+      speedEstimation: !!(lineA || lineB || lineC || lineD),
+      lineA,
+      lineB,
+      lineC,
+      lineD,
     },
   });
 
@@ -213,10 +226,10 @@ export default function ZoneEditPane({
         loitering_time,
         objects: form_objects,
         speedEstimation,
-        topWidth,
-        bottomWidth,
-        leftDepth,
-        rightDepth,
+        lineA,
+        lineB,
+        lineC,
+        lineD,
       }: ZoneFormValuesType, // values submitted via the form
       objects: string[],
     ) => {
@@ -314,9 +327,7 @@ export default function ZoneEditPane({
       }
 
       let distancesQuery = "";
-      const distances = [topWidth, bottomWidth, leftDepth, rightDepth].join(
-        ",",
-      );
+      const distances = [lineA, lineB, lineC, lineD].join(",");
       if (speedEstimation) {
         distancesQuery = `&cameras.${polygon?.camera}.zones.${zoneName}.distances=${distances}`;
       } else {
@@ -543,7 +554,7 @@ export default function ZoneEditPane({
                             polygons[activePolygonIndex].points.length !== 4
                           ) {
                             toast.error(
-                              "Zones with speed estimation must have exactly 4 points",
+                              "Zones with speed estimation must have exactly 4 points.",
                             );
                             return;
                           }
@@ -557,6 +568,7 @@ export default function ZoneEditPane({
                   Enable speed estimation for objects in this zone. The zone
                   must have exactly 4 points.
                 </FormDescription>
+                <FormMessage />
               </FormItem>
             )}
           />
@@ -568,7 +580,7 @@ export default function ZoneEditPane({
               <>
                 <FormField
                   control={form.control}
-                  name="topWidth"
+                  name="lineA"
                   render={({ field }) => (
                     <FormItem>
                       <FormLabel>Line A distance</FormLabel>
@@ -584,7 +596,7 @@ export default function ZoneEditPane({
                 />
                 <FormField
                   control={form.control}
-                  name="bottomWidth"
+                  name="lineB"
                   render={({ field }) => (
                     <FormItem>
                       <FormLabel>Line B distance</FormLabel>
@@ -600,7 +612,7 @@ export default function ZoneEditPane({
                 />
                 <FormField
                   control={form.control}
-                  name="leftDepth"
+                  name="lineC"
                   render={({ field }) => (
                     <FormItem>
                       <FormLabel>Line C distance</FormLabel>
@@ -616,7 +628,7 @@ export default function ZoneEditPane({
                 />
                 <FormField
                   control={form.control}
-                  name="rightDepth"
+                  name="lineD"
                   render={({ field }) => (
                     <FormItem>
                       <FormLabel>Line D distance</FormLabel>
diff --git a/web/src/types/canvas.ts b/web/src/types/canvas.ts
index 045d5897d..d6d9f84f7 100644
--- a/web/src/types/canvas.ts
+++ b/web/src/types/canvas.ts
@@ -20,10 +20,10 @@ export type ZoneFormValuesType = {
   isFinished: boolean;
   objects: string[];
   speedEstimation: boolean;
-  topWidth: number;
-  bottomWidth: number;
-  leftDepth: number;
-  rightDepth: number;
+  lineA: number;
+  lineB: number;
+  lineC: number;
+  lineD: number;
 };
 
 export type ObjectMaskFormValuesType = {

From 6af95b74872df4e6446e3a30ba69ee4fc8ef804d Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sun, 8 Dec 2024 13:11:23 -0600
Subject: [PATCH 10/17] ensure speed estimation is disabled when user adds more
 than 4 points

---
 web/src/components/settings/ZoneEditPane.tsx | 21 +++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/web/src/components/settings/ZoneEditPane.tsx b/web/src/components/settings/ZoneEditPane.tsx
index aee16ec60..ec60086c5 100644
--- a/web/src/components/settings/ZoneEditPane.tsx
+++ b/web/src/components/settings/ZoneEditPane.tsx
@@ -90,7 +90,7 @@ export default function ZoneEditPane({
 
     return Array.isArray(distances)
       ? distances.map((value) => parseFloat(value) || 0)
-      : [0, 0, 0, 0];
+      : [undefined, undefined, undefined, undefined];
   }, [polygon, config]);
 
   const formSchema = z
@@ -197,7 +197,7 @@ export default function ZoneEditPane({
 
   const form = useForm<z.infer<typeof formSchema>>({
     resolver: zodResolver(formSchema),
-    mode: "onChange",
+    mode: "onBlur",
     defaultValues: {
       name: polygon?.name ?? "",
       inertia:
@@ -218,6 +218,19 @@ export default function ZoneEditPane({
     },
   });
 
+  useEffect(() => {
+    if (
+      form.watch("speedEstimation") &&
+      polygon &&
+      polygon.points.length !== 4
+    ) {
+      toast.error(
+        "Speed estimation has been disabled for this zone. Zones with speed estimation must have exactly 4 points.",
+      );
+      form.setValue("speedEstimation", false);
+    }
+  }, [polygon, form]);
+
   const saveToConfig = useCallback(
     async (
       {
@@ -746,7 +759,9 @@ export function ZoneObjectSelector({
 
   useEffect(() => {
     updateLabelFilter(currentLabels);
-  }, [currentLabels, updateLabelFilter]);
+    // we know that these deps are correct
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [currentLabels]);
 
   return (
     <>

From 327522bc23a6ed8140e156dd610280b1bf08a3b3 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sun, 8 Dec 2024 17:31:07 -0600
Subject: [PATCH 11/17] pixel velocity in debug

---
 frigate/track/tracked_object.py | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/frigate/track/tracked_object.py b/frigate/track/tracked_object.py
index e695e7e63..a85912b8a 100644
--- a/frigate/track/tracked_object.py
+++ b/frigate/track/tracked_object.py
@@ -171,7 +171,9 @@ class TrackedObject:
                     else 0
                 )
                 logger.debug(
-                    f"Camera: {self.camera_config.name}, zone: {name}, tracked object ID: {self.obj_data['id']}, estimated speed: {self.estimated_speed:.1f}"
+                    f"Camera: {self.camera_config.name}, zone: {name}, tracked object ID: {self.obj_data['id']}, \
+                        pixel velocity: {str(tuple(np.round(self.obj_data["estimate_velocity"]).flatten().astype(int)))} \
+                        estimated speed: {self.estimated_speed:.1f}"
                 )
 
                 if self.estimated_speed > self.max_estimated_speed:
@@ -257,11 +259,6 @@ class TrackedObject:
             "attributes": self.attributes,
             "current_attributes": self.obj_data["attributes"],
             "pending_loitering": self.pending_loitering,
-            "pixel_velocity": str(
-                tuple(
-                    np.round(self.obj_data["estimate_velocity"]).flatten().astype(int)
-                )
-            ),
             "estimated_speed": self.estimated_speed,
             "max_estimated_speed": self.max_estimated_speed,
             "velocity_angle": self.velocity_angle,

From aa51122879f36b2b3052497c88208d874d39f57a Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Sun, 8 Dec 2024 17:31:25 -0600
Subject: [PATCH 12/17] unit_system in config

---
 frigate/config/ui.py           | 10 +++++++++-
 web/src/types/frigateConfig.ts |  1 +
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/frigate/config/ui.py b/frigate/config/ui.py
index a562edf61..2f66aeed3 100644
--- a/frigate/config/ui.py
+++ b/frigate/config/ui.py
@@ -5,7 +5,7 @@ from pydantic import Field
 
 from .base import FrigateBaseModel
 
-__all__ = ["TimeFormatEnum", "DateTimeStyleEnum", "UIConfig"]
+__all__ = ["TimeFormatEnum", "DateTimeStyleEnum", "UnitSystemEnum", "UIConfig"]
 
 
 class TimeFormatEnum(str, Enum):
@@ -21,6 +21,11 @@ class DateTimeStyleEnum(str, Enum):
     short = "short"
 
 
+class UnitSystemEnum(str, Enum):
+    imperial = "imperial"
+    metric = "metric"
+
+
 class UIConfig(FrigateBaseModel):
     timezone: Optional[str] = Field(default=None, title="Override UI timezone.")
     time_format: TimeFormatEnum = Field(
@@ -35,3 +40,6 @@ class UIConfig(FrigateBaseModel):
     strftime_fmt: Optional[str] = Field(
         default=None, title="Override date and time format using strftime syntax."
     )
+    unit_system: UnitSystemEnum = Field(
+        default=UnitSystemEnum.metric, title="The unit system to use for measurements."
+    )
diff --git a/web/src/types/frigateConfig.ts b/web/src/types/frigateConfig.ts
index 45bb39475..1220412a8 100644
--- a/web/src/types/frigateConfig.ts
+++ b/web/src/types/frigateConfig.ts
@@ -8,6 +8,7 @@ export interface UiConfig {
   strftime_fmt?: string;
   dashboard: boolean;
   order: number;
+  unit_system?: "metric" | "imperial";
 }
 
 export interface BirdseyeConfig {

From b97fe96c887a4c17d707424295bc64602b5ed570 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Mon, 9 Dec 2024 08:05:43 -0600
Subject: [PATCH 13/17] ability to define unit system in config

---
 frigate/object_processing.py    |  1 +
 frigate/track/tracked_object.py | 15 +++++++++++----
 frigate/util/velocity.py        | 14 +-------------
 3 files changed, 13 insertions(+), 17 deletions(-)

diff --git a/frigate/object_processing.py b/frigate/object_processing.py
index a718ef2c7..9c9a1bbf5 100644
--- a/frigate/object_processing.py
+++ b/frigate/object_processing.py
@@ -261,6 +261,7 @@ class CameraState:
             new_obj = tracked_objects[id] = TrackedObject(
                 self.config.model,
                 self.camera_config,
+                self.config.ui,
                 self.frame_cache,
                 current_detections[id],
             )
diff --git a/frigate/track/tracked_object.py b/frigate/track/tracked_object.py
index a85912b8a..0c05541a2 100644
--- a/frigate/track/tracked_object.py
+++ b/frigate/track/tracked_object.py
@@ -12,6 +12,7 @@ import numpy as np
 from frigate.config import (
     CameraConfig,
     ModelConfig,
+    UIConfig,
 )
 from frigate.util.image import (
     area,
@@ -31,6 +32,7 @@ class TrackedObject:
         self,
         model_config: ModelConfig,
         camera_config: CameraConfig,
+        ui_config: UIConfig,
         frame_cache,
         obj_data: dict[str, any],
     ):
@@ -42,6 +44,7 @@ class TrackedObject:
         self.colormap = model_config.colormap
         self.logos = model_config.all_attribute_logos
         self.camera_config = camera_config
+        self.ui_config = ui_config
         self.frame_cache = frame_cache
         self.zone_presence: dict[str, int] = {}
         self.zone_loitering: dict[str, int] = {}
@@ -159,7 +162,7 @@ class TrackedObject:
 
             # update speed
             if zone.distances and name in self.entered_zones:
-                self.estimated_speed, self.velocity_angle = (
+                speed_magnitude, self.velocity_angle = (
                     calculate_real_world_speed(
                         zone.contour,
                         zone.distances,
@@ -170,10 +173,14 @@ class TrackedObject:
                     if self.active
                     else 0
                 )
+                if self.ui_config.unit_system == "metric":
+                    # Convert m/s to km/h
+                    self.estimated_speed = speed_magnitude * 3.6
+                elif self.ui_config.unit_system == "imperial":
+                    # Convert ft/s to mph
+                    self.estimated_speed = speed_magnitude * 0.681818
                 logger.debug(
-                    f"Camera: {self.camera_config.name}, zone: {name}, tracked object ID: {self.obj_data['id']}, \
-                        pixel velocity: {str(tuple(np.round(self.obj_data["estimate_velocity"]).flatten().astype(int)))} \
-                        estimated speed: {self.estimated_speed:.1f}"
+                    f"Camera: {self.camera_config.name}, zone: {name}, tracked object ID: {self.obj_data['id']}, pixel velocity: {str(tuple(np.round(self.obj_data['estimate_velocity']).flatten().astype(int)))} estimated speed: {self.estimated_speed:.1f}"
                 )
 
                 if self.estimated_speed > self.max_estimated_speed:
diff --git a/frigate/util/velocity.py b/frigate/util/velocity.py
index 276c9815c..3d6b0a91a 100644
--- a/frigate/util/velocity.py
+++ b/frigate/util/velocity.py
@@ -2,9 +2,6 @@ import math
 
 import numpy as np
 
-unit_system = "imperial"
-magnitude = "mph"
-
 
 def create_ground_plane(zone_points, distances):
     """
@@ -68,7 +65,7 @@ def calculate_real_world_speed(
     :param velocity_pixels: List of tuples representing velocity in pixels/frame
     :param position: Current position of the object (x, y) in pixels
     :param camera_fps: Frames per second of the camera
-    :return: speed in the specified unit system (m/s for metric, ft/s for imperial) and velocity direction
+    :return: speed and velocity angle direction
     """
     ground_plane = create_ground_plane(zone_contour, distances)
 
@@ -90,13 +87,4 @@ def calculate_real_world_speed(
     if angle < 0:
         angle += 360
 
-    if unit_system == "metric":
-        if magnitude == "kmh":
-            # Convert m/s to km/h
-            speed_magnitude *= 3.6
-    elif unit_system == "imperial":
-        if magnitude == "mph":
-            # Convert ft/s to mph
-            speed_magnitude *= 0.681818
-
     return speed_magnitude, angle

From 227eec49a38cc6bbb33361b3ef0ede2b18d1c420 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Mon, 9 Dec 2024 08:05:58 -0600
Subject: [PATCH 14/17] save max speed to db

---
 frigate/events/maintainer.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/frigate/events/maintainer.py b/frigate/events/maintainer.py
index 3a4209ec3..f9bd67288 100644
--- a/frigate/events/maintainer.py
+++ b/frigate/events/maintainer.py
@@ -25,6 +25,7 @@ def should_update_db(prev_event: Event, current_event: Event) -> bool:
             or prev_event["entered_zones"] != current_event["entered_zones"]
             or prev_event["thumbnail"] != current_event["thumbnail"]
             or prev_event["end_time"] != current_event["end_time"]
+            or prev_event["max_estimated_speed"] != current_event["max_estimated_speed"]
         ):
             return True
     return False
@@ -209,6 +210,7 @@ class EventProcessor(threading.Thread):
                     "score": score,
                     "top_score": event_data["top_score"],
                     "attributes": attributes,
+                    "max_estimated_speed": event_data["max_estimated_speed"],
                     "type": "object",
                 },
             }

From cfc4a5367ec2d8a3b0ab10097d6a7fbff6d08fd7 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Mon, 9 Dec 2024 08:06:06 -0600
Subject: [PATCH 15/17] frontend

---
 .../overlay/detail/SearchDetailDialog.tsx     | 21 +++++++++++++++++++
 web/src/types/search.ts                       |  1 +
 2 files changed, 22 insertions(+)

diff --git a/web/src/components/overlay/detail/SearchDetailDialog.tsx b/web/src/components/overlay/detail/SearchDetailDialog.tsx
index b0eeac98d..dc03eef5a 100644
--- a/web/src/components/overlay/detail/SearchDetailDialog.tsx
+++ b/web/src/components/overlay/detail/SearchDetailDialog.tsx
@@ -316,6 +316,18 @@ function ObjectDetailsTab({
     }
   }, [search]);
 
+  const maxEstimatedSpeed = useMemo(() => {
+    if (!search || !search.data?.max_estimated_speed) {
+      return undefined;
+    }
+
+    if (search.data?.max_estimated_speed != 0) {
+      return search.data?.max_estimated_speed.toFixed(1);
+    } else {
+      return undefined;
+    }
+  }, [search]);
+
   const updateDescription = useCallback(() => {
     if (!search) {
       return;
@@ -427,6 +439,15 @@ function ObjectDetailsTab({
               {score}%{subLabelScore && ` (${subLabelScore}%)`}
             </div>
           </div>
+          {maxEstimatedSpeed && (
+            <div className="flex flex-col gap-1.5">
+              <div className="text-sm text-primary/40">Max Estimated Speed</div>
+              <div className="text-sm">
+                {maxEstimatedSpeed}{" "}
+                {config?.ui.unit_system == "imperial" ? "mph" : "kph"}
+              </div>
+            </div>
+          )}
           <div className="flex flex-col gap-1.5">
             <div className="text-sm text-primary/40">Camera</div>
             <div className="text-sm capitalize">
diff --git a/web/src/types/search.ts b/web/src/types/search.ts
index 1d8de1611..223370e9a 100644
--- a/web/src/types/search.ts
+++ b/web/src/types/search.ts
@@ -55,6 +55,7 @@ export type SearchResult = {
     ratio: number;
     type: "object" | "audio" | "manual";
     description?: string;
+    max_estimated_speed: number;
   };
 };
 

From 60550d9cde019d64179c15cb8bde5a8d236b6056 Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Mon, 9 Dec 2024 10:23:54 -0600
Subject: [PATCH 16/17] docs

---
 docs/docs/configuration/reference.md |   6 +++++
 docs/docs/configuration/zones.md     |  38 ++++++++++++++++++++++-----
 docs/docs/integrations/mqtt.md       |  10 +++++--
 docs/static/img/ground-plane.jpg     | Bin 0 -> 54107 bytes
 4 files changed, 46 insertions(+), 8 deletions(-)
 create mode 100644 docs/static/img/ground-plane.jpg

diff --git a/docs/docs/configuration/reference.md b/docs/docs/configuration/reference.md
index bb7ae49a3..1737b5902 100644
--- a/docs/docs/configuration/reference.md
+++ b/docs/docs/configuration/reference.md
@@ -640,6 +640,9 @@ cameras:
         # Required: List of x,y coordinates to define the polygon of the zone.
         # NOTE: Presence in a zone is evaluated only based on the bottom center of the objects bounding box.
         coordinates: 0.284,0.997,0.389,0.869,0.410,0.745
+        # Optional: The real-world distances of a 4-sided zone used for zones with speed estimation enabled (default: none)
+        # List distances in order of the zone points coordinates and use the unit system defined in the ui config
+        distances: 10,15,12,11
         # Optional: Number of consecutive frames required for object to be considered present in the zone (default: shown below).
         inertia: 3
         # Optional: Number of seconds that an object must loiter to be considered in the zone (default: shown below)
@@ -785,6 +788,9 @@ ui:
   # https://www.gnu.org/software/libc/manual/html_node/Formatting-Calendar-Time.html
   # possible values are shown above (default: not set)
   strftime_fmt: "%Y/%m/%d %H:%M"
+  # Optional: Set the unit system to either "imperial" or "metric" (default: metric)
+  # Used in the UI and in MQTT topics
+  unit_system: metric
 
 # Optional: Telemetry configuration
 telemetry:
diff --git a/docs/docs/configuration/zones.md b/docs/docs/configuration/zones.md
index aef6b0a5b..a111d0439 100644
--- a/docs/docs/configuration/zones.md
+++ b/docs/docs/configuration/zones.md
@@ -122,16 +122,42 @@ cameras:
           - car
 ```
 
-### Loitering Time
+### Speed Estimation
 
-Zones support a `loitering_time` configuration which can be used to only consider an object as part of a zone if they loiter in the zone for the specified number of seconds. This can be used, for example, to create alerts for cars that stop on the street but not cars that just drive past your camera.
+Frigate can be configured to estimate the speed of objects moving through a zone. This works by combining data from Frigate's object tracker and "real world" distance measurements of the edges of the zone. The recommended use case for this feature is to track the speed of vehicles on a road.
+
+Your zone must be defined with exactly 4 points and should be aligned to the ground where objects are moving.
+
+![Ground plane 4-point zone](/img/ground-plane.jpg)
+
+Speed estimation requires a minimum number of frames for your object to be tracked before a valid estimate can be calculated, so create your zone away from the edges of the frame for the best results. _Your zone should not take up the full frame._ Once an object enters a speed estimation zone, its speed will continue to be tracked, even after it leaves the zone.
+
+Accurate real-world distance measurements are required to estimate speeds. These distances can be specified in your zone config through the `distances` field.
 
 ```yaml
 cameras:
   name_of_your_camera:
     zones:
-      front_yard:
-        loitering_time: 5 # unit is in seconds
-        objects:
-          - person
+      street:
+        coordinates: 0.033,0.306,0.324,0.138,0.439,0.185,0.042,0.428
+        distances: 10,12,11,13.5
 ```
+
+Each number in the `distance` field represents the real-world distance between the points in the `coordinates` list. So in the example above, the distance between the first two points ([0.033,0.306] and [0.324,0.138]) is 10. The distance between the second and third set of points ([0.324,0.138] and [0.439,0.185]) is 12, and so on. The fastest and most accurate way to configure this is through the Zone Editor in the Frigate UI.
+
+The `distance` values are measured in meters or feet, depending on how `unit_system` is configured in your `ui` config:
+
+```yaml
+ui:
+  # can be "metric" or "imperial", default is metric
+  unit_system: metric
+```
+
+The maximum speed during the object's lifetime is saved in Frigate's database and can be seen in the UI in the Tracked Object Details pane in Explore. Current estimated speed can also be seen on the debug view as the third value in the object label. Current estimated speed, max estimated speed, and velocity angle (the angle of the direction the object is moving relative to the frame) of tracked objects is also sent through the `events` MQTT topic in the `data` field. See the [MQTT docs](../integrations/mqtt.md#frigateevents).
+
+#### Best practices and caveats
+
+- Speed estimation works best with a straight road or path when your object travels in a straight line across that path. If your object makes turns, speed estimation may not be accurate.
+- Create a zone where the bottom center of your object's bounding box travels directly through it.
+- The more accurate your real-world dimensions can be measured, the more accurate speed estimation will be. However, due to the way Frigate's tracking algorithm works, you may need to tweak the real-world distance values so that estimated speeds better match real-world speeds.
+- The speeds are only an _estimation_ and are highly dependent on camera position, zone points, and real-world measurements. This feature should not be used for law enforcement.
diff --git a/docs/docs/integrations/mqtt.md b/docs/docs/integrations/mqtt.md
index 194821cbd..e2fcbcd67 100644
--- a/docs/docs/integrations/mqtt.md
+++ b/docs/docs/integrations/mqtt.md
@@ -52,7 +52,10 @@ Message published for each changed tracked object. The first message is publishe
     "attributes": {
       "face": 0.64
     }, // attributes with top score that have been identified on the object at any point
-    "current_attributes": [] // detailed data about the current attributes in this frame
+    "current_attributes": [], // detailed data about the current attributes in this frame
+    "estimated_speed": 0.71, // current estimated speed (mph or kph) for objects moving through zones with speed estimation enabled
+    "max_estimated_speed": 1.2, // max estimated speed (mph or kph) for objects moving through zones with speed estimation enabled
+    "velocity_angle": 180 // direction of travel relative to the frame for objects moving through zones with speed estimation enabled
   },
   "after": {
     "id": "1607123955.475377-mxklsc",
@@ -89,7 +92,10 @@ Message published for each changed tracked object. The first message is publishe
         "box": [442, 506, 534, 524],
         "score": 0.86
       }
-    ]
+    ],
+    "estimated_speed": 0.77, // current estimated speed (mph or kph) for objects moving through zones with speed estimation enabled
+    "max_estimated_speed": 1.2, // max estimated speed (mph or kph) for objects moving through zones with speed estimation enabled
+    "velocity_angle": 180 // direction of travel relative to the frame for objects moving through zones with speed estimation enabled
   }
 }
 ```
diff --git a/docs/static/img/ground-plane.jpg b/docs/static/img/ground-plane.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..2e7ed2e15a208db3acba1052dafef1b99ed7a5f6
GIT binary patch
literal 54107
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

literal 0
HcmV?d00001


From c87f2829ae28a4d6090c5af261f05cfc76421e2d Mon Sep 17 00:00:00 2001
From: Josh Hawkins <32435876+hawkeye217@users.noreply.github.com>
Date: Mon, 9 Dec 2024 10:27:11 -0600
Subject: [PATCH 17/17] clarify docs

---
 docs/docs/configuration/reference.md | 2 +-
 docs/docs/configuration/zones.md     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/docs/configuration/reference.md b/docs/docs/configuration/reference.md
index 1737b5902..bf7729844 100644
--- a/docs/docs/configuration/reference.md
+++ b/docs/docs/configuration/reference.md
@@ -639,7 +639,7 @@ cameras:
       front_steps:
         # Required: List of x,y coordinates to define the polygon of the zone.
         # NOTE: Presence in a zone is evaluated only based on the bottom center of the objects bounding box.
-        coordinates: 0.284,0.997,0.389,0.869,0.410,0.745
+        coordinates: 0.033,0.306,0.324,0.138,0.439,0.185,0.042,0.428
         # Optional: The real-world distances of a 4-sided zone used for zones with speed estimation enabled (default: none)
         # List distances in order of the zone points coordinates and use the unit system defined in the ui config
         distances: 10,15,12,11
diff --git a/docs/docs/configuration/zones.md b/docs/docs/configuration/zones.md
index a111d0439..0edfea299 100644
--- a/docs/docs/configuration/zones.md
+++ b/docs/docs/configuration/zones.md
@@ -153,7 +153,7 @@ ui:
   unit_system: metric
 ```
 
-The maximum speed during the object's lifetime is saved in Frigate's database and can be seen in the UI in the Tracked Object Details pane in Explore. Current estimated speed can also be seen on the debug view as the third value in the object label. Current estimated speed, max estimated speed, and velocity angle (the angle of the direction the object is moving relative to the frame) of tracked objects is also sent through the `events` MQTT topic in the `data` field. See the [MQTT docs](../integrations/mqtt.md#frigateevents).
+The maximum speed during the object's lifetime is saved in Frigate's database and can be seen in the UI in the Tracked Object Details pane in Explore. Current estimated speed can also be seen on the debug view as the third value in the object label. Current estimated speed, max estimated speed, and velocity angle (the angle of the direction the object is moving relative to the frame) of tracked objects is also sent through the `events` MQTT topic. See the [MQTT docs](../integrations/mqtt.md#frigateevents).
 
 #### Best practices and caveats