Image structure Image document-open


Reading structures from Gaussian log files.


structure.read_gaussian(file=None, dir=None, set_mol_name=None, set_model_num=None, verbosity=1)

Keyword arguments

file: The name of the Gaussian log file.

dir: The directory where the file is located.

set_mol_name: Set the names of the read molecules. If unset, then the molecules will be automatically labelled based on the file name or other information. This can either be a single name or a list of names.

set_model_num: Set the model numbers of the loaded molecules. This can be a single number or list of numbers.

verbosity: The amount of information to print out. Set to zero to silence the user function, or one to see all messages.


The atomic positions from a Gaussian log file can be read into relax. If optimisation has been preformed, the last set of atomic coordinates from the log will be read to obtain the final structure. The log file can be Gzip or Bzip2 compressed.

The setting of molecule names is used to name the molecules within the Gaussian file. If not set, then the molecules will be named after the file name, with the molecule number appended if more than one exists. By setting the molecule name or setting the model number, the loaded structure can be stored as a specific model or as a different molecule.

Prompt examples

To load all structures from the Gaussian file `taxol.log' in the directory `~/logs', including all models and all molecules, type one of:

relax> structure.read_gaussian('taxol.log', '~/logs')

relax> structure.read_gaussian(file='taxol.log', dir=logs')

The relax user manual (PDF), created 2024-06-08.