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

nthroot

実数の n 乗根

ページ内をすべて折りたたむ

構文

Y = nthroot(X,N)

説明

Y = nthroot(X,N) は、X の実数の n 乗根を返します。X の要素が負の場合、対応する N の要素は奇数の整数でなければなりません。

例

例

すべて折りたたむ

ライブ スクリプトを開く

-27 の実数の 3 乗根を求めます。 

nthroot(-27,3)
ans = 
-3

比較のために (-27)^(1/3) を計算します。結果は、-27 の複素数の 3 乗根になります。 

(-27)^(1/3)
ans = 
1.5000 + 2.5981i
ライブ スクリプトを開く

-8 の複数の実数の n 乗根を計算します。

N = [5 3 -1];
Y = nthroot(-8,N)
Y = 1×3

   -1.5157   -2.0000   -0.1250
ライブ スクリプトを開く

底の行ベクトル X および計算する根の列ベクトル N を作成します。

X = [4 -3 -5];
N = [1; -1; 3];

X の要素の実数の n 乗根を計算します。結果は、底と根のすべての組み合わせを含む行列です。たとえば、Y(3,1) は 4 の 3 乗根です。 

Y = nthroot(X,N)
Y = 3×3

    4.0000   -3.0000   -5.0000
    0.2500   -0.3333   -0.2000
    1.5874   -1.4422   -1.7100
ライブ スクリプトを開く

底の行列 X および計算する根の行列 N を作成します。X の各要素は N の要素に対応しています。 

X = [-2 -2 -2; 4 -3 -5];
N = [1 -1 3; 1/2 5 3];

X の要素の実数の n 乗根を計算します。 

Y = nthroot(X,N)
Y = 2×3

   -2.0000   -0.5000   -1.2599
   16.0000   -1.2457   -1.7100

(別途処理される) 符号を除いて、結果は abs(X).^(1./N) と同じです。反対に、X.^(1./N) を使用して複素根を計算できます。

入力引数

すべて折りたたむ

入力配列。スカラー、ベクトル、行列、多次元配列、table または timetable として指定します。X の要素は実数でなければなりません。入力 X と N は同じサイズであるか、互換性のあるサイズでなければなりません。

データ型: single | double | table | timetable

計算する根。スカラー、ベクトル、行列、多次元配列、table、または timetable として指定します。N の要素は実数でなければなりません。X の要素が負の場合、対応する N の要素は奇数の整数でなければなりません。入力 X と N は同じサイズであるか、互換性のあるサイズでなければなりません。

  • X が多次元配列の場合、N を table または timetable にすることはできません。

  • X が table または timetable の場合、N は X と同じデータ型、あるいは互換性のあるサイズをもつスカラー、ベクトル、行列、または多次元配列にすることができます。両方の入力が table または timetable の場合は、入力要件についてRules for Table and Timetable Mathematicsを参照してください。

データ型: single | double | table | timetable

ヒント

  • 関数 power の方が数値の根の計算に関してより効果的ですが、実根と複素根の両方が存在する場合に、power は複素根のみを返します。このような場合に nthroot を使用して実根を取得します。

拡張機能

すべて展開する

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

バージョン履歴

R2006a より前に導入

すべて展開する

参考

|