RPD Vaktari Measure · manual de uso

01Qué hace

RPD Vaktari Measure lee los ficheros CSV que un sistema de visión Visitri escribe mientras inspecciona piezas, y los convierte en las estadísticas necesarias para decidir si el proceso está bajo control: porcentaje fuera de tolerancia, capacidad, cartas de control, Pareto de defectos y un informe completo para imprimir o entregar.

No mide nada y no toca la máquina. Sólo lee una carpeta. Si paras el programa, la producción sigue exactamente igual; simplemente dejas de ver las estadísticas hasta que lo vuelvas a arrancar.

Vigila una carpeta. Cada pocos segundos busca ficheros CSV nuevos o modificados.
Agrupa las medidas en ventanas. Una ventana es una referencia, un lote, una pasada y una cámara. Es la unidad sobre la que se calcula todo.
Guarda su propio histórico. Una vez leído un fichero, sus datos viven en la carpeta de histórico del programa. Puedes archivar o borrar los CSV sin perder nada.
Funciona solo. Python y un navegador, nada más. Sin instalación, sin base de datos, sin conexión a internet y sin licencia.

qué necesitasUn PC con Python 3.8 o superior, acceso de lectura a la carpeta donde el programa de medida deja los CSV, y un navegador. No se instala nada y no se envía nada a ninguna parte: el programa sólo sirve páginas a tu propio PC.

02Instalación y arranque

Copia la carpeta del programa donde quieras del PC — C:\RPD-Vaktari\Measurement analysis es el sitio habitual — y abre start_vaktari_measure.bat con un editor de texto para indicar la carpeta que quieres vigilar:

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

CARPETA es la carpeta donde el programa de medida deja los CSV. PORT sólo hay que cambiarlo si otro programa ya usa el 8760. Una instancia del programa vigila una carpeta; si tienes dos, arranca dos copias en dos puertos distintos.

Tres maneras de arrancarlo

start_vaktari_measure.bat: Abre una ventana donde ves lo que hace el programa. Es la que hay que usar la primera vez, y siempre que algo no funcione.
START_vaktari_measure_silent.vbs: Lo arranca sin ninguna ventana. Todo lo que habría escrito va a log_vaktari.log. Es la del día a día — pon un acceso directo en la carpeta de Inicio y arrancará con el PC.
STOP_vaktari_measure.bat: Para el programa. Sólo mata lo que esté escuchando en el puerto, de modo que los demás programas Python del PC no se tocan.

Una vez en marcha, abre http://localhost:8760 en el navegador. Desde otro PC de la misma red, usa la dirección del PC servidor, por ejemplo http://192.168.1.40:8760.

primer arranqueEl primer escaneo de una carpeta que ya contiene miles de ficheros tarda un rato — unos cuarenta segundos para tres mil ficheros. El panel se abre enseguida y se va rellenando a medida que avanza el escaneo; no hay que esperar. Los arranques siguientes son inmediatos, porque los datos ya están en la carpeta de histórico.

03La barra superior

Todo lo que hay encima de las pestañas decide qué datos estás mirando. Todo lo que hay debajo se calcula a partir de esa selección.

Ref.: La referencia de la pieza. Cambiarla recarga toda la pantalla.
LOT: El lote. * significa todos los lotes del rango.
Cámara: Qué sistema de visión estás analizando. Aquí no hay opción « todos », y es deliberado — ver la sección 12.
Rango: Hoy, 7 días, 30 días o todo el histórico. Las dos casillas de fecha permiten cualquier otro rango a mano.
Idioma: Seis idiomas. La elección queda recordada en el navegador.
Tema: Oscuro (el de serie, con la barra superior oscura) o claro. La impresión siempre se hace en claro, sea cual sea el tema en pantalla.
scan: Fuerza una relectura inmediata de la carpeta en lugar de esperar al escaneo automático.

los selectores muestran todoCada selector lista todos los valores que han llegado, no sólo los que encajan con los demás filtros. Una opción sin datos detrás queda marcada como tal. Así siempre puedes ver qué más se ha medido e ir allí, en vez de que un filtro te lo esconda sin decir nada.

La barra superior con el **tema claro**. El oscuro es el de serie: mantiene una barra oscura sobre los datos, que cansa menos en una pantalla de taller encendida todo el día.

04EN VIVO · qué está pasando ahora

Es la pantalla de taller. Muestra la última ventana que ha llegado y nada más, de modo que responde a una sola pregunta: lo que la máquina está haciendo ahora, ¿es bueno?

La última ventana. La primera tarjeta es la **conformidad de pieza**: el porcentaje de piezas con todas las cotas dentro de tolerancia a la vez. El resto son una tarjeta por cota.

En cada tarjeta de cota:

% fuera — la proporción de medidas fuera de tolerancia en esta ventana. El color es el semáforo: verde dentro, ámbar por encima del umbral de aviso, rojo por encima del de alarma.
Cpk — capacidad, cuánto margen tiene el proceso dentro de la tolerancia. 1,33 es el objetivo habitual.
μ — la media, con su distancia al nominal en micras.
σ — la dispersión.
vs ventana anterior — cuánto se ha movido la media desde la ventana de antes. Es lo que detecta una herramienta que empieza a derivar antes de que nada salga de tolerancia.
La barra pequeña de abajo es la tolerancia dibujada a escala, con las medidas encima.

**Tendencia reciente**: porcentaje fuera de tolerancia, ventana a ventana, de las últimas ventanas de esta referencia. Una línea que sube de forma sostenida es un proceso que deriva; los picos en ventanas sueltas suelen ser otra cosa.

qué cuenta como una ventanaUna ventana es una referencia, un lote, una pasada y una cámara — en la práctica, un fichero CSV. Las piezas se emparejan por número dentro de una ventana, nunca entre ventanas: la numeración se reinicia, y la pieza 7 de un fichero no tiene nada que ver con la pieza 7 de otro.

05Cotas por atributos

No todo lo que se comprueba se mide. Una rosca está o no está; una marca se lee o no se lee. Estas comprobaciones no tienen nominal ni tolerancia — el CSV lleva NA donde iría el nominal — y el veredicto sale del campo Status: 5 significa que la pieza pasa, cualquier otro valor significa que no.

Las cotas por atributos se listan aparte, con el recuento de piezas comprobadas, aceptadas y rechazadas.

Se muestran separadas de las cotas medidas porque no hay nada que promediar: un atributo no tiene media, ni σ, ni Cpk. Una comprobación de pasa/no pasa no tiene distribución.

también cuentanUn atributo fallado hace la pieza mala, exactamente igual que una cota fuera de tolerancia. Los atributos entran en la conformidad de pieza y en los dos Pareto — una pieza sin rosca es una pieza mala por buenas que sean sus medidas.

06Medidas no encontradas

Cuando la herramienta de visión no encuentra lo que busca, escribe −1 en lugar de una medida. Pasa lo mismo cuando una medida depende de otra y la primera ha fallado.

Las medidas no encontradas se cuentan aparte, por cota.

Se cuentan por separado y se dejan fuera de todo lo demás de forma deliberada. Un −1 no es una medida mala: no es ninguna medida. Si entrara en la media la arrastraría once milímetros abajo y haría las estadísticas absurdas, y contarlo como fuera de tolerancia culparía al proceso de algo que ha hecho la cámara.

No entran en la media, ni en σ, ni en Cp, ni en Cpk, ni en la carta de control.
No cuentan como fuera de tolerancia.
Una pieza con una medida no encontrada queda fuera del recuento de conformidad: su veredicto es desconocido, no malo.

qué suele significarUna tirada de medidas no encontradas casi siempre es un problema de visión o de posición de la pieza, no de proceso: iluminación, enfoque, sujeción, una pieza mal puesta o una pieza que no está. Compruébalo antes de tocar la máquina.

07Los dos Pareto

Ambos gráficos ordenan las cotas que generan rechazo. Se parecen y responden a preguntas distintas, así que vale la pena tener claro cuál es cuál.

Pareto de defectos

Cuántos defectos genera cada cota, de más frecuente a menos, con el porcentaje acumulado.

Es el clásico: qué falla más a menudo. La curva acumulada se calcula sobre el total de defectos, de modo que siempre cierra en el 100 %.

Qué defecto hay que arreglar primero

Cuántas piezas recuperarías arreglando cada cota por sí sola.

Este responde a la pregunta que de verdad importa en taller: ¿qué arreglo para salvar más piezas? Una pieza puede fallar varias cotas a la vez, y arreglar sólo una no la salva. Este gráfico cuenta sólo las piezas que fallan esa cota y ninguna otra — las piezas que una sola corrección recuperaría de verdad.

cuando los dos no coincidenSi una cota está arriba en el primer gráfico pero baja en el segundo, es que falla sobre todo en piezas que ya son malas por otro motivo. Arreglarla sola te cambiaría muy poco el rechazo. El segundo gráfico es el que debe decirte dónde poner el esfuerzo.

08ACUMULADO · la vista de trabajo

La pestaña en vivo muestra una ventana. Esta junta todo el rango seleccionado y es donde miras cuando quieres saber cómo ha ido el turno, no cómo ha salido la última pieza.

La **carta de control X̄–R**: medias de subgrupo a lo largo del tiempo, con los límites de control calculados a partir del propio proceso.

Los límites de control no son la tolerancia. Son lo que hace el proceso cuando lo dejas en paz. Un punto fuera, o una tirada de puntos del mismo lado, significa que algo ha cambiado — aunque todas las piezas sigan dentro de tolerancia. Esa es toda la gracia de una carta de control: te avisa antes de hacer rechazo, no después.

Todas las ventanas del rango, con sus cifras. Sirve para encontrar el momento en que las cosas cambiaron.

09REFERENCIAS · qué se ha verificado y cuándo

Una fila por día, con las horas del día a lo largo, y un bloque de color allí donde se estaba verificando una referencia. Responde a « ¿qué comprobamos el martes, y a qué hora cambiamos? » sin tener que abrir nada.

La línea temporal en vista Detalle. Cada color es una referencia; la posición de un bloque es la hora del día en que se hacía. La escala de horas aparece arriba y abajo.

A la derecha de la leyenda está el selector Vista. Detalle dibuja las tiradas de cada cámara por separado: cuando dos cámaras verifican el mismo lote a la vez, sus ficheros se alternan y sale un bloque por fichero, como en la figura de arriba. Agrupado lo junta en un solo bloque por referencia, con todas las cámaras y todos los lotes dentro. El bloque solo se corta cuando cambia la referencia o cuando pasan más de 30 minutos sin ningún fichero, de modo que las paradas largas se siguen viendo.

La misma pantalla en vista Agrupado: un bloque por referencia. Al pasar el ratón por encima salen los lotes y las cámaras que contiene.

La vista elegida se recuerda en este navegador y solo cambia el dibujo: el resumen de arriba, las cifras de cada día y la tabla de totales son los mismos en las dos vistas. Una tirada que pasa de medianoche se dibuja hasta las 24 en la fila del día en que empezó.

Haz clic en cualquier bloque y esa referencia y lote se cargan en el resto de pestañas. Es la forma más rápida de entrar en una tirada concreta: la buscas en la línea temporal, haces clic, y te vas al informe completo. En vista Agrupado, un bloque con un solo lote y una sola cámara los selecciona; si contiene más, se abre la referencia con todos los lotes y se mantiene la cámara que ya tenías elegida.

Totales por referencia dentro del rango: lotes, tiradas, piezas, tiempo ocupado y porcentaje fuera de tolerancia.

alcanceEsta pantalla trata de qué referencias se han verificado. No es, deliberadamente, una pantalla de control de máquina: los errores, las paradas y la disponibilidad están en RPD Vaktari Machine, que es el módulo que se ocupa de eso.

10INFORME COMPLETO · el documento

Todo sobre la selección actual, maquetado para imprimir y entregar — a un cliente, a una auditoría o a la carpeta del lote. La orden de imprimir del navegador lo convierte en PDF.

**Tablero de tolerancias**: cada cota sobre su propia tolerancia, dibujada a escala, para que de un vistazo veas cuáles están centradas y cuáles van rozando un límite.

**Distribuciones**: el histograma de cada cota con sus límites, el nominal y la curva ajustada.

**Conformidad de pieza**: cuántas cotas falla cada pieza. La primera barra son las piezas buenas.

El informe lleva además la tabla resumen por cota, las correlaciones entre cotas, las secciones de atributos y de medidas no encontradas, los dos Pareto y una conclusión escrita.

**Conclusiones**: el informe dice con palabras qué significan los números y qué hay que mirar primero.

11EXPORTAR

Las tres maneras en que los datos salen del programa.

Todas las medidas: Una fila por medida individual. Es la que hay que coger para llevarla a Excel o a otro paquete estadístico.
Sólo resultados: Una fila por cota, con n, media, σ, Cp, Cpk y los recuentos. Un resumen, no datos crudos.
Informe en PDF: Abre el diálogo de impresión del navegador sobre el informe completo. Elige « Guardar como PDF ».

Las exportaciones CSV usan el mismo separador y la misma marca decimal que los ficheros de entrada, de modo que se abren bien en un Excel español sin ningún paso de conversión.

12Varias cámaras en la misma carpeta

Si más de un sistema de visión escribe en la carpeta vigilada, sus ficheros llegan mezclados. El campo VIS del CSV dice de qué cámara viene cada medida, y el selector Cámara de la barra superior elige la que estás analizando.

no hay « todas las cámaras »y no debe haberla. Dos cámaras son dos sistemas de medida, cada uno con su calibración, su óptica y su sesgo. Juntar sus medidas de una misma cota da una media que no es de ninguna de las dos y una σ que es sobre todo la diferencia entre cámaras. La capacidad que sale no está un poco equivocada — no significa nada.

Números de pieza

Cada cámara numera sus piezas desde el 1 y reinicia cuando le toca. La pieza 7 de la cámara 1 y la pieza 7 de la cámara 2 no son la misma pieza, y el programa no lo da nunca por supuesto. Las piezas se emparejan por número sólo dentro de una misma ventana.

Las cámaras tampoco hacen siempre el mismo número de fotografías: van por tiempo, y si pasa algo una de ellas se salta un ciclo. Por eso un fichero puede tener más piezas que otro de los mismos minutos. Es normal y el programa lo espera.

Si a una pieza le falta una medida dentro de su propia ventana, queda fuera del recuento de conformidad en lugar de suponerla, y el informe dice a cuántas piezas ha afectado.

13Cómo leer los números

LSL, USL: Los límites de tolerancia. LSL = nominal + tol− y USL = nominal + tol⁺, sacados del propio CSV.
μ: La media de las medidas. Al lado, su distancia al nominal en micras.
σ: La desviación estándar — la dispersión de las medidas.
Cp: Cuánto vale la tolerancia comparada con la dispersión, si el proceso estuviera perfectamente centrado. Cp = (USL − LSL) / 6σ.
Cpk: Lo mismo, teniendo en cuenta lo descentrado que está realmente el proceso. Es el que hay que mirar. 1,33 es el objetivo habitual.
Pp, Ppk: Los mismos dos, calculados sobre todo el rango en lugar de dentro de los subgrupos. Dicen qué ha dado realmente el proceso, derivas entre ventanas incluidas.

σ y σw

Cp y Cpk se calculan sobre σw, la dispersión dentro del subgrupo: lo que puede hacer el proceso cuando nada se mueve. Pp y Ppk usan la σ global, que contiene además todas las derivas y todos los cambios de reglaje del rango.

Así, un Cpk bueno con un Ppk malo es un mensaje claro: la máquina es capaz, pero se mueve. Busca la deriva — desgaste de herramienta, efecto de temperatura, un operario que corrige entre lotes — en lugar de mirar la precisión de la máquina.

filas StatusLas filas con tipo Status son el veredicto de la propia máquina. Se dejan fuera de la estadística dimensional y se muestran aparte, de modo que la opinión de la máquina no contamina nunca las medidas. Para las cotas de atributo, el campo Status es el veredicto — ver la sección 05.

14Cuando salta una alarma

Los banners de arriba de la pestaña en vivo están ordenados por gravedad. Los umbrales se fijan en la línea de comandos y estos son los de serie:

Banner	Salta cuando	De serie
Fuera de tolerancia	Demasiadas piezas fuera de los límites en esta ventana	más del 10 %
Aviso	Menos, pero más de las que querrías	más del 2 %
Salto de media	La media se ha movido de una ventana a la siguiente	desactivado
Carta de control	Un punto fuera de los límites, o 2 de 3 más allá de 2σ	siempre activo
No encontradas	Demasiadas medidas −1	aviso más del 1 %, alarma más del 5 %
Estado de máquina	La propia máquina ha marcado medidas como NOK	cualquiera

Las dos sobre las que hay que actuar primero son el salto de media y la carta de control. Ambas pueden saltar con todas las piezas todavía dentro de tolerancia, que es exactamente cuando corregir sale barato. Cuando el banner de fuera de tolerancia está rojo, ya estás haciendo rechazo.

Para cambiar un umbral, edita el fichero de arranque. Por ejemplo, para avisar al 5 % y alarmar con un salto de media de 15 µm:

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

15Dónde viven los datos

Dentro de la carpeta del programa hay una carpeta hist. Esa es la base de datos. Los CSV de la carpeta vigilada sólo son la bandeja de entrada.

hist\dades-AAAA-MM-DD.json: Un fichero por día de producción, con todas las ventanas leídas ese día. Estos son los datos de verdad.
hist\fitxers.json: El registro de ficheros ya leídos, con su tamaño y fecha, para que un fichero no se cuente nunca dos veces.
hist\marques.json: Las intervenciones que marcas en los gráficos.

borrar los CSV es seguroUna vez leído un fichero, sus datos están en hist y el CSV ya no hace falta. Puedes archivar o borrar los ficheros de la carpeta vigilada sin perder ni una estadística. Moverlos a una subcarpeta es mejor que borrarlos, por si alguna vez necesitas los datos crudos.

borrar hist no lo esSi borras hist pierdes el histórico. El programa sólo reconstruiría lo que contengan los CSV que todavía pueda ver — de modo que si esos también se han archivado, esos datos se han perdido. Haz copia de hist junto con el resto del PC.

La carpeta de histórico se puede mover a otro sitio con --state, lo cual es útil si prefieres tenerla en una unidad de red que se respalda.

16Los ficheros

vaktari_measure.py: El servidor. Lee los CSV, mantiene el histórico y sirve el panel.
vaktari_measure.html: El panel.
vaktari_measure_i18n.js: Las traducciones, seis idiomas.
vaktari_measure_theme.css: Todos los colores y todas las tipografías. Los dos temas viven aquí, y se añade uno nuevo copiando un bloque.
vaktari_measure.ico, .svg: La marca.
start_vaktari_measure.bat: Arranque con ventana visible.
START_vaktari_measure_silent.bat: Arranque sin salida en pantalla.
START_vaktari_measure_silent.vbs: Arranque sin ninguna ventana. Es la habitual.
STOP_vaktari_measure.bat: Para el programa.
hist\: El histórico — ver la sección 15.
log_vaktari.log: Lo que ha escrito el programa, cuando se ha arrancado sin ventana.

versiónEl número de versión está abajo a la derecha de todas las pantallas y en la portada de este manual. Es la fecha de publicación más una letra. Indícalo si reportas un problema.

17Problemas frecuentes

El navegador dice que no puede conectar

El programa no está en marcha. Arráncalo con el .bat visible y lee lo que escribe, o abre log_vaktari.log. Las causas habituales son que Python no está instalado o que el puerto ya está ocupado.

Dice que el puerto está ocupado

Ya hay otra copia en marcha — abre el panel, seguramente está ahí. Si no, ejecuta STOP_vaktari_measure.bat y vuelve a arrancar, o cambia PORT en el fichero de arranque.

No aparece nada, o dice « sin datos »

Comprueba que CARPETA apunte a la carpeta correcta y que realmente haya CSV dentro. La barra superior muestra la carpeta vigilada y la hora del último escaneo. Mira también el rango: puede que la selección sea de hoy y los datos sean de ayer — un banner te avisa cuando hay datos fuera del rango, con un botón para ir allí.

Falta una cámara en el selector

El campo VIS falta o está vacío en los ficheros de esa cámara. La barra superior muestra las variables que ha encontrado. Si el campo no se escribe, hay que corregirlo en la configuración de salida del programa de medida.

Las cifras salen raras después de un cambio

Mira el selector de lote. Con * estás mirando varios lotes a la vez, y un cambio de reglaje en medio ensancha la σ y hunde el Cpk. Elige un solo lote y compara.

Una cota no muestra media ni Cpk

Es un atributo: una comprobación de pasa/no pasa sin nominal, de modo que no hay nada que promediar. Ver la sección 05.

Tarda en arrancar

Sólo la primera vez en una carpeta con mucho histórico. El panel se puede usar mientras el escaneo avanza. Si tarda siempre, seguramente la carpeta vigilada contiene años de ficheros — archiva los antiguos en una subcarpeta; el histórico conserva sus datos.