DualCoding::MapBuilderRequest Class Reference

#include <MapBuilderRequest.h>

Detailed Description

Definition at line 22 of file MapBuilderRequest.h.

Public Types
enum	MapBuilderRequestType_t { cameraMap, groundMap, localMap, worldMap }
enum	GroundPlaneAssumption_t { onStand, onLegs, onWheel, custom }
typedef unsigned int	MapBuilderVerbosity_t
Public Member Functions
	MapBuilderRequest (MapBuilderRequestType_t reqtype=cameraMap)
	Constructor.
	MapBuilderRequest (const MapBuilderRequest &req)
	Copy constructor.
MapBuilderRequest &	operator= (const MapBuilderRequest &req)
	Assignment operator.
virtual	~MapBuilderRequest ()
	Destructor.
MapBuilderRequestType_t	getRequestType () const
std::set< color_index >	allColors ()
	Set of all non-zero/non-unsaturated colors (useful for requesting markers of all possible colors).
void	addObjectColor (ShapeType_t type, std::string const &color_name)
	Shortcut for specifying an objectColors entry.
void	addAllObjectColors (ShapeType_t type)
	Shortcut for specifying all object colors.
void	addOccluderColor (ShapeType_t type, std::string const &color_name)
	Shortcut for specifying an occluderColors entry.
void	addMinBlobArea (std::string const &color_name, int area)
	Shortcut for specifying a minimum blob area.
void	addAllMinBlobAreas (int area)
	Shortcut for specifying a minimum blob area for all blob colors.
void	addBlobOrientation (std::string const &color_name, BlobData::BlobOrientation_t orient, coordinate_t assumedHeight=0)
	Shortcut for specifying a blob's orientation and (for poster orientations) assumed height.
void	addMarkerType (MarkerType_t type)
	Shortcut for specifying a marker type to look for.
void	addSiftObject (string const &name)
	Shortcut for specifying a SIFT object type to look for.
void	setAprilTagFamily ()
	Shortcut for requesting AprilTag extraction using the smallest available tag family.
void	setAprilTagFamily (int bits, int minimumHammingDistance)
	Shortcut for selecting a specific AprilTag family.
Public Attributes
MapBuilderRequestType_t	requestType
	Type of map to build.
std::map< ShapeType_t, std::set< color_index > >	objectColors
	For each object type, a set of object color indices.
std::map< ShapeType_t, std::set< color_index > >	occluderColors
	For each object type, a set of occluder color indices.
std::map< color_index, int >	minBlobAreas
	Minimum acceptable areas for blobs of specified colors, e.g., req.minBlobAreas[pink_index]=50.
std::map< color_index, BlobData::BlobOrientation_t >	blobOrientations
	Default orientation for blobs of specified colors.
std::map< color_index, coordinate_t >	assumedBlobHeights
	Fixed heights for pillar or poster blobs of specified colors.
std::set< MarkerType_t >	markerTypes
	Types of markers to search for.
std::map< MarkerType_t, coordinate_t >	markerHeights
	Assumed height above ground in mm for markers of this type.
unsigned int	floorColor
string	siftDatabasePath
	Path to the SIFT object database to load.
std::set< std::string >	siftObjectNames
	Names of objects to search for; if empty, search for everything.
std::pair< int, int >	aprilTagFamily
	AprilTag family to use, e.g., Tag16h5 would be std::pair<int,int>(16,5).
unsigned int	motionSettleTime
	Time in msec to wait before taking measurements or throwing completion event after head reaches gazePt.
int	numSamples
	Number of camera images to combine, for noise reduction.
int	sampleInterval
	Interval in msec between successive samples.
float	maxDist
	Ignore objects farther than this distance.
bool	clearCamera
	If true (default), clear the camera sketch and shape spaces at start of request.
bool	clearLocal
	If true (default), clear the local sketch and shape spaces at start of request.
bool	clearWorld
	If true (default is false), clear the world sketch and shape spaces at start of request.
bool	pursueShapes
	If true, generate new gaze points as shapes are recognized.
bool	immediateRequest
	If true, the current camera image is processed immediately and results are available when MapBuilder::executeRequest() returns, so there's no need to set up an event listener. Only possible if numSamples == 1 and no head motion is required.
bool	manualHeadMotion
	If true, waits for !msg MoveHead before moving to next gaze point (for debugging).
bool	rawY
	If true, leave an intensity (Y-channel) image in camera space for debugging.
bool	removePts
	If true, remove pending gaze points if they're visible in current image.
bool	doScan
	If true, do a continuous scan of the area to find interest points to be examined.
AngPi	dTheta
	Angular step for scanning.
ShapeRoot	searchArea
	The area to search, in egocentric coords.
std::queue < LookoutSearchRequest * >	worldTargets
	Queue of search requests for world targets.
void(*	userImageProcessing )()
	User routine to call after a camera image is received.
void(*	userCamProcessing )()
	User routine to call after cam space processing.
void(*	userGroundProcessing )()
	User routine to call after ground space processing.
void(*	userLocalProcessing )()
	User routine to call after local space processing.
void(*	userWorldProcessing )()
	User routine to call after world space processing.
bool(*	exitTest )()
	If true, terminate map building and post completion event.
enum DualCoding::MapBuilderRequest::GroundPlaneAssumption_t	groundPlaneAssumption
PlaneEquation	customGroundPlane
	User-supplied ground plane.
BehaviorBase *	requestingBehavior
	The Behavior making this request; used for posting mapbuilder events.
MapBuilderVerbosity_t	setVerbosity
	Verbosity elements to force on.
MapBuilderVerbosity_t	clearVerbosity
	Verbosity elements to force off.
fmat::Transform	baseTransform
	Used by the Pilot when rotating the body to simulate a pan/tilt.
Static Public Attributes
static coordinate_t	defaultMarkerHeight = 7.0f * 25.4f
Protected Member Functions
bool	validateRequest ()
	check object types, colors, etc.
bool	validateSift ()
bool	validateRequestType ()
Static Protected Member Functions
static bool	validateColors (const map< ShapeType_t, set< color_index > > &shapes2colors)
static bool	validateAdd (ShapeType_t type, std::string const &color_name)
Private Attributes
std::vector< Point >	gazePts
std::vector< fmat::Transform >	baseToCamMats
unsigned int	requestID
	Set by mapbuilder when the request is added to its request queue.
MapBuilderVerbosity_t	verbosity
	Merger of global default verbosity settings and set/clear for this request.
Friends
class	MapBuilder

Member Typedef Documentation

typedef unsigned int DualCoding::MapBuilderRequest::MapBuilderVerbosity_t

Definition at line 33 of file MapBuilderRequest.h.

Member Enumeration Documentation

enum DualCoding::MapBuilderRequest::GroundPlaneAssumption_t

Enumerator:

onStand
onLegs
onWheel
custom

Definition at line 70 of file MapBuilderRequest.h.

enum DualCoding::MapBuilderRequest::MapBuilderRequestType_t

Enumerator:

cameraMap
groundMap
localMap
worldMap

Definition at line 26 of file MapBuilderRequest.h.

Constructor & Destructor Documentation

DualCoding::MapBuilderRequest::MapBuilderRequest ( MapBuilderRequestType_t reqtype = cameraMap )

Constructor.

Definition at line 85 of file MapBuilderRequest.h.

DualCoding::MapBuilderRequest::MapBuilderRequest ( const MapBuilderRequest & req )

Copy constructor.

Definition at line 106 of file MapBuilderRequest.h.

virtual DualCoding::MapBuilderRequest::~MapBuilderRequest ( ) [virtual]

Destructor.

Definition at line 188 of file MapBuilderRequest.h.

Member Function Documentation

void DualCoding::MapBuilderRequest::addAllMinBlobAreas ( int area )

Shortcut for specifying a minimum blob area for all blob colors.

Definition at line 98 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::addAllObjectColors ( ShapeType_t type )

Shortcut for specifying all object colors.

Definition at line 84 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::addBlobOrientation	(	std::string const &	color_name,
		BlobData::BlobOrientation_t	orient,
		coordinate_t	assumedHeight = `0`
	)

Shortcut for specifying a blob's orientation and (for poster orientations) assumed height.

Definition at line 103 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::addMarkerType ( MarkerType_t type )

Shortcut for specifying a marker type to look for.

Definition at line 108 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::addMinBlobArea	(	std::string const &	color_name,
		int	area
	)

Shortcut for specifying a minimum blob area.

Definition at line 93 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::addObjectColor	(	ShapeType_t	type,
		std::string const &	color_name
	)

Shortcut for specifying an objectColors entry.

Definition at line 79 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::addOccluderColor	(	ShapeType_t	type,
		std::string const &	color_name
	)

Shortcut for specifying an occluderColors entry.

Definition at line 88 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::addSiftObject ( string const & name )

Shortcut for specifying a SIFT object type to look for.

Definition at line 112 of file MapBuilderRequest.cc.

std::set< color_index > DualCoding::MapBuilderRequest::allColors ( )

Set of all non-zero/non-unsaturated colors (useful for requesting markers of all possible colors).

Definition at line 71 of file MapBuilderRequest.cc.

Referenced by addAllObjectColors().

MapBuilderRequestType_t DualCoding::MapBuilderRequest::getRequestType ( ) const

Definition at line 190 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::determineNextGazePoint(), DualCoding::MapBuilder::processImage(), and validateRequestType().

MapBuilderRequest& DualCoding::MapBuilderRequest::operator= ( const MapBuilderRequest & req )

Assignment operator.

Definition at line 140 of file MapBuilderRequest.h.

void DualCoding::MapBuilderRequest::setAprilTagFamily	(	int	bits,
		int	minimumHammingDistance
	)

Shortcut for selecting a specific AprilTag family.

Definition at line 132 of file MapBuilderRequest.cc.

void DualCoding::MapBuilderRequest::setAprilTagFamily ( )

Shortcut for requesting AprilTag extraction using the smallest available tag family.

Definition at line 116 of file MapBuilderRequest.cc.

bool DualCoding::MapBuilderRequest::validateAdd	(	ShapeType_t	type,
		std::string const &	color_name
	)			`[static, protected]`

Definition at line 20 of file MapBuilderRequest.cc.

Referenced by addMinBlobArea(), addObjectColor(), and addOccluderColor().

bool DualCoding::MapBuilderRequest::validateColors ( const map< ShapeType_t, set< color_index > > & shapes2colors ) [static, protected]

Definition at line 33 of file MapBuilderRequest.cc.

Referenced by validateRequest().

bool DualCoding::MapBuilderRequest::validateRequest ( ) [protected]

check object types, colors, etc.

Definition at line 16 of file MapBuilderRequest.cc.

Referenced by DualCoding::MapBuilder::executeRequest().

bool DualCoding::MapBuilderRequest::validateRequestType ( ) [protected]

Definition at line 57 of file MapBuilderRequest.cc.

Referenced by validateRequest().

bool DualCoding::MapBuilderRequest::validateSift ( ) [protected]

Definition at line 53 of file MapBuilderRequest.cc.

Referenced by validateRequest().

Friends And Related Function Documentation

friend class MapBuilder [friend]

Definition at line 23 of file MapBuilderRequest.h.

Member Data Documentation

std::pair<int,int> DualCoding::MapBuilderRequest::aprilTagFamily

AprilTag family to use, e.g., Tag16h5 would be std::pair<int,int>(16,5).

Definition at line 47 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::getCamAprilTags(), operator=(), and setAprilTagFamily().

std::map<color_index, coordinate_t> DualCoding::MapBuilderRequest::assumedBlobHeights

Fixed heights for pillar or poster blobs of specified colors.

Definition at line 41 of file MapBuilderRequest.h.

Referenced by addBlobOrientation(), DualCoding::MapBuilder::getCamBlobs(), DualCoding::MapBuilder::getCameraShapes(), and operator=().

std::vector<fmat::Transform> DualCoding::MapBuilderRequest::baseToCamMats [private]

Definition at line 79 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::executeRequest(), DualCoding::MapBuilder::extendLocal(), DualCoding::MapBuilder::extendWorld(), and operator=().

fmat::Transform DualCoding::MapBuilderRequest::baseTransform

Used by the Pilot when rotating the body to simulate a pan/tilt.

Definition at line 75 of file MapBuilderRequest.h.

Referenced by operator=(), and DualCoding::MapBuilder::processImage().

std::map<color_index, BlobData::BlobOrientation_t> DualCoding::MapBuilderRequest::blobOrientations

Default orientation for blobs of specified colors.

Definition at line 40 of file MapBuilderRequest.h.

Referenced by addBlobOrientation(), DualCoding::MapBuilder::getCamBlobs(), DualCoding::MapBuilder::getCameraShapes(), and operator=().

bool DualCoding::MapBuilderRequest::clearCamera

If true (default), clear the camera sketch and shape spaces at start of request.

Definition at line 52 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::executeRequest(), operator=(), and DualCoding::MapBuilder::processImage().

bool DualCoding::MapBuilderRequest::clearLocal

If true (default), clear the local sketch and shape spaces at start of request.

Definition at line 53 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::executeRequest(), and operator=().

MapBuilderVerbosity_t DualCoding::MapBuilderRequest::clearVerbosity

Verbosity elements to force off.

Definition at line 74 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::executeRequest(), and operator=().

bool DualCoding::MapBuilderRequest::clearWorld

If true (default is false), clear the world sketch and shape spaces at start of request.

Definition at line 54 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::executeRequest(), and operator=().

PlaneEquation DualCoding::MapBuilderRequest::customGroundPlane

User-supplied ground plane.

Definition at line 71 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::calculateGroundPlane(), and operator=().

coordinate_t DualCoding::MapBuilderRequest::defaultMarkerHeight = 7.0f * 25.4f [static]

Definition at line 34 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::getCamAprilTags().

bool DualCoding::MapBuilderRequest::doScan

If true, do a continuous scan of the area to find interest points to be examined.

Definition at line 60 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::defineGazePts(), DualCoding::MapBuilder::executeRequest(), operator=(), and validateRequestType().

AngPi DualCoding::MapBuilderRequest::dTheta

Angular step for scanning.

Definition at line 61 of file MapBuilderRequest.h.

Referenced by operator=(), and DualCoding::MapBuilder::scanForGazePts().

bool(* DualCoding::MapBuilderRequest::exitTest)()

If true, terminate map building and post completion event.

Definition at line 69 of file MapBuilderRequest.h.

Referenced by operator=(), and DualCoding::MapBuilder::requestExitTest().

unsigned int DualCoding::MapBuilderRequest::floorColor

Definition at line 44 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::getCameraShapes(), and operator=().

std::vector<Point> DualCoding::MapBuilderRequest::gazePts [private]

Definition at line 78 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::defineGazePts(), DualCoding::MapBuilder::determineNextGazePoint(), DualCoding::MapBuilder::doEvent(), DualCoding::MapBuilder::executeRequest(), DualCoding::MapBuilder::extendLocal(), DualCoding::MapBuilder::extendWorld(), and operator=().

enum DualCoding::MapBuilderRequest::GroundPlaneAssumption_t DualCoding::MapBuilderRequest::groundPlaneAssumption

Referenced by DualCoding::MapBuilder::calculateGroundPlane(), and operator=().

bool DualCoding::MapBuilderRequest::immediateRequest

If true, the current camera image is processed immediately and results are available when MapBuilder::executeRequest() returns, so there's no need to set up an event listener. Only possible if numSamples == 1 and no head motion is required.

Definition at line 56 of file MapBuilderRequest.h.

Referenced by LookAtMarkers::Search::doEvent(), LookAtMarkers::TrackMarker::doEvent(), DualCoding::MapBuilder::executeRequest(), operator=(), and validateRequestType().

bool DualCoding::MapBuilderRequest::manualHeadMotion

If true, waits for !msg MoveHead before moving to next gaze point (for debugging).

Definition at line 57 of file MapBuilderRequest.h.

Referenced by DualCoding::MapBuilder::moveToNextGazePoint(), and operator=().

std::map<MarkerType_t, coordinate_t> DualCoding::MapBuilderRequest::markerHeights

Assumed height above ground in mm for markers of this type.

Definition at line 43 of file MapBuilderRequest.h.

Referenced by operator=().

std::set<MarkerType_t> DualCoding::MapBuilderRequest::markerTypes

Types of markers to search for.