Regular Class Reference

A puzzle has Regular pieces when they are all of a consistent sizing such that their edge structure can be compared in a standard North, South, East, West approach. More...

Inheritance diagram for Regular:

Collaboration diagram for Regular:

Public Member Functions
def	__init__ (self, PuzzleTemplate y=None, r=(0, 0), id=None, theta=0, pieceStatus=PieceStatus.UNKNOWN)
	Constructor for the regular puzzle piece. More...
def	printEdgeType (self)
def	rotatePiece (self, theta)
def	setEdgeType (self, direction, etype)
	Set up the type of the chosen edge. More...
Public Member Functions inherited from Template
def	__init__ (self, PuzzleTemplate y=None, r=None, centroidLoc=None, id=None, theta=0, pieceStatus=PieceStatus.UNKNOWN)
	Constructor for template class. More...
def	deepcopy (self)
def	displace (self, dr)
	Displace puzzle piece. More...
def	display (self, fh=None)
	Display the puzzle piece contents in an image window. More...
def	genFeature (self, theMatcher)
def	getFeature (self, theMatcher=None)
	Get the feature vector of the puzzle piece. More...
def	getGraspLoc (self, kernel_size=10)
	Get the location in pixel coordinates to send the suction cup gripper to grasp the piece. More...
def	getMask (self, theMask, offset=[0, 0])
	Get an updated mask of the target. More...
def	placeInImage (self, theImage, offset=[0, 0], CONTOUR_DISPLAY=False)
	Insert the puzzle piece into the image in the original location. More...
def	placeInImageAt (self, theImage, rc, theta=None, isCenter=False, CONTOUR_DISPLAY=True)
	Insert the puzzle piece into the image at the given location. More...
def	replaceSourceData (self, theImage, pOff=None)
	Replace a puzzle pieces source data by grabbing from an image. More...
def	rotate (self, theta)
	Rotate piece appearance by given angle. More...
def	setPlacement (self, r, isOffset=False, isCenter=False)
	Provide pixel placement location information. More...
def	setStatus (self, theStatus)
def	size (self)
	Return the dimensions of the puzzle piece image. More...
def	toImage (self)
	Return the puzzle piece image (cropped). More...
def	update (self, matchedPiece)
	Update template board puzzle piece based on association. More...

Static Public Member Functions
def	buildFromMaskAndImage (theMask, theImage, cLoc, rLoc=None, pieceStatus=PieceStatus.MEASURED)
	Given a mask (individual) and an image of same base dimensions, use to instantiate a puzzle piece template. More...
def	upgradeTemplate (thePiece)
	Given a Template instance, transfer to a Regular instance. More...
Static Public Member Functions inherited from Template
def	buildFromFullMaskAndImage (theMask, theImage, cLoc=None, rLoc=None, pieceStatus=PieceStatus.MEASURED)
	Given a mask and an image of same base dimensions, use to instantiate a puzzle piece template. More...
def	buildFromMaskAndImage (theMask, theImage, cLoc=None, rLoc=None, centroidLoc=None, pieceStatus=PieceStatus.MEASURED)
	Given a mask (individual) and an image of same base dimensions, use to instantiate a puzzle piece template. More...
def	buildSphere (radius, color, rLoc=[0, 0])
	Build a sphere piece. More...
def	buildSquare (size, color, rLoc=[0, 0])
	Build a square piece. More...
def	getEig (img)
	To find the major and minor axes of a blob and then return the aligned rotation. More...

Public Attributes
	class_image
	edge
	filtered_harris_pts
	rectangle_pts
	simple_harris_pts
	theta
Public Attributes inherited from Template
	centroidLoc
	featVec
	gLoc
	id
	lifespan
	status
	theta
	y

Additional Inherited Members
Static Public Attributes inherited from Template
tuple	cDelta = (rodims - imdims)/2
tuple	cLoc = self.y.pcorner - cDelta
	cLoc = np.maximum(cLoc, 0)
	colInds = np.argwhere(colMa)
tuple	colInds = colInds + cLoc[0]
	colMa = rMa.any(axis=0)
	cropIm = theImage[rowInds, np.transpose(colInds), :]
	cropMa = rMa[rowInds,np.transpose(colInds)]
	imdims = np.array(self.y.image.shape[0:2])
def	newPiece
	rIm = self.y.image
tuple	rLoc = self.rLoc - cDelta
	rLoc = np.maximum(rLoc, 0)
	rMa = self.y.mask
	rodims = np.array(cropMa.shape[0:2])
	rowInds = np.argwhere(rowMa)
tuple	rowInds = rowInds + cLoc[1]
	rowMa = rMa.any(axis=1)

Detailed Description

A puzzle has Regular pieces when they are all of a consistent sizing such that their edge structure can be compared in a standard North, South, East, West approach.

Usually Regular pieces are part of a Gridded puzzle.

Constructor & Destructor Documentation

__init__()

def __init__	(		self,
		PuzzleTemplate	y = None,
			r = (0, 0),
			id = None,
			theta = 0,
			pieceStatus = PieceStatus.UNKNOWN
	)

Constructor for the regular puzzle piece.

Arguments are optional.

Parameters

[in]	y	Puzzle template instance.
[in]	r	Location of the puzzle piece (top-left corner).
[in]	theta	Orientation of the piece.
[in]	pieceStatus	Measurement status.

Member Function Documentation

buildFromMaskAndImage()

def buildFromMaskAndImage (   theMask,   theImage,   cLoc,   rLoc = None,   pieceStatus = PieceStatus.MEASURED  )

static

Given a mask (individual) and an image of same base dimensions, use to instantiate a puzzle piece template.

Parameters

[in]	theMask	Individual mask.
[in]	theImage	Source image.
[in]	rLoc	Puzzle piece (corner) location in the whole image.
[in]	theRegular	Puzzle piece instance as a Regular piece.

printEdgeType()

def printEdgeType

(

self

)

@brief  Display the edge type of the piece.

rotatePiece()

def rotatePiece	(		self,
			theta
	)

@brief  Rotate the regular puzzle piece

Args:
    theta: The rotation angle.

Returns:
    theRegular: The rotated regular piece.

Reimplemented from Template.

setEdgeType()

def setEdgeType	(		self,
			direction,
			etype
	)

Set up the type of the chosen edge.

Parameters

[in]	direction	The edge to be set up.
[in]	etype	The edge type.

Todo:

Shouldn't this be a private or protected member function?

upgradeTemplate()

def upgradeTemplate (   thePiece )

static

Given a Template instance, transfer to a Regular instance.

Parameters

[in]	thePiece	Puzzle piece as a Template instance.
[out]	Puzzle	piece as a Regular instance.

Member Data Documentation

class_image

class_image

edge

edge

filtered_harris_pts

filtered_harris_pts

rectangle_pts

rectangle_pts

simple_harris_pts

simple_harris_pts

theta

theta

---

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

• /local/source/python/puzzle_solver/puzzle/piece.py