このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

subs

シンボリック代入

構文

snew = subs(s,match,replacement)

snew = subs(s,replacement)

snew = subs(s)

sMnew = subs(sM,matchM,replacementM)

sMnew = subs(sM,replacementM)

sMnew = subs(sM)

説明

シンボリック スカラー変数とシンボリック関数の代入

snew = subs(s,match,replacement) は、現れるすべての match を replacement に置き換え、次に s を評価して s のコピーを返します。ここで、s はシンボリック スカラー変数またはシンボリック関数の式であり、match には代入の対象となるシンボリック スカラー変数またはシンボリック関数を指定します。

• match および replacement がいずれも同じサイズのベクトルまたは cell 配列の場合、subs は match の各要素を replacement の対応する要素で置き換えます。

• match がスカラーであり、replacement がベクトルまたは行列である場合、subs(s,match,replacement) はすべての演算を要素単位で実行して、s における match のインスタンスをすべて replacement に置き換えます。s のすべての定数項は、すべて 1 のベクトルまたは行列にその定数をかけた項に置き換えられます。

snew = subs(s,replacement) は、s に現れる既定のシンボリック スカラー変数をすべて replacement に置き換え、次に s を評価して s のコピーを返します。既定の変数は symvar(s,1) で定義されます。

snew = subs(s) は、s のコピーを返し、s 内のシンボリック スカラー変数を MATLAB^® ワークスペースで割り当てられた値に置き換えてから、s を評価します。値が代入されていない変数は、変数のままになります。

シンボリック行列変数とシンボリック行列関数の代入

sMnew = subs(sM,matchM,replacementM) は、現れるすべての matchM を replacementM に置き換え、次に sM を評価して sM のコピーを返します。ここで、sM はシンボリック行列変数およびシンボリック行列関数を含む式、方程式、または条件であり、matchM には代入の対象となるシンボリック行列変数およびシンボリック行列関数を指定します。置換値 replacementM は、matchM と同じサイズでなければなりません。 (R2021b 以降)

sMnew = subs(sM,replacementM) は、sM に現れる既定のシンボリック行列変数をすべて replacementM に置き換え、次に sM を評価して sM のコピーを返します。 (R2021b 以降)

sMnew = subs(sM) は、sM 内のシンボリック行列変数を MATLAB ワークスペースで割り当てられた値に置き換え、次に sM を評価して sM のコピーを返します。値が代入されていない変数は、変数のままになります。 (R2023b 以降)

例

単一置換

この式で a を 4 に置き換えます。

syms a b
expr = subs(a + b,a,4)

expr = $$b+4$$

この式で a*b を 5 に置き換えます。

expr = subs(a*b^2,a*b,5)

expr = $$5\hspace{0.17em}b$$

既定の代入変数

次の式の既定のシンボリック スカラー変数を a に置き換えます。置き換えるスカラー変数または式を指定しない場合、subs は、symvar を使用して既定の変数を求めます。x + y では、既定の変数は x です。

syms x y a
var = symvar(x + y,1)

var = $$x$$

したがって、subs は x を a に置き換えます。

expr = subs(x + y,a)

expr = $$a+y$$

新しい値による式の評価

シンボリック スカラー変数に新しい値が代入されても、それらの値を含む式の値は自動的に求められません。代わりに、subs を使用して式の値を求めます。

式 y = x^2 を定義します。

syms x
y = x^2;

2 を x に代入します。y 値は 4 ではなく x^2 のままです。

x = 2;
y

y = $$x^2$$

subs を使用して、x の新しい値で y を評価します。

yeval = subs(y)

yeval = $$4$$

複数置換

代入の対象となる変数と新しい値をベクトルとして指定し、複数の置換を行います。

syms a b
expr = subs(cos(a) + sin(b), [a,b], [sym("alpha"),2])

expr = $$\sin \left(2\right)+\cos \left(\alpha \right)$$

あるいは、複数の代入には cell 配列を使用します。

expr = subs(cos(a) + sin(b), {a,b}, {sym("alpha"),2})

expr = $$\sin \left(2\right)+\cos \left(\alpha \right)$$

配列によるスカラーの置き換え

次の式のシンボリック スカラー変数 a を 3 行 3 列の魔方陣行列に置き換えます。定数 1 により、3 行 3 列の行列のすべての要素が 1 に拡張されることに注意してください。

syms a t
expr3by3 = subs(exp(a*t) + 1, a, -magic(3))

expr3by3 = 
$$\left(\begin{array}{ccc}{\mathrm{e}}^{-8\hspace{0.17em}t}+1& {\mathrm{e}}^{-t}+1& {\mathrm{e}}^{-6\hspace{0.17em}t}+1\\ {\mathrm{e}}^{-3\hspace{0.17em}t}+1& {\mathrm{e}}^{-5\hspace{0.17em}t}+1& {\mathrm{e}}^{-7\hspace{0.17em}t}+1\\ {\mathrm{e}}^{-4\hspace{0.17em}t}+1& {\mathrm{e}}^{-9\hspace{0.17em}t}+1& {\mathrm{e}}^{-2\hspace{0.17em}t}+1\end{array}\right)$$

ベクトル、行列または非スカラー値の配列の要素を置き換えることもできます。たとえば、これらの 2 行 2 列の行列を作成します。

A = sym("A",[2,2])

A = 
$$\left(\begin{array}{cc}{A}_{1,1}& A_{1,2}\\ A_{2,1}& A_{2,2}\end{array}\right)$$

B = sym("B",[2,2])

B = 
$$\left(\begin{array}{cc}{B}_{1,1}& B_{1,2}\\ B_{2,1}& B_{2,2}\end{array}\right)$$

行列 A の最初の要素を行列 B と置き換えます。この置き換えを行う際に、subs は 2 行 2 列の行列 A を 4 行 4 列の行列に拡張します。

A4by4 = subs(A, A(1,1), B)

A4by4 = 
$$\left(\begin{array}{cccc}{B}_{1,1}& B_{1,2}& A_{1,2}& A_{1,2}\\ B_{2,1}& B_{2,2}& A_{1,2}& A_{1,2}\\ A_{2,1}& A_{2,1}& A_{2,2}& A_{2,2}\\ A_{2,1}& A_{2,1}& A_{2,2}& A_{2,2}\end{array}\right)$$

subs では、非スカラーまたは行列を、行列のサイズを縮小するスカラーに置き換えることはできません。

構造体配列内のシンボリック スカラー変数の置換

フィールド値としてシンボリック式を使用して構造体配列を作成します。

syms x y z
S = struct("f1",x*y,"f2",y + z,"f3",y^2)

S = struct with fields:
    f1: x*y
    f2: y + z
    f3: y^2

シンボリック スカラー変数 x、y、および z を数値に置き換えます。

Sval = subs(S,[x y z],[0.5 1 1.5])

Sval = struct with fields:
    f1: 1/2
    f2: 5/2
    f3: 1

配列による複数のスカラーの置き換え

式でシンボリック スカラー変数 x および y を 2 行 2 列の行列に置き換えます。ベクトルまたは行列を含む複数の置換を行う場合は、cell 配列を使用して代入の対象となる変数と新しい値を指定します。

syms x y
expr = subs(x*y, {x,y}, {[0 1; -1 0], [1 -1; -2 1]})

expr = 
$$\left(\begin{array}{cc}0& -1\\ 2& 0\end{array}\right)$$

x と y はスカラーであるため、これらの代入は要素単位で行われます。

expr = [0 1; -1 0].*[1 -1; -2 1]

expr = 2×2

     0    -1
     2     0

方程式での置換

もう 1 つの方程式の変数の値を使用して、方程式からスカラー変数を消去します。2 番目の方程式において、isolate を使用して変数を左辺に分離し、それから右辺を 1 番目の方程式の変数で置き換えます。

はじめに、方程式 eqn1 および eqn2 を宣言します。

syms x y
eqn1 = sin(x)+y == x^2 + y^2;
eqn2 = y*x == cos(x);

isolate を使用して eqn2 の y を分離します。

eqn2 = isolate(eqn2,y)

eqn2 = 
$$y=\frac{\cos \left(x\right)}{x}$$

eqn2 の左辺を eqn2 の右辺に置き換えることで、eqn1 から y を消去します。

eqn1 = subs(eqn1,lhs(eqn2),rhs(eqn2))

eqn1 = 
$$\sin \left(x\right)+\frac{\cos \left(x\right)}{x}=\frac{{\cos \left(x\right)}^2}{x^2}+x^2$$

関数での置換

このシンボリック関数の x を a に置き換えます。

syms x y a
syms f(x,y)
f(x,y) = x + y;
f = subs(f,x,a)

f(x, y) = $$a+y$$

subs はシンボリック関数式の値を置き換えますが、関数の入力引数は置き換えません。

formula = formula(f)

formula = $$a+y$$

args = argnames(f)

args = $$\left(\begin{array}{cc}x& y\end{array}\right)$$

シンボリック関数の引数は明示的に置き換えます。

syms x y
f(x,y) = x + y;
f(a,y) = subs(f,x,a);
f

f(a, y) = $$a+y$$

構造体の対応値による変数の置き換え

次の連立方程式の解を確認するとします。

syms x y
eqs = [x^2 + y^2 == 1, x == y];
S = solve(eqs,[x y]);
S.x

ans = 
$$\left(\begin{array}{c}-\frac{\sqrt{2}}{2}\\ \frac{\sqrt{2}}{2}\end{array}\right)$$

S.y

ans = 
$$\left(\begin{array}{c}-\frac{\sqrt{2}}{2}\\ \frac{\sqrt{2}}{2}\end{array}\right)$$

解を元の連立方程式に代入して解を検証します。

tf = isAlways(subs(eqs,S))

tf = 2×2 logical array

   1   1
   1   1

1 次導関数と 2 次導関数を含む代入

1 次導関数と 2 次導関数を含むシンボリック式を作成します。

syms r(t)
expr = diff(r,t,t) + diff(r,t)

expr(t) = 
$$\frac{{\partial }^2}{\partial t^2}\mathrm{ }r\left(t\right)+\frac{\partial }{\partial t}\mathrm{ }r\left(t\right)$$

1 次導関数に別の変数 ${\mathit{v}}_0$ を、2 次導関数に別の変数 $\mathrm{D2r}$ を代入します。これを行うには、まず、より高次の導関数 (2 次導関数) の代入を行う必要があります。

syms v_0 D2r
exprnew = subs(expr,diff(r,t,t),D2r);
exprnew = subs(exprnew,diff(r,t),v_0)

exprnew(t) = $$\mathrm{D2r}+v_0$$

また、置き換える変数とその置換値をベクトルとして指定することで、1 回の subs 呼び出しでこれらの代入を行うこともできます。

exprnew = subs(expr,[diff(r,t,t) diff(r,t)],[D2r v_0])

exprnew(t) = $$\mathrm{D2r}+v_0$$

1 次導関数のみを代入し、2 次導関数をそのまま保持する場合は、一時変数 $\mathrm{D2r}$ を $\frac{{\partial }^2}{\partial {\mathit{t}}^2}\mathit{r}\left(\mathit{t}\right)$ に戻して前のワークフローを続行します。

exprnew = subs(exprnew,D2r,diff(r,t,t))

exprnew(t) = 
$$\frac{{\partial }^2}{\partial t^2}\mathrm{ }r\left(t\right)+v_0$$

比較として、まず元の式の 1 次導関数に ${\mathit{v}}_0$ を代入すると、結果は ${\mathit{v}}_0$ になります。ここで、subs は 1 次導関数を ${\mathit{v}}_0$ に、2 次導関数を $\frac{\partial }{\partial \mathit{t}}\frac{\partial \mathit{r}\left(\mathit{t}\right)}{\partial \mathit{t}}=\frac{\partial }{\partial \mathit{t}}{\mathit{v}}_0=0$ に置き換えます。この代入結果は、2 次導関数が含まれていない式となります。

syms v_0
exprnew = subs(expr,diff(r,t),v_0)

exprnew(t) = $$v_0$$

配列によるシンボリック行列変数の置き換え

R2021b 以降

2 つの 2 行 2 列の行列の積を定義します。行列を symmatrix データ型のシンボリック行列変数として宣言します。

syms X Y [2 2] matrix
sM = X*Y

sM = $$X\hspace{0.17em}Y$$

行列変数 $$X$$ と $$Y$$ を 2 行 2 列のシンボリック行列に置き換えます。ベクトルまたは行列を含む複数の置換を行う場合は、cell 配列を使用して代入の対象となる行列変数とその新しい値を指定します。新しい値は、代入の対象となる行列変数と同じサイズでなければなりません。

S = subs(sM,{X,Y},{[0 sqrt(sym(2)); sqrt(sym(2)) 0], [1 -1; -2 1]})

S = 
$$\begin{array}{l}{\Sigma }_1\\ \\ \mathrm{where}\\ \\ \mathrm{ }{\Sigma }_1=\left(\begin{array}{cc}-2\hspace{0.17em}\sqrt{2}& \sqrt{2}\\ \sqrt{2}& -\sqrt{2}\end{array}\right)\end{array}$$

式 S を sym データ型に変換して、置換された行列の乗算結果を表示します。

Ssym = symmatrix2sym(S)

Ssym = 
$$\left(\begin{array}{cc}-2\hspace{0.17em}\sqrt{2}& \sqrt{2}\\ \sqrt{2}& -\sqrt{2}\end{array}\right)$$

行列の特性多項式

R2021b 以降

シンボリック数の行列を作成します。

A = sym([1 4 2; 4 1 2; 2 2 3])

A = 
$$\left(\begin{array}{ccc}1& 4& 2\\ 4& 1& 2\\ 2& 2& 3\end{array}\right)$$

関数 charpoly を使用して、A の特性多項式の係数を計算します。

c = charpoly(A)

c = $$\left(\begin{array}{cccc}1& -5& -17& 21\end{array}\right)$$

次に、$$X$$ を 3 行 3 列のシンボリック行列変数として定義します。係数 c を使用して、多項式 $$p(X)=c_1{X}^3+c_2{X}^2+c_{3}X+c_4{I}_3$$ を作成します。ここで $$X$$ は、3 行 3 列の行列を表す不定元です。

syms X [3 3] matrix
p = c(1)*X^3 + c(2)*X^2 + c(3)*X + c(4)*X^0

p = $$21\hspace{0.17em}{\mathrm{I}}_3-17\hspace{0.17em}X-5\hspace{0.17em}{X}^2+X^3$$

関数 subs を使用して、多項式 $$p(X)$$ の $$X$$ を A で置換します。ケーリー・ハミルトンの定理によれば、係数 c が A の特性多項式であるため、この代入結果は 3 行 3 列のゼロ行列となります。symmatrix2sym を使用して、置換された式をシンボリック数の行列に変換します。

Y = subs(p,A)

Y = 
$$\begin{array}{l}-17\hspace{0.17em}{\Sigma }_1-5\hspace{0.17em}{{\Sigma }_1}^2+{{\Sigma }_1}^3+21\hspace{0.17em}{\mathrm{I}}_3\\ \\ \mathrm{where}\\ \\ \mathrm{ }{\Sigma }_1=\left(\begin{array}{ccc}1& 4& 2\\ 4& 1& 2\\ 2& 2& 3\end{array}\right)\end{array}$$

Z = symmatrix2sym(Y)

Z = 
$$\left(\begin{array}{ccc}0& 0& 0\\ 0& 0& 0\\ 0& 0& 0\end{array}\right)$$

シンボリック行列関数での変数の代入

R2022a 以降

関数 $\mathit{f}\left(\mathit{A}\right)={\mathit{A}}^2-2\mathit{A}+{\mathrm{I}}_2$ を定義します。ここで、$\mathit{A}$ は 2 行 2 列の行列であり、${\mathrm{I}}_2$ は 2 行 2 列の単位行列です。変数 $\mathit{A}$ に別の式を代入して、新しい関数を評価します。

2 行 2 列のシンボリック行列変数 $\mathit{A}$ を作成します。$\mathit{A}$ の既存の定義をワークスペースに保持したまま、シンボリック行列関数 $\mathit{f}\left(\mathit{A}\right)$ を作成します。$\mathit{f}\left(\mathit{A}\right)$ の多項式を割り当てます。

syms A 2 matrix
syms f(A) 2 matrix keepargs
f(A) = A*A - 2*A + eye(2)

f(A) = $${\mathrm{I}}_2-2\hspace{0.17em}A+A^2$$

次に、新しいシンボリック行列変数 $\mathit{B}$ と $\mathit{C}$ を作成します。$\mathit{B}$ と $\mathit{C}$ の既存の定義をワークスペースに保持したまま、新しいシンボリック行列関数 $\mathit{g}\left(\mathit{B},\mathit{C}\right)$ を作成します。

syms B C 2 matrix
syms g(B,C) 2 matrix keepargs

$\mathit{f}\left(\mathit{A}\right)$ 内の変数 $\mathit{A}$ に $\mathit{B}+\mathit{C}$ を代入します。代入結果を新しい関数 $\mathit{g}\left(\mathit{B},\mathit{C}\right)$ に割り当てます。

g(B,C) = subs(f,A,B+C)

g(B, C) = $${\left(B+C\right)}^2+{\mathrm{I}}_2-2\hspace{0.17em}B-2\hspace{0.17em}C$$

subs を使用して、行列値 $\mathit{B}=\left[\begin{array}{cc}0& 1\\ -1& 0\end{array}\right]$ と $\mathit{C}=\left[\begin{array}{cc}1& -1\\ -2& 1\end{array}\right]$ に対する $\mathit{g}\left(\mathit{B},\mathit{C}\right)$ を評価します。

S = subs(g(B,C),{B,C},{[0 1; -1 0],[1 -1; -2 1]})

S = 
$$\begin{array}{l}-2\hspace{0.17em}{\Sigma }_1-2\hspace{0.17em}{\Sigma }_2+{\left({\Sigma }_1+{\Sigma }_2\right)}^2+{\mathrm{I}}_2\\ \\ \mathrm{where}\\ \\ \mathrm{ }{\Sigma }_1=\left(\begin{array}{cc}0& 1\\ -1& 0\end{array}\right)\\ \\ \mathrm{ }{\Sigma }_2=\left(\begin{array}{cc}1& -1\\ -2& 1\end{array}\right)\end{array}$$

式 S を symmatrix データ型から sym データ型に変換して、多項式の代入結果を表示します。

Ssym = symmatrix2sym(S)

Ssym = 
$$\left(\begin{array}{cc}0& 0\\ 0& 0\end{array}\right)$$

シンボリック行列変数およびシンボリック行列関数の方程式への代入

R2022b 以降

方程式 $\frac{\partial }{\partial X^{\mathrm{T}}}\mathrm{}\frac{\partial }{\partial X}\mathrm{}f\left(X,A\right)=2A$ を定義します。ここで、$\mathit{A}$ は 3 行 3 列の行列、$\mathit{X}$ は 3 行 1 列の行列です。$f(\mathit{X},\mathit{A})$ に、別のシンボリック式、およびシンボリック値をもつ $\mathit{A}$ を代入します。この方程式がこれらの値について真となるかどうかをチェックします。

2 つのシンボリック行列変数 $\mathit{A}$ および $\mathit{X}$ を作成します。$\mathit{A}$ と $\mathit{X}$ の既存の定義をワークスペースに保持したまま、シンボリック行列関数 $f(\mathit{X},\mathit{A})$ を作成します。方程式を作成します。

syms A [3 3] matrix
syms X [3 1] matrix
syms f(X,A) [1 1] matrix keepargs
eq = diff(diff(f,X),X.') == 2*A

eq(X, A) = 
$$\frac{\partial }{\partial X^{\mathrm{T}}}\mathrm{ }\frac{\partial }{\partial X}\mathrm{ }f\left(X,A\right)=2\hspace{0.17em}A$$

$f(\mathit{X},\mathit{A})$ に ${\mathit{X}}^{\mathit{T}}\mathit{AX}$ を代入し、この式の方程式に含まれる 2 次微分関数を評価します。

eq = subs(eq,f,X.'*A*X)

eq(X, A) = $$A^{\mathrm{T}}+A=2\hspace{0.17em}A$$

$\mathit{A}$ に次数 3 のヒルベルト行列を代入します。

eq = subs(eq,A,hilb(3))

eq(X, A) = 
$$\begin{array}{l}{\Sigma }_1+{{\Sigma }_1}^{\mathrm{T}}=2\hspace{0.17em}{\Sigma }_1\\ \\ \mathrm{where}\\ \\ \mathrm{ }{\Sigma }_1=\left(\begin{array}{ccc}1& \frac{1}{2}& \frac{1}{3}\\ \frac{1}{2}& \frac{1}{3}& \frac{1}{4}\\ \frac{1}{3}& \frac{1}{4}& \frac{1}{5}\end{array}\right)\end{array}$$

isAlways を使用して、この方程式がこれらの値について真となるかどうかをチェックします。isAlways は symfun 型または sym 型のシンボリック入力のみを受け入れるため、isAlways を使用する前に eq を symfunmatrix 型から symfun 型に変換します。

tf = isAlways(symfunmatrix2symfun(eq))

tf = 3×3 logical array

   1   1   1
   1   1   1
   1   1   1

シンボリック行列変数を含む式の評価

R2023b 以降

式 $\mathit{X}{\mathit{Y}}^2-\mathit{Y}{\mathit{X}}^2$ を定義します。ここで、$\mathit{X}$ と $\mathit{Y}$ は 3 行 3 列の行列です。行列をシンボリック行列変数として作成します。

syms X Y [3 3] matrix
C = X*Y^2 - Y*X^2

C = $$X\hspace{0.17em}{Y}^2-Y\hspace{0.17em}{X}^2$$

行列 X と Y に値を代入します。

X = [-1 2 pi; 0 1/2 2; 2 1 0];
Y = [3 2 2; -1 2 1; 1 2 -1];

subs を使用して、X と Y の値が代入された式 C を評価します。

Cnew = subs(C)

Cnew = 
$$\begin{array}{l}-{\Sigma }_1\hspace{0.17em}{{\Sigma }_2}^2+{\Sigma }_2\hspace{0.17em}{{\Sigma }_1}^2\\ \\ \mathrm{where}\\ \\ \mathrm{ }{\Sigma }_1=\left(\begin{array}{ccc}3& 2& 2\\ -1& 2& 1\\ 1& 2& -1\end{array}\right)\\ \\ \mathrm{ }{\Sigma }_2=\left(\begin{array}{ccc}-1& 2& \pi \\ 0& \frac{1}{2}& 2\\ 2& 1& 0\end{array}\right)\end{array}$$

結果を symmatrix データ型から double データ型に変換します。

Cnum = double(Cnew)

Cnum = 3×3

  -42.8496  -13.3584  -13.4336
   -0.7168    3.1416    0.0752
   -3.2832   29.8584   16.4248

入力引数

s — シンボリック入力

シンボリック スカラー変数 | シンボリック式 | シンボリック方程式 | シンボリック関数 | シンボリック配列 | シンボリック行列 | 構造体

シンボリック入力。シンボリック スカラー変数、シンボリック式、シンボリック方程式、シンボリック関数、シンボリック配列、シンボリック行列、または構造体として指定します。

データ型: sym | symfun | struct

match — 代入の対象となるスカラー変数

シンボリック スカラー変数 | シンボリック関数 | シンボリック式 | シンボリック配列 | cell 配列

代入の対象となるスカラー変数。シンボリック スカラー変数、シンボリック関数、シンボリック式、シンボリック配列、または cell 配列として指定します。

データ型: sym | symfun | cell

replacement — 新しい置換値

数値 | シンボリック数 | シンボリック スカラー変数 | シンボリック関数 | シンボリック式 | シンボリック配列 | 構造体 | cell 配列

代入する新しい置換値。数値、シンボリック数、シンボリック スカラー変数、シンボリック関数、シンボリック式、シンボリック配列、構造体、または cell 配列として指定します。

データ型: sym | symfun | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | struct | cell

sM — シンボリック入力

シンボリック行列変数 | シンボリック行列関数 | シンボリック式 | シンボリック方程式 | シンボリックな条件

シンボリック入力。シンボリック行列変数、シンボリック行列関数、シンボリック式、シンボリック方程式、またはシンボリック条件として指定します。

データ型: symmatrix | symfunmatrix

matchM — 代入の対象となる行列変数または行列関数

シンボリック行列変数 | シンボリック行列関数 | シンボリック式 | cell 配列

代入の対象となる行列変数または行列関数。シンボリック行列変数、シンボリック行列関数、シンボリック式、または cell 配列として指定します。

データ型: symmatrix | symfunmatrix | cell

replacementM — 新しい置換値

数値 | シンボリック数 | シンボリック行列変数 | シンボリック行列関数 | シンボリック式 | シンボリック配列 | cell 配列

代入する新しい置換値。数値、シンボリック数、シンボリック行列変数、シンボリック行列関数、シンボリック式、シンボリック配列、または cell 配列として指定します。replacementM のサイズは、matchM と同じであるか、sM の既定のシンボリック行列変数と同じでなければなりません。

データ型: sym | symmatrix | symfunmatrix | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | struct | cell

ヒント

• subs(s,__) は s を変更しません。s を変更するには、s = subs(s,__) を使用します。

• s が一変数多項式で、replacement が数値行列の場合、polyvalm(sym2poly(s),replacement) を使用して行列として s を評価します。すべての定数項は、単位行列にその定数をかけた項に置き換えられます。

バージョン履歴

R2006a より前に導入

R2023b: シンボリック行列変数へのワークスペースの値の代入

構文 subs(sM) を使用すると、sM 内のシンボリック行列変数およびシンボリック行列関数に MATLAB ワークスペースで割り当てられた値を代入してから sM を評価できます。値が代入されていない変数は、変数のままになります。例については、シンボリック行列変数を含む式の評価を参照してください。

R2022b: シンボリック方程式またはシンボリック条件におけるシンボリック行列変数およびシンボリック行列関数の代入

関数 subs は、最初の入力引数として、symmatrix 型または symfunmatrix 型のシンボリック方程式またはシンボリック条件を受け入れます。例については、シンボリック行列変数およびシンボリック行列関数の方程式への代入を参照してください。

R2022b: 入力順序に従う、微分を含むシンボリック代入

R2022b 以降、微分または関数 diff を含むシンボリック代入では、代入されるシンボリック オブジェクトの入力順序に従います。たとえば、次のコードは関数 diff を含むシンボリック代入を実行します。

syms m k x(t)
syms x_t x_t_ddot
eqSHM = m*diff(x(t),t,2) == -k*x(t);
eqSHMnew = subs(eqSHM,[x(t) diff(x(t),t,2)],[x_t x_t_ddot])

R2022b より前では、コードは次の出力を返します。

eqSHMnew = 
m*x_t_ddot == -k*x_t

R2022b 以降では、コードは次の出力を返します。

eqSHMnew =
0 == -k*x_t

出力が異なるのは、subs が最初に x(t) に x_t を代入するようになったためであり、この結果左辺が m*diff(x_t,t,2) となり、つまり 0 に等しくなります。以前のリリースと同じ代入結果を得るには、最初に diff(x(t),t,2) 項を指定して、それが x(t) 項の前に代入されるようにします。

eqSHMnew = subs(eqSHM,[diff(x(t),t,2) x(t)],[x_t_ddot x_t])

eqSHMnew = 
m*x_t_ddot == -k*x_t

R2022a: シンボリック行列関数での変数の代入

関数 subs は、最初の入力引数として、symfunmatrix 型のシンボリック行列関数を受け入れます。例については、シンボリック行列関数での変数の代入を参照してください。

R2021b: シンボリック式でのシンボリック行列変数の代入

関数 subs は、最初の入力引数として、symmatrix 型のシンボリック式を受け入れます。例については、配列によるシンボリック行列変数の置き換えおよび行列の特性多項式を参照してください。

参考

関数

• double | lhs | rhs | simplify | subexpr | vpa

トピック

• シンボリック式への代入
• シンボリック式の変数の置き換え
• シンボリック行列の要素の置き換え
• スカラーを行列で置き換える
• subs を使用したシンボリック式の求解