[DO NOT MERGE] JOSS Paper Draft

[ranocha]

DO NOT MERGE THIS PR

We can use this PR to check and discuss the paper draft. The PR can be closed when the JOSS paper is finished. The branch paper-2025-joss must be kept around forever.

You can download the PDF of the paper draft from the GitHub action Build JOSS paper draft PDF / JOSS Paper Draft (pull_request) below.

• Click on it
• Go to Summary on the left
• Download the artifact

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.18%. Comparing base (63c826d) to head (fc31c14).
Report is 1 commits behind head on main.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #138   +/-   ##
=======================================
  Coverage   98.18%   98.18%           
=======================================
  Files           7        7           
  Lines        1546     1546           
=======================================
  Hits         1518     1518           
  Misses         28       28           

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

[SKopecz]

I added bibliography information for all the papers that I could think of that describe or analyze the currently implemented schemes. Do we also want to make reference to schemes that could be implemented in the future?

What's the purpose of the section "Related research and software"? Do want to give a general overview or do we want to describe exactly in which paper which implemented method can be found?

[ranocha]

Thanks!

I added bibliography information for all the papers that I could think of that describe or analyze the currently implemented schemes. Do we also want to make reference to schemes that could be implemented in the future?

We should only describe what kind of schemes are implemented - plans may change and we may not implement other methods we could list...

What's the purpose of the section "Related research and software"? Do want to give a general overview or do we want to describe exactly in which paper which implemented method can be found?

This section should contain

• papers where this package and/or the methods implemented here have been used
• other open-source software implementing the same or related methods
• maybe also papers developing the methods implemented in this package

[JoshuaLampert]

Thanks a lot for the draft! I had a brief look and left some comments below.

[coveralls]

Pull Request Test Coverage Report for Build 14623225132

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage remained the same at 97.76%

---

Totals
Change from base Build 14598967342:	0.0%
Covered Lines:	1964
Relevant Lines:	2009

---

💛 - Coveralls

[JoshuaLampert]

I left some final comments below.

[SKopecz]

I added tags and set the date to tomorrow.

@ranocha @JoshuaLampert if you agree with the tags, I will submit tomorrow.

[JoshuaLampert]

Sounds good to me. I have only two final minor comments/suggestions.

[ranocha]

I added tags and set the date to tomorrow.

@ranocha @JoshuaLampert if you agree with the tags, I will submit tomorrow.

Great, thanks a lot! I am fine submitting the paper 👍

[SKopecz]

CI is failing again on macOS inside a work_precision test.

work-precision fixed: Test Failed at /Users/runner/work/PositiveIntegrators.jl/PositiveIntegrators.jl/test/runtests.jl:2594
  Expression: maximum((v .- m1) ./ m1) < 1.5
   Evaluated: 1.8971724926437623 < 1.5

But I don't see why this happens, since the allowed tolerance for macOS should be 10.0 now.

[JoshuaLampert]

I guess we should delete this line:

PositiveIntegrators.jl/test/runtests.jl

Line 2594 in fad4655

@test maximum((v .- m1) ./ m1) < 1.5

because it is doubled in

PositiveIntegrators.jl/test/runtests.jl

Line 2601 in fad4655

@test maximum((v .- m1) ./ m1) < allowed

with the platform dependent tolerance.

[SKopecz]

Thanks!

[SKopecz]

Now building the docs fails.

To github.com:NumericalMathematics/PositiveIntegrators.jl
 ! [rejected]        HEAD -> gh-pages (fetch first)
error: failed to push some refs to 'github.com:NumericalMathematics/PositiveIntegrators.jl'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

[ranocha]

Now building the docs fails.

To github.com:NumericalMathematics/PositiveIntegrators.jl
 ! [rejected]        HEAD -> gh-pages (fetch first)
error: failed to push some refs to 'github.com:NumericalMathematics/PositiveIntegrators.jl'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

Where do you see this error?

It is likely just a race condition from two CI jobs trying to push changes at the same time. We can submit the paper anyway

[JoshuaLampert]

I restarted CI yesterday evening. This error was just spurious.