petsc4py.PETSc.TAOLineSearch#

class petsc4py.PETSc.TAOLineSearch#

Bases: Object

TAO Line Search.

Enumerations

`ConvergedReason`	TAO Line Search Termination Reasons.
`Type`	TAO Line Search Types.

Methods Summary

`apply`(x, g, s)	Performs a line-search in a given step direction.
`create`([comm])	Create a TAO linesearch.
`destroy`()	Destroy the linesearch object.
`getOptionsPrefix`()	Return the prefix used for searching for options in the database.
`getType`()	Return the type of the linesearch.
`setFromOptions`()	Configure the linesearch from the options database.
`setGradient`(gradient[, args, kargs])	Set the gradient evaluation callback.
`setObjective`(objective[, args, kargs])	Set the objective function evaluation callback.
`setObjectiveGradient`(objgrad[, args, kargs])	Set the objective function and gradient evaluation callback.
`setOptionsPrefix`([prefix])	Set the prefix used for searching for options in the database.
`setType`(ls_type)	Set the type of the linesearch.
`setUp`()	Set up the internal data structures for using the linesearch.
`useTAORoutine`(tao)	Use the objective and gradient evaluation routines from the given Tao object.
`view`([viewer])	View the linesearch object.

Methods Documentation

apply(x, g, s)#

Performs a line-search in a given step direction.

Collective.

See also

TaoLineSearchApply

Source code at petsc4py/PETSc/TAO.pyx:2377

Parameters:

x (Vec)
g (Vec)
s (Vec)

Return type:

tuple[float, float, str]

create(comm=None)#

Create a TAO linesearch.

Collective.

Parameters:: comm – MPI communicator, defaults to Sys.getDefaultComm.
Return type:: Self

Source code at petsc4py/PETSc/TAO.pyx:2180

destroy()#

Destroy the linesearch object.

Collective.

See also

TaoLineSearchDestroy

Source code at petsc4py/PETSc/TAO.pyx:2167

Return type:: Self

getOptionsPrefix()#

Return the prefix used for searching for options in the database.

Not collective.

Source code at petsc4py/PETSc/TAO.pyx:2272

Return type:: str

getType()#

Return the type of the linesearch.

Not collective.

See also

setType, TaoLineSearchGetType

Source code at petsc4py/PETSc/TAO.pyx:2220

Return type:: str

setFromOptions()#

Configure the linesearch from the options database.

Collective.

Source code at petsc4py/PETSc/TAO.pyx:2234

Return type:: None

setGradient(gradient, args=None, kargs=None)#

Set the gradient evaluation callback.

Logically collective.

Parameters:

gradient (TAOLSGradientFunction) – The gradient callback.
g – The vector to store the gradient.
args (tuple[Any, ...] | None) – Positional arguments for the callback.
kargs (dict[str, Any] | None) – Keyword arguments for the callback.

Return type:

None

Source code at petsc4py/PETSc/TAO.pyx:2311

setObjective(objective, args=None, kargs=None)#

Set the objective function evaluation callback.

Logically collective.

Parameters:

objective (TAOLSObjectiveFunction) – The objective function callback.
args (tuple[Any, ...] | None) – Positional arguments for the callback.
kargs (dict[str, Any] | None) – Keyword arguments for the callback.

Return type:

None

Source code at petsc4py/PETSc/TAO.pyx:2286

setObjectiveGradient(objgrad, args=None, kargs=None)#

Set the objective function and gradient evaluation callback.

Logically collective.

Parameters:

objgrad (TAOLSObjectiveGradientFunction) – The objective function and gradient callback.
g – The vector to store the gradient.
args (tuple[Any, ...] | None) – Positional arguments for the callback.
kargs (dict[str, Any] | None) – Keyword arguments for the callback.

Return type: