Skip to main content

FrameAnalysisResult

Struct FrameAnalysisResult 

Source
pub struct FrameAnalysisResult { /* private fields */ }
Expand description

Solved frame: frame-level access to displacements, reactions, member end forces and global equilibrium.

All values come from the existing BeamSolver; nothing is recomputed with a second formulation.

Implementations§

Source§

impl FrameAnalysisResult

Source

pub fn solver_name(&self) -> Option<&str>

Name of the backend used by the successful solve.

Examples found in repository?
examples/frame_portal.rs (line 39)
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}
Source

pub fn n_nodes(&self) -> usize

Number of nodes in the solved frame.

Examples found in repository?
examples/frame_portal.rs (line 42)
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}
Source

pub fn n_members(&self) -> usize

Number of members in the solved frame.

Examples found in repository?
examples/frame_portal.rs (line 43)
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}
Source

pub fn displacements(&self) -> &[f64]

Full global displacement vector, laid out [ux, uy, rz] per node.

Source

pub fn reactions(&self) -> Vec<f64>

Global support reactions, laid out [Rx, Ry, Mz] per node.

Source

pub fn displacement(&self, node: NodeHandle, dof: Dof) -> Result<f64, FemError>

Displacement of a DOF at a node (global).

§Errors

FemError::InvalidNode if the handle is not valid for this frame.

Examples found in repository?
examples/frame_portal.rs (line 49)
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}
Source

pub fn reaction(&self, node: NodeHandle, dof: Dof) -> Result<f64, FemError>

Support reaction of a DOF at a node (global).

Free DOFs report the raw (round-off) residual, exactly as BeamSolver::reaction_dof does.

§Errors

FemError::InvalidNode if the handle is not valid for this frame.

Examples found in repository?
examples/frame_portal.rs (line 53)
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}
Source

pub fn member_end_forces( &self, member: MemberHandle, ) -> Result<[f64; 6], FemError>

Member end forces in local axes: [N_i, V_i, M_i, N_j, V_j, M_j].

These are element-on-node forces, f_end = f_equiv - K_e u_e, exactly as documented in docs/beam_fem.md; the sign convention is not inverted for the frame API.

§Errors

FemError::InvalidMember if the handle is not valid for this frame.

Examples found in repository?
examples/frame_portal.rs (line 67)
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}
Source

pub fn member_end_forces_global( &self, member: MemberHandle, ) -> Result<[f64; 6], FemError>

Member end forces transformed to global axes (f_global = Tᵀ f_local).

§Errors

FemError::InvalidMember if the handle is not valid for this frame.

Examples found in repository?
examples/frame_portal.rs (line 71)
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}
Source

pub fn equilibrium(&self) -> EquilibriumReport

Global equilibrium check about the origin (0, 0).

Combines support reactions, global nodal loads and moments, and the global resultants of member distributed and point loads (transformed from member-local axes and applied at their true global locations). See EquilibriumReport.

Examples found in repository?
examples/frame_portal.rs (line 79)
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}

Trait Implementations§

Source§

impl Debug for FrameAnalysisResult

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.