org.gicentre.geomap

Class AttributeTable

java.lang.Object

org.gicentre.geomap.AttributeTable

Deprecated.

Should use Processing's Table class instead. This class is maintained for backward compatibility only (it was written before the Processing Table class).

@Deprecated
public class AttributeTable
extends java.lang.Object

Class for representing a table of attributes suitable for querying.

Version:

1.3, 4th March, 2017.

Author:

Ben Fry (http://ben.fry.com/writing/map/Table.pde) with modifications by Jo Wood and Iain Dillingham, giCentre, City University of London.

Constructor Summary

Constructors

Constructor and Description
AttributeTable(int numRows, int numCols, processing.core.PApplet parent) Deprecated. Creates a new empty table with the given dimensions
AttributeTable(processing.core.PApplet parent) Deprecated. Creates a new empty 10 by 10 table.
AttributeTable(java.lang.String filename, processing.core.PApplet parent) Deprecated. Creates a table from the given tab separated values file.

Method Summary

Modifier and Type	Method and Description
static processing.data.Table	buildNewTable(AttributeTable oldTable) Deprecated. Builds a Table from the given (deprecated) attribute table.
static AttributeTable	buildOldTable(processing.data.Table table, processing.core.PApplet parent) Deprecated. Builds an old AttributeTable from the given Table.
int[]	calcMaxWidths() Deprecated. Calculates the maximum widths of the values in each column.
int	findNumCols() Deprecated. Finds the number of columns in the table.
float	getFloat(int id, int columnIndex) Deprecated. Reports the item in the row with the given ID at the given column location as a decimal number.
float	getFloat(java.lang.String id, int columnIndex) Deprecated. Reports the item in the row with the given ID at the given column location as a decimal number.
float	getFloatAt(int rowIndex, int columnIndex) Deprecated. Reports the item at the given row and column location as a decimal number.
java.lang.String[]	getHeadings() Deprecated. Reports the column headings for the table.
int	getInt(int id, int columnIndex) Deprecated. Reports the item in the row with the given ID at the given column location as a whole number.
int	getInt(java.lang.String id, int columnIndex) Deprecated. Reports the item in the row with the given ID at the given column location as a whole number.
int	getIntAt(int rowIndex, int columnIndex) Deprecated. Reports the item at the given row and column location as a whole number.
int	getRowCount() Deprecated. Reports the number of rows in the table.
int	getRowIndex(int id) Deprecated. Finds a row by its ID.
int	getRowIndex(java.lang.String id) Deprecated. Finds a row by its ID.
java.lang.String	getRowName(int rowIndex) Deprecated. Reports the id of the row at the given row index (first row is 0, second is 1 etc.).
java.lang.String	getString(int id, int columnIndex) Deprecated. Reports the item in the row with the given ID at the given column location as a String.
java.lang.String	getString(java.lang.String id, int columnIndex) Deprecated. Reports the item in the given column position with the given ID as a String.
java.lang.String	getStringAt(int rowIndex, int columnIndex) Deprecated. Reports the item at the given row and column location as a String.
java.util.Set<java.lang.Integer>	match(java.lang.String attribute, int columnIndex) Deprecated. Reports the ids of all items at the given column index that match the given text
void	setFloat(int id, int columnIndex, float value) Deprecated. Sets the value at the given row and column as the given decimal number.
void	setFloat(java.lang.String id, int columnIndex, float value) Deprecated. Sets the value at the given row and column as the given decimal number.
void	setFloatAt(int rowIndex, int columnIndex, float value) Deprecated. Sets the value at the given row and column location as the given decimal number.
void	setHeadings(java.lang.String[] headings) Deprecated. Sets the column headings for the table.
void	setInt(int id, int columnIndex, int value) Deprecated. Sets the value at the given row and column as the given whole number.
void	setInt(java.lang.String id, int columnIndex, int value) Deprecated. Sets the value at the given row and column as the given whole number.
void	setIntAt(int rowIndex, int columnIndex, int value) Deprecated. Sets the value at the given row and column location as the given whole number.
void	setRowName(int rowIndex, java.lang.String id) Deprecated. Sets the ID of the given row.
void	setString(int id, int columnIndex, java.lang.String value) Deprecated. Sets the value at the given row and column as the given String.
void	setString(java.lang.String id, int columnIndex, java.lang.String value) Deprecated. Sets the value at the given row and column as the given String.
void	setStringAt(int rowIndex, int columnIndex, java.lang.String value) Deprecated. Sets the value at the given row and column location as the given String.
void	write() Deprecated. Writes this table in TSV format to standard output.
void	write(java.io.PrintWriter writer) Deprecated. Writes this table as a TSV file to the given writer.
void	write(java.lang.String fileName) Deprecated. Writes this table as a TSV file with the given name.
void	writeAsTable(int maxNumRows) Deprecated. Writes this table as formatted text to standard output.
void	writeAsTable(java.io.PrintWriter writer, int maxNumRows) Deprecated. Writes this table as formatted text to the given writer.
void	writeAsTable(java.lang.String fileName, int maxNumRows) Deprecated. Writes this table as formatted text to the file with the given name.

Methods inherited from class java.lang.Object

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

Constructor Detail

AttributeTable

public AttributeTable(processing.core.PApplet parent)

Deprecated.

Creates a new empty 10 by 10 table.

Parameters:

parent - Sketch controlling the location of files to load and save.

AttributeTable

public AttributeTable(int numRows,
                      int numCols,
                      processing.core.PApplet parent)

Deprecated.

Creates a new empty table with the given dimensions

Parameters:

numRows - Number of rows in table.

numCols - Number of columns in table.

parent - Sketch controlling the location of files to load and save.

AttributeTable

public AttributeTable(java.lang.String filename,
                      processing.core.PApplet parent)

Deprecated.

Creates a table from the given tab separated values file.

Parameters:

filename - Name of file containing the TSVs.

parent - Parent sketch from which file reading is handled.

Method Detail

setHeadings

public void setHeadings(java.lang.String[] headings)

Deprecated.

Sets the column headings for the table.

Parameters:

headings - Text headings for each column in the table.

getHeadings

public java.lang.String[] getHeadings()

Deprecated.

Reports the column headings for the table.

Returns:

Text headings for each column in the table.

getRowCount

public int getRowCount()

Deprecated.

Reports the number of rows in the table.

Returns:

Number of rows in the table.

getRowIndex

public int getRowIndex(java.lang.String id)

Deprecated.

Finds a row by its ID. The ID is always stored the first column.

Parameters:

id - ID of the row to search for.

Returns:

Row index corresponding to the first row containing the given ID or -1 if no ID is found.

getRowIndex

public int getRowIndex(int id)

Deprecated.

Finds a row by its ID. The ID is always stored the first column.

Parameters:

id - ID of the row to search for.

Returns:

Row index corresponding to the first row containing the given ID or -1 if no ID is found.

getRowName

public java.lang.String getRowName(int rowIndex)

Deprecated.

Reports the id of the row at the given row index (first row is 0, second is 1 etc.).

Parameters:

rowIndex - Row index to query.

Returns:

First column value associated with the given row index.

getStringAt

public java.lang.String getStringAt(int rowIndex,
                                    int columnIndex)

Deprecated.

Reports the item at the given row and column location as a String.

Parameters:

rowIndex - Row index of the table value to retrieve (first row is 0, second is 1 etc.).

columnIndex - Column index of the table value to retrieve. (first column is 0, second is 1 etc.).

Returns:

Table value at the given location reported as a string.

match

public java.util.Set<java.lang.Integer> match(java.lang.String attribute,
                                              int columnIndex)

Deprecated.

Reports the ids of all items at the given column index that match the given text

Parameters:

attribute - Text to search for.

columnIndex - Column in table to search (first column is 0, second is 1 etc.).

Returns:

List of ids corresponding to matched text. Will be an empty list if no matches found.

getString

public java.lang.String getString(java.lang.String id,
                                  int columnIndex)

Deprecated.

Reports the item in the given column position with the given ID as a String.

Parameters:

id - ID of the row to query.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given column reported as a string.

getString

public java.lang.String getString(int id,
                                  int columnIndex)

Deprecated.

Reports the item in the row with the given ID at the given column location as a String.

Parameters:

id - ID of the row to query.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given column reported as a string.

getIntAt

public int getIntAt(int rowIndex,
                    int columnIndex)

Deprecated.

Reports the item at the given row and column location as a whole number.

Parameters:

rowIndex - Row of the table value to retrieve.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given row and column location reported as a whole number.

getInt

public int getInt(java.lang.String id,
                  int columnIndex)

Deprecated.

Reports the item in the row with the given ID at the given column location as a whole number.

Parameters:

id - ID of the row to query.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given row and column location reported as a whole number.

getInt

public int getInt(int id,
                  int columnIndex)

Deprecated.

Reports the item in the row with the given ID at the given column location as a whole number.

Parameters:

id - ID of the row to query.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given row and column location reported as a whole number.

getFloatAt

public float getFloatAt(int rowIndex,
                        int columnIndex)

Deprecated.

Reports the item at the given row and column location as a decimal number.

Parameters:

rowIndex - Row of the table value to retrieve.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given row and column location reported as a decimal number.

getFloat

public float getFloat(java.lang.String id,
                      int columnIndex)

Deprecated.

Reports the item in the row with the given ID at the given column location as a decimal number.

Parameters:

id - ID of the row to query.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given row and column location reported as a decimal number.

getFloat

public float getFloat(int id,
                      int columnIndex)

Deprecated.

Reports the item in the row with the given ID at the given column location as a decimal number.

Parameters:

id - ID of the row to query.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc).

Returns:

Table value at the given row and column location reported as a decimal number.

setRowName

public void setRowName(int rowIndex,
                       java.lang.String id)

Deprecated.

Sets the ID of the given row. This item will be stored in column 0 of the row.

Parameters:

rowIndex - Row in which to set the name (0 is the first row, 1 the second etc.).

id - New ID (column 0 value) to be associated with the given row.

setStringAt

public void setStringAt(int rowIndex,
                        int columnIndex,
                        java.lang.String value)

Deprecated.

Sets the value at the given row and column location as the given String.

Parameters:

rowIndex - Row of the table value to change (0 is the first row, 1 is the second etc.).

columnIndex - Column of the table value to change (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setString

public void setString(int id,
                      int columnIndex,
                      java.lang.String value)

Deprecated.

Sets the value at the given row and column as the given String.

Parameters:

id - ID of the row in which a value will be changed.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setString

public void setString(java.lang.String id,
                      int columnIndex,
                      java.lang.String value)

Deprecated.

Sets the value at the given row and column as the given String.

Parameters:

id - ID of the row in which a value will be changed.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setIntAt

public void setIntAt(int rowIndex,
                     int columnIndex,
                     int value)

Deprecated.

Sets the value at the given row and column location as the given whole number.

Parameters:

rowIndex - Row of the table value to change (0 is the first row, 1 is the second etc.).

columnIndex - Column of the table value to change (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setInt

public void setInt(java.lang.String id,
                   int columnIndex,
                   int value)

Deprecated.

Sets the value at the given row and column as the given whole number.

Parameters:

id - ID of the row in which a value will be changed.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setInt

public void setInt(int id,
                   int columnIndex,
                   int value)

Deprecated.

Sets the value at the given row and column as the given whole number.

Parameters:

id - ID of the row in which a value will be changed.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setFloatAt

public void setFloatAt(int rowIndex,
                       int columnIndex,
                       float value)

Deprecated.

Sets the value at the given row and column location as the given decimal number.

Parameters:

rowIndex - Row of the table value to change (0 is the first row, 1 is the second etc.).

columnIndex - Column of the table value to change (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setFloat

public void setFloat(java.lang.String id,
                     int columnIndex,
                     float value)

Deprecated.

Sets the value at the given row and column as the given decimal number.

Parameters:

id - ID of the row in which a value will be changed.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

setFloat

public void setFloat(int id,
                     int columnIndex,
                     float value)

Deprecated.

Sets the value at the given row and column as the given decimal number.

Parameters:

id - ID of the row in which a value will be changed.

columnIndex - Column of the table value to retrieve (0 is the first column, 1 is the second etc.).

value - New value to be associated with the given table cell.

calcMaxWidths

public int[] calcMaxWidths()

Deprecated.

Calculates the maximum widths of the values in each column. A width is the number of characters in a cell.

Returns:

Maximum width of each of the columns in the table.

findNumCols

public int findNumCols()

Deprecated.

Finds the number of columns in the table. Since the table may be ragged, this method will check each row will return the maximum number of columns found in the entire table.

Returns:

Maximum number of columns in the table.

write

public void write()

Deprecated.

Writes this table in TSV format to standard output.

write

public void write(java.lang.String fileName)

Deprecated.

Writes this table as a TSV file with the given name.

Parameters:

fileName - Name of file to contain the TSV output.

write

public void write(java.io.PrintWriter writer)

Deprecated.

Writes this table as a TSV file to the given writer.

Parameters:

writer - Output writer in which to send table contents.

writeAsTable

public void writeAsTable(int maxNumRows)

Deprecated.

Writes this table as formatted text to standard output. This is designed for producing 'pretty' text output so table can be examined more easily.

Parameters:

maxNumRows - Maximum number of rows of the table to display.

writeAsTable

public void writeAsTable(java.lang.String fileName,
                         int maxNumRows)

Deprecated.

Writes this table as formatted text to the file with the given name. This is designed for producing 'pretty' text output so table can be examined more easily.

Parameters:

fileName - Name of file to contain the formatted output.

maxNumRows - Maximum number of rows of the table to display.

writeAsTable

public void writeAsTable(java.io.PrintWriter writer,
                         int maxNumRows)

Deprecated.

Writes this table as formatted text to the given writer. This is designed for producing 'pretty' text output so table can be examined more easily.

Parameters:

writer - Output writer in which to send table contents.

maxNumRows - Maximum number of rows of the table to display.

buildOldTable

public static AttributeTable buildOldTable(processing.data.Table table,
                                           processing.core.PApplet parent)

Deprecated.

Builds an old AttributeTable from the given Table. This is used for creating backward compatible versions of an attribute table associated with a geoMap.

Parameters:

table - Table to convert.

parent - Parent sketch that deals with file handling should the attribute table need saving.

Returns:

Old attribute table.

buildNewTable

public static processing.data.Table buildNewTable(AttributeTable oldTable)

Deprecated.

Builds a Table from the given (deprecated) attribute table. This is used for converting from backward compatible versions of an attribute table associated with a geoMap.

Parameters:

oldTable - Old table to convert.

Returns:

New attribute table.