`ruler2num`

Converte valores exibidos em uma régua de eixo para os números que os eixos guardam internamente.

Categoria: Graphics > Formatting and Annotation

Sintaxe

num = ruler2num(data, ruler)

Converte data, por exemplo valores datetime, em posições numéricas ao longo da régua.

Descrição

Eixos que mostram datas, durações ou categorias guardam suas posições como números. ruler2num fornece o número que corresponde a um dado valor, para que o código possa definir limites, marcas ou posições de anotação nas unidades usadas pelos eixos. Em um eixo de datas, os números contam dias a partir do primeiro dia plotado.

Uma régua numérica devolve a entrada sem alteração. num2ruler é a inversa.

Argumentos de entrada

data: Valores do tipo que a régua exibe.
ruler: Uma régua de eixo, como ax.XAxis ou ax.YAxis.

Argumentos de saída

num: Array numérico do mesmo tamanho de data.

Exemplo

Número da terceira data

t = datetime(2024,1,1) + days(0:4);
plot(t, [1 4 2 5 3])
ax = gca;
n = ruler2num(t(3), ax.XAxis)

Saída

n = 2

Observações

No MatLivre a conversão está disponível para réguas numéricas e de datetime.

Veja também

num2ruler datetime xlim xticks gca