`yline`

Desenha uma linha horizontal em um valor y dado, atravessando os eixos.

Categoria: Graphics > Formatting and Annotation

Sintaxe

yline(yvalue)

Desenha uma linha horizontal em yvalue. Um vetor desenha uma linha por elemento.

yline(yvalue, LineSpec)

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

yline(yvalue, LineSpec, label)

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

yl = yline(___)

Retorna o objeto da linha.

Descrição

Diferente de line, a linha cobre toda a largura 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, um nível-alvo ou uma média. A versão vertical é xline.

Argumentos de entrada

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

Argumentos de saída

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

Exemplo

Marcar a média

y = [3 5 4 6 2 7];
plot(y)
h = yline(mean(y), ':r', 'mean');
h.Value
h.Label

Saída

ans = 4.5000
ans = 'mean'

Veja também

xline yregion line ylim text