Editing Flatten obj (section)

= Arguments =

* name = a unique name for the flattened object {default: flat}

* selection = the set of objects to include in the flattening. The selection will be expanded to include all atoms of objects. {default: all}

* state = the source state to select. Use 0 or -1 to flatten all states {default: 0}

* rename = The scheme to use for renaming chains: {default: 0}
** (0) preserve chains IDs where possible, rename other chains alphabetically
** (1) rename all chains alphabetically
** (2) rename chains using the original chain letter, object name, and state

* quiet = If set to 0, print some additional information about progress and chain renaming {default: 1}

* chain_map = An attribute name for the 'stored' scratch object. If specified, `stored.<chain_map>` will be populated with a dictionary mapping the new chain names to a tuple giving the originated object, state, and chainID. {default: ""}