Overview
cclib is a Python library that parses output files of computational chemistry packages and offers a platform for implementing algorithms in a package-independent way. Program coverage, field availability and unit conventions are documented per supported package, so a given quantity may be missing for a particular program or job.
The README states that a 2.0 release is in preparation and that the default branch carries breaking changes and no further tagged releases; version 1.8.1 is the current release on the Python package index. Parsing a log file reports what the program wrote, not whether the calculation converged or is scientifically sound; failed or incomplete jobs need to be detected before downstream use.
LICENSE states the BSD 3-Clause licence. The project documentation site covers supported programs and the extracted data model.
Key Features
- Parsers for computational chemistry output files with a shared, package-independent data representation.
- A documented platform for implementing analysis algorithms across supported programs.
Use Cases
- Extract energies, geometries and related results from many program logs into one analysis pipeline.
How to Use
Install the released version from the Python package index or conda-forge, then parse a supported log file and check which attributes are present. Confirm convergence and units from the original output before comparing results across programs.
See the official documentation for supported programs: https://cclib.github.io/
Sources and verification
This entry describes capabilities documented by the linked project sources. Catalog edits are not evidence of a successful run, compatibility test or scientific performance evaluation.
Read the editorial and verification policy