VISWIR_vQuasar module¶
The VISWIR_vQuasar module represents the current and actively maintained
implementation of the VISWIR pipeline. It provides the latest algorithms,
optimizations, and real‑time features for visible–SWIR image fusion.
Compared to legacy versions, this version is faster, more modular, and better integrated with the rest of the VISWIR ecosystem.
Tip
Use fast mode to quickly preview results when adjusting parameters. This mode skips metric computation and is intended for rapid prototyping. Switch back to the standard mode for full evaluation and benchmarking.
Main entry point for the VISWIR Quasar project.
This function orchestrates the execution of the VISWIR pipeline depending on the selected mode (fast, SQL, or Optuna).
Workflow¶
- Parse CLI arguments.
–fast : Run the fast pipeline (fusion + detection, no metrics).
–visible, –swir, –out : Required in fast mode.
- If fast mode is enabled:
Load minimal config (fast_config.yaml and yolo_config.json).
Run the FastFusionPipeline on the provided visible and SWIR images.
Save the fused image to the specified output path.
- Otherwise:
Load all configurations (base, params, optuna).
- Validate that mode_fixe is enabled in parameters.json.
If not, exit with a safety warning.
- Dispatch execution depending on the mode:
“optuna” : Run Optuna optimization (process_folder_optuna).
“sql” : Run SQL-based batch processing (process_folder_sql).
“fixed” : Run fixed-parameter batch processing (process_folder).
Notes
- The script enforces mode_fixe for safety reasons, to prevent
accidental execution of exploratory modes that may consume excessive disk space or memory.
Logs are written using the project-wide logger.
Errors are caught at the top level and logged as critical.
- raises SystemExit:
If required arguments are missing in fast mode, or if mode_fixe is disabled in the configuration.