Skip to main content
`Ctrl`+`K`

# TaoTermSetSolutionLayout

Set the layout describing the solution vector of `TaoTerm`.

## Synopsis

    #include "petsctao.h"
    PetscErrorCode TaoTermSetSolutionLayout(TaoTerm term, PetscLayout solution_layout)

Collective

## Input Parameters

- term - a `TaoTerm`

- solution_layout - the `PetscLayout` for the solution space

## Notes

The “solution space” of a `TaoTerm` is the vector space of the optimization variable \(x\) in \(f(x; p)\). This is distinct from the “parameter space” (the space of the fixed data \(p\), set with `TaoTermSetParametersSizes()`). Some `TaoTermType`s require the solution and parameter spaces to be related (e.g., have the same size); see the documentation for each type.

When a mapping matrix \(A\) is used to add a term to a `Tao` via `TaoAddTerm()`, the mapping transforms the `Tao` solution vector into this term’s solution space. For example, if the `Tao` solution vector is \(x \in \mathbb{R}^n\) and the mapping matrix is \(A \in \mathbb{R}^{m \times n}\), then the term evaluates \(f(Ax; p)\) with \(Ax \in \mathbb{R}^m\). The term’s solution space is therefore \(\mathbb{R}^m\), and `TaoTermView()` will report \(N = m\) for this term.

Alternatively, one may use `TaoTermSetSolutionSizes()` or `TaoTermSetSolutionTemplate()` to define the vector sizes.

## See Also

TaoTerm: composable objective function terms, `TaoTerm`, `TaoTermGetSolutionVecType()`, `TaoTermSetSolutionVecType()`, `TaoTermGetSolutionLayout()`, `TaoTermSetSolutionTemplate()`, `TaoTermSetParametersTemplate()`, `TaoTermCreateSolutionVec()`

## Level

intermediate

## Location

src/tao/term/interface/taoterm.c

Index of all TaoTerm routines
Table of Contents for all manual pages
Index of all manual pages