Package adams.flow.sink
Class WekaFileWriter
- java.lang.Object
-
- adams.core.logging.LoggingObject
-
- adams.core.logging.CustomLoggingLevelObject
-
- adams.core.option.AbstractOptionHandler
-
- adams.flow.core.AbstractActor
-
- adams.flow.sink.AbstractSink
-
- adams.flow.sink.AbstractFileWriter
-
- adams.flow.sink.WekaFileWriter
-
- All Implemented Interfaces:
adams.core.AdditionalInformationHandler
,adams.core.CleanUpHandler
,adams.core.Destroyable
,adams.core.GlobalInfoSupporter
,adams.core.io.FileWriter
,adams.core.logging.LoggingLevelHandler
,adams.core.logging.LoggingSupporter
,adams.core.option.OptionHandler
,adams.core.QuickInfoSupporter
,adams.core.ShallowCopySupporter<adams.flow.core.Actor>
,adams.core.SizeOfHandler
,adams.core.Stoppable
,adams.core.StoppableWithFeedback
,adams.core.VariablesInspectionHandler
,adams.event.VariableChangeListener
,adams.flow.core.Actor
,adams.flow.core.ErrorHandler
,adams.flow.core.InputConsumer
,Serializable
,Comparable
public class WekaFileWriter extends adams.flow.sink.AbstractFileWriter
Actor for saving a weka.core.Instances object as file.
The relation name of the incoming dataset can be used to replace the current filename (path and extension are kept). If the filename points to a directory, the relation name is simply appended.
Input/output:
- accepts:
weka.core.Instances
-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel) The logging level for outputting errors and debugging output. default: WARNING
-name <java.lang.String> (property: name) The name of the actor. default: WekaFileWriter
-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
-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
-output <adams.core.io.PlaceholderFile> (property: outputFile) The filename of the dataset to write (the file extension determines the file format). default: ${CWD}
-use-relation <boolean> (property: useRelationNameAsFilename) If set to true, then the relation name replaces the name of the output file; eg if the output file is '/some/where/file.arff' and the relation is 'anneal' then the resulting file name will be '/some/where/anneal.arff'; if the file points to a directory, then the relation name is simple appended. default: false
-use-custom <boolean> (property: useCustomSaver) If set to true, then the custom saver will be used for saving the data. default: false
-saver <weka.core.converters.AbstractFileSaver> (property: customSaver) The custom saver to use if enabled. default: weka.core.converters.SimpleArffSaver -decimal 6
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected weka.core.converters.AbstractFileSaver
m_CustomSaver
the custom saver.protected boolean
m_UseCustomSaver
whether to use a custom converter.protected boolean
m_UseRelationNameAsFilename
whether to use the relation name as filename.-
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
-
-
Constructor Summary
Constructors Constructor Description WekaFileWriter()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Class[]
accepts()
Returns the class that the consumer accepts.String
customSaverTipText()
Returns the tip text for this property.void
defineOptions()
Adds options to the internal list of options.protected String
doExecute()
Executes the flow item.weka.core.converters.AbstractFileSaver
getCustomSaver()
Returns the custom saver in use.String
getQuickInfo()
Returns a quick info about the actor, which will be displayed in the GUI.boolean
getUseCustomSaver()
Returns whether a custom saver is used or not.boolean
getUseRelationNameAsFilename()
Returns whether the relation name is used as filename.String
globalInfo()
Returns a string describing the object.String
outputFileTipText()
Returns the tip text for this property.protected String
performSetUpChecks(boolean fromSetUp)
Hook for performing setup checks -- used in setUp() and preExecute().void
setCustomSaver(weka.core.converters.AbstractFileSaver value)
Sets the custom saver to use.void
setUseCustomSaver(boolean value)
Sets whether to use a custom saver or not.void
setUseRelationNameAsFilename(boolean value)
Sets whether to use the relation name as filename instead.String
useCustomSaverTipText()
Returns the tip text for this property.String
useRelationNameAsFilenameTipText()
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, 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
-
-
-
-
Field Detail
-
m_UseRelationNameAsFilename
protected boolean m_UseRelationNameAsFilename
whether to use the relation name as filename.
-
m_UseCustomSaver
protected boolean m_UseCustomSaver
whether to use a custom converter.
-
m_CustomSaver
protected weka.core.converters.AbstractFileSaver m_CustomSaver
the custom saver.
-
-
Method Detail
-
globalInfo
public String globalInfo()
Returns a string describing the object.- Specified by:
globalInfo
in interfaceadams.core.GlobalInfoSupporter
- Specified by:
globalInfo
in classadams.core.option.AbstractOptionHandler
- 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 interfaceadams.core.option.OptionHandler
- Overrides:
defineOptions
in classadams.flow.sink.AbstractFileWriter
-
outputFileTipText
public String outputFileTipText()
Returns the tip text for this property.- Specified by:
outputFileTipText
in interfaceadams.core.io.FileWriter
- Specified by:
outputFileTipText
in classadams.flow.sink.AbstractFileWriter
- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setUseRelationNameAsFilename
public void setUseRelationNameAsFilename(boolean value)
Sets whether to use the relation name as filename instead.- Parameters:
value
- if true then the relation name will be used
-
getUseRelationNameAsFilename
public boolean getUseRelationNameAsFilename()
Returns whether the relation name is used as filename.- Returns:
- true if the relation name is used
-
useRelationNameAsFilenameTipText
public String useRelationNameAsFilenameTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setUseCustomSaver
public void setUseCustomSaver(boolean value)
Sets whether to use a custom saver or not.- Parameters:
value
- if true then the custom saver will be used
-
getUseCustomSaver
public boolean getUseCustomSaver()
Returns whether a custom saver is used or not.- Returns:
- true if a custom saver is used
-
useCustomSaverTipText
public String useCustomSaverTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setCustomSaver
public void setCustomSaver(weka.core.converters.AbstractFileSaver value)
Sets the custom saver to use.- Parameters:
value
- the custom saver
-
getCustomSaver
public weka.core.converters.AbstractFileSaver getCustomSaver()
Returns the custom saver in use.- Returns:
- the custom saver
-
customSaverTipText
public String customSaverTipText()
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 interfaceadams.flow.core.Actor
- Specified by:
getQuickInfo
in interfaceadams.core.QuickInfoSupporter
- Overrides:
getQuickInfo
in classadams.flow.sink.AbstractFileWriter
- Returns:
- null if no info available, otherwise short string
-
accepts
public Class[] accepts()
Returns the class that the consumer accepts.- Returns:
- weka.core.Instances.class
-
performSetUpChecks
protected String performSetUpChecks(boolean fromSetUp)
Hook for performing setup checks -- used in setUp() and preExecute().- Overrides:
performSetUpChecks
in classadams.flow.core.AbstractActor
- Parameters:
fromSetUp
- whether the method has been called from within setUp()- Returns:
- null if everything OK, otherwise error message
-
doExecute
protected String doExecute()
Executes the flow item.- Specified by:
doExecute
in classadams.flow.core.AbstractActor
- Returns:
- null if everything is fine, otherwise error message
-
-