Portal Frame Calculator

Concept 2D portal frame analysis with member forces and deflections. Educational use only.

This page documents the scope, inputs, outputs, and computational approach of the Portal Frame Calculator on steelcalculator.app. The interactive calculator is designed to run in your browser for speed, but this documentation is written so the page remains useful (and indexable) even if JavaScript is not executed.

What this tool is for

• Fast screening and iteration while you are exploring a design space.
• Creating a repeatable calculation workflow that a reviewer can audit.
• Learning the terminology and the “shape” of a typical check for portal frame analysis.

What this tool is not for

• It is not a complete design package and does not replace the governing standard, project specification, or an engineer’s judgment.
• It is not a substitute for system-level checks (global stability, constructability, fatigue/seismic detailing, etc.).
• It does not guarantee compliance with any specific standard, because compliance depends on configuration, edition, and jurisdictional requirements.

Key concepts this page covers

• 2D frame element stiffness
• member forces
• drift/deflection indicators

Inputs and naming conventions (high-level)

The calculator UI may present different groupings depending on the selected standard or mode, but inputs generally fall into these categories:

1) Actions / demands
Values that represent the loading on the component you are checking (forces, moments, pressures). Ensure you understand whether the workflow expects factored actions (strength) or service actions (serviceability), and keep that consistent across your verification.

2) Geometry and detailing parameters
Dimensions that define the physical configuration (spacing, thickness, eccentricity, end conditions). Many “unexpected” results come from geometry assumptions that are implicitly different from the real detail.

3) Material properties
Strength values (yield/ultimate), stiffness values (E), and any standard-specific parameters that affect resistance models.

4) Standard / method selection
The same physical configuration can be checked using different methods, with different reduction factors and definitions. A tool can only be unambiguous when you lock down the standard and edition you are matching.

The most common inputs for this tool include: geometry, member E/I, support conditions, load cases.

Outputs you should expect

A well-behaved calculator output should be both summary-friendly and auditable:

• A small set of headline results (pass/fail indicators, utilization ratios, controlling mode).
• Intermediate values that let you reproduce at least one limit state independently (areas, lever arms, coefficients).
• Clear units on every numeric value and a statement of the method used.

If the output is not auditable, treat it as a black box and do not rely on it for anything beyond quick intuition.

Computation approach (what happens under the hood)

This calculator is intended to implement a deterministic sequence of steps:

1. Normalize inputs into a consistent internal unit system (for example, all lengths in meters, all forces in newtons), then convert back for display.
2. Derive secondary parameters that are not explicitly entered (for example, effective areas, lever arms, eccentricities, or effective lengths). These are often where standards differ.
3. Evaluate candidate limit states relevant to portal frame analysis. Each limit state produces a resistance (or allowable) that can be compared to the demand.
4. Compute utilization as a dimensionless ratio (demand divided by resistance, or resistance divided by demand depending on convention). The controlling utilization is the maximum across the evaluated checks.
5. Render the report with intermediate values and the controlling failure mode, so a user can trace “why” the governing mode controls.

The implementation should also apply predictable rounding rules: keep higher precision internally, and only round for display. This is essential for stable regression tests.

Verification workflow (recommended QA steps)

This section is not a design instruction; it is a quality-assurance pattern for checking any engineering calculator.

1. Unit sanity check: confirm that each input has the unit you think it has. A common failure mode is mixing MPa and Pa, or mm and m.
2. Independent replication: pick one limit state (or one equation) and replicate it with an independent method (hand check, spreadsheet, or trusted reference). You are validating the method, not chasing an exact rounded match.
3. Sensitivity test: change one input in a direction that should clearly increase or decrease the capacity (for example, increase thickness) and confirm the output changes logically.
4. Boundary test: test extreme-but-possible values to make sure the UI doesn’t silently overflow, divide by zero, or return NaN/Infinity.
5. Documentation: record the standard/mode, inputs, and the controlling output in a calculation note format so the result can be reviewed later.

For a structured approach, see: How to verify calculator results.

Common pitfalls and how to avoid confusion

• Hidden assumptions: some checks require assumptions that are not explicit in the UI (e.g., end restraint idealization, load distribution, slip requirements). If you can’t state the assumption, do not treat the result as verified.
• Standard mismatch: names like “yield strength” and “ultimate strength” are universal, but how they are used in a resistance model is standard-specific.
• Axis confusion: major/minor axis properties, sign conventions, and local coordinate systems can flip a result.
• Detailing constraints: minimum edge distances, minimum weld sizes, and installation constraints often govern before a strength limit state does.
• Over-trusting a single ratio: a utilization < 1.0 does not prove the detail is acceptable; it only indicates the evaluated checks passed under the tool’s assumptions.

Data handling, privacy, and offline behavior

Steelcalculator.app is designed so that most calculations can run client-side. In a typical configuration:

• Your numeric inputs may be stored in local browser storage to improve UX (so values persist across refreshes).
• A PWA/service worker may cache static assets for performance and offline behavior.
• If analytics are enabled, aggregate usage events may be sent to a third-party provider.

If you are deploying this site, document the exact behavior in the Privacy Policy and ensure that any tracking complies with applicable privacy laws. For more context see /privacy and /terms.

How the Portal Frame Calculator Works

The calculator performs a 2D linear-elastic analysis of a single-bay, single-storey portal frame under gravity and lateral load combinations. The frame consists of two columns and a rafter (beam), connected at the eaves (knee joints) with rigid or pinned connections, and supported at the base with pinned or fixed conditions. The tool assembles the frame stiffness matrix, applies the specified loads, solves for joint displacements and rotations, then back-calculates member forces (axial, shear, moment) and reactions.

The analysis uses the direct stiffness method: each member is represented by a 6-DOF beam element (axial, shear, and moment at each end) with stiffness proportional to EI/L. For fixed-base frames, the base provides three restraint DOFs (vertical, horizontal, and rotational). For pinned bases, the rotational DOF is released, allowing free rotation at the foundation level. The tool outputs bending moment diagrams, shear force diagrams, axial force diagrams, and lateral drift at the eaves level.

Load cases include uniform gravity load on the rafter, concentrated loads, lateral wind load on the columns, and asymmetric load patterns. The calculator evaluates multiple load combinations (typically gravity-only, gravity + wind from each direction, and uplift cases) and reports the envelope of demands for each member.

Key Equations

Lateral drift of a pinned-base portal frame under horizontal load H:

delta_drift = H * h^3 / (12 * E * Ic) + H * h^2 * L / (8 * E * Ir)

Where h = column height, L = span, Ic = column moment of inertia, Ir = rafter moment of inertia. The first term is column bending; the second is rafter flexibility contribution.

Knee moment in a pinned-base portal under uniform gravity load w:

M_knee = w * L^2 / 8 * [1 / (1 + 2*k)]

Where k = (Ir/L) / (Ic/h) = ratio of rafter stiffness to column stiffness. For stiff columns (k small), the knee moment approaches w*L^2/8 (simply supported rafter). For stiff rafters (k large), moment distributes to columns.

Horizontal thrust at base under gravity load (pinned base):

H_base = M_knee / h

Fixed-base portal -- column base moment under uniform gravity w:

M_base = w * L^2 / 8 * [k / (2 + 3*k)]
M_knee = w * L^2 / 8 * [(1 + k) / (2 + 3*k)]

The total rafter midspan moment is reduced by the combined column-end moments.

Lateral drift of a fixed-base portal under horizontal load H:

delta_drift = H * h^3 / (12 * E * Ic) * [1 / (1 + 6*Ic*L / (Ir*h))]

Fixed bases reduce drift by approximately 50-70% compared to pinned bases for the same members.

Rafter midspan moment (pinned-base, uniform gravity w):

M_midspan = w * L^2 / 8 - M_knee

Design Code Requirements

Key difference: AISC requires notional lateral loads equal to 0.2% of the gravity load at each level (the 0.002*Yi provision in C2.2b) to account for frame imperfections. AS 4100 uses a similar geometric imperfection approach (Cl 3.2.4, delta_0 = L/1000). EN 1993-1-1 applies an equivalent initial sway imperfection phi = 1/200 * alpha_h * alpha_m.

Step-by-Step Example

Problem: Analyze a single-bay pinned-base portal frame. Span L = 40 ft, column height h = 16 ft. Uniform gravity load on rafter w = 1.5 kip/ft (factored). Lateral wind load = 0.8 kip/ft on windward column (factored). Columns: W10x33 (Ic = 171 in^4). Rafter: W16x26 (Ir = 301 in^4).

Step 1 -- Stiffness ratio: k = (Ir/L) / (Ic/h) = (301/480) / (171/192) = 0.627 / 0.891 = 0.704.

Step 2 -- Gravity-only knee moment: Mknee = 1.5 * 40^2 / 8 _ [1 / (1 + 20.704)] = 300 * [1/2.408] = 124.6 kip-ft.

Step 3 -- Rafter midspan moment: M_midspan = 300 - 124.6 = 175.4 kip-ft.

Step 4 -- Base horizontal thrust: H_base = 124.6 / 16 = 7.8 kips (pushing outward at each base).

Step 5 -- Wind lateral drift: Total lateral force = 0.8 _ 16 = 12.8 kips. delta = 12.8 _ (1612)^3 / (12 * 29000 _ 171) + 12.8 _ (1612)^2 * (4012) / (8 * 29000 _ 301) = 12.8 _ 7.07810^6 / 5.94910^7 + 12.8 * 1.76910^7 / 6.983*10^7 = 1.523 + 3.240 = 4.76 in.

Drift ratio = 4.76 / (16*12) = 1/40.3. Typical limit = h/400 = 0.48 in. Drift FAILS significantly -- stiffer columns or fixed bases required.

Result: Gravity knee moment = 125 kip-ft, midspan moment = 175 kip-ft. Wind drift = 4.76 in (h/40) far exceeds h/400 limit. Solution: use deeper columns (W12x58, Ic = 475 in^4) or switch to fixed-base portal to reduce drift by 60%.

Common Design Mistakes

• Assuming pinned-base portals can meet typical drift limits: Pinned-base portal frames are inherently flexible. For spans over 30 ft and column heights over 12 ft, meeting h/400 drift limits typically requires either fixed bases or dedicated lateral bracing systems.
• Neglecting the horizontal thrust under gravity load: Even without lateral wind, a portal frame generates outward horizontal thrust at the bases under gravity load. This thrust must be resisted by the foundation (tie rods, slab-on-grade friction, or footing mass). Forgetting this thrust leads to foundation sliding.
• Ignoring second-order (P-Delta) effects: The column axial load acts through the lateral sway displacement, creating additional moment. For flexible portal frames with large drift ratios, P-Delta effects can amplify column moments by 20-40%. AISC C2 requires second-order analysis.
• Using rigid knee connections without checking the connection itself: The analysis assumes a perfectly rigid knee joint, but the physical connection must be detailed and checked to develop the full knee moment. Understiffened knee connections create a semi-rigid joint that increases drift and redistributes moments.
• Not checking rafter axial compression from horizontal thrust: Under gravity load, the rafter carries axial compression equal to the horizontal base thrust. This compressive force must be combined with the rafter bending moment in a beam-column interaction check (AISC H1-1).
• Selecting columns based on bending only: Portal frame columns are beam-columns under combined axial load and bending. The interaction equation often controls column selection more severely than either force component alone.

Frequently Asked Questions

How does a fixed base change moment distribution compared to a pinned base? A pinned base provides a vertical and horizontal reaction but zero moment resistance, so the column moment is zero at the base and the full overturning moment from lateral load must be carried by frame action through the knee joint and rafter. A fixed base resists moment at the foundation, which reduces the column moment at the knee and the rafter moment at midspan — distributing the demand more efficiently and typically allowing lighter frame members. However, fixed bases require larger and more expensive base plates and anchor bolts, and impose significant moment demands on the foundation.

What causes sway in a portal frame under lateral wind or seismic load? Sway occurs because the lateral load applied to the frame has no direct resisting mechanism other than bending stiffness of the columns and the moment connections at the knee joints. Unlike a braced frame, a portal frame is a moment-resisting frame where lateral stiffness comes entirely from the EI of the columns and the rigidity of the rafter-to-column connections. Pinned-base portals are more flexible than fixed-base ones; increasing column depth (thus column I) is the most effective way to reduce sway, since drift is inversely proportional to column stiffness.

How are column and rafter moments related in a symmetric portal frame under gravity load? In a symmetric portal frame with symmetric gravity loading, the knee joints are points of equal moment by symmetry. The moment at the top of each column equals the moment at the end of each rafter at the knee, because they share the same rigid joint. The gravity load on the rafter induces a horizontal thrust at the base of each column (inward, compressing the frame), and the column moment diagram is approximately linear from zero at a pinned base to the knee moment at the top. This means that for gravity-only loading, the column is subject to combined axial compression and bending — a beam-column check is required.

When should a haunch be used at the knee joint of a portal frame? A haunch (a tapered deepening of the rafter at the eaves) is used when the bending moment at the knee joint is the largest in the frame, as it typically is under gravity plus wind combinations. Increasing the rafter depth at the knee reduces the extreme-fibre bending stress and increases the section modulus locally where demand is highest. Haunches also improve lateral-torsional buckling resistance at the critical section and allow a more efficient distribution of steel — a shallow uniform rafter throughout plus a haunch at the knee often weighs less than a uniform rafter deep enough to resist the knee moment everywhere.

How do gravity loads and lateral loads combine in portal frame design? Portal frames are commonly designed for several governing load combinations: gravity only (dead + live or dead + snow), gravity plus wind from each direction, and uplift cases (wind uplift minus dead load). The critical combination for column moment and sway is usually dead + live + full wind from the controlling direction. Under wind uplift on the rafter, the frame can reverse its moment diagram relative to gravity-only loading, so both sagging and hogging moment demands must be considered for every member. LRFD combinations per ASCE 7 or equivalent govern the factored demands entered into the frame analysis.

What effective length factor should I use for portal frame columns? The effective length factor K for a portal frame column depends on the base condition and the degree of restraint provided by the rafter. For a pinned-base portal with a rigid knee connection to a relatively stiff rafter, K about the in-plane axis is typically between 1.2 and 2.0 depending on the rafter-to-column stiffness ratio; for a fixed-base portal, K is typically 0.7 to 1.0 in-plane. Out-of-plane buckling is governed by the spacing of fly-braces or girts that restrain the column flange, and often controls the design of lightly loaded or slender portal columns.

Related pages

• Wind load calculator
• Beam calculator
• Beam capacity calculator
• Section properties database
• Unit converter
• Tools directory
• Reference tables directory
• Guides and checklists
• How to verify calculator results
• Disclaimer (educational use only)
• column buckling capacity calculator
• Wind Load Workflow
• Braced Frame
• Shear wall calculator

Disclaimer (educational use only)

This page is provided for general technical information and educational use only. It does not constitute professional engineering advice, a design service, or a substitute for an independent review by a qualified structural engineer. Any calculations, outputs, examples, and workflows discussed here are simplified descriptions intended to support understanding and preliminary estimation.

All real-world structural design depends on project-specific factors (loads, combinations, stability, detailing, fabrication, erection, tolerances, site conditions, and the governing standard and project specification). You are responsible for verifying inputs, validating results with an independent method, checking constructability and code compliance, and obtaining professional sign-off where required.

The site operator provides the content “as is” and “as available” without warranties of any kind. To the maximum extent permitted by law, the operator disclaims liability for any loss or damage arising from the use of, or reliance on, this page or any linked tools.