Download and run RADDOSE-3D - recommended:

  • Click here for the latest RADDOSE-3D release
  • Download the latest jar file
  • Create a plain-text input file in the same directory as your downloaded jar file. See here for tips on writing the file.
  • To run, navigate to this directory in the command prompt and use the command:

    java -jar raddose3d.jar -i MyInput.txt

  • Help on how to run and create an input file can be found here

Additional ways to run RADDOSE-3D:

A simpler way to run RADDOSE-3D for new users, and for the automatic generation of 3D dose maps, is via the manual interface. Note that functions requiting file uploads cannot be used with the manual interface. Note: A more user-friendly interface has previously been available, however this option is currently undergoing maintenance and is not available at this time!

Keep up to date with our newest source code:

RADDOSE-3D is continously in development and the Garman Group is still adding new features to our code. Our most up to date code base is openly available on GitHub. Feel free to download our newest code, run it, or even modify it.

Current developments are ongoing by our team in the following areas:
  • Inclusion of a full 3D model for photoelectron and fluorescent X-ray escape from the crystal
  • The implementation of circular and elliptical beam collimations
  • Adaption of RADDOSE-3D to small molecule experiments

If you have any queries regarding these functionalities, please contact us and we can provide a working jar version of our developmental code!

User guide and help:

  • A user guide is available to download here
  • Additional help is provided in our GitHub README
  • Example input files for SAXS experiments and for experimentally-measured beams can be found here



We have a new release of the RADDOSE-3D that can now calculate fluorescent escape and simualte photoelectrons produced in the crystal and surrounding material. Source code available on GitHub.


We have a new release of the RADDOSE-3D source code available on GitHub.


We have a new publication on our recent developments in RADDOSE-3D.


RADDOSE-3D now simulates SAXS experiments. The release is now available on Github.


We have added some tips for running RADDOSE-3D, which should help for cases when the default values will give misleading/null results.


RADDOSE-3D version 1.2.467 fixes an issue that caused the program to crash if heavy atoms in the solvent were not specified.


We have now released the RADDOSE-3D version 1.2.427 source code at GitHub. This version also includes an updated user guide.


Several improvments to functionality have been incorporated into RADDOSE-3D version 1.2.415. The absorption coefficient calculation is more accurate, particularly for structures containing nucleic acids.


Together with our paper Predicting the X-ray lifetime of protein crystals we released RADDOSE-3D version 1.1.1000, the first version to support Diffraction Weighted Dose (DWD).


RADDOSE-3D version 1.0.994 fixes an issue that caused a single misplaced minus sign in large CSV outputs.


We have just released RADDOSE-3D version 1.0.989. This version uses a more accurate algorithm to identify the TAD-95 dose quantile, especially in very low or high dose regimes.