You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
362 lines
14 KiB
362 lines
14 KiB
// |
|
// Copyright (c) 2002--2010 |
|
// Toon Knapen, Karl Meerbergen, Kresimir Fresl, |
|
// Thomas Klimpel and Rutger ter Borg |
|
// |
|
// Distributed under the Boost Software License, Version 1.0. |
|
// (See accompanying file LICENSE_1_0.txt or copy at |
|
// http://www.boost.org/LICENSE_1_0.txt) |
|
// |
|
// THIS FILE IS AUTOMATICALLY GENERATED |
|
// PLEASE DO NOT EDIT! |
|
// |
|
|
|
#ifndef BOOST_NUMERIC_BINDINGS_LAPACK_AUXILIARY_LARF_HPP |
|
#define BOOST_NUMERIC_BINDINGS_LAPACK_AUXILIARY_LARF_HPP |
|
|
|
#include <boost/assert.hpp> |
|
#include <boost/numeric/bindings/begin.hpp> |
|
#include <boost/numeric/bindings/detail/array.hpp> |
|
#include <boost/numeric/bindings/detail/if_left.hpp> |
|
#include <boost/numeric/bindings/is_column_major.hpp> |
|
#include <boost/numeric/bindings/is_complex.hpp> |
|
#include <boost/numeric/bindings/is_mutable.hpp> |
|
#include <boost/numeric/bindings/is_real.hpp> |
|
#include <boost/numeric/bindings/lapack/workspace.hpp> |
|
#include <boost/numeric/bindings/remove_imaginary.hpp> |
|
#include <boost/numeric/bindings/size.hpp> |
|
#include <boost/numeric/bindings/stride.hpp> |
|
#include <boost/numeric/bindings/value_type.hpp> |
|
#include <boost/static_assert.hpp> |
|
#include <boost/type_traits/is_same.hpp> |
|
#include <boost/type_traits/remove_const.hpp> |
|
#include <boost/utility/enable_if.hpp> |
|
|
|
// |
|
// The LAPACK-backend for larf is the netlib-compatible backend. |
|
// |
|
#include <boost/numeric/bindings/lapack/detail/lapack.h> |
|
#include <boost/numeric/bindings/lapack/detail/lapack_option.hpp> |
|
|
|
namespace boost { |
|
namespace numeric { |
|
namespace bindings { |
|
namespace lapack { |
|
|
|
// |
|
// The detail namespace contains value-type-overloaded functions that |
|
// dispatch to the appropriate back-end LAPACK-routine. |
|
// |
|
namespace detail { |
|
|
|
// |
|
// Overloaded function for dispatching to |
|
// * netlib-compatible LAPACK backend (the default), and |
|
// * float value-type. |
|
// |
|
template< typename Side > |
|
inline std::ptrdiff_t larf( const Side, const fortran_int_t m, |
|
const fortran_int_t n, const float* v, const fortran_int_t incv, |
|
const float tau, float* c, const fortran_int_t ldc, float* work ) { |
|
fortran_int_t info(0); |
|
LAPACK_SLARF( &lapack_option< Side >::value, &m, &n, v, &incv, &tau, c, |
|
&ldc, work ); |
|
return info; |
|
} |
|
|
|
// |
|
// Overloaded function for dispatching to |
|
// * netlib-compatible LAPACK backend (the default), and |
|
// * double value-type. |
|
// |
|
template< typename Side > |
|
inline std::ptrdiff_t larf( const Side, const fortran_int_t m, |
|
const fortran_int_t n, const double* v, const fortran_int_t incv, |
|
const double tau, double* c, const fortran_int_t ldc, double* work ) { |
|
fortran_int_t info(0); |
|
LAPACK_DLARF( &lapack_option< Side >::value, &m, &n, v, &incv, &tau, c, |
|
&ldc, work ); |
|
return info; |
|
} |
|
|
|
// |
|
// Overloaded function for dispatching to |
|
// * netlib-compatible LAPACK backend (the default), and |
|
// * complex<float> value-type. |
|
// |
|
template< typename Side > |
|
inline std::ptrdiff_t larf( const Side, const fortran_int_t m, |
|
const fortran_int_t n, const std::complex<float>* v, |
|
const fortran_int_t incv, const std::complex<float> tau, |
|
std::complex<float>* c, const fortran_int_t ldc, |
|
std::complex<float>* work ) { |
|
fortran_int_t info(0); |
|
LAPACK_CLARF( &lapack_option< Side >::value, &m, &n, v, &incv, &tau, c, |
|
&ldc, work ); |
|
return info; |
|
} |
|
|
|
// |
|
// Overloaded function for dispatching to |
|
// * netlib-compatible LAPACK backend (the default), and |
|
// * complex<double> value-type. |
|
// |
|
template< typename Side > |
|
inline std::ptrdiff_t larf( const Side, const fortran_int_t m, |
|
const fortran_int_t n, const std::complex<double>* v, |
|
const fortran_int_t incv, const std::complex<double> tau, |
|
std::complex<double>* c, const fortran_int_t ldc, |
|
std::complex<double>* work ) { |
|
fortran_int_t info(0); |
|
LAPACK_ZLARF( &lapack_option< Side >::value, &m, &n, v, &incv, &tau, c, |
|
&ldc, work ); |
|
return info; |
|
} |
|
|
|
} // namespace detail |
|
|
|
// |
|
// Value-type based template class. Use this class if you need a type |
|
// for dispatching to larf. |
|
// |
|
template< typename Value, typename Enable = void > |
|
struct larf_impl {}; |
|
|
|
// |
|
// This implementation is enabled if Value is a real type. |
|
// |
|
template< typename Value > |
|
struct larf_impl< Value, typename boost::enable_if< is_real< Value > >::type > { |
|
|
|
typedef Value value_type; |
|
typedef typename remove_imaginary< Value >::type real_type; |
|
|
|
// |
|
// Static member function for user-defined workspaces, that |
|
// * Deduces the required arguments for dispatching to LAPACK, and |
|
// * Asserts that most arguments make sense. |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC, |
|
typename WORK > |
|
static std::ptrdiff_t invoke( const Side side, const VectorV& v, |
|
const real_type tau, MatrixC& c, detail::workspace1< |
|
WORK > work ) { |
|
namespace bindings = ::boost::numeric::bindings; |
|
BOOST_STATIC_ASSERT( (bindings::is_column_major< MatrixC >::value) ); |
|
BOOST_STATIC_ASSERT( (boost::is_same< typename remove_const< |
|
typename bindings::value_type< VectorV >::type >::type, |
|
typename remove_const< typename bindings::value_type< |
|
MatrixC >::type >::type >::value) ); |
|
BOOST_STATIC_ASSERT( (bindings::is_mutable< MatrixC >::value) ); |
|
BOOST_ASSERT( bindings::size(work.select(real_type())) >= |
|
min_size_work( side, bindings::size_row(c), |
|
bindings::size_column(c) )); |
|
BOOST_ASSERT( bindings::size_minor(c) == 1 || |
|
bindings::stride_minor(c) == 1 ); |
|
BOOST_ASSERT( bindings::stride_major(c) >= std::max< std::ptrdiff_t >(1, |
|
bindings::size_row(c)) ); |
|
return detail::larf( side, bindings::size_row(c), |
|
bindings::size_column(c), bindings::begin_value(v), |
|
bindings::stride(v), tau, bindings::begin_value(c), |
|
bindings::stride_major(c), |
|
bindings::begin_value(work.select(real_type())) ); |
|
} |
|
|
|
// |
|
// Static member function that |
|
// * Figures out the minimal workspace requirements, and passes |
|
// the results to the user-defined workspace overload of the |
|
// invoke static member function |
|
// * Enables the unblocked algorithm (BLAS level 2) |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC > |
|
static std::ptrdiff_t invoke( const Side side, const VectorV& v, |
|
const real_type tau, MatrixC& c, minimal_workspace ) { |
|
namespace bindings = ::boost::numeric::bindings; |
|
bindings::detail::array< real_type > tmp_work( min_size_work( side, |
|
bindings::size_row(c), bindings::size_column(c) ) ); |
|
return invoke( side, v, tau, c, workspace( tmp_work ) ); |
|
} |
|
|
|
// |
|
// Static member function that |
|
// * Figures out the optimal workspace requirements, and passes |
|
// the results to the user-defined workspace overload of the |
|
// invoke static member |
|
// * Enables the blocked algorithm (BLAS level 3) |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC > |
|
static std::ptrdiff_t invoke( const Side side, const VectorV& v, |
|
const real_type tau, MatrixC& c, optimal_workspace ) { |
|
namespace bindings = ::boost::numeric::bindings; |
|
return invoke( side, v, tau, c, minimal_workspace() ); |
|
} |
|
|
|
// |
|
// Static member function that returns the minimum size of |
|
// workspace-array work. |
|
// |
|
template< typename Side > |
|
static std::ptrdiff_t min_size_work( const Side side, |
|
const std::ptrdiff_t m, const std::ptrdiff_t n ) { |
|
return std::max< std::ptrdiff_t >( 1, bindings::detail::if_left( side, |
|
n, m ) ); |
|
} |
|
}; |
|
|
|
// |
|
// This implementation is enabled if Value is a complex type. |
|
// |
|
template< typename Value > |
|
struct larf_impl< Value, typename boost::enable_if< is_complex< Value > >::type > { |
|
|
|
typedef Value value_type; |
|
typedef typename remove_imaginary< Value >::type real_type; |
|
|
|
// |
|
// Static member function for user-defined workspaces, that |
|
// * Deduces the required arguments for dispatching to LAPACK, and |
|
// * Asserts that most arguments make sense. |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC, |
|
typename WORK > |
|
static std::ptrdiff_t invoke( const Side side, const VectorV& v, |
|
const value_type tau, MatrixC& c, detail::workspace1< |
|
WORK > work ) { |
|
namespace bindings = ::boost::numeric::bindings; |
|
BOOST_STATIC_ASSERT( (bindings::is_column_major< MatrixC >::value) ); |
|
BOOST_STATIC_ASSERT( (boost::is_same< typename remove_const< |
|
typename bindings::value_type< VectorV >::type >::type, |
|
typename remove_const< typename bindings::value_type< |
|
MatrixC >::type >::type >::value) ); |
|
BOOST_STATIC_ASSERT( (bindings::is_mutable< MatrixC >::value) ); |
|
BOOST_ASSERT( bindings::size(work.select(value_type())) >= |
|
min_size_work( side, bindings::size_row(c), |
|
bindings::size_column(c) )); |
|
BOOST_ASSERT( bindings::size_minor(c) == 1 || |
|
bindings::stride_minor(c) == 1 ); |
|
BOOST_ASSERT( bindings::stride_major(c) >= std::max< std::ptrdiff_t >(1, |
|
bindings::size_row(c)) ); |
|
return detail::larf( side, bindings::size_row(c), |
|
bindings::size_column(c), bindings::begin_value(v), |
|
bindings::stride(v), tau, bindings::begin_value(c), |
|
bindings::stride_major(c), |
|
bindings::begin_value(work.select(value_type())) ); |
|
} |
|
|
|
// |
|
// Static member function that |
|
// * Figures out the minimal workspace requirements, and passes |
|
// the results to the user-defined workspace overload of the |
|
// invoke static member function |
|
// * Enables the unblocked algorithm (BLAS level 2) |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC > |
|
static std::ptrdiff_t invoke( const Side side, const VectorV& v, |
|
const value_type tau, MatrixC& c, minimal_workspace ) { |
|
namespace bindings = ::boost::numeric::bindings; |
|
bindings::detail::array< value_type > tmp_work( min_size_work( side, |
|
bindings::size_row(c), bindings::size_column(c) ) ); |
|
return invoke( side, v, tau, c, workspace( tmp_work ) ); |
|
} |
|
|
|
// |
|
// Static member function that |
|
// * Figures out the optimal workspace requirements, and passes |
|
// the results to the user-defined workspace overload of the |
|
// invoke static member |
|
// * Enables the blocked algorithm (BLAS level 3) |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC > |
|
static std::ptrdiff_t invoke( const Side side, const VectorV& v, |
|
const value_type tau, MatrixC& c, optimal_workspace ) { |
|
namespace bindings = ::boost::numeric::bindings; |
|
return invoke( side, v, tau, c, minimal_workspace() ); |
|
} |
|
|
|
// |
|
// Static member function that returns the minimum size of |
|
// workspace-array work. |
|
// |
|
template< typename Side > |
|
static std::ptrdiff_t min_size_work( const Side side, |
|
const std::ptrdiff_t m, const std::ptrdiff_t n ) { |
|
return std::max< std::ptrdiff_t >( 1, bindings::detail::if_left( side, |
|
n, m ) ); |
|
} |
|
}; |
|
|
|
|
|
// |
|
// Functions for direct use. These functions are overloaded for temporaries, |
|
// so that wrapped types can still be passed and used for write-access. In |
|
// addition, if applicable, they are overloaded for user-defined workspaces. |
|
// Calls to these functions are passed to the larf_impl classes. In the |
|
// documentation, most overloads are collapsed to avoid a large number of |
|
// prototypes which are very similar. |
|
// |
|
|
|
// |
|
// Overloaded function for larf. Its overload differs for |
|
// * User-defined workspace |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC, |
|
typename Workspace > |
|
inline typename boost::enable_if< detail::is_workspace< Workspace >, |
|
std::ptrdiff_t >::type |
|
larf( const Side side, const VectorV& v, |
|
const typename remove_imaginary< typename bindings::value_type< |
|
VectorV >::type >::type tau, MatrixC& c, Workspace work ) { |
|
return larf_impl< typename bindings::value_type< |
|
VectorV >::type >::invoke( side, v, tau, c, work ); |
|
} |
|
|
|
// |
|
// Overloaded function for larf. Its overload differs for |
|
// * Default workspace-type (optimal) |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC > |
|
inline typename boost::disable_if< detail::is_workspace< MatrixC >, |
|
std::ptrdiff_t >::type |
|
larf( const Side side, const VectorV& v, |
|
const typename remove_imaginary< typename bindings::value_type< |
|
VectorV >::type >::type tau, MatrixC& c ) { |
|
return larf_impl< typename bindings::value_type< |
|
VectorV >::type >::invoke( side, v, tau, c, optimal_workspace() ); |
|
} |
|
|
|
// |
|
// Overloaded function for larf. Its overload differs for |
|
// * User-defined workspace |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC, |
|
typename Workspace > |
|
inline typename boost::enable_if< detail::is_workspace< Workspace >, |
|
std::ptrdiff_t >::type |
|
larf( const Side side, const VectorV& v, |
|
const typename bindings::value_type< VectorV >::type tau, MatrixC& c, |
|
Workspace work ) { |
|
return larf_impl< typename bindings::value_type< |
|
VectorV >::type >::invoke( side, v, tau, c, work ); |
|
} |
|
|
|
// |
|
// Overloaded function for larf. Its overload differs for |
|
// * Default workspace-type (optimal) |
|
// |
|
template< typename Side, typename VectorV, typename MatrixC > |
|
inline typename boost::disable_if< detail::is_workspace< MatrixC >, |
|
std::ptrdiff_t >::type |
|
larf( const Side side, const VectorV& v, |
|
const typename bindings::value_type< VectorV >::type tau, |
|
MatrixC& c ) { |
|
return larf_impl< typename bindings::value_type< |
|
VectorV >::type >::invoke( side, v, tau, c, optimal_workspace() ); |
|
} |
|
|
|
} // namespace lapack |
|
} // namespace bindings |
|
} // namespace numeric |
|
} // namespace boost |
|
|
|
#endif
|
|
|