The scripts and input files that accompany this demo can be found in the demos/public directory of the Rosetta weekly releases.



Justin Ashworth, James Havranek, Phil Bradley, Carlos Duarte, David Baker

The document was last updated in 2016 XRW by Parisa Hosseinzadeh to enable automated demo testing.


This application provides support for biophysical modeling of protein-DNA interactions. It provides sampling and energetic estimates of structural and mutational degrees of freedom in the protein-DNA interface.


This application is provided to access full-atom, primarily fixed-backbone protocols in the protocols/dna directory through the RosettaScripts and Job Dsitributor schemes. This scheme is highly extensible: this application also provides access to any other class or procedure that is implemented under the RosettaScripts scheme. Currently, the primary difference between this application and the RosettaScripts application is that this one uses a custom JobOutputter class to prepend protein-DNA-specific information to output PDB files.


This application is not officially supported for anything that is not described in the referenced literature citations listed below.

How to run

Three modes are provided: automated basepair-specific design, resfile-directed design, and basepair specificity prediction. The codes to run in each mode is shown below. For more details of the scripts and input files, please check below.

($ROSETTA3= path-to-Rosetta/main/source)

Automated basepair-specific design:

$> $ROSETTA3/bin/rosettaDNA.default.linuxgccrelease @design.flags 
resfile-directed design:
$> $ROSETTA3/bin/rosettaDNA.default.linuxgccrelease @resfile.flags 

basepair specificity prediction:

$> $ROSETTA3/bin/rosettaDNA.default.linuxgccrelease @predspec.flags 

Input Files

Required A PDB structure of a protein-DNA interface, provided in the inputs directory. Note: many structures contain non-canonical amino acids and nucleotides. You will need to substitute these with normal types using a method of your choice. A RosettaScripts XML-like protocol file provided in the scripts directory. Examples are provided in the demos (integrations tests). Please see the RosettaScripts documentation for more details. Optional A resfile provided in the inputs directory. This is a file that explicitly specifies residue-level behaviors. It is only applied if the appropriate ResfileReader TaskOperation is employed in the RosettaScript. An example is provided (see paths in section Files).


Protocol-Specific Options Most protocol-specific behavior is specified through the RosettaScripts interface. Here are examples of the primary class options: This class automatically detects the relevant amino acids to move and mutate (those near DNA). base_only: should backbone contacts be considered?; z_cutoff: distance cutoff for contact to a certain basepair, measured along the DNA helical axis; dna_defs: which base pairs to consider (uses PDB chain id and numbering). sets the weights file for the internal score function. ** This class performs multi-state design of amino acids for improved descrimination between sequences. This functionality is not officially supported. pop_size: number of different protein sequences; num_packs: number of packing trials per sequence; numresults: number of results to return; boltz_temp: the Boltzmann temperature factor to use when effectively comparing energy fitnesses; anchor_offset: approximate number of energy units that can be traded in order to gain specificity; mutate_rate: rate of mutation for a single sequence; generations: number of times to "evolve" set of sequences. This class tries to introduce small local changes in backbone structure. gapspan and spread determine how much of the backbone is made flexible (spread refers to the number of backbone residues on either side of each DNA-contacting residue, and gapspan sets the number of amino acids between spreads that results in their concatenation). cycles_outer and cycles_inner set the number of times to samplee possible backbone conformations. temp_initial and temp_final affect the starting and ending acceptance rates of backbone changes that increase free energy (higher numbers: higher acceptance rates and thus more aggressive and potentially destabilizing changes). This class controls the fixed-backbone packing stage of the protocol. task_operations: this specifies all of the RosettaScripts-specified TaskOperations that specify the behavior of the packer (see the full script in the demos (integration tests) for examples of these). binding: this option sets whether binding energies are calculated (0: no, 1: yes). probe_specificity: sets whether the basepair specificity of the protein is calculated after the packer has finished altering the interface. Please see the demos and RosettaScripts documentation for more details.

General Options

The following general Rosetta command-line options are currently used in demos: -adducts dna_major_groove_water activates hydrated nucleotides -sparse_pdb_output only write PDB lines for residues that differ from input structure (to reduce disk space and memory sizes) -file:s [your.pdb] specifies input structure file -in:ignore_unrecognized_res this options toggles failure upon encountering an unkown residue in the input file -score:weights dna sets scorefunction weights for output structure (separate (but preferably the same as) scorefunction weights specified in the RosettaScripts file). -use_input_sc toggles inclusion of original sidechain orientations in conformational sampling. -run:output_hbond_info adds hydrogen bonding information to the output file -score:output_residue_energies adds residue energies to output file -jd2:dd_parser required option for RosettaScripts -parser:protocol design.script specifies protocol file for RosettaScripts -overwrite overwrites old output files when re-run -out:prefix design_ output file prefix


The demos are designed to run quickly. For higher quality results, additional rotamer sampling can be enabled using the -ex1 and -ex2 command line options. Also, see the scientific tests (the linke mentioned below) for more useful parameters.

Optimal performance depends upon a few minor modifications of the code and database files. For this reason, alternative database files are provided in /test/scientific/cluster/dna_interface_design/minirosetta_database_sparse/. The modifications are summarized below: increasing the rotamer probability cutoff in SingleResidueDunbrackLibrary::probability_to_accumulate_while_building_rotamers (-dunbrack_prob_buried and -dunbrack_prob_nonburied options) eliminating protein-DNA hydrogen bond strength attenuation on the basis of number of neighbors (use NO_ENV_HB_DEP_DNA option in weights files) reducing the hydrogen radii in minirosetta_database_sparse/chemical/atom_type_sets/fa_standard/atom_properties.txt to 0.1/0.7 (polar/nonpolar). Still requires manually/ changing/customizing database files.

Expected Outputs These protocols output files through the JobDistributor scheme. Normally, this results in a PDB file. Often, this PDB file will contain header information that describes the results of the analysis.

Code and Demo

Application source code: src/apps/public/RosettaDNA/ Primary protocol classes: src/protocols/dna/ Fast tests and demos: test/integration/tests/dna_interface_design/ Scientific tests: test/scientific/cluster/dna_interface_design/


Ashworth J, Taylor GK, Havranek JJ, Quadri SA, Stoddard BL, Baker D. Computational reprogramming of homing endonuclease specificity at multiple adjacent base pairs. Nucleic Acids Res. 2010 Sep;38(16):5601-8. PMID:20435674 Thyme SB, Jarjour J, Takeuchi R, Havranek JJ, Ashworth J, Scharenberg AM, Stoddard BL, Baker D. Exploitation of binding energy for catalysis and design. Nature. 2009 Oct 29;461(7268):1300-4. PMID:19865174 Ashworth J, Baker D. Assessment of the optimization of affinity and specificity at protein-DNA interfaces. Nucleic Acids Res. 2009 Jun;37(10):e73. PMID:19389725 Ashworth J, Havranek JJ, Duarte CM, Sussman D, Monnat RJ Jr, Stoddard BL, Baker D. Computational redesign of endonuclease DNA binding and cleavage specificity. Nature. 2006 Jun 1;441(7093):656-9. PMID:16738662