`xline`

Desenha uma linha vertical em um valor x dado, atravessando os eixos.

Categoria: Graphics > Formatting and Annotation

Sintaxe

xline(xvalue)

Desenha uma linha vertical em xvalue. Um vetor desenha uma linha por elemento.

xline(xvalue, LineSpec)

Define o estilo e a cor da linha, por exemplo '--r'.

xline(xvalue, LineSpec, label)

Também anexa um rótulo de texto à linha.

xl = xline(___)

Retorna o objeto da linha.

Descrição

Diferente de line, a linha cobre toda a altura dos eixos mesmo quando os limites mudam, pois está ligada a um valor e não a um par de pontos extremos. Ela não afeta os limites automáticos dos eixos.

É útil para marcar um limiar, o instante de um evento ou uma média. A versão horizontal é yline.

Argumentos de entrada

xvalue: Posição ou posições ao longo do eixo x.
label: Texto exibido ao lado da linha.

Argumentos de saída

xl: Objeto de linha constante, classe matlab.graphics.chart.decoration.ConstantLine, com as propriedades Value, Label e Color.

Exemplo

Marcar um evento

t = 0:0.1:10;
plot(t, sin(t))
h = xline(5, '--r', 'event');
h.Value
h.Label

Saída

ans = 5
ans = 'event'

Veja também

yline xregion line xlim text