pyef.run

Module Contents

Functions

main(job_name, molden_paths, xyz_paths, ...[, ...])

Main function for running the pyEF workflow.

read_file_lines(file_path)

Reads in auxiliary files containing job information

Attributes

parser

main(job_name, molden_paths, xyz_paths, analysis_types, metal_indices, bond_indices, dielectric, geom_flag, multiwfn_path, charge_types=['Hirshfeld_I'], multipole_bool=True, use_multipole=False, decompose_atomwise=False, substrate_idxs=None, env_idxs=None, multipole_order=2, include_ptchgs=False, ptchg_file='', dielectric_scale=1.0, use_ecp=False, exclude_atoms=[])

Main function for running the pyEF workflow.

Parameters:

  • job_name (str) – Name for output files

  • molden_paths (list of str) – List of paths to .molden files

  • xyz_paths (list of str) – List of paths to .xyz files

  • analysis_types (list of str) – List of analysis types per job (‘ef’, ‘esp’, ‘estab’, or combinations)

  • metal_indices (list of int or None) – List of metal atom indices (only required for ESP analysis or auto-finding bonds)

  • bond_indices (list of tuples) – List of bond pairs (required for E-field if metal_indices not provided)

  • dielectric (float) – Dielectric constant

  • geom_flag (bool) – Geometry checks are currently not implemented; flag is accepted but skipped

  • multiwfn_path (str) – Path to Multiwfn executable

  • charge_types (list of str, optional) – Charge partitioning schemes (default: [‘Hirshfeld_I’])

  • multipole_bool (bool, optional) – Use multipole expansion for E-field (default: True)

  • use_multipole (bool, optional) – Use multipole expansion for ESP (default: False)

  • decompose_atomwise (bool, optional) – Compute atom-wise decomposition (default: False)

  • substrate_idxs (list or None, optional) – Substrate atom indices for estab calculation (default: None)

  • env_idxs (list or None, optional) – Environment atom indices for estab calculation (default: None)

  • multipole_order (int, optional) – Multipole expansion order (default: 2)

  • include_ptchgs (bool, optional) – Include MM point charges from QM/MM calculations (default: False)

  • ptchg_file (str, optional) – Filename of point charge file (default: ‘’) File is looked for in the same directory as each job’s molden file. Example: ‘pointcharges.txt’ will look for this file in each job directory.

  • dielectric_scale (float, optional) – Dielectric scaling factor for MM charges (default: 1.0)

  • use_ecp (bool, optional) – Use effective core potential (ECP) correction for molden files (default: False)

  • exclude_atoms (list of int or list of lists, optional) – Atom indices to exclude from E-field calculations (default: []) Can be either: - Flat list [0, 1, 2] for same exclusions across all jobs - Nested list [[0, 1], [2, 3], []] for different exclusions per job

read_file_lines(file_path)

Reads in auxiliary files containing job information

parser