SWBPIPE · The open manual
Part IV · Modelling GuideIV–1

Part IV

Modelling Guide

A. Building a model

A model represents the pipe centerline, with sizes, materials, components, supports and loads attached. SWBPIPE does not supply missing engineering inputs. A required value that is absent stops the solve. The diagnostic identifies the missing input.

1.Units and geometry.

Every quantity has an entered unit. Consumed values are converted to SI for the solve. The node table defines the model geometry, and the drawing follows those rows.

Put nodes at every change of direction, support, component and branch. Also put nodes at every change of size, material or temperature, and wherever you want a result. Long straight runs need no intermediate nodes for accuracy under the exact beam assumptions of end loads and consistent span loads. Intermediate nodes provide intermediate results.

Today

Nodes are entered with absolute coordinates. Readouts offer Entered, SI and US display units where conversion is available. Editing retains entered units. Display preferences do not change the model’s authored units (Status).

2.Pipe sizes.

Each pipe has its nominal outside diameter and wall thickness, entered directly or through a defined section. For weight, give pipe, contents and insulation densities, and the insulation thickness. Corrosion and other allowances reduce the section for stress only.

Today

There are no pipe schedule tables to select from (Status). Mill tolerance also reduces the wall used for stiffness and weight. Leave it out (Status).

3.Materials.

Material inputs depend on the selected model contract. The ordinary route uses entered elastic and shear moduli and thermal expansion data. Enter these properties at the temperatures you need. When an ordinary case selects a temperature basis, it uses one named point or supported interpolation. It never extrapolates.

Exact pressure and model 0.4.0 load/reference states require explicit elastic modulus E and Poisson ratio ν. These routes derive the shear modulus.

Model 0.4.0 selects each member’s actual material basis explicitly. It uses base properties, an exact point or supported temperature interpolation. It refuses extrapolation. Installation, operating temperature and thermal/fit definitions are explicit states. Recorded shear modulus and expansion data do not substitute for E/ν. For a code range, the reference modulus basis is the value required by that code (Part II D).

Part IV · Modelling GuideIV–2

B. Components

ComponentHow to model it
Bend or elbowRadius, angle, flexibility factor k, and in-plane and out-of-plane SIFs from the code you work to (Part II E). The explicit curved_bend_macro_element mode carries entered k in its stiffness on ordinary preview-physics-1. The legacy mechanics_geometry_only mode uses the chord. Realized arcs have no published governing stress maximum (Status).
Tee or branchHeader and branch meet at one node. Enter the SIFs for the connection type; the branch SIF is applied with the branch section. Today: no local junction flexibility. With mechanics_geometry_only tee/branch records, the ordinary route can publish a separate user equal-factor intensified bending measure. The straight member end must match the declared header or branch pipe reference. It uses that member’s section modulus and the corresponding positive user-entered SIF. It is not a code stress (Status).
Valve, flange, rigidLength, weight and center of gravity; modeled as a rigid element. Today: not yet a rigid element, and the weight is not added: enter it as a point force at the center of gravity (Status).
ReducerThe two end sizes over its length. Today: model it as a short pipe of the smaller size (Status).
Expansion jointAxial, lateral, angular and torsional stiffness, effective area, and whether it is tied. Today: do not model expansion joints (Status).
Part IV · Modelling GuideIV–3

C. Supports, hangers and nozzles

Model each support as built, with its actual physical behavior. A shoe on a steel beam is a rest with friction. Lugs may also make the shoe a guide. A rod hanger carries tension only. A trunnion on a beam is a stub from the centerline to the support point, with a rest at its end.

SupportWhat to enter
AnchorRigid, or the stiffnesses of the structure it is fixed to.
Rest, guide, line stopThe type, the clearance on each side, and the friction coefficient where the pipe slides (Part II H).
Variable spring hangerRate and cold (installed) load, from your hanger design (Part II I).
Constant support hangerThe load it carries.
Equipment nozzleAn anchor at the nozzle face, or an anchor with the nozzle’s flexibility, and the equipment’s thermal growth there as an imposed movement for each operating case (Part II J).
Today

Restraints use global directions. A guide or line stop on a skewed run has no general local restraint-axis model (Status). Friction uses separate global-axis support laws and a compatible normal-force source (Status). Spring preload and complete hanger design remain unsupported (Status).

Model a designed hanger as a force in the weight case. Do not also count the same load through a constant-effort declaration or duplicate applied force. Constant effort is an applied force, not a rigid restraint; mechanics combinations are withheld when their factor sum would count that force incorrectly (Status).

Model 0.4.0 supports explicit rigid boundary translations and rotations at already restrained DOFs. It refuses spring base motions, device preload/reference laws, inactive or locked participation, and per-case mass states. Legacy imposed_displacement is refused (Status). The joint equilibrium defect remains contained: the ordinary route refuses nonzero lateral stiffness over a nonzero span without the required rigid-body moment coupling.

A model needs enough restraint to prevent rigid-body movement in every direction. When numerical checks detect a mechanism or insufficient restraint, the solve is blocked. Diagnostics identify the detected problem. A solved result does not prove physical stability. Examine the largest movement and rotation in every case. Read the numerical admission and coverage limits.

Part IV · Modelling GuideIV–4

D. Load cases for a typical job

Build the basic loads first. Then construct the cases needed for the code check. The following tables describe a line with one operating condition.

Basic loadWhat it contains
WWeight of pipe, contents, insulation and components.
P1Design or operating pressure.
T1Temperature change from installation to operation, with the equipment movements that go with it.
WIN, EQWind and static seismic, each direction and sense its own load.
CaseHow it is formed
Sustained (SUS)W + P1, solved in the support state of the operating case where supports lift off.
Operating (OPE)W + T1 + P1, solved with its nonlinear supports. Gives hot support and nozzle loads, and movements.
Expansion (EXP)OPE − SUS, an algebraic difference of forces and moments. Gives the displacement stress range.
Occasional (OCC)SUS with each wind or seismic load added in turn.
HydrotestWater-filled weight and test pressure, with spring hangers locked.

Each operating condition has its own OPE case. The expansion range is formed between the extreme states. Part II C and D explain this distinction.

Today

Nonzero legacy pressure is refused. Do not put it in an ordinary solved case (Status). The native entrypoint run_linear_static_preview_with_mode supports the separate exact_straight_pressure_v2 contract 2.0.0 for models 0.3.0 and 0.4.0; model 0.4.0 requires it. It needs explicit pressure regions, member ownership, two physical terminals with closure transfer, E/ν, and the declared internal_differential_zero_external_v1 basis. Pressure units do not select gauge or absolute reference.

This route supports straight circular members, linear restraints and springs. It refuses component records, nonlinear or constant-effort supports, and combinations. Broader pressure and arc mechanics remain unfinished. SWBPIPE does not automatically construct the code cases above (Status). Ordinary mechanics combinations are withheld for nonlinear supports, mixed moduli, or incorrect constant-effort factor sums. An explicit result-state subtraction is a labeled difference, not an equilibrium state (Status). Hydrotest pressure and full locked-hanger behavior remain unsupported (Status).

Part IV · Modelling GuideIV–5

E. Code data you enter

SWBPIPE supplies no code tables. Enter flexibility factors, SIFs, component dimensions and allowables from the applicable codes and catalogs. For the B31 codes, use ASME B31J for SIFs and flexibility factors. Use owner and manufacturer data for components and hangers. The classical forms in Part II E provide a comparison for entered data.

The ordinary curved-bend mode uses k in stiffness. With mechanics_geometry_only bend markers or tee/branch records, the ordinary route can publish a separate user equal-factor intensified bending measure. It applies at adjacent straight member ends; tee/branch ends must match the declared header or branch pipe reference. Each end uses its member section modulus and the corresponding positive user-entered SIF.

A realized curved-bend component supplies no such measure on its arc or straight neighbors. This measure never multiplies stress by k and is not a code stress. User formula criteria can evaluate intervals, but a formula gate is not standards approval. SWBPIPE supplies no built-in code classification or allowable. The code check is made in the program used for validation (Part V).

You can keep material, section, component and hanger data in private libraries. You can keep projects in a local store. These local data remain on your machine.

Today

The native desktop can validate and save accepted private library imports in a project-scoped local store. The browser preview has no substitute validator or store. Importing a library does not automatically populate the mechanics model (Status). Workflows that prepare and maintain libraries from private spreadsheets and data sheets remain in development.

Part IV · Modelling GuideIV–6

F. Checking a model

Check the model before reading its results. Short diagnostic runs can reveal model errors.

  • Movements first. Look at the largest displacement and rotation in every case. Meters of movement or whole radians of rotation indicate a possible mechanism or unit error. Investigate these values (Status).
  • Weight balance. In the weight case with every rest acting, the vertical support loads add up to the total weight entered.
  • Free growth. Hold the line at one anchor only and apply the thermal case. For uniform unconstrained thermal strain, each node should move by αΔT times its position vector from the anchor. Member forces should be zero. Other restraints, nonuniform strain or imposed boundary motions change this expectation.
  • Order of magnitude. Compare the thermal load on a leg with the guided-cantilever estimate of Part II A. A result ten times larger or smaller needs explaining.
  • Support states. In each nonlinear case, read which rests have lifted off, which gaps have closed and which shoes slide. Ask whether the line would behave that way.
  • The validating program. The final check is the model in the program you validate in, compared result by result (Part V C).

Contents · Part III · Part V · The program: swbpipe.com · MIT license