Release Notes¶
v0.3.0 (Orion Release 2020.2)¶
New Floes¶
- Psi4 QM Complete Molecule Torsion Scan is a QM version of the floe that used to be in the Scientific Floes package which was redistributed. This floe identifies all rotatable bonds in a molecule and then performs a torsion scan round each bond. As with our other torsion scan floes, QM single point energies or geometry optimizations can optionally be performed on the force field optimized structures.
- Psi4 QM Fragmentation and Torsion Scanning generates custom torsion rules which can be used in conformer generation. It begins by fragmenting the molecule around each rotatable bond. Then, a torsion scan with QM geometry optimization is performed for each rotatable bond. Lastly, these torsion scan results are analyzed to generate rules for conformer generation. The output from this floe can be used as input for the Psi4 QM Conformer Ensemble floe which will use the custom sampling rules for each rotatable bond.
- Psi4 QM Tautomer Floe enumerates tautomers of the input molecule and performs a local minima search for each. The final report for this floe shows the relative energy of each tautomer including a distribution of their conformer energies.
- Psi4 QM Vacuum Entropy Floe expects an ensemble of optimized conformers such as output from the Psi4 QM Local Minima Search and generates a finite difference Hessian for each input conformer. Then, a gas phase entropy at room temperature is calculated for the ensemble.
Floe Updates¶
- The new Psi4 Logs Report cube was added to all QM floes. When Psi4 log files are saved to a record during computation, this cube will convert those fields to a floe report to make accessing and reading the log files on orion more straight forward.
- Cubes from the Snowball package for counting successful records and handling failures and exceptions were added to all floes. This structure includes better communication of failures and exceptions with the user.
- A conformer splitter cube was add to the Psi4 QM Property Calculation and Psi4 QM Geometry Optimization floes to allow multiple conformer molecules to be used in these floes. In both cases, the conformers are split, the Psi4 calculation is performed and the output contains one conformer per record. That is, the conformers are not remerged.
- Promoted parameters have been updated for almost all floes to make running floes simpler.
New Cubes¶
The following cubes have been added during this release, primarily to facilitate the new floes and generate floe reports.
- The Psi4 Logs Report cube takes a field containing Psi4 log file strings and generates a floe report for easier access to these log files for users who wish to save them.
- The Fragment Molecule for Torsion Scans cube fragments molecules around each rotatable bond. There is a parent output port so that fragments can be recombined later if necessary.
- The Create Custom Torsion Rules cube gathers fragmented molecules and analyzes their torsion scans to generate torsion rules for conformer generation. This cube also generates a floe report showing the torsion scans and rules for each fragment.
- The Tautomer Floe Report was created to analyze local minima search results for multiple tautomers of the same molecule. The tautomer enumeration cube comes from the Snowball package.
- The cube_Psi4FDHessianCube cube was added to calculate finite difference Hessians single point gradients. This cube is intended to be used in combination with the Psi4 Property Calculation cube to compute the gradients.
- The cube_Psi4ConfEntropyFromHessianCube cube computes a configurational entropy based on a provided Hessian.
- The Psi4 Vacuum Entropy cube computes entropy using previously calculated energies and Hessians for a conformer ensemble. It assumes the energies and Hessians were computed at the same level of theory.
Cube Updates¶
- All cubes were updated to use the same exception handling that is used in Classic Floes. This allows exceptions and individual failures to be communicated more clearly with the user.
- The Psi4 Multi-conformer Splitter, Psi4 Multi-conformer Merger, and Psi4 Multi-conformer Energy Filter cubes have been deprecated in favor of cubes from the Snowball package. None of these cubes are used in floes for this release and a Deprecation Warning was added. In the next released version, these cubes will be removed entirely.
- The Psi4 Strain and Energy Filter cube was moved from the Crystal Math package to this one.
- The Exact Conformer Deduplicator cube was updated to handle conformers from different molecule allowing for more diverse floes to use this cube. The description was also updated to make it clear that this cube is only intended to deduplicate exact conformers within a very small RMSD.
v0.2.0 (Orion Release 2020.1)¶
General Notice¶
Constraints were refactored out of the geometry optimization cube. This allows for more geometry optimization options, including fixing only the relevant torsion in the torsion drive floes.
New Floes¶
Psi4 QM SMARTS Torsion Scan
is a new floe which uses the SMARTSMapCube
from snowball to tag atoms in a torsion
using a SMARTS pattern rather than indices.
Floe Updates¶
The torsion floes were updated to use new constraint cubes, meaning only the torsion being
scanned is held fixed. Additionally, the Psi4 QM Torsion Scanning
floe was renamed
Psi4 QM Atom Indices Torsion Scanning
to distinguish from the SMARTS based torsion floe. Similarly, The
Psi4 QM Geometry Optimization,
Psi4 QM Conformer Ensemble, and
Psi4 Local Minima Search
floes were updated to use the new constraint cubes.
New Cubes¶
The following cubes have been added in order to increase the variety of constraints which can be applied during optimizations
- Psi4 Constrain All Torsions assigns constraints to fix all torsions in a molecule.
- Psi4 Assign Constraints generates constraints for the tagged atoms in a molecule. The current implementation supports distances (two tagged atoms) or dihedral torsions (four bonded atoms)
- Tag atoms by Indices allows the user to tag atoms based on indices, this allows us to replicate the old torsion drive floe.
- Torsion Scan Report Cube generates a floe report showing MM and/or QM torsion scans.
Cube Updates¶
The ability to constrain all torsions was removed from the Psi4 Geometry Optimization to allow for more general optimization parameters
Removed Cubes¶
Psi4 Torsion Driver
was removed, the torsion scan floes have been updated to use
the snowball torsion scan cube instead.