Editing Iterate (section)

== Exposed Variables ==

All commands in the '''iterate'''-family expose the following variables:

*'''model''' (str): the object name (appearing in the selection panel on the right) (cannot be altered)
*'''name''' (str): the atom name
*'''resn''' (str): the residue name
*'''oneletter''' (str): '''resn''' translated to one letter code, like it's displayed in the sequence viewer (cannot be altered, alter '''resn''' instead) (PyMOL 1.8.7+)
*'''resi''' (str): the residue identifier (residue number) as a string, including optional insertion code
*'''resv''' (int): the residue identifier (residue number) as an integer, excluding insertion code
*'''chain''' (str): the chain name
*'''alt''' (str): alternate location identifier
*'''elem''' (str): the chemical element
*'''q''' (float): occupancy
*'''b''' (float): the B Factor
*'''segi''' (str): segment identifier (columns 73-76 in PDB file)
*'''type''' (str: ATOM,HETATM): the atom type (PDB convention for canonical polymer residues)
*'''formal_charge''' (int): the formal charge of the atom
*'''partial_charge''' (float): the partial charge of the atom
*'''numeric_type'''
*'''text_type''' (str): automatic mol2 atom typing (Incentive PyMOL 1.4+)
*'''stereo''' (str): automatic stereochemical R/S label (Incentive PyMOL 1.4+)
*'''ID''' (int): PDB atom id (not guaranteed to be unique)
*'''rank''' (int): atom index from original file import (not guaranteed to be unique)
*'''index''' (int): internal atom index (unique per object, sensitive to [[sort|sorting]] and [[remove|removing]] of atoms, cannot be altered)
*'''vdw''' (float): Van der Waals radius
*'''ss''' (str): secondary structure
*'''color''' (int): color index
*'''reps''' (int): numeric mask of shown representations (PyMOL 1.7.4+)
*'''protons''' (int): (PyMOL 1.7.4+)
*'''p''' (object): property object to access user-defined properties like '''p.abc''' (Incentive PyMOL 1.7+)
*'''s''' (object): settings object to access settings, e.g. '''s.sphere_scale''' (Incentive PyMOL 1.7+, Open-Source PyMOL 1.8.1+)
*'''label''' (str): see [[label]]
*'''geom''' (int): 1=single, 2=linear, 3=planar, 4=tetrahedral (see [[set_geometry]])
*'''valence''' (int): expected number of bonds (?)
*'''flags''' (int): bitmask, see [[flag]]
*'''cartoon''' (int): see [[cartoon]]

The '''iterate_state''' and '''alter_state''' commands in addition expose:

*'''x''' (float): x-coordinate
*'''y''' (float): y-coordinate
*'''z''' (float): z-coordinate
*'''state''' (int): (PyMOL 1.7.0+)