Skip to content

JOSS Submission#122

Draft
JoelLucaAdams wants to merge 35 commits into
mainfrom
joss
Draft

JOSS Submission#122
JoelLucaAdams wants to merge 35 commits into
mainfrom
joss

Conversation

@JoelLucaAdams

@JoelLucaAdams JoelLucaAdams commented Jun 12, 2026

Copy link
Copy Markdown
Collaborator

I think it's high time we publish a paper on sdf-xarray in JOSS as it's currently in a good state. Please can everyone tagged here read through the paper. It would be nice to have a polished draft complete within the next few weeks so that we can submit a draft to JOSS before EPS-PP 2026!

For those unfamiliar this is quite different to the traditional physics journal publication route. Please read this section of their documentation to understand the section titles and the expected format. The paper is meant to be on the shorter side and be complimentary to the existing documentation.

Document format

This document is written using a flavour of Markdown provided by JOSS, please see their documentation for details.

Authorship

I have added anyone who has contributed to the project using the GitHub contributors statistics. If you think I've missed someone please let me know. If you would prefer to have your name retracted from the paper please also let me know.

With that being said, I have added the following authors to the paper in the following order:

I have attempted to get all of your Orcid's correct, please do check them!

Citations

This is the first paper I have written so I might have not got the citations completely right, especially when it comes to citing software projects where there is no clear CITATION.cff or bibtex entry. Any suggestions here would be appreciated.

Building the paper

I have not managed to build the PDF locally (might be an M-series MacOS thing) but feel free to try yourself.

Everytime a new change to paper.md is pushed to GitHub, the GitHub action gets triggered. You can view the compiled PDF by clicking on the latest commit that's worked, then the "paper draft", then click on the "upload" section in the main window and click on the link at the end which should download a .zip file with the pdf.

Comment thread joss/paper.md
JoelLucaAdams and others added 2 commits June 12, 2026 16:24
Co-authored-by: Liam Pattinson <LiamPattinson@users.noreply.github.com>
Co-authored-by: ShaunD137 <shaun.doherty@york.ac.uk>

@ZedThree ZedThree left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some other things that I didn't see that are worth mentioning or making explicit:

  • sdf-xarray is a wrapper over SDF-C, just like sdf_helper
  • this means we also have compiled components
  • we use a modern Python backend (scikit-build-core) to simplify the building process, even for local builds
  • we distribute pre-built binaries, built using cibuildwheel to build on multiple platforms

Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
@JoelLucaAdams

Copy link
Copy Markdown
Collaborator Author

@ZedThree Thanks for the useful feedback! I have updated the paper to also include the bullet points you've mentioned in the State of Field section.

Comment thread joss/paper.md Outdated

@LiamPattinson LiamPattinson left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking really good! I only have a few style comments and a couple potential missing references.

Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
JoelLucaAdams and others added 3 commits June 22, 2026 13:40
Co-authored-by: Liam Pattinson <LiamPattinson@users.noreply.github.com>
Co-authored-by: LiamPattinson <liam.pattinson@york.ac.uk>
@JoelLucaAdams

Copy link
Copy Markdown
Collaborator Author

@LiamPattinson I have tightened the flow of the Loading SDF files section. Thoughts?

@LiamPattinson LiamPattinson left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This whole section looks much better to me! Just a few typos etc.

Comment thread joss/paper.md Outdated
Co-authored-by: Liam Pattinson <LiamPattinson@users.noreply.github.com>

@Dartrisen Dartrisen left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@LawrenceDior LawrenceDior left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All looks good to me. I've suggested a few tiny changes -- mostly adding/removing apostrophes, and one slight rewording of a bit of text.

Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Comment thread joss/paper.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants