Top of Pile Forces [SPIG]

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.