Class XYWithErrorsPlotGenerator
- java.lang.Object
-
- adams.core.logging.LoggingObject
-
- adams.core.logging.CustomLoggingLevelObject
-
- adams.core.option.AbstractOptionHandler
-
- adams.flow.transformer.plotgenerator.AbstractPlotGenerator
-
- adams.flow.transformer.plotgenerator.XYWithErrorsPlotGenerator
-
- All Implemented Interfaces:
Destroyable,GlobalInfoSupporter,LoggingLevelHandler,LoggingSupporter,OptionHandler,QuickInfoSupporter,SizeOfHandler,Serializable
public class XYWithErrorsPlotGenerator extends AbstractPlotGenerator
Generator for X/Y plots (with X optional) that attaches error information for Y and optionally X as well. If only one error column is defined, this is interpreted as 'error-delta'; providing two columns is interpreted as 'low' and 'high'.
-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:
-y-column <adams.data.spreadsheet.SpreadSheetColumnIndex> (property: YColumn) The column to use for Y; 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: 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
-x-column <adams.data.spreadsheet.SpreadSheetColumnIndex> (property: XColumn) The (optional) index of the column which values to use as X values in the 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: 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
-y-error-columns <adams.data.spreadsheet.SpreadSheetColumnRange> (property: YErrorColumns) The range of columns to use for Y error information (1=delta, 2=low/high ); 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: example: 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-x-error-columns <adams.data.spreadsheet.SpreadSheetColumnRange> (property: XErrorColumns) The (optional) range of columns to use for X error information (1=delta, 2=low/high); 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: example: 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-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:- Version:
- $Revision$
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected SpreadSheetColumnRangem_MetaDataColumnsthe meta-data columns.protected SpreadSheetColumnIndexm_XColumnthe column to use as X value (optional).protected SpreadSheetColumnRangem_XErrorColumnsthe columns to use as X error, 1=delta, 2=low/high (optional).protected SpreadSheetColumnIndexm_YColumnthe column to use as Y value.protected SpreadSheetColumnRangem_YErrorColumnsthe columns to use as Y error, 1=delta, 2=low/high.-
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 XYWithErrorsPlotGenerator()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected voidcheck(SpreadSheet sheet)Checks the spreadsheet.voiddefineOptions()Adds options to the internal list of options.protected List<SequencePlotterContainer>doGenerate(SpreadSheet sheet)Performs the actual generation of containers.StringgetMetaDataColumns()Returns the current column range to add as meta-data in the plot.StringgetQuickInfo()Returns a quick info about the actor, which will be displayed in the GUI.SpreadSheetColumnIndexgetXColumn()Returns the index of the column which values to use as X values.SpreadSheetColumnRangegetXErrorColumns()Returns the column range to use for X error information (1=delta, 2=low/high).SpreadSheetColumnIndexgetYColumn()Returns the y column to use in the plot.SpreadSheetColumnRangegetYErrorColumns()Returns the column range to use for Y error information (1=delta, 2=low/high).StringglobalInfo()Returns a string describing the object.protected voidinitialize()Initializes the members.StringmetaDataColumnsTipText()Returns the tip text for this property.voidsetMetaDataColumns(String value)Sets the column range to add as meta-data in the plot.voidsetXColumn(SpreadSheetColumnIndex value)Sets the index of the column which values to use as X values.voidsetXErrorColumns(SpreadSheetColumnRange value)Sets the column range to use for X error information (1=delta, 2=low/high).voidsetYColumn(SpreadSheetColumnIndex value)Sets the y column to use in the plot.voidsetYErrorColumns(SpreadSheetColumnRange value)Sets the column range to use for Y error information (1=delta, 2=low/high).StringXColumnTipText()Returns the tip text for this property.StringXErrorColumnsTipText()Returns the tip text for this property.StringYColumnTipText()Returns the tip text for this property.StringYErrorColumnsTipText()Returns the tip text for this property.-
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_YColumn
protected SpreadSheetColumnIndex m_YColumn
the column to use as Y value.
-
m_XColumn
protected SpreadSheetColumnIndex m_XColumn
the column to use as X value (optional).
-
m_YErrorColumns
protected SpreadSheetColumnRange m_YErrorColumns
the columns to use as Y error, 1=delta, 2=low/high.
-
m_XErrorColumns
protected SpreadSheetColumnRange m_XErrorColumns
the columns to use as X error, 1=delta, 2=low/high (optional).
-
m_MetaDataColumns
protected SpreadSheetColumnRange m_MetaDataColumns
the meta-data columns.
-
-
Method Detail
-
globalInfo
public String globalInfo()
Returns a string describing the object.- Specified by:
globalInfoin interfaceGlobalInfoSupporter- Specified by:
globalInfoin classAbstractOptionHandler- Returns:
- a description suitable for displaying in the gui
-
defineOptions
public void defineOptions()
Adds options to the internal list of options.- Specified by:
defineOptionsin interfaceOptionHandler- Overrides:
defineOptionsin classAbstractPlotGenerator
-
initialize
protected void initialize()
Initializes the members.- Overrides:
initializein classAbstractPlotGenerator
-
getQuickInfo
public String getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.- Specified by:
getQuickInfoin interfaceQuickInfoSupporter- Overrides:
getQuickInfoin classAbstractPlotGenerator- Returns:
- null if no info available, otherwise short string
-
setYColumn
public void setYColumn(SpreadSheetColumnIndex value)
Sets the y column to use in the plot.- Parameters:
value- the column
-
getYColumn
public SpreadSheetColumnIndex getYColumn()
Returns the y column to use in the plot.- Returns:
- the column
-
YColumnTipText
public String YColumnTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setXColumn
public void setXColumn(SpreadSheetColumnIndex value)
Sets the index of the column which values to use as X values.- Parameters:
value- the column index
-
getXColumn
public SpreadSheetColumnIndex getXColumn()
Returns the index of the column which values to use as X values.- Returns:
- the column index
-
XColumnTipText
public String XColumnTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setYErrorColumns
public void setYErrorColumns(SpreadSheetColumnRange value)
Sets the column range to use for Y error information (1=delta, 2=low/high).- Parameters:
value- the column range
-
getYErrorColumns
public SpreadSheetColumnRange getYErrorColumns()
Returns the column range to use for Y error information (1=delta, 2=low/high).- Returns:
- the column range
-
YErrorColumnsTipText
public String YErrorColumnsTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setXErrorColumns
public void setXErrorColumns(SpreadSheetColumnRange value)
Sets the column range to use for X error information (1=delta, 2=low/high).- Parameters:
value- the column range
-
getXErrorColumns
public SpreadSheetColumnRange getXErrorColumns()
Returns the column range to use for X error information (1=delta, 2=low/high).- Returns:
- the column range
-
XErrorColumnsTipText
public String XErrorColumnsTipText()
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.
-
check
protected void check(SpreadSheet sheet)
Checks the spreadsheet.- Overrides:
checkin classAbstractPlotGenerator- Parameters:
sheet- the sheet to check
-
doGenerate
protected List<SequencePlotterContainer> doGenerate(SpreadSheet sheet)
Performs the actual generation of containers.- Specified by:
doGeneratein classAbstractPlotGenerator- Parameters:
sheet- the basis for the containers- Returns:
- the generated containers
-
-