> For the complete documentation index, see [llms.txt](https://docs.openbrim.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openbrim.org/quick-guides/fea-results.md).

# FEA Results

## Access the Steel I-Girder Training Example

{% hint style="info" %}
Follow the steps below to open the **Steel I-Girder Training Example**.
{% endhint %}

1. Sign in. The **Projects** screen opens. Click **New Project**, or **NEW** in the bar on the left. (With a project already open, click the **New** icon, the page icon next to the project name in the top bar.)

   ![Projects screen](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-8259d4ccd9f7506d86ed3e7c28047ffe210635e4%2Fprojects-screen-new-project.png?alt=media)
2. The **Project Templates** screen opens. Open the **Example Projects** folder.

   ![Project Templates screen](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-14402564cc1f44ace73ad72b5a381386b6981265%2Fproject-templates-screen.png?alt=media)
3. Click **New Project** on the **Steel I-Girder Training Example** card.

   ![Steel I-Girder Training Example card](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-1cfcafab90187e24638a8bdd36bcfde8f0aeaf71%2Fexample-projects-steel-i-girder-card.png?alt=media)
4. In the **Create Project** dialog, enter a name for your project, choose a **Folder** if you want one, and click **Create**. The project opens in the 3D view.

   ![Create Project dialog](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-927d95853809887c9990c739d337476a268205ee%2Fcreate-project-dialog.png?alt=media)

![Steel I-Girder Training Example in the 3D view](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-161590db90b30d71e39a93d85b27a3d566db872f%2Fsteel-i-girder-training-example-opened.png?alt=media)

## View FE Results of the Steel I-Girder Training Example

{% hint style="info" %}
Follow the steps below to view steel I-girder FEA results.
{% endhint %}

1. Click **FEA** in the bar on the left to open the finite element view. **FEM** in the middle of the top bar (**3D** | **FEM** | **Detailing**) must be on, because it turns finite element model generation on and off. When the FE model has compiled, the **Analyze** button appears in the top-left corner of the view.

   ![FEA view with the Analyze button](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-d1159188e60ed74065b377cfbe2aa93618d61d69%2Ffea-view-analyze-button.png?alt=media)
2. Click **Analyze** to run the finite element analysis. The **Running Analysis** dialog shows which construction stage is being solved. When it reports **Analysis complete**, click **Close**. The **Analyze** button then becomes **Design**.

   ![Running Analysis dialog](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-65a4b8a7355e32209475e80f73d302328d60a956%2Ffea-running-analysis.png?alt=media)

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Analysis for this project typically <strong>takes about one minute</strong> to complete.</p></div>
3. The display panel in the lower-left corner of the view sets what is drawn. Click it to expand it. Its first row picks the display: **Model**, **Load**, **Deflection**, **Force** or **Stress**. **Force** and **Stress** add a **Type** row: **Reactions** (Force only), **Line**, **Surface** and **Composite**. Below them, **Category** picks the kind of case (construction stages, moving load cases, combinations and envelopes, and so on) and the next row picks the stage, case or combination itself. The rows after that pick the envelope, the component and the elements to draw.

   ![Category list in the display panel](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-8c12caa1d3c8892b10c3cbfcc70ebbf955488cc0%2Ffea-category-dropdown.png?alt=media)
4. The spreadsheet under the 3D view holds the result tables. (**Sheet**, at the right end of the toolbar under the 3D view, shows and hides it.) Above the tree, the **FEA** tab is selected in the FEA view. Under **FEA** → **Results** → **Result Tables**, click a table. The **Result cases** list opens beside the tree: click a case to show its values. The 3D view follows the case you pick in the list, and the list follows the case you pick in the display panel.

{% hint style="success" %}
The common steps before investigating FE results are now complete.
{% endhint %}

The remaining sections explain how to read each type of finite element result. Use the links below to jump to a section.

* [Deformed Shape](#deformed-shape)
* [Node Reactions](#node-reactions)
* [FESpring Results](#fespring-results)
* [FELine Results](#feline-results)
* [FEComposite Results](#fecomposite-results)
* [Construction Stage Results](#construction-stage-results)
* [Result Combination Results](#result-combination-results)
* [Display Live Load Critical Vehicle Positions](#display-live-load-critical-vehicle-positions)

{% hint style="info" %}
Results can be reported in either of two coordinate systems. Be aware which one is active when you read values.

* **Global Coordinate System:** a single fixed system for the entire model.

  ![image-20240904-081936.png](https://openbrim.atlassian.net/wiki/download/attachments/2231435275/image-20240904-081936.png?api=v2)
* **Local Coordinate System:** aligned with the bridge's PGL/Alignment — X along the alignment, Y transverse, Z vertical. Nodes and springs are generated in the Local system, but settings such as a bearing's **Bearing Rotation** can rotate the local axes for individual elements.

  ![image-20240904-101627.png](https://openbrim.atlassian.net/wiki/download/attachments/2231435275/image-20240904-101627.png?api=v2)

  ![image-20240904-083720.png](https://openbrim.atlassian.net/wiki/download/attachments/2231435275/image-20240904-083720.png?api=v2)

  ![image-20240904-083812.png](https://openbrim.atlassian.net/wiki/download/attachments/2231435275/image-20240904-083812.png?api=v2)
  {% endhint %}

## Deformed Shape

{% hint style="info" %}
Follow the steps below to view the deformed shape.
{% endhint %}

1. With the **FEA** view active, choose **Deflection** in the display panel to draw the deformed shape for: i) result cases, ii) construction stages, or iii) result combinations / envelopes. Pick the case with **Category** and the row under it. The **Translation** (**Umag**, **Ux**, **Uy**, **Uz**) and **Rotation** (**Rmag**, **Rx**, **Ry**, **Rz**) chips colour the shape by that component. Further down, **Geometry** switches between **Deformed** and **Undeformed**, and **Contour** between **Global**, **Local** and **Off** (**On** and **Off** for Umag and Rmag).

   ![Deflection display with Uz contour](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-fa747457d51a61ae608cd472019b5f41cc7bcc06%2Ffea-deflection-deformed-shape.png?alt=media)
2. Adjust the deformation scale with the **Scale** slider in the toolbar under the 3D view.
3. The spreadsheet follows the display and opens a node displacement table. **Node Displacements (Local)** and **Node Displacements (Global)** are both under **Result Tables**.

## Node Reactions

{% hint style="info" %}
Follow the steps below to view node reactions.
{% endhint %}

1. To see the reactions in the 3D view, choose **Force** in the display panel. The **Type** row opens on **Reactions**, which draws the support reactions on the model. **Envelope** picks **Min**, **Max** or **Abs Max**.

   ![Force display with Reactions](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-914857703180462377224efe9047130b5ff4c999%2Ffea-display-force-reactions.png?alt=media)
2. To read the values, open **Node Reactions (Local)** or **Node Reactions (Global)** under **Result Tables** in the tree. In **Result cases**, pick: i) a moving load case, ii) a construction stage, or iii) a combination / envelope. Type in the **Filter** box above the list to find a case by name.
3. To read the reactions of a **Result Extraction** case such as DC1, DC2 or DW, pick it under **Combinations & Envelopes**. Each result extraction case is listed under its own name followed by **.Comb**, so DC1 appears as **DC1.Comb**. Read this rather than the construction stage the case points to: the case has already applied its cumulative or incremental setting, its load-type filter and its factors, while a stage on its own shows everything accumulated up to it, for every load type, unless you set the stage filter yourself (see [Construction Stage Results](#construction-stage-results)).

   ![Node Reactions (Local) for DC1.Comb](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-52da7e3e1663ec13e045e89040cabbc472e15720%2Ffea-node-reactions-dc1-comb.png?alt=media)

## FESpring Results

{% hint style="info" %}
Follow the steps below to view FESpring results.
{% endhint %}

1. Under **Result Tables** in the tree, open **Spring Element Forces (Local)** or **Spring Element Forces (Global)**. This displays FESpring results (a row for each node of a two-node spring) for: i) result cases, ii) construction stages, iii) result combinations / envelopes. Pick the case in **Result cases**.

   ![Spring Element Forces (Local) table](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-50170ed75f53d2a8ef043d5256c3075e63b5d84e%2Ffea-spring-element-forces-table.png?alt=media)
2. To narrow the rows to some springs, click the **Spring Element** column header, click the **⋮** button that appears on it, and choose **Filter**. The same menu sorts the column and opens **Quick Stats…**.

   ![Column header menu](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-5c927cb380a01910d7b0289c86bdd777132af3d3%2Ffea-sheet-column-menu.png?alt=media)
3. In the **Filter Spring Element…** dialog, pick names under **Select Value**, or add a rule: choose **Add objects start with**, **Add objects contain** or **Add objects end with** and type the text in the box on the right (wildcards: `*` for many characters, `?` for one). Click **Apply Filter**.

   ![Filter dialog](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-7f4b4f97eb5100c275086a6e2a7f52d90da95280%2Ffea-sheet-column-filter-dialog.png?alt=media)
4. Spring results are reported as Forces (X/Y/Z) and Moments (X/Y/Z) in the coordinate system the table names: **(Local)** or **(Global)**.

## FELine Results

{% hint style="info" %}
Follow the steps below to view FELine results.
{% endhint %}

1. With the **FEA** view active, choose **Force** or **Stress** in the display panel, then **Line** in the **Type** row, to draw line element forces or stresses for: i) result cases, ii) construction stages, iii) result combinations / envelopes.
2. Nothing is drawn until you choose elements. Click a line element in the 3D view, hold the right mouse button and drag a box over several, or click **Select all members** in the notice.

   ![Line type with nothing selected](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-baf5bdfee4ef60a379419e0fbdf2166821dc0174%2Ffea-line-nothing-selected.png?alt=media)

### Viewing FELine Results Graphically

Set the rows of the display panel to the result you want to draw: the case, the **Envelope** (**Min**, **Max** or **Both**; **Abs Max** in place of **Both** for stresses) and the **Component** (**Fx**, **Fy**, **Fz**, **Mx**, **My**, **Mz**). **Members** switches between the **Selected** elements and **All members**, and **Name filter** limits the drawing to elements whose names match (for example `G1` or `PIER*`); **Pick…** chooses them from a list.

![Line element axial force for DC1.Comb](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-ed3c184e2c1a7317f56a4a2a2f266f7a65071bce%2Ffea-line-element-forces.png?alt=media)

### Viewing FELine Results Numerically

1. Under **Result Tables** in the tree, open **Line Element Internal Forces**. (**Line Element Stresses** is beside it.) The spreadsheet reports values for: i) result cases, ii) construction stages, iii) result combinations / envelopes.

   ![Line Element Internal Forces table](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-31a5ad419a7b65438a81cda207e3fccbcb82ad16%2Ffea-line-element-internal-forces-table.png?alt=media)
2. To narrow the results to some elements, filter the **Line Element** column as described in [FESpring Results](#fespring-results).

## FEComposite Results

{% hint style="info" %}
Follow the steps below to view FEComposite results.
{% endhint %}

1. With the **FEA** view active, choose **Force** in the display panel, then **Composite** in the **Type** row, to draw FEComposite results for: i) result cases, ii) construction stages, iii) result combinations / envelopes.
2. A composite cannot be picked in the 3D view itself. Click one of the elements it is built from, hold the right mouse button and drag a box over several, or click **Pick composite elements…** in the notice. In the **Pick composite elements** dialog, choose the composites under **Select Value** (for example **G1.CompositeGirder**), or type a name rule in the box on the right, and click **Apply**.

   ![Pick composite elements dialog](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-2ffd00a87cb623adef0d73d8e0f8c12f3fc16644%2Ffea-pick-composite-elements.png?alt=media)

### Viewing FEComposite Results Graphically

Set the rows of the display panel to the result you want to draw: the case, the **Envelope** and the **Component** (**Fx**, **Fy**, **Fz**, **Mx**, **My**, **Mz**). The composites you picked are kept in **Name filter**; click **×** beside it to clear it.

![Composite girder G1 moment My for DC1.Comb](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-a877fb2e30616dc28398bdf5aab90a2943128423%2Ffea-composite-forces-g1.png?alt=media)

### Viewing FEComposite Results Numerically

1. Under **Result Tables** in the tree, open **Composite Element Section Forces**. (**Composite Element Stresses** is beside it.) The spreadsheet reports values at each **Position** along the composite for: i) result cases, ii) construction stages, iii) result combinations / envelopes.

   ![Composite Element Section Forces table](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-9903148c043ccfad5ab9c3c79dcdf564c9d17a4e%2Ffea-composite-element-section-forces-table.png?alt=media)
2. To narrow the results to one composite group, filter the **Composite Object** column as described in [FESpring Results](#fespring-results).

## Construction Stage Results

{% hint style="info" %}
Follow the steps below to view staged-construction FEA results.
{% endhint %}

1. With the **FEA** view active, choose the display in the first row of the display panel (for example **Deflection** or **Force**).
2. Choose **Construction Stages** in **Category**.
3. Choose the construction stage of interest in **Stage**, or click it under **Construction Stages** in the **Result cases** list. The arrow buttons beside **Scale** in the toolbar step to the previous or next stage.

   ![Construction stage results, cumulative](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-2e99d92f4003453d54e060da2ed49e70091f8cee%2Ffea-construction-stage-cumulative.png?alt=media)

### Viewing Stage Results Incrementally

1. Results for a stage are reported either cumulatively or incrementally. The **Results** row of the FEA display panel switches between **Cumulative** (the default) and **Incremental**, for the graphics and the spreadsheet alike, and the spreadsheet columns say which one you are reading (**Cumulative Force X** or **Incremental Force X**, for example). Choose **Incremental** to see the selected stage's own contribution only.

   ![Construction stage results, incremental](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-889526bc139effe8ba1e6069e1dc25ba1c350610%2Ffea-construction-stage-incremental.png?alt=media)
2. Result displays draw only the elements built by the selected stage. In **Model** and **Load**, the **Structure** row switches between **All structure** and **Constructed only**.

   ![Structure row in Model display](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-625fd11bd5a7f8007cf6ad6c76b04d957f7904e9%2Ffea-stage-structure-row.png?alt=media)

### Viewing Stage Results Cumulatively

1. To switch to cumulative results for a stage, choose **Cumulative** in the **Results** row. The spreadsheet now shows the cumulative load effects of every stage up to the selected one. To narrow further, click the load-type chip beside it (it reads **All loads** until a filter is set) and pick the load type. The filter applies to cumulative results only. While it is set, the chip shows the load type (for example **DL** for Dead) and the spreadsheet columns read **Cumulative(DL) …**.

   ![Load-type filter on cumulative stage results](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-b5b330865570c57145604e9556d82098c8791a1e%2Ffea-construction-stage-load-type-filter.png?alt=media)
2. To remove the filter, click the chip again and choose **None**.

## Result Combination Results

{% hint style="info" %}
Follow the steps below to view load-combination FEA results.
{% endhint %}

1. With the **FEA** view active, choose the display in the first row of the display panel (for example **Deflection** or **Force**).
2. Choose **Combinations & Envelopes** in **Category**.
3. Open **Combination** and choose the result combination of interest. Type in the search box at the top of the list to find it by name.

   ![Combination list](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-d5e65b22b7e41781bf5dc5e1087b15e04080442f%2Ffea-combination-dropdown.png?alt=media)
4. The selected combination's results are now displayed. A combination that includes live load can take a few seconds to load the first time; a progress notice shows meanwhile.

   ![Strength I combination, vertical displacement](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-8693542008cce4e8e7d4e026dfdf638a9191ddc1%2Ffea-combination-strength-i.png?alt=media)

## Display Live Load Critical Vehicle Positions

1. Click **FEA** in the bar on the left to open the FEA view.
2. Under **Result Tables** in the tree, open **Node Reactions (Local)**.
3. In **Result cases**, choose **LLHL93Case.LIVELOAD** under **Moving Load Cases**.

{% hint style="info" %}
Vehicle positions can be reviewed for several result types: node displacements, element end forces, FELine forces, and FEComposite forces. FEComposite forces and stresses take longer to compute than node reactions because of the extra steps needed to determine vehicle positions.
{% endhint %}

4. To see the vehicle position responsible for a specific reaction, click the corresponding cell in the spreadsheet. The 3D view draws the vehicles in that position over the influence surface (**Inf Coef.** in the legend).

   ![Vehicle position for a reaction](https://2645910244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGR3Y2oTOZjlXFJKoQ7ar%2Fuploads%2Fgit-blob-78ba58ae41a2021b99b3e0147ab889f7fcc17301%2Ffea-live-load-vehicle-position.png?alt=media)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.openbrim.org/quick-guides/fea-results.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
