# Top of Pile Forces \[CBG]

The Top of Pile Forces workflow item extracts finite-element analysis results at the top of a selected pile for use by downstream code checks (pile capacity, interaction) and reports. It supports both result-case and load-combination-table based extraction, and selects either the maximum, minimum, or absolute-maximum component per the chosen force/moment axis.

## General

**Pile:** Pick the pile from which forces are extracted at its top. Required; exactly one pile must be selected.

**Extract From \[Result Case/Load Combination Table]:** Source of the extracted forces. Result Case (0) pulls the force envelope from a single analysis case. Load Combination Table (1) applies the AASHTO limit-state factors from the picked table before extraction.

**Result Case:** Analysis case whose result is read when Extract From is Result Case. Only enabled in that mode.

**Load Combination Table:** Limit-state table used when Extract From is Load Combination Table. Only enabled in that mode.

**Limit State \[Strength I/Strength II/Strength III/Strength IV/Strength V/Extreme Event I/Extreme Event II/Service I/Service II/Service III/Service IV/Fatigue I/Fatigue II]:** AASHTO limit state whose combined forces are extracted from the table. Only enabled when Extract From is Load Combination Table.

## Force Extraction Settings

**Maximize Force \[All/Fx/Fy/Fz/Mx/My/Mz]:** Component used to identify the critical result. When All is chosen, every component is maximized independently and the returned tuple contains each component's critical value. When a specific component is chosen, the other five components reflect the case that maximizes that component.

**Min/Max \[Abs. max/Max/Min]:** Sorting convention used with Maximize Force. Abs. max picks the largest magnitude; Max picks the most positive value; Min picks the most negative.

**Set Max Target \[Self/Target]:** (Read-only) Indicates that the max target is the selected pile itself. Shown for reference only.

## Extracted Forces

All values in this group are computed from the most recent result extraction — they are displayed read-only for inspection and cannot be edited.

**Extracted From:** (Read-only) Name of the result case or load combination actually used to compute the current values.

**Force Settings:** (Read-only) Summary of the Maximize Force and Min/Max selections used.

**Last Result Extraction:** (Read-only) Date and time of the last result extraction run.

**Fx:** (Read-only) Extracted axial (longitudinal) force at the pile top.

**Fy:** (Read-only) Extracted transverse shear force at the pile top.

**Fz:** (Read-only) Extracted vertical force at the pile top.

**Mx:** (Read-only) Extracted moment about the X axis at the pile top.

**My:** (Read-only) Extracted moment about the Y axis at the pile top.

**Mz:** (Read-only) Extracted moment about the Z axis at the pile top.

**Coordinate System:** (Read-only) Coordinate system in which the extracted forces are reported. Local by default.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openbrim.org/templates/concrete-box-girder-bridge-workflow/organization-cbg/cross-project-data-cbg/analysis-results-cbg/top-of-pile-forces-cbg.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.