xref: /petsc/src/snes/impls/qn/qn.c (revision b21d5a53bf502312e62816a78e24953477e13656)
14b11644fSPeter Brune #include <private/snesimpl.h>
24b11644fSPeter Brune 
34b11644fSPeter Brune typedef struct {
44b11644fSPeter Brune   Vec *dX;           /* The change in X */
53af51624SPeter Brune   Vec *dD;           /* The change in F */
64b11644fSPeter Brune   PetscInt m;         /* the number of kept previous steps */
7bd052dfeSPeter Brune   PetscScalar *alpha;
8bd052dfeSPeter Brune   PetscScalar *beta;
9bd052dfeSPeter Brune   PetscScalar *rho;
1044f7e39eSPeter Brune   PetscViewer monitor;
115ba6227bSPeter Brune   PetscReal gamma;    /* Powell restart constant */
12*b21d5a53SPeter Brune   PetscReal scaling;  /* scaling of H0 */
139f83bee8SJed Brown } SNES_QN;
144b11644fSPeter Brune 
154b11644fSPeter Brune #undef __FUNCT__
164b11644fSPeter Brune #define __FUNCT__ "LBGFSApplyJinv_Private"
173af51624SPeter Brune PetscErrorCode LBGFSApplyJinv_Private(SNES snes, PetscInt it, Vec D, Vec Y) {
184b11644fSPeter Brune 
194b11644fSPeter Brune   PetscErrorCode ierr;
204b11644fSPeter Brune 
219f83bee8SJed Brown   SNES_QN *qn = (SNES_QN*)snes->data;
224b11644fSPeter Brune 
234b11644fSPeter Brune   Vec *dX = qn->dX;
243af51624SPeter Brune   Vec *dD = qn->dD;
254b11644fSPeter Brune 
26bd052dfeSPeter Brune   PetscScalar *alpha = qn->alpha;
27bd052dfeSPeter Brune   PetscScalar *beta = qn->beta;
28bd052dfeSPeter Brune   PetscScalar *rho = qn->rho;
29bd052dfeSPeter Brune 
304b11644fSPeter Brune   PetscInt k, i;
314b11644fSPeter Brune   PetscInt m = qn->m;
324b11644fSPeter Brune   PetscScalar t;
334b11644fSPeter Brune   PetscInt l = m;
344b11644fSPeter Brune 
35*b21d5a53SPeter Brune   Vec         X = snes->vec_sol;
36*b21d5a53SPeter Brune 
374b11644fSPeter Brune   PetscFunctionBegin;
384b11644fSPeter Brune 
393af51624SPeter Brune   ierr = VecCopy(D, Y);CHKERRQ(ierr);
404b11644fSPeter Brune 
415ba6227bSPeter Brune   if (it < m) l = it;
424b11644fSPeter Brune 
434b11644fSPeter Brune   /* outward recursion starting at iteration k's update and working back */
444b11644fSPeter Brune   for (i = 0; i < l; i++) {
45*b21d5a53SPeter Brune     k = (it - i - 1) % l;
463af51624SPeter Brune     ierr = VecDot(dX[k], Y, &t);CHKERRQ(ierr);
47bd052dfeSPeter Brune     alpha[k] = t*rho[k];
4844f7e39eSPeter Brune     if (qn->monitor) {
493af51624SPeter Brune       ierr = PetscViewerASCIIAddTab(qn->monitor,((PetscObject)snes)->tablevel+2);CHKERRQ(ierr);
505ba6227bSPeter Brune       ierr = PetscViewerASCIIPrintf(qn->monitor, "it: %d k: %d alpha:        %14.12e\n", it, k, PetscRealPart(alpha[k]));CHKERRQ(ierr);
513af51624SPeter Brune       ierr = PetscViewerASCIISubtractTab(qn->monitor,((PetscObject)snes)->tablevel+2);CHKERRQ(ierr);
5244f7e39eSPeter Brune     }
533af51624SPeter Brune     ierr = VecAXPY(Y, -alpha[k], dD[k]);CHKERRQ(ierr);
544b11644fSPeter Brune   }
554b11644fSPeter Brune 
56*b21d5a53SPeter Brune   ierr = VecScale(Y, qn->scaling);CHKERRQ(ierr);
57*b21d5a53SPeter Brune 
584b11644fSPeter Brune   /* inward recursion starting at the first update and working forward */
59bd052dfeSPeter Brune   for (i = 0; i < l; i++) {
60*b21d5a53SPeter Brune     k = (it + i - l) % l;
613af51624SPeter Brune     ierr = VecDot(dD[k], Y, &t);CHKERRQ(ierr);
624b11644fSPeter Brune     beta[k] = rho[k]*t;
633af51624SPeter Brune     ierr = VecAXPY(Y, (alpha[k] - beta[k]), dX[k]);
6444f7e39eSPeter Brune     if (qn->monitor) {
653af51624SPeter Brune       ierr = PetscViewerASCIIAddTab(qn->monitor,((PetscObject)snes)->tablevel+2);CHKERRQ(ierr);
665ba6227bSPeter Brune       ierr = PetscViewerASCIIPrintf(qn->monitor, "it: %d k: %d alpha - beta: %14.12e\n", it, k, PetscRealPart(alpha[k] - beta[k]));CHKERRQ(ierr);
673af51624SPeter Brune       ierr = PetscViewerASCIISubtractTab(qn->monitor,((PetscObject)snes)->tablevel+2);CHKERRQ(ierr);
6844f7e39eSPeter Brune     }
694b11644fSPeter Brune   }
704b11644fSPeter Brune   PetscFunctionReturn(0);
714b11644fSPeter Brune }
724b11644fSPeter Brune 
734b11644fSPeter Brune #undef __FUNCT__
744b11644fSPeter Brune #define __FUNCT__ "SNESSolve_QN"
754b11644fSPeter Brune static PetscErrorCode SNESSolve_QN(SNES snes)
764b11644fSPeter Brune {
774b11644fSPeter Brune 
784b11644fSPeter Brune   PetscErrorCode ierr;
799f83bee8SJed Brown   SNES_QN *qn = (SNES_QN*) snes->data;
804b11644fSPeter Brune 
8115f5eeeaSPeter Brune   Vec X, Xold;
823af51624SPeter Brune   Vec F, G, B;
833af51624SPeter Brune   Vec W, Y, D, Dold;
843af51624SPeter Brune   SNESConvergedReason reason;
855ba6227bSPeter Brune   PetscInt i, i_r, k;
864b11644fSPeter Brune 
879f3a0142SPeter Brune   PetscReal fnorm, xnorm = 0, ynorm, gnorm;
884b11644fSPeter Brune   PetscInt m = qn->m;
899f3a0142SPeter Brune   PetscBool lssucceed;
904b11644fSPeter Brune 
91bd052dfeSPeter Brune   PetscScalar rhosc;
92bd052dfeSPeter Brune 
93bd052dfeSPeter Brune   Vec *dX = qn->dX;
943af51624SPeter Brune   Vec *dD = qn->dD;
95bd052dfeSPeter Brune   PetscScalar *rho = qn->rho;
96*b21d5a53SPeter Brune   PetscScalar DolddotD, DolddotDold, a, fdotf;
974b11644fSPeter Brune 
984b11644fSPeter Brune   /* basically just a regular newton's method except for the application of the jacobian */
994b11644fSPeter Brune   PetscFunctionBegin;
1004b11644fSPeter Brune 
1019f3a0142SPeter Brune   X             = snes->vec_sol;        /* solution vector */
1029f3a0142SPeter Brune   F             = snes->vec_func;       /* residual vector */
1033af51624SPeter Brune   Y             = snes->vec_sol_update; /* search direction generated by J^-1D*/
1043af51624SPeter Brune   B             = snes->vec_rhs;
10570d3b23bSPeter Brune   G             = snes->work[0];
10670d3b23bSPeter Brune   W             = snes->work[1];
10770d3b23bSPeter Brune   Xold          = snes->work[2];
1083af51624SPeter Brune 
1093af51624SPeter Brune   /* directions generated by the preconditioned problem with F_pre = F or x - M(x, b) */
1103af51624SPeter Brune   D             = snes->work[3];
1113af51624SPeter Brune   Dold          = snes->work[4];
1124b11644fSPeter Brune 
1134b11644fSPeter Brune   snes->reason = SNES_CONVERGED_ITERATING;
1144b11644fSPeter Brune 
1154b11644fSPeter Brune   ierr = PetscObjectTakeAccess(snes);CHKERRQ(ierr);
1164b11644fSPeter Brune   snes->iter = 0;
1174b11644fSPeter Brune   snes->norm = 0.;
1184b11644fSPeter Brune   ierr = PetscObjectGrantAccess(snes);CHKERRQ(ierr);
11915f5eeeaSPeter Brune   ierr = SNESComputeFunction(snes,X,F);CHKERRQ(ierr);
1204b11644fSPeter Brune   if (snes->domainerror) {
1214b11644fSPeter Brune     snes->reason = SNES_DIVERGED_FUNCTION_DOMAIN;
1224b11644fSPeter Brune     PetscFunctionReturn(0);
1234b11644fSPeter Brune   }
12415f5eeeaSPeter Brune   ierr = VecNorm(F, NORM_2, &fnorm);CHKERRQ(ierr); /* fnorm <- ||F||  */
1254b11644fSPeter Brune   if (PetscIsInfOrNanReal(fnorm)) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_FP,"Infinite or not-a-number generated in norm");
1264b11644fSPeter Brune   ierr = PetscObjectTakeAccess(snes);CHKERRQ(ierr);
1274b11644fSPeter Brune   snes->norm = fnorm;
1284b11644fSPeter Brune   ierr = PetscObjectGrantAccess(snes);CHKERRQ(ierr);
1294b11644fSPeter Brune   SNESLogConvHistory(snes,fnorm,0);
1304b11644fSPeter Brune   ierr = SNESMonitor(snes,0,fnorm);CHKERRQ(ierr);
1314b11644fSPeter Brune 
1324b11644fSPeter Brune   /* set parameter for default relative tolerance convergence test */
1334b11644fSPeter Brune    snes->ttol = fnorm*snes->rtol;
1344b11644fSPeter Brune   /* test convergence */
1354b11644fSPeter Brune   ierr = (*snes->ops->converged)(snes,0,0.0,0.0,fnorm,&snes->reason,snes->cnvP);CHKERRQ(ierr);
1364b11644fSPeter Brune   if (snes->reason) PetscFunctionReturn(0);
13770d3b23bSPeter Brune 
138*b21d5a53SPeter Brune   /* initialize the scaling */
139*b21d5a53SPeter Brune   ierr = VecDot(X, F, &fdotf);CHKERRQ(ierr);
140*b21d5a53SPeter Brune   qn->scaling = fdotf;
141*b21d5a53SPeter Brune   ierr = VecDot(F, F, &fdotf);CHKERRQ(ierr);
142*b21d5a53SPeter Brune   qn->scaling /= fdotf;
143*b21d5a53SPeter Brune 
14470d3b23bSPeter Brune   /* initialize the search direction as steepest descent */
1453af51624SPeter Brune   ierr = VecCopy(F, D);CHKERRQ(ierr);
1463af51624SPeter Brune   ierr = VecCopy(D, Y);CHKERRQ(ierr);
147*b21d5a53SPeter Brune   ierr = VecScale(Y, qn->scaling);CHKERRQ(ierr);
1483af51624SPeter Brune 
1495ba6227bSPeter Brune   for(i = 0, i_r = 0; i < snes->max_its; i++, i_r++) {
15070d3b23bSPeter Brune     /* line search for lambda */
15170d3b23bSPeter Brune     ynorm = 1; gnorm = fnorm;
1523af51624SPeter Brune     ierr = VecCopy(D, Dold);CHKERRQ(ierr);
15315f5eeeaSPeter Brune     ierr = VecCopy(X, Xold);CHKERRQ(ierr);
1549f3a0142SPeter Brune     ierr = (*snes->ops->linesearch)(snes,snes->lsP,X,F,Y,fnorm,xnorm,G,W,&ynorm,&gnorm,&lssucceed);CHKERRQ(ierr);
1559f3a0142SPeter Brune     if (snes->reason == SNES_DIVERGED_FUNCTION_COUNT) break;
1569f3a0142SPeter Brune     if (snes->domainerror) {
1579f3a0142SPeter Brune       snes->reason = SNES_DIVERGED_FUNCTION_DOMAIN;
1589f3a0142SPeter Brune       PetscFunctionReturn(0);
1599f3a0142SPeter Brune       }
1609f3a0142SPeter Brune     if (!lssucceed) {
1619f3a0142SPeter Brune       if (++snes->numFailures >= snes->maxFailures) {
1629f3a0142SPeter Brune         snes->reason = SNES_DIVERGED_LINE_SEARCH;
1639f3a0142SPeter Brune         break;
1649f3a0142SPeter Brune       }
1659f3a0142SPeter Brune     }
166*b21d5a53SPeter Brune 
1679f3a0142SPeter Brune     /* Update function and solution vectors */
1689f3a0142SPeter Brune     fnorm = gnorm;
1699f3a0142SPeter Brune     ierr = VecCopy(G,F);CHKERRQ(ierr);
17015f5eeeaSPeter Brune     ierr = VecCopy(W,X);CHKERRQ(ierr);
1713af51624SPeter Brune 
172*b21d5a53SPeter Brune     if (snes->pc) {
173*b21d5a53SPeter Brune       ierr = SNESSolve(snes->pc, snes->vec_rhs, X);CHKERRQ(ierr);
174*b21d5a53SPeter Brune       ierr = SNESComputeFunction(snes, X, F);CHKERRQ(ierr);
175*b21d5a53SPeter Brune       ierr = VecNorm(F, NORM_2, &fnorm);CHKERRQ(ierr);
176*b21d5a53SPeter Brune     }
177*b21d5a53SPeter Brune 
178*b21d5a53SPeter Brune     ierr = PetscInfo4(snes,"fnorm=%18.16e, gnorm=%18.16e, ynorm=%18.16e, lssucceed=%d\n",(double)fnorm,(double)gnorm,(double)ynorm,(int)lssucceed);CHKERRQ(ierr);
179*b21d5a53SPeter Brune 
1804b11644fSPeter Brune     ierr = PetscObjectTakeAccess(snes);CHKERRQ(ierr);
1818409ca45SMatthew G Knepley     snes->iter = i + 1;
1824b11644fSPeter Brune     snes->norm = fnorm;
1834b11644fSPeter Brune     ierr = PetscObjectGrantAccess(snes);CHKERRQ(ierr);
1848409ca45SMatthew G Knepley     SNESLogConvHistory(snes,snes->norm,snes->iter);
1858409ca45SMatthew G Knepley     ierr = SNESMonitor(snes,snes->iter,snes->norm);CHKERRQ(ierr);
1864b11644fSPeter Brune     /* set parameter for default relative tolerance convergence test */
1875ba6227bSPeter Brune     ierr = (*snes->ops->converged)(snes,snes->iter,0.0,0.0,fnorm,&snes->reason,snes->cnvP);CHKERRQ(ierr);
1884b11644fSPeter Brune     if (snes->reason) PetscFunctionReturn(0);
1894b11644fSPeter Brune 
1905ba6227bSPeter Brune     /* create the new direction */
191*b21d5a53SPeter Brune     if (0 && snes->pc) {
1923af51624SPeter Brune       ierr = VecCopy(X, D);CHKERRQ(ierr);
1933af51624SPeter Brune       ierr = SNESSolve(snes->pc, B, D);CHKERRQ(ierr);
1943af51624SPeter Brune       ierr = SNESGetConvergedReason(snes->pc,&reason);CHKERRQ(ierr);
1953af51624SPeter Brune       if (reason < 0 && (reason != SNES_DIVERGED_MAX_IT)) {
1963af51624SPeter Brune         snes->reason = SNES_DIVERGED_INNER;
1973af51624SPeter Brune         PetscFunctionReturn(0);
1983af51624SPeter Brune       }
1993af51624SPeter Brune       ierr = VecAYPX(D,-1.0,X);CHKERRQ(ierr);
2003af51624SPeter Brune     } else {
2013af51624SPeter Brune       ierr = VecCopy(F, D);CHKERRQ(ierr);
2023af51624SPeter Brune     }
2033af51624SPeter Brune 
2045ba6227bSPeter Brune     /* check restart by Powell's Criterion: |D^T H_0 Dold| > 0.2 * |Dold^T H_0 Dold| */
2055ba6227bSPeter Brune     ierr = VecDot(Dold, Dold, &DolddotDold);CHKERRQ(ierr);
2065ba6227bSPeter Brune     ierr = VecDot(Dold, D, &DolddotD);CHKERRQ(ierr);
207*b21d5a53SPeter Brune     if (PetscAbs(PetscRealPart(DolddotD)) > qn->gamma*PetscAbs(PetscRealPart(DolddotDold)) && i_r > 2) {
2085ba6227bSPeter Brune       if (qn->monitor) {
2095ba6227bSPeter Brune         ierr = PetscViewerASCIIAddTab(qn->monitor,((PetscObject)snes)->tablevel+2);CHKERRQ(ierr);
2105ba6227bSPeter Brune         ierr = PetscViewerASCIIPrintf(qn->monitor, "restart! |%14.12e| > %4.2f*|%14.12e|\n", k, PetscRealPart(DolddotD), qn->gamma, PetscRealPart(DolddotDold));CHKERRQ(ierr);
2115ba6227bSPeter Brune         ierr = PetscViewerASCIISubtractTab(qn->monitor,((PetscObject)snes)->tablevel+2);CHKERRQ(ierr);
2125ba6227bSPeter Brune       }
2135ba6227bSPeter Brune       i_r = -1;
2145ba6227bSPeter Brune       /* general purpose update */
2155ba6227bSPeter Brune       if (snes->ops->update) {
2165ba6227bSPeter Brune         ierr = (*snes->ops->update)(snes, snes->iter);CHKERRQ(ierr);
2175ba6227bSPeter Brune       }
2185ba6227bSPeter Brune       ierr = VecCopy(D, Y);CHKERRQ(ierr);
2195ba6227bSPeter Brune     } else {
220bd052dfeSPeter Brune       /* set the differences */
2215ba6227bSPeter Brune       k = i_r % m;
2223af51624SPeter Brune       ierr = VecCopy(D, dD[k]);CHKERRQ(ierr);
2233af51624SPeter Brune       ierr = VecAXPY(dD[k], -1.0, Dold);CHKERRQ(ierr);
22415f5eeeaSPeter Brune       ierr = VecCopy(X, dX[k]);CHKERRQ(ierr);
22515f5eeeaSPeter Brune       ierr = VecAXPY(dX[k], -1.0, Xold);CHKERRQ(ierr);
2263af51624SPeter Brune       ierr = VecDot(dX[k], dD[k], &rhosc);CHKERRQ(ierr);
227bd052dfeSPeter Brune       rho[k] = 1. / rhosc;
228*b21d5a53SPeter Brune       ierr = VecDot(dD[k], dD[k], &a);CHKERRQ(ierr);
229*b21d5a53SPeter Brune       qn->scaling = rhosc / a;
23070d3b23bSPeter Brune 
23170d3b23bSPeter Brune       /* general purpose update */
23270d3b23bSPeter Brune       if (snes->ops->update) {
23370d3b23bSPeter Brune         ierr = (*snes->ops->update)(snes, snes->iter);CHKERRQ(ierr);
23470d3b23bSPeter Brune       }
23570d3b23bSPeter Brune       /* apply the current iteration of the approximate jacobian in order to get the next search direction*/
2365ba6227bSPeter Brune       ierr = LBGFSApplyJinv_Private(snes, i_r+1, D, Y);CHKERRQ(ierr);
2375ba6227bSPeter Brune     }
2384b11644fSPeter Brune }
2394b11644fSPeter Brune   if (i == snes->max_its) {
2404b11644fSPeter Brune     ierr = PetscInfo1(snes, "Maximum number of iterations has been reached: %D\n", snes->max_its);CHKERRQ(ierr);
2414b11644fSPeter Brune     if (!snes->reason) snes->reason = SNES_DIVERGED_MAX_IT;
2424b11644fSPeter Brune   }
2434b11644fSPeter Brune   PetscFunctionReturn(0);
2444b11644fSPeter Brune }
2454b11644fSPeter Brune 
2464b11644fSPeter Brune 
2474b11644fSPeter Brune #undef __FUNCT__
2484b11644fSPeter Brune #define __FUNCT__ "SNESSetUp_QN"
2494b11644fSPeter Brune static PetscErrorCode SNESSetUp_QN(SNES snes)
2504b11644fSPeter Brune {
2519f83bee8SJed Brown   SNES_QN *qn = (SNES_QN*)snes->data;
2524b11644fSPeter Brune   PetscErrorCode ierr;
2534b11644fSPeter Brune   PetscFunctionBegin;
2544b11644fSPeter Brune   ierr = VecDuplicateVecs(snes->vec_sol, qn->m, &qn->dX);CHKERRQ(ierr);
2553af51624SPeter Brune   ierr = VecDuplicateVecs(snes->vec_sol, qn->m, &qn->dD);CHKERRQ(ierr);
256bd052dfeSPeter Brune   ierr = PetscMalloc3(qn->m, PetscScalar, &qn->alpha, qn->m, PetscScalar, &qn->beta, qn->m, PetscScalar, &qn->rho);CHKERRQ(ierr);
2573af51624SPeter Brune   ierr = SNESDefaultGetWork(snes,5);CHKERRQ(ierr);
2584b11644fSPeter Brune   PetscFunctionReturn(0);
2594b11644fSPeter Brune }
2604b11644fSPeter Brune 
2614b11644fSPeter Brune #undef __FUNCT__
2624b11644fSPeter Brune #define __FUNCT__ "SNESReset_QN"
2634b11644fSPeter Brune static PetscErrorCode SNESReset_QN(SNES snes)
2644b11644fSPeter Brune {
2654b11644fSPeter Brune   PetscErrorCode ierr;
2669f83bee8SJed Brown   SNES_QN *qn;
2674b11644fSPeter Brune   PetscFunctionBegin;
2684b11644fSPeter Brune   if (snes->data) {
2699f83bee8SJed Brown     qn = (SNES_QN*)snes->data;
2704b11644fSPeter Brune     if (qn->dX) {
2714b11644fSPeter Brune       ierr = VecDestroyVecs(qn->m, &qn->dX);CHKERRQ(ierr);
2724b11644fSPeter Brune     }
2733af51624SPeter Brune     if (qn->dD) {
2743af51624SPeter Brune       ierr = VecDestroyVecs(qn->m, &qn->dD);CHKERRQ(ierr);
2754b11644fSPeter Brune     }
276bd052dfeSPeter Brune     ierr = PetscFree3(qn->alpha, qn->beta, qn->rho);CHKERRQ(ierr);
2774b11644fSPeter Brune   }
2784b11644fSPeter Brune   PetscFunctionReturn(0);
2794b11644fSPeter Brune }
2804b11644fSPeter Brune 
2814b11644fSPeter Brune #undef __FUNCT__
2824b11644fSPeter Brune #define __FUNCT__ "SNESDestroy_QN"
2834b11644fSPeter Brune static PetscErrorCode SNESDestroy_QN(SNES snes)
2844b11644fSPeter Brune {
2854b11644fSPeter Brune   PetscErrorCode ierr;
2864b11644fSPeter Brune   PetscFunctionBegin;
2874b11644fSPeter Brune   ierr = SNESReset_QN(snes);CHKERRQ(ierr);
2884b11644fSPeter Brune   ierr = PetscFree(snes->data);CHKERRQ(ierr);
2899c05af5eSJed Brown   ierr = PetscObjectComposeFunctionDynamic((PetscObject)snes,"","",PETSC_NULL);CHKERRQ(ierr);
2904b11644fSPeter Brune   PetscFunctionReturn(0);
2914b11644fSPeter Brune }
2924b11644fSPeter Brune 
2934b11644fSPeter Brune #undef __FUNCT__
2944b11644fSPeter Brune #define __FUNCT__ "SNESSetFromOptions_QN"
2954b11644fSPeter Brune static PetscErrorCode SNESSetFromOptions_QN(SNES snes)
2964b11644fSPeter Brune {
2974b11644fSPeter Brune 
2984b11644fSPeter Brune   PetscErrorCode ierr;
2999f83bee8SJed Brown   SNES_QN *qn;
30044f7e39eSPeter Brune   PetscBool monflg = PETSC_FALSE;
3014b11644fSPeter Brune   PetscFunctionBegin;
3024b11644fSPeter Brune 
3039f83bee8SJed Brown   qn = (SNES_QN*)snes->data;
3044b11644fSPeter Brune 
3054b11644fSPeter Brune   ierr = PetscOptionsHead("SNES QN options");CHKERRQ(ierr);
3064b11644fSPeter Brune   ierr = PetscOptionsInt("-snes_qn_m", "Number of past states saved for L-Broyden methods", "SNES", qn->m, &qn->m, PETSC_NULL);CHKERRQ(ierr);
3075ba6227bSPeter Brune   ierr = PetscOptionsReal("-snes_qn_gamma", "Restart condition for L-Broyden methods", "SNES", qn->gamma, &qn->gamma, PETSC_NULL);CHKERRQ(ierr);
30844f7e39eSPeter Brune   ierr = PetscOptionsBool("-snes_qn_monitor", "Monitor for the QN methods", "SNES", monflg, &monflg, PETSC_NULL);CHKERRQ(ierr);
3094b11644fSPeter Brune   ierr = PetscOptionsTail();CHKERRQ(ierr);
31044f7e39eSPeter Brune   if (monflg) {
31144f7e39eSPeter Brune     qn->monitor = PETSC_VIEWER_STDOUT_(((PetscObject)snes)->comm);CHKERRQ(ierr);
31244f7e39eSPeter Brune   }
3134b11644fSPeter Brune   PetscFunctionReturn(0);
3144b11644fSPeter Brune }
3154b11644fSPeter Brune 
31692c02d66SPeter Brune EXTERN_C_BEGIN
31792c02d66SPeter Brune #undef __FUNCT__
31892c02d66SPeter Brune #define __FUNCT__ "SNESLineSearchSetType_QN"
31992c02d66SPeter Brune PetscErrorCode  SNESLineSearchSetType_QN(SNES snes, SNESLineSearchType type)
32092c02d66SPeter Brune {
32192c02d66SPeter Brune   PetscErrorCode ierr;
32292c02d66SPeter Brune   PetscFunctionBegin;
32392c02d66SPeter Brune 
32492c02d66SPeter Brune   switch (type) {
32592c02d66SPeter Brune   case SNES_LS_BASIC:
32692c02d66SPeter Brune     ierr = SNESLineSearchSet(snes,SNESLineSearchNo,PETSC_NULL);CHKERRQ(ierr);
32792c02d66SPeter Brune     break;
32892c02d66SPeter Brune   case SNES_LS_BASIC_NONORMS:
32992c02d66SPeter Brune     ierr = SNESLineSearchSet(snes,SNESLineSearchNoNorms,PETSC_NULL);CHKERRQ(ierr);
33092c02d66SPeter Brune     break;
33192c02d66SPeter Brune   case SNES_LS_QUADRATIC:
332af60355fSPeter Brune     ierr = SNESLineSearchSet(snes,SNESLineSearchQuadraticSecant,PETSC_NULL);CHKERRQ(ierr);
33392c02d66SPeter Brune     break;
334cf9edfecSPeter Brune   case SNES_LS_SECANT:
335cf9edfecSPeter Brune     ierr = SNESLineSearchSet(snes,SNESLineSearchSecant,PETSC_NULL);CHKERRQ(ierr);
336cf9edfecSPeter Brune     break;
33792c02d66SPeter Brune   default:
33892c02d66SPeter Brune     SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP,"Unknown line search type");
33992c02d66SPeter Brune     break;
34092c02d66SPeter Brune   }
34192c02d66SPeter Brune   snes->ls_type = type;
34292c02d66SPeter Brune   PetscFunctionReturn(0);
34392c02d66SPeter Brune }
34492c02d66SPeter Brune EXTERN_C_END
34592c02d66SPeter Brune 
34692c02d66SPeter Brune 
3474b11644fSPeter Brune /* -------------------------------------------------------------------------- */
3484b11644fSPeter Brune /*MC
3494b11644fSPeter Brune       SNESQN - Limited-Memory Quasi-Newton methods for the solution of nonlinear systems.
3504b11644fSPeter Brune 
3516cc8130cSPeter Brune       Options Database:
3526cc8130cSPeter Brune 
3536cc8130cSPeter Brune +     -snes_qn_m - Number of past states saved for the L-Broyden methods.
35444f7e39eSPeter Brune -     -snes_qn_monitor - Monitors the quasi-newton jacobian.
3556cc8130cSPeter Brune 
35644f7e39eSPeter Brune       Notes: This implements the L-BFGS algorithm for the solution of F(x) = b using previous change in F(x) and x to
3576cc8130cSPeter Brune       form the approximate inverse Jacobian using a series of multiplicative rank-one updates.  This will eventually be
3586cc8130cSPeter Brune       generalized to implement several limited-memory Broyden methods.
3596cc8130cSPeter Brune 
3606cc8130cSPeter Brune       References:
3616cc8130cSPeter Brune 
3626cc8130cSPeter Brune       L-Broyden Methods: a generalization of the L-BFGS method to the limited memory Broyden family, M. B. Reed,
3636cc8130cSPeter Brune       International Journal of Computer Mathematics, vol. 86, 2009.
3646cc8130cSPeter Brune 
3654b11644fSPeter Brune 
3664b11644fSPeter Brune       Level: beginner
3674b11644fSPeter Brune 
3684b11644fSPeter Brune .seealso:  SNESCreate(), SNES, SNESSetType(), SNESLS, SNESTR
3696cc8130cSPeter Brune 
3704b11644fSPeter Brune M*/
3714b11644fSPeter Brune EXTERN_C_BEGIN
3724b11644fSPeter Brune #undef __FUNCT__
3734b11644fSPeter Brune #define __FUNCT__ "SNESCreate_QN"
3744b11644fSPeter Brune PetscErrorCode  SNESCreate_QN(SNES snes)
3754b11644fSPeter Brune {
3764b11644fSPeter Brune 
3774b11644fSPeter Brune   PetscErrorCode ierr;
3789f83bee8SJed Brown   SNES_QN *qn;
3794b11644fSPeter Brune 
3804b11644fSPeter Brune   PetscFunctionBegin;
3814b11644fSPeter Brune   snes->ops->setup           = SNESSetUp_QN;
3824b11644fSPeter Brune   snes->ops->solve           = SNESSolve_QN;
3834b11644fSPeter Brune   snes->ops->destroy         = SNESDestroy_QN;
3844b11644fSPeter Brune   snes->ops->setfromoptions  = SNESSetFromOptions_QN;
3854b11644fSPeter Brune   snes->ops->view            = 0;
3864b11644fSPeter Brune   snes->ops->reset           = SNESReset_QN;
3874b11644fSPeter Brune 
38842f4f86dSBarry Smith   snes->usespc          = PETSC_TRUE;
38942f4f86dSBarry Smith   snes->usesksp         = PETSC_FALSE;
39042f4f86dSBarry Smith 
3910e444f03SPeter Brune   snes->max_funcs = 30000;
3920e444f03SPeter Brune   snes->max_its   = 10000;
3930e444f03SPeter Brune 
3949f83bee8SJed Brown   ierr = PetscNewLog(snes,SNES_QN,&qn);CHKERRQ(ierr);
3954b11644fSPeter Brune   snes->data = (void *) qn;
39670d3b23bSPeter Brune   qn->m       = 10;
397*b21d5a53SPeter Brune   qn->scaling = 1.0;
3984b11644fSPeter Brune   qn->dX      = PETSC_NULL;
3993af51624SPeter Brune   qn->dD      = PETSC_NULL;
40044f7e39eSPeter Brune   qn->monitor = PETSC_NULL;
401*b21d5a53SPeter Brune   qn->gamma   = 0.5;
402ea630c6eSPeter Brune 
40392c02d66SPeter Brune   ierr = PetscObjectComposeFunctionDynamic((PetscObject)snes,"SNESLineSearchSetType_C","SNESLineSearchSetType_QN",SNESLineSearchSetType_QN);CHKERRQ(ierr);
404*b21d5a53SPeter Brune   ierr = SNESLineSearchSetType(snes, SNES_LS_SECANT);CHKERRQ(ierr);
4059f3a0142SPeter Brune 
4064b11644fSPeter Brune   PetscFunctionReturn(0);
4074b11644fSPeter Brune }
4084b11644fSPeter Brune EXTERN_C_END
409