repgrid.tracks

Class TrackedRepertoryGrid

Object

repgrid.RepertoryGrid

repgrid.tracks.TrackedRepertoryGrid

All Implemented Interfaces:

KnowledgeSource

public class TrackedRepertoryGrid
extends RepertoryGrid
implements KnowledgeSource

Extensions to repertory grids for their use in CRAFT. Not all extensions are encapsulated here; most uses of repertory grid in CRAFT involve this class instead of its base class. Some extensions to repertory grids and where to find them are as follows:

Attributes	Tracked grids can use a TrackedAttribute. They are constructed, however, with the default RGAttribute; a TrackedAttribute only replaces it when a type descriptor (of any kind) is provided, either by the user or by some automated means.
XML generation	TrackedAttributes are generated with more detail.
conceptual basis	TrackedGrid's have a concept-relation-concept pattern associated with them, and are therefore connected to specific objects in specific conceptual graphs using a locator.
source file	For convenience, the source file (if any) can be saved with a TrackedGrid

Field Summary

Fields

Modifier and Type	Field and Description
Concept	conceptOne Concept corresponding to the element aspect
ObjectLocator	conceptOneLocator Locator for the concept corresponding to the element aspect
Concept	conceptTwo Concept corresponding to the attribute aspect
ObjectLocator	conceptTwoLocator Locator for the concept corresponding to the attribute aspect
GNode	relation Either a relation or an actor
ObjectLocator	relationLocator Locator for either a relation or an actor
File	sourceAbsoluteFile The source of this grid in the file system, null if there isn't one.

Fields inherited from class repgrid.RepertoryGrid

attributeLabel, attributes, elementLabel, name, relationLabel, valuetype

Constructor Summary

Constructors

Constructor and Description
TrackedRepertoryGrid() Construct a new, empty grid with no labels and no cells.
TrackedRepertoryGrid(Concept c1, GNode r, Concept c2, RGValue type)
TrackedRepertoryGrid(File f)
TrackedRepertoryGrid(String eLabel, String rLabel, String aLabel, RGValue type) Creates a new tracked repertory grid, with no rows or columns.

Method Summary

Modifier and Type	Method and Description
AbstractTypeDescriptor[]	findTypeDescriptors(String term) Look for the given type descriptor in the knowledge source, however it may be represented.
Graph[]	getAllGraphs() Get all the graphs known to this knowledge source.
AbstractTypeDescriptor[]	getAllTypeDescriptors() Get all the type descriptors known to this knowledge source.
File	getFile()
void	replaceAttribute(RGAttribute oldattr, RGAttribute newattr) Substitutes a new RGAttribute (or a subclass) for the current attribute.
void	setFile(File f) Associate the given file with this grid.

Methods inherited from class repgrid.RepertoryGrid

addAttribute, addAttribute, addElement, addElement, deleteAttribute, deleteAttribute, deleteCell, deleteElement, deleteElement, getAttribute, getAttributes, getCell, getCell, getCells, getElement, getElements, getName, getQuestionLabel, gridComplete, gridEmpty, setAttributeLabel, setElementLabel, setName, setRelationLabel, setValueType, summary, summary, toCXTString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

sourceAbsoluteFile

public File sourceAbsoluteFile

The source of this grid in the file system, null if there isn't one.

conceptOne

public Concept conceptOne

Concept corresponding to the element aspect

conceptTwo

public Concept conceptTwo

Concept corresponding to the attribute aspect

relation

public GNode relation

Either a relation or an actor

conceptOneLocator

public ObjectLocator conceptOneLocator

Locator for the concept corresponding to the element aspect

See Also:

ObjectLocator

conceptTwoLocator

public ObjectLocator conceptTwoLocator

Locator for the concept corresponding to the attribute aspect

See Also:

ObjectLocator

relationLocator

public ObjectLocator relationLocator

Locator for either a relation or an actor

See Also:

ObjectLocator

Constructor Detail

TrackedRepertoryGrid

public TrackedRepertoryGrid(String eLabel,
                            String rLabel,
                            String aLabel,
                            RGValue type)

Creates a new tracked repertory grid, with no rows or columns.

Parameters:

eLabel - element label, telling what kind of thing the elements are

rLabel - relationship label, denoting relationship between elements and attributes

aLabel - attribute label, telling what kind of thing the attributes are

type - The type of value to be associated with each element/attribute pair. Currently only RGBooleanValue types are fully supported; use others at your own risk!

TrackedRepertoryGrid

public TrackedRepertoryGrid(Concept c1,
                            GNode r,
                            Concept c2,
                            RGValue type)

TrackedRepertoryGrid

public TrackedRepertoryGrid()

Construct a new, empty grid with no labels and no cells. Cell type defaults to RGBooleanValue.

TrackedRepertoryGrid

public TrackedRepertoryGrid(File f)

Method Detail

getFile

public File getFile()

setFile

public void setFile(File f)

Associate the given file with this grid.

Parameters:

f - the file to be associated; no assumption made about its existence or permissions.

replaceAttribute

public void replaceAttribute(RGAttribute oldattr,
                             RGAttribute newattr)

Substitutes a new RGAttribute (or a subclass) for the current attribute. Useful in converting one class to another. Works differently from delete/insert in that associated cells are preserved.

findTypeDescriptors

public AbstractTypeDescriptor[] findTypeDescriptors(String term)

Description copied from interface: KnowledgeSource

Look for the given type descriptor in the knowledge source, however it may be represented. Calls to findTypeDescriptors may return more than one descriptor, since some compound terms may require two or more descriptors.

Specified by:

findTypeDescriptors in interface KnowledgeSource

Parameters:

term - a phrase that may have type descriptors.

Returns:

zero or more type descriptors, but never null;

getAllTypeDescriptors

public AbstractTypeDescriptor[] getAllTypeDescriptors()

Get all the type descriptors known to this knowledge source.

Specified by:

getAllTypeDescriptors in interface KnowledgeSource

Returns:

a possibly empty list, but never null;

getAllGraphs

public Graph[] getAllGraphs()

Get all the graphs known to this knowledge source.

Specified by:

getAllGraphs in interface KnowledgeSource

Returns:

a possibly empty list of graphs, but never null;