ghex 0.4.0__tar.gz

ghex-0.4.0/.bumpversion.toml

@@ -0,0 +1,30 @@
+[tool.bumpversion]
+current_version = "0.4.0"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+search = "{current_version}"
+replace = "{new_version}"
+regex = false
+ignore_missing_version = false
+ignore_missing_files = false
+tag = false
+sign_tags = false
+tag_name = "v{new_version}"
+tag_message = "Bump version: {current_version} → {new_version}"
+allow_dirty = false
+commit = false
+message = "Bump version: {current_version} → {new_version}"
+commit_args = ""
+setup_hooks = []
+pre_commit_hooks = []
+post_commit_hooks = []
+
+[[tool.bumpversion.files]]
+filename = "CMakeLists.txt"
+parse = "(?P<major>\\d+) (?P<minor>\\d+) (?P<patch>\\d+)"
+serialize = ["{major} {minor} {patch}"]
+search = "make_version(GHEX {current_version})"
+replace = "make_version(GHEX {new_version})"
+
+[[tool.bumpversion.files]]
+filename = "bindings/python/pyproject.toml"

ghex-0.4.0/.clang-format

@@ -0,0 +1,92 @@
+---
+Language:        Cpp
+# BasedOnStyle:  LLVM
+#AccessModifierOffset: -4
+AccessModifierOffset: -2
+AlignAfterOpenBracket: DontAlign
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: true
+AlignConsecutiveMacros: true
+#AlignConsecutiveAssignments: false
+#AlignConsecutiveDeclarations: false
+#AlignConsecutiveMacros: false
+AlignEscapedNewlines: Right
+AlignOperands: true
+AlignTrailingComments: true
+AllowAllArgumentsOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+BinPackArguments: true
+BinPackParameters: true
+BreakBeforeBraces: Allman
+#BreakBeforeBraces: Attach
+#BreakBeforeBraces: Custom
+#BraceWrapping:
+#    AfterCaseLabel: true
+#    AfterClass: true
+# BreakBeforeBinaryOperators: All
+# ConstructorInitializerAllOnOneLineOrOnePerLine: false
+BreakConstructorInitializers: BeforeComma
+ConstructorInitializerIndentWidth: 0
+BreakInheritanceList: BeforeComma
+#AllowShortBlocksOnASingleLine: Always
+AllowShortBlocksOnASingleLine: true
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: Always
+AllowShortLambdasOnASingleLine: All
+AllowShortLoopsOnASingleLine: true
+#AlwaysBreakAfterReturnType: None
+AlwaysBreakAfterReturnType: TopLevelDefinitions
+# PenaltyReturnTypeOnItsOwnLine: 1
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: Yes
+BreakBeforeTernaryOperators: true
+BreakStringLiterals: false
+ColumnLimit: 100
+#ColumnLimit: 120
+# CommentPragmas
+CompactNamespaces: false
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+#--DeriveLineEnding: true
+#--DerivePointerAlignment: true
+FixNamespaceComments: true
+# ForEachMacros: [for_each]
+# IncludeBlocks: Regroup
+IndentCaseLabels: true
+#IndentGotoLabels: false
+#IndentPPDirectives: BeforeHash
+IndentPPDirectives: None
+IndentWidth: 4
+IndentWrappedFunctionNames: false
+KeepEmptyLinesAtTheStartOfBlocks: false
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+PointerAlignment: Left
+ReflowComments: false
+SortIncludes: false
+SortUsingDeclarations: false
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+#SpaceBeforeSquareBrackets: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles: false
+SpacesInCStyleCastParentheses: false
+# SpacesInConditionalStatement: false
+SpacesInContainerLiterals: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+#Standard: Latest
+TabWidth: 4
+UseTab: Never
+
+
+

ghex-0.4.0/.github/workflows/CI.yml

@@ -0,0 +1,165 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  build-all:
+    name: "Build GHEX and run unit tests"
+    runs-on: ubuntu-latest
+    container: ${{ matrix.config.container }}
+
+    strategy:
+      matrix:
+        config:
+        - {
+            name:      "cpu-gcc-mpi-atlas-parmetis",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis",
+            cc:        "gcc",
+            cxx:       "g++",
+            fortran:   "ON",
+            gpu:       "OFF",
+            gpu_type:  "AUTO",
+            run:       "ON",
+            atlas:     "ON",
+            parmetis:  "ON",
+            backend:   "MPI",
+          }
+
+        - {
+            name:      "cpu-gcc-ucx-atlas-parmetis",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis",
+            cc:        "gcc",
+            cxx:       "g++",
+            fortran:   "ON",
+            gpu:       "OFF",
+            gpu_type:  "AUTO",
+            run:       "ON",
+            atlas:     "ON",
+            parmetis:  "ON",
+            backend:   "UCX",
+          }
+
+        - {
+            name:      "cpu-clang-mpi-atlas-parmetis",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis-hip",
+            cc:        "/opt/rocm/llvm/bin/clang",
+            cxx:       "/opt/rocm/llvm/bin/clang++",
+            fortran:   "OFF",
+            gpu:       "OFF",
+            gpu_type:  "AUTO",
+            run:       "ON",
+            atlas:     "ON",
+            parmetis:  "ON",
+            backend:   "MPI",
+          }
+
+        - {
+            name:      "cpu-clang-ucx-atlas-parmetis",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis-hip",
+            cc:        "/opt/rocm/llvm/bin/clang",
+            cxx:       "/opt/rocm/llvm/bin/clang++",
+            fortran:   "OFF",
+            gpu:       "OFF",
+            gpu_type:  "AUTO",
+            run:       "ON",
+            atlas:     "ON",
+            parmetis:  "ON",
+            backend:   "UCX",
+          }
+
+        - {
+            name:      "gpu-hip-mpi-atlas-parmetis",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis-hip",
+            cc:        "/opt/rocm/llvm/bin/clang",
+            cxx:       "/opt/rocm/llvm/bin/clang++",
+            fortran:   "OFF",
+            gpu:       "ON",
+            gpu_type:  "AMD",
+            run:       "OFF",
+            atlas:     "ON",
+            parmetis:  "ON",
+            backend:   "MPI",
+          }
+
+        - {
+            name:      "gpu-cuda-mpi-atlas-parmetis",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis-cuda-11",
+            cc:        "gcc",
+            cxx:       "g++",
+            fortran:   "ON",
+            gpu:       "ON",
+            gpu_type:  "NVIDIA",
+            run:       "OFF",
+            atlas:     "ON",
+            parmetis:  "ON",
+            backend:   "MPI",
+          }
+
+    env:
+      CC:                             ${{ matrix.config.cc }}
+      CXX:                            ${{ matrix.config.cxx }}
+      GHEX_USE_GPU:                   ${{ matrix.config.gpu }}
+      GHEX_GPU_TYPE:                  ${{ matrix.config.gpu_type }}
+      eckit_DIR:                      ${{ matrix.eckit }}
+      Atlas_DIR:                      ${{ matrix.atlas }}
+      SHLVL:                          "1"
+      OMPI_ALLOW_RUN_AS_ROOT:         "1"
+      OMPI_ALLOW_RUN_AS_ROOT_CONFIRM: "1"
+      CTEST_OUTPUT_ON_FAILURE:        "1"
+      UCX_DIR:                        "/opt/ucx"
+      #ECKIT_DIR:                      "/opt/eckit"
+      #ATLAS_DIR:                      "/opt/atlas"
+      METIS_INCLUDE_DIR:              "/opt/metis/include"
+      METIS_LIB_DIR:                  "/opt/metis/lib"
+      PARMETIS_INCLUDE_DIR:           "/opt/parmetis/include"
+      PARMETIS_LIB_DIR:               "/opt/parmetis/lib"
+
+
+    steps:
+      - name: Install packages
+        run: |
+          apt update
+          apt-get -y install python3-dev python3-venv python3-pybind11 ninja-build
+
+      - name: Clone w/ submodules
+        uses: actions/checkout@v3
+        with:
+          submodules: recursive
+
+      - name: Configure
+        run: |
+          mkdir -p build
+          cd build
+          cmake .. \
+            -GNinja \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DGHEX_GIT_SUBMODULE=OFF \
+            -DGHEX_USE_BUNDLED_LIBS=ON \
+            -DGHEX_USE_BUNDLED_GRIDTOOLS=ON \
+            -DUCX_DIR=${UCX_DIR} \
+            -DGHEX_TRANSPORT_BACKEND=${{ matrix.config.backend }} \
+            -DGHEX_USE_BUNDLED_OOMPH=ON \
+            -DGHEX_WITH_TESTING=ON \
+            -DGHEX_BUILD_PYTHON_BINDINGS=ON \
+            -DGHEX_BUILD_FORTRAN=${{ matrix.config.fortran }} \
+            -DGHEX_ENABLE_ATLAS_BINDINGS=${{ matrix.config.atlas }} \
+            -DGHEX_ENABLE_PARMETIS_BINDINGS=${{ matrix.config.parmetis }} \
+            -DMETIS_INCLUDE_DIR=${METIS_INCLUDE_DIR} \
+            -DMETIS_LIB_DIR=${METIS_LIB_DIR} \
+            -DPARMETIS_INCLUDE_DIR=${PARMETIS_INCLUDE_DIR} \
+            -DPARMETIS_LIB_DIR=${PARMETIS_LIB_DIR} \
+            -DMPIEXEC_PREFLAGS=--oversubscribe \
+            -DGHEX_USE_GPU=${{ matrix.config.gpu }} \
+            -DGHEX_GPU_TYPE=${{ matrix.config.gpu_type }}
+
+      - name: Build
+        run: cmake --build build --parallel 4
+
+      - if: ${{ matrix.config.run == 'ON' }}
+        name: Execute tests
+        run: cd build && ctest
+

ghex-0.4.0/.github/workflows/pypi_deploy.yml

@@ -0,0 +1,83 @@
+name: Deploy Python Distribution
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build Python distribution
+    runs-on: ubuntu-latest
+    container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis"
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        submodules: recursive
+    - name: Set up Python 3.10
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+    - name: Install pypa/build
+      run: |
+        python -m pip install build --user
+    - name: Build source tarball
+      run: |
+        python -m build --sdist --outdir dist/
+    - name: Test sdist
+      run: |
+        python -m venv .venv
+        . .venv/bin/activate
+        python -m pip install -r ./bindings/python/requirements-test.txt # before ghex installation to avoid mpi4py version conflict  
+        python -m pip install dist/*.tar.gz
+        python -c "import ghex"
+        python -m pytest -s ./test/bindings/python/
+    - name: Upload artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: ghex-dist
+        path: ./dist/**
+  # publish-pypi:
+  #   name: Publish Python distribution to pypi.org
+  #   runs-on: ubuntu-latest
+  #   needs: build
+  #   if: ${{ github.event_name == 'workflow_dispatch' }} # the action was triggered manually
+  #   environment:
+  #     name: pypi
+  #     url: https://pypi.org/project/ghex
+  #   permissions:
+  #     id-token: write
+  #   steps:
+  #   - name: Download wheel
+  #     uses: actions/download-artifact@v3
+  #     with:
+  #       name: ghex-dist
+  #       path: dist
+  #   - name: Publish distribution to PyPI
+  #     uses: pypa/gh-action-pypi-publish@release/v1
+  publish-test-pypi:
+    name: Publish Python distribution to test.pypi.org
+    runs-on: ubuntu-latest
+    needs: build
+    if: ${{ github.event_name == 'workflow_dispatch' }} # TODO: once working, enable line below
+    # if: ${{ github.event_name == 'release' }} # triggered by releasing on github, test first before manually triggering the deployment to PyPI (see release documentation)
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/ghex/
+    permissions:
+      id-token: write
+    steps:
+    - name: Download wheel
+      uses: actions/download-artifact@v4
+      with:
+        name: ghex-dist
+        path: dist
+    - name: Publish distribution to Test PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+        verbose: true

ghex-0.4.0/.github/workflows/test_pip.yml

@@ -0,0 +1,83 @@
+name: Test pip
+
+on:
+  push:
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test-pip:
+    name:      "Install ghex through pip"
+    runs-on:   ubuntu-latest
+    container: ${{ matrix.config.container }}
+
+    strategy:
+      matrix:
+        config:
+        - {
+            name:      "cpu",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis",
+            cc:        "gcc",
+            cxx:       "g++",
+            gpu:       "OFF",
+            gpu_type:  "AUTO",
+            run:       "ON",
+          }
+
+        - {
+            name:      "gpu-cuda",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis-cuda-11",
+            cc:        "gcc",
+            cxx:       "g++",
+            gpu:       "ON",
+            gpu_type:  "NVIDIA",
+            run:       "OFF",
+          }
+
+        - {
+            name:      "gpu-hip",
+            container: "ghcr.io/gridtools/gridtools-base:gcc-9-ucx-mpi-atlas-parmetis-hip",
+            cc:        "/opt/rocm/llvm/bin/clang",
+            cxx:       "/opt/rocm/llvm/bin/clang++",
+            gpu:       "ON",
+            gpu_type:  "AMD",
+            run:       "OFF",
+          }
+
+    env:
+      CC:                             ${{ matrix.config.cc }}
+      CXX:                            ${{ matrix.config.cxx }}
+      GHEX_USE_GPU:                   ${{ matrix.config.gpu }}
+      GHEX_GPU_TYPE:                  ${{ matrix.config.gpu_type }}
+      SHLVL:                          "1"
+      OMPI_ALLOW_RUN_AS_ROOT:         "1"
+      OMPI_ALLOW_RUN_AS_ROOT_CONFIRM: "1"
+
+    steps:
+      - name: Install python
+        run: |
+          apt update
+          apt-get -y install python3-dev python3-venv python3-pybind11
+
+      - name: Clone w/ submodules
+        uses: actions/checkout@v3
+        with:
+          submodules: recursive
+
+      - name: Setup venv
+        run: |
+          python3 -m venv ~/env
+
+      - name: Build and install ghex
+        run: |
+          . ~/env/bin/activate
+          python3 -m pip install --upgrade pip
+          python3 -m pip install -r ./bindings/python/requirements-test.txt # before ghex installation to avoid mpi4py version conflict
+          python3 -m pip install -v .
+
+      - if: ${{ matrix.config.run == 'ON' }}
+        name: Run Python tests
+        run: |
+          . ~/env/bin/activate
+          python3 -m pytest -s ./test/bindings/python/
+          mpirun --oversubscribe -np 4 python3 -m pytest -s --with-mpi ./test/bindings/python/

ghex-0.4.0/.gitignore

@@ -0,0 +1,50 @@
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+# Temporaries
+*.swp
+*.swo
+*~
+
+CMakeCache.txt
+CMakeFiles
+.vscode
+build
+bin
+lib/
+pyvenv.cfg
+doc_src/__pycache__
+doc_src/_build/
+__pycache__
+_build
+.venv*/

ghex-0.4.0/.gitmodules

@@ -0,0 +1,12 @@
+[submodule "ext/gridtools"]
+    path = ext/gridtools
+    url = https://github.com/GridTools/gridtools.git
+    branch = v2.3.2
+[submodule "ext/googletest"]
+    path = ext/googletest
+    url = https://github.com/google/googletest.git
+    branch = v1.14.0
+[submodule "ext/oomph"]
+    path = ext/oomph
+    url = https://github.com/ghex-org/oomph.git
+    branch = main

ghex-0.4.0/CMakeLists.txt

@@ -0,0 +1,178 @@
+cmake_minimum_required(VERSION 3.21)
+
+if (NOT ${CMAKE_VERSION} VERSION_LESS 3.27)
+    # new in 3.27: additionally use uppercase <PACKAGENAME>_ROOT
+    # environment and CMake variables for find_package
+    cmake_policy(SET CMP0144 NEW)
+    set(CMAKE_POLICY_DEFAULT_CMP0144 NEW)
+endif()
+
+set(GHEX_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
+list(APPEND CMAKE_MODULE_PATH "${GHEX_MODULE_PATH}")
+
+include(ghex_version)
+# note: version should not be changed manually, use bump-my-version instead:
+# install: pip install bump-my-version
+# example: bump-my-version bump patch
+make_version(GHEX 0 4 0)
+
+project(GHEX VERSION ${GHEX_VERSION} LANGUAGES C CXX)
+
+# ---------------------------------------------------------------------
+# CMake setup, C++ version, build type, modules, etc
+# ---------------------------------------------------------------------
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_EXTENSIONS OFF)
+if(NOT CMAKE_BUILD_TYPE) # AND NOT CMAKE_CONFIGURATION_TYPES)
+    set(CMAKE_BUILD_TYPE "Release" CACHE STRING "Choose the type of build." FORCE)
+    set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "MinSizeRel" "RelWithDebInfo")
+endif()
+
+# Position Independent Code (PIC) option
+set(POSITION_INDEPENDENT_CODE ON)
+
+# Set the output directory
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
+
+# Set the library and archive output directories
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib)
+set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib)
+
+# ---------------------------------------------------------------------
+# GHEX options
+# ---------------------------------------------------------------------
+option(GHEX_GIT_SUBMODULE "Check submodules during build" OFF)
+option(GHEX_USE_BUNDLED_LIBS "Use bundled 3rd party libraries" OFF)
+set(GHEX_NO_RMA OFF CACHE BOOL "Disable in-node RMA completely")
+set(GHEX_USE_XPMEM OFF CACHE BOOL "Set to true to use xpmem shared memory")
+set(GHEX_USE_XPMEM_ACCESS_GUARD OFF CACHE BOOL "Use xpmem to synchronize rma access")
+mark_as_advanced(GHEX_USE_XPMEM_ACCESS_GUARD)
+set(GHEX_ENABLE_PARMETIS_BINDINGS OFF CACHE BOOL "Set to true to build with ParMETIS bindings")
+set(GHEX_ENABLE_ATLAS_BINDINGS OFF CACHE BOOL "Set to true to build with Atlas bindings")
+set(GHEX_BUILD_FORTRAN OFF CACHE BOOL "True if FORTRAN bindings shall be built")
+set(GHEX_BUILD_PYTHON_BINDINGS OFF CACHE BOOL "Set to true to build Python bindings")
+set(GHEX_WITH_TESTING OFF CACHE BOOL "True if tests shall be built")
+
+# ---------------------------------------------------------------------
+# Common includes
+# ---------------------------------------------------------------------
+include(ghex_device)
+include(ghex_compile_options)
+include(ghex_copy_files)
+include(ghex_reg_test)
+
+# ---------------------------------------------------------------------
+# Define main library
+# ---------------------------------------------------------------------
+include(ghex_common)
+
+# ---------------------------------------------------------------------
+# Dependencies
+# ---------------------------------------------------------------------
+include(ghex_external_dependencies)
+target_link_libraries(ghex_common INTERFACE MPI::MPI_CXX)
+target_link_libraries(ghex_common INTERFACE Boost::boost)
+target_link_libraries(ghex_common INTERFACE GridTools::gridtools)
+target_link_libraries(ghex_common INTERFACE oomph::oomph)
+target_link_libraries(ghex PRIVATE MPI::MPI_CXX)
+if (UNIX AND NOT APPLE)
+target_link_libraries(ghex PUBLIC ${LIBRT})
+endif()
+target_link_libraries(ghex INTERFACE oomph::oomph)
+if (GHEX_USE_XPMEM)
+    target_link_libraries(ghex_common INTERFACE XPMEM::libxpmem)
+    target_link_libraries(ghex PRIVATE XPMEM::libxpmem)
+endif()
+
+# ---------------------------------------------------------------------
+# include paths
+# ---------------------------------------------------------------------
+target_include_directories(ghex_common INTERFACE
+    $<INSTALL_INTERFACE:include>
+    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+    $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>)
+
+# ---------------------------------------------------------------------
+# main src subdir
+# ---------------------------------------------------------------------
+add_subdirectory(src)
+
+# ---------------------------------------------------------------------
+# generate config file
+# ---------------------------------------------------------------------
+configure_file(${CMAKE_CURRENT_SOURCE_DIR}/cmake/config.hpp.in
+    ${CMAKE_CURRENT_BINARY_DIR}/include/ghex/config.hpp @ONLY)
+install(FILES ${PROJECT_BINARY_DIR}/include/ghex/config.hpp
+    DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/ghex)
+configure_file(${CMAKE_CURRENT_SOURCE_DIR}/cmake/ghex_version.txt.in
+    ${CMAKE_CURRENT_BINARY_DIR}/version.txt @ONLY)
+
+# ---------------------------------------------------------------------
+# fortran bindings
+# ---------------------------------------------------------------------
+include(ghex_fortran)
+
+# ---------------------------------------------------------------------
+# python bindings
+# ---------------------------------------------------------------------
+include(ghex_python)
+
+# bindings
+add_subdirectory(bindings)
+
+# ---------------------------------------------------------------------
+# testing
+# ---------------------------------------------------------------------
+if (GHEX_WITH_TESTING)
+    enable_testing()
+    add_subdirectory(test)
+endif()
+
+# ---------------------------------------------------------------------
+# benchmarks
+# ---------------------------------------------------------------------
+
+# ---------------------------------------------------------------------
+# installation
+# ---------------------------------------------------------------------
+install(EXPORT ghex-targets
+    FILE ghex-targets.cmake
+    NAMESPACE GHEX::
+    DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake)
+
+configure_package_config_file(${CMAKE_CURRENT_SOURCE_DIR}/cmake/ghex_config.cmake.in
+    ${CMAKE_CURRENT_BINARY_DIR}/GHEXConfig.cmake
+    INSTALL_DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake)
+
+write_basic_package_version_file(GHEXConfigVersion.cmake
+    VERSION ${PROJECT_VERSION} COMPATIBILITY SameMajorVersion)
+
+install(
+    FILES
+        ${CMAKE_CURRENT_BINARY_DIR}/GHEXConfig.cmake
+        ${CMAKE_CURRENT_BINARY_DIR}/GHEXConfigVersion.cmake
+        ${CMAKE_CURRENT_LIST_DIR}/cmake/FindXPMEM.cmake
+    DESTINATION
+        ${CMAKE_INSTALL_LIBDIR}/cmake)
+
+install(
+    FILES "${PROJECT_SOURCE_DIR}/LICENSE"
+    DESTINATION ${CMAKE_INSTALL_DATADIR}/ghex
+    COMPONENT license
+)
+
+export(EXPORT ghex-targets
+    FILE "${CMAKE_CURRENT_BINARY_DIR}/ghex-targets.cmake")
+
+# set rpaths for bundled oomph libraries
+if(GHEX_USE_BUNDLED_OOMPH)
+    include(ghex_rpath)
+    set_target_properties(ghex PROPERTIES INSTALL_RPATH "${rpath_origin}")
+    if (GHEX_TRANSPORT_BACKEND STREQUAL "LIBFABRIC")
+        set_target_properties(oomph_libfabric PROPERTIES INSTALL_RPATH "${rpath_origin}")
+    elseif (GHEX_TRANSPORT_BACKEND STREQUAL "UCX")
+        set_target_properties(oomph_ucx PROPERTIES INSTALL_RPATH "${rpath_origin}")
+    else()
+        set_target_properties(oomph_mpi PROPERTIES INSTALL_RPATH "${rpath_origin}")
+    endif()
+endif()