Conversor de ângulos de Euler e quaternions

Converta entre ângulos de Euler, quaternions, eixo-ângulo e matrizes. Inclui pré-visualização 3D, normalização, saída JSON e snippets para Unity, ROS e Python.

Ângulos de Euler ↔ quaternions (roll, pitch, yaw)

Converta rotações XYZ em quaternions, eixo-ângulo, matrizes, JSON e snippets reutilizáveis.

Esta calculadora converte ângulos de Euler XYZ (roll, pitch, yaw) em quaternions normalizados para rotações 3D e faz o caminho inverso. Quaternions são comuns em robótica, drones e motores/gráficos 3D porque ajudam a evitar o gimbal lock e deixam as interpolações de orientação mais estáveis.

Convenção fixa: XYZ intrínseco, sistema de mão direita, R = Rz(yaw) · Ry(pitch) · Rx(roll).

Ângulos → Quaternion

Informe roll (X), pitch (Y) e yaw (Z) em graus. O quaternion calculado é normalizado automaticamente.

ex. 45
Aceita ponto ou vírgula decimal.
ex. -30
Ordem aeronáutica: roll → pitch → yaw.
ex. 120
Sequência intrínseca XYZ.

Quaternion normalizado

Informe ângulos de Euler em graus para obter o quaternion.
w
x
y
z
Eixo-ângulo
Eixo indefinido (rotação nula).

Matriz de rotação

JSON / código para copiar

Quaternion → Ângulos

Informe os componentes do quaternion (w, x, y, z). Se não for unitário, normalizamos antes de converter.

ex. 0,9239
ex. 0,3827
ex. 0
ex. 0

Ângulos XYZ

Informe os componentes do quaternion para ver os ângulos.
‖q‖
w (normalizado)
x (normalizado)
y (normalizado)
z (normalizado)
Eixo-ângulo
Eixo indefinido (rotação nula).

Matriz de rotação

JSON / código para copiar

Quando o pitch se aproxima de ±90° ocorre gimbal lock e os ângulos de Euler deixam de ser únicos. Use o eixo-ângulo para interpretar a rotação.

Eixo-ângulo → Quaternio

Informe um ângulo de rotação e um eixo 3D. O eixo é normalizado automaticamente quando o comprimento não é 1.

ex. 90
1 / 0 / 0
0 / 1 / 0
0 / 0 / 1

Quaternio normalizado

w
x
y
z

Matriz de rotação

JSON / código para copiar

Pré-visualização 3D simples

A orientação do cubo é atualizada com o último cálculo válido. É uma ajuda visual rápida, não um motor 3D CAD.

A pré-visualização é atualizada com o último cálculo válido.
Qual convenção é utilizada?

Trabalhamos com rotações XYZ intrínsecas (roll, pitch, yaw) em um sistema de mão direita. As entradas são em graus e os resultados exibem também radianos e a matriz de rotação.

Como lidar com quaternions não unitários?

Qualquer quaternion diferente de zero é normalizado antes de calcular os ângulos. Mostramos a norma original e avisamos se houve normalização.

Qual é a diferença entre ângulos de Euler e quaternions?

Ângulos de Euler (roll, pitch, yaw) são intuitivos, porém podem sofrer gimbal lock e instabilidade numérica. Quaternions representam rotações 3D sem ambiguidades e são mais robustos para controles, robótica e motores 3D.

O que é gimbal lock e como os quaternions evitam esse problema?

O gimbal lock ocorre quando dois eixos da descrição em Euler se alinham e um grau de liberdade se perde. Quaternions usam quatro componentes, preservam os três graus de rotação e atravessam qualquer movimento 3D sem singularidades.

Posso usar esta calculadora com os dados de roll, pitch e yaw de um sensor IMU?

Sim. Informe os valores de roll, pitch e yaw do IMU na ordem XYZ fixa e em graus para obter quaternions normalizados prontos para robótica, drones ou simulações 3D.