Advanced Building Features

In this section, we look at the special purpose building features designed for specific tasks and circumstances.

Using a Custom Fragment Library

The Custom Fragment button can be used to access and modify a local fragment library. Clicking on it when it is inactive activates the last used custom fragment library; the first fragment within it becomes the current fragment, appearing in the area below the toolbars and in the popup menu to the right of the various building buttons. Clicking on the same button when it is selected opens the Custom Fragments palette, bringing up the window in Figure 28.

p_custom.tif

Figure 28. The Custom Fragments Window

This palette allows you to select from the available fragments in the open library. The selected fragment will become the current fragment once the dialog is exited.

The Library field at the top of the palette indicates the fragment library that is in use. Previously opened libraries are also present in the list. Additional library locations may be opened by clicking on the button labeled “...”.

Fragment libraries are simply folders on disk, and individual fragments within a library are stored as files within that folder. Thus, creating a new fragment library consists of creating a folder at the desired location and then selecting it in this palette. The library will obviously be initially empty. Any non-fragment files within the folder are ignored, although best practice is to limit fragment library folder use solely to fragment files.

Fragments within a fragment library are organized into a series of user-defined groups. If this feature has not been used, then all fragments will be within the “root” group: i.e., / as in the figure.

A context menu, reached by right clicking within the white fragment list area in the center of the palette, is used to manage and modify fragment libraries. It has the following selections:

Note that fragments within a library can be updated only by removing and then readding them (there is no way to modify an existing fragment).

The Atom List Editor

The Atom List Editor window is displayed when you select the Edit=>Atom List menu item or click on the Atom List button. This tool presents the coordinates and other parameters for the molecule in the active View window in an editable spreadsheet format. The window’s default configuration is illustrated in Figure 29.

ed_aed.tif

Figure 29. The Atom List Editor

The columns that are present in the table are controlled by the buttons in the toolbar. Columns corresponding to highlighted buttons are visible. Only buttons relevant to the current molecular structure are active. Individual columns may be displayed/hidden using the items on the Columns menu. You can also go directly to a specific atom (by number) using the Go To control in the toolbar.

The default configuration of this window displays the molecule’s Z-matrix and Cartesian coordinates. Different data can be selected for display using the toolbar buttons. From the left, they control Z-matrix coordinates (Z), Cartesian coordinates (C), fractional coordinates for PBC jobs (F), ONIOM layer assignments and related settings (L), Molecular Mechanics atoms types and other data (M), Isotope specification (I), and PDB file residue and chain data (P). Columns corresponding to the final button are read-only. Figure 26 illustrates the columns that may be present in this window. Clicking one of the lettered display icons will show or hide all columns in that group. You can also control the display of every individual column by selecting or deselecting it in the Columns menu.

ed_aed_more.tif

Figure 30. Additional Atom List Editor Columns

Beginning at the top and moving down and from left to right, these columns are controlled by the ONIOM Layers button, the Molecular Mechanics Parameters button, the Fractional Coordinates button, the PDB Info button, and the Isotope Masses button. Note that shaded columns are read-only.

Any of the molecular parameters can be edited in this spreadsheet-like window. Atoms may be selected by clicking on their Row cell in the leftmost column (and deselected by clicking it a second time). The dot in the Highlight column causes the corresponding atoms to also be selected/deselected in the molecule’s View window.

You can add additional atoms by scrolling to the bottom of the window, selecting an element in the Symbol column, and then clicking the Add button. This inserts a new row into the list (filled with default values, as in Figure 30 above).

The various menu items in the Atom List Editor window are described below. The File menu includes items related to saving and printing the data in the table:

The Edit menu items allow you to modify the contents of the molecule specification:

ale_mmcharges.tif

Figure 31. Assigning MM Charges with the Atom List Editor

This dialog is used to automatically assign charges to atoms for use in Molecular Mechanics calculations. The Target menu specifies which atoms should be assigned charges: all atoms, all selected atoms, or all atoms currently lacking an MM charge. The Action menu specifies which charge scheme should be used. Amber94 charges are always available. The other options in the list are available when they have been previously computed for the structure in a Gaussian calculation.

The View menu controls atom highlighting within view windows while the Atom List Editor is in use. Each item in the first section is a toggle, and check mark next to it within the menu indicates that it is enabled:

The remaining items on the View menu have the following effects:

The Rows menu controls whether some or all atoms within the molecule are visible in the table and also provides some shortcuts for selecting groups of atoms:

The Columns menu allows you to specify which columns appear in the table on an individual column basis. The first few items in the menu correspond to the default columns in the table, which are independent of the various column display buttons. The Freeze and Gaussian Fragment items further down in the list function in the same way.

You can select which columns appear for the Z-matrix Coordinates, Fractional Coordinates, ONIOM Layers, PDB Info, Isotope Masses and Molecular Mechanics Parameters buttons via the corresponding submenus. The Cartesian Coordinates item has the same function as the corresponding button although individual coordinates cannot be selected separately.

The Help menu item provides help for the Atom List Editor.

Using Sublist Filters

Sublist filters are a means of limiting the visible rows within the Atom List Editor to a manageable number for large molecules. They are defined by means of a dialog reached with the Atom List Editor’s Rows=>Sublist Filters menu path, illustrated in Figure 32.

ed_aed_sublist.tif

Figure 32. Creating Sublist Filters

This dialog allows you to create and apply sublist filters which are used to limit the rows which are displayed within the Atom List Editor. In this case, we apply two filters in succession: Filter 1 selects atoms in the High ONIOM layer and Filter 2 selects oxygen and nitrogen atoms within that subset.

To use the facility, you must first create a filter using the New Filter button. Filters are always named Filter n and cannot be renamed. The filter is defined using items from within the Criteria list; the popup menu displays the available categories of criteria items. In the figure, we are using the ONIOM category to define Filter 1. Select one or more criteria from the list and then use the > button to move them to the selected filter. Although we have not done so in the example, items from different Criteria categories can be combined with the same filter.

The >> button will similarly move all items within the list. Items can be removed from filters using the < and << items, to remove the selected item and all items (respectively). An entire filter is removed with the Remove Filter button.

Criteria within filters are combined with an OR logic: any atom matching any criterion will be displayed (or not, according to the settings on the Atom List Editor’s Rows=>Sublist submenu). Filters are activated and deactivated by selecting/deselecting the check box to the left of their name. When only a single filter is active, all atoms matching that filter are affected. When more than one filter is active, then all active filters are applied in series, in the order in which they are listed within the dialog, according to an AND logic. For example, Filter 2 is applied only to the matching atoms remaining after applying Filter 1. Subsequent filters will never enlarge the selection resulting from a previous filter, but rather only filter it further.

The available Criteria categories are:

Filters are specific to individual molecule groups, and they do not persist across different sessions for the corresponding input file. In other words, if you close and reopen the input file or if you exit and restart GaussView, current filters are lost.

Defining Isotope Masses and Isotopologues

ale_iso_menu.tif
The Atom List Editor provides an easy way for specifying alternate isotope masses for atoms which are relevant for some calculation types (e.g., vibration frequency analysis). By default, Gaussian assigns the most abundant isotope to each atom in a molecular structure. You can specify a different isotope by enabling the Isotope Masses button. Doing so will reveal a column titled Mass (Isotopologue 0). Each cell in the column contains a popup menu listing the possible isotopes for the element in that row of the table. You can select the desired isotope from the menu, or you may enter the desired value directly into the field. The Default choice always refers to the most abundant isotope.

You can define multiple isotopologues for the structure by adding additional columns to the table via the Columns=>Mass=>Mass (Isotopologue n) menu paths. These can be used for subsequent vibrational analysis visualization (discussed later).

The PDB Residue Editor and The PDB Secondary Structure Editor

Examining and modifying structures imported from PDB files may be made easier by the PDB Residue Editor and PDB Secondary Structure Editor, reached via the correspondingly named items on the Edit menu. They are illustrated in Figure 33.

The menus in these editors are very similar to those in the Atom List Editor discussed in the previous section. Briefly, they are:

ed_pdb.tif

Figure 33. The PDB Residue and PDB Secondary Structure Editors

The PDB Residue Editor (top) and PDB Secondary Structure Editor provide mainly read-only views of residue and other data assigned in PDB files. The Display column can be used to hide the atoms in certain residues/secondary structures for easier viewing of the molecule’s key features. The Highlight column can be used to highlight the atoms corresponding to the selected item. In this example, we have highlighted residue 12 in chain A making it easy to locate in the View window below.

The Connection Editor

The Connection Editor, reached via the Edit=>Connection menu path, can be used to determine whether proper atom ordering is maintained throughout a molecule group. You can also use it to automatically reorder atoms to align atom tags between related structures across a molecule group (useful for preparing structures for QST2 and QST3 transition structure optimizations). Manual atom reordering is also possible.

When the Connection Editor is active, the molecule will be analyzed to determine if the atom tags match across the entire molecule group, and the status bar will report the result. If potentially fixable mismatches are detected, the dialog will report this and suggest that the user Enable Autofixing. Clicking on the corresponding button will tell the Connection Editor to reorder the atom labels to remove these mismatches. The success or failure of autofixing will be reported on the status bar. When autofixing is active, any manual reordering of atom tags will cause autofixing to be called and remove any mismatches that might have been introduced.

When active, autofixing can be disabled using the relabeled Disable Autofixing button. When autofixing is not applicable, the button is relabeled as No Autofixing.

bld_conn_ed.tif

Figure 34. The Connection Editor

The Connection Editor is used to verify and assign atom equivalences in two molecular structures. When working with a molecule group, viewing in multi-geometry mode allows easier comparison and editing. In this contrived example, we need to swap the ordering of atoms 3 and 4 in one of the models in order for the atoms to correspond properly. This can be done by clicking on the Enable Autofixing button or via a manual process.

Atoms can also be manually reordered by using the mouse. These operations use a reference atom as their basis (see the first bullet):

The Apply to Molecule Group checkbox determines whether the Connection Editor’s actions apply only to the current model or to all models within the molecule group.

The ZMat Tools popup allows you to perform some Z-matrix operations on the molecule or molecule group:

The other items on this popup menu do not apply to Gaussian.

The Redundant Coordinate Editor

The Redundant Coordinate Editor allows you to create and edit redundant coordinates for use with Gaussian optimizations or potential energy surface scans. It is accessed via the Edit=>Redundant Coordinates menu path or the Redundant Coordinate Editor button. It is illustrated in Figure 35.

The central feature of this dialog is a scrollable list containing information on each of the coordinates. A pencil icon in the status column marks that coordinate as the currently active coordinate. A warning sign in the status column indicates that that coordinate is incomplete or invalid. When the currently active coordinate is invalid or incomplete, the status bar at the bottom describes the nature of the warning. The coordinate column contains a brief description of the coordinate and its parameters.

ed_redun.tif

Figure 35. The Redundant Coordinate Editor

We are adding the bond coordinates for the two selected atoms so that its distance will be reported in the optimization output (even though the atoms are not in fact bonded to one another). The list in the window also shows 2 other coordinates we added.

A toolbar at the top provides buttons for adding a new coordinate, deleting a coordinate, and moving an item up or down in the list. Adding a new coordinate creates an unidentified coordinate, which is placed in the list just after the currently active coordinate and becomes the active coordinate.

All of the available redundant internal coordinate types are supported by the various selections in the two popups in the Coordinate area, and the items on these menus are self-explanatory. Any additional fields required by a specific coordinate type will appear in the panel when the type is selected. See the discussion of Opt=ModRedundant in the Gaussian 09 User’s Reference for more information. The Set/Don’t Set popup and related fields allow you to specify the value of a coordinate or an increment to its current value.

When exiting the Redundant Coordinate Editor, if any coordinates are still invalid or incomplete, you will be notified and given the option of continuing to edit. If you exit anyway, any invalid coordinates will be deleted.

Specifying ONIOM Layers

Choosing the Edit=>Select Layer menu item or clicking on the Select Layer button opens the Layer Selection Tool. This window is used to assign atoms to ONIOM layers graphically. It is illustrated in Figure 36.

There are several methods for selecting atoms for layer assignment:

ed_layer.tif

Figure 36. Assigning Atoms to ONIOM Layers

This dialog allows you to assign atoms to layers for ONIOM calculations. Different layers are indicated by the different display formats. Here, the atoms in the ring at the left are selected for layer assignment.

For distance based atom selection, the distance between atoms to be selected depends on the following criteria, selected in the Using popup menu:

Layer Selection by PDB Residue

ed_layer_pdb.tif

Figure 37. Selecting Atoms for Layer Assignment by PDB Residue

This dialog allows you to specify the desired residue by residue name (type), residue number and/or chain (A or B). Omitted items act as wildcards. For example, if you enter only residue number 22, then residue 22 in both chains will be selected. Similarly, entering only a residue name will cause all residues of that type within the molecule to be selected.

Confirming Layer Assignments

Once atoms are selected, you must click on the Apply button to assign them to that layer. Note that clicking on Apply turns off the selection. If you close the panel without applying your changes, they will be lost.

Layer Display Formats

By default, atoms in different layers are displayed in different formats in the View window. Using the standard settings, atoms in the High layer appear in ball-and-stick format, atoms in the Medium layer are displayed as tubes, and atoms in the Low layer are in wireframe format. These can be customized with View=>Display Format for the current molecule or, for all future views, via the corresponding fields in the Molecule panel of the Display Format Preferences.

The Molecular Orbital (MO) Editor

The Edit=>MOs menu path and the MO Editor button both open the MOs window, illustrated in Figure 32. It is used to inspect molecular orbitals (MOs) from Gaussian calculations—MO energy and occupancy diagrams, visualized MO isovalue surfaces—as well as to quickly generate new MOs and/or visually select active-space MOs to be used for CASSCF calculations.

ed_mo.tif

Figure 38. The MO Editor

This window is used for examining molecular orbitals visually and potentially rearranging their occupancies and/or ordering for a subsequent Gaussian calculation. Here we are viewing MO 20, one of 5 available surfaces (and 2 selected MOs).

The MOs dialog has its own embedded View window for displaying the molecule and surface corresponding to the currently selected MO (if available). This embedded view is read-only and cannot be used to edit the molecule. In viewing functionality, it functions almost identically to a standard View window in terms of includes keyboard and mouse controls for translating, rotating, and zooming the molecule, accessing the context menu, and so on. (See the discussion of manipulating views earlier in this chapter and that concerning surfaces in “Viewing Gaussian Results” for details.)

The size of the Current Surface window can be changed by resizing the entire MOs dialog. Its width can also be adjusted by clicking and dragging on the partition between it and the MO diagram. This adjusts the relative widths of the two windows.

MOs can be selected for visualization, inclusion in future calculation, and other operations by left-clicking on them. Selected MOs are highlighted in yellow. If a surface is available for an MO, a small square appears to the right of the MO. The square is red for the MO whose surface is currently being viewed. Clicking on a different MO’s grey square will change the Current Surface View to show that MO’s surface.

The bottom portion of the window contains four panels:

The Visualize panel is visible in Figure 39. The various fields in it specify which orbitals should be visualized, along with two surface generation parameters (the isodensity value and the grid density, via the Isovalue and Cube Grid fields, respectively). The Add Type popup contains items which specify which MOs to visualize; its options are generally self-explanatory with the possible exception of Current List (regenerates the orbitals listed in the Current List field) and Other (specifies the arbitrary list of orbitals present in the editable Add List field). Note that GaussView attempts to keep the Add List and Add Type fields synchronized. Clicking the Update button will generate the requested orbital surfaces.

Figure 39 displays the other panels present in the MO Editor (stacked on top of one another), each of which will be discussed in the course of the remainder of this section.

ed_mo_3.tif

Figure 39. The MO Editor’s New, Calculation and Diagram Panels

Each panel shows a typical use for it (and not necessarily the default settings).

Modifying Orbital Occupancies, Molecular Charge and Spin Multiplicity

ed_mo_mv.tif
To the right of the Current Surface is the MO energy and occupancy diagram showing the MOs for the current molecule if available, initially arranged in order of increasing energy. Alpha and Beta electrons are represented by red up and down arrows in a blue box, respectively. Electrons can be moved from one MO to another by dragging them between the corresponding boxes. Electrons can also be added or removed from an MO by right-clicking in the MO box. Manipulating the MO occupancies in this way changes the net charge and/or spin multiplicity of the molecule as appropriate, reflected in the Charge and Spin fields. These fields can also be edited directly, and any changes will be reflected in the MO occupancies. Increasing the charge will remove electrons from the MOs, starting with the HOMO. Decreasing the charge will add electrons to the MOs, starting with the LUMO (or the HOMO if it is singly occupied). Similarly, increasing the spin multiplicity will move electrons from the highest doubly occupied MOs to the lowest virtual MOs, and decreasing the spin multiplicity will move electrons from the lowest-energy singly occupied MOs to the highest-energy singly occupied MOs. Finally, modifying the charge will also affect the spin multiplicity if the charge is changed by an odd number.

Controls in the Calculation panel also serve this purpose. The Adjust Occupancies popup contains two choices:

Controlling the Orbitals Display

The Diagram panel controls the orbital diagram. The Arrange MOs popup allows you to order orbitals by increasing energy, by occupancy, or by CI; the latter is appropriate for creating a CAS active space (see below). The Degeneracy Threshold sets the value below which to consider orbital energies as equal. This feature is illustrated in Figure 40.

ed_mo_degen.tif

Figure 40. Degenerate Orbitals in the MO Editor

This MO display for NH3 illustrates how degenerate orbitals appear in the orbital display area. Note that we have modified the Degeneracy Threshold from its default value of 0 to allow GaussView to detect the degenerate MOs.

Generating and Retrieving MOs

The New MOs panel allows you to read-in or generate MO data, depending on the setting of the Method popup. When it is set to Load Existing Chk File, you can read in orbital data from a checkpoint file by specifying its location and then clicking Load.

When Method is set to Generate New Chk File, the Model and Basis Set areas specify the calculation model for generating orbitals. The fields labeled Model specify the initial guess type, localization method and wavefunction type, while the desired basis set is specified in the fields below these. The fields in the second line of this panel specify the basis set to use for the Gaussian calculation. Consult the discussion of the Guess keyword in the Gaussian 09 User’s Reference for more information on the various fields and choices. Clicking Generate will launch a Gaussian job to generate the orbital data (calculation type is Guess=Only).

Rearranging Orbital Ordering

The Permutation List control in the Calculation panel displays the current orbital reordering at any given moment; it is initially empty. The popup in this area offers three choices for orbital reordering:

Miscellaneous Options

The Diagram panel contains two additional controls:

Building Periodic Systems with the Crystal Editor

The Edit=>PBC menu path and the Crystal Editor button both bring up the PBC window. This tool is used to specify unit cells for periodic systems. In order to use this feature, as well as to perform Periodic Boundary Conditions calculations in Gaussian, you will need some understanding of periodic systems, space groups, and general related terminology. This background is assumed in this section.

The window contains five panels:

From the highest-level view, a typical process of building a periodic system might proceed as follows (consult the PBC tutorials in the GaussView online help for more detailed instructions):

[1] Use the Symmetry panel to specify the number of dimensions and desired space group.

[2] Add atoms to the cell using the mouse or via the Contents panel.

[3] Remove any unwanted atoms (e.g., if you used a fragment as a shortcut to creating the necessary atoms).

[4] Set the unit cell size using the Cell panel.

[5] Adjust bonding using the Contents panel if appropriate.

[6] Reduce cell contents if appropriate.

[7] Specify display properties using the View panel as desired.

The controls in each of the PBC window panels will be described in turn in the following subsections.

The Symmetry Panel

The Symmetry panel is displayed in Figure 41. It contains the following controls:

ed_pbc_symm.tif

Figure 41. The PBC Symmetry Panel

This panel shows settings for a 3D periodic system constrained to the indicated space group.

These controls appear in the Current Space Group panel:

These controls appear in the Approximate Space Groups area of the panel:

The Symmetrize button will symmetrize the system to exactly belong to the specified space group.

The Contents Panel

The Contents panel contains an embedded mini Atom List Editor which functions like the corresponding tool. It is illustrated in Figure 42. The controls at the top of the panel are:

ed_pbc_content.tif

Figure 42. The PBC Contents Panel

This panel displays an atom list for the contents of the unit cell. It also contains the Bonds button which allows you to rebond atoms as appropriate, typically after modify parameters with the Cell panel (see Figure 43).

ed_pbc_add.tif
Adding atoms with this panel uses a procedure similar to that with the Atom List Editor. There is an Add button in the final row of the table (row 1 when the table is empty). In order to activate it, you must enter an element type into the column. You can also use the remaining columns to specify the fractional coordinates for the new atom. Note that additional atoms will also be added when you click Add in order to conform to space group constraints.

 

The Cell Panel

The Cell panel is displayed in Figure 43.

The Cell Changes popup specifies what should happen to the cell contents when the cell parameters are changed. When Fix Contents’ Cartesian Coordinates is selected, the contents of the cell and their Cartesian coordinates after a change are the same as before the change, provided the atoms are still within the cell boundaries.

The setting of the Add/Remove Atoms checkbox affects the operation of this choice:

When Cell Changes is set to Fix Contents’ Fractional Coordinates, the contents of the cell and their fractional coordinates after a change are the same as before the change. For example, if there is one atom in the cell with fractional coordinates (1/2, 1/2, 1/2) and the length of a is then doubled, the contents of the cell will still be one atom with fractional coordinates (1/2, 1/2, 1/2). This option is often the more useful of the two.

ed_pbc_cell.tif

Figure 43. The PBC Cell Panel

This panel is being used to resize the unit cell. The values in the disabled fields are predetermined by the space group to which the structure is constrained (see the Symmetry panel in Figure 35).

The controls in the Cell Lengths and Cell Angles areas control the geometry of the cell:

Figure 44 illustrates the GaAs unit cell we are working on after specifying cell lengths as in Figure 43 and then rebonding in the Contents panel (see Figure 42).

ed_pbc_rebonded.tif

Figure 44. Modified and Rebonded GaAS Unit Cell

View appearance after the operations in Figures 42 and 43.

The fields in the next two rows of the panel control placement of the cell vertices (which define the boundaries of the unit cell):

The five buttons at the bottom of the panel have the following purposes (the examples use a 3D cell):

The Reduce Panel

The Reduce panel is displayed in Figure 45. It contains the following controls:

ed_pbc_reduce.tif

Figure 45. The PBC Reduce Panel

This panel is used to convert a unit cell to one having a lower dimensionality. Here, we are reducing a palladium 3D cell to a surface two atoms deep. The light colored plane indicates the cut.

The View Panel

The View panel is displayed in Figure 46. It contains the following controls:

ed_pbc_view.tif

Figure 46. The PBC View Panel

This panel specifies how many unit cells appear in the View window. The View window shows a 3D gallium arsenide structure. Two cells in each direction are displayed. The contents of replicate cells are displayed using the Low Layer display format (their default display mode).

Specifying Fragment Placement Behavior

i_fragplace.tif
The small triangle above the Current Fragment area of the GaussView control window can be clicked to reveal some advanced options to specify how new fragments are joined to an existing molecular structure. The Mode popup allows you to select the settings (in which case, all fields are disabled), to specify Custom settings, or to restore the previously-used (Old) non-default settings (also nonmodifiable). You must select Custom in order to make changes to these items. The values for these three groups of settings can be specified in the Building Preferences.

There are two panels in this area. The Before panel, pictured in Figure 47, sets restrictions for how fragments may be added to a structure. The After panel (see Figure 48) specifies how the structure is treated after a fragment is added.

Here are some preliminary definitions necessary for understanding the options in these panels:

These are the items in the Fragment Placement Before panel:

bld_before.tif

Figure 47. Fragment Placement Restrictions

The items in this window set restrictions on the circumstances in which fragments may be joined to an existing structure. This window shows the default values.

bld_after.tif

Figure 48. Structure Options After a Fragment Placement

The options in this panel allow you to select actions for GaussView to perform automatically after a fragment is added to a molecular structure. The settings in this example are the defaults.

These are the items in the After panel:

The next three items activate electron bookkeeping at the target atom site. Note, however, that non-terminal atoms are not affected. Also, GaussView does not reduce or elevate the bond type to satisfy valency requirements.

The remaining options enable automatic cleaning operations, and they are self-explanatory: Optimize Dihedral Angle About New Bond, Apply “Clean” Around Hot Atoms, and Apply “Clean” to Whole Structure.