Changing Configurations

To test your operator in Altair AI Studio, you must first change some configuration in the extension project. Adapt the following two files (replace 'NAME' with the name of your extension):

OperatorsNAME.xml
OperatorsDocNAME.xml

Here is how to make your operators available to Altair RapidMiner:

Decide on a name of the operator group to put the operator in.
Open the file OperatorsNAME.xml and add the new group with a key.
Add an operator tag. The operator has a key, the class (with the complete package path) and, optionally, an icon. If an icon is already part of the Altair RapidMiner Core, you can just use it.

Otherwise:
- Create the folder com.rapidminer.resources.icons and subfolders called 16, 24 and 48.
- Paste the icon you want to use in the sizes 16x16 pixels, 24x24 pixels and 48x48 pixels in the respective folder.
- Add a 96x96 pixels version of the icon directly to the folder com.rapidminer.resources.icons.

../img/operator-key.png

At this point you can already build the extension and use it in Altair AI Studio. You could see the operator in the Operator Tree, but its name would be the key. Instead, you need to define a translation from the key to the operator name in the file operator's documentation file, and we will come back to this later here. As a temporary approach, you can define a key to name translation in the OperatorsDocNAME.xml (This approach is considered deprecated since version 2025.0.0, but it will work for now). Define the key and name for every operator and every operator group.

../img/operator-key-name-translation.png

The operator search in Altair AI Studio will find operators not only by name (in this case My Operator). To improve the search results you can define additional tags per operator.

Operator tagging example

<operatorHelp>
    <operator>
        <key>my_own_operator</key>
        <name>My Operator</name>
        <tags>
            <tag>My First Tag</tag>
            <tag>My Second Tag</tag>
        </tags>
    </operator>
</operatorHelp>

Coloring your operator

If you want your operator to have a specific color, open the file groupsNAME.properties and add a color for your operator group. Use the operator group key to define the operator group and use a Hex code to define the operator color. For example:

# Operator group colors
group.operator_test.color = #5FDE35

Testing your operator

The following section describes how to test your operator.

Installing the extension

To install the extension:

If you are using IntelliJ, open the Gradle view and double-click the task installExtension.
If you are using Eclipse, select the project in the Gradle Tasks view and double-click the task installExtension.
If using a text editor, open a command prompt, browse to the extension template project and execute the following command:
```
  ./gradlew installExtension
```

Starting Altair AI Studio

Open Altair AI Studio and find your operator group in the Operators Tree panel in the Extensions group. Drag the new operator on to the process canvas. Verify that the operator has the color and icon that you defined and that it has a name instead of a key. You can run the process and the operator will produce a log entry, but depending on the purpose of your operator, there might be something missing.

../img/my-own-operator.png

It might be helpful to add input and output ports, for example, if your operator should process data. Look at the Parameters panel and the Help panel, and you'll see that there are not yet parameters that you can set or help for your operator. Adding parameters to your operator helps users to configure how your operator should be executed. Adding documentation to your operator is obviously useful. Use it to explain what your operator does and which parameters can be set. You can even add sample processes.

Categories

Versions