nvalchemi.csp.chem.generate_conformers_from_smiles#

nvalchemi.csp.chem.generate_conformers_from_smiles(smiles, *, config=None)[source]#

Generate 3D conformers with explicit hydrogens from one SMILES molecule.

Parameters:
  • smiles (str) – SMILES for exactly one connected molecule.

  • config (RDKitConformerConfig, optional) – RDKit distance-geometry options. Defaults to 100 conformers with unseeded sampling, no RMSD pruning, and up to 1000 embedding attempts.

Returns:

A new molecule with explicit hydrogens and all retained 3D conformers.

Return type:

rdkit.Chem.rdchem.Mol

Raises:
  • OptionalDependencyError – If RDKit is unavailable. Install nvalchemi-toolkit[rdkit].

  • TypeError – If smiles is not a string or config has the wrong type.

  • ValueError – If the SMILES is invalid or describes multiple disconnected fragments.

  • RuntimeError – If RDKit retains no conformers.

Notes

No separate MMFF or UFF minimization is run. Exact reproducibility across RDKit versions, platforms, and thread settings is not guaranteed.

Examples

>>> molecule = generate_conformers_from_smiles(
...     "CO", config=RDKitConformerConfig(num_conformers=2, random_seed=7)
... )
>>> molecule.GetNumConformers() > 0
True