User Tools

Site Tools



“fetch” downloads a file from the internet (if possible)


fetch code [, name [, state [, finish [, discrete [, multiplex [, zoom [, type [, async ]]]]]]]]


code = a single PDB identifier or a list of identifiers.

name = the object name into which the file should be loaded.

state = the state number into which the file should loaded.

finish = (internal argument)

discrete = 0/1: make discrete states for multi-state objects {default: 0}

multiplex = 0/1: split states into individual objects {default: 0}

zoom = 0/1: zoom camera on new object {default: 1}

type =

  • pdb: PDB assymetric unit {default}
  • pdb1: PDB biological unit
  • 2fofc: electron density
  • fofc: difference density
  • cid: PubChem compound ID (new in 1.6.1)
  • sid: PubChem substance ID (new in 1.6.1)

async = 0/1: fetch in background (do not lock the interface) {default: 0 from PyMOL scripts, 1 from python API}


When running in interactive mode, the fetch command loads structures asyncronously by default, meaning that the next command may get executed before the structures have been loaded. If you need synchronous behavior in order to insure that all structures are loaded before the next command is executed, please provide the optional argument “async=0”.

Fetch requires a direct connection to the internet and thus may not work behind certain types of network firewalls.


fetch 1rx1, async=0
fetch 1rx1, type=2fofc

New in 1.6.1:

fetch CID_6830 SID_416404
fetch 6830, type=cid
fetch 416404, type=sid

See Also


command/fetch.txt · Last modified: 2013/08/19 21:01 (external edit)