Difference between revisions of "Selecting"

From Jmol
Jump to navigation Jump to search
(Geometric expressions)
(correct misguiding phrases: "display" doe snot select atoms)
 
(4 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
Selecting can be done via atom expressions or based on topology or geometry.
 
Selecting can be done via atom expressions or based on topology or geometry.
The selection expressions used in Jmol can be used for the "select" and the "display within" commands.
+
Atom expressions in Jmol can be used in "select", "display", "hide" commands, as well as many others.
  
 
= Atom expressions =
 
= Atom expressions =
Line 9: Line 9:
  
 
* '''display *.CA''' displays all C-alpha atoms.
 
* '''display *.CA''' displays all C-alpha atoms.
* '''select _C''' selects all carbon atoms, equivalent to '''select *.C??'''
+
* '''select _C''' selects all carbon atoms, usually (but not necessarily) equivalent to '''select *.C??''' (the first identifies the element, the second just the atomm names and is only good for pdb files)
* '''select [ALA]''' selects all atoms in ALA amino acids.
+
* '''select [ALA]''' selects all atoms in alanine residues (pdb file format)
* '''display 1''', this will select the first amino acid residue and/or molecule. If a file contains various molecules, and they are all numbered starting from 1, this will select all first molecules or first residues of peptide strings.
+
* '''display 1''', this will display only the first amino acid residue and/or molecule. If a file contains various molecules, and they are all numbered starting from 1, this will display only all first molecules or first residues of peptide strings.
* '''display 1:A''', if multiple chains are present, this will select residue 1 of chain A.
+
* '''display 1:A''', if multiple chains are present, this will display only atoms in residue 1 of chain A.
  
 
= Geometric expressions =
 
= Geometric expressions =
  
Of course one can select based on distances.
+
Of course one can select based on distances:
  
* '''display within(3.0,hydrophobic)''' Selects all atoms of hydrophobic residues, and all atoms within 3.0 Angstroms from these residues.
+
* '''display within(3.0,hydrophobic)''' displays only all atoms of hydrophobic residues (pdb file format), and all atoms within 3.0 Angstroms from these residues.
  
It is for the newest versions of Jmol also possible to select atoms according to [http://chemapps.stolaf.edu/jmol/docs/?#planeexpressions plane selections].  
+
It is for the newest versions of Jmol also possible to select atoms according to [http://chemapps.stolaf.edu/jmol/docs/?#planeexpressions plane selections].
  
One can select atoms within 0.01 angstrom distance within a plane (and by combing two of these selections, on a line).
+
One can select atoms within 0.01 angstrom distance within a plane (and by combining two of these selections, on a line). To display atoms up to 6 Angstrom away from a surface with Miller index 1 1 1, use:
  
* ''' '''
+
* '''display within (-6, hkl, {1 1 1})'''
 +
 
 +
Using a plane definition instead, for example by defining two atoms and one xyz coordinate (in angstroms).
 +
 
 +
* '''display within (3, PLANE, (atomno=5) (atomno=40) {0 0 0})'''
 +
 
 +
Or it is possible to draw a plane, define it, make it invisible, and then re-use the plane definition later on:
 +
 
 +
* '''draw plane1 (atomno=10) (atomno=40) {0 0 0};'''
 +
* '''draw plane1 off;'''
 +
* '''display within (-6, PLANE, $plane1)'''
 +
 
 +
One can first define two planes, then define the atoms enclosed by the two planes:
 +
 
 +
* '''draw plane1 (atomno=5) (atomno=40) {0 0 0}; '''
 +
* '''draw plane1 off;'''
 +
* '''draw plane2 (atomno=5) (atomno=40) {20 20 20};'''
 +
* '''draw plane2 off;'''
 +
* '''display (within (-3, PLANE, $plane1) and within (3, PLANE, $plane2))'''
  
 
= Topology expressions =
 
= Topology expressions =
Line 44: Line 62:
 
=== Select A or B ===
 
=== Select A or B ===
 
[[Image:Select_A_or_B.jpg]] Selects all atoms in the peptide chain, and all oxygen atoms, including the oxygen atoms in the water molecules.
 
[[Image:Select_A_or_B.jpg]] Selects all atoms in the peptide chain, and all oxygen atoms, including the oxygen atoms in the water molecules.
 +
Synonym: '''Select A,B'''
  
  
Line 50: Line 69:
  
 
=== Select A and not B ===
 
=== Select A and not B ===
[[Image:Select_A_not_B.jpg]] Selects the atoms in the peptide chain, but not the ones that are oxygen atoms.  
+
[[Image:Select_A_not_B.jpg]] Selects the atoms in the peptide chain, except those that are oxygen atoms.
  
=== Select (A or B ) and (not (A and B)) ===
+
=== Select (A or B ) and not (A and B) ===
 
[[Image:Select_A_or_B_and_not_A_and_B.jpg]] Selects all the peptide chain atoms and all the oxygen atoms, but not the oxygen atoms in the peptide chain.
 
[[Image:Select_A_or_B_and_not_A_and_B.jpg]] Selects all the peptide chain atoms and all the oxygen atoms, but not the oxygen atoms in the peptide chain.

Latest revision as of 22:08, 27 June 2009

Jmol / JSmol Tutorials


Selecting can be done via atom expressions or based on topology or geometry. Atom expressions in Jmol can be used in "select", "display", "hide" commands, as well as many others.

Atom expressions

In the reference the full list of atom expressions can be found. Common examples:

  • display *.CA displays all C-alpha atoms.
  • select _C selects all carbon atoms, usually (but not necessarily) equivalent to select *.C?? (the first identifies the element, the second just the atomm names and is only good for pdb files)
  • select [ALA] selects all atoms in alanine residues (pdb file format)
  • display 1, this will display only the first amino acid residue and/or molecule. If a file contains various molecules, and they are all numbered starting from 1, this will display only all first molecules or first residues of peptide strings.
  • display 1:A, if multiple chains are present, this will display only atoms in residue 1 of chain A.

Geometric expressions

Of course one can select based on distances:

  • display within(3.0,hydrophobic) displays only all atoms of hydrophobic residues (pdb file format), and all atoms within 3.0 Angstroms from these residues.

It is for the newest versions of Jmol also possible to select atoms according to plane selections.

One can select atoms within 0.01 angstrom distance within a plane (and by combining two of these selections, on a line). To display atoms up to 6 Angstrom away from a surface with Miller index 1 1 1, use:

  • display within (-6, hkl, {1 1 1})

Using a plane definition instead, for example by defining two atoms and one xyz coordinate (in angstroms).

  • display within (3, PLANE, (atomno=5) (atomno=40) {0 0 0})

Or it is possible to draw a plane, define it, make it invisible, and then re-use the plane definition later on:

  • draw plane1 (atomno=10) (atomno=40) {0 0 0};
  • draw plane1 off;
  • display within (-6, PLANE, $plane1)

One can first define two planes, then define the atoms enclosed by the two planes:

  • draw plane1 (atomno=5) (atomno=40) {0 0 0};
  • draw plane1 off;
  • draw plane2 (atomno=5) (atomno=40) {20 20 20};
  • draw plane2 off;
  • display (within (-3, PLANE, $plane1) and within (3, PLANE, $plane2))

Topology expressions

Some examples of using topologies as selection criteria: (check the reference for more options)

  • select molecule = 1 selects the first set of covalently bound atoms in the file.
  • select connected(3) selects all atoms that are connected by bonds to 3 other atoms.
  • select substructure("C(O)C") selects all ketone groups in the system. Any substructure strings in the SMILE format are accepted.

Combining selection statements

The combination of selection statements in Jmol is based on Boolean logic, using the statements And, Or, and Not, in a slightly different way than these are used in conversational language.

Example: We have a system consisting of water and a peptide chain. We are interested in selecting oxygen atoms. Let's call the set of atoms in the peptide chain A, and all oxygen atoms B.

Select A

Select A.jpg Selects all atoms in the peptide chain


Select A or B

Select A or B.jpg Selects all atoms in the peptide chain, and all oxygen atoms, including the oxygen atoms in the water molecules. Synonym: Select A,B


Select A and B

Select A and B.jpg Selects only the atoms that are both belonging to the peptide chain, and oxygen atoms. Therefore it selects only the oxygen atoms in the chain.

Select A and not B

Select A not B.jpg Selects the atoms in the peptide chain, except those that are oxygen atoms.

Select (A or B ) and not (A and B)

Select A or B and not A and B.jpg Selects all the peptide chain atoms and all the oxygen atoms, but not the oxygen atoms in the peptide chain.

Contributors

Pimpim, AngelHerraez