Difference between revisions of "Select"

From PyMOLWiki
Jump to: navigation, search
(usage/arguments)
 
Line 2: Line 2:
 
'''select''' creates a named selection from an atom selection.  Selections are one of the most powerful aspects of PyMOL and learning to use selections well is paramount to quickly achieving your goals in PyMOL.
 
'''select''' creates a named selection from an atom selection.  Selections are one of the most powerful aspects of PyMOL and learning to use selections well is paramount to quickly achieving your goals in PyMOL.
  
===USAGE===
+
== Usage ==
 +
 
 +
select name [, selection [, enable [, quiet [, merge [, state ]]]]]
 +
 
 +
Convenience shortcut to create selection with name "sele":
 +
 
 
  select (selection)
 
  select (selection)
select name, (selection)
 
select name = (selection)            # (DEPRECATED)
 
  
===PYMOL API===
+
== Arguments ==
<source lang="python">
+
 
cmd.select(string name, string selection)
+
* '''name''' = str: a unique name for the selection {default if skipped: sele}
</source>
+
* '''selection''' = str: a selection-expression
 +
* '''enable''' = 0/1: show selection indicators {default: 1}
 +
* '''quiet''' = 0/1 {default: 0 for command, 1 for API}
 +
* '''merge''' = 0/1: update existing named selection {default: 0}
 +
* '''state''' = int: object state, affects spacial operators like '''within''' {default: 0 (all states)}
 +
 
 +
== Examples ==
  
===EXAMPLES===
 
 
  select near , (ll expand 8)
 
  select near , (ll expand 8)
 
  select near , (ll expand 8)
 
  select near , (ll expand 8)
  select bb, (name ca,n,c,o )
+
  select bb, (name CA+N+C+O)
 
<source lang="python">
 
<source lang="python">
 
cmd.select("%s_%s"%(prefix,stretch), "none")
 
cmd.select("%s_%s"%(prefix,stretch), "none")
 
</source>
 
</source>
  
===NOTES===
+
== Notes ==
 +
 
 
Type '''help selections''' for more information about selections.  
 
Type '''help selections''' for more information about selections.  
  
===SEE ALSO===
+
== See Also ==
 +
 
 
*[[Selection Algebra]]
 
*[[Selection Algebra]]
 
*[[Property Selectors]]
 
*[[Property Selectors]]

Latest revision as of 14:06, 23 July 2018

select creates a named selection from an atom selection. Selections are one of the most powerful aspects of PyMOL and learning to use selections well is paramount to quickly achieving your goals in PyMOL.

Usage

select name [, selection [, enable [, quiet [, merge [, state ]]]]]

Convenience shortcut to create selection with name "sele":

select (selection)

Arguments

  • name = str: a unique name for the selection {default if skipped: sele}
  • selection = str: a selection-expression
  • enable = 0/1: show selection indicators {default: 1}
  • quiet = 0/1 {default: 0 for command, 1 for API}
  • merge = 0/1: update existing named selection {default: 0}
  • state = int: object state, affects spacial operators like within {default: 0 (all states)}

Examples

select near , (ll expand 8)
select near , (ll expand 8)
select bb, (name CA+N+C+O)
cmd.select("%s_%s"%(prefix,stretch), "none")

Notes

Type help selections for more information about selections.

See Also