holoscan 3.5.0__cp313-cp313-manylinux_2_35_x86_64.whl

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

@@ -0,0 +1,135 @@
+"""
+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.
+"""  # noqa: E501
+
+import importlib.metadata
+
+# We import core and gxf to make sure they're available before other modules that rely on them
+from . import core, gxf
+
+
+def _set_version():
+    try:
+        return importlib.metadata.version("holoscan")
+    except ImportError:
+        return "3.5.0" or "unknown version"
+
+
+__all__ = ["__version__", "as_tensor", "core", "gxf"]
+__version__ = _set_version()
+
+
+def as_tensor(obj):
+    if hasattr(obj, "__cuda_array_interface__") or hasattr(obj, "__array_interface__"):
+        # Workaround for bug in CuPy<13.0.0a1 where strides of ndarray with all but 1 dimension a
+        # singleton, could become order='F' strides instead of the expected order='C' strides.
+        # See:
+        #   https://github.com/cupy/cupy/pull/7438
+        #   https://github.com/cupy/cupy/pull/7457
+        #   https://forums.developer.nvidia.com/t/known-issue-in-cupy-affecting-tensor-interop/244423
+        #
+        # Here we force any array that is both C and F contiguous to have C-ordered strides
+        # We do this for both NumPy and CuPy arrays for consistency.
+
+        # nd-array, but with only 1 non-singleton dimension
+        nd_singleton = (obj.ndim > 1) and (sum(tuple(s > 1 for s in obj.shape)) == 1)
+        if nd_singleton and obj.flags.forc:
+            # determine expected strides for a C-contiguous array
+            expected_strides = [
+                1,
+            ] * obj.ndim
+            expected_strides[obj.ndim - 1] = obj.itemsize
+            for i in range(obj.ndim - 2, -1, -1):
+                expected_strides[i] = expected_strides[i + 1] * obj.shape[i + 1]
+            expected_strides = tuple(expected_strides)
+
+            # make a copy to force stride update if they do not match
+            if obj.strides != expected_strides:
+                if hasattr(obj, "__cuda_array_interface__"):
+                    try:
+                        import cupy as cp
+
+                        if isinstance(obj, cp.ndarray):
+                            # use as_strided to avoid a copy
+                            obj = cp.lib.stride_tricks.as_strided(
+                                obj, shape=obj.shape, strides=expected_strides
+                            )
+                            return core.Tensor.as_tensor(obj)
+                    except ImportError:
+                        pass
+                elif hasattr(obj, "__array_interface__"):
+                    try:
+                        import numpy as np
+
+                        if isinstance(obj, np.ndarray):
+                            # use as_strided to avoid a copy
+                            obj = np.lib.stride_tricks.as_strided(
+                                obj, shape=obj.shape, strides=expected_strides
+                            )
+                            return core.Tensor.as_tensor(obj)
+                    except ImportError:
+                        pass
+                # update strides by making an explicit copy
+                try:
+                    obj = obj.copy(order="C")
+                except (AttributeError, TypeError):
+                    import warnings
+
+                    warnings.warn(
+                        "Unexpected strides encountered during call to `as_tensor` and no copy "
+                        "method was available. Leaving the strides unchanged.",
+                        stacklevel=2,
+                    )
+
+    return core.Tensor.as_tensor(obj)
+
+
+as_tensor.__doc__ = core.Tensor.as_tensor.__doc__
+
+
+# Other modules are exposed to the public API but will only be lazily loaded
+_EXTRA_MODULES = [
+    "conditions",
+    "data_loggers",
+    "decorator",
+    "executors",
+    "graphs",
+    "logger",
+    "operators",
+    "pose_tree",
+    "resources",
+    "schedulers",
+]
+__all__.extend(_EXTRA_MODULES)
+
+
+# Autocomplete
+def __dir__():
+    return __all__
+
+
+# Lazily load extra modules
+def __getattr__(name):
+    import importlib
+    import sys
+
+    if name in _EXTRA_MODULES:
+        module_name = f"{__name__}.{name}"
+        module = importlib.import_module(module_name)  # import
+        sys.modules[module_name] = module  # cache
+        return module
+    else:
+        raise AttributeError(f"module {__name__} has no attribute {name}")

holoscan-3.5.0.data/purelib/holoscan/cli/__main__.py

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: Copyright (c) 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.
+
+
+def main():
+    print("As of version 2.9.0, Holoscan CLI is no longer bundled with the Holoscan SDK.")
+    print("To enhance your experience and ensure you have access to the latest tools,")
+    print("please use the command below to install Holoscan CLI:")
+    print("\n$ pip install holoscan-cli \n")
+    print("Visit https://github.com/nvidia-holoscan/holoscan-cli for more information.\n")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,75 @@
+# 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 to underlying C++ API Conditions.
+
+.. autosummary::
+
+    holoscan.conditions.AsynchronousCondition
+    holoscan.conditions.BooleanCondition
+    holoscan.conditions.CountCondition
+    holoscan.conditions.CudaBufferAvailableCondition
+    holoscan.conditions.CudaEventCondition
+    holoscan.conditions.CudaStreamCondition
+    holoscan.conditions.DownstreamMessageAffordableCondition
+    holoscan.conditions.ExpiringMessageAvailableCondition
+    holoscan.conditions.MemoryAvailableCondition
+    holoscan.conditions.MessageAvailableCondition
+    holoscan.conditions.MultiMessageAvailableCondition
+    holoscan.conditions.MultiMessageAvailableTimeoutCondition
+    holoscan.conditions.PeriodicCondition
+    holoscan.conditions.PeriodicConditionPolicy
+"""
+
+from ._conditions import (
+    AsynchronousCondition,
+    AsynchronousEventState,
+    BooleanCondition,
+    CountCondition,
+    CudaBufferAvailableCondition,
+    CudaEventCondition,
+    CudaStreamCondition,
+    DownstreamMessageAffordableCondition,
+    ExpiringMessageAvailableCondition,
+    MemoryAvailableCondition,
+    MessageAvailableCondition,
+    MultiMessageAvailableCondition,
+    MultiMessageAvailableTimeoutCondition,
+    PeriodicCondition,
+    PeriodicConditionPolicy,
+)
+
+__all__ = [
+    "AsynchronousCondition",
+    "AsynchronousEventState",
+    "BooleanCondition",
+    "CountCondition",
+    "CudaBufferAvailableCondition",
+    "CudaEventCondition",
+    "CudaStreamCondition",
+    "DownstreamMessageAffordableCondition",
+    "ExpiringMessageAvailableCondition",
+    "MemoryAvailableCondition",
+    "MessageAvailableCondition",
+    "MultiMessageAvailableCondition",
+    "MultiMessageAvailableTimeoutCondition",
+    "PeriodicCondition",
+    "PeriodicConditionPolicy",
+]
+
+
+# expose the SamplingMode enum from MultiMessageAvailableCondition
+# (done this way instead of redefinining it in the bindings to avoids error:
+#  ImportError: generic_type: type "SamplingMode" is already registered!)
+MultiMessageAvailableTimeoutCondition.SamplingMode = MultiMessageAvailableCondition.SamplingMode