Closed editorialbot closed 1 month ago
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:
@editorialbot commands
For example, to regenerate the paper pdf after making changes in the paper's md or bib files, type:
@editorialbot generate pdf
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
✅ OK DOIs
- 10.1109/access.2024.3406510 is OK
- 10.3390/sym16020221 is OK
- 10.1109/mic.2021.3065245 is OK
- 10.3289/sw_arches_core_1.0.0 is OK
- 10.1109/MS.2018.2801541 is OK
- 10.1080/00423114.2020.1730917 is OK
- 10.48550/ARXIV.2408.13866 is OK
🟡 SKIP DOIs
- No DOI given, and none found for title: ACM SIGSOFT Empirical Standards on GitHub
- No DOI given, and none found for title: ARCHES PiCar-X
❌ MISSING DOIs
- None
❌ INVALID DOIs
- None
Software report:
github.com/AlDanial/cloc v 1.90 T=0.06 s (2142.0 files/s, 142407.8 lines/s)
--------------------------------------------------------------------------------
Language files blank comment code
--------------------------------------------------------------------------------
Python 31 696 1418 1906
YAML 18 159 7 1743
Markdown 27 338 0 974
XML 26 93 11 597
CMake 9 58 6 175
Dockerfile 7 26 0 82
TeX 1 8 0 82
CSS 1 8 0 46
Gencat NLS 4 3 0 22
HTML 1 3 0 22
JavaScript 1 4 0 16
Bourne Again Shell 2 0 0 7
--------------------------------------------------------------------------------
SUM: 128 1396 1442 5672
--------------------------------------------------------------------------------
Commit count by author:
41 Alexander Barbie
1 AlexanderBarbie
1 Wilhelm Hasselbring
1 abarbie
Paper file info:
📄 Wordcount for paper.md
is 1184
✅ The paper includes a Statement of need
section
License info:
✅ License found: Apache License 2.0
(Valid open source OSI approved license)
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
@mrsonandrade and @AlexanderFabisch - Thanks for agreeing to review this submission. This is the review thread for the paper. All of our communications will happen here from now on.
As you can see above, you each should use the command @editorialbot generate my checklist
to create your review checklist. @editorialbot commands need to be the first thing in a new comment.
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.
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 openjournals/joss-reviews#7179
so that a link is created to this thread (and I can keep an eye on what is happening). Please also feel free to comment and ask questions on this thread. In my experience, it is better to post comments/questions/suggestions as you come across them instead of waiting until you've reviewed the entire package.
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.
JOSS publishes articles about software that represent substantial scholarly effort on the part of the authors. Your software should be a significant contribution to the available open source software that either enables some new research challenges to be addressed or makes addressing research challenges significantly better (e.g., faster, easier, simpler).
The summary could be improved: referring to
This paper presents a digital twin prototype of...
What is a digital twin and why is it useful?
Our goal is to provide researchers and practitioners with an affordable and straightforward example to explore various concepts of digital twins.
What are these concepts of digital twins? In which way can they be explored?
Moreover, this example can be used to explore all the concepts implemented in a previous project named ARCHES (Autonomous Robotic Networks to help Human Societies), which focused on monitoring and operating an underwater network of ocean observation systems
Again, what are these concepts and how are we able to explore these with the picar?
One of the outcomes of this project was the ARCHES Digital Twin Framework
Can you briefly describe what the ARCHES Digital Twin Framework does and why it is needed?
Digital twins are becoming increasingly relevant...
Why are they becoming more relevant? Certainly they are useful in a way, but it is not clear to me.
Industrial Internet of Things and Industry 4.0
I think these terms need references.
@AlexanderBarbie: I have a question regarding this point of the checklist:
Contribution and authorship: Has the submitting author (@AlexanderBarbie) made major contributions to the software? Does the full list of paper authors seem appropriate and complete?
According to the list above, your co-author Wilhelm Hasselbring only made one commit to the repositoy
41 Alexander Barbie 1 AlexanderBarbie 1 Wilhelm Hasselbring 1 abarbie
I think this would hardly qualify as an appropriate contribution to claim co-authorship. However, comparing the amount of code and number of commits, I assume that you developed the project internally and pushed it to github without the whole commit history. Can you confirm this? Or did your co-author contribute a significant part to the software project (maybe in any other form)?
@AlexanderFabisch - please keep in mind that JOSS is looking for authors to have contributed to the project, which can happen in many ways outside of commits to a repo, though your question is certainly an appropriate one.
@AlexanderFabisch - please keep in mind that JOSS is looking for authors to have contributed to the project, which can happen in many ways outside of commits to a repo, though your question is certainly an appropriate one.
Thanks for pointing this out. I rephrased my question.
@AlexanderBarbie: I have a question regarding this point of the checklist:
Contribution and authorship: Has the submitting author (@AlexanderBarbie) made major contributions to the software? Does the full list of paper authors seem appropriate and complete?
According to the list above, your co-author Wilhelm Hasselbring only made one commit to the repositoy
41 Alexander Barbie 1 AlexanderBarbie 1 Wilhelm Hasselbring 1 abarbie
I think this would hardly qualify as an appropriate contribution to claim co-authorship. However, comparing the amount of code and number of commits, I assume that you developed the project internally and pushed it to github without the whole commit history. Can you confirm this? Or did your co-author contribute a significant part to the ~software~ project (maybe in any other form)?
@whasselbring and I have been conducting research together for six years on how digital twins, particularly digital twin prototypes, can be developed and applied in robotics. After proving the concept that DTPs work, we collaboratively developed a formal specification of our digital twin concept.
PoC: Barbie, A., Pech, N., Hasselbring, W., Flögel, S., Wenzhöfer, F., Walter, M., … & Sommer, S. (2021). Developing an underwater network of ocean observation systems with digital twin prototypes—a field report from the baltic sea. IEEE Internet Computing, 26(3), 33-42. https://doi.org/10.1109/mic.2021.3065245
Formalization: Barbie, A., & Hasselbring, W. (2024). From Digital Twins to Digital Twin Prototypes: Concepts, Formalization, and Applications. IEEE Access. https://doi.org/10.1109/access.2024.3406510
It was his idea to create a low-cost lab experiment to easily demonstrate the results and allow the replication of experiments for other researchers. The PiCar-X emerged from this idea and is used in another publication to illustrate the formal specification with practical examples:
PiCar-X Applied: Barbie, A., & Hasselbring, W. (2024). Toward Reproducibility of Digital Twin Research: Exemplified with the PiCar-X. arXiv preprint arXiv:2408.13866. https://doi.org/10.48550/ARXIV.2408.13866
While his direct contribution to the source code may not be extensive, his work is an integral part of the overall concept, and without it, this submission would not have been realized.
While his direct contribution to the source code may not be extensive, his work is an integral part of the overall concept, and without it, this submission would not have been realized.
OK, thanks for clarification.
I'll summarize the current state of my review here.
The summary could be improved: referring to
This paper presents a digital twin prototype of...
What is a digital twin and why is it useful?
Our goal is to provide researchers and practitioners with an affordable and straightforward example to explore various concepts of digital twins.
What are these concepts of digital twins? In which way can they be explored?
Moreover, this example can be used to explore all the concepts implemented in a previous project named ARCHES (Autonomous Robotic Networks to help Human Societies), which focused on monitoring and operating an underwater network of ocean observation systems
Again, what are these concepts and how are we able to explore these with the picar?
One of the outcomes of this project was the ARCHES Digital Twin Framework
Can you briefly describe what the ARCHES Digital Twin Framework does and why it is needed?
Digital twins are becoming increasingly relevant...
Why are they becoming more relevant? Certainly they are useful in a way, but it is not clear to me.
Industrial Internet of Things and Industry 4.0
I think these terms need references.
Hi All - it looks like things are moving along on this, which is good.
@AlexanderBarbie - are you working on the comments above (https://github.com/openjournals/joss-reviews/issues/7179#issuecomment-2343629103)?
@AlexanderBarbie - Can you update us on where things are? (I know there are lots of issues, but perhaps you can summarize this here?)
@AlexanderBarbie - Can you update us on where things are? (I know there are lots of issues, but perhaps you can summarize this here?)
I'm sorry, I did not see your last comment.
I opened two issues to work on the comments of @AlexanderFabisch.
The first one to revise the paper, which I did today. In short: I tried to be more specific and what the PiCar-X can be used for. Since there is already a publication with regards to the formalization of the used digital twin concept and also a preprint which describes in more detail how the different concepts (digital mode, shadow, twin, etc.) could be implemented with the PiCar-X, I opened as second Issue.
The second issue was to enhance the documentation. Here I briefly introduced the different concept with small examples and added a view figures. Furthermore I added a description of the key features of the ARCHES Digital Twin Framework, which is used by the PiCar-X to exchange data/commands between physical and digital twin. This issue also affects the issue opened by @mrsonandrade. He found a bug which I (hopefully) solved, but I am waiting whether it is working for him now. I will make a few small changes to the documentation over the weekend, but overall, I think it's pretty much finished, if there are no new comments/suggestions.
@editorialbot check references
@editorialbot generate pdf
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
✅ OK DOIs
- 10.1109/access.2024.3406510 is OK
- 10.3390/sym16020221 is OK
- 10.1109/mic.2021.3065245 is OK
- 10.3289/sw_arches_core_1.0.0 is OK
- 10.1109/MS.2018.2801541 is OK
- 10.1080/00423114.2020.1730917 is OK
- 10.48550/ARXIV.2408.13866 is OK
- 10.1016/j.ifacol.2018.08.474 is OK
🟡 SKIP DOIs
- No DOI given, and none found for title: ACM SIGSOFT Empirical Standards on GitHub
- No DOI given, and none found for title: ARCHES PiCar-X
❌ MISSING DOIs
- None
❌ INVALID DOIs
- None
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
👋 @mrsonandrade, @AlexanderFabisch - Can you see how this now seems, and what else, if anything, is needed for the work to be published?
I checked all the points in my list. Everything looks really good from my perspective. The documentation is much more detailed and useful now. The paper is easier to read.
@danielskatz I fixed some typos in the paper
@editorialbot generate pdf
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
looks good from my end.
If future changes are needed, you can run this command too...
I’m almost done with all the points on my list. My last point concerns the State of the field, which should be in the paper. Thus, are there other related packages? If yes, please, compare them. If not, I think it is valid to clarify this in the paper.
@editorialbot generate pdf
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
@editorialbot check references
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
✅ OK DOIs
- 10.1109/access.2024.3406510 is OK
- 10.3390/sym16020221 is OK
- 10.1109/mic.2021.3065245 is OK
- 10.3289/sw_arches_core_1.0.0 is OK
- 10.1109/MS.2018.2801541 is OK
- 10.1080/00423114.2020.1730917 is OK
- 10.48550/ARXIV.2408.13866 is OK
- 10.1016/j.ifacol.2018.08.474 is OK
- 10.1145/3264888.3264892 is OK
- 10.1109/tdsc.2023.3236798 is OK
- 10.1109/tii.2023.3264101 is OK
🟡 SKIP DOIs
- No DOI given, and none found for title: ACM SIGSOFT Empirical Standards on GitHub
- No DOI given, and none found for title: ARCHES PiCar-X
❌ MISSING DOIs
- None
❌ INVALID DOIs
- None
@danielskatz - I have checked all required points and all my issues were addressed, thus, from my side, I can recommend publication.
thanks @mrsonandrade and @AlexanderFabisch.
@AlexanderBarbie - I'll next proofread the paper and let you know what happens after that.
@AlexanderBarbie - I'm suggesting a bunch of small changes in https://github.com/cau-se/ARCHES-PiCar-X/pull/12 - please merge this, or let me know what you disagree with, then we can continue to acceptance and publication
@editorialbot generate pdf
@AlexanderBarbie - please check this PDF to make sure it looks ok, and assuming so, please
I can then move forward with accepting the submission.
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
The paper looks fine.
I will upload the repository later this evening.
Sooo... I fixed some bugs and uploaded the released version now. I think it is under review status on zenodo but there was a DOI generated already.
version: v.1.1.1 doi: 10.5281/zenodo.13937454
@editorialbot set v.1.1.1 as version
Done! version is now v.1.1.1
@editorialbot set 10.5281/zenodo.13937454 as archive
Done! archive is now 10.5281/zenodo.13937454
Thanks @AlexanderBarbie - this looks fine.
@editorialbot recommend-accept
Attempting dry run of processing paper acceptance...
Reference check summary (note 'MISSING' DOIs are suggestions that need verification):
✅ OK DOIs
- 10.1109/access.2024.3406510 is OK
- 10.3390/sym16020221 is OK
- 10.1109/mic.2021.3065245 is OK
- 10.3289/sw_arches_core_1.0.0 is OK
- 10.1109/MS.2018.2801541 is OK
- 10.1080/00423114.2020.1730917 is OK
- 10.48550/ARXIV.2408.13866 is OK
- 10.1016/j.ifacol.2018.08.474 is OK
- 10.1145/3264888.3264892 is OK
- 10.1109/tdsc.2023.3236798 is OK
- 10.1109/tii.2023.3264101 is OK
🟡 SKIP DOIs
- No DOI given, and none found for title: ACM SIGSOFT Empirical Standards on GitHub
- No DOI given, and none found for title: ARCHES PiCar-X
❌ MISSING DOIs
- None
❌ INVALID DOIs
- None
Submitting author: !--author-handle-->@AlexanderBarbie<!--end-author-handle-- (Alexander Barbie) Repository: https://github.com/cau-se/ARCHES-PiCar-X Branch with paper.md (empty if default branch): Version: v.1.1.1 Editor: !--editor-->@danielskatz<!--end-editor-- Reviewers: @mrsonandrade, @AlexanderFabisch Archive: 10.5281/zenodo.13937454
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
@mrsonandrade & @AlexanderFabisch, 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 @AlexanderFabisch
📝 Checklist for @mrsonandrade