mirror of
https://github.com/amd/blis.git
synced 2026-05-13 18:52:14 +00:00
Merged contributions from AMD's AOCL BLIS (#448). Details: - Added support for level-3 operation gemmt, which performs a gemm on only the lower or upper triangle of a square matrix C. For now, only the conventional/large code path will be supported (in vanilla BLIS). This was accomplished by leveraging the existing variant logic for herk. However, some of the infrastructure to support a gemmtsup is included in this commit, including - A bli_gemmtsup() front-end, similar to bli_gemmsup(). - A bli_gemmtsup_ref() reference handler function. - A bli_gemmtsup_int() variant chooser function (with variant calls commented out). - Added support for inducing complex domain gemmt via the 1m method. - Added gemmt APIs to the BLAS and CBLAS compatiblity layers. - Added gemmt test module to testsuite. - Added standalone gemmt test driver to 'test' directory. - Documented gemmt APIs in BLISObjectAPI.md and BLISTypedAPI.md. - Added a C++ template header (blis.hh) containing a BLAS-inspired wrapper to a set of polymorphic CBLAS-like function wrappers defined in another header (cblas.hh). These two headers are installed if running the 'install' target with INSTALL_HH is set to 'yes'. (Also added a set of unit tests that exercise blis.hh, although they are disabled for now because they aren't compatible with out-of-tree builds.) These files now live in the 'vendor' top-level directory. - Various updates to 'zen' and 'zen2' subconfigurations, particularly within the context initialization functions. - Added s and d copyv, setv, and swapv kernels to kernels/zen/1, and various minor updates to dotv and scalv kernels. Also added various sup kernels contributed by AMD to kernels/zen/3. However, these kernels are (for now) not yet used, in part because they caused AppVeyor clang failures, and also because I have not found time to review and vet them. - Output the python found during configure into the definition of PYTHON in build/config.mk (via build/config.mk.in). - Added early-return checks (A, B, or C with zero dimension; alpha = 0) to bli_gemm_front.c. - Implemented explicit beta = 0 handling in for the sgemm ukernel in bli_gemm_armv7a_int_d4x4.c, which was previously missing. This latent bug surfaced because the gemmt module verifies its computation using gemm with its beta parameter set to zero, which, on a cortexa15 system caused the gemm kernel code to unconditionally multiply the uninitialized C data by beta. The C matrix likely contained non-numeric values such as NaN, which then would have resulted in a false failure. - Fixed a bug whereby the implementation for bli_herk_determine_kc(), in bli_l3_blocksize.c, was inadvertantly being defined in terms of helper functions meant for trmm. This bug was probably harmless since the trmm code should have also done the right thing for herk. - Used cpp macros to neutralize the various AOCL_DTL_TRACE_ macros in kernels/zen/3/bli_gemm_small.c since those macros are not used in vanilla BLIS. - Added cpp guard to definition of bli_mem_clear() in bli_mem.h to accommodate C++'s stricter type checking. - Added cpp guard to test/*.c drivers that facilitate compilation on Windows systems. - Various whitespace changes.
235 lines
6.2 KiB
C
235 lines
6.2 KiB
C
/*
|
|
|
|
BLIS
|
|
An object-based framework for developing high-performance BLAS-like
|
|
libraries.
|
|
|
|
Copyright (C) 2014, The University of Texas at Austin
|
|
Copyright (C) 2020, Advanced Micro Devices, Inc.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are
|
|
met:
|
|
- Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
- Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in the
|
|
documentation and/or other materials provided with the distribution.
|
|
- Neither the name(s) of the copyright holder(s) nor the names of its
|
|
contributors may be used to endorse or promote products derived
|
|
from this software without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*/
|
|
|
|
#include "blis.h"
|
|
|
|
|
|
//
|
|
// Define BLAS-to-BLIS interfaces.
|
|
//
|
|
|
|
#ifdef BLIS_BLAS3_CALLS_TAPI
|
|
|
|
#undef GENTFUNC
|
|
#define GENTFUNC( ftype, ch, blasname, blisname ) \
|
|
\
|
|
void PASTEF77(ch,blasname) \
|
|
( \
|
|
const f77_char* uploc, \
|
|
const f77_char* transa, \
|
|
const f77_char* transb, \
|
|
const f77_int* m, \
|
|
const f77_int* k, \
|
|
const ftype* alpha, \
|
|
const ftype* a, const f77_int* lda, \
|
|
const ftype* b, const f77_int* ldb, \
|
|
const ftype* beta, \
|
|
ftype* c, const f77_int* ldc \
|
|
) \
|
|
{ \
|
|
uplo_t blis_uploc; \
|
|
trans_t blis_transa; \
|
|
trans_t blis_transb; \
|
|
dim_t m0, k0; \
|
|
inc_t rs_a, cs_a; \
|
|
inc_t rs_b, cs_b; \
|
|
inc_t rs_c, cs_c; \
|
|
\
|
|
/* Initialize BLIS. */ \
|
|
bli_init_auto(); \
|
|
\
|
|
/* Perform BLAS parameter checking. */ \
|
|
PASTEBLACHK(blasname) \
|
|
( \
|
|
MKSTR(ch), \
|
|
MKSTR(blasname), \
|
|
uploc, \
|
|
transa, \
|
|
transb, \
|
|
m, \
|
|
k, \
|
|
lda, \
|
|
ldb, \
|
|
ldc \
|
|
); \
|
|
\
|
|
/* Map BLAS chars to their corresponding BLIS enumerated type value. */ \
|
|
bli_param_map_netlib_to_blis_uplo( *uploc, &blis_uploc ); \
|
|
bli_param_map_netlib_to_blis_trans( *transa, &blis_transa ); \
|
|
bli_param_map_netlib_to_blis_trans( *transb, &blis_transb ); \
|
|
\
|
|
/* Typecast BLAS integers to BLIS integers. */ \
|
|
bli_convert_blas_dim1( *m, m0 ); \
|
|
bli_convert_blas_dim1( *k, k0 ); \
|
|
\
|
|
/* Set the row and column strides of the matrix operands. */ \
|
|
rs_a = 1; \
|
|
cs_a = *lda; \
|
|
rs_b = 1; \
|
|
cs_b = *ldb; \
|
|
rs_c = 1; \
|
|
cs_c = *ldc; \
|
|
\
|
|
/* Call BLIS interface. */ \
|
|
PASTEMAC2(ch,blisname,BLIS_TAPI_EX_SUF) \
|
|
( \
|
|
blis_uploc, \
|
|
blis_transa, \
|
|
blis_transb, \
|
|
m0, \
|
|
k0, \
|
|
(ftype*)alpha, \
|
|
(ftype*)a, rs_a, cs_a, \
|
|
(ftype*)b, rs_b, cs_b, \
|
|
(ftype*)beta, \
|
|
(ftype*)c, rs_c, cs_c, \
|
|
NULL, \
|
|
NULL \
|
|
); \
|
|
\
|
|
/* Finalize BLIS. */ \
|
|
bli_finalize_auto(); \
|
|
}
|
|
|
|
#else
|
|
|
|
#undef GENTFUNC
|
|
#define GENTFUNC( ftype, ch, blasname, blisname ) \
|
|
\
|
|
void PASTEF77(ch,blasname) \
|
|
( \
|
|
const f77_char* uploc, \
|
|
const f77_char* transa, \
|
|
const f77_char* transb, \
|
|
const f77_int* m, \
|
|
const f77_int* k, \
|
|
const ftype* alpha, \
|
|
const ftype* a, const f77_int* lda, \
|
|
const ftype* b, const f77_int* ldb, \
|
|
const ftype* beta, \
|
|
ftype* c, const f77_int* ldc \
|
|
) \
|
|
{ \
|
|
uplo_t blis_uploc; \
|
|
trans_t blis_transa; \
|
|
trans_t blis_transb; \
|
|
dim_t m0, k0; \
|
|
\
|
|
/* Initialize BLIS. */ \
|
|
bli_init_auto(); \
|
|
\
|
|
/* Perform BLAS parameter checking. */ \
|
|
PASTEBLACHK(blasname) \
|
|
( \
|
|
MKSTR(ch), \
|
|
MKSTR(blasname), \
|
|
uploc, \
|
|
transa, \
|
|
transb, \
|
|
m, \
|
|
k, \
|
|
lda, \
|
|
ldb, \
|
|
ldc \
|
|
); \
|
|
\
|
|
/* Map BLAS chars to their corresponding BLIS enumerated type value. */ \
|
|
bli_param_map_netlib_to_blis_uplo( *uploc, &blis_uploc ); \
|
|
bli_param_map_netlib_to_blis_trans( *transa, &blis_transa ); \
|
|
bli_param_map_netlib_to_blis_trans( *transb, &blis_transb ); \
|
|
\
|
|
/* Typecast BLAS integers to BLIS integers. */ \
|
|
bli_convert_blas_dim1( *m, m0 ); \
|
|
bli_convert_blas_dim1( *k, k0 ); \
|
|
\
|
|
/* Set the row and column strides of the matrix operands. */ \
|
|
const inc_t rs_a = 1; \
|
|
const inc_t cs_a = *lda; \
|
|
const inc_t rs_b = 1; \
|
|
const inc_t cs_b = *ldb; \
|
|
const inc_t rs_c = 1; \
|
|
const inc_t cs_c = *ldc; \
|
|
\
|
|
const num_t dt = PASTEMAC(ch,type); \
|
|
\
|
|
const struc_t strucc = BLIS_SYMMETRIC; \
|
|
\
|
|
obj_t alphao = BLIS_OBJECT_INITIALIZER_1X1; \
|
|
obj_t ao = BLIS_OBJECT_INITIALIZER; \
|
|
obj_t bo = BLIS_OBJECT_INITIALIZER; \
|
|
obj_t betao = BLIS_OBJECT_INITIALIZER_1X1; \
|
|
obj_t co = BLIS_OBJECT_INITIALIZER; \
|
|
\
|
|
dim_t m0_a, n0_a; \
|
|
dim_t m0_b, n0_b; \
|
|
\
|
|
bli_set_dims_with_trans( blis_transa, m0, k0, &m0_a, &n0_a ); \
|
|
bli_set_dims_with_trans( blis_transb, k0, m0, &m0_b, &n0_b ); \
|
|
\
|
|
bli_obj_init_finish_1x1( dt, (ftype*)alpha, &alphao ); \
|
|
bli_obj_init_finish_1x1( dt, (ftype*)beta, &betao ); \
|
|
\
|
|
bli_obj_init_finish( dt, m0_a, n0_a, (ftype*)a, rs_a, cs_a, &ao ); \
|
|
bli_obj_init_finish( dt, m0_b, n0_b, (ftype*)b, rs_b, cs_b, &bo ); \
|
|
bli_obj_init_finish( dt, m0, m0, (ftype*)c, rs_c, cs_c, &co ); \
|
|
\
|
|
bli_obj_set_uplo( blis_uploc, &co ); \
|
|
bli_obj_set_conjtrans( blis_transa, &ao ); \
|
|
bli_obj_set_conjtrans( blis_transb, &bo ); \
|
|
\
|
|
bli_obj_set_struc( strucc, &co ); \
|
|
\
|
|
PASTEMAC(blisname,BLIS_OAPI_EX_SUF) \
|
|
( \
|
|
&alphao, \
|
|
&ao, \
|
|
&bo, \
|
|
&betao, \
|
|
&co, \
|
|
NULL, \
|
|
NULL \
|
|
); \
|
|
\
|
|
/* Finalize BLIS. */ \
|
|
bli_finalize_auto(); \
|
|
}
|
|
|
|
#endif
|
|
|
|
#ifdef BLIS_ENABLE_BLAS
|
|
INSERT_GENTFUNC_BLAS( gemmt, gemmt )
|
|
#endif
|
|
|