Skip to content

docs: cite Yung+24/25 on colossus comparison, fix Yung24 ref#318

Merged
steven-murray merged 1 commit into
mainfrom
docs/colossus-comparison-citations
Jul 6, 2026
Merged

docs: cite Yung+24/25 on colossus comparison, fix Yung24 ref#318
steven-murray merged 1 commit into
mainfrom
docs/colossus-comparison-citations

Conversation

@steven-murray

Copy link
Copy Markdown
Collaborator

Description

Aaron Yung and Miguel Vargas independently noticed the hmf/Colossus Tinker08 disagreement while preparing their papers, and that report is what led to the growth-factor fix (#270) and the follow-up threshold tightening in v3.6.1. They've given permission to cite their work on the comparison page.

This PR:

  • Adds a short note near the top of docs/technical/colossus_comparison.rst crediting Yung and Vargas, with proper citations to:
    • Yung et al. 2024, MNRAS 530, 4868
    • Yung et al. 2025, MNRAS 543, 3802
  • Follows the repo's existing citation convention (plain reST [Label]_ citations + a References section, as used in growth_factors.rst) — there's no CITATIONS.bib/CITATION.cff in the repo to extend, so no new bibliography format was introduced.
  • Fixes an unrelated but adjacent bug I noticed while verifying the 2024 reference: Yung24._ref in src/hmf/mass_function/fitting_functions.py cited the wrong author list (Finkelstein/Wilkins instead of Nguyen/Behroozi/Modi) and the wrong MNRAS volume/page (527, 5929 instead of 530, 4868) for arXiv:2309.14408.

Issues

N/A

Checklist

I have

  • N/A — docs/reference-only change, no new behavior to test
  • N/A — no docstring behavior changed, only corrected a citation string
  • N/A — not a tutorial-worthy feature
  • Important: this change does not break API compatibility

Aaron Yung and Miguel Vargas noticed the hmf/Colossus Tinker08
discrepancy while preparing their papers, which led directly to the
growth-factor fix. Add a note and citations crediting them on the
comparison page, using the repo's existing reST citation convention
(no bibliography file exists to extend).

Also fixes the Yung24 fitting-function `_ref` string, which had the
wrong author list and MNRAS volume/page for arXiv:2309.14408 (should
be Yung, Somerville, Nguyen, Behroozi, Modi, Gardner, MNRAS 530, 4868,
not the previously listed authors and MNRAS 527, 5929).
@codecov

codecov Bot commented Jul 6, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.89%. Comparing base (3150f21) to head (82cbabd).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #318   +/-   ##
=======================================
  Coverage   97.89%   97.89%           
=======================================
  Files          26       26           
  Lines        2710     2710           
=======================================
  Hits         2653     2653           
  Misses         57       57           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@steven-murray steven-murray added the type: maint: documentation Improvements or additions to documentation label Jul 6, 2026
@steven-murray
steven-murray merged commit e4c52e5 into main Jul 6, 2026
22 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: maint: documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant