Auto3D 2.3.1__tar.gz → 3.1.0__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 (249) hide show
  1. auto3d-3.1.0/MANIFEST.in +19 -0
  2. auto3d-3.1.0/PKG-INFO +271 -0
  3. auto3d-3.1.0/README.md +211 -0
  4. auto3d-3.1.0/pyproject.toml +275 -0
  5. auto3d-3.1.0/setup.cfg +4 -0
  6. auto3d-3.1.0/src/Auto3D/__init__.py +125 -0
  7. auto3d-3.1.0/src/Auto3D/domain/__init__.py +6 -0
  8. auto3d-3.1.0/src/Auto3D/domain/clash_relief.py +103 -0
  9. auto3d-3.1.0/src/Auto3D/domain/embedding.py +229 -0
  10. auto3d-3.1.0/src/Auto3D/domain/filtering.py +391 -0
  11. auto3d-3.1.0/src/Auto3D/domain/id_mapping.py +194 -0
  12. auto3d-3.1.0/src/Auto3D/domain/ranking.py +572 -0
  13. auto3d-3.1.0/src/Auto3D/engines/__init__.py +6 -0
  14. auto3d-3.1.0/src/Auto3D/engines/batch_opt/batchopt.py +444 -0
  15. auto3d-3.1.0/src/Auto3D/engines/batch_opt/fire_optimizer.py +201 -0
  16. auto3d-3.1.0/src/Auto3D/engines/batch_opt/model_wrapper.py +336 -0
  17. auto3d-3.1.0/src/Auto3D/engines/batch_opt/optimization_engine.py +501 -0
  18. auto3d-3.1.0/src/Auto3D/engines/batch_opt/padding.py +96 -0
  19. auto3d-3.1.0/src/Auto3D/engines/isomers/__init__.py +27 -0
  20. auto3d-3.1.0/src/Auto3D/engines/isomers/base.py +47 -0
  21. auto3d-3.1.0/src/Auto3D/engines/isomers/factory.py +262 -0
  22. auto3d-3.1.0/src/Auto3D/engines/isomers/omega.py +209 -0
  23. auto3d-3.1.0/src/Auto3D/engines/isomers/rdkit_sdf.py +177 -0
  24. auto3d-3.1.0/src/Auto3D/engines/isomers/rdkit_smi.py +304 -0
  25. auto3d-3.1.0/src/Auto3D/engines/isomers/tautomers.py +146 -0
  26. auto3d-3.1.0/src/Auto3D/engines/model_factory.py +312 -0
  27. auto3d-3.1.0/src/Auto3D/engines/models/__init__.py +24 -0
  28. auto3d-3.1.0/src/Auto3D/engines/models/adapter.py +844 -0
  29. auto3d-3.1.0/src/Auto3D/engines/models/ani2xt.py +384 -0
  30. auto3d-3.1.0/src/Auto3D/engines/models/contract.py +518 -0
  31. auto3d-3.1.0/src/Auto3D/engines/models/loading.py +86 -0
  32. auto3d-3.1.0/src/Auto3D/engines/models/policy.py +142 -0
  33. auto3d-3.1.0/src/Auto3D/engines/models/preflight.py +219 -0
  34. auto3d-3.1.0/src/Auto3D/engines/models/species.py +106 -0
  35. auto3d-3.1.0/src/Auto3D/entry/ASE/geometry.py +232 -0
  36. auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/__init__.py +36 -0
  37. auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/calculator.py +341 -0
  38. auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/driver.py +708 -0
  39. auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/properties.py +338 -0
  40. auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/vibrations.py +546 -0
  41. auto3d-3.1.0/src/Auto3D/entry/SPE.py +182 -0
  42. auto3d-3.1.0/src/Auto3D/entry/__init__.py +6 -0
  43. auto3d-3.1.0/src/Auto3D/entry/auto3D.py +268 -0
  44. auto3d-3.1.0/src/Auto3D/entry/tautomer.py +168 -0
  45. auto3d-3.1.0/src/Auto3D/foundation/__init__.py +6 -0
  46. auto3d-3.1.0/src/Auto3D/foundation/config.py +685 -0
  47. auto3d-3.1.0/src/Auto3D/foundation/constants.py +168 -0
  48. auto3d-3.1.0/src/Auto3D/foundation/exceptions.py +144 -0
  49. auto3d-3.1.0/src/Auto3D/foundation/registry.py +124 -0
  50. auto3d-3.1.0/src/Auto3D/foundation/results.py +82 -0
  51. auto3d-3.1.0/src/Auto3D/foundation/torch_config.py +161 -0
  52. auto3d-3.1.0/src/Auto3D/foundation/utils/__init__.py +60 -0
  53. auto3d-3.1.0/src/Auto3D/foundation/utils/atomic_io.py +102 -0
  54. auto3d-3.1.0/src/Auto3D/foundation/utils/connectivity.py +210 -0
  55. auto3d-3.1.0/src/Auto3D/foundation/utils/convergence.py +100 -0
  56. auto3d-3.1.0/src/Auto3D/foundation/utils/energy.py +371 -0
  57. auto3d-3.1.0/src/Auto3D/foundation/utils/geometry.py +112 -0
  58. auto3d-3.1.0/src/Auto3D/foundation/utils/logging_config.py +67 -0
  59. auto3d-3.1.0/src/Auto3D/foundation/utils/molprops.py +75 -0
  60. auto3d-3.1.0/src/Auto3D/foundation/utils/output_guard.py +157 -0
  61. auto3d-3.1.0/src/Auto3D/foundation/utils/reconciliation.py +171 -0
  62. auto3d-3.1.0/src/Auto3D/foundation/utils/sdf_io.py +207 -0
  63. auto3d-3.1.0/src/Auto3D/foundation/utils/smi_io.py +254 -0
  64. auto3d-3.1.0/src/Auto3D/foundation/utils/stereo_check.py +166 -0
  65. auto3d-3.1.0/src/Auto3D/foundation/utils/stereochemistry.py +566 -0
  66. auto3d-3.1.0/src/Auto3D/orchestration/__init__.py +6 -0
  67. auto3d-3.1.0/src/Auto3D/orchestration/chunk_manager.py +309 -0
  68. auto3d-3.1.0/src/Auto3D/orchestration/job_layout.py +125 -0
  69. auto3d-3.1.0/src/Auto3D/orchestration/pipeline/__init__.py +7 -0
  70. auto3d-3.1.0/src/Auto3D/orchestration/pipeline/input_checks.py +408 -0
  71. auto3d-3.1.0/src/Auto3D/orchestration/processors.py +56 -0
  72. auto3d-3.1.0/src/Auto3D/orchestration/workflow.py +672 -0
  73. auto3d-3.1.0/src/Auto3D/orchestration/workflow_workers.py +365 -0
  74. auto3d-3.1.0/src/Auto3D/presentation/__init__.py +6 -0
  75. auto3d-3.1.0/src/Auto3D/presentation/auto3Dcli.py +212 -0
  76. auto3d-3.1.0/src/Auto3D/presentation/cli/__init__.py +14 -0
  77. auto3d-3.1.0/src/Auto3D/presentation/cli/app.py +644 -0
  78. auto3d-3.1.0/src/Auto3D/presentation/cli/commands/__init__.py +1 -0
  79. auto3d-3.1.0/src/Auto3D/presentation/cli/commands/config.py +244 -0
  80. auto3d-3.1.0/src/Auto3D/presentation/cli/commands/models.py +322 -0
  81. auto3d-3.1.0/src/Auto3D/presentation/cli/commands/properties.py +278 -0
  82. auto3d-3.1.0/src/Auto3D/presentation/cli/commands/run.py +349 -0
  83. auto3d-3.1.0/src/Auto3D/presentation/cli/commands/validate.py +242 -0
  84. auto3d-3.1.0/src/Auto3D/presentation/cli/config_schema.py +240 -0
  85. auto3d-3.1.0/src/Auto3D/presentation/cli/console.py +268 -0
  86. auto3d-3.1.0/src/Auto3D/presentation/cli/errors.py +252 -0
  87. auto3d-3.1.0/src/Auto3D/presentation/cli/progress.py +115 -0
  88. auto3d-3.1.0/src/Auto3D/presentation/cli/results.py +134 -0
  89. auto3d-3.1.0/src/Auto3D.egg-info/PKG-INFO +271 -0
  90. auto3d-3.1.0/src/Auto3D.egg-info/SOURCES.txt +202 -0
  91. auto3d-3.1.0/src/Auto3D.egg-info/entry_points.txt +2 -0
  92. auto3d-3.1.0/src/Auto3D.egg-info/requires.txt +36 -0
  93. auto3d-3.1.0/tests/test_SPE.py +345 -0
  94. auto3d-3.1.0/tests/test_adapter_atom_mask.py +205 -0
  95. auto3d-3.1.0/tests/test_adapter_fp64_contract.py +118 -0
  96. auto3d-3.1.0/tests/test_ani2xt_atom_energies.py +374 -0
  97. auto3d-3.1.0/tests/test_ase_geometry.py +76 -0
  98. auto3d-3.1.0/tests/test_ase_torch_config.py +39 -0
  99. auto3d-3.1.0/tests/test_atomic_io.py +259 -0
  100. auto3d-3.1.0/tests/test_auto3D.py +642 -0
  101. auto3d-3.1.0/tests/test_auto3Dcli.py +99 -0
  102. auto3d-3.1.0/tests/test_batchopt.py +389 -0
  103. auto3d-3.1.0/tests/test_chunk_manager.py +827 -0
  104. auto3d-3.1.0/tests/test_cli.py +472 -0
  105. auto3d-3.1.0/tests/test_cli_app.py +1129 -0
  106. auto3d-3.1.0/tests/test_cli_commands_config.py +27 -0
  107. auto3d-3.1.0/tests/test_cli_config_schema.py +543 -0
  108. auto3d-3.1.0/tests/test_cli_console.py +80 -0
  109. auto3d-3.1.0/tests/test_cli_errors.py +355 -0
  110. auto3d-3.1.0/tests/test_cli_exit_codes.py +702 -0
  111. auto3d-3.1.0/tests/test_cli_models_command.py +102 -0
  112. auto3d-3.1.0/tests/test_cli_property_commands.py +652 -0
  113. auto3d-3.1.0/tests/test_cli_results.py +135 -0
  114. auto3d-3.1.0/tests/test_cli_security.py +165 -0
  115. auto3d-3.1.0/tests/test_config.py +514 -0
  116. auto3d-3.1.0/tests/test_config_parity.py +488 -0
  117. auto3d-3.1.0/tests/test_conftest_isolation_guards.py +134 -0
  118. auto3d-3.1.0/tests/test_custom_nnp_contract.py +804 -0
  119. auto3d-3.1.0/tests/test_custom_nnp_eager.py +109 -0
  120. auto3d-3.1.0/tests/test_durability.py +1227 -0
  121. auto3d-3.1.0/tests/test_e_tot_units.py +221 -0
  122. auto3d-3.1.0/tests/test_element_sets.py +133 -0
  123. auto3d-3.1.0/tests/test_embed_params.py +100 -0
  124. auto3d-3.1.0/tests/test_filtering.py +778 -0
  125. auto3d-3.1.0/tests/test_filtering_thermo_failed.py +96 -0
  126. auto3d-3.1.0/tests/test_fire_optimizer.py +458 -0
  127. auto3d-3.1.0/tests/test_helpers_pipeline_output.py +761 -0
  128. auto3d-3.1.0/tests/test_hessian_invocation_contract.py +325 -0
  129. auto3d-3.1.0/tests/test_id_mapping.py +204 -0
  130. auto3d-3.1.0/tests/test_import_boundaries.py +1003 -0
  131. auto3d-3.1.0/tests/test_isomer_engine.py +356 -0
  132. auto3d-3.1.0/tests/test_isomer_engine_hardening.py +532 -0
  133. auto3d-3.1.0/tests/test_isomers.py +489 -0
  134. auto3d-3.1.0/tests/test_job_layout.py +148 -0
  135. auto3d-3.1.0/tests/test_layer_boundaries.py +241 -0
  136. auto3d-3.1.0/tests/test_lazy_torchani_import.py +63 -0
  137. auto3d-3.1.0/tests/test_legacy_yaml_parity.py +141 -0
  138. auto3d-3.1.0/tests/test_logging_config.py +169 -0
  139. auto3d-3.1.0/tests/test_model_adapter.py +769 -0
  140. auto3d-3.1.0/tests/test_model_caching.py +108 -0
  141. auto3d-3.1.0/tests/test_model_factory.py +429 -0
  142. auto3d-3.1.0/tests/test_model_preflight.py +477 -0
  143. auto3d-3.1.0/tests/test_model_wrapper.py +406 -0
  144. auto3d-3.1.0/tests/test_mp_start_method.py +110 -0
  145. auto3d-3.1.0/tests/test_notebook_properties.py +121 -0
  146. auto3d-3.1.0/tests/test_optimization_engine.py +658 -0
  147. auto3d-3.1.0/tests/test_optimization_engine_indexing.py +900 -0
  148. auto3d-3.1.0/tests/test_optimization_engine_validation.py +163 -0
  149. auto3d-3.1.0/tests/test_output_overwrite_gates.py +290 -0
  150. auto3d-3.1.0/tests/test_packaging_metadata.py +199 -0
  151. auto3d-3.1.0/tests/test_padding.py +270 -0
  152. auto3d-3.1.0/tests/test_padding_invariance.py +81 -0
  153. auto3d-3.1.0/tests/test_parallel_embed.py +263 -0
  154. auto3d-3.1.0/tests/test_pipeline_e2e.py +340 -0
  155. auto3d-3.1.0/tests/test_processors.py +140 -0
  156. auto3d-3.1.0/tests/test_progress.py +330 -0
  157. auto3d-3.1.0/tests/test_public_api.py +67 -0
  158. auto3d-3.1.0/tests/test_ranking.py +1268 -0
  159. auto3d-3.1.0/tests/test_ranking_by_gibbs.py +187 -0
  160. auto3d-3.1.0/tests/test_registry.py +108 -0
  161. auto3d-3.1.0/tests/test_results.py +45 -0
  162. auto3d-3.1.0/tests/test_sdf_isomer_enumeration.py +202 -0
  163. auto3d-3.1.0/tests/test_smiles_stereo_warning.py +179 -0
  164. auto3d-3.1.0/tests/test_spe_energy_only.py +480 -0
  165. auto3d-3.1.0/tests/test_species_conversion.py +147 -0
  166. auto3d-3.1.0/tests/test_species_module.py +227 -0
  167. auto3d-3.1.0/tests/test_stereo_identity.py +242 -0
  168. auto3d-3.1.0/tests/test_stereo_postopt.py +220 -0
  169. auto3d-3.1.0/tests/test_stereochemistry_validation.py +231 -0
  170. auto3d-3.1.0/tests/test_suite_hygiene.py +121 -0
  171. {auto3d-2.3.1 → auto3d-3.1.0}/tests/test_tauto.py +46 -23
  172. auto3d-3.1.0/tests/test_tautomer_select.py +108 -0
  173. auto3d-3.1.0/tests/test_tautomer_stereo.py +128 -0
  174. auto3d-3.1.0/tests/test_thermo.py +584 -0
  175. auto3d-3.1.0/tests/test_thermo_etot_sync.py +146 -0
  176. auto3d-3.1.0/tests/test_thermo_helpers.py +1855 -0
  177. auto3d-3.1.0/tests/test_thermo_imaginary_mode_inversion.py +529 -0
  178. auto3d-3.1.0/tests/test_thermo_projection.py +392 -0
  179. auto3d-3.1.0/tests/test_thermo_record_assertions.py +85 -0
  180. auto3d-3.1.0/tests/test_thermo_reference.py +243 -0
  181. auto3d-3.1.0/tests/test_thermo_relative_energies.py +360 -0
  182. auto3d-3.1.0/tests/test_thermo_transition_state.py +191 -0
  183. auto3d-3.1.0/tests/test_torch_config.py +306 -0
  184. {auto3d-2.3.1 → auto3d-3.1.0}/tests/test_utils.py +30 -20
  185. auto3d-3.1.0/tests/test_utils_connectivity.py +219 -0
  186. auto3d-3.1.0/tests/test_utils_energy_constants.py +67 -0
  187. auto3d-3.1.0/tests/test_utils_geometry.py +143 -0
  188. auto3d-3.1.0/tests/test_utils_molprops.py +109 -0
  189. auto3d-3.1.0/tests/test_utils_reconciliation.py +245 -0
  190. auto3d-3.1.0/tests/test_utils_sdf_io.py +315 -0
  191. auto3d-3.1.0/tests/test_utils_smi_io.py +363 -0
  192. auto3d-3.1.0/tests/test_utils_stereochemistry.py +555 -0
  193. auto3d-3.1.0/tests/test_utils_validation.py +267 -0
  194. auto3d-3.1.0/tests/test_validate_run_parity.py +124 -0
  195. auto3d-3.1.0/tests/test_validation.py +303 -0
  196. auto3d-3.1.0/tests/test_validation_errors.py +207 -0
  197. auto3d-3.1.0/tests/test_workflow.py +1108 -0
  198. auto3d-2.3.1/MANIFEST.in +0 -3
  199. auto3d-2.3.1/PKG-INFO +0 -35
  200. auto3d-2.3.1/README.md +0 -16
  201. auto3d-2.3.1/pyproject.toml +0 -3
  202. auto3d-2.3.1/setup.cfg +0 -39
  203. auto3d-2.3.1/src/Auto3D/.gitignore +0 -18
  204. auto3d-2.3.1/src/Auto3D/ASE/__pycache__/__init__.cpython-39.pyc +0 -0
  205. auto3d-2.3.1/src/Auto3D/ASE/__pycache__/geometry.cpython-39.pyc +0 -0
  206. auto3d-2.3.1/src/Auto3D/ASE/__pycache__/thermo.cpython-39.pyc +0 -0
  207. auto3d-2.3.1/src/Auto3D/ASE/geometry.py +0 -72
  208. auto3d-2.3.1/src/Auto3D/ASE/thermo.py +0 -327
  209. auto3d-2.3.1/src/Auto3D/SPE.py +0 -112
  210. auto3d-2.3.1/src/Auto3D/__init__.py +0 -26
  211. auto3d-2.3.1/src/Auto3D/__pycache__/SPE.cpython-39.pyc +0 -0
  212. auto3d-2.3.1/src/Auto3D/__pycache__/__init__.cpython-39.pyc +0 -0
  213. auto3d-2.3.1/src/Auto3D/__pycache__/auto3D.cpython-39.pyc +0 -0
  214. auto3d-2.3.1/src/Auto3D/__pycache__/auto3Dcli.cpython-39.pyc +0 -0
  215. auto3d-2.3.1/src/Auto3D/__pycache__/isomer_engine.cpython-39.pyc +0 -0
  216. auto3d-2.3.1/src/Auto3D/__pycache__/ranking.cpython-39.pyc +0 -0
  217. auto3d-2.3.1/src/Auto3D/__pycache__/tautomer.cpython-39.pyc +0 -0
  218. auto3d-2.3.1/src/Auto3D/__pycache__/utils.cpython-39.pyc +0 -0
  219. auto3d-2.3.1/src/Auto3D/__pycache__/utils_file.cpython-39.pyc +0 -0
  220. auto3d-2.3.1/src/Auto3D/auto3D.py +0 -520
  221. auto3d-2.3.1/src/Auto3D/auto3Dcli.py +0 -170
  222. auto3d-2.3.1/src/Auto3D/batch_opt/ANI2xt_no_rep.py +0 -126
  223. auto3d-2.3.1/src/Auto3D/batch_opt/ANI2xt_rep.py +0 -127
  224. auto3d-2.3.1/src/Auto3D/batch_opt/__pycache__/ANI2xt_no_rep.cpython-39.pyc +0 -0
  225. auto3d-2.3.1/src/Auto3D/batch_opt/__pycache__/__init__.cpython-39.pyc +0 -0
  226. auto3d-2.3.1/src/Auto3D/batch_opt/__pycache__/batchopt.cpython-39.pyc +0 -0
  227. auto3d-2.3.1/src/Auto3D/batch_opt/batchopt.py +0 -447
  228. auto3d-2.3.1/src/Auto3D/isomer_engine.py +0 -368
  229. auto3d-2.3.1/src/Auto3D/models/aimnet2_wb97m-d3_0.jpt +0 -0
  230. auto3d-2.3.1/src/Auto3D/models/aimnet2_wb97m_ens_f.jpt +0 -0
  231. auto3d-2.3.1/src/Auto3D/ranking.py +0 -170
  232. auto3d-2.3.1/src/Auto3D/tautomer.py +0 -83
  233. auto3d-2.3.1/src/Auto3D/utils.py +0 -706
  234. auto3d-2.3.1/src/Auto3D/utils_file.py +0 -320
  235. auto3d-2.3.1/src/Auto3D.egg-info/PKG-INFO +0 -35
  236. auto3d-2.3.1/src/Auto3D.egg-info/SOURCES.txt +0 -53
  237. auto3d-2.3.1/src/Auto3D.egg-info/entry_points.txt +0 -2
  238. auto3d-2.3.1/src/Auto3D.egg-info/requires.txt +0 -4
  239. auto3d-2.3.1/tests/test_SPE.py +0 -190
  240. auto3d-2.3.1/tests/test_auto3D.py +0 -371
  241. auto3d-2.3.1/tests/test_isomer_engine.py +0 -91
  242. auto3d-2.3.1/tests/test_thermo.py +0 -299
  243. {auto3d-2.3.1 → auto3d-3.1.0}/LICENSE +0 -0
  244. {auto3d-2.3.1/src/Auto3D/ASE → auto3d-3.1.0/src/Auto3D/engines/batch_opt}/__init__.py +0 -0
  245. {auto3d-2.3.1/src/Auto3D → auto3d-3.1.0/src/Auto3D/engines}/models/ani2xt_no_repulsion.pt +0 -0
  246. {auto3d-2.3.1/src/Auto3D/batch_opt → auto3d-3.1.0/src/Auto3D/entry/ASE}/__init__.py +0 -0
  247. /auto3d-2.3.1/src/Auto3D/models/__init__.py → /auto3d-3.1.0/src/Auto3D/py.typed +0 -0
  248. {auto3d-2.3.1 → auto3d-3.1.0}/src/Auto3D.egg-info/dependency_links.txt +0 -0
  249. {auto3d-2.3.1 → auto3d-3.1.0}/src/Auto3D.egg-info/top_level.txt +0 -0
@@ -0,0 +1,19 @@
1
+ graft src/Auto3D
2
+
3
+ # `graft` is recursive and unconditional, so without these the sdist and wheel
4
+ # pick up whatever the build tree happens to contain. Building in a checkout
5
+ # that has been used -- which is every real build -- put 69 __pycache__/*.pyc
6
+ # files into the first 3.0.0 wheel: CPython 3.13 bytecode shipped inside a
7
+ # py3-none-any wheel, stale for any other interpreter and pure bloat for this
8
+ # one. Bytecode is generated at install time; it never belongs in a
9
+ # distribution.
10
+ global-exclude *.py[cod]
11
+ global-exclude __pycache__/*
12
+
13
+ # `src/Auto3D/.gitignore` is a repository file that `graft` swept into the
14
+ # 3.0.0 wheel (verified against the artifact: entry `Auto3D/.gitignore`). It
15
+ # was the only non-Python payload there besides the bundled ANI2xt weights, and
16
+ # an installed package telling anyone that it ignores `*.sdf` is meaningless at
17
+ # best. It stays in the repo -- it still carries patterns the root .gitignore
18
+ # does not -- it just stops being shipped.
19
+ global-exclude .gitignore
auto3d-3.1.0/PKG-INFO ADDED
@@ -0,0 +1,271 @@
1
+ Metadata-Version: 2.4
2
+ Name: Auto3D
3
+ Version: 3.1.0
4
+ Summary: Generating Low-energy 3D Conformers from SMILES/SDF
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
+ Maintainer-email: Olexandr Isayev <olexandr@olexandrisayev.com>
7
+ License: MIT
8
+ Project-URL: Homepage, https://github.com/isayevlab/Auto3D_pkg
9
+ Project-URL: Documentation, https://auto3d.readthedocs.io
10
+ Project-URL: Repository, https://github.com/isayevlab/Auto3D_pkg
11
+ Project-URL: Bug Tracker, https://github.com/isayevlab/Auto3D_pkg/issues
12
+ Project-URL: Changelog, https://github.com/isayevlab/Auto3D_pkg/releases
13
+ Keywords: chemistry,molecular-dynamics,conformer-generation,neural-network-potentials,cheminformatics,drug-discovery
14
+ Classifier: Development Status :: 5 - Production/Stable
15
+ Classifier: Intended Audience :: Science/Research
16
+ Classifier: License :: OSI Approved :: MIT License
17
+ Classifier: Operating System :: OS Independent
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Topic :: Scientific/Engineering :: Chemistry
23
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
24
+ Classifier: Typing :: Typed
25
+ Requires-Python: >=3.11
26
+ Description-Content-Type: text/markdown
27
+ License-File: LICENSE
28
+ Requires-Dist: tqdm>=4.60.0
29
+ Requires-Dist: psutil>=5.8.0
30
+ Requires-Dist: Send2Trash>=1.8.0
31
+ Requires-Dist: pyyaml>=6.0
32
+ Requires-Dist: numpy>=1.21.0
33
+ Requires-Dist: pandas>=1.3.0
34
+ Requires-Dist: rdkit>=2022.9.5
35
+ Requires-Dist: torch>=2.8
36
+ Requires-Dist: aimnet>=0.2
37
+ Requires-Dist: requests>=2.32.3
38
+ Requires-Dist: typer>=0.12.0
39
+ Requires-Dist: rich>=13.0.0
40
+ Requires-Dist: pydantic>=2.0
41
+ Provides-Extra: ani
42
+ Requires-Dist: torchani>=2.8; extra == "ani"
43
+ Provides-Extra: ase
44
+ Requires-Dist: ase>=3.23.0; extra == "ase"
45
+ Provides-Extra: dev
46
+ Requires-Dist: pytest>=7.0; extra == "dev"
47
+ Requires-Dist: pytest-cov>=4.0; extra == "dev"
48
+ Requires-Dist: mypy>=1.0; extra == "dev"
49
+ Requires-Dist: types-requests; extra == "dev"
50
+ Requires-Dist: ruff==0.15.9; extra == "dev"
51
+ Requires-Dist: pre-commit>=3.0; extra == "dev"
52
+ Provides-Extra: docs
53
+ Requires-Dist: sphinx>=7.0; extra == "docs"
54
+ Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
55
+ Requires-Dist: nbsphinx>=0.9.0; extra == "docs"
56
+ Requires-Dist: myst-parser>=2.0; extra == "docs"
57
+ Provides-Extra: all
58
+ Requires-Dist: Auto3D[ani,ase,dev,docs]; extra == "all"
59
+ Dynamic: license-file
60
+
61
+ # **Auto3D**
62
+
63
+ [![PyPI](https://img.shields.io/pypi/v/Auto3D)](https://pypi.org/project/Auto3D/)
64
+ [![PyPI - Downloads](https://img.shields.io/pypi/dm/Auto3D)](https://pypi.org/project/Auto3D/)
65
+ [![Docs](https://img.shields.io/readthedocs/auto3d)](https://auto3d.readthedocs.io/)
66
+ [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
67
+ [![PyPI - License](https://img.shields.io/pypi/l/Auto3D)](https://github.com/isayevlab/Auto3D_pkg/blob/main/LICENSE)
68
+
69
+ ![auto3d-white](https://github.com/user-attachments/assets/3184d31b-fb21-42d5-a1e0-611ccbf66ad2)
70
+
71
+ **SMILES in, low-energy 3D conformers out.** Auto3D enumerates tautomers and
72
+ stereoisomers, embeds and optimizes them with a neural network potential
73
+ (AIMNet2, ANI2x, ANI2xt), removes duplicates, and ranks what is left by energy —
74
+ in one command, or one function call.
75
+
76
+ ```bash
77
+ pip install Auto3D
78
+ auto3d run molecules.smi --k=1
79
+ ```
80
+
81
+ That writes `molecules_<timestamp>/molecules_out.sdf`: the lowest-energy
82
+ conformer per input molecule, each carrying its energy.
83
+
84
+ ---
85
+
86
+ ## Installation
87
+
88
+ ```bash
89
+ pip install Auto3D # core: AIMNet2 engines
90
+ pip install "Auto3D[ani,ase]" # + torchani (ANI2x/ANI2xt) and ase (thermochemistry)
91
+ ```
92
+
93
+ Requires **Python ≥ 3.11** and **PyTorch ≥ 2.8**. For GPU acceleration, install a
94
+ CUDA-enabled PyTorch build first. AIMNet2 weights download to `~/.cache/aimnet`
95
+ on first use, so the first run needs network access.
96
+
97
+ <details>
98
+ <summary><b>Using conda?</b> Install Auto3D itself with pip, even inside a conda env.</summary>
99
+
100
+ <br>
101
+
102
+ `conda install -c conda-forge auto3d` installs **2.3.0**, not 3.1.0. conda-forge
103
+ requires every dependency to be a conda package, and `aimnet` — a core dependency
104
+ since 3.0.0 — is not one yet, nor is its own dependency `nvalchemi-toolkit-ops`.
105
+
106
+ Auto3D works fine *inside* a conda environment; it is only the conda **package**
107
+ that lags. `installation.yml` sets up the supported combination:
108
+
109
+ ```bash
110
+ conda env create --file installation.yml --name auto3D
111
+ conda activate auto3D # pip installs Auto3D[ani,ase] into it
112
+ ```
113
+
114
+ Details and the path forward: [Building the conda package](https://auto3d.readthedocs.io/en/latest/howto/conda_build.html).
115
+
116
+ </details>
117
+
118
+ ## Quick start
119
+
120
+ **Command line**
121
+
122
+ ```bash
123
+ auto3d run molecules.smi --k=5 # top-5 conformers per molecule
124
+ auto3d run molecules.smi --window=3.0 # or everything within 3 kcal/mol
125
+ auto3d run molecules.smi --k=5 --no-gpu # CPU only
126
+ ```
127
+
128
+ Exactly one of `--k` or `--window` is required. GPU is used by default, and
129
+ requesting it with no visible CUDA device is a **fatal error, not a fallback** —
130
+ pass `--no-gpu` on a CPU-only machine.
131
+
132
+ **Python**
133
+
134
+ ```python
135
+ from Auto3D import Auto3DOptions, main
136
+
137
+ config = Auto3DOptions(path="molecules.smi", k=1)
138
+ output_path = main(config)
139
+ ```
140
+
141
+ `main()` returns a `WorkflowResult`, which *is* the output path (it subclasses
142
+ `str`) and also carries `n_molecules`, `n_conformers`, and `failures`.
143
+
144
+ For batches of ≤150 molecules, skip the job directory and get RDKit molecules
145
+ straight back:
146
+
147
+ ```python
148
+ from Auto3D import Auto3DOptions, smiles2mols
149
+
150
+ mols = smiles2mols(["CCO", "CCCO", "c1ccccc1"], Auto3DOptions(k=1, use_gpu=False))
151
+ for mol in mols:
152
+ print(mol.GetProp("_Name"), mol.GetProp("E_tot"), "Hartree")
153
+ ```
154
+
155
+ ## What you get
156
+
157
+ A run creates `<stem>_<timestamp>/` next to the input, containing the output SDF
158
+ and an `Auto3D.log`. Each conformer in the SDF carries:
159
+
160
+ | Property | Meaning |
161
+ |---|---|
162
+ | `E_tot` / `E_tot(Hartree)` | Total energy, Hartree |
163
+ | `E_rel(kcal/mol)` | Energy relative to the best conformer of that molecule |
164
+ | `_Name`, `ID` | Molecule name and a stable identifier |
165
+ | `fmax`, `Converged`, `Dropped_Oscillating` | Optimizer diagnostics |
166
+
167
+ The input SMILES is **not** written to the output — join on `_Name`/`ID` against
168
+ your input file.
169
+
170
+ ## Beyond conformer generation
171
+
172
+ Each of these wraps a Python API function and has a matching notebook in
173
+ [`example/`](example/).
174
+
175
+ | Command | Does | Python API |
176
+ |---|---|---|
177
+ | `auto3d run` | Generate conformers from SMILES/SDF | `main`, `smiles2mols` |
178
+ | `auto3d energy` | Single-point energy for an SDF | `calc_spe` |
179
+ | `auto3d optimize` | Geometry-optimize an existing SDF | `opt_geometry` |
180
+ | `auto3d thermo` | Enthalpy / entropy / Gibbs (needs `ase`) | `calc_thermo` |
181
+ | `auto3d tautomers` | Enumerate and rank stable tautomers | `get_stable_tautomers` |
182
+ | `auto3d validate` | Check an input file without running | — |
183
+ | `auto3d config init\|show\|validate` | Manage YAML configs | — |
184
+ | `auto3d models list\|info\|test` | Inspect and smoke-test engines | — |
185
+
186
+ All commands except `models list` take `-v/--verbose`, the only way to get a
187
+ traceback. `--json` is available on `run`, `validate`, and the four property
188
+ commands. Exit codes: `0` success, `2` config/input error, `4` GPU requested but
189
+ unavailable, `6` partial success, `130` interrupted.
190
+
191
+ ## Engines
192
+
193
+ | Engine | Networks/step | Elements |
194
+ |---|---|---|
195
+ | **AIMNET** (default) | 1 | H, B, C, N, O, F, Si, P, S, Cl, As, Se, Br, I |
196
+ | **aimnet2-2025**, **aimnet2-nse**, **aimnet2-pd**, … | 1 | as above (`aimnet2-pd` swaps As for Pd) |
197
+ | **ANI2x** | 8 (ensemble) | H, C, N, O, F, S, Cl |
198
+ | **ANI2xt** | 1 | H, C, N, O, F, S, Cl |
199
+
200
+ Select with `--engine` or `optimizing_engine`. AIMNet2 models come from the
201
+ [`aimnet`](https://github.com/isayevlab/aimnetcentral) package and are
202
+ sha256-validated on download; `auto3d models list` shows what is available.
203
+ `optimizing_engine` also accepts a path to a
204
+ [custom NNP](https://auto3d.readthedocs.io/en/latest/howto/custom_nnp.html).
205
+
206
+ No engine speed benchmark is maintained in this repository, so the table reports
207
+ how many networks each engine evaluates per step rather than a speed ranking.
208
+ Time your own workload before choosing.
209
+
210
+ ## Key parameters
211
+
212
+ | Parameter | Default | Description |
213
+ |---|---|---|
214
+ | `k` | — | Top-k conformers per molecule |
215
+ | `window` | — | Energy window, kcal/mol — exactly one of `k`/`window` is required |
216
+ | `optimizing_engine` | `AIMNET` | Engine name, registry name, or path to a custom model |
217
+ | `use_gpu` | `True` | GPU acceleration; missing CUDA device is fatal, not a fallback |
218
+ | `gpu_idx` | `0` | CUDA index, or a list for multi-GPU |
219
+ | `enumerate_tautomer` | `False` | Enumerate tautomers |
220
+ | `enumerate_isomer` | `True` | Enumerate stereoisomers |
221
+ | `threshold` | `0.3` | RMSD threshold for duplicate removal, Å |
222
+ | `opt_steps` | `2000` | Maximum optimization steps |
223
+ | `convergence_threshold` | `0.01` | Force convergence threshold, eV/Å |
224
+
225
+ Full list: [CLI reference](https://auto3d.readthedocs.io/en/latest/cli.html) ·
226
+ [API reference](https://auto3d.readthedocs.io/en/latest/api.html)
227
+
228
+ ## Upgrading from 2.x
229
+
230
+ AIMNet2 is now served by the `aimnet` package rather than bundled `.jpt` files,
231
+ and the default AIMNet2 energies differ from 2.x (the registry `.pt` externalizes
232
+ D3 dispersion), so conformer rankings may shift slightly. The thermochemistry SDF
233
+ property `S_hartree` is now `S_hartree_per_K`. Python ≥ 3.11 and PyTorch ≥ 2.8 are
234
+ required. See the [migration guide](https://auto3d.readthedocs.io/en/latest/migration.html).
235
+
236
+ ## Documentation
237
+
238
+ [**auto3d.readthedocs.io**](https://auto3d.readthedocs.io/) ·
239
+ [Installation](https://auto3d.readthedocs.io/en/latest/installation.html) ·
240
+ [Quickstart](https://auto3d.readthedocs.io/en/latest/howto/quickstart.html) ·
241
+ [CLI](https://auto3d.readthedocs.io/en/latest/cli.html) ·
242
+ [API](https://auto3d.readthedocs.io/en/latest/api.html) ·
243
+ [Custom NNPs](https://auto3d.readthedocs.io/en/latest/howto/custom_nnp.html) ·
244
+ [Troubleshooting](https://auto3d.readthedocs.io/en/latest/howto/troubleshooting.html) ·
245
+ [Notebooks](example/)
246
+
247
+ ## Citation
248
+
249
+ ```bibtex
250
+ @article{liu2022auto3d,
251
+ title={Auto3D: Automatic generation of the low-energy 3D structures with ANI neural network potentials},
252
+ author={Liu, Zhen and Zubatiuk, Tetiana and Roitberg, Adrian and Isayev, Olexandr},
253
+ journal={Journal of Chemical Information and Modeling},
254
+ volume={62},
255
+ number={22},
256
+ pages={5373--5382},
257
+ year={2022},
258
+ publisher={ACS Publications},
259
+ doi={10.1021/acs.jcim.2c00817}
260
+ }
261
+ ```
262
+
263
+ ## Contributing
264
+
265
+ [Issues](https://github.com/isayevlab/Auto3D_pkg/issues) ·
266
+ [Discussions](https://github.com/isayevlab/Auto3D_pkg/discussions) ·
267
+ [CONTRIBUTING.md](CONTRIBUTING.md)
268
+
269
+ ## License
270
+
271
+ MIT — see [LICENSE](LICENSE).
auto3d-3.1.0/README.md ADDED
@@ -0,0 +1,211 @@
1
+ # **Auto3D**
2
+
3
+ [![PyPI](https://img.shields.io/pypi/v/Auto3D)](https://pypi.org/project/Auto3D/)
4
+ [![PyPI - Downloads](https://img.shields.io/pypi/dm/Auto3D)](https://pypi.org/project/Auto3D/)
5
+ [![Docs](https://img.shields.io/readthedocs/auto3d)](https://auto3d.readthedocs.io/)
6
+ [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
7
+ [![PyPI - License](https://img.shields.io/pypi/l/Auto3D)](https://github.com/isayevlab/Auto3D_pkg/blob/main/LICENSE)
8
+
9
+ ![auto3d-white](https://github.com/user-attachments/assets/3184d31b-fb21-42d5-a1e0-611ccbf66ad2)
10
+
11
+ **SMILES in, low-energy 3D conformers out.** Auto3D enumerates tautomers and
12
+ stereoisomers, embeds and optimizes them with a neural network potential
13
+ (AIMNet2, ANI2x, ANI2xt), removes duplicates, and ranks what is left by energy —
14
+ in one command, or one function call.
15
+
16
+ ```bash
17
+ pip install Auto3D
18
+ auto3d run molecules.smi --k=1
19
+ ```
20
+
21
+ That writes `molecules_<timestamp>/molecules_out.sdf`: the lowest-energy
22
+ conformer per input molecule, each carrying its energy.
23
+
24
+ ---
25
+
26
+ ## Installation
27
+
28
+ ```bash
29
+ pip install Auto3D # core: AIMNet2 engines
30
+ pip install "Auto3D[ani,ase]" # + torchani (ANI2x/ANI2xt) and ase (thermochemistry)
31
+ ```
32
+
33
+ Requires **Python ≥ 3.11** and **PyTorch ≥ 2.8**. For GPU acceleration, install a
34
+ CUDA-enabled PyTorch build first. AIMNet2 weights download to `~/.cache/aimnet`
35
+ on first use, so the first run needs network access.
36
+
37
+ <details>
38
+ <summary><b>Using conda?</b> Install Auto3D itself with pip, even inside a conda env.</summary>
39
+
40
+ <br>
41
+
42
+ `conda install -c conda-forge auto3d` installs **2.3.0**, not 3.1.0. conda-forge
43
+ requires every dependency to be a conda package, and `aimnet` — a core dependency
44
+ since 3.0.0 — is not one yet, nor is its own dependency `nvalchemi-toolkit-ops`.
45
+
46
+ Auto3D works fine *inside* a conda environment; it is only the conda **package**
47
+ that lags. `installation.yml` sets up the supported combination:
48
+
49
+ ```bash
50
+ conda env create --file installation.yml --name auto3D
51
+ conda activate auto3D # pip installs Auto3D[ani,ase] into it
52
+ ```
53
+
54
+ Details and the path forward: [Building the conda package](https://auto3d.readthedocs.io/en/latest/howto/conda_build.html).
55
+
56
+ </details>
57
+
58
+ ## Quick start
59
+
60
+ **Command line**
61
+
62
+ ```bash
63
+ auto3d run molecules.smi --k=5 # top-5 conformers per molecule
64
+ auto3d run molecules.smi --window=3.0 # or everything within 3 kcal/mol
65
+ auto3d run molecules.smi --k=5 --no-gpu # CPU only
66
+ ```
67
+
68
+ Exactly one of `--k` or `--window` is required. GPU is used by default, and
69
+ requesting it with no visible CUDA device is a **fatal error, not a fallback** —
70
+ pass `--no-gpu` on a CPU-only machine.
71
+
72
+ **Python**
73
+
74
+ ```python
75
+ from Auto3D import Auto3DOptions, main
76
+
77
+ config = Auto3DOptions(path="molecules.smi", k=1)
78
+ output_path = main(config)
79
+ ```
80
+
81
+ `main()` returns a `WorkflowResult`, which *is* the output path (it subclasses
82
+ `str`) and also carries `n_molecules`, `n_conformers`, and `failures`.
83
+
84
+ For batches of ≤150 molecules, skip the job directory and get RDKit molecules
85
+ straight back:
86
+
87
+ ```python
88
+ from Auto3D import Auto3DOptions, smiles2mols
89
+
90
+ mols = smiles2mols(["CCO", "CCCO", "c1ccccc1"], Auto3DOptions(k=1, use_gpu=False))
91
+ for mol in mols:
92
+ print(mol.GetProp("_Name"), mol.GetProp("E_tot"), "Hartree")
93
+ ```
94
+
95
+ ## What you get
96
+
97
+ A run creates `<stem>_<timestamp>/` next to the input, containing the output SDF
98
+ and an `Auto3D.log`. Each conformer in the SDF carries:
99
+
100
+ | Property | Meaning |
101
+ |---|---|
102
+ | `E_tot` / `E_tot(Hartree)` | Total energy, Hartree |
103
+ | `E_rel(kcal/mol)` | Energy relative to the best conformer of that molecule |
104
+ | `_Name`, `ID` | Molecule name and a stable identifier |
105
+ | `fmax`, `Converged`, `Dropped_Oscillating` | Optimizer diagnostics |
106
+
107
+ The input SMILES is **not** written to the output — join on `_Name`/`ID` against
108
+ your input file.
109
+
110
+ ## Beyond conformer generation
111
+
112
+ Each of these wraps a Python API function and has a matching notebook in
113
+ [`example/`](example/).
114
+
115
+ | Command | Does | Python API |
116
+ |---|---|---|
117
+ | `auto3d run` | Generate conformers from SMILES/SDF | `main`, `smiles2mols` |
118
+ | `auto3d energy` | Single-point energy for an SDF | `calc_spe` |
119
+ | `auto3d optimize` | Geometry-optimize an existing SDF | `opt_geometry` |
120
+ | `auto3d thermo` | Enthalpy / entropy / Gibbs (needs `ase`) | `calc_thermo` |
121
+ | `auto3d tautomers` | Enumerate and rank stable tautomers | `get_stable_tautomers` |
122
+ | `auto3d validate` | Check an input file without running | — |
123
+ | `auto3d config init\|show\|validate` | Manage YAML configs | — |
124
+ | `auto3d models list\|info\|test` | Inspect and smoke-test engines | — |
125
+
126
+ All commands except `models list` take `-v/--verbose`, the only way to get a
127
+ traceback. `--json` is available on `run`, `validate`, and the four property
128
+ commands. Exit codes: `0` success, `2` config/input error, `4` GPU requested but
129
+ unavailable, `6` partial success, `130` interrupted.
130
+
131
+ ## Engines
132
+
133
+ | Engine | Networks/step | Elements |
134
+ |---|---|---|
135
+ | **AIMNET** (default) | 1 | H, B, C, N, O, F, Si, P, S, Cl, As, Se, Br, I |
136
+ | **aimnet2-2025**, **aimnet2-nse**, **aimnet2-pd**, … | 1 | as above (`aimnet2-pd` swaps As for Pd) |
137
+ | **ANI2x** | 8 (ensemble) | H, C, N, O, F, S, Cl |
138
+ | **ANI2xt** | 1 | H, C, N, O, F, S, Cl |
139
+
140
+ Select with `--engine` or `optimizing_engine`. AIMNet2 models come from the
141
+ [`aimnet`](https://github.com/isayevlab/aimnetcentral) package and are
142
+ sha256-validated on download; `auto3d models list` shows what is available.
143
+ `optimizing_engine` also accepts a path to a
144
+ [custom NNP](https://auto3d.readthedocs.io/en/latest/howto/custom_nnp.html).
145
+
146
+ No engine speed benchmark is maintained in this repository, so the table reports
147
+ how many networks each engine evaluates per step rather than a speed ranking.
148
+ Time your own workload before choosing.
149
+
150
+ ## Key parameters
151
+
152
+ | Parameter | Default | Description |
153
+ |---|---|---|
154
+ | `k` | — | Top-k conformers per molecule |
155
+ | `window` | — | Energy window, kcal/mol — exactly one of `k`/`window` is required |
156
+ | `optimizing_engine` | `AIMNET` | Engine name, registry name, or path to a custom model |
157
+ | `use_gpu` | `True` | GPU acceleration; missing CUDA device is fatal, not a fallback |
158
+ | `gpu_idx` | `0` | CUDA index, or a list for multi-GPU |
159
+ | `enumerate_tautomer` | `False` | Enumerate tautomers |
160
+ | `enumerate_isomer` | `True` | Enumerate stereoisomers |
161
+ | `threshold` | `0.3` | RMSD threshold for duplicate removal, Å |
162
+ | `opt_steps` | `2000` | Maximum optimization steps |
163
+ | `convergence_threshold` | `0.01` | Force convergence threshold, eV/Å |
164
+
165
+ Full list: [CLI reference](https://auto3d.readthedocs.io/en/latest/cli.html) ·
166
+ [API reference](https://auto3d.readthedocs.io/en/latest/api.html)
167
+
168
+ ## Upgrading from 2.x
169
+
170
+ AIMNet2 is now served by the `aimnet` package rather than bundled `.jpt` files,
171
+ and the default AIMNet2 energies differ from 2.x (the registry `.pt` externalizes
172
+ D3 dispersion), so conformer rankings may shift slightly. The thermochemistry SDF
173
+ property `S_hartree` is now `S_hartree_per_K`. Python ≥ 3.11 and PyTorch ≥ 2.8 are
174
+ required. See the [migration guide](https://auto3d.readthedocs.io/en/latest/migration.html).
175
+
176
+ ## Documentation
177
+
178
+ [**auto3d.readthedocs.io**](https://auto3d.readthedocs.io/) ·
179
+ [Installation](https://auto3d.readthedocs.io/en/latest/installation.html) ·
180
+ [Quickstart](https://auto3d.readthedocs.io/en/latest/howto/quickstart.html) ·
181
+ [CLI](https://auto3d.readthedocs.io/en/latest/cli.html) ·
182
+ [API](https://auto3d.readthedocs.io/en/latest/api.html) ·
183
+ [Custom NNPs](https://auto3d.readthedocs.io/en/latest/howto/custom_nnp.html) ·
184
+ [Troubleshooting](https://auto3d.readthedocs.io/en/latest/howto/troubleshooting.html) ·
185
+ [Notebooks](example/)
186
+
187
+ ## Citation
188
+
189
+ ```bibtex
190
+ @article{liu2022auto3d,
191
+ title={Auto3D: Automatic generation of the low-energy 3D structures with ANI neural network potentials},
192
+ author={Liu, Zhen and Zubatiuk, Tetiana and Roitberg, Adrian and Isayev, Olexandr},
193
+ journal={Journal of Chemical Information and Modeling},
194
+ volume={62},
195
+ number={22},
196
+ pages={5373--5382},
197
+ year={2022},
198
+ publisher={ACS Publications},
199
+ doi={10.1021/acs.jcim.2c00817}
200
+ }
201
+ ```
202
+
203
+ ## Contributing
204
+
205
+ [Issues](https://github.com/isayevlab/Auto3D_pkg/issues) ·
206
+ [Discussions](https://github.com/isayevlab/Auto3D_pkg/discussions) ·
207
+ [CONTRIBUTING.md](CONTRIBUTING.md)
208
+
209
+ ## License
210
+
211
+ MIT — see [LICENSE](LICENSE).