org.gephi.datalab.impl

Class AttributeColumnsMergeStrategiesControllerImpl

java.lang.Object

org.gephi.datalab.impl.AttributeColumnsMergeStrategiesControllerImpl

All Implemented Interfaces:

AttributeColumnsMergeStrategiesController

public class AttributeColumnsMergeStrategiesControllerImpl
extends Object
implements AttributeColumnsMergeStrategiesController

Implementation of the AttributeColumnsMergeStrategiesController interface declared in the Data Laboratory API.

Author:

Eduardo Ramos

See Also:

AttributeColumnsMergeStrategiesController

Nested Class Summary

Nested classes/interfaces inherited from interface org.gephi.datalab.api.AttributeColumnsMergeStrategiesController

AttributeColumnsMergeStrategiesController.BooleanOperations

Constructor Summary

Constructors

Constructor and Description
AttributeColumnsMergeStrategiesControllerImpl()

Method Summary

Methods

Modifier and Type	Method and Description
org.gephi.graph.api.Column	averageNumberMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the average of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.
org.gephi.graph.api.Column	booleanLogicOperationsMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, AttributeColumnsMergeStrategiesController.BooleanOperations[] booleanOperations, String newColumnTitle) Strategy to apply only to all boolean columns.
private void	checkColumnsAreNumberOrNumberList(org.gephi.graph.api.Column[] columns)
private void	checkTableAndColumnsAreNumberOrNumberList(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columns)
private void	checkTableAndOneColumn(org.gephi.graph.api.Table table, org.gephi.graph.api.Column startColumn, org.gephi.graph.api.Column endColumn)
org.gephi.graph.api.Column	firstQuartileNumberMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the first quartile (Q1) of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.
private org.gephi.graph.api.Column	getTimeIntervalColumn(org.gephi.graph.api.Table table) Private methods:
org.gephi.graph.api.Column	interQuartileRangeNumberMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the interquartile range (IQR) of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.
org.gephi.graph.api.Column	joinWithSeparatorMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, Class newColumnType, String newColumnTitle, String separator) Joins various columns of any type into a new column using the given separator string (or null).
org.gephi.graph.api.Column	maxValueNumbersMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the maximum value of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.
org.gephi.graph.api.Column	medianNumberMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the median of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.
org.gephi.graph.api.Column	mergeDateColumnsToTimeInterval(org.gephi.graph.api.Table table, org.gephi.graph.api.Column startColumn, org.gephi.graph.api.Column endColumn, SimpleDateFormat dateFormat, String defaultStartDate, String defaultEndDate) Merge 1 or 2 columns creating a time interval for each row.
org.gephi.graph.api.Column	mergeNumericColumnsToTimeInterval(org.gephi.graph.api.Table table, org.gephi.graph.api.Column startColumn, org.gephi.graph.api.Column endColumn, double defaultStart, double defaultEnd) Merge 1 or 2 columns creating a time interval for each row.
org.gephi.graph.api.Column	minValueNumbersMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the minimum value of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.
private double	parseDateToDouble(SimpleDateFormat dateFormat, String date, double defaultValue)
private double	parseDouble(String number, double defaultValue)
org.gephi.graph.api.Column	sumNumbersMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the sum of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.
org.gephi.graph.api.Column	thirdQuartileNumberMerge(org.gephi.graph.api.Table table, org.gephi.graph.api.Column[] columnsToMerge, String newColumnTitle) Merges any combination of number or number list columns, calculating the third quartile (Q3) of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Methods inherited from class java.lang.Object

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

Constructor Detail

AttributeColumnsMergeStrategiesControllerImpl

public AttributeColumnsMergeStrategiesControllerImpl()

Method Detail

joinWithSeparatorMerge

public org.gephi.graph.api.Column joinWithSeparatorMerge(org.gephi.graph.api.Table table,
                                                org.gephi.graph.api.Column[] columnsToMerge,
                                                Class newColumnType,
                                                String newColumnTitle,
                                                String separator)

Description copied from interface: AttributeColumnsMergeStrategiesController

Joins various columns of any type into a new column using the given separator string (or null).

If the specified column type is null, the new created column will have STRING AttributeType by default.

Specified by:

joinWithSeparatorMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Columns to merge

newColumnType - Type for the new column. If null, STRING will be used by default

newColumnTitle - Title for the new column

separator - Separator to put between each value

Returns:

The new created column

booleanLogicOperationsMerge

public org.gephi.graph.api.Column booleanLogicOperationsMerge(org.gephi.graph.api.Table table,
                                                     org.gephi.graph.api.Column[] columnsToMerge,
                                                     AttributeColumnsMergeStrategiesController.BooleanOperations[] booleanOperations,
                                                     String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Strategy to apply only to all boolean columns. Merges various columns into a new boolean column allowing to define each operation to apply between each pair of columns to merge.

The length of the operations array must be the length of the columns array-1, or IllegalArgumentException will be thrown.

Specified by:

booleanLogicOperationsMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Boolean columns to merge

booleanOperations - Boolean operations to apply

newColumnTitle - Title for the new column

Returns:

The new created column

mergeNumericColumnsToTimeInterval

public org.gephi.graph.api.Column mergeNumericColumnsToTimeInterval(org.gephi.graph.api.Table table,
                                                           org.gephi.graph.api.Column startColumn,
                                                           org.gephi.graph.api.Column endColumn,
                                                           double defaultStart,
                                                           double defaultEnd)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merge 1 or 2 columns creating a time interval for each row. Values of the columns will be expected as numbers

Only one of the 2 column could be null, and its corresponding start/end default will be used.

Columns can be of any type. If not numeric, their values will be parsed.

Default start and end values will be used when the columns don't have a value or it can't be parsed to a double.

When start > end for any reason:

• If both columns were provided: A infinite time interval will be set
• If only one column was provided: The value for the provided column will be kept and the other will be infinite

Specified by:

mergeNumericColumnsToTimeInterval in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns, can't be null or wrong

startColumn - Column to use as start value

endColumn - Column to use as end value

defaultStart - Default start value

defaultEnd - Default end value

Returns:

Time interval column

mergeDateColumnsToTimeInterval

public org.gephi.graph.api.Column mergeDateColumnsToTimeInterval(org.gephi.graph.api.Table table,
                                                        org.gephi.graph.api.Column startColumn,
                                                        org.gephi.graph.api.Column endColumn,
                                                        SimpleDateFormat dateFormat,
                                                        String defaultStartDate,
                                                        String defaultEndDate)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merge 1 or 2 columns creating a time interval for each row. Values of the columns will be expected as dates in the given date format

Only one of the 2 column could be null, and its corresponding start/end default will be used.

Columns can be of any type.

Default start and end values will be used when the columns don't have a value or it can't be parsed to a date. If a default value can't be parsed to a date, infinity will be used as default instead.

When start > end for any reason:

• If both columns were provided: A infinite time interval will be set
• If only one column was provided: The value for the provided column will be kept and the other will be infinite

Specified by:

mergeDateColumnsToTimeInterval in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns, can't be null or wrong

startColumn - Column to use as start value

endColumn - Column to use as end value

dateFormat - Format for the dates, can't be null

defaultStartDate - Default date to use as start if it can be parsed

defaultEndDate - Default date to use as end if it can be parsed

Returns:

Time interval column

averageNumberMerge

public org.gephi.graph.api.Column averageNumberMerge(org.gephi.graph.api.Table table,
                                            org.gephi.graph.api.Column[] columnsToMerge,
                                            String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the average of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

averageNumberMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

firstQuartileNumberMerge

public org.gephi.graph.api.Column firstQuartileNumberMerge(org.gephi.graph.api.Table table,
                                                  org.gephi.graph.api.Column[] columnsToMerge,
                                                  String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the first quartile (Q1) of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

firstQuartileNumberMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

medianNumberMerge

public org.gephi.graph.api.Column medianNumberMerge(org.gephi.graph.api.Table table,
                                           org.gephi.graph.api.Column[] columnsToMerge,
                                           String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the median of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

medianNumberMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

thirdQuartileNumberMerge

public org.gephi.graph.api.Column thirdQuartileNumberMerge(org.gephi.graph.api.Table table,
                                                  org.gephi.graph.api.Column[] columnsToMerge,
                                                  String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the third quartile (Q3) of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

thirdQuartileNumberMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

interQuartileRangeNumberMerge

public org.gephi.graph.api.Column interQuartileRangeNumberMerge(org.gephi.graph.api.Table table,
                                                       org.gephi.graph.api.Column[] columnsToMerge,
                                                       String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the interquartile range (IQR) of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

interQuartileRangeNumberMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

sumNumbersMerge

public org.gephi.graph.api.Column sumNumbersMerge(org.gephi.graph.api.Table table,
                                         org.gephi.graph.api.Column[] columnsToMerge,
                                         String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the sum of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

sumNumbersMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

minValueNumbersMerge

public org.gephi.graph.api.Column minValueNumbersMerge(org.gephi.graph.api.Table table,
                                              org.gephi.graph.api.Column[] columnsToMerge,
                                              String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the minimum value of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

minValueNumbersMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

maxValueNumbersMerge

public org.gephi.graph.api.Column maxValueNumbersMerge(org.gephi.graph.api.Table table,
                                              org.gephi.graph.api.Column[] columnsToMerge,
                                              String newColumnTitle)

Description copied from interface: AttributeColumnsMergeStrategiesController

Merges any combination of number or number list columns, calculating the maximum value of all not null values and puts the result of each row in a new column of BIGDECIMAL AttributeType.

Specified by:

maxValueNumbersMerge in interface AttributeColumnsMergeStrategiesController

Parameters:

table - Table of the columns to merge

columnsToMerge - Number or number list columns

newColumnTitle - Title for the new column

Returns:

The new created column

getTimeIntervalColumn

private org.gephi.graph.api.Column getTimeIntervalColumn(org.gephi.graph.api.Table table)

Private methods:

parseDouble

private double parseDouble(String number,
                 double defaultValue)

parseDateToDouble

private double parseDateToDouble(SimpleDateFormat dateFormat,
                       String date,
                       double defaultValue)

checkTableAndOneColumn

private void checkTableAndOneColumn(org.gephi.graph.api.Table table,
                          org.gephi.graph.api.Column startColumn,
                          org.gephi.graph.api.Column endColumn)

checkTableAndColumnsAreNumberOrNumberList

private void checkTableAndColumnsAreNumberOrNumberList(org.gephi.graph.api.Table table,
                                             org.gephi.graph.api.Column[] columns)

checkColumnsAreNumberOrNumberList

private void checkColumnsAreNumberOrNumberList(org.gephi.graph.api.Column[] columns)