ETK

The Extraction Tool Kit (ETK) interface combines the full functionality of all separate ETK/output interfaces for the following file formats:

This node is able to handle solver responses provided in binary and text form.

Opening the Reference File

You can browse for a file or select a registered file.

To browse for a file:

  1. On the ETK tab, click Browse file.

  2. In the Choose a file to open dialog, browse to and select the reference file.

  3. Click Open.

To use a registered file:

  1. Click Use a registered file.

  2. In the table, select the reference file.

  3. Click OK.

After importing the file, the pane below is filled with data depending on the file format.

Defining Responses

You can define responses in multiple ways, including direct definition of matrices or signals.

Directly

Highlight the response and then drag and drop it into the Responses or Output slots pane.

Using Markers

  1. In the text field, highlight the required string.

  2. Right-click and select one of the following options from the context menu:

    • define marker > Use your string as marker

      Use a text marker to define a scalar response.

    • define marker > Use your string as repeated marker

      Use a text marker to define a vector response. Each occurrence of this marker in the file or until the end marker is reached is used.

  3. In the Variable Name field, enter a name for the variable.

  4. From the multi-action button, select either Use as response or Use as output slot.

Using Locations

  1. In the text field, highlight the required response value.

  2. If a marker has not been defined, right-click and select define location > from begin of file from the context menu.

    The file is read from the start and lines or token offset are used to define the response.

  3. If a marker has already been defined, right-click and select one of the following options from the context menu:

    • define location > From marker

      Start reading from an earlier defined marker and use line or token offset.

    • define location > From marker repeated

      Start reading from an earlier defined marker and use line or token offset to define a vector.

  4. In the Variable Name field, enter a name for the variable.

  5. From the multi-action button, select either Use as response or Use as output slot.

Variables Tab

This tab is used for internal variables. This can be helpful when defining derived outputs, for example, a signal created from two vectors.

Instant Visualization

When selected, visualizes signals and XY-data. A graphical and a textual representation is available by switching the tab of the visualization widget. Multiple values can be visualized simultaneously.

Advanced Options

To access the options shown in the following table, in the Text Output tab, click Show advanced options.

OptionDescription
When token wise is selected:
Line

  • Offset: Start with the n-th line

  • Increment : Use every m-th line

  • Maximum: Last line number, maximum of all lines that match

Token

  • Offset: Start with the n-th token

  • Increment : Use every m-th token

  • Maximum: Last token, maximum of all tokens that match

  • Choose token separator: Select delimiters to use to separate tokens (Double inverted commas are not supported).

  • Compressed: Compress adjacent separators

Use text markerWhen selected, the following options are available:

  • Begin: String to start with. To define the string as a regex select the Use regex check box.

  • End: String to stop on. This is an optional setting. To define the string as a regex select the Use regex check box.

    When typing the string into the fields, do not use the [ and ] characters. Use \[ and \] instead.

  • Offset: Start with the n-th marker (if selected string appears more than once in file).

  • Increment : Use every m-th marker.

  • Maximum: Last marker.

When column wise is selected:
Line

  • Offset: Start with the n-th line

  • Increment : Use every m-th line

  • Maximum: Last line number, maximum of all lines that match

Column

  • Initial offset: Start with the n-th character in the line

  • Width: The number of characters that are parsed as a value

  • Offset: The n-th value in the line that fits the equation Initial offest +n*width, repetition rule starts with the first element

  • Increment : Use every m-th entry

  • Maximum: Last line number, maximum of all offsets that match

Use text markerWhen selected, the following options are available:

  • Begin: String to start with. To define the string as a regex select the Use regex check box.

  • End: String to stop on. This is an optional setting. To define the string as a regex select the Use regex check box.

    When typing the string into the fields, do not use the [ and ] characters. Use \[ and \] instead.

  • Offset: Start with the n-th marker (if selected string appears more than once in file).

  • Increment : Use every m-th marker.

  • Maximum: Last marker.

Run Options

This node has general Run Options. The number of supported options is individual for each node.