Package adams.flow.sink
Class XChartFileWriter
-
- All Implemented Interfaces:
AdditionalInformationHandler,CleanUpHandler,Destroyable,GlobalInfoSupporter,FileWriter,LoggingLevelHandler,LoggingSupporter,OptionHandler,QuickInfoSupporter,ShallowCopySupporter<Actor>,SizeOfHandler,Stoppable,StoppableWithFeedback,VariablesInspectionHandler,VariableChangeListener,Actor,ErrorHandler,InputConsumer,Serializable,Comparable
public class XChartFileWriter extends AbstractFileWriter
Generates an XChart plot and writes the bitmap to a file.
Dataset generation is skipped if the incoming data already represents a XChart dataset.
Input/output:
- accepts:
adams.data.spreadsheet.SpreadSheet
adams.gui.visualization.xchart.dataset.Datasets
-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel) The logging level for outputting errors and debugging output. default: WARNING min-user-mode: Expert
-name <java.lang.String> (property: name) The name of the actor. default: XChartFileWriter
-annotation <adams.core.base.BaseAnnotation> (property: annotations) The annotations to attach to this actor. default:
-skip <boolean> (property: skip) If set to true, transformation is skipped and the input token is just forwarded as it is. default: false
-stop-flow-on-error <boolean> (property: stopFlowOnError) If set to true, the flow execution at this level gets stopped in case this actor encounters an error; the error gets propagated; useful for critical actors. default: false min-user-mode: Expert
-silent <boolean> (property: silent) If enabled, then no errors are output in the console; Note: the enclosing actor handler must have this enabled as well. default: false min-user-mode: Expert
-output <adams.core.io.PlaceholderFile> (property: outputFile) The file to write the plot to default: ${CWD}-dataset <adams.gui.visualization.xchart.dataset.AbstractDatasetGenerator> (property: dataset) The dataset generator to use. default: adams.gui.visualization.xchart.dataset.XYDatasetGenerator
-chart <adams.gui.visualization.xchart.chart.AbstractChartGenerator> (property: chart) The chart generator to use. default: adams.gui.visualization.xchart.chart.XYLineChart -color-provider adams.gui.visualization.core.DefaultColorProvider
-marker <adams.gui.visualization.xchart.marker.AbstractMarkerGenerator> (property: marker) The marker generator to use for the data point markers for XY charts. default: adams.gui.visualization.xchart.marker.Default
-width <int> (property: width) The width of the plot. default: 800 minimum: -1
-height <int> (property: height) The height of the plot. default: 600 minimum: -1
-watermark <adams.gui.visualization.watermark.Watermark> (property: watermark) The watermark to use for painting the data. default: adams.gui.visualization.watermark.Default
-writer <adams.data.io.output.ImageWriter> (property: writer) The image writer to use. default: adams.data.io.output.JAIImageWriter
- Author:
- FracPete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected AbstractChartGeneratorm_Chartthe chart generator.protected AbstractDatasetGeneratorm_Datasetthe dataset generator.protected intm_Heightthe height of the plot.protected AbstractMarkerGeneratorm_Markerthe marker generator.protected Watermarkm_Watermarkthe watermark to use.protected intm_Widththe width of the plot.protected ImageWriterm_Writerthe image writer to use.-
Fields inherited from class adams.flow.sink.AbstractFileWriter
m_OutputFile
-
Fields inherited from class adams.flow.sink.AbstractSink
BACKUP_INPUT, m_InputToken
-
Fields inherited from class adams.flow.core.AbstractActor
m_Annotations, m_BackupState, m_DetectedObjectVariables, m_DetectedVariables, m_ErrorHandler, m_Executed, m_Executing, m_ExecutionListeningSupporter, m_FullName, m_LoggingPrefix, m_Name, m_Parent, m_ScopeHandler, m_Self, m_Silent, m_Skip, m_StopFlowOnError, m_StopMessage, m_Stopped, m_StorageHandler, m_VariablesUpdated
-
Fields inherited from class adams.core.option.AbstractOptionHandler
m_OptionManager
-
Fields inherited from class adams.core.logging.LoggingObject
m_Logger, m_LoggingIsEnabled, m_LoggingLevel
-
Fields inherited from interface adams.flow.core.Actor
FILE_EXTENSION, FILE_EXTENSION_GZ
-
-
Constructor Summary
Constructors Constructor Description XChartFileWriter()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Class[]accepts()Returns the class that the consumer accepts.StringchartTipText()Returns the tip text for this property.StringdatasetTipText()Returns the tip text for this property.voiddefineOptions()Adds options to the internal list of options.protected StringdoExecute()Executes the flow item.AbstractChartGeneratorgetChart()Returns the chart generator.AbstractDatasetGeneratorgetDataset()Returns the dataset generator.intgetHeight()Returns the currently set height of the plot.AbstractMarkerGeneratorgetMarker()Returns the marker generator for XY charts.StringgetQuickInfo()Returns a quick info about the actor, which will be displayed in the GUI.WatermarkgetWatermark()Returns the watermark to use.intgetWidth()Returns the currently set width of the plot.ImageWritergetWriter()Returns the image writer.StringglobalInfo()Returns a string describing the object.StringheightTipText()Returns the tip text for this property.StringmarkerTipText()Returns the tip text for this property.StringoutputFileTipText()Returns the tip text for this property.voidsetChart(AbstractChartGenerator value)Sets the chart generator.voidsetDataset(AbstractDatasetGenerator value)Sets the dataset generator.voidsetHeight(int value)Sets the height of the plot.voidsetMarker(AbstractMarkerGenerator value)Sets the marker generator for XY charts.voidsetWatermark(Watermark value)Sets the watermark to use.voidsetWidth(int value)Sets the width of the plot.voidsetWriter(ImageWriter value)Sets the image writer.StringwatermarkTipText()Returns the tip text for this property.StringwidthTipText()Returns the tip text for this property.StringwriterTipText()Returns the tip text for this property.-
Methods inherited from class adams.flow.sink.AbstractFileWriter
getDefaultOutputFile, getOutputFile, setOutputFile, setUp
-
Methods inherited from class adams.flow.sink.AbstractSink
backupState, currentInput, hasInput, input, postExecute, restoreState, wrapUp
-
Methods inherited from class adams.flow.core.AbstractActor
annotationsTipText, canInspectOptions, canPerformSetUpCheck, cleanUp, compareTo, configureLogger, destroy, equals, execute, finalUpdateVariables, findVariables, findVariables, forceVariables, forCommandLine, forName, forName, getAdditionalInformation, getAnnotations, getDefaultName, getDetectedVariables, getErrorHandler, getFlowActors, getFlowExecutionListeningSupporter, getFullName, getName, getNextSibling, getParent, getParentComponent, getPreviousSibling, getRoot, getScopeHandler, getSilent, getSkip, getStopFlowOnError, getStopMessage, getStorageHandler, getVariables, handleError, handleException, hasErrorHandler, hasStopMessage, index, initialize, isBackedUp, isExecuted, isExecuting, isFinished, isHeadless, isStopped, nameTipText, performSetUpChecks, performVariableChecks, preExecute, pruneBackup, pruneBackup, reset, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setVariables, shallowCopy, shallowCopy, silentTipText, sizeOf, skipTipText, stopExecution, stopExecution, stopFlowOnErrorTipText, updateDetectedVariables, updatePrefix, updateVariables, variableChanged
-
Methods inherited from class adams.core.option.AbstractOptionHandler
cleanUpOptions, finishInit, getDefaultLoggingLevel, getOptionManager, loggingLevelTipText, newOptionManager, setLoggingLevel, toCommandLine, toString
-
Methods inherited from class adams.core.logging.LoggingObject
getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface adams.flow.core.Actor
cleanUp, compareTo, destroy, equals, execute, findVariables, getAnnotations, getDefaultName, getDetectedVariables, getErrorHandler, getFlowExecutionListeningSupporter, getFullName, getName, getNextSibling, getParent, getParentComponent, getPreviousSibling, getRoot, getScopeHandler, getSilent, getSkip, getStopFlowOnError, getStopMessage, getStorageHandler, getVariables, handleError, hasErrorHandler, hasStopMessage, index, isExecuted, isFinished, isHeadless, isStopped, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setVariables, shallowCopy, shallowCopy, sizeOf, stopExecution, stopExecution, toCommandLine, variableChanged
-
Methods inherited from interface adams.core.AdditionalInformationHandler
getAdditionalInformation
-
Methods inherited from interface adams.core.logging.LoggingLevelHandler
getLoggingLevel, setLoggingLevel
-
Methods inherited from interface adams.core.logging.LoggingSupporter
getLogger, isLoggingEnabled
-
Methods inherited from interface adams.core.option.OptionHandler
cleanUpOptions, getOptionManager
-
Methods inherited from interface adams.core.VariablesInspectionHandler
canInspectOptions
-
-
-
-
Field Detail
-
m_Dataset
protected AbstractDatasetGenerator m_Dataset
the dataset generator.
-
m_Chart
protected AbstractChartGenerator m_Chart
the chart generator.
-
m_Marker
protected AbstractMarkerGenerator m_Marker
the marker generator.
-
m_Width
protected int m_Width
the width of the plot.
-
m_Height
protected int m_Height
the height of the plot.
-
m_Watermark
protected Watermark m_Watermark
the watermark to use.
-
m_Writer
protected ImageWriter m_Writer
the image writer to use.
-
-
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 classAbstractFileWriter
-
outputFileTipText
public String outputFileTipText()
Returns the tip text for this property.- Specified by:
outputFileTipTextin interfaceFileWriter- Specified by:
outputFileTipTextin classAbstractFileWriter- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setDataset
public void setDataset(AbstractDatasetGenerator value)
Sets the dataset generator.- Parameters:
value- the generator
-
getDataset
public AbstractDatasetGenerator getDataset()
Returns the dataset generator.- Returns:
- the generator
-
datasetTipText
public String datasetTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setChart
public void setChart(AbstractChartGenerator value)
Sets the chart generator.- Parameters:
value- the generator
-
getChart
public AbstractChartGenerator getChart()
Returns the chart generator.- Returns:
- the generator
-
chartTipText
public String chartTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setMarker
public void setMarker(AbstractMarkerGenerator value)
Sets the marker generator for XY charts.- Parameters:
value- the generator
-
getMarker
public AbstractMarkerGenerator getMarker()
Returns the marker generator for XY charts.- Returns:
- the generator
-
markerTipText
public String markerTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setWidth
public void setWidth(int value)
Sets the width of the plot.- Parameters:
value- the width
-
getWidth
public int getWidth()
Returns the currently set width of the plot.- Returns:
- the width
-
widthTipText
public String widthTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setHeight
public void setHeight(int value)
Sets the height of the plot.- Parameters:
value- the height
-
getHeight
public int getHeight()
Returns the currently set height of the plot.- Returns:
- the height
-
heightTipText
public String heightTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setWatermark
public void setWatermark(Watermark value)
Sets the watermark to use.- Parameters:
value- the watermark
-
getWatermark
public Watermark getWatermark()
Returns the watermark to use.- Returns:
- the watermark
-
watermarkTipText
public String watermarkTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setWriter
public void setWriter(ImageWriter value)
Sets the image writer.- Parameters:
value- the writer
-
getWriter
public ImageWriter getWriter()
Returns the image writer.- Returns:
- the writer
-
writerTipText
public String writerTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
accepts
public Class[] accepts()
Returns the class that the consumer accepts.- Returns:
- the Class of objects that can be processed
-
getQuickInfo
public String getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.- Specified by:
getQuickInfoin interfaceActor- Specified by:
getQuickInfoin interfaceQuickInfoSupporter- Overrides:
getQuickInfoin classAbstractFileWriter- Returns:
- null if no info available, otherwise short string
-
doExecute
protected String doExecute()
Executes the flow item.- Specified by:
doExecutein classAbstractActor- Returns:
- null if everything is fine, otherwise error message
-
-