Adding support for voxel augmentations and metadata operations

[SundarRajan98]

Motivation

This PR adds multiple voxel augmentations and adds new metadata operations to rocAL. This PR needs to be merged alongside the MIVISIONX PR #1625

Technical Details

• Adds support for metadata operations like ROI random crop, and random object bounding box selection
• Support for voxel tensor layouts (NDHWC, NCDHW) for volumetric data processing in Brightness, Gaussian Noise and Flip augmentations
• Adds conditional execution support for Brightness and GaussianNoise operations to selectively apply the augmentation for each sample in a batch

Test Plan

Test Result

Submission Checklist

• Look over the contributing guidelines at https://github.com/ROCm/ROCm/blob/develop/CONTRIBUTING.md#pull-requests.

[Copilot]

Pull request overview

This PR expands rocAL’s augmentation and metadata toolset to better support volumetric (voxel) pipelines and new metadata-driven ROI workflows (including connected-component bbox selection and ROI-random-crop anchor generation), with Python bindings exposed via pybind and fn.py.

Changes:

• Added new metadata ops: randomObjectBbox (connected-component bbox selection) and roiRandomCrop (random crop anchor generation within an ROI).
• Extended augmentations to support new controls/layouts: conditional execution for Brightness/GaussianNoise and depth-axis flipping for Flip.
• Added a fixed-shape tensor slicing path (sliceFixed) to support vector-shape slicing alongside tensor-shape slicing.

Reviewed changes

Copilot reviewed 21 out of 21 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
rocAL_pybind/rocal_pybind.cpp	Exposes new ops (roiRandomCrop, randomObjectBbox, sliceFixed) to Python via pybind.
rocAL_pybind/amd/rocal/fn.py	Updates Python functional API wrappers (conditional execution, depth flip, slice fixed-shape, new metadata ops).
rocAL/source/pipeline/tensor.cpp	Adds Tensor::create_from_ptr() to wrap an externally-owned buffer pointer as a vx tensor.
rocAL/source/pipeline/random_object_bbox.cpp	Implements connected-component labeling + random bbox selection (with optional caching).
rocAL/source/pipeline/master_graph.cpp	Wires bbox + ROI random-crop updates into the execution loop and manages ROI-random-crop state.
rocAL/source/augmentations/geometry_augmentations/node_slice.cpp / .h	Adds fixed-shape slice path and improves fill-value replication handling.
rocAL/source/augmentations/geometry_augmentations/node_flip.cpp / .h	Adds optional depth flip support gated by vx_rpp version.
rocAL/source/augmentations/effects_augmentations/node_gaussian_noise.cpp / .h	Adds conditional execution support; updates vx_rpp version gating logic.
rocAL/source/augmentations/color_augmentations/node_brightness.cpp / .h	Adds conditional execution support (vx_rpp >= 3.3.1).
rocAL/source/api/rocal_api_meta_data.cpp / include/api/rocal_api_meta_data.h	Adds public C/C++ APIs for ROI random crop and random object bbox selection.
rocAL/source/api/rocal_api_augmentation.cpp / include/api/rocal_api_augmentation.h	Extends augmentation APIs: conditional execution for brightness/gaussian noise, depth flag for flip, and adds rocalSliceFixed.
rocAL/include/pipeline/master_graph.h	Declares new metadata operator hooks and ROI random-crop state in MasterGraph.
rocAL/include/pipeline/random_object_bbox.h	Declares RandomObjectBbox and its caching structures.
rocAL/include/pipeline/content_hash.h	Introduces a non-cryptographic content hash for caching repeated mask inputs.
rocAL/include/pipeline/tensor.h	Declares create_from_ptr() in Tensor.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

Copilot reviewed 21 out of 21 changed files in this pull request and generated 8 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[spolifroni-amd]

Does this need to be added to the documentation? If so, let me know.

[rrawther]

It is not a good idea to have a macro specific to one type of argument. Instead have a generic macro that can detect any invalid input argument. For e.g, this can be combined with ROCAL_INVALID_INPUT_ERR. Please remove all such

[rrawther]

Please add the newly introduced parameter to the end of the API and set default value. This will ensure that even if the user doesn't set its value, old usage won't break. Same for all such in this file

[rrawther]

move the newly introduced parameter to the end. Instead of having 2 separate flags, please use one variable and use bitmask for horizontal/vertical/depth.

[rrawther]

Can we combine all this into a single flag

[rrawther]

Newly introduced variables should be added to end of the existing parameters

[rrawther]

make sure the new parameters are added at the end

[rrawther]

why do we need to add a new api with vector data types for shape_param? The shape_param tensor should accomodate fixed shape_param