Storey Drift Viewer

When the tool is launched in T/HIS, the storey drift curves will be generated for each graph setup existing in the Workflow file. Then you will be presented with this window below.

When the Workflow file is initially created from PRIMER, default graph setups are included – one for each direction component, for each drift location defined. The storey drift curves will be created for each of these graph setups and the first graph setup will be plotted in T/HIS and will be active in the Viewer GUI:

The Viewer GUI is generally split into four sections listed below:

Graph selection/creation panel

This panel allows you to cycle through the graphs you have generated. You can use the navigation buttons to view the graphs sequentially or you can select a graph from the combo box.

You will be provided with three toggles: drift locations, direction components, and model. The toggle for drift locations will only be shown if more than one drift is included in the current graph setup. All direction component toggles will be shown, but only those included will be active. Finally, the model toggles will only be visible if more than one model is loaded in the current T/HIS session.

In this panel, you are provided with control buttons allowing you to create or modify graph setups.

To create a new graph, click Create. You will then be presented with a new window as shown below. Select the drifts and direction components you want to include. Once the selection is made, the Add to Graph button will be active. Click Add to Graph to generate the list of curves that will be added to the graph, which will be shown on the list box on the right. You may then do some final selection adjustments (e.g. you can remove some of the curves listed by selecting them and clicking Remove).

Once you have finalised the curves you wish to include, click Create to generate the new graph and return to the Plot Viewer window.

Other commands available to you are as follows:

Edit allows you to modify the currently active graph setup in your Plot Viewer. You will be shown with a similar window as for Create.
Remove allows you to delete the currently active graph setup. This will not delete the T/HIS curves associated with the graph.
Reset deletes every graph setup and recreates the defaults set in PRIMER.

Modifications made in the graph selection panel will be automatically saved to the Workflow JSON file.

You can also export the current T/HIS curves to an external file. You can do this by clicking Export to CSV.

Curve display settings

This panel allows you to define the formatting of the curves in the T/HIS graph. These settings will be applied to all graph setups stored in your Workflow file. Later, when you generate the report, REPORTER will read these settings and apply the styling you have defined.

The Workflow file will hold two separate sets of settings for single model mode and multiple model mode. This is because you may want to have different settings when you are plotting results for only one model and when you are plotting results for multiple models. If you are intending to generate reports containing results from a single model and from multiple models, you need to define the settings for these two modes separately.

The first three settings are responsible for categorising your curves by drift location, direction component and model – in the following hierarchy order:

You can categorise the drift locations and direction components by Colour or Line style. For example, if you display the drift locations by colour and the direction components by line style, the tool will then assign one colour for all curves under a drift location and will assign one line style for all curves under a direction component. As shown in the example below, all curves under Drift SW are red and all the curves representing drifts along the X direction (DRX) have solid lines:

You can also categorise the models by Colour or Line style. For models, there is a third option called Inherit (which is set by default). This option essentially tells the tool that the curves will not be categorised by model. Instead, they will just follow the formatting of the first two categories. This is particularly useful if you are more concerned with the aggregate curves and you are just displaying the model curves to see if there is an outlier compared to the aggregate curve. If you use this option, you can quickly identify visually which model curves are associated with an aggregate curve.

In the example below, the curves under Drift SW along DRX are solid lines in red colour. The curve representing the mean storey drifts follows the same format but with a thicker line width to differentiate it from the rest of the individual model curves under the same categories:

This current implementation of curve categorisation may not work for all scenarios, and could be improved further in future. Please contact us with your feedback.

The other curve settings available to you are described below:

Show Models allows you to set if the model curves are shown or hidden in the plot. This is only relevant for multiple model mode.
Summarize by allows you to choose which aggregate curve is shown. You have the following options: None, Average, Envelope.
Model Colours allows you to choose if the model curves will be in Colour or Greyscale.
Summary Colours allows you to choose if the aggregate curves will be in Colour or Greyscale.
Model Line width allows you to set the line width for the model curves.
Summary Line width allows you to set the line width for the aggregate curves.

Any modifications made in this settings panel will not be automatically saved to the Workflow file. Click Save to write these settings to the Workflow file. You may also revert back to default settings by clicking Reset, which will simultaneously update these settings on the Workflow file.

Storey Drift limits

This panel allows you to define vertical curve limits on the positive and negative X-axis. These limits normally represent acceptable code standard drift limits. They are typically included in building design reports to demonstrate compliance.

There are two types of vertical storey curve limits that you can define:

Constant curve limit along the structure elevation
Stepped curve limit, where the desired limit per storey extent varies

You can define a constant curve limit using this panel. In order to define a stepped curve limit, you need to import a CSV file. You can download an example plot limit input file by clicking Export defaults.

You can also import a constant curve limit using an external file and this file may contain multiple curve limits of different types. Theoretically, you can store all your curve limits into one file to quickly generate them later.

To define a constant curve limit, you would need to define a label and the X-axis value on the text boxes provided. Then, click Add.

To define a stepped curve limit, create a CSV file following the data format of the exported default file. Click Import to add the data to the plot.

The limits created will be listed below along with some control buttons to manipulate them:

Show or hide the curve limits using the ON/OFF toggles
Change the colour of the curve limits using the colour selection dropdown.
Delete a curve limit using the delete (X) button. Currently, this panel does not allow you to edit an existing curve limit. You may need to recreate a curve limit to modify the X-value(s) along the storeys.

The storey curve limits will be automatically saved to the Workflow file upon creation. Curve colour and visibility settings will also be automatically updated in the Workflow file upon changing them in this panel. You may wish to store these data separately for future use. You can do so by clicking Export located on the right side of the panel header.

You may also revert back to default storey curve limits by clicking the Reset button.

Each Workflow will have a different set of default limits.

Storey datum settings

This panel allows you to define the formatting of the storey datums shown in the plot. This panel is hidden by default. Click Show to reveal this panel.

The settings available to you are as follows:

Colour allows you to choose the colour of the storey datums
Line Style allows you to choose the line style of the storey datums
Line Width allows you to choose the line width of the storey datums
Label Font allows you to choose the font of the storey datum labels
Label Size allows you to choose the font size of the storey datum labels
Label Position allows you to define the location of the labels relative to the storey datums

Any modifications made on this settings panel will not be automatically saved to the Workflow file. Click Save to write these settings to the Workflow file. You may also revert back to default settings by clicking Reset, which will simultaneously update these settings on the Workflow file.

Previous | Next