Merge pull request #272 from CVCUDA/feat/judavis/v0.16

feat: updating code for release v0.16.0

Author: justincdavis

.gitattributes

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# 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");
@@ -22,3 +22,9 @@
 *.a filter=lfs diff=lfs merge=lfs -text
 *.hdf5 filter=lfs diff=lfs merge=lfs -text
 *.pt filter=lfs diff=lfs merge=lfs -text
+docs/sphinx/content/DataLayout.svg filter=lfs diff=lfs merge=lfs -text
+docs/sphinx/content/TensorBatch.svg filter=lfs diff=lfs merge=lfs -text
+docs/sphinx/content/ImageBatchVarShape.svg filter=lfs diff=lfs merge=lfs -text
+docs/sphinx/content/ImageBatch.svg filter=lfs diff=lfs merge=lfs -text
+docs/sphinx/content/DataLayout_1D.svg filter=lfs diff=lfs merge=lfs -text
+docs/sphinx/content/DataLayout_3D_2D_1D.svg filter=lfs diff=lfs merge=lfs -text

.github/workflows/codeql.yml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# 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");
@@ -51,7 +51,7 @@ jobs:
         sudo apt update -y && sudo add-apt-repository ppa:ubuntu-toolchain-r/test -y && \
         sudo apt update -y && sudo apt install -y --no-install-recommends \
         git git-lfs gcc-11 g++-11 ninja-build ccache libgtest-dev libgmock-dev \
-        shellcheck curl doxygen python3 python3-pip python3-dev python3-setuptools \
+        shellcheck curl doxygen python3 python3-pip python3-dev python3-distutils \
         texlive-latex-extra ghostscript graphviz \
         && curl -L https://cmake.org/files/v3.20/cmake-3.20.1-linux-x86_64.tar.gz --output /tmp/cmake-3.20.1.tar.gz \
         && tar -xzf /tmp/cmake-3.20.1.tar.gz -C /tmp/ && sudo cp -r /tmp/cmake-3.20.1-linux-x86_64/bin/ /usr/local/ \
@@ -62,7 +62,7 @@ jobs:
       name: Install Python Dependencies
       run: |
         sudo apt update -y && sudo apt install -y --no-install-recommends \
-        python3 python3-pip python3-dev python3-setuptools doxygen && sudo rm -rf /var/lib/apt/lists/* \
+        python3 python3-pip python3-dev python3-distutils doxygen && sudo rm -rf /var/lib/apt/lists/* \
         && python3 -m pip install sphinx-rtd-theme sphinx breathe recommonmark graphviz \
         && python3 -m pip install numpy==2.0.1 patchelf==0.17.2.1
 
@@ -103,25 +103,3 @@ jobs:
       uses: github/codeql-action/analyze@v3
       with:
         category: "/language:${{matrix.language}}"
-
-    - if: matrix.language == 'c-cpp' && github.event_name == 'push'
-      name: Build Docs and Clean up Sphinx Build Directory
-      run: |
-        ./ci/build.sh debug build "-DBUILD_SAMPLES=OFF -DBUILD_TESTS=OFF -DBUILD_DOCS=ON -DBUILD_PYTHON=ON -DPYTHON_VERSIONS=3.10" $*
-        find build/docs/sphinx -name '*.doctree' -delete
-        find build/docs/sphinx -name '*.map' -delete
-        find build/docs/sphinx -name '*.pickle' -delete
-        find build/docs/sphinx -name '*.inv' -delete
-        find build/docs/sphinx -name '*.gz' -delete
-
-    - if: matrix.language == 'c-cpp' && github.event_name == 'push'
-      name: Create .nojekyll file
-      run: touch build/docs/sphinx/.nojekyll
-
-    - if: matrix.language == 'c-cpp' && github.event_name == 'push'
-      name: Deploy to GitHub Pages
-      uses: JamesIves/github-pages-deploy-action@v4
-      with:
-        folder: build/docs/sphinx
-        branch: gh-pages
-        clean: true

.gitignore

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# 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");
@@ -20,6 +20,7 @@
 /build_*/
 /install/
 /cvcuda-installer*/
+/.cache/
 
 # Visual Studio Code
 # ------------------
@@ -48,7 +49,10 @@ ipython_config.py
 
 # Documentation
 # -------------
+_c_api
+_cpp_api
 _c_cpp_api
+_python_api
 _cvcuda_api
 
 # Samples

.pre-commit-config.yaml

@@ -0,0 +1,68 @@
+# 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.
+
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+
+default_stages:
+  - merge-commit
+  - commit
+  - post-rewrite
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v4.3.0
+  hooks:
+  - id: check-merge-conflict
+  - id: trailing-whitespace
+  - id: end-of-file-fixer
+  - id: mixed-line-ending
+    args: ['--fix=lf']
+  - id: check-executables-have-shebangs
+  - id: check-shebang-scripts-are-executable
+  - id: detect-private-key
+  - id: check-added-large-files
+  - id: check-case-conflict
+  - id: destroyed-symlinks
+  - id: check-yaml
+    exclude: '.clang-format'
+
+- repo: https://github.com/detailyang/pre-commit-shell
+  rev: 1.0.5
+  hooks:
+  - id: shell-lint
+    args: ['-x', '--severity=warning']
+
+- repo: https://github.com/pre-commit/mirrors-clang-format
+  rev: v14.0.6
+  hooks:
+  - id: clang-format
+
+- repo: https://github.com/pryorda/dockerfilelint-precommit-hooks
+  rev: v0.1.0
+  hooks:
+  - id: dockerfilelint
+
+- repo: https://github.com/psf/black
+  rev: 22.10.0
+  hooks:
+  - id: black
+
+- repo: https://github.com/pycqa/flake8
+  rev: 5.0.4
+  hooks:
+  - id: flake8
+    args:
+      - "--max-line-length=110"

3rdparty/nvbench

@@ -23,7 +23,7 @@ endif()
 
 project(cvcuda
         LANGUAGES C CXX
-        VERSION 0.15.0
+        VERSION 0.16.0
         DESCRIPTION "CUDA-accelerated Computer Vision algorithms"
 )
 
@@ -45,13 +45,61 @@ if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
     set(CMAKE_INSTALL_PREFIX "/opt/nvidia/cvcuda${PROJECT_VERSION_MAJOR}" CACHE PATH "where cvcuda will be installed" FORCE)
 endif()
 
+# Save command-line values before option() resets them
+set(_BUILD_TESTS_CPP_CMDLINE ${BUILD_TESTS_CPP})
+set(_BUILD_TESTS_WHEELS_CMDLINE ${BUILD_TESTS_WHEELS})
+set(_BUILD_TESTS_PYTHON_CMDLINE ${BUILD_TESTS_PYTHON})
+
 # Options to configure the build tree =======
-option(BUILD_TESTS "Enable testsuite" OFF)
-option(BUILD_PYTHON "Build python bindings" OFF)
+option(BUILD_TESTS "Enable testsuite" ON)
+option(BUILD_TESTS_CPP "Build C++ tests" OFF)
+option(BUILD_TESTS_WHEELS "Generate test_wheels.sh script" OFF)
+option(BUILD_TESTS_PYTHON "Build Python tests" OFF)
+option(BUILD_PYTHON "Build python bindings" ON)
 option(BUILD_BENCH "Build benchmark" OFF)
 option(BUILD_DOCS "Build documentation" OFF)
 option(ENABLE_SANITIZER "Enabled sanitized build" OFF)
 
+# BUILD_TESTS enables all test sub-options by default, but respects explicit overrides
+# Normalize command-line values to uppercase for proper boolean comparison
+string(TOUPPER "${_BUILD_TESTS_CPP_CMDLINE}" _BUILD_TESTS_CPP_CMDLINE_UPPER)
+string(TOUPPER "${_BUILD_TESTS_WHEELS_CMDLINE}" _BUILD_TESTS_WHEELS_CMDLINE_UPPER)
+string(TOUPPER "${_BUILD_TESTS_PYTHON_CMDLINE}" _BUILD_TESTS_PYTHON_CMDLINE_UPPER)
+
+# Define patterns for CMake boolean values (supports both numeric and string forms)
+set(_CMAKE_BOOL_TRUE_PATTERN "^(1|ON|YES|TRUE|Y)$")
+set(_CMAKE_BOOL_FALSE_PATTERN "^(0|OFF|NO|FALSE|N)$")
+
+if(BUILD_TESTS)
+    # Enable sub-options unless explicitly set to a false value on command line
+    if(NOT _BUILD_TESTS_CPP_CMDLINE_UPPER MATCHES "${_CMAKE_BOOL_FALSE_PATTERN}")
+        set(BUILD_TESTS_CPP ON CACHE BOOL "Build C++ tests (enabled by BUILD_TESTS)" FORCE)
+    endif()
+    if(NOT _BUILD_TESTS_WHEELS_CMDLINE_UPPER MATCHES "${_CMAKE_BOOL_FALSE_PATTERN}")
+        set(BUILD_TESTS_WHEELS ON CACHE BOOL "Generate test_wheels.sh (enabled by BUILD_TESTS)" FORCE)
+    endif()
+    if(NOT _BUILD_TESTS_PYTHON_CMDLINE_UPPER MATCHES "${_CMAKE_BOOL_FALSE_PATTERN}")
+        set(BUILD_TESTS_PYTHON ON CACHE BOOL "Build Python tests (enabled by BUILD_TESTS)" FORCE)
+    endif()
+else()
+    # If BUILD_TESTS is OFF, disable all test sub-options unless explicitly set to a true value
+    if(_BUILD_TESTS_CPP_CMDLINE_UPPER MATCHES "${_CMAKE_BOOL_TRUE_PATTERN}")
+        set(BUILD_TESTS_CPP ON CACHE BOOL "Build C++ tests (explicitly enabled)" FORCE)
+    else()
+        set(BUILD_TESTS_CPP OFF CACHE BOOL "Build C++ tests (disabled by BUILD_TESTS=OFF)" FORCE)
+    endif()
+    if(_BUILD_TESTS_WHEELS_CMDLINE_UPPER MATCHES "${_CMAKE_BOOL_TRUE_PATTERN}")
+        set(BUILD_TESTS_WHEELS ON CACHE BOOL "Generate test_wheels.sh (explicitly enabled)" FORCE)
+    else()
+        set(BUILD_TESTS_WHEELS OFF CACHE BOOL "Generate test_wheels.sh (disabled by BUILD_TESTS=OFF)" FORCE)
+    endif()
+    if(_BUILD_TESTS_PYTHON_CMDLINE_UPPER MATCHES "${_CMAKE_BOOL_TRUE_PATTERN}")
+        set(BUILD_TESTS_PYTHON ON CACHE BOOL "Build Python tests (explicitly enabled)" FORCE)
+    else()
+        set(BUILD_TESTS_PYTHON OFF CACHE BOOL "Build Python tests (disabled by BUILD_TESTS=OFF)" FORCE)
+    endif()
+endif()
+
 # Configure build tree ======================
 
 list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake" )
@@ -75,18 +123,14 @@ if(BUILD_PYTHON)
     include(BuildPython)
 endif()
 
-if(BUILD_TESTS)
+if(BUILD_TESTS_CPP OR BUILD_TESTS_WHEELS OR BUILD_TESTS_PYTHON)
     add_subdirectory(tests)
 endif()
 
 if(BUILD_DOCS)
     add_subdirectory(docs)
 endif()
 
-if(BUILD_SAMPLES)
-    add_subdirectory(samples)
-endif()
-
 if(BUILD_BENCH)
     add_subdirectory(bench)
 endif()

CMakeLists.txt

@@ -1,5 +1,5 @@
 
-[//]: # "SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved."
+[//]: # "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');"
@@ -18,22 +18,8 @@
 
 **Currently, CV-CUDA is not accepting outside contributions.**
 
-Contributions to CV-CUDA fall into the following categories:
+To report a bug, request a new feature, or ask a general question, please file a [GitHub issue](https://github.com/CVCUDA/CV-CUDA/issues/new/choose).
 
-1. To report a bug, request a new feature, or report a problem with documentation,
-   please file an [issue](https://github.com/CVCUDA/CV-CUDA/issues/new/choose)
-   describing the problem or new feature in detail. The CV-CUDA team evaluates
-   and triages issues, and schedules them for a release. If you believe the issue
-   needs priority attention, please comment on the issue to notify the team.
-1. To propose a new feature, please file a new feature request
-   [issue](https://github.com/CVCUDA/CV-CUDA/issues/new/choose). Describe the
-   intended feature and discuss the design and implementation with the team and
-   community. NOTE: Currently, CV-CUDA is not accepting
-   outside contributions.
-1. To ask a general question, please sumbit a question
-   [issue](https://github.com/CVCUDA/CV-CUDA/issues/new/choose). If you need
-   more context on a particular issue, please ask in a comment.
-
-As contributors and maintainers to this project, you are expected to abide by
+Contributors and maintainers to this project are expected to abide by
 CV-CUDA's contributor code of conduct. More information can be found at:
 [Contributor Code of Conduct](https://github.com/CVCUDA/CV-CUDA/tree/main/CODE_OF_CONDUCT.md).

CONTRIBUTING.md

@@ -1,5 +1,5 @@
 
-[//]: # "SPDX-FileCopyrightText: Copyright (c) 2023-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved."
+[//]: # "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');"
@@ -102,7 +102,3 @@ To apply the Apache License to your work, attach the following boilerplate notic
     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.
-
-
------------------------------------------------
-See [THIRD_PARTY_LICENSES](THIRD_PARTY_LICENSES.md) for licenses of software redistributed as part of CV-CUDA's code or binary packages.