harmonisation standard UQO WP (2026-10-17)
Page titre canonique, hyperref pdftitle/pdfauthor, mots-clés normalisés, .gitignore du gabarit, README : Status + Notes, courriel uqo.ca. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
11 changed files +64 −24
modified
.gitignore
+16 −1
@@ -1,19 +1,34 @@ | ||
| 1 | −# Raw data snapshot — 747 MB, exceeds GitHub limits and is not redistributed | |
| 1 | +# Raw data snapshot — 747 MB DuckDB, not redistributed (see data/raw/README.md) | |
| 2 | 2 | data/raw/*.duckdb |
| 3 | +data/raw/*.parquet | |
| 4 | +data/processed/*.parquet | |
| 3 | 5 | |
| 4 | 6 | # Python |
| 5 | 7 | __pycache__/ |
| 6 | 8 | *.pyc |
| 9 | +.pytest_cache/ | |
| 10 | +.venv/ | |
| 11 | +*.egg-info/ | |
| 7 | 12 | |
| 8 | 13 | # LaTeX build artifacts (paper/main.pdf IS committed) |
| 9 | 14 | paper/*.aux |
| 10 | 15 | paper/*.log |
| 11 | 16 | paper/*.out |
| 17 | +paper/*.toc | |
| 18 | +paper/*.lof | |
| 19 | +paper/*.lot | |
| 12 | 20 | paper/*.fls |
| 13 | 21 | paper/*.fdb_latexmk |
| 14 | 22 | paper/*.bbl |
| 15 | 23 | paper/*.blg |
| 24 | +paper/*.spl | |
| 16 | 25 | paper/*.synctex.gz |
| 26 | +paper/*.run.xml | |
| 27 | +paper/*.bcf | |
| 28 | + | |
| 29 | +# Logs | |
| 30 | +logs/ | |
| 31 | +*.log | |
| 17 | 32 | |
| 18 | 33 | # macOS |
| 19 | 34 | .DS_Store |
modified
README.md
+26 −10
@@ -3,15 +3,15 @@ | ||
| 3 | 3 | **UQO Working Paper No. 9** — *Decomposing the Value of Structure and Location across |
| 4 | 4 | 140,931 MLS Listings with High-Dimensional Neighbourhood Fixed Effects* |
| 5 | 5 | |
| 6 | −[-b31b1b?logo=latex&logoColor=white)](paper/main.pdf) | |
| 6 | +[-b31b1b?logo=latex&logoColor=white)](paper/main.pdf) | |
| 7 | 7 | [](requirements.txt) |
| 8 | 8 | [](data/raw/README.md) |
| 9 | 9 | [-4051b5)](src/wp9/models.py) |
| 10 | 10 | [](scripts/) |
| 11 | −[](AUDIT.md) | |
| 11 | +[](docs/AUDIT.md) | |
| 12 | 12 | [](https://uqo.ca) |
| 13 | −[](mailto:contact@spboucher.ai) | |
| 14 | −[](mailto:contact@spboucher.ai) | |
| 13 | +[](mailto:simon-pierre.boucher@uqo.ca) | |
| 14 | +[](mailto:simon-pierre.boucher@uqo.ca) | |
| 15 | 15 | |
| 16 | 16 | > **TL;DR** — On 140,931 Canadian MLS listings, absorbing 1,153 neighbourhood (FSA) fixed |
| 17 | 17 | > effects lifts explained log-price variance from **46% → 77%**. Location alone is worth |
@@ -21,8 +21,18 @@ | ||
| 21 | 21 | |
| 22 | 22 | --- |
| 23 | 23 | |
| 24 | +## 📌 Status | |
| 25 | + | |
| 26 | +| Item | Value | | |
| 27 | +|---|---| | |
| 28 | +| Version | 1.2 (May 2026) | | |
| 29 | +| SSRN | [7626678](https://ssrn.com/abstract=7626678) — submitted 2026-10-17 (preliminary upload) | | |
| 30 | +| Journal | not yet submitted | | |
| 31 | +| Code & data | reproducible from `scripts/` (see Quick start); raw DuckDB snapshot not redistributed | | |
| 32 | + | |
| 24 | 33 | ## 📖 Table of contents |
| 25 | 34 | |
| 35 | +0. [Status](#-status) | |
| 26 | 36 | 1. [What this paper does](#-what-this-paper-does) |
| 27 | 37 | 2. [Headline results](#-headline-results) |
| 28 | 38 | 3. [Repository layout](#-repository-layout) |
@@ -91,8 +101,8 @@ Saskatchewan, Manitoba and Newfoundland (−60 to −67%). | ||
| 91 | 101 | ``` |
| 92 | 102 | wp9_uqo/ |
| 93 | 103 | ├── README.md ← you are here |
| 94 | −├── AUDIT.md forensic audit of the original project + verification | |
| 95 | −├── CHANGES.md restructuring report (what moved, what was rewritten) | |
| 104 | +├── docs/ AUDIT.md (forensic audit + verification), CHANGES.md, | |
| 105 | +│ PAPER_REVIEW.md, UPGRADE_REPORT.md | |
| 96 | 106 | ├── requirements.txt pinned Python dependencies |
| 97 | 107 | ├── .gitignore |
| 98 | 108 | ├── data/ |
@@ -120,7 +130,7 @@ wp9_uqo/ | ||
| 120 | 130 | │ └── tables/ the 6 LaTeX tables consumed by the paper |
| 121 | 131 | └── paper/ |
| 122 | 132 | ├── main.tex preamble + metadata; \input's the sections |
| 123 | − ├── main.pdf compiled paper (26 pages) | |
| 133 | + ├── main.pdf compiled paper (34 pages) | |
| 124 | 134 | ├── sections/ titlepage, introduction, literature, data, |
| 125 | 135 | │ methodology, results, robustness, conclusion |
| 126 | 136 | ├── references.bib 32 entries, natbib author-year, aer style |
@@ -211,7 +221,7 @@ Alberta dominate; PEI and the territories have no listings in this snapshot. | ||
| 211 | 221 | |
| 212 | 222 | The original upstream cleaning code (`RE_DB_QC/hedonic`) was **lost** before this |
| 213 | 223 | repository was assembled; `src/wp9/sample.py` is a careful reconstruction from the |
| 214 | −paper's own data section, calibrated against every stored output (see `AUDIT.md`). It | |
| 224 | +paper's own data section, calibrated against every stored output (see `docs/AUDIT.md`). It | |
| 215 | 225 | reproduces the published sample to **+0.86%** and all headline estimates closely — but |
| 216 | 226 | not to the last digit. To keep the published record intact: |
| 217 | 227 | |
@@ -254,7 +264,7 @@ Tables (`results/tables/`): `summary_stats`, `regression` (M1/M2/M3/M5), | ||
| 254 | 264 | |
| 255 | 265 | ## ✅ Reproduction verification |
| 256 | 266 | |
| 257 | −Full side-by-side in [`AUDIT.md`](AUDIT.md) §5. Highlights (original → reproduced): | |
| 267 | +Full side-by-side in [`docs/AUDIT.md`](docs/AUDIT.md) §5. Highlights (original → reproduced): | |
| 258 | 268 | |
| 259 | 269 | - Sample: 140,931 → 142,146 (+0.86%); condos match to 3 listings. |
| 260 | 270 | - R² ladder: 0.464/0.469/0.567/0.762/0.767 → 0.467/0.470/0.569/0.766/0.770. |
@@ -295,9 +305,15 @@ research agenda these imply. | ||
| 295 | 305 | Département des sciences administratives, Université du Québec en Outaouais |
| 296 | 306 | Gatineau — Pavillon Alexandre-Taché, 283 boulevard Alexandre-Taché, Gatineau (QC) J9A 1L8 |
| 297 | 307 | |
| 298 | −📧 **contact@spboucher.ai** · 🌐 [spboucher.ai](https://www.spboucher.ai) | |
| 308 | +📧 **simon-pierre.boucher@uqo.ca** · 🌐 [spboucher.ai](https://www.spboucher.ai) | |
| 299 | 309 | |
| 300 | 310 | All code files carry the header `Author: Simon-Pierre Boucher — contact@spboucher.ai`. |
| 301 | 311 | |
| 302 | 312 | © 2026 Simon-Pierre Boucher. All rights reserved. The listing data snapshot is not |
| 303 | 313 | redistributed; code and paper are shared for research reproducibility. |
| 314 | + | |
| 315 | +## 🗒 Notes | |
| 316 | + | |
| 317 | +- Numbering: UQO Working Paper No. 9 since the first version (May 2026). | |
| 318 | +- The original flat May 2026 project (`immo-wp9-spb-20260529`) is archived in `Recherche-UQO/_archives/versions-mai-2026/grand-hedonic-model-canada--immo-wp9-20260529`; `docs/AUDIT.md` and `docs/CHANGES.md` describe how this repository was rebuilt from it. | |
| 319 | +- Cover page, metadata and layout follow `Recherche-UQO/HARMONISATION.md` (2026-10-17). | |
renamed
AUDIT.md → docs/AUDIT.md
+0 −0
renamed
CHANGES.md → docs/CHANGES.md
+0 −0
renamed
PAPER_REVIEW.md → docs/PAPER_REVIEW.md
+0 −0
renamed
UPGRADE_REPORT.md → docs/UPGRADE_REPORT.md
+0 −0
modified
paper/.latexmkrc
+0 −1
@@ -1,4 +1,3 @@ | ||
| 1 | −# Author: Simon-Pierre Boucher — contact@spboucher.ai | |
| 2 | 1 | $pdf_mode = 1; |
| 3 | 2 | $pdflatex = 'pdflatex -interaction=nonstopmode -halt-on-error -synctex=1 %O %S'; |
| 4 | 3 | $bibtex_use = 2; |
modified
paper/Makefile
+4 −2
@@ -1,9 +1,11 @@ | ||
| 1 | −# Author: Simon-Pierre Boucher — contact@spboucher.ai | |
| 1 | +.PHONY: all clean distclean | |
| 2 | + | |
| 2 | 3 | all: |
| 3 | − latexmk -pdf main.tex | |
| 4 | + latexmk | |
| 4 | 5 | |
| 5 | 6 | clean: |
| 6 | 7 | latexmk -c |
| 7 | 8 | |
| 8 | 9 | distclean: |
| 9 | 10 | latexmk -C |
| 11 | + rm -f *.synctex.gz *.run.xml *.bbl *.bcf | |
modified
paper/main.pdf
+0 −0
Binary file not shown.
modified
paper/main.tex
+3 −2
@@ -67,8 +67,7 @@ | ||
| 67 | 67 | 140{,}931 MLS Listings with High-Dimensional Neighbourhood Fixed Effects} |
| 68 | 68 | \newcommand{\WPdate}{May 2026} |
| 69 | 69 | \newcommand{\WPversion}{1.2} |
| 70 | −\newcommand{\WPkeywords}{Hedonic pricing, Housing markets, Canada, Fixed effects, | |
| 71 | − Spatial heterogeneity, Automated valuation} | |
| 70 | +\newcommand{\WPkeywords}{hedonic pricing, housing markets, Canada, fixed effects, spatial heterogeneity, automated valuation} | |
| 72 | 71 | \newcommand{\WPjel}{R31, R21, C21, C55} |
| 73 | 72 | |
| 74 | 73 | \newcommand{\WPauthor}{Simon-Pierre Boucher} |
@@ -98,6 +97,8 @@ distance to major metros, and quantile and cross-province heterogeneity in the i | ||
| 98 | 97 | prices. We map the resulting neighbourhood premia, which span a factor of roughly nine |
| 99 | 98 | between the most and least expensive areas.} |
| 100 | 99 | |
| 100 | +\hypersetup{pdftitle={A Grand Hedonic Model of the Canadian Housing Market}, pdfauthor={Simon-Pierre Boucher}} | |
| 101 | + | |
| 101 | 102 | \begin{document} |
| 102 | 103 | |
| 103 | 104 | \input{sections/titlepage} |
modified
paper/sections/titlepage.tex
+15 −8
@@ -1,17 +1,17 @@ | ||
| 1 | −% Author: Simon-Pierre Boucher — contact@spboucher.ai | |
| 2 | 1 | % ============================================================================ |
| 3 | −% Title and abstract pages | |
| 2 | +% Title Page | |
| 4 | 3 | % ============================================================================ |
| 5 | 4 | \thispagestyle{empty} |
| 6 | 5 | |
| 7 | 6 | \begin{center} |
| 8 | 7 | |
| 9 | −\includegraphics[width=4cm]{uq_logo.jpg} | |
| 8 | +% --- Logo --- | |
| 9 | +\includegraphics[width=3.5cm]{uq_logo.jpg} | |
| 10 | 10 | |
| 11 | 11 | \vspace{0.6cm} |
| 12 | 12 | |
| 13 | −{\footnotesize\textsc{Universit\'e du Qu\'ebec en Outaouais}}\\[0.15cm] | |
| 14 | −{\footnotesize\textsc{D\'epartement des sciences administratives}} | |
| 13 | +{\footnotesize\textsc{Université du Québec en Outaouais}}\\[0.15cm] | |
| 14 | +{\footnotesize\textsc{Département des sciences administratives}} | |
| 15 | 15 | |
| 16 | 16 | \vspace{0.8cm} |
| 17 | 17 | |
@@ -19,13 +19,17 @@ | ||
| 19 | 19 | |
| 20 | 20 | \vspace{1.2cm} |
| 21 | 21 | |
| 22 | +% --- Title --- | |
| 22 | 23 | {\LARGE\bfseries \WPtitle\par} |
| 23 | 24 | |
| 24 | −\vspace{0.4cm} | |
| 25 | −{\large\itshape \WPsubtitle\par} | |
| 25 | +\ifx\WPsubtitle\empty\else | |
| 26 | + \vspace{0.3cm} | |
| 27 | + {\large\itshape \WPsubtitle\par} | |
| 28 | +\fi | |
| 26 | 29 | |
| 27 | 30 | \vspace{1.2cm} |
| 28 | 31 | |
| 32 | +% --- Author --- | |
| 29 | 33 | {\large \WPauthor}\\[0.3cm] |
| 30 | 34 | {\normalsize \WPaffiliation}\\[0.15cm] |
| 31 | 35 | {\normalsize \href{mailto:\WPemail}{\WPemail}}\\[0.15cm] |
@@ -33,6 +37,7 @@ | ||
| 33 | 37 | |
| 34 | 38 | \vspace{0.8cm} |
| 35 | 39 | |
| 40 | +% --- Date & Version --- | |
| 36 | 41 | {\normalsize \WPdate}\\[0.1cm] |
| 37 | 42 | {\small Version~\WPversion} |
| 38 | 43 | |
@@ -42,7 +47,9 @@ | ||
| 42 | 47 | |
| 43 | 48 | \newpage |
| 44 | 49 | |
| 45 | −% ---------------------------------------------------------------- abstract | |
| 50 | +% ============================================================================ | |
| 51 | +% Abstract Page | |
| 52 | +% ============================================================================ | |
| 46 | 53 | \thispagestyle{empty} |
| 47 | 54 | |
| 48 | 55 | \vspace*{1cm} |
| 49 | 56 | |