This is a read-only mirror of pymolwiki.org
Difference between revisions of "Get Names"
Jump to navigation
Jump to search
m (1 revision) |
|||
| (19 intermediate revisions by 8 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"> | |
| − | + | cmd.get_names(type,enabled_only,selection) | |
| − | + | </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 default behavior is to return only object names. | |
| − | + | ||
| + | === EXAMPLES === | ||
| + | Multiple alignments | ||
| + | <source lang="python"> | ||
| + | # 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) | ||
| + | </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_names_of_type]], [[count_atoms]], [[count_states]] | |
| − | + | ||
| − | [[Category:Commands| | + | [[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"