Enviar un trabajo ODM

Un MappingJob es la unidad de trabajo para la fotogrametría de ARGUS. Un trabajo = un conjunto de imágenes → una ejecución de procesamiento → un bundle de artefactos. Los trabajos están acotados a un operationId y fluyen por las etapas del worker de ODM en el backend.

Crear un trabajo

Desde la funcionalidad Mapping de la organización (/es/mapping/) o el tile de mapping de la operación:

Haz clic en New mapping job.
Establece el nombre (obligatorio).
Elige Outputs (MappingOutputType, selección múltiple):
- orthomosaic — ortho 2D (GeoTIFF / COG).
- 3d_model — malla 3D texturizada (OBJ + glTF).
- point_cloud — LAS / LAZ.
- dem / dsm — elevación / superficie.
- ndvi — índice de vegetación (requiere banda NIR).
- thermal_map — mosaico térmico.
Elige Quality (MappingQuality):
- preview — validación de baja resolución rápida.
- low — rápido, detalle reducido.
- medium — por defecto.
- high — alto detalle, tiempo de ejecución más largo.
- ultra — máximo detalle.
Opcionalmente establece CRS — presets EPSG:4326 (WGS 84), EPSG:3857 (Web Mercator), EPSG:3395 (World Mercator), o déjalo en blanco para que ODM lo auto-detecte.
Haz clic en Create job. El estado se vuelve pending.

El tile también ofrece Clone job en cualquier trabajo existente para pre-rellenar el formulario con las mismas salidas / calidad / CRS — útil para re-ejecutar después de ajustes.

Subir imágenes origen

Con el trabajo seleccionado, arrastra fotos al drop zone o usa el selector de archivos. Aceptado: JPG / JPEG / PNG / TIF / TIFF / DNG.

Comportamiento de subida:

Los archivos suben uno a uno con progreso a nivel de byte por archivo.
La barra global es una mezcla suavizada: los archivos completados contribuyen 1 cada uno, el archivo en vuelo contribuye su fracción a nivel de byte (evita el efecto escalera en imágenes grandes).
El estado se mantiene en uploading hasta que cada archivo aterriza. Un fallo aparece en MappingJob.error; arregla y vuelve a subir.

Cuando las imágenes están en su sitio, haz clic en Start processing. El estado cambia a queued.

Auto-creación desde una misión de mapping

Una DroneMission con pattern: 'mapping' y autoProcessOnCompletion: true (por defecto) genera un trabajo en el backend tan pronto como la misión alcanza dji_completed. Los medios capturados de la misión se cablean como la fuente del trabajo — sin paso manual de subida. Desactiva el flag en el planificador si quieres curar el conjunto de imágenes primero.

Etapas de procesamiento

El worker recorre el pipeline de ODM. MappingJob.steps[] transmite los timestamps y el progreso por etapa:

Etapa	Qué está pasando
`queued`	Esperando un slot de worker ODM.
`initialising`	Descargando imágenes de S3 al worker.
`matching`	Emparejamiento SIFT / de features entre fotos solapadas.
`sfm`	Structure-from-motion — poses de cámara + nube dispersa.
`dense`	Reconstrucción de nube de puntos densa.
`meshing`	Malla a partir de la nube densa.
`texturing`	Horneado de textura sobre la malla.
`tiling`	Generación de 3D Tiles / COG para vista previa en la app.
`completed`	Salidas listas; `artifacts[]` rellenado.
`failed`	Terminal; `error` lleva el extracto del último log.
`cancelled`	Cancelado por el usuario; salidas parciales descartadas.

El progress global (0-100) se actualiza en sincronía con el progreso de etapa.

Salidas

Una vez en completed:

Lista de artefactos — cada MappingArtifact lleva type, format, sizeBytes, bounds ([west, south, east, north]), thumbnailUrl, y — para 3D — un tilesetUrl.
Descarga — la UI llama a getArtifactDownloadUrl(jobId, type) que devuelve una URL S3 presignada. El respaldo es la artifact.url legado horneada.
Vista previa — miniaturas en línea; los tilesets 3D se cargan en la vista 3D del ops-map.
Archivo — un pseudo-artefacto archive empaqueta el all.zip completo de ODM.

Cancelar / eliminar / re-ejecutar

Cancelar un trabajo en ejecución — se le dice al worker que pare; el estado pasa a cancelled.
Eliminar — elimina el trabajo y sus artefactos S3.
Re-ejecutar — usa Clone job para producir un nuevo trabajo con los mismos ajustes. Las ejecuciones ODM no mutan in situ.