From BlenderWiki

Jump to: navigation, search
Atomic Blender
Imports XYZ files
UI location File -> Import -> XYZ (.xyz)

File -> Export -> XYZ (.xyz)

Usage Import: Choose the pdb file, the options and go onto 'Import'. The atomic structure is then automatically imported afterwards.

Export: Select all objects and structures and export them.

Version 1.0 (2012-11-10) Author(s) Blendphys (Clemens Barth)
Blender >= 2.64 License GPL
Category Import-Export
Note(s) 1. A panel can be used (Atomic Blender - Utilities), which helps modifying atomic structures.

2. Other details about the ad-don can be found here: other details

3. Please, use Blender version >= 2.64

4. The number of atoms has to be the same for all frames!!

Executable information
File name see files in directory ../scripts/addons/io_mesh_xyz
Current version download
External Python Modules or dependencies No dependencies
Data A custom data file can be used for the colours and radii of the elements. You can download it from here:

Warning /
Links Atomic Blender personal pages
Release Log Forum


Quick install

The addon is not in the official version of Blender. You have to manually install the addon. The best thing to do is:

  1. Download the file from here: (Do not unzip)
  2. Go to Menu: File -> User Preferences ... -> Addons (top)
  3. At the bottom, push Install addon and load the downloaded file.
  4. Search for the XYZ - Atomic Blender script in the addon list and activate it (top right, check box). If the script shall be present after each start of Blender choose Save As Default.
  5. Re-start Blender!

If you want to have the Atomic Blender - Utilities panel, visit this page: Atomic Blender - Utilities panel


The addon can be discussed in this forum:

Examples, recent highlights

This is indeed a highlight, a movie that has been done by the Femto-ST CNRS institute in Besançon (France) (Creator: Sébastien Coget, Researchers: Frank Palmino and Frederic Cherioux)! It demonstrates the combination of the Atomic Blender addons and Blender, and shows that very professional movies can be done for research by Blender. The movie was rendered with cycles. Other movies from the Femto-ST can be found here.

Examples, literature

Here are some Cover Pictures and figures, which were produced with Blender and the Atomic Blender addons for high impact journals:

Cover Picture in Advanced Materials 2012. Cover Picture in Chem. Soc. Rev. 2013. Figure in New Journal of Physics 2012.

Figure in Scientific Reports 2013.

Figure in ChemPhysChem 2013.

Examples, other

You can use this test file to try out the XYZ importer: File:XYZ You should see almost same objects as shown in the video (without plane, add one if you want to). Have fun ... .

TBI molecule on a SiB surface. All materials changed, and then rendered using Cycles
TBI network on a SiB surface. All materials changed, and then rendered using Cycles

What is it good for?

  • Producing fancy graphics of structures (atoms, molecules, clusters, surfaces, etc.) for high-impact journals
  • Producing fancy movies of structures (interesting for especially theory that produces snapshots of calculations stored in a xyz file)
  • 3D scene: Visualisation and analysing structures
  • 3D scene: Scientific discussions
  • Education
  • Having fun



  • Import of atoms with x, y and z coordinates
  • Frames, for animation

The number of atoms has to be the same for all frames!!


  • Varying number of atoms in frames

Importing XYZ files

Using Atomic Blender is quite easy:
Import Protein Data Bank
  1. Got to: File » Import » XYZ (.xyz)
  2. In the file dialog you find some options on the left. Scroll down to the panel if necessary. Make a choice of options (explained below).
  3. Search your XYZ file and press the button XYZ (*.xyz). Your structure will then be loaded.

File dialog window

File selector options

Operator Presets - This property is useful to store all the properties you can see below by a key that one can save as follows: First, choose your options by modifying the properties below. Then, go onto + and add a new key and go on okay. - The next time when you want to load a XYZ structure, you can choose the key and all options are restored.

Camera and lamp - The camera and lamp are useful for obtaining a quick impression of a loaded structure. If the button Camera is active, a camera is put into the scene. The camera is 10 times the size of the structure far away from the center of the structure. The camera automatically points to the structure. In the Camera View the camera can be positioned via ⇧ ShiftF for instance (see manual for Blender). A lamp can be loaded, too. The lamp is automatically positioned between structure and camera.

In order to activate the camera, choose the camera A_camera in the Outliner (top right of the Blender Window). Then go to the 3D View and choose in the menu: File » View » Cameras » Set Active Object as Camera.

Type of ball - The type of ball can be chosen, either 'NURBS' (default), 'Mesh' or 'Meta' balls. If 'Mesh' is chosen the number of sectors in azimuth and zenith directions can be chosen as well.

Scalling factors - The radii of all atoms and all distances can be scaled with the two scaling factors.

Object to origin - Sometimes it may happen that structures in XYZ files have an offset. If this button is active, the structure is put into the center of the scene.

Type of radii - With this bool enumerator the type of radii can be chosen. Either one uses pre-defined radii, atomic radii or van der Waals radii.The default values for pre-defined radii are the atomic radii.

Load all frames? - A XYZ file can contain more than one frame. If this option is chosen, all frames are imported. The two properties at the buttom can be used to specify how the import of all frames shall be done. Note that the number of atoms has to be the same for all frames!!

Skip frames - Number of frames that are skipped during loading the frames (default = 0: show all frames). - Sometimes, XYZ files contain a large number of frames. In order to reduce the number, each 2nd or 3rd or ... frame can be skipped during loading. If the value is 1 (2), each 2nd (3rd) frame is shown. The remaining loaded frames have one shape key each!

Frames / key - Number of Blender frames (images) between two shape keys (frames from the XYZ file). - The movement of the atoms between two frames of the XYZ file is extrapolated in additional Blender frames (images). This is useful when the movement of atoms shall be more smooth between two keys (frames from XYZ). Increase this number for more smooth movements. Note that the number of rendered images can considerably increase at the same time!

When the structure is loaded it can be seen in the 3D View. The components of the structure are listed in the Outliner (top right in the Blender window). All atoms of one type form one Group.

Dupliverts structures and center atom

When atomic structures are imported via the PDB or XYZ importer the atoms are put into so-called dupliverts structures, somewhat into groups of elements (e.g. all hydrogens into one dupliverts structure). A dupliverts structure of one element (e.g., hydrogens) consists of a mesh of vertices, which are located at the positions of the atoms. The number of vertices equals the number of atoms. Furthermore, a dupliverts structure has a representative ball, the atom itself (e.g., hydrogen). This ball is then duplicated at all vertices such that the atomic structure is build. Single atoms can be deleted or displaced in the Edit Mode of Blender by modifying the position of the vertices. However, they are always a part of the structure and are not independent objects.

The center atom visible in the 3D scene of Blender
The center atom is not visible anymore in the rendered image

After the import of an atomic structure into the 3D scene of Blender, the atoms and sticks are visible but also an atom (ball) and stick (cylinder) in the center of the structure (left). The center ball and cylinder do not make sense, but they are very important: they are the representative objects of the dupliverts structures. They cannot be deleted or made invisble, they are always there. However, when rendering a picture these balls and cylinders disappear (right). So, after all they do not really disturb.

Exporting to XYZ

Calling the exporter

It is possible to export the x, y and z coordinates and names of the atoms or structures (objects) in a Blender scene into a XYZ file. Go to: Menu -> File -> Export -> XYZ (.xyz). The objects can be 'normal' objects or dupliverts structures. They all must be selected and visible in the 3D Blender scene. In the file dialog, one can choose between 'Elements' or 'All'. Option 'Elements' means that only those objects or structures are exported, which contain the name of an element. If option 'All' is chosen, the coordinates of all marked objects and structures are exported. If the name does not contain a name of an element, a '?' is put into the XYZ file.

Note: Converting all atoms of a dupliverts structure to real objects

Do the following: Select the whole structure (molecules, surface, or what ever) with the mouse. Go to objects Apply -> Make Dupliverts Real or just push Shift Control A. With this you produce real objects! In the outliner delete the remaining dupliverts, named like 'Carbon', 'Hydrogen', etc.