Segmentación con IA

Meratyn ofrece tres flujos de segmentación con requisitos de ejecución distintos:

• Procesamiento → Segmentación con IA envía una indicación de texto o una segmentación automática a un servicio samgeo-api configurado.
• Procesamiento → Segmentar todo ejecuta SlimSAM localmente en un worker del navegador.
• Plugins → SamGeo se conecta a un servicio samgeo-api configurado para indicaciones de texto, puntos, caja y segmentación automática.

Procesamiento → Segmentación con IA

Segmentación con IA acepta imágenes .tif, .tiff, .png, .jpg y .jpeg, y admite el modo de texto o automático. Envía la solicitud mediante el proxy del sidecar de Meratyn a samgeo-api, reproyecta los polígonos devueltos a WGS84, los añade como una capa GeoJSON y acerca el mapa al resultado. El servicio usa SAM 3 de forma predeterminada y puede exponer otros modelos mediante su catálogo.

Cerrar el panel cancela la solicitud activa. Este flujo requiere un servicio de segmentación accesible; use Segmentar todo cuando la inferencia deba permanecer local.

Procesamiento → Segmentar todo

Segmentar todo identifica objetos distintos en un GeoTIFF y añade sus contornos como una capa GeoJSON. La inferencia usa ONNX Runtime Web y un codificador y decodificador SlimSAM; la imagen y la ejecución del modelo permanecen en el proceso del navegador. No requiere el sidecar de Python.

La primera ejecución descarga los archivos del modelo desde el host configurado. Las siguientes reutilizan los bytes almacenados en caché. Un despliegue que bloquee descargas externas debe alojar esos archivos o desactivar esta capacidad.

Uso de Segmentar todo

1. Abra Procesamiento → Segmentar todo.
2. Elija una imagen .tif o .tiff.
3. Ajuste la cuadrícula de muestreo, el umbral de calidad y el área mínima de máscara cuando sea necesario.
4. Seleccione Segmentar todo. Meratyn muestra el progreso de descarga e inferencia, añade los polígonos resultantes como capa y acerca el mapa.

Cerrar el panel cancela la inferencia activa. No se encontraron objetos es un resultado normal; reduzca el umbral de calidad o el tamaño mínimo, o aumente la cuadrícula para buscar con mayor densidad.

Plugins → SamGeo

Active Plugins → SamGeo para la segmentación interactiva respaldada por un servicio. El panel acepta una capa ráster cargada o una imagen subida y ofrece cuatro modos:

• Indicación de texto — envía lenguaje natural mediante SAM 3.
• Puntos de primer plano/fondo — coloca puntos positivos y negativos en el mapa y refina la máscara con SAM 3.
• Caja delimitadora — dibuja una caja y segmenta su contenido con SAM 3.
• Automático (todo) — ejecuta el generador automático de máscaras de SAM 2. Este modo expone el modelo SAM 2, puntos por lado, IoU prevista y controles de estabilidad.

El panel también expone el ID del modelo SAM 3, el backend, el umbral de confianza y los tamaños mínimo y máximo de máscara. Los resultados se reproyectan a WGS84 y se añaden como una capa GeoJSON nueva. Cerrar el panel o cancelar la ejecución interrumpe la solicitud que le pertenece.

SamGeo es una integración solo de compilación. Meratyn no incluye los pesos de los modelos ni concede o representa una licencia de modelo. El operador aporta los pesos, acepta las condiciones que les correspondan y configura el entorno en el host del servicio. El navegador solo guarda la configuración no secreta del servicio; los pesos y cachés del backend quedan en el límite de almacenamiento del servicio y nunca se serializan en un archivo de proyecto. El panel indica cuando los pesos no están incluidos o configurados, para que la falta de entorno sea explícita. Se requieren MAPPVIEW_ML_SAMGEO_WEIGHTS_CONFIGURED=1 y MAPPVIEW_ML_SAMGEO_LICENSE_ACCEPTED=1 antes de informar que el servicio está listo o ejecutar una inferencia.

Configuración del servicio SamGeo

Instale por separado el proxy ligero del sidecar y el runtime de modelos fijado. El sidecar base admite Python 3.10 o posterior y su extra [ml] solo contiene el cliente HTTP. El extra [samgeo-runtime], gestionado por el operador, vive en un entorno separado, requiere Python 3.12 o posterior y fija segment-geospatial[api,samgeo3]==1.4.2:

pip install -e ".[ml]"
pip install -e ".[samgeo-runtime]"
samgeo-api --port 8000

Ejecute samgeo-api desde el entorno que contiene [samgeo-runtime], con una compilación compatible de PyTorch. El paquete de runtime y los pesos permanecen fuera de los paquetes de escritorio o navegador.

Configure Meratyn para usar ese servicio antes de iniciarlo:

MAPPVIEW_ML_SAMGEO_URL=http://127.0.0.1:8000 mappview

Defina las señales de política en el entorno del sidecar después de aportar los pesos y aceptar sus condiciones:

MAPPVIEW_ML_SAMGEO_WEIGHTS_CONFIGURED=1
MAPPVIEW_ML_SAMGEO_LICENSE_ACCEPTED=1

El paquete de escritorio no incluye la pila de modelos. Los despliegues web también deben exponer un servicio accesible mediante el proxy del sidecar.

La suite de navegador de producción verifica la activación del panel, la cancelación, la limpieza y el ciclo de vida de la capa resultante. Los equipos de despliegue deben validar por separado sus pesos de modelo, el entorno GPU o CPU y el endpoint del servicio.

Véase también Herramientas de procesamiento.