mirror of
https://github.com/amd/blis.git
synced 2026-04-20 15:48:50 +00:00
fde5f1fdec
Details:
- Standard names for reference kernels (levels-1v, -1f and 3) are now
macro constants. Examples:
BLIS_SAXPYV_KERNEL_REF
BLIS_DDOTXF_KERNEL_REF
BLIS_ZGEMM_UKERNEL_REF
- Developers no longer have to name all datatype instances of a kernel
with a common base name; [sdcz] datatype flavors of each kernel or
micro-kernel (level-1v, -1f, or 3) may now be named independently.
This means you can now, if you wish, encode the datatype-specific
register blocksizes in the name of the micro-kernel functions.
- Any datatype instances of any kernel (1v, 1f, or 3) that is left
undefined in bli_kernel.h will default to the corresponding reference
implementation. For example, if BLIS_DGEMM_UKERNEL is left undefined,
it will be defined to be BLIS_DGEMM_UKERNEL_REF.
- Developers no longer need to name level-1v/-1f kernels with multiple
datatype chars to match the number of types the kernel WOULD take in
a mixed type environment, as in bli_dddaxpyv_opt(). Now, one char is
sufficient, as in bli_daxpyv_opt().
- There is no longer a need to define an obj_t wrapper to go along with
your level-1v/-1f kernels. The framework now prvides a _kernel()
function which serves as the obj_t wrapper for whatever kernels are
specified (or defaulted to) via bli_kernel.h
- Developers no longer need to prototype their kernels, and thus no
longer need to include any prototyping headers from within
bli_kernel.h. The framework now generates kernel prototypes, with the
proper type signature, based on the kernel names defined (or defaulted
to) via bli_kernel.h.
- If the complex datatype x (of [cz]) implementation of the gemm micro-
kernel is left undefined by bli_kernel.h, but its same-precision real
domain equivalent IS defined, BLIS will use a 4m-based implementation
for the datatype x implementations of all level-3 operations, using
only the real gemm micro-kernel.
243 lines
7.2 KiB
C
243 lines
7.2 KiB
C
/*
|
|
|
|
BLIS
|
|
An object-based framework for developing high-performance BLAS-like
|
|
libraries.
|
|
|
|
Copyright (C) 2014, The University of Texas
|
|
|
|
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 of The University of Texas 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.
|
|
|
|
*/
|
|
|
|
#ifndef BLIS_KERNEL_H
|
|
#define BLIS_KERNEL_H
|
|
|
|
|
|
// -- LEVEL-3 MICRO-KERNEL CONSTANTS -------------------------------------------
|
|
|
|
// -- Cache blocksizes --
|
|
|
|
//
|
|
// Constraints:
|
|
//
|
|
// (1) MC must be a multiple of:
|
|
// (a) MR (for zero-padding purposes)
|
|
// (b) NR (for zero-padding purposes when MR and NR are "swapped")
|
|
// (2) NC must be a multiple of
|
|
// (a) NR (for zero-padding purposes)
|
|
// (b) MR (for zero-padding purposes when MR and NR are "swapped")
|
|
// (3) KC must be a multiple of
|
|
// (a) MR and
|
|
// (b) NR (for triangular operations such as trmm and trsm).
|
|
//
|
|
|
|
#define BLIS_DEFAULT_MC_S 768
|
|
#define BLIS_DEFAULT_KC_S 384
|
|
#define BLIS_DEFAULT_NC_S 4096
|
|
|
|
#define BLIS_DEFAULT_MC_D 384
|
|
#define BLIS_DEFAULT_KC_D 384
|
|
#define BLIS_DEFAULT_NC_D 4096
|
|
|
|
//#define BLIS_DEFAULT_MC_C 384
|
|
//#define BLIS_DEFAULT_KC_C 384
|
|
//#define BLIS_DEFAULT_NC_C 4096
|
|
|
|
//#define BLIS_DEFAULT_MC_Z 192
|
|
//#define BLIS_DEFAULT_KC_Z 384
|
|
//#define BLIS_DEFAULT_NC_Z 4096
|
|
|
|
// NOTE: If 4m blocksizes are not defined here, they will be determined
|
|
// from the corresponding real domain blocksizes.
|
|
#define BLIS_DEFAULT_4M_MC_C 384
|
|
#define BLIS_DEFAULT_4M_KC_C 512
|
|
#define BLIS_DEFAULT_4M_NC_C 4096
|
|
|
|
#define BLIS_DEFAULT_4M_MC_Z 192
|
|
#define BLIS_DEFAULT_4M_KC_Z 256
|
|
#define BLIS_DEFAULT_4M_NC_Z 4096
|
|
|
|
// NOTE: If 3m blocksizes are not defined here, they will be determined
|
|
// from the corresponding real domain blocksizes.
|
|
#define BLIS_DEFAULT_3M_MC_C 384
|
|
#define BLIS_DEFAULT_3M_KC_C 512
|
|
#define BLIS_DEFAULT_3M_NC_C 4096
|
|
|
|
#define BLIS_DEFAULT_3M_MC_Z 192
|
|
#define BLIS_DEFAULT_3M_KC_Z 256
|
|
#define BLIS_DEFAULT_3M_NC_Z 4096
|
|
|
|
// -- Register blocksizes --
|
|
|
|
#define BLIS_DEFAULT_MR_S 8
|
|
#define BLIS_DEFAULT_NR_S 4
|
|
|
|
#define BLIS_DEFAULT_MR_D 4
|
|
#define BLIS_DEFAULT_NR_D 4
|
|
|
|
#define BLIS_DEFAULT_MR_C 4
|
|
#define BLIS_DEFAULT_NR_C 2
|
|
|
|
#define BLIS_DEFAULT_MR_Z 2
|
|
#define BLIS_DEFAULT_NR_Z 2
|
|
|
|
// NOTE: If the micro-kernel, which is typically unrolled to a factor
|
|
// of f, handles leftover edge cases (ie: when k % f > 0) then these
|
|
// register blocksizes in the k dimension can be defined to 1.
|
|
|
|
//#define BLIS_DEFAULT_KR_S 1
|
|
//#define BLIS_DEFAULT_KR_D 1
|
|
//#define BLIS_DEFAULT_KR_C 1
|
|
//#define BLIS_DEFAULT_KR_Z 1
|
|
|
|
// -- Cache blocksize extensions (for optimizing edge cases) --
|
|
|
|
// NOTE: These cache blocksize "extensions" have the same constraints as
|
|
// the corresponding default blocksizes above. When these values are
|
|
// non-zero, blocksizes used at edge cases are extended (enlarged) if
|
|
// such an extension would encompass the remaining portion of the
|
|
// matrix dimension.
|
|
|
|
//#define BLIS_EXTEND_MC_S 0 //(BLIS_DEFAULT_MC_S/4)
|
|
//#define BLIS_EXTEND_KC_S 0 //(BLIS_DEFAULT_KC_S/4)
|
|
//#define BLIS_EXTEND_NC_S 0 //(BLIS_DEFAULT_NC_S/4)
|
|
|
|
//#define BLIS_EXTEND_MC_D (BLIS_DEFAULT_MC_D/4)
|
|
//#define BLIS_EXTEND_KC_D (BLIS_DEFAULT_KC_D/4)
|
|
//#define BLIS_EXTEND_NC_D 0 //(BLIS_DEFAULT_NC_D/4)
|
|
|
|
//#define BLIS_EXTEND_MC_C 0 //(BLIS_DEFAULT_MC_C/4)
|
|
//#define BLIS_EXTEND_KC_C 0 //(BLIS_DEFAULT_KC_C/4)
|
|
//#define BLIS_EXTEND_NC_C 0 //(BLIS_DEFAULT_NC_C/4)
|
|
|
|
//#define BLIS_EXTEND_MC_Z 0 //(BLIS_DEFAULT_MC_Z/4)
|
|
//#define BLIS_EXTEND_KC_Z 0 //(BLIS_DEFAULT_KC_Z/4)
|
|
//#define BLIS_EXTEND_NC_Z 0 //(BLIS_DEFAULT_NC_Z/4)
|
|
|
|
// -- Register blocksize extensions (for packed micro-panels) --
|
|
|
|
// NOTE: These register blocksize "extensions" determine whether the
|
|
// leading dimensions used within the packed micro-panels are equal to
|
|
// or greater than their corresponding register blocksizes above.
|
|
|
|
//#define BLIS_EXTEND_MR_S 0
|
|
//#define BLIS_EXTEND_NR_S 0
|
|
|
|
//#define BLIS_EXTEND_MR_D 0
|
|
//#define BLIS_EXTEND_NR_D 0
|
|
|
|
//#define BLIS_EXTEND_MR_C 0
|
|
//#define BLIS_EXTEND_NR_C 0
|
|
|
|
//#define BLIS_EXTEND_MR_Z 0
|
|
//#define BLIS_EXTEND_NR_Z 0
|
|
|
|
|
|
|
|
|
|
// -- LEVEL-2 KERNEL CONSTANTS -------------------------------------------------
|
|
|
|
|
|
|
|
|
|
// -- LEVEL-1F KERNEL CONSTANTS ------------------------------------------------
|
|
|
|
|
|
|
|
|
|
// -- LEVEL-3 KERNEL DEFINITIONS -----------------------------------------------
|
|
|
|
// -- gemm --
|
|
|
|
#define BLIS_SGEMM_UKERNEL bli_sgemm_opt_8x4
|
|
#define BLIS_DGEMM_UKERNEL bli_dgemm_opt_4x4
|
|
|
|
// -- trsm-related --
|
|
|
|
#define BLIS_DGEMMTRSM_L_UKERNEL bli_dgemmtrsm_l_opt_4x4
|
|
#define BLIS_DGEMMTRSM_U_UKERNEL bli_dgemmtrsm_u_opt_4x4
|
|
|
|
|
|
|
|
|
|
// -- LEVEL-1F KERNEL DEFINITIONS ----------------------------------------------
|
|
|
|
// -- axpy2v --
|
|
|
|
#define BLIS_DAXPY2V_KERNEL bli_daxpy2v_opt_var1
|
|
|
|
// -- dotaxpyv --
|
|
|
|
#define BLIS_DDOTAXPYV_KERNEL bli_ddotaxpyv_opt_var1
|
|
|
|
// -- axpyf --
|
|
|
|
#define BLIS_DAXPYF_KERNEL bli_daxpyf_opt_var1
|
|
|
|
// -- dotxf --
|
|
|
|
#define BLIS_DDOTXF_KERNEL bli_ddotxf_opt_var1
|
|
|
|
// -- dotxaxpyf --
|
|
|
|
#define BLIS_DDOTXAXPYF_KERNEL bli_ddotxaxpyf_opt_var1
|
|
|
|
|
|
|
|
|
|
// -- LEVEL-1V KERNEL DEFINITIONS ----------------------------------------------
|
|
|
|
// -- addv --
|
|
|
|
// -- axpyv --
|
|
|
|
#define BLIS_DAXPYV_KERNEL bli_daxpyv_opt_var1
|
|
|
|
// -- copyv --
|
|
|
|
// -- dotv --
|
|
|
|
#define BLIS_DDOTV_KERNEL bli_ddotv_opt_var1
|
|
|
|
// -- dotxv --
|
|
|
|
// -- invertv --
|
|
|
|
// -- scal2v --
|
|
|
|
// -- scalv --
|
|
|
|
// -- setv --
|
|
|
|
// -- subv --
|
|
|
|
// -- swapv --
|
|
|
|
|
|
|
|
#endif
|
|
|