Package adams.data.heatmapfeatures
Class Scripted
- java.lang.Object
-
- adams.core.logging.LoggingObject
-
- adams.core.logging.CustomLoggingLevelObject
-
- adams.core.option.AbstractOptionHandler
-
- adams.data.heatmapfeatures.AbstractHeatmapFeatureGenerator
-
- adams.data.heatmapfeatures.AbstractScriptedFeatureGenerator
-
- adams.data.heatmapfeatures.Scripted
-
- All Implemented Interfaces:
adams.core.CleanUpHandler
,adams.core.Destroyable
,adams.core.GlobalInfoSupporter
,adams.core.logging.LoggingLevelHandler
,adams.core.logging.LoggingSupporter
,adams.core.option.OptionHandler
,adams.core.QuickInfoSupporter
,adams.core.scripting.FileBasedScripting
,adams.core.scripting.FileBasedScriptingWithOptions
,adams.core.ShallowCopySupporter<AbstractHeatmapFeatureGenerator>
,adams.core.SizeOfHandler
,Serializable
,Comparable
public class Scripted extends AbstractScriptedFeatureGenerator
A feature generator that uses any scripting handler for processing the data with a script located in the specified file.
-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel) The logging level for outputting errors and debugging output. default: WARNING
-converter <adams.data.featureconverter.AbstractFeatureConverter> (property: converter) The feature converter to use to produce the output data. default: adams.data.featureconverter.SpreadSheet -data-row-type adams.data.spreadsheet.DenseDataRow -spreadsheet-type adams.data.spreadsheet.SpreadSheet
-field <adams.data.report.Field> [-field ...] (property: fields) The fields to add to the output. default:
-notes <adams.core.base.BaseString> [-notes ...] (property: notes) The notes to add as attributes to the generated data, eg 'PROCESS INFORMATION' . default:
-script <adams.core.io.PlaceholderFile> (property: scriptFile) The script file to load and execute. default: ${CWD}
-options <adams.core.base.BaseText> (property: scriptOptions) The options for the script; must consist of 'key=value' pairs separated by blanks; the value of 'key' can be accessed via the 'getAdditionalOptions ().getXYZ("key")' method in the script actor. default:
-handler <adams.core.scripting.AbstractScriptingHandler> (property: handler) The handler to use for scripting. default: adams.core.scripting.Dummy
- Version:
- $Revision$
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected AbstractHeatmapFeatureGenerator
m_FeatureGeneratorObject
the loaded script object.protected adams.core.scripting.AbstractScriptingHandler
m_Handler
the scripting handler to use.-
Fields inherited from class adams.data.heatmapfeatures.AbstractScriptedFeatureGenerator
m_ScriptFile, m_ScriptObject, m_ScriptOptions
-
Fields inherited from class adams.data.heatmapfeatures.AbstractHeatmapFeatureGenerator
m_Converter, m_Fields, m_Notes
-
-
Constructor Summary
Constructors Constructor Description Scripted()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
checkData(Heatmap map)
Optional checks of the heatmap.protected String
checkScriptObject()
Checks the script object.adams.data.featureconverter.HeaderDefinition
createHeader(Heatmap map)
Creates the header from a template heatmap.void
defineOptions()
Adds options to the internal list of options.void
destroy()
Frees up memory in a "destructive" non-reversible way.List<Object>[]
generateRows(Heatmap map)
Performs the actual feature generation.adams.core.scripting.AbstractScriptingHandler
getHandler()
Gets the handler to use for scripting.String
globalInfo()
Returns a string describing the object.String
handlerTipText()
Returns the tip text for this property.protected String
loadScriptObject()
Loads the scripts object and sets its options.String
scriptOptionsTipText()
Returns the tip text for this property.void
setHandler(adams.core.scripting.AbstractScriptingHandler value)
Sets the handler to use for scripting.-
Methods inherited from class adams.data.heatmapfeatures.AbstractScriptedFeatureGenerator
getScriptFile, getScriptOptions, initScriptObject, reset, scriptFileTipText, setScriptFile, setScriptOptions
-
Methods inherited from class adams.data.heatmapfeatures.AbstractHeatmapFeatureGenerator
cleanUp, compareTo, converterTipText, equals, fieldsTipText, generate, getConverter, getDatasetFormat, getFields, getNotes, getQuickInfo, getRowFormat, notesTipText, postProcessHeader, postProcessRow, postProcessRows, setConverter, setFields, setNotes, shallowCopy, shallowCopy
-
Methods inherited from class adams.core.option.AbstractOptionHandler
cleanUpOptions, finishInit, getDefaultLoggingLevel, getOptionManager, initialize, loggingLevelTipText, newOptionManager, setLoggingLevel, toCommandLine, toString
-
Methods inherited from class adams.core.logging.LoggingObject
configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf
-
-
-
-
Field Detail
-
m_FeatureGeneratorObject
protected transient AbstractHeatmapFeatureGenerator m_FeatureGeneratorObject
the loaded script object.
-
m_Handler
protected adams.core.scripting.AbstractScriptingHandler m_Handler
the scripting handler to use.
-
-
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 classAbstractScriptedFeatureGenerator
-
scriptOptionsTipText
public String scriptOptionsTipText()
Returns the tip text for this property.- Specified by:
scriptOptionsTipText
in interfaceadams.core.scripting.FileBasedScriptingWithOptions
- Overrides:
scriptOptionsTipText
in classAbstractScriptedFeatureGenerator
- Returns:
- tip text for this property suitable for displaying in the explorer/experimenter gui
-
setHandler
public void setHandler(adams.core.scripting.AbstractScriptingHandler value)
Sets the handler to use for scripting.- Parameters:
value
- the handler
-
getHandler
public adams.core.scripting.AbstractScriptingHandler getHandler()
Gets the handler to use for scripting.- Returns:
- the handler
-
handlerTipText
public String handlerTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the explorer/experimenter gui
-
loadScriptObject
protected String loadScriptObject()
Loads the scripts object and sets its options.- Specified by:
loadScriptObject
in classAbstractScriptedFeatureGenerator
- Returns:
- null if OK, otherwise the error message
-
checkScriptObject
protected String checkScriptObject()
Checks the script object.- Specified by:
checkScriptObject
in classAbstractScriptedFeatureGenerator
- Returns:
- null if OK, otherwise the error message
-
checkData
protected void checkData(Heatmap map)
Optional checks of the heatmap.- Overrides:
checkData
in classAbstractScriptedFeatureGenerator
- Parameters:
map
- the heatmap to check
-
createHeader
public adams.data.featureconverter.HeaderDefinition createHeader(Heatmap map)
Creates the header from a template heatmap.- Specified by:
createHeader
in classAbstractHeatmapFeatureGenerator
- Parameters:
map
- the heatmap to act as a template- Returns:
- the generated header
-
generateRows
public List<Object>[] generateRows(Heatmap map)
Performs the actual feature generation.- Specified by:
generateRows
in classAbstractHeatmapFeatureGenerator
- Parameters:
map
- the heatmap to process- Returns:
- the generated features
-
destroy
public void destroy()
Frees up memory in a "destructive" non-reversible way.- Specified by:
destroy
in interfaceadams.core.Destroyable
- Overrides:
destroy
in classAbstractScriptedFeatureGenerator
-
-