cart2sph

Transformar coordenadas cartesianas en esféricas

Sintaxis

[azimuth,elevation,r] = cart2sph(x,y,z)

Descripción

[azimuth,elevation,r] = cart2sph(x,y,z) transforma los elementos correspondientes de los arreglos de coordenadas cartesianas x, y y z en coordenadas esféricas azimuth, elevation y r.

Ejemplos

De coordenadas cartesianas a esféricas

Convierta las coordenadas cartesianas definidas por las entradas correspondientes en las matrices x, y y z a las coordenadas esféricas az, el y r. Estos puntos corresponden a los ocho vértices de un cubo.

x = [1 1 1 1; -1 -1 -1 -1]

x = 2×4

     1     1     1     1
    -1    -1    -1    -1

y = [1 1 -1 -1; 1 1 -1 -1]

y = 2×4

     1     1    -1    -1
     1     1    -1    -1

z = [1 -1 1 -1; 1 -1 1 -1]

z = 2×4

     1    -1     1    -1
     1    -1     1    -1

[az,el,r] = cart2sph(x,y,z)

az = 2×4

    0.7854    0.7854   -0.7854   -0.7854
    2.3562    2.3562   -2.3562   -2.3562

el = 2×4

    0.6155   -0.6155    0.6155   -0.6155
    0.6155   -0.6155    0.6155   -0.6155

r = 2×4

    1.7321    1.7321    1.7321    1.7321
    1.7321    1.7321    1.7321    1.7321

Argumentos de entrada

x,y,z — Coordenadas cartesianas

escalares | vectores | matrices | arreglos multidimensionales

Coordenadas cartesianas, especificadas como escalares, vectores, matrices o arreglos multidimensionales. x, y y z deben ser del mismo tamaño o tener tamaños compatibles (por ejemplo, x es una matriz de M por N, y es un escalar y z es un escalar o un vector fila de 1 por N). Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

Tipos de datos: single | double

Argumentos de salida

azimuth — Ángulo azimut

arreglo

Ángulo azimut, devuelto como un arreglo. azimuth es el ángulo en sentido contrario a las agujas del reloj en el plano x-y medido en radianes desde el eje x positivo. El valor del ángulo está en el intervalo [-pi pi].

elevation — Ángulo de elevación

arreglo

Ángulo de elevación, devuelto como un arreglo. elevation es el ángulo de elevación en radianes desde el plano x-y. El valor del ángulo está en el intervalo [-pi/2, pi/2].

r — Radio

arreglo

Radio, devuelto como un arreglo. r es la distancia desde el origen hasta un punto. Las unidades de longitud de r son arbitrarias y coinciden con las unidades de los arreglos de entrada x, y y z.

Algoritmos

La aplicación desde las coordenadas cartesianas tridimensionales a las coordenadas esféricas es

azimuth = atan2(y,x)
elevation = atan2(z,sqrt(x.^2 + y.^2))
r = sqrt(x.^2 + y.^2 + z.^2)

La notación para coordinadas esféricas no es la estándar. Para la función cart2sph, elevation, se mide desde el plano x-y. Observe que, si elevation = 0, el punto está en el plano x-y. Si elevation = pi/2, el punto está en el eje z positivo.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función cart2sph es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Si utiliza cart2sph con operandos de tipo simple y de tipo doble, es posible que el código generado no produzca el mismo resultado que MATLAB^®. Consulte Binary Element-Wise Operations with Single and Double Operands (MATLAB Coder).

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función cart2sph es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

cart2pol | pol2cart | sph2cart