This is a read-only mirror of pymolwiki.org

Difference between revisions of "Get Names"

From PyMOL Wiki
Jump to navigation Jump to search
m (1 revision)
 
(11 intermediate revisions by 7 users not shown)
Line 1: Line 1:
'''get_names_of_type''' returns a list of object and/or selection names.
+
'''get_names''' returns a list of object and/or selection names.
  
 
===PYMOL API===
 
===PYMOL API===
 
<source lang="python">
 
<source lang="python">
cmd.get_names_of_type( [string: "type"] )
+
cmd.get_names(type,enabled_only,selection)
 
</source>
 
</source>
  
 +
===ARGUMENTS===
 +
* '''type : string''' determines the type of objects to be returned. It can take any of the following values:
 +
** '''objects''' Structure objects
 +
** '''selections''' All selection
 +
** '''all''' Objects and Selections
 +
** '''public_objects''' (default)
 +
** '''public_selections'''
 +
** '''public_nongroup_objects'''
 +
** '''public_group_objects'''
 +
** '''nongroup_objects'''
 +
** '''group_objects'''
 +
* '''enabled_only : boolean''' If 1, only enabled objects are returned. Default 0 (all objects)
 +
* '''selection'''
 
===NOTES===
 
===NOTES===
The object types are strings such as "object:molecule" for a molecule type and "object:map" for a map.
+
The default behavior is to return only object names.
  
 
=== EXAMPLES ===
 
=== EXAMPLES ===
Truncate names of all molecules
+
Multiple alignments
 
<source lang="python">
 
<source lang="python">
# Get names for all molecules.
+
# structure align all proteins in PyMOL to the protein named "PROT".  Effectively a
for x in cmd.get_names_of_type("object:molecule"): cmd.set_name(x,x[:5])
+
# poor multiple method for multiple structure alignment.
 +
for x in cmd.get_names("all"): cealign( "PROT", x)
 
</source>  
 
</source>  
 +
 +
Determine whether or not an object (objName) is enabled:
 +
<source lang="python">
 +
if objName in cmd.get_names(enabled_only=1):
 +
    print objName, "is enabled"
 +
</source>
  
 
===SEE ALSO===
 
===SEE ALSO===
[[get_type]], [[count_atoms]], [[count_states]],[[get_names_of_type]]
+
[[get_type]], [[get_names_of_type]], [[count_atoms]], [[count_states]]
  
 
[[Category:Commands|Get Names]]
 
[[Category:Commands|Get Names]]

Latest revision as of 03:47, 7 March 2016

get_names returns a list of object and/or selection names.

PYMOL API

cmd.get_names(type,enabled_only,selection)

ARGUMENTS

  • type : string determines the type of objects to be returned. It can take any of the following values:
    • objects Structure objects
    • selections All selection
    • all Objects and Selections
    • public_objects (default)
    • public_selections
    • public_nongroup_objects
    • public_group_objects
    • nongroup_objects
    • group_objects
  • enabled_only : boolean If 1, only enabled objects are returned. Default 0 (all objects)
  • selection

NOTES

The default behavior is to return only object names.

EXAMPLES

Multiple alignments

# structure align all proteins in PyMOL to the protein named "PROT".  Effectively a 
# poor multiple method for multiple structure alignment.
for x in cmd.get_names("all"): cealign( "PROT", x)

Determine whether or not an object (objName) is enabled:

if objName in cmd.get_names(enabled_only=1):
    print objName, "is enabled"

SEE ALSO

get_type, get_names_of_type, count_atoms, count_states