xref: /petsc/src/snes/tests/ex1f.F90 (revision a5b23f4acc7afc99d3844ebd5fb65a81c16e8b8c)
1c4762a1bSJed Brown!
2c4762a1bSJed Brown!  Description: This example solves a nonlinear system on 1 processor with SNES.
3c4762a1bSJed Brown!  We solve the  Bratu (SFI - solid fuel ignition) problem in a 2D rectangular
4c4762a1bSJed Brown!  domain.  The command line options include:
5c4762a1bSJed Brown!    -par <parameter>, where <parameter> indicates the nonlinearity of the problem
6c4762a1bSJed Brown!       problem SFI:  <parameter> = Bratu parameter (0 <= par <= 6.81)
7c4762a1bSJed Brown!    -mx <xg>, where <xg> = number of grid points in the x-direction
8c4762a1bSJed Brown!    -my <yg>, where <yg> = number of grid points in the y-direction
9c4762a1bSJed Brown!
10c4762a1bSJed Brown!!/*T
11c4762a1bSJed Brown!  Concepts: SNES^sequential Bratu example
12c4762a1bSJed Brown!  Processors: 1
13c4762a1bSJed Brown!T*/
14c4762a1bSJed Brown
15c4762a1bSJed Brown!
16c4762a1bSJed Brown!  --------------------------------------------------------------------------
17c4762a1bSJed Brown!
18c4762a1bSJed Brown!  Solid Fuel Ignition (SFI) problem.  This problem is modeled by
19c4762a1bSJed Brown!  the partial differential equation
20c4762a1bSJed Brown!
21c4762a1bSJed Brown!          -Laplacian u - lambda*exp(u) = 0,  0 < x,y < 1,
22c4762a1bSJed Brown!
23c4762a1bSJed Brown!  with boundary conditions
24c4762a1bSJed Brown!
25c4762a1bSJed Brown!           u = 0  for  x = 0, x = 1, y = 0, y = 1.
26c4762a1bSJed Brown!
27c4762a1bSJed Brown!  A finite difference approximation with the usual 5-point stencil
28c4762a1bSJed Brown!  is used to discretize the boundary value problem to obtain a nonlinear
29c4762a1bSJed Brown!  system of equations.
30c4762a1bSJed Brown!
31c4762a1bSJed Brown!  The parallel version of this code is snes/tutorials/ex5f.F
32c4762a1bSJed Brown!
33c4762a1bSJed Brown!  --------------------------------------------------------------------------
34c4762a1bSJed Brown      subroutine postcheck(snes,x,y,w,changed_y,changed_w,ctx,ierr)
35c4762a1bSJed Brown#include <petsc/finclude/petscsnes.h>
36c4762a1bSJed Brown      use petscsnes
37c4762a1bSJed Brown      implicit none
38c4762a1bSJed Brown      SNES           snes
39c4762a1bSJed Brown      PetscReal      norm
40c4762a1bSJed Brown      Vec            tmp,x,y,w
41c4762a1bSJed Brown      PetscBool      changed_w,changed_y
42c4762a1bSJed Brown      PetscErrorCode ierr
43c4762a1bSJed Brown      PetscInt       ctx
44c4762a1bSJed Brown      PetscScalar    mone
45c4762a1bSJed Brown
46c4762a1bSJed Brown      call VecDuplicate(x,tmp,ierr)
47c4762a1bSJed Brown      mone = -1.0
48c4762a1bSJed Brown      call VecWAXPY(tmp,mone,x,w,ierr)
49c4762a1bSJed Brown      call VecNorm(tmp,NORM_2,norm,ierr)
50c4762a1bSJed Brown      call VecDestroy(tmp,ierr)
51c4762a1bSJed Brown      print*, 'Norm of search step ',norm
52c4762a1bSJed Brown      changed_y = PETSC_FALSE
53c4762a1bSJed Brown      changed_w = PETSC_FALSE
54c4762a1bSJed Brown      return
55c4762a1bSJed Brown      end
56c4762a1bSJed Brown
57c4762a1bSJed Brown      program main
58c4762a1bSJed Brown#include <petsc/finclude/petscdraw.h>
59c4762a1bSJed Brown      use petscsnes
60c4762a1bSJed Brown      implicit none
6117a42bb7SSatish Balay      interface SNESSetJacobian
6217a42bb7SSatish Balay      subroutine SNESSetJacobian1(a,b,c,d,e,z)
6317a42bb7SSatish Balay       use petscsnes
6417a42bb7SSatish Balay       SNES a
6517a42bb7SSatish Balay       Mat b
6617a42bb7SSatish Balay       Mat c
6717a42bb7SSatish Balay       external d
6817a42bb7SSatish Balay       MatFDColoring e
6917a42bb7SSatish Balay       PetscErrorCode z
7017a42bb7SSatish Balay      end subroutine
7117a42bb7SSatish Balay      subroutine SNESSetJacobian2(a,b,c,d,e,z)
7217a42bb7SSatish Balay       use petscsnes
7317a42bb7SSatish Balay       SNES a
7417a42bb7SSatish Balay       Mat b
7517a42bb7SSatish Balay       Mat c
7617a42bb7SSatish Balay       external d
7717a42bb7SSatish Balay       integer e
7817a42bb7SSatish Balay       PetscErrorCode z
7917a42bb7SSatish Balay      end subroutine
8017a42bb7SSatish Balay      end interface
81c4762a1bSJed Brown!
82c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
83c4762a1bSJed Brown!                   Variable declarations
84c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
85c4762a1bSJed Brown!
86c4762a1bSJed Brown!  Variables:
87c4762a1bSJed Brown!     snes        - nonlinear solver
88c4762a1bSJed Brown!     x, r        - solution, residual vectors
89c4762a1bSJed Brown!     J           - Jacobian matrix
90c4762a1bSJed Brown!     its         - iterations for convergence
91c4762a1bSJed Brown!     matrix_free - flag - 1 indicates matrix-free version
92c4762a1bSJed Brown!     lambda      - nonlinearity parameter
93c4762a1bSJed Brown!     draw        - drawing context
94c4762a1bSJed Brown!
95c4762a1bSJed Brown      SNES               snes
96c4762a1bSJed Brown      MatColoring        mc
97c4762a1bSJed Brown      Vec                x,r
98c4762a1bSJed Brown      PetscDraw               draw
99c4762a1bSJed Brown      Mat                J
100c4762a1bSJed Brown      PetscBool  matrix_free,flg,fd_coloring
101c4762a1bSJed Brown      PetscErrorCode ierr
102c4762a1bSJed Brown      PetscInt   its,N, mx,my,i5
103c4762a1bSJed Brown      PetscMPIInt size,rank
104c4762a1bSJed Brown      PetscReal   lambda_max,lambda_min,lambda
105c4762a1bSJed Brown      MatFDColoring      fdcoloring
106c4762a1bSJed Brown      ISColoring         iscoloring
107c4762a1bSJed Brown      PetscBool          pc
108c4762a1bSJed Brown      external           postcheck
109c4762a1bSJed Brown
110c4762a1bSJed Brown      PetscScalar        lx_v(0:1)
111c4762a1bSJed Brown      PetscOffset        lx_i
112c4762a1bSJed Brown
113c4762a1bSJed Brown!  Store parameters in common block
114c4762a1bSJed Brown
115c4762a1bSJed Brown      common /params/ lambda,mx,my,fd_coloring
116c4762a1bSJed Brown
117c4762a1bSJed Brown!  Note: Any user-defined Fortran routines (such as FormJacobian)
118c4762a1bSJed Brown!  MUST be declared as external.
119c4762a1bSJed Brown
120c4762a1bSJed Brown      external FormFunction,FormInitialGuess,FormJacobian
121c4762a1bSJed Brown
122c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
123c4762a1bSJed Brown!  Initialize program
124c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
125c4762a1bSJed Brown
126c4762a1bSJed Brown      call PetscInitialize(PETSC_NULL_CHARACTER,ierr)
127c4762a1bSJed Brown      if (ierr .ne. 0) then
128c4762a1bSJed Brown        print*,'Unable to initialize PETSc'
129c4762a1bSJed Brown        stop
130c4762a1bSJed Brown      endif
131c4762a1bSJed Brown      call MPI_Comm_size(PETSC_COMM_WORLD,size,ierr)
132c4762a1bSJed Brown      call MPI_Comm_rank(PETSC_COMM_WORLD,rank,ierr)
133c4762a1bSJed Brown
134c4762a1bSJed Brown      if (size .ne. 1) then; SETERRA(PETSC_COMM_SELF,PETSC_ERR_WRONG_MPI_SIZE,'This is a uniprocessor example only'); endif
135c4762a1bSJed Brown
136c4762a1bSJed Brown!  Initialize problem parameters
137c4762a1bSJed Brown      i5 = 5
138c4762a1bSJed Brown      lambda_max = 6.81
139c4762a1bSJed Brown      lambda_min = 0.0
140c4762a1bSJed Brown      lambda     = 6.0
141c4762a1bSJed Brown      mx         = 4
142c4762a1bSJed Brown      my         = 4
143c4762a1bSJed Brown      call PetscOptionsGetInt(PETSC_NULL_OPTIONS,PETSC_NULL_CHARACTER,'-mx',mx,flg,ierr)
144c4762a1bSJed Brown      call PetscOptionsGetInt(PETSC_NULL_OPTIONS,PETSC_NULL_CHARACTER,'-my',my,flg,ierr)
145c4762a1bSJed Brown      call PetscOptionsGetReal(PETSC_NULL_OPTIONS,PETSC_NULL_CHARACTER,'-par',lambda,flg,ierr)
146c4762a1bSJed Brown      if (lambda .ge. lambda_max .or. lambda .le. lambda_min) then; SETERRA(PETSC_COMM_SELF,PETSC_ERR_USER,'Lambda out of range '); endif
147c4762a1bSJed Brown      N  = mx*my
148c4762a1bSJed Brown      pc = PETSC_FALSE
149c4762a1bSJed Brown      call PetscOptionsGetBool(PETSC_NULL_OPTIONS,PETSC_NULL_CHARACTER,'-pc',pc,PETSC_NULL_BOOL,ierr);
150c4762a1bSJed Brown
151c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
152c4762a1bSJed Brown!  Create nonlinear solver context
153c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
154c4762a1bSJed Brown
155c4762a1bSJed Brown      call SNESCreate(PETSC_COMM_WORLD,snes,ierr)
156c4762a1bSJed Brown
157c4762a1bSJed Brown      if (pc .eqv. PETSC_TRUE) then
158c4762a1bSJed Brown        call SNESSetType(snes,SNESNEWTONTR,ierr)
159c4762a1bSJed Brown        call SNESNewtonTRSetPostCheck(snes, postcheck,snes,ierr)
160c4762a1bSJed Brown      endif
161c4762a1bSJed Brown
162c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
163c4762a1bSJed Brown!  Create vector data structures; set function evaluation routine
164c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
165c4762a1bSJed Brown
166c4762a1bSJed Brown      call VecCreate(PETSC_COMM_WORLD,x,ierr)
167c4762a1bSJed Brown      call VecSetSizes(x,PETSC_DECIDE,N,ierr)
168c4762a1bSJed Brown      call VecSetFromOptions(x,ierr)
169c4762a1bSJed Brown      call VecDuplicate(x,r,ierr)
170c4762a1bSJed Brown
171c4762a1bSJed Brown!  Set function evaluation routine and vector.  Whenever the nonlinear
172c4762a1bSJed Brown!  solver needs to evaluate the nonlinear function, it will call this
173c4762a1bSJed Brown!  routine.
174c4762a1bSJed Brown!   - Note that the final routine argument is the user-defined
175c4762a1bSJed Brown!     context that provides application-specific data for the
176c4762a1bSJed Brown!     function evaluation routine.
177c4762a1bSJed Brown
178c4762a1bSJed Brown      call SNESSetFunction(snes,r,FormFunction,fdcoloring,ierr)
179c4762a1bSJed Brown
180c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
181c4762a1bSJed Brown!  Create matrix data structure; set Jacobian evaluation routine
182c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
183c4762a1bSJed Brown
184c4762a1bSJed Brown!  Create matrix. Here we only approximately preallocate storage space
185c4762a1bSJed Brown!  for the Jacobian.  See the users manual for a discussion of better
186c4762a1bSJed Brown!  techniques for preallocating matrix memory.
187c4762a1bSJed Brown
188c4762a1bSJed Brown      call PetscOptionsHasName(PETSC_NULL_OPTIONS,PETSC_NULL_CHARACTER,'-snes_mf',matrix_free,ierr)
189c4762a1bSJed Brown      if (.not. matrix_free) then
190c4762a1bSJed Brown        call MatCreateSeqAIJ(PETSC_COMM_WORLD,N,N,i5,PETSC_NULL_INTEGER,J,ierr)
191c4762a1bSJed Brown      endif
192c4762a1bSJed Brown
193c4762a1bSJed Brown!
194c4762a1bSJed Brown!     This option will cause the Jacobian to be computed via finite differences
195c4762a1bSJed Brown!    efficiently using a coloring of the columns of the matrix.
196c4762a1bSJed Brown!
197c4762a1bSJed Brown      fd_coloring = .false.
198c4762a1bSJed Brown      call PetscOptionsHasName(PETSC_NULL_OPTIONS,PETSC_NULL_CHARACTER,'-snes_fd_coloring',fd_coloring,ierr)
199c4762a1bSJed Brown      if (fd_coloring) then
200c4762a1bSJed Brown
201c4762a1bSJed Brown!
202c4762a1bSJed Brown!      This initializes the nonzero structure of the Jacobian. This is artificial
203c4762a1bSJed Brown!      because clearly if we had a routine to compute the Jacobian we won't need
204c4762a1bSJed Brown!      to use finite differences.
205c4762a1bSJed Brown!
206c4762a1bSJed Brown        call FormJacobian(snes,x,J,J,0,ierr)
207c4762a1bSJed Brown!
208c4762a1bSJed Brown!       Color the matrix, i.e. determine groups of columns that share no common
209*a5b23f4aSJose E. Roman!      rows. These columns in the Jacobian can all be computed simultaneously.
210c4762a1bSJed Brown!
211c4762a1bSJed Brown        call MatColoringCreate(J,mc,ierr)
212c4762a1bSJed Brown        call MatColoringSetType(mc,MATCOLORINGNATURAL,ierr)
213c4762a1bSJed Brown        call MatColoringSetFromOptions(mc,ierr)
214c4762a1bSJed Brown        call MatColoringApply(mc,iscoloring,ierr)
215c4762a1bSJed Brown        call MatColoringDestroy(mc,ierr)
216c4762a1bSJed Brown!
217c4762a1bSJed Brown!       Create the data structure that SNESComputeJacobianDefaultColor() uses
218c4762a1bSJed Brown!       to compute the actual Jacobians via finite differences.
219c4762a1bSJed Brown!
220c4762a1bSJed Brown        call MatFDColoringCreate(J,iscoloring,fdcoloring,ierr)
221c4762a1bSJed Brown        call MatFDColoringSetFunction(fdcoloring,FormFunction,fdcoloring,ierr)
222c4762a1bSJed Brown        call MatFDColoringSetFromOptions(fdcoloring,ierr)
223c4762a1bSJed Brown        call MatFDColoringSetUp(J,iscoloring,fdcoloring,ierr)
224c4762a1bSJed Brown!
225c4762a1bSJed Brown!        Tell SNES to use the routine SNESComputeJacobianDefaultColor()
226c4762a1bSJed Brown!      to compute Jacobians.
227c4762a1bSJed Brown!
228c4762a1bSJed Brown        call SNESSetJacobian(snes,J,J,SNESComputeJacobianDefaultColor,fdcoloring,ierr)
229c4762a1bSJed Brown        call ISColoringDestroy(iscoloring,ierr)
230c4762a1bSJed Brown
231c4762a1bSJed Brown      else if (.not. matrix_free) then
232c4762a1bSJed Brown
233c4762a1bSJed Brown!  Set Jacobian matrix data structure and default Jacobian evaluation
234c4762a1bSJed Brown!  routine.  Whenever the nonlinear solver needs to compute the
235c4762a1bSJed Brown!  Jacobian matrix, it will call this routine.
236c4762a1bSJed Brown!   - Note that the final routine argument is the user-defined
237c4762a1bSJed Brown!     context that provides application-specific data for the
238c4762a1bSJed Brown!     Jacobian evaluation routine.
239c4762a1bSJed Brown!   - The user can override with:
240c4762a1bSJed Brown!      -snes_fd : default finite differencing approximation of Jacobian
241c4762a1bSJed Brown!      -snes_mf : matrix-free Newton-Krylov method with no preconditioning
242c4762a1bSJed Brown!                 (unless user explicitly sets preconditioner)
243c4762a1bSJed Brown!      -snes_mf_operator : form preconditioning matrix as set by the user,
244c4762a1bSJed Brown!                          but use matrix-free approx for Jacobian-vector
245c4762a1bSJed Brown!                          products within Newton-Krylov method
246c4762a1bSJed Brown!
247c4762a1bSJed Brown        call SNESSetJacobian(snes,J,J,FormJacobian,0,ierr)
248c4762a1bSJed Brown      endif
249c4762a1bSJed Brown
250c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
251c4762a1bSJed Brown!  Customize nonlinear solver; set runtime options
252c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
253c4762a1bSJed Brown
254c4762a1bSJed Brown!  Set runtime options (e.g., -snes_monitor -snes_rtol <rtol> -ksp_type <type>)
255c4762a1bSJed Brown
256c4762a1bSJed Brown      call SNESSetFromOptions(snes,ierr)
257c4762a1bSJed Brown
258c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
259c4762a1bSJed Brown!  Evaluate initial guess; then solve nonlinear system.
260c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
261c4762a1bSJed Brown
262c4762a1bSJed Brown!  Note: The user should initialize the vector, x, with the initial guess
263c4762a1bSJed Brown!  for the nonlinear solver prior to calling SNESSolve().  In particular,
264c4762a1bSJed Brown!  to employ an initial guess of zero, the user should explicitly set
265c4762a1bSJed Brown!  this vector to zero by calling VecSet().
266c4762a1bSJed Brown
267c4762a1bSJed Brown      call FormInitialGuess(x,ierr)
268c4762a1bSJed Brown      call SNESSolve(snes,PETSC_NULL_VEC,x,ierr)
269c4762a1bSJed Brown      call SNESGetIterationNumber(snes,its,ierr);
270c4762a1bSJed Brown      if (rank .eq. 0) then
271c4762a1bSJed Brown         write(6,100) its
272c4762a1bSJed Brown      endif
273c4762a1bSJed Brown  100 format('Number of SNES iterations = ',i1)
274c4762a1bSJed Brown
275c4762a1bSJed Brown!  PetscDraw contour plot of solution
276c4762a1bSJed Brown
277c4762a1bSJed Brown      call PetscDrawCreate(PETSC_COMM_WORLD,PETSC_NULL_CHARACTER,'Solution',300,0,300,300,draw,ierr)
278c4762a1bSJed Brown      call PetscDrawSetFromOptions(draw,ierr)
279c4762a1bSJed Brown
280c4762a1bSJed Brown      call VecGetArrayRead(x,lx_v,lx_i,ierr)
281c4762a1bSJed Brown      call PetscDrawTensorContour(draw,mx,my,PETSC_NULL_REAL,PETSC_NULL_REAL,lx_v(lx_i+1),ierr)
282c4762a1bSJed Brown      call VecRestoreArrayRead(x,lx_v,lx_i,ierr)
283c4762a1bSJed Brown
284c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
285c4762a1bSJed Brown!  Free work space.  All PETSc objects should be destroyed when they
286c4762a1bSJed Brown!  are no longer needed.
287c4762a1bSJed Brown! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
288c4762a1bSJed Brown
289c4762a1bSJed Brown      if (.not. matrix_free) call MatDestroy(J,ierr)
290c4762a1bSJed Brown      if (fd_coloring) call MatFDColoringDestroy(fdcoloring,ierr)
291c4762a1bSJed Brown
292c4762a1bSJed Brown      call VecDestroy(x,ierr)
293c4762a1bSJed Brown      call VecDestroy(r,ierr)
294c4762a1bSJed Brown      call SNESDestroy(snes,ierr)
295c4762a1bSJed Brown      call PetscDrawDestroy(draw,ierr)
296c4762a1bSJed Brown      call PetscFinalize(ierr)
297c4762a1bSJed Brown      end
298c4762a1bSJed Brown
299c4762a1bSJed Brown! ---------------------------------------------------------------------
300c4762a1bSJed Brown!
301c4762a1bSJed Brown!  FormInitialGuess - Forms initial approximation.
302c4762a1bSJed Brown!
303c4762a1bSJed Brown!  Input Parameter:
304c4762a1bSJed Brown!  X - vector
305c4762a1bSJed Brown!
306c4762a1bSJed Brown!  Output Parameters:
307c4762a1bSJed Brown!  X - vector
308c4762a1bSJed Brown!  ierr - error code
309c4762a1bSJed Brown!
310c4762a1bSJed Brown!  Notes:
311c4762a1bSJed Brown!  This routine serves as a wrapper for the lower-level routine
312c4762a1bSJed Brown!  "ApplicationInitialGuess", where the actual computations are
313c4762a1bSJed Brown!  done using the standard Fortran style of treating the local
314c4762a1bSJed Brown!  vector data as a multidimensional array over the local mesh.
315c4762a1bSJed Brown!  This routine merely accesses the local vector data via
316c4762a1bSJed Brown!  VecGetArray() and VecRestoreArray().
317c4762a1bSJed Brown!
318c4762a1bSJed Brown      subroutine FormInitialGuess(X,ierr)
319c4762a1bSJed Brown      use petscsnes
320c4762a1bSJed Brown      implicit none
321c4762a1bSJed Brown
322c4762a1bSJed Brown!  Input/output variables:
323c4762a1bSJed Brown      Vec           X
324c4762a1bSJed Brown      PetscErrorCode    ierr
325c4762a1bSJed Brown
326c4762a1bSJed Brown!  Declarations for use with local arrays:
327c4762a1bSJed Brown      PetscScalar   lx_v(0:1)
328c4762a1bSJed Brown      PetscOffset   lx_i
329c4762a1bSJed Brown
330c4762a1bSJed Brown      ierr   = 0
331c4762a1bSJed Brown
332c4762a1bSJed Brown!  Get a pointer to vector data.
333c4762a1bSJed Brown!    - For default PETSc vectors, VecGetArray() returns a pointer to
334c4762a1bSJed Brown!      the data array.  Otherwise, the routine is implementation dependent.
335c4762a1bSJed Brown!    - You MUST call VecRestoreArray() when you no longer need access to
336c4762a1bSJed Brown!      the array.
337c4762a1bSJed Brown!    - Note that the Fortran interface to VecGetArray() differs from the
338c4762a1bSJed Brown!      C version.  See the users manual for details.
339c4762a1bSJed Brown
340c4762a1bSJed Brown      call VecGetArray(X,lx_v,lx_i,ierr)
341c4762a1bSJed Brown
342c4762a1bSJed Brown!  Compute initial guess
343c4762a1bSJed Brown
344c4762a1bSJed Brown      call ApplicationInitialGuess(lx_v(lx_i),ierr)
345c4762a1bSJed Brown
346c4762a1bSJed Brown!  Restore vector
347c4762a1bSJed Brown
348c4762a1bSJed Brown      call VecRestoreArray(X,lx_v,lx_i,ierr)
349c4762a1bSJed Brown
350c4762a1bSJed Brown      return
351c4762a1bSJed Brown      end
352c4762a1bSJed Brown
353c4762a1bSJed Brown! ---------------------------------------------------------------------
354c4762a1bSJed Brown!
355c4762a1bSJed Brown!  ApplicationInitialGuess - Computes initial approximation, called by
356c4762a1bSJed Brown!  the higher level routine FormInitialGuess().
357c4762a1bSJed Brown!
358c4762a1bSJed Brown!  Input Parameter:
359c4762a1bSJed Brown!  x - local vector data
360c4762a1bSJed Brown!
361c4762a1bSJed Brown!  Output Parameters:
362c4762a1bSJed Brown!  f - local vector data, f(x)
363c4762a1bSJed Brown!  ierr - error code
364c4762a1bSJed Brown!
365c4762a1bSJed Brown!  Notes:
366c4762a1bSJed Brown!  This routine uses standard Fortran-style computations over a 2-dim array.
367c4762a1bSJed Brown!
368c4762a1bSJed Brown      subroutine ApplicationInitialGuess(x,ierr)
369c4762a1bSJed Brown      use petscksp
370c4762a1bSJed Brown      implicit none
371c4762a1bSJed Brown
372c4762a1bSJed Brown!  Common blocks:
373c4762a1bSJed Brown      PetscReal   lambda
374c4762a1bSJed Brown      PetscInt     mx,my
375c4762a1bSJed Brown      PetscBool         fd_coloring
376c4762a1bSJed Brown      common      /params/ lambda,mx,my,fd_coloring
377c4762a1bSJed Brown
378c4762a1bSJed Brown!  Input/output variables:
379c4762a1bSJed Brown      PetscScalar x(mx,my)
380c4762a1bSJed Brown      PetscErrorCode     ierr
381c4762a1bSJed Brown
382c4762a1bSJed Brown!  Local variables:
383c4762a1bSJed Brown      PetscInt     i,j
384c4762a1bSJed Brown      PetscReal temp1,temp,hx,hy,one
385c4762a1bSJed Brown
386c4762a1bSJed Brown!  Set parameters
387c4762a1bSJed Brown
388c4762a1bSJed Brown      ierr   = 0
389c4762a1bSJed Brown      one    = 1.0
390c4762a1bSJed Brown      hx     = one/(mx-1)
391c4762a1bSJed Brown      hy     = one/(my-1)
392c4762a1bSJed Brown      temp1  = lambda/(lambda + one)
393c4762a1bSJed Brown
394c4762a1bSJed Brown      do 20 j=1,my
395c4762a1bSJed Brown         temp = min(j-1,my-j)*hy
396c4762a1bSJed Brown         do 10 i=1,mx
397c4762a1bSJed Brown            if (i .eq. 1 .or. j .eq. 1 .or. i .eq. mx .or. j .eq. my) then
398c4762a1bSJed Brown              x(i,j) = 0.0
399c4762a1bSJed Brown            else
400c4762a1bSJed Brown              x(i,j) = temp1 * sqrt(min(min(i-1,mx-i)*hx,temp))
401c4762a1bSJed Brown            endif
402c4762a1bSJed Brown 10      continue
403c4762a1bSJed Brown 20   continue
404c4762a1bSJed Brown
405c4762a1bSJed Brown      return
406c4762a1bSJed Brown      end
407c4762a1bSJed Brown
408c4762a1bSJed Brown! ---------------------------------------------------------------------
409c4762a1bSJed Brown!
410c4762a1bSJed Brown!  FormFunction - Evaluates nonlinear function, F(x).
411c4762a1bSJed Brown!
412c4762a1bSJed Brown!  Input Parameters:
413c4762a1bSJed Brown!  snes  - the SNES context
414c4762a1bSJed Brown!  X     - input vector
415c4762a1bSJed Brown!  dummy - optional user-defined context, as set by SNESSetFunction()
416c4762a1bSJed Brown!          (not used here)
417c4762a1bSJed Brown!
418c4762a1bSJed Brown!  Output Parameter:
419c4762a1bSJed Brown!  F     - vector with newly computed function
420c4762a1bSJed Brown!
421c4762a1bSJed Brown!  Notes:
422c4762a1bSJed Brown!  This routine serves as a wrapper for the lower-level routine
423c4762a1bSJed Brown!  "ApplicationFunction", where the actual computations are
424c4762a1bSJed Brown!  done using the standard Fortran style of treating the local
425c4762a1bSJed Brown!  vector data as a multidimensional array over the local mesh.
426c4762a1bSJed Brown!  This routine merely accesses the local vector data via
427c4762a1bSJed Brown!  VecGetArray() and VecRestoreArray().
428c4762a1bSJed Brown!
429c4762a1bSJed Brown      subroutine FormFunction(snes,X,F,fdcoloring,ierr)
430c4762a1bSJed Brown      use petscsnes
431c4762a1bSJed Brown      implicit none
432c4762a1bSJed Brown
433c4762a1bSJed Brown!  Input/output variables:
434c4762a1bSJed Brown      SNES              snes
435c4762a1bSJed Brown      Vec               X,F
436c4762a1bSJed Brown      PetscErrorCode          ierr
437c4762a1bSJed Brown      MatFDColoring fdcoloring
438c4762a1bSJed Brown
439c4762a1bSJed Brown!  Common blocks:
440c4762a1bSJed Brown      PetscReal         lambda
441c4762a1bSJed Brown      PetscInt          mx,my
442c4762a1bSJed Brown      PetscBool         fd_coloring
443c4762a1bSJed Brown      common            /params/ lambda,mx,my,fd_coloring
444c4762a1bSJed Brown
445c4762a1bSJed Brown!  Declarations for use with local arrays:
446c4762a1bSJed Brown      PetscScalar       lx_v(0:1),lf_v(0:1)
447c4762a1bSJed Brown      PetscOffset       lx_i,lf_i
448c4762a1bSJed Brown
449c4762a1bSJed Brown      PetscInt, pointer :: indices(:)
450c4762a1bSJed Brown
451c4762a1bSJed Brown!  Get pointers to vector data.
452c4762a1bSJed Brown!    - For default PETSc vectors, VecGetArray() returns a pointer to
453c4762a1bSJed Brown!      the data array.  Otherwise, the routine is implementation dependent.
454c4762a1bSJed Brown!    - You MUST call VecRestoreArray() when you no longer need access to
455c4762a1bSJed Brown!      the array.
456c4762a1bSJed Brown!    - Note that the Fortran interface to VecGetArray() differs from the
457c4762a1bSJed Brown!      C version.  See the Fortran chapter of the users manual for details.
458c4762a1bSJed Brown
459c4762a1bSJed Brown      call VecGetArrayRead(X,lx_v,lx_i,ierr)
460c4762a1bSJed Brown      call VecGetArray(F,lf_v,lf_i,ierr)
461c4762a1bSJed Brown
462c4762a1bSJed Brown!  Compute function
463c4762a1bSJed Brown
464c4762a1bSJed Brown      call ApplicationFunction(lx_v(lx_i),lf_v(lf_i),ierr)
465c4762a1bSJed Brown
466c4762a1bSJed Brown!  Restore vectors
467c4762a1bSJed Brown
468c4762a1bSJed Brown      call VecRestoreArrayRead(X,lx_v,lx_i,ierr)
469c4762a1bSJed Brown      call VecRestoreArray(F,lf_v,lf_i,ierr)
470c4762a1bSJed Brown
471c4762a1bSJed Brown      call PetscLogFlops(11.0d0*mx*my,ierr)
472c4762a1bSJed Brown!
473c4762a1bSJed Brown!     fdcoloring is in the common block and used here ONLY to test the
474c4762a1bSJed Brown!     calls to MatFDColoringGetPerturbedColumnsF90() and  MatFDColoringRestorePerturbedColumnsF90()
475c4762a1bSJed Brown!
476c4762a1bSJed Brown      if (fd_coloring) then
477c4762a1bSJed Brown         call MatFDColoringGetPerturbedColumnsF90(fdcoloring,indices,ierr)
478c4762a1bSJed Brown         print*,'Indices from GetPerturbedColumnsF90'
479c4762a1bSJed Brown         write(*,1000) indices
480c4762a1bSJed Brown 1000    format(50i4)
481c4762a1bSJed Brown         call MatFDColoringRestorePerturbedColumnsF90(fdcoloring,indices,ierr)
482c4762a1bSJed Brown      endif
483c4762a1bSJed Brown      return
484c4762a1bSJed Brown      end
485c4762a1bSJed Brown
486c4762a1bSJed Brown! ---------------------------------------------------------------------
487c4762a1bSJed Brown!
488c4762a1bSJed Brown!  ApplicationFunction - Computes nonlinear function, called by
489c4762a1bSJed Brown!  the higher level routine FormFunction().
490c4762a1bSJed Brown!
491c4762a1bSJed Brown!  Input Parameter:
492c4762a1bSJed Brown!  x    - local vector data
493c4762a1bSJed Brown!
494c4762a1bSJed Brown!  Output Parameters:
495c4762a1bSJed Brown!  f    - local vector data, f(x)
496c4762a1bSJed Brown!  ierr - error code
497c4762a1bSJed Brown!
498c4762a1bSJed Brown!  Notes:
499c4762a1bSJed Brown!  This routine uses standard Fortran-style computations over a 2-dim array.
500c4762a1bSJed Brown!
501c4762a1bSJed Brown      subroutine ApplicationFunction(x,f,ierr)
502c4762a1bSJed Brown      use petscsnes
503c4762a1bSJed Brown      implicit none
504c4762a1bSJed Brown
505c4762a1bSJed Brown!  Common blocks:
506c4762a1bSJed Brown      PetscReal      lambda
507c4762a1bSJed Brown      PetscInt        mx,my
508c4762a1bSJed Brown      PetscBool         fd_coloring
509c4762a1bSJed Brown      common         /params/ lambda,mx,my,fd_coloring
510c4762a1bSJed Brown
511c4762a1bSJed Brown!  Input/output variables:
512c4762a1bSJed Brown      PetscScalar    x(mx,my),f(mx,my)
513c4762a1bSJed Brown      PetscErrorCode       ierr
514c4762a1bSJed Brown
515c4762a1bSJed Brown!  Local variables:
516c4762a1bSJed Brown      PetscScalar    two,one,hx,hy
517c4762a1bSJed Brown      PetscScalar    hxdhy,hydhx,sc
518c4762a1bSJed Brown      PetscScalar    u,uxx,uyy
519c4762a1bSJed Brown      PetscInt        i,j
520c4762a1bSJed Brown
521c4762a1bSJed Brown      ierr   = 0
522c4762a1bSJed Brown      one    = 1.0
523c4762a1bSJed Brown      two    = 2.0
524c4762a1bSJed Brown      hx     = one/(mx-1)
525c4762a1bSJed Brown      hy     = one/(my-1)
526c4762a1bSJed Brown      sc     = hx*hy*lambda
527c4762a1bSJed Brown      hxdhy  = hx/hy
528c4762a1bSJed Brown      hydhx  = hy/hx
529c4762a1bSJed Brown
530c4762a1bSJed Brown!  Compute function
531c4762a1bSJed Brown
532c4762a1bSJed Brown      do 20 j=1,my
533c4762a1bSJed Brown         do 10 i=1,mx
534c4762a1bSJed Brown            if (i .eq. 1 .or. j .eq. 1 .or. i .eq. mx .or. j .eq. my) then
535c4762a1bSJed Brown               f(i,j) = x(i,j)
536c4762a1bSJed Brown            else
537c4762a1bSJed Brown               u = x(i,j)
538c4762a1bSJed Brown               uxx = hydhx * (two*u - x(i-1,j) - x(i+1,j))
539c4762a1bSJed Brown               uyy = hxdhy * (two*u - x(i,j-1) - x(i,j+1))
540c4762a1bSJed Brown               f(i,j) = uxx + uyy - sc*exp(u)
541c4762a1bSJed Brown            endif
542c4762a1bSJed Brown 10      continue
543c4762a1bSJed Brown 20   continue
544c4762a1bSJed Brown
545c4762a1bSJed Brown      return
546c4762a1bSJed Brown      end
547c4762a1bSJed Brown
548c4762a1bSJed Brown! ---------------------------------------------------------------------
549c4762a1bSJed Brown!
550c4762a1bSJed Brown!  FormJacobian - Evaluates Jacobian matrix.
551c4762a1bSJed Brown!
552c4762a1bSJed Brown!  Input Parameters:
553c4762a1bSJed Brown!  snes    - the SNES context
554c4762a1bSJed Brown!  x       - input vector
555c4762a1bSJed Brown!  dummy   - optional user-defined context, as set by SNESSetJacobian()
556c4762a1bSJed Brown!            (not used here)
557c4762a1bSJed Brown!
558c4762a1bSJed Brown!  Output Parameters:
559c4762a1bSJed Brown!  jac      - Jacobian matrix
560c4762a1bSJed Brown!  jac_prec - optionally different preconditioning matrix (not used here)
561c4762a1bSJed Brown!  flag     - flag indicating matrix structure
562c4762a1bSJed Brown!
563c4762a1bSJed Brown!  Notes:
564c4762a1bSJed Brown!  This routine serves as a wrapper for the lower-level routine
565c4762a1bSJed Brown!  "ApplicationJacobian", where the actual computations are
566c4762a1bSJed Brown!  done using the standard Fortran style of treating the local
567c4762a1bSJed Brown!  vector data as a multidimensional array over the local mesh.
568c4762a1bSJed Brown!  This routine merely accesses the local vector data via
569c4762a1bSJed Brown!  VecGetArray() and VecRestoreArray().
570c4762a1bSJed Brown!
571c4762a1bSJed Brown      subroutine FormJacobian(snes,X,jac,jac_prec,dummy,ierr)
572c4762a1bSJed Brown      use petscsnes
573c4762a1bSJed Brown      implicit none
574c4762a1bSJed Brown
575c4762a1bSJed Brown!  Input/output variables:
576c4762a1bSJed Brown      SNES          snes
577c4762a1bSJed Brown      Vec           X
578c4762a1bSJed Brown      Mat           jac,jac_prec
579c4762a1bSJed Brown      PetscErrorCode      ierr
580c4762a1bSJed Brown      integer dummy
581c4762a1bSJed Brown
582c4762a1bSJed Brown!  Common blocks:
583c4762a1bSJed Brown      PetscReal     lambda
584c4762a1bSJed Brown      PetscInt       mx,my
585c4762a1bSJed Brown      PetscBool         fd_coloring
586c4762a1bSJed Brown      common        /params/ lambda,mx,my,fd_coloring
587c4762a1bSJed Brown
588c4762a1bSJed Brown!  Declarations for use with local array:
589c4762a1bSJed Brown      PetscScalar   lx_v(0:1)
590c4762a1bSJed Brown      PetscOffset   lx_i
591c4762a1bSJed Brown
592c4762a1bSJed Brown!  Get a pointer to vector data
593c4762a1bSJed Brown
594c4762a1bSJed Brown      call VecGetArrayRead(X,lx_v,lx_i,ierr)
595c4762a1bSJed Brown
596c4762a1bSJed Brown!  Compute Jacobian entries
597c4762a1bSJed Brown
598c4762a1bSJed Brown      call ApplicationJacobian(lx_v(lx_i),jac,jac_prec,ierr)
599c4762a1bSJed Brown
600c4762a1bSJed Brown!  Restore vector
601c4762a1bSJed Brown
602c4762a1bSJed Brown      call VecRestoreArrayRead(X,lx_v,lx_i,ierr)
603c4762a1bSJed Brown
604c4762a1bSJed Brown!  Assemble matrix
605c4762a1bSJed Brown
606c4762a1bSJed Brown      call MatAssemblyBegin(jac_prec,MAT_FINAL_ASSEMBLY,ierr)
607c4762a1bSJed Brown      call MatAssemblyEnd(jac_prec,MAT_FINAL_ASSEMBLY,ierr)
608c4762a1bSJed Brown
609c4762a1bSJed Brown      return
610c4762a1bSJed Brown      end
611c4762a1bSJed Brown
612c4762a1bSJed Brown! ---------------------------------------------------------------------
613c4762a1bSJed Brown!
614c4762a1bSJed Brown!  ApplicationJacobian - Computes Jacobian matrix, called by
615c4762a1bSJed Brown!  the higher level routine FormJacobian().
616c4762a1bSJed Brown!
617c4762a1bSJed Brown!  Input Parameters:
618c4762a1bSJed Brown!  x        - local vector data
619c4762a1bSJed Brown!
620c4762a1bSJed Brown!  Output Parameters:
621c4762a1bSJed Brown!  jac      - Jacobian matrix
622c4762a1bSJed Brown!  jac_prec - optionally different preconditioning matrix (not used here)
623c4762a1bSJed Brown!  ierr     - error code
624c4762a1bSJed Brown!
625c4762a1bSJed Brown!  Notes:
626c4762a1bSJed Brown!  This routine uses standard Fortran-style computations over a 2-dim array.
627c4762a1bSJed Brown!
628c4762a1bSJed Brown      subroutine ApplicationJacobian(x,jac,jac_prec,ierr)
629c4762a1bSJed Brown      use petscsnes
630c4762a1bSJed Brown      implicit none
631c4762a1bSJed Brown
632c4762a1bSJed Brown!  Common blocks:
633c4762a1bSJed Brown      PetscReal    lambda
634c4762a1bSJed Brown      PetscInt      mx,my
635c4762a1bSJed Brown      PetscBool         fd_coloring
636c4762a1bSJed Brown      common       /params/ lambda,mx,my,fd_coloring
637c4762a1bSJed Brown
638c4762a1bSJed Brown!  Input/output variables:
639c4762a1bSJed Brown      PetscScalar  x(mx,my)
640c4762a1bSJed Brown      Mat          jac,jac_prec
641c4762a1bSJed Brown      PetscErrorCode      ierr
642c4762a1bSJed Brown
643c4762a1bSJed Brown!  Local variables:
644c4762a1bSJed Brown      PetscInt      i,j,row(1),col(5),i1,i5
645c4762a1bSJed Brown      PetscScalar  two,one, hx,hy
646c4762a1bSJed Brown      PetscScalar  hxdhy,hydhx,sc,v(5)
647c4762a1bSJed Brown
648c4762a1bSJed Brown!  Set parameters
649c4762a1bSJed Brown
650c4762a1bSJed Brown      i1     = 1
651c4762a1bSJed Brown      i5     = 5
652c4762a1bSJed Brown      one    = 1.0
653c4762a1bSJed Brown      two    = 2.0
654c4762a1bSJed Brown      hx     = one/(mx-1)
655c4762a1bSJed Brown      hy     = one/(my-1)
656c4762a1bSJed Brown      sc     = hx*hy
657c4762a1bSJed Brown      hxdhy  = hx/hy
658c4762a1bSJed Brown      hydhx  = hy/hx
659c4762a1bSJed Brown
660c4762a1bSJed Brown!  Compute entries of the Jacobian matrix
661c4762a1bSJed Brown!   - Here, we set all entries for a particular row at once.
662c4762a1bSJed Brown!   - Note that MatSetValues() uses 0-based row and column numbers
663c4762a1bSJed Brown!     in Fortran as well as in C.
664c4762a1bSJed Brown
665c4762a1bSJed Brown      do 20 j=1,my
666c4762a1bSJed Brown         row(1) = (j-1)*mx - 1
667c4762a1bSJed Brown         do 10 i=1,mx
668c4762a1bSJed Brown            row(1) = row(1) + 1
669c4762a1bSJed Brown!           boundary points
670c4762a1bSJed Brown            if (i .eq. 1 .or. j .eq. 1 .or. i .eq. mx .or. j .eq. my) then
671c4762a1bSJed Brown               call MatSetValues(jac_prec,i1,row,i1,row,one,INSERT_VALUES,ierr)
672c4762a1bSJed Brown!           interior grid points
673c4762a1bSJed Brown            else
674c4762a1bSJed Brown               v(1) = -hxdhy
675c4762a1bSJed Brown               v(2) = -hydhx
676c4762a1bSJed Brown               v(3) = two*(hydhx + hxdhy) - sc*lambda*exp(x(i,j))
677c4762a1bSJed Brown               v(4) = -hydhx
678c4762a1bSJed Brown               v(5) = -hxdhy
679c4762a1bSJed Brown               col(1) = row(1) - mx
680c4762a1bSJed Brown               col(2) = row(1) - 1
681c4762a1bSJed Brown               col(3) = row(1)
682c4762a1bSJed Brown               col(4) = row(1) + 1
683c4762a1bSJed Brown               col(5) = row(1) + mx
684c4762a1bSJed Brown               call MatSetValues(jac_prec,i1,row,i5,col,v,INSERT_VALUES,ierr)
685c4762a1bSJed Brown            endif
686c4762a1bSJed Brown 10      continue
687c4762a1bSJed Brown 20   continue
688c4762a1bSJed Brown
689c4762a1bSJed Brown      return
690c4762a1bSJed Brown      end
691c4762a1bSJed Brown
692c4762a1bSJed Brown!
693c4762a1bSJed Brown!/*TEST
694c4762a1bSJed Brown!
695c4762a1bSJed Brown!   build:
696c4762a1bSJed Brown!      requires: !single
697c4762a1bSJed Brown!
698c4762a1bSJed Brown!   test:
699c4762a1bSJed Brown!      args: -snes_monitor_short -nox -snes_type newtontr -ksp_gmres_cgs_refinement_type refine_always
700c4762a1bSJed Brown!
701c4762a1bSJed Brown!   test:
702c4762a1bSJed Brown!      suffix: 2
703c4762a1bSJed Brown!      args: -snes_monitor_short -nox -snes_fd -ksp_gmres_cgs_refinement_type refine_always
704c4762a1bSJed Brown!
705c4762a1bSJed Brown!   test:
706c4762a1bSJed Brown!      suffix: 3
707c4762a1bSJed Brown!      args: -snes_monitor_short -nox -snes_fd_coloring -mat_coloring_type sl -ksp_gmres_cgs_refinement_type refine_always
708c4762a1bSJed Brown!      filter: sort -b
709c4762a1bSJed Brown!      filter_output: sort -b
710c4762a1bSJed Brown!
711c4762a1bSJed Brown!   test:
712c4762a1bSJed Brown!     suffix: 4
713c4762a1bSJed Brown!     args: -pc -par 6.807 -nox
714c4762a1bSJed Brown!
715c4762a1bSJed Brown!TEST*/
716