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 requiring 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.

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



A new major release v5.0 of RADDOSE-3D, including RADDOSE-ED to estimate doses for electron diffraction experiments, the ability to use intensity decay models to convert the "Diffraction Weighted Dose" output from a "Fluence Weighted Dose" to a "Diffraction-Decay Weighted Dose", and a new graphical user interface for Linux and Windows. All of these are described in a new publication. Release available on GitHub.


Minor fixes, including: For heavy atoms, where X-ray energies above the L3 edge but below the L1 edge, are now dealt with more accurately. This is necessary for metals in small molecule crystallography. Release available on GitHub.


Minor changes, including entry of material from surrounding material for SAXS, and bug fixes. Release available on GitHub.


A new major version v4.0 of RADDOSE-3D, including the ability to define a pink beam, RADDOSE-XFEL to estimate time-resolved absorbed pulses, and a new publication on the new RADDOSE-3D Monte Carlo subprogram, for simulating rotating crystals during synchrotron data collection. Release available on GitHub.


When defining an oil based surrounding, the user can now define the density and elemental composition instead of the concentration. Release available on GitHub.


We have a new release of the RADDOSE-3D that can now calculate fluorescent escape and simulate 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.