5.6 math -- Funzioni matematiche

Questo modulo sempre disponibile. Fornisce l'accesso alle funzioni matematiche definite dallo standard C.

Queste funzioni non possono essere usate con i numeri complessi; usate le funzioni con lo stesso nome dal modulo cmath se avete bisogno del supporto per i numeri complessi. Visto che molti utilizzatori non intendono acquisire le necessarie conoscenze matematiche per comprendere i numeri complessi, si deciso di porre una distinzione tra le funzioni che li supportano e quelle che non lo fanno. Ricevere un'eccezione piuttosto che un risultato complesso consente di rilevare immediatamente la presenza di inaspettati numeri complessi usati come un parametro, coscch il programmatore possa determinare come e perch l'eccezione venne inizialmente generata.

Le seguenti funzioni vengono fornite da questo modulo. Tranne quando esplicitamente dichiarato, tutti i valori restituiti sono numeri in virgola mobile.

acos( x)
Restituisce l'arcocoseno di x.

asin( x)
Restituisce l'arcoseno di x.

atan( x)
Restituisce l'arcotangente di x.

atan2( y, x)
Restituisce atan(y / x).

ceil( x)
Restituisce l'approssimazione per eccesso di x come numero in virgola mobile.

cos( x)
Restituisce il coseno di x.

cosh( x)
Restituisce il coseno iperbolico di x.

degrees( x)
Converte l'angolo x da radianti a gradi.

exp( x)
Restituisce e**x.

fabs( x)
Restituisce il valore assoluto di x.

floor( x)
Restituisce l'approssimazione per difetto di x come numero in virgola mobile.

fmod( x, y)
Restituisce fmod(x, y), come definito nella libreria C della piattaforma. Notate che l'espressione Python x % y pu non restituire lo stesso lo stesso risultato.

frexp( x)
Restituisce la mantissa e l'esponente di x come una coppia (m, e). m un numero in virgola mobile ed e un numero intero come nell'espressione x == m * 2**e. Se x zero, restituisce (0.0, 0), altrimenti 0.5 <= abs(m) < 1.

hypot( x, y)
Restituisce la distanza euclidea, sqrt(x*x + y*y).

ldexp( x, i)
Restituisce x * (2**i).

log( x[, base])
Restituisce il logaritmo di x in base base. Se la base base non specificata, restituisce il logaritmo naturale di x. Modificato nella versione 2.3: Aggiunto l'argomento base.

log10( x)
Restituisce il logaritmo di x in base 10.

modf( x)
Restituisce la parte frazionaria ed intera di x. Entrambi i risultati riportano il segno di x. la parte intera restituita come numero in virgola mobile.

pow( x, y)
Restituisce x**y.

radians( x)
Converte l'angolo x da gradi a radianti.

sin( x)
Restituisce il seno di x.

sinh( x)
Restituisce il seno iperbolico di x.

sqrt( x)
Restituisce la radice quadrata di x.

tan( x)
Restituisce la tangente di x.

tanh( x)
Restituisce la tangente iperbolica di x.

Notate che frexp() e modf() hanno un modello di chiamata/risultato diverso dalle equivalenti chiamate C: esse richiedono un singolo argomento e restituiscono una coppia di valori, invece che restituire il loro secondo risultato per mezzo di un 'parametro di output' (non esiste una cosa del genere in Python).

Il modulo definisce anche due costanti matematiche:

pi
La costante matematica pi (NdT: Pi greco).

e
La costante matematica e.

Note: Il modulo matematico math consiste per lo pi di sottili involucri costruiti attorno alle funzioni matematiche della libreria C della piattaforma sottostante. Il comportamento in casi eccezionali specificato in modo vago dagli standard del linguaggio C, e Python eredita gran parte del funzionamento dei messaggi di errore delle funzioni matematiche proprio dall'implementazione C della piattaforma sottostante. Come risultato, le eccezioni specifiche sollevate in caso di errore (e anche se alcuni argomenti sono considerati del tutto eccezionali) non vengono definite in una maniera utile che sia portabile tra le piattaforme o le release. Per esempio, non sappiamo se math.log(0) debba restituire -Inf o sollevare (ValueError) o (OverflowError), e in alcuni casi quando math.log(0) solleva OverflowError, math.log(0L) potrebbe sollevare ValueError.

Vedete anche:

Modulo cmath:
La versione per numeri complessi della gran parte di queste funzioni.
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.