*filtertable

Filter unique cells of key strings of selected column(s) and generate a new table considering the indices of key strings in key columns.

Syntax

*filtertable table=<name> keystring=<string1, string2, ... stringN> keycolumns=<column1, column2, ... columnN> valuecolumns=<column1, column2, ... columnN> targettable=<name>

Type

HyperMesh Tcl Modify Command

Description

Filter unique cells of key strings of selected column(s) and generate a new table considering the indices of key strings in key columns.

Unless otherwise noted, all inputs are mandatory. They may be specified in any order.

Inputs

keycolumns=<column1, column2, ... columnN>: The key columns of the selected table, separated by commas. These must follow the same sequence as the keystrings.
keystring=<string1, string2, ... stringN>: The key strings of the selected columns, separated by commas. These must follow the same sequence as the keycolumns.
table=<name>: The name of the input/source table.
targettable=<name>: The name of the output/target table.
valuecolumns=<column1, column2, ... columnN>: The value columns of the selected table, separated by commas. These must follow the same sequence as the keystrings.

Examples

For a given sourcetable table, filter 2 from layerindex column, 2_3_0 from loadcase column and get elementid and TAU12 columns output to a new table named targTable:

*filtertable table=sourcetable keystring={2,2_3_0} keycolumns={layerindex,loadcase} valuecolumns={elementid,TAU12} targettable=targTable

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2020