TRIQS/nda 2.0.0
Multi-dimensional array library for C++
Loading...
Searching...
No Matches
geqrf.hpp
Go to the documentation of this file.
1// Copyright (c) 2024--present, The Simons Foundation
2// This file is part of TRIQS/nda and is licensed under the Apache License, Version 2.0.
3// SPDX-License-Identifier: Apache-2.0
4// See LICENSE in the root of this distribution for details.
5
10
11#pragma once
12
14#include "../basic_array.hpp"
16#include "../blas/tools.hpp"
17#include "../concepts.hpp"
18#include "../declarations.hpp"
19#include "../macros.hpp"
21#include "../traits.hpp"
22
23#include <algorithm>
24#include <cmath>
25#include <complex>
26#include <type_traits>
27
28namespace nda::lapack {
29
70 template <BlasArray<2> A, BlasArrayFor<A, 1> TAU, BlasArrayFor<A, 1> W = vector_value_t<A>>
71 requires(has_F_layout<A>)
72 int geqrf(A &&a, TAU &&tau, W &&work = vector_value_t<A>{}) { // NOLINT (temporary views are allowed here)
73 constexpr bool run_on_device = mem::have_device_compatible_addr_space<A, TAU, W>;
74
75 // check the dimensions of the input/output arrays/views and resize if necessary
76 auto const [m, n] = a.shape();
77 resize_or_check_if_view(tau, {std::min(m, n)});
78
79 // arrays/views must be LAPACK compatible
80 EXPECTS(a.indexmap().min_stride() == 1);
81 EXPECTS(tau.indexmap().min_stride() == 1);
82
83 // first call to get the optimal buffer size
84 auto tmp_lwork = get_value_t<A>{};
85 int info = 0;
86 if constexpr (run_on_device) {
87 tmp_lwork = device::geqrf_buffer_size(m, n, a.data(), get_ld(a));
88 } else {
89 f77::geqrf(m, n, a.data(), get_ld(a), tau.data(), &tmp_lwork, -1, info);
90 }
91 int lwork = static_cast<int>(std::ceil(std::real(tmp_lwork)));
92
93 // resize/check work buffer
94 resize_or_check_work_buffer(work, lwork);
95
96 // perform actual library call
97 if constexpr (run_on_device) {
98 device::geqrf(m, n, a.data(), get_ld(a), tau.data(), work.data(), lwork, info);
99 } else {
100 f77::geqrf(m, n, a.data(), get_ld(a), tau.data(), work.data(), lwork, info);
101 }
102
103 return info;
104 }
105
106} // namespace nda::lapack
Provides definitions and type traits involving the different memory address spaces supported by nda.
Provides the generic class for arrays.
Provides basic functions to create and manipulate arrays and views.
Provides various traits and utilities for the BLAS interface.
Provides concepts for the nda library.
Provides various convenient aliases and helper functions for nda::basic_array and nda::basic_array_vi...
void resize_or_check_if_view(A &a, std::array< long, A::rank > const &sha)
Resize a given regular array to the given shape or check if a given view as the correct shape.
std::decay_t< decltype(get_first_element(std::declval< A const >()))> get_value_t
Get the value type of an array/view or a scalar type.
Definition traits.hpp:212
int get_ld(A const &a)
Get the leading dimension of an nda::MemoryArray with rank 1 or 2 for BLAS/LAPACK calls.
Definition tools.hpp:128
void resize_or_check_work_buffer(A &a, long min_size)
Resize or check the size of a 1D array/view.
Definition tools.hpp:207
vector< get_value_t< A >, heap< mem::get_addr_space< A > > > vector_value_t
Alias for an nda::vector with the same value type and address space as the given type.
Definition tools.hpp:161
static constexpr bool has_F_layout
Constexpr variable that is true if all given nda::Array types have nda::F_layout.
Definition tools.hpp:79
int geqrf(A &&a, TAU &&tau, W &&work=vector_value_t< A >{})
Interface to the LAPACK/cuSOLVER geqrf routine.
Definition geqrf.hpp:72
static constexpr bool have_device_compatible_addr_space
Constexpr variable that is true if all given types have an address space compatible with Device.
Provides a C++ interface for various LAPACK routines.
Macros used in the nda library.
Provides type traits for the nda library.