Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

unfold-protein: velocity clamp protein unfolding experiment control

Project Description


Unfold-protein is a set of tools for controlling velocity-clamp single molecule force spectroscopy. It uses the pyafm package for low level AFM control. This package contains the high-level experiment control logic.



I’ve packaged pyafm for Gentoo. You need layman and my wtk overlay. Install with:

# emerge -av app-portage/layman
# layman --add wtk
# emerge -av sci-physics/unfold-protein


Unfold-protein requires the following Python modules:

Getting the source

Unfold-protein is available as a Git repository:

$ git clone git://

There are also periodic bundled releases. For example, get version 0.2 as a gzipped tarball with:

$ wget ';a=snapshot;h=v0.2;sf=tgz'
$ tar -xzvf unfold-protein-0.2.tar.gz


After downloading, change to the source directory and run:

$ python install

to install unfold-protein. Run:

$ python install --help

to see a list of installation options you may want to configure.


The script runs a series of unfolding pulls while scanning the pulling velocity and contact position. It has a few command line options; get details with:

$ --help

You can configure the unfolding and scanning behavior using h5config. The configuration is stored in ~/.config/unfold-default.yaml. To seed this configuration file before tweaking it, you should configure pyafm (as described in its README). Then run:

>>> import as storage
>>> config = storage.get_default_config()
>>> storage.save_scan_config(config=config)

to create a configuration using the default settings. The YAML syntax is plain text, which you can edit as you see fit. Future runs of (and calls to will load this configuration by default. saves each unfolding pull in its own timestamped file with the unfolding data along with the complete configuration used to acquire it. You can configure the directory where these files are stored with the unfold/save/base directory setting. You can convert the saved unfolding data to PNGs with For example:

$ ~/rsrch/data/unfold/*.h5

For more detailed analysis, you may want to use Hooke. You may also want to use calibcant to calibrate your AFM cantilever’s bending spring constant.

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(21.6 kB) Copy SHA256 Hash SHA256
Source None May 27, 2013

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers