The TAPBS documentation

Gernot Kieseritzky


1. Introduction
1.1. What is TAPBS?
1.2. Multiple conformations
2. Installation
2.1. Installation and patching of APBS 4.0
2.2. Compilation and installation of TAPBS
3. Running
4. Syntax of input to stdin
4.1. General syntax
4.2. List of keywords
5. File formats
5.1. PQR file format
5.2. SITES files (*.sites)
5.3. Residue state description files (*.ST)
5.4. Potential binary file format
5.5. Intrinsic pK values (*.pkint)
5.6. W interaction matrix (*.g)
6. Copyright

1. Introduction

1.1. What is TAPBS?

TAPBS calculates electrostatic energies needed for continuum electrostatics based pKa and redox calculations. It prepares the input files by Karlsberg 2.0 to predict protonation and redox patterns in a protein. Essentially, TAPBS is a front end to APBS 4.0, a stand-alone program developed by Nathan Baker at the University of Washington to solve the linearized Poisson-Boltzmann equation (LPBE) numerically, which tries to efficiently and conveniently automate the large number of LPBE calculations needed to compute Born solvation, background and pair wise energy terms that determine pKa values. TAPBS supports local conformational changes, multiple charged states, protein regions of different dielectric constant and implicit membrane slabs.

1.2. Multiple conformations

TAPBS is able to calculate electrostatic energy shifts for conformational states of molecular groups within macromolecules to be used in Karlsberg 2.0 to predict pH-dependent conformational changes such as hydrogen bonding patterns that usually highly depends on the protonation/redox states of titratable groups. The LPBE will be solved twice for each state of a flexible group in a) the solution state and b) the protein environment. In the standard approach used by TAPBS the protein environment consists of the combined dielectric volume of all conformers, i.e. combines all conformers as defined by the set of ST-files (see below) into a single protein volume. However, the location of the partial charges is moved for each conformational state to calculate its corresponding electrostatic potential from the solution of the LPBE. This approximation is, of course, only valid for small conformational changes such as hydrogen flexibility. For larger conformational variations one should make use of the global conformations supported by Karlsberg 2.0 as was done e.g. in Karlsberg+.

2. Installation

First of all download the source package of TAPBS provided on the Karlsberg+ website and extract its contents into the directory TAPBSDIR.

2.1. Installation and patching of APBS 4.0

The following procedure assumes that you have installed in a directory BLASLIB a copy of the open source "Automatically Tuned Linear Algebra Software" (ATLAS) numeric libraries suitable for your computing environment (which is highly recommended of you want good performance). It is also assumed that you have installed a GNU compiler collection. Download the source package of APBS 4.0 (but don't forget to register) and MALOC 0.1-2 (a hardware abstraction layer that is used by APBS). Untar the source packages in any directory which in the following will be referred to as BASEDIR. It should now contain two directories BASEDIR/apbs-0.4.0 and BASEDIR/maloc-0.1, respectively. Create an installation directory INSTALLDIR. Change into the BASEDIR/maloc-0.1 and type

% ./configure --prefix=INSTALLDIR --disable-blas
% make
% make install

These lines compile and install the MALOC 0.1-2 libraries in INSTALLDIR. Now change back into BASEDIR. Run the following command

% patch -b -p0 < TAPBSDIR/src/apbs-0.4.0_patch

This adds a couple of code lines into the APBS source code which are essential for TAPBS. Now change into BASEDIR/apbs-0.4.0

% export CFLAGS="-O3 -DVAPBSQUIET"
% export FFLAGS="-O3"
% ./configure --prefix=INSTALLDIR --with-blas="-LBLASLIB -llapack -lcblas -lf77blas -latlas" --with-blas-name="atlas"
% make
% make install

The first line extends the environment variable CFLAGS with the option "-DVAPBSQUIET" making APBS less verbose. It assumes you are using the BASH shell. The equivalent C shell command would be

% set CFLAGS = ($CFLAGS '-DVAPBSQUIET')

If the configure script did not crash and you properly installed the ATLAS libraries you should now have the directories INSTDIR/bin, INSTDIR/lib and INSTDIR/include. Next, copy the following files

% cp bin/routines.h INSTDIR/include/apbs
% cp src/aaa_inc/apbscfg.h INSTDIR/include/apbs
% cp src/generic/apbs/vclist.h INSTDIR/include/apbs

Now that's it.

2.2. Compilation and installation of TAPBS

Change into the directory TAPBSDIR. Run

% ./configure --with-apbs=INSTDIR --with-blas='-LBLASLIB/lib -llapack -lcblas -lf77blas -latlas'
% make CXXFLAGS='-O3'

After successfull compilation you should find an executable file called 'tapbs'.

3. Running

To invoke TAPBS you simply type

% tapbs < input.in > output.out

For a successful run you will at least need a PQR file, a SITES file and a set of ST files.

4. Syntax of input to stdin

4.1. General syntax

Empty lines and lines starting with # are ignored.

Normal lines start with a keyword (or whitespace - leading whitespace is ignored, so you can indent as you like it). A keyword may be followed by one or more arguments. Arguments are seperated by whitespace. Escaping is not possible, so do not use spaces within your arguments. Parsing always stops at EOF. Order of lines does not have any significance, with one important exception: Most keywords should only appear once in the input. If such a keyword is used more than once, only the first appearance is recognized, all others are ignored.

In Section 4.2, “List of keywords”, all keywords are listed together with explanation of all possible arguments. The order of arguments is significant. Optional arguments are, as the name suggests, optional, but if there are more than one optional arguments, you can only skip them beginning from the end of the arguments list, e.g. if there are three optional arguments, and you want to skip the second one, you must also skip the third one. Default values for skipped arguments are given in the description.

The possible formats of the arguments are the following:

Table 1. Formats of arguments

formatdescription
stringstring of arbitrary characters with the exception of # and whitespace
integeran integer number
floata floating point number, exponential numbers in C-like format
energy unita special string, see next section

4.2. List of keywords

  • pqr

    usable more than onceno
    requiredyes
    behavior if missingnot possible

    Filename of the structure definition in PQR format. PQR is derived from PDB where occupancies are replaced by atomic partial charges and B-factors by atomic radii.

    Arguments:

    descriptionformatoptionaldefault value
    PQR filenamestringnon/a
  • sites

    usable more than onceno
    requiredyes
    behavior if missingnot possible

    Filename of list of titratable residues in structure.

    Arguments:

    descriptionformatoptionaldefault value
    sites filenamestringnon/a
  • output

    usable more than onceno
    requiredyes
    behavior if missingnot possible

    During run TAPBS generates several files: For each titratable residue a file that contains the electrostatic potentials of all states (STEM.name-NR.potat), a PQR file defining the vdW-volume of the structure (STEM.volume.pqr), a PQR file with all titratable groups in the reference charge state (STEM.reference.pqr), the intrinsic pKa-file (STEM.pkint) and the W interaction matrix (STEM.g). The argument of this parameter is the file name stem.

    Arguments:

    descriptionformatoptionaldefault value
    filename STEMstringnon/a
  • bcfl

    usable more than onceno
    requiredno
    behavior if missingbcfl sdh

    Specify the boundary condition for calculations using the coarsest grid. The boundary grid points can either be initialized with 0.0 ("zero") or using an analytic expression of the electrostatic potential in the Debye-Hückel limit ("sdh") where the protein is treated as a single charged sphere. Alternatively, one can treat the protein as polyion consisting of individual charged spheres that contribute linearly to the electrostatic potential at the boundary ("mdh"). The latter boundary model is computationally much more demanding.

    Arguments:

    descriptionformatoptionaldefault value
    boundary condition model"zero", "sdh" or "mdh"non/a
  • pdie

    usable more than onceno
    requiredyes
    behavior if missingnot possible

    Dielectric constant of the protein volume. A reasonable range of values is between 2.0 and 20.0 depending on the system. We recommend 4.0 if conformational flexibility is not included explicitly.

    Arguments:

    descriptionformatoptionaldefault value
    protein dielectric constantfloatnon/a
  • sdie

    usable more than onceno
    requiredyes
    behavior if missingnot possible

    Dielectric constant of the continuum solvent. A reasonable value for water is 80.0.

    Arguments:

    descriptionformatoptionaldefault value
    solvent dielectric constantfloatnon/a
  • temperature

    usable more than onceno
    requiredno
    behavior if missingtemperature 300.0

    The temperature in Kelvin. Necessary only for unit conversions from pK to kJ/mol and vice-versa.

    Arguments:

    descriptionformatoptionaldefault value
    temperaturefloatnon/a
  • ion

    usable more than onceyes
    requiredyes
    behavior if missingnot possible

    Specification of dissolved ion species defining the total ionic strength. For each ion species one has to provide its charge, concentration (M) and radius (Angstroms). The largest ion radius will be used to define the thickness of the Stern-layer, i.e. the region around the protein volume that is ion-inaccessible. The total net charge of all ion species must sum up to zero.

    Arguments:

    descriptionformatoptionaldefault value
    ion chargefloatnon/a
    ion concentration in Mfloatnon/a
    ion radius in Angstromsfloatnon/a
  • srfm

    usable more than onceno
    requiredno
    behavior if missingsrfm mol

    Specifiy the method of mapping the dielectric function onto the grid. This is done based on the molecular surface ("mol"). The solute-solvent interface can then be "smoothed" by 9-point harmonic averaging ("smol") to decrease sensitivity to the grid setup.

    Arguments:

    descriptionformatoptionaldefault value
    Mapping of dielectric coefficient function"mol" or "smol"non/a
  • srad

    usable more than onceno
    requiredyes
    behavior if missingnot possible

    Solvent probe radius in Angstroms is necessary to define the solvent-accessible surface area (SASA). For water a value of 1.4 Angstroms is reasonable.

    Arguments:

    descriptionformatoptionaldefault value
    solvent probe radiusfloatnon/a
  • sdens

    usable more than onceno
    requiredno
    behavior if missingsdens 3.0

    Specifies the SASA point density, i.e. the resolution of the SASA. The molecular surface used to define the protein volume is calculated by roling a sphere with the solvent probe radius over the SASA represented by a set of points on which the probe spheres are centered. The smaller the probe radius the higher the resolution should be. A reasonable value is 3.0 pts/Angstrom^2 for a probe radius of 1.4 Angstroms (water). However, the APBS default is set 10.0 pts/Angstrom^2. This affects strongly the calculation time!

    Arguments:

    descriptionformatoptionaldefault value
    Surface density of SASA points in pts/Angstrom^2floatnon/a
  • chgm

    usable more than onceno
    requiredno
    behavior if missingchgm spl0

    Specify charge discretization method. Atomic partial charges will be mapped onto local grid points. This can be done by trilinear interpolation ("spl0") which smears point charges over the nearest grid points or, alternatively, by cubic B-spline interpolation ("spl2") that smears charges over nearest and next-nearest grid points. Results of cubic B-spline interpolation are less sensitive to grid spacing, length and position.

    Arguments:

    descriptionformatoptionaldefault value
    charge mapping method"spl0" or "spl2"non/a
  • dimension_of_protein_grid

    usable more than onceyes
    requiredyes
    behavior if missingnot possible

    TAPBS calculates the electrostatic potential for each state of all titratable residues buried in the protein volume (protein calculations) and solvated in a model compound (model calculations). This involves the solution of the PBE discritized on grid. The parameter defines the dimension of this grid used in protein calculations in terms of the number of grid points.

    To reduce the grid size necessary to include the whole protein volume TAPBS supports the grid focusing procedure which breaks a single high resolution calculation into several focusing calculations with gradually increasing grid resolutions. Typically, one starts with a calulation on a large but coarse grid centered on the geometrical center of the protein structure and with its boundary grid points initialized by application of a reasonable boundary condition. The calculation is repeated on a second grid that is centered on a region of interest inside the protein and fully contained by the larger grid. This time, the grid is initialized by the focusing boundary condition, i.e. the boundary grid points of the smaller grid take the values of the corresponding grid points of the coarser grid.

    Each focusing calculation has to be specified by a dimension_of_protein_grid line together with the corresponding grid spacing and grid centering specifications. The following example

    dimension_of_protein_grid 65 65 65
    spacing_of_protein_grid 3.0 3.0 3.0
    center_of_protein_grid oncent
    
    dimension_of_protein_grid 129 97 97
    spacing_of_protein_grid 1.0 1.0 1.0
    center_of_protein_grid oncent
    
    dimension_of_protein_grid 97 97 97
    spacing_of_protein_grid 0.25 0.25 0.25
    center_of_protein_grid onsite
    

    defines a three-step grid focusing procedure. TAPBS will first perform a coarse grained calculation on a 3x64=192 Angstroms sized grid that is centered on the protein volume and uses the resulting electrostatic potential as boundary conditions for a calculation on a second and third fine grained grid with the last only being 24 Angstroms in size on the edges but centered on the titratable residue. As you can see the number of grid points can vary for each direction as well as in each focusing calculation.

    Arguments:

    descriptionformatoptionaldefault value
    grid points in x-directionintegernon/a
    grid points in y-directionintegernon/a
    grid porints in z-directionintegernon/a

    The number of grid points n used must obey the formula n=c2^(l+1)+1 where c is an integer factor and l the so-called grid level (integer). Typical values are 33, 65, 97, 129 and 161. This constraint is related to the numerical multi-grid algorithm implemented in APBS.

  • dimension_of_model_grid

    Defines the grid dimension used in model calculations. If omitted TAPBS will use the same grid dimensions as defined for the protein calculations. The parameter follows the same syntax as . Usually, a smaller number of grid points is desirable for model calculations as the model structure is much smaller than the protein volume. A typical value is 65 in all spatial directions.

  • spacing_of_protein_grid

    usable more than onceyes
    requiredyes
    behavior if missingnot possible

    Specfies the spacing between the grid points in Angstroms, i.e. the grid resolution in protein calculations. Typical values range between 3.0 and 0.25 Angstroms. This statement can be used more than once but must balance with the number of dimension_of_protein_grid lines. The order is relevant, i.e. the first spacing_of_protein_grid line will correspond to the first dimension_of_protein_grid statement.

    Arguments:

    descriptionformatoptionaldefault value
    spacing in x-directionfloatnon/a
    spacing in y-directionfloatnon/a
    spacing in z-directionfloatnon/a
  • spacing_of_model_grid

    Specifies the spacing between the grid points in model calculations. It follows the same rules as . Make sure that the resolution in the last focusing step is the same in both protein and model calculations. Otherwise the grid artefact will not cancel in the Born energy terms.

  • center_of_protein_grid

    usable more than onceyes
    requiredyes
    behavior if missingnot possible

    Specification of the centering method in protein calculations: Center the grid on the protein geometry ("oncent") or on the geometric center of the titratable residue ("onsite"). This statement can be used more than once but must balance with the number of dimension_of_protein_grid lines. The order is relevant, i.e. the first center_of_protein_grid line will correspond to the first dimension_of_protein_grid statement.

    Arguments:

    descriptionformatoptionaldefault value
    centering method"oncent" or "onsite"non/a
  • center_of_model_grid

    Specification of the centering method in model calculations. It follows the same rules as . Make sure that the centering method in the last focusing step is the same in both protein and model calculations. Otherwise the grid artefact will not cancel in the Born energy term.

  • errtol

    usable more than onceno
    requiredno
    behavior if missingerrtol 1E-6

    The multi-grid approach is an iterative algorithm for solving the descritized PBE. The algorithm stops if convergence is reached. The convergence is defined in terms of the relative residual. If the relative residual is below the value specified the algorithm will stop refining the solution. TAPBS uses the APBS default of 1E-6. A faster and still accurate limit is 1E-3.

    Arguments:

    descriptionformatoptionaldefault value
    Error tolerance in terms of relative residualfloatnon/a
  • itmax

    usable more than onceno
    requiredno
    behavior if missingitmax 200

    Specifies the maximum number of multi-grid iterations. Affects convergence time independently from errtol. We found that a value of 4 represents a reasonable trade-off between calculation times and accuracy.

    Arguments:

    descriptionformatoptionaldefault value
    maximum number of multi-grid iterationsintegernon/a
  • diel_atomno

    usable more than onceyes
    requiredno
    behavior if missingnothing

    TAPBS supports the assignment of multiple dielectric constants within the protein volume. This done by defining the protein volume first on the basis of the molecular surface using a single dielectric constant specified by pdie and then map additional dielectric constants onto the grid within the vdW-radii of the atoms specified in the diel_atomno, diel_resid or diel_segres lines.

    Arguments:

    descriptionformatoptionaldefault value
    atom numberintegernon/a
    dielectric constantfloatnon/a
  • diel_resid

    usable more than onceyes
    requiredno
    behavior if missingnothing

    See diel_atomno.

    descriptionformatoptionaldefault value
    segment namestringnon/a
    residue numberintegernon/a
    dielectric constantfloatnon/a
  • diel_segres

    usable more than onceyes
    requiredno
    behavior if missingnothing

    See diel_atomno.

    descriptionformatoptionaldefault value
    segment namestringnon/a
    residue numberintegernon/a
    dielectric constantfloatnon/a
  • dummy

    usable more than onceno
    requiredno
    behavior if missingfull calculation of electrostatic potentials

    If the dummy flag is found in the input TAPBS will only simulate a full titration calculation, i.e. the PBE is not actually solved but the solution array set to zero. However, structure manipulations, calculations of the molecular surface, the intrinsic pKs and W matrix entries will be performed. This is good for testing to check whether the computation is set up correctly.

    No further arguments are required for this keyword.

  • membrane

    usable more than onceno
    requiredno
    behavior if missingnothing

    TAPBS supports the assignment of an implicit membrane characterized by a volume slab on the grid around the protein assigned a different dielectric constant. The keyword is supplied two vectors: The first represents the support vector describing the translation of the membrane plane from the origin, the second the orientation and thickness of the volume slab. The protein coordinates and both vectors will be rotated so that the plane normal vector of the membrane will coalign with the z-axis. The volume slab between the resulting zmin and zmax value will be assigned the dielectric constant given as the last parameter. Note, that the membrane slab makes computations slightly slower and might need a higher resolution. Use the keyword writemap to write out and check (using a tool like VMD for visualization) the dielectric constant maps used.

    descriptionformatoptionaldefault value
    x-component of support vectorfloatnon/a
    y-component of support vectorfloatnon/a
    z-component of support vectorfloatnon/a
    x-component of membrane vectorfloatnon/a
    y-component of membrane vectorfloatnon/a
    z-component of membrane vectorfloatnon/a
    dielectric constant of volume slabfloatnon/a
  • writemap

    usable more than onceno
    requiredno
    behavior if missingnothing

    The writemap flag tells TAPBS to write dielectric and ion accessiblity maps into files. The format used is DX which VMD is able to visualize. As these maps consume quite a lot of disk space, be sure you limit the number of titratable residues in the SITES file. The keyword is used for debugging.

    No further arguments are required for this keyword.

5. File formats

5.1. PQR file format

TAPBS parses PQR files strictly according to the PDB file format specification. However, all lines that do not begin with "ATOM" are ignored. The occupancy section is used for atomic partial charges, while B-factor section is used for atomic radii. Make sure that each line contains at least 75 characters even when the segment name section is left empty. Do not use tab characters for formatting. Here is an example PQR line that should parse correctly:

ATOM    545 CD   GLU L  35       5.145  15.745  26.036  0.62  2.00      LYSZ  

5.2. SITES files (*.sites)

Sites files are simple text file in which each line defines a titratable residue by giving 1) the segment name, 2) residue number, 3) the residue name and finally the file name of a designated residue state description file (see below). It follows an example file that should parse correctly:

A 8 ASP ASP.st

Alternatively, if the protein structure does contain only a single segment (e.g. in case of a small single chain protein without cofactors), one can skip the leading segment name.

5.3. Residue state description files (*.ST)

The residue state description files simply list the possible states that a titratable residue can adopt. In TAPBS a state can be either a charge set or a conformation, the latter involving a change in the coordaintes or radii. Each state is described by a single line providing the so-called model energy shift (measured or calculated ab-initio in solution) and a transition state identifier. It is followed by a list of charges and/or coordinates in PQR format. For convenience, several different energy units are supported (until now only 'pK'). The transition type identifiers are the same as defined by Karlsberg 2.0 (see its user guide): 'P', 'D', '+', '-' and all possible combinations as well as '0' for conformational transitions or 'R' for the reference state. One of the states in the ST-File must be the reference state. Energy shifts are always relative to the reference. Here is an example file describing the deprotonation of glutamate:

0.00 pK R
ATOM      1 CG   GLU     1    9999.9999999.9999999.999-0.21099.999      GLU   
ATOM      2 CD   GLU     1    9999.9999999.9999999.999 0.75099.999      GLU   
ATOM      3 OE1  GLU     1    9999.9999999.9999999.999-0.36099.999      GLU   
ATOM      4 OE2  GLU     1    9999.9999999.9999999.999-0.36099.999      GLU   
4.40 pK D
ATOM      1 CG   GLU     1    9999.9999999.9999999.999-0.28099.999      GLU   
ATOM      2 CD   GLU     1    9999.9999999.9999999.999 0.62099.999      GLU   
ATOM      3 OE1  GLU     1    9999.9999999.9999999.999-0.76099.999      GLU   
ATOM      4 OE2  GLU     1    9999.9999999.9999999.999-0.76099.999      GLU     

"ATOM", atom numbers, residue names, residue numbers and segment names are ignored. The atom names, however, must coincide with those found in this residue. For transitions that leave coordinates untouched the string '9999.999' found in the coordinate columns will be replaced by values found in the PQR file. For invariant charges or radii the string '99.999' will be replaced by values found in the PQR file.

It follows an example ST-file that describes the three-fold state transition of Histidine:

0.00 pK R
ATOM   4935  CB  HSP A 102    9999.9999999.9999999.999-0.09099.999      A    C
ATOM   4938  CD2 HSP A 102    9999.9999999.9999999.999 0.22099.999      A    C
ATOM   4939  HD2 HSP A 102    9999.9999999.9999999.999 0.10099.999      A    H
ATOM   4940  CG  HSP A 102    9999.9999999.9999999.999-0.05099.999      A    C
ATOM   4941  NE2 HSP A 102    9999.9999999.9999999.999-0.70099.999      A    N
ATOM   4942  HE2 HSP A 102    9999.9999999.9999999.999 0.00099.999      A    H
ATOM   4943  ND1 HSP A 102    9999.9999999.9999999.999-0.36099.999      A    N
ATOM   4944  HD1 HSP A 102    9999.9999999.9999999.999 0.32099.999      A    H
ATOM   4945  CE1 HSP A 102    9999.9999999.9999999.999 0.25099.999      A    C
ATOM   4946  HE1 HSP A 102    9999.9999999.9999999.999 0.13099.999      A    H
-7.00 pK P
ATOM   4935  CB  HSP A 102    9999.9999999.9999999.999-0.05099.999      A    C
ATOM   4938  CD2 HSP A 102    9999.9999999.9999999.999 0.19099.999      A    C
ATOM   4939  HD2 HSP A 102    9999.9999999.9999999.999 0.13099.999      A    H
ATOM   4940  CG  HSP A 102    9999.9999999.9999999.999 0.19099.999      A    C
ATOM   4941  NE2 HSP A 102    9999.9999999.9999999.999-0.51099.999      A    N
ATOM   4942  HE2 HSP A 102    9999.9999999.9999999.999 0.44099.999      A    H
ATOM   4943  ND1 HSP A 102    9999.9999999.9999999.999-0.51099.999      A    N
ATOM   4944  HD1 HSP A 102    9999.9999999.9999999.999 0.44099.999      A    H
ATOM   4945  CE1 HSP A 102    9999.9999999.9999999.999 0.32099.999      A    C
ATOM   4946  HE1 HSP A 102    9999.9999999.9999999.999 0.18099.999      A    H
-0.40 pK 0
ATOM   4935  CB  HSP A 102    9999.9999999.9999999.999-0.08099.999      A    C
ATOM   4938  CD2 HSP A 102    9999.9999999.9999999.999-0.05099.999      A    C
ATOM   4939  HD2 HSP A 102    9999.9999999.9999999.999 0.09099.999      A    H
ATOM   4940  CG  HSP A 102    9999.9999999.9999999.999 0.22099.999      A    C
ATOM   4941  NE2 HSP A 102    9999.9999999.9999999.999-0.36099.999      A    N
ATOM   4942  HE2 HSP A 102    9999.9999999.9999999.999 0.32099.999      A    H
ATOM   4943  ND1 HSP A 102    9999.9999999.9999999.999-0.70099.999      A    N
ATOM   4944  HD1 HSP A 102    9999.9999999.9999999.999 0.00099.999      A    H
ATOM   4945  CE1 HSP A 102    9999.9999999.9999999.999 0.25099.999      A    C
ATOM   4946  HE1 HSP A 102    9999.9999999.9999999.999 0.13099.999      A    H

5.4. Potential binary file format

The calculated electrostatic potentials are evaluated on all atom positions and stored into a binary file that contains the potentials for all states of a titratable residue from protein and model calculations. The file structure is as follows:

field descriptiontype
Number of statesint
Number of atomsint
x position (Angstroms)double
y position (Angstroms)double
z position (Angstroms)double
potential value (kT/ec)double
... 
Number of statesint
Number of atomsint
x position (Angstroms)double
y position (Angstroms)double
z position (Angstroms)double
potential value (kT/ec)double
... 

5.5. Intrinsic pK values (*.pkint)

For a description of this file format please consult the documentation of Karlsberg2.

5.6. W interaction matrix (*.g)

For a description of this file format please consult the documentation of Karlsberg2.

6. Copyright

TAPBS 0.1 Copyright 2007 Gernot Kieseritzky,

TAPBS 0.1 was written in the macromolecular modelling group of E. W. Knapp at the Freie Universität Berlin. Please acknowledge your use of TAPBS 0.1 by citing

[G. Kieseritzky & E. W. Knapp (2007)] Optimizing pKa computations in proteins with pH adapted conformations (PACs). Proteins. in press.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.