Submitting author: @ashleefv (Ashlee N. Ford Versypt)
Repository: https://github.com/SMRuggiero/sbmltoodepy
Version: v1.0.3
Editor: @mgymrek
Reviewer: @SirSharpest, @marouenbg
Archive: 10.5281/zenodo.3441677
Status badge code:
HTML: <a href="https://joss.theoj.org/papers/7180dfddc52a8b3bbf13b58eaa0e6d45"><img src="https://joss.theoj.org/papers/7180dfddc52a8b3bbf13b58eaa0e6d45/status.svg"></a>
Markdown: [](https://joss.theoj.org/papers/7180dfddc52a8b3bbf13b58eaa0e6d45)
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.)
@SirSharpest & @marouenbg, please carry out your review in this issue by updating the checklist below. If you cannot edit the checklist please:
The reviewer guidelines are available here: https://joss.readthedocs.io/en/latest/reviewer_guidelines.html. Any questions/concerns please let @mgymrek know.
โจ Please try and complete your review in the next two weeks โจ
paper.md file include a list of authors with their affiliations?paper.md file include a list of authors with their affiliations?Hello human, I'm @whedon, a robot that can help you with some common editorial tasks. @SirSharpest, @marouenbg it looks like you're currently assigned to review this paper :tada:.
:star: Important :star:
If you haven't already, you should seriously consider unsubscribing from GitHub notifications for this (https://github.com/openjournals/joss-reviews) repository. As a reviewer, you're probably currently watching this repository which means for GitHub's default behaviour you will receive notifications (emails) for all reviews ๐ฟ
To fix this do the following two things:


For a list of things I can do to help you, just type:
@whedon commands
For example, to regenerate the paper pdf after making changes in the paper's md or bib files, type:
@whedon generate pdf
Attempting PDF compilation. Reticulating splines etc...
@ashleefv I have made my comments as a new issue on the relevant github page: https://github.com/SMRuggiero/sbmltoodepy/issues/1
Most are minor, and possibly non-issues. Though, I feel that the clarifications I mentioned for the manuscript would be important to readers. As would being explicit in which python versions are supported. Finally, I feel strongly about unit-testing being done to software engineering standards, but I understand that this has at least been addressed using their own method.
@mgymrek if there is anything else, prior to author response, please let me know and I'll promptly proceed with.
Thanks @SirSharpest and @marouenbg. These comments look reasonable.
@ashleefv please review the comments from the reviewers and post responses to their comments here.
Alright. We've been posting responses on the github repository issues. We'll also consolidate them and post here when they are completed (should be later this week).
Ashlee N. Ford Versypt, Ph.D.
Assistant Professor, School of Chemical Engineering, Oklahoma State University
Member, Harold Hamm Diabetes Center, University of Oklahoma Health Sciences Center
420 Engineering North, OSU, Stillwater, OK 74078
Ph: 405-744-5280
[email protected]ashleefv@okstate.edu
Ford Versypt Lab Websitehttps://sites.google.com/site/ashleefordversypt/
On Sun, Sep 1, 2019 at 11:54 AM Melissa Gymrek <[email protected]notifications@github.com> wrote:
External Email - Please verify sender email address before responding.
External Email - Please verify sender email address before responding.
Thanks @SirSharpesthttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FSirSharpest&data=02%7C01%7Cashleefv%40okstate.edu%7Cc7fd0a4b6fb84a59701908d72efd0de6%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637029536707290708&sdata=mcuLcFShtmQe9IqbVrfs3saXZ5xxpb0OZVExFAfQ%2Bv4%3D&reserved=0 and @marouenbghttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fmarouenbg&data=02%7C01%7Cashleefv%40okstate.edu%7Cc7fd0a4b6fb84a59701908d72efd0de6%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637029536707300702&sdata=AyYQFRGIJ4oLeGFKnuijIvRxdXvertrCNIpalEHLyXk%3D&reserved=0. These comments look reasonable.
@ashleefvhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fashleefv&data=02%7C01%7Cashleefv%40okstate.edu%7Cc7fd0a4b6fb84a59701908d72efd0de6%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637029536707300702&sdata=XwbE8raSs%2B0iDcPygTQohMyMHQCU%2BPZEMJxKnZbI5%2Fk%3D&reserved=0 please review the comments from the reviewers and post responses to their comments here.
โ
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHubhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fopenjournals%2Fjoss-reviews%2Fissues%2F1643%3Femail_source%3Dnotifications%26email_token%3DADAP4NREQNQWOHMSUMUW2DLQHPXTHA5CNFSM4ILEJWS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD5UGOVQ%23issuecomment-526935894&data=02%7C01%7Cashleefv%40okstate.edu%7Cc7fd0a4b6fb84a59701908d72efd0de6%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637029536707300702&sdata=a5991GU%2F6iO2G6QbPkLewnSze%2BcT9c4h0tTLi5969YY%3D&reserved=0, or mute the threadhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FADAP4NVYHSACPQKVDARNOLLQHPXTHANCNFSM4ILEJWSQ&data=02%7C01%7Cashleefv%40okstate.edu%7Cc7fd0a4b6fb84a59701908d72efd0de6%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637029536707310696&sdata=DEyq9QQTRvTruoJ6w713nb3eK3yCCPHdk7IkKQyUXFg%3D&reserved=0.
We now specify that the supported versions of python are 3.5, 3.6, and 3.7.
Added comment to README.md about installing from source.
PyTest could be a good fit for our project, but we expect to include if we have a major update in the future.
We now specify that the supported versions of python are 3.5, 3.6, and 3.7.
Removed all of the "import *" statements. While the updated code on this github repo has been updated, we plan on updating the package on PyPI once all reviewer comments have been addressed.
We addressed the comments by
We do not see the scope of the project for others' to make pull requests or suggest features.
In our paper, we compare our work to two other pieces of software.
COPASI- The comparison was intended simply to validate the results of the models generated by SBMLtoODEpy. COPASI uses ODEPACK for its Time Course calculations, which is the same library that scipy's odeint function uses. If the calculations agree, then that suggests SBMLtoODEpy has generated the correct equations. Furthermore, the targeted niche for SBMLtoODEpy is not the same as COPASI.
Systems Biology Format Converter (SBFC)- SBFC is a better software to compare SBMLtoODEpy to. SBFC converts SBML models into various programming and modeling languages, but notably excludes Python. This gap SBFC's functionality is specifically the target niche of SBMLtoODEpy. Additionally, SBMLtoODEpy is designed to generate code that can be incorporated into other python projects. The Octave/MATLAB scripts generated by SBFC implement the model that neither accept arguments nor return any values. SBMLtoODEpy generates code that implements the model as a class with most methods and members intended to be accessible to other code.
The paper has been updated to better convey the scope and intent of the comparisons.
Since we expect users to take and modify or use the code generated by SBMLtoODEpy in ways we can't predict, the burden of applying SED-ML or KiSAO will have to be on the user. Additionally most SBML components are stored as entries in dictionaries that are members of the class implementing the model. Currently rules and initial assignments are not implemented this way and annotations stored in the SBML model are not retained. We plan to address these in a future update.
We updated the paper to expand on the comparison to COPASI. My comment to reviewer #1 addresses the comparison to COPASI and Systems Biology Format Converter in more depth.
We looked into the suggestion and are currently not interested in using Travis-CI. Travis-CI does not play well with PyPI accounts with non-alphanumeric characters in its password. Additionally, any updates to SBMLtoODEpy will change the code generated by it and may require different interfacing with user code. Because of this, we want only want a new version of our code pushed when we are absolutely certain its ready for public use. Building and pushing a new version of our code to PyPI is already a simple process with setuptools and twine.
We did set up a code ocean capsule and tested our code on Ubuntu 16.04 and 18.04. We're not planning on publishing the capsule as we do not believe it to be a good fit to publish this project on code ocean. However, we are glad the reviewer provided this suggestion because it may be a good fit for some of our other projects that involve simulation experiments.
We have added in both the readme and tutorial to our documentation page. While we see the value in a troubleshooting section of the documentation, we think we need user feedback before creating it. We plan on adding a changelog section to the documentation as part of finishing addressing reviewer feedback, if future edits are made.
@whedon generate pdf
Attempting PDF compilation. Reticulating splines etc...
@whedon generate pdf
Attempting PDF compilation. Reticulating splines etc...
Approved the new article proof. We have concluded our responses to the reviewers' comments.
Thanks @ashleefv for addressing these comments.
@SirSharpest, @marouenbg, could you review these edits and update the checklists above accordingly?
Also, I noticed you mentioned you mentioned for community guidelines that you do not envision contributions from others to the project. However this is an important aspect of open source projects. Even if you do not envision new features, it's possible a user could find a bug and want to contribute a fix for example. To address this point you could simply add a blurb to the readme suggesting users to contact you or submit a pull request if they would like to contribute a change.
That's a good suggestion. I've edited the readme accordingly.
Ashlee N. Ford Versypt, Ph.D.
Assistant Professor, School of Chemical Engineering, Oklahoma State University
Member, Harold Hamm Diabetes Center, University of Oklahoma Health Sciences Center
420 Engineering North, OSU, Stillwater, OK 74078
Ph: 405-744-5280
[email protected]ashleefv@okstate.edu
Ford Versypt Lab Websitehttps://sites.google.com/site/ashleefordversypt/
On Sun, Sep 8, 2019 at 4:30 PM Melissa Gymrek <[email protected]notifications@github.com> wrote:
External Email - Please verify sender email address before responding.
External Email - Please verify sender email address before responding.
Thanks @ashleefvhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fashleefv&data=02%7C01%7Cashleefv%40okstate.edu%7Cbc27e1764ae0415dd45808d734a3b08e%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637035749976906292&sdata=CfgqLiIMgCsH%2Bhha9SYWtvmk7yBsrqitMt5Ae1%2Fr%2BRo%3D&reserved=0 for addressing these comments.
@SirSharpesthttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FSirSharpest&data=02%7C01%7Cashleefv%40okstate.edu%7Cbc27e1764ae0415dd45808d734a3b08e%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637035749976916285&sdata=Wzy25mE3zPIRxyTw1Ni7WnRhG6c44K85YVrcqLq%2By2Q%3D&reserved=0, @marouenbghttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fmarouenbg&data=02%7C01%7Cashleefv%40okstate.edu%7Cbc27e1764ae0415dd45808d734a3b08e%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637035749976916285&sdata=l%2FiMTA4VSwQYRnKk2q2n71FcGaa1Cy8fGhyv8ES2Eg4%3D&reserved=0, could you review these edits and update the checklists above accordingly?
Also, I noticed you mentioned you mentioned for community guidelines that you do not envision contributions from others to the project. However this is an important aspect of open source projects. Even if you do not envision new features, it's possible a user could find a bug and want to contribute a fix for example. To address this point you could simply add a blurb to the readme suggesting users to contact you or submit a pull request if they would like to contribute a change.
โ
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHubhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fopenjournals%2Fjoss-reviews%2Fissues%2F1643%3Femail_source%3Dnotifications%26email_token%3DADAP4NRBMY35QFOFU4OA23LQIVVEDA5CNFSM4ILEJWS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD6FZ2PA%23issuecomment-529243452&data=02%7C01%7Cashleefv%40okstate.edu%7Cbc27e1764ae0415dd45808d734a3b08e%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637035749976926282&sdata=TLuwxjAxBooKcxh8p4aI3ow9s6vqpRQkbWdAYLDlkxs%3D&reserved=0, or mute the threadhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FADAP4NXPTK24LJZVQIFVO7LQIVVEDANCNFSM4ILEJWSQ&data=02%7C01%7Cashleefv%40okstate.edu%7Cbc27e1764ae0415dd45808d734a3b08e%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C0%7C637035749976926282&sdata=uyXaMjEc%2FSv1tXeRUZlSwZcc0QDRE2RonfPRyx1VIeI%3D&reserved=0.
I just checked all the boxes on my side. The authors did address the comments either through new commits and/or provided reasonable explanations for sticking to their initial choices. Great job!
Perfect, thanks @marouenbg and @SirSharpest for the reviews!
@whedon generate pdf
Attempting PDF compilation. Reticulating splines etc...
I approve of the proof.
Ashlee N. Ford Versypt, Ph.D.
Assistant Professor, School of Chemical Engineering, Oklahoma State University
Member, Harold Hamm Diabetes Center, University of Oklahoma Health Sciences Center
420 Engineering North, OSU, Stillwater, OK 74078
Ph: 405-744-5280
[email protected]ashleefv@okstate.edu
Ford Versypt Lab Websitehttps://sites.google.com/site/ashleefordversypt/
On Tue, Sep 10, 2019 at 10:44 AM whedon <[email protected]notifications@github.com> wrote:
External Email - Please verify sender email address before responding.
External Email - Please verify sender email address before responding.
โ
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHubhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fopenjournals%2Fjoss-reviews%2Fissues%2F1643%3Femail_source%3Dnotifications%26email_token%3DADAP4NWYWSDR6UD26AIQ3N3QI66E3A5CNFSM4ILEJWS2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD6LSC2Y%23issuecomment-529998187&data=02%7C01%7Cashleefv%40okstate.edu%7C1a9134394c574cfb828d08d73605c065%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C1%7C637037270637206273&sdata=nGahIuNqxUm7mh%2B4eO1RARSd%2Fc%2BsStLTrWOmyJTq1GI%3D&reserved=0, or mute the threadhttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FADAP4NW77NDX7QY2VI3MZR3QI66E3ANCNFSM4ILEJWSQ&data=02%7C01%7Cashleefv%40okstate.edu%7C1a9134394c574cfb828d08d73605c065%7C2a69c91de8494e34a230cdf8b27e1964%7C0%7C1%7C637037270637216266&sdata=t26vgqAyIovN4SgFeymtOa69dlpWRCIp0pREYzKZgw0%3D&reserved=0.
@mgymrek What is the next step?
@whedon check references
Attempting to check references...
```Reference check summary:
OK DOIs
MISSING DOIs
INVALID DOIs
@ashleefv We are almost there, just a couple more steps. I have gone over the proof and have the following minor comments:
After fixing these, please make a Zenodo archive, ensuring the title + author list match that in the paper and that the version number is correct.
The Hindmarsh paper was published in an edited book before doi's were available, and it doesn't seem to be available now. The author has a pdf available on his Lawrence Livermore National Laboratory website. Would this suffice? https://computing.llnl.gov/casc/nsde/pubs/u88007.pdf
Hi @ashleefv sorry for the delayed response, yes that is fine. You can now proceed with making the Zenodo archive. Thanks!
@whedon generate pdf
Attempting PDF compilation. Reticulating splines etc...
@whedon check references
Attempting to check references...
```Reference check summary:
OK DOIs
MISSING DOIs
INVALID DOIs
@mgymrek We have updated the Hindmarsh url, fixed the noted typo, finalized the revised pypi release, and created a new zenodo doi for this updated release: https://zenodo.org/record/3441677#.XYLMoyhKjZs
@whedon set v1.0.3 as version
OK. v1.0.3 is the version.
@whedon set 10.5281/zenodo.3441677 as archive
OK. 10.5281/zenodo.3441677 is the archive.
@openjournals/joss-eics We are ready to accept this submission!
@whedon accept
Attempting dry run of processing paper acceptance...
Check final proof :point_right: https://github.com/openjournals/joss-papers/pull/974
If the paper PDF and Crossref deposit XML look good in https://github.com/openjournals/joss-papers/pull/974, then you can now move forward with accepting the submission by compiling again with the flag deposit=true e.g.
@whedon accept deposit=true
@whedon accept deposit=true
Doing it live! Attempting automated processing of paper acceptance...
๐ฆ๐ฆ๐ฆ ๐ Tweet for this paper ๐ ๐ฆ๐ฆ๐ฆ
๐จ๐จ๐จ THIS IS NOT A DRILL, YOU HAVE JUST ACCEPTED A PAPER INTO JOSS! ๐จ๐จ๐จ
Here's what you must now do:
Party like you just published a paper! ๐๐๐ฆ๐๐ป๐ค
Any issues? notify your editorial technical team...
Woohoo!! Congrats @ashleefv on your publication and thank you to reviewers @SirSharpest and @marouenbg!!
:tada::tada::tada: Congratulations on your paper acceptance! :tada::tada::tada:
If you would like to include a link to your paper from your README use the following code snippets:
Markdown:
[](https://doi.org/10.21105/joss.01643)
HTML:
<a style="border-width:0" href="https://doi.org/10.21105/joss.01643">
<img src="https://joss.theoj.org/papers/10.21105/joss.01643/status.svg" alt="DOI badge" >
</a>
reStructuredText:
.. image:: https://joss.theoj.org/papers/10.21105/joss.01643/status.svg
:target: https://doi.org/10.21105/joss.01643
This is how it will look in your documentation:
We need your help!
Journal of Open Source Software is a community-run journal and relies upon volunteer effort. If you'd like to support us please consider doing either one (or both) of the the following:
I recently got the feedback that our acronym in the first word of the title reversed the B & M. It should be SBMLtoODEpy. Additionally this accidental reversal of the letters appeared one other time int he document. Can this be corrected?
@mgymrek We aren't sure if our title issue and internal typo can be updated. We accidentally switched the letters B&M in the title of our paper and in one other place (I'm fine if that internal typo is not corrected, but the title would be best to fix.). I never caught the error because it blended together for me visually. Someone just commented on our github repository pointing out the issue.
@ashleefv - please make the necessary changes to your paper.md file and let me know when you've done this. I can then update the paper.
@arfon I have updated paper.md in the repository: https://github.com/SMRuggiero/sbmltoodepy
@ashleefv - this was fixed in https://github.com/openjournals/joss-papers/commit/5f08ae368b4f81d8c7783bd4be821829cb0a3335 although the paper might take a few hours to show as updated on the JOSS website as there's caching in place.