Distance: Difference between revisions
Jump to navigation
Jump to search
m (→EXAMPLE) |
No edit summary |
||
Line 1: | Line 1: | ||
===DESCRIPTION=== | ===DESCRIPTION=== | ||
'''distance''' creates a new distance object between two selections. It will display all distances within the cutoff. | |||
selections. It will display all distances within the cutoff. | |||
===USAGE=== | ===USAGE=== | ||
Line 14: | Line 13: | ||
===PYMOL API=== | ===PYMOL API=== | ||
<source lang="python"> | |||
cmd.distance( string name, string selection1, string selection2, | |||
string cutoff, string mode ) | |||
# returns the average distance between all atoms/frames | # returns the average distance between all atoms/frames | ||
</source> | |||
===NOTES=== | ===NOTES=== | ||
The distance wizard makes measuring distances easier than using | The distance wizard makes measuring distances easier than using the "dist" command for real-time operations. | ||
the "dist" command for real-time operations | |||
"dist" alone will show distances between selections (pk1) and (pk1), which can be set using the PkAt mouse action (usually CTRL-middle-click). | |||
===EXAMPLES=== | ===EXAMPLES=== | ||
Line 43: | Line 41: | ||
===SEE ALSO=== | ===SEE ALSO=== | ||
[[Measure_Distance]] | [[Measure_Distance]] | ||
[[Category:Commands|distance]] | [[Category:Commands|distance]] |
Revision as of 14:22, 3 January 2006
DESCRIPTION
distance creates a new distance object between two selections. It will display all distances within the cutoff.
USAGE
distance distance (selection1), (selection2) distance name = (selection1), (selection2) [,cutoff [,mode] ] name = name of distance object selection1, selection2 = atom selections cutoff = maximum distance to display mode = 0 (default)
PYMOL API
cmd.distance( string name, string selection1, string selection2,
string cutoff, string mode )
# returns the average distance between all atoms/frames
NOTES
The distance wizard makes measuring distances easier than using the "dist" command for real-time operations.
"dist" alone will show distances between selections (pk1) and (pk1), which can be set using the PkAt mouse action (usually CTRL-middle-click).
EXAMPLES
- This neat example shows how to create distance measurements from an atom in a molecule to all other atoms in the molecule (since PyMol supports wildcards).
cmd.dist("(/mol1///1/C)","(/mol1///2/C*)")
or written without the PyMolScript code,
dist /mol1///1/C, /mol1///2/C*
- Create multiple distance objects
for at1 in cmd.index("resi 10"): \
for at2 in cmd.index("resi 11"): \
cmd.dist(None, "%s`%d"%at1, "%s`%d"%at2)