/* * Copyright 2008-2013 NVIDIA Corporation * Modifications Copyright© 2019-2025 Advanced Micro Devices, Inc. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include #include #include #include #include #include "test_param_fixtures.hpp" #include "test_real_assertions.hpp" #include "test_utils.hpp" #if !_THRUST_HAS_DEVICE_SYSTEM_STD # include #endif template > struct ParamsMerge { using input_type = Input; using compare_function = CompareFunction; }; template class MergeByKeyTestsClass : public ::testing::Test { public: using input_type = typename ParamsMerge::input_type; using compare_function = typename ParamsMerge::compare_function; }; using MergeByKeyTestsParams = ::testing::Types< ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>, ParamsMerge>>; TYPED_TEST_SUITE(MergeByKeyTestsClass, MergeByKeyTestsParams); TESTS_DEFINE(MergeByKeyTests, FullTestsParams); TESTS_DEFINE(PrimitiveMergeByKeyTests, NumericalTestsParams); TEST(MergeByKeyTests, UsingHip) { SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); ASSERT_EQ(THRUST_DEVICE_SYSTEM, THRUST_DEVICE_SYSTEM_HIP); } TYPED_TEST(MergeByKeyTests, MergeByKeySimple) { using Vector = typename TestFixture::input_type; SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); const Vector a_key{0, 2, 4}, a_val{13, 7, 42}, b_key{0, 3, 3, 4}, b_val{42, 42, 7, 13}; Vector ref_key{0, 0, 2, 3, 3, 4, 4}, ref_val{13, 42, 7, 42, 7, 42, 13}; Vector result_key(7), result_val(7); const auto ends = thrust::merge_by_key( a_key.begin(), a_key.end(), b_key.begin(), b_key.end(), a_val.begin(), b_val.begin(), result_key.begin(), result_val.begin()); ASSERT_EQ_QUIET(result_key.end(), ends.first); ASSERT_EQ_QUIET(result_val.end(), ends.second); ASSERT_EQ(ref_key, result_key); ASSERT_EQ(ref_val, result_val); } template thrust::pair merge_by_key( my_system& system, InputIterator1, InputIterator1, InputIterator2, InputIterator2, InputIterator3, InputIterator4, OutputIterator1 keys_result, OutputIterator2 values_result) { system.validate_dispatch(); return thrust::make_pair(keys_result, values_result); } TEST(MergeByKeyTests, TestMergeByKeyDispatchExplicit) { SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); thrust::device_vector vec(1); my_system sys(0); thrust::merge_by_key( sys, vec.begin(), vec.begin(), vec.begin(), vec.begin(), vec.begin(), vec.begin(), vec.begin(), vec.begin()); ASSERT_EQ(true, sys.is_valid()); } template thrust::pair merge_by_key( my_tag, InputIterator1, InputIterator1, InputIterator2, InputIterator2, InputIterator3, InputIterator4, OutputIterator1 keys_result, OutputIterator2 values_result) { *keys_result = 13; return thrust::make_pair(keys_result, values_result); } TEST(MergeByKeyTests, TestMergeByKeyDispatchImplicit) { SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); thrust::device_vector vec(1); thrust::merge_by_key( thrust::retag(vec.begin()), thrust::retag(vec.begin()), thrust::retag(vec.begin()), thrust::retag(vec.begin()), thrust::retag(vec.begin()), thrust::retag(vec.begin()), thrust::retag(vec.begin()), thrust::retag(vec.begin())); ASSERT_EQ(13, vec.front()); } template auto call_merge_by_key(Args&&... args) -> decltype(thrust::merge_by_key(std::forward(args)...)) { THRUST_IF_CONSTEXPR (_THRUST_STD::is_void::value) { return thrust::merge_by_key(std::forward(args)...); } else { // TODO(bgruber): remove next line in C++17 and pass CompareOp{} directly to stable_sort using C = _THRUST_STD::conditional_t<_THRUST_STD::is_void::value, thrust::less, CompareOp>; return thrust::merge_by_key(std::forward(args)..., C{}); } __builtin_unreachable(); } // ascending and descending TYPED_TEST(MergeByKeyTestsClass, TestMergeByKey) { using T = typename TestFixture::input_type; using compare_function = typename TestFixture::compare_function; SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); for (auto size : get_sizes()) { SCOPED_TRACE(testing::Message() << "with size= " << size); for (auto seed : get_seeds()) { SCOPED_TRACE(testing::Message() << "with seed= " << seed); const auto random_keys = get_random_data(size, get_default_limits::min(), get_default_limits::max(), seed); const auto random_vals = get_random_data( size, get_default_limits::min(), get_default_limits::max(), seed + seed_value_addition); const size_t denominators[] = {1, 2, 3, 4, 5, 6, 7, 8, 9}; for (const auto& denom : denominators) { const size_t size_a = size / denom; thrust::host_vector h_a_keys(random_keys.begin(), random_keys.begin() + size_a); thrust::host_vector h_b_keys(random_keys.begin() + size_a, random_keys.end()); const thrust::host_vector h_a_vals(random_vals.begin(), random_vals.begin() + size_a); const thrust::host_vector h_b_vals(random_vals.begin() + size_a, random_vals.end()); THRUST_IF_CONSTEXPR (_THRUST_STD::is_void::value) { thrust::stable_sort(h_a_keys.begin(), h_a_keys.end()); thrust::stable_sort(h_b_keys.begin(), h_b_keys.end()); } else { // TODO(bgruber): remove next line in C++17 and pass compare_function{} directly to stable_sort using C = _THRUST_STD::conditional_t<_THRUST_STD::is_void::value, thrust::less, compare_function>; thrust::stable_sort(h_a_keys.begin(), h_a_keys.end(), C{}); thrust::stable_sort(h_b_keys.begin(), h_b_keys.end(), C{}); } const thrust::device_vector d_a_keys = h_a_keys; const thrust::device_vector d_b_keys = h_b_keys; const thrust::device_vector d_a_vals = h_a_vals; const thrust::device_vector d_b_vals = h_b_vals; thrust::host_vector h_result_keys(size); thrust::host_vector h_result_vals(size); thrust::device_vector d_result_keys(size); thrust::device_vector d_result_vals(size); const auto h_end = call_merge_by_key( h_a_keys.begin(), h_a_keys.end(), h_b_keys.begin(), h_b_keys.end(), h_a_vals.begin(), h_b_vals.begin(), h_result_keys.begin(), h_result_vals.begin()); h_result_keys.erase(h_end.first, h_result_keys.end()); h_result_vals.erase(h_end.second, h_result_vals.end()); const auto d_end = call_merge_by_key( d_a_keys.begin(), d_a_keys.end(), d_b_keys.begin(), d_b_keys.end(), d_a_vals.begin(), d_b_vals.begin(), d_result_keys.begin(), d_result_vals.begin()); d_result_keys.erase(d_end.first, d_result_keys.end()); d_result_vals.erase(d_end.second, d_result_vals.end()); ASSERT_EQ(h_result_keys, d_result_keys); ASSERT_EQ(h_result_vals, d_result_vals); ASSERT_TRUE(h_end.first == h_result_keys.end()); ASSERT_TRUE(h_end.second == h_result_vals.end()); ASSERT_TRUE(d_end.first == d_result_keys.end()); ASSERT_TRUE(d_end.second == d_result_vals.end()); } } } } TYPED_TEST(PrimitiveMergeByKeyTests, TestMergeByKeyToDiscardIterator) { using T = typename TestFixture::input_type; SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); for (auto size : get_sizes()) { SCOPED_TRACE(testing::Message() << "with size= " << size); for (auto seed : get_seeds()) { SCOPED_TRACE(testing::Message() << "with seed= " << seed); auto h_a_keys = get_random_data(size, get_default_limits::min(), get_default_limits::max(), seed); auto h_b_keys = get_random_data( size, get_default_limits::min(), get_default_limits::max(), seed + seed_value_addition); const auto h_a_vals = get_random_data( size, get_default_limits::min(), get_default_limits::max(), seed + 2 * seed_value_addition); const auto h_b_vals = get_random_data( size, get_default_limits::min(), get_default_limits::max(), seed + 3 * seed_value_addition); thrust::stable_sort(h_a_keys.begin(), h_a_keys.end()); thrust::stable_sort(h_b_keys.begin(), h_b_keys.end()); const thrust::device_vector d_a_keys = h_a_keys; const thrust::device_vector d_b_keys = h_b_keys; const thrust::device_vector d_a_vals = h_a_vals; const thrust::device_vector d_b_vals = h_b_vals; using discard_pair = thrust::pair, thrust::discard_iterator<>>; const discard_pair h_result = thrust::merge_by_key( h_a_keys.begin(), h_a_keys.end(), h_b_keys.begin(), h_b_keys.end(), h_a_vals.begin(), h_b_vals.begin(), thrust::make_discard_iterator(), thrust::make_discard_iterator()); const discard_pair d_result = thrust::merge_by_key( d_a_keys.begin(), d_a_keys.end(), d_b_keys.begin(), d_b_keys.end(), d_a_vals.begin(), d_b_vals.begin(), thrust::make_discard_iterator(), thrust::make_discard_iterator()); const thrust::discard_iterator<> reference(2 * size); ASSERT_EQ_QUIET(reference, h_result.first); ASSERT_EQ_QUIET(reference, h_result.second); ASSERT_EQ_QUIET(reference, d_result.first); ASSERT_EQ_QUIET(reference, d_result.second); } } } struct def_level_fn { THRUST_DEVICE std::uint32_t operator()(int i) const { return static_cast(i + 10); } }; struct offset_transform { THRUST_DEVICE int operator()(int i) const { return i + 1; } }; // Tests the use of thrust::merge_by_key similar to cuDF in // https://github.com/rapidsai/cudf/blob/branch-24.08/cpp/src/lists/dremel.cu#L413 TEST(MergeByKeyTests, TestMergeByKeyFromCuDFDremel) { SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); // TODO(bgruber): I have no idea what this code is actually computing, but I tried to replicate the types/iterators constexpr std::ptrdiff_t empties_size = 123; constexpr int max_vals_size = 225; constexpr int level = 4; constexpr int curr_rep_values_size = 0; thrust::device_vector empties(empties_size, 42); thrust::device_vector empties_idx(empties_size, 13); thrust::device_vector temp_rep_vals(max_vals_size); thrust::device_vector temp_def_vals(max_vals_size); thrust::device_vector rep_level(max_vals_size); thrust::device_vector def_level(max_vals_size); auto offset_transformer = offset_transform{}; auto transformed_empties = thrust::make_transform_iterator(empties.begin(), offset_transformer); auto input_parent_rep_it = thrust::make_constant_iterator(level); auto input_parent_def_it = thrust::make_transform_iterator(empties_idx.begin(), def_level_fn{}); auto input_parent_zip_it = thrust::make_zip_iterator(input_parent_rep_it, input_parent_def_it); auto input_child_zip_it = thrust::make_zip_iterator(temp_rep_vals.begin(), temp_def_vals.begin()); auto output_zip_it = thrust::make_zip_iterator(rep_level.begin(), def_level.begin()); thrust::merge_by_key( transformed_empties, transformed_empties + empties_size, thrust::make_counting_iterator(0), thrust::make_counting_iterator(curr_rep_values_size), input_parent_zip_it, input_child_zip_it, thrust::make_discard_iterator(), output_zip_it); thrust::device_vector reference_rep_level(max_vals_size); thrust::fill(reference_rep_level.begin(), reference_rep_level.begin() + empties_size, level); thrust::device_vector reference_def_level(max_vals_size); thrust::fill(reference_def_level.begin(), reference_def_level.begin() + empties_size, 13 + 10); ASSERT_EQ(reference_rep_level, rep_level); ASSERT_EQ(reference_def_level, def_level); } template __global__ THRUST_HIP_LAUNCH_BOUNDS_DEFAULT void MergeByKeyKernel(int const N, T* keys_A, T* keys_B, T* values_A, T* values_B, T* keys_result, T* values_result) { if (threadIdx.x == 0) { thrust::device_ptr keyA_begin(keys_A); thrust::device_ptr keyA_end(keys_A + N); thrust::device_ptr keyB_begin(keys_B); thrust::device_ptr keyB_end(keys_B + N); thrust::device_ptr valuesA_begin(values_A); thrust::device_ptr valuesB_begin(values_B); thrust::device_ptr keys_result_begin(keys_result); thrust::device_ptr values_result_begin(values_result); thrust::merge_by_key( thrust::hip::par, keyA_begin, keyA_end, keyB_begin, keyB_end, valuesA_begin, valuesB_begin, keys_result_begin, values_result_begin); } } TEST(MergeByKeyTests, TestMergeByKeyDevice) { using T = int; SCOPED_TRACE(testing::Message() << "with device_id= " << test::set_device_from_ctest()); for (auto size : get_sizes()) { SCOPED_TRACE(testing::Message() << "with size= " << size); for (auto seed : get_seeds()) { SCOPED_TRACE(testing::Message() << "with seed= " << seed); thrust::host_vector h_keys_a = get_random_data(size, get_default_limits::min(), get_default_limits::max(), seed); thrust::host_vector h_keys_b = get_random_data( size, get_default_limits::min(), get_default_limits::max(), seed + seed_value_addition); thrust::host_vector h_values_a = get_random_data(size, get_default_limits::min(), get_default_limits::max(), seed); thrust::host_vector h_values_b = get_random_data( size, get_default_limits::min(), get_default_limits::max(), seed + seed_value_addition); thrust::stable_sort(h_keys_a.begin(), h_keys_a.end(), thrust::greater()); thrust::stable_sort(h_keys_b.begin(), h_keys_b.end(), thrust::greater()); thrust::device_vector d_keys_a = h_keys_a; thrust::device_vector d_keys_b = h_keys_b; thrust::device_vector d_values_a = h_values_a; thrust::device_vector d_values_b = h_values_b; thrust::host_vector h_keys_result(h_keys_a.size() + h_keys_b.size()); thrust::device_vector d_keys_result(d_keys_a.size() + d_keys_b.size()); thrust::host_vector h_values_result(h_values_a.size() + h_values_b.size()); thrust::device_vector d_values_result(d_values_a.size() + d_values_b.size()); typename thrust::device_vector::iterator d_end; thrust::merge_by_key( h_keys_a.begin(), h_keys_a.end(), h_keys_b.begin(), h_keys_b.end(), h_values_a.begin(), h_values_b.begin(), h_keys_result.begin(), h_values_result.begin()); hipLaunchKernelGGL( MergeByKeyKernel, dim3(1, 1, 1), dim3(128, 1, 1), 0, 0, size, thrust::raw_pointer_cast(&d_keys_a[0]), thrust::raw_pointer_cast(&d_keys_b[0]), thrust::raw_pointer_cast(&d_values_a[0]), thrust::raw_pointer_cast(&d_values_b[0]), thrust::raw_pointer_cast(&d_keys_result[0]), thrust::raw_pointer_cast(&d_values_result[0])); HIP_CHECK(hipGetLastError()); ASSERT_EQ(h_keys_result, d_keys_result); ASSERT_EQ(h_values_result, d_values_result); } } }