org.wwbota.identification
Interface Identification

All Known Implementing Classes:
SimpleIdentification

public interface Identification

Computer-aided interactive Identification (determination) of a biological specimen, believed to belong to one of the taxa of the current Taxonomy . This is the central interface of this API. It should allow to integrate a specific Identification algorithm, plus the Taxonomy on which it operates, in a GUI (Graphical User Interface) or other software. Each implementation will support a different kind of Identification algorithm and user interaction. The way of specifying the observed character values is in in the child classes. ISSUE: Identification interface should support history of user commands, probably through the Command Design Pattern (see Design patterns by E. Gamma et al., the "gang of four") .

Author:
Jean-Marc Vanel jmvanel@free.fr , Worldwide Botanical Knowledge Base

Method Summary
 java.util.List getAdvices()
          Which are the best characters to use now?
 Description getDescription()
          Get and set the list of Criteria, that is, the observed characters.
 java.util.List getMatches()
          Get the list of items satisfying the Criteria entered so far.
 Taxonomy getTaxonomy()
          Get and set the list of Taxon (items) to be recognized, together with the characters taken in account.
 void setDescription(Description t)
           
 void setTaxonomy(Taxonomy t)
           
 

Method Detail

getMatches

public java.util.List getMatches()
Get the list of items satisfying the Criteria entered so far.
Returns:
a list of Description objects

getAdvices

public java.util.List getAdvices()
Which are the best characters to use now?
Returns:
a list of Character objects, which are the best separating characters to use at this point in the identification process .

getTaxonomy

public Taxonomy getTaxonomy()
Get and set the list of Taxon (items) to be recognized, together with the characters taken in account.

setTaxonomy

public void setTaxonomy(Taxonomy t)

getDescription

public Description getDescription()
Get and set the list of Criteria, that is, the observed characters.

setDescription

public void setDescription(Description t)