sqrt

Quadratwurzel

Syntax

B = sqrt(X)

Beschreibung

B = sqrt(X) gibt die Quadratwurzel jedes Elements des Arrays X zurück. Bei negativen oder komplexen Elementen von X erzeugt sqrt(X) komplexe Ergebnisse.

Der Bereich der sqrt-Funktion umfasst negative und komplexe Zahlen, die zu unerwarteten Ergebnissen führen können, wenn sie unbeabsichtigt verwendet werden. Für negative und komplexe Zahlen z = u + i*w gibt die komplexe Quadratwurzel sqrt(z) Folgendes zurück

sqrt(r)*(cos(phi/2) + 1i*sin(phi/2))

wobei r = abs(z) der Radius und phi = angle(z) der Phasenwinkel des geschlossenen Intervalls -pi <= phi <= pi ist.

Wenn Sie möchten, dass für negative und komplexe Zahlen Fehlermeldungen anstatt komplexer Ergebnisse zurückgegeben werden, verwenden Sie stattdessen realsqrt.

Beispiele

Quadratwurzel von Vektorelementen

Erstellen Sie einen Zeilenvektor, der sowohl negative als auch positive Werte enthält.

X = -2:2

X = 1×5

    -2    -1     0     1     2

Berechnet die Quadratwurzel jedes Elements von X.

Y = sqrt(X)

Y = 1×5 complex

   0.0000 + 1.4142i   0.0000 + 1.0000i   0.0000 + 0.0000i   1.0000 + 0.0000i   1.4142 + 0.0000i

Eingabeargumente

X — Input Array

Skalar | Vektor | Matrix | mehrdimensionales Array | Tabelle | Timetable

Eingabearray, angegeben als numerischer Skalar, Vektor, Matrix, mehrdimensionales Array, Tabelle oder Timetable.

Datentypen: single | double | table | timetable
Unterstützung komplexer Zahlen: Ja

Mehr über

IEEE-Konformität

Bei reellen Eingaben weist sqrt einige Verhaltensweisen auf, die sich von den Empfehlungen der Norm IEEE^®-754 unterscheiden. Insbesondere erzeugen negative Eingaben komplexe Ergebnisse statt NaN.

	MATLAB®	IEEE
sqrt(-0)	0	-0
sqrt(X) für X < 0	0+sqrt(-X)*i	NaN

Tipps

• Matrix-Quadratwurzel siehe sqrtm.

Erweiterte Fähigkeiten

Tall Arrays

Rechnen mit Arrays, die mehr Zeilen haben, als in den Speicher passen.

Die Funktion sqrt bietet vollständige Unterstützung für Tall-Arrays. Weitere Informationen finden Sie unter Tall-Arrays.

C/C++ Codegenerierung

Generieren Sie C und C++ Code mit MATLAB® Coder™.

Hinweise zur Verwendung und Einschränkungen:

• Die Simulation gibt einen Fehler aus. Der generierte eigenständige Code gibt NaN zurück, wenn der Eingabewert x reell ist, die Ausgabe jedoch komplex sein sollte. Zum Generieren des komplexen Ergebnisses machen Sie den Eingabewert komplex, indem Sie ihn als complex(x) übergeben.

• Wenn Sie Code für eigenständige Zielplattformen generieren und die Eingabe für sqrt in Ihrem MATLAB-Code keine Konstante ist, ist der Wert, den der generierte Code für sqrt(-0) zurückgibt, identisch zum Wert, den die Standard-Bibliotheksfunktion Ihres C/C++ Compilers zurückgibt. Wenn die Funktion der Standardbibliothek mit der Norm IEEE-754 konform geht, gibt der generierte Code -0 zurück.

GPU-Codegenerierung

Generieren von CUDA® Code für NVIDIA® Grafikprozessoren mit dem GPU Coder™.

Hinweise zur Verwendung und Einschränkungen:

• Die Simulation gibt einen Fehler aus. Der generierte eigenständige Code gibt NaN zurück, wenn der Eingabewert x reell ist, die Ausgabe jedoch komplex sein sollte. Zum Generieren des komplexen Ergebnisses machen Sie den Eingabewert komplex, indem Sie ihn als complex(x) übergeben.

Thread-Based Environment

Führen Sie mithilfe von MATLAB® backgroundPool den Code im Hintergrund aus oder machen Sie den Code mit der Parallel Computing Toolbox™ ThreadPool schneller.

Diese Funktion bietet vollständige Unterstützung für thread-basierte Umgebungen. Weitere Informationen finden Sie unter Run MATLAB Functions in Thread-Based Environment.

GPU-Arrays

Schnellere Codeausführung durch Ausführen auf einer Grafikkarte (GPU) mit der Parallel Computing Toolbox™.

Die Funktion sqrt unterstützt GPU-Array-Eingaben mit folgenden Verwendungshinweisen und Einschränkungen:

Wenn die Ausgabe der Funktion, die auf der Grafikkarte ausgeführt wird, komplex sein kann, müssen Sie ihre Eingabeargumente explizit als komplex angeben. Weitere Informationen finden Sie unter Work with Complex Numbers on a GPU (Parallel Computing Toolbox).

Weitere Informationen finden Sie unter Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Verteilte Arrays

Partitionieren von großen Arrays über den kombinierten Speicher Ihres Clusters mit Parallel Computing Toolbox™.

Diese Funktion bietet vollständige Unterstützung für verteilte Arrays. Weitere Informationen finden Sie unter Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Versionsverlauf

Eingeführt vor R2006a

R2023a: Direkte Durchführung von Berechnungen für Tabellen und Timetables

Die Funktion sqrt kann die Berechnung mit allen Variablen in einer Tabelle oder einem Timetable ausführen, ohne für den Zugriff auf diese Variablen eine Indizierung zu benötigen. Alle Variablen müssen Datentypen aufweisen, die die Berechnung unterstützen. Weitere Informationen finden Sie unter Direct Calculations on Tables and Timetables.

Siehe auch

nthroot | sqrtm | realsqrt