This is the implementation of the algorithm PS⁴o presented in the paper Engineering In-place (Shared-memory) Sorting Algorithms, which contains an in-depth description of its inner workings, as well as an extensive experimental performance evaluation. Here's the abstract:
We present new sequential and parallel sorting algorithms that now represent the fastest known techniques for a wide range of input sizes, input distributions, data types, and machines. Somewhat surprisingly, part of the speed advantage is due to the additional feature of the algorithms to work in-place, i.e., they do not need a significant amount of space beyond the input array. Previously, the in-place feature often implied performance penalties. Our main algorithmic contribution is a blockwise approach to in-place data distribution that is provably cache-efficient. We also parallelize this approach taking dynamic load balancing and memory locality into account.
Our new comparison-based algorithm In-place Superscalar Samplesort (IPS⁴o), combines this technique with branchless decision trees. By taking cases with many equal elements into account and by adapting the distribution degree dynamically, we obtain a highly robust algorithm that outperforms the best previous in-place parallel comparison-based sorting algorithms by almost a factor of three. That algorithm also outperforms the best comparison-based competitors regardless of whether we consider in-place or not in-place, parallel or sequential settings.
Another surprising result is that IPS⁴o even outperforms the best (in-place or not in-place) integer sorting algorithms in a wide range of situations. In many of the remaining cases (often involving near-uniform input distributions, small keys, or a sequential setting), our new In-place Parallel Super Scalar Radix Sort (IPS²Ra) turns out to be the best algorithm.
Claims to have the -- in some sense -- "best" sorting algorithm can be found in many papers which cannot all be true. Therefore, we base our conclusions on an extensive experimental study involving a large part of the cross product of 21 state-of-the-art sorting codes, 6 data types, 10 input distributions, 4 machines, 4 memory allocation strategies, and input sizes varying over 7 orders of magnitude. This confirms the claims made about the robust performance of our algorithms while revealing major performance problems in many competitors outside the concrete set of measurements reported in the associated publications. This is particularly true for integer sorting algorithms giving one reason to prefer comparison-based algorithms for robust general-purpose sorting.
PS⁴o is an reimplementation of Super Scalar Sample Sort described by Sanders and Winkel [1]. The implementation of IPS⁴o is also available on github. We recommend to use IPS⁴o instead of PS⁴o as IPS⁴o is not only in-place but also significantly faster than PS⁴o.
An initial version of IPS⁴o has been described in our publication on the 25th Annual European Symposium on Algorithms.
Clone this repository and check out its submodule
git clone --recurse-submodules https://github.com/ips4o/ps4o.gitor use the following commands instead if you want to include this repository as a submodule:
git submodule add https://github.com/ips4o/ps4o.git
git submodule update --recursive --initPS⁴o provides a CMake library for simple usage:
add_subdirectory(<path-to-the-ps4o-repository>)
target_link_libraries(<your-target> PRIVATE ps4o)A minimal working example:
#include "ps4o.hpp"
// sort sequentially
ps4o::sort(begin, end[, comparator]);
// sort in parallel (uses OpenMP if available, std::thread otherwise)
ps4o::parallel::sort(begin, end[, comparator]);If you use the CMake example shown above, we automatically optimize PS⁴o for the native CPU (e.g., -march=native).
You can disable the CMake property PS4O_OPTIMIZE_FOR_NATIVE to avoid native optimization.
PS⁴o uses C++ threads if not specified otherwise.
If you prefer OpenMP threads, you need to enable OpenMP threads, e.g., enable the CMake property IPS4O_USE_OPENMP or add OpenMP to your target.
If you enable the CMake property DISABLE_PS4O_PARALLEL, most of the parallel code will not be compiled and no parallel libraries will be linked.
Otherwise, CMake automatically enables C++ threads (e.g., -pthread) and links against TBB.
Thus, you need the Thread Building Blocks (TBB) library to compile and execute the parallel version of PS⁴o.
We search TBB with find_package(TBB REQUIRED).
If you want to execute IPS⁴o in parallel but your TBB library is not accessible via find_package(TBB REQUIRED), you can still compile IPS⁴o with parallel support.
Just enable the CMake property DISABLE_IPS4O_PARALLEL, enable C++ threads for your own target and link your own target against your TBB library.
If you do not set a CMake build type, we use the build type Release which disables debugging (e.g., -DNDEBUG) and enables optimizations (e.g., -O3).
Currently, the code does not compile on Windows.
PS⁴o is free software provided under the BSD 2-Clause License described in the LICENSE file. If you use PS⁴o in an academic setting please cite the paper Engineering In-place (Shared-memory) Sorting Algorithms using the BibTeX entry
@misc{axtmann2020engineering,
title = {Engineering In-place (Shared-memory) Sorting Algorithms},
author = {Michael Axtmann and Sascha Witt and Daniel Ferizovic and Peter Sanders},
howpublished = {Computing Research Repository (CoRR)},
year = {Sept. 2020},
archivePrefix ={arXiv},
eprint = {2009.13569},
}