spb/traite-evaluation-qc
Public
1\chapter{Scripts, données et classeurs}\label{app:scripts-classeurs}23Cette annexe inventorie les artefacts informatiques qui accompagnent l'ouvrage et qui permettent de reproduire chaque chiffre, chaque tableau et chaque figure. Le dépôt est organisé selon les conventions décrites dans \texttt{CONVENTIONS.md} ; l'inventaire ci-dessous est généré automatiquement par \texttt{tools/inventaire.py} à partir de l'état du dépôt, de sorte qu'il reflète toujours les fichiers réellement présents.45\section{Organisation du dépôt}6Le manuscrit LuaLaTeX se trouve dans \texttt{manuscript/} (un fichier par chapitre dans \texttt{chapters/}, les annexes dans \texttt{appendices/}, les pages liminaires dans \texttt{frontmatter/}) et s'appuie sur le style \texttt{styles/\allowbreak traite-qc.sty}. Les figures vectorielles sont dans \texttt{assets/\allowbreak figures/\allowbreak chNN/}, chacune produite par un script de \texttt{analysis/\allowbreak python/\allowbreak figures/} ou dessinée en TikZ dans le chapitre. Les données brutes publiques, jamais modifiées, sont dans \texttt{data/raw/} avec leur inventaire (\texttt{SOURCES.md} : URL exacte, licence, date de téléchargement) ; les jeux synthétiques, identifiés comme tels, dans \texttt{data/synthetic/} avec leurs lois de génération (\texttt{README.md}) et le journal de calibration (\texttt{calibration\_\allowbreak journal.csv}). La bibliothèque commune \texttt{analysis/\allowbreak python/\allowbreak traite/} regroupe les fonctions financières, la méthode du coût, la comparaison, l'économétrie hédonique et spatiale, les panels, la géomatique et les quatre dossiers de cas ; chaque fonction est couverte par un test de \texttt{analysis/\allowbreak python/\allowbreak tests/}. Les registres de vérification (\texttt{verification/}) relient chaque affirmation, chaque calcul et chaque figure à sa source ou à son script.78\section{Reproduire l'ouvrage}9Depuis la racine du dépôt : \texttt{make data} régénère les jeux synthétiques (graines fixées) ; \texttt{make figures} exécute tous les scripts de figures ; \texttt{make test} lance les tests unitaires et les vérifications du manuscrit ; \texttt{make pdf} compile le livre (LuaLaTeX, biber, makeindex) ; \texttt{make chapter CH=16} compile un chapitre isolé. Les prérequis sont énumérés dans \texttt{README.md}. Aucune donnée réelle sous licence restrictive n'est redistribuée ; les chiffres d'industrie (APCIQ, CBRE, Altus, JLR) sont cités avec attribution, jamais reproduits en tableau.1011\section{Classeurs Excel}12Trois classeurs à formules vivantes, produits par le script \texttt{make\_spreadsheets.py} du dossier \texttt{analysis/python/cases/}, reproduisent les identités du livre : la grille d'ajustements du cas 1 (chapitres 16 et 17), le dossier du cas 3 (état locatif, dépenses normalisées, revenu net, capitalisation, flux actualisés, financement ; chapitres 28 à 31 et 47) et un calculateur d'hypothèque canadienne à composition semestrielle avec tableau d'amortissement (chapitre 31). Les cellules de contrôle rappellent les valeurs calculées par la bibliothèque Python, de sorte qu'un écart signale une divergence de convention.1314\section{Inventaire}15\input{../manuscript/appendices/_inventaire.tex}16