Files
blis/frame/util/bli_util_tapi.c
Field G. Van Zee a89555d160 Added randn[vm] operations, support in testsuite.
Details:
- Defined a new randomization operation, randn, on vectors and matrices.
  The randnv and randnm operations randomize each element of the target
  object with values from a narrow range of values. Presently, those
  values are all integer powers of two, but they do not need to be powers
  of two in order to achieve the primary goal, which is to initialize
  objects that can be operated on with plenty of precision "slack"
  available to allow computations that avoid roundoff. Using this method
  of randomization makes it much more likely that testsuite residuals of
  properly-functioning operations are close to zero, if not exactly zero.
- Updated existing randomization operations randv and randm to skip
  special diagonal handling and normalization for matrices with structure.
  This is now handled by the testsuite modules by explicitly calling a
  testsuite function that loads the diagonal (and scales off-diagonal
  elements).
- Added support for randnv and randnm in the testsuite with a new switch
  in input.general that universally toggles between use of the classic
  randv/randm, which use real values on the interval [-1,1], and
  randnv/randnm, which use only values from a narrow range. Currently,
  the narrow range is: +/-{2^0, 2^-1, 2^-2, 2^-3, 2^-4, 2^-5, 2^-6}, as
  well as 0.0.
- Updated testsuite modules so that a testsutie wrapper function is called
  instead of directly calling the randomization operations (such as
  bli_randv() and bli_randm()). This wrapper also takes a bool_t that
  indicates whether the object's elements should be normalized. (NOTE: As
  alluded to above, in the test modules of triangular solve operations such
  as trsv and trsm, we perform the extra step of loading the diagonal.)
- Defined a new level-0 operation, invertsc, which inverts a scalar.
- Updated the abval2ris and sqrt2ris level-0 macros to avoid an unlikely
  but possible divide-by-zero.
- Updated function signature and prototype formatting in testsuite.
2016-06-17 14:08:35 -05:00

426 lines
9.9 KiB
C

/*
BLIS
An object-based framework for developing high-performance BLAS-like
libraries.
Copyright (C) 2014, The University of Texas at Austin
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 at Austin 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-like interfaces with typed operands.
//
#undef GENTFUNCI
#define GENTFUNCI( ctype, ctype_i, ch, chi, opname ) \
\
void PASTEMAC(ch,opname) \
( \
dim_t n, \
ctype* x, inc_t incx, \
ctype_i* index, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If the vector length is zero, set the index to zero and return
early. This directly emulatess the behavior of netlib LAPACK's
i?amax() routines. */ \
if ( bli_zero_dim1( n ) ) \
{ \
ctype_i* zero_i = PASTEMAC(chi,0); \
\
PASTEMAC(chi,copys)( *zero_i, *index ); \
return; \
} \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
n, \
x, incx, \
index, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNCI_BASIC0( amaxv )
#undef GENTFUNCR
#define GENTFUNCR( ctype, ctype_r, ch, chr, opname ) \
\
void PASTEMAC(ch,opname) \
( \
dim_t n, \
ctype* x, inc_t incx, \
ctype_r* asum, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If the vector length is zero, set the absolute sum return value to
zero and return early. */ \
if ( bli_zero_dim1( n ) ) \
{ \
PASTEMAC(chr,set0s)( *asum ); \
return; \
} \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
n, \
x, incx, \
asum, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNCR_BASIC0( asumv )
#undef GENTFUNC
#define GENTFUNC( ctype, ch, opname ) \
\
void PASTEMAC(ch,opname) \
( \
uplo_t uploa, \
dim_t m, \
ctype* a, inc_t rs_a, inc_t cs_a, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If either dimension is zero, return early. */ \
if ( bli_zero_dim2( m, m ) ) return; \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
uploa, \
m, \
a, rs_a, cs_a, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNC_BASIC0( mkherm )
INSERT_GENTFUNC_BASIC0( mksymm )
INSERT_GENTFUNC_BASIC0( mktrim )
#undef GENTFUNCR
#define GENTFUNCR( ctype, ctype_r, ch, chr, opname ) \
\
void PASTEMAC(ch,opname) \
( \
dim_t n, \
ctype* x, inc_t incx, \
ctype_r* norm, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If the vector length is zero, set the norm to zero and return
early. */ \
if ( bli_zero_dim1( n ) ) \
{ \
PASTEMAC(chr,set0s)( *norm ); \
return; \
} \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
n, \
x, incx, \
norm, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNCR_BASIC0( norm1v )
INSERT_GENTFUNCR_BASIC0( normfv )
INSERT_GENTFUNCR_BASIC0( normiv )
#undef GENTFUNCR
#define GENTFUNCR( ctype, ctype_r, ch, chr, opname ) \
\
void PASTEMAC(ch,opname) \
( \
doff_t diagoffx, \
diag_t diagx, \
uplo_t uplox, \
dim_t m, \
dim_t n, \
ctype* x, inc_t rs_x, inc_t cs_x, \
ctype_r* norm, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If either dimension is zero, set the norm to zero and return
early. */ \
if ( bli_zero_dim2( m, n ) ) \
{ \
PASTEMAC(chr,set0s)( *norm ); \
return; \
} \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
diagoffx, \
diagx, \
uplox, \
m, \
n, \
x, rs_x, cs_x, \
norm, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNCR_BASIC0( norm1m )
INSERT_GENTFUNCR_BASIC0( normfm )
INSERT_GENTFUNCR_BASIC0( normim )
#undef GENTFUNC
#define GENTFUNC( ctype, ch, opname, varname ) \
\
void PASTEMAC(ch,opname) \
( \
char* s1, \
dim_t n, \
void* x, inc_t incx, \
char* format, \
char* s2 \
) \
{ \
PASTEMAC(ch,varname) \
( \
stdout, \
s1, \
n, \
x, incx, \
format, \
s2 \
); \
}
INSERT_GENTFUNC_BASIC_I( printv, fprintv )
#undef GENTFUNC
#define GENTFUNC( ctype, ch, opname, varname ) \
\
void PASTEMAC(ch,opname) \
( \
char* s1, \
dim_t m, \
dim_t n, \
void* x, inc_t rs_x, inc_t cs_x, \
char* format, \
char* s2 \
) \
{ \
PASTEMAC(ch,varname) \
( \
stdout, \
s1, \
m, \
n, \
x, rs_x, cs_x, \
format, \
s2 \
); \
}
INSERT_GENTFUNC_BASIC_I( printm, fprintm )
#undef GENTFUNC
#define GENTFUNC( ctype, ch, opname ) \
\
void PASTEMAC(ch,opname) \
( \
dim_t n, \
ctype* x, inc_t incx, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If the vector length is zero, return early. */ \
if ( bli_zero_dim1( n ) ) return; \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
n, \
x, incx, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNC_BASIC0( randv )
INSERT_GENTFUNC_BASIC0( randnv )
#undef GENTFUNC
#define GENTFUNC( ctype, ch, opname ) \
\
void PASTEMAC(ch,opname) \
( \
doff_t diagoffx, \
uplo_t uplox, \
dim_t m, \
dim_t n, \
ctype* x, inc_t rs_x, inc_t cs_x, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If either dimension is zero, return early. */ \
if ( bli_zero_dim2( m, n ) ) return; \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
diagoffx, \
uplox, \
m, \
n, \
x, rs_x, cs_x, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNC_BASIC0( randm )
INSERT_GENTFUNC_BASIC0( randnm )
#undef GENTFUNCR
#define GENTFUNCR( ctype, ctype_r, ch, chr, opname ) \
\
void PASTEMAC(ch,opname) \
( \
dim_t n, \
ctype* x, inc_t incx, \
ctype_r* scale, \
ctype_r* sumsq, \
cntx_t* cntx \
) \
{ \
cntx_t* cntx_p = cntx; \
\
/* If x is zero length, return with scale and sumsq unchanged. */ \
if ( bli_zero_dim1( n ) ) return; \
\
/* Initialize a local context if the given context is NULL. */ \
/*bli_cntx_init_local_if( opname, cntx, cntx_p );*/ \
\
/* Invoke the helper variant, which loops over the appropriate kernel
to implement the current operation. */ \
PASTEMAC2(ch,opname,_unb_var1) \
( \
n, \
x, incx, \
scale, \
sumsq, \
cntx_p \
); \
\
/* Finalize the context if it was initialized locally. */ \
/*bli_cntx_finalize_local_if( opname, cntx );*/ \
}
INSERT_GENTFUNCR_BASIC0( sumsqv )