1 // This file is part of Eigen, a lightweight C++ template library 2 // for linear algebra. 3 // 4 // Copyright (C) 2012 Dsir Nuentsa-Wakam <desire.nuentsa_wakam (at) inria.fr> 5 // Copyright (C) 2012 Gael Guennebaud <gael.guennebaud (at) inria.fr> 6 // 7 // This Source Code Form is subject to the terms of the Mozilla 8 // Public License v. 2.0. If a copy of the MPL was not distributed 9 // with this file, You can obtain one at http://mozilla.org/MPL/2.0/. 10 11 /* 12 13 * NOTE: This file is the modified version of [s,d,c,z]panel_bmod.c file in SuperLU 14 15 * -- SuperLU routine (version 3.0) -- 16 * Univ. of California Berkeley, Xerox Palo Alto Research Center, 17 * and Lawrence Berkeley National Lab. 18 * October 15, 2003 19 * 20 * Copyright (c) 1994 by Xerox Corporation. All rights reserved. 21 * 22 * THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY 23 * EXPRESSED OR IMPLIED. ANY USE IS AT YOUR OWN RISK. 24 * 25 * Permission is hereby granted to use or copy this program for any 26 * purpose, provided the above notices are retained on all copies. 27 * Permission to modify the code and to distribute modified code is 28 * granted, provided the above notices are retained, and a notice that 29 * the code was modified is included with the above copyright notice. 30 */ 31 #ifndef SPARSELU_PANEL_BMOD_H 32 #define SPARSELU_PANEL_BMOD_H 33 34 namespace Eigen { 35 namespace internal { 36 37 /** 38 * \brief Performs numeric block updates (sup-panel) in topological order. 39 * 40 * Before entering this routine, the original nonzeros in the panel 41 * were already copied i nto the spa[m,w] 42 * 43 * \param m number of rows in the matrix 44 * \param w Panel size 45 * \param jcol Starting column of the panel 46 * \param nseg Number of segments in the U part 47 * \param dense Store the full representation of the panel 48 * \param tempv working array 49 * \param segrep segment representative... first row in the segment 50 * \param repfnz First nonzero rows 51 * \param glu Global LU data. 52 * 53 * 54 */ 55 template <typename Scalar, typename Index> 56 void SparseLUImpl<Scalar,Index>::panel_bmod(const Index m, const Index w, const Index jcol, 57 const Index nseg, ScalarVector& dense, ScalarVector& tempv, 58 IndexVector& segrep, IndexVector& repfnz, GlobalLU_t& glu) 59 { 60 61 Index ksub,jj,nextl_col; 62 Index fsupc, nsupc, nsupr, nrow; 63 Index krep, kfnz; 64 Index lptr; // points to the row subscripts of a supernode 65 Index luptr; // ... 66 Index segsize,no_zeros ; 67 // For each nonz supernode segment of U[*,j] in topological order 68 Index k = nseg - 1; 69 const Index PacketSize = internal::packet_traits<Scalar>::size; 70 71 for (ksub = 0; ksub < nseg; ksub++) 72 { // For each updating supernode 73 /* krep = representative of current k-th supernode 74 * fsupc = first supernodal column 75 * nsupc = number of columns in a supernode 76 * nsupr = number of rows in a supernode 77 */ 78 krep = segrep(k); k--; 79 fsupc = glu.xsup(glu.supno(krep)); 80 nsupc = krep - fsupc + 1; 81 nsupr = glu.xlsub(fsupc+1) - glu.xlsub(fsupc); 82 nrow = nsupr - nsupc; 83 lptr = glu.xlsub(fsupc); 84 85 // loop over the panel columns to detect the actual number of columns and rows 86 Index u_rows = 0; 87 Index u_cols = 0; 88 for (jj = jcol; jj < jcol + w; jj++) 89 { 90 nextl_col = (jj-jcol) * m; 91 VectorBlock<IndexVector> repfnz_col(repfnz, nextl_col, m); // First nonzero column index for each row 92 93 kfnz = repfnz_col(krep); 94 if ( kfnz == emptyIdxLU ) 95 continue; // skip any zero segment 96 97 segsize = krep - kfnz + 1; 98 u_cols++; 99 u_rows = (std::max)(segsize,u_rows); 100 } 101 102 if(nsupc >= 2) 103 { 104 Index ldu = internal::first_multiple<Index>(u_rows, PacketSize); 105 Map<Matrix<Scalar,Dynamic,Dynamic>, Aligned, OuterStride<> > U(tempv.data(), u_rows, u_cols, OuterStride<>(ldu)); 106 107 // gather U 108 Index u_col = 0; 109 for (jj = jcol; jj < jcol + w; jj++) 110 { 111 nextl_col = (jj-jcol) * m; 112 VectorBlock<IndexVector> repfnz_col(repfnz, nextl_col, m); // First nonzero column index for each row 113 VectorBlock<ScalarVector> dense_col(dense, nextl_col, m); // Scatter/gather entire matrix column from/to here 114 115 kfnz = repfnz_col(krep); 116 if ( kfnz == emptyIdxLU ) 117 continue; // skip any zero segment 118 119 segsize = krep - kfnz + 1; 120 luptr = glu.xlusup(fsupc); 121 no_zeros = kfnz - fsupc; 122 123 Index isub = lptr + no_zeros; 124 Index off = u_rows-segsize; 125 for (Index i = 0; i < off; i++) U(i,u_col) = 0; 126 for (Index i = 0; i < segsize; i++) 127 { 128 Index irow = glu.lsub(isub); 129 U(i+off,u_col) = dense_col(irow); 130 ++isub; 131 } 132 u_col++; 133 } 134 // solve U = A^-1 U 135 luptr = glu.xlusup(fsupc); 136 Index lda = glu.xlusup(fsupc+1) - glu.xlusup(fsupc); 137 no_zeros = (krep - u_rows + 1) - fsupc; 138 luptr += lda * no_zeros + no_zeros; 139 Map<Matrix<Scalar,Dynamic,Dynamic>, 0, OuterStride<> > A(glu.lusup.data()+luptr, u_rows, u_rows, OuterStride<>(lda) ); 140 U = A.template triangularView<UnitLower>().solve(U); 141 142 // update 143 luptr += u_rows; 144 Map<Matrix<Scalar,Dynamic,Dynamic>, 0, OuterStride<> > B(glu.lusup.data()+luptr, nrow, u_rows, OuterStride<>(lda) ); 145 eigen_assert(tempv.size()>w*ldu + nrow*w + 1); 146 147 Index ldl = internal::first_multiple<Index>(nrow, PacketSize); 148 Index offset = (PacketSize-internal::first_aligned(B.data(), PacketSize)) % PacketSize; 149 Map<Matrix<Scalar,Dynamic,Dynamic>, 0, OuterStride<> > L(tempv.data()+w*ldu+offset, nrow, u_cols, OuterStride<>(ldl)); 150 151 L.setZero(); 152 internal::sparselu_gemm<Scalar>(L.rows(), L.cols(), B.cols(), B.data(), B.outerStride(), U.data(), U.outerStride(), L.data(), L.outerStride()); 153 154 // scatter U and L 155 u_col = 0; 156 for (jj = jcol; jj < jcol + w; jj++) 157 { 158 nextl_col = (jj-jcol) * m; 159 VectorBlock<IndexVector> repfnz_col(repfnz, nextl_col, m); // First nonzero column index for each row 160 VectorBlock<ScalarVector> dense_col(dense, nextl_col, m); // Scatter/gather entire matrix column from/to here 161 162 kfnz = repfnz_col(krep); 163 if ( kfnz == emptyIdxLU ) 164 continue; // skip any zero segment 165 166 segsize = krep - kfnz + 1; 167 no_zeros = kfnz - fsupc; 168 Index isub = lptr + no_zeros; 169 170 Index off = u_rows-segsize; 171 for (Index i = 0; i < segsize; i++) 172 { 173 Index irow = glu.lsub(isub++); 174 dense_col(irow) = U.coeff(i+off,u_col); 175 U.coeffRef(i+off,u_col) = 0; 176 } 177 178 // Scatter l into SPA dense[] 179 for (Index i = 0; i < nrow; i++) 180 { 181 Index irow = glu.lsub(isub++); 182 dense_col(irow) -= L.coeff(i,u_col); 183 L.coeffRef(i,u_col) = 0; 184 } 185 u_col++; 186 } 187 } 188 else // level 2 only 189 { 190 // Sequence through each column in the panel 191 for (jj = jcol; jj < jcol + w; jj++) 192 { 193 nextl_col = (jj-jcol) * m; 194 VectorBlock<IndexVector> repfnz_col(repfnz, nextl_col, m); // First nonzero column index for each row 195 VectorBlock<ScalarVector> dense_col(dense, nextl_col, m); // Scatter/gather entire matrix column from/to here 196 197 kfnz = repfnz_col(krep); 198 if ( kfnz == emptyIdxLU ) 199 continue; // skip any zero segment 200 201 segsize = krep - kfnz + 1; 202 luptr = glu.xlusup(fsupc); 203 204 Index lda = glu.xlusup(fsupc+1)-glu.xlusup(fsupc);// nsupr 205 206 // Perform a trianglar solve and block update, 207 // then scatter the result of sup-col update to dense[] 208 no_zeros = kfnz - fsupc; 209 if(segsize==1) LU_kernel_bmod<1>::run(segsize, dense_col, tempv, glu.lusup, luptr, lda, nrow, glu.lsub, lptr, no_zeros); 210 else if(segsize==2) LU_kernel_bmod<2>::run(segsize, dense_col, tempv, glu.lusup, luptr, lda, nrow, glu.lsub, lptr, no_zeros); 211 else if(segsize==3) LU_kernel_bmod<3>::run(segsize, dense_col, tempv, glu.lusup, luptr, lda, nrow, glu.lsub, lptr, no_zeros); 212 else LU_kernel_bmod<Dynamic>::run(segsize, dense_col, tempv, glu.lusup, luptr, lda, nrow, glu.lsub, lptr, no_zeros); 213 } // End for each column in the panel 214 } 215 216 } // End for each updating supernode 217 } // end panel bmod 218 219 } // end namespace internal 220 221 } // end namespace Eigen 222 223 #endif // SPARSELU_PANEL_BMOD_H 224