petsc-3.7.3 2016-08-01

TaoSetJacobianDesignRoutine

Sets the function to compute the Jacobian of the constraint function with respect to the design variables. Used only for pde-constrained optimization.

Synopsis

#include "petsctao.h" 
PetscErrorCode TaoSetJacobianDesignRoutine(Tao tao, Mat J, PetscErrorCode (*func)(Tao, Vec, Mat, void*), void *ctx)

Logically collective on Tao

Input Parameters

	tao	- the Tao context
	J	- Matrix used for the jacobian
	jac	- Jacobian evaluation routine
	ctx	- [optional] user-defined context for private data for the Jacobian evaluation routine (may be NULL)

Calling sequence of jac

   jac (Tao tao,Vec x,Mat *J,void *ctx);

	tao	- the Tao context
	x	- input vector
	J	- Jacobian matrix
	ctx	- [optional] user-defined Jacobian context

Notes

The function jac() takes Mat * as the matrix arguments rather than Mat. This allows the Jacobian evaluation routine to replace A and/or B with a completely new new matrix structure (not just different matrix elements) when appropriate, for instance, if the nonzero structure is changing throughout the global iterations.

Examples