@ferscloud/fers-calculation-web 0.2.58 → 0.2.60

package/fers-models.d.ts

@@ -56,6 +56,11 @@ export interface components {
         AnalysisOptions: {
             /** Format: double */
             axial_slack?: number;
+            /**
+             * @description Declarative only; the solver always assembles the full 3D formulation.
+             *     A planar model must restrain its out-of-plane DOFs at every node itself
+             *     — see [`Dimensionality`].
+             */
             dimensionality: components["schemas"]["Dimensionality"];
             /**
              * @description When true, the engine generates self-weight (dead load) for every member
@@ -225,6 +230,16 @@ export interface components {
          *     results are reported in `results.buckling_runs` (with
          *     `results.buckling` carrying the first successful run for backward
          *     compatibility).
+         *
+         *     **The eigenvalue is mesh-sensitive, unlike the rest of the bundle.**
+         *     Reactions and the internal forces recovered along a member come out exact on
+         *     one element for a straight prismatic member; α_cr does not. A buckling
+         *     half-wave cannot form on a single cubic element — its consistent geometric
+         *     stiffness gives `12EI/L²` against Euler's `π²EI/L²`, so α_cr comes out about
+         *     **21 % high, which is unconservative**. Two elements per member are within
+         *     0.75 %, four within 0.05 %. Mesh compressed members into at least four
+         *     elements; the solve stays in the millisecond range. A run left on one element
+         *     raises `buckling_unrefined_mesh` in [`crate::models::results::modalresult::BucklingResults::warnings`].
          */
         BucklingAnalysisSettings: {
             /**
@@ -494,7 +509,21 @@ export interface components {
          */
         DensityUnit: "kg/m3" | "kg/mm3";
         /**
-         * @description Python:
+         * @description **Declarative only — the solver does not branch on this.** The formulation
+         *     is always the full 3D beam with 6 structural DOFs (plus warping) per node,
+         *     whichever value is given.
+         *
+         *     So a planar model is planar only because the caller made it so: it must
+         *     restrain the out-of-plane DOFs — `Z`, `RX` and `RY` for an XY model — on
+         *     **every node**, not just at the supports. Leave them free and the
+         *     out-of-plane subsystem is unrestrained, which is either a singular stiffness
+         *     matrix or, worse, a solve that succeeds with movement nobody asked for; see
+         *     the `singular_model` diagnostic.
+         *
+         *     The field is required because the payload has to carry something, and it is
+         *     kept because dropping it would break every existing caller for no gain.
+         *
+         *     Python:
          *     class Dimensionality(Enum):
          *         TWO_DIMENSIONAL = "2D"
          *         THREE_DIMENSIONAL = "3D"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ferscloud/fers-calculation-web",
   "type": "module",
-  "version": "0.2.58",
+  "version": "0.2.60",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",