@ferscloud/fers-calculation-web 0.2.45 → 0.2.47

package/fers-models.d.ts

@@ -421,6 +421,25 @@ export interface components {
              * @default 0
              */
             c3: number;
+            /**
+             * Format: double
+             * @description Equivalent uniform moment factor override for lateral-torsional buckling
+             *     (`C_mLT`). When omitted it is computed (Annex A) or taken as the
+             *     major-axis `C_m` (Annex B).
+             */
+            cm_lt?: number | null;
+            /**
+             * Format: double
+             * @description Equivalent uniform moment factor override for major-axis bending
+             *     (`C_my`; Annex A Table A.2 `C_my,0`-based value or Annex B Table B.3).
+             *     When omitted it is computed from the member's actual moment diagram.
+             */
+            cmy?: number | null;
+            /**
+             * Format: double
+             * @description Equivalent uniform moment factor override for minor-axis bending (`C_mz`).
+             */
+            cmz?: number | null;
             /**
              * Format: double
              * @default 1
@@ -758,9 +777,11 @@ export interface components {
         Member: {
             /**
              * Format: double
-             * @description Optional user-supplied buckling reduction factor χ (EN 1993-1-1 §6.3).
-             *     Currently informational: the EC3 unity-check evaluator computes its own χ
-             *     from the section's buckling curve and does not yet read this override.
+             * @description Optional user-supplied flexural buckling reduction factor χ
+             *     (EN 1993-1-1 §6.3). When set, the EC3 unity-check evaluator replaces the
+             *     section-curve χ with this value for BOTH flexural axes (the modeller
+             *     owns the override); the slenderness λ̄ used by the §6.3.3 interaction
+             *     stays physical.
              */
             chi?: number | null;
             /**
@@ -963,8 +984,15 @@ export interface components {
          *       `[start, …section_forces…, end]` raw therefore draws a `value → −value` sawtooth;
          *       use [`MemberResult::internal_force_series`] (which negates the end node) for a
          *       continuous diagram, or negate `local_end_forces` yourself.
-         *     - **Components.** Axial `fx` is **tension-positive**; `fy`/`fz` are shears, `mx` is
-         *       torsion, `my`/`mz` are bending moments, `bw` is the warping bimoment.
+         *     - **Components.** `fx` is axial, `fy`/`fz` are shears, `mx` is torsion, `my`/`mz`
+         *       are bending moments, `bw` is the warping bimoment.
+         *     - **Axial sign caveat.** In the continuous internal series (`local_start_forces`,
+         *       `section_forces`, negated `local_end_forces`) axial `fx` comes out
+         *       **compression-positive / tension-negative**: the end-force recovery
+         *       `q = k·u − f_eq` yields `local_start_forces.fx = −T` for a member in tension
+         *       `T`, and the interior sections inherit it. Consumers that need a
+         *       tension-positive axial value (e.g. code checks classifying compression) must
+         *       flip the sign of the series value.
          */
         MemberResult: {
             /**
@@ -1030,9 +1058,16 @@ export interface components {
         MemberSet: {
             /**
              * Format: double
-             * @description Buckling-length overrides for code checks (EN 1993-1-1 §6.3). When absent,
-             *     the unity-check evaluator derives L_cr from `buckling_restraints` spacing.
-             *     Explicit lengths (m) take precedence over the factors.
+             * @description Torsional buckling length `l_T` for `N_cr,T` (model length units). When
+             *     absent, derived from the torsional `buckling_restraints` spacing, else
+             *     the LTB length.
+             */
+            buckling_length_t?: number | null;
+            /**
+             * Format: double
+             * @description Buckling-length overrides for code checks (EN 1993-1-1 §6.3), in **model
+             *     length units**. Precedence per axis: explicit length → effective-length
+             *     factor → `buckling_restraints` spacing → member length.
              */
             buckling_length_y?: number | null;
             /** Format: double */
@@ -1049,7 +1084,11 @@ export interface components {
             classification?: string | null;
             /**
              * Format: double
-             * @description Effective-length factor K_y (L_cr,y = K_y · L) when no explicit length given.
+             * @description Effective-length factor K_y (L_cr,y = K_y · L) when no explicit length
+             *     given. NOTE: `L` here is the individual FE member's length (a
+             *     sub-member length when the beam is split), whereas restraint-derived
+             *     lengths measure along the whole physical chain — prefer explicit
+             *     lengths or restraints for split members.
              */
             effective_length_factor_y?: number | null;
             /** Format: double */
@@ -1058,7 +1097,9 @@ export interface components {
             id: number;
             /**
              * Format: double
-             * @description Unrestrained length for lateral-torsional buckling (m).
+             * @description Unrestrained length for lateral-torsional buckling (model length units).
+             *     When absent, derived from the torsional `buckling_restraints` spacing,
+             *     else the member length.
              */
             ltb_length?: number | null;
             /** @description Ids of the members (in `FERS.members`) that make up this beam. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ferscloud/fers-calculation-web",
   "type": "module",
-  "version": "0.2.45",
+  "version": "0.2.47",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Jeroen124/FERS_calculations.git"