Closed editorialbot closed 8 months 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.1093/nar/gky379 is OK
- 10.3389/fnins.2018.00261 is OK
- 10.3389/fninf.2012.00007 is OK
- 10.1038/nrn3475 is OK
- 10.1111/nyas.13325 is OK
- 10.1016/j.neuron.2017.10.013 is OK
- 10.3389/fninf.2011.00013 is OK
- 10.1093/bioinformatics/bth361 is OK
- 10.1155/2011/156869 is OK
- 10.1126/science.aac4716 is OK
- 10.1016/j.neuroimage.2019.06.046 is OK
- 10.1016/S1053-8119(03)00185-X is OK
- 10.1177/0956797611417632 is OK
- 10.1371/journal.pbio.2000797 is OK
- 10.1017/S0140525X17001972 is OK
MISSING DOIs
- 10.1007/3-211-27183-x_1 may be a valid DOI for title: MATLAB
INVALID DOIs
- None
Software report:
github.com/AlDanial/cloc v 1.88 T=17.42 s (418.7 files/s, 69514.6 lines/s)
---------------------------------------------------------------------------------------
Language files blank comment code
---------------------------------------------------------------------------------------
MATLAB 5647 95785 230136 480408
C 829 33375 46894 162300
C++ 109 6363 6643 25657
C/C++ Header 283 8799 18127 22648
make 115 2891 1412 9397
TeX 19 1676 623 9097
Fortran 77 36 1743 3894 7722
Java 39 1069 1661 5194
HTML 40 598 1060 5020
Bourne Shell 20 961 1044 2710
Windows Module Definition 8 122 0 2437
Arduino Sketch 7 536 904 2303
Markdown 27 499 0 1150
XML 14 18 43 1005
TypeScript 1 0 0 1001
C Shell 29 148 127 784
Expect 6 17 0 783
Ruby 4 0 0 603
Python 4 173 94 532
MSBuild script 2 0 0 455
Mathematica 3 9 0 220
Perl 1 40 81 220
XSLT 1 47 21 217
sed 5 8 0 164
ProGuard 7 50 25 141
CMake 3 58 16 107
Ant 2 16 2 100
Scheme 1 0 0 78
CSS 1 14 2 66
INI 9 6 5 59
Bourne Again Shell 3 8 0 40
DOS Batch 3 11 1 39
reStructuredText 1 18 0 33
awk 6 15 0 29
Qt Project 2 6 0 18
MUMPS 1 4 0 14
YAML 2 0 0 11
Solidity 2 0 0 10
---------------------------------------------------------------------------------------
SUM: 7292 155083 312815 742772
---------------------------------------------------------------------------------------
gitinspector failed to run statistical information for the repository
Wordcount for paper.md
is 1579
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
@matsvanes does not appear to have made any contributions to this code base. Am I looking at this wrong?
You seem to be right! Not sure of the expectations for first authorship, but let me check!
Hi @matsvanes, in response to @gflofst 's comment, do you mind sharing your author's contributions to FieldTrip? Thanks!
@crsl4 Thanks for reaching out. I can see how my contributions are not clear from FieldTrip's github directly. I hope the following clears things up. Unfortunately, much of the work submitted here has somewhat dispersed origins. My contributions were mostly in design, testing, and documentation, and haven't ended up in the main branch of the FieldTrip toolbox directly. See below for a trail of my involvement in the various stages.
Design The toolbox addition was inspired by this early implementation.
Development and testing Mostly through comments on issues and pulls on the FieldTrip Github, for example: #1617, #1362, #1330, #1317, #973
Documentation A trail of developing the tests and documentation is found here, and their implementation on the FieldTrip website here.
@matsvanes JOSS will have to judge if this is sufficient. I don't have adequate guidance except to see if "significant" effort was involved on the submitter's part. If you have any design notes or otherwise that can be added to this thread, that would make it more easily pass the bar. I appreciate tests and documentation rather than just code. I would certainly count those. Similar software is hard to judge attributions without something explicit.
Thank you for the suggestion @gflofst. Of importance would definitely be the two links above under Documentation. In case it's relevant, we also have a pre-print available.
Hi @crsl4 - is there any update on the review progress? Thanks!
Thanks @matsvanes for your message! I am still waiting to hear back from reviewers. The pre-print opens up a new set of questions. Can you explain the overlap? Is that preprint a journal submission?
@crsl4, We have a question as to whether the submission meets the required significant effort bar. In the submitted materials, the author is not in the code repo at all, but was responsible for writing some of the associated papers, provided after the fact. If this is sufficient, I think we need to have the repo updated with links/copies of the additional materials to be able to check that review criteria as satisfied. I am waiting for your guidance on whether what is in the repo is sufficient, if the additional materials existing are sufficient, if the existing materials need to be added/linked in the repo to be sufficient, or if it is insufficient given the lack of code contributions.
@crsl4, I was wondering the same thing about the preprint. Should the review comments be focused only on the material in the JOSS article, or should we also consider the additional preprint?
Thanks for your help.
@ashahide We are supposed to only review the JOSS article, but we should understand what is the gap to the pre-print, and whether the pre-print has significant overlap (bc then, why do we have the JOSS article?).
@gflofst Thanks for your message! I think I want to discuss this with other editors. I am not sure what the standard expectations are compared to other articles. I will reach back, thanks!
Hi @matsvanes , is there a list of the required Matlab toolboxes somewhere that I may be missing? I see that there is an external folder for additional non-Matlab dependencies and that some of the tests check for necessary toolboxes, but I'm unable to find a list in the documentation.
Hi @matsvanes , is there a list of the required Matlab toolboxes somewhere that I may be missing? I see that there is an external folder for additional non-Matlab dependencies and that some of the tests check for necessary toolboxes, but I'm unable to find a list in the documentation.
Hi @ashahide, the list of external toolboxes can be found here. Most of these are supplied alongside FieldTrip (i.e., in /external
), and are added to the path when running ft_defaults
(see here for more info on installation)
@crsl4, We have a question as to whether the submission meets the required significant effort bar. In the submitted materials, the author is not in the code repo at all, but was responsible for writing some of the associated papers, provided after the fact. If this is sufficient, I think we need to have the repo updated with links/copies of the additional materials to be able to check that review criteria as satisfied. I am waiting for your guidance on whether what is in the repo is sufficient, if the additional materials existing are sufficient, if the existing materials need to be added/linked in the repo to be sufficient, or if it is insufficient given the lack of code contributions.
I hope I can clarify these questions with some historic perspective/context. This project was part of my PhD - a time when I unfortunately was rather new to git(hub). Because of this, my FieldTrip branch was messy, and I used the quick route through my collaborators (co-authors on this paper) to get the code on the master branch. As mentioned before, I have also done most of the testing and documentation of the code. Regarding the pre-print: this is essentially one chapter out of my PhD thesis. We were interested in submitting to JOSS because we believe its aims align well with our paper, and we wanted to change the narrative from a tutorial-style opinion/recommendation paper to put the focus on the software implementation itself (and get credit for it). Consequently, after opening a pre-submission enquiry, we adapted the pre-print to the JOSS format, and moved the tutorials to the website documentation: 1, 2, 3.
@matsvanes does not appear to have made any contributions to this code base. Am I looking at this wrong?
Let me as the head of the FieldTrip project and senior author on this submission confirm Mats' comment: Mats did indeed make significant contributions to the conceptual design, the implementation, the testing, and the the documentation (initially in the form of a manuscript that was rejected elsewhere, later also on the website). He fully deserves credit for this as first author.
My own involvement was mainly to supervise the process, to ensure consistency and future maintainability, and to help with the technical aspects of the coding and merging process. Since we are neuroscientists and neither of us are git and GitHub experts, I realize that the representation on github is not as ideal as it could have been. We continue to constantly learn how to make use of version control using git, and also how to pass those skills on to students that are working on concrete projects which involve coding (like this reproducescript
one).
Thanks @robertoostenveld ! I talked with other JOSS editors, and it seems that @matsvanes satisfies the criteria for first authorship.
One thing we need to determine is the existing overlap between the pre-print and the JOSS article. @matsvanes Is the pre-print to be published in another journal? If the pre-print will be published elsewhere, then we need to make sure that there is no overlap with the JOSS manuscript. That is, it is ok to use the software in a dataset for another publication, but not for the JOSS manuscript (or the introduction of the software) to be a subset of the pre-print to be published elsewhere.
@ashahide @gflofst Can you add this as part of your review? Thanks!
We have no intentions to publish the pre-print in another journal. After releasing the pre-print we changed course and decided to focus more on the software for publication. For this reason, we moved most of the content of the pre-print (e.g., the examples) to the FieldTrip Website. If the software were to be published at JOSS, the pre-print would thus become obsolete, just like it would when a pre-print is finally published in a peer-reviewed journal.
Hi @crsl4, Has there been any progress in the review process?
Hi! We are waiting for reviewers to finish their review π.
I've had two bad weeks including technology failure. Hopefully this week I'll be able to get it done.
Best,
Jay
From: Claudia Solis-Lemus @.> Sent: Monday, September 18, 2023 10:36:30 AM To: openjournals/joss-reviews @.> Cc: Lofstead, Jay F @.>; Mention @.> Subject: [EXTERNAL] Re: [openjournals/joss-reviews] [REVIEW]: Reducing the efforts to create reproducible analysis code with FieldTrip (Issue #5566)
Hi! We are waiting for reviewers to finish their review π.
β Reply to this email directly, view it on GitHubhttps://github.com/openjournals/joss-reviews/issues/5566#issuecomment-1723913550, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AAUR4WULPLMAYX725IVQVTLX3B2A5ANCNFSM6AAAAAAZJN6RPQ. You are receiving this because you were mentioned.Message ID: @.***>
Thank you, Jay! No worries! We are experiencing delays on several fronts.
Hi @crsl4, I have completed my review. I think the article meets all of the JOSS criteria, and the work is interesting and addresses an important topic. Let me know if there is anything else I should do on my end. Thanks!
@gflofst thanks again for your help as a reviewer here. Do you think you can pick up the review again at this point? Let us know if you have any updates.
@gflofst :wave:
@crsl4 can you please keep on top of this review and remind the reviewers when needed.
I'm back in. Reviewing now.
I can't find installation instructions.
I also do not have a desktop version of MATLAB so I'm trying the free online version. There are no notes as to whether or not that should work.
Hi Jay,
The installation instructions can be found here: https://www.fieldtriptoolbox.org/download/
In short, after downloading the toolbox, you should add it to your path with addpath <path_to_fieldtrip>
, and then run ft_defaults
, which will setup the rest.
For requirements, see https://www.fieldtriptoolbox.org/faq/requirements/. Depending on the fieldtrip functionality you want to use, you may be required to have (licensed) toolboxes installed.
I'm at SC23 this week. I doubt I'll have time to do this before Saturday.
From: Mats @.> Sent: Thursday, November 9, 2023 7:12 AM To: openjournals/joss-reviews @.> Cc: Lofstead, Jay F @.>; Mention @.> Subject: [EXTERNAL] Re: [openjournals/joss-reviews] [REVIEW]: Reducing the efforts to create reproducible analysis code with FieldTrip (Issue #5566)
Hi Jay,
The installation instructions can be found here: https://www.fieldtriptoolbox.org/download/
In short, after downloadinghttps://www.fieldtriptoolbox.org/download.php the toolbox, you should add it to your path with addpath
For requirements, see https://www.fieldtriptoolbox.org/faq/requirements/. Depending on the fieldtrip functionality you want to use, you may be required to have (licensed) toolboxes installed.
- Reply to this email directly, view it on GitHubhttps://github.com/openjournals/joss-reviews/issues/5566#issuecomment-1803908443, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AAUR4WWYJNBMCOYV2TUBWVLYDTQEHAVCNFSM6AAAAAAZJN6RPSVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTQMBTHEYDQNBUGM. You are receiving this because you were mentioned.Message ID: @.**@.>>
I got a MATLAB license and will be able to test everything. Installing now.
It looks good and technically meets the requirements. I'd prefer if there was more in the github rather than their own website (e.g., installation instructions), but it is all finable without too much effort. I vote to accept.
I'd prefer if there was more in the github rather than their own website (e.g., installation instructions), but it is all finable without too much effort. I vote to accept.
Note that the website itself is also on github (separate from the code), including documentation on reproduce script here, here and here. It is just that the rendering as html on our own server looks better and it makes us independent from github/microsoft as commercial service provider.
Having independent installation instructions in the git repository, i.e., also on github, bitbucket and gitlab, separate from those on the website, is a good idea and simple to implement. I will add that to the README file.
@crsl4 Are there any updates/conclusions following the reviews?
Yes! I feel both reviewers have approved the manuscript and we can move forward. Tagging them in case I missed something: @gflofst @ashahide
So, @Kevin-Mattheus-Moerman , is this the time to do create post-review checklist
? Thanks all for your hard work!
@crsl4 yep, please do create that checklist.
@editorialbot set <DOI here> as archive
@editorialbot set <version here> as version
@editorialbot generate pdf
@editorialbot check references
and ask author(s) to update as needed@editorialbot recommend-accept
Hi @crsl4, what is the status on this?
Hi @matsvanes ! Working on the post-review checklist for editors. You need to go over the ones for authors (see message above).
@editorialbot generate pdf
:point_right::page_facing_up: Download article proof :page_facing_up: View article proof on GitHub :page_facing_up: :point_left:
Submitting author: !--author-handle-->@matsvanes<!--end-author-handle-- (Mats W.J. van Es) Repository: https://github.com/fieldtrip/fieldtrip Branch with paper.md (empty if default branch): JOSS Version: 20231220 Editor: !--editor-->@crsl4<!--end-editor-- Reviewers: @gflofst, @ashahide Archive: 10.5281/zenodo.10495308
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
@gflofst & @ashahide, 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 @crsl4 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 @gflofst
π Checklist for @ashahide