// Copyright (c) 2025-2026 Advanced Micro Devices, Inc. All rights reserved. // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. #ifndef ROCRAND_TEST_INTERNAL_TEST_ROCRAND_HOST_PRNG_HPP_ #define ROCRAND_TEST_INTERNAL_TEST_ROCRAND_HOST_PRNG_HPP_ #include "test_common.hpp" #include "test_rocrand_common.hpp" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include // // General generator host API tests // template struct generator_prng_host_tests : public testing::Test { using generator_t = typename Params::generator_t; static inline constexpr rocrand_ordering ordering = Params::ordering; auto get_generator() const { generator_t g; if(g.set_order(ordering) != ROCRAND_STATUS_SUCCESS) { throw std::runtime_error("Could not set ordering for generator"); } return g; } }; template struct generator_prng_host_tests_params { using generator_t = Generator; static inline constexpr rocrand_ordering ordering = Ordering; }; TYPED_TEST_SUITE_P(generator_prng_host_tests); TYPED_TEST_P(generator_prng_host_tests, init_test) { auto g = TestFixture::get_generator(); // offset = 0 ROCRAND_CHECK(g.init()); HIP_CHECK(hipDeviceSynchronize()); g.set_offset(1); ROCRAND_CHECK(g.init()); HIP_CHECK(hipDeviceSynchronize()); g.set_offset(1337); ROCRAND_CHECK(g.init()); HIP_CHECK(hipDeviceSynchronize()); g.set_offset(1048576); ROCRAND_CHECK(g.init()); HIP_CHECK(hipDeviceSynchronize()); g.set_offset(1 << 24); ROCRAND_CHECK(g.init()); HIP_CHECK(hipDeviceSynchronize()); g.set_offset(1 << 28); ROCRAND_CHECK(g.init()); HIP_CHECK(hipDeviceSynchronize()); g.set_offset((1ULL << 36) + 1234567ULL); ROCRAND_CHECK(g.init()); HIP_CHECK(hipDeviceSynchronize()); } TYPED_TEST_P(generator_prng_host_tests, uniform_uint_test) { const size_t size = 1313; unsigned int* data = new unsigned int[size]; auto g = TestFixture::get_generator(); ROCRAND_CHECK(g.generate_uniform(data, size)); HIP_CHECK(hipDeviceSynchronize()); double mean = std::accumulate(data, data + size, 0.0) / (double)size; double maxi = std::numeric_limits::max(); ASSERT_NEAR(mean, maxi / 2, maxi / 20); delete[] data; } template void uniform_floating_point_host_test(rocrand_ordering ordering) { const size_t size = 1313; T* data = new T[size]; Generator g; g.set_order(ordering); ROCRAND_CHECK(g.generate_uniform(data, size)); HIP_CHECK(hipDeviceSynchronize()); double mean = std::accumulate(data, data + size, 0.0) / (double)size; ASSERT_NEAR(mean, 0.5, 0.05); delete[] data; } TYPED_TEST_P(generator_prng_host_tests, uniform_float_test) { using generator_t = typename TestFixture::generator_t; constexpr rocrand_ordering ordering = TestFixture::ordering; uniform_floating_point_host_test(ordering); } TYPED_TEST_P(generator_prng_host_tests, uniform_double_test) { using generator_t = typename TestFixture::generator_t; constexpr rocrand_ordering ordering = TestFixture::ordering; uniform_floating_point_host_test(ordering); } template void normal_floating_point_host_test(rocrand_ordering ordering) { const size_t size = 1313; T* data = new T[size]; Generator g; g.set_order(ordering); ROCRAND_CHECK(g.generate_normal(data, size, static_cast(2.0), static_cast(5.0))); HIP_CHECK(hipDeviceSynchronize()); double mean = std::accumulate(data, data + size, 0.0) / (double)size; double stddev = std::sqrt(std::accumulate(data, data + size, 0.0, [mean](double acc, double x) { return acc + std::pow((x - mean), 2); }) / size); EXPECT_NEAR(2.0, mean, 0.4); // 20% EXPECT_NEAR(5.0, stddev, 1.0); // 20% delete[] data; } TYPED_TEST_P(generator_prng_host_tests, normal_float_test) { using generator_t = typename TestFixture::generator_t; constexpr rocrand_ordering ordering = TestFixture::ordering; normal_floating_point_host_test(ordering); } TYPED_TEST_P(generator_prng_host_tests, normal_double_test) { using generator_t = typename TestFixture::generator_t; constexpr rocrand_ordering ordering = TestFixture::ordering; normal_floating_point_host_test(ordering); } template void log_normal_floating_point_host_test(rocrand_ordering ordering) { const size_t size = 131313; T* data = new T[size]; T normal_mean = static_cast(3.0); T normal_stddev = static_cast(1.5); T normal_var = normal_stddev * normal_stddev; T log_normal_mean = std::exp(normal_mean + normal_var / 2.0); T log_normal_stddev = std::sqrt(std::exp(normal_var) - 1.0) * log_normal_mean; Generator g; g.set_order(ordering); ROCRAND_CHECK(g.generate_log_normal(data, size, normal_mean, normal_stddev)); HIP_CHECK(hipDeviceSynchronize()); double mean = std::accumulate(data, data + size, 0.0) / (double)size; double stddev = std::sqrt(std::accumulate(data, data + size, 0.0, [mean](double acc, double x) { return acc + std::pow((x - mean), 2); }) / size); EXPECT_NEAR(log_normal_mean, mean, log_normal_mean * 0.2); // 20% EXPECT_NEAR(log_normal_stddev, stddev, log_normal_stddev * 0.2); // 20% delete[] data; } TYPED_TEST_P(generator_prng_host_tests, log_normal_float_test) { using generator_t = typename TestFixture::generator_t; constexpr rocrand_ordering ordering = TestFixture::ordering; log_normal_floating_point_host_test(ordering); } TYPED_TEST_P(generator_prng_host_tests, log_normal_double_test) { using generator_t = typename TestFixture::generator_t; constexpr rocrand_ordering ordering = TestFixture::ordering; log_normal_floating_point_host_test(ordering); } TYPED_TEST_P(generator_prng_host_tests, poisson_test) { const size_t size = 1313; unsigned int* data = new unsigned int[size]; auto g = TestFixture::get_generator(); ROCRAND_CHECK(g.generate_poisson(data, size, 5.5)); HIP_CHECK(hipDeviceSynchronize()); double mean = std::accumulate(data, data + size, 0.0) / (double)size; double var = std::accumulate(data, data + size, 0.0, [mean](double acc, double x) { return acc + std::pow(x - mean, 2); }) / size; EXPECT_NEAR(mean, 5.5, std::max(1.0, 5.5 * 1e-2)); EXPECT_NEAR(var, 5.5, std::max(1.0, 5.5 * 1e-2)); delete[] data; } // Check if the numbers generated by first generate() call are different from // the numbers generated by the 2nd call (same generator) TYPED_TEST_P(generator_prng_host_tests, state_progress_test) { // Device data const size_t size = 1025; unsigned int* data1 = new unsigned int[size]; // Generator auto g0 = TestFixture::get_generator(); // Generate using g0 and copy to host ROCRAND_CHECK(g0.generate(data1, size)); unsigned int* data2 = new unsigned int[size]; ROCRAND_CHECK(g0.generate(data2, size)); HIP_CHECK(hipDeviceSynchronize()); size_t same = 0; for(size_t i = 0; i < size; i++) { if(data1[i] == data2[i]) same++; } // It may happen that numbers are the same, so we // just make sure that most of them are different. EXPECT_LT(same, static_cast(0.01f * size)); delete[] data1; delete[] data2; } // Checks if generators with the same seed and in the same state // generate the same numbers TYPED_TEST_P(generator_prng_host_tests, same_seed_test) { const unsigned long long seed = 0xdeadbeefdeadbeefULL; // Device side data const size_t size = 1024; unsigned int* data1 = new unsigned int[size]; unsigned int* data2 = new unsigned int[size]; // Generators auto g0 = TestFixture::get_generator(), g1 = TestFixture::get_generator(); // Set same seeds g0.set_seed(seed); g1.set_seed(seed); ROCRAND_CHECK(g0.generate(data1, size)); HIP_CHECK(hipDeviceSynchronize()); ROCRAND_CHECK(g1.generate(data2, size)); HIP_CHECK(hipDeviceSynchronize()); for(size_t i = 0; i < size; i++) { ASSERT_EQ(data1[i], data2[i]); } delete[] data1; delete[] data2; } template void different_seed_host_impl(rocrand_ordering ordering, const unsigned long long seed0, const unsigned long long seed1) { // Device side data const size_t size = 1024; unsigned int* data1 = new unsigned int[size]; unsigned int* data2 = new unsigned int[size]; // Generators Generator g0, g1; g0.set_order(ordering); g1.set_order(ordering); // Set different seeds g0.set_seed(seed0); g1.set_seed(seed1); ASSERT_NE(g0.get_seed(), g1.get_seed()); // Generate using g0 and copy to host ROCRAND_CHECK(g0.generate(data1, size)); HIP_CHECK(hipDeviceSynchronize()); // Generate using g1 and copy to host ROCRAND_CHECK(g1.generate(data2, size)); HIP_CHECK(hipDeviceSynchronize()); size_t same = 0; for(size_t i = 0; i < size; i++) { if(data1[i] == data2[i]) same++; } // It may happen that numbers are the same, so we // just make sure that most of them are different. EXPECT_LT(same, static_cast(0.01f * size)); delete[] data1; delete[] data2; } template void different_seed_host(rocrand_ordering ordering) { different_seed_host_impl(ordering, Seed0, Seed1); } // mtgp32 uses a different seed template<> void different_seed_host>(rocrand_ordering ordering) { different_seed_host_impl>(ordering, 5ULL, 10ULL); } // mt19937 uses a different seed template<> void different_seed_host>( rocrand_ordering ordering) { different_seed_host_impl>(ordering, 5ULL, 10ULL); } // lsfr113 uses it's particular implementation template<> void different_seed_host>( rocrand_ordering /*ordering*/) { GTEST_SKIP() << "LFSR113 runs a custom implementation of different_seed_host test!"; } TYPED_TEST_P(generator_prng_host_tests, different_seed_test) { using generator_t = typename TestFixture::generator_t; constexpr rocrand_ordering ordering = TestFixture::ordering; different_seed_host(ordering); } // Generator host API continuity tests // // Check that subsequent generations of different sizes produce one // sequence without gaps, no matter how many values are generated per call. // template struct generator_prng_continuity_host_tests : public testing::Test { using generator_t = typename Params::generator_t; static inline constexpr rocrand_ordering ordering = Params::ordering; }; TYPED_TEST_SUITE_P(generator_prng_continuity_host_tests); template< typename T, typename Generator, typename GenerateFunc, std::enable_if_t>, bool> = false> void continuity_host_test(GenerateFunc generate_func, rocrand_ordering ordering, unsigned int divisor = 1) { std::vector sizes0({100, 1, 24783, 3, 2, 776543, 1048576}); std::vector sizes1({1024, 55, 65536, 623456, 30, 1048576, 111331}); if(divisor > 1) { for(size_t& s : sizes0) s = (s + divisor - 1) & ~static_cast(divisor - 1); for(size_t& s : sizes1) s = (s + divisor - 1) & ~static_cast(divisor - 1); } const size_t size0 = std::accumulate(sizes0.cbegin(), sizes0.cend(), std::size_t{0}); const size_t size1 = std::accumulate(sizes1.cbegin(), sizes1.cend(), std::size_t{0}); T* data0 = new T[size0]; T* data1 = new T[size1]; std::vector out_data0; std::vector out_data1; Generator g0; g0.set_order(ordering); Generator g1; g1.set_order(ordering); for(size_t s : sizes0) { generate_func(g0, data0, s); HIP_CHECK(hipDeviceSynchronize()); std::copy(data0, data0 + s, std::back_inserter(out_data0)); } for(size_t s : sizes1) { generate_func(g1, data1, s); HIP_CHECK(hipDeviceSynchronize()); std::copy(data1, data1 + s, std::back_inserter(out_data1)); } for(size_t i = 0; i < std::min(size0, size1); i++) { ASSERT_EQ(out_data0[i], out_data1[i]); } delete[] data0; delete[] data1; } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_uniform_uint_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef unsigned int output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_uniform(data, s); }, ordering, rocrand_impl::host::uniform_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_uniform_char_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef unsigned char output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_uniform(data, s); }, ordering, rocrand_impl::host::uniform_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_uniform_float_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef float output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_uniform(data, s); }, ordering, rocrand_impl::host::uniform_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_uniform_double_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef double output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_uniform(data, s); }, ordering, rocrand_impl::host::uniform_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_normal_float_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef float output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_normal(data, s, 0.0f, 1.0f); }, ordering, rocrand_impl::host::normal_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_normal_double_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef double output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_normal(data, s, 0.0, 1.0); }, ordering, rocrand_impl::host::normal_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_log_normal_float_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef float output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_log_normal(data, s, 0.0f, 1.0f); }, ordering, rocrand_impl::host::normal_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_log_normal_double_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef double output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_log_normal(data, s, 0.0, 1.0); }, ordering, rocrand_impl::host::normal_distribution::output_width); } TYPED_TEST_P(generator_prng_continuity_host_tests, continuity_poisson_test) { constexpr rocrand_ordering ordering = TestFixture::ordering; using generator_t = typename TestFixture::generator_t; typedef unsigned int output_t; continuity_host_test( [](generator_t& g, output_t* data, size_t s) { g.generate_poisson(data, s, 100.0); }, ordering, rocrand_impl::host::poisson_distribution<>::output_width); } template struct generator_prng_offset_host_tests : public ::testing::Test { using output_t = typename Params::output_t; using generator_t = typename Params::generator_t; static inline constexpr rocrand_ordering ordering = Params::ordering; auto get_generator() const { generator_t g; if(g.set_order(ordering) != ROCRAND_STATUS_SUCCESS) { throw std::runtime_error("Could not set ordering for generator"); } return g; } }; // // Generator host API offset tests // template struct generator_prng_offset_host_tests_params { using output_t = Output; using generator_t = Generator; static constexpr rocrand_ordering ordering = Ordering; }; TYPED_TEST_SUITE_P(generator_prng_offset_host_tests); TYPED_TEST_P(generator_prng_offset_host_tests, offsets_test) { using output_t = typename TestFixture::output_t; const size_t size = 131313; constexpr size_t offsets[] = {0, 1, 4, 11, 65536, 112233}; for(const auto offset : offsets) { SCOPED_TRACE(::testing::Message() << "with offset=" << offset); const size_t size0 = size; const size_t size1 = (size + offset); output_t* data0 = new output_t[size0]; output_t* data1 = new output_t[size1]; auto g0 = TestFixture::get_generator(); g0.set_offset(offset); g0.generate(data0, size0); HIP_CHECK(hipDeviceSynchronize()); auto g1 = TestFixture::get_generator(); g1.generate(data1, size1); HIP_CHECK(hipDeviceSynchronize()); for(size_t i = 0; i < size; ++i) { ASSERT_EQ(data0[i], data1[i + offset]); } delete[] data0; delete[] data1; } } REGISTER_TYPED_TEST_SUITE_P(generator_prng_host_tests, init_test, uniform_uint_test, uniform_float_test, uniform_double_test, normal_float_test, normal_double_test, log_normal_float_test, log_normal_double_test, poisson_test, state_progress_test, same_seed_test, different_seed_test); REGISTER_TYPED_TEST_SUITE_P(generator_prng_continuity_host_tests, continuity_uniform_uint_test, continuity_uniform_char_test, continuity_uniform_float_test, continuity_uniform_double_test, continuity_normal_float_test, continuity_normal_double_test, continuity_log_normal_float_test, continuity_log_normal_double_test, continuity_poisson_test); GTEST_ALLOW_UNINSTANTIATED_PARAMETERIZED_TEST(generator_prng_host_tests); GTEST_ALLOW_UNINSTANTIATED_PARAMETERIZED_TEST(generator_prng_continuity_host_tests); REGISTER_TYPED_TEST_SUITE_P(generator_prng_offset_host_tests, offsets_test); GTEST_ALLOW_UNINSTANTIATED_PARAMETERIZED_TEST(generator_prng_offset_host_tests); #endif // ROCRAND_TEST_INTERNAL_TEST_ROCRAND_HOST_PRNG_HPP_