Skip to content

JOSS Submission#122

Draft
JoelLucaAdams wants to merge 26 commits into
mainfrom
joss
Draft

JOSS Submission#122
JoelLucaAdams wants to merge 26 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

@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
On top of it's adoption by researchers at the University of York, Strathclyde University, Queens University Belfast, First Light Fusion and a few government entities, it is also being used in teaching materials for a course on PIC codes delivered to undergraduate students at the University of York. The library was also used as the primary interfacing tool in the EPOCH 2025 and 2026 workshops.
Beyond its foundational deployment at the University of York, `sdf-xarray` has achieved broader institutional adoption, seeing active use by researchers at the University of Strathclyde, Queen's University Belfast, First Light Fusion, and several government entities. In addition to driving primary research, the library serves a distinct educational role; it has been integrated into a course on PIC codes delivered to undergraduate students at the University of York and served as the primary data-interfacing utility for both the 2025 and 2026 international EPOCH user workshops.

By adhering strictly to FAIR (Findable, Accessible, Interoperable, and Reusable) data principles, `sdf-xarray` alongside it's sister BEAM packages, `epyscan` and `epydeck` [@hill:2024b] maintains a transparent, community-driven developement model that encourages external contributions. In recognition of this commitment to open science and its measurable impact on the plasma physics community, the BEAM project was awarded the [2025 University of York Open Research Award in the Postgraduate Researcher (Sciences) category](https://uoy.atlassian.net/wiki/spaces/YorkOpenResearch/pages/995426305/York+Open+Research+Awards+2025#BEAM%3A-Broad-Epoch-Analysis-Modules).

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.

I doubt you can depend on this URL being persistent, so you may have to exclude the link.

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.

4 participants