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,797 @@
1
+ """Solver-owned multiplicative rotations for formulation-native elements.
2
+
3
+ The ordinary ANYfeSolver displacement vector retains additive rotational
4
+ coordinates for compatibility with existing elements. A formulation-native
5
+ large-rotation element needs a different history variable: one proper rotation
6
+ operator shared by every native element incident on a node. This module owns
7
+ that history without changing the public displacement or element APIs.
8
+
9
+ There is deliberately no empty-store object. The factory returns ``None``
10
+ when a model has no native nodes, so established Q4 and legacy models pay no
11
+ allocation or transaction cost. A non-empty store permits exactly one trial
12
+ at a time. Every candidate is reconstructed from the committed base as
13
+
14
+ ``Q_trial = Exp(theta_trial - theta_committed) @ Q_committed``.
15
+
16
+ Rejected candidates never modify committed state. Commit additionally binds
17
+ the candidate to the exact full displacement and coordinate arrays accepted by
18
+ the solver; committing element-local or stale kinematics is therefore not
19
+ possible.
20
+ """
21
+
22
+ from __future__ import annotations
23
+
24
+ import threading
25
+ from collections.abc import Hashable, Mapping, Sequence
26
+ from dataclasses import dataclass, field
27
+ from typing import Any, Optional
28
+
29
+ import numpy as np
30
+
31
+
32
+ _SO3_TOLERANCE = 1.0e-10
33
+
34
+
35
+ class NativeRotationStateError(RuntimeError):
36
+ """Base class for solver-owned native-rotation failures."""
37
+
38
+
39
+ class NativeRotationValidationError(NativeRotationStateError, ValueError):
40
+ """Raised when coordinates, DOFs, or rotations violate the contract."""
41
+
42
+
43
+ class NativeRotationTransactionError(NativeRotationStateError):
44
+ """Raised when native-rotation transaction ordering is invalid."""
45
+
46
+
47
+ class StaleNativeRotationTokenError(NativeRotationTransactionError):
48
+ """Raised when a trial capability is stale or belongs to another store."""
49
+
50
+
51
+ class AcceptedConfigurationMismatchError(NativeRotationTransactionError):
52
+ """Raised when commit does not name the exact evaluated configuration."""
53
+
54
+
55
+ def _immutable_float_array(values: Any, *, name: str) -> np.ndarray:
56
+ """Return a finite float64 array backed by immutable bytes."""
57
+
58
+ array = np.asarray(values, dtype=np.float64)
59
+ if not np.all(np.isfinite(array)):
60
+ raise NativeRotationValidationError(f"{name} must contain only finite values")
61
+ contiguous = np.ascontiguousarray(array)
62
+ # A view backed by ``bytes`` cannot be made writable again with setflags().
63
+ payload = contiguous.tobytes(order="C")
64
+ return np.frombuffer(payload, dtype=np.float64).reshape(contiguous.shape)
65
+
66
+
67
+ def _coerce_full_displacement(values: Any, *, name: str) -> np.ndarray:
68
+ result = _immutable_float_array(values, name=name)
69
+ if result.ndim != 1:
70
+ raise NativeRotationValidationError(f"{name} must be one-dimensional")
71
+ return result
72
+
73
+
74
+ def _coerce_full_coordinates(values: Any, *, name: str) -> np.ndarray:
75
+ result = _immutable_float_array(values, name=name)
76
+ if result.ndim != 2 or result.shape[1] != 3:
77
+ raise NativeRotationValidationError(f"{name} must have shape (n, 3)")
78
+ return result
79
+
80
+
81
+ def _skew(vector: np.ndarray) -> np.ndarray:
82
+ x, y, z = (float(value) for value in vector)
83
+ return np.asarray(
84
+ ((0.0, -z, y), (z, 0.0, -x), (-y, x, 0.0)),
85
+ dtype=np.float64,
86
+ )
87
+
88
+
89
+ def rotation_exponential(rotation_vector: Any) -> np.ndarray:
90
+ """Return the proper rotation ``Exp(skew(rotation_vector))``.
91
+
92
+ The small-angle coefficients avoid normalizing by a vanishing angle and
93
+ retain the quadratic term required by nonlinear trial construction.
94
+ """
95
+
96
+ vector = np.asarray(rotation_vector, dtype=np.float64)
97
+ if vector.shape != (3,) or not np.all(np.isfinite(vector)):
98
+ raise NativeRotationValidationError(
99
+ "rotation_vector must be a finite three-component vector"
100
+ )
101
+ angle_squared = float(vector @ vector)
102
+ cross = _skew(vector)
103
+ if angle_squared < 1.0e-16:
104
+ angle_fourth = angle_squared * angle_squared
105
+ sine_coefficient = 1.0 - angle_squared / 6.0 + angle_fourth / 120.0
106
+ cosine_coefficient = 0.5 - angle_squared / 24.0 + angle_fourth / 720.0
107
+ else:
108
+ angle = float(np.sqrt(angle_squared))
109
+ sine_coefficient = float(np.sin(angle) / angle)
110
+ cosine_coefficient = float((1.0 - np.cos(angle)) / angle_squared)
111
+ return (
112
+ np.eye(3, dtype=np.float64)
113
+ + sine_coefficient * cross
114
+ + cosine_coefficient * (cross @ cross)
115
+ )
116
+
117
+
118
+ def validate_proper_rotation_matrices(
119
+ matrices: Any,
120
+ *,
121
+ name: str = "rotation_matrices",
122
+ tolerance: float = _SO3_TOLERANCE,
123
+ ) -> np.ndarray:
124
+ """Validate finite matrices in SO(3) and return an immutable copy.
125
+
126
+ A single ``(3, 3)`` matrix and a stack ``(n, 3, 3)`` are accepted. The
127
+ values are not projected or silently repaired: an improper or materially
128
+ non-orthogonal input is rejected.
129
+ """
130
+
131
+ if not np.isfinite(tolerance) or tolerance <= 0.0:
132
+ raise ValueError("tolerance must be finite and positive")
133
+ result = _immutable_float_array(matrices, name=name)
134
+ single = result.ndim == 2
135
+ stack = result.reshape(1, 3, 3) if single and result.shape == (3, 3) else result
136
+ if stack.ndim != 3 or stack.shape[1:] != (3, 3):
137
+ raise NativeRotationValidationError(
138
+ f"{name} must have shape (3, 3) or (n, 3, 3)"
139
+ )
140
+ identity = np.eye(3, dtype=np.float64)
141
+ for index, matrix in enumerate(stack):
142
+ orthogonality_error = float(np.max(np.abs(matrix.T @ matrix - identity)))
143
+ determinant = float(np.linalg.det(matrix))
144
+ if (
145
+ determinant <= 0.0
146
+ or orthogonality_error > tolerance
147
+ or abs(determinant - 1.0) > tolerance
148
+ ):
149
+ raise NativeRotationValidationError(
150
+ f"{name}[{index}] is not a proper SO(3) matrix "
151
+ f"(orthogonality_error={orthogonality_error:.3e}, "
152
+ f"determinant={determinant:.17g})"
153
+ )
154
+ return result
155
+
156
+
157
+ @dataclass(frozen=True, slots=True)
158
+ class NativeRotationTrialToken:
159
+ """Opaque generation-checked capability for one native-rotation trial."""
160
+
161
+ generation: int
162
+ serial: int
163
+ _owner: object = field(repr=False, compare=False, hash=False)
164
+
165
+
166
+ @dataclass(frozen=True, slots=True)
167
+ class NativeElementRotationView:
168
+ """Immutable native-node data in one element's connectivity order.
169
+
170
+ Rotation matrices are node-shared. Reference directors are supplied by
171
+ the element and copied into this view, so two elements meeting at a crease
172
+ retain distinct reference directors while observing the same nodal
173
+ rotation operator.
174
+ """
175
+
176
+ element_id: Hashable
177
+ node_ids: tuple[int, ...]
178
+ committed_coordinates: np.ndarray
179
+ trial_coordinates: np.ndarray
180
+ coordinate_increment: np.ndarray
181
+ committed_rotation_coordinates: np.ndarray
182
+ trial_rotation_coordinates: np.ndarray
183
+ rotation_coordinate_increment: np.ndarray
184
+ committed_rotation_matrices: np.ndarray
185
+ trial_rotation_matrices: np.ndarray
186
+ reference_directors: np.ndarray
187
+ committed_directors: np.ndarray
188
+ trial_directors: np.ndarray
189
+ generation: int
190
+ trial_serial: Optional[int]
191
+
192
+ @property
193
+ def coordinates(self) -> np.ndarray:
194
+ """Compatibility alias for the selected (committed or trial) coordinates."""
195
+
196
+ return self.trial_coordinates
197
+
198
+ @property
199
+ def rotation_matrices(self) -> np.ndarray:
200
+ """Compatibility alias for the selected (committed or trial) operators."""
201
+
202
+ return self.trial_rotation_matrices
203
+
204
+
205
+ @dataclass(frozen=True, slots=True)
206
+ class _ActiveNativeRotationTrial:
207
+ token: NativeRotationTrialToken
208
+ full_displacement: np.ndarray
209
+ full_coordinates: np.ndarray
210
+ native_coordinates: np.ndarray
211
+ rotation_matrices: np.ndarray
212
+
213
+
214
+ class NativeRotationCandidate:
215
+ """Exception-safe facade over one active store transaction."""
216
+
217
+ __slots__ = ("_store", "_token", "_closed")
218
+
219
+ def __init__(
220
+ self,
221
+ store: "NativeRotationStateStore",
222
+ token: NativeRotationTrialToken,
223
+ ) -> None:
224
+ self._store = store
225
+ self._token = token
226
+ self._closed = False
227
+
228
+ @property
229
+ def token(self) -> NativeRotationTrialToken:
230
+ return self._token
231
+
232
+ @property
233
+ def closed(self) -> bool:
234
+ return bool(self._closed)
235
+
236
+ def element_view(
237
+ self,
238
+ element_id: Hashable,
239
+ node_ids: Sequence[int],
240
+ reference_directors: Any,
241
+ ) -> NativeElementRotationView:
242
+ return self._store.element_view(
243
+ element_id,
244
+ node_ids,
245
+ reference_directors,
246
+ trial_token=self._token,
247
+ )
248
+
249
+ def commit(
250
+ self,
251
+ accepted_full_displacement: Any,
252
+ accepted_full_coordinates: Any,
253
+ ) -> int:
254
+ generation = self._store.commit_trial(
255
+ self._token,
256
+ accepted_full_displacement,
257
+ accepted_full_coordinates,
258
+ )
259
+ self._closed = True
260
+ return generation
261
+
262
+ def discard(self) -> None:
263
+ self._store.discard_trial(self._token)
264
+ self._closed = True
265
+
266
+ def __enter__(self) -> "NativeRotationCandidate":
267
+ return self
268
+
269
+ def __exit__(self, exc_type: Any, exc: Any, traceback: Any) -> bool:
270
+ del exc_type, exc, traceback
271
+ if not self._closed:
272
+ self._store._discard_if_active(self._token)
273
+ self._closed = True
274
+ return False
275
+
276
+
277
+ class NativeRotationStateStore:
278
+ """Committed and trial SO(3) state for a non-empty set of native nodes."""
279
+
280
+ def __init__(
281
+ self,
282
+ native_node_ids: Sequence[int],
283
+ *,
284
+ rotational_dofs: Mapping[int, Sequence[int]],
285
+ coordinate_rows: Mapping[int, int],
286
+ committed_full_displacement: Any,
287
+ committed_full_coordinates: Any,
288
+ committed_rotation_matrices: Mapping[int, Any] | Any | None = None,
289
+ coordinate_node_ids: Sequence[int] | None = None,
290
+ ) -> None:
291
+ normalized_ids = tuple(sorted(int(value) for value in native_node_ids))
292
+ if not normalized_ids:
293
+ raise NativeRotationValidationError(
294
+ "NativeRotationStateStore requires at least one native node; "
295
+ "use create_native_rotation_state_store for optional creation"
296
+ )
297
+ if len(set(normalized_ids)) != len(normalized_ids):
298
+ raise NativeRotationValidationError("native_node_ids must be unique")
299
+ self._node_ids = normalized_ids
300
+ self._node_index = {
301
+ node_id: index for index, node_id in enumerate(self._node_ids)
302
+ }
303
+ self._committed_full_displacement = _coerce_full_displacement(
304
+ committed_full_displacement,
305
+ name="committed_full_displacement",
306
+ )
307
+ self._committed_full_coordinates = _coerce_full_coordinates(
308
+ committed_full_coordinates,
309
+ name="committed_full_coordinates",
310
+ )
311
+ if coordinate_node_ids is None:
312
+ normalized_coordinate_node_ids = tuple(
313
+ range(self._committed_full_coordinates.shape[0])
314
+ )
315
+ else:
316
+ normalized_coordinate_node_ids = tuple(
317
+ int(value) for value in coordinate_node_ids
318
+ )
319
+ if (
320
+ len(normalized_coordinate_node_ids)
321
+ != self._committed_full_coordinates.shape[0]
322
+ or len(set(normalized_coordinate_node_ids))
323
+ != len(normalized_coordinate_node_ids)
324
+ ):
325
+ raise NativeRotationValidationError(
326
+ "coordinate_node_ids must uniquely identify every full-coordinate row"
327
+ )
328
+ self._coordinate_node_ids = normalized_coordinate_node_ids
329
+
330
+ dof_rows: list[tuple[int, int, int]] = []
331
+ coordinate_indices: list[int] = []
332
+ for node_id in self._node_ids:
333
+ try:
334
+ node_dofs = tuple(int(value) for value in rotational_dofs[node_id])
335
+ except KeyError as exc:
336
+ raise NativeRotationValidationError(
337
+ f"rotational_dofs is missing native node {node_id}"
338
+ ) from exc
339
+ if len(node_dofs) != 3 or len(set(node_dofs)) != 3:
340
+ raise NativeRotationValidationError(
341
+ f"native node {node_id} must have three distinct rotational DOFs"
342
+ )
343
+ if min(node_dofs) < 0 or max(node_dofs) >= self._committed_full_displacement.size:
344
+ raise NativeRotationValidationError(
345
+ f"rotational DOFs for native node {node_id} are out of bounds"
346
+ )
347
+ dof_rows.append(node_dofs)
348
+ try:
349
+ coordinate_row = int(coordinate_rows[node_id])
350
+ except KeyError as exc:
351
+ raise NativeRotationValidationError(
352
+ f"coordinate_rows is missing native node {node_id}"
353
+ ) from exc
354
+ if not 0 <= coordinate_row < self._committed_full_coordinates.shape[0]:
355
+ raise NativeRotationValidationError(
356
+ f"coordinate row for native node {node_id} is out of bounds"
357
+ )
358
+ coordinate_indices.append(coordinate_row)
359
+ if len({value for row in dof_rows for value in row}) != 3 * len(dof_rows):
360
+ raise NativeRotationValidationError(
361
+ "native nodes must not share rotational displacement DOFs"
362
+ )
363
+ if len(set(coordinate_indices)) != len(coordinate_indices):
364
+ raise NativeRotationValidationError(
365
+ "native nodes must not share full-coordinate rows"
366
+ )
367
+ self._rotational_dofs = np.asarray(dof_rows, dtype=np.intp)
368
+ self._coordinate_rows = np.asarray(coordinate_indices, dtype=np.intp)
369
+
370
+ if committed_rotation_matrices is None:
371
+ initial = np.repeat(
372
+ np.eye(3, dtype=np.float64)[None, :, :],
373
+ len(self._node_ids),
374
+ axis=0,
375
+ )
376
+ elif isinstance(committed_rotation_matrices, Mapping):
377
+ try:
378
+ initial = np.asarray(
379
+ [committed_rotation_matrices[node_id] for node_id in self._node_ids],
380
+ dtype=np.float64,
381
+ )
382
+ except KeyError as exc:
383
+ raise NativeRotationValidationError(
384
+ f"committed_rotation_matrices is missing native node {int(exc.args[0])}"
385
+ ) from exc
386
+ else:
387
+ initial = np.asarray(committed_rotation_matrices, dtype=np.float64)
388
+ if initial.shape != (len(self._node_ids), 3, 3):
389
+ raise NativeRotationValidationError(
390
+ "committed_rotation_matrices must have shape (native_node_count, 3, 3)"
391
+ )
392
+ self._committed_rotation_matrices = validate_proper_rotation_matrices(
393
+ initial,
394
+ name="committed_rotation_matrices",
395
+ )
396
+ self._committed_native_coordinates = _immutable_float_array(
397
+ self._committed_full_coordinates[self._coordinate_rows],
398
+ name="committed_native_coordinates",
399
+ )
400
+
401
+ self._owner = object()
402
+ self._generation = 0
403
+ self._serial = 0
404
+ self._active: _ActiveNativeRotationTrial | None = None
405
+ self._lock = threading.RLock()
406
+
407
+ @property
408
+ def node_ids(self) -> tuple[int, ...]:
409
+ return self._node_ids
410
+
411
+ @property
412
+ def generation(self) -> int:
413
+ with self._lock:
414
+ return int(self._generation)
415
+
416
+ @property
417
+ def committed_coordinates(self) -> np.ndarray:
418
+ with self._lock:
419
+ return self._committed_native_coordinates
420
+
421
+ @property
422
+ def committed_rotation_matrices(self) -> np.ndarray:
423
+ with self._lock:
424
+ return self._committed_rotation_matrices
425
+
426
+ @property
427
+ def committed_full_displacement(self) -> np.ndarray:
428
+ with self._lock:
429
+ return self._committed_full_displacement
430
+
431
+ @property
432
+ def committed_full_coordinates(self) -> np.ndarray:
433
+ with self._lock:
434
+ return self._committed_full_coordinates
435
+
436
+ @property
437
+ def coordinate_node_ids(self) -> tuple[int, ...]:
438
+ return self._coordinate_node_ids
439
+
440
+ @property
441
+ def has_active_trial(self) -> bool:
442
+ with self._lock:
443
+ return self._active is not None
444
+
445
+ def _require_active(
446
+ self,
447
+ token: NativeRotationTrialToken,
448
+ ) -> _ActiveNativeRotationTrial:
449
+ active = self._active
450
+ valid = bool(
451
+ isinstance(token, NativeRotationTrialToken)
452
+ and token._owner is self._owner
453
+ and token.generation == self._generation
454
+ and active is not None
455
+ and active.token is token
456
+ )
457
+ if not valid:
458
+ raise StaleNativeRotationTokenError(
459
+ "Native-rotation token is stale, belongs to another store, "
460
+ "or is not active"
461
+ )
462
+ return active
463
+
464
+ def begin_trial(
465
+ self,
466
+ trial_full_displacement: Any,
467
+ trial_full_coordinates: Any,
468
+ ) -> NativeRotationTrialToken:
469
+ """Create the sole trial, always relative to the committed base."""
470
+
471
+ with self._lock:
472
+ if self._active is not None:
473
+ raise NativeRotationTransactionError(
474
+ "A native-rotation trial is already active"
475
+ )
476
+ displacement = _coerce_full_displacement(
477
+ trial_full_displacement,
478
+ name="trial_full_displacement",
479
+ )
480
+ coordinates = _coerce_full_coordinates(
481
+ trial_full_coordinates,
482
+ name="trial_full_coordinates",
483
+ )
484
+ if displacement.shape != self._committed_full_displacement.shape:
485
+ raise NativeRotationValidationError(
486
+ "trial_full_displacement shape differs from the committed full vector"
487
+ )
488
+ if coordinates.shape != self._committed_full_coordinates.shape:
489
+ raise NativeRotationValidationError(
490
+ "trial_full_coordinates shape differs from the committed coordinate array"
491
+ )
492
+ committed_theta = self._committed_full_displacement[
493
+ self._rotational_dofs
494
+ ]
495
+ trial_theta = displacement[self._rotational_dofs]
496
+ rotations = np.empty_like(self._committed_rotation_matrices)
497
+ for index, delta in enumerate(trial_theta - committed_theta):
498
+ rotations[index] = (
499
+ rotation_exponential(delta)
500
+ @ self._committed_rotation_matrices[index]
501
+ )
502
+ rotations = validate_proper_rotation_matrices(
503
+ rotations,
504
+ name="trial_rotation_matrices",
505
+ )
506
+ native_coordinates = _immutable_float_array(
507
+ coordinates[self._coordinate_rows],
508
+ name="trial_native_coordinates",
509
+ )
510
+ self._serial += 1
511
+ token = NativeRotationTrialToken(
512
+ self._generation,
513
+ self._serial,
514
+ self._owner,
515
+ )
516
+ self._active = _ActiveNativeRotationTrial(
517
+ token=token,
518
+ full_displacement=displacement,
519
+ full_coordinates=coordinates,
520
+ native_coordinates=native_coordinates,
521
+ rotation_matrices=rotations,
522
+ )
523
+ return token
524
+
525
+ def candidate(
526
+ self,
527
+ trial_full_displacement: Any,
528
+ trial_full_coordinates: Any,
529
+ ) -> NativeRotationCandidate:
530
+ """Return an exception-safe context facade for a new trial."""
531
+
532
+ return NativeRotationCandidate(
533
+ self,
534
+ self.begin_trial(trial_full_displacement, trial_full_coordinates),
535
+ )
536
+
537
+ def validate_trial_token(self, token: NativeRotationTrialToken) -> None:
538
+ with self._lock:
539
+ self._require_active(token)
540
+
541
+ def element_view(
542
+ self,
543
+ element_id: Hashable,
544
+ node_ids: Sequence[int],
545
+ reference_directors: Any,
546
+ *,
547
+ trial_token: NativeRotationTrialToken | None = None,
548
+ ) -> NativeElementRotationView:
549
+ """Return committed or candidate state in one element's node order."""
550
+
551
+ with self._lock:
552
+ ordered_node_ids = tuple(int(value) for value in node_ids)
553
+ if not ordered_node_ids or len(set(ordered_node_ids)) != len(ordered_node_ids):
554
+ raise NativeRotationValidationError(
555
+ "element native node_ids must be non-empty and unique"
556
+ )
557
+ try:
558
+ indices = np.asarray(
559
+ [self._node_index[node_id] for node_id in ordered_node_ids],
560
+ dtype=np.intp,
561
+ )
562
+ except KeyError as exc:
563
+ raise NativeRotationValidationError(
564
+ f"element references non-native node {int(exc.args[0])}"
565
+ ) from exc
566
+ directors = _immutable_float_array(
567
+ reference_directors,
568
+ name="reference_directors",
569
+ )
570
+ if directors.shape != (len(ordered_node_ids), 3):
571
+ raise NativeRotationValidationError(
572
+ "reference_directors must have shape (element_native_node_count, 3)"
573
+ )
574
+ if trial_token is None:
575
+ trial_coordinates = self._committed_native_coordinates
576
+ trial_rotations = self._committed_rotation_matrices
577
+ trial_full_displacement = self._committed_full_displacement
578
+ serial: Optional[int] = None
579
+ else:
580
+ active = self._require_active(trial_token)
581
+ trial_coordinates = active.native_coordinates
582
+ trial_rotations = active.rotation_matrices
583
+ trial_full_displacement = active.full_displacement
584
+ serial = int(trial_token.serial)
585
+ committed_coordinates = self._committed_native_coordinates[indices]
586
+ selected_coordinates = trial_coordinates[indices]
587
+ committed_rotation_coordinates = self._committed_full_displacement[
588
+ self._rotational_dofs[indices]
589
+ ]
590
+ trial_rotation_coordinates = trial_full_displacement[
591
+ self._rotational_dofs[indices]
592
+ ]
593
+ committed_rotations = self._committed_rotation_matrices[indices]
594
+ selected_rotations = trial_rotations[indices]
595
+ committed_directors = np.einsum(
596
+ "nij,nj->ni", committed_rotations, directors
597
+ )
598
+ trial_directors = np.einsum(
599
+ "nij,nj->ni", selected_rotations, directors
600
+ )
601
+ return NativeElementRotationView(
602
+ element_id=element_id,
603
+ node_ids=ordered_node_ids,
604
+ committed_coordinates=_immutable_float_array(
605
+ committed_coordinates,
606
+ name="element_committed_coordinates",
607
+ ),
608
+ trial_coordinates=_immutable_float_array(
609
+ selected_coordinates,
610
+ name="element_trial_coordinates",
611
+ ),
612
+ coordinate_increment=_immutable_float_array(
613
+ selected_coordinates - committed_coordinates,
614
+ name="element_coordinate_increment",
615
+ ),
616
+ committed_rotation_coordinates=_immutable_float_array(
617
+ committed_rotation_coordinates,
618
+ name="element_committed_rotation_coordinates",
619
+ ),
620
+ trial_rotation_coordinates=_immutable_float_array(
621
+ trial_rotation_coordinates,
622
+ name="element_trial_rotation_coordinates",
623
+ ),
624
+ rotation_coordinate_increment=_immutable_float_array(
625
+ trial_rotation_coordinates - committed_rotation_coordinates,
626
+ name="element_rotation_coordinate_increment",
627
+ ),
628
+ committed_rotation_matrices=validate_proper_rotation_matrices(
629
+ committed_rotations,
630
+ name="element_committed_rotation_matrices",
631
+ ),
632
+ trial_rotation_matrices=validate_proper_rotation_matrices(
633
+ selected_rotations,
634
+ name="element_trial_rotation_matrices",
635
+ ),
636
+ reference_directors=directors,
637
+ committed_directors=_immutable_float_array(
638
+ committed_directors,
639
+ name="element_committed_directors",
640
+ ),
641
+ trial_directors=_immutable_float_array(
642
+ trial_directors,
643
+ name="element_trial_directors",
644
+ ),
645
+ generation=int(self._generation),
646
+ trial_serial=serial,
647
+ )
648
+
649
+ @staticmethod
650
+ def _configuration_matches(expected: np.ndarray, accepted: Any) -> bool:
651
+ try:
652
+ actual = np.asarray(accepted, dtype=np.float64)
653
+ except (TypeError, ValueError):
654
+ return False
655
+ return bool(
656
+ actual.shape == expected.shape
657
+ and np.all(np.isfinite(actual))
658
+ and np.array_equal(actual, expected)
659
+ )
660
+
661
+ def commit_trial(
662
+ self,
663
+ token: NativeRotationTrialToken,
664
+ accepted_full_displacement: Any,
665
+ accepted_full_coordinates: Any,
666
+ ) -> int:
667
+ """Commit only when the solver accepted this exact full candidate."""
668
+
669
+ with self._lock:
670
+ active = self._validate_commit_configuration(
671
+ token,
672
+ accepted_full_displacement,
673
+ accepted_full_coordinates,
674
+ )
675
+ self._committed_full_displacement = active.full_displacement
676
+ self._committed_full_coordinates = active.full_coordinates
677
+ self._committed_native_coordinates = active.native_coordinates
678
+ self._committed_rotation_matrices = active.rotation_matrices
679
+ self._generation += 1
680
+ self._active = None
681
+ return int(self._generation)
682
+
683
+ def _validate_commit_configuration(
684
+ self,
685
+ token: NativeRotationTrialToken,
686
+ accepted_full_displacement: Any,
687
+ accepted_full_coordinates: Any,
688
+ ) -> _ActiveNativeRotationTrial:
689
+ active = self._require_active(token)
690
+ if not self._configuration_matches(
691
+ active.full_displacement,
692
+ accepted_full_displacement,
693
+ ):
694
+ raise AcceptedConfigurationMismatchError(
695
+ "accepted full displacement does not exactly match the evaluated trial"
696
+ )
697
+ if not self._configuration_matches(
698
+ active.full_coordinates,
699
+ accepted_full_coordinates,
700
+ ):
701
+ raise AcceptedConfigurationMismatchError(
702
+ "accepted full coordinates do not exactly match the evaluated trial"
703
+ )
704
+ return active
705
+
706
+ def validate_commit_configuration(
707
+ self,
708
+ token: NativeRotationTrialToken,
709
+ accepted_full_displacement: Any,
710
+ accepted_full_coordinates: Any,
711
+ ) -> None:
712
+ """Validate an atomic parent transaction without changing history."""
713
+
714
+ with self._lock:
715
+ self._validate_commit_configuration(
716
+ token,
717
+ accepted_full_displacement,
718
+ accepted_full_coordinates,
719
+ )
720
+
721
+ def commit(
722
+ self,
723
+ token: NativeRotationTrialToken,
724
+ accepted_full_displacement: Any,
725
+ accepted_full_coordinates: Any,
726
+ ) -> int:
727
+ return self.commit_trial(
728
+ token,
729
+ accepted_full_displacement,
730
+ accepted_full_coordinates,
731
+ )
732
+
733
+ def discard_trial(self, token: NativeRotationTrialToken) -> None:
734
+ """Reject the active candidate without changing committed state."""
735
+
736
+ with self._lock:
737
+ self._require_active(token)
738
+ self._active = None
739
+
740
+ def discard(self, token: NativeRotationTrialToken) -> None:
741
+ self.discard_trial(token)
742
+
743
+ def _discard_if_active(self, token: NativeRotationTrialToken) -> None:
744
+ """Best-effort context cleanup that never masks an outer exception."""
745
+
746
+ with self._lock:
747
+ if self._active is not None and self._active.token is token:
748
+ self._active = None
749
+
750
+
751
+ def create_native_rotation_state_store(
752
+ native_node_ids: Sequence[int],
753
+ *,
754
+ rotational_dofs: Mapping[int, Sequence[int]] | None = None,
755
+ coordinate_rows: Mapping[int, int] | None = None,
756
+ committed_full_displacement: Any = None,
757
+ committed_full_coordinates: Any = None,
758
+ committed_rotation_matrices: Mapping[int, Any] | Any | None = None,
759
+ coordinate_node_ids: Sequence[int] | None = None,
760
+ ) -> NativeRotationStateStore | None:
761
+ """Create native history, or return ``None`` without touching other inputs.
762
+
763
+ The early empty return is the Q4/legacy fast path. Required construction
764
+ inputs are validated only when at least one native node exists.
765
+ """
766
+
767
+ if len(native_node_ids) == 0:
768
+ return None
769
+ if rotational_dofs is None or coordinate_rows is None:
770
+ raise NativeRotationValidationError(
771
+ "rotational_dofs and coordinate_rows are required for native nodes"
772
+ )
773
+ return NativeRotationStateStore(
774
+ native_node_ids,
775
+ rotational_dofs=rotational_dofs,
776
+ coordinate_rows=coordinate_rows,
777
+ committed_full_displacement=committed_full_displacement,
778
+ committed_full_coordinates=committed_full_coordinates,
779
+ committed_rotation_matrices=committed_rotation_matrices,
780
+ coordinate_node_ids=coordinate_node_ids,
781
+ )
782
+
783
+
784
+ __all__ = [
785
+ "AcceptedConfigurationMismatchError",
786
+ "NativeElementRotationView",
787
+ "NativeRotationCandidate",
788
+ "NativeRotationStateError",
789
+ "NativeRotationStateStore",
790
+ "NativeRotationTransactionError",
791
+ "NativeRotationTrialToken",
792
+ "NativeRotationValidationError",
793
+ "StaleNativeRotationTokenError",
794
+ "create_native_rotation_state_store",
795
+ "rotation_exponential",
796
+ "validate_proper_rotation_matrices",
797
+ ]