Simulate secondary

[sbfnk]

Description

This PR closes #563 by introducing a new function simulate_secondary(). The existing function of that named has been renamed to convolve_and_scale()

Initial submission checklist

• My PR is based on a package issue and I have explicitly linked it.
• I have tested my changes locally (using devtools::test() and devtools::check()).
• I have added or updated unit tests where necessary.
• I have updated the documentation if required and rebuilt docs if yes (using devtools::document()).
• I have followed the established coding standards (and checked using lintr::lint_package()).
• I have added a news item linked to this PR.

After the initial Pull Request

• I have reviewed Checks for this PR and addressed any issues as far as I am able.

[github-actions]

This is how benchmark results would change (along with a 95% confidence interval in relative change) if 97e07cf is merged into main:

• ✔️default: 33s -> 33.3s [-11.71%, +13.89%]
• ✔️no_delays: 46.4s -> 34.6s [-85.18%, +34.25%]
• ✔️random_walk: 9.59s -> 9.14s [-18.24%, +9.01%]
• ✔️stationary: 21.5s -> 17.7s [-55.23%, +20.47%]
• ✔️uncertain: 50.5s -> 1.03m [-18.71%, +63.44%]
  Further explanation regarding interpretation and methodology can be found in the documentation.

[seabbs]

LGTM. A bit of a painful merge I think.

[github-actions]

This is how benchmark results would change (along with a 95% confidence interval in relative change) if 8d0f69c is merged into main:

• ✔️default: 33.3s -> 34.5s [-8.51%, +15.97%]
• 🚀no_delays: 35.3s -> 31.9s [-15.9%, -3.28%]
• ✔️random_walk: 9.92s -> 9s [-19.59%, +1.03%]
• ✔️stationary: 18.6s -> 18.8s [-10.19%, +12.55%]
• ✔️uncertain: 46.4s -> 50.9s [-10.45%, +30.13%]
  Further explanation regarding interpretation and methodology can be found in the documentation.

[github-actions]

This is how benchmark results would change (along with a 95% confidence interval in relative change) if 65b3043 is merged into main:

• ✔️default: 31.9s -> 31.8s [-14.22%, +13.62%]
• ❗🐌no_delays: 31.7s -> 35.6s [+3.92%, +20.88%]
• ✔️random_walk: 9s -> 9.05s [-7.92%, +9.02%]
• ✔️stationary: 16.9s -> 21.5s [-11.44%, +65.31%]
• ✔️uncertain: 51.9s -> 53.6s [-15.34%, +22.07%]
  Further explanation regarding interpretation and methodology can be found in the documentation.

[sbfnk]

All changes since last review were merges / minor doc changes so merging as is.