Class RowWisePlotGenerator
- java.lang.Object
-
- adams.core.logging.LoggingObject
-
- adams.core.logging.CustomLoggingLevelObject
-
- adams.core.option.AbstractOptionHandler
-
- adams.flow.transformer.plotgenerator.AbstractPlotGenerator
-
- adams.flow.transformer.plotgenerator.RowWisePlotGenerator
-
- All Implemented Interfaces:
Destroyable
,GlobalInfoSupporter
,LoggingLevelHandler
,LoggingSupporter
,OptionHandler
,QuickInfoSupporter
,SizeOfHandler
,Serializable
public class RowWisePlotGenerator extends AbstractPlotGenerator
Generates a separate plot per row in the spreadsheet, using the specified columns as data points. Additional meta-data columns can be specified as well. The optional ID column can be used to name the row plots.
-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel) The logging level for outputting errors and debugging output. default: WARNING
-default-cell-value <double> (property: defaultCellValue) The default value for missing or non-numeric cells. default: -1.0
-plot-name-range <java.lang.String> (property: plotNameRange) The range of columns to use for generating the plot name (overrides any plot generator specific names); A range is a comma-separated list of single 1-based indices or sub-ranges of indices ('start-end'); 'inv(...)' inverts the range '...'; column names (case-sensitive) as well as the following placeholders can be used: first, second, third, last_2, last_1, last default:
-plot-name-separator <java.lang.String> (property: plotNameSeparator) The separator to use when constructing the plot name from cell values. default:
-id-column <java.lang.String> (property: IDColumn) The (optional) column to use for naming the row plot; 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 default:
-data-columns <java.lang.String> (property: dataColumns) The range of columns to include in the plot; A range is a comma-separated list of single 1-based indices or sub-ranges of indices ('start-end'); ' inv(...)' inverts the range '...'; column names (case-sensitive) as well as the following placeholders can be used: first, second, third, last_2, last_1, last default:
-meta-data-columns <java.lang.String> (property: metaDataColumns) The range of columns to add as meta-data in the plot; A range is a comma-separated list of single 1-based indices or sub-ranges of indices ('start-end'); ' inv(...)' inverts the range '...'; column names (case-sensitive) as well as the following placeholders can be used: first, second, third, last_2, last_1, last default:
-add-column-name <boolean> (property: addColumnName) If enabled, the column name gets added to the meta-data. default: false
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected boolean
m_AddColumnName
whether to add the column name as meta-data.protected SpreadSheetColumnRange
m_DataColumns
the columns to plot.protected SpreadSheetColumnIndex
m_IDColumn
the (optional) column that identifies a row, uses as plot name.protected SpreadSheetColumnRange
m_MetaDataColumns
the meta-data columns.-
Fields inherited from class adams.flow.transformer.plotgenerator.AbstractPlotGenerator
m_DefaultCellValue, m_PlotNameRange, m_PlotNameSeparator, MISSING_CELL_VALUE
-
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 RowWisePlotGenerator()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description String
addColumnNameTipText()
Returns the tip text for this property.protected void
check(SpreadSheet sheet)
Checks the spreadsheet.String
dataColumnsTipText()
Returns the tip text for this property.void
defineOptions()
Adds options to the internal list of options.protected List<SequencePlotterContainer>
doGenerate(SpreadSheet sheet)
Performs the actual generation of containers.boolean
getAddColumnName()
Returns whether to add the column name to the meta-data.String
getDataColumns()
Returns the current column range to use in the plot.String
getIDColumn()
Returns the (optional) column to use for naming the row plots.String
getMetaDataColumns()
Returns the current column range to add as meta-data in the plot.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
IDColumnTipText()
Returns the tip text for this property.protected void
initialize()
Initializes the members.String
metaDataColumnsTipText()
Returns the tip text for this property.void
setAddColumnName(boolean value)
Sets whether to add the column name to the meta-data.void
setDataColumns(String value)
Sets the column range to use in the plot.void
setIDColumn(String value)
Sets the (optional) column to use for naming the row plots.void
setMetaDataColumns(String value)
Sets the column range to add as meta-data in the plot.-
Methods inherited from class adams.flow.transformer.plotgenerator.AbstractPlotGenerator
defaultCellValueTipText, generate, getActualPlotName, getCellObject, getCellString, getCellValue, getCellValue, getDefaultCellValue, getPlotNameRange, getPlotNameSeparator, plotNameRangeTipText, plotNameSeparatorTipText, setDefaultCellValue, setPlotNameRange, setPlotNameSeparator
-
Methods inherited from class adams.core.option.AbstractOptionHandler
cleanUpOptions, destroy, finishInit, getDefaultLoggingLevel, getOptionManager, 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_IDColumn
protected SpreadSheetColumnIndex m_IDColumn
the (optional) column that identifies a row, uses as plot name.
-
m_DataColumns
protected SpreadSheetColumnRange m_DataColumns
the columns to plot.
-
m_MetaDataColumns
protected SpreadSheetColumnRange m_MetaDataColumns
the meta-data columns.
-
m_AddColumnName
protected boolean m_AddColumnName
whether to add the column name as meta-data.
-
-
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 classAbstractPlotGenerator
-
initialize
protected void initialize()
Initializes the members.- Overrides:
initialize
in classAbstractPlotGenerator
-
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 classAbstractPlotGenerator
- Returns:
- null if no info available, otherwise short string
-
setIDColumn
public void setIDColumn(String value)
Sets the (optional) column to use for naming the row plots.- Parameters:
value
- the column
-
getIDColumn
public String getIDColumn()
Returns the (optional) column to use for naming the row plots.- Returns:
- the column
-
IDColumnTipText
public String IDColumnTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setDataColumns
public void setDataColumns(String value)
Sets the column range to use in the plot.- Parameters:
value
- the column range
-
getDataColumns
public String getDataColumns()
Returns the current column range to use in the plot.- Returns:
- the column range
-
dataColumnsTipText
public String dataColumnsTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setMetaDataColumns
public void setMetaDataColumns(String value)
Sets the column range to add as meta-data in the plot.- Parameters:
value
- the column range
-
getMetaDataColumns
public String getMetaDataColumns()
Returns the current column range to add as meta-data in the plot.- Returns:
- the column range
-
metaDataColumnsTipText
public String metaDataColumnsTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setAddColumnName
public void setAddColumnName(boolean value)
Sets whether to add the column name to the meta-data.- Parameters:
value
- true if to add column name
-
getAddColumnName
public boolean getAddColumnName()
Returns whether to add the column name to the meta-data.- Returns:
- true if to add column name
-
addColumnNameTipText
public String addColumnNameTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
check
protected void check(SpreadSheet sheet)
Checks the spreadsheet.- Overrides:
check
in classAbstractPlotGenerator
- Parameters:
sheet
- the sheet to check
-
doGenerate
protected List<SequencePlotterContainer> doGenerate(SpreadSheet sheet)
Performs the actual generation of containers.- Specified by:
doGenerate
in classAbstractPlotGenerator
- Parameters:
sheet
- the basis for the containers- Returns:
- the generated containers
-
-