⚠️ Avertissements Importants - tinystork/zemosaic GitHub Wiki

⚠️ Avertissements Importants : Utilisation des Ressources (RAM et Disque) ZeMosaic est un outil puissant capable de traiter un très grand nombre d'images. Cependant, certaines étapes peuvent être particulièrement gourmandes en ressources, notamment en mémoire vive (RAM) et en espace disque. Voici les éléments importants à connaître pour une utilisation optimale.

🧠 Utilisation de la Mémoire Vive (RAM) 📌 Facteurs influents Nombre d'images sources dans un groupe de master tuile (Phase 3) → Chaque groupe est chargé en entier en mémoire pour être aligné et empilé.

Exemple :

Seestar S50 (24 Mo/image en float32) × 100 images = 2 à 4 Go de RAM par thread, incluant masques de poids et tableaux intermédiaires.

✅ Recommandation : Limitez le nombre de threads pour la Phase 3 via l’option dans la GUI (Threads de Traitement). Une limite automatique des images par tuile est prévue prochainement.

🧩 Méthodes d’Assemblage (Phase 5) 🔹 Reproject & Coadd (recommandé pour la qualité) Nécessite de charger en mémoire de nombreuses tuiles pour le match_background.

Exemple : 180 tuiles = ~15 Go de RAM avec 2 threads.

⚠️ Pour des mosaïques très vastes : prévoir 32 à 64 Go de RAM, voire plus.

🔹 Mode Incrémental (faible mémoire) Traitement séquentiel des tuiles, utilise des accumulateurs.

Exemple :

5000×4000 (3 canaux) → 1 Go

20000×20000 → ~50 Go

✅ Recommandation :

Choisir ce mode si vous avez peu de RAM.

Les transitions entre tuiles peuvent être un peu plus visibles.

⚙️ Threads de Traitement Plus vous autorisez de threads, plus la RAM consommée en parallèle augmente.

💡 Conseils généraux Surveillez votre RAM pendant les traitements.

En cas de lenteur ou d’erreur “Out of Memory” :

Réduisez le nombre de threads dans la GUI.

Fermez les autres applications.

32 Go = bon départ, mais 64 Go ou + peuvent être requis pour de gros projets en mode Reproject.

💾 Utilisation de l’Espace Disque 📁 Fichiers temporaires utilisés Cache images prétraitées (.zemosaic_img_cache/) → Fichiers .npy (float32 non compressé)

Exemple :

1000 images Seestar S50 = ~24 Go

10 000 images = ~240 Go

Tuiles intermédiaires (zemosaic_temp_master_tiles/) → Sauvegardées en .fits

Exemple :

180 tuiles de 24 Mo = ~4,3 Go

✅ Recommandations Vérifiez que le disque contenant le dossier de sortie a suffisamment d’espace libre.

Les dossiers temporaires sont nettoyés automatiquement en fin de traitement, mais doivent être supprimés manuellement en cas d’interruption.

🐞 Signaler un Bug ou un Problème 🔍 Consulter les logs GUI : Messages dans la fenêtre de log de l'application.

Fichier zemosaic_worker.log : → Situé dans le dossier contenant zemosaic_worker.py → Contient des informations détaillées, très utiles pour le debug.

📬 Créer une issue GitHub Accédez à la page Issues du projet

Cliquez sur "New Issue"

Décrivez :

Version de ZeMosaic

Système d’exploitation

Actions effectuées

Paramètres utilisés

Comportement attendu vs observé

Joignez :

Le contenu complet de zemosaic_worker.log

Une capture d’écran de la GUI

Une image de sortie problématique

Un petit jeu de données (si possible)

Plus vous fournissez d'informations, plus il sera facile d’identifier et résoudre le problème. Merci de contribuer à l'amélioration de ZeMosaic !