HERRAMIENTAS GEOESTADÍSTICAS — PROYECTO SS-XAVIER
Goldberg Resources Ltda.
Versión 3 (septiembre 2026) — alineada con el paper v25: Varimax con
normalización de Kaiser en las configuraciones del paper y congruencia de
Tucker tras rotación Procrustes en la comparación log10 vs CLR.
Versión 2 — agregó CLR, comparación log10 vs CLR, configuraciones del paper,
base de 51 elementos y especiación normativa de Cu.
==================================================

CONTENIDO DE LA CARPETA
  index.html                      Página de inicio (enlaza a las tres herramientas)
  variograma.html                 Calculadora de variograma down-hole
  pca.html                        PCA geoquímico (log10 o CLR) con rotación Varimax
  normativo.html                  Especiación normativa de Cu a partir de S/Cu  [NUEVO v2]
  datos/sperling2009_51elementos.csv
                                  ICP 51 elementos ALS ME-MS41, campaña Sperling 2009
                                  (14 sondajes ARSP, 1.622 intervalos) + columnas de
                                  logueo lito_log, alt_log, zmin_log  [NUEVO v2]
  datos/sperling2009_assay.csv    Ensayes Cu/Fe, campaña Sperling 2009 (se mantiene)

No requiere base de datos, PHP ni instalación: son archivos estáticos.


1) SUBIR AL HOSTING (cPanel)
  a. cPanel > Administrador de archivos (File Manager) > public_html
  b. Crear una carpeta, por ejemplo:  herramientas
  c. Entrar a esa carpeta > Cargar (Upload) > subir el ZIP
  d. Clic derecho sobre el ZIP > Extraer (Extract)
  e. Verificar que index.html, variograma.html, pca.html y la carpeta datos
     queden directamente dentro de "herramientas" (si quedan dentro de una
     subcarpeta "ssxavier-herramientas", mover su contenido un nivel arriba
     o usar esa subcarpeta como dirección).
  f. Borrar el ZIP del servidor.

  Dirección resultante (ejemplo):  https://www.goldbergresources.com/herramientas/


2) PONER CLAVE (cPanel > Privacidad de directorios / Directory Privacy)
  a. cPanel > Archivos > "Privacidad de directorios" (Directory Privacy)
  b. Navegar hasta public_html/herramientas y seleccionarla
  c. Marcar "Proteger este directorio con contraseña"
     y escribir un nombre (ej: Herramientas SS-Xavier) > Guardar
  d. En la misma pantalla, "Crear usuario": definir usuario y contraseña > Guardar
  e. Probar en una ventana privada del navegador: debe pedir usuario y clave.

  IMPORTANTE: proteger la carpeta completa ("herramientas"), no solo index.html,
  para que los archivos de datos (carpeta datos/) también queden
  protegido. Las páginas además llevan la etiqueta "noindex" para que los
  buscadores no las indexen.


3) NOTAS DE USO
  - Usar el sitio con https:// (el botón "Copiar tabla" lo requiere).
  - Las tipografías se cargan desde Google Fonts; sin internet se usan
    fuentes del sistema y todo sigue funcionando.
  - Los CSV propios pueden venir con separador coma, punto y coma o tabulación,
    y con coma decimal (formato Excel en español). Primera fila = encabezados.
  - Valores bajo el límite de detección: se reconocen escritos como "<0,2"
    (o "<0.2"). No se eliminan: por defecto se imputan por ROS (regresión
    sobre estadísticos de orden en escala log, Helsel 2005), elemento por
    elemento y con varios límites de detección si los hay. Alternativas:
    LD/2, LD/√2 o excluir (no recomendado). Los valores ">x" se usan en el
    límite (en el PCA se puede optar por excluir las muestras con algún
    ">x"). En el PCA, los elementos con más de 70% de valores <LD se
    excluyen (umbral ajustable) y la pestaña "Límite de detección" muestra
    el detalle por elemento.
  - Los códigos -99 / -999 / -99.9 se tratan como "sin muestra" (faltante),
    no como bajo el límite de detección.
  - Los CSV que exportan las herramientas usan coma como separador y punto
    decimal (así se pueden subir de una herramienta a la otra). Para abrirlos
    en Excel en español: Datos > Desde texto/CSV > Delimitador: coma.
  - Flujo para variografía de factores: PCA > descargar puntajes factoriales
    (con sondaje y desde/hasta mapeados) > subir ese CSV en Variograma >
    elegir el factor (F1, F2...) como "Variable a analizar".
  - Todo el cálculo ocurre en el navegador del usuario; ningún dato subido
    se envía ni se guarda en el servidor.


4) NOVEDADES DE LAS VERSIONES 2 Y 3
  PCA (pca.html)
  - Transformación a elegir: CLR (log-cociente centrado, Aitchison 1986),
    log10 o ninguna. CLR: clr(x)i = ln(xi / g(x)), g(x) = media geométrica
    de la muestra sobre los elementos usados. Las columnas _pct o % se pasan
    a ppm (x10^4) y _ppb a ppm (x10^-3) antes de la CLR (la CLR exige
    unidades comunes; log10 + correlación no se ve afectado por la unidad).
  - Campo "Excluir sólo en CLR": para dejar fuera de la composición
    elementos de digestión residual en agua regia (ej. Hf, Nb, Zr).
  - Matriz de covarianza o de correlación. Las cargas siempre se expresan
    como correlación variable-factor, de modo que son comparables entre
    ambas matrices. La varianza explicada es la fracción de la traza.
  - Kaiser automático generalizado: autovalor > autovalor medio (con la
    matriz de correlación equivale a autovalor > 1).
  - Varimax con o sin normalización de Kaiser. Las configuraciones del
    paper usan normalización de Kaiser (variante estándar), que reproduce
    los seis factores de López (2026).
  - Signo de cada factor: la carga de mayor valor absoluto queda positiva.
  - Puntajes factoriales estandarizados (media 0, varianza 1) y rotados.
    En la v1 los puntajes no rotados no se dividían por la raíz del
    autovalor; la escala cambia, no la forma de los perfiles.
  - Botones "PCA-CLR (paper)" y "Réplica log10 (tesis)": cargan la base de
    51 elementos y fijan LD/2, exclusión >50% <LD (Au, Re, Ta, Tl),
    6 factores, Varimax con normalización de Kaiser; CLR con covarianza y sin
    Hf-Nb-Zr (44 elementos), log10 con correlación (47 elementos).
    Al abrir la página se aplica automáticamente "PCA-CLR (paper)".
  - Pestaña "log10 vs CLR": calcula log10-correlación, CLR-covarianza y
    CLR-correlación con el mismo tratamiento y N° de factores. Medida
    principal: phi de Tucker tras rotar la solución CLR hacia la log10 por
    Procrustes ortogonal (Schönemann 1966), independiente de la rotación.
    Como referencia muestra el emparejamiento directo de factores Varimax.
    Umbrales de Lorenzo-Seva y ten Berge (2006): >= 0,95 equivalentes;
    0,85-0,94 aceptable; < 0,85 no equivalentes. Descarga en CSV.

  Verificación con la base de 51 elementos (reproduce la Tabla 1 del
  paper v25; CLR-cov / CLR-corr):
    F1 matriz 0,94/0,94 · F2 calcófilo Co-Te-Mo-Bi-Fe 0,75/0,76 ·
    F3 Sr-Sb-As-Hg 0,90/0,91 · F4 REE 0,92/0,95 · F5 K-Rb-Cs vs V-P
    0,98/0,99 · F6 Sn-Nb-Cd 0,88/0,88. Varianza: CLR-cov 63,6 %,
    log10 62,6 % (6 factores, 1.619 muestras).
    (La herramienta puede mostrar F4 y F5 en orden inverso.)

  Especiación normativa (normativo.html)  [NUEVO]
  - S disponible = S - S(esfalerita) - S(galena) - S(molibdenita).
  - Clases por razón másica S/Cu: < 0,252 Cu no sulfurado; 0,252-0,404
    cc/cv-bn; 0,404-1,009 bn+cpy; 1,009-2,0 cpy ± py; >= 2,0 py dominante.
  - Resultados: % de Cu no sulfurado (en masa), clases, tramos de
    profundidad, tabla contra la zona mineral logueada, resumen por sondaje
    y CSV por muestra con cpy y py normativas.
  - Verificación (Cu >= 500 ppm): 264 intervalos; 39,5% del Cu no
    sulfurado; 118 (45%) logueados estériles; fracción de intervalos no
    sulfurados por tramo 73/57/38/15/10/0%.
  - Es un balance de masa: indica compatibilidad, no presencia. Verificar
    con Cu soluble secuencial y mineralogía.

  Variograma (variograma.html)
  - Nuevo botón "Sperling 51 elem." para variografiar cualquiera de los
    51 elementos. Eje Y en notación compacta para varianzas grandes.
