Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bytehamster/gpurecsplit
Parallel space-efficient minimal perfect hash function on SIMD and GPU
https://github.com/bytehamster/gpurecsplit
Last synced: about 1 month ago
JSON representation
Parallel space-efficient minimal perfect hash function on SIMD and GPU
- Host: GitHub
- URL: https://github.com/bytehamster/gpurecsplit
- Owner: ByteHamster
- License: gpl-3.0
- Created: 2022-10-15T16:55:39.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-23T10:11:18.000Z (9 months ago)
- Last Synced: 2024-06-12T17:57:34.773Z (5 months ago)
- Language: C++
- Homepage:
- Size: 1.05 MB
- Stars: 14
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
- Citation: CITATION.cff
Awesome Lists containing this project
README
# GpuRecSplit / SimdRecSplit
We greatly improve the construction time of the [RecSplit](https://arxiv.org/abs/1910.06416) Minimal Perfect Hash Function using two orthogonal approaches.
*Rotation fitting* hashes the objects in each leaf to two sets and tries to combine them to a bijection by cyclically shifting one set to fill the holes in the other.
In addition, we harness parallelism on the level of bits, vectors, cores, and GPUs.
The code in this repository achieves significant speedups on SIMD machines and GPUs, compared
to the original [RecSplit implementation](https://github.com/vigna/sux/blob/master/sux/function/RecSplit.hpp).
### Construction performance
| l | b | Method | Threads | B/Object | us/Object | Speedup |
|---:|---:|:---|---:|---:|---:|---:|
| 16 | 2000 | RecSplit [\[ALENEX'20\]](https://arxiv.org/abs/1910.06416) | 1 | 1.560 | 1175.4 | |
| 16 | 2000 | SimdRecSplit | 1 | 1.560 | 138.0 | 8 |
| 16 | 2000 | SimdRecSplit | 16 | 1.560 | 27.9 | 42 |
| 16 | 2000 | GpuRecSplit | 4 | 1.5601 | 1.0 | 1173 |
| 18 | 50 | RecSplit [\[ALENEX'20\]](https://arxiv.org/abs/1910.06416) | 1 | 1.707 | 2942.9 | |
| 18 | 50 | SimdRecSplit | 1 | 1.709 | 58.3 | 50 |
| 18 | 50 | SimdRecSplit | 16 | 1.708 | 12.3 | 239 |
| 18 | 50 | GpuRecSplit | 4 | 1.709 | 0.5 | 5438 |
| 24 | 2000 | GpuRecSplit | 4 | 1.498 | 467.9 | |
In the space efficient configurations here, we use n = 5 million objects (strong scaling).
For more detailed measurements, refer to [our paper](https://arxiv.org/abs/2212.09562).
### Library Usage
Clone (with submodules, `git clone --recursive`) this repo and add it to your `CMakeLists.txt`:
```
add_subdirectory(path/to/GpuRecSplit)
target_link_libraries(YourTarget PRIVATE RecSplit SIMDRecSplit GPURecSplit) # or a subset of the targets
```
### Reproducing Experiments
This repository contains the source code and our reproducibility artifacts for the benchmarks specific to GpuRecSplit/SimdRecSplit.
Benchmarks that compare SimdRecSplit to competitors are available in a different repository: https://github.com/ByteHamster/MPHF-Experiments
We provide an easy to use Docker image to quickly reproduce our results.
Alternatively, you can look at the `Dockerfile` to see all libraries, tools, and commands necessary to compile.
#### Cloning the Repository
This repository contains submodules.
To clone the repository including submodules, use the following command.
```
git clone --recursive https://github.com/ByteHamster/GpuRecSplit.git
```
#### Building the Docker Image
Run the following command to build the Docker image.
Building the image takes about 10 minutes, as some packages (including LaTeX for the plots) have to be installed.
```bash
docker build -t gpurecsplit --no-cache .
```
Some compiler warnings (red) are expected when building dependencies and will not prevent building the image or running the experiments.
Please ignore them!
#### Running the Experiments
Due to the long total running time of all experiments in our paper, we provide run scripts for a slightly simplified version of the experiments.
They run fewer iterations and output fewer data points.
You can modify the benchmarks scripts in `scripts/dockerVolume` if you want to change the number of runs or data points.
This does not require the Docker image to recompile.
Different experiments can be started by using the following command:
```bash
docker run --interactive --tty -v "$(pwd)/scripts/dockerVolume:/opt/dockerVolume" gpurecsplit /opt/dockerVolume/.sh
```
`<script>` depends on the experiment you want to run.
| Figure | Launch command | Estimated runtime |
| :------------------------------------------------------------------- | :-------------------------------------------- | :----------------- |
| Figure 3 <br /><img src="preview-gpurecsplit-figure-3.png" width="300"/> | /opt/dockerVolume/brute-force-vs-rotations.sh | 30 minutes |
The resulting plots can be found in `scripts/dockerVolume` and have the file extension `.pdf`.
More experiments comparing GpuRecSplit with competitors can be found in a different repository: https://github.com/ByteHamster/MPHF-Experiments
### Licensing
GpuRecSplit is licensed exactly like `libstdc++` (GPLv3 + GCC Runtime Library Exception), which essentially means you can use it everywhere, exactly like `libstdc++`.
You can find details in the [COPYING](/COPYING) and [COPYING.RUNTIME](/COPYING.RUNTIME) files.
If you use the project in an academic context or publication, please cite [our paper](https://arxiv.org/abs/2212.09562):
```
@inproceedings{bez2022high,
author = {Dominik Bez and
Florian Kurpicz and
Hans{-}Peter Lehmann and
Peter Sanders},
title = {High Performance Construction of {RecSplit} Based Minimal Perfect Hash
Functions},
booktitle = {{ESA}},
series = {LIPIcs},
volume = {274},
pages = {19:1--19:16},
publisher = {Schloss Dagstuhl - Leibniz-Zentrum f{\"{u}}r Informatik},
year = {2023},
doi = {10.4230/LIPICS.ESA.2023.19}
}
```