HarmonicBalance.jl: A Julia suite for nonlinear dynamics using harmonic balance

Dear Dr Attaccalite,

Thank you for sending us the referee reports on our manuscript "HarmonicBalance.jl: A Julia suite for nonlinear dynamics using harmonic balance". We are pleased to hear that the referees, and you with them, find our work of potential interest. We have addressed the referees' comments in total and used them to improve our manuscript.

We are glad that the Referees recognise our open-source software's critical range of applications and praise the clarity and quality of our presentation. They raise several questions regarding the scope of our toolbox that we each address in detail in our response and revised manuscript. We also appreciate that Referee 1 finds our package very useful and convenient, while they suggest package enhancements such as calculation indicators and data exports on the results. Referee 2 raises comments on the expected impact in several disciplines and the capabilities of the current version of the package. We have followed up on the suggestions, and while this has required significant effort, it has led to several extension modules included in the latest release and new usage examples and documentation. We are delighted with the positive impact it has had on our toolbox, whose scope has now increased.

Finally, both referees highlight the importance of an extension that would allow determining limit cycles and stochastic dynamics. Here, we emphasise that our current submission's goal is to provide a solution to the (so far unsolved problem) of finding the totality of fixed point steady-state solutions o a deterministic nonlinear, time-dependent differential equation. In this process, we also imbue into the code several years of experience in handling the solutions to provide an explainable output beyond the scope of time-dependent-based numerical experiments. Therefore, while we have carried out preliminary steps in the suggested directions, we plan to include limit cycle functionality and stochastic dynamics in full in future releases of the package.

The responses to each of the Referee's replies can be found below each corresponding report. We hope that, with these changes, the referees find our improved manuscript suitable for publication in SciPost Codebases. I thank you for your careful consideration.

With kind regards,

Javier del Pino (on behalf of the authors)

* We have included nine new relevant references to nonlinear dynamics in the Introduction. Here we added minor revisions to establish further the different capabilities of our methodology and time evolution toward the steady-state.

* We revised section 2.2 to stress the envisioned usage of harmonic expansions to find limit cycles. Here we included four new references.

* We have extended the comparison with other harmonic balance implementations by further elaborating
the first bullet point in section 4.

* We have revised our plotting routines as detailed above and upgraded our progress bar to offer a
human-readable output during parallel calculations and considering progress along with analysis tasks
(matching solution branches, calculating response spectra).

* To further emphasise the time-domain simulation capabilities of the package, we incorporated in the
manuscript a link to a new relevant example in the online documentation.

* We now provide a LinearResponse module to calculate linear response, as documented in
[https://nonlinearoscillations.github.io/HarmonicBalance.jl/stable/examples/linear_response/].

* We included a new example to illustrate the calculation of a sub-harmonic response in HarmonicBalance.jl, namely a parametrically driven Duffing oscillator or "parametron". Here, we included five new references.

* We added a comment in the revised manuscript regarding the focus on deterministic dynamics.
We shaped the discussion in section 5.4, “Increasing computational complexity: performance scaling.”
by highlighting some example experimental directions where our library can be most appropriate.

*In unison, we stressed the potential impact in other research areas in the conclusions.