holoscan 3.5.0__cp313-cp313-manylinux_2_35_x86_64.whl

holoscan-3.5.0.data/purelib/holoscan/graphs/__init__.py

@@ -0,0 +1,32 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2023 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.
+"""This module provides a Python API for the C++ API Graph classes.
+
+.. autosummary::
+
+    holoscan.graphs.FlowGraph
+    holoscan.graphs.FragmentFlowGraph
+    holoscan.graphs.OperatorFlowGraph
+"""
+
+from ._graphs import FragmentFlowGraph, OperatorFlowGraph
+
+FlowGraph = OperatorFlowGraph  # provide alias for backwards compatibility
+
+__all__ = [
+    "FlowGraph",
+    "FragmentFlowGraph",
+    "OperatorFlowGraph",
+]

holoscan-3.5.0.data/purelib/holoscan/gxf/__init__.py

@@ -0,0 +1,60 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2025 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.
+"""This module provides a Python API for GXF base classes in the C++ API.
+
+.. autosummary::
+
+    holoscan.gxf.Entity
+    holoscan.gxf.GXFComponent
+    holoscan.gxf.GXFCondition
+    holoscan.gxf.GXFExecutionContext
+    holoscan.gxf.GXFInputContext
+    holoscan.gxf.GXFNetworkContext
+    holoscan.gxf.GXFOperator
+    holoscan.gxf.GXFOutputContext
+    holoscan.gxf.GXFResource
+    holoscan.gxf.GXFScheduler
+    holoscan.gxf.GXFSystemResourceBase
+"""
+
+from ._gxf import (  # noqa: I001
+    GXFComponent,
+    GXFCondition,
+    GXFExecutionContext,
+    GXFInputContext,
+    GXFNetworkContext,
+    GXFOperator,
+    GXFOutputContext,
+    GXFResource,
+    GXFScheduler,
+    GXFSystemResourceBase,
+    load_extensions,
+)
+from ._gxf import PyEntity as Entity
+
+__all__ = [
+    "Entity",
+    "GXFComponent",
+    "GXFCondition",
+    "GXFExecutionContext",
+    "GXFInputContext",
+    "GXFNetworkContext",
+    "GXFOperator",
+    "GXFOutputContext",
+    "GXFResource",
+    "GXFScheduler",
+    "GXFSystemResourceBase",
+    "load_extensions",
+]

holoscan-3.5.0.data/purelib/holoscan/logger/__init__.py

@@ -0,0 +1,37 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2024 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.
+"""This module provides a Python interface to the Holoscan SDK logger.
+
+.. autosummary::
+
+    holoscan.logger.LogLevel
+    holoscan.logger.log_level
+    holoscan.logger.set_log_level
+    holoscan.logger.set_log_pattern
+"""
+
+from ._logger import (
+    LogLevel,
+    log_level,
+    set_log_level,
+    set_log_pattern,
+)
+
+__all__ = [
+    "LogLevel",
+    "log_level",
+    "set_log_level",
+    "set_log_pattern",
+]

holoscan-3.5.0.data/purelib/holoscan/network_contexts/__init__.py

@@ -0,0 +1,28 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023 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.
+"""This module provides a Python API to underlying C++ API NetworkContexts.
+
+.. autosummary::
+
+    holoscan.network_contexts.UcxContext
+"""
+
+# Need to import UcxEntitySerializer before a UcxContext can be constructed
+from ..resources import UcxEntitySerializer  # noqa
+from ._network_contexts import UcxContext
+
+__all__ = ["UcxContext"]
+
+del UcxEntitySerializer

holoscan-3.5.0.data/purelib/holoscan/operators/__init__.py

@@ -0,0 +1,95 @@
+# SPDX-FileCopyrightText: Copyright (c) 2022-2024 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.
+"""This module provides a Python API to underlying C++ API Operators.
+
+.. autosummary::
+
+    holoscan.operators.BayerDemosaicOp
+    holoscan.operators.FormatConverterOp
+    holoscan.operators.GXFCodeletOp
+    holoscan.operators.HolovizOp
+    holoscan.operators.InferenceOp
+    holoscan.operators.InferenceProcessorOp
+    holoscan.operators.PingRxOp
+    holoscan.operators.PingTensorRxOp
+    holoscan.operators.PingTensorTxOp
+    holoscan.operators.PingTxOp
+    holoscan.operators.SegmentationPostprocessorOp
+    holoscan.operators.V4L2VideoCaptureOp
+    holoscan.operators.VideoStreamRecorderOp
+    holoscan.operators.VideoStreamReplayerOp
+"""
+
+# Define operator modules and classes for lazy loading
+_OPERATOR_MODULES = {
+    "bayer_demosaic": ["BayerDemosaicOp"],
+    "format_converter": ["FormatConverterOp"],
+    "gxf_codelet": ["GXFCodeletOp"],
+    "holoviz": ["HolovizOp"],
+    "inference": ["InferenceOp"],
+    "inference_processor": ["InferenceProcessorOp"],
+    "ping_rx": ["PingRxOp"],
+    "ping_tensor_rx": ["PingTensorRxOp"],
+    "ping_tensor_tx": ["PingTensorTxOp"],
+    "ping_tx": ["PingTxOp"],
+    "segmentation_postprocessor": ["SegmentationPostprocessorOp"],
+    "v4l2_video_capture": ["V4L2VideoCaptureOp"],
+    "video_stream_recorder": ["VideoStreamRecorderOp"],
+    "video_stream_replayer": ["VideoStreamReplayerOp"],
+}
+_OPERATORS = [item for sublist in _OPERATOR_MODULES.values() for item in sublist]
+_LOADED_OPERATORS = {}
+# expose both operator modules and operator classes for backward compatibility
+__all__ = list(_OPERATOR_MODULES.keys()) + _OPERATORS
+
+
+# Autocomplete
+def __dir__():
+    return __all__
+
+
+# Lazily load modules and classes
+def __getattr__(attr):
+    # Get submodule, import if needed
+    def getsubmodule(name):
+        import importlib
+        import sys
+
+        module_name = f"{__name__}.{name}"
+        if module_name in sys.modules:  # cached
+            module = sys.modules[module_name]
+        else:
+            module = importlib.import_module(module_name)  # import
+            sys.modules[module_name] = module  # cache
+        return module
+
+    # Return submodule
+    if attr in _OPERATOR_MODULES:
+        return getsubmodule(attr)
+
+    # Return cached operator class
+    if attr in _LOADED_OPERATORS:
+        return _LOADED_OPERATORS[attr]
+
+    # Get new operator class
+    if attr in _OPERATORS:
+        # Search for submodule that holds it
+        for module_name, values in _OPERATOR_MODULES.items():
+            if attr in values:
+                operator = getattr(getsubmodule(module_name), attr)  # retrieve from submodule
+                _LOADED_OPERATORS[attr] = operator  # cache
+                return operator
+
+    raise AttributeError(f"module {__name__} has no attribute {attr}")

holoscan-3.5.0.data/purelib/holoscan/operators/bayer_demosaic/__init__.py

@@ -0,0 +1,24 @@
+"""
+SPDX-FileCopyrightText: Copyright (c) 2023-2024 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.
+"""  # noqa: E501
+
+import holoscan.core  # noqa: F401
+import holoscan.gxf  # noqa: F401
+from holoscan.resources import Allocator, CudaStreamPool  # noqa: F401
+
+from ._bayer_demosaic import BayerDemosaicOp
+
+__all__ = ["BayerDemosaicOp"]

holoscan-3.5.0.data/purelib/holoscan/operators/format_converter/__init__.py

@@ -0,0 +1,23 @@
+"""
+SPDX-FileCopyrightText: Copyright (c) 2023-2024 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.
+"""  # noqa: E501
+
+import holoscan.core  # noqa: F401
+from holoscan.resources import Allocator, CudaStreamPool  # noqa: F401
+
+from ._format_converter import FormatConverterOp
+
+__all__ = ["FormatConverterOp"]

holoscan-3.5.0.data/purelib/holoscan/operators/gxf_codelet/__init__.py

@@ -0,0 +1,67 @@
+"""
+SPDX-FileCopyrightText: Copyright (c) 2024 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.
+"""  # noqa: E501
+
+import holoscan.core  # noqa: F401
+import holoscan.gxf  # noqa: F401
+from holoscan.core import OperatorSpec, _Fragment
+
+from ._gxf_codelet import GXFCodeletOp as _GXFCodeletOp
+
+__all__ = ["GXFCodeletOp"]
+
+
+class GXFCodeletOp(_GXFCodeletOp):
+    def __setattr__(self, name, value):
+        readonly_attributes = [
+            "fragment",
+            "gxf_typename",
+            "conditions",
+            "resources",
+            "operator_type",
+            "description",
+        ]
+        if name in readonly_attributes:
+            raise AttributeError(f'cannot override read-only property "{name}"')
+        super().__setattr__(name, value)
+
+    def __init__(self, fragment, *args, **kwargs):
+        if not isinstance(fragment, _Fragment):
+            raise ValueError(
+                "The first argument to an Operator's constructor must be the Fragment "
+                "(Application) to which it belongs."
+            )
+        # It is recommended to not use super()
+        # (https://pybind11.readthedocs.io/en/stable/advanced/classes.html#overriding-virtual-functions-in-python)
+        _GXFCodeletOp.__init__(self, self, fragment, *args, **kwargs)
+        # Create a PyOperatorSpec object and pass it to the C++ API
+        spec = OperatorSpec(fragment=self.fragment, op=self)
+        self.spec = spec
+        # Call setup method in the derived class
+        self.setup(spec)
+
+    def setup(self, spec: OperatorSpec):
+        # This method is invoked by the derived class to set up the operator.
+        super().setup(spec)
+
+    def initialize(self):
+        # Place holder for initialize method
+        pass
+
+
+# copy docstrings defined in pydoc.hpp
+GXFCodeletOp.__doc__ = _GXFCodeletOp.__doc__
+GXFCodeletOp.__init__.__doc__ = _GXFCodeletOp.__init__.__doc__