apply_replacement_rules

apply_replacement_rules(expression: MatrixExpr | MatrixBase, *replacement_rules)[source]

A Replacement rule define symbols and values. This method searches in the expression for symbols and replaces them by values as defined by a replacement rule. Each replacement rule is applied independently.

Examples

In the following expression some symbols should be replaced by values.

>>> r1, r2, r3 = sy.symbols("r1 r2 r3")
>>> expr = 1*r1 + 2*r2 + 3*r3

Three replacement rules map r and s to values.

>>> repl = create_replacement_rules(
...     [r1, r2],
...     [1, 0],
...     [0, 1],
...     [1, 1]
... )
>>> repl  
[{r1: ...1..., r2: ...0...}, {r1: ...0..., r2: ...1...}, {r1: ...1..., r2: ...1...}]

Each of the three replacement rules is applied independently. The t symbol is not replaceed.

>>> apply_replacement_rules(expr, *repl)
[3*r3 + 1, 3*r3 + 2, 3*r3 + 3]