Builder for mfpf_region_pdf objects. More...

#include <mfpf_region_pdf_builder.h>

Inheritance diagram for mfpf_region_pdf_builder:

Public Member Functions
	mfpf_region_pdf_builder ()
virtual	~mfpf_region_pdf_builder ()
void	set_as_box (unsigned ni, unsigned nj, double ref_x, double ref_y, const vpdfl_builder_base &builder)
	Define model region as an ni x nj box.
void	set_as_box (unsigned ni, unsigned nj, const vpdfl_builder_base &builder)
	Define model region as an ni x nj box.
void	set_as_ellipse (double ri, double rj, const vpdfl_builder_base &builder)
	Define model region as an ellipse with radii ri, rj.
void	set_region (const mfpf_region_form &form)
	Define model region using description in form.
virtual void	set_region_size (double wi, double wj)
	Define region size in world co-ordinates.
unsigned	n_pixels () const
	Number of pixels in region.
const vcl_string &	shape () const
	String defining shape of region, eg "box" or "ellipse".
vpdfl_builder_base &	pdf_builder ()
	Builder for PDF.
virtual mfpf_point_finder *	new_finder () const
	Create new mfpf_region_pdf on heap.
virtual void	clear (unsigned n_egs)
	Initialise building.
virtual void	add_example (const vimt_image_2d_of< float > &image, const vgl_point_2d< double > &p, const vgl_vector_2d< double > &u)
	Add one example to the model.
virtual void	build (mfpf_point_finder &)
	Build object from the data supplied in add_example().
virtual bool	set_from_stream (vcl_istream &is)
	Initialise from a string stream.
virtual vcl_string	is_a () const
	Name of the class.
virtual mfpf_point_finder_builder *	clone () const
	Create a copy on the heap and return base class pointer.
virtual void	print_summary (vcl_ostream &os) const
	Print class to os.
void	print_shape (vcl_ostream &os) const
	Prints ASCII representation of shape to os.
short	version_no () const
	Version number for I/O.
virtual void	b_write (vsl_b_ostream &bfs) const
	Save class to binary file stream.
virtual void	b_read (vsl_b_istream &bfs)
	Load class from binary file stream.
virtual void	set_step_size (double)
	Size of step between sample points.
double	step_size () const
	Size of step between sample points.
virtual void	set_search_area (unsigned ni, unsigned nj)
	Define search region size.
void	set_search_angle_range (unsigned nA, double dA)
	Define angle search parameters.
void	set_search_scale_range (unsigned ns, double ds)
	Define scale search parameters.
int	search_ni () const
int	search_nj () const
unsigned	search_nA () const
	Number of angles to search at (ie try at A+idA, i in [-nA,+nA]).
double	search_dA () const
	Angle step size (ie try at A+idA, i in [-nA,+nA]).
unsigned	search_ns () const
	Number of scales to try at.
double	search_ds () const
	Scaling factor (ie try at ((ds)^i), i in [-ns,+ns].
virtual unsigned	model_dim ()
	Number of dimensions in the model.
virtual void	get_sample_vector (const vimt_image_2d_of< float > &image, const vgl_point_2d< double > &p, const vgl_vector_2d< double > &u, vcl_vector< double > &v)
	Get sample of region around specified point in image.
Static Public Member Functions
static vcl_auto_ptr < mfpf_point_finder_builder >	create_from_stream (vcl_istream &is)
	Create a concrete object, from a text specification.
Protected Member Functions
bool	base_equality (const mfpf_point_finder_builder &b) const
	Return true if base class parameters are the same in b.
void	parse_base_props (mbl_read_props_type &props)
	Parse relevant parameters from props list.
void	set_base_parameters (mfpf_point_finder &pf)
	Set base-class parameters of point finder.
Protected Attributes
double	step_size_
	Size of step between sample points.
int	search_ni_
	Number of points either side of centre to search.
int	search_nj_
	Number of points either side of centre to search.
unsigned	search_nA_
	Define N. angles (ie try at A+idA, i in [-nA,+nA]).
double	search_dA_
	Angle step size (ie try at A+idA, i in [-nA,+nA]).
unsigned	search_ns_
	Number of scales to try at.
double	search_ds_
	Scaling factor (ie try at ((ds)^i), i in [-ns,+ns].
Private Member Functions
void	set_defaults ()
	Define default values.
void	set_as_box (unsigned ni, unsigned nj, double ref_x, double ref_y)
	Define model region as an ni x nj box.
void	set_as_ellipse (double ri, double rj)
	Define model region as an ellipse with radii ri, rj.
void	config_as_box (vcl_istream &is)
	Parse stream to set up as a box shape.
void	config_as_ellipse (vcl_istream &is)
	Parse stream to set up as an ellipse shape.
void	add_one_example (const vimt_image_2d_of< float > &image, const vgl_point_2d< double > &p, const vgl_vector_2d< double > &u)
	Add one example to the model.
Private Attributes
double	ref_x_
	Kernel reference point (in roi_ni_ x roi_nj_ grid).
double	ref_y_
	Kernel reference point (in roi_ni_ x roi_nj_ grid).
vcl_string	shape_
	String defining shape of region, eg "box" or "ellipse".
vcl_vector< mbl_chord >	roi_
	Chords defining the region of interest.
unsigned	roi_ni_
	Size of bounding box of region of interest.
unsigned	roi_nj_
	Size of bounding box of region of interest.
unsigned	n_pixels_
	Number of pixels in region.
mbl_cloneable_ptr < vpdfl_builder_base >	pdf_builder_
	Builder for PDf for profile vector.
short	norm_method_
	Which normalisation to use (0=none, 1=linear).
vcl_vector< vnl_vector< double > >	data_
	Samples added in calls to add_example().
unsigned	nA_
	Number of angles either side of 0 to sample at.
double	dA_
	Angle displacement.
double	overlap_f_
	Relative size of region used for estimating overlap.

Detailed Description

Builder for mfpf_region_pdf objects.

Text for configuring:

   mfpf_region_pdf_builder { shape: ellipse { ri: 5 rj: 3  }
    pdf_builder: vpdfl_axis_gaussian_builder { }
    norm: linear
    search_ni: 5 search_nj: 4
    overlap_f: 0.5
   }
   Alternative for shape:
     shape: box { ni: 5 nj: 3 ref_x: 2.5 ref_y: 1.5 }

Definition at line 28 of file mfpf_region_pdf_builder.h.

Constructor & Destructor Documentation

mfpf_region_pdf_builder::mfpf_region_pdf_builder ( )

Definition at line 32 of file mfpf_region_pdf_builder.cxx.

mfpf_region_pdf_builder::~mfpf_region_pdf_builder ( ) [virtual]

Definition at line 59 of file mfpf_region_pdf_builder.cxx.

Member Function Documentation

void mfpf_region_pdf_builder::add_example	(	const vimt_image_2d_of< float > &	image,
		const vgl_point_2d< double > &	p,
		const vgl_vector_2d< double > &	u
	)		`[virtual]`

Add one example to the model.

Implements mfpf_point_finder_builder.

Definition at line 214 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::add_one_example	(	const vimt_image_2d_of< float > &	image,
		const vgl_point_2d< double > &	p,
		const vgl_vector_2d< double > &	u
	)		`[private]`

Add one example to the model.

Definition at line 182 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::b_read ( vsl_b_istream & bfs ) [virtual]

Load class from binary file stream.

Reimplemented from mfpf_point_finder_builder.

Definition at line 492 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::b_write ( vsl_b_ostream & bfs ) const [virtual]

Save class to binary file stream.

Reimplemented from mfpf_point_finder_builder.

Definition at line 470 of file mfpf_region_pdf_builder.cxx.

bool mfpf_point_finder_builder::base_equality ( const mfpf_point_finder_builder & b ) const [protected, inherited]

Return true if base class parameters are the same in b.

Return true if base class parameters are the same in pf.

Definition at line 189 of file mfpf_point_finder_builder.cxx.

void mfpf_region_pdf_builder::build ( mfpf_point_finder & pf ) [virtual]

Build object from the data supplied in add_example().

Build this object from the data supplied in add_example().

Implements mfpf_point_finder_builder.

Definition at line 234 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::clear ( unsigned n_egs ) [virtual]

Initialise building.

Must be called before any calls to add_example(...)

Implements mfpf_point_finder_builder.

Definition at line 176 of file mfpf_region_pdf_builder.cxx.

mfpf_point_finder_builder * mfpf_region_pdf_builder::clone ( ) const [virtual]

Create a copy on the heap and return base class pointer.

Implements mfpf_point_finder_builder.

Definition at line 420 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::config_as_box ( vcl_istream & is ) [private]

Parse stream to set up as a box shape.

Expects: "{ ni: 3 nj: 5 ref_x: 1.0 ref_y: 2.0 }

Definition at line 261 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::config_as_ellipse ( vcl_istream & is ) [private]

Parse stream to set up as an ellipse shape.

Expects: "{ ri: 2.1 rj: 5.2 }

Definition at line 305 of file mfpf_region_pdf_builder.cxx.

vcl_auto_ptr< mfpf_point_finder_builder > mfpf_point_finder_builder::create_from_stream ( vcl_istream & is ) [static, inherited]

Create a concrete object, from a text specification.

Definition at line 153 of file mfpf_point_finder_builder.cxx.

void mfpf_point_finder_builder::get_sample_vector	(	const vimt_image_2d_of< float > &	image,
		const vgl_point_2d< double > &	p,
		const vgl_vector_2d< double > &	u,
		vcl_vector< double > &	v
	)		`[virtual, inherited]`

Get sample of region around specified point in image.

Reimplemented in mfpf_grad_corr2d_builder, and mfpf_norm_corr2d_builder.

Definition at line 74 of file mfpf_point_finder_builder.cxx.

vcl_string mfpf_region_pdf_builder::is_a ( ) const [virtual]

Name of the class.

Reimplemented from mfpf_point_finder_builder.

Definition at line 414 of file mfpf_region_pdf_builder.cxx.

unsigned mfpf_point_finder_builder::model_dim ( ) [virtual, inherited]

Number of dimensions in the model.

Reimplemented in mfpf_lin_clsfy_finder_builder, mfpf_region_finder_builder, mfpf_grad_corr2d_builder, mfpf_norm_corr2d_builder, and mfpf_norm_corr1d_builder.

Definition at line 68 of file mfpf_point_finder_builder.cxx.

unsigned mfpf_region_pdf_builder::n_pixels ( ) const [inline]

Number of pixels in region.

Definition at line 129 of file mfpf_region_pdf_builder.h.

mfpf_point_finder * mfpf_region_pdf_builder::new_finder ( ) const [virtual]

Create new mfpf_region_pdf on heap.

Implements mfpf_point_finder_builder.

Definition at line 64 of file mfpf_region_pdf_builder.cxx.

void mfpf_point_finder_builder::parse_base_props ( mbl_read_props_type & props ) [protected, inherited]

Parse relevant parameters from props list.

Definition at line 85 of file mfpf_point_finder_builder.cxx.

vpdfl_builder_base& mfpf_region_pdf_builder::pdf_builder ( ) [inline]

Builder for PDF.

Definition at line 135 of file mfpf_region_pdf_builder.h.

void mfpf_region_pdf_builder::print_shape ( vcl_ostream & os ) const

Prints ASCII representation of shape to os.

Definition at line 448 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::print_summary ( vcl_ostream & os ) const [virtual]

Print class to os.

Reimplemented from mfpf_point_finder_builder.

Definition at line 429 of file mfpf_region_pdf_builder.cxx.

double mfpf_point_finder_builder::search_dA ( ) const [inline, inherited]

Angle step size (ie try at A+idA, i in [-nA,+nA]).

Definition at line 90 of file mfpf_point_finder_builder.h.

double mfpf_point_finder_builder::search_ds ( ) const [inline, inherited]

Scaling factor (ie try at ((ds)^i), i in [-ns,+ns].

Definition at line 96 of file mfpf_point_finder_builder.h.

unsigned mfpf_point_finder_builder::search_nA ( ) const [inline, inherited]

Number of angles to search at (ie try at A+idA, i in [-nA,+nA]).

Definition at line 87 of file mfpf_point_finder_builder.h.

int mfpf_point_finder_builder::search_ni ( ) const [inline, inherited]

Definition at line 83 of file mfpf_point_finder_builder.h.

int mfpf_point_finder_builder::search_nj ( ) const [inline, inherited]

Definition at line 84 of file mfpf_point_finder_builder.h.

unsigned mfpf_point_finder_builder::search_ns ( ) const [inline, inherited]

Number of scales to try at.

Definition at line 93 of file mfpf_point_finder_builder.h.

void mfpf_region_pdf_builder::set_as_box	(	unsigned	ni,
		unsigned	nj,
		double	ref_x,
		double	ref_y
	)		`[private]`

Define model region as an ni x nj box.

Definition at line 120 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::set_as_box	(	unsigned	ni,
		unsigned	nj,
		double	ref_x,
		double	ref_y,
		const vpdfl_builder_base &	builder
	)

Define model region as an ni x nj box.

Definition at line 111 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::set_as_box	(	unsigned	ni,
		unsigned	nj,
		const vpdfl_builder_base &	builder
	)

Define model region as an ni x nj box.

Ref. point in centre.

Definition at line 136 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::set_as_ellipse	(	double	ri,
		double	rj
	)		`[private]`

Define model region as an ellipse with radii ri, rj.

Ref. point in centre.

Definition at line 153 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::set_as_ellipse	(	double	ri,
		double	rj,
		const vpdfl_builder_base &	builder
	)

Define model region as an ellipse with radii ri, rj.

Ref. point in centre.

Definition at line 144 of file mfpf_region_pdf_builder.cxx.

void mfpf_point_finder_builder::set_base_parameters ( mfpf_point_finder & pf ) [protected, inherited]

Set base-class parameters of point finder.

Definition at line 126 of file mfpf_point_finder_builder.cxx.

void mfpf_region_pdf_builder::set_defaults ( ) [private]

Define default values.

Definition at line 38 of file mfpf_region_pdf_builder.cxx.

bool mfpf_region_pdf_builder::set_from_stream ( vcl_istream & is ) [virtual]

Initialise from a string stream.

Reimplemented from mfpf_point_finder_builder.

Definition at line 338 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::set_region ( const mfpf_region_form & form )

Define model region using description in form.

Assumes form defined in world-coords. Sets step_size() to form.pose().scale().

Assumes form defined in world-coords. Assumes step_size() pixel units (ie dimensions are divided by step_size() to map to reference frame).

Definition at line 73 of file mfpf_region_pdf_builder.cxx.

void mfpf_region_pdf_builder::set_region_size	(	double	wi,
		double	wj
	)		`[virtual]`

Define region size in world co-ordinates.

Sets up ROI to cover given box (with samples at step_size()), with ref point at centre. Currently just defines as a box

Sets up ROI to cover given box (with samples at step_size()), with ref point at centre.

Implements mfpf_point_finder_builder.

Definition at line 100 of file mfpf_region_pdf_builder.cxx.

void mfpf_point_finder_builder::set_search_angle_range	(	unsigned	nA,
		double	dA
	)		`[inherited]`

Define angle search parameters.

Definition at line 54 of file mfpf_point_finder_builder.cxx.

void mfpf_point_finder_builder::set_search_area	(	unsigned	ni,
		unsigned	nj
	)		`[virtual, inherited]`

Define search region size.

During search, samples at points on grid [-ni,ni]x[-nj,nj], with axes defined by u.

Definition at line 47 of file mfpf_point_finder_builder.cxx.

void mfpf_point_finder_builder::set_search_scale_range	(	unsigned	ns,
		double	ds
	)		`[inherited]`

Define scale search parameters.

Definition at line 61 of file mfpf_point_finder_builder.cxx.

void mfpf_point_finder_builder::set_step_size ( double s ) [virtual, inherited]

Size of step between sample points.

Definition at line 39 of file mfpf_point_finder_builder.cxx.

const vcl_string& mfpf_region_pdf_builder::shape ( ) const [inline]

String defining shape of region, eg "box" or "ellipse".

Definition at line 132 of file mfpf_region_pdf_builder.h.

double mfpf_point_finder_builder::step_size ( ) const [inline, inherited]

Size of step between sample points.

Definition at line 65 of file mfpf_point_finder_builder.h.

short mfpf_region_pdf_builder::version_no ( ) const

Version number for I/O.

Reimplemented from mfpf_point_finder_builder.

Definition at line 465 of file mfpf_region_pdf_builder.cxx.

Member Data Documentation

double mfpf_region_pdf_builder::dA_ [private]

Angle displacement.

Definition at line 63 of file mfpf_region_pdf_builder.h.

vcl_vector<vnl_vector<double> > mfpf_region_pdf_builder::data_ [private]

Samples added in calls to add_example().

Definition at line 57 of file mfpf_region_pdf_builder.h.

unsigned mfpf_region_pdf_builder::n_pixels_ [private]

Number of pixels in region.

Definition at line 48 of file mfpf_region_pdf_builder.h.

unsigned mfpf_region_pdf_builder::nA_ [private]

Number of angles either side of 0 to sample at.

Definition at line 60 of file mfpf_region_pdf_builder.h.

short mfpf_region_pdf_builder::norm_method_ [private]

Which normalisation to use (0=none, 1=linear).

Definition at line 54 of file mfpf_region_pdf_builder.h.

double mfpf_region_pdf_builder::overlap_f_ [private]

Relative size of region used for estimating overlap.

If 0.5, then overlap requires pt inside central 50% of region.

Definition at line 67 of file mfpf_region_pdf_builder.h.

mbl_cloneable_ptr<vpdfl_builder_base> mfpf_region_pdf_builder::pdf_builder_ [private]

Builder for PDf for profile vector.

Definition at line 51 of file mfpf_region_pdf_builder.h.

double mfpf_region_pdf_builder::ref_x_ [private]

Kernel reference point (in roi_ni_ x roi_nj_ grid).

Definition at line 32 of file mfpf_region_pdf_builder.h.

double mfpf_region_pdf_builder::ref_y_ [private]

Kernel reference point (in roi_ni_ x roi_nj_ grid).

Definition at line 34 of file mfpf_region_pdf_builder.h.

vcl_vector<mbl_chord> mfpf_region_pdf_builder::roi_ [private]

Chords defining the region of interest.

Definition at line 40 of file mfpf_region_pdf_builder.h.

unsigned mfpf_region_pdf_builder::roi_ni_ [private]

Size of bounding box of region of interest.

Definition at line 43 of file mfpf_region_pdf_builder.h.

unsigned mfpf_region_pdf_builder::roi_nj_ [private]

Size of bounding box of region of interest.

Definition at line 45 of file mfpf_region_pdf_builder.h.

double mfpf_point_finder_builder::search_dA_ [protected, inherited]

Angle step size (ie try at A+idA, i in [-nA,+nA]).

Definition at line 36 of file mfpf_point_finder_builder.h.

double mfpf_point_finder_builder::search_ds_ [protected, inherited]

Scaling factor (ie try at ((ds)^i), i in [-ns,+ns].

Definition at line 42 of file mfpf_point_finder_builder.h.

unsigned mfpf_point_finder_builder::search_nA_ [protected, inherited]

Define N. angles (ie try at A+idA, i in [-nA,+nA]).

Definition at line 33 of file mfpf_point_finder_builder.h.

int mfpf_point_finder_builder::search_ni_ [protected, inherited]

Number of points either side of centre to search.

Definition at line 27 of file mfpf_point_finder_builder.h.

int mfpf_point_finder_builder::search_nj_ [protected, inherited]

Number of points either side of centre to search.

Definition at line 30 of file mfpf_point_finder_builder.h.

unsigned mfpf_point_finder_builder::search_ns_ [protected, inherited]

Number of scales to try at.

Definition at line 39 of file mfpf_point_finder_builder.h.

vcl_string mfpf_region_pdf_builder::shape_ [private]

String defining shape of region, eg "box" or "ellipse".

Definition at line 37 of file mfpf_region_pdf_builder.h.

double mfpf_point_finder_builder::step_size_ [protected, inherited]

Size of step between sample points.

Definition at line 24 of file mfpf_point_finder_builder.h.

The documentation for this class was generated from the following files:

contrib/mul/mfpf/mfpf_region_pdf_builder.h
contrib/mul/mfpf/mfpf_region_pdf_builder.cxx

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation