diva.sketch.recognition

Interface ChoiceElement

All Superinterfaces:

CompositeElement, SceneElement

public interface ChoiceElement
extends CompositeElement

A choice element represents a choice between multiple typed elements that have the same type (or super-type). A choice element has the following properties:

• All direct children of a choice node cover the same set of stroke leaves.
• The type of a choice node is a super-class of each of its direct children, either in the object-oriented sense of the word (Triangle extends Shape) or the grammar sense of the word (shape ::= triangle | square | circle).

Here is an example of a choice element:

 textLine(.9)        textLine(.7)
    |                   |
 text("foo", .9)   text("boo", .7)
         \           /
         [strokes...]
 

can be represented as:

            textLine
               |
          CHOICE(text)
          /          \
 text("foo", .9)   text("boo", .7)
          \          /
          [strokes...]
 

This means that all interpretations of text that use the same underlying strokes are handled as one node through the rest of the parsing algorithm. This greatly improves parsing efficiency. It is up to the application to choose one of the children of a choice node (probably the highest confidence choice, or allow the user to mediate when the difference in confidences is low).

Version:

$Revision: 1.2 $

Author:

Michael Shilman (michaels@eecs.berkeley.edu)

Method Summary

Modifier and Type	Method and Description
List	choiceNames() Return an array of the names of the children of this element, each of which sequentially corresponds to an item in the array returned by children().
List	choices() Return a list that contains the choices that this element covers, from high to low confidence.

Methods inherited from interface diva.sketch.recognition.CompositeElement

childNames, children, getConfidence, getData

Methods inherited from interface diva.sketch.recognition.SceneElement

getBounds, parents

Method Detail

choices

List choices()

Return a list that contains the choices that this element covers, from high to low confidence.

choiceNames

List choiceNames()

Return an array of the names of the children of this element, each of which sequentially corresponds to an item in the array returned by children().