Auto3D 3.2.2__tar.gz → 3.2.3__tar.gz

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 (247) hide show
  1. {auto3d-3.2.2/src/Auto3D.egg-info → auto3d-3.2.3}/PKG-INFO +1 -1
  2. {auto3d-3.2.2 → auto3d-3.2.3}/pyproject.toml +1 -1
  3. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/batch_opt/model_wrapper.py +1 -1
  4. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/model_factory.py +2 -2
  5. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/adapter/aimnet2.py +101 -11
  6. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/adapter/ani.py +150 -23
  7. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/adapter/base.py +17 -7
  8. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/adapter/compiling.py +12 -11
  9. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/policy.py +5 -4
  10. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/constants.py +18 -7
  11. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/pipeline/input_checks.py +6 -2
  12. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/workflow.py +1 -1
  13. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/workflow_workers.py +1 -1
  14. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/errors.py +3 -0
  15. {auto3d-3.2.2 → auto3d-3.2.3/src/Auto3D.egg-info}/PKG-INFO +1 -1
  16. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_SPE.py +1 -1
  17. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_adapter_atom_mask.py +3 -3
  18. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_adapter_fp64_contract.py +2 -2
  19. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_adapter_template.py +2 -2
  20. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_ani2xt_atom_energies.py +151 -0
  21. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_ase_geometry.py +4 -4
  22. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_batchopt.py +2 -3
  23. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_bench_scripts.py +141 -0
  24. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_chunk_manager.py +18 -19
  25. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_app.py +3 -3
  26. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_config_schema.py +7 -7
  27. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_errors.py +3 -3
  28. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_exit_codes.py +2 -2
  29. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_property_commands.py +1 -1
  30. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_compile_values.py +34 -26
  31. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_config.py +3 -4
  32. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_config_parallel_embedding.py +1 -1
  33. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_config_parity.py +1 -1
  34. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_connectivity.py +4 -4
  35. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_custom_nnp_contract.py +2 -2
  36. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_custom_nnp_eager.py +1 -1
  37. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_docs_compile_figures.py +1 -1
  38. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_docs_reproducibility.py +1 -1
  39. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_durability.py +4 -4
  40. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_e_tot_units.py +1 -1
  41. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_energy_constants.py +2 -2
  42. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_geometry.py +3 -3
  43. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_hessian_invocation_contract.py +2 -2
  44. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_id_mapping.py +2 -2
  45. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_isomer_engine_hardening.py +6 -6
  46. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_isomers.py +6 -5
  47. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_model_adapter.py +261 -14
  48. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_model_caching.py +4 -4
  49. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_model_factory.py +5 -5
  50. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_model_preflight.py +3 -3
  51. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_model_wrapper.py +6 -6
  52. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_non_finite_rows.py +1 -1
  53. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_optimization_engine.py +4 -4
  54. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_optimization_engine_indexing.py +4 -4
  55. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_padding_invariance.py +1 -1
  56. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_parallel_embed.py +7 -7
  57. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_pipeline_e2e.py +1 -1
  58. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_policy.py +3 -3
  59. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_preflight_registry_offline.py +1 -1
  60. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_ranking.py +3 -3
  61. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_record_policy_agreement.py +1 -1
  62. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_results.py +2 -2
  63. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_run_setup.py +2 -2
  64. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_sdf_isomer_enumeration.py +1 -1
  65. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_smiles_stereo_warning.py +1 -1
  66. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_spe_energy_only.py +2 -2
  67. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_stereo_identity.py +2 -2
  68. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_stereo_postopt.py +12 -12
  69. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_stereochemistry.py +4 -4
  70. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_suite_hygiene.py +4 -4
  71. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_tautomer_select.py +3 -3
  72. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_conventions.py +1 -1
  73. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_helpers.py +2 -2
  74. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_linearity.py +3 -3
  75. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_projection.py +2 -2
  76. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_record_assertions.py +3 -3
  77. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_relative_energies.py +10 -10
  78. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_utils_sdf_io.py +8 -8
  79. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_utils_smi_io.py +5 -5
  80. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_validation.py +12 -12
  81. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_worker_lifecycle.py +5 -5
  82. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_workflow.py +23 -24
  83. {auto3d-3.2.2 → auto3d-3.2.3}/LICENSE +0 -0
  84. {auto3d-3.2.2 → auto3d-3.2.3}/MANIFEST.in +0 -0
  85. {auto3d-3.2.2 → auto3d-3.2.3}/README.md +0 -0
  86. {auto3d-3.2.2 → auto3d-3.2.3}/setup.cfg +0 -0
  87. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/__init__.py +0 -0
  88. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/__init__.py +0 -0
  89. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/clash_relief.py +0 -0
  90. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/conformer_budget.py +0 -0
  91. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/connectivity.py +0 -0
  92. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/convergence.py +0 -0
  93. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/embedding.py +0 -0
  94. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/energy.py +0 -0
  95. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/filtering.py +0 -0
  96. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/geometry.py +0 -0
  97. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/id_mapping.py +0 -0
  98. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/multiplicity.py +0 -0
  99. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/ranking.py +0 -0
  100. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/stereo_check.py +0 -0
  101. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/stereochemistry.py +0 -0
  102. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/domain/stereochemistry_smiles.py +0 -0
  103. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/__init__.py +0 -0
  104. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/batch_opt/__init__.py +0 -0
  105. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/batch_opt/batchopt.py +0 -0
  106. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/batch_opt/fire_optimizer.py +0 -0
  107. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/batch_opt/optimization_engine.py +0 -0
  108. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/batch_opt/padding.py +0 -0
  109. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/isomers/__init__.py +0 -0
  110. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/isomers/base.py +0 -0
  111. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/isomers/factory.py +0 -0
  112. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/isomers/omega.py +0 -0
  113. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/isomers/rdkit_sdf.py +0 -0
  114. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/isomers/rdkit_smi.py +0 -0
  115. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/isomers/tautomers.py +0 -0
  116. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/__init__.py +0 -0
  117. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/adapter/__init__.py +0 -0
  118. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/adapter/custom.py +0 -0
  119. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/adapter/validation.py +0 -0
  120. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/ani2xt.py +0 -0
  121. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/ani2xt_no_repulsion.pt +0 -0
  122. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/availability.py +0 -0
  123. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/contract.py +0 -0
  124. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/loading.py +0 -0
  125. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/preflight.py +0 -0
  126. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/models/species.py +0 -0
  127. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/engines/torch_config.py +0 -0
  128. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/ASE/__init__.py +0 -0
  129. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/ASE/geometry.py +0 -0
  130. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/ASE/thermo/__init__.py +0 -0
  131. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/ASE/thermo/calculator.py +0 -0
  132. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/ASE/thermo/driver.py +0 -0
  133. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/ASE/thermo/properties.py +0 -0
  134. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/ASE/thermo/vibrations.py +0 -0
  135. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/SPE.py +0 -0
  136. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/__init__.py +0 -0
  137. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/_run_setup.py +0 -0
  138. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/auto3D.py +0 -0
  139. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/entry/tautomer.py +0 -0
  140. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/__init__.py +0 -0
  141. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/config.py +0 -0
  142. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/exceptions.py +0 -0
  143. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/process_lifecycle.py +0 -0
  144. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/registry.py +0 -0
  145. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/results.py +0 -0
  146. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/__init__.py +0 -0
  147. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/atomic_io.py +0 -0
  148. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/logging_config.py +0 -0
  149. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/molprops.py +0 -0
  150. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/output_guard.py +0 -0
  151. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/output_names.py +0 -0
  152. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/reconciliation.py +0 -0
  153. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/sdf_io.py +0 -0
  154. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/foundation/utils/smi_io.py +0 -0
  155. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/__init__.py +0 -0
  156. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/chunk_manager.py +0 -0
  157. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/finalize.py +0 -0
  158. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/job_layout.py +0 -0
  159. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/pipeline/__init__.py +0 -0
  160. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/processors.py +0 -0
  161. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/run_logging.py +0 -0
  162. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/orchestration/supervisor.py +0 -0
  163. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/__init__.py +0 -0
  164. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/auto3Dcli.py +0 -0
  165. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/__init__.py +0 -0
  166. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/app.py +0 -0
  167. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/commands/__init__.py +0 -0
  168. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/commands/config.py +0 -0
  169. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/commands/models.py +0 -0
  170. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/commands/properties.py +0 -0
  171. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/commands/run.py +0 -0
  172. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/commands/validate.py +0 -0
  173. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/config_schema.py +0 -0
  174. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/console.py +0 -0
  175. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/progress.py +0 -0
  176. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/presentation/cli/results.py +0 -0
  177. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D/py.typed +0 -0
  178. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D.egg-info/SOURCES.txt +0 -0
  179. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D.egg-info/dependency_links.txt +0 -0
  180. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D.egg-info/entry_points.txt +0 -0
  181. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D.egg-info/requires.txt +0 -0
  182. {auto3d-3.2.2 → auto3d-3.2.3}/src/Auto3D.egg-info/top_level.txt +0 -0
  183. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_adapter_package_layout.py +0 -0
  184. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_ase_torch_config.py +0 -0
  185. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_atomic_io.py +0 -0
  186. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_auto3D.py +0 -0
  187. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_auto3Dcli.py +0 -0
  188. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_available_cpu_count.py +0 -0
  189. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli.py +0 -0
  190. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_commands_config.py +0 -0
  191. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_console.py +0 -0
  192. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_models_command.py +0 -0
  193. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_results.py +0 -0
  194. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_cli_security.py +0 -0
  195. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_config_bounds.py +0 -0
  196. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_conformer_budget.py +0 -0
  197. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_conftest_isolation_guards.py +0 -0
  198. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_element_sets.py +0 -0
  199. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_embed_params.py +0 -0
  200. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_filtering.py +0 -0
  201. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_filtering_thermo_failed.py +0 -0
  202. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_fire_optimizer.py +0 -0
  203. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_helpers_pipeline_output.py +0 -0
  204. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_import_boundaries.py +0 -0
  205. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_isomer_engine.py +0 -0
  206. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_job_layout.py +0 -0
  207. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_layer_boundaries.py +0 -0
  208. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_lazy_torchani_import.py +0 -0
  209. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_legacy_names.py +0 -0
  210. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_legacy_yaml_parity.py +0 -0
  211. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_logging_config.py +0 -0
  212. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_molprops.py +0 -0
  213. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_mp_start_method.py +0 -0
  214. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_multiplicity.py +0 -0
  215. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_no_aimnet.py +0 -0
  216. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_notebook_properties.py +0 -0
  217. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_nse_multiplicity.py +0 -0
  218. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_optimization_engine_validation.py +0 -0
  219. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_output_names.py +0 -0
  220. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_output_overwrite_gates.py +0 -0
  221. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_packaging_metadata.py +0 -0
  222. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_padding.py +0 -0
  223. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_processors.py +0 -0
  224. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_progress.py +0 -0
  225. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_public_api.py +0 -0
  226. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_ranking_by_gibbs.py +0 -0
  227. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_registry.py +0 -0
  228. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_species_conversion.py +0 -0
  229. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_species_module.py +0 -0
  230. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_stereo_check_positions.py +0 -0
  231. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_stereochemistry_validation.py +0 -0
  232. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_tauto.py +0 -0
  233. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_tautomer_mirror_images.py +0 -0
  234. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_tautomer_stereo.py +0 -0
  235. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo.py +0 -0
  236. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_etot_sync.py +0 -0
  237. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_imaginary_mode_inversion.py +0 -0
  238. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_reference.py +0 -0
  239. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_temperature_validation.py +0 -0
  240. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_thermo_transition_state.py +0 -0
  241. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_torch_config.py +0 -0
  242. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_utils.py +0 -0
  243. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_utils_reconciliation.py +0 -0
  244. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_utils_validation.py +0 -0
  245. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_validate_run_parity.py +0 -0
  246. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_validation_errors.py +0 -0
  247. {auto3d-3.2.2 → auto3d-3.2.3}/tests/test_workflow_package_layout.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Auto3D
3
- Version: 3.2.2
3
+ Version: 3.2.3
4
4
  Summary: Generating Low-energy 3D Conformers from SMILES/SDF
5
5
  Author-email: Zhen Liu <liu5@andrew.cmu.edu>, Tetiana Zubatiuk <tetiana@zubatyuk.com>, Adrian Roitberg <roitberg@ufl.edu>, Olexandr Isayev <olexandr@olexandrisayev.com>
6
6
  Maintainer-email: Olexandr Isayev <olexandr@olexandrisayev.com>
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "Auto3D"
7
- version = "3.2.2"
7
+ version = "3.2.3"
8
8
  description = "Generating Low-energy 3D Conformers from SMILES/SDF"
9
9
  readme = "README.md"
10
10
  license = {text = "MIT"}
@@ -368,7 +368,7 @@ class BatchedEnergyForce(nn.Module):
368
368
  f"at batch size 1. Reduce batchsize_atoms or use a smaller model."
369
369
  )
370
370
  # Halve the SUB-BATCH SIZE, not the length of the slice that
371
- # happened to fail (T-3) -- but never to more than that length.
371
+ # happened to fail -- but never to more than that length.
372
372
  # Both halves matter:
373
373
  #
374
374
  # * `bsize // 2` rather than `sub.numel() // 2`, because a tail
@@ -68,7 +68,7 @@ def _verify_compiled_adapter(
68
68
 
69
69
  Private: it is absent from ``docs/source/api.rst``, its only caller is
70
70
  :meth:`ModelFactory.create`, and what a user needs to know about it is
71
- ``create_model``'s ``Raises:`` block (A-2). ``_probe_mols`` beside it is
71
+ ``create_model``'s ``Raises:`` block. ``_probe_mols`` beside it is
72
72
  private for the same reason.
73
73
  """
74
74
  mols = _probe_mols()
@@ -106,7 +106,7 @@ def _rebaseline_compile_fallback_counters(adapter: BaseModelAdapter) -> None:
106
106
  ``_compile_suppressed_seen`` is reset along with the snapshot, and must be:
107
107
  if the probe itself suppressed a frame, the count is already 1, and after
108
108
  the snapshot moves forward the next genuine suppression computes a delta of
109
- 1 again -- which is not greater than 1, so it would never be reported (T-2).
109
+ 1 again -- which is not greater than 1, so it would never be reported.
110
110
  """
111
111
  adapter._compile_frame_stats_before = dict(torch._dynamo.utils.counters.get("frames", {}))
112
112
  adapter._compile_suppressed_seen = 0
@@ -10,10 +10,23 @@ import torch
10
10
  from Auto3D.engines.models.adapter.base import BaseModelAdapter
11
11
  from Auto3D.engines.models.adapter.validation import _validate_outputs
12
12
  from Auto3D.engines.models.availability import require_aimnet
13
+ from Auto3D.foundation.exceptions import ConfigurationError
13
14
  from Auto3D.foundation.utils.logging_config import get_logger
14
15
 
15
16
  logger = get_logger(__name__)
16
17
 
18
+ #: The two refusals ``AIMNet2Calculator._validate_species_and_charge`` raises as
19
+ #: a plain ``ValueError``, each identified by the one phrase that states the
20
+ #: refusal rather than the advice wrapped around it. Element coverage
21
+ #: (``implemented_species``) and net charge (``supports_charged_systems``) go
22
+ #: through that single validator, which ``eval`` runs before it branches on
23
+ #: ``hessian``, so these two phrases cover both of this adapter's calculator
24
+ #: call sites. See :meth:`AIMNet2Adapter._run_calculator`.
25
+ _CALCULATOR_REJECTIONS = (
26
+ "are not in this model's implemented_species",
27
+ "does not support net-charged systems",
28
+ )
29
+
17
30
 
18
31
  class AIMNet2Adapter(BaseModelAdapter):
19
32
  """Adapter for AIMNet2 models served by the `aimnet` package.
@@ -49,17 +62,21 @@ class AIMNet2Adapter(BaseModelAdapter):
49
62
  # constant. That row is salbutamol: its arrangements agree to 0.0647 A
50
63
  # heavy-atom RMSD, the duplicate filter's own criterion, but the molecule
51
64
  # carries hydroxyl and amine hydrogens whose alternative orientations are
52
- # close in energy, so an O-H rotamer or N-H invertomer pair is not
53
- # excluded (the next case, 4.0e-03 eV, has no such rotor). The spread was
54
- # also 1.4x above its own reading an hour earlier, so a value built on it
55
- # would be built on a draw rather than a bound -- and five times it,
56
- # 0.050 eV (1.15 kcal/mol, 1.9 kT at 298 K), overlaps typical
57
- # hydroxyl-rotamer splittings of roughly 0.5 to 1.5 kcal/mol, which the
58
- # energy half of the duplicate test exists to keep apart (ANI2xt's
59
- # 0.011 eV, 0.25 kcal/mol, sits below that band). That matters here
65
+ # distinct minima that can be close in energy -- this engine's smallest
66
+ # measured gap between two conformers the heavy-atom criterion cannot
67
+ # separate is 0.0073 eV, below that row -- so an O-H rotamer or N-H
68
+ # invertomer pair is not excluded (the next case, 4.0e-03 eV, has no such
69
+ # rotor). The spread was also 1.4x above its own reading an hour earlier,
70
+ # so a value built on it would be built on a draw rather than a bound --
71
+ # and five times it, 0.050 eV (1.15 kcal/mol, 1.9 kT at 298 K), would
72
+ # merge 6 of the 12 distinct pairs measured for this engine on 2026-10-19,
73
+ # in every one of three repeats, against the 1 this constant merges; those
74
+ # 12 span 0.17 to 5.5 kcal/mol with a median of 1.3, and all 12 come from
75
+ # salbutamol and diethanolamine. That matters here
60
76
  # because this class serves ``aimnet2``, ``aimnet2-2025``, ``aimnet2-nse``
61
77
  # and ``aimnet2-pd`` while only the default model was measured. See
62
- # ``benchmarks/results-notes/2026-10-16-batch-noise.md``.
78
+ # ``benchmarks/results-notes/2026-10-16-batch-noise.md`` and
79
+ # ``benchmarks/results-notes/2026-10-19-rotamer-splittings.md``.
63
80
 
64
81
  def __init__(
65
82
  self,
@@ -131,6 +148,79 @@ class AIMNet2Adapter(BaseModelAdapter):
131
148
  )
132
149
  return data
133
150
 
151
+ def _run_calculator(self, data: dict, **kwargs: bool) -> dict:
152
+ """Call the calculator, typing its species/charge refusal on the way out.
153
+
154
+ ``AIMNet2Calculator`` refuses an atomic number outside the model's
155
+ ``implemented_species``, and a net charge on a model whose family
156
+ declares ``supports_charged_systems`` false, with a plain
157
+ ``builtins.ValueError``. That is not an ``Auto3DError``, so it escaped
158
+ Auto3D's error taxonomy and its exit codes entirely: an unhandled
159
+ traceback out of the very engine Auto3D's own routing had sent the user
160
+ to, since ``models.policy``'s ANI refusal for such a molecule names
161
+ AIMNET. Raising :class:`~Auto3D.foundation.exceptions.ConfigurationError`
162
+ gives it exit code 2 -- the code that ANI refusal already carries -- so
163
+ the two engines finally refuse the same input the same way on the
164
+ entry points that let it reach the caller (``auto3d energy``,
165
+ ``auto3d optimize``, ``smiles2mols``). Two others deliberately do not:
166
+ ``auto3d thermo``'s driver keeps and marks a failed record instead of
167
+ aborting, so it stays at exit 0 and the gain is a classified error in
168
+ its per-record warning; ``auto3d run`` and ``main`` optimize in a
169
+ child process and report their own ``OptimizationError`` for a chunk
170
+ that produced nothing, so there the gain is the typed error in that
171
+ chunk's log. The CHANGELOG entry states all three.
172
+
173
+ Upstream's message is preserved WHOLE rather than paraphrased: it names
174
+ the offending atomic numbers and the model's full supported set, and
175
+ that set is per registry model (``aimnet2-pd`` covers palladium, the
176
+ default does not), so no fixed text on this side could state it. The
177
+ sentence added in front names the model and says nothing about the
178
+ cause, because the element and the charge refusal share this validator
179
+ and would not share one diagnosis.
180
+
181
+ Any other ``ValueError`` is re-raised untouched -- a bare ``raise``, so
182
+ the same object with its traceback intact. The discrimination is by
183
+ message shape because that is all upstream offers: the validator raises
184
+ the built-in type and defines no exception class of its own. Matching
185
+ narrowly is the safe direction. An upstream rewording stops the
186
+ conversion and restores the untyped traceback, which is merely the old
187
+ behavior; a loose match would retype an unrelated ``ValueError`` as a
188
+ configuration error and misdiagnose it, which is worse than the defect.
189
+
190
+ Neither guard this class raises of its own is inside the converted
191
+ region. ``forward``'s ``atom_mask`` refusal runs well before this
192
+ method is reached, and ``_with_spin``'s ``mults`` shape check runs
193
+ while this call's arguments are still being built -- ``_with_spin`` is
194
+ an argument expression at both call sites, evaluated before the ``try``
195
+ below is entered.
196
+
197
+ Args:
198
+ data: The calculator input, already through :meth:`_with_spin`.
199
+ **kwargs: ``forces=True`` or ``hessian=True``, as each call site
200
+ sends; passed through unchanged.
201
+
202
+ Returns:
203
+ The calculator's output dict, exactly as returned.
204
+
205
+ Raises:
206
+ ConfigurationError: The calculator refused this input's elements or
207
+ its net charge. ``__cause__`` is upstream's ``ValueError``.
208
+ """
209
+ try:
210
+ # Annotated, not returned directly: `aimnet` ships no type
211
+ # information, so `self._calc` is `Any` and a bare return of its
212
+ # result would be a `no-any-return` error here rather than at the
213
+ # two call sites that unpack it.
214
+ result: dict = self._calc(data, **kwargs)
215
+ except ValueError as exc:
216
+ if not any(phrase in str(exc) for phrase in _CALCULATOR_REJECTIONS):
217
+ raise
218
+ raise ConfigurationError(
219
+ f"{self.model_name} cannot evaluate this input. {exc}",
220
+ hint_key="aimnet_rejected_input",
221
+ ) from exc
222
+ return result
223
+
134
224
  def analytic_hessian(
135
225
  self,
136
226
  coords: torch.Tensor,
@@ -173,7 +263,7 @@ class AIMNet2Adapter(BaseModelAdapter):
173
263
  Hessian in eV/A^2, shape ``(n_atoms, 3, n_atoms, 3)`` as aimnet
174
264
  returns it.
175
265
  """
176
- result = self._calc(
266
+ result = self._run_calculator(
177
267
  self._with_spin({"coord": coords, "numbers": species, "charge": charges}, mults),
178
268
  hessian=True,
179
269
  )
@@ -301,7 +391,7 @@ class AIMNet2Adapter(BaseModelAdapter):
301
391
  numbers_flat = species[mask] # (M,)
302
392
  mol_idx = torch.arange(b, device=species.device).unsqueeze(1).expand(b, n)[mask] # (M,)
303
393
 
304
- result = self._calc(
394
+ result = self._run_calculator(
305
395
  self._with_spin(
306
396
  {
307
397
  "coord": coord_flat,
@@ -5,7 +5,7 @@ Cut from this package's single-file predecessor.
5
5
 
6
6
  from __future__ import annotations
7
7
 
8
- from collections.abc import Sequence
8
+ from collections.abc import Callable, Sequence
9
9
 
10
10
  import torch
11
11
  import torch.nn as nn
@@ -19,6 +19,108 @@ from Auto3D.foundation.utils.logging_config import get_logger
19
19
 
20
20
  logger = get_logger(__name__)
21
21
 
22
+ #: Row-count quantum for the compiled per-element loop's index tensors. Every
23
+ #: such tensor is padded up to a positive multiple of this, so Dynamo never
24
+ #: sees one sized 0 or 1 and cannot 0/1-specialize the compiled frame on it.
25
+ #: 8 and 32 are the two values the recipe names; 8 is the smaller, and the
26
+ #: padding is pure overhead, so it is the one measured.
27
+ _PAD_QUANTUM = 8
28
+
29
+ #: Whether :meth:`ANI2xtAdapter._compile` installs that padding. Read at
30
+ #: compile-install time, so one process can build an adapter under each
31
+ #: setting and measure both; it reaches nothing outside
32
+ #: ``compile_model=True``, which is off by default.
33
+ #: See ``benchmarks/measure_mark_dynamic.py``.
34
+ _PAD_INDEX_TO_QUANTUM = True
35
+
36
+
37
+ def _pad_index_to_quantum(idx: torch.Tensor, scratch_start: int) -> torch.Tensor:
38
+ """``idx`` extended to a positive multiple of :data:`_PAD_QUANTUM`.
39
+
40
+ The padding rows are ``scratch_start``, ``scratch_start + 1``, ... --
41
+ consecutive and therefore distinct, so the ``index_copy`` they feed has no
42
+ duplicate target and stays deterministic under
43
+ ``torch.use_deterministic_algorithms``, which Auto3D lets a caller request
44
+ (``Auto3D.engines.torch_config``). The caller gives each element a block of
45
+ :data:`_PAD_QUANTUM` scratch rows of its own, which is the most any one
46
+ element can need.
47
+
48
+ The target is ``max(q, ceil(n / q) * q)``, not the bare ``ceil``: an
49
+ element absent from the batch has ``n == 0``, whose next multiple of ``q``
50
+ is 0, and a 0-sized tensor is exactly the thing this is here to prevent --
51
+ the common case, not an edge one, since most batches carry three or four
52
+ of the seven elements.
53
+ """
54
+ n = int(idx.shape[0])
55
+ quanta = max(1, -(-n // _PAD_QUANTUM))
56
+ target = quanta * _PAD_QUANTUM
57
+ if target == n:
58
+ return idx
59
+ pad = torch.arange(target - n, dtype=idx.dtype, device=idx.device) + scratch_start
60
+ return torch.cat([idx, pad])
61
+
62
+
63
+ def _quantize_index_shapes(
64
+ atom_energies_fn: Callable[..., torch.Tensor],
65
+ ) -> Callable[..., torch.Tensor]:
66
+ """Wrap the compiled per-element loop so no index tensor it sees is 0/1-sized.
67
+
68
+ Each distinct element-presence pattern across a run 0/1-specializes
69
+ ``element_indices``'s seven per-element row-index tensors, so past
70
+ ``torch._dynamo.config.recompile_limit`` of those patterns the compiled
71
+ frame silently falls back to eager. Rounding every index tensor up to a
72
+ positive multiple of :data:`_PAD_QUANTUM` leaves Dynamo no 0 or 1 to
73
+ specialize on, and ``mark_dynamic`` on the padded dimension then asks for
74
+ one graph covering the rest.
75
+
76
+ The padding runs **outside** the compiled callable, which is why this
77
+ wraps the result of ``_try_compile`` rather than the other way round:
78
+ :func:`_pad_index_to_quantum` reads ``idx.shape[0]`` as a Python integer
79
+ and branches on it, and inside a graph that branch would be a guard --
80
+ another specialization, in place of the one being removed. Reading the
81
+ shape costs nothing here: ``element_indices`` already took its one host
82
+ readback, so these tensors have concrete sizes and no synchronization is
83
+ added.
84
+
85
+ The cost, paid on every forward: one copy of ``aev_flat``, and up to
86
+ ``_PAD_QUANTUM`` extra MLP rows per element (56 at ``_PAD_QUANTUM`` 8)
87
+ whose energies are computed and discarded. Scratch rows carry a zero AEV,
88
+ which every network maps to a finite number, and they land in scratch
89
+ slots of the output that the slice below drops. The ``torch.cat``
90
+ duplicates the whole AEV block and autograd keeps it for the backward
91
+ pass, which measured as 57.5 MiB (14.3%) of extra peak allocation on the
92
+ 32-pattern sweep, identical in every pass of both samples.
93
+
94
+ The rows that survive the slice are *not* bit-identical to the unpadded
95
+ result, which is the thing this docstring would otherwise imply. Each
96
+ network now runs over a few more rows, and a float32 matrix multiply over
97
+ a different row count is free to reduce in a different order: one to two
98
+ float32 ULP, measured at 1.47e-06 eV against eager over the pattern set
99
+ -- between the two readings of the unpadded compile it replaces, and 680x
100
+ under the tolerance ``create_model``'s construction probe applies.
101
+ Reordered arithmetic, not an error term that grows.
102
+ """
103
+
104
+ def padded(
105
+ networks: nn.ModuleList | Sequence[nn.Module],
106
+ aev_flat: torch.Tensor,
107
+ elem_index: list[torch.Tensor],
108
+ n_rows: int,
109
+ ) -> torch.Tensor:
110
+ num_elements = len(elem_index)
111
+ scratch_rows = num_elements * _PAD_QUANTUM
112
+ aev_ext = torch.cat([aev_flat, aev_flat.new_zeros((scratch_rows, aev_flat.shape[-1]))])
113
+ torch._dynamo.mark_dynamic(aev_ext, 0)
114
+ padded_index = []
115
+ for position, idx in enumerate(elem_index):
116
+ padded_idx = _pad_index_to_quantum(idx, n_rows + position * _PAD_QUANTUM)
117
+ torch._dynamo.mark_dynamic(padded_idx, 0)
118
+ padded_index.append(padded_idx)
119
+ out = atom_energies_fn(networks, aev_ext, padded_index, n_rows + scratch_rows)
120
+ return out[:n_rows]
121
+
122
+ return padded
123
+
22
124
 
23
125
  class ANI2xtAdapter(BaseModelAdapter):
24
126
  """Adapter for ANI2xt model.
@@ -32,10 +134,21 @@ class ANI2xtAdapter(BaseModelAdapter):
32
134
  but returns energies off by hundreds of eV with no error raised. Only
33
135
  ``_atom_energies_fn`` -- the per-element loop, free of a data-dependent
34
136
  branch that would otherwise make it uncompilable on its own -- is
35
- compiled (``tests/test_ani2xt_atom_energies.py``). Whether that is a
36
- wall-clock win, and by how much, is a GPU measurement this repository does
37
- not make; see ``benchmarks/bench_optimization_perf.py``. No speedup figure
38
- is claimed here because none has been measured.
137
+ compiled (``tests/test_ani2xt_atom_energies.py``), with its index tensors
138
+ padded by :func:`_quantize_index_shapes` so the frame is not
139
+ 0/1-specialized out of existence.
140
+
141
+ What that buys, measured on one L40S over 32 element-presence patterns in
142
+ two sessions (``benchmarks/results-notes/2026-10-19-mark-dynamic.md``):
143
+ the compiled frame stops falling back to eager (two compiles for the whole
144
+ pattern set instead of nine, one of which was suppressed); at 64
145
+ conformers per batch it is 1.07x and 1.21x eager in the two sessions, and
146
+ at 256 conformers 1.18x and 1.24x; at 1 and 8 conformers it is within
147
+ noise of eager. The two sessions are quoted as a range rather than
148
+ summarized, because two is too few to put an interval on and they differ
149
+ by more than the within-session spread. Those are per-forward figures on
150
+ one card, not a whole-run speedup -- the cold compile is paid once per
151
+ process and is not in them.
39
152
  """
40
153
 
41
154
  # No `duplicate_energy_tol` here: :class:`BaseModelAdapter` carries the
@@ -81,14 +194,20 @@ class ANI2xtAdapter(BaseModelAdapter):
81
194
  # module (which includes torchani's AEVComputer) gives energies off by
82
195
  # hundreds of eV with no error raised. The AEV stays eager.
83
196
  #
84
- # Attempted, not landed: each distinct element-presence
85
- # pattern across a run 0/1-specializes `element_indices`'s seven
86
- # per-element row-index tensors, so past
197
+ # Each distinct element-presence pattern across a run 0/1-specializes
198
+ # `element_indices`'s seven per-element row-index tensors, so past
87
199
  # `torch._dynamo.config.recompile_limit` of those patterns the frame
88
- # silently falls back to eager (measured: total 9, ok 8).
89
- # `torch._dynamo.mark_dynamic` on `aev_flat` and each `elem_index[i]`
90
- # does not fix this on torch 2.9.1+cu128: with seven simultaneously
91
- # varying, frequently 0/1-sized dims, Dynamo's own 0/1 specialization
200
+ # silently falls back to eager. `_quantize_index_shapes` removes the 0
201
+ # and the 1 from those sizes before Dynamo sees them, so there is
202
+ # nothing left for that specialization to fire on; see its docstring
203
+ # for the cost, and
204
+ # `benchmarks/results-notes/2026-10-19-mark-dynamic.md` for what it
205
+ # buys.
206
+ #
207
+ # Why the padding and not one of the direct knobs, which is the first
208
+ # question this raises: `torch._dynamo.mark_dynamic` alone does not
209
+ # fix it on torch 2.9.1+cu128 -- with seven simultaneously varying,
210
+ # frequently 0/1-sized dims, Dynamo's own 0/1 specialization
92
211
  # recompiles anyway ("to avoid specialization try
93
212
  # torch._dynamo.mark_unbacked"); `mark_unbacked` instead raises
94
213
  # `GuardOnDataDependentSymNode: Eq(u7, 0) | Eq(u7, 1)` inside
@@ -97,11 +216,13 @@ class ANI2xtAdapter(BaseModelAdapter):
97
216
  # `use_duck_shape = False` and
98
217
  # `torch._inductor.config.joint_graph_constant_folding = False` only
99
218
  # trades that failure for a broadcast-lowering guard on the same
100
- # size-1 question. No config combination tried removes the
101
- # specialization. The compile below is unchanged from before this was
102
- # attempted -- no mark_dynamic wrapper is installed, rather than
103
- # landing a closure whose docstring claims a fix that does not hold.
104
- model._atom_energies_fn = _try_compile(model._atom_energies_fn)
219
+ # size-1 question. Every one of those asks Dynamo to stop caring about
220
+ # the 0 and the 1; the padding removes them instead, which is the only
221
+ # form of the request this torch honors.
222
+ compiled = _try_compile(model._atom_energies_fn)
223
+ if _PAD_INDEX_TO_QUANTUM:
224
+ compiled = _quantize_index_shapes(compiled)
225
+ model._atom_energies_fn = compiled
105
226
  return model
106
227
 
107
228
  def to_species(self, atomic_numbers: Sequence[int]) -> list[int]:
@@ -176,12 +297,18 @@ class ANI2xAdapter(BaseModelAdapter):
176
297
  # steps apart (1.95e-02 eV, 0.45 kcal/mol; its arrangements agree to at
177
298
  # most 0.1023 A heavy-atom RMSD, and that molecule's only hydrogen-only
178
299
  # rotors cost several kcal/mol, so it is one basin), so such a pair
179
- # survives deduplication as two
180
- # near-degenerate copies -- which is visible in the output and correctable,
181
- # unlike a merged rotamer, and preferred to a window of 0.098 eV (3.8 kT at
182
- # 298 K) that five times this floor would ask for. The step doubles with
183
- # each doubling of |E|. See
184
- # ``benchmarks/results-notes/2026-10-16-batch-noise.md``.
300
+ # survives deduplication as two near-degenerate copies -- visible in the
301
+ # output and correctable, unlike a merged rotamer, and preferred to a
302
+ # window of 0.098 eV (3.8 kT at 298 K) that five times this floor would
303
+ # ask for: of the 13 distinct pairs this engine's heavy-atom criterion
304
+ # cannot separate, measured on 2026-10-19 over three repeats, 4 or 5 sit
305
+ # below that window -- 3 or 4 of the 12 whose polar hydrogens moved to
306
+ # another rotor well -- against the 2 (1 on that cut) this constant
307
+ # merges. Both counts take two values because one pair, salbutamol 64/80,
308
+ # sits at 0.296 A against the 0.300 A RMSD threshold and crosses it on the
309
+ # optimizer's own noise. The step doubles with each doubling of |E|. See
310
+ # ``benchmarks/results-notes/2026-10-16-batch-noise.md`` and
311
+ # ``benchmarks/results-notes/2026-10-19-rotamer-splittings.md``.
185
312
 
186
313
  def __init__(self, device: torch.device, compile_model: bool = False) -> None:
187
314
  """Initialize ANI2x adapter.
@@ -79,12 +79,22 @@ class BaseModelAdapter(ABC, nn.Module):
79
79
  #: ``DEFAULT_DUPLICATE_ENERGY_TOL``, and none overrides it: the
80
80
  #: 2026-10-16 measurement of the three bundled engines
81
81
  #: (``benchmarks/results-notes/2026-10-16-batch-noise.md``) found floors
82
- #: that moved between two runs an hour apart, and the per-engine values it
83
- #: computed for AIMNet2 and ANI2x (0.050 and 0.098 eV, 1.9 and 3.8 times
84
- #: kT at 298 K) reach into and past the hydroxyl-rotamer splittings the
85
- #: energy half of the duplicate test protects, roughly 0.5 to 1.5
86
- #: kcal/mol; the third (ANI2xt, 0.011 eV) is within rounding of this
87
- #: constant. The attribute is here so that an adapter
82
+ #: that moved between two runs an hour apart, and every per-engine value
83
+ #: it computed (0.050, 0.011 and 0.098 eV for AIMNet2, ANI2xt and ANI2x;
84
+ #: 1.9, 0.4 and 3.8 times kT at 298 K) reaches well into the gaps the
85
+ #: energy half of the duplicate test protects
86
+ #: (``benchmarks/results-notes/2026-10-19-rotamer-splittings.md``: 12, 11
87
+ #: and 13 distinct RMSD-passing pairs, spanning 0.17 to 5.5, 0.04 to 4.3
88
+ #: and 0.09 to 7.2 kcal/mol with medians of 1.3, 0.5 and 2.4, over three
89
+ #: repeats of a pool two of whose ten molecules produced every pair). Of
90
+ #: the pairs whose polar hydrogens moved to another rotor well, those
91
+ #: windows merge 6 of AIMNet2's 12 and 3 of ANI2xt's 10 in every repeat
92
+ #: and 3 or 4 of ANI2x's 12 depending on the repeat, against 1, 2 and 1
93
+ #: for this constant, which ANI2xt's 0.011 eV is also within rounding of.
94
+ #: The AIMNet2 figures are the default ``aimnet2`` model's;
95
+ #: :class:`~Auto3D.engines.models.adapter.aimnet2.AIMNet2Adapter` also
96
+ #: serves ``aimnet2-2025``, ``aimnet2-nse`` and ``aimnet2-pd``, which have
97
+ #: no measurement of their own. The attribute is here so that an adapter
88
98
  #: class CAN carry its own value, for a backend whose spread has been
89
99
  #: measured; setting it on a subclass changes only that adapter's runs.
90
100
  duplicate_energy_tol: float = DEFAULT_DUPLICATE_ENERGY_TOL
@@ -147,7 +157,7 @@ class BaseModelAdapter(ABC, nn.Module):
147
157
  # back long after the first forward (the recompile limit -- see that
148
158
  # method's docstring), so a one-shot gate spent its single observation
149
159
  # on a frame that always compiles cleanly and then stayed silent
150
- # forever (T-2).
160
+ # forever.
151
161
  self._compile_suppressed_seen = 0
152
162
 
153
163
  # Disable gradients for model parameters (inference mode)
@@ -136,17 +136,18 @@ def _warn_if_compile_fell_back_to_eager(adapter: _CompileTrackedAdapter) -> None
136
136
  once per *increase* in the suppressed count (``_compile_suppressed_seen``).
137
137
 
138
138
  Checked on every forward rather than once, because whether a compiled
139
- frame falls back can change after the first observation: Dynamo
140
- 0/1-specializes
141
- the seven per-element index tensors ``ANI2xt`` builds, so each distinct
142
- element-presence pattern is a fresh recompile, and once
143
- ``torch._dynamo.config.recompile_limit`` is reached the frame runs
144
- eager for the rest of the process (measured on CPU: total 9, ok 8).
145
- The one allowed observation, meanwhile, is spent on the
146
- compiled-vs-eager probe forward ``create_model`` runs at construction
147
- -- a frame that by construction compiles cleanly -- so the real
148
- fallback, hundreds of steps later, would never be reported by a single
149
- check. The
139
+ frame falls back can change after the first observation. ``ANI2xt`` was
140
+ the worked example: Dynamo 0/1-specialized the seven per-element index
141
+ tensors it builds, so each distinct element-presence pattern was a fresh
142
+ recompile and the frame ran eager for the rest of the process once
143
+ ``torch._dynamo.config.recompile_limit`` was reached. That one is fixed
144
+ (``Auto3D.engines.models.adapter.ani._quantize_index_shapes``), but
145
+ nothing here depends on it staying fixed, and the third-party compiled
146
+ frames named above can still degrade. The one allowed observation,
147
+ meanwhile, is spent on the compiled-vs-eager probe forward
148
+ ``create_model`` runs at construction -- a frame that by construction
149
+ compiles cleanly -- so a fallback hundreds of steps later would never be
150
+ reported by a single check. The
150
151
  factory re-baselines ``_compile_frame_stats_before`` and this count
151
152
  after that probe, so the probe's own frame is excluded from these
152
153
  deltas.
@@ -324,10 +324,11 @@ def check_engine_supports_molecules(
324
324
  ]
325
325
  if incompatible:
326
326
  raise ConfigurationError(
327
- f"Only AIMNET can handle: {incompatible}, but {optimizing_engine} was "
328
- "parsed to Auto3D. A molecule requires AIMNET if it has an element "
329
- "outside the ANI training set, a nonzero net charge, or unpaired "
330
- "(radical) electrons."
327
+ f"{optimizing_engine} does not cover: {incompatible}. A molecule "
328
+ "requires AIMNET or your own NNP if it has an element outside the "
329
+ "ANI training set, a nonzero net charge, or unpaired (radical) "
330
+ "electrons.",
331
+ hint_key="aimnet_rejected_input",
331
332
  )
332
333
 
333
334
  # Every molecule here passed requires_aimnet (net charge zero, in-set
@@ -176,16 +176,27 @@ DEFAULT_RMSD_THRESHOLD = 0.3 # Angstrom, for duplicate conformer removal
176
176
  # 0.050, 0.011 and 0.098 eV, five times each floor rounded up -- and were NOT
177
177
  # adopted. Two reasons: the floors moved by 1.4x and 2.5x between two runs an
178
178
  # hour apart, so five times the largest of three draws is a draw and not a
179
- # bound on the quantity. And a window of that width overlaps the hydroxyl and
180
- # amine rotamer splittings the energy half of this test exists to protect,
181
- # roughly 0.5 to 1.5 kcal/mol: the AIMNet2 value (1.15 kcal/mol, 1.9 kT at
182
- # 298 K) sits inside that range and the ANI2x one (2.26 kcal/mol, 3.8 kT)
183
- # above it, while ANI2xt's 0.011 eV is 0.43 kT and within rounding of this
179
+ # bound on the quantity. And a window of that width merges pairs the
180
+ # heavy-atom criterion cannot separate, which is what the energy half of this
181
+ # test exists to protect -- its motivation being the hydroxyl and amine rotors
182
+ # whose orientation that criterion cannot see at all. How far apart such pairs
183
+ # sit was measured on 2026-10-19, over three repeats of a 164-conformer
184
+ # production pool from ten hydroxyl- and amine-bearing molecules, two of which
185
+ # produced every pair: 12 distinct pairs for AIMNet2 spanning 0.17 to
186
+ # 5.5 kcal/mol with a median of 1.3, 11 for ANI2xt spanning 0.04 to 4.3 with a
187
+ # median of 0.5, and 13 for ANI2x spanning 0.09 to 7.2 with a median of 2.4.
188
+ # Restricted to the pairs whose polar hydrogens actually moved to another rotor
189
+ # well, each per-engine window merges 6 of AIMNet2's 12 and 3 of ANI2xt's 10 in
190
+ # every one of the three repeats, and 3 or 4 of ANI2x's 12 depending on the
191
+ # repeat, against the 1, 2 and 1 this constant merges: the AIMNet2 value is
192
+ # 1.9 kT at 298 K and the ANI2x one 3.8 kT, while ANI2xt's 0.011 eV is 0.43 kT
193
+ # and within rounding of this
184
194
  # constant -- which would buy false positives (a merged rotamer, silent and
185
195
  # irreversible) to
186
196
  # reduce false negatives that are intrinsic to any finite window and that a
187
- # user can see and correct. The measurement, both samples and that reading:
188
- # benchmarks/results-notes/2026-10-16-batch-noise.md.
197
+ # user can see and correct. The floors, both samples and that reading:
198
+ # benchmarks/results-notes/2026-10-16-batch-noise.md. The gaps:
199
+ # benchmarks/results-notes/2026-10-19-rotamer-splittings.md.
189
200
  #
190
201
  # The accepted cost is on ANI2x, whose measured floor is twice this value: its
191
202
  # float32 total energy is quantized at 3.91e-3 eV near |E| ~ 3.9e4 eV (the step
@@ -173,7 +173,11 @@ def check_input(args: Any) -> None:
173
173
  optimizing_engine = args.optimizing_engine
174
174
  if optimizing_engine in {"ANI2x", "ANI2xt"}:
175
175
  raise ConfigurationError(
176
- f"Only AIMNET can handle: {only_aimnet_smiles}, but {optimizing_engine} was parsed to Auto3D."
176
+ f"{optimizing_engine} does not cover: {only_aimnet_smiles}. A "
177
+ "molecule requires AIMNET or your own NNP if it has an element "
178
+ "outside the ANI training set, a nonzero net charge, or "
179
+ "unpaired (radical) electrons.",
180
+ hint_key="aimnet_rejected_input",
177
181
  )
178
182
 
179
183
 
@@ -322,7 +326,7 @@ def check_smi_format(args: Any) -> tuple[bool, list[str]]:
322
326
  #
323
327
  # Not folded into the engine question: atomic number 0 is outside
324
328
  # ANI_ELEMENTS, so counting this record would make check_input raise
325
- # "Only AIMNET can handle: [...]" for an ANI run, the opposite of
329
+ # "ANI2xt does not cover: [...]" for an ANI run, the opposite of
326
330
  # the dummy-atom contract (warned about and skipped, never fatal), and it
327
331
  # must not decide anything on behalf of the records that stay.
328
332
  #
@@ -100,7 +100,7 @@ def _sigterm_raises() -> Iterator[None]:
100
100
  for the duration of one ``main()``. Nothing is lost by declining:
101
101
  every worker arms ``PR_SET_PDEATHSIG`` plus a parent-sentinel watchdog
102
102
  of its own (``Auto3D.foundation.process_lifecycle``), so the workers
103
- still die with the parent however the parent goes (A-3).
103
+ still die with the parent however the parent goes.
104
104
 
105
105
  When the handler IS installed, the previous disposition -- ``SIG_DFL`` by
106
106
  the guard above -- is put back on the way out, so one ``main()`` call
@@ -261,7 +261,7 @@ def isomer_wrapper(
261
261
  # put then raises from inside a `finally` -- turning a quiet
262
262
  # SystemExit(130) into a BrokenPipeError traceback on the shared
263
263
  # stderr, which is the exact noise the `except KeyboardInterrupt`
264
- # above exists to avoid (C-3b). (Belt-and-braces in practice: since
264
+ # above exists to avoid. (Belt-and-braces in practice: since
265
265
  # bpo-36368 the Manager server ignores SIGINT, so it normally
266
266
  # survives the group interrupt that reaches these workers.)
267
267
  with contextlib.suppress(OSError, EOFError, BrokenPipeError):
@@ -103,6 +103,9 @@ _HINT_BY_KEY: dict[tuple[type, str], str] = {
103
103
  (ConfigurationError, "k_one_for_single_conformer"): (
104
104
  "Append --k=1 to keep one conformer per molecule."
105
105
  ),
106
+ (ConfigurationError, "aimnet_rejected_input"): (
107
+ "Choose another model with --engine; 'auto3d models list' shows what is available."
108
+ ),
106
109
  }
107
110
 
108
111
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Auto3D
3
- Version: 3.2.2
3
+ Version: 3.2.3
4
4
  Summary: Generating Low-energy 3D Conformers from SMILES/SDF
5
5
  Author-email: Zhen Liu <liu5@andrew.cmu.edu>, Tetiana Zubatiuk <tetiana@zubatyuk.com>, Adrian Roitberg <roitberg@ufl.edu>, Olexandr Isayev <olexandr@olexandrisayev.com>
6
6
  Maintainer-email: Olexandr Isayev <olexandr@olexandrisayev.com>
@@ -333,7 +333,7 @@ def test_calc_spe_uses_model_factory(tmp_path, monkeypatch):
333
333
 
334
334
  def energy_batched(self, coords, numbers, charges, atom_mask=None):
335
335
  # Energy-only: calc_spe never reads forces, so it stopped asking for
336
- # them (audit M39). See tests/test_spe_energy_only.py.
336
+ # them. See tests/test_spe_energy_only.py.
337
337
  n = coords.shape[0]
338
338
  return torch.zeros(n, dtype=torch.float64)
339
339
 
@@ -226,9 +226,9 @@ class TestMaskReachesTheAdapterThroughTheStack:
226
226
  assert seen == [9, 3]
227
227
 
228
228
 
229
- # A padded batch handed over WITHOUT its mask is refused, not scored (P-M7). The
230
- # sentinel is read only to decide whether to raise -- never to build a mask, which
231
- # is the audit C13 rule the rest of this file pins. `species_pad` is 0 here, so a
229
+ # A padded batch handed over WITHOUT its mask is refused, not scored. The
230
+ # sentinel is read only to decide whether to raise -- never to build a mask,
231
+ # which is the rule the rest of this file pins. `species_pad` is 0 here, so a
232
232
  # zero slot is either padding or a dummy `*` atom and this adapter cannot tell
233
233
  # which; scoring it silently is wrong under either reading.
234
234
  def test_aimnet2_refuses_a_multi_molecule_batch_without_a_mask():