Skip to main content

frame_portal/
frame_portal.rs

1//! 2D frame analysis with the `FrameModel` façade.
2//!
3//! Demonstrates: node/member handles, support vocabulary (fixed bases), a
4//! global nodal load, a **local** member distributed load, solving with an
5//! explicit backend, typed result access, and the global equilibrium report.
6//!
7//! Conventions (unchanged from the Beam FEM core):
8//! nodal loads and moments are GLOBAL; member loads are LOCAL.
9
10use section_properties::frame::FrameModel;
11use section_properties::{BeamSection, Dof, Material, SolverSelection};
12
13fn main() -> Result<(), Box<dyn std::error::Error>> {
14    let (e, a, i) = (200e9, 5e-3, 2e-5);
15    let (h, w) = (3.0, 4.0);
16    let lateral = 20e3; // N, +X
17    let udl = -8e3; // N/m, downward in member-local +y
18
19    // --- model -----------------------------------------------------------------
20    let mut frame = FrameModel::new();
21    let base_left = frame.add_node(0.0, 0.0)?;
22    let top_left = frame.add_node(0.0, h)?;
23    let top_right = frame.add_node(w, h)?;
24    let base_right = frame.add_node(w, 0.0)?;
25
26    let section = BeamSection::new(a, i);
27    let mat = Material::new(e, 0.3, 7850.0, "Steel");
28    let col_left = frame.add_member(base_left, top_left, mat, section)?;
29    let beam = frame.add_member(top_left, top_right, mat, section)?;
30    let col_right = frame.add_member(top_right, base_right, mat, section)?;
31
32    frame.fix(base_left)?;
33    frame.fix(base_right)?;
34    frame.nodal_load(top_left, lateral, 0.0)?; // global
35    frame.member_udl(beam, 0.0, udl)?; // local
36
37    // --- solve -----------------------------------------------------------------
38    let result = frame.solve_with(SolverSelection::named("sparse_lu"))?;
39    println!("backend              : {:?}", result.solver_name());
40    println!(
41        "nodes / members      : {} / {}",
42        result.n_nodes(),
43        result.n_members()
44    );
45
46    // --- results ---------------------------------------------------------------
47    println!(
48        "roof sway (ux)       : {:+.6e} m",
49        result.displacement(top_left, Dof::Ux)?
50    );
51    println!(
52        "base reactions       : Rx={:+.6e}  Ry={:+.6e}  Mz={:+.6e}",
53        result.reaction(base_left, Dof::Ux)?,
54        result.reaction(base_left, Dof::Uy)?,
55        result.reaction(base_left, Dof::Rz)?
56    );
57    println!(
58        "right base reaction  : Rx={:+.6e}  Ry={:+.6e}",
59        result.reaction(base_right, Dof::Ux)?,
60        result.reaction(base_right, Dof::Uy)?
61    );
62
63    // Member end forces are element-on-node forces in LOCAL axes:
64    // [N_i, V_i, M_i, N_j, V_j, M_j] = f_equiv - K_e u_e.
65    println!(
66        "beam end forces (local)  : {:?}",
67        result.member_end_forces(beam)?
68    );
69    println!(
70        "left column global ends  : {:?}",
71        result.member_end_forces_global(col_left)?
72    );
73    println!(
74        "right column global ends : {:?}",
75        result.member_end_forces_global(col_right)?
76    );
77
78    // --- equilibrium -----------------------------------------------------------
79    let eq = result.equilibrium();
80    println!(
81        "equilibrium residual : sumFx={:+.3e}  sumFy={:+.3e}  sumMz={:+.3e}  (about the origin)",
82        eq.fx_residual, eq.fy_residual, eq.mz_residual
83    );
84    println!("balanced             : {}", eq.is_balanced());
85
86    Ok(())
87}