-
-
Notifications
You must be signed in to change notification settings - Fork 36
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[REVIEW]: DiffeRT2d: A Differentiable Ray Tracing Python Framework for Radio Propagation #6915
Comments
Hello humans, I'm @editorialbot, a robot that can help you with some common editorial tasks. For a list of things I can do to help you, just type:
For example, to regenerate the paper pdf after making changes in the paper's md or bib files, type:
|
Software report:
Commit count by author:
|
|
Paper file info: 📄 Wordcount for ✅ The paper includes a |
License info: ✅ License found: |
@idoby and @roth-jakob - Thanks for agreeing to review this submission. As you can see above, you each should use the command As you go over the submission, please check any items that you feel have been satisfied. There are also links to the JOSS reviewer guidelines. As you both know, the JOSS review is different from most other journals. Our goal is to work with the authors to help them meet our criteria instead of merely passing judgment on the submission. As such, reviewers are encouraged to submit issues and pull requests on the software repository. When doing so, please mention We aim for reviews to be completed within about 2-4 weeks. Please let me know if either of you require some more time. We can also use editorialbot (our bot) to set automatic reminders if you know you'll be away for a known period of time. Please feel free to ping me (@danielskatz) if you have any questions/concerns. |
Review checklist for @idobyConflict of interest
Code of Conduct
General checks
Functionality
Documentation
Software paper
|
Review checklist for @roth-jakobConflict of interest
Code of Conduct
General checks
Functionality
Documentation
Software paper
|
Hey @jeertmans, thanks for submitting your package to JOSS! 📦 A few comments about the paper:
Other than these minor comments, good work! I will take a look at the software itself soon. |
Hi, thanks for your effort in writing the paper! Just a follow-up on the 4. above comment. I fully agree with that. Giving a little bit more explanation for readers not familiar with the subdiscipline could make the paper much more accessible. |
This PR addresses the comments from @idoby, especially from openjournals/joss-reviews#6915 (comment). Ref: openjournals/joss-reviews#6915
Hello @idoby, thanks for your first review comments, which I try to address in jeertmans/DiffeRT2d#69. Let me add a few comments here:
Thanks for catching! I have rephrased those sentences.
I think I have addressed this issue by (1) putting the complete code and (2) rephrasing the caption.
Done.
I hope this is now clearer (I forgot to update that part before submitting, this is my bad). I always hesitate between putting links from Zenodo, GitHub, or else. The motivation to use a link to my website was that, I am more likely to keep my
Looking forward to the software review! :D |
Hello! I have (I think) addressed this comment in jeertmans/DiffeRT2d#69. Can you review it and tell me if it needs more details? |
The issue with the links is that Zenodo etc are meant to be truly permanent in the sense that they are meant to be archived forever. This is why JOSS requests that upon acceptance, you archive your software with one of these services for posterity. The JOSS guidelines do not seem to address the issue of including external links in the paper. @danielskatz what do you think? The same applies to the link you added to https://dial.uclouvain.be/pr/boreal/object/boreal:288635 Other than these points, the paper seems good and my comments have been addressed as far as I'm concerned. |
Personally, I'm ok with content on website being linked to, but I would prefer that an archive.org copy of it was linked, as this is more "permanent" if possible. e.g., rather than referencing https://www.ncsa.illinois.edu, one could reference https://web.archive.org/web/20240620232147/https://www.ncsa.illinois.edu/ for the version as of a few days ago. For the link above, using the hdl (http://hdl.handle.net/2078/288635) would be better than using the direct link, even though it points to the same thing. If https://dial.uclouvain.be is an institutional repository, which I think it is, then this is enough. If not, then doing what @idoby suggests would be good, putting it on a "permanent" archive like Zenodo, arXiv, ... |
Indeed, https://dial.uclouvain.be/ is an institutional repository, and should be a permalink that will always be valid. This is a preliminary work, so not really published, but I transformed the URL-reference to a citation that points to the "preprint", available on our inst. website. For the other internet links, I will convert them later (today or this week) to web archives :-) |
@editorialbot generate pdf |
Thanks for fixing the links and adding the full code for the figure in jeertmans/DiffeRT2d#69. I was able to reproduce the figure. I will have a look at the software in the next few days. |
Looks like the new paper proof did not pick up the changes |
Yes, I forgot to first merge the PR ^^'. I'll fix that soon! |
@editorialbot commands |
Hello @jeertmans, here are the things you can ask me to do:
|
Thanks!
I have reviewed and merge all PRs, thanks for your help!
Good remark, I will wait for the second reviewer (and the editor?) to give their feedback first, then I think I might improve a bit the documentation according to your suggestions. Other than that, I will re-generate a paper with the latest changes. |
@editorialbot generate pdf |
My TODO list:
|
@jeertmans, nice software package! I had a closer look at it. I have only one minor suggestion, along the lines of @idoby's comment. I personally like it if there are a few sentences at the top of the README explaining what the package is doing and for whom it is targeted. All this information is in the paper, and you could consider summarizing it at the top of the README. |
👋 @idoby & @roth-jakob - You both have checked off all your items - but I also see comments about things to do from you and @jeertmans. So I'm a little uncertain about if you think this is done, or if we need to wait for @jeertmans to do some more things. |
@danielskatz Jerome still wants to improve the documentation page, but as far as I'm concerned the review is done and is up to @jeertmans |
At the end of the process, once the review is complete, I will proofread the paper, and perhaps suggest changes, then ask you to make an archival deposit (e.g., in Zenodo) and tell me that DOI and the version associated with it, so you might want to wait on the 2nd and 4th items above until then. |
Yes, for me, it's the same. I proposed to @jeertmans to expand the readme a bit, but otherwise, I'm done with the review. |
@jeertmans - Also, I think we can complete this before you go away on July 2nd if you want, since we are quite close. |
Sure @jeertmans, I will do that in the next few hours :-) |
@danielskatz done, the latest version is v0.3.3 (https://github.com/jeertmans/DiffeRT2d/releases/tag/v0.3.3). I'll update the Zenodo after you have proofread the paper, as you suggested :-) |
My institution's summer picnic is starting soon, but I'll do this after it and some meetings, in the 4-8 hours... |
@editorialbot generate pdf |
@editorialbot check references |
|
@jeertmans - I've suggested some changes in jeertmans/DiffeRT2d#78. Please merge this or let me know what you disagree with. |
Thanks, @danielskatz! It looked great, and I also remove one footnote that was no longer needed (as I now include the full code snippet). |
@editorialbot generate pdf |
Submitting author: @jeertmans (Jérome Eertmans)
Repository: https://github.com/jeertmans/DiffeRT2d
Branch with paper.md (empty if default branch):
Version: v0.3.2
Editor: @danielskatz
Reviewers: @idoby, @roth-jakob
Archive: Pending
Status
Status badge code:
Reviewers and authors:
Please avoid lengthy details of difficulties in the review thread. Instead, please create a new issue in the target repository and link to those issues (especially acceptance-blockers) by leaving comments in the review thread below. (For completists: if the target issue tracker is also on GitHub, linking the review thread in the issue or vice versa will create corresponding breadcrumb trails in the link target.)
Reviewer instructions & questions
@idoby & @roth-jakob, your review will be checklist based. Each of you will have a separate checklist that you should update when carrying out your review.
First of all you need to run this command in a separate comment to create the checklist:
The reviewer guidelines are available here: https://joss.readthedocs.io/en/latest/reviewer_guidelines.html. Any questions/concerns please let @danielskatz know.
✨ Please start on your review when you are able, and be sure to complete your review in the next six weeks, at the very latest ✨
Checklists
📝 Checklist for @idoby
📝 Checklist for @roth-jakob
The text was updated successfully, but these errors were encountered: