nvalchemi.csp.chem.RDKitConformerConfig#

class nvalchemi.csp.chem.RDKitConformerConfig(*, num_conformers=100, random_seed=None, prune_rms_thresh=-1.0, embed_force_tol=0.05, max_embed_attempts=1000, num_threads=-1)[source]#

Options for generating 3D conformers with RDKit distance geometry.

ETKDGv3 is RDKit’s distance-geometry method for proposing molecular conformations.

Parameters:
  • num_conformers (int, default=100) – Number of conformers to request.

  • random_seed (int or None, default=None) – Nonnegative RDKit random seed. None leaves RDKit’s random seed unset.

  • prune_rms_thresh (float, default=-1.0) – Discard a newly generated conformer if its heavy-atom geometry is too similar to one already retained. The threshold is RMSD in angstroms; -1 disables this pruning.

  • embed_force_tol (float, default=0.05) – ETKDG embedding cleanup tolerance passed to RDKit.

  • max_embed_attempts (int, default=1000) – Maximum RDKit attempts per requested conformer.

  • num_threads (int, default=-1) – Positive values request that many embedding threads. 0 asks RDKit to use the system’s maximum supported thread count; -1 is passed through to RDKit unchanged.

Notes

This immutable configuration covers embedding only. It does not request a separate MMFF or UFF geometry optimization.

model_config = {'extra': 'forbid', 'frozen': True, 'strict': True}#

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].