“load” can by used to read molecules, crystallographic maps and other volumetric data, PyMOL sessions, and some other types of content.


load filename [,object [,state [,format ]]


filename = string: file path or URL

object = string: name of the object {default: filename prefix}

state = integer: number of the state into which the content should be loaded, or 0 for append {default:0}

format = pdb, ccp4, etc. {default: use file extension}): format of data file


load 1dn2.pdb 

load file001.pdb, ligand 

load http://pymol.org/sample.pdb 


The file extension is used to determine the format unless the format is provided explicitly.

If an object name is specified, then the file is loaded into that object. Otherwise, an object is created with the same name as the file prefix.

If a state value is not specified, then the content is appended after the last existing state (if any).

Supported molecular file formats include: pdb, mol, mol2, sdf, xyz, and others.

Supported map formats include: xplor, ccp4, phi, and others.

All supported file formats are covered in the reference documentation under File Formats.

See Also


Advanced Usage

load filename [,object [,state [,format [,finish [,discrete [, quiet [,multiplex [, zoom ]]]]]]]]

Advanced Arguments

finish = 0 or 1 (default:1) : should PyMOL finish the object or is more content to follow?

discrete = 0 or 1 (default: depends on format): does the molecular object have discrete states?

quiet = 0 or 1 (default:1) : should PyMOL provide text feedback?

multiplex = 0 or 1 (default: 0): should PyMOL load content into separate objects?

Advanced Notes

The finish option can be used to increase efficiency when loading lots of separate files into a single object.

The discrete option saves memory for objects where each atom appears in only one molecular state. SDF files are loaded as discrete by default.

The multipex option can be used to load certain file types into separate objects.

Copyright © Schrödinger, LLC. All Rights Reserved.