Resumen
PetroPyQAPF es una aplicación de escritorio en Python para apoyar la clasificación reproducible de rocas ígneas y la generación de reportes técnicos. Su arquitectura separa la decisión modal formal del contraste geoquímico, el apoyo probabilístico, la síntesis interpretativa, el atlas mineral, la revisión petrográfica por imagen y la presentación del reporte.
La regla central sigue siendo explícita: la clasificación formal es modal y petrográfica cuando esa evidencia aplica. CIPW, ML, el Modelo de Interpretación Normalizada (NIM), el Motor de Conocimiento Geológico-Petrológico (GPKE), interpretación asistida e imagen funcionan como contexto, contraste o apoyo de revisión; no reemplazan automáticamente el criterio petrográfico.
Capacidades actuales
- Clasificación modal IUGS-QAPF para dominios plutónico y volcánico
- Rutas especializadas para variantes gabroicas, ultramáficas, plutónicas y volcánicas
- Validación de componentes modales, auxiliares petrográficos y óxidos mayores
- Proyección normativa CIPW mediante GeoNormPy
- Comparación modal contra CIPW con distancia, consistencia y advertencias
- Modelos ML oficiales por dominio: XGBoost para VOL (rocas volcánicas) y RandomForest para PLU (rocas plutónicas)
- Síntesis del Modelo de Interpretación Normalizada (NIM) para soporte, incertidumbre, factores de evidencia y recomendaciones
- Capas GPKE e hipótesis como parte del razonamiento extendido
- Interpretación asistida por IA configurada por el usuario mediante Ollama local, API de OpenAI o API de Anthropic
- Atlas mineral bilingüe de minerales formadores de rocas
- Visor petrográfico experimental para fotomicrografías PPL y XPL
- Salidas JSON, texto, reportes desde plantilla DOCX y PDF
- Autorización opcional de escritorio con Google/Firebase
- Interfaz en español o inglés con configuración persistente
Workspace de proyecto
PetroPyQAPF ya soporta trabajo con proyectos de varias muestras, no solo corridas aisladas. El workspace incluye importación por lote desde CSV o Excel, selector compacto de muestras, autoguardado de sesión, recuperación tras cierre inesperado, indicador de cambios sin guardar y formato propio GisGeo con extensión .gisgeo.
Los paquetes de proyecto pueden exportarse en ZIP con resúmenes, reportes, imágenes asociadas y capturas del visor cuando están disponibles.
Visor petrográfico
El visor petrográfico permite cargar imágenes PPL y XPL, elegir el tipo de vista al importar, comparar ambas vistas con divisor móvil vertical u horizontal, hacer zoom, paneo, ajuste de posición, calibración por diámetro trazado, mediciones, anotaciones y capturas listas para reporte.
Esta capa está pensada para documentación y revisión visual. Sigue siendo experimental y no reemplaza la clasificación modal.
Atlas mineral
El atlas integrado cubre minerales formadores de rocas mediante una base de conocimiento local bilingüe. Permite búsqueda por nombre y fórmula, fichas con descripción, propiedades, notas y referencias visuales, y muestra el contenido según el idioma activo de la aplicación.
Release académico
PetroPyQAPF se publica como release académico para estudiantes, docentes e investigadores sin fines de lucro que necesitan una herramienta reproducible de apoyo para enseñanza, revisión y documentación en petrología ígnea.
Licenciamiento y acceso
El acceso académico gratuito está dirigido a estudiantes, docencia e investigación académica o independiente estrictamente sin fines de lucro.
Los usos empresariales, profesionales, institucionales, gubernamentales, de consultoría, integración privada, procesamiento comercial o fines lucrativos requieren autorización escrita previa mediante jordanzav@gisgeo.dev.
La descarga oficial se realiza únicamente desde este sitio. La redistribución, reempaquetado, alojamiento externo, ingeniería inversa, descompilación o modificación del ejecutable y sus sistemas de autenticación no están autorizados sin consentimiento escrito.
Privacidad y tratamiento de datos
PetroPyQAPF funciona como aplicación local de escritorio. Los datos científicos, imágenes petrográficas, reportes y resultados permanecen bajo responsabilidad y control local del usuario.
El software no realiza recolección, almacenamiento o transmisión intrusiva de datos analíticos hacia servidores externos, salvo que el usuario configure explícitamente un backend propio o un servicio externo.
La autenticación con Google/Firebase se usa únicamente para verificar si el correo está autorizado; no transmite muestras, composiciones químicas, imágenes petrográficas ni reportes generados.
La interpretación asistida por IA es opcional y depende de servicios configurados por el usuario, incluyendo Ollama local o credenciales propias de API para OpenAI o Anthropic. El usuario conserva la responsabilidad de decidir qué información envía a cualquier proveedor externo de IA.
Estado actual
Al 6 de junio de 2026, el sistema integra el flujo central de clasificación, workspace de proyecto, atlas mineral, visor petrográfico, interfaz bilingüe, exportación de reportes y soporte de empaquetado.
La siguiente etapa de maduración se centra en QA manual de GUI, login, cambio de idioma, flujo manual y por archivo, exportación PDF, empaquetado Nuitka completo en una computadora limpia y validación científica externa con muestras curadas y comparación experta.
Límites actuales
- La inferencia por imagen y el soporte petrográfico por imagen siguen siendo experimentales
- El visor documenta observación visual, pero no reemplaza la clasificación modal
- CIPW, ML, el Modelo de Interpretación Normalizada (NIM), GPKE e interpretación asistida son capas de apoyo y contraste, no sustitutos del criterio petrográfico
- La validación científica externa completa sigue pendiente