You are reading the documentation for version 1.6 of OpenStructure. You may also want to read the documentation for: 1.1 1.2 1.3 1.4 1.5 devel

A gentle introduction to OpenStructure

In this tutorial you will be learning by example how to use the OpenStructure framework.

We assume that you already have a version of OpenStructure installed. If not, please refer to Installing OpenStructure From Source.

What will be covered in this tutorial?

The tutorial is divided into several parts. The first part of the tutorial is a walk-through of the basic functionality you will be using in your everyday work, followed by an introduction to the mol, img and seq modules.

Getting ready to rumble

The files we will be using in the tutorial are available in the examples directory that comes with OpenStructure. Depending on your platform, the examples are located at a different location:

  • on MacOS X the files are located inside the application bundle ( The file browser will automatically point to the examples.
  • on Linux the files are located at PREFIX/share/openstructure/examples, where PREFIX is the path to the directory containing OpenStructure.

Starting DNG

The graphical user interface of OpenStructure is called DNG (Dino/DeepView Next Generation). To start it,

  • on MacOS X double click
  • on Linux fire up a terminal change into the OpenStructure installation directory and type ‘bin/dng’. If you have the binary directory in the PATH, typing dng is sufficient.

Interactive Python Shell


Now we will enter commands in the Python shell (in the screenshot above, the Python shell (shown in green) is located at the right of the main window). If you want to get more information on any object, function or class, the Python help command may be useful. For example:

# get list of methods of EntityView
# get help for method Select

Continue with part one



Enter search terms or a module, class or function name.

Previous topic

Installing OpenStructure From Source

Next topic

Introduction to the mol Module

You are here