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
smilesis not a string orconfighas 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