%% Generated by Sphinx.
\def\sphinxdocclass{report}
\documentclass[letterpaper,11pt,english]{sphinxmanual}
\ifdefined\pdfpxdimen
   \let\sphinxpxdimen\pdfpxdimen\else\newdimen\sphinxpxdimen
\fi \sphinxpxdimen=.75bp\relax
\ifdefined\pdfimageresolution
    \pdfimageresolution= \numexpr \dimexpr1in\relax/\sphinxpxdimen\relax
\fi
%% let collapsible pdf bookmarks panel have high depth per default
\PassOptionsToPackage{bookmarksdepth=5}{hyperref}

\PassOptionsToPackage{booktabs}{sphinx}
\PassOptionsToPackage{colorrows}{sphinx}

\PassOptionsToPackage{warn}{textcomp}
\usepackage[utf8]{inputenc}
\ifdefined\DeclareUnicodeCharacter
% support both utf8 and utf8x syntaxes
  \ifdefined\DeclareUnicodeCharacterAsOptional
    \def\sphinxDUC#1{\DeclareUnicodeCharacter{"#1}}
  \else
    \let\sphinxDUC\DeclareUnicodeCharacter
  \fi
  \sphinxDUC{00A0}{\nobreakspace}
  \sphinxDUC{2500}{\sphinxunichar{2500}}
  \sphinxDUC{2502}{\sphinxunichar{2502}}
  \sphinxDUC{2514}{\sphinxunichar{2514}}
  \sphinxDUC{251C}{\sphinxunichar{251C}}
  \sphinxDUC{2572}{\textbackslash}
\fi
\usepackage{cmap}
\usepackage[T1]{fontenc}
\usepackage{amsmath,amssymb,amstext}
\usepackage{babel}



\usepackage{tgtermes}
\usepackage{tgheros}
\renewcommand{\ttdefault}{txtt}



\usepackage[Bjarne]{fncychap}
\usepackage{sphinx}

\fvset{fontsize=auto}
\usepackage{geometry}


% Include hyperref last.
\usepackage{hyperref}
% Fix anchor placement for figures with captions.
\usepackage{hypcap}% it must be loaded after hyperref.
% Set up styles of URL: it should be placed after hyperref.
\urlstyle{same}


\usepackage{sphinxmessages}
\setcounter{tocdepth}{1}


        \usepackage{charter}
        \usepackage[defaultsans]{lato}
        \usepackage{inconsolata}
    

\title{FFE User\textquotesingle{}s Guide}
\date{May 04, 2024}
\release{}
\author{TinkerTools Organization}
\newcommand{\sphinxlogo}{\vbox{}}
\renewcommand{\releasename}{}
\makeindex
\begin{document}

\ifdefined\shorthandoff
  \ifnum\catcode`\=\string=\active\shorthandoff{=}\fi
  \ifnum\catcode`\"=\active\shorthandoff{"}\fi
\fi

\pagestyle{empty}
\sphinxmaketitle
\pagestyle{plain}
\sphinxtableofcontents
\pagestyle{normal}
\phantomsection\label{\detokenize{index::doc}}


\sphinxstepscope


\chapter{Introduction}
\label{\detokenize{text/introduction:introduction}}\label{\detokenize{text/introduction::doc}}

\section{What is Force Field Explorer?}
\label{\detokenize{text/introduction:what-is-force-field-explorer}}
\sphinxAtStartPar
Force Field Explorer (FFE) is a graphical user interface to the Tinker suite of software tools for molecular modeling. The goal is to create a robust environment for computational chemistry, biomolecular modeling and molecular engineering applications. Current features of FFE include:
\begin{itemize}
\item {} 
\sphinxAtStartPar
Setup and real\sphinxhyphen{}time visualization of modeling routines, including local/global optimizations, molecular dynamics, sampling methods, superposition, docking, etc.

\item {} 
\sphinxAtStartPar
Basic 3D molecular visualization (wireframe, tube, spacefilled, ball \& stick, etc., and several coloring schemes) with special features for force field\sphinxhyphen{}specific parameters such as Lennard\sphinxhyphen{}Jones radii and partial charges, induced dipole vectors, and atomic force and velocity vectors.

\item {} 
\sphinxAtStartPar
A comprehensive editor for Tinker keyword files containing parameters and options that control modeling algorithms.

\item {} 
\sphinxAtStartPar
Playback of Tinker molecular dynamics trajectories and structure archives.

\end{itemize}


\section{Current Release}
\label{\detokenize{text/introduction:current-release}}
\sphinxAtStartPar
The current release of Force Field Explorer is denoted as Version 8.10 and dated July 2020 to mirror the corresponding Tinker 8.8 version. FFE is self\sphinxhyphen{}contained in that all dependencies, listed below, are included in install packages available for Linux, MacOS and Microsoft Windows operating systems.
\begin{itemize}
\item {} 
\sphinxAtStartPar
Tinker version 8.10

\item {} 
\sphinxAtStartPar
Java Runtime Environment (JRE) 1.8 (Java 8) or later

\item {} 
\sphinxAtStartPar
Java3D version 1.6

\end{itemize}

\sphinxAtStartPar
Major improvements over the previous releases of FFE include:
\begin{itemize}
\item {} 
\sphinxAtStartPar
Self\sphinxhyphen{}Extracting Installers for Linux, macOS and Microsoft Windows. The installer distributions include FFE\sphinxhyphen{}enabled Tinker binaries, full source code, FFE and Tinker documentation, and example files. Private JRE and Java3D libraries are bundled with all versions of FFE.

\item {} 
\sphinxAtStartPar
An intuitive, consistent selection mechanism.

\item {} 
\sphinxAtStartPar
Improvements to the keyword and modeling panels.

\item {} 
\sphinxAtStartPar
Support for Tinker internal coordinate, restart and induced dipole file formats, plus of molecules and biopolymers directly from the PubChem, NCI or PDB databases,  or from disk files.

\item {} 
\sphinxAtStartPar
Automatic conversion of downloaded small molecules to Tinker’s “BASIC” force field. Also supported is convertion of PDB files to Tinker format with automatic atom typing for many standard biomolecular force fields.

\end{itemize}


\section{Future Plans}
\label{\detokenize{text/introduction:future-plans}}
\sphinxAtStartPar
The most important Force Field Explorer development is to add further molecular editing and visualization features, as well as tighter integration with Tinker. Currently, Java3D is used as the graphics toolkit underlying FFE’s visualization engine. Java3D was originally developed by Sun, but is now maintained by an open source consortium and is freely available. Other planned enhancements include support for additional molecule file types and special capabilities for molecular complexes, docking and binding applications.

\sphinxstepscope


\chapter{Installation}
\label{\detokenize{text/installation:installation}}\label{\detokenize{text/installation::doc}}

\section{Use of Self\sphinxhyphen{}Extracting Kits}
\label{\detokenize{text/installation:use-of-self-extracting-kits}}
\sphinxAtStartPar
Force Field Explorer and Tinker are distributed via self\sphinxhyphen{}extracting installers for Linux, Apple MacOS and Microsoft Windows. These install kits are available from the Tinker web site maintained by the Ponder group at \sphinxurl{https://dasher.wustl.edu/tinker/}. Included within the installers are binary Tinker executables, source code, example/test files, documentation and the Java environment needed by Force Field Explorer. FFE contains a private JRE version that will not affect any other JREs installed system\sphinxhyphen{}wide.

\sphinxAtStartPar
For each platform, a launch script/exe located in the top level installation directory named “ffe” will launch Force Field Explorer.

\sphinxAtStartPar
On some platforms, double clicking the ffe.jar file in the “tinker/jar” directory will also launch Force Field Explorer. In this case, your system JRE will be invoked instead of the private JRE bundled with the installation kit. This should behave correctly, as long as your system JRE is a 1.8 version (Java 8) and includes Java3D extensions.

\sphinxAtStartPar
Specific installation instructions for operating systems are provided below:
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Linux}
\begin{quote}

\sphinxAtStartPar
The Tinker\sphinxhyphen{}FFE Installer for Linux is provided as a gzipped shell script. Uncompress the the .gz archive to produce an .sh script, and then run the script. The script must have the “executable” attribute, set via “chmod +x ffe\sphinxhyphen{}linux.sh”, prior to being run.

\sphinxAtStartPar
After installation, the top\sphinxhyphen{}level directory defaults to “\$HOME/Tinker\sphinxhyphen{}FFE”. The FFE\sphinxhyphen{}enabled Tinker binaries are located in the “\$HOME/Tinker\sphinxhyphen{}FFE/tinker/bin” directory.
\end{quote}

\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Apple MacOS}
\begin{quote}

\sphinxAtStartPar
The Tinker\sphinxhyphen{}FFE Installer for MacOS is provided as a .dmg disk image file. Double\sphinxhyphen{}click on the file to run the installer. Once installed, Force Field Explorer is launched by double clicking on the Desktop icon.

\sphinxAtStartPar
Recent versions of MacOS contains a security feature called Gatekeeper that keeps applications not obtained via the App Store or Apple\sphinxhyphen{}approved developers from being opened. Gatekeeper is enabled by default, and may result in the (incorrect!) error message: “Tinker\sphinxhyphen{}FFE Installer.app is damaged and can’t be opened.” To turn off Gatekeeper, go to the panel System Preferences \textgreater{} Security \& Privacy \textgreater{} General, and set “Allow apps downloaded from:” to “Anywhere”. This will require an Administrator account, and must be done before invoking the FFE installer. After FFE is installed and launched for the first time, you can return the System Preference to its prior value. On Sierra (MacOS 10.12) and later, the “Anywhere” option has been removed. In most cases the Security \& Privacy panel will open and permit the user to run the installer. Alternatively, the “Anywhere” option can be restored by running the command “sudo spctl \textendash{}master\sphinxhyphen{}disable” in a Terminal window with Administrator privilege.
\end{quote}

\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Microsoft Windows}
\begin{quote}

\sphinxAtStartPar
The Tinker\sphinxhyphen{}FFE Installer for Windows is provided as a zipped executable. First, unzip the .zip file. Then run the resulting executable .exe file by double clicking. Following installation, Force Field Explorer is launched via the FFE desktop icon or from the Start Menu.

\sphinxAtStartPar
In order to perform minimizations or molecular dynamics from within FFE, some environment variables and symbolic links must be set prior to using the program. A batch file named “FFESetupWin.bat” is installed in the main Tinker\sphinxhyphen{}FFE directory, which by default resides in the user’s home directory. To complete the setup of FFE, this batch file should be run from a Command Prompt window following installation. It is only necessary to invoke this batch file once, as the settings should persist between logins.
\end{quote}

\end{itemize}


\section{Building FFE from Source}
\label{\detokenize{text/installation:building-ffe-from-source}}
\sphinxAtStartPar
For those wishing to modify the FFE GUI or build installation kits from source, we provide a complete development package for Tinker\sphinxhyphen{}FFE. The full source distribution for Force Field Explorer is available from the TinkerTools organization public repository on Github located at \sphinxurl{https://github/TinkerTools/FFE/}. The 0README file in the top\sphinxhyphen{}level of the distribution has instructions for building installers for Linux, MacOS and Windows.

\sphinxAtStartPar
Additional requirements for building FFE are the GNU compiler suite with gcc, g++ and gfortran and the Install4j Java installer builder. On Windows systems we recommend use of the MinGW\sphinxhyphen{}w64 compilers under Cygwin. Note that Install4j is a commercial product; only the command line “install4jc” compiler is needed, and not the full Install4j GUI interface.

\sphinxstepscope


\chapter{Description of FFE Components}
\label{\detokenize{text/components:description-of-ffe-components}}\label{\detokenize{text/components::doc}}

\section{Molecular Tree}
\label{\detokenize{text/components:molecular-tree}}
\sphinxAtStartPar
The Molecular Tree is a structural hierarchy of each system, used for navigating and making selections. When Force Field Explorer opens a structure file, it attempts to groups atoms into protein/nucleic acid macromolecules and their constituent residues. It also groups ions, water and hetero molecules together. This is done even in the absence of a Tinker sequence file. When a display or color command is chosen, all currently selected groups of atoms are affected.

\noindent\sphinxincludegraphics[width=625\sphinxpxdimen]{{figure1}.png}

\sphinxAtStartPar
Figure 1. The first residue of the enkephalin peptide is selected in the Tree view and is highlighted in blue on the Graphics Window.


\section{3D Graphics and Global Axis}
\label{\detokenize{text/components:d-graphics-and-global-axis}}
\sphinxAtStartPar
Left\sphinxhyphen{}clicking the Global Axis, then dragging performs a rotation about the origin of the entire scene. This is useful for manual docking of two systems. For example, after positioning each system individually in the X\sphinxhyphen{}Y plane by dragging them with the mouse, a rotation about the Y\sphinxhyphen{}axis allows orientation in the Y\sphinxhyphen{}Z plane. Right\sphinxhyphen{}clicking the Global Axis, then dragging performs a translation of the entire scene.

\noindent\sphinxincludegraphics[width=625\sphinxpxdimen]{{figure2}.png}

\sphinxAtStartPar
Figure 2. Dragging the Graphics Axis causes the entire scene to rotate about the global origin. The scene above is rotated 180 degrees around the Y\sphinxhyphen{}axis.


\section{Keyword Editor}
\label{\detokenize{text/components:keyword-editor}}
\sphinxAtStartPar
The Keyword Editor allows modification of keyword files that control various aspects of Tinker calculations. If a Modeling Command is executed on a system, the corresponding Keyword File is automatically saved. Modifications can also be saved at any time using one of the save buttons. Any text or keywords that Force Field Explorer does not recognize are considered “Comments” and are appended to the end of saved key files. As an example, the enkephalin keyword control file is shown below.

\noindent\sphinxincludegraphics[width=625\sphinxpxdimen]{{figure3}.png}

\sphinxAtStartPar
Figure 3. The Keyword Editor Panel displaying the enkephalin keyword file.


\section{Modeling Commands}
\label{\detokenize{text/components:modeling-commands}}
\sphinxAtStartPar
The Modeling Commands panel of Force Field Explorer allows launching of most of the Tinker programs. After selecting a routine and configuring its modifying arguments, selecting the “play” button starts the job running. If Tinker will modify the coordinates of the system, Force Field Explorer will automatically connect to the routine and show progress interactively. If the routine completes before Force Field Explorer is exited, the textual results in the log file are loaded into the Logs panel. If Force Field Explorer exits while one or more routines are running, they continue in the background unless explicitly killed by the user. For example, the “Optimize” command has been selected for enkephalin (Figure 4).

\noindent\sphinxincludegraphics[width=625\sphinxpxdimen]{{figure4}.png}

\sphinxAtStartPar
Figure 4. The Tinker OPTIMIZE program selected in the Modeling Commands panel and will execute on the active system, in this case the enkephalin peptide.


\section{Activity Logs}
\label{\detokenize{text/components:activity-logs}}
\sphinxAtStartPar
The Logs panel is a simple text editor where output logged from Tinker routines is automatically loaded. It can also be used to edit any text file, for example Tinker coordinate or keyword files.

\noindent\sphinxincludegraphics[width=625\sphinxpxdimen]{{figure5}.png}

\sphinxAtStartPar
Figure 5. The Log panel showing output logged from running Tinker OPTIMIZE on the enkephalin peptide.

\sphinxAtStartPar
If a modeling command changes the coordinates of an open structure, the final structure generated is re\sphinxhyphen{}loaded onto the open structure used to initiate the command.

\noindent\sphinxincludegraphics[width=625\sphinxpxdimen]{{figure6}.png}

\sphinxAtStartPar
Figure 6.  The coordinates for the final local minimum of enkephalin (enkephalin.xyz\_2) are loaded onto the originally opened structure, enkephalin.xyz, used as input to the Tinker OPTIMIZE command.

\sphinxstepscope


\chapter{Description of FFE Menus}
\label{\detokenize{text/menus:description-of-ffe-menus}}\label{\detokenize{text/menus::doc}}

\section{File Menu}
\label{\detokenize{text/menus:file-menu}}
\sphinxAtStartPar
Force Field Explorer currently reads Tinker coordinate files (XYZ, INT), restart files (DYN), archive files (ARC), induced dipole files (file suffix ending in “u”) and Protein Databank files (PDB). Currently, file writing us only implemented for Tinker XYZ coordinate files.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Open}

\end{itemize}

\sphinxAtStartPar
An attempt is made to open the selected file. Currently, Tinker XYZ coordinate files, Tinker archive files, and Protein Databank files are recognized.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Save As}

\end{itemize}

\sphinxAtStartPar
Saves the active file under a different name. Currently, this command is currently only supported for Tinker XYZ coordinate files.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Close}

\end{itemize}

\sphinxAtStartPar
Close the active file.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Close All}

\end{itemize}

\sphinxAtStartPar
Close all open files.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Download from PubChem…}

\end{itemize}

\sphinxAtStartPar
Entering a valid molecule name downloads the corresponding structure from the NIH PubChem database, convert atom types to the “tiny” force field, and save the Tinker XYZ file to the NIH Downloads directory, then open it.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Download from NCI…}

\end{itemize}

\sphinxAtStartPar
Entering a valid molecule name downloads the corresponding structure from the NCI Cactus database, convert atom types to the “tiny” force field, save the Tinker XYZ file to the NIH Downloads directory, then open it.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Download from PDB…}

\end{itemize}

\sphinxAtStartPar
Entering a valid 4 character accession downloads the corresponding PDB file, save it to the current Force Field Explorer working directory, then open it.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Choose Key File…}

\end{itemize}

\sphinxAtStartPar
Allows selecting a specific, non\sphinxhyphen{}default Tinker KEY file containing options for the selected molecular system.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Choose Log File…}

\end{itemize}

\sphinxAtStartPar
Allows selectiong a specific Tinker LOG file that will be displayed in the FFE Log panel.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Load Restart Data…}

\end{itemize}

\sphinxAtStartPar
Tinker Restart files (DYN) contain atomic positions, velocities and two sets of accelerations (current and previous step), but no connectivity information. Loading a Restart file on top of an open Tinker coordinate file allows visualization of velocities and accelerations.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Load Induced Data…}

\end{itemize}

\sphinxAtStartPar
Tinker Induced Dipole files (end in “u”) contain induced dipole vectors. They are produced during a molecular dynamics routine using the Tinker “save\sphinxhyphen{}induced” keyword. Loading an Induced Dipole file on top of an open Tinker coordinate file allows visualization of induced dipoles.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Choose Tinker Location…}

\end{itemize}

\sphinxAtStartPar
Allows specifying a location for the Tinker executables to be used with Force Field Explorer. The default is to use the executables bundled with the install kit and present under \$HOME/Tinker\sphinxhyphen{}FFE.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Exit}

\end{itemize}

\sphinxAtStartPar
Exit shuts down Force Field Explorer, after saving user preferences.


\section{Selection Menu}
\label{\detokenize{text/menus:selection-menu}}
\sphinxAtStartPar
The set of nodes currently selected are highlighted in the Molecular Tree. If the shift key his pressed while clicking on two nodes, all nodes in between are selected. Alternatively, by holding down the control key while clicking on a node, either in the Tree or Graphics window, the selection state of a node can be toggled. To use Graphics based picking, the Graphics Picking checkbox under the Picking menu must be selected.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Select All}

\end{itemize}

\sphinxAtStartPar
All open systems are selected.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Restrict to Selections}

\end{itemize}

\sphinxAtStartPar
Nodes that are not selected are made invisible.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Highlight Selections}

\end{itemize}

\sphinxAtStartPar
Selected nodes are highlighted in the Graphics window.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set Selection Color…}

\end{itemize}

\sphinxAtStartPar
Choose the color for selected atoms.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Label Selected Atoms}

\end{itemize}

\sphinxAtStartPar
Selected atoms are labeled by number and description.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Label Selected Residues}

\end{itemize}

\sphinxAtStartPar
Selected residues are labeled by their respective three letter identifiers.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set Label Font Size}

\end{itemize}

\sphinxAtStartPar
The default label size is 12 point.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set Label Font Color…}

\end{itemize}

\sphinxAtStartPar
The default font color is white.


\section{Display Menu}
\label{\detokenize{text/menus:display-menu}}
\sphinxAtStartPar
We have intentionally maintained a simple, but elegant rendering mechanism. The Force Field Explorer data structure is self\sphinxhyphen{}rendering, meaning that each object “knows how to draw itself”. Rendering commands are “Top\sphinxhyphen{}Down”, meaning that commands filter down through the molecular tree, with each node responding and/or passing commands to its children. This paradigm positions Force Field Explorer to easily scale up to multi\sphinxhyphen{}level molecular engineering/nanotechnology modeling projects. The intent is to avoid is a rendering/data architecture built upon “an array of atoms”. In our opinion, “an array of atoms” infrastructure does not achieve our molecular engineering design goals. While a graphics change is being rendered, one additional graphics command will be cached. Other commands are ignored while the 3D view catches up. Changes are applied to all selected nodes in the Molecular Tree View.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Wireframe}

\end{itemize}

\sphinxAtStartPar
Represents the selection as a collection of thin lines for bonds.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Tube}

\end{itemize}

\sphinxAtStartPar
Represents the selection as a collection of bond tubes of medium diameter. This option can be slow for systems with more than a few thousand atoms.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Spacefill}

\end{itemize}

\sphinxAtStartPar
Represnets the selection as a collection of overlapping atoms of large diameter proportional to their vdw radii.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Ball \& Stick}

\end{itemize}

\sphinxAtStartPar
Represents the selection as a collection of atoms of medium diameter and thin tubes for bonds. This options can be slow for large systems with more than a few thousand atoms.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Invisible}

\end{itemize}

\sphinxAtStartPar
Removes any graphical representation of the selected system or subsystem.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{RMIN}

\end{itemize}

\sphinxAtStartPar
Similar to Spacefill, but the sphere sizes are set to the Lennard\sphinxhyphen{}Jones minima for each atom in the system.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Fill}

\end{itemize}

\sphinxAtStartPar
Fill rendered polygons.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Points}

\end{itemize}

\sphinxAtStartPar
Render only vertices.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Lines}

\end{itemize}

\sphinxAtStartPar
Render edges between vertices.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Preferences… \textendash{}\textgreater{} Radius}

\end{itemize}

\sphinxAtStartPar
A scale factor applied to all rendered spheres and cylinders.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Preferences… \textendash{}\textgreater{} Wireframe Thickness}

\end{itemize}

\sphinxAtStartPar
This specifies the thickness of wireframe representations in pixels.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Preferences… \textendash{}\textgreater{} Detail}

\end{itemize}

\sphinxAtStartPar
Changes the number of vertices used in creating spheres and cylinders. More vertices (a higher number on the slider) create a smoother appearance, but slower rotations.


\section{Color Menu}
\label{\detokenize{text/menus:color-menu}}\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Monochrome}

\end{itemize}

\sphinxAtStartPar
Black \& White rendering.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{CPK}

\end{itemize}

\sphinxAtStartPar
Atom based colors.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Residue}

\end{itemize}

\sphinxAtStartPar
Color based on amino/nucleic acid.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Structure}

\end{itemize}

\sphinxAtStartPar
Color based on secondary structure specified in PDB files.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Polymer}

\end{itemize}

\sphinxAtStartPar
A different color is assigned to each polymer.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Partial Charge}

\end{itemize}

\sphinxAtStartPar
Coloring is based on partial charges that correspond to atom types specified in Tinker coordinate files.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Vector Magnitude}

\end{itemize}

\sphinxAtStartPar
Coloring is based on vector magnitude, where the vector may represent velocity, acceleration, induced dipole or force depending on user choice.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{User Color}

\end{itemize}

\sphinxAtStartPar
Arbitrary colors can be assigned to selected atoms by choosing the “Apply User Color to Selections” menu item. The “User Color” can then be selected to invoke this scheme.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Apply User Color to Selections}

\end{itemize}

\sphinxAtStartPar
Applies the currently active User Color to the selected atoms.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set User Color…}

\end{itemize}

\sphinxAtStartPar
Specify the color to use when selecting the “Apply User Color to Selections” option.


\section{Options Menu}
\label{\detokenize{text/menus:options-menu}}\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Active System}

\end{itemize}

\sphinxAtStartPar
Coordinate controls for the active system.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Rotation}

\end{itemize}

\sphinxAtStartPar
Removes any rotations applied to the active system.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Translation}

\end{itemize}

\sphinxAtStartPar
Removes any translation applied to the active system.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Rotation and Translation}

\end{itemize}

\sphinxAtStartPar
Removes any rotation/translation applied to the active system.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Rotate About Center of Mass}

\end{itemize}

\sphinxAtStartPar
Specifies the active system should be rotated about its center of mass.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset About Pick}

\end{itemize}

\sphinxAtStartPar
Specifies the active system should be rotated about the node selected by graphics picking.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Drag}

\end{itemize}

\sphinxAtStartPar
Specify which system is controlled by mouse clicking/dragging within the Graphics window.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Active System}

\end{itemize}

\sphinxAtStartPar
Regardless of mouse position, the Active system is controlled.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{System Below Mouse}

\end{itemize}

\sphinxAtStartPar
To move a system, it must be picked by clicking over it with the mouse.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Global Zoom}

\end{itemize}

\sphinxAtStartPar
Reset the global zoom that has been applied to the entire scene.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Global Translation}

\end{itemize}

\sphinxAtStartPar
Remove any global translation that has been applied to the entire scene.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Global Rotation}

\end{itemize}

\sphinxAtStartPar
Remove any global rotation that has been applied to the entire scene.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Global View}

\end{itemize}

\sphinxAtStartPar
Remove any global rotation and translation, then reset the global zoom.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Toggle Hydrogens}

\end{itemize}

\sphinxAtStartPar
Show/Hide hydrogen atoms.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Full Screen}

\end{itemize}

\sphinxAtStartPar
Make the graphics window fill the entire screen.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set Background Color…}

\end{itemize}

\sphinxAtStartPar
Change the color of the graphics window background. This is useful for switching to a white background before capturing images that might be printed.


\section{Picking Menu}
\label{\detokenize{text/menus:picking-menu}}
\sphinxAtStartPar
Graphics picking can be used to select nodes anywhere in the structural hierarchy. By holding the control key while picking, the selection state of the picked node is toggled between selected/not selected. However, holding the shift button down while picking currently has no effect.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Graphics Picking}

\end{itemize}

\sphinxAtStartPar
Selecting this checkbox turns on Graphics Picking.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick Atom}

\end{itemize}

\sphinxAtStartPar
An individual Atom will be picked.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick Bond}

\end{itemize}

\sphinxAtStartPar
A Bond will be picked, with consecutive clicks cycling through all Bonds made by the picked atom.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick Angle}

\end{itemize}

\sphinxAtStartPar
An Angle will be picked, with consecutive clicks cycling through all Angles made by the picked atom.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick Dihedral}

\end{itemize}

\sphinxAtStartPar
A Dihedral will be picked, with consecutive clicks cycling through all Dihedrals made by the picked atom.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick Residue}

\end{itemize}

\sphinxAtStartPar
An individual Residue from a biopolymer will be picked.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick Polymer}

\end{itemize}

\sphinxAtStartPar
An individual Polymer chain will be picked.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick Molecule}

\end{itemize}

\sphinxAtStartPar
An individual Molecule will be picked.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Pick System}

\end{itemize}

\sphinxAtStartPar
An individual System from among those currently loaded will be picked.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Measure Distance}

\end{itemize}

\sphinxAtStartPar
After selecting two atoms the distance between them will be reported in the Force Field Explorer console.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Measure Angle}

\end{itemize}

\sphinxAtStartPar
After selecting three atoms the angle formed between them will be reported in the Force Field Explorer console.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Measure Dihedral}

\end{itemize}

\sphinxAtStartPar
After selecting four atoms the dihedral formed between them will be reported in the Force Field Explorer console.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set Graphics Picking Color…}

\end{itemize}

\sphinxAtStartPar
Picked nodes will be highlighted in the color selected using this control.


\section{Trajectory Menu}
\label{\detokenize{text/menus:trajectory-menu}}
\sphinxAtStartPar
Tinker trajectories are stored in Archive files (ARC), which are simply a concatenation of Tinker coordinate files (XYZ, INT).
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Oscillate}

\end{itemize}

\sphinxAtStartPar
When the end of a trajectory is reached, it is played in the reverse direction instead of restarting at the beginning.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Frame…}

\end{itemize}

\sphinxAtStartPar
Advance to an arbitrary frame of the active trajectory.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Speed…}

\end{itemize}

\sphinxAtStartPar
Choose a frame rate for trajectory playback. If 20 frames per second is entered, for example, a delay of 50 msec between coordinate changes is enforced. Therefore, the actual frame rate will be slower than what is specified if rendering for the system is slow.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Skip…}

\end{itemize}

\sphinxAtStartPar
Instead of displaying every frame during trajectory playback, only every nth frame will be rendered.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Play}

\end{itemize}

\sphinxAtStartPar
Play the active trajectory.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Stop}

\end{itemize}

\sphinxAtStartPar
Stop the active trajectory.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Step Forward}

\end{itemize}

\sphinxAtStartPar
Advance the active trajectory one frame.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Step Back}

\end{itemize}

\sphinxAtStartPar
Rewind the active trajectory one frame.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset}

\end{itemize}

\sphinxAtStartPar
Return the active trajectory to the first frame.


\section{Simulation Menu}
\label{\detokenize{text/menus:simulation-menu}}
\sphinxAtStartPar
Tinker molecular dynamics, optimization and sampling methods are configured to start a server that listens for Force Field Explorer clients. Once a client\sphinxhyphen{}to\sphinxhyphen{}server connection is established, simulation information can be sent between Tinker and Force Field Explorer. Multiple Force Field Explorer clients can connect to the same Tinker simulation.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Release Job}

\end{itemize}

\sphinxAtStartPar
If Force Field Explorer is connected to a Tinker simulation, the connection will be closed.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Connect to Local Job}

\end{itemize}

\sphinxAtStartPar
Force Field Explorer will attempt to connect to a Tinker simulation executing on the current computer.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Connect to Remote Job}

\end{itemize}

\sphinxAtStartPar
Force Field Explorer will attempt to connect to a Tinker simulation executing on a remote computer.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set Remote Job Address…}

\end{itemize}

\sphinxAtStartPar
Specify the IP address of the remote computer where a Tinker simulation is executing. No domain name server is used, so the address should be of the form: XXX.XXX.XXX.XXX
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Set Port…}

\end{itemize}

\sphinxAtStartPar
Specify the port number to be used for connection to a Tinker simulation.


\section{Export Menu}
\label{\detokenize{text/menus:export-menu}}
\sphinxAtStartPar
Currently, Force Field Explorer can save screenshots in PNG, JPEG, BMP and GIF formats. In most cases, PNG gives better image quality when using Force Field Explorer than JPEG, likely because the default JPEG configuration use prioritizes small image size over preservation of detail.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Capture Graphics}

\end{itemize}

\sphinxAtStartPar
Capture the Graphics window to an image file.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{PNG}

\end{itemize}

\sphinxAtStartPar
Use the PNG image format to render Graphics output.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{JPEG}

\end{itemize}

\sphinxAtStartPar
Use the JPEG image format to render Graphics output.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{BMP}

\end{itemize}

\sphinxAtStartPar
Use the BMP image format to render Graphics output.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{WBMP}

\end{itemize}

\sphinxAtStartPar
Use the WBMP image format to render Graphics output.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{GIF}

\end{itemize}

\sphinxAtStartPar
Use the GIF image format to render Graphics output.


\section{Window Menu}
\label{\detokenize{text/menus:window-menu}}
\sphinxAtStartPar
Force Field Explorer components can be customized to some extent to suit user preferences. Many user configurable choices are saved between sessions.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Panes}

\end{itemize}

\sphinxAtStartPar
This resets the slider between the Molecular Tree and Graphics Windows to the default position. The Graphics window is a heavy weight component (so hardware graphics acceleration can be used), while most Force Field Explorer components are light weight “Swing” components. Unfortunately, this effect prevents the user from dragging the slider and shrinking the Graphics window.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Show Tree}

\end{itemize}

\sphinxAtStartPar
Show/Hide the Tree view.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Show Tool Bar}

\end{itemize}

\sphinxAtStartPar
Show/Hide the Tool Bar.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Show Global Axes}

\end{itemize}

\sphinxAtStartPar
Show/Hide the Global Axes. The Global Axes are used both as a visual cue and to affect global rotations and translations.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Reset Console}

\end{itemize}

\sphinxAtStartPar
Resets the FFE command line Console.
\begin{itemize}
\item {} 
\sphinxAtStartPar
\sphinxstylestrong{Ocean Look \& Feel}

\end{itemize}

\sphinxAtStartPar
This appearance should cause Force Field Explorer to more closely resemble the native platform. In addtion, top bar menu items will be moved to the main FFE application window. The default appearance is “Java Metal”, which should be consistent across platforms.

\sphinxstepscope


\chapter{Acknowledgments}
\label{\detokenize{text/acknowledgements:acknowledgments}}\label{\detokenize{text/acknowledgements::doc}}

\section{Contributors}
\label{\detokenize{text/acknowledgements:contributors}}
\sphinxAtStartPar
The original version of Force Field Explorer was written by Michael Schnieders, before and during his graduate school stay in Jay Ponder’s laboratory at Washington University in St. Louis. The code is now being developed and maintained by the Ponder group.

\sphinxAtStartPar
A significant contribution to Force Field Explorer was made by Zhiguang “Frank” Gao over the summer of 2002. The Force Field Explorer logo shows an optimized AMOEBA gas phase water dimer, and was provided by Pengyu Ren. The User’s Guide cover showing the crambin protein with 13\sphinxhyphen{}PHE highlighted was produced by Jay Ponder. Special thanks to Alan Grossfield for offering many helpful suggestions. We would also like to thank Eric Reiss for making available his modified version of some Java3D Behaviors, and Pat Niemeyer for his work in developing the BeanShell scripting framework. Important code modernization, additon of new options and updating of FFE was done over the period from 2013 to 2016 by Jeffrey Bigg, Tyler Ponder and Brendan McMurrow. A major reorganization and unification of the Linux, Windows and macOS code bases was completed during summer 2017 by Jay Ponder.


\section{Reporting Bugs}
\label{\detokenize{text/acknowledgements:reporting-bugs}}
\sphinxAtStartPar
We apologize in advance for any bugs that remain in Force Field Explorer. Should you happen to perform some command that causes a Java stack trace to be dumped to the console, please copy the output and forward to \sphinxhref{mailto:ponder@dasher.wustl.edu}{ponder@dasher.wustl.edu}. Poor video card drivers can sometimes result in unpredictable behavior from Force Field Explorer. If this should occur, try to find the latest drivers for your computer, operating system and video card combination.



\renewcommand{\indexname}{Index}
\printindex
\end{document}