xref: /petsc/src/tao/leastsquares/impls/pounders/gqt.c (revision 503c0ea9b45bcfbcebbb1ea5341243bbc69f0bea)
1 #include <petscsys.h>
2 #include <petscblaslapack.h>
3 
4 static PetscErrorCode estsv(PetscInt n, PetscReal *r, PetscInt ldr, PetscReal *svmin, PetscReal *z)
5 {
6   PetscBLASInt   blas1=1, blasn, blasnmi, blasj, blasldr;
7   PetscInt       i,j;
8   PetscReal      e,temp,w,wm,ynorm,znorm,s,sm;
9 
10   PetscFunctionBegin;
11   PetscCall(PetscBLASIntCast(n,&blasn));
12   PetscCall(PetscBLASIntCast(ldr,&blasldr));
13   for (i=0;i<n;i++) {
14     z[i]=0.0;
15   }
16   e = PetscAbs(r[0]);
17   if (e == 0.0) {
18     *svmin = 0.0;
19     z[0] = 1.0;
20   } else {
21     /* Solve R'*y = e */
22     for (i=0;i<n;i++) {
23       /* Scale y. The scaling factor (0.01) reduces the number of scalings */
24       if (z[i] >= 0.0) e =-PetscAbs(e);
25       else             e = PetscAbs(e);
26 
27       if (PetscAbs(e - z[i]) > PetscAbs(r[i + ldr*i])) {
28         temp = PetscMin(0.01,PetscAbs(r[i + ldr*i]))/PetscAbs(e-z[i]);
29         PetscStackCallBLAS("BLASscal",BLASscal_(&blasn, &temp, z, &blas1));
30         e = temp*e;
31       }
32 
33       /* Determine the two possible choices of y[i] */
34       if (r[i + ldr*i] == 0.0) {
35         w = wm = 1.0;
36       } else {
37         w  = (e - z[i]) / r[i + ldr*i];
38         wm = - (e + z[i]) / r[i + ldr*i];
39       }
40 
41       /*  Chose y[i] based on the predicted value of y[j] for j>i */
42       s  = PetscAbs(e - z[i]);
43       sm = PetscAbs(e + z[i]);
44       for (j=i+1;j<n;j++) {
45         sm += PetscAbs(z[j] + wm * r[i + ldr*j]);
46       }
47       if (i < n-1) {
48         PetscCall(PetscBLASIntCast(n-i-1,&blasnmi));
49         PetscStackCallBLAS("BLASaxpy",BLASaxpy_(&blasnmi, &w, &r[i + ldr*(i+1)], &blasldr, &z[i+1], &blas1));
50         PetscStackCallBLAS("BLASasum",s += BLASasum_(&blasnmi, &z[i+1], &blas1));
51       }
52       if (s < sm) {
53         temp = wm - w;
54         w = wm;
55         if (i < n-1) {
56           PetscStackCallBLAS("BLASaxpy",BLASaxpy_(&blasnmi, &temp, &r[i + ldr*(i+1)], &blasldr, &z[i+1], &blas1));
57         }
58       }
59       z[i] = w;
60     }
61 
62     PetscStackCallBLAS("BLASnrm2",ynorm = BLASnrm2_(&blasn, z, &blas1));
63 
64     /* Solve R*z = y */
65     for (j=n-1; j>=0; j--) {
66       /* Scale z */
67       if (PetscAbs(z[j]) > PetscAbs(r[j + ldr*j])) {
68         temp = PetscMin(0.01, PetscAbs(r[j + ldr*j] / z[j]));
69         PetscStackCallBLAS("BLASscal",BLASscal_(&blasn, &temp, z, &blas1));
70         ynorm *=temp;
71       }
72       if (r[j + ldr*j] == 0) {
73         z[j] = 1.0;
74       } else {
75         z[j] = z[j] / r[j + ldr*j];
76       }
77       temp = -z[j];
78       PetscCall(PetscBLASIntCast(j,&blasj));
79       PetscStackCallBLAS("BLASaxpy",BLASaxpy_(&blasj,&temp,&r[0+ldr*j],&blas1,z,&blas1));
80     }
81 
82     /* Compute svmin and normalize z */
83     PetscStackCallBLAS("BLASnrm2",znorm = 1.0 / BLASnrm2_(&blasn, z, &blas1));
84     *svmin = ynorm*znorm;
85     PetscStackCallBLAS("BLASscal",BLASscal_(&blasn, &znorm, z, &blas1));
86   }
87   PetscFunctionReturn(0);
88 }
89 
90 /*
91 c     ***********
92 c
93 c     Subroutine gqt
94 c
95 c     Given an n by n symmetric matrix A, an n-vector b, and a
96 c     positive number delta, this subroutine determines a vector
97 c     x which approximately minimizes the quadratic function
98 c
99 c           f(x) = (1/2)*x'*A*x + b'*x
100 c
101 c     subject to the Euclidean norm constraint
102 c
103 c           norm(x) <= delta.
104 c
105 c     This subroutine computes an approximation x and a Lagrange
106 c     multiplier par such that either par is zero and
107 c
108 c            norm(x) <= (1+rtol)*delta,
109 c
110 c     or par is positive and
111 c
112 c            abs(norm(x) - delta) <= rtol*delta.
113 c
114 c     If xsol is the solution to the problem, the approximation x
115 c     satisfies
116 c
117 c            f(x) <= ((1 - rtol)**2)*f(xsol)
118 c
119 c     The subroutine statement is
120 c
121 c       subroutine gqt(n,a,lda,b,delta,rtol,atol,itmax,
122 c                        par,f,x,info,z,wa1,wa2)
123 c
124 c     where
125 c
126 c       n is an integer variable.
127 c         On entry n is the order of A.
128 c         On exit n is unchanged.
129 c
130 c       a is a double precision array of dimension (lda,n).
131 c         On entry the full upper triangle of a must contain the
132 c            full upper triangle of the symmetric matrix A.
133 c         On exit the array contains the matrix A.
134 c
135 c       lda is an integer variable.
136 c         On entry lda is the leading dimension of the array a.
137 c         On exit lda is unchanged.
138 c
139 c       b is an double precision array of dimension n.
140 c         On entry b specifies the linear term in the quadratic.
141 c         On exit b is unchanged.
142 c
143 c       delta is a double precision variable.
144 c         On entry delta is a bound on the Euclidean norm of x.
145 c         On exit delta is unchanged.
146 c
147 c       rtol is a double precision variable.
148 c         On entry rtol is the relative accuracy desired in the
149 c            solution. Convergence occurs if
150 c
151 c              f(x) <= ((1 - rtol)**2)*f(xsol)
152 c
153 c         On exit rtol is unchanged.
154 c
155 c       atol is a double precision variable.
156 c         On entry atol is the absolute accuracy desired in the
157 c            solution. Convergence occurs when
158 c
159 c              norm(x) <= (1 + rtol)*delta
160 c
161 c              max(-f(x),-f(xsol)) <= atol
162 c
163 c         On exit atol is unchanged.
164 c
165 c       itmax is an integer variable.
166 c         On entry itmax specifies the maximum number of iterations.
167 c         On exit itmax is unchanged.
168 c
169 c       par is a double precision variable.
170 c         On entry par is an initial estimate of the Lagrange
171 c            multiplier for the constraint norm(x) <= delta.
172 c         On exit par contains the final estimate of the multiplier.
173 c
174 c       f is a double precision variable.
175 c         On entry f need not be specified.
176 c         On exit f is set to f(x) at the output x.
177 c
178 c       x is a double precision array of dimension n.
179 c         On entry x need not be specified.
180 c         On exit x is set to the final estimate of the solution.
181 c
182 c       info is an integer variable.
183 c         On entry info need not be specified.
184 c         On exit info is set as follows:
185 c
186 c            info = 1  The function value f(x) has the relative
187 c                      accuracy specified by rtol.
188 c
189 c            info = 2  The function value f(x) has the absolute
190 c                      accuracy specified by atol.
191 c
192 c            info = 3  Rounding errors prevent further progress.
193 c                      On exit x is the best available approximation.
194 c
195 c            info = 4  Failure to converge after itmax iterations.
196 c                      On exit x is the best available approximation.
197 c
198 c       z is a double precision work array of dimension n.
199 c
200 c       wa1 is a double precision work array of dimension n.
201 c
202 c       wa2 is a double precision work array of dimension n.
203 c
204 c     Subprograms called
205 c
206 c       MINPACK-2  ......  destsv
207 c
208 c       LAPACK  .........  dpotrf
209 c
210 c       Level 1 BLAS  ...  daxpy, dcopy, ddot, dnrm2, dscal
211 c
212 c       Level 2 BLAS  ...  dtrmv, dtrsv
213 c
214 c     MINPACK-2 Project. October 1993.
215 c     Argonne National Laboratory and University of Minnesota.
216 c     Brett M. Averick, Richard Carter, and Jorge J. More'
217 c
218 c     ***********
219 */
220 PetscErrorCode gqt(PetscInt n, PetscReal *a, PetscInt lda, PetscReal *b,
221                    PetscReal delta, PetscReal rtol, PetscReal atol,
222                    PetscInt itmax, PetscReal *retpar, PetscReal *retf,
223                    PetscReal *x, PetscInt *retinfo, PetscInt *retits,
224                    PetscReal *z, PetscReal *wa1, PetscReal *wa2)
225 {
226   PetscReal      f=0.0,p001=0.001,p5=0.5,minusone=-1,delta2=delta*delta;
227   PetscInt       iter, j, rednc,info;
228   PetscBLASInt   indef;
229   PetscBLASInt   blas1=1, blasn, iblas, blaslda, blasldap1, blasinfo;
230   PetscReal      alpha, anorm, bnorm, parc, parf, parl, pars, par=*retpar,paru, prod, rxnorm, rznorm=0.0, temp, xnorm;
231 
232   PetscFunctionBegin;
233   PetscCall(PetscBLASIntCast(n,&blasn));
234   PetscCall(PetscBLASIntCast(lda,&blaslda));
235   PetscCall(PetscBLASIntCast(lda+1,&blasldap1));
236   parf   = 0.0;
237   xnorm  = 0.0;
238   rxnorm = 0.0;
239   rednc  = 0;
240   for (j=0; j<n; j++) {
241     x[j] = 0.0;
242     z[j] = 0.0;
243   }
244 
245   /* Copy the diagonal and save A in its lower triangle */
246   PetscStackCallBLAS("BLAScopy",BLAScopy_(&blasn,a,&blasldap1, wa1, &blas1));
247   for (j=0;j<n-1;j++) {
248     PetscCall(PetscBLASIntCast(n - j - 1,&iblas));
249     PetscStackCallBLAS("BLAScopy",BLAScopy_(&iblas,&a[j + lda*(j+1)], &blaslda, &a[j+1 + lda*j], &blas1));
250   }
251 
252   /* Calculate the l1-norm of A, the Gershgorin row sums, and the
253    l2-norm of b */
254   anorm = 0.0;
255   for (j=0;j<n;j++) {
256     PetscStackCallBLAS("BLASasum",wa2[j] = BLASasum_(&blasn, &a[0 + lda*j], &blas1));CHKMEMQ;
257     anorm = PetscMax(anorm,wa2[j]);
258   }
259   for (j=0;j<n;j++) {
260     wa2[j] = wa2[j] - PetscAbs(wa1[j]);
261   }
262   PetscStackCallBLAS("BLASnrm2",bnorm = BLASnrm2_(&blasn,b,&blas1));CHKMEMQ;
263   /* Calculate a lower bound, pars, for the domain of the problem.
264    Also calculate an upper bound, paru, and a lower bound, parl,
265    for the Lagrange multiplier. */
266   pars = parl = paru = -anorm;
267   for (j=0;j<n;j++) {
268     pars = PetscMax(pars, -wa1[j]);
269     parl = PetscMax(parl, wa1[j] + wa2[j]);
270     paru = PetscMax(paru, -wa1[j] + wa2[j]);
271   }
272   parl = PetscMax(bnorm/delta - parl,pars);
273   parl = PetscMax(0.0,parl);
274   paru = PetscMax(0.0, bnorm/delta + paru);
275 
276   /* If the input par lies outside of the interval (parl, paru),
277    set par to the closer endpoint. */
278 
279   par = PetscMax(par,parl);
280   par = PetscMin(par,paru);
281 
282   /* Special case: parl == paru */
283   paru = PetscMax(paru, (1.0 + rtol)*parl);
284 
285   /* Beginning of an iteration */
286 
287   info = 0;
288   for (iter=1;iter<=itmax;iter++) {
289     /* Safeguard par */
290     if (par <= pars && paru > 0) {
291       par = PetscMax(p001, PetscSqrtScalar(parl/paru)) * paru;
292     }
293 
294     /* Copy the lower triangle of A into its upper triangle and  compute A + par*I */
295 
296     for (j=0;j<n-1;j++) {
297       PetscCall(PetscBLASIntCast(n - j - 1,&iblas));
298       PetscStackCallBLAS("BLAScopy",BLAScopy_(&iblas,&a[j+1 + j*lda], &blas1,&a[j + (j+1)*lda], &blaslda));
299     }
300     for (j=0;j<n;j++) {
301       a[j + j*lda] = wa1[j] + par;
302     }
303 
304     /* Attempt the Cholesky factorization of A without referencing the lower triangular part. */
305     PetscStackCallBLAS("LAPACKpotrf",LAPACKpotrf_("U",&blasn,a,&blaslda,&indef));
306 
307     /* Case 1: A + par*I is pos. def. */
308     if (indef == 0) {
309 
310       /* Compute an approximate solution x and save the last value of par with A + par*I pos. def. */
311 
312       parf = par;
313       PetscStackCallBLAS("BLAScopy",BLAScopy_(&blasn, b, &blas1, wa2, &blas1));
314       PetscStackCallBLAS("LAPACKtrtrs",LAPACKtrtrs_("U","T","N",&blasn,&blas1,a,&blaslda,wa2,&blasn,&blasinfo));
315       PetscCheck(!blasinfo,PETSC_COMM_SELF,PETSC_ERR_LIB,"LAPACKtrtrs() returned info %d",blasinfo);
316       PetscStackCallBLAS("BLASnrm2",rxnorm = BLASnrm2_(&blasn, wa2, &blas1));
317       PetscStackCallBLAS("LAPACKtrtrs",LAPACKtrtrs_("U","N","N",&blasn,&blas1,a,&blaslda,wa2,&blasn,&blasinfo));
318       PetscCheck(!blasinfo,PETSC_COMM_SELF,PETSC_ERR_LIB,"LAPACKtrtrs() returned info %d",blasinfo);
319 
320       PetscStackCallBLAS("BLAScopy",BLAScopy_(&blasn, wa2, &blas1, x, &blas1));
321       PetscStackCallBLAS("BLASscal",BLASscal_(&blasn, &minusone, x, &blas1));
322       PetscStackCallBLAS("BLASnrm2",xnorm = BLASnrm2_(&blasn, x, &blas1));CHKMEMQ;
323 
324       /* Test for convergence */
325       if (PetscAbs(xnorm - delta) <= rtol*delta || (par == 0  && xnorm <= (1.0+rtol)*delta)) {
326         info = 1;
327       }
328 
329       /* Compute a direction of negative curvature and use this information to improve pars. */
330       PetscCall(estsv(n,a,lda,&rznorm,z));CHKMEMQ;
331       pars = PetscMax(pars, par-rznorm*rznorm);
332 
333       /* Compute a negative curvature solution of the form x + alpha*z,  where norm(x+alpha*z)==delta */
334 
335       rednc = 0;
336       if (xnorm < delta) {
337         /* Compute alpha */
338         PetscStackCallBLAS("BLASdot",prod = BLASdot_(&blasn, z, &blas1, x, &blas1)/delta);
339         temp = (delta - xnorm)*((delta + xnorm)/delta);
340         alpha = temp/(PetscAbs(prod) + PetscSqrtScalar(prod*prod + temp/delta));
341         if (prod >= 0) alpha = PetscAbs(alpha);
342         else alpha =-PetscAbs(alpha);
343 
344         /* Test to decide if the negative curvature step produces a larger reduction than with z=0 */
345         rznorm = PetscAbs(alpha) * rznorm;
346         if ((rznorm*rznorm + par*xnorm*xnorm)/(delta2) <= par) {
347           rednc = 1;
348         }
349         /* Test for convergence */
350         if (p5 * rznorm*rznorm / delta2 <= rtol*(1.0-p5*rtol)*(par + rxnorm*rxnorm/delta2)) {
351           info = 1;
352         } else if (info == 0 && (p5*(par + rxnorm*rxnorm/delta2) <= atol/delta2)) {
353           info = 2;
354         }
355       }
356 
357       /* Compute the Newton correction parc to par. */
358       if (xnorm == 0) {
359         parc = -par;
360       } else {
361         PetscStackCallBLAS("BLAScopy",BLAScopy_(&blasn, x, &blas1, wa2, &blas1));
362         temp = 1.0/xnorm;
363         PetscStackCallBLAS("BLASscal",BLASscal_(&blasn, &temp, wa2, &blas1));
364         PetscStackCallBLAS("LAPACKtrtrs",LAPACKtrtrs_("U","T","N",&blasn, &blas1, a, &blaslda, wa2, &blasn, &blasinfo));
365         PetscCheck(!blasinfo,PETSC_COMM_SELF,PETSC_ERR_LIB,"LAPACKtrtrs() returned info %d",blasinfo);
366         PetscStackCallBLAS("BLASnrm2",temp = BLASnrm2_(&blasn, wa2, &blas1));
367         parc = (xnorm - delta)/(delta*temp*temp);
368       }
369 
370       /* update parl or paru */
371       if (xnorm > delta) {
372         parl = PetscMax(parl, par);
373       } else if (xnorm < delta) {
374         paru = PetscMin(paru, par);
375       }
376     } else {
377       /* Case 2: A + par*I is not pos. def. */
378 
379       /* Use the rank information from the Cholesky decomposition to update par. */
380 
381       if (indef > 1) {
382         /* Restore column indef to A + par*I. */
383         iblas = indef - 1;
384         PetscStackCallBLAS("BLAScopy",BLAScopy_(&iblas,&a[indef-1 + 0*lda],&blaslda,&a[0 + (indef-1)*lda],&blas1));
385         a[indef-1 + (indef-1)*lda] = wa1[indef-1] + par;
386 
387         /* compute parc. */
388         PetscStackCallBLAS("BLAScopy",BLAScopy_(&iblas,&a[0 + (indef-1)*lda], &blas1, wa2, &blas1));
389         PetscStackCallBLAS("LAPACKtrtrs",LAPACKtrtrs_("U","T","N",&iblas,&blas1,a,&blaslda,wa2,&blasn,&blasinfo));
390         PetscCheck(!blasinfo,PETSC_COMM_SELF,PETSC_ERR_LIB,"LAPACKtrtrs() returned info %d",blasinfo);
391         PetscStackCallBLAS("BLAScopy",BLAScopy_(&iblas,wa2,&blas1,&a[0 + (indef-1)*lda],&blas1));
392         PetscStackCallBLAS("BLASnrm2",temp = BLASnrm2_(&iblas,&a[0 + (indef-1)*lda],&blas1));CHKMEMQ;
393         a[indef-1 + (indef-1)*lda] -= temp*temp;
394         PetscStackCallBLAS("LAPACKtrtrs",LAPACKtrtrs_("U","N","N",&iblas,&blas1,a,&blaslda,wa2,&blasn,&blasinfo));
395         PetscCheck(!blasinfo,PETSC_COMM_SELF,PETSC_ERR_LIB,"LAPACKtrtrs() returned info %d",blasinfo);
396       }
397 
398       wa2[indef-1] = -1.0;
399       iblas = indef;
400       PetscStackCallBLAS("BLASnrm2",temp = BLASnrm2_(&iblas,wa2,&blas1));
401       parc = - a[indef-1 + (indef-1)*lda]/(temp*temp);
402       pars = PetscMax(pars,par+parc);
403 
404       /* If necessary, increase paru slightly.
405        This is needed because in some exceptional situations
406        paru is the optimal value of par. */
407 
408       paru = PetscMax(paru, (1.0+rtol)*pars);
409     }
410 
411     /* Use pars to update parl */
412     parl = PetscMax(parl,pars);
413 
414     /* Test for converged. */
415     if (info == 0) {
416       if (iter == itmax) info=4;
417       if (paru <= (1.0+p5*rtol)*pars) info=3;
418       if (paru == 0.0) info = 2;
419     }
420 
421     /* If exiting, store the best approximation and restore
422      the upper triangle of A. */
423 
424     if (info != 0) {
425       /* Compute the best current estimates for x and f. */
426       par = parf;
427       f = -p5 * (rxnorm*rxnorm + par*xnorm*xnorm);
428       if (rednc) {
429         f = -p5 * (rxnorm*rxnorm + par*delta*delta - rznorm*rznorm);
430         PetscStackCallBLAS("BLASaxpy",BLASaxpy_(&blasn, &alpha, z, &blas1, x, &blas1));
431       }
432       /* Restore the upper triangle of A */
433       for (j = 0; j<n; j++) {
434         PetscCall(PetscBLASIntCast(n - j - 1,&iblas));
435         PetscStackCallBLAS("BLAScopy",BLAScopy_(&iblas,&a[j+1 + j*lda],&blas1, &a[j + (j+1)*lda],&blaslda));
436       }
437       PetscCall(PetscBLASIntCast(lda+1,&iblas));
438       PetscStackCallBLAS("BLAScopy",BLAScopy_(&blasn,wa1,&blas1,a,&iblas));
439       break;
440     }
441     par = PetscMax(parl,par+parc);
442   }
443   *retpar  = par;
444   *retf    = f;
445   *retinfo = info;
446   *retits  = iter;
447   CHKMEMQ;
448   PetscFunctionReturn(0);
449 }
450