.. _getstructure_example:

.. include:: ../../apps-substitutions

.. program:: getstructure

======================
Example Commands
======================

The **getstructure** utility program is run by passing in a 4-letter PDB code:

.. code-block:: bash

   prompt> getstructure 4OBD

Here, **getstructure** will download :file:`4obd.cif.gz` (mmCIF structure) and
:file:`4obd_validation_2fo-fc_map_coef.cif.gz` (2Fo-Fc structure factor CIF) for X-ray structures.

To also download the legacy PDB format and the Fo-Fc structure factor file:

.. code-block:: bash

   prompt> getstructure -pdb -fofc 4OBD

This additionally downloads :file:`4obd.pdb.gz` and :file:`4obd_validation_fo-fc_map_coef.cif.gz`.

For cryo-EM structures, **getstructure** downloads the mmCIF file along with the associated
EMDB density map (``.map.gz``) and header (``.xml``) instead of structure factor CIF files.