## model.rename_segments() — rename MODEL segments

`rename_segments(segment_ids, renumber_residues=[])`

> This assigns single character PDB chain IDs (from segment_ids; there should be as many elements in segment_ids as there are chains in the current MODEL). The residues in each chain are also renumbered consecutively, starting with the corresponding element from renumber_residues if provided, or the existing first residue number otherwise.

> See also Chain.name for assigning chain IDs individually without also renumbering residues.

Example: examples/commands/rename_segments.py

      # Example for: model.rename_segments()

      # This will assign new PDB single-character chain id's to all the chains
      # in the input PDB file (in this example there are two chains).

      from modeller import *

      env = environ()
      env.io.atom_files_directory = ['../atom_files']
      mdl = model(env, file='2abx')

      # Assign new segment names and write out the new model:
      mdl.rename_segments(segment_ids=('X', 'Y'))
      mdl.write(file='2abx-renamed.pdb')