SPB Git forge

spb/wp18_uqo

Public
6commits 1branches 0releases
5.4 MBsize
maindefault branch
yesterdaylast push
TeX 53.2% Python 46.6%
12.3 KB · 152 lines markdown
Rendered Raw Blame History
1# WP18 — Audit de style de la série UQO Working Papers (Phase 0)23Date : 2026-10-20. Sources inspectées **localement** : les 17 dépôts `~/Desktop/Recherche-UQO/{immobilier,finance}/*/paper/`4(main.tex, sections/, appendix/, tables/, references.bib, main.pdf) et le gabarit `~/Desktop/Recherche-UQO/_modele-working-paper/`,5ainsi que `HARMONISATION.md` (standard du 2026-10-17) et `REVISION-PROTOCOLE.md`. Lecture détaillée : WP2 (decoding-real-estate-6descriptions), WP5 (airbnb-rents-housing-pressure), WP8 (polymarket-arrow-debreu, seul WP avec environnements de théorèmes),7WP10 (assessment-gap-quebec), WP16 (sales-comparison-validation). Les autres WP ont été inspectés par grep (préambule, métadonnées,8flottants, bibliographie). Aucun fichier manquant : les 17 `main.tex` et 17 `main.pdf` sont présents (WP18 n'a pas encore de PDF).910## 1. Couverture et numéro1112- `paper/sections/titlepage.tex` = copie exacte du gabarit (identique dans WP18 : vérifié par diff implicite, même taille 1458 o).13  Logo `uq_logo.jpg` 3,5 cm ; « Université du Québec en Outaouais » / « Département des sciences administratives » en14  `\footnotesize\textsc` ; « Working Paper No.~\WPnumber » ; titre `\LARGE\bfseries` ; sous-titre `\large\itshape` si non vide ;15  auteur `\large` ; affiliation, courriel (`\href{mailto:}`), adresse ; date « Month YYYY » ; « Version x.y ». Page 2 : règle,16  **Abstract**, **Keywords:**, **JEL Classification:**, règle. `\thispagestyle{empty}` sur les deux pages.17- Numéro : `\WPnumber{18}` (HARMONISATION §1 : un numéro = un papier ; 1–17 figés). Dépôt spbgit `wp18_uqo.git`.18- Métadonnées obligatoires dans `main.tex` : `\WPnumber`, `\WPtitle`, `\WPsubtitle`, `\WPdate`, `\WPversion`, `\WPabstract`,19  `\WPkeywords`, `\WPjel`, `\WPauthor`, `\WPaffiliation`, `\WPemail`, `\WPaddress`. Valeurs observées sur les 17 WP :20  `\WPdate{October 2026}` (jamais `\today`), `\WPversion` = `1.1`–`2.1` (nombre seul), 5–8 mots-clés en minuscules sauf noms21  propres, séparés par des virgules ; JEL en codes séparés par des virgules.22- Affiliation / courriel / adresse = macros du gabarit, **à ne pas modifier** :23  `\WPaffiliation{Département des sciences administratives\\ Université du Québec en Outaouais}`,24  `\WPemail{simon-pierre.boucher@uqo.ca}`, `\WPaddress{Gatineau -- Pavillon Alexandre-Taché\\ 283, boulevard Alexandre-Taché\\25  Gatineau, Québec, Canada J9A 1L8}`. Auteur unique `Simon-Pierre Boucher` (WP17 est le seul multi-auteurs). Aucun WP ne26  comporte de remerciements ni de coauteur inventé ; WP18 n'en aura pas.2728## 2. Typographie et préambule (commun aux 17 WP)2930`\documentclass[12pt,letterpaper]{article}` ; `inputenc utf8`, `fontenc T1`, `babel english` ; `geometry` marges 1 in ;31`mathptmx` (Times texte + maths) + `microtype` ; `setspace` `\onehalfspacing` ; `amsmath, amssymb, amsthm` ; `booktabs, tabularx,32multirow, threeparttable, siunitx` ; `graphicx, subcaption, float` ; `xcolor[dvipsnames]` + `hyperref` colorlinks NavyBlue ;33`caption` (small, labelfont bf, labelsep period, justified) ; `fancyhdr` (numéro de page centré, pas de filet) ; `titlesec`34(`\section` = `\large\bfseries` « 1. », `\subsection` = `\normalsize\bfseries`, `\subsubsection` = `\normalsize\itshape`) ;35`appendix[toc,page]` ; `enumitem` `nosep`. Le `main.tex` de WP18 est déjà la copie du gabarit : **ne rien retirer**, seulement36ajouter les environnements de théorèmes (§6) et renseigner les métadonnées.3738## 3. Résumé, mots-clés, JEL3940Résumé de 150–220 mots sur la page 2, en un seul paragraphe, résultats réels seulement (REVISION-PROTOCOLE : pas de41« novel », « comprehensive »…). Exemples de JEL de la série immobilier : R21, R31, R32, R51, R52, H22, H71, C21… WP18 proposera42`R21, R31, D31, D91, E31, E44, G51` (à confirmer une fois les résultats connus ; E21 possible pour l'épargne/richesse des ménages).4344## 4. Structure des sections (observée)4546Fichiers séparés dans `paper/sections/` (noms simples : `introduction.tex`, `literature.tex`, `data.tex`, `methodology.tex`,47`results.tex`, `robustness.tex`, `discussion.tex` (WP1, 2, 3, 9, 10, 17), `conclusion.tex`) ; WP5 et WP15 numérotent48`01_introduction.tex`… ; les deux conventions coexistent, la non-numérotée est celle du gabarit. Les titres de section sont49en anglais : « Introduction », « Related literature » (WP10) / « Literature review », « Data and sample construction », « Methodology »,50« Results », « Robustness », « Discussion » (sous-sections « Mechanisms », « Policy implications », « Limitations »), « Conclusion ».51WP8 (seul WP avec de la théorie) ajoute `theoretical.tex` (« Theoretical framework ») entre la revue et les données.5253**Adaptation WP18 (papier théorique, pas de section Données)** — mêmes fichiers, renommés selon le plan du CLAUDE.md :54`introduction.tex`, `literature.tex` (section 4 du plan : revue critique par mécanismes et lacunes), `model.tex` (environnement,55timing, programmes, contraintes, marchés), `equilibrium.tex` (définition d'équilibre + propositions), `numerical.tex` (algorithme,56calibration, vérification), `baseline.tex` (simulations de base, héritage, inégalité), `inflation.tex` (contrefactuels inflation /57contrat hypothécaire), `supply_policy.tex` (élasticité de l'offre, politique, bien-être), `robustness.tex` (sensibilité, limites),58`conclusion.tex`. Les fichiers `data.tex`/`methodology.tex`/`results.tex` du squelette seront remplacés (pas de section vide).59Prose académique sobre, sans listes à puces dans le corps (REVISION-PROTOCOLE), équations numérotées et référencées60(`\eqref`), `\label{sec:…}`, `\label{eq:…}`, `\label{fig:…}`, `\label{tab:…}`, `\label{prop:…}`.6162## 5. Figures et tables6364- Figures : `\begin{figure}[H]` ou `[htbp]` (WP16 et WP10 : `[H]`), `\centering`, `\includegraphics[width=\textwidth]{fN_slug.pdf}`65  (fichiers PDF vectoriels dans `paper/figures/`, chemin résolu par `\graphicspath` ou copie ; WP16 nomme `f1_…`, `f2_…`),66  légende descriptive d'une à trois phrases après le graphique, `\label{fig:…}`. Aucune figure PNG dans le PDF ; les PNG servent67  d'aperçus (README). WP18 : `results/figures/figNN_slug.{pdf,png}` générés par `src/figures.py`, copiés dans `paper/figures/`.68- Tables : `\begin{table}[H]`, `\centering`, `\caption{…}` **avant** la table, `\label{tab:…}`, `\small`/`\footnotesize`,69  corps `\input{tables/<nom>}` généré par script (fragment `tabular` + `booktabs` : `\toprule/\midrule/\bottomrule`, pas de70  filets verticaux), notes en `\begin{tablenotes}\footnotesize \item Note: … \end{tablenotes}` (threeparttable). Les tables71  larges passent par `\resizebox{\textwidth}{!}{\input{…}}`. **Jamais de table tapée à la main** (REVISION-PROTOCOLE) : WP1872  génère `results/tables/*.tex` via `src/tables.py` et les copie dans `paper/tables/`.73- Nombres du texte : WP16 injecte ses chiffres par des macros générées (`\input{tables/numbers}` → `\newcommand{\nSalesRaw}{456,950}`),74  ce qui garantit « chaque nombre du papier correspond à un fichier de résultats ». WP18 reprend ce mécanisme :75  `paper/tables/numbers.tex` généré par `src/tables.py`.76- Virgules protégées dans les titres : `140{,}931`.7778## 6. Environnements de théorèmes7980Aucun des WP1–17 n'est théorique. Seul WP8 (polymarket-arrow-debreu) déclare, dans `main.tex` juste après `amsthm` :81```latex82% --- Theorem Environments ---83\newtheorem{proposition}{Proposition}84\newtheorem{definition}{Definition}85\newtheorem{hypothesis}{Hypothesis}86```87(style amsthm par défaut `plain` : titre gras, corps italique ; numérotation globale sans section ; options88`\begin{proposition}[Absence of arbitrage]\label{prop:no_arb}` ; une preuve en prose sans environnement `proof`). WP10 a une89annexe de dérivations (`\appendix` + `\section{Measurement-error bounds and first stage}`) en prose + équations numérotées.9091**Convention proposée pour WP18** (cohérente avec WP8 et la typographie Times / amsthm du gabarit) :92```latex93% --- Theorem Environments (WP18) ---94\theoremstyle{plain}95\newtheorem{proposition}{Proposition}96\newtheorem{lemma}{Lemma}97\newtheorem{corollary}{Corollary}98\newtheorem{theorem}{Theorem}99\theoremstyle{definition}100\newtheorem{assumption}{Assumption}101\newtheorem{definition}{Definition}102\theoremstyle{remark}103\newtheorem{remark}{Remark}104```105- Numérotation globale (`Proposition 1, 2, …`, `Assumption 1, …`), comme WP8 ; pas de numérotation par section.106- `Assumption` et `Definition` en style `definition` (titre gras, corps romain) pour les distinguer visuellement des résultats ;107  `Proposition/Lemma/Corollary` en `plain` (corps italique). Titres entre crochets : `\begin{proposition}[Ownership threshold]`.108- Preuves : environnement `proof` d'amsthm (« *Proof.* … ∎ ») **dans `paper/appendix_proofs.tex`** (inclus via109  `\input{appendix_proofs}` après `\begin{appendices}`), avec `\begin{proof}[Proof of Proposition~\ref{prop:threshold}]`.110  Les lacunes de preuve sont signalées explicitement dans l'énoncé (« (proof gap: …) ») ou par un `remark`.111- Labels : `prop:`, `lem:`, `cor:`, `ass:`, `def:`, `rem:`. Renvois : `Proposition~\ref{prop:…}`, `Assumption~\ref{ass:…}`.112- Les constats numériques ne sont jamais dans un environnement de théorème (CLAUDE.md : « do not call simulation findings113  theorems ») ; on les énonce en prose (« Result 1 » sans environnement) ou dans une liste `\paragraph`.114115## 7. Citations et bibliographie116117- `natbib[authoryear,round,semicolon]` + `\bibliographystyle{aer}` dans 15/17 WP (WP2 et WP7 : `\bibliography{references}` sans118  `\bibliographystyle` visible dans `main.tex` — dérogation à noter si reproduite ; WP18 suit le gabarit : `aer`).119- Usage : `\citet{}` pour les citations sujets (« \citet{iacoviello2005house} shows… ») et `\citep{}` entre parenthèses ;120  jamais `\cite{}`. Ratios observés WP2 75/83, WP5 75/58, WP10 57/34, WP16 52/26.121- Clés : minuscules `auteurYYYYmotclé` (WP10 : `paglin1972equity`, `cheng1970common`) ou `auteurYYYY` (WP16). WP18 :122  `auteurYYYYmotclé` (premier auteur, année, premier mot significatif du titre), DOI dans chaque entrée, champ `url` seulement123  pour les working papers sans DOI (NBER, Bank of Canada, SSRN), `note` pour les versions WP. Taille observée : 52–94 entrées,124  43–61 avec DOI. REVISION-PROTOCOLE : **zéro référence non vérifiée** ; source de vérification consignée (ici125  `research/literature_matrix.csv`, colonne `verified_via`, et journaux JSON bruts dans `research/verification/`).126- `\newpage \bibliography{references}` avant l'annexe.127128## 8. Annexes129130Deux usages coexistent : `\usepackage[toc,page]{appendix}` + `\begin{appendices} … \end{appendices}` (WP16, WP8 : page131« Appendices » puis `\section{Additional tables}` → « Appendix A ») et `\appendix` + sections (WP10). Le gabarit charge le paquet132`appendix` ; WP18 utilise `\begin{appendices}` avec `\input{appendix_proofs}` (preuves), `\input{appendix_computation}`133(algorithmes, tolérances, diagnostics) puis `\input{appendix/appendix}` (tables et figures supplémentaires), conformément au134plan de répertoire du CLAUDE.md. Équations d'annexe numérotées en continu (pas de `\numberwithin` dans la série).135136## 9. Compilation137138`paper/Makefile` (`latexmk`, `clean`, `distclean`) + `.latexmkrc` du gabarit (`pdf_mode=1`, `pdflatex -interaction=nonstopmode139-halt-on-error -synctex=1`, `bibtex_use=2`, `@default_files=('main.tex')`). Critère HARMONISATION §6 : `cd paper && make` sans `!`,140sans citation/référence indéfinie ; page 1 = « Working Paper No. 18 », titre, auteur, « October 2026 », « Version 1.0 » ;141page 2 = Abstract / Keywords / JEL. Le `Makefile` racine de WP18 (`make paper`) appellera `cd paper && latexmk`.142Longueur observée des PDF : 39–82 pages (médiane ≈ 50), cohérent avec la cible 30–45 pages de texte principal + annexes.143144## 10. Dérogations prévues pour WP18 (à reporter dans README « Notes »)1451461. Papier théorique : pas de section « Data » ; une section « Numerical algorithm, calibration and verification » la remplace.1472. Environnements amsthm étendus (Assumption, Lemma, Corollary, Remark, proof) par rapport à WP8.1483. Annexes séparées `appendix_proofs.tex` et `appendix_computation.tex` à la racine de `paper/` (exigence du CLAUDE.md), en plus149   de `appendix/appendix.tex`.1504. `scripts/` numérotés du standard remplacés par `src/*.py` + `Makefile` + `configs/*.yaml` (exigence du CLAUDE.md) ; à151   documenter dans le README (« Quick start » = `make all`).152