RPD Vaktari Measure · manual de utilização

01O que faz

O RPD Vaktari Measure lê os ficheiros CSV que um sistema de visão Visitri escreve enquanto inspeciona peças, e converte-os nas estatísticas necessárias para decidir se o processo está sob controlo: percentagem fora de tolerância, capacidade, cartas de controlo, Pareto de defeitos e um relatório completo para imprimir ou entregar.

Não mede nada e não mexe na máquina. Apenas lê uma pasta. Se parar o programa, a produção continua exatamente igual; simplesmente deixa de ver as estatísticas até o voltar a arrancar.

Vigia uma pasta. De poucos em poucos segundos procura ficheiros CSV novos ou alterados.
Agrupa as medições em janelas. Uma janela é uma referência, um lote, uma passagem e uma câmara. É a unidade sobre a qual tudo é calculado.
Guarda o seu próprio histórico. Depois de lido um ficheiro, os seus dados vivem na pasta de histórico do programa. Pode arquivar ou apagar os CSV sem perder nada.
Funciona sozinho. Python e um navegador, mais nada. Sem instalação, sem base de dados, sem ligação à internet e sem licença.

do que precisaUm PC com Python 3.8 ou superior, acesso de leitura à pasta onde o programa de medição deixa os CSV, e um navegador. Nada é instalado e nada é enviado para lado nenhum: o programa serve apenas páginas ao seu próprio PC.

02Instalação e arranque

Copie a pasta do programa para onde quiser no PC — C:\RPD-Vaktari\Measurement analysis é o sítio habitual — e abra start_vaktari_measure.bat num editor de texto para indicar a pasta que quer vigiar:

set CARPETA=C:\STATS\Vaktari
set PORT=8760

CARPETA é a pasta onde o programa de medição deixa os CSV. PORT só precisa de ser alterado se outro programa já usar o 8760. Uma instância do programa vigia uma pasta; se tiver duas, arranque duas cópias em duas portas diferentes.

Três formas de o arrancar

start_vaktari_measure.bat: Abre uma janela onde vê o que o programa está a fazer. É a que deve usar da primeira vez, e sempre que algo não funcione.
START_vaktari_measure_silent.vbs: Arranca-o sem qualquer janela. Tudo o que teria escrito vai para log_vaktari.log. É a do dia a dia — ponha um atalho na pasta Arranque e arrancará com o PC.
STOP_vaktari_measure.bat: Para o programa. Só termina o que estiver à escuta na porta, pelo que os restantes programas Python do PC não são tocados.

Depois de a correr, abra http://localhost:8760 no navegador. A partir de outro PC da mesma rede, use o endereço do PC servidor, por exemplo http://192.168.1.40:8760.

primeiro arranqueA primeira varredura de uma pasta que já contém milhares de ficheiros demora algum tempo — cerca de quarenta segundos para três mil ficheiros. O painel abre de imediato e vai-se enchendo à medida que a varredura avança; não é preciso esperar. Os arranques seguintes são imediatos, porque os dados já estão na pasta de histórico.

03A barra superior

Tudo o que está acima dos separadores decide que dados está a ver. Tudo o que está abaixo é calculado a partir dessa seleção.

Ref.: A referência da peça. Mudá-la recarrega todo o ecrã.
LOT: O lote. * significa todos os lotes do intervalo.
Câmara: Que sistema de visão está a analisar. Aqui não há opção « todas », e é intencional — ver a secção 12.
Intervalo: Hoje, 7 dias, 30 dias ou todo o histórico. Os dois campos de data permitem qualquer outro intervalo à mão.
Idioma: Seis idiomas. A escolha fica memorizada no navegador.
Tema: Escuro (o de série, com a barra superior escura) ou claro. A impressão é sempre feita em claro, seja qual for o tema no ecrã.
scan: Força uma releitura imediata da pasta em vez de esperar pela varredura automática.

os seletores mostram tudoCada seletor lista todos os valores que chegaram, não apenas os que encaixam nos outros filtros. Uma opção sem dados atrás fica assinalada como tal. Assim consegue sempre ver o que mais foi medido e ir lá, em vez de um filtro lho esconder sem dizer nada.

A barra superior com o **tema claro**. O escuro é o de série: mantém uma barra escura sobre os dados, o que cansa menos num ecrã de oficina ligado todo o dia.

04AO VIVO · o que está a acontecer agora

É o ecrã de oficina. Mostra a última janela que chegou e mais nada, pelo que responde a uma única pergunta: o que a máquina está a produzir agora é bom?

A última janela. O primeiro cartão é a **conformidade de peça**: a percentagem de peças com todas as cotas dentro de tolerância ao mesmo tempo. Os restantes são um cartão por cota.

Em cada cartão de cota:

% fora — a proporção de medições fora de tolerância nesta janela. A cor é o semáforo: verde dentro, âmbar acima do limiar de aviso, vermelho acima do de alarme.
Cpk — capacidade, quanta margem tem o processo dentro da tolerância. 1,33 é o objetivo habitual.
μ — a média, com a sua distância ao nominal em micrómetros.
σ — a dispersão.
vs janela anterior — quanto se moveu a média desde a janela anterior. É o que deteta uma ferramenta a começar a derivar antes de algo sair de tolerância.
A pequena barra em baixo é a tolerância desenhada à escala, com as medições sobre ela.

**Tendência recente**: percentagem fora de tolerância, janela a janela, nas últimas janelas desta referência. Uma linha que sobe de forma sustentada é um processo a derivar; os picos em janelas isoladas costumam ser outra coisa.

o que conta como uma janelaUma janela é uma referência, um lote, uma passagem e uma câmara — na prática, um ficheiro CSV. As peças são emparelhadas por número dentro de uma janela, nunca entre janelas: a numeração reinicia, e a peça 7 de um ficheiro nada tem a ver com a peça 7 de outro.

05Cotas por atributos

Nem tudo o que se verifica se mede. Uma rosca existe ou não existe; uma marca lê-se ou não se lê. Estas verificações não têm nominal nem tolerância — o CSV traz NA onde iria o nominal — e o veredicto sai do campo Status: 5 significa que a peça passa, qualquer outro valor significa que não.

As cotas por atributos são listadas à parte, com a contagem de peças verificadas, aceites e rejeitadas.

São mostradas separadas das cotas medidas porque não há nada para fazer média: um atributo não tem média, nem σ, nem Cpk. Uma verificação de passa/não passa não tem distribuição.

também contamUm atributo falhado torna a peça má, exatamente como uma cota fora de tolerância. Os atributos entram na conformidade de peça e nos dois Pareto — uma peça sem rosca é uma peça má por melhores que sejam as suas medições.

06Medições não encontradas

Quando a ferramenta de visão não encontra o que procura, escreve −1 em vez de uma medição. O mesmo acontece quando uma medição depende de outra e a primeira falhou.

As medições não encontradas são contadas à parte, por cota.

São contadas separadamente e deixadas de fora de todo o resto de forma deliberada. Um −1 não é uma medição má: não é medição nenhuma. Se entrasse na média arrastá-la-ia onze milímetros para baixo e tornaria as estatísticas absurdas, e contá-la como fora de tolerância culparia o processo por algo que a câmara fez.

Não entram na média, nem em σ, nem em Cp, nem em Cpk, nem na carta de controlo.
Não contam como fora de tolerância.
Uma peça com uma medição não encontrada fica fora da contagem de conformidade: o seu veredicto é desconhecido, não mau.

o que costuma significarUma série de medições não encontradas é quase sempre um problema de visão ou de posição da peça, não de processo: iluminação, focagem, fixação, uma peça mal posta ou uma peça que não está lá. Verifique isso antes de mexer na máquina.

07Os dois Pareto

Ambos os gráficos ordenam as cotas que geram rejeição. São parecidos e respondem a perguntas diferentes, pelo que vale a pena ter claro qual é qual.

Pareto de defeitos

Quantos defeitos gera cada cota, do mais frequente ao menos, com a percentagem acumulada.

É o clássico: o que falha mais vezes. A curva acumulada é calculada sobre o total de defeitos, pelo que fecha sempre nos 100 %.

Que defeito corrigir primeiro

Quantas peças recuperaria corrigindo cada cota sozinha.

Este responde à pergunta que realmente importa na oficina: o que corrijo para salvar mais peças? Uma peça pode falhar várias cotas ao mesmo tempo, e corrigir apenas uma não a salva. Este gráfico conta apenas as peças que falham essa cota e mais nenhuma — as peças que uma única correção recuperaria mesmo.

quando os dois divergemSe uma cota está no topo do primeiro gráfico mas baixa no segundo, é porque falha sobretudo em peças que já são más por outro motivo. Corrigi-la sozinha alteraria muito pouco a sua rejeição. O segundo gráfico é o que deve orientar o esforço.

08ACUMULADO · a vista de trabalho

O separador ao vivo mostra uma janela. Este junta todo o intervalo selecionado e é onde se olha quando se quer saber como correu o turno, não como saiu a última peça.

A **carta de controlo X̄–R**: médias de subgrupo ao longo do tempo, com os limites de controlo calculados a partir do próprio processo.

Os limites de controlo não são a tolerância. São o que o processo faz quando o deixam em paz. Um ponto fora, ou uma série de pontos do mesmo lado, significa que algo mudou — mesmo que todas as peças continuem dentro de tolerância. É essa toda a graça de uma carta de controlo: avisa antes de se fazer rejeição, não depois.

Todas as janelas do intervalo, com os seus números. Serve para encontrar o momento em que as coisas mudaram.

09REFERÊNCIAS · o que foi verificado e quando

Uma linha por dia, com as horas do dia ao longo, e um bloco colorido onde uma referência estava a ser verificada. Responde a « o que verificámos na terça-feira, e a que horas mudámos? » sem abrir nada.

A linha temporal na vista Detalhe. Cada cor é uma referência; a posição de um bloco é a hora do dia em que estava a correr. A escala de horas aparece em cima e em baixo.

À direita da legenda está o seletor Vista. Detalhe desenha as séries de cada câmara em separado: quando duas câmaras verificam o mesmo lote ao mesmo tempo, os seus ficheiros alternam e sai um bloco por ficheiro, como na figura acima. Agrupado junta tudo num único bloco por referência, com todas as câmaras e todos os lotes lá dentro. O bloco só é cortado quando muda a referência ou quando passam mais de 30 minutos sem nenhum ficheiro, de modo que as paragens longas continuam a ver-se.

O mesmo ecrã na vista Agrupado: um bloco por referência. Passando o rato por cima aparecem os lotes e as câmaras que contém.

A vista escolhida fica guardada neste navegador e só muda o desenho: o resumo de cima, os números de cada dia e a tabela de totais são os mesmos nas duas vistas. Uma série que passa da meia-noite é desenhada até às 24 na linha do dia em que começou.

Clique em qualquer bloco e essa referência e lote são carregados nos restantes separadores. É a forma mais rápida de entrar numa série concreta: encontra-a na linha temporal, clica, e vai para o relatório completo. Na vista Agrupado, um bloco com um só lote e uma só câmara seleciona-os; se tiver mais, abre-se a referência com todos os lotes e mantém-se a câmara que já estava escolhida.

Totais por referência no intervalo: lotes, séries, peças, tempo ocupado e percentagem fora de tolerância.

âmbitoEste ecrã trata de que referências foram verificadas. Não é, deliberadamente, um ecrã de controlo de máquina: os erros, as paragens e a disponibilidade estão no RPD Vaktari Machine, que é o módulo para isso.

10RELATÓRIO COMPLETO · o documento

Tudo sobre a seleção atual, paginado para imprimir e entregar — a um cliente, a uma auditoria, ou à pasta do lote. O comando de impressão do navegador converte-o em PDF.

**Quadro de tolerâncias**: cada cota sobre a sua própria tolerância, desenhada à escala, para ver de relance quais estão centradas e quais andam rente a um limite.

**Distribuições**: o histograma de cada cota com os seus limites, o nominal e a curva ajustada.

**Conformidade de peça**: quantas cotas falha cada peça. A primeira barra são as peças boas.

O relatório traz ainda a tabela resumo por cota, as correlações entre cotas, as secções de atributos e de medições não encontradas, os dois Pareto e uma conclusão escrita.

**Conclusões**: o relatório diz por palavras o que significam os números e o que ver primeiro.

11EXPORTAR

As três formas de os dados saírem do programa.

Todas as medições: Uma linha por medição individual. É a que deve levar para o Excel ou para outro pacote estatístico.
Só resultados: Uma linha por cota, com n, média, σ, Cp, Cpk e as contagens. Um resumo, não dados em bruto.
Relatório em PDF: Abre a caixa de impressão do navegador sobre o relatório completo. Escolha « Guardar como PDF ».

As exportações CSV usam o mesmo separador e a mesma marca decimal dos ficheiros de entrada, pelo que abrem corretamente no Excel sem qualquer passo de conversão.

12Várias câmaras na mesma pasta

Se mais do que um sistema de visão escrever na pasta vigiada, os seus ficheiros chegam misturados. O campo VIS do CSV diz de que câmara veio cada medição, e o seletor Câmara da barra superior escolhe a que está a analisar.

não há « todas as câmaras »e não deve haver. Duas câmaras são dois sistemas de medição, cada um com a sua calibração, a sua ótica e o seu desvio. Juntar as suas medições de uma mesma cota dá uma média que não é de nenhuma das duas e um σ que é sobretudo a diferença entre câmaras. A capacidade que daí sai não está um pouco errada — não significa nada.

Números de peça

Cada câmara numera as suas peças a partir de 1 e reinicia quando lhe calha. A peça 7 da câmara 1 e a peça 7 da câmara 2 não são a mesma peça, e o programa nunca o assume. As peças só são emparelhadas por número dentro de uma mesma janela.

As câmaras também nem sempre tiram o mesmo número de fotografias: trabalham por tempo, e se algo acontecer uma delas salta um ciclo. Por isso um ficheiro pode ter mais peças do que outro dos mesmos minutos. É normal e o programa conta com isso.

Se faltar uma medição a uma peça dentro da sua própria janela, ela fica fora da contagem de conformidade em vez de ser adivinhada, e o relatório diz quantas peças isso afetou.

13Como ler os números

LSL, USL: Os limites de tolerância. LSL = nominal + tol− e USL = nominal + tol⁺, tirados do próprio CSV.
μ: A média das medições. Ao lado, a sua distância ao nominal em micrómetros.
σ: O desvio-padrão — a dispersão das medições.
Cp: Quanto vale a tolerância face à dispersão, se o processo estivesse perfeitamente centrado. Cp = (USL − LSL) / 6σ.
Cpk: O mesmo, tendo em conta o quanto o processo está realmente descentrado. É o que deve olhar. 1,33 é o objetivo habitual.
Pp, Ppk: Os mesmos dois, calculados sobre todo o intervalo em vez de dentro dos subgrupos. Dizem o que o processo realmente deu, derivas entre janelas incluídas.

σ e σw

Cp e Cpk calculam-se sobre σw, a dispersão dentro do subgrupo: o que o processo consegue fazer quando nada se move. Pp e Ppk usam o σ global, que contém ainda todas as derivas e todas as afinações do intervalo.

Assim, um Cpk bom com um Ppk mau é uma mensagem clara: a máquina é capaz, mas está a mover-se. Procure a deriva — desgaste de ferramenta, efeito da temperatura, um operador que corrige entre lotes — em vez de olhar para a precisão da máquina.

linhas StatusAs linhas do tipo Status são o veredicto da própria máquina. São mantidas fora da estatística dimensional e mostradas à parte, para que a opinião da máquina nunca contamine as medições. Para as cotas de atributo, o campo Status é o veredicto — ver a secção 05.

14Quando salta um alarme

Os avisos no topo do separador ao vivo estão ordenados por gravidade. Os limiares definem-se na linha de comandos e estes são os de série:

Aviso	Salta quando	De série
Fora de tolerância	Demasiadas peças fora dos limites nesta janela	mais de 10 %
Atenção	Menos, mas mais do que gostaria	mais de 2 %
Salto de média	A média moveu-se de uma janela para a seguinte	desativado
Carta de controlo	Um ponto fora dos limites, ou 2 em 3 além de 2σ	sempre ativo
Não encontradas	Demasiadas medições −1	aviso acima de 1 %, alarme acima de 5 %
Estado da máquina	A própria máquina marcou medições como NOK	qualquer

Os dois sobre os quais atuar primeiro são o salto de média e a carta de controlo. Ambos podem saltar com todas as peças ainda dentro de tolerância, que é exatamente quando corrigir sai barato. Quando o aviso de fora de tolerância está vermelho, já está a fazer rejeição.

Para alterar um limiar, edite o ficheiro de arranque. Por exemplo, para avisar a 5 % e alarmar com um salto de média de 15 µm:

vaktari_measure.py --dir "%CARPETA%" --port %PORT% ^
    --pct-out-warn 5 --delta-mu-um 15

15Onde vivem os dados

Dentro da pasta do programa há uma pasta hist. É essa a base de dados. Os CSV da pasta vigiada são apenas a caixa de entrada.

hist\dades-AAAA-MM-DD.json: Um ficheiro por dia de produção, com todas as janelas lidas nesse dia. São estes os dados a sério.
hist\fitxers.json: O registo dos ficheiros já lidos, com o seu tamanho e data, para que um ficheiro nunca seja contado duas vezes.
hist\marques.json: As intervenções que marca nos gráficos.

apagar os CSV é seguroDepois de lido um ficheiro, os seus dados estão em hist e o CSV deixa de ser necessário. Pode arquivar ou apagar os ficheiros da pasta vigiada sem perder uma única estatística. Movê-los para uma subpasta é melhor do que apagá-los, caso alguma vez precise dos dados em bruto.

apagar hist não éSe apagar hist perde o histórico. O programa só reconstruiria o que os CSV ainda visíveis contiverem — pelo que se esses também foram arquivados, esses dados perderam-se. Faça cópia de hist juntamente com o resto do PC.

A pasta de histórico pode ser movida para outro sítio com --state, o que é útil se preferir tê-la numa unidade de rede com cópia de segurança.

16Os ficheiros

vaktari_measure.py: O servidor. Lê os CSV, mantém o histórico e serve o painel.
vaktari_measure.html: O painel.
vaktari_measure_i18n.js: As traduções, seis idiomas.
vaktari_measure_theme.css: Todas as cores e todas as tipografias. Os dois temas vivem aqui, e acrescenta-se um novo copiando um bloco.
vaktari_measure.ico, .svg: A marca.
start_vaktari_measure.bat: Arranque com janela visível.
START_vaktari_measure_silent.bat: Arranque sem saída no ecrã.
START_vaktari_measure_silent.vbs: Arranque sem qualquer janela. É o habitual.
STOP_vaktari_measure.bat: Para o programa.
hist\: O histórico — ver a secção 15.
log_vaktari.log: O que o programa escreveu, quando foi arrancado sem janela.

versãoO número de versão está em baixo à direita de todos os ecrãs e na capa deste manual. É a data de publicação mais uma letra. Indique-o se reportar um problema.

17Problemas frequentes

O navegador diz que não consegue ligar

O programa não está a correr. Arranque-o com o .bat visível e leia o que escreve, ou abra log_vaktari.log. As causas habituais são o Python não estar instalado ou a porta já estar ocupada.

Diz que a porta está ocupada

Já há outra cópia a correr — abra o painel, provavelmente está lá. Se não, execute STOP_vaktari_measure.bat e volte a arrancar, ou mude PORT no ficheiro de arranque.

Não aparece nada, ou diz « sem dados »

Verifique que CARPETA aponta para a pasta correta e que há mesmo CSV lá dentro. A barra superior mostra a pasta vigiada e a hora da última varredura. Veja também o intervalo: a seleção pode estar em hoje e os dados serem de ontem — um aviso di-lo, com um botão para lá ir.

Falta uma câmara no seletor

O campo VIS falta ou está vazio nos ficheiros dessa câmara. A barra superior mostra as variáveis encontradas. Se o campo não for escrito, tem de ser corrigido na configuração de saída do programa de medição.

Os números saem estranhos depois de uma mudança

Veja o seletor de lote. Com * está a ver vários lotes ao mesmo tempo, e uma afinação pelo meio alarga o σ e afunda o Cpk. Escolha um único lote e compare.

Uma cota não mostra média nem Cpk

É um atributo: uma verificação de passa/não passa sem nominal, pelo que não há nada para fazer média. Ver a secção 05.

Demora a arrancar

Só da primeira vez numa pasta com muito histórico. O painel pode ser usado enquanto a varredura avança. Se demorar sempre, a pasta vigiada contém provavelmente anos de ficheiros — arquive os antigos numa subpasta; o histórico conserva os seus dados.