Peer Review History
| Original SubmissionJuly 29, 2024 |
|---|
|
PONE-D-24-31812calibmsm: An R package for calibration plots of the transition 4 probabilities in a multistate modelPLOS ONE Dear Dr. Pate, Thank you for submitting your manuscript to PLOS ONE. After careful consideration, we feel that it has merit but does not fully meet PLOS ONE’s publication criteria as it currently stands. Therefore, we invite you to submit a revised version of the manuscript that addresses the points raised during the review process. ============================== Authors need to address all points raised by the reviewers as attached. Additionally, the following points need to address. Major Points:
Minor Points:
============================== Please submit your revised manuscript by Nov 13 2024 11:59PM. If you will need more time than this to complete your revisions, please reply to this message or contact the journal office at plosone@plos.org . When you're ready to submit your revision, log on to https://www.editorialmanager.com/pone/ and select the 'Submissions Needing Revision' folder to locate your manuscript file. Please include the following items when submitting your revised manuscript:
If you would like to make changes to your financial disclosure, please include your updated statement in your cover letter. Guidelines for resubmitting your figure files are available below the reviewer comments at the end of this letter. If applicable, we recommend that you deposit your laboratory protocols in protocols.io to enhance the reproducibility of your results. Protocols.io assigns your protocol its own identifier (DOI) so that it can be cited independently in the future. For instructions see: https://journals.plos.org/plosone/s/submission-guidelines#loc-laboratory-protocols . Additionally, PLOS ONE offers an option for publishing peer-reviewed Lab Protocol articles, which describe protocols hosted on protocols.io. Read more information on sharing protocols at https://plos.org/protocols?utm_medium=editorial-email&utm_source=authorletters&utm_campaign=protocols . We look forward to receiving your revised manuscript. Kind regards, Md Hasinur Rahaman Khan, Ph.D. Academic Editor PLOS ONE Journal requirements: When submitting your revision, we need you to address these additional requirements. 1. Please ensure that your manuscript meets PLOS ONE's style requirements, including those for file naming. The PLOS ONE style templates can be found at https://journals.plos.org/plosone/s/file?id=wjVg/PLOSOne_formatting_sample_main_body.pdf and 2. Thank you for stating the following financial disclosure: “This work was supported by funding from the MRC-NIHR Methodology Research Programme [grant number: MR/T025085/1].” Please state what role the funders took in the study. If the funders had no role, please state: "The funders had no role in study design, data collection and analysis, decision to publish, or preparation of the manuscript." If this statement is not correct you must amend it as needed. Please include this amended Role of Funder statement in your cover letter; we will change the online submission form on your behalf. Additional Editor Comments: Authors need to address the points as raised by the two reviewers and given in the attachments. Additionally, I have the following comments that also need to address. Major Points: 1. Clarity and Justification of Calibration Methods: The methods section is comprehensive but could benefit from additional clarity regarding the rationale behind choosing the three calibration methods (BLR-IPCW, MLR-IPCW, and pseudo-values). A more detailed comparison or discussion of their relative merits, particularly for different types of datasets (e.g., varying amounts of censoring), would add value. 2. Handling of Censoring: Censoring is a significant challenge in survival analysis. The manuscript describes using inverse probability of censoring weights (IPCW) to handle informative censoring, which is a valid approach. However, further discussion on how the choice of weights impacts the calibration curves and the results should be provided. Some sensitivity analysis regarding the impact of weight selection would enhance the robustness of the findings. 3. Sample Size and Calibration: The manuscript notes that calibration results could be improved with a larger sample size, but it would be helpful to provide more concrete guidance or examples of how sample size affects calibration estimates. Including a brief power calculation or similar quantitative justification for sample size adequacy would enhance the practical use of the software. 4. Practical Interpretation: While the results section demonstrates the use of the calibmsm package well, a deeper interpretation of the results (e.g., how clinicians or statisticians should act based on poor calibration) would be helpful. This would provide the necessary bridge between technical calibration results and clinical decision-making. Minor Points: 1. Software Documentation: It would be helpful to include more detailed instructions or a user manual within the manuscript or supplementary materials, especially for users less familiar with R. 2. Notations and Definitions: Ensure consistent use of notation, particularly in sections where different methods are discussed. Some readers may find the jump between calibration techniques disorienting without a clear distinction between them. 3. Figures and Plots: The calibration curves and scatter plots (such as those generated using BLR-IPCW and MLR-IPCW) should be labeled more clearly in the figures. This will help non-expert readers follow the results more easily. [Note: HTML markup is below. Please do not edit.] Reviewers' comments: Reviewer's Responses to Questions Comments to the Author 1. Is the manuscript technically sound, and do the data support the conclusions? The manuscript must describe a technically sound piece of scientific research with data that supports the conclusions. Experiments must have been conducted rigorously, with appropriate controls, replication, and sample sizes. The conclusions must be drawn appropriately based on the data presented. Reviewer #1: Yes Reviewer #2: Yes ********** 2. Has the statistical analysis been performed appropriately and rigorously? Reviewer #1: Yes Reviewer #2: Yes ********** 3. Have the authors made all data underlying the findings in their manuscript fully available? The PLOS Data policy requires authors to make all data underlying the findings described in their manuscript fully available without restriction, with rare exception (please refer to the Data Availability Statement in the manuscript PDF file). The data should be provided as part of the manuscript or its supporting information, or deposited to a public repository. For example, in addition to summary statistics, the data points behind means, medians and variance measures should be available. If there are restrictions on publicly sharing data—e.g. participant privacy or use of data from a third party—those must be specified. Reviewer #1: Yes Reviewer #2: Yes ********** 4. Is the manuscript presented in an intelligible fashion and written in standard English? PLOS ONE does not copyedit accepted manuscripts, so the language in submitted articles must be clear, correct, and unambiguous. Any typographical or grammatical errors should be corrected at revision, so please note any specific errors here. Reviewer #1: Yes Reviewer #2: Yes ********** 5. Review Comments to the Author Please use the space provided to explain your answers to the questions above. You may also include additional comments for the author, including concerns about dual publication, research ethics, or publication ethics. (Please upload your review as an attachment if it exceeds 20,000 characters) Reviewer #1: The paper presents an R package, calibmsm, for producing calibration plots for the estimated transition probabilities in multistate regression models. For the most part, the underlying theory relating to the plots has already been published elsewhere, although the current paper extends the approach to any starting time and any starting state (rather than the initial state at time 0) using landmarking. The current paper is structured as a tutorial paper which uses a dataset on leukemia patients following bone marrow transplantation as an illustrative example. The calibration plots are a very useful diagnostic tool for assessing goodness-of-fit in multistate models with right-censoring. The package works closely with mstate, which is the principal package for fitting such models in R. Generally the paper, and the associated R package, are well written and fairly easy to follow. Main comments 1. For useability, it might be helpful for the paper to give a bit more detail on how the data frames containing the transition probability estimates are created and the requirements for the data.raw dataset. In the paper, the relevant dataframes are just directly used. However, in practice researchers would need to construct these themselves starting from a fitted mstate model. For the data.raw dataset it is unclear whether the wide form transition times are necessary, or whether it is only the covariates and event time/status for the censoring model. 2. The vignette on IPCW suggests that the default method of calculating the weights is inappropriate. In particular, the "year" variable clearly sets an upper limit on the administrative censoring (and hence overall censoring) time. It would be helpful to see what impact there is if a more appropriate set of weights is used. Minor comments (page numbers refer to the pages in the generated pdf) P9 Title page: "Surname" is included in the list of authors. P17 l194: cox -> Cox P18 l225: "All multistate models must have an absorbing state": I don't think that is necessarily true. While most applications would include death as an absorbing state, some models (e.g. models of STIs) may have two or more recurrent states and assume that death is negligble or may be treated as non-informative censoring. P32 l448: Unfinished sentence. P51 Figure 4: The plots do not appear to have any estimated calibration curves included. Reviewer #2: The authors present the R-package calibmsm for calibrationsplots of the transition probabilities in a multistate model. This is a quite interesting tool for many researchers that facilitates the application of existing methods. I appreciate the Reference list provided and the overall explanation of the package. However, I have some minor remarks that might help to improve the quality of manuscript. - Authors name of Ben van Calster seems to be entered incorrect, as in the authors list “Surname” is written - Line 30: There is a typo: psuedo -> pseudo - Line 36: “… the calibration of a multistate model developed…” I think you can say “… any multistate model” in order to underline the flexibility of this package. - Line 67-68: I think there is a grammatical error in this sentence (“which”?). Please check. - line 102-103: I would be interested in the transition probabilities into any state. This is actually what you are doing. However, in this sentence it sounds like you are only addressing the transitions out of the starting state. - Line 228: There is a typo: This is issue…-> delete is - The numbers referencing to formulas (like (1) and (2)) look the same as the numbers for the references. This is irritating, please use different styles. - Line 265 – 273: You nicely explain step by step how to estimate confidence intervals. For me as a potential user it would be nice if you could add the information where I can find some example code (maybe as supplement, or in the practical part that follows) - Section 3 and 4: o For me it was not that easy to capture the overview provided of section 3 (description of package functions and interface). o It might help, if you separate it a little bit. Maybe first state everything that is needed. And explain afterwards how it should look like. Maybe consider a step by step approach. In the end there should be a clearer structure in this section 3. o In general, for a user it is easier to directly see what is goin on (what input for what purpose etc) by including snippets of examples. You could think of combining section 3 and 4. But if you want to keep this separated you could already refer to the next section. - Figure 4: There seems to be an error when uploading the figure. When viewing the submission I there are only empty graphs (with diagonals). - Line 548: The authors mention a range of other models, that can be addressed via calibmsm, not only multistate models, e.g. competing risks models. A competing risk model is actually a simple multistate model with 3 states. ********** 6. PLOS authors have the option to publish the peer review history of their article (what does this mean? ). If published, this will include your full peer review and any attached files. If you choose “no”, your identity will remain anonymous but your review may still be made public. Do you want your identity to be public for this peer review? For information about this choice, including consent withdrawal, please see our Privacy Policy . Reviewer #1: No Reviewer #2: No ********** [NOTE: If reviewer comments were submitted as an attachment file, they will be attached to this email and accessible via the submission site. Please log into your account, locate the manuscript record, and check for the action link "View Attachments". If this link does not appear, there are no attachment files.] While revising your submission, please upload your figure files to the Preflight Analysis and Conversion Engine (PACE) digital diagnostic tool, https://pacev2.apexcovantage.com/ . PACE helps ensure that figures meet PLOS requirements. To use PACE, you must first register as a user. Registration is free. Then, login and navigate to the UPLOAD tab, where you will find detailed instructions on how to use the tool. If you encounter any issues or have any questions when using PACE, please email PLOS at figures@plos.org . Please note that Supporting Information files do not need this step. |
| Revision 1 |
|
calibmsm: An R package for calibration plots of the transition probabilities in a multistate model PONE-D-24-31812R1 Dear Dr. Pate, We’re pleased to inform you that your manuscript has been judged scientifically suitable for publication and will be formally accepted for publication once it meets all outstanding technical requirements. Within one week, you’ll receive an e-mail detailing the required amendments. When these have been addressed, you’ll receive a formal acceptance letter and your manuscript will be scheduled for publication. An invoice will be generated when your article is formally accepted. Please note, if your institution has a publishing partnership with PLOS and your article meets the relevant criteria, all or part of your publication costs will be covered. Please make sure your user information is up-to-date by logging into Editorial Manager at Editorial Manager® and clicking the ‘Update My Information' link at the top of the page. If you have any questions relating to publication charges, please contact our Author Billing department directly at authorbilling@plos.org. If your institution or institutions have a press office, please notify them about your upcoming paper to help maximize its impact. If they’ll be preparing press materials, please inform our press team as soon as possible -- no later than 48 hours after receiving the formal acceptance. Your manuscript will remain under strict press embargo until 2 pm Eastern Time on the date of publication. For more information, please contact onepress@plos.org. Kind regards, Md Hasinur Rahaman Khan, Ph.D. Academic Editor PLOS ONE Additional Editor Comments (optional): Need to check carefully the typos and PLOS ONE manuscript structures while providing the final document for potential publication. Reviewers' comments: |
| Formally Accepted |
|
PONE-D-24-31812R1 PLOS ONE Dear Dr. Pate, I'm pleased to inform you that your manuscript has been deemed suitable for publication in PLOS ONE. Congratulations! Your manuscript is now being handed over to our production team. At this stage, our production department will prepare your paper for publication. This includes ensuring the following: * All references, tables, and figures are properly cited * All relevant supporting information is included in the manuscript submission, * There are no issues that prevent the paper from being properly typeset If revisions are needed, the production department will contact you directly to resolve them. If no revisions are needed, you will receive an email when the publication date has been set. At this time, we do not offer pre-publication proofs to authors during production of the accepted work. Please keep in mind that we are working through a large volume of accepted articles, so please give us a few weeks to review your paper and let you know the next and final steps. Lastly, if your institution or institutions have a press office, please let them know about your upcoming paper now to help maximize its impact. If they'll be preparing press materials, please inform our press team within the next 48 hours. Your manuscript will remain under strict press embargo until 2 pm Eastern Time on the date of publication. For more information, please contact onepress@plos.org. If we can help with anything else, please email us at customercare@plos.org. Thank you for submitting your work to PLOS ONE and supporting open access. Kind regards, PLOS ONE Editorial Office Staff on behalf of Dr. Md Hasinur Rahaman Khan Academic Editor PLOS ONE |
Open letter on the publication of peer review reports
PLOS recognizes the benefits of transparency in the peer review process. Therefore, we enable the publication of all of the content of peer review and author responses alongside final, published articles. Reviewers remain anonymous, unless they choose to reveal their names.
We encourage other journals to join us in this initiative. We hope that our action inspires the community, including researchers, research funders, and research institutions, to recognize the benefits of published peer review reports for all parts of the research system.
Learn more at ASAPbio .