Rename by Example Values (RapidMiner Studio Core)

Synopsis

This operator renames the attributes of an ExampleSet by assigning the values of a specified example as attribute names and deleting that example from the ExampleSet.

Description

The Rename by Example Values operator uses the values of the specified example of the ExampleSet as new attribute names. The row number parameter specifies which row should be used as attribute names. Please note that all regular and special attributes are renamed. Moreover, the example is deleted from the ExampleSet. This operator can be useful in cases when an example holds the names of the attributes.

Please keep in mind that attribute names must be unique. The Rename by Example Values operator has no impact on the type or role of an attribute. For example if you have an attribute named 'alpha' of integer type and regular role. Renaming the attribute to 'beta' will just change its name. It will retain its type integer and role regular. To change the role of an operator, use the Set Role operator. Many type conversion operators are available for changing the type of an attribute at 'Data Transformation/Type Conversion'.

Input

example set input (Data Table)
This input port expects an ExampleSet. It is the output of the Subprocess operator in the attached Example Process. The output of other operators can also be used as input. It is essential that meta data should be attached with the data for the input because attributes are specified in their meta data.

Output

example set output (Data Table)
The ExampleSet with renamed attributes is output of this port.
original (Data Table)
The ExampleSet that was given as input is passed without changing to the output through this port. This is usually used to reuse the same ExampleSet in further operators or to view the ExampleSet in the Results Workspace.

Parameters

row_numberThis parameter specifies which row values should be used as attribute names. Please note that counting starts with 1. Range: integer

Tutorial Processes

Renaming all attributes by example values

This Example Process starts with the Subprocess operator. The Subprocess operator delivers an ExampleSet. A breakpoint is inserted here so that you can have a look at the ExampleSet. You can see that currently the attributes names are 'label', 'att1' and 'att2'. The first example has the values 'new_label', 'new_name1' and 'new_name2'. The Rename by Example Values operator is applied on this ExampleSet to set the values of the first example as attribute names. The row number parameter is set to 1. After execution of the process you will see that the attributes have been renamed accordingly. Moreover the first example has been removed from the ExampleSet.