diff options
Diffstat (limited to 'test')
-rw-r--r-- | test/correctness/routines/xtrmm.cc | 96 | ||||
-rw-r--r-- | test/performance/graphs/xtrmm.r | 127 | ||||
-rw-r--r-- | test/performance/routines/xtrmm.cc | 36 | ||||
-rw-r--r-- | test/routines/xtrmm.h | 127 |
4 files changed, 386 insertions, 0 deletions
diff --git a/test/correctness/routines/xtrmm.cc b/test/correctness/routines/xtrmm.cc new file mode 100644 index 00000000..943fb664 --- /dev/null +++ b/test/correctness/routines/xtrmm.cc @@ -0,0 +1,96 @@ + +// ================================================================================================= +// This file is part of the CLBlast project. The project is licensed under Apache Version 2.0. This +// project loosely follows the Google C++ styleguide and uses a tab-size of two spaces and a max- +// width of 100 characters per line. +// +// Author(s): +// Cedric Nugteren <www.cedricnugteren.nl> +// +// This file implements the tests for the Xtrmm routine. +// +// ================================================================================================= + +#include "correctness/testblas.h" +#include "routines/xtrmm.h" + +namespace clblast { +// ================================================================================================= + +// The correctness tester +template <typename T> +void RunTest(int argc, char *argv[], const bool silent, const std::string &name) { + + // Creates a tester + TestBlas<T> tester{argc, argv, silent, name, TestXtrmm<T>::GetOptions(), + TestXtrmm<T>::RunRoutine, TestXtrmm<T>::RunReference, + TestXtrmm<T>::DownloadResult, TestXtrmm<T>::GetResultIndex, + TestXtrmm<T>::ResultID1, TestXtrmm<T>::ResultID2}; + + // This variable holds the arguments relevant for this routine + auto args = Arguments<T>{}; + + // Loops over the test-cases from a data-layout point of view + for (auto &layout: tester.kLayouts) { args.layout = layout; + for (auto &side: tester.kSides) { args.side = side; + for (auto &triangle: tester.kTriangles) { args.triangle = triangle; + for (auto &a_transpose: tester.kTransposes) { args.a_transpose = a_transpose; + for (auto &diagonal: tester.kDiagonals) { args.diagonal = diagonal; + + // Creates the arguments vector for the regular tests + auto regular_test_vector = std::vector<Arguments<T>>{}; + for (auto &m: tester.kMatrixDims) { args.m = m; + for (auto &n: tester.kMatrixDims) { args.n = n; + for (auto &a_ld: tester.kMatrixDims) { args.a_ld = a_ld; + for (auto &a_offset: tester.kOffsets) { args.a_offset = a_offset; + for (auto &b_ld: tester.kMatrixDims) { args.b_ld = b_ld; + for (auto &b_offset: tester.kOffsets) { args.b_offset = b_offset; + for (auto &alpha: tester.kAlphaValues) { args.alpha = alpha; + args.a_size = TestXtrmm<T>::GetSizeA(args); + args.b_size = TestXtrmm<T>::GetSizeB(args); + if (args.a_size<1 || args.b_size<1) { continue; } + regular_test_vector.push_back(args); + } + } + } + } + } + } + } + + // Creates the arguments vector for the invalid-buffer tests + auto invalid_test_vector = std::vector<Arguments<T>>{}; + args.m = args.n = tester.kBufferSize; + args.a_ld = args.b_ld = tester.kBufferSize; + args.a_offset = args.b_offset = 0; + for (auto &a_size: tester.kMatSizes) { args.a_size = a_size; + for (auto &b_size: tester.kMatSizes) { args.b_size = b_size; + invalid_test_vector.push_back(args); + } + } + + // Runs the tests + const auto case_name = ToString(layout)+" "+ToString(side)+" "+ToString(triangle)+" "+ + ToString(a_transpose)+" "+ToString(diagonal); + tester.TestRegular(regular_test_vector, case_name); + tester.TestInvalid(invalid_test_vector, case_name); + } + } + } + } + } +} + +// ================================================================================================= +} // namespace clblast + +// Main function (not within the clblast namespace) +int main(int argc, char *argv[]) { + clblast::RunTest<float>(argc, argv, false, "STRMM"); + clblast::RunTest<double>(argc, argv, true, "DTRMM"); + clblast::RunTest<clblast::float2>(argc, argv, true, "CTRMM"); + clblast::RunTest<clblast::double2>(argc, argv, true, "ZTRMM"); + return 0; +} + +// ================================================================================================= diff --git a/test/performance/graphs/xtrmm.r b/test/performance/graphs/xtrmm.r new file mode 100644 index 00000000..4a3c2440 --- /dev/null +++ b/test/performance/graphs/xtrmm.r @@ -0,0 +1,127 @@ + +# ================================================================================================== +# This file is part of the CLBlast project. The project is licensed under Apache Version 2.0. This +# project uses a tab-size of two spaces and a max-width of 100 characters per line. +# +# Author(s): +# Cedric Nugteren <www.cedricnugteren.nl> +# +# This file implements the performance script for the Xtrmm routine +# +# ================================================================================================== + +# Includes the common functions +args <- commandArgs(trailingOnly = FALSE) +thisfile <- (normalizePath(sub("--file=", "", args[grep("--file=", args)]))) +source(file.path(dirname(thisfile), "common.r")) + +# ================================================================================================== + +# Settings +routine_name <- "xtrmm" +parameters <- c("-m","-n","-layout","-side","-triangle","-transA","-diagonal", + "-num_steps","-step","-runs","-precision") +precision <- 32 + +# Sets the names of the test-cases +test_names <- list( + "multiples of 128", + "multiples of 128 (+1)", + "around m=n=512", + "around m=n=2048", + "layouts and side/triangle (m=n=1024)", + "powers of 2" +) + +# Defines the test-cases +test_values <- list( + list(c(128, 128, 0, 0, 0, 0, 0, 16, 128, num_runs, precision)), + list(c(129, 129, 0, 0, 0, 0, 0, 16, 128, num_runs, precision)), + list(c(512, 512, 0, 0, 0, 0, 0, 16, 1, num_runs, precision)), + list(c(2048, 2048, 0, 0, 0, 0, 0, 16, 1, num_runs, precision)), + list( + c(1024, 1024, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 0, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 0, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 0, 1, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 1, 1, 1, 0, num_runs, precision), + + c(1024, 1024, 0, 1, 0, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 1, 0, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 1, 0, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 1, 0, 1, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 1, 1, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 1, 1, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 1, 1, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 1, 1, 1, 1, 1, 0, num_runs, precision), + + c(1024, 1024, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 0, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 0, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 0, 1, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 1, 1, 1, 1, 0, num_runs, precision), + + c(1024, 1024, 1, 1, 0, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 1, 1, 0, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 1, 1, 0, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 1, 1, 0, 1, 1, 1, 0, num_runs, precision), + c(1024, 1024, 1, 1, 1, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 1, 1, 1, 0, 1, 1, 0, num_runs, precision), + c(1024, 1024, 1, 1, 1, 1, 0, 1, 0, num_runs, precision), + c(1024, 1024, 1, 1, 1, 1, 1, 1, 0, num_runs, precision) + ), + list( + c(8, 8, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(16, 16, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(32, 32, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(64, 64, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(128, 128, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(256, 256, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(512, 512, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(1024, 1024, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(2048, 2048, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(4096, 4096, 0, 0, 0, 0, 0, 1, 0, num_runs, precision), + c(8192, 8192, 0, 0, 0, 0, 0, 1, 0, num_runs, precision) + ) +) + +# Defines the x-labels corresponding to the test-cases +test_xlabels <- list( + "matrix sizes (m=n)", + "matrix sizes (m=n)", + "matrix sizes (m=n)", + "matrix sizes (m=n)", + "layout (row/col), side (l/r), triangle (up/lo), transA (n/y), diag (u/nu)", + "matrix sizes (m=n)" +) + +# Defines the x-axis of the test-cases +test_xaxis <- list( + c("m", ""), + c("m", ""), + c("m", ""), + c("m", ""), + list(1:32, c("row,l,up,n,u", "row,l,up,n,nu", "row,l,up,y,u", "row,l,up,y,nu", + "row,r,up,n,u", "row,r,up,n,nu", "row,r,up,y,u", "row,r,up,y,nu", + "row,l,lo,n,u", "row,l,lo,n,nu", "row,l,lo,y,u", "row,l,lo,y,nu", + "row,r,lo,n,u", "row,r,lo,n,nu", "row,r,lo,y,u", "row,r,lo,y,nu", + "col,l,up,n,u", "col,l,up,n,nu", "col,l,up,y,u", "col,l,up,y,nu", + "col,r,up,n,u", "col,r,up,n,nu", "col,r,up,y,u", "col,r,up,y,nu", + "col,l,lo,n,u", "col,l,lo,n,nu", "col,l,lo,y,u", "col,l,lo,y,nu", + "col,r,lo,n,u", "col,r,lo,n,nu", "col,r,lo,y,u", "col,r,lo,y,nu")), + c("m", "x") +) + +# ================================================================================================== + +# Start the script +main(routine_name=routine_name, precision=precision, test_names=test_names, test_values=test_values, + test_xlabels=test_xlabels, test_xaxis=test_xaxis, metric_gflops=TRUE) + +# ==================================================================================================
\ No newline at end of file diff --git a/test/performance/routines/xtrmm.cc b/test/performance/routines/xtrmm.cc new file mode 100644 index 00000000..91dcbd07 --- /dev/null +++ b/test/performance/routines/xtrmm.cc @@ -0,0 +1,36 @@ + +// ================================================================================================= +// This file is part of the CLBlast project. The project is licensed under Apache Version 2.0. This +// project loosely follows the Google C++ styleguide and uses a tab-size of two spaces and a max- +// width of 100 characters per line. +// +// Author(s): +// Cedric Nugteren <www.cedricnugteren.nl> +// +// This file implements the Xtrmm command-line interface performance tester. +// +// ================================================================================================= + +#include "performance/client.h" +#include "routines/xtrmm.h" + +// ================================================================================================= + +// Main function (not within the clblast namespace) +int main(int argc, char *argv[]) { + switch(clblast::GetPrecision(argc, argv)) { + case clblast::Precision::kHalf: + throw std::runtime_error("Unsupported precision mode"); + case clblast::Precision::kSingle: + clblast::RunClient<clblast::TestXtrmm<float>, float>(argc, argv); break; + case clblast::Precision::kDouble: + clblast::RunClient<clblast::TestXtrmm<double>, double>(argc, argv); break; + case clblast::Precision::kComplexSingle: + clblast::RunClient<clblast::TestXtrmm<clblast::float2>, clblast::float2>(argc, argv); break; + case clblast::Precision::kComplexDouble: + clblast::RunClient<clblast::TestXtrmm<clblast::double2>, clblast::double2>(argc, argv); break; + } + return 0; +} + +// ================================================================================================= diff --git a/test/routines/xtrmm.h b/test/routines/xtrmm.h new file mode 100644 index 00000000..7b7e7af1 --- /dev/null +++ b/test/routines/xtrmm.h @@ -0,0 +1,127 @@ + +// ================================================================================================= +// This file is part of the CLBlast project. The project is licensed under Apache Version 2.0. This +// project loosely follows the Google C++ styleguide and uses a tab-size of two spaces and a max- +// width of 100 characters per line. +// +// Author(s): +// Cedric Nugteren <www.cedricnugteren.nl> +// +// This file implements a class with static methods to describe the Xtrmm routine. Examples of +// such 'descriptions' are how to calculate the size a of buffer or how to run the routine. These +// static methods are used by the correctness tester and the performance tester. +// +// ================================================================================================= + +#ifndef CLBLAST_TEST_ROUTINES_XTRMM_H_ +#define CLBLAST_TEST_ROUTINES_XTRMM_H_ + +#include <vector> +#include <string> + +#include "wrapper_clblas.h" + +namespace clblast { +// ================================================================================================= + +// See comment at top of file for a description of the class +template <typename T> +class TestXtrmm { + public: + + // The list of arguments relevant for this routine + static std::vector<std::string> GetOptions() { + return {kArgM, kArgN, + kArgLayout, kArgSide, kArgTriangle, kArgATransp, kArgDiagonal, + kArgALeadDim, kArgBLeadDim, + kArgAOffset, kArgBOffset, + kArgAlpha}; + } + + // Describes how to obtain the sizes of the buffers + static size_t GetSizeA(const Arguments<T> &args) { + auto k = (args.side == Side::kLeft) ? args.m : args.n; + return k * args.a_ld + args.a_offset; + } + static size_t GetSizeB(const Arguments<T> &args) { + auto b_rotated = (args.layout == Layout::kRowMajor); + auto b_two = (b_rotated) ? args.m : args.n; + return b_two * args.b_ld + args.b_offset; + } + + // Describes how to set the sizes of all the buffers + static void SetSizes(Arguments<T> &args) { + args.a_size = GetSizeA(args); + args.b_size = GetSizeB(args); + } + + // Describes what the default values of the leading dimensions of the matrices are + static size_t DefaultLDA(const Arguments<T> &args) { return args.m; } + static size_t DefaultLDB(const Arguments<T> &args) { return args.n; } + static size_t DefaultLDC(const Arguments<T> &) { return 1; } // N/A for this routine + + // Describes how to run the CLBlast routine + static StatusCode RunRoutine(const Arguments<T> &args, const Buffers &buffers, + CommandQueue &queue) { + auto queue_plain = queue(); + auto event = cl_event{}; + auto status = Trmm(args.layout, args.side, args.triangle, args.a_transpose, args.diagonal, + args.m, args.n, args.alpha, + buffers.a_mat(), args.a_offset, args.a_ld, + buffers.b_mat(), args.b_offset, args.b_ld, + &queue_plain, &event); + clWaitForEvents(1, &event); + return status; + } + + // Describes how to run the clBLAS routine (for correctness/performance comparison) + static StatusCode RunReference(const Arguments<T> &args, const Buffers &buffers, + CommandQueue &queue) { + auto queue_plain = queue(); + auto event = cl_event{}; + auto status = clblasXtrmm(static_cast<clblasOrder>(args.layout), + static_cast<clblasSide>(args.side), + static_cast<clblasUplo>(args.triangle), + static_cast<clblasTranspose>(args.a_transpose), + static_cast<clblasDiag>(args.diagonal), + args.m, args.n, args.alpha, + buffers.a_mat(), args.a_offset, args.a_ld, + buffers.b_mat(), args.b_offset, args.b_ld, + 1, &queue_plain, 0, nullptr, &event); + clWaitForEvents(1, &event); + return static_cast<StatusCode>(status); + } + + // Describes how to download the results of the computation (more importantly: which buffer) + static std::vector<T> DownloadResult(const Arguments<T> &args, Buffers &buffers, + CommandQueue &queue) { + std::vector<T> result(args.b_size, static_cast<T>(0)); + buffers.b_mat.ReadBuffer(queue, args.b_size*sizeof(T), result); + return result; + } + + // Describes how to compute the indices of the result buffer + static size_t ResultID1(const Arguments<T> &args) { return args.m; } + static size_t ResultID2(const Arguments<T> &args) { return args.n; } + static size_t GetResultIndex(const Arguments<T> &args, const size_t id1, const size_t id2) { + return (args.layout == Layout::kRowMajor) ? + id1*args.b_ld + id2 + args.b_offset: + id2*args.b_ld + id1 + args.b_offset; + } + + // Describes how to compute performance metrics + static size_t GetFlops(const Arguments<T> &args) { + auto k = (args.side == Side::kLeft) ? args.m : args.n; + return args.m * args.n * k; + } + static size_t GetBytes(const Arguments<T> &args) { + auto k = (args.side == Side::kLeft) ? args.m : args.n; + return (k*k + 2*args.m*args.n) * sizeof(T); + } +}; + +// ================================================================================================= +} // namespace clblast + +// CLBLAST_TEST_ROUTINES_XTRMM_H_ +#endif |