LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.
Methodology
Purpose and model boundary
This calculator analyses a 2D frame with rigid joints drawn on the page: a portal, a gable or mono-slope frame, a multi-span frame or a simple beam. You set pinned, fixed or roller supports and load it at the nodes or along whole members (gravity, wind, snow by projection, or normal to a member). It returns the support reactions, each node's displacement and rotation, and each member's axial force, shear and bending moment along its length with exact extremes, the deflected shape and the drift.
It is a linear elastic analysis only, for learning and estimating. It makes no strength, stability, second-order, load-combination, drift-limit or code check, and it gives no verdict on any frame. The drift ratio is for information only and is not compared with any limit.
The model is the calculation authority. The page sends the drawn geometry and the values you type to the model and draws only what the model returns; it computes no engineering value itself.
Inputs and units
- Nodes, members and supports are drawn on the canvas: up to 20 nodes, 30 members and 10 supports. Every joint is a rigid (moment) joint, and each member is straight and prismatic. Pin holds a node horizontally and vertically, Fixed also stops it rotating, and Roller holds it vertically only; there is one support row per supported node.
- Sections are defined in the Sections grid, up to 12: a name, a profile (I, C, L, HSS, PIPE, RECT, or PROPS to type the area A and the moment of inertia Ix yourself) and the dimensions that profile reads. Members bend in the frame's plane about the section's x axis (depth d vertical). The model returns each section's A, Ix and weight per length.
- Loads are drawn on the canvas: up to 20 loads at nodes (a horizontal force, a vertical force and a moment; a blank component is zero) and 30 uniform loads along whole members. A member load acts along X or Z per unit of member length, along X or Z per unit of the member's vertical or horizontal projection (wind, snow), or at right angles to the member. A point load inside a member is placed by splitting the member at a node on the canvas.
- Material: the modulus of elasticity E, used for every member (about 29,000 ksi or 200,000 MPa for structural steel), and an optional density. With a density the model gives the member weights; Include the self-weight adds each member's own weight as a downward load along its length.
- Units: US works in feet, kips and inches for section dimensions; Metric in metres, kilonewtons and millimetres. Every value you type and every result follows this choice; nothing is converted.
Sign conventions: X is horizontal to the right and Z is up. In the model, loads are positive along +X, +Z or the member's local +y, so gravity is negative, and moments and rotations are counterclockwise positive. The canvas lets you type a vertical load as a downward size and a moment as a clockwise size, and sends them with the model's signs.
Governing relationships
- The frame is solved by linear elastic 2D frame theory, the direct stiffness method, with finite axial stiffness (EA), so axial shortening of the members is included.
- Equilibrium: the reactions plus the loads add up to zero, horizontally, vertically and in moment about the origin, up to rounding.
- The degree of static indeterminacy is three times the members plus the restrained support directions, minus three times the nodes. Zero means the frame is statically determinate.
- The drift ratio is the height of the node that moves sideways the most, above the lowest support, divided by its sideways displacement, so 150 means H/150.
Calculation sequence
- The model checks the frame before it solves it. The members must form one connected frame, and the supports must hold it against all three rigid-body motions (sideways, up and down, and turning). An unstable, disconnected or invalid frame reads NOT VALID with the first input to fix, and every result is then blank.
- It solves the frame by linear elastic 2D frame theory with finite axial stiffness (EA), so axial shortening of the members is included.
- It reports the reactions, the node displacements and rotations, and the member end forces. It also gives eleven points along each member (its start, every tenth of its length and its end), from which the canvas draws the axial force, shear and moment diagrams and the deflected shape.
- The largest positive and the most negative moments are exact: they are found at the member ends or where the shear is zero. The largest vertical displacement is the largest of the sampled points.
- It reports the equilibrium residuals (the reactions plus the loads), which should be zero up to rounding, the degree of static indeterminacy, and the totals of the loads, reactions, member lengths and member weights.
Outputs and interpretation
- Reactions: for each support, the horizontal force RX, the vertical force RZ and, for a fixed support, the moment MY that the support applies to the frame, with their sums.
- Node results: each node's horizontal and vertical displacement (right and up positive) and rotation (radians, counterclockwise positive); the largest sideways displacement, its node, its height and the drift ratio.
- Member results: each member's length, weight, axial force N, shear V and moment M at its start and end, and its largest and smallest moment with their distances from the start node; the largest axial force, the largest compression, the largest shear, the largest positive and most negative moments and the largest sampled vertical displacement, each with its member.
- Totals: the applied horizontal and vertical loads, the total member length and weight, the counts of nodes, members and supports, and the section properties.
Member forces are internal forces. N is tension positive. A positive bending moment puts the side to the right of the member's start-to-end direction in tension (sagging, for a member drawn left to right). Reactions are what the supports apply to the frame. A roller's horizontal reaction and the moment at a support that is not fixed do not apply and read blank, never zero.
Validation and status logic
The status reads OK when the frame was analysed, or NOT VALID followed by the first input to fix. Every result is blank under NOT VALID; the node, member and support IDs still echo.
Assumptions and limitations
- Linear elastic analysis only: no strength, stability, second-order, load-combination, drift-limit or code check.
- One modulus of elasticity for every member; each member is straight and prismatic, and every joint is rigid.
- Member loads are uniform along whole members; the model has no interior point loads.
- The member diagrams are drawn from eleven sampled points per member; the moment extremes are exact, but the largest vertical displacement is the largest sampled value.
- Because axial deformation is modelled, the base shears of a symmetric portal under a sway load are not exactly equal.
- maxMoment and minMoment read blank when no member has a moment of that sign.
Restrictions and non-computing states
- E is between 10 and 100,000 ksi, or 70 and 700,000 MPa.
- The density is above 0 and at most 1,600 lb/ft³ or 25,000 kg/m³; including the self-weight needs a density.
- Node coordinates are from -1,000 to 1,000 ft; node IDs must differ (ignoring letter case), and no two nodes may be at the same point.
- A nodal load is at most 1,000 kip in force and 10,000 kip-ft in moment, either way; a member load is at most 50 kip/ft either way, with a direction of GlobalX, GlobalZ, ProjectedX, ProjectedZ or Normal.
- Each member joins two different nodes from the node table, names a section from the Sections table, does not repeat another member's two nodes, and is not shorter than 1/500 of the longest member.
- Every node is connected to a member, the members form one connected frame, there is at least one support and at most one support row per node, and a section's thicknesses fit inside its outline.
Errors and warnings
Each NOT VALID status names the first input to fix, for example "the frame is unstable: it needs a pin or a fixed support to hold it sideways", "the frame is unstable: its supports let it move or rotate", "the members do not form one connected frame", "member B1 names section XX, which is not in the Sections table" or "node N5 is not connected to any member".
References
The governing method is linear elastic 2D frame theory: the direct stiffness method for plane frames with rigid joints, prismatic Euler-Bernoulli members and finite axial stiffness. Each member's 6 x 6 stiffness matrix is rotated by its direction cosines and assembled by node, uniform member loads enter as fixed-end forces, and the member end forces follow from the solved displacements. Displacements along a member use cubic Hermite shape functions. The frame's connectivity is checked with the matrix-tree theorem. Section properties come from idealized sharp-corner outlines by component rectangles and the parallel-axis theorem; no shape table is used.
Sources and further reading
- The direct stiffness method for plane frames, including member stiffness in local and global axes, fixed-end forces and member end forces: A. Kassimali, Matrix Analysis of Structures, 3rd edition, Cengage Learning, 2022, chapter 6, Plane Frames. Publisher page
- Plane frame analysis by the stiffness method: R. C. Hibbeler, Structural Analysis, 11th edition, Pearson, 2024, chapter 16, Plane Frame Analysis Using the Stiffness Method. Publisher page
- The stiffness analysis of frames, including the member stiffness relations and the solution of the global equations: W. McGuire, R. H. Gallagher and R. D. Ziemian, Matrix Structural Analysis, 2nd edition, 2000. Free edition from Bucknell University
- The matrix-tree theorem, by which a cofactor of a graph's Laplacian matrix counts its spanning trees, used to check that the members form one connected frame: E. W. Weisstein, "Matrix Tree Theorem", MathWorld, Wolfram Research. MathWorld
- Centroids, second moments of area and the parallel-axis theorem, used for the section properties: B. J. Goodno and J. M. Gere, Mechanics of Materials, 9th edition, Cengage Learning, 2018, appendix D, Review of Centroids and Moments of Inertia. Publisher page
No table, chart or text from any of these publications is reproduced, and none of their authors or publishers has reviewed or endorses this calculator.
Its results were checked against two independent methods: closed-form textbook solutions for fixed and pinned portals, cantilevers and the simple beam, and an independent exact direct stiffness solution of each test frame.
The results are not a frame design. Applicable design codes and a qualified engineer govern real structures.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.