Class CommonIDs
- java.lang.Object
-
- adams.core.logging.LoggingObject
-
- adams.core.logging.CustomLoggingLevelObject
-
- adams.core.option.AbstractOptionHandler
-
- adams.flow.transformer.multispreadsheetoperation.AbstractMultiSpreadSheetOperation<SpreadSheet>
-
- adams.flow.transformer.multispreadsheetoperation.CommonIDs
-
- All Implemented Interfaces:
Destroyable
,GlobalInfoSupporter
,LoggingLevelHandler
,LoggingSupporter
,OptionHandler
,QuickInfoSupporter
,SizeOfHandler
,Serializable
public class CommonIDs extends AbstractMultiSpreadSheetOperation<SpreadSheet>
Extracts the common IDs from two or more spreadsheets.
Matching sense can be inverted, i.e., the IDs not in common are output.
-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel) The logging level for outputting errors and debugging output. default: WARNING
-index <adams.data.spreadsheet.SpreadSheetColumnIndex> (property: index) The index of the column with the IDs in the spreadsheet. default: first example: An index is a number starting with 1; column names (case-sensitive) as well as the following placeholders can be used: first, second, third, last_2, last_1, last; numeric indices can be enforced by preceding them with '#' (eg '#12'); column names can be surrounded by double quotes.
-invert <boolean> (property: invert) Whether to invert the matching sense and return the IDs 'not' in common. default: false
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected SpreadSheetColumnIndex
m_Index
the column in the spreadsheet.protected boolean
m_Invert
whether to invert the matching (= return the IDs not in common).-
Fields inherited from class adams.core.option.AbstractOptionHandler
m_OptionManager
-
Fields inherited from class adams.core.logging.LoggingObject
m_Logger, m_LoggingIsEnabled, m_LoggingLevel
-
-
Constructor Summary
Constructors Constructor Description CommonIDs()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
defineOptions()
Adds options to the internal list of options.protected SpreadSheet
doProcess(SpreadSheet[] sheets, MessageCollection errors)
Performs the actual processing of the sheets.Class
generates()
Returns the class of objects that it generates.SpreadSheetColumnIndex
getIndex()
Returns the index of the column in the spreadsheet.boolean
getInvert()
Returns whether to invert the matchin, i.e., return IDs not in common.String
getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.String
globalInfo()
Returns a string describing the object.String
indexTipText()
Returns the tip text for this property.String
invertTipText()
Returns the tip text for this property.int
maxNumSheetsRequired()
Returns the maximum number of sheets that are required for the operation.int
minNumSheetsRequired()
Returns the minimum number of sheets that are required for the operation.void
setIndex(SpreadSheetColumnIndex value)
Sets the index of the column in the spreadsheet.void
setInvert(boolean value)
Sets whether to invert the matchin, i.e., return IDs not in common.-
Methods inherited from class adams.flow.transformer.multispreadsheetoperation.AbstractMultiSpreadSheetOperation
check, process
-
Methods inherited from class adams.core.option.AbstractOptionHandler
cleanUpOptions, destroy, finishInit, getDefaultLoggingLevel, getOptionManager, initialize, loggingLevelTipText, newOptionManager, reset, setLoggingLevel, toCommandLine, toString
-
Methods inherited from class adams.core.logging.LoggingObject
configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface adams.core.logging.LoggingLevelHandler
getLoggingLevel
-
-
-
-
Field Detail
-
m_Index
protected SpreadSheetColumnIndex m_Index
the column in the spreadsheet.
-
m_Invert
protected boolean m_Invert
whether to invert the matching (= return the IDs not in common).
-
-
Method Detail
-
globalInfo
public String globalInfo()
Returns a string describing the object.- Specified by:
globalInfo
in interfaceGlobalInfoSupporter
- Specified by:
globalInfo
in classAbstractOptionHandler
- Returns:
- a description suitable for displaying in the gui
-
defineOptions
public void defineOptions()
Adds options to the internal list of options.- Specified by:
defineOptions
in interfaceOptionHandler
- Overrides:
defineOptions
in classAbstractOptionHandler
-
setIndex
public void setIndex(SpreadSheetColumnIndex value)
Sets the index of the column in the spreadsheet.- Parameters:
value
- the index
-
getIndex
public SpreadSheetColumnIndex getIndex()
Returns the index of the column in the spreadsheet.- Returns:
- the index
-
indexTipText
public String indexTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setInvert
public void setInvert(boolean value)
Sets whether to invert the matchin, i.e., return IDs not in common.- Parameters:
value
- true if to invert matching
-
getInvert
public boolean getInvert()
Returns whether to invert the matchin, i.e., return IDs not in common.- Returns:
- true if to invert matching
-
invertTipText
public String invertTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
getQuickInfo
public String getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.- Specified by:
getQuickInfo
in interfaceQuickInfoSupporter
- Overrides:
getQuickInfo
in classAbstractMultiSpreadSheetOperation<SpreadSheet>
- Returns:
- null if no info available, otherwise short string
-
minNumSheetsRequired
public int minNumSheetsRequired()
Returns the minimum number of sheets that are required for the operation.- Specified by:
minNumSheetsRequired
in classAbstractMultiSpreadSheetOperation<SpreadSheet>
- Returns:
- the number of sheets that are required, <= 0 means no lower limit
-
maxNumSheetsRequired
public int maxNumSheetsRequired()
Returns the maximum number of sheets that are required for the operation.- Specified by:
maxNumSheetsRequired
in classAbstractMultiSpreadSheetOperation<SpreadSheet>
- Returns:
- the number of sheets that are required, <= 0 means no upper limit
-
generates
public Class generates()
Returns the class of objects that it generates.- Specified by:
generates
in classAbstractMultiSpreadSheetOperation<SpreadSheet>
- Returns:
- the Class of the generated tokens
-
doProcess
protected SpreadSheet doProcess(SpreadSheet[] sheets, MessageCollection errors)
Performs the actual processing of the sheets.- Specified by:
doProcess
in classAbstractMultiSpreadSheetOperation<SpreadSheet>
- Parameters:
sheets
- the containers to processerrors
- for collecting errors- Returns:
- the generated data
-
-