View source for Get raw distances

{{Infobox script-repo
|type      = module
|filename  = scripts/get_raw_distances.py
|author    = [[User:TakanoriNakane|Takanori Nakane]] and [[User:Speleo3|Thomas Holder]]
|license   = BSD-2-Clause
}}

{{Infobox psico
|module    = psico.querying
}}

[[get_raw_distances]] can dump distance objects, created with [[distance]].

This script also provides the command '''select_distances''', which selects atoms from distance objects.

''Warning: the atoms are hashed by coordinates; this could cause issues if coordinates are altered after distance objects have been created (see also [[dynamic_measures]] setting).''

== Usage ==

 get_raw_distances [ names [, state [, selection ]]]

 select_distances [ names [, name [, state [, selection [, cutoff ]]]]]

== Arguments ==

* '''names''' = string: names of distance objects (no wildcards!) {default: all measurement objects}
* '''state''' = integer: object state {default: 1}
* '''selection''' = string: atom selection {default: all}

== Example ==

<syntaxhighlight lang="python">
fetch 2xwu, async=0

# interface polar contacts
distance iface_hbonds, chain A, chain B, mode=2

# dump (model,index) information
get_raw_distances iface_hbonds
</syntaxhighlight>

== Example Atom Selection ==

<syntaxhighlight lang="python">
# select atoms
select_distances iface_hbonds, hbsele

# nice representation
set cartoon_side_chain_helper
set sphere_scale, 0.5
as cartoon, 2xwu
show sticks, byres hbsele
show spheres, hbsele
</syntaxhighlight>

== See Also ==

* [[distance]]
* [[dynamic_measures]]
* [[find_pairs]]
* [[get_raw_alignment]]

[[Category:Script Library]]
[[Category:ObjSel_Scripts]]
[[Category:Pymol-script-repo]]