sqrt

Radice quadrata

Sintassi

B = sqrt(X)

Descrizione

B = sqrt(X) restituisce la radice quadrata di ciascun elemento dell'array X. Per gli elementi di X che sono negativi o complessi, sqrt(X) produce risultati complessi.

Il dominio della funzione sqrt include i numeri negativi e complessi che possono portare a risultati inaspettati se usati involontariamente. Per i numeri negativi complessi z = u + i*w, la radice quadrata complessa sqrt(z) restituisce

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

dove r = abs(z) è il raggio e phi = angle(z) l'angolo di fase sull'intervallo chiuso -pi <= phi <= pi.

Se si desidera che i numeri negativi e complessi restituiscano messaggi di errore anziché risultati complessi, utilizzare invece realsqrt.

Esempi

Radice quadrata di elementi del vettore

Creare un vettore riga contenente valori sia negativi che positivi.

X = -2:2

X = 1×5

    -2    -1     0     1     2

Calcolare la radice quadrata di ciascun elemento di 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

Argomenti di input

X — Array di input

scalare | vettore | matrice | array multidimensionale | tabella | orario

Array di input, specificato come scalare numerico, vettore, matrice, array multidimensionale, tabella o orario.

Tipi di dati: single | double | table | timetable
Supporto numeri complessi: Sì

Ulteriori informazioni

Conformità IEEE

Per gli input reali, sqrt ha alcuni comportamenti che differiscono da quelli raccomandati dallo Standard IEEE^®-754. In particolare, gli input negativi producono risultati complessi invece di NaN.

	MATLAB®	IEEE
sqrt(-0)	0	-0
sqrt(X) per X < 0	0+sqrt(-X)*i	NaN

Suggerimenti

• Per la radice quadrata della matrice, vedere sqrtm.

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione sqrt supporta completamente i tall array. Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• La simulazione produce un errore. Il codice standalone generato restituisce NaN quando il valore di input x è reale, ma l'output deve essere complesso. Per ottenere il risultato complesso, rendere complesso il valore di input passando in complex(x).

• Se si genera codice per destinazioni standalone e l'input di sqrt nel codice di MATLAB non è una costante, il valore che il codice generato restituisce per sqrt(-0) è identico al valore restituito dalla funzione di libreria standard del compilatore C/C++. Se la funzione della libreria standard è conforme allo Standard IEEE-754, il codice generato restituisce -0.

Generazione di codice GPU

Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Note su utilizzo e limitazioni:

• La simulazione produce un errore. Il codice standalone generato restituisce NaN quando il valore di input x è reale, ma l'output deve essere complesso. Per ottenere il risultato complesso, rendere complesso il valore di input passando in complex(x).

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

Questa funzione supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

La funzione sqrt supporta l'input di array GPU con queste note su utilizzo e limitazioni:

Se l'output della funzione in esecuzione sulla GPU può essere complesso, è necessario specificare esplicitamente gli argomenti di input come complessi. Per maggiori informazioni, vedere Work with Complex Numbers on a GPU (Parallel Computing Toolbox).

Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

Questa funzione supporta completamente gli array distribuiti. Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

R2023a: Esecuzione di calcoli direttamente su tabelle e orari

La funzione sqrt può eseguire calcoli su tutte le variabili all’interno di una tabella o di un orario senza dover eseguire indicizzazioni per accedere a tali variabili. Tutte le variabili devono avere tipi di dati che supportino il calcolo. Per maggiori informazioni, vedere Direct Calculations on Tables and Timetables.

Vedi anche

nthroot | sqrtm | realsqrt