THIS 22.1

Table

Table

The Table option can be used to give more control over which curves are blanked and unblanked in all of the currently defined graphs, as well as display curve properties and injury values in a tabulated format. By default the Curve Table displays a scrolling list of all of the currently defined curves and curve groups along with a set of tick boxes that display the status of the curve in the current graphs. Curves are displayed in BLUE text while curve groups are displayed in GREEN.

For each curve the following information is displayed by default.

ID Curve ID or Group ID for curve groups
Label Curve Label or Group Name
Directory If the curve has been read in from a model then this will be the directory that all all the model files are in, if the curve had been read in from a file (.cur. .csv) then this will be the file location.

No information is displayed for curve groups.
Model/File If the curve has been read in from a model then by default this will be the ID of the model. If the curve had been read in from a file then this will be the filename.

No information is displayed for curve groups.
Type The entity type that the curve was generated from. If the curve was read in from a file then this will display "FILE".
Entity ID ID of the item that the data was read from. If the curve was read from a file then this will be the index within the file for each curve.

If the row represents more than one curve (e.g. curve groups) and the curves have different components then it will display '*'
Component Data component name.

If the row represents more than one curve (e.g. curve groups) and the curves have different components then it will display '*'
Style This will show the line colour, style and width used to display the curve.   

The column widths of any of the above columns can be adjusted by clicking on the bars between the header columns and the order of the columns can be changed by dragging the column headers.

The contents of the table can also be sorted by any column by clicking on the relevant header button. Clicking on the same header a 2nd time reverses the sort order for the column.

Adding / Removing Curves from graphs and Locking / Freezing

To add an individual curve (or curve group) to a graph the tick boxes on the right hand side of the curve table can be used.

The first column of tick boxes (under the *) can be used to add/remove a curve from all the currently defined graphs, while the top row of tick boxes can be used to add/remove all the currently defined curves from a graph.

  • If all of the curves are unblanked in a graph then the tick box will display a black tick in a white box.
  • If some of the curves are unblanked in a graph then the tick box will display a dark grey tick in a grey box.
  • If none of the curves in a group are unblanked in a graph then the tick box will be empty.

Multiple tick boxes can be set/unset by clicking on the first one and then holding SHIFT while clicking on the last one.



These tickboxes can also be used to lock or freeze curves. If the 'Locking/Freezing' button, or the 'Locking/Freezing' option in the 'Graph buttons' popup is selected, then the tickboxes are re-purposed. Locking a curve means fixing it as blanked in a graph so it cannot be made visible until it is unlocked. Freezing a curve is the equivalent for visible curves. The curve will be visible in that graph until it is unfrozen. These curves will no longer be affected by shortcut keys such as 'u', 'r' and 'b'.

Instead of changing the ticks, locking and freezing will change the background colour of the tickbox. When a curve is locked, the background will be red. When it it is frozen, the background will be green.

The buttons relating to multiple graphs or multiple curves behave in the same way as for blanking, as does multiple-selection using CTRL or SHIFT.


Individual curves can also be selected by clicking on them in the main part of the curve table. Multiple curves can be selected using either CTRL to select a single curve or SHIFT to select a range of curves. As curves are selected they are highlighted in blue and the tick boxes for any unselected curves are greyed out.

When multiple curves have been selected then clicking on a tick box sets the status for all the selected curves.


As well as blanking and unblanking curves in graphs a number of other options can be applied to selected curves by right clicking on them, such as applying operations and changing the line style.


View Options

The viewing options popup, found in the top left of the curve table window, can be used to control which columns of data are displayed and what items are displayed in the curve table.

By default all 8 columns of general information about each curve will be displayed, each column can be turned on and off but T/HIS will ensure that at least one column is always displayed. Curve properties and injury values can also be displayed, but this will be discussed further below.

The columns that are initially displayed can be specified in the preference file (see Format of the oa_pref File for more details). If the columns are changed then Save to Pref can be used to update the preference file.

Display

This option can be used to control how items are displayed in the curve table.

All Items

By default the curve table will contain one row for each curve and one row for each curve group.

Group By Model/File


This option will display a single row for all the curves that were read from the same model or file.

When this option is selected the columns for curve ID, Label, Type, Entity ID and component display a '*' as they represent multiple values.

This option can be used to quickly assign all of the curves from a single model or file to the same graph.

Group By Common Items

This option will display a single row for all the curves that were created using the same entity type, ID and component.

In the example opposite the 1st row represents all of the curves that contain a model Kinetic Energy while the 3rd row represents all the curves that contain a displacement magnitude for Node 10000.

This option can be used to quickly assign all of the curves for the same entity and component to the same graph when comparing results from multiple models.

Include

By default the curve table contains both curves and curve groups. This option can be used to display either just the curves only or just the curve groups.

Show Models By

If the column displaying the model ID is displayed in the curve table then by default it will display the model number.

This option can be used to display either.

The model ID

The model directory

The name of the THF file

A user defined model description


Filter Options

The filter options can be used to filter the list of curves displayed in the curve table.

Multiple filters can be active at the same time


Filter By Model

This option can be used to filter the list of curves by model number. If curves have been read in from a file then an "Other" option will be shown.

In the example opposite only curves that are either from model 1 or model 2 will be displayed.


Filter By Label

This option can be used to filter the list of curves by label. Up to 5 different strings can be entered and the list of curves displayed will be filtered using those strings. If multiple strings are entered then the strings can either be combined using either "AND" or "OR".

A separate option can be used to ignore the case so that "model" will match both "Model" and "model"

In the example opposite only curves that contain either the word "Model" OR the word "Node" in their labels will be displayed.


Filter By Type

This option can be used to filter the list of curves by entity type. The list of entity types displayed will automatically update to show the entity types for all the curves that are currently stored in T/HIS.

In the example opposite only curves that contain "Model" data are displayed.


Filter By Component

This option can be used to filter the list of curves by component type. The list of components displayed will automatically update to show the components for all the curves that are currently stored in T/HIS.

In the example opposite only curves that are either Model Kinetic Energy or Nodal Displacement Magnitudes are displayed.


Include

By default the curve table contains both curves and curve groups. This option can be used to display either just the curves only or just the curve groups.

Curve Properties

The properties of each curve and any calculated injury values can also be displayed in the Curve Table. These are displayed by selecting the Curve Properties tab above the graph tickboxes. The Curve Table, including the values in all the displayed columns (except the Style column), can be written out to either a .csv or .xlsx file.

The Curve Properties and Injury Values columns that are displayed can be customized in the View... popup, both individually by clicking their name in the popup and as a group using the Show in table tickboxes. The choice of displayed columns can be saved to preferences.

Annotating Curves

Curves can be annotated with most of the properties and injury values by right-clicking the values in the table and selecting Annotate. Options for customising these annotations can be found in the Annotation options popup. The options include the format of the displayed value, i.e. whether it should appear as a single value (usually either an X or Y value depending on the property), or as a point (X,Y). The choice to highlight the value on the curve with a cross is also given, as well as the ability to add either an automatic or user-defined label to the annotation.