This is a read-only mirror of pymolwiki.org
Difference between revisions of "Get Names"
Jump to navigation
Jump to search
m (moved Get Names to Get Names of Type) |
m (1 revision) |
||
| (10 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
| − | ''' | + | '''get_names''' returns a list of object and/or selection names. |
===PYMOL API=== | ===PYMOL API=== | ||
<source lang="python"> | <source lang="python"> | ||
| − | cmd. | + | 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 | + | The default behavior is to return only object names. |
=== EXAMPLES === | === EXAMPLES === | ||
| − | + | Multiple alignments | |
<source lang="python"> | <source lang="python"> | ||
| − | # | + | # structure align all proteins in PyMOL to the protein named "PROT". Effectively a |
| − | for x in cmd. | + | # 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]], [[ | + | [[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"