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,257 @@
1
+ """Private signed factor-spectrum numerical kernel; not qualification.
2
+
3
+ Derived from the preserved research reconstruction, with owned inputs,
4
+ bounded cancellation and actual signed mode-shape extraction. No mechanics,
5
+ public routing, state transaction or independent review is provided here.
6
+ """
7
+
8
+ from dataclasses import dataclass
9
+ from time import monotonic
10
+ from ._native_reference_modal import _owned
11
+ from .control import cancellation_safe_point
12
+
13
+ import numpy as np
14
+ from scipy import linalg
15
+ from ._relative_reference_svd import relative_reference_svd
16
+
17
+
18
+ def _reduce(factor, geometric, mass, free_dofs, algebraic_dofs, checkpoint):
19
+ checkpoint('reduction.start')
20
+ f, g, m = (np.array(x, dtype=float, copy=True) for x in (factor, geometric, mass))
21
+ if (f.ndim != 2 or not 1 <= f.shape[1] <= 256 or f.shape[0] > 8192
22
+ or g.shape != (f.shape[1],)*2 or m.shape != g.shape
23
+ or not all(np.isfinite(x).all() for x in (f, g, m))):
24
+ raise ValueError('bounded finite signed split required')
25
+ for a in (g, m):
26
+ if np.linalg.norm(a-a.T) > 1e-11*max(1., np.linalg.norm(a)):
27
+ raise ValueError('symmetric split required')
28
+ for slots in (free_dofs, algebraic_dofs):
29
+ if (type(slots) is not tuple or len(set(slots)) != len(slots)
30
+ or any(type(i) is not int or not 0 <= i < f.shape[1] for i in slots)):
31
+ raise ValueError('exact distinct in-range DOFs required')
32
+ if not set(algebraic_dofs) <= set(free_dofs):
33
+ raise ValueError('algebraic DOFs must be free')
34
+ if np.any(m[:, algebraic_dofs] != 0.) or np.any(m[algebraic_dofs, :] != 0.):
35
+ raise ValueError('algebraic inertia must be exactly zero')
36
+ physical = tuple(i for i in free_dofs if i not in algebraic_dofs)
37
+ if not physical: raise ValueError('physical coordinates required')
38
+ mapping = np.zeros((f.shape[1], len(physical)))
39
+ mapping[list(physical)] = np.eye(len(physical))
40
+ strain = f[:, physical]
41
+ if algebraic_dofs:
42
+ count = len(algebraic_dofs)
43
+ q, r = linalg.qr(f[:, algebraic_dofs], mode='full')
44
+ r = r[:count]
45
+ if r.shape != (count, count): raise ValueError('insufficient trace rows')
46
+ singular = linalg.svdvals(r)
47
+ if singular[-1] <= np.finfo(float).eps*count*singular[0]:
48
+ raise ValueError('unresolved material trace rank')
49
+ mapping[list(algebraic_dofs)] = -linalg.solve_triangular(r, q[:, :count].T@strain)
50
+ # Use orthogonal rows, not a subtraction of large normal equations.
51
+ strain = q[:, count:].T@strain
52
+ trace = r.T@r+g[np.ix_(algebraic_dofs, algebraic_dofs)]
53
+ cholesky = linalg.cho_factor(trace)
54
+ cross = g[list(algebraic_dofs)]@mapping
55
+ correction = linalg.cho_solve(cholesky, cross)
56
+ reduced_g = mapping.T@g@mapping-cross.T@correction
57
+ mapping[list(algebraic_dofs)] -= correction
58
+ else:
59
+ reduced_g = mapping.T@g@mapping
60
+ mass_r = linalg.cholesky(m[np.ix_(physical, physical)], lower=False)
61
+ normalized = linalg.solve_triangular(mass_r.T, strain.T, lower=True).T
62
+ left_g = linalg.solve_triangular(mass_r.T, reduced_g, lower=True)
63
+ normalized_g = linalg.solve_triangular(mass_r.T, left_g.T, lower=True).T
64
+ checkpoint('reduction.svd')
65
+ _, singular, right = relative_reference_svd(normalized)
66
+ with np.errstate(over='raise', invalid='raise', under='raise'):
67
+ diagonal = singular**2
68
+ signed = right@normalized_g@right.T
69
+ vectors = mapping@linalg.solve_triangular(mass_r, right.T)
70
+ return diagonal, signed, vectors
71
+
72
+
73
+ def _shifted_matrix(diagonal, correction, shift):
74
+ """Congruently scale the shifted pencil without modifying its inertia."""
75
+ d, g = np.asarray(diagonal), np.asarray(correction)
76
+ if (d.ndim != 1 or not 1 <= len(d) <= 256 or g.shape != (len(d), len(d))
77
+ or not np.isfinite(d).all() or not np.isfinite(g).all()
78
+ or not np.isfinite(shift) or np.any(d < 0.)):
79
+ raise ValueError('finite positive-factor diagonal and signed correction required')
80
+ if np.linalg.norm(g-g.T) > 1e-11*max(1., np.linalg.norm(g)):
81
+ raise ValueError('symmetric signed correction required')
82
+ # Form the shift before summing the stress correction. No global stiffness
83
+ # scale enters the sign threshold; congruence preserves inertia, not roots.
84
+ delta = d-shift
85
+ # Diagonal-based congruence matters: using the largest off-diagonal entry
86
+ # in each row can bury a small Schur root even after a valid congruence.
87
+ # Off-diagonal row scale is used only for an exactly absent diagonal.
88
+ size = np.maximum(np.abs(delta), np.abs(np.diag(g)))
89
+ size = np.where(size == 0., np.max(np.abs(g), axis=1), size)
90
+ scale = np.sqrt(size)
91
+ if np.any(scale == 0.): raise ValueError('unresolved shifted sign')
92
+ scaled = (g/scale[:, None])/scale[None, :]
93
+ scaled[np.diag_indices(len(d))] += (delta/scale)/scale
94
+ return scaled, scale
95
+
96
+
97
+ def _inertia(diagonal, correction, shift):
98
+ scaled, _ = _shifted_matrix(diagonal, correction, shift)
99
+ values = linalg.eigvalsh(scaled)
100
+ margin = 64*np.finfo(float).eps*len(diagonal)*max(1., np.max(np.abs(values)))
101
+ if np.min(np.abs(values)) <= margin: raise ValueError('unresolved shifted sign')
102
+ return int(np.count_nonzero(values < 0.))
103
+
104
+
105
+ def _bracket(diagonal, correction, bounds, count, width, checkpoint):
106
+ """Bounded same-author numerical search; caller freezes the search bounds."""
107
+ if (type(count) is not int or not 1 <= count <= len(diagonal)
108
+ or len(bounds) != 2 or not np.isfinite(bounds).all()
109
+ or not bounds[0] < bounds[1] or not np.isfinite(width) or width <= 0.):
110
+ raise ValueError('finite ordered search bounds and positive width required')
111
+ low_count = _inertia(diagonal, correction, bounds[0])
112
+ high_count = _inertia(diagonal, correction, bounds[1])
113
+ if low_count != 0 or high_count < count: raise ValueError('bounds do not enclose lowest requested roots')
114
+ result = []
115
+ for index in range(count):
116
+ lo, hi = bounds
117
+ for _ in range(96):
118
+ checkpoint('bracket.shift')
119
+ if hi-lo <= width: break
120
+ middle = lo+(hi-lo)/2
121
+ try:
122
+ negative = _inertia(diagonal, correction, middle)
123
+ except ValueError as exc:
124
+ if str(exc) != 'unresolved shifted sign': raise
125
+ left, right = max(lo, middle-width/4), min(hi, middle+width/4)
126
+ a = _inertia(diagonal, correction, left)
127
+ b = _inertia(diagonal, correction, right)
128
+ if a <= index < b:
129
+ lo, hi = left, right
130
+ break
131
+ raise ValueError('shifted signs unresolved at requested root width') from exc
132
+ if negative <= index: lo = middle
133
+ else: hi = middle
134
+ else: raise ValueError('signed search iteration limit')
135
+ if hi-lo > width: raise ValueError('signed search width not achieved')
136
+ result.append((lo, hi))
137
+ return np.array(result)
138
+
139
+ @dataclass(frozen=True)
140
+ class SignedFactorModes:
141
+ eigenvalues: np.ndarray
142
+ full_modes: np.ndarray
143
+ numerical_brackets: np.ndarray
144
+ spectral_residual: float
145
+ full_backward_residual: float
146
+ policy: str = 'PRIVATE_SIGNED_MATERIAL_GEOMETRIC_FACTOR_MODES_V1'
147
+ negative_eigenvalues_retained: bool = True
148
+ certified_intervals: bool = False
149
+ production_qualified: bool = False
150
+
151
+
152
+ def _orthonormalize(columns):
153
+ # Householder Q reconstruction can lose an O(1e-18) leading component
154
+ # through subtraction from one. Retain that component by direct scaling
155
+ # and twice-applied modified Gram-Schmidt on the small requested cluster.
156
+ result = []
157
+ for column in columns.T:
158
+ v = column.copy()
159
+ maximum = np.max(np.abs(v))
160
+ if not np.isfinite(maximum) or maximum == 0.: raise ValueError('empty signed mode column')
161
+ v /= maximum
162
+ for _ in range(2):
163
+ for previous in result: v -= previous*(previous@v)
164
+ size = np.linalg.norm(v)
165
+ if not np.isfinite(size) or size <= 64*np.finfo(float).eps:
166
+ raise ValueError('unresolved signed mode subspace rank')
167
+ result.append(v/size)
168
+ return np.column_stack(result)
169
+
170
+
171
+ def solve_signed_factor_modes(factor, geometric, mass, free_dofs, algebraic_dofs, *,
172
+ bounds, num_modes=6, root_width=1e-10, cancellation_token=None):
173
+ """Finite bounded kernel, no fallback. Caller binds the mechanical split.
174
+
175
+ Full-coordinate residual is a backward check ONLY: it is not sufficient
176
+ evidence of accuracy of low bending modes. The separate signed-basis
177
+ residual uses the ACTION of the material diagonal and prestress, never
178
+ the norm of the largest unrelated stiffness.
179
+ """
180
+ started = monotonic()
181
+ def checkpoint(stage):
182
+ cancellation_safe_point(cancellation_token, 'signed_factor_modes.'+stage)
183
+ if monotonic()-started > 600.: raise ValueError('signed factor modes time limit')
184
+ checkpoint('capture')
185
+ # Bytes-owned copies survive caller mutation and are not writable views.
186
+ f, g, m = (_owned(x) for x in (factor, geometric, mass))
187
+ if (type(bounds) is not tuple or len(bounds) != 2
188
+ or any(type(x) not in (int, float) or not np.isfinite(x) for x in bounds)
189
+ or bounds[0] >= bounds[1] or type(num_modes) is not int or num_modes < 1
190
+ or type(root_width) is not float or not np.isfinite(root_width) or root_width <= 0.):
191
+ raise ValueError('immutable finite explicit root bounds, count and width required')
192
+ d, correction, mapping = _reduce(f, g, m, free_dofs, algebraic_dofs, checkpoint)
193
+ intervals = _bracket(d, correction, bounds, num_modes, root_width, checkpoint)
194
+ coordinates = []; values = []
195
+ index = 0
196
+ while index < num_modes:
197
+ end = index+1
198
+ while end < num_modes and intervals[end, 0]-intervals[end-1, 1] <= 8*root_width:
199
+ end += 1
200
+ # Do not return an arbitrary portion of a repeated eigenvalue.
201
+ if _inertia(d, correction, intervals[index, 0]) != index or (
202
+ _inertia(d, correction, intervals[end-1, 1]) != end):
203
+ raise ValueError('requested modes truncate or fail to resolve a cluster')
204
+ checkpoint('cluster.eigenvectors')
205
+ # Stay off the root: a pure-material mode can have exactly zero
206
+ # diagonal and correction at its root, with no scaling available.
207
+ shift = float(intervals[index, 0]-2*root_width)
208
+ scaled, scale = _shifted_matrix(d, correction, shift)
209
+ roots, vectors = linalg.eigh(scaled)
210
+ raw_all = vectors/scale[:, None]
211
+ # Congruence does NOT preserve eigenvalue distance. For a diagonal
212
+ # pencil every scaled root can be +/-1. Include the transformed mass
213
+ # in the selection score, rather than selecting an unrelated mode.
214
+ scores = np.abs(roots)/np.sum(raw_all*raw_all, axis=0)
215
+ if not np.isfinite(scores).all(): raise ValueError('unrepresentable signed mode selection')
216
+ selected = np.argsort(scores, kind='stable')[:end-index]
217
+ raw = raw_all[:, selected]
218
+ basis = _orthonormalize(raw)
219
+ # A fixed shift strictly outside this cluster avoids attempting a
220
+ # singular solve at its Ritz root. Two bounded block inverse steps
221
+ # restore small strong-coordinate components through force balance.
222
+ inverse_scale = scale
223
+ lu = linalg.lu_factor(scaled)
224
+ for _ in range(2):
225
+ checkpoint('cluster.inverse_iteration')
226
+ basis = _orthonormalize(linalg.lu_solve(lu, basis/inverse_scale[:, None])/inverse_scale[:, None])
227
+ # Rayleigh-Ritz on a small cluster includes the SIGNED correction.
228
+ ritz = basis.T@(d[:, None]*basis)+basis.T@correction@basis
229
+ rv, ru = linalg.eigh(ritz)
230
+ actual = basis@ru
231
+ if np.any(rv < intervals[index:end, 0]-root_width) or np.any(rv > intervals[index:end, 1]+root_width):
232
+ raise ValueError('signed Ritz values leave numerical brackets')
233
+ coordinates.append(actual); values.extend(rv)
234
+ index = end
235
+ coordinates = np.column_stack(coordinates); values = np.array(values)
236
+ if np.linalg.norm(coordinates.T@coordinates-np.eye(num_modes)) > 1e-11:
237
+ raise ValueError('signed spectral orthogonality failed')
238
+ diagonal_action = d[:, None]*coordinates; stress_action = correction@coordinates
239
+ residue = diagonal_action+stress_action-coordinates*values
240
+ action_scale = np.maximum(1., np.maximum(np.linalg.norm(diagonal_action, axis=0),
241
+ np.maximum(np.linalg.norm(stress_action, axis=0), np.abs(values))))
242
+ spectral_error = float(np.max(np.linalg.norm(residue, axis=0)/action_scale))
243
+ if not np.isfinite(spectral_error) or spectral_error > 1e-11:
244
+ raise ValueError('signed action-scaled eigenpair residual failed')
245
+ modes = mapping@coordinates
246
+ if np.linalg.norm(modes.T@m@modes-np.eye(num_modes)) > 1e-11:
247
+ raise ValueError('signed physical mass normalization failed')
248
+ for j in range(num_modes):
249
+ if modes[int(np.argmax(np.abs(modes[:, j]))), j] < 0.: modes[:, j] *= -1.
250
+ residue = (f.T@(f@modes)+g@modes-(m@modes)*values)[list(free_dofs)]
251
+ scale = max(1., (np.linalg.norm(f)**2+np.linalg.norm(g))*np.linalg.norm(modes),
252
+ np.linalg.norm(m)*np.linalg.norm(modes*values))
253
+ backward = float(np.linalg.norm(residue)/scale)
254
+ if not np.isfinite(backward) or backward > 1e-11:
255
+ raise ValueError('signed full backward residual failed')
256
+ checkpoint('output')
257
+ return SignedFactorModes(_owned(values), _owned(modes), _owned(intervals), spectral_error, backward)
@@ -0,0 +1,279 @@
1
+ # Private V2 successor: preserve the full kinetic factor through whitening.
2
+ """Private signed factor-spectrum numerical kernel; not qualification.
3
+
4
+ Derived from the preserved research reconstruction, with owned inputs,
5
+ bounded cancellation and actual signed mode-shape extraction. No mechanics,
6
+ public routing, state transaction or independent review is provided here.
7
+ """
8
+
9
+ from dataclasses import dataclass
10
+ from time import monotonic
11
+ from ._native_reference_modal import _owned
12
+ from .control import cancellation_safe_point
13
+
14
+ import numpy as np
15
+ from scipy import linalg
16
+ from ._relative_reference_svd import relative_reference_svd
17
+
18
+
19
+ def _reduce(factor, geometric, mass, free_dofs, algebraic_dofs, checkpoint, kinetic):
20
+ from ._native_modal_capacity import limits
21
+ coordinates,rows,_=limits()
22
+ checkpoint('reduction.start')
23
+ f, g, m = (np.array(x, dtype=float, copy=True) for x in (factor, geometric, mass))
24
+ if (f.ndim != 2 or not 1 <= f.shape[1] <= coordinates or f.shape[0] > rows
25
+ or g.shape != (f.shape[1],)*2 or m.shape != g.shape
26
+ or not all(np.isfinite(x).all() for x in (f, g, m))):
27
+ raise ValueError('bounded finite signed split required')
28
+ for a in (g, m):
29
+ if np.linalg.norm(a-a.T) > 1e-11*max(1., np.linalg.norm(a)):
30
+ raise ValueError('symmetric split required')
31
+ for slots in (free_dofs, algebraic_dofs):
32
+ if (type(slots) is not tuple or len(set(slots)) != len(slots)
33
+ or any(type(i) is not int or not 0 <= i < f.shape[1] for i in slots)):
34
+ raise ValueError('exact distinct in-range DOFs required')
35
+ if not set(algebraic_dofs) <= set(free_dofs):
36
+ raise ValueError('algebraic DOFs must be free')
37
+ if np.any(kinetic[:, algebraic_dofs] != 0.):
38
+ raise ValueError('algebraic kinetic factor must be exactly zero')
39
+ if np.any(m[:, algebraic_dofs] != 0.) or np.any(m[algebraic_dofs, :] != 0.):
40
+ raise ValueError('algebraic inertia must be exactly zero')
41
+ physical = tuple(i for i in free_dofs if i not in algebraic_dofs)
42
+ if not physical: raise ValueError('physical coordinates required')
43
+ mapping = np.zeros((f.shape[1], len(physical)))
44
+ mapping[list(physical)] = np.eye(len(physical))
45
+ strain = f[:, physical]
46
+ if algebraic_dofs:
47
+ count = len(algebraic_dofs)
48
+ q, r = linalg.qr(f[:, algebraic_dofs], mode='full')
49
+ r = r[:count]
50
+ if r.shape != (count, count): raise ValueError('insufficient trace rows')
51
+ singular = linalg.svdvals(r)
52
+ if singular[-1] <= np.finfo(float).eps*count*singular[0]:
53
+ raise ValueError('unresolved material trace rank')
54
+ mapping[list(algebraic_dofs)] = -linalg.solve_triangular(r, q[:, :count].T@strain)
55
+ # Retain the original physical strain rows. Material trace columns
56
+ # vanish exactly in the strong axial/shear station rows. Rotating
57
+ # their entire row space by a completed Q unnecessarily mixes strong
58
+ # and weak rows. This evaluates the same trace-stationary map without
59
+ # forming or subtracting normal equations.
60
+ strain = f@mapping
61
+ trace = r.T@r+g[np.ix_(algebraic_dofs, algebraic_dofs)]
62
+ cholesky = linalg.cho_factor(trace)
63
+ cross = g[list(algebraic_dofs)]@mapping
64
+ correction = linalg.cho_solve(cholesky, cross)
65
+ reduced_g = mapping.T@g@mapping-cross.T@correction
66
+ mapping[list(algebraic_dofs)] -= correction
67
+ else:
68
+ reduced_g = mapping.T@g@mapping
69
+ # Avoid squaring kinetic conditioning in a dense mass Cholesky.
70
+ # Algebraic columns are exactly zero, so the signed trace correction
71
+ # does not change the retained kinetic factor.
72
+ _, mass_r = linalg.qr(kinetic[:, physical], mode='economic')
73
+ singular_mass = linalg.svdvals(mass_r)
74
+ if (mass_r.shape != (len(physical), len(physical))
75
+ or singular_mass[-1] <= np.finfo(float).eps*len(physical)*singular_mass[0]):
76
+ raise ValueError('unresolved physical kinetic rank')
77
+ normalized = linalg.solve_triangular(mass_r.T, strain.T, lower=True).T
78
+ left_g = linalg.solve_triangular(mass_r.T, reduced_g, lower=True)
79
+ normalized_g = linalg.solve_triangular(mass_r.T, left_g.T, lower=True).T
80
+ checkpoint('reduction.svd')
81
+ _, singular, right = relative_reference_svd(normalized)
82
+ with np.errstate(over='raise', invalid='raise', under='raise'):
83
+ diagonal = singular**2
84
+ signed = right@normalized_g@right.T
85
+ vectors = mapping@linalg.solve_triangular(mass_r, right.T)
86
+ return diagonal, signed, vectors
87
+
88
+
89
+ def _shifted_matrix(diagonal, correction, shift):
90
+ """Congruently scale the shifted pencil without modifying its inertia."""
91
+ d, g = np.asarray(diagonal), np.asarray(correction)
92
+ if (d.ndim != 1 or not 1 <= len(d) <= 256 or g.shape != (len(d), len(d))
93
+ or not np.isfinite(d).all() or not np.isfinite(g).all()
94
+ or not np.isfinite(shift) or np.any(d < 0.)):
95
+ raise ValueError('finite positive-factor diagonal and signed correction required')
96
+ if np.linalg.norm(g-g.T) > 1e-11*max(1., np.linalg.norm(g)):
97
+ raise ValueError('symmetric signed correction required')
98
+ # Form the shift before summing the stress correction. No global stiffness
99
+ # scale enters the sign threshold; congruence preserves inertia, not roots.
100
+ delta = d-shift
101
+ # Diagonal-based congruence matters: using the largest off-diagonal entry
102
+ # in each row can bury a small Schur root even after a valid congruence.
103
+ # Off-diagonal row scale is used only for an exactly absent diagonal.
104
+ size = np.maximum(np.abs(delta), np.abs(np.diag(g)))
105
+ size = np.where(size == 0., np.max(np.abs(g), axis=1), size)
106
+ scale = np.sqrt(size)
107
+ if np.any(scale == 0.): raise ValueError('unresolved shifted sign')
108
+ scaled = (g/scale[:, None])/scale[None, :]
109
+ scaled[np.diag_indices(len(d))] += (delta/scale)/scale
110
+ return scaled, scale
111
+
112
+
113
+ def _inertia(diagonal, correction, shift):
114
+ scaled, _ = _shifted_matrix(diagonal, correction, shift)
115
+ values = linalg.eigvalsh(scaled)
116
+ margin = 64*np.finfo(float).eps*len(diagonal)*max(1., np.max(np.abs(values)))
117
+ if np.min(np.abs(values)) <= margin: raise ValueError('unresolved shifted sign')
118
+ return int(np.count_nonzero(values < 0.))
119
+
120
+
121
+ def _bracket(diagonal, correction, bounds, count, width, checkpoint):
122
+ """Bounded same-author numerical search; caller freezes the search bounds."""
123
+ if (type(count) is not int or not 1 <= count <= len(diagonal)
124
+ or len(bounds) != 2 or not np.isfinite(bounds).all()
125
+ or not bounds[0] < bounds[1] or not np.isfinite(width) or width <= 0.):
126
+ raise ValueError('finite ordered search bounds and positive width required')
127
+ low_count = _inertia(diagonal, correction, bounds[0])
128
+ high_count = _inertia(diagonal, correction, bounds[1])
129
+ if low_count != 0 or high_count < count: raise ValueError('bounds do not enclose lowest requested roots')
130
+ result = []
131
+ for index in range(count):
132
+ lo, hi = bounds
133
+ for _ in range(96):
134
+ checkpoint('bracket.shift')
135
+ if hi-lo <= width: break
136
+ middle = lo+(hi-lo)/2
137
+ try:
138
+ negative = _inertia(diagonal, correction, middle)
139
+ except ValueError as exc:
140
+ if str(exc) != 'unresolved shifted sign': raise
141
+ left, right = max(lo, middle-width/4), min(hi, middle+width/4)
142
+ a = _inertia(diagonal, correction, left)
143
+ b = _inertia(diagonal, correction, right)
144
+ if a <= index < b:
145
+ lo, hi = left, right
146
+ break
147
+ raise ValueError('shifted signs unresolved at requested root width') from exc
148
+ if negative <= index: lo = middle
149
+ else: hi = middle
150
+ else: raise ValueError('signed search iteration limit')
151
+ if hi-lo > width: raise ValueError('signed search width not achieved')
152
+ result.append((lo, hi))
153
+ return np.array(result)
154
+
155
+ @dataclass(frozen=True)
156
+ class SignedFactorModes:
157
+ eigenvalues: np.ndarray
158
+ full_modes: np.ndarray
159
+ numerical_brackets: np.ndarray
160
+ spectral_residual: float
161
+ full_backward_residual: float
162
+ policy: str = 'PRIVATE_SIGNED_MATERIAL_KINETIC_FACTOR_MODES_V2'
163
+ negative_eigenvalues_retained: bool = True
164
+ certified_intervals: bool = False
165
+ production_qualified: bool = False
166
+
167
+
168
+ def _orthonormalize(columns):
169
+ # Householder Q reconstruction can lose an O(1e-18) leading component
170
+ # through subtraction from one. Retain that component by direct scaling
171
+ # and twice-applied modified Gram-Schmidt on the small requested cluster.
172
+ result = []
173
+ for column in columns.T:
174
+ v = column.copy()
175
+ maximum = np.max(np.abs(v))
176
+ if not np.isfinite(maximum) or maximum == 0.: raise ValueError('empty signed mode column')
177
+ v /= maximum
178
+ for _ in range(2):
179
+ for previous in result: v -= previous*(previous@v)
180
+ size = np.linalg.norm(v)
181
+ if not np.isfinite(size) or size <= 64*np.finfo(float).eps:
182
+ raise ValueError('unresolved signed mode subspace rank')
183
+ result.append(v/size)
184
+ return np.column_stack(result)
185
+
186
+
187
+ def solve_signed_kinetic_factor_modes(factor, geometric, kinetic_factor, free_dofs, algebraic_dofs, *,
188
+ bounds, num_modes=6, root_width=1e-10, cancellation_token=None):
189
+ """Finite bounded kernel, no fallback. Caller binds the mechanical split.
190
+
191
+ Full-coordinate residual is a backward check ONLY: it is not sufficient
192
+ evidence of accuracy of low bending modes. The separate signed-basis
193
+ residual uses the ACTION of the material diagonal and prestress, never
194
+ the norm of the largest unrelated stiffness.
195
+ """
196
+ started = monotonic()
197
+ def checkpoint(stage):
198
+ cancellation_safe_point(cancellation_token, 'signed_factor_modes.'+stage)
199
+ if monotonic()-started > 600.: raise ValueError('signed factor modes time limit')
200
+ checkpoint('capture')
201
+ # Bytes-owned copies survive caller mutation and are not writable views.
202
+ # Dense mass below is for checks only, never used for whitening.
203
+ f, g, kinetic = (_owned(x) for x in (factor, geometric, kinetic_factor))
204
+ if (kinetic.ndim != 2 or not 1 <= kinetic.shape[0] <= 8192
205
+ or not 1 <= kinetic.shape[1] <= 256 or f.ndim != 2
206
+ or kinetic.shape[1] != f.shape[1]):
207
+ raise ValueError('bounded matching material and kinetic factors required')
208
+ m = kinetic.T@kinetic
209
+ if (type(bounds) is not tuple or len(bounds) != 2
210
+ or any(type(x) not in (int, float) or not np.isfinite(x) for x in bounds)
211
+ or bounds[0] >= bounds[1] or type(num_modes) is not int or num_modes < 1
212
+ or type(root_width) is not float or not np.isfinite(root_width) or root_width <= 0.):
213
+ raise ValueError('immutable finite explicit root bounds, count and width required')
214
+ d, correction, mapping = _reduce(f, g, m, free_dofs, algebraic_dofs, checkpoint, kinetic)
215
+ intervals = _bracket(d, correction, bounds, num_modes, root_width, checkpoint)
216
+ coordinates = []; values = []
217
+ index = 0
218
+ while index < num_modes:
219
+ end = index+1
220
+ while end < num_modes and intervals[end, 0]-intervals[end-1, 1] <= 8*root_width:
221
+ end += 1
222
+ # Do not return an arbitrary portion of a repeated eigenvalue.
223
+ if _inertia(d, correction, intervals[index, 0]) != index or (
224
+ _inertia(d, correction, intervals[end-1, 1]) != end):
225
+ raise ValueError('requested modes truncate or fail to resolve a cluster')
226
+ checkpoint('cluster.eigenvectors')
227
+ # Stay off the root: a pure-material mode can have exactly zero
228
+ # diagonal and correction at its root, with no scaling available.
229
+ shift = float(intervals[index, 0]-2*root_width)
230
+ scaled, scale = _shifted_matrix(d, correction, shift)
231
+ roots, vectors = linalg.eigh(scaled)
232
+ raw_all = vectors/scale[:, None]
233
+ # Congruence does NOT preserve eigenvalue distance. For a diagonal
234
+ # pencil every scaled root can be +/-1. Include the transformed mass
235
+ # in the selection score, rather than selecting an unrelated mode.
236
+ scores = np.abs(roots)/np.sum(raw_all*raw_all, axis=0)
237
+ if not np.isfinite(scores).all(): raise ValueError('unrepresentable signed mode selection')
238
+ selected = np.argsort(scores, kind='stable')[:end-index]
239
+ raw = raw_all[:, selected]
240
+ basis = _orthonormalize(raw)
241
+ # A fixed shift strictly outside this cluster avoids attempting a
242
+ # singular solve at its Ritz root. Two bounded block inverse steps
243
+ # restore small strong-coordinate components through force balance.
244
+ inverse_scale = scale
245
+ lu = linalg.lu_factor(scaled)
246
+ for _ in range(2):
247
+ checkpoint('cluster.inverse_iteration')
248
+ basis = _orthonormalize(linalg.lu_solve(lu, basis/inverse_scale[:, None])/inverse_scale[:, None])
249
+ # Rayleigh-Ritz on a small cluster includes the SIGNED correction.
250
+ ritz = basis.T@(d[:, None]*basis)+basis.T@correction@basis
251
+ rv, ru = linalg.eigh(ritz)
252
+ actual = basis@ru
253
+ if np.any(rv < intervals[index:end, 0]-root_width) or np.any(rv > intervals[index:end, 1]+root_width):
254
+ raise ValueError('signed Ritz values leave numerical brackets')
255
+ coordinates.append(actual); values.extend(rv)
256
+ index = end
257
+ coordinates = np.column_stack(coordinates); values = np.array(values)
258
+ if np.linalg.norm(coordinates.T@coordinates-np.eye(num_modes)) > 1e-11:
259
+ raise ValueError('signed spectral orthogonality failed')
260
+ diagonal_action = d[:, None]*coordinates; stress_action = correction@coordinates
261
+ residue = diagonal_action+stress_action-coordinates*values
262
+ action_scale = np.maximum(1., np.maximum(np.linalg.norm(diagonal_action, axis=0),
263
+ np.maximum(np.linalg.norm(stress_action, axis=0), np.abs(values))))
264
+ spectral_error = float(np.max(np.linalg.norm(residue, axis=0)/action_scale))
265
+ if not np.isfinite(spectral_error) or spectral_error > 1e-11:
266
+ raise ValueError('signed action-scaled eigenpair residual failed')
267
+ modes = mapping@coordinates
268
+ if np.linalg.norm(modes.T@m@modes-np.eye(num_modes)) > 1e-11:
269
+ raise ValueError('signed physical mass normalization failed')
270
+ for j in range(num_modes):
271
+ if modes[int(np.argmax(np.abs(modes[:, j]))), j] < 0.: modes[:, j] *= -1.
272
+ residue = (f.T@(f@modes)+g@modes-(m@modes)*values)[list(free_dofs)]
273
+ scale = max(1., (np.linalg.norm(f)**2+np.linalg.norm(g))*np.linalg.norm(modes),
274
+ np.linalg.norm(m)*np.linalg.norm(modes*values))
275
+ backward = float(np.linalg.norm(residue)/scale)
276
+ if not np.isfinite(backward) or backward > 1e-11:
277
+ raise ValueError('signed full backward residual failed')
278
+ checkpoint('output')
279
+ return SignedFactorModes(_owned(values), _owned(modes), _owned(intervals), spectral_error, backward)
@@ -0,0 +1,79 @@
1
+ """Private signed stationary pencil with explicitly declared massless DOFs.
2
+
3
+ Unlike reference energy-factor assembly, this algebra must retain negative
4
+ stiffness eigenvalues. It does not certify a material branch or equilibrium;
5
+ the caller must establish those before treating its output as vibration data.
6
+ """
7
+
8
+ from dataclasses import dataclass
9
+
10
+ import numpy as np
11
+ from scipy import linalg
12
+
13
+ from ._native_reference_modal import _owned
14
+ from .control import cancellation_safe_point
15
+
16
+
17
+ @dataclass(frozen=True)
18
+ class StationarySpectrum:
19
+ eigenvalues: np.ndarray
20
+ full_modes: np.ndarray
21
+ dynamic_map: np.ndarray
22
+ normalized_residual: float
23
+ production_qualified: bool = False
24
+
25
+
26
+ def solve_stationary_spectrum(stiffness, mass, free_dofs, algebraic_dofs, *,
27
+ num_modes=6, cancellation_token=None):
28
+ """Eliminate only positive, exactly massless assembled trace equations.
29
+
30
+ The trace block must be positive: a hidden negative algebraic-energy mode
31
+ must fail rather than disappear behind a positive finite spectrum.
32
+ All finite physical modes, including negative and zero values, are kept
33
+ eligible for selection. No stiffness factorization requiring global PSD,
34
+ eigenvalue clipping, mass regularization or inferred mass kernel is used.
35
+ Supports have already selected ``free_dofs``. Dense development scope only.
36
+ """
37
+ cancellation_safe_point(cancellation_token, 'stationary_spectrum.start')
38
+ k, m = _owned(stiffness), _owned(mass)
39
+ if (k.ndim != 2 or k.shape[0] != k.shape[1] or m.shape != k.shape
40
+ or not 1 <= len(k) <= 256):
41
+ raise ValueError('matching bounded stationary matrices required')
42
+ for matrix in (k, m):
43
+ if np.linalg.norm(matrix-matrix.T) > 1e-11*max(1., np.linalg.norm(matrix)):
44
+ raise ValueError('symmetric stationary pencil required')
45
+ for slots in (free_dofs, algebraic_dofs):
46
+ if (type(slots) is not tuple or len(set(slots)) != len(slots)
47
+ or any(type(i) is not int or not 0 <= i < len(k) for i in slots)):
48
+ raise ValueError('exact distinct in-range DOFs required')
49
+ if not set(algebraic_dofs) <= set(free_dofs):
50
+ raise ValueError('algebraic DOFs must be free')
51
+ if np.any(m[:, algebraic_dofs] != 0.) or np.any(m[algebraic_dofs, :] != 0.):
52
+ raise ValueError('declared algebraic mass must be exactly zero')
53
+ physical = tuple(i for i in free_dofs if i not in algebraic_dofs)
54
+ if type(num_modes) is not int or not 1 <= num_modes <= len(physical):
55
+ raise ValueError('requested modes outside physical dimension')
56
+ mapping = np.zeros((len(k), len(physical)))
57
+ mapping[list(physical)] = np.eye(len(physical))
58
+ if algebraic_dofs:
59
+ a = k[np.ix_(algebraic_dofs, algebraic_dofs)]
60
+ coupling = k[np.ix_(algebraic_dofs, physical)]
61
+ np.linalg.cholesky(a)
62
+ mapping[list(algebraic_dofs)] = -np.linalg.solve(a, coupling)
63
+ reduced_k, reduced_m = mapping.T@k@mapping, mapping.T@m@mapping
64
+ np.linalg.cholesky(reduced_m)
65
+ cancellation_safe_point(cancellation_token, 'stationary_spectrum.reduced')
66
+ values, vectors = linalg.eigh(reduced_k, reduced_m, subset_by_index=(0, num_modes-1))
67
+ modes = mapping@vectors
68
+ for index in range(num_modes):
69
+ pivot = int(np.argmax(np.abs(modes[:, index])))
70
+ if modes[pivot, index] < 0.: modes[:, index] *= -1.
71
+ residual = (k@modes-(m@modes)*values)[list(free_dofs)]
72
+ scale = max(1., np.linalg.norm(k)*np.linalg.norm(modes), np.linalg.norm(m)*np.linalg.norm(modes*values))
73
+ error = float(np.linalg.norm(residual)/scale)
74
+ if not np.isfinite(error) or error > 1e-11:
75
+ raise ValueError('stationary full-pencil eigenpair residual failed')
76
+ if np.linalg.norm(modes.T@m@modes-np.eye(num_modes)) > 1e-11:
77
+ raise ValueError('stationary modal mass normalization failed')
78
+ cancellation_safe_point(cancellation_token, 'stationary_spectrum.output')
79
+ return StationarySpectrum(_owned(values), _owned(modes), _owned(mapping), error)