Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

ANYfeSolver finite-element solver

Alpha preview. This release introduces the renamed Python packages. The solver has open shell equilibrium and checkpoint replay failures. Use it for migration testing. Verification results.

anyfesolver is a headless structural FE solver for beam, shell, stiffened-panel, and cylindrical-shell analysis. It is an engineering solver with an explicit qualification scope, not a general-purpose CAD, contact, or fracture platform.

Start with the documentation guide and current development status for maintained entry points, recent integrations, open limits and the historical evidence map.

Install the released package with:

python -m pip install ANYfeSolver

For coordinated local development across sibling repositories, install the checkouts first:

python -m pip install -e C:\Github\ANYmaterial
python -m pip install -e C:\Github\ANYmesh
python -m pip install -e C:\Github\ANYfileIO
python -m pip install C:\Github\ANYfeSolver\packages\results
python -m pip install -e C:\Github\ANYfeSolver

Installation and migration

ANYfeSolver 0.5 uses the independent ANYfeSolver-results 2.2 runtime, ANYmaterial 0.2, ANYmesher 0.4–0.5 and ANYfileio 0.3.3 or later in the 0.3 line. Install the results distribution alone for NumPy-only offline recovery. The migration guide covers renamed Python imports and upgrades from ANYsolver.

For the marine-excitation or marine-morison extra, install the corresponding ecosystem sibling checkout before requesting the extra:

python -m pip install -e C:\Github\ANYhydro
python -m pip install 'ANYfeSolver[marine-excitation]'

python -m pip install -e C:\Github\ANYloads
python -m pip install 'ANYfeSolver[marine-morison]'

Core analyses and the solver-owned generated-geometry workflow are available directly from anyfesolver; the lightweight normalized flat-panel and cylinder facade is exposed through anyfesolver.runtime:

from anyfesolver import (
    FEModel,
    GeneratedGeometryFEMConfig,
    LoadCase,
    run_generated_geometry_fem,
    solve_linear,
)
from anyfesolver.runtime import (
    LightweightFEMConfig,
    resolve_runtime_analysis,
    run_production_fem,
)

The runtime facade applies its normalized axial force, bending moment, shear force, torsional moment, and pressure inputs to the generated model. Set LightweightFEMConfig.follower_pressure=True only for nonlinear static or arc-length analysis using the static only or nonlinear static runtime path; incompatible linear, stepwise eigenvalue-buckling, transient, collision, and structured-capacity paths return an explicit invalid_follower_pressure status. Arc length retains the requested von Karman or corotational kinematics. Production runtime failures remain failures rather than being replaced by an estimator.

Application integrations should use resolve_runtime_analysis(config) to reflect the solver's effective nonlinear/material/control/kinematics choices; the normalization helpers with leading underscores are implementation details.

The generic GeneratedGeometryFEM* names are the preferred workflow API. Historical AnyStructureFEM* aliases remain available only for downstream compatibility. Material selection is owned by ANYmaterial; the root-level dnv_c208_steel_properties() and dnv_c208_steel_curve() names are temporary compatibility imports over its canonical table and validation.

The source code and tests are authoritative. Generated reports under reports/ are dated evidence snapshots and must be regenerated after solver changes before making release claims.

Functional overview

Production four-node shell selectors use the qualified E4-PL formulation by default. New/current-policy three-node shell selectors use the independently qualified E4-PL S3 V2D companion; historical S3 records without formulation authority remain explicit legacy. TRI6, Q8, and Q8R remain on their established implementations.

Qualified S3 admission intentionally fails closed where a triangle touches a shell edge with more than two incident elements. Automatically imprinted four-way sheet intersections therefore require junction-aware meshing support or an explicit model-level legacy-S3 rollback; the mesher never silently changes the formulation. The explicit legacy-Q4 rollback is deprecated during the 0.4.x burn-in and is scheduled for removal no earlier than 0.5.0; see the E4-PL migration guide for diagnostics, rollback, and release gates.

Area Implemented functionality
Model Six DOFs per node; SI units; materials, density, nodal mass, shell/beam topology, supports, and MPC constraints. audit_constraints() reports equation provenance, feasibility, structural rank, dependency depth, and independent DOFs before assembly.
Materials Constitutive objects, elastic reductions, Hill-48 yield data, and DNV curves come from ANYmaterial; ANYfeSolver owns their use in element integration and nonlinear solution. Orthotropic shells support material direction/angle and Hill-48 plasticity; orthotropic beams use local material axes and an explicit section torsional rigidity.
Shells 3- and 6-node triangles; 4-node MITC-style and 8-node Mindlin-Reissner quadrilaterals; isotropic, rotated orthotropic, or pre-integrated generalized A/B/D/As section stiffness. Generalized sections retain membrane-bending coupling and recover exact strains/resultants without inventing ply stresses.
Beams 2-node and straight-sided 3-node Timoshenko beams with axial, biaxial bending, direction-dependent shear, torsion, consistent/lumped mass options, geometric stiffness, optional fiber-section plasticity, or a fully coupled local 6x6 generalized section law.
Coupling Coincident or eccentric beam-shell MPCs, with explicit rotating_eccentricity selection; see connection options and limits.
Loads Nodal force/moment, dead or current-area follower shell pressure, in-plane edge loads, acceleration/gravity, prescribed displacement, load combinations, proportional and staged nonlinear loads. Follower pressure includes its exact, generally nonsymmetric external-load tangent.
Linear analysis Static single- and multiple-RHS solves, reactions and MPC-force diagnostics, free-free rigid-body nullspace handling, sparse factorization reuse, and post-solve affine-constraint residual checks.
Modal and mass Consistent mass assembly, point masses, model mass/inertia properties, constrained and free-free vibration modes.
Attached mass and free-body statics Concentrated rigid mass and inertia, including offset coupling, and linear inertia relief for the admitted connected free-free domain.
Floating-body development Six-DOF frequency response and fixed-step transient wind-thrust feedback, with neutral numerical inputs, pressure-region loads and explicit small-rotation limits. Development evidence does not establish general marine qualification.
Buckling Linear eigenvalue buckling for beam axial force and shell Mindlin initial-stress resultants, including sparse shift-invert and repeated-mode diagnostics. A follower-load stiffness can be included when its constrained tangent is symmetric; a general nonsymmetric follower eigenproblem is outside scope.
Nonlinear static Incremental Newton solution, adaptive stepping, force or displacement control, dead or follower pressure, von Karman or opt-in corotational kinematics, rotated or consistent corotational tangent, layered shell J2 or orthotropic Hill-48 plasticity with safeguarded local solves and consistent tangents, beam fiber plasticity, stage-boundary commits, true preload/restart displacement control, and simplified element erosion.
Continuation Bounded Crisfield-style spherical arc-length tracing through a first limit point and a guarded descending branch, including current-area follower pressure and its load tangent.
Dynamics Newmark or HHT-alpha implicit transient response, Rayleigh damping, prescribed shell pressure patches, selected/envelope history storage, and memory preflight.
Impact/contact One rigid sphere with frictionless penalty contact against shells and opt-in beam-axis segments; event substepping, Aitken relaxation, nonlinear material response, and engineering damage/erosion options.
General-contact development Opt-in shell and declared round classical-beam static contact profiles, with exact admission and documented limits; see the capability ledger, C0 shell plane, C2 beam plane, C2 beam pair, and C2 radial obstacle. A measured opt-in guided static candidate additionally supports deformable shell-pair normal contact, material-anchor Coulomb stick/slip friction, checkpoint restart and detached result archives; see the static candidate guide. Engineering acceptance remains open.
Imperfections Stress-free eigenmode, member-bow, plate-wave, flange-twist, explicit, and composite imperfection fields.
Initial fields Element-local shell membrane/bending stress or membrane/curvature prestrain, arbitrary configured beam-fiber stress/prestrain distributions, zero-external-load equilibration, admissibility checks, and provenance kept separate from geometric imperfections.
Workflows Normalized generated geometry to static/prestress/buckling; traceable static-to-buckling-to-imperfect nonlinear-capacity workflow.
Interchange ANYfileio owns SESAM/CalculiX parsing, validation, neutral semantics, and guarded writing. ANYfeSolver retains only neutral-record-to-FEModel adapters and the legacy compatibility imports introduced for the 0.2 line.
Results Result provenance; unified elastic or committed shell-layer/beam-fiber stress recovery; Gauss-point membrane-force and bending-moment resultants for generated-geometry prestress; guarded Zienkiewicz-Zhu-style patch recovery for qualified shell neighborhoods; selected recovery; reaction filtering; validation diagnostics; deterministic baselines; benchmarks; and generated qualification reports.
External verification Reproducible CalculiX model flattening, opt-in isolated execution, solver provenance, and tolerance-controlled analytical comparison, using ANYfileio for deck writing and FRD/DAT parsing. Deck-only reports remain explicitly not_executed and make no numerical-agreement claim.

StructuralMaterial is a runtime-checkable, ANYmaterial-owned protocol containing name, density, elastic_symmetry, and elastic_compliance_matrix() in engineering Voigt order [11, 22, 33, 23, 13, 12]. FEModel.register_material() accepts compatible external objects through that contract; FEModel.add_orthotropic_material() constructs the canonical OrthotropicMaterial.

ANYmesher owns neutral mesh topology, numbering, quality and coupling records; this package converts them into solver elements and exact constraints. ANYfileio owns SESAM and CalculiX syntax; this package converts neutral records to FEModel objects and retains execution and validation evidence.

Every production solver uses the same fixed/MPC preflight. Invalid or cyclic systems fail before assembly or factorization. Linear, modal, buckling, nonlinear, arc-length, transient, and impact results include a normalized constraint residual diagnostic. Modal and buckling modes correctly verify the homogeneous variation equations when the base model has prescribed offsets.

ResourceConfig(solver_threads=N, assembly_threads=M) now applies scoped native and Numba limits. Native pools are restored even after exceptions, and parallel Numba assembly suppresses nested BLAS/OpenMP pools to one thread. Diagnostics record requested limits, active runtime pools, the selected sparse backend, and any limiter/backend fallback. Omitting the resource policy retains the backend's existing unrestricted default.

Applications that expect a large qualified-Q4 nonlinear analysis can move the first-use JIT cost out of the interactive solve path with an explicit warm-up:

from anyfesolver import warm_fe_solver_kernels

warm_fe_solver_kernels(include_nonlinear_static=True)

This opt-in helper builds and discards a small 4x4 Q4 batch solely to prepare the existing native kernel. It does not change the application model, material state, element mechanics, or normal solver behavior.

GeneralizedShellSectionProtocol and GeneralizedBeamSectionContract are likewise solver-owned structural interfaces. The built-in GeneralizedShellSection(A, B, D, As, ...) accepts pre-integrated laminate or homogenized shell stiffness, while GeneralizedBeamSection(stiffness, ...) accepts a coupled 6x6 sectional law. They may be attached directly to elements or supplied inline/by name through generated geometry. Optional section mass data override the legacy homogeneous mass construction; otherwise the attached material, thickness, and legacy section geometry continue to define mass.

For shells, material_direction is projected into the shell plane and then material_angle_deg is applied right-handed about the positive shell normal; without a direction, the angle starts at shell-local x. For beams, material axes 1/2/3 are beam-local x/y/z. Orthotropic beam sections must provide a positive cross_section["torsional_rigidity"] in N*m^2; isotropic beams retain G*J.

Implemented does not automatically mean qualified for every geometry or load regime. The live capability matrix is produced by write_production_readiness_artifacts() and the verification manifest.

Production scope

The qualified target is thin flat or cylindrical shell structure, with beam stiffeners/girders represented through the documented coupling, inside the verified mesh, material, distortion, eccentricity, and load ranges.

Important limits:

  • no arbitrary CAD topology or automatic general-purpose meshing;
  • no arbitrary 3-D anisotropic material law, ply-stack integration, ply stress recovery, tension/compression-asymmetric composite failure, or progressive composite damage. Pre-integrated linear shell A/B/D/As and beam 6x6 section laws are supported, including their elastic couplings;
  • Q8R is experimental: its hourglass stabilization is not qualified for thin bending and it is deliberately excluded from nonlinear batch acceleration;
  • the 3-node quadratic beam is straight-sided; curved members must be represented by straight beam segments until a true curved formulation is implemented;
  • the shell initial-stress operator covers the in-plane N, M, and H stress moments acting on Mindlin midsurface translations and director gradients; it does not add drilling, transverse-normal-stress, or a geometrically exact finite-rotation shell/director formulation;
  • current-area follower pressure is supported in nonlinear static and arc-length analyses, with its exact load tangent. Linear/dead pressure remains the default. Linear buckling rejects a constrained nonsymmetric follower-pressure pencil because general complex nonconservative eigenanalysis is not implemented;
  • no general shell-shell, body-body, rolling, or self-contact; deformable shell-pair normal contact and frictional contact exist only as the measured opt-in guided static candidate scope (guided shell pairs against rigid tools or each other, material-anchor Coulomb stick/slip) with the documented limits in the static candidate guide;
  • no fluid-structure interaction, cavitation, or water-entry model;
  • no cohesive cracks, remeshing, material separation, or fracture-mechanics claim—the erosion models are engineering screens;
  • no unrestricted deep post-buckling or automatic bifurcation branch switching;
  • the consistent corotational tangent includes frame derivatives and is selected automatically for follower pressure, but its numerical frame-sensitivity evaluation is costlier than the rotated tangent used by default for ordinary corotational solves;
  • material-history-aware recovery requires retained, matching committed nonlinear layer/fiber states; missing or invalid state is reported and the affected components fall back explicitly to elastic reconstruction;
  • for legacy isotropic plastic histories, von_mises retains the established return-mapped shell in-plane or beam-fiber scope. Orthotropic results keep von_mises as the conventional invariant of the physical stress, including matching elastic transverse shear/torsion reconstruction, while equivalent_stress and hill_utilization remain explicitly scoped to the Hill-return-mapped components. mixed_reconstruction_von_mises and recovery provenance identify that mixed constitutive scope;
  • the guarded patch-recovery fit is qualified only for locally planar, consistently oriented, homogeneous, full-integration Q4 or Q8 shell neighborhoods. Discontinuities remain separate, and the optional normalized stress-L2 discrepancy is a diagnostic—not an energy-norm error estimate;
  • initial stress/prestrain fields are qualified only in element-local reference coordinates with kinematics="von_karman". Shell fields use the documented membrane/positive-face-bending convention, and beam fields require a configured fiber section. Input stress must be admissible for the supplied hardening state; equilibration may redistribute it and does not reconstruct the manufacturing history. A field-bearing restart also requires its matching converged displacement vector;
  • the analytical plane-stress tangent is branch-consistent. The numerical derivative remains an oracle and automatic invalid-row fallback; local yield-residual nonconvergence fails closed;
  • no unverified material laws or distortion ranges;
  • orthotropic and generalized-section shells use the general element/nonlinear paths and report deterministic fallback diagnostics; generalized beams use the general element path, while the existing accelerated shell kernels remain isotropic homogeneous-section only;
  • generalized-section recovery is resultants-only. CalculiX export rejects these sections because the current deck mapping cannot preserve their coupling; use analytical or a dedicated section-capable reference model;
  • SESAM FEModel export remains outside the supported interchange gate;
  • CalculiX comparison requires a compatible local executable and an explicit execution request. Deck generation alone is a reproducibility handoff, not external numerical evidence.

Use validate_production_model(), the analysis-specific preflight checks, and the generated production-scope artifacts before production use.

Documentation map

Basic verification

Linear free-free accelerating-frame statics is available through solve_inertia_relief; see inertia relief and the free bar example for scope, accelerations, effective loads and numerical diagnostics.

From the repository root:

python -m pytest tests -q -p no:cacheprovider
python run_qc.py --no-save
python scripts/run_fe_verification.py

The last command regenerates the canonical JSON and Markdown evidence under reports/verification/. Its default external-reference mode generates handoff decks with status not_executed; that status is not a pass or a claim of numerical agreement. To execute the comparisons, provide a compatible CalculiX executable on PATH, through ANYSOLVER_CALCULIX_EXECUTABLE, or with --calculix, and run:

python scripts/run_fe_verification.py --execute-calculix

An external case becomes passing evidence only after isolated execution, successful FRD/DAT parsing, and every declared comparison meeting its tolerance.

License

Starting with version 0.4.0, this project is licensed under the Mozilla Public License 2.0. See LICENSE for the full terms and LICENSING.md for the transition and third-party scope.

Earlier published versions remain available under the licence terms that applied to those versions.

The optional CPython 3.11 Windows x64 source-authority accelerator preserves the complete literal guard and every existing safe point. See native source-authority guard for build, fallback, admission and bounded evidence details.

Metadata

Release files for ANYfeSolver 0.5.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ANYfeSolver 0.5.0a1
File Size Uploaded Provenance Actions
anyfesolver-0.5.0a1.tar.gz 3.6 MB With provenance Details for anyfesolver-0.5.0a1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ANYfeSolver 0.5.0a1
File Interpreter ABI Platform Actions
anyfesolver-0.5.0a1-py3-none-any.whl Python 3 none any Details for anyfesolver-0.5.0a1-py3-none-any.whl

Total release size: 7.5 MB

Release files / anyfesolver-0.5.0a1.tar.gz

Download URL anyfesolver-0.5.0a1.tar.gz
Size 3.6 MB
Tags Source
SHA-256 checksum
How to use checksums
ce6f877fec1330f2ba664bfabd46303a4dbfeb87ee17d05a0a9cd412fdc68deb
BLAKE2b-256 checksum
How to use checksums
7e58eb6f3364840dca4d318f4c0aaddce6df6824625044b695e020cc45078a15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / anyfesolver-0.5.0a1-py3-none-any.whl

Download URL anyfesolver-0.5.0a1-py3-none-any.whl
Size 4.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
df5b685874d7e3c889af42e7267e946d17febc5abd35ac4b2f4f97df82a3fa4a
BLAKE2b-256 checksum
How to use checksums
53ba306a413f9b5ec3451397d93c6faf5ba6c693b419d15ba81909c49d7a4a48
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for ANYfeSolver 0.5.0a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for anyfesolver-0.5.0a1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page