Skip to main content

Multi Label Modeling

Synopsis

This operator trains a Multi Label Model on an input ExampleSet.

Description

A Multi Label Model is a meta model able to predict multiple label attributes at once. For each label attribute, the Multi Label Model contains a Prediction Model. The label attributes can be selected by theattribute filter.

The inner subprocess of the operator is executed for each selected label attribute. The input training data, with the current label attribute set to theLabelrole, is provided at the innertraining setport. It can be used to train a Prediction Model for the corresponding label attribute. The Prediction Model has to be provided to themodelport of the inner subprocess. The Prediction Models are collected and provided as the Multi Label Model at themodeloutput port of the operator. Additional objects can be passed in and out of the subprocess through theinputandoutputport extender.

Any attribute, independent of type or special role, can be selected as label attribute. It has only be ensured that the Prediction Model trained in the inner subprocess is capable of handling all selected label attributes. To ensure a defined behavior the input ExampleSet is not allowed to have a normal 'Label' attribute. If the input data has such an attribute, its role has to be set to another role with theSet Roleoperator. Note that the role of all other attributes are not changed. Hence if a regular attribute is selected as a label attribute, it will be still a regular attribute in the training iterations of the other label attributes and used as an input attribute for the Prediction Models of the other label attributes. The name and type of the current label attribute in the subprocess can be added as macros if the parameteradd macrosis selected.

When the Multi Label Model is applied on an ExampleSet (using theApply Modeloperator) the Prediction Models of the meta model are used to create a 'Prediction' attribute for every label attribute. The name of the 'Prediction' attributes is set toprediction(<name of label attribute>), the special role of the 'Prediction' attribute is set toprediction_<name of label attribute>. If the Prediction Model also creates 'Confidence' attributes (in case the label is nominal), the 'Confidence' attributes are namedconfidence(<name of label attribute>=<value>). The role of the 'Confidence' attributes are set toconfidence<name of label attribute><value>.

The performance of the multiple predictions can be evaluated by the operatorMulti Label Performance.

Input

training set

The input ExampleSet on which the Multi Label Model is built.

input

This port is a port extender, which means if a port is connected a newinputport is created. Any IOObject can be connected to the port and is passed to the corresponding innerinputport for each iteration.

Output

model

The Multi Label Model, containing Prediction Models for each of the selected label attributes.

output

This port is a port extender, which means if a port is connected a newoutputport is created. The port collects every result that is provided by the inner process and returns a collections of all iterations.

Parameters

Attribute filter type

This parameter allows you to select the filter for the label attributes selection; the method you want to select the attributes for which Prediction Models are trained. Note that the filter is applied on all attributes indepent of their special role (the parameterinclude special attributesis set totruefor this attribute selection and cannot be changed). The different filter types are:

  • all: This option selects all attributes of the ExampleSet to be label attributes. This is the default option.
  • single: This option allows the selection of a single label attribute. The required attribute is selected by theattributeparameter.
  • subset: This option allows the selection of multiple label attributes through a list (see parameterattributes). If the meta data of the ExampleSet is known all attributes are present in the list and the required ones can easily be selected.
  • regular_expression: This option allows you to specify a regular expression for the label attribute selection. The regular expression filter is configured by the parametersregular expression, use except expression and except expression.
  • value_type: This option allows selection of all the attributes of a particular type to be label attributes. It should be noted that types are hierarchical. For example real and integer types both belong to the numeric type. The value type filter is configured by the parametersvalue type, use value type exception, except value type.
  • block_type: This option allows the selection of all the attributes of a particular block type to be label attributes. It should be noted that block types may be hierarchical. For example value_series_start and value_series_end block types both belong to the value_series block type. The block type filter is configured by the parametersblock type, use block type exception, except block type.
  • no_missing_values: This option selects all attributes of the ExampleSet as label attributes which do not contain a missing value in any example. Attributes that have even a single missing value are not selected.
  • numeric_value_filter: All numeric attributes whose examples all match a given numeric condition are selected as label attributes. The condition is specified by thenumeric conditionparameter.

Attribute

The required attribute can be selected from this option. The attribute name can be selected from the drop down box of the parameter if the meta data is known.

Attributes

The required attributes can be selected from this option. This opens a new window with two lists. All attributes are present in the left list. They can be shifted to the right list, which is the list of selected label attributes.

Regular expression

Attributes whose names match this expression will be selected. The expression can be specified through theedit and preview regular expressionmenu. This menu gives a good idea of regular expressions and it also allows you to try different expressions and preview the results simultaneously.

Use except expression

If enabled, an exception to the first regular expression can be specified. This exception is specified by theexcept regular expressionparameter.

Except regular expression

This option allows you to specify a regular expression. Attributes matching this expression will not be selected even if they match the first expression (expression that was specified inregular expressionparameter).

Value type

This option allows to select a type of attribute.

Use value type exception

If enabled, an exception to the selected type can be specified. This exception is specified by theexcept value typeparameter.

Except value type

The attributes matching this type will not be selected even if they matched the before selected type, specified by thevalue typeparameter.

Block type

这个选项允许选择一块类型的素质bute.

Use block type exception

If enabled, an exception to the selected block type can be specified. This exception is specified by theexcept block typeparameter.

Except block type

The attributes matching this block type will not be selected even if they matched the before selected type by theblock typeparameter.

Numeric condition

The numeric condition used by the numeric condition filter type. A numeric attribute is selected if all examples match the specified condition for this attribute. For example the numeric condition '>6' will keep all numeric attributes having a value of greater than 6 in every example. A combination of conditions is possible: '>6 &&<11' or '<= 5 ||<0'. But && and || cannot be used together in one numeric condition. Conditions like '(>0 &&<2) || (>10 &&<12)' are not allowed because they use both && and ||.

Invert selection

If this parameter is set to true the selection is reversed. In that case all attributes not matching the specified condition are selected as label attributes.

Add macros

If selected macros containing the name and the value type of the current label attribute are added in each iteration of the subprocess.

Current label name macro

Ifadd macrosis true, this parameter defines the name of the macro holding the current label attribute name.

Current label type macro

Ifadd macrosis true, this parameter defines the name of the macro holding the current label attribute type.

Enable parallel execution

该参数使parallel execution of the inner processes. Please disable the parallel execution if you run into memory problems.