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.
- auto3d-3.1.0/MANIFEST.in +19 -0
- auto3d-3.1.0/PKG-INFO +271 -0
- auto3d-3.1.0/README.md +211 -0
- auto3d-3.1.0/pyproject.toml +275 -0
- auto3d-3.1.0/setup.cfg +4 -0
- auto3d-3.1.0/src/Auto3D/__init__.py +125 -0
- auto3d-3.1.0/src/Auto3D/domain/__init__.py +6 -0
- auto3d-3.1.0/src/Auto3D/domain/clash_relief.py +103 -0
- auto3d-3.1.0/src/Auto3D/domain/embedding.py +229 -0
- auto3d-3.1.0/src/Auto3D/domain/filtering.py +391 -0
- auto3d-3.1.0/src/Auto3D/domain/id_mapping.py +194 -0
- auto3d-3.1.0/src/Auto3D/domain/ranking.py +572 -0
- auto3d-3.1.0/src/Auto3D/engines/__init__.py +6 -0
- auto3d-3.1.0/src/Auto3D/engines/batch_opt/batchopt.py +444 -0
- auto3d-3.1.0/src/Auto3D/engines/batch_opt/fire_optimizer.py +201 -0
- auto3d-3.1.0/src/Auto3D/engines/batch_opt/model_wrapper.py +336 -0
- auto3d-3.1.0/src/Auto3D/engines/batch_opt/optimization_engine.py +501 -0
- auto3d-3.1.0/src/Auto3D/engines/batch_opt/padding.py +96 -0
- auto3d-3.1.0/src/Auto3D/engines/isomers/__init__.py +27 -0
- auto3d-3.1.0/src/Auto3D/engines/isomers/base.py +47 -0
- auto3d-3.1.0/src/Auto3D/engines/isomers/factory.py +262 -0
- auto3d-3.1.0/src/Auto3D/engines/isomers/omega.py +209 -0
- auto3d-3.1.0/src/Auto3D/engines/isomers/rdkit_sdf.py +177 -0
- auto3d-3.1.0/src/Auto3D/engines/isomers/rdkit_smi.py +304 -0
- auto3d-3.1.0/src/Auto3D/engines/isomers/tautomers.py +146 -0
- auto3d-3.1.0/src/Auto3D/engines/model_factory.py +312 -0
- auto3d-3.1.0/src/Auto3D/engines/models/__init__.py +24 -0
- auto3d-3.1.0/src/Auto3D/engines/models/adapter.py +844 -0
- auto3d-3.1.0/src/Auto3D/engines/models/ani2xt.py +384 -0
- auto3d-3.1.0/src/Auto3D/engines/models/contract.py +518 -0
- auto3d-3.1.0/src/Auto3D/engines/models/loading.py +86 -0
- auto3d-3.1.0/src/Auto3D/engines/models/policy.py +142 -0
- auto3d-3.1.0/src/Auto3D/engines/models/preflight.py +219 -0
- auto3d-3.1.0/src/Auto3D/engines/models/species.py +106 -0
- auto3d-3.1.0/src/Auto3D/entry/ASE/geometry.py +232 -0
- auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/__init__.py +36 -0
- auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/calculator.py +341 -0
- auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/driver.py +708 -0
- auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/properties.py +338 -0
- auto3d-3.1.0/src/Auto3D/entry/ASE/thermo/vibrations.py +546 -0
- auto3d-3.1.0/src/Auto3D/entry/SPE.py +182 -0
- auto3d-3.1.0/src/Auto3D/entry/__init__.py +6 -0
- auto3d-3.1.0/src/Auto3D/entry/auto3D.py +268 -0
- auto3d-3.1.0/src/Auto3D/entry/tautomer.py +168 -0
- auto3d-3.1.0/src/Auto3D/foundation/__init__.py +6 -0
- auto3d-3.1.0/src/Auto3D/foundation/config.py +685 -0
- auto3d-3.1.0/src/Auto3D/foundation/constants.py +168 -0
- auto3d-3.1.0/src/Auto3D/foundation/exceptions.py +144 -0
- auto3d-3.1.0/src/Auto3D/foundation/registry.py +124 -0
- auto3d-3.1.0/src/Auto3D/foundation/results.py +82 -0
- auto3d-3.1.0/src/Auto3D/foundation/torch_config.py +161 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/__init__.py +60 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/atomic_io.py +102 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/connectivity.py +210 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/convergence.py +100 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/energy.py +371 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/geometry.py +112 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/logging_config.py +67 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/molprops.py +75 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/output_guard.py +157 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/reconciliation.py +171 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/sdf_io.py +207 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/smi_io.py +254 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/stereo_check.py +166 -0
- auto3d-3.1.0/src/Auto3D/foundation/utils/stereochemistry.py +566 -0
- auto3d-3.1.0/src/Auto3D/orchestration/__init__.py +6 -0
- auto3d-3.1.0/src/Auto3D/orchestration/chunk_manager.py +309 -0
- auto3d-3.1.0/src/Auto3D/orchestration/job_layout.py +125 -0
- auto3d-3.1.0/src/Auto3D/orchestration/pipeline/__init__.py +7 -0
- auto3d-3.1.0/src/Auto3D/orchestration/pipeline/input_checks.py +408 -0
- auto3d-3.1.0/src/Auto3D/orchestration/processors.py +56 -0
- auto3d-3.1.0/src/Auto3D/orchestration/workflow.py +672 -0
- auto3d-3.1.0/src/Auto3D/orchestration/workflow_workers.py +365 -0
- auto3d-3.1.0/src/Auto3D/presentation/__init__.py +6 -0
- auto3d-3.1.0/src/Auto3D/presentation/auto3Dcli.py +212 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/__init__.py +14 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/app.py +644 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/commands/__init__.py +1 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/commands/config.py +244 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/commands/models.py +322 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/commands/properties.py +278 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/commands/run.py +349 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/commands/validate.py +242 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/config_schema.py +240 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/console.py +268 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/errors.py +252 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/progress.py +115 -0
- auto3d-3.1.0/src/Auto3D/presentation/cli/results.py +134 -0
- auto3d-3.1.0/src/Auto3D.egg-info/PKG-INFO +271 -0
- auto3d-3.1.0/src/Auto3D.egg-info/SOURCES.txt +202 -0
- auto3d-3.1.0/src/Auto3D.egg-info/entry_points.txt +2 -0
- auto3d-3.1.0/src/Auto3D.egg-info/requires.txt +36 -0
- auto3d-3.1.0/tests/test_SPE.py +345 -0
- auto3d-3.1.0/tests/test_adapter_atom_mask.py +205 -0
- auto3d-3.1.0/tests/test_adapter_fp64_contract.py +118 -0
- auto3d-3.1.0/tests/test_ani2xt_atom_energies.py +374 -0
- auto3d-3.1.0/tests/test_ase_geometry.py +76 -0
- auto3d-3.1.0/tests/test_ase_torch_config.py +39 -0
- auto3d-3.1.0/tests/test_atomic_io.py +259 -0
- auto3d-3.1.0/tests/test_auto3D.py +642 -0
- auto3d-3.1.0/tests/test_auto3Dcli.py +99 -0
- auto3d-3.1.0/tests/test_batchopt.py +389 -0
- auto3d-3.1.0/tests/test_chunk_manager.py +827 -0
- auto3d-3.1.0/tests/test_cli.py +472 -0
- auto3d-3.1.0/tests/test_cli_app.py +1129 -0
- auto3d-3.1.0/tests/test_cli_commands_config.py +27 -0
- auto3d-3.1.0/tests/test_cli_config_schema.py +543 -0
- auto3d-3.1.0/tests/test_cli_console.py +80 -0
- auto3d-3.1.0/tests/test_cli_errors.py +355 -0
- auto3d-3.1.0/tests/test_cli_exit_codes.py +702 -0
- auto3d-3.1.0/tests/test_cli_models_command.py +102 -0
- auto3d-3.1.0/tests/test_cli_property_commands.py +652 -0
- auto3d-3.1.0/tests/test_cli_results.py +135 -0
- auto3d-3.1.0/tests/test_cli_security.py +165 -0
- auto3d-3.1.0/tests/test_config.py +514 -0
- auto3d-3.1.0/tests/test_config_parity.py +488 -0
- auto3d-3.1.0/tests/test_conftest_isolation_guards.py +134 -0
- auto3d-3.1.0/tests/test_custom_nnp_contract.py +804 -0
- auto3d-3.1.0/tests/test_custom_nnp_eager.py +109 -0
- auto3d-3.1.0/tests/test_durability.py +1227 -0
- auto3d-3.1.0/tests/test_e_tot_units.py +221 -0
- auto3d-3.1.0/tests/test_element_sets.py +133 -0
- auto3d-3.1.0/tests/test_embed_params.py +100 -0
- auto3d-3.1.0/tests/test_filtering.py +778 -0
- auto3d-3.1.0/tests/test_filtering_thermo_failed.py +96 -0
- auto3d-3.1.0/tests/test_fire_optimizer.py +458 -0
- auto3d-3.1.0/tests/test_helpers_pipeline_output.py +761 -0
- auto3d-3.1.0/tests/test_hessian_invocation_contract.py +325 -0
- auto3d-3.1.0/tests/test_id_mapping.py +204 -0
- auto3d-3.1.0/tests/test_import_boundaries.py +1003 -0
- auto3d-3.1.0/tests/test_isomer_engine.py +356 -0
- auto3d-3.1.0/tests/test_isomer_engine_hardening.py +532 -0
- auto3d-3.1.0/tests/test_isomers.py +489 -0
- auto3d-3.1.0/tests/test_job_layout.py +148 -0
- auto3d-3.1.0/tests/test_layer_boundaries.py +241 -0
- auto3d-3.1.0/tests/test_lazy_torchani_import.py +63 -0
- auto3d-3.1.0/tests/test_legacy_yaml_parity.py +141 -0
- auto3d-3.1.0/tests/test_logging_config.py +169 -0
- auto3d-3.1.0/tests/test_model_adapter.py +769 -0
- auto3d-3.1.0/tests/test_model_caching.py +108 -0
- auto3d-3.1.0/tests/test_model_factory.py +429 -0
- auto3d-3.1.0/tests/test_model_preflight.py +477 -0
- auto3d-3.1.0/tests/test_model_wrapper.py +406 -0
- auto3d-3.1.0/tests/test_mp_start_method.py +110 -0
- auto3d-3.1.0/tests/test_notebook_properties.py +121 -0
- auto3d-3.1.0/tests/test_optimization_engine.py +658 -0
- auto3d-3.1.0/tests/test_optimization_engine_indexing.py +900 -0
- auto3d-3.1.0/tests/test_optimization_engine_validation.py +163 -0
- auto3d-3.1.0/tests/test_output_overwrite_gates.py +290 -0
- auto3d-3.1.0/tests/test_packaging_metadata.py +199 -0
- auto3d-3.1.0/tests/test_padding.py +270 -0
- auto3d-3.1.0/tests/test_padding_invariance.py +81 -0
- auto3d-3.1.0/tests/test_parallel_embed.py +263 -0
- auto3d-3.1.0/tests/test_pipeline_e2e.py +340 -0
- auto3d-3.1.0/tests/test_processors.py +140 -0
- auto3d-3.1.0/tests/test_progress.py +330 -0
- auto3d-3.1.0/tests/test_public_api.py +67 -0
- auto3d-3.1.0/tests/test_ranking.py +1268 -0
- auto3d-3.1.0/tests/test_ranking_by_gibbs.py +187 -0
- auto3d-3.1.0/tests/test_registry.py +108 -0
- auto3d-3.1.0/tests/test_results.py +45 -0
- auto3d-3.1.0/tests/test_sdf_isomer_enumeration.py +202 -0
- auto3d-3.1.0/tests/test_smiles_stereo_warning.py +179 -0
- auto3d-3.1.0/tests/test_spe_energy_only.py +480 -0
- auto3d-3.1.0/tests/test_species_conversion.py +147 -0
- auto3d-3.1.0/tests/test_species_module.py +227 -0
- auto3d-3.1.0/tests/test_stereo_identity.py +242 -0
- auto3d-3.1.0/tests/test_stereo_postopt.py +220 -0
- auto3d-3.1.0/tests/test_stereochemistry_validation.py +231 -0
- auto3d-3.1.0/tests/test_suite_hygiene.py +121 -0
- {auto3d-2.3.1 → auto3d-3.1.0}/tests/test_tauto.py +46 -23
- auto3d-3.1.0/tests/test_tautomer_select.py +108 -0
- auto3d-3.1.0/tests/test_tautomer_stereo.py +128 -0
- auto3d-3.1.0/tests/test_thermo.py +584 -0
- auto3d-3.1.0/tests/test_thermo_etot_sync.py +146 -0
- auto3d-3.1.0/tests/test_thermo_helpers.py +1855 -0
- auto3d-3.1.0/tests/test_thermo_imaginary_mode_inversion.py +529 -0
- auto3d-3.1.0/tests/test_thermo_projection.py +392 -0
- auto3d-3.1.0/tests/test_thermo_record_assertions.py +85 -0
- auto3d-3.1.0/tests/test_thermo_reference.py +243 -0
- auto3d-3.1.0/tests/test_thermo_relative_energies.py +360 -0
- auto3d-3.1.0/tests/test_thermo_transition_state.py +191 -0
- auto3d-3.1.0/tests/test_torch_config.py +306 -0
- {auto3d-2.3.1 → auto3d-3.1.0}/tests/test_utils.py +30 -20
- auto3d-3.1.0/tests/test_utils_connectivity.py +219 -0
- auto3d-3.1.0/tests/test_utils_energy_constants.py +67 -0
- auto3d-3.1.0/tests/test_utils_geometry.py +143 -0
- auto3d-3.1.0/tests/test_utils_molprops.py +109 -0
- auto3d-3.1.0/tests/test_utils_reconciliation.py +245 -0
- auto3d-3.1.0/tests/test_utils_sdf_io.py +315 -0
- auto3d-3.1.0/tests/test_utils_smi_io.py +363 -0
- auto3d-3.1.0/tests/test_utils_stereochemistry.py +555 -0
- auto3d-3.1.0/tests/test_utils_validation.py +267 -0
- auto3d-3.1.0/tests/test_validate_run_parity.py +124 -0
- auto3d-3.1.0/tests/test_validation.py +303 -0
- auto3d-3.1.0/tests/test_validation_errors.py +207 -0
- auto3d-3.1.0/tests/test_workflow.py +1108 -0
- auto3d-2.3.1/MANIFEST.in +0 -3
- auto3d-2.3.1/PKG-INFO +0 -35
- auto3d-2.3.1/README.md +0 -16
- auto3d-2.3.1/pyproject.toml +0 -3
- auto3d-2.3.1/setup.cfg +0 -39
- auto3d-2.3.1/src/Auto3D/.gitignore +0 -18
- auto3d-2.3.1/src/Auto3D/ASE/__pycache__/__init__.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/ASE/__pycache__/geometry.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/ASE/__pycache__/thermo.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/ASE/geometry.py +0 -72
- auto3d-2.3.1/src/Auto3D/ASE/thermo.py +0 -327
- auto3d-2.3.1/src/Auto3D/SPE.py +0 -112
- auto3d-2.3.1/src/Auto3D/__init__.py +0 -26
- auto3d-2.3.1/src/Auto3D/__pycache__/SPE.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/__init__.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/auto3D.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/auto3Dcli.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/isomer_engine.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/ranking.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/tautomer.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/utils.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/__pycache__/utils_file.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/auto3D.py +0 -520
- auto3d-2.3.1/src/Auto3D/auto3Dcli.py +0 -170
- auto3d-2.3.1/src/Auto3D/batch_opt/ANI2xt_no_rep.py +0 -126
- auto3d-2.3.1/src/Auto3D/batch_opt/ANI2xt_rep.py +0 -127
- auto3d-2.3.1/src/Auto3D/batch_opt/__pycache__/ANI2xt_no_rep.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/batch_opt/__pycache__/__init__.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/batch_opt/__pycache__/batchopt.cpython-39.pyc +0 -0
- auto3d-2.3.1/src/Auto3D/batch_opt/batchopt.py +0 -447
- auto3d-2.3.1/src/Auto3D/isomer_engine.py +0 -368
- auto3d-2.3.1/src/Auto3D/models/aimnet2_wb97m-d3_0.jpt +0 -0
- auto3d-2.3.1/src/Auto3D/models/aimnet2_wb97m_ens_f.jpt +0 -0
- auto3d-2.3.1/src/Auto3D/ranking.py +0 -170
- auto3d-2.3.1/src/Auto3D/tautomer.py +0 -83
- auto3d-2.3.1/src/Auto3D/utils.py +0 -706
- auto3d-2.3.1/src/Auto3D/utils_file.py +0 -320
- auto3d-2.3.1/src/Auto3D.egg-info/PKG-INFO +0 -35
- auto3d-2.3.1/src/Auto3D.egg-info/SOURCES.txt +0 -53
- auto3d-2.3.1/src/Auto3D.egg-info/entry_points.txt +0 -2
- auto3d-2.3.1/src/Auto3D.egg-info/requires.txt +0 -4
- auto3d-2.3.1/tests/test_SPE.py +0 -190
- auto3d-2.3.1/tests/test_auto3D.py +0 -371
- auto3d-2.3.1/tests/test_isomer_engine.py +0 -91
- auto3d-2.3.1/tests/test_thermo.py +0 -299
- {auto3d-2.3.1 → auto3d-3.1.0}/LICENSE +0 -0
- {auto3d-2.3.1/src/Auto3D/ASE → auto3d-3.1.0/src/Auto3D/engines/batch_opt}/__init__.py +0 -0
- {auto3d-2.3.1/src/Auto3D → auto3d-3.1.0/src/Auto3D/engines}/models/ani2xt_no_repulsion.pt +0 -0
- {auto3d-2.3.1/src/Auto3D/batch_opt → auto3d-3.1.0/src/Auto3D/entry/ASE}/__init__.py +0 -0
- /auto3d-2.3.1/src/Auto3D/models/__init__.py → /auto3d-3.1.0/src/Auto3D/py.typed +0 -0
- {auto3d-2.3.1 → auto3d-3.1.0}/src/Auto3D.egg-info/dependency_links.txt +0 -0
- {auto3d-2.3.1 → auto3d-3.1.0}/src/Auto3D.egg-info/top_level.txt +0 -0
auto3d-3.1.0/MANIFEST.in
ADDED
|
@@ -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
|
+
[](https://pypi.org/project/Auto3D/)
|
|
64
|
+
[](https://pypi.org/project/Auto3D/)
|
|
65
|
+
[](https://auto3d.readthedocs.io/)
|
|
66
|
+
[](https://www.python.org/downloads/)
|
|
67
|
+
[](https://github.com/isayevlab/Auto3D_pkg/blob/main/LICENSE)
|
|
68
|
+
|
|
69
|
+

|
|
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
|
+
[](https://pypi.org/project/Auto3D/)
|
|
4
|
+
[](https://pypi.org/project/Auto3D/)
|
|
5
|
+
[](https://auto3d.readthedocs.io/)
|
|
6
|
+
[](https://www.python.org/downloads/)
|
|
7
|
+
[](https://github.com/isayevlab/Auto3D_pkg/blob/main/LICENSE)
|
|
8
|
+
|
|
9
|
+

|
|
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).
|