Contents

Release 97.2, May 1998

Table of Contents
1. Introduction
- What is the Discover® program?
- What Discover can do
- Comparison of C and FORTRAN versions
- CDiscover--Cerius2, Insight and standalone modes
- Accessing CDiscover
- How to use the documentation
- Electronic information sources
- Typographical conventions and terminology
2. CDiscover within Cerius2
- Preparing the model and forcefield
- Choosing the forcefield
- Building or loading models
- Assigning atom types and charges
- Defining charge groups
- Setting constraints
- Fixed atoms
- Constraints during dynamics
- Preparing the energy expression
- Nonbond interactions
- Parameter scaling
- What to do if some parameters cannot be assigned
- Setting up the simulation conditions
- Single-point energy and gradient calculations
- Minimization
- Specifying the minimization algorithm
- Setting convergence criteria
- Maximum number of iterations
- Dynamics
- Defining the timestep
- Defining the thermodynamic ensembles
- Controlling temperature, pressure, and stress
- Type of dynamics simulation
- Stages of a dynamics run
- Setting up and starting the run
- Specifying output
- Specifying how and where to send the job
- Interactive vs. background or NQS run mode
- Selecting a machine and base directory
- Setting up NQS-mode jobs
- Monitoring and controlling running jobs
- Transferring files from one machine to another
- Other file-control issues
- Starting the run
- Analyzing results
- Preparing trajectories
- Loading or creating a trajectory
- Selecting frames from a loaded trajectory
- Output from analysis
- Displaying model conformations
- Output as graphs and text
- Output in tables format
- Property statistics
- Basic statistics of various properties
- Mean-square displacement
- Self-diffusion constant
- Velocity autocorrelation
- Power spectrum
- Radial distribution function
- Structure factor
- Dipole-dipole interactions
- Fluctuation analysis
3. CDiscover within Insight
- General procedure
- Setting up the ESFF forcefield
- CDiscover background jobs
- Using the Background_Job pulldown
- Setting up a background job
- Interactive screen coordinate updates
- Examining completion status
- Killing a background job
- In case of run errors
- Tutorial--The Insight Environment
- Pilot online tutorials
- Tutorials in hypertext format
- Overview of tutorial lessons
- Lesson 5: Generating a phi/psi map
- Command Summary--The Insight Environment
- Setup pulldown
- Strategy pulldown
- Specify pulldown
- Calculate pulldown
- Language_Control pulldown
- Analyze pulldown
- Pseudo_Atom pulldown
- Background_Job pulldown
- D_Run pulldown
4. Standalone CDiscover
- Input files required
- Overview of BTCL commands
- Calculation commands
- Commands for calculation setup and analysis
- Input commands
- Output commands
- Control commands
- Exiting a BTCL session
- Defining and using your own procedures
- Performance and convenience
- Databases
- Objects
- Initiating a run
- Direct method
- Using the interactive utility
- File redirection method
- Running CDiscover in parallel
- Scripts and program initialization
- An example CDiscover run
- Input files
- Explanation of command input file
- Initiating the run
- History file support
- Editing the ESFF forcefield parameters
- Tutorial--Standalone Mode
- Overview of tutorial lesson
- Lesson 1: Using BTCL and TCL commands to manipulate the geometry of two helices
- Command Summary--Standalone Mode

APPENDICES
A. Btcl Language and Commands--Standalone Mode
- MSI (Biosym) Tcl language syntax
- General programming syntax
- Variables and expressions
- Special characters and the expr and eval commands
- Control statements
- Conditional statements: if, else, and elseif
- Conditional looping statements: while, for, and foreach
- Btcl procedures
- Btcl commands and utilities
- Btcl command parameter types
- Global Btcl and Tcl variables and environment variables
- Exiting a Btcl session
- Conventions in documentation of Btcl commands
- Font conventions for keywords
- Assignment and types of values
- Punctuation conventions
- Command descriptions
- analyzeNonbond
- atomMovability
- begin
- cellParameter
- database
- $dbHandle
- diffraction
- discoverHistory
- dynamics
- energy
- energyContribution
- forcefield
- geometry
- help
- minimize
- molGeom
- object
- output
- peek
- print
- pseudoAtom
- rattle
- readFile
- reset
- restraint
- select
- subset
- subStructure
- vdWTailCorrection
- vector
- vibrationalAnalysis
- writeFile
B. Databases and Tables
- Introduction to databases and tables
- Introduction
- Illustrations
- Data types for columns
- System database
- Introduction
- Contents of the system database common to all systems
- Atom table
- Monomer table
- Molecule table
- NonbondGroup Table
- Bond table
- Contents of the system database for periodic systems
- Introduction to symmetry and periodicity
- Differences from simple systems
- Descriptions of new and augmented tables
- Contents of the system database for systems with symmetry and periodicity
- Differences from simpler systems
- Descriptions of new and augmented tables
- Subset tables
- PseudoAtom table
- Internal energy exclusion
- Nonbond energy exclusion
- Consensus dynamics
- Energy database
- Introduction
- Contents of the energy database
- Values table
- Atom table
- Accessing the energy database
- Minimize database
- Dynamics database
- Miscellaneous examples
C. Discover Interprocess Communication (IPC)
- Purpose
- Background
- IPC components
- Discover Btcl IPC commands
- MSI IPC client application program interface
- ipc procedure
- Common IPC operations
- Advanced IPC operations
- Common IPC operations
- init
- Advanced IPC operations
- accept
- connect
- eval
- listen
- poll
- send
- server
- Interprocess communication for Discover--discoverIO
- discoverIpc
- eval
- poll
- connect
- listen
- accept
- MSI IPC C application program interface
- Background
- C functions for IPC
- BiosymIpc_Init
- BiosymIpc_Shutdown
- BiosymIpc_Read
- BiosymIpc_Write
- BiosymIpc_Print
- BiosymIpc_VarWrite
- BiosymIpc_WriteRawBtcl2
- BiosymIpc_WriteRawBtcl
- BiosymIpc_SetChannel
- BiosymIpc_GetError
- BiosymIpc_GetLocalVersion
- BiosymIpc_GetRemoteVersion
- MSI IPC FORTRAN application program interface
- Background
- Subroutines
- BiosymIpc_Initf
- BiosymIpc_ReadHeaderf
- BiosymIpc_ReadString128f
- BiosymIpc_WriteIntegerf
- BiosymIpc_WriteReal8f
- BiosymIpc_WriteStringf
- BiosymIpc_WriteString128f
- BiosymIpc_WriteBtcl128f
- BiosymIpc_WriteRawBtcl128f
- BiosymIpc_GetErrorf
- BiosymIpc_GetLocalVersionf
- BiosymIpc_GetRemoteVersionf
- BiosymIpc_Int2Charf
- BiosymIpc_Char2Intf
- BiosymIpc_ReadIntegerf
- BiosymIpc_ReadReal8f
- BiosymIpc_ReadStringf
- MSI IPC C language structures
- Background
- IPC frames
D. Files
- Introduction
- Command input file (.inp)
- Sample CDiscover .inp file
- Forcefield parameter file (.frc)
- Format of .frc file
- Version and reference numbers
- MSI file identification
- Forcefield version
- Atom types
- Equivalence table
- Hydrogen bond donors and acceptors
- Quadratic bond-stretching potential
- Quartic bond-stretching potential
- Morse bond-stretching potential
- Quadratic angle-bending potential
- Quartic angle-bending potential
- Quadratic bond-bond interaction potential
- Quadratic bond-angle interaction potential
- One-term torsion potential
- Three-term torsion potential
- Four-term torsion potential
- Angle-angle-torsion interaction potential
- Peripheral bond-torsion interaction potential
- Central bond-torsion interaction potential
- Three-term angle-torsion interaction potential
- Out-of-plane potential, improper torsion definition
- Out-of-plane, Wilson definition
- Out-of-plane interaction potential using improper torsion definition
- Angle-angle interaction potential
- 6-9 Nonbond (van der Waals) potential
- 6-12 Nonbond (van der Waals) potential
- 10-12 Hydrogen bond potential
- Bond increments
- Standard output file (.out)
- CDiscover output files (.arc, .xfrc, .out, .tbl, .xdyn, user-named)
- Discover dynamics restart files (.xdyn)
- Automatic potential parameter assignment
- ESFF structure output file (.esf)
- ESFF forcefield parameter file (.epa)
- Torsion information
- Dynamics tabular output for energies (.gre)
- Dynamics tabular output for thermodynamic states (.grp)
- Dynamics scratch file (.pre)

INDICES
List of Tables
Tcl man pages
General Index
Last updated January 8, 1998.
Copyright © 1997, 1998, Molecular Simulations, Inc. All rights
reserved.