SIFT

cvcuda.sift(src: nvcv.Tensor, max_features: int = 0, num_octave_layers: int = 3, contrast_threshold: float = 0.029999999329447746, edge_threshold: float = 10.0, init_sigma: float = 1.600000023841858, flags: cvcuda.SIFT = <SIFT.USE_EXPANDED_INPUT: 1>, *, stream: Optional[nvcv.cuda.Stream] = None) → tuple[nvcv.Tensor, nvcv.Tensor, nvcv.Tensor, nvcv.Tensor]

Executes the SIFT operation on the given cuda stream.

See also

Refer to the CV-CUDA C API reference for the SIFT operator for more details and usage examples.

Parameters:

  • src (nvcv.Tensor) – Input tensor to extract features and compute descriptors from.

  • max_features (Number, optional) – Maximum number of features to be extracted, default is 5% of total pixels at a minimum of 1.

  • num_octave_layers (Number, optional) – Number of octave layers, default is 3.

  • contrast_threshold (Number, optional) – Contrast threshold, default is 0.03.

  • edge_threshold (Number, optional) – Edge threshold, default is 10.0.

  • init_sigma (Number, optional) – Initial sigma, default is 1.6.

  • flags (cvcuda.SIFT, optional) – Flag to whether to expand the input or not, default is cvcuda.SIFT.USE_EXPANDED_INPUT.

  • stream (nvcv.cuda.Stream, optional) – CUDA Stream on which to perform the operation.

Returns:

A tuple with feature coordinates, metadata, descriptors and number of features.

Return type:

Tuple[nvcv.Tensor, nvcv.Tensor, nvcv.Tensor, nvcv.Tensor]

Caution

Restrictions to several arguments may apply. Check the C API references of the CV-CUDA operator.

cvcuda.sift_into(feat_coords: nvcv.Tensor, feat_metadata: nvcv.Tensor, feat_descriptors: nvcv.Tensor, num_features: nvcv.Tensor, src: nvcv.Tensor, num_octave_layers: int = 3, contrast_threshold: float = 0.029999999329447746, edge_threshold: float = 10.0, init_sigma: float = 1.600000023841858, flags: cvcuda.SIFT = <SIFT.USE_EXPANDED_INPUT: 1>, *, stream: Optional[nvcv.cuda.Stream] = None) → tuple[nvcv.Tensor, nvcv.Tensor, nvcv.Tensor, nvcv.Tensor]

Executes the SIFT operation on the given cuda stream.

See also

Refer to the CV-CUDA C API reference for the SIFT operator for more details and usage examples.

Parameters:

  • feat_coords (nvcv.Tensor) – Output tensor with feature coordinates.

  • feat_metadata (nvcv.Tensor) – Output tensor with feature metadata.

  • feat_descriptors (nvcv.Tensor) – Output tensor with feature descriptors.

  • num_features (nvcv.Tensor) – Output tensor with number of features.

  • src (nvcv.Tensor) – Input tensor to extract features and compute descriptors from.

  • num_octave_layers (Number, optional) – Number of octave layers, default is 3.

  • contrast_threshold (Number, optional) – Contrast threshold, default is 0.03.

  • edge_threshold (Number, optional) – Edge threshold, default is 10.0.

  • init_sigma (Number, optional) – Initial sigma, default is 1.6.

  • flags (cvcuda.SIFT, optional) – Flag to whether to expand the input or not, default is cvcuda.SIFT.USE_EXPANDED_INPUT.

  • stream (nvcv.cuda.Stream, optional) – CUDA Stream on which to perform the operation.

Returns:

A tuple with feature coordinates, metadata, descriptors and number of features.

Return type:

Tuple[nvcv.Tensor, nvcv.Tensor, nvcv.Tensor, nvcv.Tensor]

Caution

Restrictions to several arguments may apply. Check the C API references of the CV-CUDA operator.