﻿KENTI ICTIOLÓGICO · versión de prueba 0.2
=========================================

Nuevo en la 0.2: esfuerzo de muestreo y CPUE calculada (pestaña 1),
tallas, peso y condición (pestaña 5) y rasgos por especie e IBI (pestaña 6).
Si venías de la 0.1, reemplaza el .exe: tu tabla se conserva.

Cómo abrirlo
------------
1. Descomprime este archivo .zip en cualquier carpeta (por ejemplo, el Escritorio).
   No lo abras desde dentro del .zip.
2. Haz doble clic en "Kenti Ictiologico.exe".
   Se abre una ventana propia con el programa. No hace falta instalar nada
   ni tener conexión a internet.

La primera vez, Windows puede mostrar el aviso "Windows protegió su PC".
Aparece porque el programa todavía no tiene firma digital. Haz clic en
"Más información" y después en "Ejecutar de todas formas".

Requisitos: Windows 10 u 11 con Microsoft Edge (viene con Windows) o Google Chrome.

Si ya tenías la versión anterior, puedes reemplazar el .exe: tus datos se
conservan porque están en la carpeta Documentos, no junto al programa.

Dónde quedan tus datos
----------------------
Cada cambio se guarda solo, en:

    Documentos\Kenti Ictiologico\datos-ictiologia.json

En esa carpeta también hay:
  - datos-ictiologia.respaldo.json : la versión anterior, por si algo sale mal.
  - kenti.log : un registro técnico, útil si hay que revisar un error.
  - Exportaciones\ : los libros de Excel que generes.

El botón "Abrir carpeta de datos", al pie de la tabla, abre esa carpeta.

Cómo cargar tus datos
---------------------
La tabla de la primera pestaña funciona como una planilla de Excel: todas las
celdas se pueden escribir, borrar y corregir. El programa arranca vacío, sin
datos de ejemplo, así que todo lo que ves en índices y gráficos sale de tu
tabla.

- Primera fila: los sitios. Sirve el código (P1) o el nombre (Vega Norte).
- Primera columna: las especies.
- Celda A1 (arriba a la izquierda): puede tener cualquier cosa o quedar
  vacía. No hace falta escribir "Especie".

Cargar un archivo de Excel
1. "Cargar tabla de Excel" → "Elegir archivo…" y elige tu planilla (.xlsx)
   o un .csv.
2. Si el libro tiene varias hojas, elige la hoja en "Hoja".
3. La tabla leída aparece en el cuadro para revisarla. "Cargar tabla" la pone
   en Kenti y reemplaza la actual.
   Los archivos .xls antiguos no se pueden leer: en Excel usa "Guardar como"
   → "Libro de Excel (.xlsx)".

Pegar tu tabla de Excel
1. En Excel, selecciona la tabla entera, desde la celda con los nombres de
   sitio y especie, y cópiala (Ctrl+C).
2. En Kenti, haz clic en la celda A1 de la tabla y pega (Ctrl+V).
   Pegar en A1 reemplaza la tabla entera. También puedes pegarla en el cuadro
   de "Cargar tabla de Excel".
3. Pegar un bloque en cualquier otra celda escribe sólo esas celdas, como en
   Excel.

   Ejemplo de lo que se copia:
                          P1      P2      P3
     Trichomycterus sp.    12       3       0
     Orestias agassii       0      28      41

- Filas o columnas de Total, Familia u Orden se ignoran al pegar en A1.
- Una celda vacía, "-" o "s/d" cuenta como 0; "x" o "presente", como 1.
- Si algo no se pudo leer, el aviso de abajo lo dice y ofrece "Deshacer".

Editar
- Para agregar un sitio o una especie, escribe en la columna "+ sitio" o en
  la fila "+ especie", al final de la tabla.
- Para quitar una fila o una columna, pasa el mouse sobre el nombre y haz clic
  en la ×. También tiene "Deshacer".
- Enter o las flechas mueven entre celdas.
- "Vaciar tabla" borra todo, con "Deshacer".

Todos los sitios de la tabla entran en los análisis. Si un sitio no se
relevó, no lo incluyas.

Medida
- Con "Medida" indicas si los números son individuos capturados, CPUE
  (captura por unidad de esfuerzo) o biomasa en gramos. Cambia cómo se nombran
  los resultados, no los cálculos. Usa una sola medida por tabla.
- Con CPUE, anota en el informe cuál es la unidad de esfuerzo (horas de red,
  metros de arrastre, minutos de pesca eléctrica). Con biomasa, Shannon y
  Simpson miden cómo se reparte la biomasa entre especies, no los individuos.
- Con "Arte de muestreo" indicas cómo se pescó: red de espera, red de
  arrastre, pesca eléctrica, atarraya, trampa u observación directa. Queda
  anotado en el Excel; no cambia los cálculos. Si un sitio se muestreó con
  otra arte, conviene aclararlo en el informe: la captura no es comparable
  entre artes distintas.

Índices
- Riqueza (S), abundancia, CPUE o biomasa total (N), Shannon (H′), Simpson
  (1 − D y su dominancia D), equitatividad de Pielou (J′) y Margalef.
- Diversidad beta: Jaccard, Morisita-Horn y Bray-Curtis, con mapas de calor y
  cluster UPGMA.
- Con pocas especies, que es lo habitual en ríos y lagunas de altura, los
  índices de diversidad se mueven mucho con un solo registro: mira también la
  riqueza y la abundancia por separado.

Esfuerzo de muestreo y CPUE (opcional, pestaña 1)
- Debajo de la tabla hay una tarjeta "Esfuerzo de muestreo por sitio".
  Escribe la unidad (horas-red, m² de red, minutos de pesca eléctrica…) y
  un valor por sitio; también puedes pegar una columna de valores o dos
  columnas Sitio / Esfuerzo. Kenti calcula la CPUE (N ÷ esfuerzo) por sitio y
  por especie, y la deja como variable en Correlación y PCA y en el Excel.
- Dividir por el esfuerzo no cambia Shannon, Simpson ni Pielou (son
  proporciones dentro de cada sitio): cambia la comparación de abundancias
  entre sitios. Si elegiste la medida "CPUE" porque ya traes la división
  hecha, la tarjeta se oculta.

Tallas, peso y condición (pestaña 5)
- Una fila por pez: Sitio, Especie, Longitud, Peso (g), Sexo y Anomalías.
  Pega la planilla desde Excel en la celda A1 (las columnas se reconocen por
  el encabezado, en cualquier orden) o usa "Cargar de Excel". Elige si la
  longitud está en mm o cm y si es total, estándar o furcal.
- Con eso calcula, por especie: la relación longitud–peso (W = a·L^b, con
  intervalo de confianza de b y prueba de b = 3), el factor de condición de
  Fulton (K) y la condición relativa de Le Cren (Kn) por sitio, los
  histogramas de tallas por sitio (con talla de madurez si la cargas), el
  porcentaje de peces con anomalías (DELT) y la proporción de sexos.
- Hacen falta 5 peces con longitud y peso para ajustar la relación. Lo que
  falte (por ejemplo el peso) sólo deja sin calcular lo que lo necesita.
- "Armar la tabla de la pestaña 1 con estos individuos" cuenta los peces por
  especie y sitio (o suma los pesos, si la medida es biomasa) y reemplaza la
  tabla de la pestaña 1 con ese conteo: no hace falta cargar los datos dos
  veces.

Rasgos por especie e IBI (pestaña 6)
- Para cada especie de la tabla elige origen (nativa / exótica), tolerancia,
  gremio trófico y hábitat. Cada rasgo habilita sus métricas; una especie sin
  rasgo queda fuera de esa métrica y se informa, pero no bloquea nada.
- El IBI (Karr, 1981) suma el puntaje (5, 3 o 1) de las métricas que elijas.
  No hay una versión calibrada para el NOA: los límites de cada métrica los
  pones tú para tu cuenca. "Proponer límites" da un punto de partida
  (trisección del máximo observado y los cortes de Karr) que debes revisar.
- Como el número de métricas lo eliges tú, el IBI se expresa también como
  porcentaje del máximo y la clase sale de ahí (cortes editables).
- Todo lo usado (métricas, límites, rasgos, clases y citas) queda escrito en
  la hoja 7 del Excel, para copiar al informe.

Variables fisicoquímicas (opcionales)
- En la pestaña "Diversidad alfa", debajo de los índices, hay una tabla con
  pH, Temperatura (°C), Conductividad, OD y TDS: una fila por sitio (los
  sitios de la tabla de la pestaña 1). No es obligatorio completarla, ni
  completar todas las variables.
- Para Conductividad, OD y TDS elige la unidad en el encabezado
  (µS/cm o mS/cm; mg/L o % de saturación; mg/L o g/L).
- Se escriben a mano, se pegan o se cargan con "Cargar desde Excel". Para
  pegar una tabla, haz clic en la celda de arriba a la izquierda y pega: la
  primera columna son los sitios, escritos igual que en la tabla de peces, y
  la primera fila, las variables, en cualquier orden.
- Un valor como "<0,01" (bajo el límite de detección) se guarda tal cual,
  pero no entra en las correlaciones.

Correlaciones con los fisicoquímicos
- En la pestaña "Correlación y PCA" aparece una tabla con la r de Pearson
  entre cada variable fisicoquímica y la comunidad (riqueza, N, Shannon,
  Simpson, Pielou y Margalef). En negrita y con *, las que dan p < 0,05.
  Haz clic en una celda para ver su gráfico de dispersión, con recta, banda
  de confianza y r de Pearson.
- Una variable entra si tiene valor en al menos 3 sitios.
- Las variables fisicoquímicas cargadas también se pueden sumar al PCA.
- En el Excel (hoja 5) van la tabla de r, la de p, la de n y el gráfico
  elegido; los fisicoquímicos cargados van en la hoja 2.

Guardar los resultados en Excel
-------------------------------
El botón "Exportar a Excel", arriba a la derecha de las pestañas, arma un
libro con siete hojas:
  1. Tabla de datos
  2. Índices alfa
  3. Gráficos alfa
  4. Diversidad beta: matrices de similitud, mapas de calor y dendrogramas
  5. Correlación y PCA: gráficos y tablas del análisis
  6. Peces · CPUE y tallas: esfuerzo y CPUE, relación longitud–peso,
     condición, tallas y anomalías, con sus figuras
  7. IBI: métricas, puntajes, límites usados, clases y rasgos
Los gráficos van como imágenes, listas para copiar al informe. Los números
van en celdas. Cada exportación se guarda como un archivo nuevo en la carpeta
Exportaciones; al terminar puedes abrirlo directamente.

Qué probar
----------
1. Tabla de datos: carga, corrección y pegado desde Excel.
2. Diversidad alfa: riqueza, abundancia, Shannon, Simpson, dominancia,
   Margalef y Pielou, con sus gráficos.
3. Diversidad beta: Jaccard, Morisita-Horn y Bray-Curtis, y el cluster UPGMA.
4. Correlación y PCA: dispersión de los sitios (riqueza y diversidad,
   abundancia y diversidad) con recta de regresión, banda de confianza y
   r de Pearson; PCA con las variables que elijas.
5. Esfuerzo y CPUE: pegar una columna de esfuerzo y mirar la CPUE.
6. Tallas y condición: pegar una planilla de individuos, mirar la relación
   longitud–peso, la condición por sitio y los histogramas.
7. IBI: cargar los rasgos, proponer límites, ajustarlos y mirar las clases.
8. Exportar a Excel y abrir el libro (siete hojas).

Para enviar comentarios
-----------------------
Anota qué hiciste, qué esperabas y qué pasó. Si hay un error, adjunta
datos-ictiologia.json y kenti.log de la carpeta de datos.

Para cerrar el programa, cierra su ventana.
