deselect.interatom

Synopsis

Deselect specific interatomic data containers.

Defaults

deselect.interatom(spin_id1=None, spin_id2=None, boolean=`AND', change_all=False)

Keyword arguments

spin_id1: The spin ID string of the first spin of the interatomic data container.

spin_id2: The spin ID string of the second spin of the interatomic data container.

boolean: The boolean operator specifying how interatomic data containers should be selected.

change_all: A flag specifying if all other interatomic data containers should be changed.

Description

This is used to deselect specific interatomic data containers which store information about spin pairs such as RDCs, NOEs, dipole-dipole pairs involved in relaxation, etc. The `change all' flag default is False meaning that all interatomic data containers currently either selected or deselected will remain that way. Setting this to True will cause all interatomic data containers not specified by the spin ID strings to be deselected.

Boolean operators

The boolean operator can be used to change how spin systems or interatomic data containers are selected. The allowed values are: `OR', `NOR', `AND', `NAND', `XOR', `XNOR'. The following table details how the selections will occur for the different boolean operators.

Please see Table 17.1 on page .

Table 17.1: Boolean operators and their effects on selections

Spin system or interatomic data container	1	2	3	4	5	6	7	8	9
Original selection	0	1	1	1	1	0	1	0	1
New selection	0	1	1	1	1	1	0	0	0
OR	0	1	1	1	1	1	1	0	1
NOR	1	0	0	0	0	0	0	1	0
AND	0	1	1	1	1	0	0	0	0
NAND	1	0	0	0	0	1	1	1	1
XOR	0	0	0	0	0	1	1	0	1
XNOR	1	1	1	1	1	0	0	1	0

Prompt examples

To deselect all N-H backbone bond vectors of a protein, assuming these interatomic data containers have been already set up, type one of:

[numbers=none]
relax> deselect.interatom('@N', '@H')

[numbers=none]
relax> deselect.interatom(spin_id1='@N', spin_id2='@H')

To deselect all H-H interatomic vectors of a small organic molecule, type one of:

[numbers=none]
relax> deselect.interatom('@H*', '@H*')

[numbers=none]
relax> deselect.interatom(spin_id1='@H*', spin_id2='@H*')