Add JOSS paper for submission

.github/workflows/draft-pdf.yml

@@ -0,0 +1,23 @@
+on:
+  push:
+    paths:
+      - paper.md
+      - paper.bib
+  pull_request:
+    paths:
+      - paper.md
+      - paper.bib
+
+jobs:
+  paper:
+    runs-on: ubuntu-latest
+    name: Draft PDF
+    steps:
+      - uses: actions/checkout@v4
+      - uses: openjournals/openjournals-draft-action@master
+        with:
+          journal: joss
+      - uses: actions/upload-artifact@v4
+        with:
+          name: paper
+          path: paper.pdf

CITATION.cff

@@ -0,0 +1,31 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+type: software
+title: "microimpute: A Model-Agnostic Tool for Cross-Survey Imputation"
+url: "https://github.com/PolicyEngine/microimpute"
+repository-code: "https://github.com/PolicyEngine/microimpute"
+abstract: "A Python package for imputing variables from one survey onto another, implementing five imputation methods behind a common interface with cross-validated automatic method selection."
+authors:
+  - family-names: Ahmadi
+    given-names: Vahid
+    orcid: "https://orcid.org/0009-0004-1093-6272"
+    affiliation: "PolicyEngine, Washington, DC, United States"
+  - family-names: Ghenis
+    given-names: Max
+    orcid: "https://orcid.org/0000-0002-1335-8277"
+    affiliation: "PolicyEngine, Washington, DC, United States"
+  - family-names: Juaristi
+    given-names: María
+    orcid: "https://orcid.org/0009-0007-4946-2248"
+    affiliation: "PolicyEngine, Washington, DC, United States"
+  - family-names: Woodruff
+    given-names: Nikhil
+    orcid: "https://orcid.org/0009-0009-5004-4910"
+    affiliation: "PolicyEngine, Washington, DC, United States"
+keywords:
+  - imputation
+  - statistical matching
+  - survey microdata
+  - quantile regression
+  - microsimulation
+  - Python

CODE_OF_CONDUCT.md

@@ -0,0 +1,64 @@
+# Contributor covenant code of conduct
+
+## Our pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+hello@policyengine.org. All complaints will be reviewed and investigated
+promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+[homepage]: https://www.contributor-covenant.org

changelog.d/joss-paper.added.md

@@ -0,0 +1 @@
+- Added a JOSS paper, a citation file, a code of conduct, and a workflow that builds a draft PDF of the paper.

paper.bib

@@ -0,0 +1,124 @@
+@misc{arnold_ventures,
+  title={Public Finance Program},
+  author={{Arnold Ventures}},
+  year={2023},
+  note={Grant to PolicyEngine for congressional district-level policy analysis},
+  url={https://www.arnoldventures.org/work/public-finance}
+}
+
+@misc{nsf_pose,
+  title={{POSE}: Phase {I}: {PolicyEngine} -- Advancing Public Policy Analysis},
+  author={{National Science Foundation}},
+  year={2025},
+  note={Award 2518372. PI: Max Ghenis, PSL Foundation. \$299,974},
+  url={https://www.nsf.gov/awardsearch/showAward.jsp?AWD_ID=2518372}
+}
+
+@online{neo_philanthropy,
+  title={{NEO Philanthropy} Awards \$200,000 Grant to {PolicyEngine}},
+  author={Ghenis, Max},
+  year={2024},
+  url={https://policyengine.org/us/research/neo-philanthropy}
+}
+
+@software{claude2026,
+  title={{Claude}},
+  author={{Anthropic}},
+  year={2026},
+  note={Opus 4 model used for code refactoring assistance},
+  url={https://www.anthropic.com/claude}
+}
+
+@misc{nuffield2024grant,
+  title={Enhancing, localising and democratising tax-benefit policy analysis},
+  author={{Nuffield Foundation}},
+  year={2024},
+  note={General Election Analysis and Briefing Fund grant to PolicyEngine},
+  url={https://www.nuffieldfoundation.org/project/enhancing-localising-and-democratising-tax-benefit-policy-analysis}
+}
+@article{koenker1978regression,
+  author  = {Koenker, Roger and Bassett, Gilbert},
+  title   = {Regression Quantiles},
+  journal = {Econometrica},
+  volume  = {46},
+  number  = {1},
+  pages   = {33--50},
+  year    = {1978},
+  doi     = {10.2307/1913643}
+}
+
+@article{meinshausen2006qrf,
+  author  = {Meinshausen, Nicolai},
+  title   = {Quantile Regression Forests},
+  journal = {Journal of Machine Learning Research},
+  volume  = {7},
+  pages   = {983--999},
+  year    = {2006},
+  url     = {https://www.jmlr.org/papers/v7/meinshausen06a.html}
+}
+
+@techreport{bishop1994mdn,
+  author      = {Bishop, Christopher M.},
+  title       = {Mixture Density Networks},
+  institution = {Aston University},
+  year        = {1994},
+  url         = {https://publications.aston.ac.uk/id/eprint/373/}
+}
+
+@article{pedregosa2011scikit,
+  author  = {Pedregosa, Fabian and Varoquaux, Ga{\"e}l and Gramfort, Alexandre and Michel, Vincent and Thirion, Bertrand and Grisel, Olivier and Blondel, Mathieu and Prettenhofer, Peter and Weiss, Ron and Dubourg, Vincent and Vanderplas, Jake and Passos, Alexandre and Cournapeau, David and Brucher, Matthieu and Perrot, Matthieu and Duchesnay, {\'E}douard},
+  title   = {Scikit-learn: Machine Learning in Python},
+  journal = {Journal of Machine Learning Research},
+  volume  = {12},
+  pages   = {2825--2830},
+  year    = {2011},
+  url     = {https://www.jmlr.org/papers/v12/pedregosa11a.html}
+}
+
+@inproceedings{seabold2010statsmodels,
+  author    = {Seabold, Skipper and Perktold, Josef},
+  title     = {statsmodels: Econometric and statistical modeling with Python},
+  booktitle = {Proceedings of the 9th Python in Science Conference},
+  year      = {2010},
+  doi       = {10.25080/Majora-92bf1922-011}
+}
+
+@article{vanbuuren2011mice,
+  author  = {van Buuren, Stef and Groothuis-Oudshoorn, Karin},
+  title   = {mice: Multivariate Imputation by Chained Equations in R},
+  journal = {Journal of Statistical Software},
+  volume  = {45},
+  number  = {3},
+  pages   = {1--67},
+  year    = {2011},
+  doi     = {10.18637/jss.v045.i03}
+}
+
+@manual{dorazio2022statmatch,
+  author = {D'Orazio, Marcello},
+  title  = {StatMatch: Statistical Matching or Data Fusion},
+  year   = {2022},
+  note   = {R package},
+  url    = {https://CRAN.R-project.org/package=StatMatch}
+}
+
+@unpublished{juaristi2026microimpute,
+  author = {Juaristi, Mar\'ia},
+  title  = {microimpute: Benchmarking Cross-Survey Imputation Methods for U.S. Household Wealth},
+  year   = {2026},
+  note   = {Working paper, PolicyEngine},
+  url    = {https://github.com/PolicyEngine/microimpute/blob/main/paper/main.pdf}
+}
+
+@article{policyengine_py,
+  author    = {Ahmadi, Vahid and Ghenis, Max and Woodruff, Nikhil and Makarchuk, Pavel and Volk, Anthony},
+  title     = {policyengine: A Microsimulation Tool for Tax-Benefit Policy Analysis},
+  journal   = {Journal of Open Source Software},
+  publisher = {The Open Journal},
+  volume    = {11},
+  number    = {125},
+  pages     = {11115},
+  year      = {2026},
+  doi       = {10.21105/joss.11115},
+  url       = {https://doi.org/10.21105/joss.11115}
+}