# Gráfico de linhas

> Referência do componente de dashboard Gráfico de linhas, as séries, os eixos e os subgráficos empilhados dele, a janela e a retenção, a fidelidade do desenho e a caixa de ferramentas.

O **Gráfico de linhas** acompanha pontos ao longo do tempo: cada série lê um endereço da Logic,
amostrado na cadência do próprio gráfico para dentro do coletor de séries ao vivo da estação,
então o gráfico abre sobre uma janela já preenchida em vez de um eixo vazio. O mesmo desenho
serve ao gráfico gravado de uma execução no [Process](process) e nos
[Históricos](histories); o que um dashboard acrescenta é de onde vem a configuração, as
propriedades deste componente.

## Conteúdo {#content}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Título do gráfico | Cabeçalho opcional desenhado dentro do subgráfico. Este é o cabeçalho do próprio gráfico, não o título de canto do componente (aquele mora na seção Aparência compartilhada). | texto | vazio |

## Séries {#series}

Um cartão por série, na ordem declarada. **Adicionar série** junta uma; cada cartão carrega:

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Endereço | Endereço com raiz, na Logic, que a série lê. O campo sugere a partir da lista de pontos ao vivo, filtrada por pontos numéricos, e mostra a leitura atual do ponto assim que ele é nomeado. | endereço | vazio |
| Nome | Como a legenda e a dica de valor chamam a série. | texto | em branco recai no endereço |
| Cor | A tinta da linha como `#RRGGBB`. | cor hex | em branco toma a vez da paleta |
| Decimais | Com quantas casas as leituras desta série são escritas sob o cursor. Por série, porque os canais de um gráfico não são lidos com a mesma precisão: uma pressão com duas casas ao lado de uma contagem que não tem nenhuma. | de 0 a 15 | em branco usa a preferência da estação |
| Unir a linha através das lacunas | O que a linha faz onde esta série não foi lida. Desligado, a linha se parte no buraco, que é a figura honesta, porque a estação não tem nada para aquele trecho. Ligado, ela é levada em linha reta por cima, que é como um setpoint que simplesmente se manteve entre escritas é lido. | ligado / desligado | desligado |
| Subgráfico | Em qual dos subgráficos empilhados do gráfico a série é desenhada. Pedido só enquanto o gráfico tem subgráficos sob o dele. | Subgráfico 1 (o do próprio gráfico) · de Subgráfico 2 a Subgráfico 4 (os empilhados) | Subgráfico 1 |
| Eixo | Contra qual eixo de valor a série se escala, o primeiro ou o segundo. Pedido só dentro do subgráfico do próprio gráfico e enquanto existe um segundo eixo; uma série num subgráfico empilhado tem o eixo único daquele subgráfico. | primeiro · segundo | primeiro |
| Desenhar esta série | Se a série chega ao canvas. Persistido, então um canal deixado de fora da figura continua de fora na próxima vez que a tela abrir: o gesto de mostrar e esconder da caixa de ferramentas é para olhar, este é para escrever a tela. | ligado / desligado | ligado |

## Gráfico {#chart}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Forma | A forma que toda série toma sobre o eixo: uma medição contínua é uma linha, um total sob ela é uma área, um valor que se mantém até ser escrito de novo é um degrau, e uma quantidade por intervalo é barras no tempo. | Linha · Área · Degrau · Barras ao longo do tempo | Linha |
| Legenda | Onde a legenda fica. | sobre o subgráfico · sob o subgráfico · nenhuma | sobre o subgráfico |
| Navegação | Quanto o operador pode percorrer o eixo de tempo: uma janela fixa que nada move, roda e arrasto sobre o subgráfico, ou roda e arrasto mais uma barra de navegação sob o subgráfico mostrando onde a janela fica. | janela fixa · roda e arrasto · roda e uma barra de navegação | roda e arrasto |

## Eixos {#axes}

Todo eixo é um cartão: um nome, uma unidade (juntada ao nome entre colchetes), uma contagem de
divisões e, nos eixos de valor, pontas mantidas e uma borda.

**Eixo de tempo**

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Conta em | Como o eixo apresenta as posições das amostras: tempo decorrido em relação à borda da janela, carimbos de relógio (formatados conforme o idioma e os formatos da estação), ou o número simples da amostra. | o tempo desde que a janela abriu · o relógio · o número da amostra | o tempo desde que a janela abriu |
| Nome / Unidade | O nome e a unidade do eixo. | texto | vazio |
| Marcas | Quantas divisões são pedidas ao eixo. Uma contagem declarada é uma sugestão que o motor honra tão de perto quanto os valores redondos permitem, não a promessa daquele número de marcas. | de 2 a 20 | em branco (automático) |

**Eixo de valor** (e o **Segundo eixo de valor** opcional, para séries cuja escala não tem nada
a ver com a primeira; sem ele, toda série divide a única escala que há)

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Nome / Unidade / Marcas | Como no eixo de tempo. | | |
| Mín / Máx | As pontas em que a escala é mantida. Deixado por conta própria, um eixo de valor se reajusta a cada amostra, então a linha mais alta está sempre no topo da janela e nada pode ser comparado com um minuto atrás; manter uma ponta para isso. Cada ponta é mantida por conta própria: um piso sozinho guarda a linha do zero enquanto o teto respira. | números | em branco (automático) |
| Desenhado no | Em que borda do subgráfico a régua fica. | esquerda · direita | esquerda |

**Espaço ao lado do subgráfico.** Um eixo de valor sem nome nem unidade fica só com uma margem
fina ao lado dos números, seja qual for a largura do gráfico; com nome ou unidade, fica com o
espaço de que o nome girado precisa. Um segundo eixo de valor desenhado na mesma borda fica além
dos números e do nome do primeiro. Quando o gráfico é desenhado mais estreito do que os eixos de
valor e um subgráfico legível precisam juntos, o segundo eixo de valor deixa de escrever os
números: as séries dele continuam na própria escala, e as leituras delas continuam na dica de
valor. Alargar o gráfico traz os números de volta.

## Subgráficos empilhados {#stacked-plots}

Duas grandezas lidas no mesmo instante não precisam dividir uma régua: um subgráfico empilhado
sob o do próprio gráfico ganha uma escala própria e o mesmo eixo de tempo, então a temperatura
e a vazão são lidas uma sob a outra em vez de espremidas na régua uma da outra. Um gráfico tem
no máximo **quatro subgráficos de altura**: o dele mais até três empilhados sob ele; o cartão de
cada subgráfico empilhado carrega o eixo dele (nome, unidade, marcas, pontas mantidas, borda) e:

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Altura | Quão alto o subgráfico é desenhado em relação ao do próprio gráfico, que é 1. | de 0,25 a 4 | 1 |

Uma série declara em qual subgráfico ela cai no cartão dela.

## Avaliação {#evaluation}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Desenhar a faixa aprovada da execução em andamento | Desenha, atrás das séries, a faixa aprovada da execução que a unidade está executando agora. Os limites vêm da avaliação do procedimento que a unidade estiver executando, e um limite que segue um canal de referência se move com ele. Ela não nomeia unidade nenhuma: a unidade é a que as séries já leram; numa tela de modelo ela chega quando uma unidade abre a tela, e uma tela que não lê unidade nenhuma não tem execução a acompanhar. | ligado / desligado | desligado |

É assim que um gráfico de tela acompanha um procedimento em execução; um gráfico de uma
execução gravada nos Históricos já carrega as faixas da execução dele.

Uma faixa leva o nome do critério dela, escrito no primeiro canto dela que nenhuma linha do
gráfico cruza, começando pelo canto de cima à direita. Onde as linhas a cruzam em todos os
cantos e no meio das duas pontas, a faixa é desenhada sem o nome.

## Histórico {#history}

Dois botões diferentes: a janela é o que o gráfico enquadra, a retenção é o que a estação guarda
por trás. Um gráfico pode guardar dez minutos e enquadrar o último, então navegar para trás
percorre o que foi guardado em vez de encontrar um eixo vazio. As amostras vivem em memória;
reiniciar o aplicativo recomeça a coleta.

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Mostrar | O que a janela mostra ao abrir: uma janela móvel que acompanha a amostra mais nova, ou tudo o que a estação guardou para o gráfico, por mais longe que isso vá. | uma janela móvel · tudo o que é guardado | uma janela móvel |
| Janela (s) | O trecho que uma janela móvel mostra. Pedido só enquanto a janela se move. | de 5 a 86.400 (1 dia) | 60 |
| Amostrar a cada (ms) | A cadência de amostragem do próprio gráfico. Mudá-la começa um buffer novo a partir de agora, porque uma cadência faz parte da identidade de uma série coletada. | de 100 (a varredura) a 3.600.000 (1 h) | 500 |
| Guardar | O que os números de retenção significam. | só a janela · um trecho de tempo · um número de amostras | só a janela |
| Guardar por (s) | O trecho guardado por série enquanto a retenção é um trecho de tempo. | de 5 a 604.800 (7 dias) | 600 |
| Guardar (amostras) | A contagem guardada por série enquanto a retenção é um número de amostras. | de 2 a 20.000 | 2.000 |

A estação concede retenção dentro de três tetos: 20.000 amostras por ponto, 60.000 por
componente e 200.000 para a estação como um todo. Uma retenção que um teto não pôde conceder
inteira é dita sob o próprio gráfico, e não só no editor. Quando o teto da própria estação já
está gasto, uma série nova não coleta nada e diz isso: "A estação já está guardando todo o
histórico que permite, então esta série não coleta nada. Encurte a retenção de outro gráfico
para abrir espaço.".

## Fidelidade e desempenho {#fidelity-and-performance}

Quanto dos dados chega ao canvas, a configuração mais consequente do gráfico. Desenhar toda
amostra trava conforme os canais e a janela crescem; reduzir sem dizer isso é pior. A redução
acontece **na hora de desenhar e nunca no que é guardado**, e ela é **adaptativa**: o gráfico
conta os pontos dentro da faixa visível, e abaixo do limiar a redução desaparece; ampliar sempre
revela os dados de verdade.

Uma **predefinição** preenche todos os campos de uma vez; tocar em qualquer campo isolado torna
o conjunto Personalizado por si só, porque nada é guardado além dos valores.

| Predefinição | O que ela grava |
|---|---|
| Fidelidade máxima | Limiar 100.000 (além do que qualquer canvas resolve, ou seja, nunca reduzir), manter os picos, símbolos até 1.000 pontos, desenhar fora da janela, sem animação, modo mostrado no canto. |
| Equilibrado | Os valores com que um gráfico nasce (abaixo). |
| Desempenho máximo | Limiar 400, média de cada intervalo, sem símbolos, nada desenhado fora da janela, sem animação, sem marca de modo. |
| Personalizado | Não é uma escolha: é a leitura mostrada quando os campos não casam com nenhum dos conjuntos nomeados. |

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Desenhar toda amostra até | Quantos pontos dentro da faixa visível são o limite abaixo do qual a redução se desliga. Ela conta a figura inteira, todas as séries desenhadas juntas. | de 100 a 100.000 | 2.000 |
| Acima disso, preservar | Qual redução roda acima do limiar, nomeada pelo que ela preserva: o mínimo *e* o máximo de cada intervalo (um pico que durou uma amostra não pode ser descartado), o ponto que guarda a silhueta da curva, ou a média de cada intervalo, a mais barata e a que achata um pico. | Preservar os picos · Preservar a forma · Média | Preservar os picos |
| Um símbolo por amostra até | Quantos pontos visíveis ainda podem carregar cada um um símbolo; zero nunca os desenha. Um símbolo só significa alguma coisa enquanto a redução está desligada. | de 0 a 5.000 | 200 |
| Desenhar o que está fora da janela | Se o que está fora da faixa visível é desenhado (de forma grosseira: ele volta a ser o dado de verdade no instante em que é enquadrado). | ligado / desligado | ligado |
| Animar o desenho | Se o desenho se anima. Desligado, porque dados ao vivo que deslizam são mais difíceis de ler. | ligado / desligado | desligado |
| Dizer no canto em que modo o gráfico está | Uma marca discreta no canto dizendo se a tela mostra a medição ou uma redução dela. Poluição numa tela de operação, essencial numa tela de análise. | ligado / desligado | desligado |

Uma estimativa sob os campos diz quanto a configuração custa, ao vivo conforme ela é digitada.

## Caixa de ferramentas {#toolbox}

A seção **Caixa de ferramentas** escolhe quais botões o operador recebe neste gráfico, para que
uma tela de operação em que o operador não pode mexer na escala deixe de carregar a barra de
ferramentas de uma tela de análise. Sem nenhuma marcada, nenhuma barra de ferramentas é desenhada.

| Ferramenta | O que ela faz | No conjunto padrão |
|---|---|---|
| Selecionar uma área para ampliar | Arma a ampliação por caixa sobre o subgráfico. | sim |
| Restaurar a ampliação | Devolve a janela a tudo o que está desenhado. | sim |
| Ajustar a escala à mão | Fixa à mão o período de tempo e a faixa de valor, ou devolve qualquer um dos dois ao ajuste. O botão fica aceso enquanto algo está fixado. Uma janela fixada que não contém amostras diz isso sob o desenho, em vez de se ler como um gráfico que parou. | não |
| Mínimo, média e máximo da janela mostrada | Abre um painel com o menor, o médio e o maior valor de cada série dentro da janela mostrada. Medido só enquanto o painel está aberto. | não |
| Desenhar uma linha de referência | Desenha uma linha num valor ou num instante. As linhas vivem só enquanto a tela fica aberta, nada é persistido, e o botão fica aceso enquanto alguma linha está desenhada. | não |
| Salvar PNG | Baixa o desenho como um PNG. | sim |
| Copiar PNG | Põe o desenho na área de transferência como um PNG. | sim |
| Mostrar ou esconder séries | Mostra ou esconde uma série sem editar a tela. | sim |
| Ligar e desligar a dica de valor | Alterna a dica de valor que aparece ao passar o cursor. | sim |
| Tela cheia | Preenche a janela com este gráfico. | sim |

Enquanto a Navegação está em janela fixa, a lista deixa de fora Selecionar uma área para ampliar
e Restaurar a ampliação, e a barra de ferramentas não os desenha: uma janela que nada move não tem ampliação a
que eles respondam. As marcas deles são guardadas, então deixar a janela se mover de novo traz os
dois botões de volta.

## Numa tela de modelo {#on-a-models-screen}

Numa tela definida num modelo do Process, os campos de endereço das séries são encabeçados
pelos canais abstratos do modelo: escolher um deles vincula o canal e deixa a unidade para ser
respondida quando uma unidade abrir a tela. Os pontos da própria estação mantêm o lugar deles
atrás desses canais, porque uma tela de modelo pode legitimamente ler um.