Durham University

The Durham HepData Project


Submitting Data to the Reaction Database

The compilers of the Reaction Database regularly scan the archives and literature to locate suitable new data sets for inclusion in the database, often contacting the experiments directly to obtain the exact numerical data.

If you have, or know of, data which you think should be in the database, then please email us at hepdata(at)projects.hepforge.org.

The criteria for data to be included is that it be data of a publishable form and not preliminary data. Data from conferences often fall into the latter category. If it is possible that data will change following peer review, it may be better to delay HepData submission until after journal acceptance.

The format we accept data in is very wide and generally we require only a flat file containing the numerical values. Postscript and pdf figures are not suitable.

Ideally the format should be:

xlow xhigh y +stat -stat +sys1 -sys1 +sys2 -sys2 ...

xlow and xhigh are the xbin edges
y is the measured quantity
+stat and -stat are the positive and negative statistical errors (could also be +-stat if equal)
+sysn and -sysn are any number of positive and negative systematic errors (again could be +-sysn if equal)

You can also include other things like xfocus (mean of the distribution within the bin); just specify the column definitions when submitting the data.

Any text files you send us will be processed into a standard format, which can be seen from the "input" link on any of the existing records. Data submissions provided in text formats closer to the "input" format can therefore be entered more quickly into the database. You can start by looking at the "input" file for an existing record that is similar to your submitted data. An annotated sample input file is available, as is the historical 1970s encoding manual (14 MB) defining some nomenclature that is still used in practice. It is useful to provide key metadata for each table such as a caption, the process being considered (initial-state and final-state particles), important kinematic cuts, and headers for the x and y columns specifying the quantity with units. Multiple x and y values can be given in the same row separated by semicolons and non-existent entries can be indicated by dashes "-". Numerical values should be given with an appropriate and not excessive number of significant figures (in general, a maximum of 4), avoiding giving more decimal places for the errors than the central values. An online form is available to test data input. Click on "Browse..." to select your input file, followed by "Upload" and "Process", then click "Display" for the first 10 tables, or "All" for the whole record. Please note that this online form is only for testing purposes, and the final submittal to HepData must still be done by email.

STFCIPPP HepData is funded by the UK STFC and hosted at the Durham IPPP.
HepData also maintains the UK mirror of the PDG.