Translate the whole project to English and fix outdated comments and help

Comments, docstrings, logs, CLI help, map UI, legends, PDF sheet, scripts,
compose files and AGENTS.md are now English. Data keys stay unchanged
(relief_oriente, densite_sol, visualisations/, API JSON keys, link params).
Wrong comments and help defaults found along the way are corrected.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Antoine
2026-09-27 23:16:45 +02:00
parent cc1c22d2b8
commit fb892ea9f2
52 changed files with 4356 additions and 4323 deletions

View File

@ -1,16 +1,18 @@
# Lancement du pipeline LiDAR — TOUJOURS via docker compose :
# docker compose up -d --build serve # TOUJOURS --build : le code est baké dans
# # l'image, sans --build l'ANCIEN code tourne
# # (carte + tuiles XYZ + API sur http://localhost:8973)
# docker compose logs -f serve # journal du serveur
# docker compose down # arrêt
# Traitement ponctuel (sans serveur) — --build pour la même raison :
# docker compose run --rm --build process [-r 0.2 | --force | --file ...]
# Jupyter (opt-in) :
# Running the LiDAR pipeline - ALWAYS through docker compose:
# docker compose up -d --build serve # ALWAYS --build: the code is baked into
# # the image; without --build the OLD code runs
# # (map + XYZ tiles + API on http://localhost:8973)
# docker compose logs -f serve # server log
# docker compose down # stop
# One-off processing (no server) - --build for the same reason:
# docker compose run --rm --build process [--force | --file ...]
# (any argument replaces the default command: repeat
# python3 -m lidar_pipeline /data/input -o /data/output ... in full)
# Jupyter (opt-in):
# docker compose --profile interactive up -d jupyter
services:
# Carte + tuiles XYZ + API de génération (mode ./run.sh --serve)
# Map + XYZ tiles + generation API (./run.sh --serve mode)
serve:
build: .
image: lidar-lidar
@ -21,7 +23,7 @@ services:
ports:
- "8973:8973"
volumes:
# input/ en écriture : l'API y télécharge les dalles IGN manquantes
# input/ writable: the API downloads missing IGN tiles into it
- ./input:/data/input
- ./output:/data/output
environment:
@ -29,21 +31,21 @@ services:
- LIDAR_INPUT_DIR=/data/input
- LIDAR_OUTPUT_DIR=/data/output
- LIDAR_PORT=8973
# Les générations lancées depuis la carte utilisent le GPU
# Generations started from the map use the GPU
- LIDAR_GPU=1
- LIDAR_WORKERS=10
# Machine de traitement pour une carte distante (Raspberry Pi) :
# décommenter et définir la même valeur en LIDAR_REMOTE_TOKEN là-bas
# (protège /api/generate, /api/preview, /api/stop).
# - LIDAR_API_TOKEN=change-moi
# Réseaux autorisés à lancer les générations depuis la carte (défaut :
# localhost + plages privées RFC1918 ; liste de CIDR séparés par
# virgules, vide = tout autoriser).
# Processing machine for a remote map (Raspberry Pi): uncomment and set
# the same value as LIDAR_REMOTE_TOKEN over there (protects
# /api/generate, /api/preview, /api/stop, /api/queue/clear).
# - LIDAR_API_TOKEN=change-me
# Networks allowed to start generations from the map (default:
# localhost + RFC1918 private ranges; comma-separated CIDR list,
# empty = allow everything).
# - LIDAR_REGEN_CIDR=192.168.1.0/24
command: python3 -m uvicorn lidar_pipeline.mapserve:app --host 0.0.0.0 --port 8973
restart: unless-stopped
# Traitement ponctuel des dalles input/ (une passe puis arrêt)
# One-off processing of the input/ tiles (one pass, then exit)
process:
build: .
image: lidar-lidar
@ -60,7 +62,7 @@ services:
profiles:
- process
# Exploration interactive (opt-in : --profile interactive)
# Interactive exploration (opt-in: --profile interactive)
jupyter:
build: .
image: lidar-lidar
@ -70,11 +72,11 @@ services:
ports:
- "8888:8888"
volumes:
- ./input:/data/input:ro # exploration seule : pas d'écriture dans input/
- ./input:/data/input:ro # exploration only: no writes to input/
- ./output:/data/output
- ./notebooks:/workspace
# Pas de token vide : Jupyter en génère un et l'affiche (URL de login)
# dans `docker compose logs jupyter` — le port 8888 reste protégé.
# No empty token: Jupyter generates one and prints it (login URL) in
# `docker compose logs jupyter` - port 8888 stays protected.
command: >
bash -c "pip install --user jupyter && \
python3 -m notebook --ip=0.0.0.0 --port=8888 --no-browser \