Package adams.flow.source
Class WekaNewInstances
-
- All Implemented Interfaces:
AdditionalInformationHandler,CleanUpHandler,Destroyable,GlobalInfoSupporter,LoggingLevelHandler,LoggingSupporter,OptionHandler,QuickInfoSupporter,ShallowCopySupporter<Actor>,SizeOfHandler,Stoppable,StoppableWithFeedback,VariablesInspectionHandler,VariableChangeListener,Actor,ErrorHandler,OutputProducer,Serializable,Comparable
public class WekaNewInstances extends AbstractSimpleSource
Generates an empty dataset, based on the attribute types and names specified.
Nominal attributes are generated with an empty set of labels. Use the weka.filters.unsupervised.attribute.AddValues filter to add the required labels.
Date attributes are created with the default format of 'yyyy-MM-dd'T'HH:mm:ss'. Use the weka.filters.unsupervised.attribute.ChangeDateFormat filter to change the format to a more suitable format, if required.
Input/output:
- generates:
weka.core.Instances
Valid options are:
-D <int> (property: debugLevel) The greater the number the more additional info the scheme may output to the console (0 = off). default: 0 minimum: 0
-name <java.lang.String> (property: name) The name of the actor. default: WekaNewInstances
-annotation <adams.core.base.BaseText> (property: annotations) The annotations to attach to this actor. default:
-skip (property: skip) If set to true, transformation is skipped and the input token is just forwarded as it is.
-stop-flow-on-error (property: stopFlowOnError) If set to true, the flow gets stopped in case this actor encounters an error; useful for critical actors.
-relation-name <java.lang.String> (property: relationName) The name of the relation; if left empty, the full name of the actor is used. default:
-att-type <adams.core.base.AttributeTypeList> (property: attributeTypes) A comma-separated list of attribute types (NUM|NOM|STR|DAT). default:
-att-name <adams.core.base.BaseList> (property: attributeNames) The comma-separated list of attribute names; if left empty or not enough items available, the prefix 'att-' is used in conjunction with the 1-based index of the attribute; for the class attribute (if applicable), the name 'class' is used, unless otherwise specified. default:
-class-index <java.lang.String> (property: classIndex) The class index to set, leave empty to have none set; An index is a number starting with 1; the following placeholders can be used as well: first, second, third, last_2, last_1, last default:
-class-name <java.lang.String> (property: className) The name of the class attribute; default is 'class'. default:
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static StringATTRIBUTE_PREFIXthe prefix for attributes (if nto specified explicitly).static StringDEFAULT_CLASSthe class attribute name (if not specified explicitly).static StringDEFAULT_DATE_FORMATthe default date format.protected BaseListm_AttributeNamesthe comma-separated list of attribute names.protected AttributeTypeListm_AttributeTypesthe comma-separated list of attribute types.protected Indexm_ClassIndexthe index for the class attribute, if any.protected Stringm_ClassNamethe name for the class attribute, if any.protected Stringm_RelationNamethe name for the relation, if any.-
Fields inherited from class adams.flow.source.AbstractSimpleSource
m_OutputToken
-
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 WekaNewInstances()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description StringattributeNamesTipText()Returns the tip text for this property.StringattributeTypesTipText()Returns the tip text for this property.StringclassIndexTipText()Returns the tip text for this property.StringclassNameTipText()Returns the tip text for this property.voiddefineOptions()Adds options to the internal list of options.protected StringdoExecute()Executes the flow item.Class[]generates()Returns the class of objects that it generates.BaseListgetAttributeNames()Returns the list of attribute names.AttributeTypeListgetAttributeTypes()Returns the list of attribute types.StringgetClassIndex()Returns the index of the class attribute.StringgetClassName()Returns the name of the class attribute.StringgetQuickInfo()Returns a quick info about the actor, which will be displayed in the GUI.StringgetRelationName()Returns the name of the relation.StringglobalInfo()Returns a string describing the object.protected voidinitialize()Initializes the members.StringrelationNameTipText()Returns the tip text for this property.voidsetAttributeNames(BaseList value)Sets the list of attribute names.voidsetAttributeTypes(AttributeTypeList value)Sets the list of attribute types.voidsetClassIndex(String value)Sets the index of the class attribute.voidsetClassName(String value)Sets the name of the class attribute.voidsetRelationName(String value)Sets the name of the relation.-
Methods inherited from class adams.flow.source.AbstractSimpleSource
hasPendingOutput, output, reset
-
Methods inherited from class adams.flow.core.AbstractActor
annotationsTipText, backupState, 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, isBackedUp, isExecuted, isExecuting, isFinished, isHeadless, isStopped, nameTipText, performSetUpChecks, performVariableChecks, postExecute, preExecute, pruneBackup, pruneBackup, restoreState, setAnnotations, setErrorHandler, setName, setParent, setSilent, setSkip, setStopFlowOnError, setUp, setVariables, shallowCopy, shallowCopy, silentTipText, sizeOf, skipTipText, stopExecution, stopExecution, stopFlowOnErrorTipText, updateDetectedVariables, updatePrefix, updateVariables, variableChanged, wrapUp
-
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, setUp, setVariables, shallowCopy, shallowCopy, sizeOf, stopExecution, stopExecution, toCommandLine, variableChanged, wrapUp
-
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
-
ATTRIBUTE_PREFIX
public static final String ATTRIBUTE_PREFIX
the prefix for attributes (if nto specified explicitly).- See Also:
- Constant Field Values
-
DEFAULT_CLASS
public static final String DEFAULT_CLASS
the class attribute name (if not specified explicitly).- See Also:
- Constant Field Values
-
DEFAULT_DATE_FORMAT
public static final String DEFAULT_DATE_FORMAT
the default date format.- See Also:
- Constant Field Values
-
m_AttributeTypes
protected AttributeTypeList m_AttributeTypes
the comma-separated list of attribute types.
-
m_AttributeNames
protected BaseList m_AttributeNames
the comma-separated list of attribute names.
-
m_ClassIndex
protected Index m_ClassIndex
the index for the class attribute, if any.
-
m_ClassName
protected String m_ClassName
the name for the class attribute, if any.
-
m_RelationName
protected String m_RelationName
the name for the relation, if any.
-
-
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 classAbstractActor
-
initialize
protected void initialize()
Initializes the members.- Overrides:
initializein classAbstractSimpleSource
-
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 classAbstractActor- Returns:
- null if no info available, otherwise short string
-
setRelationName
public void setRelationName(String value)
Sets the name of the relation.- Parameters:
value- the name of the relation, uses full actor name as default if left empty
-
getRelationName
public String getRelationName()
Returns the name of the relation.- Returns:
- the relation name, empty if default is used, i.e., the full actor name
-
relationNameTipText
public String relationNameTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setAttributeTypes
public void setAttributeTypes(AttributeTypeList value)
Sets the list of attribute types.- Parameters:
value- the attribute types
-
getAttributeTypes
public AttributeTypeList getAttributeTypes()
Returns the list of attribute types.- Returns:
- the attribute types
-
attributeTypesTipText
public String attributeTypesTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setAttributeNames
public void setAttributeNames(BaseList value)
Sets the list of attribute names.- Parameters:
value- the attribute names
-
getAttributeNames
public BaseList getAttributeNames()
Returns the list of attribute names.- Returns:
- the attribute names
-
attributeNamesTipText
public String attributeNamesTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setClassIndex
public void setClassIndex(String value)
Sets the index of the class attribute.- Parameters:
value- the index, empty for none
-
getClassIndex
public String getClassIndex()
Returns the index of the class attribute.- Returns:
- the index, none if empty
-
classIndexTipText
public String classIndexTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setClassName
public void setClassName(String value)
Sets the name of the class attribute.- Parameters:
value- the name of the class attribute, uses default if left empty- See Also:
DEFAULT_CLASS
-
getClassName
public String getClassName()
Returns the name of the class attribute.- Returns:
- the class, empty if default
- See Also:
DEFAULT_CLASS
-
classNameTipText
public String classNameTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
generates
public Class[] generates()
Returns the class of objects that it generates.- Returns:
- weka.core.Instances.class
-
doExecute
protected String doExecute()
Executes the flow item.- Specified by:
doExecutein classAbstractActor- Returns:
- null if everything is fine, otherwise error message
-
-