FreeSASA  2.0.3
Open source SASA calculations
View on GitHub

![DOI]( ![Build Status]( ![Coverage Status](

FreeSASA is a C library and command line tool for calculating Solvent Accessible Surface Area (SASA) of biomolecules. It is designed to be simple to use with defaults, but allows customization of all parameters of the calculation and provides a few different tools to analyze the results. Python bindings are provided separately (see below).

By default Lee & Richards' algorithm is used, but Shrake & Rupley's is also available. Both can be parameterized to arbitrary precision, and for high resolution versions of the algorithms, the calculations give identical results.

FreeSASA assigns a radius and a class to each atom. The atomic radii are by default the ProtOr radii defined by Tsai et al. (JMB 1999, 290: 253) for standard amino acids and nucleic acids, and the van der Waals radius of the element for other atoms. Each atom is also classified as either polar or apolar.

Users can provide their own atomic radii and classifications via configuration files. The input format for configuration files is described in the online documentation, and the share/ directory contains some sample configurations, including one for the NACCESS parameters (Hubbard & Thornton 1993).

Version 2.0 adds some new features and breaks a few parts of the interface from 1.x (mainly the API), see for detailed information.

Building and installing

FreeSASA can be compiled and installed using the following

make && make install

NB: If the source is downloaded from the git repository the configure-script needs to be set up first using autoreconf -i. Users who don't have autotools installed, can download a tarball that includes the autogenerated scripts from or from the latest GitHub-release.

The above commands build and install the command line tool freesasa (built in src/), the commands

freesasa -h

and, if installed,

man freesasa

give an overview of options. To run a calculation from PDB-file input using the defaults, simply type

freesasa <pdb-file>

In addition, make install installs the header freesasa.h and the library libfreesasa.

The configuration can be changed with these options:

For developers:

Python module

The Python bindings are available from PyPi and can be installed using

pip install freesasa

This module is found in a separate repository The PyPi module has binaries for Mac OS X and Windows, for a number of Python versions and separate documentation.


Enabling Doxygen builds a full reference manual, documenting both CLI and API in the folder doc/html/doxygen/, also available on the web at

After building the package, calling

freesasa -h

explains how the commandline tool can be used.

Compatibility and dependencies

The library has been tested successfully with several versions of GNU C Compiler and Clang/LLVM. It can be built using only standard C and GNU libraries. The standard build depends on json-c and libxml2. These can be disabled by configuring with --disable-json and --disable-xml respectively.

Developers who want to do testing need to install the Check unit testing framework. Building the full reference manual requires Doxygen (version > 1.8.8). Changing the selection parser and lexer requires Flex and Bison. These build options, which add extra dependencies, are disabled by default to simplify installation for users only interested in the command line tool and and/or C Library.

The C API can be built using MSVC, see: (no project files provided though), but probably not the command line tool. It should be relatively straightforwad to build the command line tool for Windows using MinGW or Cygwin, but this hasn't been tested (let me know if you've got it to work).

Citing FreeSASA

FreeSASA can be cited using the following publication

The DOI numbers from Zenodo can be used to cite a specific version of FreeSASA.