lhapdf

changeset 1110:2ba52dbf2312 lhapdfv6

Add release instructions for new sets
author Andy Buckley <andy@insectnation.org>
date Tue, 17 Oct 2017 17:12:04 +0100
parents 447df3a394ed
children 39805fd9ca0a
files DATARELEASE
diffstat 1 files changed, 54 insertions(+), 0 deletions(-) [+]
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/DATARELEASE	Tue Oct 17 17:12:04 2017 +0100
     1.3 @@ -0,0 +1,54 @@
     1.4 +LHAPDF6 PDF set release procedure
     1.5 +=================================
     1.6 +
     1.7 +Releasing a new PDF set is primarily to be done via the CVMFS distributed
     1.8 +filesystem: this is now the canonical data archive, with copies on AFS and
     1.9 +HepForge being secondary (and subject to future removal).
    1.10 +
    1.11 +PRELIMINARY: You will need an up-to-date copy of LHAPDF, e.g. version 6.2.1 or
    1.12 +the hg head. It's best to build this on lxplus7, which has a system C++ compiler
    1.13 +that supports the C++11 standard, and has CVMFS mounted at /cvmfs. You will need
    1.14 +to set the environment so it picks up the libLHAPDF library from LD_LIBRARY_PATH
    1.15 +and the Python module from PYTHONPATH.
    1.16 +
    1.17 +1. In the expanded-tarball/hg-checkout directory, make a testing directory
    1.18 +e.g. TESTPDFS, and download the PDF set tarballs supplied by the fitting group
    1.19 +into it. Each tarball must have filename format my_set_name.tar.gz -- no .tgz
    1.20 +file extensions, please!
    1.21 +
    1.22 +2. Check that each tarball expands to a directory with the same name as the
    1.23 +tarball without the .tar.gz suffix, containing similarly named files: a
    1.24 +mandatory my_set_name.info, and N x my_set_name_0000.dat, my_set_name_0001.dat,
    1.25 +etc.
    1.26 +
    1.27 +3. Test each set's .info file for format correctness:
    1.28 +  ./testinfo TESTPDFS/*/*.info
    1.29 +If everything is ok, it will be silent.
    1.30 +
    1.31 +4. Test each set for basic operation:
    1.32 +  export LHAPDF_DATA_PATH=$PWD/TESTPDFS::
    1.33 +  for i in `find TESTPDFS -mindepth 1 -type d -exec basename {} \;`; do ./testpdfs $i; done
    1.34 +
    1.35 +5. Ok, everything seems to be basically working. So we move the new set tarballs
    1.36 +and expanded dirs into the CVMFS downloads area, via the AFS one:
    1.37 +  mv TESTPDFS/* /afs/cern.ch/sw/lcg/external/lhapdfsets/current/
    1.38 +
    1.39 +6. Backup and regenerate the pdfsets.index file and the Doxygen version which
    1.40 +will become the table on the website:
    1.41 +  export LHAPDF_DATA_PATH=/afs/cern.ch/sw/lcg/external/lhapdfsets/current/::
    1.42 +  cp pdfsets.index{,.bak}
    1.43 +  ./mkindex > pdfsets.index
    1.44 +  diff pdfsets.index{.bak,}
    1.45 +  -> sanity-check the diff to see that the expected sets have been added, and have distinct IDs
    1.46 +  cd doc
    1.47 +  cp pdfsets.dox{,.bak}
    1.48 +  ./mkpdflist > pdfsets.dox
    1.49 +  diff pdfsets.dox{.bak,}
    1.50 +  -> minimal sanity check the diff
    1.51 +
    1.52 +7. Copy the new index file on to AFS/CVMFS:
    1.53 +  cp pdfsets.index /afs/cern.ch/sw/lcg/external/lhapdfsets/current/
    1.54 +  And sync to CVMFS...
    1.55 +
    1.56 +8. Send new pdfsets.index and pdfsets.dox files to AB, who'll commit them to hg,
    1.57 +and update the website & HepForge downloads area.