restructure cmake files into multiple files

.github/workflows/checks.yml

@@ -174,7 +174,7 @@ jobs:
         run: apt-get -y update
 
       - name: Install missing software
-        run: apt-get install -y git python3-pip && pip install black
+        run: apt-get install -y git python3-pip && pip install black==23.3.0
 
       - uses: actions/checkout@v2
 

cmake/AddBaseDependencies.cmake

@@ -0,0 +1,5 @@
+# add OpenMP and MPI
+find_package(OpenMP)
+find_package(MPI)
+# add nlohmann json
+find_package(nlohmann_json)

cmake/AddCorrectionlib.cmake

@@ -0,0 +1,42 @@
+function(install_correctionlib)
+  execute_process(
+    COMMAND "${Python_EXECUTABLE}" "-c"
+            "import correctionlib; print(correctionlib.__version__)"
+    RESULT_VARIABLE PACKAGE_NOT_FOUND
+    OUTPUT_VARIABLE PACKAGE_VERSION
+    OUTPUT_STRIP_TRAILING_WHITESPACE)
+  if(${PACKAGE_NOT_FOUND} EQUAL 1)
+    execute_process(
+      COMMAND ${Python_EXECUTABLE} -m pip install ${_pip_args}
+              git+https://github.com/cms-nanoAOD/correctionlib.git)
+  endif()
+  message(STATUS "Found correctionlib !")
+endfunction()
+
+# Adding correctionlib for scale factor evaluation for now the official pip
+# package has some problem in the future "find_python_package(correctionlib
+# correctionlib X.X)" should hopefully work
+install_correctionlib()
+message(STATUS "Setting up correctionlib ...")
+execute_process(
+  COMMAND correction config --cmake
+  OUTPUT_VARIABLE CORRECTION_LIB_ARGS
+  OUTPUT_STRIP_TRAILING_WHITESPACE)
+string(REPLACE -Dcorrectionlib_DIR= "" CORRECTIONLIBPATH ${CORRECTION_LIB_ARGS})
+# if correctionlib comes from cvmfs, change the correctionlibpath accordingly
+if(${CORRECTIONLIBPATH} MATCHES "^/cvmfs/")
+  message(STATUS "Setting up correctionlib from cvmfs ...")
+  set(USING_CVMFS TRUE)
+  find_package(correctionlib)
+  find_library(CORRECTION_LIB_PATH correctionlib)
+else()
+  message(STATUS "Setting up correctionlib from local setup ...")
+  set(USING_CVMFS FALSE)
+  find_package(correctionlib REQUIRED PATHS ${CORRECTIONLIBPATH})
+  set(CORRECTION_LIB_PATH "${CORRECTIONLIBPATH}/../lib/libcorrectionlib.so")
+endif()
+set(THREADS_PREFER_PTHREAD_FLAG ON)
+find_package(Threads)
+find_package(ZLIB)
+set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
+message(STATUS "Correctionlib library path: ${CORRECTION_LIB_PATH}")

cmake/AddLogging.cmake

@@ -0,0 +1,34 @@
+message(STATUS "Including spdlog.")
+# Build the logging library
+include(ExternalProject)
+ExternalProject_Add(
+  spdlog
+  PREFIX spdlog
+  GIT_REPOSITORY https://github.com/gabime/spdlog.git
+  GIT_SHALLOW 1
+  GIT_TAG v1.8.5
+  CMAKE_ARGS -DCMAKE_CXX_STANDARD=${CMAKE_CXX_STANDARD}
+             -DCMAKE_BUILD_TYPE=Release
+             -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR} -DCMAKE_CXX_FLAGS=-fpic
+  LOG_DOWNLOAD 1
+  LOG_CONFIGURE 1
+  LOG_BUILD 1
+  LOG_INSTALL 1
+  BUILD_BYPRODUCTS ${CMAKE_INSTALL_PREFIX}/lib64/libspdlog.a
+  BUILD_BYPRODUCTS ${CMAKE_INSTALL_PREFIX}/lib/libspdlog.a)
+
+message(STATUS "Configuring spdlog.")
+# Make an imported target out of the build logging library
+add_library(logging STATIC IMPORTED)
+file(MAKE_DIRECTORY "${CMAKE_BINARY_DIR}/include"
+)# required because the include dir must be existent for
+ # INTERFACE_INCLUDE_DIRECTORIES
+include(GNUInstallDirs) # required to populate CMAKE_INSTALL_LIBDIR with lib or
+                        # lib64 required for the destination of libspdlog.a
+set_target_properties(
+  logging
+  PROPERTIES IMPORTED_LOCATION
+             "${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_LIBDIR}/libspdlog.a"
+             INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_BINARY_DIR}/include")
+add_dependencies(logging spdlog) # enforces to build spdlog before making the
+                                 # imported target

cmake/AddOnnxruntime.cmake

@@ -0,0 +1,23 @@
+# Find ONNXRuntime first check if we have an LCG stack via LCG_VERSION
+# environment variable
+if(DEFINED ENV{LCG_VERSION})
+  string(REPLACE ":" ";" RUNTIME_PATH "$ENV{LD_LIBRARY_PATH}")
+  message(STATUS "Found LCG stack, using it to find ONNXRuntime")
+  find_library(
+    ONNX_RUNTIME_LIB_PATH
+    NAMES onnxruntime
+    HINTS ${RUNTIME_PATH})
+  if(ONNX_RUNTIME_LIB_PATH)
+    # get the real path of the library to find the include directory
+    get_filename_component(ONNX_RUNTIME_LIB_PATH ${ONNX_RUNTIME_LIB_PATH}
+                           REALPATH)
+    get_filename_component(ONNX_RUNTIME_INCLUDE_PATH
+                           ${ONNX_RUNTIME_LIB_PATH}/../../include REALPATH)
+    message(STATUS "ONNXRuntime include path: ${ONNX_RUNTIME_INCLUDE_PATH}/core/session")
+    include_directories("${ONNX_RUNTIME_INCLUDE_PATH}/core/session")
+  endif()
+
+  message(STATUS "ONNXRuntime library path: ${ONNX_RUNTIME_LIB_PATH}")
+else()
+  message(STATUS "No LCG stack found, not adding ONNXRuntime")
+endif()

cmake/AddRoot.cmake

@@ -0,0 +1,43 @@
+find_package(ROOT 6.26 REQUIRED COMPONENTS ROOTVecOps ROOTDataFrame RooFit
+                                           GenVector)
+
+message(STATUS "")
+message(STATUS "Found ROOT with following settings:")
+message(STATUS "  Version: ${ROOT_VERSION}")
+message(STATUS "  ROOT executable: ${ROOT_EXECUTABLE}")
+message(STATUS "  Include directories: ${ROOT_INCLUDE_DIRS}")
+message(STATUS "  Compiler flags: ${ROOT_CXX_FLAGS}")
+message(STATUS "")
+
+# Add ROOT flags to compile options, e.g. we have to use the same C++ standard
+# Note that the flags from the build type, e.g. CMAKE_CXX_FLAGS_RELEASE, are
+# automatically appended. You can check this during build time by enabling the
+# verbose make output with "VERBOSE=1 make".
+set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${ROOT_CXX_FLAGS}")
+
+# Use -fconcepts with g++ to silence following warning: warning: use of 'auto'
+# in parameter declaration only available with '-fconcepts
+if(CMAKE_CXX_COMPILER_ID STREQUAL GNU)
+  message(STATUS "Attach -fconcepts to the compiler flags to silence warnings.")
+  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fconcepts")
+endif()
+
+# Find the C++ standard from ROOT and set it as the standard of this project We
+# require the C++ standard 17 or 20 and don't want to fall back to lower
+# versions.
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+if(${ROOT_CXX_FLAGS} MATCHES "\\-std\\=c\\+\\+17")
+  message(STATUS "Set c++17 as the C++ standard.")
+  set(CMAKE_CXX_STANDARD 17)
+elseif(${ROOT_CXX_FLAGS} MATCHES "\\-std\\=c\\+\\+20")
+  message(STATUS "Set c++20 as the C++ standard.")
+  set(CMAKE_CXX_STANDARD 20)
+elseif(${ROOT_CXX_FLAGS} MATCHES "\\-std\\=c\\+\\+14")
+  message(STATUS "c++14 found, setting c++17 as the C++ standard.")
+  set(CMAKE_CXX_STANDARD 17)
+else()
+  message(
+    FATAL_ERROR
+      "The standard c++17 or higher is required but not found in the ROOT flags: ${ROOT_CXX_FLAGS}"
+  )
+endif()

cmake/Build.cmake

@@ -0,0 +1,80 @@
+set(GENERATE_CPP_OUTPUT_FILELIST "${GENERATE_CPP_OUTPUT_DIRECTORY}/files.txt")
+if(NOT EXISTS ${GENERATE_CPP_OUTPUT_FILELIST})
+  message(
+    FATAL_ERROR
+      "List of generated C++ files in ${GENERATE_CPP_OUTPUT_FILELIST} does not exist."
+  )
+endif()
+
+# Iterate over files from output filelist and add build and install targets
+file(READ ${GENERATE_CPP_OUTPUT_FILELIST} FILELIST)
+string(REGEX REPLACE "\n" ";" FILELIST ${FILELIST})
+set(TARGET_NAMES "")
+# copy all correction files into the install location
+install(DIRECTORY data/ DESTINATION ${INSTALLDIR}/data)
+if(PAYLOADS)
+  install(
+    DIRECTORY ${CMAKE_SOURCE_DIR}/analysis_configurations/${ANALYSIS}/payloads
+    DESTINATION ${INSTALLDIR})
+endif()
+
+# also copy inish script needed for job tarball
+install(FILES init.sh DESTINATION ${INSTALLDIR})
+foreach(FILENAME ${FILELIST})
+  # STRING(REGEX REPLACE ".cxx" "" TARGET_NAME ${FILENAME})
+  cmake_path(GET FILENAME RELATIVE_PART RELATIVE_PATH)
+  cmake_path(GET FILENAME FILENAME TARGET_FILENAMENAME)
+  string(REGEX REPLACE ".cxx" "" TARGET_NAME ${TARGET_FILENAMENAME})
+  string(REGEX REPLACE "/${TARGET_FILENAMENAME}" "" GENERATED_CODEBASE
+                       ${RELATIVE_PATH})
+
+  list(APPEND TARGET_NAMES ${TARGET_NAME})
+  set(FULL_PATH "${GENERATE_CPP_OUTPUT_DIRECTORY}/${FILENAME}")
+
+  # Add build target
+  message(STATUS "Add build target for file ${FILENAME}.")
+
+  # message(STATUS "FULL_PATH: ${FULL_PATH} / TARGET_NAME: ${TARGET_NAME}")
+  # message(STATUS "Adding header files from
+  # ${GENERATE_CPP_OUTPUT_DIRECTORY}/${GENERATED_CODEBASE}/include/*")
+  file(
+    GLOB GENERATED_HEADERS
+    LIST_DIRECTORIES true
+    "${GENERATE_CPP_OUTPUT_DIRECTORY}/${GENERATED_CODEBASE}/include/*")
+  file(GLOB GENERATED_CXX_FILES
+       "${GENERATE_CPP_OUTPUT_DIRECTORY}/${GENERATED_CODEBASE}/src/*/*.cxx")
+  # message(STATUS "GENERATED_HEADERS ${GENERATED_HEADERS}")
+  add_executable(${TARGET_NAME} ${FULL_PATH} ${GENERATED_CXX_FILES})
+  # Adds a pre-build event to the Target copying the correctionlib.so file into
+  # the /lib folder in the install directory
+  target_include_directories(
+    ${TARGET_NAME} PRIVATE ${CMAKE_SOURCE_DIR} ${ROOT_INCLUDE_DIRS}
+                           $ORIGIN/lib/ lib/)
+  target_link_libraries(
+    ${TARGET_NAME}
+    ROOT::ROOTVecOps
+    ROOT::ROOTDataFrame
+    ROOT::RooFit
+    ROOT::GenVector
+    logging
+    correctionlib
+    nlohmann_json::nlohmann_json
+    CROWNLIB
+    ${ONNX_RUNTIME_LIB_PATH})
+  add_custom_command(
+    TARGET ${TARGET_NAME}
+    PRE_BUILD
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different "${CORRECTION_LIB_PATH}"
+            ${INSTALLDIR}/lib/libcorrectionlib.so)
+  # Find shared libraries next to the executable in the /lib folder
+  set_target_properties(
+    ${TARGET_NAME} PROPERTIES BUILD_WITH_INSTALL_RPATH FALSE
+                              LINK_FLAGS "-Wl,-rpath,$ORIGIN/lib")
+  # Add install target, basically just copying the executable around relative to
+  # CMAKE_INSTALL_PREFIX
+  install(TARGETS ${TARGET_NAME} DESTINATION ${INSTALLDIR})
+  install(
+    CODE "execute_process(COMMAND ${CMAKE_SOURCE_DIR}/checks/get-diff.sh ${CMAKE_SOURCE_DIR} ${ANALYSIS} ${INSTALLDIR}/diff )"
+  )
+
+endforeach()

cmake/CodeGeneration.cmake

@@ -0,0 +1,49 @@
+# Generate the C++ code
+if(FRIENDS)
+  set(GENERATE_CPP_INPUT_TEMPLATE
+      "${CMAKE_SOURCE_DIR}/code_generation/analysis_template_friends.cxx")
+else()
+  set(GENERATE_CPP_INPUT_TEMPLATE
+      "${CMAKE_SOURCE_DIR}/code_generation/analysis_template.cxx")
+endif()
+set(GENERATE_CPP_SUBSET_TEMPLATE
+    "${CMAKE_SOURCE_DIR}/code_generation/subset_template.cxx")
+
+message(STATUS "")
+message(STATUS "Generate C++ code with following settings:")
+message(STATUS "  Output directory: ${GENERATE_CPP_OUTPUT_DIRECTORY}")
+message(STATUS "  Install directory: ${INSTALLDIR}")
+message(STATUS "  Template: ${GENERATE_CPP_INPUT_TEMPLATE}")
+message(STATUS "  Subset template: ${GENERATE_CPP_SUBSET_TEMPLATE}")
+message(STATUS "  Analysis: ${ANALYSIS}")
+message(STATUS "  Config: ${CONFIG}")
+message(STATUS "  Channels: ${SCOPES}")
+message(STATUS "  Shifts: ${SHIFTS}")
+message(STATUS "  Samples: ${SAMPLES}")
+message(STATUS "  Eras: ${ERAS}")
+message(STATUS "")
+
+file(MAKE_DIRECTORY ${GENERATE_CPP_OUTPUT_DIRECTORY})
+# loop over all samples and eras and generate code for each one of them
+foreach(ERA IN LISTS ERAS)
+  foreach(SAMPLE IN LISTS SAMPLES)
+    message("Generating code for sample ${SAMPLE} and era ${ERA}")
+    message(
+      "Running command: ${Python_EXECUTABLE} ${CMAKE_SOURCE_DIR}/generate.py --template ${GENERATE_CPP_INPUT_TEMPLATE} --subset-template ${GENERATE_CPP_SUBSET_TEMPLATE} --output ${GENERATE_CPP_OUTPUT_DIRECTORY} --analysis ${ANALYSIS} --config ${CONFIG} --scopes ${SCOPES} --shifts ${SHIFTS} --sample ${SAMPLE} --era ${ERA} --threads ${THREADS} --debug ${DEBUG_PARSED} --friends ${FRIENDS} --quantities-map ${QUANTITIESMAP}"
+    )
+    execute_process(
+      COMMAND
+        ${Python_EXECUTABLE} ${CMAKE_SOURCE_DIR}/generate.py --template
+        ${GENERATE_CPP_INPUT_TEMPLATE} --subset-template
+        ${GENERATE_CPP_SUBSET_TEMPLATE} --output
+        ${GENERATE_CPP_OUTPUT_DIRECTORY} --analysis ${ANALYSIS} --config
+        ${CONFIG} --scopes ${SCOPES} --shifts ${SHIFTS} --sample ${SAMPLE} --era
+        ${ERA} --threads ${THREADS} --debug ${DEBUG_PARSED} --friends ${FRIENDS}
+        --quantities-map ${QUANTITIESMAP}
+      RESULT_VARIABLE ret
+      WORKING_DIRECTORY ${CMAKE_SOURCE_DIR})
+    if(ret EQUAL "1")
+      message(FATAL_ERROR "Code Generation Failed - Exiting !")
+    endif()
+  endforeach()
+endforeach()

cmake/ConfigureCrownlib.cmake

@@ -0,0 +1,54 @@
+# build a shared lib from all CROWN functions
+include_directories(${CMAKE_SOURCE_DIR}/src)
+include_directories(${CMAKE_SOURCE_DIR}/include)
+file(GLOB SOURCES_1 ${CMAKE_SOURCE_DIR}/src/*.cxx)
+file(GLOB SOURCES_2 ${CMAKE_SOURCE_DIR}/src/utility/*.cxx
+     ${CMAKE_SOURCE_DIR}/src/RecoilCorrections/*.cxx
+     ${CMAKE_SOURCE_DIR}/src/SVFit/*.cxx)
+set(SOURCES ${SOURCES_1} ${SOURCES_2})
+
+if(BUILD_CROWNLIB_ONLY)
+  message(STATUS "Building only the CROWNLIB library")
+  add_library(CROWNLIB SHARED ${SOURCES})
+  target_include_directories(CROWNLIB PRIVATE ${CMAKE_SOURCE_DIR}
+                                              ${ROOT_INCLUDE_DIRS})
+  target_link_libraries(
+    CROWNLIB
+    ROOT::ROOTVecOps
+    ROOT::ROOTDataFrame
+    ROOT::RooFit
+    ROOT::GenVector
+    logging
+    correctionlib
+    nlohmann_json::nlohmann_json
+    ${ONNX_RUNTIME_LIB_PATH})
+  install(TARGETS CROWNLIB DESTINATION ${INSTALLDIR}/lib)
+  return()
+endif()
+# check if CROWNLIB is already installed
+find_library(
+  CROWNLIB_FOUND CROWNLIB HINTS ${INSTALLDIR}/lib ${CMAKE_CURRENT_BINARY_DIR}
+                                ${CMAKE_CURRENT_BINARY_DIR}/lib)
+if(NOT CROWNLIB_FOUND OR REBUILD_CROWN_LIB)
+  message(STATUS "CROWNLIB not found, building it")
+  # CROWNLIB not found, build it
+  add_library(CROWNLIB SHARED ${SOURCES})
+  target_include_directories(CROWNLIB PRIVATE ${CMAKE_SOURCE_DIR}
+                                              ${ROOT_INCLUDE_DIRS})
+  target_link_libraries(
+    CROWNLIB
+    ROOT::ROOTVecOps
+    ROOT::ROOTDataFrame
+    ROOT::RooFit
+    ROOT::GenVector
+    logging
+    correctionlib
+    nlohmann_json::nlohmann_json
+    ${ONNX_RUNTIME_LIB_PATH})
+  install(TARGETS CROWNLIB DESTINATION ${INSTALLDIR}/lib)
+else()
+  message(STATUS "Found CROWNLIB in ${CROWNLIB_FOUND}")
+  install(FILES ${CROWNLIB_FOUND} DESTINATION ${INSTALLDIR}/lib)
+  link_directories(${INSTALLDIR}/lib ${CMAKE_CURRENT_BINARY_DIR}
+                   ${CMAKE_CURRENT_BINARY_DIR}/lib)
+endif()

cmake/ConfigurePython.cmake

@@ -0,0 +1,41 @@
+# Find Python 3
+find_package(Python 3.9 REQUIRED COMPONENTS Interpreter)
+
+# detect virtualenv and set Pip args accordingly
+if(DEFINED ENV{VIRTUAL_ENV} OR DEFINED ENV{CONDA_PREFIX})
+  set(_pip_args)
+else()
+  set(_pip_args "--user")
+endif()
+
+function(find_python_package PYPINAME NAME MIN_VERSION)
+  execute_process(
+    COMMAND "${Python_EXECUTABLE}" "-c"
+            "import ${NAME}; print(${NAME}.__version__)"
+    RESULT_VARIABLE PACKAGE_NOT_FOUND
+    OUTPUT_VARIABLE PACKAGE_VERSION
+    OUTPUT_STRIP_TRAILING_WHITESPACE)
+  if(${PACKAGE_NOT_FOUND} EQUAL 1)
+    execute_process(COMMAND ${Python_EXECUTABLE} -m pip install ${PYPINAME}
+                            ${_pip_args})
+    execute_process(
+      COMMAND "${Python_EXECUTABLE}" "-c"
+              "import ${NAME}; print(${NAME}.__version__)"
+      RESULT_VARIABLE PACKAGE_NOT_FOUND
+      OUTPUT_VARIABLE PACKAGE_VERSION
+      OUTPUT_STRIP_TRAILING_WHITESPACE)
+    if(${PACKAGE_NOT_FOUND} EQUAL 1)
+      message(FATAL_ERROR "Failed to import ${PYPINAME} or get version.")
+    endif()
+  endif()
+  if(PACKAGE_VERSION VERSION_LESS MIN_VERSION)
+    message(
+      FATAL_ERROR
+        "The version of Python package ${PYPINAME} is too old (found ${PACKAGE_VERSION}, require at least ${MIN_VERSION})."
+    )
+  endif()
+  message(
+    STATUS
+      "Found Python package ${PYPINAME} (require ${MIN_VERSION}, found ${PACKAGE_VERSION})"
+  )
+endfunction()