print
The print
util allows the display through console of some key properties
of the gaussian output files. There options are:
potential
Prints the Potential energy. Defaults to the 'Done' of l502 or l508
usage: pyssianutils print potential [-h] [-l] [-o OUTFILE]
[--method {oniom,mp2,mp2scs,mp4,ccsdt,default}]
[-v]
files [files ...]
Positional Arguments
- files
Gaussian Output File(s)
Named Arguments
- -l, --listfile
When enabled instead of considering the files provided as the gaussian output files considers the file provided as a list of gaussian output files
Default:
False
- -o, --outfile
File to write the Data. If it exists, the data will be appended. If none is provided it will be printed to stdout
- --method
Possible choices: oniom, mp2, mp2scs, mp4, ccsdt, default
When not provided it will attempt (and may fail) to guess the method used for the calculation to correctly read the potential energy. Otherwise it defaults to the Energy of the 'SCF Done:'
Default:
default
- -v, --verbose
if enabled it will raise an error anytime it is unable to find the energy of the provided file
Default:
False
Usage
The simplest way to use the print potential
utils is to extract the
potential energy of a single molecule:
$ pyssianutils print potential File1.log
File1.log -11111
We can also specify multiple files manually:
$ pyssianutils print potential File1.log File2.log
File1.log -11111
File2.log -22222
$ pyssianutils print potential File*.log
File1.log -11111
File2.log -22222
File3.log -33333
Another option is to provide a file where each line points to a gaussian output.
pyssianutils will respect the order of the file, which may be useful for some
users. For example lets assume a file name Files.txt
with the contents:
Path/To/Files/File1.log
Path/To/Files/File3.log
Path/To/Files/File2.log
We can pass this file to pyssianutils with the -l
flag:
$ pyssianutils print potential -l Files.txt
Path/To/Files/File1.log -11111
Path/To/Files/File3.log -33333
Path/To/Files/File2.log -22222
Finally the --verbose or -v option will raise an error for files that do not have a potential energy and will stop the execution.
thermo
Prints the Potential energy, Zero point energy, Enthalpy and Free energy from a gaussian frequency calculation. By default the Potential energy is the value of the 'Done'
usage: pyssianutils print thermo [-h] [-l] [-o OUTFILE]
[--method {oniom,mp2,mp2scs,mp4,ccsdt,default}]
[--only-stem] [-v]
files [files ...]
Positional Arguments
- files
Gaussian Output File(s)
Named Arguments
- -l, --listfile
When enabled instead of considering the files provided as the gaussian output files considers the file provided as a list of gaussian output files
Default:
False
- -o, --outfile
File to write the Data. If it exists, the data will be appended. If none is provided it will be printed to stdout
- --method
Possible choices: oniom, mp2, mp2scs, mp4, ccsdt, default
When not provided it will attempt (and may fail) to guess the method used for the calculation to correctly read the potential energy. Otherwise it defaults to the Energy of the 'SCF Done:'
Default:
default
- --only-stem
only show the file stem instead of the full path
Default:
False
- -v, --verbose
if enabled it will raise an error anytime it is unable to find the thermochemistry of the provided file
Default:
False
Usage
The simplest way to use the print thermo
utils is to extract the
thermochemistry of a single calculation:
$ pyssianutils print thermo File1.log
File E Z H G
File1.log -11111 -11111 -11111 -11111
If the thermochemistry is not available but the potential energy is available, only the potential energy will be shown
$ pyssianutils print thermo File1*.log
File E Z H G
File1.log -11111 -11111 -11111 -11111
File1_SP.log -11111
Hint
As with the potential
util. We can specify multiple files either
manually or using a file that contains one filepath per line.
Finally the --only-stem
flag allows to shorten full filepaths to only
the filenames, without the suffix:
Path/To/Files/File3.log
Path/To/Files/File2.log
We can pass this file to pyssianutils with the -l
flag:
$ pyssianutils print thermo Path/To/Files/File1.log Path/To/Files/File1_SP.log --only-stem
File E Z H G
File1 -11111 -11111 -11111 -11111
File1_SP -11111
which, without the flag would instead output
$ pyssianutils print thermo Path/To/Files/File1.log Path/To/Files/File1_SP.log
File E Z H G
Path/To/Files/File1.log -11111 -11111 -11111 -11111
Path/To/Files/File1_SP.log -11111
summary
Prints the Potential energy, Zero point energy, Enthalpy and Free energy from a gaussian frequency calculation. By default the Potential energy is the value of the 'Done'
usage: pyssianutils print summary [-h] [-l] [-o OUTFILE] [--with-sp]
[--pattern PATTERN]
[--method {oniom,mp2,mp2scs,mp4,ccsdt,default,default}]
[--method-sp {oniom,mp2,mp2scs,mp4,ccsdt,default}]
[--only-stem] [-v]
files [files ...]
Positional Arguments
- files
Gaussian Output File(s)
Named Arguments
- -l, --listfile
When enabled instead of considering the files provided as the gaussian output files considers the file provided as a list of gaussian output files
Default:
False
- -o, --outfile
File to write the Data. If it exists, the data will be appended. If none is provided it will be printed to stdout
- --with-sp
if enabled it will try to match the pattern provided to compute the SP corrections from the files that match the pattern to provide the final energies
Default:
False
- --pattern
pattern used when matching the SP files, defaults to 'SP'
Default:
'SP'
- --method
Possible choices: oniom, mp2, mp2scs, mp4, ccsdt, default, default
When not provided it will attempt (and may fail) to guess the method used for the calculation to correctly read the potential energy. Otherwise it defaults to the Energy of the 'SCF Done:'
Default:
default
- --method-sp
Possible choices: oniom, mp2, mp2scs, mp4, ccsdt, default
When not provided it will attempt (and may fail) to guess the method used for the SP calculation to correctly read the potential energy. Otherwise it defaults to the Energy of the 'SCF Done:'
Default:
default
- --only-stem
only show the file stem instead of the full path
Default:
False
- -v, --verbose
if enabled it will raise an error anytime it is unable to find the thermochemistry of the provided file
Default:
False
Usage
The simplest way to use the print summary
utils is to extract the
thermochemistry of a single calculation:
$ pyssianutils print summary File1.log
File E Z H G
File1.log -11111 -11111 -11111 -11111
If the thermochemistry is not available but the potential energy is available, only the potential energy will be shown
$ pyssianutils print summary File1*.log
File E Z H G
File1.log -11111 -11111 -11111 -11111
File1_SP.log -11111
Note
For all terms and purposes print summary
behaves like
print thermo
while the --with-sp
is not specified.
When the --with-sp
flag is enabled, the util will attempt to find files
matching the name with a specific pattern at the end of the file stem (which
may be specified with the --pattern
flag. For the files in which it
finds a match it will display the E(SP)
and the G(SP)
computed
as
Therefore, going back to the previous example:
$ pyssianutils print summary File1*.log --with-sp
File File_SP E Z H G E(SP) G(SP)
File1.log File1_SP.log -11111 -11111 -11111 -11111 -11111 -11111