Skip to content

Commit

Permalink
[cuda] Adding a VLFeat-compliant feature descriptor
Browse files Browse the repository at this point in the history
  • Loading branch information
Carsten Griwodz committed Aug 15, 2024
1 parent 8623b69 commit da9cc32
Show file tree
Hide file tree
Showing 9 changed files with 305 additions and 14 deletions.
1 change: 1 addition & 0 deletions src/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ add_library(popsift
popsift/s_desc_grid.cu popsift/s_desc_grid.h
popsift/s_desc_igrid.cu popsift/s_desc_igrid.h
popsift/s_desc_notile.cu popsift/s_desc_notile.h
popsift/s_desc_vlfeat.cu popsift/s_desc_vlfeat.h
popsift/s_desc_norm_rs.h
popsift/s_desc_norm_l2.h
popsift/s_desc_normalize.h
Expand Down
5 changes: 1 addition & 4 deletions src/application/main.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -73,10 +73,7 @@ static void parseargs(int argc, char** argv, popsift::Config& config, string& in
// "Choice of span (1-sided) for Gauss filters. Default is VLFeat-like computation depending on sigma. "
// "Options are: vlfeat, relative, relative-all, opencv, fixed9, fixed15"
("desc-mode", value<std::string>()->notifier([&](const std::string& s) { config.setDescMode(s); }),
"Choice of descriptor extraction modes:\n"
"loop, iloop, grid, igrid, notile\n"
"Default is loop\n"
"loop is OpenCV-like horizontal scanning, computing only valid points, grid extracts only useful points but rounds them, iloop uses linear texture and rotated gradiant fetching. igrid is grid with linear interpolation. notile is like igrid but avoids redundant gradiant fetching.")
popsift::Config::getDescModeUsage())
("popsift-mode", bool_switch()->notifier([&](bool b) { if(b) config.setMode(popsift::Config::PopSift); }),
"During the initial upscale, shift pixels by 1. In extrema refinement, steps up to 0.6, do not reject points when reaching max iterations, "
"first contrast threshold is .8 * peak thresh. Shift feature coords octave 0 back to original pos.")
Expand Down
5 changes: 1 addition & 4 deletions src/application/match.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -71,10 +71,7 @@ static void parseargs(int argc, char** argv, popsift::Config& config, string& lF
( "gauss-mode", value<std::string>()->notifier([&](const std::string& s) { config.setGaussMode(s); }),
popsift::Config::getGaussModeUsage() )
("desc-mode", value<std::string>()->notifier([&](const std::string& s) { config.setDescMode(s); }),
"Choice of descriptor extraction modes:\n"
"loop, iloop, grid, igrid, notile\n"
"Default is loop\n"
"loop is OpenCV-like horizontal scanning, computing only valid points, grid extracts only useful points but rounds them, iloop uses linear texture and rotated gradiant fetching. igrid is grid with linear interpolation. notile is like igrid but avoids redundant gradiant fetching.")
popsift::Config::getDescModeUsage() )
("popsift-mode", bool_switch()->notifier([&](bool b) { if(b) config.setMode(popsift::Config::PopSift); }),
"During the initial upscale, shift pixels by 1. In extrema refinement, steps up to 0.6, do not reject points when reaching max iterations, "
"first contrast threshold is .8 * peak thresh. Shift feature coords octave 0 back to original pos.")
Expand Down
213 changes: 213 additions & 0 deletions src/popsift/s_desc_vlfeat.cu
Original file line number Diff line number Diff line change
@@ -0,0 +1,213 @@
/*
* Copyright 2016-2017, Simula Research Laboratory
* 2018-2020, University of Oslo
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
#include "popsift/sift_config.h"

#include "common/assist.h"
#include "common/debug_macros.h"
#include "common/vec_macros.h"
#include "s_desc_vlfeat.h"
#include "s_gradiant.h"
#include "sift_constants.h"
#include "sift_pyramid.h"

#include <cstdio>

using namespace popsift;

__device__ static inline
void ext_desc_vlfeat_sub( const float ang,
const Extremum* ext,
float* __restrict__ features,
cudaTextureObject_t layer_tex,
const int width,
const int height )
{
const float x = ext->xpos;
const float y = ext->ypos;
const int level = ext->lpos; // old_level;
const float sig = ext->sigma;
const float SBP = fabsf(DESC_MAGNIFY * sig);

if( SBP == 0 ) {
return;
}

float cos_t;
float sin_t;
__sincosf( ang, &sin_t, &cos_t );

const float csbp = cos_t * SBP;
const float ssbp = sin_t * SBP;
const float crsbp = cos_t / SBP;
const float srsbp = sin_t / SBP;

// We have 4x4*16 bins.
// There centers have the offsets -1.5, -0.5, 0.5, 1.5 from the
// keypoint. The points that support them stretch from -2 to 2
const float2 maxdist = make_float2( -2.0f, -2.0f );

// We rotate the corner of the maximum range by the keypoint orientation.
// const float ptx = csbp * maxdist - ssbp * maxdist;
// const float pty = csbp * maxdist + ssbp * maxdist;
const float ptx = fabsf( ::fmaf( csbp, maxdist.x, -ssbp * maxdist.y ) );
const float pty = fabsf( ::fmaf( csbp, maxdist.y, ssbp * maxdist.x ) );

const float bsz = 2.0f * ( fabsf(csbp) + fabsf(ssbp) );

const int xmin = max(1, (int)floorf(x - ptx - bsz));
const int ymin = max(1, (int)floorf(y - pty - bsz));
const int xmax = min(width - 2, (int)floorf(x + ptx + bsz));
const int ymax = min(height - 2, (int)floorf(y + pty + bsz));

__shared__ float dpt[128];

for( int i=threadIdx.x; i<128; i+=blockDim.x )
{
dpt[i] = 0.0f;
}

__syncthreads();

for( int pix_y = ymin; pix_y <= ymax; pix_y += 1 )
{
for( int base_x = xmin; base_x <= xmax; base_x += 32 )
{
float mod;
float th;

get_gradiant32( mod, th, base_x, pix_y, layer_tex, level );

mod /= 2.0f; // Our mod is double that of vlfeat. Huh.

th -= ang;
while( th > M_PI2 ) th -= M_PI2;
while( th < 0.0f ) th += M_PI2;
__syncthreads();

const int pix_x = base_x + threadIdx.x;

if( ( pix_y <= ymax ) && ( pix_x <= xmax ) )
{
// d : distance from keypoint
const float2 d = make_float2( pix_x - x, pix_y - y );

// n : normalized distance from keypoint
const float2 n = make_float2( ::fmaf( crsbp, d.x, srsbp * d.y ),
::fmaf( crsbp, d.y, -srsbp * d.x ) );

const float ww = __expf( -scalbnf(n.x*n.x + n.y*n.y, -3));

const float nt = 8.0f * th / M_PI2;

// neighbouring tile on the lower side: -2, -1, 0 or 1
// (must use floorf because casting rounds towards zero
const int3 t0 = make_int3( (int)floorf(n.x - 0.5f),
(int)floorf(n.y - 0.5f),
(int)nt );
const float wgt_x = - ( n.x - ( t0.x + 0.5f ) );
const float wgt_y = - ( n.y - ( t0.y + 0.5f ) );
const float wgt_t = - ( nt - t0.z );

for( int tx=0; tx<2; tx++ )
{
for( int ty=0; ty<2; ty++ )
{
for( int tt=0; tt<2; tt++ )
{
if( ( t0.y + ty >= -2 ) &&
( t0.y + ty < 2 ) &&
( t0.x + tx >= -2 ) &&
( t0.x + tx < 2 ) )
{
float i_wgt_x = ( tx == 0 ) ? 1.0f + wgt_x : wgt_x;
float i_wgt_y = ( ty == 0 ) ? 1.0f + wgt_y : wgt_y;
float i_wgt_t = ( tt == 0 ) ? 1.0f + wgt_t : wgt_t;

i_wgt_x = fabsf( i_wgt_x );
i_wgt_y = fabsf( i_wgt_y );
i_wgt_t = fabsf( i_wgt_t );

const float val = ww
* mod
* i_wgt_x
* i_wgt_y
* i_wgt_t;

const int offset = 80
+ ( t0.y + ty ) * 32
+ ( t0.x + tx ) * 8
+ ( t0.z + tt ) % 8;

atomicAdd( &dpt[offset], val );
}
}
}
}
}
__syncthreads();
}
}

for( int i=threadIdx.x; i<128; i+=blockDim.x )
{
features[i] = dpt[i];
}
}

__global__ void ext_desc_vlfeat( int octave, cudaTextureObject_t layer_tex, int w, int h)
{
const int o_offset = dct.ori_ps[octave] + blockIdx.x;
Descriptor* desc = &dbuf.desc [o_offset];
const int ext_idx = dobuf.feat_to_ext_map[o_offset];
Extremum* ext = dobuf.extrema + ext_idx;

const int ext_base = ext->idx_ori;
const int ori_num = o_offset - ext_base;
const float ang = ext->orientation[ori_num];

ext_desc_vlfeat_sub( ang,
ext,
desc->features,
layer_tex,
w,
h );
}

namespace popsift
{

bool start_ext_desc_vlfeat( const int octave, Octave& oct_obj )
{
dim3 block;
dim3 grid;
grid.x = hct.ori_ct[octave];
grid.y = 1;
grid.z = 1;

if( grid.x == 0 ) return false;

block.x = 32;
block.y = 1;
block.z = 1;

size_t shared_size = 4 * 128 * sizeof(float);

ext_desc_vlfeat
<<<grid,block,shared_size,oct_obj.getStream()>>>
( octave,
oct_obj.getDataTexPoint( ),
oct_obj.getWidth(),
oct_obj.getHeight() );

POP_SYNC_CHK;

return true;
}

}; // namespace popsift
19 changes: 19 additions & 0 deletions src/popsift/s_desc_vlfeat.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
/*
* Copyright 2016-2017, Simula Research Laboratory
* 2018-2020, University of Oslo
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
#pragma once
#include "sift_octave.h"
#include "sift_pyramid.h"

namespace popsift
{

bool start_ext_desc_vlfeat( const int octave, Octave& oct_obj );

}; // namespace popsift

31 changes: 31 additions & 0 deletions src/popsift/s_gradiant.h
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,37 @@ void get_gradiant( float& grad,
theta = atan2f(dy, dx);
}

/* A version of get_gradiant that works for a (32,1,1) threadblock
* and pulls data to shared memory before computing. Data is pulled
* less frequently, meaning that we do not rely on the L1 cache.
*/
__device__ static inline
void get_gradiant32( float& grad,
float& theta,
const int x,
const int y,
cudaTextureObject_t layer,
const int level )
{
const int idx = threadIdx.x;

__shared__ float x_array[34];

for( int i=idx; i<34; i += blockDim.x )
{
x_array[i] = readTex( layer, x+i-1.0f, y, level );
}
__syncthreads();

const float dx = x_array[idx+2] - x_array[idx];

const float dy = readTex( layer, x+idx, y+1.0f, level )
- readTex( layer, x+idx, y-1.0f, level );

grad = hypotf( dx, dy ); // __fsqrt_rz(dx*dx + dy*dy);
theta = atan2f(dy, dx);
}

__device__ static inline
void get_gradiant( float& grad,
float& theta,
Expand Down
21 changes: 21 additions & 0 deletions src/popsift/sift_conf.cu
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,8 @@ void Config::setDescMode( const std::string& text )
setDescMode( Config::IGrid );
else if( text == "notile" )
setDescMode( Config::NoTile );
else if( text == "vlfeat" )
setDescMode( Config::VLFeat_Desc );
else
POP_FATAL( "specified descriptor extraction mode must be one of loop, grid or igrid" );
}
Expand All @@ -81,6 +83,25 @@ void Config::setDescMode( Config::DescMode m )
_desc_mode = m;
}

const char* Config::getDescModeUsage( )
{
return "Choice of descriptor extraction modes:\n"
"loop, iloop, grid, igrid, notile, vlfeat\n"
"Default is loop\n"
"loop is OpenCV-like horizontal scanning, sampling every pixel in a radius around the "
"centers or the 16 tiles arond the keypoint. Each sampled point contributes to two "
"histogram bins."
"iloop is like loop but samples all constant 1-pixel distances from the keypoint, "
"using the CUDA texture engine for interpolation. "
"grid is like loop but works on rotated, normalized tiles, relying on CUDA 2D cache "
"to replace the manual data aligment idea of loop. "
"igrid iloop and grid. "
"notile is like igrid but handles all 16 tiles at once.\n"
"vlfeat is VLFeat-like horizontal scanning, sampling every pixel in a radius around "
"keypoint itself, using the 16 tile centers only for weighting. Every sampled point "
"contributes to up to eight historgram bins.";
}

void Config::setGaussMode( const std::string& m )
{
if( m == "vlfeat" )
Expand Down
21 changes: 15 additions & 6 deletions src/popsift/sift_conf.h
Original file line number Diff line number Diff line change
Expand Up @@ -84,16 +84,20 @@ struct Config
*/
enum DescMode
{
/// scan horizontal, extract valid points
/// scan horizontal, extract valid points - weight goes into 2 histogram bins
Loop,
/// scan horizontal, extract valid points, interpolate with tex engine
/// loop-compatible; scan horizontal, extract valid points, interpolate with tex engine
ILoop,
/// scan in rotated mode, round pixel address
/// loop-compatible; scan in rotated mode, round pixel address
Grid,
/// scan in rotated mode, interpolate with tex engine
/// loop-compatible; scan in rotated mode, interpolate with tex engine
IGrid,
/// variant of IGrid, no duplicate gradient fetching
NoTile
/// loop-compatible; variant of IGrid, no duplicate gradient fetching
NoTile,
/** extraction code according to VLFeat, similar to loop, weight goes into
* up to 8 histogram bins
*/
VLFeat_Desc
};

/**
Expand Down Expand Up @@ -182,6 +186,11 @@ struct Config
*/
void setDescMode( DescMode mode = Loop );

/**
* @brief Helper functions for the main program's usage string.
*/
static const char* getDescModeUsage( );

// void setGaussGroup( int groupsize );
// int getGaussGroup( ) const;

Expand Down
3 changes: 3 additions & 0 deletions src/popsift/sift_desc.cu
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
#include "s_desc_loop.h"
#include "s_desc_normalize.h"
#include "s_desc_notile.h"
#include "s_desc_vlfeat.h"
#include "s_gradiant.h"
#include "sift_config.h"
#include "sift_constants.h"
Expand Down Expand Up @@ -77,6 +78,8 @@ void Pyramid::descriptors( const Config& conf )
start_ext_desc_igrid( octave, oct_obj );
} else if( conf.getDescMode() == Config::NoTile ) {
start_ext_desc_notile( octave, oct_obj );
} else if( conf.getDescMode() == Config::VLFeat_Desc ) {
start_ext_desc_vlfeat( octave, oct_obj );
} else {
POP_FATAL( "not yet" );
}
Expand Down

0 comments on commit da9cc32

Please sign in to comment.