RepertoryGrid (CharGer4 Documentation)

Object
- repgrid.RepertoryGrid

Direct Known Subclasses:

TrackedRepertoryGrid
```
public class RepertoryGrid
extends Object
```
Represents the abstraction of a single repertory grid, encapsulating a name, a set of attributes (constructs) as rows and elements as columns, with a single cell for each attribute/construct pair. Allows for tracked repertory grids such that this grid's attributes or elements can be used in another grid.
Conceptually the grid is a list of attributes (row labels), a list of elements (col labels) and a list of cells.

Field Summary

Fields
Modifier and Type	Field and Description
`String`	`attributeLabel` The type of the attributes (rows) of this grid.
`protected ArrayList<RGAttribute>`	`attributes`
`private ArrayList`	`cells`
`String`	`elementLabel` The type of the elements (columns) of this grid.
`private ArrayList<RGElement>`	`elements`
`String`	`name` An identifying string for this grid.
`String`	`relationLabel` The relation type that relates to attributes and elements
`RGValue`	`valuetype` What type is every cell in this grid?

Constructor Summary

Constructors
Constructor and Description
`RepertoryGrid()` Create a new, empty and completely blank repertory grid, ready to have everything set.
`RepertoryGrid(String eLabel, String rLabel, String aLabel, RGValue type)` Create a new, empty repertory grid, with the particular labels and value type.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAttribute(String s)` Adds the given string as an attribute (row) label.
`void`	`addAttribute(String s, int pos)` Add an attribute (construct) "row" with the given description to this grid.
`void`	`addElement(String s)` Adds the given string as an element (column) label.
`void`	`addElement(String s, int pos)` Add an element (column) with the given description to this grid.
`void`	`deleteAttribute(RGAttribute attr)` Deletes an attribute (row) label and all of its associated cells froma repertory grid.
`void`	`deleteAttribute(String label)` Deletes an attribute (row) label and all of its associated cells from a repertory grid.
`void`	`deleteCell(RGCell c)` Detaches a cell from its associated element, attribute and the list of cells.
`void`	`deleteElement(RGElement elem)` Deletes an element (col) label and all of its associated cells froma repertory grid.
`void`	`deleteElement(String label)` Deletes an element (col) label and all of its associated cells from a repertory grid.
`RGAttribute`	`getAttribute(String label)` Finds an attribute object based on its label.
`ArrayList<RGAttribute>`	`getAttributes()` Accesses the attributes (rows) of this repertory grid.
`RGCell`	`getCell(int attnum, int elemnum)` Find the cell at the given row,col index, considering the grid as a simple 2-dimensional array.
`RGCell`	`getCell(RGAttribute a, RGElement e)` Find the cell associated with a given attribute (row) and element (column) pair.
`ArrayList<RGCell>`	`getCells()` Returns the list of cells in this grid.
`RGElement`	`getElement(String label)` Finds an element object based on its label.
`ArrayList<RGElement>`	`getElements()` Accesses the elements (columns) of this repertory grid.
`String`	`getName()`
`String`	`getQuestionLabel()` Get the string (question) used to label this grid; e.g., "What are attributes of furniture?"
`boolean`	`gridComplete()` Determines whether any cells in the grid still need to have values assigned.
`boolean`	`gridEmpty()` Are there no cells at all in this grid?
`void`	`setAttributeLabel(String s)` Sets the term that includes all of the attributes/constructs in this grid (e.g., "attribute" ).
`void`	`setElementLabel(String s)` Sets the term that includes all of the elements in this grid (e.g., "furniture" ).
`void`	`setName(String n)` Sets a name for the grid (usually its filename)
`void`	`setRelationLabel(String s)` Sets the term that denotes the relationship from the element to the attributes (e.g., "has").
`void`	`setValueType(RGValue v)` Sets the value type that will be used to acquire and represent values for this grad.
`void`	`summary()` Prints a summary of the grid on System.out
`void`	`summary(String s)` Prints a summary of the grid on System.out.
`String`	`toCXTString(String title)`

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - attributeLabel
```
public String attributeLabel
```
    The type of the attributes (rows) of this grid.
  - elementLabel
```
public String elementLabel
```
    The type of the elements (columns) of this grid.
  - relationLabel
```
public String relationLabel
```
    The relation type that relates to attributes and elements
  - valuetype
```
public RGValue valuetype
```
    What type is every cell in this grid?
  - attributes
```
protected ArrayList<RGAttribute> attributes
```
  - elements
```
private ArrayList<RGElement> elements
```
  - cells
```
private ArrayList cells
```
  - name
```
public String name
```
    An identifying string for this grid. If association with a file is needed, use a TrackedRepertoryGrid.
    
    See Also:
    
    TrackedRepertoryGrid
- Constructor Detail
  - RepertoryGrid
```
public RepertoryGrid(String eLabel,
                     String rLabel,
                     String aLabel,
                     RGValue type)
```
    Create a new, empty repertory grid, with the particular labels and value type.
    
    Parameters:
    
    eLabel - the term that includes all of the elements in this grid (e.g., "furniture").
    
    rLabel - the term that denotes the relationship from the element to the attributes (e.g., "has").
    
    aLabel - the term that includes all of the attributes/constructs in this grid (e.g., "attribute" ).
    
    type - the type of value for each cell of this grid. Any actual values in this instance are ignored.
    
    See Also:
    
    RGValue
  - RepertoryGrid
```
public RepertoryGrid()
```
    Create a new, empty and completely blank repertory grid, ready to have everything set.
- Method Detail
  - getQuestionLabel
```
public String getQuestionLabel()
```
    Get the string (question) used to label this grid; e.g., "What are attributes of furniture?"
  - setAttributeLabel
```
public void setAttributeLabel(String s)
```
    Sets the term that includes all of the attributes/constructs in this grid (e.g., "attribute" ).
  - setElementLabel
```
public void setElementLabel(String s)
```
    Sets the term that includes all of the elements in this grid (e.g., "furniture" ).
  - setRelationLabel
```
public void setRelationLabel(String s)
```
    Sets the term that denotes the relationship from the element to the attributes (e.g., "has").
  - setValueType
```
public void setValueType(RGValue v)
```
    Sets the value type that will be used to acquire and represent values for this grad.
  - addElement
```
public void addElement(String s)
                throws IllegalArgumentException
```
    Adds the given string as an element (column) label. Creates a set of associated cells for every existing attribute (row) in the grid. This means that the grid is never "sparse" in the sense of having any missing cells.
    
    Parameters:
    
    s - the element(column) label; non-null
    
    Throws:
    
    IllegalArgumentException - if s is either null or the empty string
  - addElement
```
public void addElement(String s,
                       int pos)
                throws IllegalArgumentException
```
    Add an element (column) with the given description to this grid.
    
    Parameters:
    
    s - The label for the element (column) to add
    
    pos - The position in the list of columns. -1 if to be added automatically.
    
    Throws:
    
    IllegalArgumentException - if s is either null or the empty string
  - addAttribute
```
public void addAttribute(String s)
                  throws IllegalArgumentException
```
    Adds the given string as an attribute (row) label. Creates a set of associated cells for every existing element (column) in the grid. This means that the grid is never "sparse" in the sense of having any missing cells.
    
    Parameters:
    
    s - the attribute (row) label; must be non-null;
    
    Throws:
    
    IllegalArgumentException - if s is either null or the empty string
  - addAttribute
```
public void addAttribute(String s,
                         int pos)
                  throws IllegalArgumentException
```
    Add an attribute (construct) "row" with the given description to this grid.
    
    Parameters:
    
    s - The label for the attribute (row) to add
    
    pos - The position in the list of rows. -1 if label is to be added automatically.
    
    Throws:
    
    IllegalArgumentException - if s is either null or the empty string
  - deleteAttribute
```
public void deleteAttribute(String label)
```
    Deletes an attribute (row) label and all of its associated cells from a repertory grid.
  - deleteElement
```
public void deleteElement(String label)
```
    Deletes an element (col) label and all of its associated cells from a repertory grid.
  - getAttribute
```
public RGAttribute getAttribute(String label)
```
    Finds an attribute object based on its label.
    
    Parameters:
    
    label - identifier for this attribute
    
    Returns:
    
    attribute object if found; null otherwise.
  - getElement
```
public RGElement getElement(String label)
```
    Finds an element object based on its label.
    
    Parameters:
    
    label - identifier for this element
    
    Returns:
    
    element object if found; null otherwise.
  - deleteAttribute
```
public void deleteAttribute(RGAttribute attr)
```
    Deletes an attribute (row) label and all of its associated cells froma repertory grid.
  - deleteElement
```
public void deleteElement(RGElement elem)
```
    Deletes an element (col) label and all of its associated cells froma repertory grid.
  - getAttributes
```
public ArrayList<RGAttribute> getAttributes()
```
    Accesses the attributes (rows) of this repertory grid.
    
    Returns:
    
    a vector of RGAttribute objects
  - getElements
```
public ArrayList<RGElement> getElements()
```
    Accesses the elements (columns) of this repertory grid.
    
    Returns:
    
    a vector of RGElement objects
  - getCells
```
public ArrayList<RGCell> getCells()
```
    Returns the list of cells in this grid.
    
    See Also:
    
    RGCell
  - getCell
```
public RGCell getCell(RGAttribute a,
                      RGElement e)
```
    Find the cell associated with a given attribute (row) and element (column) pair.
    
    Returns:
    
    the associated cell, null if there isn't one.
    
    See Also:
    
    addAttribute(java.lang.String), addElement(java.lang.String)
  - getCell
```
public RGCell getCell(int attnum,
                      int elemnum)
```
    Find the cell at the given row,col index, considering the grid as a simple 2-dimensional array.
    
    Parameters:
    
    attnum - index into the attribute vector
    
    elemnum - index into the element vector
    
    Returns:
    
    cell in question; null if there isn't one.
  - deleteCell
```
public void deleteCell(RGCell c)
```
    Detaches a cell from its associated element, attribute and the list of cells. Disposes the cell.
    
    Parameters:
    
    c - the cell to be deleted.
  - summary
```
public void summary()
```
    Prints a summary of the grid on System.out
  - summary
```
public void summary(String s)
```
    Prints a summary of the grid on System.out.
    
    Parameters:
    
    s - prefix the summary with this string
  - gridComplete
```
public boolean gridComplete()
```
    Determines whether any cells in the grid still need to have values assigned.
    
    Returns:
    
    true if all cells have values; false otherwise.
  - gridEmpty
```
public boolean gridEmpty()
```
    Are there no cells at all in this grid?
    
    Returns:
    
    true if there are no cells (i.e., no attributes or elements either)
  - setName
```
public void setName(String n)
```
    Sets a name for the grid (usually its filename)
  - getName
```
public String getName()
```
  - toCXTString
```
public String toCXTString(String title)
```

Class RepertoryGrid

Field Summary

Constructor Summary

Method Summary

Methods inherited from class Object

Field Detail

attributeLabel

elementLabel

relationLabel

valuetype

attributes

elements

cells

name

Constructor Detail

RepertoryGrid

RepertoryGrid

Method Detail

getQuestionLabel

setAttributeLabel

setElementLabel

setRelationLabel

setValueType

addElement

addElement

addAttribute

addAttribute

deleteAttribute

deleteElement

getAttribute

getElement

deleteAttribute

deleteElement

getAttributes

getElements

getCells

getCell

getCell

deleteCell

summary

summary

gridComplete

gridEmpty

setName

getName

toCXTString