xfeatures2d_TEBLID
import { xfeatures2d_TEBLID } from '@banou/opencv-wasm'Use after await initOpenCV(). See the initialization and named imports guide.
Native object: release it with using or delete(). Factories can return null; check before calling methods. Inherits xfeatures2d_Feature2D.
Class implementing TEBLID (Triplet-based Efficient Binary Local Image Descriptor), described in [Suarez2021TEBLID].
TEBLID stands for Triplet-based Efficient Binary Local Image Descriptor, although originally it was called BAD [Suarez2021TEBLID]. It is an improvement over BEBLID [Suarez2020BEBLID], that uses triplet loss, hard negative mining, and anchor swap to improve the image matching results. It is able to describe keypoints from any detector just by changing the scale_factor parameter. TEBLID is as efficient as ORB, BEBLID or BRISK, but the triplet-based training objective selected more discriminative features that explain the accuracy gain. It is also more compact than BEBLID, when running the AKAZE example with 10000 keypoints detected by ORB, BEBLID obtains 561 inliers (75%) with 512 bits, whereas TEBLID obtains 621 (75.2%) with 256 bits. ORB obtains only 493 inliers (63%).
If you find this code useful, please add a reference to the following paper: <BLOCKQUOTE> Iago Suárez, José M. Buenaposada, and Luis Baumela. Revisiting Binary Local Image Description for Resource Limited Devices. IEEE Robotics and Automation Letters, vol. 6, no. 4, pp. 8317-8324, Oct. 2021. </BLOCKQUOTE>
The descriptor was trained in Liberty split of the UBC datasets [winder2007learning] .
Constructors and members
static create
Creates the TEBLID descriptor.
create(scale_factor: number, n_bits: number): xfeatures2d_TEBLID | null;2 available overloads
create(scale_factor: number): xfeatures2d_TEBLID | null;create(scale_factor: number, n_bits: number): xfeatures2d_TEBLID | null;scale_factorAdjust the sampling window around detected keypoints:
- <b> 1.00f </b> should be the scale for ORB keypoints
- <b> 6.75f </b> should be the scale for SIFT detected keypoints
- <b> 6.25f </b> is default and fits for KAZE, SURF detected keypoints
- <b> 5.00f </b> should be the scale for AKAZE, MSD, AGAST, FAST, BRISK keypoints
n_bitsDetermine the number of bits in the descriptor. Should be either TEBLID::SIZE_256_BITS or TEBLID::SIZE_512_BITS.
The xfeatures2d_TEBLID | null result.
clone
Create another handle to the same native object. This retains the object without copying its pixels or algorithm state; dispose both handles separately.
clone(): this;The this result.
getDefaultName
Return the default name configured on this xfeatures2d_TEBLID object.
getDefaultName(): string;The string result.
These signatures describe this package. Upstream documentation can mention optional backends that are absent from this build. Check runtime compatibility before choosing a backend or file format.