polyperception · mmuhiedd · Jan 20, 2026 · Jan 15, 2026 · Jan 15, 2026 · Jan 15, 2026
diff --git a/bindings/CMakeLists.txt b/bindings/CMakeLists.txt
@@ -77,7 +77,8 @@ add_library(pyds SHARED src/pyds.cpp src/utils.cpp src/bindanalyticsmeta.cpp
             src/bindnvdsmeta.cpp src/bindnvosd.cpp src/bindopticalflow.cpp
             src/bindschema.cpp src/bindtrackermeta.cpp src/custom_binding/bindcustom.cpp
             src/bind_reidembed_metadata.cpp src/bind_embed_metadata.cpp
-            src/bind_label.cpp src/bind_tracker_status_metadata.cpp src/bind_instance_segmentation.cpp)
+            src/bind_label.cpp src/bind_tracker_status_metadata.cpp 
+            src/bind_instance_segmentation.cpp src/bind_occupancy.cpp)
 
 set_target_properties(pyds PROPERTIES PREFIX "")
 set_target_properties(pyds PROPERTIES OUTPUT_NAME "pyds")

diff --git a/bindings/docstrings/functionsdoc.h b/bindings/docstrings/functionsdoc.h
@@ -622,6 +622,11 @@ constexpr const char *alloc_instance_segmentation_struct = R"pyds(
 
             :returns: Allocated :class:`InstanceSegmentationMetadata`)pyds";
 
+constexpr const char *alloc_occupancy_struct = R"pyds(
+            Allocate an :class:`OccupancyMetadata`.
+
+            :returns: Allocated :class:`OccupancyMetadata`)pyds";
+
 constexpr const char *alloc_reidembedding_struct = R"pyds(
             Allocate an :class:`ReIDEmbeddingMetadata`.
 

diff --git a/bindings/docstrings/occupancydoc.h b/bindings/docstrings/occupancydoc.h
@@ -0,0 +1,36 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2021-2022 NVIDIA CORPORATION &
+ * AFFILIATES. All rights reserved. SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+ #pragma once
+
+ namespace pydsdoc
+ {
+ namespace occupancy
+ {
+ namespace OccupancyMetadata
+ {
+ constexpr const char *descr = R"pyds(
+                  Holds occupancy information of the frame.
+                  Available only when instance segmentation is enabled.
+                  :ivar occupancy: *int*, occupancy value)pyds";
+
+ constexpr const char *cast
+     = R"pyds(cast given object/data to :class:`OccupancyMetadata`, call pyds.OccupancyMetadata.cast(data))pyds";
+ }
+ }
+ }
+
diff --git a/bindings/include/bind/bind_occupancy.hpp b/bindings/include/bind/bind_occupancy.hpp
@@ -0,0 +1,12 @@
+#include "../../docstrings/functionsdoc.h"
+#include "../../docstrings/occupancydoc.h"
+#include "occupancy.h" // Include the actual C++ header file for OccupancyMetadata
+#include "pyds.hpp"
+
+namespace py = pybind11;
+
+namespace pydeepstream
+{
+void bindoccupancy (
+    py::module &m);
+}
diff --git a/bindings/src/bind_occupancy.cpp b/bindings/src/bind_occupancy.cpp
@@ -0,0 +1,26 @@
+#include "bind_occupancy.hpp"
+
+namespace py = pybind11;
+
+namespace pydeepstream
+{
+
+void
+bindoccupancy (py::module &m)
+{
+  /* OccupancyMetadata bindings to be used with NvDsFrameMeta */
+  py::class_<OccupancyMetadata> (
+      m, "OccupancyMetadata",
+      pydsdoc::occupancy::OccupancyMetadata::descr)
+      .def (py::init<> ())
+      .def_readwrite ("percent_occupancy", &OccupancyMetadata::percent_occupancy)
+      .def (
+          "cast",
+          [] (void *data) { return (OccupancyMetadata *)data; },
+          py::return_value_policy::reference,
+          pydsdoc::occupancy::OccupancyMetadata::cast);
+
+  m.attr ("NVDS_USER_META_OCCUPANCY")
+      = py::cast (NVDS_USER_META_OCCUPANCY);
+}
+}
diff --git a/bindings/src/pyds.cpp b/bindings/src/pyds.cpp
@@ -34,6 +34,7 @@ AFFILIATES. All rights reserved.
 #include "bindschema.hpp"
 #include "bindtrackermeta.hpp"
 #include "custom_binding/include/bindcustom.hpp"
+#include "bind_occupancy.hpp"
 
 /*#define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION
 
@@ -77,6 +78,6 @@ PYBIND11_MODULE (pyds, m)
   bindlabel (m);
   bindtrackerstatus (m);
   bindinstancesegmentation (m);
-
+  bindoccupancy (m);
 } // end PYBIND11_MODULE(pyds, m)
 }