ANYfeSolver 0.5.0a1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (751) hide show
  1. anyfesolver/__init__.py +1075 -0
  2. anyfesolver/_b2_attachment_elimination_dev.py +261 -0
  3. anyfesolver/_b2_f10_f11_point_attachment.py +163 -0
  4. anyfesolver/_b2_loaded_point_trace_dev.py +173 -0
  5. anyfesolver/_b2_physical_flexibility_linear.py +707 -0
  6. anyfesolver/_b2_physical_linear_batch_dev.py +491 -0
  7. anyfesolver/_b2_physical_linear_definition.py +415 -0
  8. anyfesolver/_b2_physical_load_bubbles.py +282 -0
  9. anyfesolver/_compensated_contractions.py +497 -0
  10. anyfesolver/_compensated_native.py +437 -0
  11. anyfesolver/_corotational_batch.py +219 -0
  12. anyfesolver/_director_trace.py +214 -0
  13. anyfesolver/_dyadic_bilinear.py +76 -0
  14. anyfesolver/_dyadic_factor_chain.py +25 -0
  15. anyfesolver/_ge_beam3_adaptive_arc_program.py +286 -0
  16. anyfesolver/_ge_beam3_analysis_combined.py +102 -0
  17. anyfesolver/_ge_beam3_analysis_fibre_translation.py +130 -0
  18. anyfesolver/_ge_beam3_analysis_modal_snapshot.py +27 -0
  19. anyfesolver/_ge_beam3_analysis_nodal_program.py +140 -0
  20. anyfesolver/_ge_beam3_analysis_translation.py +147 -0
  21. anyfesolver/_ge_beam3_analysis_translation_modal.py +84 -0
  22. anyfesolver/_ge_beam3_arc_geometry.py +89 -0
  23. anyfesolver/_ge_beam3_arc_program.py +304 -0
  24. anyfesolver/_ge_beam3_authoritative_cell_seed.py +25 -0
  25. anyfesolver/_ge_beam3_cell_identity.py +52 -0
  26. anyfesolver/_ge_beam3_centered_batched_finite_inertia.py +132 -0
  27. anyfesolver/_ge_beam3_centered_finite_inertia.py +171 -0
  28. anyfesolver/_ge_beam3_centered_mixed.py +104 -0
  29. anyfesolver/_ge_beam3_centered_reference.py +187 -0
  30. anyfesolver/_ge_beam3_centered_so3_strain.py +76 -0
  31. anyfesolver/_ge_beam3_complementary_section.py +122 -0
  32. anyfesolver/_ge_beam3_compliance_snapshot_guard.py +20 -0
  33. anyfesolver/_ge_beam3_connected_dynamic.py +486 -0
  34. anyfesolver/_ge_beam3_connected_trajectory.py +258 -0
  35. anyfesolver/_ge_beam3_conservative_backtrack.py +26 -0
  36. anyfesolver/_ge_beam3_controlled_fibre_modes.py +105 -0
  37. anyfesolver/_ge_beam3_coupled_beam_subdomain.py +128 -0
  38. anyfesolver/_ge_beam3_coupled_modes.py +256 -0
  39. anyfesolver/_ge_beam3_deterministic_reduction.py +264 -0
  40. anyfesolver/_ge_beam3_displacement_program.py +255 -0
  41. anyfesolver/_ge_beam3_durable_coupled.py +251 -0
  42. anyfesolver/_ge_beam3_dynamic_elastic_state.py +461 -0
  43. anyfesolver/_ge_beam3_effective_deadline.py +58 -0
  44. anyfesolver/_ge_beam3_elastic_seed_continuation.py +223 -0
  45. anyfesolver/_ge_beam3_elastic_seed_modal.py +139 -0
  46. anyfesolver/_ge_beam3_equilibrium_line_program.py +98 -0
  47. anyfesolver/_ge_beam3_equilibrium_schur_solver.py +96 -0
  48. anyfesolver/_ge_beam3_factor_chain_modes.py +103 -0
  49. anyfesolver/_ge_beam3_fibre_cell.py +408 -0
  50. anyfesolver/_ge_beam3_fibre_distributed_couples.py +191 -0
  51. anyfesolver/_ge_beam3_fibre_kinematic_cell.py +75 -0
  52. anyfesolver/_ge_beam3_fibre_line_program.py +157 -0
  53. anyfesolver/_ge_beam3_fibre_line_work.py +87 -0
  54. anyfesolver/_ge_beam3_fibre_reference_modal.py +104 -0
  55. anyfesolver/_ge_beam3_fibre_schur_solver.py +134 -0
  56. anyfesolver/_ge_beam3_fibre_section.py +286 -0
  57. anyfesolver/_ge_beam3_fibre_static_boundary.py +113 -0
  58. anyfesolver/_ge_beam3_g1_analysis.py +307 -0
  59. anyfesolver/_ge_beam3_g1_elastic.py +161 -0
  60. anyfesolver/_ge_beam3_g1_element.py +185 -0
  61. anyfesolver/_ge_beam3_g1_operator.py +137 -0
  62. anyfesolver/_ge_beam3_g2_analysis.py +176 -0
  63. anyfesolver/_ge_beam3_g2_constraints.py +162 -0
  64. anyfesolver/_ge_beam3_g3_analysis.py +385 -0
  65. anyfesolver/_ge_beam3_g3_constraints.py +168 -0
  66. anyfesolver/_ge_beam3_g3b_owner.py +296 -0
  67. anyfesolver/_ge_beam3_g3b_q4_reference.py +186 -0
  68. anyfesolver/_ge_beam3_g3b_reference.py +206 -0
  69. anyfesolver/_ge_beam3_g3b_result_schema.py +107 -0
  70. anyfesolver/_ge_beam3_g3b_s3_reference.py +185 -0
  71. anyfesolver/_ge_beam3_g3b_weighted_reference.py +193 -0
  72. anyfesolver/_ge_beam3_g3c_affine_q4_chart.py +58 -0
  73. anyfesolver/_ge_beam3_g3c_affine_q4_increment_chart.py +257 -0
  74. anyfesolver/_ge_beam3_g3c_affine_q4_recovery.py +434 -0
  75. anyfesolver/_ge_beam3_g3c_affine_q4_registry.py +127 -0
  76. anyfesolver/_ge_beam3_g3c_b2_physical.py +153 -0
  77. anyfesolver/_ge_beam3_g3c_b2_physical_adapter.py +160 -0
  78. anyfesolver/_ge_beam3_g3c_definition.py +117 -0
  79. anyfesolver/_ge_beam3_g3c_local_beam.py +188 -0
  80. anyfesolver/_ge_beam3_g3c_local_shell.py +371 -0
  81. anyfesolver/_ge_beam3_g3c_owner.py +400 -0
  82. anyfesolver/_ge_beam3_g3c_physical_authority.py +203 -0
  83. anyfesolver/_ge_beam3_g3c_physical_owner.py +556 -0
  84. anyfesolver/_ge_beam3_g3c_recovery.py +91 -0
  85. anyfesolver/_ge_beam3_g3c_so3_numerics.py +81 -0
  86. anyfesolver/_ge_beam3_g3c_stable/__init__.py +1 -0
  87. anyfesolver/_ge_beam3_g3c_stable/authority.py +152 -0
  88. anyfesolver/_ge_beam3_g3c_stable/beam.py +196 -0
  89. anyfesolver/_ge_beam3_g3c_stable/boundary.py +38 -0
  90. anyfesolver/_ge_beam3_g3c_stable/chart.py +23 -0
  91. anyfesolver/_ge_beam3_g3c_stable/compensated.py +46 -0
  92. anyfesolver/_ge_beam3_g3c_stable/element.py +190 -0
  93. anyfesolver/_ge_beam3_g3c_stable/fit.py +54 -0
  94. anyfesolver/_ge_beam3_g3c_stable/joint.py +255 -0
  95. anyfesolver/_ge_beam3_g3c_stable/line_work.py +92 -0
  96. anyfesolver/_ge_beam3_g3c_stable/operator.py +147 -0
  97. anyfesolver/_ge_beam3_g3c_stable/owner.py +415 -0
  98. anyfesolver/_ge_beam3_g3c_stable/shell.py +358 -0
  99. anyfesolver/_ge_beam3_g4_completion.py +186 -0
  100. anyfesolver/_ge_beam3_g4a_station_transaction.py +385 -0
  101. anyfesolver/_ge_beam3_g5_completion.py +68 -0
  102. anyfesolver/_ge_beam3_g6_domain.py +354 -0
  103. anyfesolver/_ge_beam3_generalized_cell.py +172 -0
  104. anyfesolver/_ge_beam3_generalized_ellipsoid_section.py +215 -0
  105. anyfesolver/_ge_beam3_generalized_static_boundary.py +233 -0
  106. anyfesolver/_ge_beam3_lifted_kinetic_factor.py +26 -0
  107. anyfesolver/_ge_beam3_line_fibre_modes.py +121 -0
  108. anyfesolver/_ge_beam3_load_program.py +275 -0
  109. anyfesolver/_ge_beam3_loaded_modal.py +225 -0
  110. anyfesolver/_ge_beam3_mixed_ad.py +286 -0
  111. anyfesolver/_ge_beam3_native_analysis.py +484 -0
  112. anyfesolver/_ge_beam3_native_arc.py +269 -0
  113. anyfesolver/_ge_beam3_native_arc_adaptive.py +251 -0
  114. anyfesolver/_ge_beam3_native_arc_restart.py +88 -0
  115. anyfesolver/_ge_beam3_native_arc_source.py +62 -0
  116. anyfesolver/_ge_beam3_native_buckling.py +206 -0
  117. anyfesolver/_ge_beam3_native_combined_couples.py +179 -0
  118. anyfesolver/_ge_beam3_native_combined_restart.py +205 -0
  119. anyfesolver/_ge_beam3_native_definition.py +238 -0
  120. anyfesolver/_ge_beam3_native_distributed_element.py +220 -0
  121. anyfesolver/_ge_beam3_native_distributed_loading.py +92 -0
  122. anyfesolver/_ge_beam3_native_distributed_program.py +165 -0
  123. anyfesolver/_ge_beam3_native_distributed_recovery.py +34 -0
  124. anyfesolver/_ge_beam3_native_distributed_restart.py +221 -0
  125. anyfesolver/_ge_beam3_native_dynamic_analysis.py +149 -0
  126. anyfesolver/_ge_beam3_native_dynamic_restart.py +261 -0
  127. anyfesolver/_ge_beam3_native_fibre_current_modal.py +104 -0
  128. anyfesolver/_ge_beam3_native_fibre_recovery.py +34 -0
  129. anyfesolver/_ge_beam3_native_fibre_restart.py +211 -0
  130. anyfesolver/_ge_beam3_native_fibre_static_element.py +193 -0
  131. anyfesolver/_ge_beam3_native_force_adaptation.py +56 -0
  132. anyfesolver/_ge_beam3_native_generalized_combined_couples.py +188 -0
  133. anyfesolver/_ge_beam3_native_generalized_combined_restart.py +207 -0
  134. anyfesolver/_ge_beam3_native_generalized_element.py +222 -0
  135. anyfesolver/_ge_beam3_native_generalized_factor_modal.py +122 -0
  136. anyfesolver/_ge_beam3_native_generalized_loading.py +92 -0
  137. anyfesolver/_ge_beam3_native_generalized_modal.py +274 -0
  138. anyfesolver/_ge_beam3_native_generalized_paired_modal.py +13 -0
  139. anyfesolver/_ge_beam3_native_generalized_parameter.py +89 -0
  140. anyfesolver/_ge_beam3_native_generalized_program.py +196 -0
  141. anyfesolver/_ge_beam3_native_generalized_recovery.py +34 -0
  142. anyfesolver/_ge_beam3_native_generalized_restart.py +243 -0
  143. anyfesolver/_ge_beam3_native_history_profile.py +53 -0
  144. anyfesolver/_ge_beam3_native_line_loading.py +93 -0
  145. anyfesolver/_ge_beam3_native_line_program.py +150 -0
  146. anyfesolver/_ge_beam3_native_line_recovery.py +34 -0
  147. anyfesolver/_ge_beam3_native_line_restart.py +197 -0
  148. anyfesolver/_ge_beam3_native_line_static_element.py +220 -0
  149. anyfesolver/_ge_beam3_native_load_admission.py +37 -0
  150. anyfesolver/_ge_beam3_native_midpoint.py +1004 -0
  151. anyfesolver/_ge_beam3_native_multi_shell_contact.py +539 -0
  152. anyfesolver/_ge_beam3_native_pair_contact.py +236 -0
  153. anyfesolver/_ge_beam3_native_shell_contact.py +357 -0
  154. anyfesolver/_ge_beam3_native_spatial_couples.py +176 -0
  155. anyfesolver/_ge_beam3_native_spatial_restart.py +204 -0
  156. anyfesolver/_ge_beam3_native_transient.py +467 -0
  157. anyfesolver/_ge_beam3_native_translation.py +225 -0
  158. anyfesolver/_ge_beam3_native_translation_restart.py +54 -0
  159. anyfesolver/_ge_beam3_operator_validation_scope.py +53 -0
  160. anyfesolver/_ge_beam3_p5/__init__.py +11 -0
  161. anyfesolver/_ge_beam3_p5/algebra.py +91 -0
  162. anyfesolver/_ge_beam3_p5/arrays.py +29 -0
  163. anyfesolver/_ge_beam3_p5/chart.py +45 -0
  164. anyfesolver/_ge_beam3_p5/codec.py +82 -0
  165. anyfesolver/_ge_beam3_p5/committed_modal.py +191 -0
  166. anyfesolver/_ge_beam3_p5/compensated.py +118 -0
  167. anyfesolver/_ge_beam3_p5/compensated_coordinates.py +44 -0
  168. anyfesolver/_ge_beam3_p5/core.py +159 -0
  169. anyfesolver/_ge_beam3_p5/element.py +207 -0
  170. anyfesolver/_ge_beam3_p5/factors.py +61 -0
  171. anyfesolver/_ge_beam3_p5/inertia.py +120 -0
  172. anyfesolver/_ge_beam3_p5/mass.py +70 -0
  173. anyfesolver/_ge_beam3_p5/mixed.py +256 -0
  174. anyfesolver/_ge_beam3_p5/reference_modal.py +73 -0
  175. anyfesolver/_ge_beam3_p5/section.py +139 -0
  176. anyfesolver/_ge_beam3_p5/typed_schema.py +111 -0
  177. anyfesolver/_ge_beam3_p5_centered/__init__.py +6 -0
  178. anyfesolver/_ge_beam3_p5_centered/codec.py +84 -0
  179. anyfesolver/_ge_beam3_p5_centered/committed_modal.py +192 -0
  180. anyfesolver/_ge_beam3_p5_centered/core.py +171 -0
  181. anyfesolver/_ge_beam3_p5_centered/element.py +216 -0
  182. anyfesolver/_ge_beam3_p5_centered/mass.py +99 -0
  183. anyfesolver/_ge_beam3_p5_centered/positions.py +34 -0
  184. anyfesolver/_ge_beam3_p5_centered/reference_modal.py +73 -0
  185. anyfesolver/_ge_beam3_p5_coordinates/__init__.py +6 -0
  186. anyfesolver/_ge_beam3_p5_coordinates/codec.py +84 -0
  187. anyfesolver/_ge_beam3_p5_coordinates/committed_modal.py +192 -0
  188. anyfesolver/_ge_beam3_p5_coordinates/core.py +163 -0
  189. anyfesolver/_ge_beam3_p5_coordinates/element.py +213 -0
  190. anyfesolver/_ge_beam3_p5_coordinates/positions.py +102 -0
  191. anyfesolver/_ge_beam3_p5_coordinates/reference_modal.py +73 -0
  192. anyfesolver/_ge_beam3_p5_loads/__init__.py +7 -0
  193. anyfesolver/_ge_beam3_p5_loads/codec.py +85 -0
  194. anyfesolver/_ge_beam3_p5_loads/core.py +192 -0
  195. anyfesolver/_ge_beam3_p5_loads/element.py +243 -0
  196. anyfesolver/_ge_beam3_p5_loads/state.py +120 -0
  197. anyfesolver/_ge_beam3_p5_loads/work.py +45 -0
  198. anyfesolver/_ge_beam3_p5_seeded/__init__.py +9 -0
  199. anyfesolver/_ge_beam3_p5_seeded/codec.py +87 -0
  200. anyfesolver/_ge_beam3_p5_seeded/core.py +197 -0
  201. anyfesolver/_ge_beam3_p5_seeded/element.py +245 -0
  202. anyfesolver/_ge_beam3_p5_seeded/state.py +122 -0
  203. anyfesolver/_ge_beam3_p5_seeded/work.py +47 -0
  204. anyfesolver/_ge_beam3_pose_joint.py +268 -0
  205. anyfesolver/_ge_beam3_precise_geometric_work.py +147 -0
  206. anyfesolver/_ge_beam3_reassembled_signed_modes.py +101 -0
  207. anyfesolver/_ge_beam3_reference_identity.py +92 -0
  208. anyfesolver/_ge_beam3_refined_fibre_schur_solver.py +104 -0
  209. anyfesolver/_ge_beam3_refinement_capacity.py +19 -0
  210. anyfesolver/_ge_beam3_relative_virgin_reference_modes.py +60 -0
  211. anyfesolver/_ge_beam3_retained_arc.py +350 -0
  212. anyfesolver/_ge_beam3_retained_arc_geometry.py +66 -0
  213. anyfesolver/_ge_beam3_retained_arc_modal.py +125 -0
  214. anyfesolver/_ge_beam3_retained_elastic.py +134 -0
  215. anyfesolver/_ge_beam3_retained_fibre.py +209 -0
  216. anyfesolver/_ge_beam3_retained_fibre_control.py +270 -0
  217. anyfesolver/_ge_beam3_retained_fibre_element.py +58 -0
  218. anyfesolver/_ge_beam3_retained_fibre_modal.py +155 -0
  219. anyfesolver/_ge_beam3_retained_fibre_modes.py +189 -0
  220. anyfesolver/_ge_beam3_retained_fibre_program.py +68 -0
  221. anyfesolver/_ge_beam3_retained_fibre_state.py +268 -0
  222. anyfesolver/_ge_beam3_retained_force_program.py +72 -0
  223. anyfesolver/_ge_beam3_retained_generalized.py +186 -0
  224. anyfesolver/_ge_beam3_retained_generalized_modal.py +171 -0
  225. anyfesolver/_ge_beam3_retained_generalized_program.py +63 -0
  226. anyfesolver/_ge_beam3_retained_generalized_state.py +281 -0
  227. anyfesolver/_ge_beam3_retained_nodal_loading.py +111 -0
  228. anyfesolver/_ge_beam3_retained_plastic.py +116 -0
  229. anyfesolver/_ge_beam3_retained_plastic_modes.py +144 -0
  230. anyfesolver/_ge_beam3_retained_plastic_program.py +69 -0
  231. anyfesolver/_ge_beam3_retained_plastic_state.py +165 -0
  232. anyfesolver/_ge_beam3_retained_state.py +194 -0
  233. anyfesolver/_ge_beam3_retained_translation_control.py +345 -0
  234. anyfesolver/_ge_beam3_retained_translation_modal.py +137 -0
  235. anyfesolver/_ge_beam3_schur_line_program.py +98 -0
  236. anyfesolver/_ge_beam3_seeded_fibre_control.py +175 -0
  237. anyfesolver/_ge_beam3_seeded_load_program.py +301 -0
  238. anyfesolver/_ge_beam3_seeded_loaded_modal.py +226 -0
  239. anyfesolver/_ge_beam3_seeded_signed_modes.py +150 -0
  240. anyfesolver/_ge_beam3_shared_kinematic_split.py +53 -0
  241. anyfesolver/_ge_beam3_shell_joint_state.py +396 -0
  242. anyfesolver/_ge_beam3_shell_joint_trial.py +217 -0
  243. anyfesolver/_ge_beam3_signed_loaded_modes.py +140 -0
  244. anyfesolver/_ge_beam3_spatial_fibre_program.py +113 -0
  245. anyfesolver/_ge_beam3_spatial_nodal_moments.py +38 -0
  246. anyfesolver/_ge_beam3_station_resultant_cell.py +235 -0
  247. anyfesolver/_ge_beam3_variational_shell.py +211 -0
  248. anyfesolver/_ge_beam3_virgin_reference_modes.py +60 -0
  249. anyfesolver/_impact_coupling.py +162 -0
  250. anyfesolver/_native_authority_dag.py +77 -0
  251. anyfesolver/_native_dyadic_interval_inertia.py +64 -0
  252. anyfesolver/_native_exact_shift_chain_modes.py +140 -0
  253. anyfesolver/_native_exact_shift_inertia.py +86 -0
  254. anyfesolver/_native_factor_chain_modes.py +192 -0
  255. anyfesolver/_native_guard.cpp +828 -0
  256. anyfesolver/_native_guard_dispatch.py +140 -0
  257. anyfesolver/_native_large_factor_chain.py +55 -0
  258. anyfesolver/_native_material_protocol.py +51 -0
  259. anyfesolver/_native_midpoint_controller.py +90 -0
  260. anyfesolver/_native_modal_capacity.py +26 -0
  261. anyfesolver/_native_paired_factor_chain_modes.py +244 -0
  262. anyfesolver/_native_reassembled_factor_modes.py +185 -0
  263. anyfesolver/_native_reference_factor_spectrum.py +102 -0
  264. anyfesolver/_native_reference_modal.py +180 -0
  265. anyfesolver/_native_relative_factor_chain_modes.py +204 -0
  266. anyfesolver/_native_relative_reference_factor_spectrum.py +110 -0
  267. anyfesolver/_native_retained_step.py +15 -0
  268. anyfesolver/_native_rotation_state.py +797 -0
  269. anyfesolver/_native_signed_factor_modes.py +257 -0
  270. anyfesolver/_native_signed_kinetic_factor_modes.py +279 -0
  271. anyfesolver/_native_stationary_spectrum.py +79 -0
  272. anyfesolver/_nonlinear_events.py +150 -0
  273. anyfesolver/_nonlinear_seed.py +80 -0
  274. anyfesolver/_paired_modal_arithmetic.py +71 -0
  275. anyfesolver/_plate_stability_continuation.py +171 -0
  276. anyfesolver/_q4_assumed_strain_plasticity.py +502 -0
  277. anyfesolver/_qualified_authority_epoch.py +561 -0
  278. anyfesolver/_relative_reference_svd.py +44 -0
  279. anyfesolver/_stiffened_shell_affine_endpoint.py +232 -0
  280. anyfesolver/_stiffened_shell_algorithmic_pullback.py +38 -0
  281. anyfesolver/_stiffened_shell_arc_checkpoint.py +422 -0
  282. anyfesolver/_stiffened_shell_arc_control.py +108 -0
  283. anyfesolver/_stiffened_shell_arc_metric.py +222 -0
  284. anyfesolver/_stiffened_shell_arc_publication.py +153 -0
  285. anyfesolver/_stiffened_shell_arc_trial.py +310 -0
  286. anyfesolver/_stiffened_shell_b2_affine_resolution.py +101 -0
  287. anyfesolver/_stiffened_shell_b2_assembly_diagnostics.py +172 -0
  288. anyfesolver/_stiffened_shell_b2_definition_ownership.py +189 -0
  289. anyfesolver/_stiffened_shell_b2_experimental.py +153 -0
  290. anyfesolver/_stiffened_shell_b2_nodal_footprint.py +273 -0
  291. anyfesolver/_stiffened_shell_b2_physical_rigid_footprint.py +237 -0
  292. anyfesolver/_stiffened_shell_b2_q4_panel_experimental.py +2447 -0
  293. anyfesolver/_stiffened_shell_b2_q4_point_experimental.py +251 -0
  294. anyfesolver/_stiffened_shell_b2_reference_buckling.py +413 -0
  295. anyfesolver/_stiffened_shell_b3_chart.py +70 -0
  296. anyfesolver/_stiffened_shell_b3_local_adapter.py +141 -0
  297. anyfesolver/_stiffened_shell_beam_history.py +107 -0
  298. anyfesolver/_stiffened_shell_bl5_local_experimental.py +173 -0
  299. anyfesolver/_stiffened_shell_bl5_native_elastic.py +28 -0
  300. anyfesolver/_stiffened_shell_branch_event_trial.py +58 -0
  301. anyfesolver/_stiffened_shell_consumer_capabilities.py +124 -0
  302. anyfesolver/_stiffened_shell_coordinate_support.py +110 -0
  303. anyfesolver/_stiffened_shell_displacement_adaptive.py +327 -0
  304. anyfesolver/_stiffened_shell_displacement_checkpoint.py +360 -0
  305. anyfesolver/_stiffened_shell_displacement_control.py +326 -0
  306. anyfesolver/_stiffened_shell_displacement_corrector.py +293 -0
  307. anyfesolver/_stiffened_shell_displacement_increment.py +121 -0
  308. anyfesolver/_stiffened_shell_distributing_footprint.py +354 -0
  309. anyfesolver/_stiffened_shell_distributing_pose.py +267 -0
  310. anyfesolver/_stiffened_shell_f06_increment_arithmetic.py +205 -0
  311. anyfesolver/_stiffened_shell_ge_body_load.py +300 -0
  312. anyfesolver/_stiffened_shell_ge_checkpoint_binary.py +472 -0
  313. anyfesolver/_stiffened_shell_ge_distributed_load.py +210 -0
  314. anyfesolver/_stiffened_shell_ge_distributed_programme.py +175 -0
  315. anyfesolver/_stiffened_shell_ge_distributing_finite.py +242 -0
  316. anyfesolver/_stiffened_shell_ge_distributing_reference.py +296 -0
  317. anyfesolver/_stiffened_shell_ge_experimental.py +2454 -0
  318. anyfesolver/_stiffened_shell_ge_finite_experimental.py +2714 -0
  319. anyfesolver/_stiffened_shell_ge_mixed_modal_mass.py +33 -0
  320. anyfesolver/_stiffened_shell_ge_point_buckling.py +723 -0
  321. anyfesolver/_stiffened_shell_ge_pressure_load.py +366 -0
  322. anyfesolver/_stiffened_shell_ge_reference_modal.py +580 -0
  323. anyfesolver/_stiffened_shell_generalized_recovery.py +150 -0
  324. anyfesolver/_stiffened_shell_increment_control.py +217 -0
  325. anyfesolver/_stiffened_shell_l1_assembly_experimental.py +420 -0
  326. anyfesolver/_stiffened_shell_l1_local_experimental.py +284 -0
  327. anyfesolver/_stiffened_shell_l1_supported_work_experimental.py +146 -0
  328. anyfesolver/_stiffened_shell_native_distributed_load.py +120 -0
  329. anyfesolver/_stiffened_shell_native_gravity.py +236 -0
  330. anyfesolver/_stiffened_shell_nodal_footprint.py +255 -0
  331. anyfesolver/_stiffened_shell_physical_q4_mass.py +98 -0
  332. anyfesolver/_stiffened_shell_physical_s3_mass.py +53 -0
  333. anyfesolver/_stiffened_shell_point_recovery.py +49 -0
  334. anyfesolver/_stiffened_shell_q4_algorithmic_pullback.py +88 -0
  335. anyfesolver/_stiffened_shell_q4_material_event.py +114 -0
  336. anyfesolver/_stiffened_shell_q4_reference.py +65 -0
  337. anyfesolver/_stiffened_shell_rotation_charts.py +58 -0
  338. anyfesolver/_stiffened_shell_s3_algorithmic_pullback.py +59 -0
  339. anyfesolver/_stiffened_shell_s3_conservative_buckling.py +28 -0
  340. anyfesolver/_stiffened_shell_s3_dead_work_candidate.py +107 -0
  341. anyfesolver/_stiffened_shell_s3_material_event.py +30 -0
  342. anyfesolver/_stiffened_shell_same_parent_trial.py +224 -0
  343. anyfesolver/_stiffened_shell_selected_recovery.py +113 -0
  344. anyfesolver/_stiffened_shell_staged_load_experimental.py +392 -0
  345. anyfesolver/_stiffened_shell_stress_free_reference.py +204 -0
  346. anyfesolver/_wire_types.py +17 -0
  347. anyfesolver/activity.py +1537 -0
  348. anyfesolver/algebraic_dynamics.py +2864 -0
  349. anyfesolver/analysis_session.py +897 -0
  350. anyfesolver/anystructure_fem_mode.py +1637 -0
  351. anyfesolver/arc_length.py +2587 -0
  352. anyfesolver/assembly.py +1830 -0
  353. anyfesolver/b3_ge.py +179 -0
  354. anyfesolver/baselines.py +303 -0
  355. anyfesolver/beam_sections.py +292 -0
  356. anyfesolver/beam_shell_verification.py +4685 -0
  357. anyfesolver/beam_validity.py +110 -0
  358. anyfesolver/benchmarks.py +495 -0
  359. anyfesolver/boundary.py +1680 -0
  360. anyfesolver/buckling.py +2136 -0
  361. anyfesolver/buckling_validity.py +91 -0
  362. anyfesolver/capacity_workflow.py +431 -0
  363. anyfesolver/capsule_runtime_guard.py +99 -0
  364. anyfesolver/cases.py +173 -0
  365. anyfesolver/composite_strip_verification.py +297 -0
  366. anyfesolver/concentrated_mass.py +84 -0
  367. anyfesolver/constraint_audit.py +553 -0
  368. anyfesolver/contact.py +4785 -0
  369. anyfesolver/contact_performance.py +301 -0
  370. anyfesolver/control.py +206 -0
  371. anyfesolver/corotational.py +1935 -0
  372. anyfesolver/corotational_performance.py +157 -0
  373. anyfesolver/current_state_tangent.py +2780 -0
  374. anyfesolver/cylinder_benchmarks.py +369 -0
  375. anyfesolver/damage_matrix_performance.py +617 -0
  376. anyfesolver/dynamics.py +2833 -0
  377. anyfesolver/e4_pl_element.py +8265 -0
  378. anyfesolver/e4_pl_enriched.py +194 -0
  379. anyfesolver/e4_pl_enriched_nonlinear.py +159 -0
  380. anyfesolver/e4_pl_s3_element.py +9752 -0
  381. anyfesolver/e4_pl_s3_initial_fields.py +101 -0
  382. anyfesolver/e4_pl_s3_state.py +4723 -0
  383. anyfesolver/e4_pl_s3_v2_element.py +1844 -0
  384. anyfesolver/e4_pl_s3_v2b_element.py +1936 -0
  385. anyfesolver/e4_pl_s3_v2c_element.py +2196 -0
  386. anyfesolver/e4_pl_s3_v2d_element.py +2621 -0
  387. anyfesolver/e4_pl_s3_v2d_state.py +376 -0
  388. anyfesolver/element_capabilities.py +159 -0
  389. anyfesolver/element_qualification.py +432 -0
  390. anyfesolver/elements.py +6327 -0
  391. anyfesolver/experimental_csr_assembly.py +238 -0
  392. anyfesolver/external_references.py +1253 -0
  393. anyfesolver/fe_core.py +832 -0
  394. anyfesolver/floating_pressure_regions.py +119 -0
  395. anyfesolver/floating_response.py +486 -0
  396. anyfesolver/floating_transient.py +1281 -0
  397. anyfesolver/fracture.py +621 -0
  398. anyfesolver/ge_beam3_curved_reference.py +725 -0
  399. anyfesolver/ge_beam3_element.py +885 -0
  400. anyfesolver/ge_beam3_mixed_element.py +1216 -0
  401. anyfesolver/ge_beam3_mixed_state.py +814 -0
  402. anyfesolver/ge_beam3_native.py +129 -0
  403. anyfesolver/ge_beam3_native_connected_dynamics.py +24 -0
  404. anyfesolver/ge_beam3_native_dynamics.py +70 -0
  405. anyfesolver/ge_beam3_state.py +672 -0
  406. anyfesolver/general_contact/__init__.py +151 -0
  407. anyfesolver/general_contact/_enriched_multitarget_empty.py +202 -0
  408. anyfesolver/general_contact/_enriched_multitarget_trial.py +183 -0
  409. anyfesolver/general_contact/_results_archive_common.py +65 -0
  410. anyfesolver/general_contact/algebraic_path.py +206 -0
  411. anyfesolver/general_contact/arc_contact.py +237 -0
  412. anyfesolver/general_contact/arc_results_archive.py +158 -0
  413. anyfesolver/general_contact/augmentation.py +157 -0
  414. anyfesolver/general_contact/automatic_domain.py +621 -0
  415. anyfesolver/general_contact/beam_chain_consistent.py +357 -0
  416. anyfesolver/general_contact/beam_chain_end_geometry.py +237 -0
  417. anyfesolver/general_contact/beam_chain_ends.py +220 -0
  418. anyfesolver/general_contact/beam_chain_pair.py +416 -0
  419. anyfesolver/general_contact/beam_curve_end_geometry.py +254 -0
  420. anyfesolver/general_contact/beam_curve_ends.py +237 -0
  421. anyfesolver/general_contact/beam_curve_pair.py +794 -0
  422. anyfesolver/general_contact/beam_curve_pair_static.py +303 -0
  423. anyfesolver/general_contact/beam_end_radial_geometry.py +221 -0
  424. anyfesolver/general_contact/beam_end_topology.py +15 -0
  425. anyfesolver/general_contact/beam_hemisphere_coupled_tool.py +61 -0
  426. anyfesolver/general_contact/beam_hemisphere_cylinder.py +134 -0
  427. anyfesolver/general_contact/beam_hemisphere_cylinder_motion.py +89 -0
  428. anyfesolver/general_contact/beam_hemisphere_cylinder_work.py +216 -0
  429. anyfesolver/general_contact/beam_hemisphere_plane.py +175 -0
  430. anyfesolver/general_contact/beam_hemisphere_s3_support.py +152 -0
  431. anyfesolver/general_contact/beam_hemisphere_sphere.py +135 -0
  432. anyfesolver/general_contact/beam_hemisphere_sphere_work.py +114 -0
  433. anyfesolver/general_contact/beam_hemisphere_support.py +211 -0
  434. anyfesolver/general_contact/beam_pair.py +523 -0
  435. anyfesolver/general_contact/beam_pair_end_geometry.py +269 -0
  436. anyfesolver/general_contact/beam_pair_ends.py +222 -0
  437. anyfesolver/general_contact/beam_plane.py +425 -0
  438. anyfesolver/general_contact/beam_radial.py +500 -0
  439. anyfesolver/general_contact/beam_radial_ends.py +223 -0
  440. anyfesolver/general_contact/beam_s3_directional_rates.py +196 -0
  441. anyfesolver/general_contact/beam_s3_rotational_transient.py +126 -0
  442. anyfesolver/general_contact/beam_s3_transient.py +139 -0
  443. anyfesolver/general_contact/beam_shell.py +648 -0
  444. anyfesolver/general_contact/beam_shell_patch.py +395 -0
  445. anyfesolver/general_contact/beam_temporal_bounds.py +230 -0
  446. anyfesolver/general_contact/capability.py +101 -0
  447. anyfesolver/general_contact/capped_cylinder.py +618 -0
  448. anyfesolver/general_contact/contact_search.py +95 -0
  449. anyfesolver/general_contact/core.py +1769 -0
  450. anyfesolver/general_contact/curved_s3_q4_work.py +238 -0
  451. anyfesolver/general_contact/curved_shell_skin.py +520 -0
  452. anyfesolver/general_contact/d1_interior_profile.py +427 -0
  453. anyfesolver/general_contact/deformable_beam_s3_caps.py +143 -0
  454. anyfesolver/general_contact/deformable_beam_s3_line.py +211 -0
  455. anyfesolver/general_contact/deformable_beam_s3_static.py +152 -0
  456. anyfesolver/general_contact/descriptor_rates.py +61 -0
  457. anyfesolver/general_contact/enriched_cold_predictor.py +161 -0
  458. anyfesolver/general_contact/enriched_moment_batch.py +337 -0
  459. anyfesolver/general_contact/enriched_multitarget.py +308 -0
  460. anyfesolver/general_contact/enriched_multitarget_gap.py +156 -0
  461. anyfesolver/general_contact/enriched_multitarget_moments.py +194 -0
  462. anyfesolver/general_contact/enriched_multitarget_topology.py +171 -0
  463. anyfesolver/general_contact/enriched_nonlinear.py +440 -0
  464. anyfesolver/general_contact/enriched_overlap.py +299 -0
  465. anyfesolver/general_contact/enriched_path.py +253 -0
  466. anyfesolver/general_contact/enriched_small_cut.py +310 -0
  467. anyfesolver/general_contact/enriched_static.py +481 -0
  468. anyfesolver/general_contact/enriched_union.py +320 -0
  469. anyfesolver/general_contact/equilibrated_pressure_pivot.py +140 -0
  470. anyfesolver/general_contact/event_subdivision.py +273 -0
  471. anyfesolver/general_contact/finite_mixed_state.py +133 -0
  472. anyfesolver/general_contact/finite_rigid_patch.py +196 -0
  473. anyfesolver/general_contact/finite_rigid_support.py +129 -0
  474. anyfesolver/general_contact/finite_rigid_sweep.py +53 -0
  475. anyfesolver/general_contact/finite_rotation_predictor.py +171 -0
  476. anyfesolver/general_contact/finite_rotation_skin.py +212 -0
  477. anyfesolver/general_contact/finite_rotation_state.py +106 -0
  478. anyfesolver/general_contact/finite_rotation_sweep.py +161 -0
  479. anyfesolver/general_contact/finite_v2d_state.py +104 -0
  480. anyfesolver/general_contact/fixed_projection_graph.py +205 -0
  481. anyfesolver/general_contact/fixed_projection_s3_events.py +235 -0
  482. anyfesolver/general_contact/free_rigid.py +134 -0
  483. anyfesolver/general_contact/friction_point.py +378 -0
  484. anyfesolver/general_contact/gap_extrema.py +119 -0
  485. anyfesolver/general_contact/guided_pair_transient_geometry.py +138 -0
  486. anyfesolver/general_contact/initial_contact_seed.py +368 -0
  487. anyfesolver/general_contact/linearized_pivot.py +595 -0
  488. anyfesolver/general_contact/material_work_diagnostics.py +159 -0
  489. anyfesolver/general_contact/moment_batch_ad.py +129 -0
  490. anyfesolver/general_contact/moment_batch_points.py +75 -0
  491. anyfesolver/general_contact/moving.py +1031 -0
  492. anyfesolver/general_contact/multiple_beam_rigid.py +248 -0
  493. anyfesolver/general_contact/multiple_beam_s3_caps.py +199 -0
  494. anyfesolver/general_contact/multiple_beam_s3_transient.py +223 -0
  495. anyfesolver/general_contact/multiple_projected_pairs.py +196 -0
  496. anyfesolver/general_contact/multiple_shell_planes.py +226 -0
  497. anyfesolver/general_contact/native_activation_static.py +143 -0
  498. anyfesolver/general_contact/native_checkpoint_results.py +213 -0
  499. anyfesolver/general_contact/native_curve_union.py +268 -0
  500. anyfesolver/general_contact/native_curved_geometry.py +374 -0
  501. anyfesolver/general_contact/native_curved_pair_partition.py +590 -0
  502. anyfesolver/general_contact/native_curved_plane_work.py +864 -0
  503. anyfesolver/general_contact/native_curved_s3_work.py +472 -0
  504. anyfesolver/general_contact/native_event_polynomial.py +164 -0
  505. anyfesolver/general_contact/native_fibre_context.py +173 -0
  506. anyfesolver/general_contact/native_fibre_results.py +74 -0
  507. anyfesolver/general_contact/native_initial_guess.py +122 -0
  508. anyfesolver/general_contact/native_material_activation.py +108 -0
  509. anyfesolver/general_contact/native_material_plane.py +111 -0
  510. anyfesolver/general_contact/native_material_s3.py +209 -0
  511. anyfesolver/general_contact/native_multi_s3_static.py +722 -0
  512. anyfesolver/general_contact/native_normal_angles.py +233 -0
  513. anyfesolver/general_contact/native_pair_error_budget.py +49 -0
  514. anyfesolver/general_contact/native_replay_arithmetic.py +103 -0
  515. anyfesolver/general_contact/native_replay_diagnostics.py +90 -0
  516. anyfesolver/general_contact/native_retained_body_junction.py +99 -0
  517. anyfesolver/general_contact/native_retained_body_pair.py +220 -0
  518. anyfesolver/general_contact/native_retained_body_projection.py +160 -0
  519. anyfesolver/general_contact/native_retained_body_static.py +62 -0
  520. anyfesolver/general_contact/native_retained_cell_pair.py +185 -0
  521. anyfesolver/general_contact/native_retained_curve_cell.py +102 -0
  522. anyfesolver/general_contact/native_retained_line_plane.py +210 -0
  523. anyfesolver/general_contact/native_retained_line_s3.py +440 -0
  524. anyfesolver/general_contact/native_retained_line_s3_work.py +91 -0
  525. anyfesolver/general_contact/native_retained_pair_static.py +845 -0
  526. anyfesolver/general_contact/native_retained_s3_static.py +554 -0
  527. anyfesolver/general_contact/native_retained_static.py +478 -0
  528. anyfesolver/general_contact/native_retained_station.py +222 -0
  529. anyfesolver/general_contact/native_retained_whole_pair.py +2120 -0
  530. anyfesolver/general_contact/native_s3_swept.py +149 -0
  531. anyfesolver/general_contact/native_shell_static_driver.py +144 -0
  532. anyfesolver/general_contact/native_surface_activation.py +391 -0
  533. anyfesolver/general_contact/native_surface_bounds.py +198 -0
  534. anyfesolver/general_contact/native_surface_contributor.py +121 -0
  535. anyfesolver/general_contact/native_surface_crossing.py +81 -0
  536. anyfesolver/general_contact/native_surface_event_sequence.py +320 -0
  537. anyfesolver/general_contact/native_surface_extrema.py +72 -0
  538. anyfesolver/general_contact/native_surface_friction_integral.py +1724 -0
  539. anyfesolver/general_contact/native_surface_front.py +742 -0
  540. anyfesolver/general_contact/native_surface_front_boundary.py +160 -0
  541. anyfesolver/general_contact/native_surface_front_precision.py +78 -0
  542. anyfesolver/general_contact/native_surface_front_work.py +118 -0
  543. anyfesolver/general_contact/native_surface_history.py +334 -0
  544. anyfesolver/general_contact/native_surface_normal.py +324 -0
  545. anyfesolver/general_contact/native_surface_patch.py +213 -0
  546. anyfesolver/general_contact/native_surface_path.py +348 -0
  547. anyfesolver/general_contact/native_surface_quadrature.py +212 -0
  548. anyfesolver/general_contact/native_surface_s3_friction.py +340 -0
  549. anyfesolver/general_contact/native_surface_support.py +776 -0
  550. anyfesolver/general_contact/native_surface_transaction.py +198 -0
  551. anyfesolver/general_contact/native_transient_multi_shell.py +108 -0
  552. anyfesolver/general_contact/native_transient_pair.py +61 -0
  553. anyfesolver/general_contact/native_transient_shell.py +44 -0
  554. anyfesolver/general_contact/normal_s3_skin_path.py +163 -0
  555. anyfesolver/general_contact/overlap.py +443 -0
  556. anyfesolver/general_contact/pair.py +466 -0
  557. anyfesolver/general_contact/patch_broadphase.py +111 -0
  558. anyfesolver/general_contact/patch_mortar.py +593 -0
  559. anyfesolver/general_contact/patch_sliding.py +644 -0
  560. anyfesolver/general_contact/plane_newmark_events.py +278 -0
  561. anyfesolver/general_contact/pointwise_patch.py +288 -0
  562. anyfesolver/general_contact/polynomial_roots.py +312 -0
  563. anyfesolver/general_contact/pressure_basis.py +241 -0
  564. anyfesolver/general_contact/pressure_diagnostics.py +155 -0
  565. anyfesolver/general_contact/pressure_overlay.py +182 -0
  566. anyfesolver/general_contact/pressure_space.py +51 -0
  567. anyfesolver/general_contact/q4_material_checkpoint.py +276 -0
  568. anyfesolver/general_contact/q4_overlap_local_bound.py +1111 -0
  569. anyfesolver/general_contact/q4_q4_overlap_derivatives.py +234 -0
  570. anyfesolver/general_contact/q4_q4_swept_bound.py +58 -0
  571. anyfesolver/general_contact/q4_s3_overlap_derivatives.py +1159 -0
  572. anyfesolver/general_contact/q4_s3_tiny_wedge.py +180 -0
  573. anyfesolver/general_contact/q4_skin_work.py +87 -0
  574. anyfesolver/general_contact/q4_source_mortar_energy.py +181 -0
  575. anyfesolver/general_contact/q4_source_overlap.py +401 -0
  576. anyfesolver/general_contact/q4_target_overlap.py +181 -0
  577. anyfesolver/general_contact/request_identity.py +192 -0
  578. anyfesolver/general_contact/rigid_translation.py +199 -0
  579. anyfesolver/general_contact/runtime.py +27 -0
  580. anyfesolver/general_contact/s3_friction_chart_interval.py +104 -0
  581. anyfesolver/general_contact/s3_friction_coverage.py +165 -0
  582. anyfesolver/general_contact/s3_friction_dyadic_interval.py +39 -0
  583. anyfesolver/general_contact/s3_friction_history_path.py +111 -0
  584. anyfesolver/general_contact/s3_friction_mesh_coverage.py +145 -0
  585. anyfesolver/general_contact/s3_friction_mesh_gap.py +74 -0
  586. anyfesolver/general_contact/s3_friction_mesh_monolithic.py +150 -0
  587. anyfesolver/general_contact/s3_friction_monolithic.py +121 -0
  588. anyfesolver/general_contact/s3_friction_moving_coverage.py +114 -0
  589. anyfesolver/general_contact/s3_friction_pair.py +237 -0
  590. anyfesolver/general_contact/s3_friction_point.py +129 -0
  591. anyfesolver/general_contact/s3_friction_prepared_path.py +254 -0
  592. anyfesolver/general_contact/s3_friction_replay.py +1094 -0
  593. anyfesolver/general_contact/s3_friction_rim_path.py +69 -0
  594. anyfesolver/general_contact/s3_friction_rim_transaction.py +23 -0
  595. anyfesolver/general_contact/s3_friction_static.py +267 -0
  596. anyfesolver/general_contact/s3_friction_swept_gap.py +112 -0
  597. anyfesolver/general_contact/s3_friction_touch.py +94 -0
  598. anyfesolver/general_contact/s3_friction_weak_pressure.py +66 -0
  599. anyfesolver/general_contact/s3_overlap_derivatives.py +220 -0
  600. anyfesolver/general_contact/s3_overlap_hermite_gap.py +180 -0
  601. anyfesolver/general_contact/s3_pair_static.py +343 -0
  602. anyfesolver/general_contact/s3_patch_augmented.py +2056 -0
  603. anyfesolver/general_contact/s3_patch_mortar_energy.py +545 -0
  604. anyfesolver/general_contact/s3_patch_static.py +1725 -0
  605. anyfesolver/general_contact/s3_pressure_hermite_bounds.py +395 -0
  606. anyfesolver/general_contact/s3_pressure_polygon_bounds.py +73 -0
  607. anyfesolver/general_contact/s3_q4_gap_resolution.py +191 -0
  608. anyfesolver/general_contact/s3_q4_overlap_derivatives.py +252 -0
  609. anyfesolver/general_contact/s3_q4_swept.py +56 -0
  610. anyfesolver/general_contact/s3_skin_work.py +101 -0
  611. anyfesolver/general_contact/s3_sliding_friction.py +640 -0
  612. anyfesolver/general_contact/s3_stable_plane_gap.py +43 -0
  613. anyfesolver/general_contact/seed_path_vertex_interval.py +323 -0
  614. anyfesolver/general_contact/semismooth.py +133 -0
  615. anyfesolver/general_contact/semismooth_block.py +147 -0
  616. anyfesolver/general_contact/semismooth_path.py +871 -0
  617. anyfesolver/general_contact/shell_pair_hermite_sweep.py +336 -0
  618. anyfesolver/general_contact/shell_sphere_temporal_bounds.py +305 -0
  619. anyfesolver/general_contact/skin_geometry.py +106 -0
  620. anyfesolver/general_contact/sliding.py +349 -0
  621. anyfesolver/general_contact/sphere.py +691 -0
  622. anyfesolver/general_contact/sphere_temporal_bounds.py +241 -0
  623. anyfesolver/general_contact/static_path.py +2608 -0
  624. anyfesolver/general_contact/static_results_archive.py +140 -0
  625. anyfesolver/general_contact/structural_state_bridge.py +196 -0
  626. anyfesolver/general_contact/supported_schur.py +594 -0
  627. anyfesolver/general_contact/swept_patch_broadphase.py +160 -0
  628. anyfesolver/general_contact/transient.py +2921 -0
  629. anyfesolver/general_contact/transient_results_archive.py +491 -0
  630. anyfesolver/general_contact/triangle_mortar_energy.py +280 -0
  631. anyfesolver/general_contact/triangle_pair_energy.py +211 -0
  632. anyfesolver/general_contact/triangulated_rigid.py +94 -0
  633. anyfesolver/general_contact/triangulated_rigid_static.py +399 -0
  634. anyfesolver/general_contact/warped_q4_plane.py +185 -0
  635. anyfesolver/general_contact/warped_q4_skin.py +302 -0
  636. anyfesolver/general_contact/warped_q4_static.py +331 -0
  637. anyfesolver/impact_performance.py +273 -0
  638. anyfesolver/impact_reduced_assembly.py +294 -0
  639. anyfesolver/imperfections.py +397 -0
  640. anyfesolver/inertia_relief.py +676 -0
  641. anyfesolver/initial_field_state.py +54 -0
  642. anyfesolver/jit_compiler.py +135 -0
  643. anyfesolver/kernel_warmup.py +228 -0
  644. anyfesolver/linalg.py +1002 -0
  645. anyfesolver/marine_contributions.py +634 -0
  646. anyfesolver/marine_coupled_equilibrium.py +292 -0
  647. anyfesolver/marine_equilibrium.py +405 -0
  648. anyfesolver/marine_hydro_coordinates.py +346 -0
  649. anyfesolver/marine_linear.py +549 -0
  650. anyfesolver/marine_link.py +306 -0
  651. anyfesolver/marine_mechanical.py +923 -0
  652. anyfesolver/marine_mooring.py +533 -0
  653. anyfesolver/marine_morison.py +331 -0
  654. anyfesolver/marine_potential_flow.py +403 -0
  655. anyfesolver/marine_rigid.py +397 -0
  656. anyfesolver/marine_seabed.py +122 -0
  657. anyfesolver/mass_properties.py +352 -0
  658. anyfesolver/material_curves.py +52 -0
  659. anyfesolver/materials.py +43 -0
  660. anyfesolver/matrix_assembly.py +7330 -0
  661. anyfesolver/mesh_gen.py +904 -0
  662. anyfesolver/mesh_load_bc_verification.py +612 -0
  663. anyfesolver/modal.py +2494 -0
  664. anyfesolver/nonlinear.py +341 -0
  665. anyfesolver/nonlinear_analysis_diagnostics.py +466 -0
  666. anyfesolver/nonlinear_element_evaluation.py +126 -0
  667. anyfesolver/nonlinear_performance.py +2094 -0
  668. anyfesolver/nonlinear_performance_batch_b.py +1173 -0
  669. anyfesolver/nonlinear_performance_batch_c.py +850 -0
  670. anyfesolver/nonlinear_performance_bootstrap.py +164 -0
  671. anyfesolver/nonlinear_reduced_assembly.py +806 -0
  672. anyfesolver/nonlinear_restart.py +1708 -0
  673. anyfesolver/nonlinear_state.py +2800 -0
  674. anyfesolver/nonlinear_static.py +9407 -0
  675. anyfesolver/outcomes.py +694 -0
  676. anyfesolver/plasticity.py +2087 -0
  677. anyfesolver/plasticity_qualification.py +758 -0
  678. anyfesolver/prepared_static.py +1129 -0
  679. anyfesolver/prepared_static_envelopes.py +389 -0
  680. anyfesolver/prepared_static_loads.py +1180 -0
  681. anyfesolver/prepared_static_measures.py +18 -0
  682. anyfesolver/prepared_static_numeric.py +247 -0
  683. anyfesolver/prepared_static_q4.py +297 -0
  684. anyfesolver/prepared_static_recovery.py +2068 -0
  685. anyfesolver/prepared_static_response.py +1013 -0
  686. anyfesolver/prepared_static_shared.py +226 -0
  687. anyfesolver/prepared_static_snapshot.py +323 -0
  688. anyfesolver/prepared_static_vectorized.py +866 -0
  689. anyfesolver/pressure_regions.py +287 -0
  690. anyfesolver/production_readiness.py +343 -0
  691. anyfesolver/quality_control.py +1487 -0
  692. anyfesolver/quantities.py +1289 -0
  693. anyfesolver/recovery.py +4217 -0
  694. anyfesolver/recovery_batches.py +1985 -0
  695. anyfesolver/recovery_policy.py +205 -0
  696. anyfesolver/recovery_s4.py +289 -0
  697. anyfesolver/recovery_shell_frames.py +102 -0
  698. anyfesolver/reference_cases.py +366 -0
  699. anyfesolver/result_capsule.py +2175 -0
  700. anyfesolver/results.py +752 -0
  701. anyfesolver/runtime.py +9819 -0
  702. anyfesolver/s3_reference_batch.py +1338 -0
  703. anyfesolver/s3_v2c_fast_assembly.py +544 -0
  704. anyfesolver/s3_v2d_fast_assembly.py +447 -0
  705. anyfesolver/s4_validity.py +354 -0
  706. anyfesolver/sections.py +67 -0
  707. anyfesolver/sesam_fem/__init__.py +55 -0
  708. anyfesolver/sesam_fem/__main__.py +80 -0
  709. anyfesolver/sesam_fem/diagnostics.py +5 -0
  710. anyfesolver/sesam_fem/document.py +39 -0
  711. anyfesolver/sesam_fem/exporter.py +9 -0
  712. anyfesolver/sesam_fem/importer.py +228 -0
  713. anyfesolver/sesam_fem/records.py +21 -0
  714. anyfesolver/sesam_fem/schema.py +35 -0
  715. anyfesolver/sesam_fem/sif_importer.py +9 -0
  716. anyfesolver/sesam_fem/validation.py +5 -0
  717. anyfesolver/sestra_deep_diagnostics.py +173 -0
  718. anyfesolver/sestra_mixed_verification.py +146 -0
  719. anyfesolver/sestra_structure_benchmarks.py +270 -0
  720. anyfesolver/sestra_three_case.py +215 -0
  721. anyfesolver/sestra_verification.py +523 -0
  722. anyfesolver/shell_benchmarks.py +367 -0
  723. anyfesolver/shell_formulations/director_field.py +799 -0
  724. anyfesolver/shell_formulations/geometry_provenance.py +921 -0
  725. anyfesolver/shell_formulations/mitc4_plus_d_quality.py +318 -0
  726. anyfesolver/shell_formulations/mitc4_plus_d_reference.py +837 -0
  727. anyfesolver/shell_formulations/mitc4_plus_d_scalar.py +209 -0
  728. anyfesolver/shell_formulations/protocol.py +222 -0
  729. anyfesolver/shell_formulations/q4_common.py +271 -0
  730. anyfesolver/shell_formulations/s4_restricted_policy.py +78 -0
  731. anyfesolver/shell_sections.py +394 -0
  732. anyfesolver/solid_submodel.py +930 -0
  733. anyfesolver/static_batch.py +662 -0
  734. anyfesolver/static_envelopes.py +250 -0
  735. anyfesolver/stiffened_shell.py +388 -0
  736. anyfesolver/submodel_transfer.py +1306 -0
  737. anyfesolver/test_cases.py +610 -0
  738. anyfesolver/threading_policy.py +431 -0
  739. anyfesolver/validation.py +719 -0
  740. anyfesolver/vectorized_beam.py +139 -0
  741. anyfesolver/vectorized_generalized_shell.py +448 -0
  742. anyfesolver/vectorized_hill48.py +956 -0
  743. anyfesolver/vectorized_nonlinear.py +360 -0
  744. anyfesolver/vectorized_stiffness.py +694 -0
  745. anyfesolver-0.5.0a1.dist-info/METADATA +374 -0
  746. anyfesolver-0.5.0a1.dist-info/RECORD +751 -0
  747. anyfesolver-0.5.0a1.dist-info/WHEEL +5 -0
  748. anyfesolver-0.5.0a1.dist-info/licenses/COPYRIGHT +1 -0
  749. anyfesolver-0.5.0a1.dist-info/licenses/LICENSE +373 -0
  750. anyfesolver-0.5.0a1.dist-info/licenses/THIRD_PARTY_NOTICES.md +32 -0
  751. anyfesolver-0.5.0a1.dist-info/top_level.txt +1 -0
@@ -0,0 +1,719 @@
1
+ """Validation helpers for FE solver verification tests and benchmarks.
2
+
3
+ The functions in this module are intentionally lightweight. They do not define
4
+ new solver behaviour; they inspect assembled models, load vectors, solver
5
+ metadata and reconstructed displacement fields so tests and production
6
+ preflight checks can lock the supported architecture.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ from dataclasses import dataclass, field
12
+ from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Mapping, Optional, Sequence, Tuple
13
+
14
+ import numpy as np
15
+
16
+ if TYPE_CHECKING:
17
+ from .boundary import LoadCase
18
+ from .fe_core import FEModel
19
+
20
+
21
+ @dataclass(frozen=True)
22
+ class LoadResultant:
23
+ """Global resultant force and moment of a load vector."""
24
+
25
+ force: np.ndarray
26
+ moment: np.ndarray
27
+
28
+ @property
29
+ def force_norm(self) -> float:
30
+ return float(np.linalg.norm(self.force))
31
+
32
+ @property
33
+ def moment_norm(self) -> float:
34
+ return float(np.linalg.norm(self.moment))
35
+
36
+
37
+ @dataclass(frozen=True)
38
+ class ShellPatchSummary:
39
+ """Compact shell verification summary."""
40
+
41
+ element_id: int
42
+ strain_energy: float
43
+ stiffness_symmetry_error: float
44
+ max_membrane_spread: float
45
+ max_bending_spread: float
46
+
47
+
48
+ @dataclass(frozen=True)
49
+ class ProductionValidationIssue:
50
+ """Structured production model validation diagnostic."""
51
+
52
+ code: str
53
+ severity: str
54
+ entity_type: str
55
+ entity_id: Optional[int]
56
+ message: str
57
+ measured: Optional[float] = None
58
+ limit: Optional[float] = None
59
+ suggestion: str = ""
60
+
61
+ def to_dict(self) -> Dict[str, Any]:
62
+ return {
63
+ "code": self.code,
64
+ "severity": self.severity,
65
+ "entity_type": self.entity_type,
66
+ "entity_id": self.entity_id,
67
+ "message": self.message,
68
+ "measured": self.measured,
69
+ "limit": self.limit,
70
+ "suggestion": self.suggestion,
71
+ }
72
+
73
+
74
+ @dataclass(frozen=True)
75
+ class ProductionValidationReport:
76
+ """Production guardrail report for a model before analysis."""
77
+
78
+ status: str
79
+ issues: Tuple[ProductionValidationIssue, ...]
80
+ mesh_quality: Dict[str, Any]
81
+ revision_signature: Dict[str, int]
82
+ constraint_audit: Dict[str, Any] = field(default_factory=dict)
83
+
84
+ @property
85
+ def errors(self) -> Tuple[ProductionValidationIssue, ...]:
86
+ return tuple(issue for issue in self.issues if issue.severity == "error")
87
+
88
+ @property
89
+ def warnings(self) -> Tuple[ProductionValidationIssue, ...]:
90
+ return tuple(issue for issue in self.issues if issue.severity == "warning")
91
+
92
+ def to_dict(self) -> Dict[str, Any]:
93
+ return {
94
+ "status": self.status,
95
+ "issues": [issue.to_dict() for issue in self.issues],
96
+ "mesh_quality": self.mesh_quality,
97
+ "revision_signature": self.revision_signature,
98
+ "constraint_audit": self.constraint_audit,
99
+ "error_count": len(self.errors),
100
+ "warning_count": len(self.warnings),
101
+ }
102
+
103
+
104
+ def dof_order_signature(model: "FEModel") -> Dict[int, List[Tuple[int, str]]]:
105
+ """Return node DOF indices with local DOF names.
106
+
107
+ This is used by tests to protect the required ordering:
108
+ ux, uy, uz, rx, ry, rz.
109
+ """
110
+ signature: Dict[int, List[Tuple[int, str]]] = {}
111
+ dof_manager = model.mesh.dof_manager
112
+ for node_id, node in model.mesh.nodes.items():
113
+ entries: List[Tuple[int, str]] = []
114
+ for dof in node.dofs:
115
+ _node_id, _local_index, name = dof_manager.get_dof_info(dof)
116
+ entries.append((int(dof), name))
117
+ signature[int(node_id)] = entries
118
+ return signature
119
+
120
+
121
+ def load_vector_resultant(model: "FEModel", load_vector: np.ndarray) -> LoadResultant:
122
+ """Compute global force and moment resultants from a full load vector.
123
+
124
+ The moment is taken about the model coordinate origin.
125
+ """
126
+ load_vector = np.asarray(load_vector, dtype=float).reshape(-1)
127
+ force = np.zeros(3, dtype=float)
128
+ moment = np.zeros(3, dtype=float)
129
+ for node in model.mesh.nodes.values():
130
+ node_force = load_vector[node.dofs[:3]]
131
+ node_moment = load_vector[node.dofs[3:6]]
132
+ r = node.coords()
133
+ force += node_force
134
+ moment += np.cross(r, node_force) + node_moment
135
+ return LoadResultant(force=force, moment=moment)
136
+
137
+
138
+ def load_case_resultant(model: "FEModel", load_case: "LoadCase") -> LoadResultant:
139
+ """Assemble a load case and return global force/moment resultants."""
140
+ load_vector = load_case.get_load_vector(model.mesh, model.mesh.dof_manager, model.get_material)
141
+ return load_vector_resultant(model, load_vector)
142
+
143
+
144
+ def mpc_constraint_residuals(model: "FEModel", displacements: np.ndarray) -> Dict[str, float]:
145
+ """Return residuals for all element-provided linear MPC constraints.
146
+
147
+ A constraint is interpreted as:
148
+
149
+ u_slave = sum(coeff_i * u_master_i) + value
150
+
151
+ The residual returned is lhs - rhs. A correct reconstructed displacement
152
+ field should give residuals close to zero for every MPC.
153
+ """
154
+ u = np.asarray(displacements, dtype=float).reshape(-1)
155
+ residuals: Dict[str, float] = {}
156
+ counter = 0
157
+ for element in model.mesh.elements.values():
158
+ getter = getattr(element, "get_mpc_constraints", None)
159
+ if getter is None:
160
+ continue
161
+ for constraint in getter(model.mesh) or []:
162
+ slave = int(constraint["slave"])
163
+ masters = constraint.get("masters", {})
164
+ value = float(constraint.get("value", 0.0))
165
+ rhs = value
166
+ for master, coefficient in masters.items():
167
+ rhs += float(coefficient) * float(u[int(master)])
168
+ label = str(constraint.get("label", f"mpc_{counter}"))
169
+ residuals[label] = float(u[slave] - rhs)
170
+ counter += 1
171
+ return residuals
172
+
173
+
174
+ def shell_element_patch_summary(model: "FEModel", element_id: int, element_displacements: np.ndarray) -> ShellPatchSummary:
175
+ """Return compact shell element diagnostics for a supplied element displacement field."""
176
+ element = model.mesh.get_element(element_id)
177
+ if element is None:
178
+ raise ValueError(f"Element {element_id} not found")
179
+ material = model.get_material(element.material_name)
180
+ u = np.asarray(element_displacements, dtype=float).reshape(-1)
181
+ if u.shape != (element.total_dofs,):
182
+ raise ValueError(f"Element displacement shape {u.shape} does not match {(element.total_dofs,)}")
183
+
184
+ K = element.compute_stiffness_matrix(model.mesh, material)
185
+ stresses = element.compute_stresses(model.mesh, u, material)
186
+ membrane_arrays = [
187
+ np.asarray(stresses[key], dtype=float)
188
+ for key in ("membrane_xx", "membrane_yy", "membrane_xy")
189
+ if key in stresses
190
+ ]
191
+ bending_arrays = [
192
+ np.asarray(stresses[key], dtype=float)
193
+ for key in ("bending_xx", "bending_yy", "bending_xy")
194
+ if key in stresses
195
+ ]
196
+
197
+ max_membrane_spread = max((float(np.max(values) - np.min(values)) for values in membrane_arrays), default=0.0)
198
+ max_bending_spread = max((float(np.max(values) - np.min(values)) for values in bending_arrays), default=0.0)
199
+ return ShellPatchSummary(
200
+ element_id=int(element_id),
201
+ strain_energy=float(u @ K @ u),
202
+ stiffness_symmetry_error=float(np.linalg.norm(K - K.T)),
203
+ max_membrane_spread=max_membrane_spread,
204
+ max_bending_spread=max_bending_spread,
205
+ )
206
+
207
+
208
+ def max_abs(values: Iterable[float]) -> float:
209
+ """Return max absolute value, or 0.0 for an empty iterable."""
210
+ data = [abs(float(value)) for value in values]
211
+ return max(data) if data else 0.0
212
+
213
+
214
+ def nullspace_diagnostics(solver_info: Dict[str, Any]) -> Dict[str, Any]:
215
+ """Extract nullspace-related diagnostics in a stable shape for tests."""
216
+ convergence = solver_info.get("convergence_info", {}) or {}
217
+ nullspace = solver_info.get("nullspace_info", {}) or {}
218
+ return {
219
+ "constraint_method": solver_info.get("constraint_method", ""),
220
+ "rank": int(nullspace.get("rank", convergence.get("nullspace_rank", 0)) or 0),
221
+ "relative_rigid_body_load_imbalance": float(convergence.get("relative_rigid_body_load_imbalance", 0.0) or 0.0),
222
+ "augmented_residual_norm": float(convergence.get("augmented_residual_norm", 0.0) or 0.0),
223
+ "gauge_residual_norm": float(convergence.get("gauge_residual_norm", 0.0) or 0.0),
224
+ "status": convergence.get("status", "unknown"),
225
+ "warnings": list(convergence.get("warnings", []) or []),
226
+ }
227
+
228
+
229
+ def _issue(
230
+ code: str,
231
+ severity: str,
232
+ entity_type: str,
233
+ entity_id: Optional[int],
234
+ message: str,
235
+ *,
236
+ measured: Optional[float] = None,
237
+ limit: Optional[float] = None,
238
+ suggestion: str = "",
239
+ ) -> ProductionValidationIssue:
240
+ return ProductionValidationIssue(
241
+ code=code,
242
+ severity=severity,
243
+ entity_type=entity_type,
244
+ entity_id=None if entity_id is None else int(entity_id),
245
+ message=message,
246
+ measured=None if measured is None else float(measured),
247
+ limit=None if limit is None else float(limit),
248
+ suggestion=suggestion,
249
+ )
250
+
251
+
252
+ def _shell_corner_metrics(coords: np.ndarray) -> Dict[str, float]:
253
+ coordinates = np.asarray(coords, dtype=float)
254
+ if coordinates.ndim != 2 or coordinates.shape[1] != 3:
255
+ raise ValueError("shell coordinates must be an N x 3 array")
256
+ if not np.all(np.isfinite(coordinates)):
257
+ raise ValueError("shell coordinates must be finite")
258
+
259
+ node_count = int(coordinates.shape[0])
260
+ if node_count in {3, 6}:
261
+ corner = coordinates[:3]
262
+ elif node_count in {4, 8}:
263
+ corner = coordinates[:4]
264
+ else:
265
+ raise ValueError(
266
+ "shell mesh-quality evaluation supports 3, 4, 6 or 8 nodes; "
267
+ f"received {node_count}"
268
+ )
269
+
270
+ corner_count = int(corner.shape[0])
271
+ edges = [
272
+ corner[(index + 1) % corner_count] - corner[index]
273
+ for index in range(corner_count)
274
+ ]
275
+ lengths = [float(np.linalg.norm(edge)) for edge in edges]
276
+ min_edge = min(lengths) if lengths else 0.0
277
+ max_edge = max(lengths) if lengths else 0.0
278
+ aspect_ratio = max_edge / max(min_edge, 1.0e-15)
279
+ normal_raw = np.cross(corner[1] - corner[0], corner[2] - corner[0])
280
+ normal_norm = float(np.linalg.norm(normal_raw))
281
+ signed_area = 0.5 * normal_norm
282
+ if corner_count == 4:
283
+ signed_area += 0.5 * float(
284
+ np.linalg.norm(
285
+ np.cross(corner[2] - corner[0], corner[3] - corner[0])
286
+ )
287
+ )
288
+ warp = 0.0
289
+ if corner_count == 4 and normal_norm > 1.0e-15:
290
+ normal = normal_raw / normal_norm
291
+ warp = abs(float(np.dot(corner[3] - corner[0], normal))) / max(
292
+ sum(lengths) / float(corner_count), 1.0e-15
293
+ )
294
+ return {
295
+ "min_edge": min_edge,
296
+ "max_edge": max_edge,
297
+ "aspect_ratio": aspect_ratio,
298
+ "warp": warp,
299
+ "area": signed_area,
300
+ }
301
+
302
+
303
+ def _q8_midside_deviation(coords: np.ndarray) -> float:
304
+ if np.asarray(coords).shape[0] != 8:
305
+ return 0.0
306
+ pairs = ((0, 1, 4), (1, 2, 5), (2, 3, 6), (3, 0, 7))
307
+ deviations = []
308
+ for i, j, midside in pairs:
309
+ midpoint = 0.5 * (coords[i] + coords[j])
310
+ edge_length = max(float(np.linalg.norm(coords[j] - coords[i])), 1.0e-15)
311
+ deviations.append(float(np.linalg.norm(coords[midside] - midpoint)) / edge_length)
312
+ return max(deviations) if deviations else 0.0
313
+
314
+
315
+ def validate_production_model(
316
+ model: "FEModel",
317
+ load_cases: Optional[Sequence["LoadCase"]] = None,
318
+ *,
319
+ analysis_type: Optional[str] = None,
320
+ kinematics: str = "von_karman",
321
+ corotational_tangent: str = "auto",
322
+ allow_free_mechanisms: bool = False,
323
+ aspect_ratio_limit: float = 8.0,
324
+ warp_limit: float = 0.08,
325
+ midside_deviation_limit: float = 0.20,
326
+ ) -> ProductionValidationReport:
327
+ """Validate model inputs and mesh quality before production analysis.
328
+
329
+ The function is deliberately conservative: it catches invalid or
330
+ unsupported configurations early and returns structured diagnostics with
331
+ entity IDs and corrective hints. It does not run a full analysis.
332
+ """
333
+ from .assembly import build_constraint_transformation, build_reduced_rigid_body_modes
334
+ from .beam_sections import (
335
+ generalized_beam_mass_matrix,
336
+ generalized_beam_stiffness,
337
+ )
338
+ from .elements import BeamElement, CoupledBeamShellElement, QuadraticBeamElement, ShellElement
339
+ from .materials import material_symmetry, material_validation_errors
340
+ from .matrix_assembly import assemble_stiffness_matrix
341
+ from .shell_sections import validate_generalized_shell_section
342
+ from .constraint_audit import audit_constraints
343
+
344
+ issues: List[ProductionValidationIssue] = []
345
+ constraint_audit = audit_constraints(model)
346
+ for audit_issue in constraint_audit.issues:
347
+ issues.append(
348
+ _issue(
349
+ audit_issue.code,
350
+ audit_issue.severity,
351
+ "constraint",
352
+ audit_issue.dof,
353
+ audit_issue.message,
354
+ suggestion="Correct the support/MPC definition before analysis.",
355
+ )
356
+ )
357
+ analysis_name = None if analysis_type is None else str(analysis_type).strip().lower()
358
+ mesh_quality: Dict[str, Any] = {
359
+ "shell_count": 0,
360
+ "beam_count": 0,
361
+ "max_aspect_ratio": 1.0,
362
+ "max_warp": 0.0,
363
+ "max_q8_midside_deviation": 0.0,
364
+ "min_edge_length": None,
365
+ }
366
+
367
+ for name, material in model.materials.items():
368
+ entity_id = None
369
+ try:
370
+ symmetry = material_symmetry(material)
371
+ except ValueError as exc:
372
+ symmetry = ""
373
+ issues.append(
374
+ _issue(
375
+ "MAT004",
376
+ "error",
377
+ "material",
378
+ entity_id,
379
+ f"Material {name!r} does not satisfy the structural material contract: {exc}",
380
+ suggestion="Declare isotropic or orthotropic elasticity and provide 6x6 engineering compliance.",
381
+ )
382
+ )
383
+
384
+ if symmetry == "isotropic":
385
+ elastic_modulus = getattr(material, "elastic_modulus", None)
386
+ poisson_ratio = getattr(material, "poisson_ratio", None)
387
+ try:
388
+ elastic_modulus_value = (
389
+ None if elastic_modulus is None else float(elastic_modulus)
390
+ )
391
+ except (TypeError, ValueError):
392
+ elastic_modulus_value = float("nan")
393
+ if elastic_modulus_value is not None and (
394
+ not np.isfinite(elastic_modulus_value) or elastic_modulus_value <= 0.0
395
+ ):
396
+ issues.append(_issue("MAT001", "error", "material", entity_id, f"Material {name!r} has invalid elastic modulus.", measured=elastic_modulus_value, limit=0.0, suggestion="Use a positive SI elastic modulus."))
397
+ try:
398
+ poisson_ratio_value = (
399
+ None if poisson_ratio is None else float(poisson_ratio)
400
+ )
401
+ except (TypeError, ValueError):
402
+ poisson_ratio_value = float("nan")
403
+ if poisson_ratio_value is not None and (
404
+ not np.isfinite(poisson_ratio_value) or not (-0.99 < poisson_ratio_value < 0.5)
405
+ ):
406
+ issues.append(_issue("MAT002", "error", "material", entity_id, f"Material {name!r} has unsupported Poisson ratio.", measured=poisson_ratio_value, limit=0.5, suggestion="Use -0.99 < nu < 0.5 for isotropic elastic material."))
407
+ elif symmetry and symmetry not in {"isotropic", "orthotropic"}:
408
+ detail = (
409
+ "General anisotropic elasticity is not supported; arbitrary constitutive "
410
+ "coupling and general beam section stiffness are outside this capability."
411
+ if symmetry == "anisotropic"
412
+ else f"Elastic symmetry {symmetry!r} is not supported."
413
+ )
414
+ issues.append(
415
+ _issue(
416
+ "MAT004",
417
+ "error",
418
+ "material",
419
+ entity_id,
420
+ f"Material {name!r}: {detail}",
421
+ suggestion="Use elastic_symmetry='isotropic' or 'orthotropic'.",
422
+ )
423
+ )
424
+
425
+ density = getattr(material, "density", float("nan"))
426
+ try:
427
+ density_value = float(density)
428
+ except (TypeError, ValueError):
429
+ density_value = float("nan")
430
+ if not np.isfinite(density_value) or density_value < 0.0:
431
+ issues.append(_issue("MAT003", "error", "material", entity_id, f"Material {name!r} has invalid density.", measured=density_value, limit=0.0, suggestion="Use zero or positive SI density."))
432
+
433
+ contract_errors = material_validation_errors(material)
434
+ for message in contract_errors:
435
+ # Preserve the established, more specific diagnostics above.
436
+ if "density" in message:
437
+ continue
438
+ if symmetry == "isotropic" and (
439
+ "isotropic elastic modulus" in message
440
+ or "isotropic Poisson ratio" in message
441
+ or "positive definite" in message
442
+ ):
443
+ continue
444
+ if symmetry not in {"isotropic", "orthotropic"} and (
445
+ "not supported" in message or "anisotropic" in message
446
+ ):
447
+ continue
448
+ issues.append(
449
+ _issue(
450
+ "MAT004",
451
+ "error",
452
+ "material",
453
+ entity_id,
454
+ f"Material {name!r} is invalid: {message}.",
455
+ suggestion="Correct the structural material definition before analysis.",
456
+ )
457
+ )
458
+
459
+ slave_dof_owner: Dict[int, int] = {}
460
+ min_edge_values: List[float] = []
461
+ q8r_element_ids: List[int] = []
462
+ for element_id, element in model.mesh.elements.items():
463
+ material_name = getattr(element, "material_name", None)
464
+ if material_name not in model.materials:
465
+ issues.append(_issue("ELM001", "error", "element", int(element_id), f"Element references missing material {material_name!r}.", suggestion="Add the material before analysis or assign a valid material name."))
466
+ thickness = getattr(element, "thickness", None)
467
+ if thickness is not None and (not np.isfinite(float(thickness)) or float(thickness) <= 0.0):
468
+ issues.append(_issue("SHELL001", "error", "element", int(element_id), "Shell element has non-positive thickness.", measured=float(thickness), limit=0.0, suggestion="Use a positive shell thickness in metres."))
469
+
470
+ if isinstance(element, ShellElement):
471
+ mesh_quality["shell_count"] += 1
472
+ if getattr(element, "_is_8node", False) and bool(getattr(element, "reduced_integration", False)):
473
+ q8r_element_ids.append(int(element_id))
474
+ try:
475
+ coords = element.get_node_coordinates(model.mesh)
476
+ metrics = _shell_corner_metrics(coords)
477
+ min_edge_values.append(float(metrics["min_edge"]))
478
+ mesh_quality["max_aspect_ratio"] = max(float(mesh_quality["max_aspect_ratio"]), float(metrics["aspect_ratio"]))
479
+ mesh_quality["max_warp"] = max(float(mesh_quality["max_warp"]), float(metrics["warp"]))
480
+ if metrics["area"] <= 1.0e-18 or metrics["min_edge"] <= 1.0e-14:
481
+ issues.append(_issue("MESH001", "error", "element", int(element_id), "Shell element is degenerate or has near-zero area.", measured=metrics["area"], limit=1.0e-18, suggestion="Repair node ordering/coordinates or remesh this region."))
482
+ if metrics["aspect_ratio"] > aspect_ratio_limit:
483
+ issues.append(_issue("MESH002", "warning", "element", int(element_id), "Shell element aspect ratio exceeds production guidance.", measured=metrics["aspect_ratio"], limit=aspect_ratio_limit, suggestion="Refine or rebalance the mesh locally."))
484
+ if metrics["warp"] > warp_limit:
485
+ issues.append(_issue("MESH003", "warning", "element", int(element_id), "Shell element warpage exceeds production guidance.", measured=metrics["warp"], limit=warp_limit, suggestion="Use smaller elements or flatten the panel representation."))
486
+ midside = _q8_midside_deviation(coords)
487
+ mesh_quality["max_q8_midside_deviation"] = max(float(mesh_quality["max_q8_midside_deviation"]), midside)
488
+ if midside > midside_deviation_limit:
489
+ issues.append(_issue("MESH004", "warning", "element", int(element_id), "Q8/S8 midside node deviates strongly from edge midpoint.", measured=midside, limit=midside_deviation_limit, suggestion="Place midside nodes near geometric edge midpoints or regenerate the mesh."))
490
+ material = model.materials.get(material_name)
491
+ shell_section = getattr(element, "shell_section", None)
492
+ if shell_section is not None:
493
+ try:
494
+ validate_generalized_shell_section(shell_section)
495
+ except (TypeError, ValueError) as exc:
496
+ issues.append(
497
+ _issue(
498
+ "SHELL003",
499
+ "error",
500
+ "element",
501
+ int(element_id),
502
+ f"Generalized shell section is invalid: {exc}",
503
+ suggestion=(
504
+ "Provide finite A/B/D/As matrices with a "
505
+ "positive-definite ABD and transverse-shear law."
506
+ ),
507
+ )
508
+ )
509
+ if analysis_name in {"nonlinear_static", "arc_length"} and (
510
+ getattr(material, "hardening_curve", None) is not None
511
+ or getattr(material, "hill_yield", None) is not None
512
+ ):
513
+ issues.append(
514
+ _issue(
515
+ "SHELL004",
516
+ "error",
517
+ "element",
518
+ int(element_id),
519
+ "Generalized shell sections are linear elastic and "
520
+ "cannot use material layer plasticity.",
521
+ suggestion=(
522
+ "Remove the material hardening/yield law or use "
523
+ "a homogeneous material-driven shell."
524
+ ),
525
+ )
526
+ )
527
+ if (
528
+ material is not None
529
+ and (
530
+ shell_section is not None
531
+ or material_symmetry(material) == "orthotropic"
532
+ )
533
+ ):
534
+ element._material_angle(element._center_frame(coords))
535
+ except Exception as exc:
536
+ issues.append(_issue("MESH005", "error", "element", int(element_id), f"Shell mesh-quality evaluation failed: {exc}", suggestion="Check element connectivity and node coordinates."))
537
+ elif isinstance(element, CoupledBeamShellElement):
538
+ pass
539
+ else:
540
+ mesh_quality["beam_count"] += 1
541
+ if isinstance(element, (BeamElement, QuadraticBeamElement)):
542
+ material = model.materials.get(material_name)
543
+ generalized_section = getattr(element, "generalized_section", None)
544
+ if generalized_section is not None:
545
+ try:
546
+ generalized_beam_stiffness(generalized_section)
547
+ generalized_beam_mass_matrix(generalized_section)
548
+ except (TypeError, ValueError) as exc:
549
+ issues.append(
550
+ _issue(
551
+ "BEAM005",
552
+ "error",
553
+ "element",
554
+ int(element_id),
555
+ f"Generalized beam section is invalid: {exc}",
556
+ suggestion=(
557
+ "Provide finite symmetric positive-definite "
558
+ "6x6 sectional stiffness and optional "
559
+ "mass-per-length matrices."
560
+ ),
561
+ )
562
+ )
563
+ if (
564
+ generalized_section is None
565
+ and material is not None
566
+ and material_symmetry(material) == "orthotropic"
567
+ ):
568
+ rigidity = getattr(element, "cross_section", {}).get("torsional_rigidity")
569
+ try:
570
+ rigidity_value = (
571
+ float("nan") if rigidity is None else float(rigidity)
572
+ )
573
+ except (TypeError, ValueError):
574
+ rigidity_value = float("nan")
575
+ if not np.isfinite(rigidity_value) or rigidity_value <= 0.0:
576
+ issues.append(
577
+ _issue(
578
+ "BEAM004",
579
+ "error",
580
+ "element",
581
+ int(element_id),
582
+ "Orthotropic beam section lacks a positive torsional_rigidity.",
583
+ measured=(
584
+ rigidity_value
585
+ if np.isfinite(rigidity_value)
586
+ else None
587
+ ),
588
+ limit=0.0,
589
+ suggestion="Provide cross_section['torsional_rigidity'] in N*m^2.",
590
+ )
591
+ )
592
+
593
+ getter = getattr(element, "get_mpc_constraints", None)
594
+ if getter is not None:
595
+ for constraint in getter(model.mesh) or []:
596
+ slave = int(constraint.get("slave"))
597
+ previous = slave_dof_owner.get(slave)
598
+ if previous is not None and previous != int(element_id):
599
+ issues.append(_issue("MPC001", "error", "mpc", int(element_id), f"MPC slave DOF {slave} is constrained by multiple MPC elements.", measured=float(slave), suggestion="Ensure each dependent DOF has only one owner."))
600
+ slave_dof_owner[slave] = int(element_id)
601
+
602
+ if min_edge_values:
603
+ mesh_quality["min_edge_length"] = float(min(min_edge_values))
604
+ if q8r_element_ids:
605
+ issues.append(
606
+ _issue(
607
+ "SHELL002",
608
+ "warning",
609
+ "element",
610
+ q8r_element_ids[0],
611
+ f"{len(q8r_element_ids)} Q8R element(s) use an experimental reduced-integration "
612
+ "stabilization and lumped mass formulation.",
613
+ suggestion="Use full-integration Q8 for qualified thin-shell bending or independently "
614
+ "verify hourglass energy and inertia sensitivity.",
615
+ )
616
+ )
617
+
618
+ kinematics_name = str(kinematics).strip().lower()
619
+ from .corotational import resolve_corotational_tangent_mode
620
+
621
+ try:
622
+ resolved_corotational_tangent = resolve_corotational_tangent_mode(
623
+ kinematics_name,
624
+ corotational_tangent,
625
+ follower_pressure=any(
626
+ bool(getattr(case, "follower_pressure", False))
627
+ for case in (load_cases or ())
628
+ ),
629
+ )
630
+ except ValueError as exc:
631
+ resolved_corotational_tangent = "invalid"
632
+ issues.append(
633
+ _issue(
634
+ "ANALYSIS001",
635
+ "error",
636
+ "model",
637
+ None,
638
+ str(exc),
639
+ suggestion=(
640
+ "Use corotational_tangent='auto', 'rotated', or "
641
+ "'consistent' with compatible kinematics."
642
+ ),
643
+ )
644
+ )
645
+ for load_case in load_cases or ():
646
+ follower_pressure = bool(getattr(load_case, "follower_pressure", False))
647
+ if follower_pressure and analysis_name not in {"nonlinear_static", "arc_length"}:
648
+ issues.append(
649
+ _issue(
650
+ "LOAD001",
651
+ "error",
652
+ "load_case",
653
+ None,
654
+ f"Load case {load_case.name!r} requests follower pressure without an explicitly "
655
+ f"supported analysis type (received {analysis_type!r}).",
656
+ suggestion="Set analysis_type to nonlinear_static or arc_length, or use reference-configuration dead pressure.",
657
+ )
658
+ )
659
+ if (
660
+ follower_pressure
661
+ and kinematics_name == "corotational"
662
+ and resolved_corotational_tangent != "consistent"
663
+ ):
664
+ issues.append(
665
+ _issue(
666
+ "LOAD001",
667
+ "error",
668
+ "load_case",
669
+ None,
670
+ f"Load case {load_case.name!r} combines follower pressure with "
671
+ "a corotational solve that does not use the consistent "
672
+ "frame-derivative tangent.",
673
+ suggestion=(
674
+ "Use corotational_tangent='consistent' (or 'auto') "
675
+ "for follower-pressure equilibrium."
676
+ ),
677
+ )
678
+ )
679
+ for element_id in getattr(load_case, "pressure_loads", {}) or {}:
680
+ element = model.mesh.get_element(int(element_id))
681
+ if element is None:
682
+ issues.append(_issue("LOAD002", "error", "load_case", None, f"Load case {load_case.name!r} references missing pressure element {element_id}.", measured=float(element_id), suggestion="Remove stale pressure load entries or regenerate the load case."))
683
+ elif follower_pressure and not isinstance(element, ShellElement):
684
+ issues.append(
685
+ _issue(
686
+ "LOAD001",
687
+ "error",
688
+ "element",
689
+ int(element_id),
690
+ f"Follower pressure requires a 3/4/6/8-node shell interpolation; "
691
+ f"element {element_id} is {type(element).__name__}.",
692
+ suggestion="Apply follower pressure only to supported shell elements.",
693
+ )
694
+ )
695
+
696
+ if not allow_free_mechanisms and not any(issue.severity == "error" for issue in issues):
697
+ try:
698
+ model.apply_boundary_conditions()
699
+ K, _info = assemble_stiffness_matrix(model)
700
+ zero = np.zeros(model.mesh.dof_manager.total_dofs, dtype=float)
701
+ _K_red, _F_red, _T, _u0, independent, _constraint_info = build_constraint_transformation(K, zero, model)
702
+ Q, nullspace = build_reduced_rigid_body_modes(model, independent, int(K.shape[0]))
703
+ rank = int(Q.shape[1])
704
+ if rank > 0:
705
+ issues.append(_issue("MECH001", "error", "model", None, "Model has unsupported free rigid-body mechanisms for ordinary production static analysis.", measured=float(rank), limit=0.0, suggestion="Add supports, use a self-equilibrated free-free workflow, or explicitly allow free mechanisms."))
706
+ mesh_quality["rigid_body_nullspace_rank"] = rank
707
+ mesh_quality["connected_components"] = int(nullspace.get("component_count", 0) or 0)
708
+ except Exception as exc:
709
+ issues.append(_issue("MECH002", "error", "model", None, f"Mechanism check failed: {exc}", suggestion="Inspect constraints, MPC topology and element connectivity."))
710
+
711
+ status = "invalid" if any(issue.severity == "error" for issue in issues) else ("warning" if issues else "ok")
712
+ revision_signature = getattr(model, "revision_signature", lambda: {})()
713
+ return ProductionValidationReport(
714
+ status,
715
+ tuple(issues),
716
+ mesh_quality,
717
+ revision_signature,
718
+ constraint_audit.to_dict(),
719
+ )