v0.14.0 / 2020-02-06

New Features

  • (GH#212) NWChem - Adds CI for the NWChem harness.

  • (GH#226) OpenMM - Moves the OpenMM harness to a canonical forcefield based method/basis language combination.

  • (GH#228) RDKit - Adds MMFF94 force field capabilities.


  • (GH#201) Psi4 - psi4 --version collection to only grab the last line.

  • (GH#202) Entos - Adds wavefunction parsing.

  • (GH#203) NWChem - Parses DFT empirical dispersion energy.

  • (GH#204) NWChem - Allows custom DFT functionals to be run.

  • (GH#205) NWChem - Improved gradient output and added Hessian support for NWChem.

  • (GH#215) Psi4 - if Psi4 location can be found by either PATH or PYTHONPATH, harness sets up both subprocesses and API execution.

  • (GH#215) get_program shows the helpful “install this” messages from found() rather than just saying “cannot be found”.

Bug Fixes

  • (GH#199) Fix typo breaking NWChem property parsing.

  • (GH#215) NWChem complains before a calculation if the necessary networkx package not available.

  • (GH#207) NWChem - Minor bug fixes for NWChem when more than core per MPI rank is used.

  • (GH#209) NWChem - Fixed missing extras tags in NWChem harness.

v0.13.0 / 2019-12-10

New Features

  • (GH#151) Adds a OpenMM Harness for evaluation of SMIRNOFF force fields.

  • (GH#189) General MPI support and MPI CLI generator.


  • (GH#175) Allows specifications for nnodes to begin MPI support.

  • (GH#177) NWChem - Parsing updates including Hessian abilities.

  • (GH#180) GAMESS - Output properties improvements.

  • (GH#181) NWChem - Output properties improvements.

  • (GH#183) Entos - Hessian and XTB support.

  • (GH#185) Entos - Improved subcommand support.

  • (GH#187) QChem - Support for raw log files without the binary file requirements and improved output properties support.

  • (GH#188) Automatic buffer reads to prevent deadlocking of process for very large outputs.

  • (GH#194) DFTD3 - Improved error message on failed evaluations.

  • (GH#195) Blackens the code base add GHA-based lint checks.

Bug Fixes

  • (GH#179) QChem - fixes print issue when driver is of an incorrect value.

  • (GH#190) Psi4 - fixes issues for methods without basis sets such as HF-3c.

v0.12.0 / 2019-11-13

New Features

  • (GH#159) Adds MolSSI Driver Interface support.

  • (GH#160) Adds Turbomole support.

  • (GH#164) Adds Q-Chem support.


  • (GH#155) Support for Psi4 Wavefunctions using v1.4a2 or greater.

  • (GH#162) Adds test for geometry optimization with trajectory protocol truncation.

  • (GH#167) CFOUR and NWChem parsing improvements for CCSD(T) properties.

  • (GH#168) Standardizes on dispatch.out for the common output files.

  • (GH#170) Increases coverage and begins a common documentation page.

  • (GH#171) Add Molpro to the standard suite.

  • (GH#172) Models renamed according to, particularly ResultInput -> AtomicInput, Result -> AtomicResult, Optimization -> OptimizationResult.

Bug Fixes

v0.11.0 / 2019-10-01

New Features

  • (GH#162) Adds a test to take advantage of Elemental’s Protocols. Although this PR does not technically change anything in Engine, bumping the minor version here allows upstream programs to note when this feature was available because the minimum version dependency on Elemental has been bumped as well.


  • (GH#143) Updates to Entos and Molpro to allow Entos to execute functions from the Molpro Harness. Also helps the two drivers to conform to GH#86.

  • (GH#145, GH#148) Initial CLI tests have been added to help further ensure Engine is running proper.

  • (GH#149) The GAMESS Harness has been improved by adding testing.

  • (GH#150, GH#153) TorchANI has been improved by adding a Hessian driver to it and additional information is returned in the extra field when energy is the driver. This also bumped the minimum version of TorchANI Engine supports from 0.5 to 0.9.

  • (GH#154) Molpro’s harness has been improved to support callinfo_X properties, unrestricted HF and DFT calculations, and the initial support for parsing local correlation calculations.

  • (GH#158) Entos’ output parsing has been improved to read the json dictionary produced by the program directly. Also updates the input file generation.

  • (GH#161) Updates MOPAC to have more sensible quantum-chemistry like keywords by default.

Bug Fixes

  • (GH#156) Fixed a compatibility bug in specific version of Intel-OpenMP by skipping version 2019.5-281.

  • (GH#161) Improved error handling in MOPAC if the execution was incorrect.

v0.10.0 / 2019-08-25

New Features

  • (GH#132) Expands CLI for info, run, and run-procedure options.

  • (GH#137) A new CI pipeline through Azure has been developed which uses custom, private Docker images to house non-public code which will enable us to test Engine through integrated CI on these codes securely.

  • (GH#140) GAMESS, CFOUR, NWChem preliminary implementations.


  • (GH#138) Documentation on Azure triggers.

  • (GH#139) Overhauls install documentation and clearly defines dev install vs production installs.

v0.9.0 / 2019-08-14

New Features

  • (GH#120) Engine now takes advantage of Elemental’s new Msgpack serialization option for Models. Serialization defaults to msgpack when available (conda install msgpack-python [-c conda-forge]), falling back to JSON otherwise. This results in substantial speedups for both serialization and deserialization actions and should be a transparent replacement for users within Engine and Elemental themselves.


  • (GH#112) The MolproHarness has been updated to handle DFT and CCSD(T) energies and gradients.

  • (GH#116) An environment context manager has been added to catch NumPy style parallelization with Python functions.

  • (GH#117) MOPAC and DFTD3 can now accept an extras field which can pass around additional data, conforming to the rest of the Harnesses.

  • (GH#119) Small visual improvements to the docs have been made.

  • (GH#120) Lists inside models are now generally converted to numpy arrays for internal storage to maximize the benefit of the new Msgpack feature from Elemental.

  • (GH#133) The GAMESS Harness now collects the CCSD as part of its output.

Bug Fixes

  • (GH#127) Removed unused imports from the NWChem Harvester module.

  • (GH#129) Missing type hints from the MolproHarness have been added.

  • (GH#131) A code formatting redundancy in the GAMESS input file parser has been removed.

v0.8.2 / 2019-07-25

Bug Fixes

  • (GH#114) Make compute and compute_procedure not have required kwargs while debugging a Fractal serialization issue. This is intended to be a temporary change and likely reverted in a later release

v0.8.1 / 2019-07-22


  • (GH#110) Psi4’s auto-retry exception handlers now catch more classes of random errors

Bug Fixes

  • (GH#109) Geometric auto-retry settings now correctly propagate through the base code.

v0.8.0 / 2019-07-19

New Features

  • (GH#95, GH#96, GH#97, and GH#98) The NWChem interface from QCDB has been added. Thanks to @vivacebelles and @jygrace for this addition!

  • (GH#100) The MOPAC interface has now been added to QCEngine thanks help to from @godotalgorithm.


  • (GH#94) The gradient and molecule parsed from a GAMESS calculation output file are now returned in parse_output

  • (GH#101) Enabled extra files in TeraChem scratch folder to be requested by users, collected after program execution, and recorded in the Result object as extras.

  • (GH#103) Random errors can now be retried a finite, controllable number of times (current default is zero retries). Geometry optimizations automatically set retries to 2. This only impacts errors which are categorized as RandomError by QCEngine and all other errors are raised as normal.

Bug Fixes

  • (GH#99) QCEngine now manages an explicit folder for each Psi4 job to write into and passes the scratch directory via -s command line. This resolves a key mismatch which could cause an error.

  • (GH#102) DFTD3 errors are now correctly returned as a FailedOperation instead of a raw dict.

v0.7.1 / 2019-06-18

Bug Fixes

  • (GH#92) Added an file to the programs/tests directory so they are correctly bundled with the package.

v0.7.0 / 2019-06-17

Breaking Changes

  • (GH#85) The resource file has relocated and renamed to

  • (GH#89) Function util.execute forgot str argument scratch_location and learned scratch_directory in the same role of existing directory within which temporary directories are created and cleaned up. Non-user-facing function util.scratch_directory renamed to util.temporary_directory.

New Features

  • (GH#60) WIP: QCEngine interface to GAMESS can run the program (after light editing of rungms) and parse selected output (HF, CC, FCI) into QCSchema.

  • (GH#73) WIP: QCEngine interface to CFOUR can run the program and parse a variety of output into QCSchema.

  • (GH#59, GH#71, GH#75, GH#76, GH#78, GH#88) Molpro improvements: Molpro can be run by QCEngine; and the input generator and output parser now supports CCSD energy and gradient calculations. Large thanks to @sjrl for many of the improvements

  • (GH#69) Custom Exceptions have been added to QCEngine’s returns which will make parsing and diagnosing them easier and more programmatic for codes which invoke QCEngine. Thanks to @dgasmith for implementation.

  • (GH#82) QCEngine interface to entos can create input files (dft energy and gradients), run the program, and parse the output.

  • (GH#85) MP2D interface switched to upstream repo ( v1.1) and now produces correct analytic gradients.


  • (GH#62, GH#67, GH#83) A large block of TeraChem improvements thanks to @ffangliu contributions. Changed the input parser to call qcelemental to_string method with bohr unit, improved output of parser to turn stdout into Result, and modified how version is parsed.

  • (GH#63) QCEngine functions util.which, util.which_version, util.parse_version, and util.safe_version removed after migrating to QCElemental.

  • (GH#65) Torchani can now handle the ANI1-x and ANI1-ccx models. Credit to @dgasmith for implementation

  • (GH#74) Removes caching and reduces pytorch overhead from Travis CI. Credit to @dgasmith for implementation

  • (GH#77) Rename ProgramExecutor to ProgramHarness and BaseProcedure to ProcedureHarness.

  • (GH#77) Function util.execute(..., outfiles=[]) learned to collect output files matching a globbed filename.

  • (GH#81) Function util.execute learned list argument as_binary to handle input or output files as binary rather than string.

  • (GH#81) Function util.execute learned bool argument scratch_exist_ok to run in a preexisting directory. This is handy for stringing together execute calls.

  • (GH#84) Function util.execute learned str argument scratch_suffix to identify temp dictionaries for debugging.

  • (GH#90) DFTD3 now supports preliminary parameters for zero and Becke-Johnson damping to use with SAPT0-D

Bug Fixes

  • (GH#80) Fix “psi4:qcvars” handling for older Psi4 versions.

v0.6.4 / 2019-03-21

Bug Fixes

  • (GH#54) Psi4’s Engine implementation now checks its key words in a case insensitive way to give the same value whether you called Psi4 or Engine to do the compute.

  • (GH#55) Fixed an error handling routine in Engine to match Psi4.

  • (GH#56) Complex inputs are now handled better through Psi4’s wrapper which caused Engine to hang while trying to write to stdout.

v0.6.3 / 2019-03-15

New Features

  • (GH#28) TeraChem is now a registered executor in Engine! Thanks to @ffangliu for implementing.

  • (GH#46) MP2D is now a registered executor in Engine! Thanks to @loriab for implementing.


  • (GH#46) dftd3’s workings received an overhaul. The mol keyword has been replaced with dtype=2, full Psi4 support is now provided, and an MP2D interface has been added.

Bug Fixes

  • (GH#50 and GH#51) Executing Psi4 on a single node with multiprocessing is more stable because Psi4 temps are moved to scratch directories. This behavior is now better documented with an example as well.

  • (GH#52) Psi4 calls are now executed through the subprocess module to prevent possible multiprocessing issues and memory leak after thousands of runs. A trade off is this adds about 0.5 seconds to task start-up, but its safe. A future Psi4 release will correct this issue and the change can be reverted.

v0.6.2 / 2019-03-07


  • (GH#38 and GH#39) Documentation now pulls from the custom QC Archive Sphinx Theme, but can fall back to the standard RTD theme. This allows all docs across QCA to appear consistent with each other.

  • (GH#43) Added a base model for all Procedure objects to derive from. This allows procedures’ interactions with compute programs to be more unified. This PR also ensured GeomeTRIC provides Provenance information.

Bug Fixes

  • (GH#40) This PR improved numerous back-end and testing quality of life aspects. Fixed to call pytest instead of unittest when running tests on install. Some conda packages for Travis-CI are cached to reduce the download time of the larger computation codes. Psi4 is now pinned to the 1.3 version to fix build-level pin of libint. Conda-build recipe removed to avoid possible confusion for everyone who isn’t a Conda-Forge recipe maintainer. Tests now rely exclusively on the conda env setups.

v0.6.1 / 2019-02-20

Bug Fixes

  • (GH#37) Fixed an issue where RDKit methods were not case agnostic.

v0.6.0 / 2019-02-28

Breaking Changes

  • (GH#36) breaking change Model objects are returned by default rather than a dictionary.

New Features

  • (GH#18) Add the dftd3 program to available computers.

  • (GH#29) Adds preliminary support for the Molpro compute engine.

  • (GH#31) Moves all computation to ProgramExecutor to allow for a more flexible input generation, execution, output parsing interface.

  • (GH#32) Adds a general execute process which safely runs subprocess jobs.


  • (GH#33) Moves the dftd3 executor to the new ProgramExecutor interface.

  • (GH#34) Updates models to the more strict QCElemental v0.3.0 model classes.

  • (GH#35) Updates CI to avoid pulling CUDA libraries for torchani.

  • (GH#36) First pass at documentation.

v0.5.2 / 2019-02-13


  • (GH#24) Improves load times dramatically by delaying imports and cpuutils.

  • (GH#25) Code base linting.

  • (GH#30) Ensures Psi4 output is already returned and Pydantic v0.20+ changes.

v0.5.1 / 2019-01-29


  • (GH#22) Compute results are now returned as a dict of Python Primals which have been serialized-deserialized through Pydantic instead of returning un-processed Python objects or json-compatible string.

v0.5.0 / 2019-01-28

New Features

  • (GH#8) Adds the TorchANI program for ANI-1 like energies and potentials.

  • (GH#16) Adds QCElemental models based off QCSchema to QCEngine for both validation and object-based manipulation of input and output data.


  • (GH#14) Migrates option to Pydantic objects for validation and creation.

  • (GH#14) Introduces NodeDescriptor (for individual node description) and JobConfig (individual job configuration) objects.

  • (GH#17) NodeDescriptor overhauled to work better with Parsl/Balsam/Dask/etc.