DelPhi



3       DelPhi-Insight Command Summary

This chapter briefly describes the functionality of each pulldown and its associated commands. As with Insight commands, DelPhi commands are organized in a hierarchy. At the top of the organization are the modules, next are the pulldowns, and at the bottom of the hierarchy are the commands. The five DelPhi module pulldowns are Setup, Run_DelPhi, Potential, Templates, and Grid. The commands in each pulldown are described below.


Setup Pulldown

The Setup pulldown contains commands which define the DelPhi calculation parameters and input/output files. A typical DelPhi calculation begins by using one or more of these commands to set up the desired calculation conditions.

Boundary Command

The Setup/Boundary command defines the treatment of the grid points at the boundary of the DelPhi calculation grid. This includes the method used to assign values to the boundary points, as well as setting periodic bounds.

Grid Command

The Setup/Grid command defines and displays the 3-dimensional grid used in the DelPhi calculation. Three basic parameters must be specified to define the grid: the Grid Center, Grid Size, and Grid Resolution.

Solute Command

The Setup/Solute command defines the characteristics of the solute region, which consists of all points inside the solvent-accessible surface of the molecule.

The characteristics that may be defined are the atomic charges and radii and the solute dielectric constant.

Solvent Command

The Setup/Solvent command defines the characteristics of the solvent region, which consists of all points outside the solvent-accessible surface of the molecule.

The characteristics that can be defined are the solvent dielectric constant; the solvent radius, which is used for calculation of the solvent-accessible surface; the ionic strength of the solvent; and the ionic radius, which is used to create a Stern layer around the solvent surface.

Iterations Command

The Setup/Iterations command defines the form of the Poisson-Boltzmann equation used (linear or nonlinear), the number of iterations of each type, and the convergence criteria used to halt the calculation.

Energies Command

The Setup/Energies command specifies the electrostatic energy values which DelPhi calculates. DelPhi is capable of calculating the total electrostatic energy, the reaction field energy, and Coulombic energies of the molecule.

Files Command

The Setup/Files command specifies the output files created by a DelPhi calculation, as well as the characteristics of the output data.

Initialize Command

The Setup/Initialize command allows you to perform a calculation using some previously defined set of calculation parameters. The command reads a DelPhi parameter file (.prm) and sets all the associated Setup parameters.

List_Setup Command

The Setup/List_Setup command gives a brief list of the current DelPhi calculation parameter values.


Run_DelPhi Pulldown

The Run_DelPhi pulldown contains commands that are used to run a DelPhi calculation.

Host Command

The Run_DelPhi/Host command is used to select the host computer on which the DelPhi job is run.

Run Command

The Run_DelPhi/Run command creates the input files needed for the DelPhi calculation, and then runs the calculation as a background process or stores the command script for you to submit later. In addition, you may specify specific frames from an archive file as input coordinates, and an identical DelPhi calculation is performed on each frame.


Potential Pulldown

The Potential pulldown contains commands that are used to compare and extract information from potential grids. These grids may be existing grid objects or they may be read from grid files.

Difference Command

The Potential/Difference command allows you to add or subtract two potential grids, to obtain a third grid. The resulting grid can be used to determine regions where potentials are more or less positive in one grid than in the other.

List Command

The Potential/List command lists the potentials and electrostatic field values for a specified set of coordinates and total electrostatic energy. The list can be sent to the textport or to a file.


Templates Pulldown

The Templates pulldown contains commands to create new, or modify existing, charge or radius template files. Such a file contains a series of templates (or rules) that specify the charge or radius value to assign to all atoms matching the template.

Charge_Edit Command

The Templates/Charge_Edit command allows you to create or modify a charge template file. A charge template file can be specified using the Solute command of the Setup pulldown to assign atomic charges for a DelPhi calculation.

Radius_Edit Command

The Templates/Radius_Edit command allows you to create or modify a radius template file. A radius template file can be specified using the Solute command of the Setup pulldown to assign atomic radii for a DelPhi calculation.


Grid Pulldown

The Grid pulldown is used to create and manipulate a potential grid for a given molecule. You may create and compute the potential grid, display and hide this grid, and write this grid to an output file that is readable by the Contour utility.

Get Command

The Grid/Get command retrieves grids from grid files.

Get also assigns grid objects a default name based on the grid file name. If you specify an explicit grid name with the Grid Name parameter, the Get command names the grid object according to the value you specified.

Put Command

The Grid/Put command allows you to write the grid data to a disk file. The output file name is specified in the File Name parameter. If no file extension is explicitly given, a default extension of .grd is added.

The File Format option is used to specify the format of data written out. Binary, Ascii, and Voxel_View are the available choices.

Display Command

The Grid/Display command is used to control the display of grid objects. The Grid Attribute parameter controls which attribute of the grid to operate upon. The Point Set parameter specifies which points are set. The Alternate Space parameter specifies which axes to use.

Color Command

The Grid/Color command is used to control the color of grid objects. The Grid Attribute parameter controls which attribute of the grid to operate upon. The Point Set parameter specifies which points are set.

Histogram Command

The Grid/Histogram command plots a histogram of the scalar values of the grid points. The computation of histogram can be restricted to points with values which fall within a specified range. The coarseness of the histogram can be controlled by specifying the number of bins. The histogram can be plotted with linear or logarithmic scale heights.

The histogram is normally scaled so that the largest bin fills the full width of the display. An exception to this rule occurs when the number of grid data points is small. When the number of datapoints in the largest bin is less than the maximum bar length, the histogram is unscaled. In other words, the number of asterisks ("*") plotted is equal to the actual integer number of points in each bin or (when the logarithm option is selected) the logarithm of the integer values.

The number of points lying outside the lower and upper limits (i.e., the "tails" of the distribution) are demarked by the symbols [<<<] and [>>>], respectively.

Contour Command

The Grid/Contour command creates a set of contours from a specified Insight grid. One contour is created for each of the contour levels you specify. A contour level is a curve (or surface) connecting all of the points in the given grid which have the same value. These contours may be automatically displayed or left undisplayed.

The Molecule Name parameter is the name of the molecule for which the grid to be contoured is defined.


Contour Pulldown

The Contour pulldown contains commands that allow you to create and manipulate the display of contour objects and their labels. Contour objects are objects that display constant values throughout a set of grid data, such as are output by the DelPhi, DMol, or x-ray crystal refinement programs. Contours can be draw as dots, lines, or solid surfaces and represent equivalent values of a given quality of a molecule.

The following commands in the Contour pulldown will be valuable to you in using DelPhi and Solvation. For a more complete description of the Contour pulldown, please see the Insight II User Guide.

Create_Single Command

The Contour/Create_Single command is used to create contours from grid files or grid objects. When reading from a grid file, a grid object is not created.

A contour object is created for the level selected using the slider box connected to the Level Specification parameter. Contours are given the name specified as the Contour Name parameter.

Contours can be created as Big_Dots, Dots, Lines, Solid contours, or created but Undisplayed as specified under the Display Style parameter. In most cases, the outside of a solid contour is the lighted side, but if a solid contour appears as a dark shape, then the normals should be inverted using the Contour/Recalculate command.

A contour created in the execution of the Contour/Create_Single command is initially given the color specified by the Color parameter. The color can be modified by the Contour/Color command.

Create_Range Command

The Contour/Create_Range command is used to create contours from grid files or grid objects. When reading from a grid file, a grid object is not created.

The range of levels may be specified based on the values of the Level Specification parameter. One contour object is created for each level. the contours are given the name specified in the Contour Name Root parameter, with a numeric suffix added to give a unique name for each level.

Contours can be created as Big_Dots, Dots, Lines, Solid contours, or created but Undisplayed as specified under the Display Style parameter. In most cases, the outside of a solid contour is the lighted side, but if a solid contour appears as a dark shape, then the normals should be inverted using the Contour/Recalculate command.

Contours created by the Contour/Create_Range command are given one of six unique color specifications. These colors can be modified by the Contour/Color command.




Last updated February 17, 1998 at 01:08PM PST.
Copyright © 1997, Molecular Simulations, Inc. All rights reserved.