.. include:: substitutions
.. _menus:

*********************
Menus
*********************

This chapter contains a listing of the menu options available in |product|. 
Where possible, each section also contains a listing of the
Python code that is run when that option is selected.  All Python menu commands
are wrapped in a standard exception handling block:

.. oe:source:: menus.py
   :frag:     CODE_WRAPPER


File
====

Open
----

.. oe:source:: menus.py
   :frag:     FILE_OPEN

Open State
----------

.. oe:source:: menus.py
   :frag:     FILE_OPEN_STATE
   
Open Special
------------

From PDB...
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_OPEN_SPECIAL_PDB

Script...
^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_OPEN_SPECIAL_SCRIPT

MTZ...
^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_OPEN_SPECIAL_MTZ

Clear
-----

Marked
^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_CLEAR_MARKED
   
Not Marked
^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_CLEAR_NOT_MARKED

Visible
^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_CLEAR_VISIBLE
   
Not Visible
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_CLEAR_NOT_VISIBLE


Clear All
---------

.. oe:source:: menus.py
   :frag:     FILE_CLEAR
   
Save
----

.. oe:source:: menus.py
   :frag:     FILE_SAVE
   
Save Marked
-----------

.. oe:source:: menus.py
   :frag:     FILE_SAVE_MARKED
   
Save State
----------

.. oe:source:: menus.py
   :frag:     FILE_SAVE_STATE
   
New List
--------

From AND
^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_NEW_LIST_FROM_AND
   
From OR
^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_NEW_LIST_FROM_OR
   
From XOR
^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_NEW_LIST_FROM_XOR

From Marked
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_NEW_LIST_FROM_MARKED

New Molecule
------------

From Name
^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_NEW_MOLECULE_FROM_NAME

From Merge
^^^^^^^^^^

All three options under this menu (*Scoped*, *Marked*, and
*Visible*) execute the following code. 

.. oe:source:: menus.py
   :frag:     FILE_NEW_MOLECULE_FROM_MERGE
   
The SCOPE parameter is assigned a value according to which option was selected 
(SelectedScope, MarkedScope, and VisibleScope respectively).

From Split
^^^^^^^^^^

**Components**

.. oe:source:: menus.py
   :frag:     FILE_NEW_MOLECULE_FROM_SPLIT_COMPONENTS
   
**Selected**

.. oe:source:: menus.py
   :frag:     FILE_NEW_MOLECULE_FROM_SELECTED

**Marked**

.. oe:source:: menus.py
   :frag:     FILE_NEW_MOLECULE_FROM_MARKED

Import
------

Spreadsheet
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_IMPORT_SPREADSHEET

Export
------

Script History
^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_EXPORT_SCRIPT_HISTORY
   
Screenshot
^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_EXPORT_SCREENSHOT

Spreadsheet
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_EXPORT_SPREADSHEET
   
POV-Ray
^^^^^^^

.. oe:source:: menus.py
   :frag:     FILE_EXPORT_POVRAY

Recents
-------

All of the options in this menu call the following command:

.. oe:source:: menus.py
   :frag:     FILE_RECENTS

The FILENAME parameter is assigned to the filename specified in the option 
that was selected under this menu.

Recent Directories
------------------

All of the options in this menu call the following command:

.. oe:source:: menus.py
   :frag:     FILE_RECENT_DIRS

The FILENAME parameter is assigned to the filename specified in the option 
that was selected under this menu.

Exit
----

.. oe:source:: menus.py
   :frag:     FILE_EXIT

Edit
====

Undo
----

.. oe:source:: menus.py
   :frag:     EDIT_UNDO

Undo History
------------

Redo
----

.. oe:source:: menus.py
   :frag:     EDIT_REDO
   
Redo History
------------

Copy
----

.. oe:source:: menus.py
   :frag:     EDIT_COPY

Copy Image
----------

.. oe:source:: menus.py
   :frag:     EDIT_COPY_IMAGE

Paste
-----

.. oe:source:: menus.py
   :frag:     EDIT_PASTE

Select
------

All Visible
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_SELECT_ALL_VISIBLE

Expression
^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_SELECT_EXPRESSION

Query
^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_SELECT_QUERY

Invert
^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_SELECT_INVERT

None
^^^^

.. oe:source:: menus.py
   :frag:     EDIT_SELECT_NONE

Mark
----

All Visible
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_MARK_ALL_VISIBLE
   
Query
^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_MARK_QUERY

None
^^^^

.. oe:source:: menus.py
   :frag:     EDIT_MARK_NONE

Hide
----

All
^^^

.. oe:source:: menus.py
   :frag:     EDIT_HIDE_ALL

Selected
^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_HIDE_SELECTED

Marked
^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_HIDE_MARKED

Not Selected
^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_HIDE_NOT_SELECTED

Not Marked
^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_HIDE_NOT_MARKED

None
^^^^

.. oe:source:: menus.py
   :frag:     EDIT_HIDE_NONE

Find
----

By LINGO Similarity
^^^^^^^^^^^^^^^^^^^

Creates a new list of molecules, based on the LINGO similarity measure to a
query molecule.  LINGO is a fast text-based similarity measure that uses the
canonical, isomeric SMILES strings of molecules for comparisons.

.. seealso::

   * [Vidal-2005]_


.. oe:source:: menus.py
   :frag:     EDIT_FIND_BY_LINGO

By SMARTS
^^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_FIND_BY_SMARTS

By Query Molecule
^^^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_FIND_BY_QUERY

By Title
^^^^^^^^

.. oe:source:: menus.py
   :frag:     EDIT_FIND_BY_TITLE

Find on Disk
------------

.. oe:source:: menus.py
   :frag:     EDIT_FIND_ON_DISK

Clear Scripting Log
-------------------

.. oe:source:: menus.py
   :frag:     EDIT_CLEAR_SCRIPTING_LOG
   
Extensions
----------

.. oe:source:: menus.py
   :frag:     EDIT_EXTENSIONS

Preferences
-----------

.. oe:source:: menus.py
   :frag:     EDIT_PREFERENCES
   
View
====

Fullscreen
----------

.. oe:source:: menus.py
   :frag:     VIEW_FULLSCREEN

Data
====

Sort Spreadsheet
----------------

.. oe:source:: menus.py
   :frag:     DATA_SORT_SPREADSHEET

Filter Spreadsheet
------------------

.. oe:source:: menus.py
   :frag:     DATA_FILTER_SPREADSHEET

Create Column
-------------

.. oe:source:: menus.py
   :frag:     DATA_CREATE_COLUMN

Create Empty Column
-------------------

.. oe:source:: menus.py
   :frag:     DATA_CREATE_EMPTY_COLUMN

Format Columns
--------------

.. oe:source:: menus.py
   :frag:     DATA_FORMAT_COLUMNS

Organize Columns
----------------

.. oe:source:: menus.py
   :frag:     DATA_ORGANIZE_COLUMNS

Advanced Depiction Options
--------------------------

.. oe:source:: menus.py
   :frag:     DATA_ADV_DEPICTION_OPTS

Show Statistics
---------------

.. oe:source:: menus.py
   :frag:     DATA_SHOW_STATISTICS

Style
=====

Color
-----

Palette
^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_PALETTE
   
Unique
^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_UNIQUE

Restore
^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_RESTORE

Molecules
^^^^^^^^^

All but two of the options (*Carbon* and *Reference*) in this menu 
call the following function.

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_MOLECULES
   
The SCHEME parameter is assigned based on which menu option was selected 
according to the table below.

.. table:: Color schemes
  
  =====================  =====================  
  *Amino*                'amino'
  *Alternate Locations*  'alt location'          
  *BFactor*              'bfactor'        
  *Chain*                'chain'          
  *CPK*                  'cpk'            
  *CPKNew*               'cpknew'         
  *Element*              'element'        
  *Formal Charge*        'formal charge'  
  *Group*                'group'          
  *Partial Charge*       'partial charge' 
  *Residue*              'residue'        
  *Shapely*              'shapely'        
  =====================  =====================  

The *Carbon* menu option calls the following function.

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_MOLECULES_CARBON
   
The *Reference* menu option calls the following function.

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_MOLECULES_REFERENCE
   
Surfaces
^^^^^^^^

All of the options in this menu call the following function.

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_SURFACES
   
Both the SCHEME and PARAMS parameters are assigned based on which option
was selected according to the table below.

.. table:: Color schemes and parameters

  ================================= ================== ==========================
  *Atom Color*                      'atom'             ''
  *Curvature*                       'curvature'        ''
  *Distance*                        'distance'         ''
  *Electrostatic*                   'electrostatics'   ''
  *Hydrogen Bond Potential*         'hydrogen bonds'   ''
  *Hydrophobicity*                  'hydrophobicity'   ''
  *Surface Potential*               'potential'        '' 
  ================================= ================== ==========================

The *Grid* menu options calls the following function.

.. oe:source:: menus.py
   :frag:     STYLE_COLOR_SURFACES_GRID

Transparency
^^^^^^^^^^^^

All of the options in this menu call the following function.

.. oe:source:: menus.py
   :frag:     STYLE_TRANSPARENCY
   
The N parameter is assigned to a value between 0 and 255 based on which option
was selected. A value of 255 corresponds to 0 percent transparency and a value of 
0 corresponds with 100 percent transparency. The specific values used in the menu 
are: 255, 230, 204, 179, 153, 128, 102, 77, 61, 26, 0.

Selection
---------

Crop Selected
^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SELECTION_CROP_SELECTED

Crop Unselected
^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SELECTION_CROP_UNSELECTED

Display
-------

Molecules
^^^^^^^^^

All of the options in this menu call the following function.

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_MOLECULES

The STYLE parameter is assigned based on which option was selected according
to the table below.

.. table:: Molecule Styles

  =================  =================
  *Wireframe*        'wireframe'      
  *Stick*            'stick'          
  *Ball and Stick*   'ball and stick' 
  *CPK*              'cpk'            
  *Stars*            'stars'          
  *Hidden*           'hidden'         
  =================  =================

**Hydrogens**

All of the options in this menu call the following function.

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_HYDROGENS

The STYLE parameter is assigned based on which option was selected according 
to the table below.

.. table:: Hydrogen Styles

  ============= =============
  *All*         2 
  *Polar*       1 
  *None*        0 
  ============= =============

**Non-Bonded Atoms**

Both of the options in this menu call the following function with the HIDE 
parameter assigned based on which option was selected (*Show* assigns
HIDE to False and *Hide* assigns HIDE to True).

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_NONBONDED

**C-Alpha Trace**

Both of the options in this menu call the following function with the DRAW 
parameter assigned based on which option was selected (*Show* assigns
DRAW to True and *Hide* assigns DRAW to False).

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_CALPHA

**Ribbons**

Both of the options in this menu call the following function with the DRAW 
parameter assigned based on which option was selected (*Show*} assigns
DRAW to True and *Hide*} assigns DRAW to False).

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_RIBBONS

**Atom Labels**

The *Atom Labels* submenu provides a variety of labeling of options. The
"Custom..." option launches a dialog which allows the user to build up more
complex and customized labels. This dialog is launched using the following
Python command:

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_ATOM_LABELS_VIEWER

All of the other options in the submenu all call the following Python command
but with different string arguments:

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_ATOM_LABELS

The arguments used can be found in the table below:

.. table:: Atom Label Arguments

  ======================= =======================
  Name                    '%n' 
  Index                   '%i' 
  Element                 '%e' 
  Isotope                 '%iso' 
  Type                    '%t' 
  Integer Type            '%it' 
  Implicit H Count        '%h' 
  Map Idx                 '%m' 
  Partial Charge          '%p' 
  Formal Charge           '%f' 
  Atom Radius             '%rad'
  Residue Info            '%r' 
  Residue Info (CA)       '%car' 
  B-Factor                '%bf'
  C-Alpha B-Factor        '%cab' 
  Degree                  '%d' 
  Is Chiral               '%c' 
  Chirality               '%chi' 
  Hybridization           '%hy' 
  Has Stereo Specified    '%sts' 
  Is In Ring              '%rng' 
  OEChem Idx              '%oei' 
  Symmetry Class          '%sy'
  Atom Comment            '%cm'
  Atom Occupancy          '%occ'
  MMFF Atom Type          '%mmff'
  Generic Data            '%gd(<GENERIC_DATA_TAG>)'
  None                    '' 
  ======================= =======================

**Bond Labels**

The *Bond Labels* submenu provides a variety of labeling of options. The
"Custom..." option launches a dialog which allows the user to build up more
complex and customized labels. This dialog is launched using the following
Python command:

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_BOND_LABELS_VIEWER

All of the other options in the submenu all call the following Python command
but with different string arguments:

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_BOND_LABELS

The arguments used can be found in the table below:

.. table:: Bond Label Arguments

  ======================= =======================
  Name                    '%n' 
  Index                   '%i' 
  Type                    '%t' 
  Integer Type            '%it' 
  Order                   '%o' 
  Length                  '%l' 
  Is Chiral               '%c' 
  Chirality               '%chi' 
  Has Stereo Specified    '%sts' 
  OEChem Idx              '%oei' 
  Generic Data            '%gd(<GENERIC_DATA_TAG>)'
  None                    '' 
  ======================= =======================

**Electrostatic Potential**

Both of the options in this menu call the following function with the DRAW 
parameter assigned based on which option was selected (*Show* assigns
DRAW to True and *Hide* assigns DRAW to False).

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_ES_GRID

**Molecular Surface**

Both of the options in this menu call the following function with the DRAW 
parameter assigned based on which option was selected (*Show* assigns
DRAW to True and *Hide* assigns DRAW to False).

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_MOLECULAR_SURFACE

**Accessible Surface**

Both of the options in this menu call the following function with the DRAW 
parameter assigned based on which option was selected (*Show* assigns
DRAW to True and *Hide* assigns DRAW to False).

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_ACCESSIBLE_SURFACE

**Hydrogen Bonds**

*Add Targets*

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_HYDROGEN_BONDS_ADD

*Remove Targets*

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_HYDROGEN_BONDS_REMOVE

*External Hydrogen Bonds*

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_HYDROGEN_BONDS_EXTERNAL

*Internal Hydrogen Bonds*

.. oe:source:: menus.py
   :frag:     STYLE_DISPLAY_HYDROGEN_BONDS_INTERNAL

Grids
^^^^^

*Solid*

.. oe:source:: menus.py
   :frag:     STYLE_GRIDS_SOLID

*Mesh*

.. oe:source:: menus.py
   :frag:     STYLE_GRIDS_MESH

*Cloud*

.. oe:source:: menus.py
   :frag:     STYLE_GRIDS_CLOUD

*Grid Corners*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_CORNERS

*Electrostatic*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_ELECTROSTATIC

*ET*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_ET

*FRED*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_FRED

*Generic*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_GENERIC
   
*Difference Map*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_DIFFERENCE_MAP

*Regular Map*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_REGULAR_MAP

*Add Contour*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_ADD_CONTOUR

*Delete Contour*

.. oe:source:: menus.py
   :frag:     STYLE_GRID_DELETE_CONTOUR

Surfaces
^^^^^^^^

All of the options in this menu except one (*Restore*) call the following 
function.

.. oe:source:: menus.py
   :frag:     STYLE_SURFACES

The STYLE parameter is assigned based on which option was selected according 
to the table below.

.. table:: Surface Style Arguments

  ==========  ==========
  *Solid*     'solid'  
  *Mesh*      'mesh'   
  *Points*    'points' 
  ==========  ==========

The *Restore* option calls the following function.

.. oe:source:: menus.py
   :frag:     STYLE_SURFACE_RESTORE

Graphics
--------

Depth Cue
^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_DEPTHCUE

Slabbing
^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_SLABBING

Mirror Slabs
^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_MIRROR_SLABS

Slab Level
^^^^^^^^^^

All of the options in this menu call the following function.

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_SLAB_LEVEL

The N parameter is assigned to a value between 10 and 80 corresponding to the 
desired percent of the scene to be contained within the slabbing planes.

Render Quality
^^^^^^^^^^^^^^

All of the options in the menu call the following function.

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_RENDER_QUALITY

The LOD parameter is assigned based on which option was selected according to
the table below.

.. table:: Level of Detail Parameters

  ==============  ==========
  *Fastest*       1 
  *Fast*          2 
  *Good*          3 
  *Better*        4 
  *Best*          5 
  *Presentation*  6
  ==============  ==========

Note: *Presentation* quality is optimized for creating output images with a white 
background.


Stereo
^^^^^^

*Off*

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_STEREO_OFF

*Splitscreen*

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_STEREO_SPLITSCREEN

*Stencil*

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_STEREO_STENCIL

*Angle*

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_STEREO_ANGLE

*Separation*

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_STEREO_SEPARATION

*Cross-Eyed*

.. oe:source:: menus.py
   :frag:     STYLE_GRAPHICS_STEREO_CROSS_EYED

Symmetry
--------

Edit Cell
^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_EDIT_CELL
   
Show Unit Cell
^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_SHOW_UNIT_CELL

Show Symmetry
^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_SHOW

Realize Symmetry In Cell
^^^^^^^^^^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_REALIZE_IN_CELL

Realize Symmetry
^^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_REALIZE

Symmetry Radius
^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_RADIUS

Symmetry Operators
^^^^^^^^^^^^^^^^^^

No Symmetry Color
^^^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_NO_COLOR

Single Symmetry Color
^^^^^^^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_SINGLE_COLOR

Color By Operator
^^^^^^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_COLOR_HELPER

Unique Color
^^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     STYLE_SYMMETRY_UNIQUE_COLOR

Bookmarks
=========

Add
---

.. oe:source:: menus.py
   :frag:     BOOKMARKS_ADD

Organize
--------

.. oe:source:: menus.py
   :frag:     BOOKMARKS_ORGANIZE

Animated
--------

.. oe:source:: menus.py
   :frag:     BOOKMARKS_ANIMATED

Tools
=====

FRED View
---------

.. oe:source:: menus.py
   :frag:     TOOLS_FRED_VIEW

EON View
--------

.. oe:source:: menus.py
   :frag:     TOOLS_EON_VIEW

ROCS View
---------

.. oe:source:: menus.py
   :frag:     TOOLS_ROCS_VIEW

Select
======

The Select menu provides a number of ways to select groups of atoms for use
in various tasks, like coloring atoms, creating surfaces, etc.  Most
selection operations involve only molecules which are visible in the 3D Window.
The Select menu also provides the ability to name sets of atoms and store them
for later retrieval.  These sets can be combined with the current selection 
through logical operations, allowing a high degree of flexibility in creating
selection sets.

Clear
-----

Clears all selected atoms and bonds.

All
---

Selects all visible atoms and bonds.

Invert
------

Inverts the current selection with respect to visible atoms.

Protein
-------

Operations in this menu are protein-centric.

Backbone
^^^^^^^^

Selects backbone atoms only.

Sidechains
^^^^^^^^^^

Selects side chain atoms.

C-Alphas
^^^^^^^^

Selects alpha carbon atoms in a protein.

Residue #...
^^^^^^^^^^^^

Allows selection of atoms by residue number.  A dialog will prompt for
residue numbers and chain ID's to include in the selection.

Residue Type...
^^^^^^^^^^^^^^^

Selects standard amino and nucleic acid residues by type.  A dialog will
prompt for residue names to be included in the selection.

Complete Residues
^^^^^^^^^^^^^^^^^

Selects all atoms in any residue that has at least one atom selected.

Zero Occupancy
^^^^^^^^^^^^^^

Selects all atoms with an occupancy value of zero.

Partial Occupancy
^^^^^^^^^^^^^^^^^

Selects all atoms with an occupancy value less than 1.0.

Alt Locations
^^^^^^^^^^^^^

Selects all residues with alternate location specifiers.

Waters
^^^^^^

Selects all water molecules.

Atom Numbers...
---------------

Selects atoms by their OEChem index value.  A dialog will prompt for the atom
numbers to include in the selection.

By Distance...
--------------

Selects residues within a specified distance of the currently selected atoms.
A dialog will appear to allow the distance to be specified with a slider.  A
checkbox in this dialog provides an option to exclude the originally selected
atoms from the final selection.

Heteroatoms
-----------

Selects all atoms that are not carbon or hydrogen.

Charged
-------

Selects all atoms with a non-zero formal charge.

SMARTS Pattern...
-----------------

Selects all atoms matching a SMARTS query pattern. A dialog will prompt for the
SMARTS pattern to use.

Expression...
-------------

Selects atoms using an expression from |product's| selection language.  A
dialog will prompt for the expression to use.

Store
-----

These options allow the storage of the current selection into a new or existing
atom set.

New Set...
^^^^^^^^^^

Creates a new atom set after prompting for a set name.

Into <Set_Name>
^^^^^^^^^^^^^^^

Replaces the contents of the named set *Set_Name* with the current selection.

Recall
------

From <Set_Name>
^^^^^^^^^^^^^^^

Selects the atoms in the named set *Set_Name*.

Combine
-------

Combines the current selection with named sets.

Include
^^^^^^^

Adds the atoms from the named set to the current selection (a logical OR
operation).

Exclude
^^^^^^^

Removes atoms from the named set from the current selection (logical NOT
operation).

Intersect
^^^^^^^^^

Selects the atoms that are in both the named set and the current selection
(logical AND operation).

Delete Set
----------

Deletes the named set.  This does not delete any atoms.

Hide Selected
-------------

Turns off the visibility of all selected atoms.

Hide Unselected
---------------

Turns off the visibility of all unselected atoms in visible molecules.

Window
======

Main Window
-----------

2D Viewer
^^^^^^^^^

.. oe:source:: menus.py
   :frag:     WINDOW_MAIN_WINDOW_2D

3D Viewer
^^^^^^^^^

.. oe:source:: menus.py
   :frag:     WINDOW_MAIN_WINDOW_3D

Spreadsheet
^^^^^^^^^^^

.. oe:source:: menus.py
   :frag:     WINDOW_MAIN_WINDOW_SPREADSHEET

2D Preview
----------

.. oe:source:: menus.py
   :frag:     WINDOW_2D_PREVIEW

2D Viewer
---------

.. oe:source:: menus.py
   :frag:     WINDOW_2D_VIEWER

3D Viewer
---------

.. oe:source:: menus.py
   :frag:     WINDOW_3D_VIEWER

List Window
-----------

.. oe:source:: menus.py
   :frag:     WINDOW_LIST_WINDOW

Process Manager
---------------

.. oe:source:: menus.py
   :frag:     WINDOW_PROCESS_MANAGER

Scripting Window
----------------

.. oe:source:: menus.py
   :frag:     WINDOW_SCRIPTING_WINDOW

Spreadsheet
-----------

.. oe:source:: menus.py
   :frag:     WINDOW_SPREADSHEET

Style Control
-------------

.. oe:source:: menus.py
   :frag:     WINDOW_STYLE_CONTROL

Help
====

About
-----

.. oe:source:: menus.py
   :frag:     HELP_ABOUT

Documentation
-------------

All of the items in this menu open a specific document. The script
to open the document can be found below:

.. oe:source:: menus.py
   :frag:     HELP_DOCUMENTATION
   
The actual document path that is used is:

* `User Manual (HTML) <https://docs.eyesopen.com/applications/vida/index.html`>_.

License
-------

Open
^^^^

.. oe:source:: menus.py
   :frag:     HELP_LICENSE_OPEN

Set
^^^

.. oe:source:: menus.py
   :frag:     HELP_LICENSE_SET

Update
^^^^^^

.. oe:source:: menus.py
   :frag:     HELP_LICENSE_UPDATE

Open Examples Directory
-----------------------

.. oe:source:: menus.py
   :frag:     HELP_OPEN_EXAMPLES_DIR

Open User Directory
-------------------

.. oe:source:: menus.py
   :frag:     HELP_OPEN_USER_DIR
   
File Bug Report
---------------

.. oe:source:: menus.py
   :frag:     HELP_FILE_BUG
