Difference between revisions of "Get Names"
Jump to navigation
Jump to search
m (→EXAMPLES: Changed the example so that it will print the actual object name) |
(Updating argument list) |
||
| Line 3: | Line 3: | ||
===PYMOL API=== | ===PYMOL API=== | ||
<source lang="python"> | <source lang="python"> | ||
| − | cmd.get_names( | + | 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 default behavior is to return only object names. | The default behavior is to return only object names. | ||
Latest revision as of 11:31, 19 February 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"