docs/README-fr.md : README français d'origine conservé (WP 16)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Simon-Pierre Boucher committed 1 h ago (Oct 17, 2026) parent 36bb402

1 changed file +49 −0

added docs/README-fr.md +49 −0

		`@@ -0,0 +1,49 @@`
	1	+# Validation empirique de la méthode des comparables (Vrai Prix)
	2	+
	3	+Projet de recherche : rétro-évaluation à grande échelle de la méthode de comparaison des ventes sur les transactions
	4	+résidentielles unifamiliales du Québec (Vrai Prix, 2021-01 → 2026-09). Protocole : `docs/PROTOCOLE.md`.
	5	+Rapport de résultats : `docs/RAPPORT.md` / `docs/RAPPORT.pdf`.
	6	+
	7	+## Organisation
	8	+
	9	+```
	10	+pipeline/ 01_dataset → 02_index → 03_models → 04_backtest → 05_analyze → 06_report
	11	+docs/ PROTOCOLE.md, RAPPORT.md(.pdf), header.tex
	12	+out/<version>/ sales.parquet, index_asof.npy, models_.json, est_E.npy, targets.parquet, tables/, fig/, results.json
	13	+data/ (nœud seulement) vraiprix-20261010.db — instantané de la base de production Vrai Prix
	14	+ref/ MUN.csv (répertoire des municipalités MAMH : code → MRC → région)
	15	+```
	16	+
	17	+## Exécution
	18	+
	19	+Le calcul se fait sur M2U64 (`~/comparables-validation`, venv `~/uqo-eval-terrains/env`, Python 3.14 : pandas, numpy, scipy,
	20	+lightgbm, matplotlib). Le laptop garde le code, les docs et une copie des sorties.
	21	+
	22	+```bash
	23	+rsync -a --exclude out --exclude data --exclude .git ~/Desktop/Recherche-UQO/immobilier/sales-comparison-validation/ M2U64:comparables-validation/
	24	+ssh M2U64 'cd ~/comparables-validation && CV_VERSION=2026-10-10 ./run_all.sh' # ~ 30 min
	25	+./make_pdf.sh # rapatrie out/ + docs/ et compile le PDF
	26	+```
	27	+
	28	+Variables : `CV_VERSION` (dossier de sortie), `CV_SAMPLE=3000` (échantillon de cibles pour un essai), `CV_PROCS` (processus, 20 par défaut).
	29	+
	30	+## Données
	31	+
	32	+Instantané `vraiprix.db` pris sur M3U96a (`~/apps/vrai-prix/data`) le 2026-10-10 : 766 596 transactions, 3,75 M d'unités du rôle.
	33	+Jeu propre : ventes `unifamilial` jumelées au rôle, règles R0-R11 journalisées dans `out/<v>/exclusions.csv`.
	34	+
	35	+## Working paper (UQO WP 16)
	36	+
	37	+`paper/` : article en anglais au gabarit UQO (`main.tex`, `sections/*.tex`, `appendix/`, `references.bib`).
	38	+Les chiffres du texte sont des macros (`tables/numbers.tex`) et les tableaux sont générés depuis `out/<version>/` :
	39	+
	40	+```bash
	41	+./make_pdf.sh # rapatrie out/ et compile docs/RAPPORT.pdf (français)
	42	+cd paper && python3 make_paper_tables.py && latexmk -pdf main.tex # tables + macros + PDF du WP
	43	+```
	44	+
	45	+## Calcul réparti
	46	+
	47	+`run_distributed.sh` : distribue les modèles trimestriels aux nœuds, lance la rétro-évaluation en 15 fragments
	48	+(M3U96a ×4, M3U96b ×4, M2U64 ×3, M4M64a ×2, M4M64b ×2), rassemble sur M2U64 (`04b_gather.py`) puis exécute 05 et 06.
	49	+Ré-estimation trimestrielle répartie : `CV_ASOF=54,57 CV_THREADS=28 ../env/bin/python 03_models.py` sur chaque nœud.
	50