How aobeng-comp-chem/nbotools works
NBOTools is an interactive Python toolkit for analyzing NBO calculation outputs. Users provide NBO plot files and a .47 basis description; main.py dispatches menu choices to matrix transformations, orbital localization, bond-order analysis, valence–core work, and NLMO partition analysis. Matrix extraction and basis interpretation support those analyses, while separate scripts reconstruct/visualize PNAOs and check .47 basis conventions. The README documents capabilities beyond the sampled excerpts; edges below are limited to documented or indexed relationships.
Main entry points: main.py Interactive menu · sep_mat.py Matrix transforms · val_core_ortho.py Valence–core solver · pm_localization.py Pipek–Mezey localization
Components 18
Input and basis
- NBO data extraction
packages/extract_nbo_files.py - Basis interpretation
packages/basis_info.py
Matrix processing
- Matrix transforms
packages/sep_mat.py - Matrix selection and export
packages/my_func.py
Orbital analysis
- Interactive menu
packages/main.py - Pipek–Mezey localization
packages/pm_localization.py - Population analysis
packages/pop_analys.py - Bond-order analysis
packages/bond_indices.py - NLMO partition analysis
packages/nlmo_partition.py - Valence–core solver
packages/val_core_ortho.py - Promolecule density
packages/generate_promolecule.py
Supporting utilities
- Orbital data output
packages/visualizer.py - PNAO reconstruction viewer
packages/nao2pnao.py - .47 namelist converter
tools/convert-47-to-namelists.py - Basis convention checker
tools/parse-namelists
Other components
- Analyst
- NBO plot files
- .47 basis file
Connections 28
- Analyst → NBO plot files: provides
README.md - Analyst → .47 basis file: provides
README.md - Analyst → Interactive menu: selects analysis
packages/main.py - NBO plot files → NBO data extraction: parsed from
README.md - NBO data extraction → Matrix transforms: supplies matrices
packages/sep_mat.py - .47 basis file → Basis interpretation: describes basis
README.md - Interactive menu → Matrix selection and export: dispatches matrix actions
packages/main.py - Interactive menu → Matrix transforms: dispatches matrix actions
packages/main.py - Interactive menu → Pipek–Mezey localization: dispatches
packages/main.py - Interactive menu → Bond-order analysis: dispatches
packages/main.py - Interactive menu → NLMO partition analysis: dispatches
packages/main.py - Interactive menu → Valence–core solver: dispatches
packages/main.py - Matrix transforms → Basis interpretation: uses basis mapping
packages/sep_mat.py - Bond-order analysis → Basis interpretation: uses basis data
packages/bond_indices.py - Bond-order analysis → Matrix transforms: uses matrices
packages/bond_indices.py - Bond-order analysis → Promolecule density: uses promolecule data
packages/bond_indices.py - NLMO partition analysis → Basis interpretation: uses basis data
packages/nlmo_partition.py - NLMO partition analysis → Matrix transforms: uses matrices
packages/nlmo_partition.py - Pipek–Mezey localization → Matrix selection and export: uses selection helpers
packages/pm_localization.py - Pipek–Mezey localization → Population analysis: uses population analysis
packages/pm_localization.py - Pipek–Mezey localization → Orbital data output: uses output routines
packages/pm_localization.py - Valence–core solver → Matrix selection and export: uses input helpers
packages/val_core_ortho.py - Valence–core solver → Matrix transforms: uses matrix data
packages/val_core_ortho.py - Valence–core solver → Pipek–Mezey localization: uses localization
packages/val_core_ortho.py - Valence–core solver → Population analysis: uses population analysis
packages/val_core_ortho.py - Analyst → PNAO reconstruction viewer: runs separately
README.md - Analyst → .47 namelist converter: runs checker workflow
README.md - .47 namelist converter → Basis convention checker: creates checker input
README.md