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 SpreadSheetColumnRange
m_MetaDataColumns
the meta-data columns.protected SpreadSheetColumnIndex
m_XColumn
the column to use as X value (optional).protected SpreadSheetColumnRange
m_XErrorColumns
the columns to use as X error, 1=delta, 2=low/high (optional).protected SpreadSheetColumnIndex
m_YColumn
the column to use as Y value.protected SpreadSheetColumnRange
m_YErrorColumns
the 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 void
check(SpreadSheet sheet)
Checks the spreadsheet.void
defineOptions()
Adds options to the internal list of options.protected List<SequencePlotterContainer>
doGenerate(SpreadSheet sheet)
Performs the actual generation of containers.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.SpreadSheetColumnIndex
getXColumn()
Returns the index of the column which values to use as X values.SpreadSheetColumnRange
getXErrorColumns()
Returns the column range to use for X error information (1=delta, 2=low/high).SpreadSheetColumnIndex
getYColumn()
Returns the y column to use in the plot.SpreadSheetColumnRange
getYErrorColumns()
Returns the column range to use for Y error information (1=delta, 2=low/high).String
globalInfo()
Returns a string describing the object.protected void
initialize()
Initializes the members.String
metaDataColumnsTipText()
Returns the tip text for this property.void
setMetaDataColumns(String value)
Sets the column range to add as meta-data in the plot.void
setXColumn(SpreadSheetColumnIndex value)
Sets the index of the column which values to use as X values.void
setXErrorColumns(SpreadSheetColumnRange value)
Sets the column range to use for X error information (1=delta, 2=low/high).void
setYColumn(SpreadSheetColumnIndex value)
Sets the y column to use in the plot.void
setYErrorColumns(SpreadSheetColumnRange value)
Sets the column range to use for Y error information (1=delta, 2=low/high).String
XColumnTipText()
Returns the tip text for this property.String
XErrorColumnsTipText()
Returns the tip text for this property.String
YColumnTipText()
Returns the tip text for this property.String
YErrorColumnsTipText()
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:
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
-
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:
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
-
-