Skip to content

Releases: pythonhealthdatascience/des_rap_book

v0.3.0 - 2025-11-06

06 Nov 12:05
50d29ed

Choose a tag to compare

This release adds new pages on the mathematical proof of correctness, discrete-event simulation, and conclusions/feedback, as well as template repositories for structuring work as a package. It fixes the calculation of R time-weighted measures, updates the Python approach to determining warm-up length, and extends all pages to cover all performance metrics. Numerous smaller improvements are also included.

Added

  • Template repositories for package structure.
  • Mathematical proof of correctness page.
  • Discrete-event simulation introductory page.
  • Conclusions page.
  • Feedback page.

Fixed

  • Add correction for R time-weighted measures so last interval is included in calculations.

Changed

  • Pages following Performance Measures now use all metrics (and not just two) for Python and R.
  • Changed Python approach for determining length of warm-up (previous approach unsuitable when using all metrics).
  • Added patient end-time logging to all simulation model pages.
  • Upgraded to sim-tools v1.0.0 (Python) and add queueing (R).

Also some minor improvements and refinements, including:

  • Extra desk-check suggestions in verification_validation.qmd
  • Removed colour variable for R sensitivity plots.
  • Expanded and cross-linked stuff on guidelines in sharing/archive.qmd and intro/guidelines.qmd.
  • Small corrections in README, docstrings, linting.
  • Refactoring tests.
  • Clarifications on R data storage, seed sequences, correlated streams, and limitations of structuring research as a package.
  • Mentions of MRAN, P3M, commit pinning, data-raw, pins and {targets}.
  • Mentioned relevant verification/validation concepts in topic pages.
  • Added link to repository renv.lock on environment page.

v0.2.0 - 2025-10-14

15 Oct 09:02
3b60d7e

Choose a tag to compare

Added

  • Logging page
  • Output analysis section covering:
    • Initialisation bias
    • Performance measures
    • Replications
    • Parallel processing
    • Number of replications
    • Length of warm-up
  • Experimentation section covering:
    • Scenario and sensivity analysis
    • Tables and figures
    • Full run
  • Verification and validation section covering:
    • Verification and validation
    • Tests
  • Style and documentation section covering:
    • Linting
    • Docstrings
    • GitHub actions
    • Documentation
  • Collaboration and sharing section covering:
    • Code review
    • Licensing
    • Citation
    • Changelog
    • Sharing and archiving
  • Add citation to footer.
  • Add pre-commits.
  • Add all-contributors.
  • Add CONTRIBUTING.md.

Changed

  • Redid the introduction box for each page to be simpler/clearer.
  • Moved giscus comments settings to _quarto.yml so can have comments on index page.
  • Improvements to existing pages (citations, illustrations, links, .lightbox).
  • Switched to consistent modern execution options syntax.

Fixed

  • Parameters from file (don't generate PDF).
  • Input modelling (correct python-content to r-content).
  • Add padding to bottom of side bar so can see all pages (otherwise cuts off for some reason sometimes).

v0.1.0 - 2025-09-10

10 Sep 15:23
d181293

Choose a tag to compare

🌱 Initial release of the website (work in progress). This version introduces the website structure and the first written sections (up to Output Analysis).

Added

  • Project overview page (STARS).
  • Introduction section covering:
    • Reproducibility and RAPs
    • Guidelines
    • Open-source languages
    • Example conceptual models
  • Setup section covering:
    • Version control
    • Environments
    • Structuring as a package
    • Code organisation
  • Model inputs section covering:
    • Input modelling
    • Input data management
    • Parameters from script
    • Parameters from file
    • Parameter validation
  • Model building section covering:
    • Randomness
    • Entity generation
    • Entity processing