This is a read-only mirror of pymolwiki.org
Difference between revisions of "Set name"
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
===DESCRIPTION=== | ===DESCRIPTION=== | ||
− | + | '''set_name''' can be used to change the name of an object or selection. | |
− | + | ||
− | + | Not only can you simply rename an object or selection, but this command is also a powerful tool for those who deal with multiple structures in one file --- say a collection of NMR models. The user can execute the [[Split_States]] command and then rename the molecule of choice in the state of choice. For example, if one loads an NMR structure (with, say, 20 states) and aligns it to another structure, the balance of the alignment will (most likely) be off due to the weighting of the 19 other structures you probably don't see. To overcome this problem, one simply executes [[Split_States]] and then renames one of the states and then aligns that newly renamed object. | |
+ | |||
===USAGE=== | ===USAGE=== | ||
− | + | set_name old_name, new_name | |
− | + | ||
− | |||
===PYMOL API=== | ===PYMOL API=== | ||
− | + | <source lang="python"> | |
− | + | cmd.set_name(string old_name, string new_name) | |
− | + | </source> | |
+ | |||
+ | ==User Comments/Examples=== | ||
+ | <source lang="python"> | ||
+ | cmd.set_name("example", "nicename") | ||
+ | </source> | ||
[[Category:Commands|set_name]] | [[Category:Commands|set_name]] |
Revision as of 15:56, 31 July 2007
DESCRIPTION
set_name can be used to change the name of an object or selection.
Not only can you simply rename an object or selection, but this command is also a powerful tool for those who deal with multiple structures in one file --- say a collection of NMR models. The user can execute the Split_States command and then rename the molecule of choice in the state of choice. For example, if one loads an NMR structure (with, say, 20 states) and aligns it to another structure, the balance of the alignment will (most likely) be off due to the weighting of the 19 other structures you probably don't see. To overcome this problem, one simply executes Split_States and then renames one of the states and then aligns that newly renamed object.
USAGE
set_name old_name, new_name
PYMOL API
cmd.set_name(string old_name, string new_name)
User Comments/Examples=
cmd.set_name("example", "nicename")