Rename child_shapes for clarity

Author: sovrasov

src/cpp/models/include/models/results.h

@@ -315,11 +315,11 @@ struct Contour {
     std::string label;
     float probability;
     std::vector<cv::Point> shape;
-    std::vector<std::vector<cv::Point>> child_shapes;
+    std::vector<std::vector<cv::Point>> excluded_shapes;
 
     friend std::ostream& operator<<(std::ostream& os, const Contour& contour) {
         return os << contour.label << ": " << std::fixed << std::setprecision(3) << contour.probability << ", "
-                  << contour.shape.size() << ", " << contour.child_shapes.size();
+                  << contour.shape.size() << ", " << contour.excluded_shapes.size();
     }
 };
 

src/python/model_api/models/result/segmentation.py

@@ -149,28 +149,31 @@ def rotated_rects(self, value):
 
 
 class Contour:
-    """Represents a contour object with label, probability, shape, and optional excluded shapes.
+    """Represents a semantic segmentation mask as internals of a contour with "holes".
     Args:
         label (str): The label of the contour.
         probability (float): The probability associated with the contour.
-        shape (np.ndarray | list[tuple[int, int]]): The shape of the contour.
-        child_shapes (list[np.ndarray] | list[tuple[int, int]] | None, optional): Shapes of excluded contours. Defaults to None.
+        shape (np.ndarray | list[tuple[int, int]]): The shape of the contour. Shape is represented as a
+            list of 2d points or an equivalent numpy array (N, 2).
+        excluded_shapes (list[np.ndarray] | list[tuple[int, int]] | None, optional): Shapes of excluded contours.
+            If empty, the main shape is simply connected. Otherwise, excluded_shapes
+            represent "holes". Defaults to None.
     """
 
     def __init__(
         self,
         label: str,
         probability: float,
         shape: np.ndarray | list[tuple[int, int]],
-        child_shapes: list[np.ndarray] | list[tuple[int, int]] | None = None,
+        excluded_shapes: list[np.ndarray] | list[tuple[int, int]] | None = None,
     ):
         self.shape = shape
         self.label = label
         self.probability = probability
-        self.child_shapes = child_shapes
+        self.excluded_shapes = excluded_shapes
 
     def __str__(self):
-        num_children = len(self.child_shapes) if self.child_shapes is not None else 0
+        num_children = len(self.excluded_shapes) if self.excluded_shapes is not None else 0
         return f"{self.label}: {self.probability:.3f}, {len(self.shape)}, {num_children}"
 
     def __repr__(self):