Avaliações

Os critérios de aprovação e reprovação pelos quais uma execução é julgada, cada campo de um critério, o que cada resultado faz com a execução, e como os resultados se dobram num veredito.

Ver como Markdown

Uma avaliação é um conjunto reutilizável de critérios de aprovação e reprovação. Cada critério vigia um canal legível dentro de uma janela da execução e julga as amostras gravadas dele contra uma faixa fixa ou uma tolerância em torno de outro canal; cada um fecha com um resultado próprio, e o veredito da execução é a dobra deles. O motor julga ao vivo sobre as linhas que o datalog grava, então o canal de um critério e o canal de referência dele precisam ser colunas do datalog do procedimento: o arquivo da execução prova o que foi julgado. As avaliações vivem em Process > Modelos > modelo > Preparação > Avaliações e exigem a permissão Editar receitas e avaliações.

A pasta Avaliações

Selecionar a linha Avaliações abre a página da pasta ("Critérios de aprovação e reprovação pelos quais uma execução é julgada. A avaliação lê canais do processo.") com um cartão por avaliação, por nome; clicar num cartão o abre, e o X o remove. Sem nenhuma, a página diz "Nenhuma avaliação ainda. Acrescente uma."

Comando O que faz Fica cinza quando (situação) Não é desenhado quando (papel)
Avaliação (barra de detalhe, com a pasta selecionada; clique direito Adicionar avaliação) Acrescenta Avaliação <n> sem critérios e a seleciona. Alguma unidade tem uma execução, ou o runtime está parado. Sem Editar receitas e avaliações.

A página da avaliação

O cabeçalho carrega o nome, a frase "Critérios de aprovação e reprovação pelos quais uma execução é julgada." e uma pílula contando os critérios. Todo campo salva sozinho, e toda edição redesenha a prévia do critério escolhido.

Definição

Campo O que é Valores / padrão
Nome Como a avaliação se chama na árvore, no seletor de Avaliação de um procedimento e no seletor Avaliar agora de um painel. Texto livre; Avaliação <n> na criação.
Notas Texto livre para quem a lê. Vazio por padrão.

Como a execução é julgada

Este cartão declara a dobra que o motor aplica, na ordem dele:

  • NOK se qualquer critério reprova.
  • Indeterminado se nenhum reprovou e um não pôde ser julgado.
  • OK só quando todos eles passaram.

"A severidade não muda nada disso. Ela é lida contra o limiar de aborto do procedimento e decide apenas se uma reprovação também encerra a execução ali." O cartão também alerta antes de uma execução: "Um critério não pode ser julgado como está configurado, então uma execução terminaria Indeterminada." (ou "<n> critérios não podem ser julgados …"), e diz "Nenhum procedimento deste modelo roda contra esta avaliação ainda." enquanto nada a referencia.

A lista de critérios

A lista é encabeçada por Critérios, e o botão Critério dela acrescenta uma linha no primeiro canal legível do modelo (âncora Execução inteira, modo Janela inteira, uma faixa fixa com os dois lados abertos, severidade Grave, sem nome) e a escolhe. Clicar numa linha a abre na coluna Critério; sem nada escolhido, a coluna diz "Selecione um critério para editá-lo inteiro num lugar só, com o que cada campo decide ao lado." A lista carrega o critério inteiro e rola para o lado além da largura do painel.

Coluna O que ela guarda
Nome O nome do critério, editável ali mesmo.
Canal O canal legível julgado.
Âncora Execução inteira, Janela de tempo ou Segmento, cada uma com a forma do trecho que ela julga ao lado do nome e a consequência dela na dica.
Janela As duas configurações de que a âncora precisa: Seg e Estab numa âncora de Segmento, De e Até numa âncora de Janela de tempo, "Execução inteira" para Execução inteira.
Modo Janela inteira ou Um ponto, com a forma dele.
Limite Faixa fixa ou Em torno do setpoint, com a forma dele.
Faixa Mín e Máx para uma faixa fixa ("em branco deixa o lado aberto"); o canal de referência e a tolerância ± para um limite relativo.
Severidade Leve, Grave ou Crítica.
Resultado O que o critério acrescenta à execução ("NOK reprova a execução", "NOK reprova e para a execução", "Não pode ser julgado"), com a frase inteira na dica.
Ação de linha Remover pergunta "Excluir critério": o nome (ou o nome do canal), "Isto remove o critério da avaliação."

O critério por inteiro

A coluna abre com uma prévia: a faixa do critério escolhido e o trecho que ele julga, sobre eixos declarados sem nenhuma amostra por perto (não há execução por trás de uma tela de configuração). Uma faixa fixa é desenhada nos valores de engenharia do canal, com espaço para uma reprovação de cada lado; uma faixa relativa é desenhada como desvio em relação ao canal de referência, que fica como a linha no zero. Quando nada pode ser desenhado (nenhum limite definido, nenhuma referência escolhida) a moldura diz por quê, em vez de ficar vazia. Sob ela, todo campo fica sobre uma legenda fixa e, onde a resposta se move com as entradas, sobre o efeito do que está em vigor.

Campo O que é Valores / padrão Frase de efeito
Nome "Nomeia esta checagem onde quer que o resultado dela apareça." Vazio, cai no canal, no relatório; a coluna se encabeça Critério <n> até a linha ser nomeada. Texto livre; vazio na criação.
Canal "A leitura julgada. Ela precisa ser uma coluna de datalog do procedimento." Os canais legíveis do modelo; o primeiro na criação.
Âncora (JANELA) "Sobre qual trecho da execução este critério é julgado." Execução inteira (padrão), Janela de tempo, Segmento. Execução inteira: "Julgado sobre a execução inteira. Ele não precisa de receita." Janela de tempo: "Julgado entre dois instantes medidos a partir do início da execução." Segmento: "Julgado enquanto a receita está naquele segmento, depois do atraso. Uma pausa o estende."
Segmento (começando em 0) e Estabilização (ms) (âncora de Segmento) "Qual segmento da receita é julgado, e quanto tempo dentro dele a janela espera antes de abrir." Números inteiros; 0 e 0 por padrão. Nenhum dos dois campos aceita número negativo: a entrada é recusada, a nota diz isso embaixo do campo, e o valor anterior volta. "Abre com o segmento 1." ou "Abre 2 s dentro do segmento 1."
De (ms) e Até (ms, 0 = fim da execução) (âncora de Janela de tempo) "Os dois instantes, contados a partir do início da execução, entre os quais a janela fica." Milissegundos; 0 e 0 por padrão. Até = 0 significa até a execução terminar; fora isso, o Até precisa ficar depois do De. "De 5 s até o fim da execução.", "De 5 s até 30 s.", ou "O Até fica no De ou antes dele, então a janela está vazia."
Modo "De quanto daquele trecho o veredito depende." Janela inteira (padrão), Um ponto. Janela inteira: "Toda amostra da janela precisa passar." Um ponto: "Só a última amostra da janela decide."
Limite (LIMITES) "Que forma o limite toma, que é também o que os campos sob ele pedem." Faixa fixa (padrão), Em torno do setpoint. Faixa fixa: "Uma faixa fixa em valores de engenharia. Qualquer um dos lados pode ficar aberto." Em torno do setpoint: "Uma faixa em torno de outro canal, amostrado na mesma linha."
Mín e Máx (faixa fixa) "Os valores de engenharia entre os quais a leitura tem de ficar. Um lado deixado vazio fica aberto." Números ou vazio; os dois vazios na criação. "Nenhum limite definido, então toda leitura passa.", "Passa em 20 ou acima.", "Passa em 80 ou abaixo.", "Passa entre 20 e 80.", ou "O Mín fica acima do Máx, então isto não pode ser julgado e uma execução terminaria Indeterminada.", que é o que o bloco RESULTADO sob a linha também diz
Referência e ± Tolerância (relativo) "O canal contra o qual a leitura é medida, e quão longe dele ela pode ficar." Um canal legível do modelo e um número; nenhum e 0 na criação. "Passa dentro de ±0,5 de Setpoint." ou "Escolha o canal em torno do qual a tolerância é medida."
Severidade "Lida contra o limiar de aborto do procedimento. Ela também define o destaque no relatório." Leve, Grave (padrão), Crítica.
RESULTADO O que o critério produz, e o que isso faz com a execução. Somente leitura. Veja abaixo.

O que o resultado diz

Frase Detalhe Quando
"NOK reprova a execução" "Uma reprovação torna a execução NOK." ou, quando algum procedimento roda a avaliação, "Uma reprovação torna a execução NOK. A execução ainda termina, porque nenhum procedimento aborta nesta severidade." Nenhum procedimento que roda esta avaliação aborta na severidade deste critério.
"NOK reprova e para a execução" "Uma reprovação torna a execução NOK e a encerra ali, porque <procedure> aborta nesta severidade." Um procedimento que roda esta avaliação tem Abortar em NOK nesta severidade ou abaixo dela.
"Não pode ser julgado" "Como está configurado ele não pode ser julgado, então deixaria a execução Indeterminada." seguido do motivo. Um dos motivos abaixo vale.

Os motivos pelos quais um critério não pode ser julgado, perguntados no momento da configuração na ordem do próprio motor: "Ele não vigia canal nenhum deste modelo."; "O canal que ele vigia não é gravado pelo datalog do procedimento que o roda."; "Ele não segue canal de referência nenhum deste modelo."; "O Até fica no De ou antes dele, então a janela está vazia."; "Os limites dele estão incompletos ou invertidos."; "O canal de referência não é gravado pelo datalog do procedimento que o roda." Os motivos de datalog são perguntados apenas aos procedimentos que rodam a avaliação; uma avaliação que procedimento nenhum pegou ainda está inacabada, não errada.

Como os critérios se dobram num veredito

Toda linha gravada dentro de uma janela ativa é classificada uma vez: avaliada, indisponível (um valor faltando ou uma qualidade ruim) ou inválida (um valor bom que não é número finito; um NaN bom continua sendo dado bruto auditável, mas não certifica um critério numérico). Um limite fixo precisa do valor vigiado; um limite relativo precisa do valor vigiado e do de referência da mesma linha. Os contadores Amostras avaliadas, Amostras fora, Amostras indisponíveis e Amostras inválidas e o conjunto congelado de canais afetados são gravados por critério, e também são legíveis ao vivo nos pontos Procedure.* da unidade (veja O espaço de endereços da unidade).

Os resultados são rigorosos quanto à evidência. No modo Janela inteira, qualquer violação avaliada prova NOK; fora disso, uma linha indisponível ou inválida, uma observação interrompida ou uma janela vazia tornam o critério Indeterminado; só evidência completa dentro da faixa o torna OK. O modo Um ponto decide pela última amostra ativa da janela apenas; as classificações anteriores ficam nos contadores. Um procedimento Temporizado reancora todo critério por ciclo e conta os ciclos reprovados. O veredito da execução se dobra em ordem: uma execução abortada ou qualquer critério NOK a torna NOK; fora isso, qualquer resultado Indeterminado a torna Indeterminada; resultados todos OK a tornam OK; uma execução sem avaliação termina sem veredito. Só um NOK confirmado dispara o limiar de aborto do procedimento ou a contagem de ciclos reprovados.

Onde uma avaliação é usada

Superfície O que ela faz com a avaliação
O estágio Julgar de um procedimento Julga toda execução do procedimento; o seletor Abortar em NOK ≥ chega junto. A frase do estágio diz "Julga 4 critérios, e um NOK Grave aborta a execução." ou "…, e um NOK nunca aborta a execução." Um procedimento com avaliação e sem datalog não valida. Veja Procedimentos.
O cartão Comandos únicos de um painel Avaliar agora grava uma linha por um datalog e a julga contra a avaliação; o veredito é gravado nos Históricos. Os canais da avaliação precisam ser colunas do datalog escolhido.
Comandos de etiqueta Um marcador pode ler o nome, o canal, os limites, a severidade, o resultado, o erro, os instantes da janela, os contadores de amostras, os canais afetados ou a pior excursão de um critério, para um ciclo explícito. Veja Ações.
Relatórios A seção de critérios imprime o resultado de cada critério com o destaque que a severidade dele define.

Remover avaliação

Remover avaliação fica no grupo de perigo da barra de detalhe com a avaliação selecionada, no menu de clique direito dela, e como o X no cartão da página da pasta. Ele pergunta antes ("Excluir avaliação", "Isto remove a avaliação e os critérios dela."). Todo procedimento que julgava por ela esvazia a referência de Avaliação dele e passa a terminar as execuções dele sem veredito. Ele exige Editar receitas e avaliações e fica cinza sob a trava de engenharia e o runtime parado.

O que uma avaliação não faz

  • Ela não julga nada que um datalog não grave, e nada fora de uma execução ou de uma amostra.
  • Ela não tem critérios de expressão: um critério é uma faixa ou uma tolerância sobre um canal.
  • Ela não difere entre unidades em nada: um conjunto de limites serve toda unidade do modelo.
  • Ela não encerra execução por si. Se um NOK aborta a execução é o limiar Abortar em NOK do procedimento, lido contra a severidade do critério.