----------------------------------------------------------------------
2018/06/14 K.Fujii  v02-00-01
----------------------------------------------------------------------
URL: https://github.com/iLCSoft?page=1

1) Install the required packages:
$ sudo apt-get update
$ sudo apt-get install mysql-devel imake gsl-devel gsl-static clhep geant4 root cernlib xerces-c cmake gcc libtool m4 autoconf automake poppler-devel libgcrypt-devel libptexenc-devel fastjet fjcontrib ocaml whizard boost-devel

2) Get the "ilcinstall" and its MacOSX patch
$ sudo mkdir -p /proj/soft/ilcsoft/src/v02-00-01
$ sudo chown -R <your username> /proj/soft/ilcsoft
$ cd /proj/soft/ilcsoft/src/v02-00-01
# get the source files from the github above.
# make them into tarballs for later convenience.
$ ls 
CondDBMySQL_ILC-0-9-6.tar.gz
HowToInstall.osx
LP_Asian_GEM_Module.tar.gz
ced-v01-09-02.tar.gz
dd4hep-v01-07.patch
ilcinstall-v02-00-01-macosx10.13.patch
ilcinstall-v02-00-01.tar.gz
ilcutil-v01-05-macosx10.13.patch
ilcutil-v01-05.tar.gz
pandrapfanew-v03-09-00.patch

marlintpc-rootfileproc.patch
marlintpc-v01-04-not0.patch

3) Install dependent libraries
3-1) ilcutil-v01-05
$ cd <source directory>
$ mkdir -p /proj/soft/ilcsoft/ilcutil
$ tar -zxvf ilcutil-v01-05.tar.gz -C /proj/soft/ilcsoft/ilcutil
$ pushd /proj/soft/ilcsoft/ilcutil/v01-05
$ patch -p1 -s < <source directory>/ilcutil-v01-05-macosx10.13.patch
$ mkdir build
$ cd build
$ cmake ..
$ make
$ make install
$ popd

3-2) ced-v01-09-02
$ mkdir -p /proj/soft/ilcsoft/CED
$ tar -zxvf ced-v01-09-02.tar.gz -C /proj/soft/ilcsoft/CED
$ pushd /proj/soft/ilcsoft/CED/v01-09-02
$ mkdir build
$ cd build
$ cmake -DILCUTIL_DIR=/proj/soft/ilcsoft/ilcutil/v01-05 ..
$ make
$ make install
$ popd

3-3) CondDBMySQL_ILC-0-9-6
$ mkdir -p /proj/soft/ilcsoft/CondDBMySQL
$ tar -zxvf CondDBMySQL_ILC-0-9-6.tar.gz -C /proj/soft/ilcsoft/CondDBMySQL
$ pushd /proj/soft/ilcsoft/CondDBMySQL/CondDBMySQL_ILC-0-9-6
$ mkdir build
$ cd build
$ cmake -DILCUTIL_DIR=/proj/soft/ilcsoft/ilcutil/v01-05 ..
$ make
$ make install
$ popd

4) Build and install the ilcsoft
$ cd /proj/soft/ilcsoft
$ tar -zxvf /proj/soft/ilcsoft/src/v02-00-01/ilcinstall-v02-00-01.tar.gz
$ cd ilcinstall
$ patch -p1 -s -b < ../src/v02-00-01/ilcinstall-v02-00-01-macosx10.13.patch
$ ./ilcsoft-install -i releases/v02-00/release-osx.cfg
.......

... before compilation starts, apply the following patches in a new window:
... Open a new terminal and do the following

$ pushd /proj/soft/ilcsoft/v02-00-01/DD4hep/v01-07
$ patch -p1 -s < <source directory>/dd4hep-v01-07.patch
$ popd
$ pushd ../v02-00-01/PandoraPFANew/v03-09-00
$ patch -p1 -s < <source directory>/pandrapfanew-v03-09-00.patch
$ popd
$ pushd ../v02-00-01/bbq/v00-01-03
$ patch -p1 -s < <source directory>/bbq-v00-01-03.patch
$ popd
$ pushd ../v02-00-01/MarlinTPC/v01-04
$ patch -p1 -s < <source directory>/marlintpc-v01-04-not0.patch
$ patch -p3 -s < <source directory>/marlintpc-rootfileproc.patch
$ popd

# Note:
# DD4hep: DDCore/src/NamedObject.cpp # commented out instantiation of dd4hep::Handle<NamedObject>
#       : cmake/DD4hepBuild.cmake    # replace -no-undefined by undefined,error
# PandrawPFANew: PandoraSDK-v03-02-01/src/Xml/tinyxmlparser.cc # [[fallthrough]];
# bbq: v00-01-03/src/TBBQManager.cxx # avoid comparison of pointer with logical

--------------------------------------------------------------
To rebuid a package after modifiying the source code:
$ cd <package dir>
$ touch .install_failed.tmp
--------------------------------------------------------------


5) Test run
# I had to add all the relevant lib directories to DYLD_LIBRARY_PATH
# in init_ilcsoft.sh


6) KalTest in Xcode
6-1) Build root with clang++
$ sudo alternatives --config gcc
  .. to select clang
$ cd <KalTest test directory>
$ mkdir root
$ cd root
$ tar -zxvf <source file directory>/root_v6.13.02.source.tar.gz
$ cd mv root-6.13.02 6.13.02
$ cd 6.13.02
$ mkdir build_root
$ cd build_root
$ cmake -DCMAKE_INSTALL_PREFIX=`pwd`/.. ..
$ make -j8
$ make install

6-2) Then build ilcutil with that root
$ cd <KalTest test directory>
$ mkdir ilcutil
$ cd ilcutil
$ tar -zxvf <source file directory>/ilcutil-v01-05.tar.gz
$ cd v01-05
$ mkdir build
$ cd build
$ source ../../root/6.13.02/bin/thisroot.sh
$ cmake ..
$ make
$ make install

6-3) Prepare Xcode project for KalTest
$ cd <KalTest test directory>
$ mkdir kaltest
$ tar -zxvf <source file directory>/kaltest-v02-03.tar.gz
$ cd v02-03
$ mkdir build
$ source ../../root/6.13.02/bin/thisroot.sh
$ cmake -G Xcode -DILCUTIL_DIR=<ilcutil source directory> ..

6-4) Build and run KalTest with Xcode
# v02-04 does not work (no display)
# reverted to v02-03



-----------<Obsolete>-----------------------------------------
To get the head version do the following, instead:
$ svn co https://svnsrv.desy.de/public/marlintpc/trunk


5) Then build and install MarlinTPC
If you have libjpeg-devel and libtiff-devel installed,
uninstall them since they conflict with the system 
provided libraries:

$ rpm -e libjpeg-devel libtiff-devel

Then build MarlinTPC:

$ cd /proj/cdc/soft/MarlinTPC
$ tar -zxvf src/r3390.tar.gz
$ cd r3390
$ tar -zxvf ../src/analysis.tar.gz
$ mkdir build
$ cd build
$ cmake -C /proj/soft/ilcsoft/v01-17-04/ILCSoft.cmake ..
$ make install
$ cd ..
$ tar -zxvf ../src/LP_Asian_GEM_Module.tar.gz -C examples


7) You can also try CEDViewer
In order to use CEDViewer, you need to start a CED server, glced, first.
$ source /proj/soft/ilcsoft/v01-17-04/init_ilcsoft.sh
$ glced -world_size=100.

Then open a new termnal window and type
$ cd /proj/cdc/soft/MarlinTPC/r3390/examples/LP_Asian_GEM_Module
$ Marlin reconstructLCTPCRawData.xml

Hit "h" in the viewer window for "help".



In order to get trunk version of ilcsoft, first get the trunk version
of ilcinstall by typing

$ svn co https://svnsrv.desy.de/public/ilctools/ilcinstall/trunk