From 5667ce3eaef054bfbc73dde686632b45bd847cca Mon Sep 17 00:00:00 2001 From: Matthijs Berends Date: Sun, 1 Jun 2025 12:17:47 +0200 Subject: [PATCH] (v2.1.1.9287) fix antibiotics --- .github/prehooks/commit-msg | 1 + .github/prehooks/pre-commit | 2 ++ DESCRIPTION | 2 +- NAMESPACE | 1 - NEWS.md | 43 +--------------------------------- R/zz_deprecated.R | 11 --------- cran-comments.md | 6 ++--- data-raw/_pre_commit_checks.R | 5 ++++ data/antibiotics.rda | Bin 0 -> 46544 bytes index.Rmd | 2 +- index.md | 2 +- man/AMR-deprecated.Rd | 8 ------- vignettes/welcome_to_AMR.Rmd | 2 +- 13 files changed, 16 insertions(+), 69 deletions(-) create mode 100644 data/antibiotics.rda diff --git a/.github/prehooks/commit-msg b/.github/prehooks/commit-msg index 10906f01f..6e18ce448 100755 --- a/.github/prehooks/commit-msg +++ b/.github/prehooks/commit-msg @@ -60,6 +60,7 @@ else fi git add data-raw/* +git add data/* git add -u exit 0 diff --git a/.github/prehooks/pre-commit b/.github/prehooks/pre-commit index a3e82d42e..2bbc61e2a 100755 --- a/.github/prehooks/pre-commit +++ b/.github/prehooks/pre-commit @@ -51,6 +51,7 @@ if command -v Rscript > /dev/null; then currentpkg=$(Rscript -e "cat(pkgload::pkg_name())") echo "- Adding changed files in ./data-raw and ./man to this commit" git add data-raw/* + git add data/* git add man/* git add R/sysdata.rda git add NAMESPACE @@ -112,6 +113,7 @@ echo "" echo "${currentversion}" > .git/commit_version.tmp git add data-raw/* +git add data/* git add -u exit 0 diff --git a/DESCRIPTION b/DESCRIPTION index bdc9a28a3..310016939 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,5 +1,5 @@ Package: AMR -Version: 2.1.1.9286 +Version: 2.1.1.9287 Date: 2025-06-01 Title: Antimicrobial Resistance Data Analysis Description: Functions to simplify and standardise antimicrobial resistance (AMR) diff --git a/NAMESPACE b/NAMESPACE index 35d997aef..0cc72d821 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -166,7 +166,6 @@ export(amr_distance_from_row) export(amr_selector) export(anti_join_microorganisms) export(antibiogram) -export(antibiotics) export(antifungals) export(antimicrobials_equal) export(antimycobacterials) diff --git a/NEWS.md b/NEWS.md index 1642cbf9d..4f5c98baa 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,50 +1,9 @@ -# AMR 2.1.1.9286 +# AMR 2.1.1.9287 *(this beta version will eventually become v3.0. We're happy to reach a new major milestone soon, which will be all about the new One Health support! Install this beta using [the instructions here](https://amr-for-r.org/#get-this-package).)* This package now supports not only tools for AMR data analysis in clinical settings, but also for veterinary and environmental microbiology. This was made possible through a collaboration with the [University of Prince Edward Island's Atlantic Veterinary College](https://www.upei.ca/avc), Canada. To celebrate this great improvement of the package, we also updated the package logo to reflect this change. -## tl;dr - -- Scope Expansion: One Health support (Human + Veterinary + Environmental microbiology). -- Data Updates: - - `antibiotics` renamed to `antimicrobials`. - - Veterinary antimicrobials and WHOCC codes added. - - MycoBank fungal taxonomy integrated (+20,000 fungi). -- Breakpoints & Interpretations: - - CLSI/EUCAST 2024-2025 breakpoints added; EUCAST 2025 default. - - `as.sir()` supports NI/SDD levels; parallel computation enabled. - - Custom S/I/R/SDD/NI definitions allowed. - - Improved handling of capped MICs. -- New Tools & Functions: - - WISCA antibiogram support (`antibiogram()`, `wisca()`). - - New ggplot2 extensions: `scale_*_mic()`, `scale_*_sir()`, `rescale_mic()`. - - New utility functions: `top_n_microorganisms()`, `mo_group_members()`, `mic_p50()`, `mic_p90()`. -- Predictive Modelling: - - Full tidymodels compatibility for antimicrobial selectors. - - Deprecated `resistance_predict()` and `sir_predict()`. -- Python Compatibility: AMR R package now runs in Python. -- Selector Improvements: - * Added selectors (`isoxazolylpenicillins()`, `monobactams()`, `nitrofurans()`, `phenicols()`, `rifamycins()`, and `sulfonamides()`) - - Selectors renamed from `ab_*` to `amr_*`; old names deprecated. -- MIC/Disks Handling: - - MIC strict comparisons, added levels. - - Disk diffusion range expanded (0–50 mm). -- EUCAST Rules and MDROs: - - EUCAST v12–v15 rules implemented. - - Dutch MDRO 2024 guideline support in `mdro()`. -- Infrastructure: - - New website: https://amr-for-r.org. - - Improved `vctrs` integration for tidyverse workflows. - - Dropped SAS `.xpt` file support. -- Other Fixes & Enhancements: - - Support for 8 new languages, adding to a total of 28 languages. - - Faster microorganism identification. - - Improved antimicrobial and MIC handling. - - Extended documentation, additional contributors acknowledged. - -## Full Changelog - ### Breaking * Dataset `antibiotics` has been renamed to `antimicrobials` as the data set contains more than just antibiotics. Using `antibiotics` will still work, but now returns a warning. * Removed all functions and references that used the deprecated `rsi` class, which were all replaced with their `sir` equivalents over two years ago. diff --git a/R/zz_deprecated.R b/R/zz_deprecated.R index 080122e77..82fc127cb 100755 --- a/R/zz_deprecated.R +++ b/R/zz_deprecated.R @@ -35,17 +35,6 @@ #' @rdname AMR-deprecated NULL -#' @rdname AMR-deprecated -#' @usage antibiotics -#' @export -antibiotics <- local({ - warned <- FALSE - value <- AMR::antimicrobials - structure( - value, - class = c("deprecated_amr_dataset", class(value)) - ) -}) .amr_deprecation_warn <- function() { deprecation_warning(old = "antibiotics", new = "antimicrobials", is_dataset = TRUE) invisible(NULL) diff --git a/cran-comments.md b/cran-comments.md index c131e679d..9c7b4dba8 100644 --- a/cran-comments.md +++ b/cran-comments.md @@ -1,5 +1,5 @@ -As with all previous >20 releases, some CHECKs might return a NOTE for *just* hitting the installation size limit, though its size has been brought down to a minimum in collaboration with CRAN maintainers previously. +As with all previous >20 releases, some CHECKs on `oldrel` may return a `NOTE` for narrowly exceeding the installation size limit. This has been reduced to a minimum in prior coordination with CRAN maintainers and currently returns only an `INFO` on `release` and `devel`. -We consider this a high-impact package: it was published in the Journal of Statistical Software (2022), is included in a CRAN Task View (Epidemiology), and is according to download stats (cranlogs) used in almost all countries in the world. If there is anything to note, please let us know up-front without directly archiving the current version. That said, we continually unit test our package extensively and have no reason to assume that anything is wrong. +We treat this as a high-impact package: it was published in the *Journal of Statistical Software* (2022), is listed in the CRAN Task View "Epidemiology", and (based on cranlogs download statistics) is used globally. If there is anything to address, we would appreciate being informed before archiving the current version. We conduct extensive automated unit testing and have no indication of unresolved issues. -Thanks for maintaining and hosting CRAN! It's empowering R and its use enormously! +Thank you for your continued maintenance of CRAN, it plays a central role in the success and growth of the R ecosystem. diff --git a/data-raw/_pre_commit_checks.R b/data-raw/_pre_commit_checks.R index e1c2f6798..bf626fc68 100644 --- a/data-raw/_pre_commit_checks.R +++ b/data-raw/_pre_commit_checks.R @@ -625,6 +625,11 @@ if (changed_md5(dosage)) { try(arrow::write_parquet(dosage, "data-raw/datasets/dosage.parquet"), silent = TRUE) } +# Set `antibiotics` as a deprecated data set +antibiotics <- structure(antimicrobials, class = c("deprecated_amr_dataset", class(antimicrobials))) +usethis::use_data(antibiotics, internal = FALSE, overwrite = TRUE, compress = "xz", version = 2) +rm(antibiotics) + suppressMessages(reset_AMR_locale()) devtools::load_all(quiet = TRUE) diff --git a/data/antibiotics.rda b/data/antibiotics.rda new file mode 100644 index 0000000000000000000000000000000000000000..93ffa1f8c02baae6d9521fa44af4a8eff3790360 GIT binary patch literal 46544 zcmV(hK={A?H+ooF0004LBHlIv03iV!0000G&sfak&fc|@T>vQ&2UJ%gRpOV=m z?~(SQxTJTDlT=umZ5D4HhXEI~a??BbFvZ2`P=K6xG+}2VT?Aze zOVtLA-YVVSNJaEGA6FiIXWvb9mIswp%cou3!EZ_8zbKP5dQWHyh{`2#+$K&3XCanL z7G%L6ZV@e=4w4mvqQ9$-y~o?9bVw@rnT1*`h>M%*SGU?$=>ZI54vEF(31(Ed7M`VU z)fR7hBo9O?q*@{~?p_S&b~eO6`*gPa1W=$nSIGgl%f8QLMVaSkMp^4x2acJhK}-D4 zXm+`$G0^T7z9E){VL!{LtTmJ!XBj`H9`MPHV4zBG(-o)xr+CBipseE@pJXgwCyLzPk9TddWad& zr$|*S)1HJW0;E{gcLapd4bH3kj*-o$Oh@NO)<^%9usv`mOaYlBa|jj5;U(J%R{^yo ze?~|{m%63&Fqw>r`n(NXjcxDlNECLB^A&ROriGsuY2LEqq| z(ANzYV6kBnwdf@e-o-3k9nt?dIGd&fbBV?^Ja?KE1rikG5P(j^yg5UT40ZV@x3X5dRL6@&IjvW4TV)KFKK( zxNVJfl>41q@-4t4mH}RTzP%1iBz|X$vS^srXq+7%hQJd4{%=Zcd)7)pt!&gIx#DV7 zCgR9z*B=At=O>xHb(J2x;Z7$bkuIgKYmvI)qXnJBFaBXzwrp{TH~P9s|L~&ds-r!= z*No6sa6e~J$y|CCpp#SG!tok+t|Q;}T3!v*^Vfvzr+ZP=ICzAbCw1w{uMu|?e=$Vo zk)rJ>i@Un=QAJSHpvyjF%JS~Q5gX~PK!rMFqNQhFb843H<3|ZbKCfcvwfS`b^Av{ zf)uRl;6ze%Vd;do$8RS7*;sXR##E4QvJwHi7)bFLvai&mMr`77CNdBLtT5Zl+c^)X zqVt_vf@tCNeqC*7!AqRbwR3K2YZ`IWp3!UToQa6AL1%_8LIqKvxxQ6Y__cxDXD2fF zDmyQ6nLzBHW&aXw9gxzO0Spgvxxnk0g(>zn(q0hoo)rKDZk2*ubNNgx!uF@#z?e`U7#s*_2s1(PDmlsXh7)yUbPUe;H_#EoNcQa&6TBMxq9XT{xk`)v5OWTlVyGM z5LKoNH}%P`@cv>?kq`v~J-Be}QyGo677BjFxRS%*#l|?{u!Y3({yWN91cx8pPLCqH zYSjJHipHdSKJ@`(reERhlHRIIh_TYw&D`1cl77(^iLdc0C5ha#2C+$@gmZg|#`tOH z3CZ_7`R2I;p0v*}#JgA{`vlWdpwj=5>uvk+`3qskMx=rB4Uj&)RM zxC2?c=ML&K&d4cj$^Uu-u+gB;sPy_7HYdg3J1gt6Z?#VEV(C7{SU}H3SSbF#>#Pp8 zz#LP}D;1usaBNtt_-v=8SD?=dN#n=gBPVuzTTj9!SAe}PWWB$*?25)f@0wT921Z9a z(vgG!{KBp6xA}Fn% zGwqaHZu|=4>9K_U%dr;NqJXKqdQZiY(718;r!v~<_|MZiDxG3dr~M)EU%`PD9RyqI z<799%uQEqhXxF?f=JNSKkCA{4#EB>x73^*-F=#n`{P#P>$mMt(7MfY|mR_8KPy}sd zxre4)Jcuh5KkNd}0{29#Ox%kw9F~f5;>!e@l-#Q(Ps5pG(of*7_xja`WN`VJb^uOE zG|z`>h9IxO=~6Z1WCmu%jbDI7l9D(Wy@*xLJ+-dr>0@y>skr;(Z~JCv60TBX;=gLgnZiXOGN za>UN;mfhOU4fNrxZV5K?n_T)qIS`>G`>dp! zpb&sY45E4qY1QHxaa|u)zMcb&U-yY>?F~<~hG>HV zgUuZHPU%A(`}#PSvU^|rt9)qbCyl5NyoX=_OjvLdG7I0`UfS`Ak(SGeXkKIzV)tWh z=RACsa7ap|qXP#zv~S3a$zs4Zy;P9`F-axBbwdB2Fb-2J{OLA?m)ssn**H@_E>0^1 zx8UY--x8yXF(}{^)^WWraVoZ%qMC{#@My3GQg!X|Qi(j?8JFFH+shKtJEpWDu+h0b zKaM1&Jlsi`-;Be~A?_~wE?Q!SJJ$RLun60?MqE}0AKO{CueOtn78hl{S!p+_fJi3R zB%Tx7BFWkjtP>o-an~*OKWe+Rj}l@)ZxMmLvAafQ@Vz`sk_DOp3AR&PYUW>kf1XhN zrKY0!_~?IyOM3Fa?j$Wl1A$B*VY4Pax6XJG?Eot(E>3V_RZ9bV*qy7*GQNorsvCcu zvFN z16oszV6J*q&Qx0}W9O}*w5k6g;>ml`<<43hu%IDr z#?u?NHP))gCRx5g2{HVz0!_mzZ1n$30&&;Z49eE&7r6nD1y`M-k4RE{cS1eXA0&fF zC!R04>N%16_4jH;_lsVe3C=%JV#wofardrtF0skZq}BR>F@+z!e4{)9 zY?sAv(KzY0-`B0SatoQOXwC`ZD)>a0S$FC;q%TH;2LDz_?4HZqCKA(@5%c8cPD2sj zMjoRW$4yklAO_EtV!+kd0S6hz;fAjba361?`wFH21O|HVoQ(j%kd2d=-}4&=oz0i} z!$9b0MVY1GtcP;UYgIzyTfY@y8$l2AiJCLR?1#&ErhVgK<*wfb)F96SlFsGAdDtOY zV={@z^6-r~ySrpWGK3*N*Z4EJ`c8{gjo;Rcr6ir zpO2&4w;p&faBi79_+Mj?ES48T^b1R0qt;N8kw3K$Bs3xi)}Fy@RvQsAhrOWH)i0%PEPjwnQ=|vH;BWp^1E1q4*jGd$Ao{ z@{d7KfEAamIJmbtiTEBuhhqgZ)9K?ZzDJNY(NmDaz#>H57%CDH(%8U+(qnjlX*lZ1 z&cy-l`k-roI+P&8h~ks?9zI2&2go9yTQeaRQ zxn*~)elragXnf2bVE~{&N7jQWZ8!qzL7pO{GY0F{TB=R+5sm}92LW;ruaU}fxj70j z#oA+57&B0te0Huyt_5{VoCeX;pOsG5=|XlH-1t)3Wd7I-$kE7_#Gwz_bylkn-F_)9 zxQjPvx5oruo9Ov1;Fd2Yz7j_NWZSt@^njVLGzSkTwjfe(MnLqA8{JE?Pt1yu=8HEp z!QxjgRYG!V{<|405`gRuAk}aVLE2i3c<3I5)5L~jh0gh7-$F?DG&n`e9yD2V-{68gZ*(LipHKEdWD6AIQ1XCop2#9o_nw~k|621#h1$l?V!|%Pl$av4ivda z9`d96HjKZ9;QoluFlq}|ZngXcFqq^+>%tv>mI z!G+Tl=6t5&qI7#7#15YXJbZ_?a{1@v9}f?1<5EZG~Q|b*36B z6(fh9rM=qrR2$l9FU`de55%i(OhWl5=;pR8>DPb*($CeX^))rv zeR}L8D`#R5cS^j?77eYKxu1S4^#E)jMsR+?F>wS;LHxa`G(}KSc^ezozV4LJpA{@c zYef;D`_iG~Q~&RI$3A$CGqL}{90Mv+?W&{KFJ^<4Hf9kid|YQO%xXmNT59jOQEzli zkAOOlzaVY9LDW~pp>Cmfo=Wzw0RaP!#!u&&wiL#XjP? zg&8=1jY4KCK^TyfaJ7n2JX77*AZ?iu zk>70wrN(}$&=TpvDkEH3t=u>~`)#(2+(Csoo=$dhP&kXaQcMNXn=4NPH_$=$>%PXV zi4kQQ;0Mr}NE8aJrv9S)S?z$1_n~sl>i7*+hZ{(O` zYT@3cWuBv?&?(fw6gtdkSpR7#$5FO*RqX6w1itZ9G}LfzCQe<9kBWg|C1nUJYkqMh2;?4a6ly4^7yKWL0Y|J_SB(UdciVq~>sXKR|Q5pruM@g54&pD

aelsxX4Xw!c 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

$9pOtm!aq55~2NH#W@6m18(G|O7i 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

q&?S$I=+@6{Q69_GWfFG2za=MK`U$*=Yn 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 Y>jK}M55}Maiasz6ivj=u00045T0yO)@Bjb+ literal 0 HcmV?d00001 diff --git a/index.Rmd b/index.Rmd index df54a5631..39faabd1a 100644 --- a/index.Rmd +++ b/index.Rmd @@ -192,7 +192,7 @@ out %>% set_ab_names(property = "atc") This package was intended as a comprehensive toolbox for integrated AMR data analysis. This package can be used for: - * Reference for the taxonomy of microorganisms, since the package contains all microbial (sub)species from the List of Prokaryotic names with Standing in Nomenclature ([LPSN]((https://lpsn.dsmz.de))) and the Global Biodiversity Information Facility ([GBIF](https://www.gbif.org)) ([manual](./reference/mo_property.html)) + * Reference for the taxonomy of microorganisms, since the package contains all microbial (sub)species from the List of Prokaryotic names with Standing in Nomenclature ([LPSN](https://lpsn.dsmz.de)) and the Global Biodiversity Information Facility ([GBIF](https://www.gbif.org)) ([manual](./reference/mo_property.html)) * Interpreting raw MIC and disk diffusion values, based on any CLSI or EUCAST guideline ([manual](./reference/as.sir.html)) * Retrieving antimicrobial drug names, doses and forms of administration from clinical health care records ([manual](./reference/ab_from_text.html)) * Determining first isolates to be used for AMR data analysis ([manual](./reference/first_isolate.html)) diff --git a/index.md b/index.md index 3d47d246b..ca584ebc0 100644 --- a/index.md +++ b/index.md @@ -387,7 +387,7 @@ data analysis. This package can be used for: - Reference for the taxonomy of microorganisms, since the package contains all microbial (sub)species from the List of Prokaryotic names - with Standing in Nomenclature ([LPSN]((https://lpsn.dsmz.de))) and the + with Standing in Nomenclature ([LPSN](https://lpsn.dsmz.de)) and the Global Biodiversity Information Facility ([GBIF](https://www.gbif.org)) ([manual](./reference/mo_property.html)) diff --git a/man/AMR-deprecated.Rd b/man/AMR-deprecated.Rd index 881d24955..fa51804a8 100644 --- a/man/AMR-deprecated.Rd +++ b/man/AMR-deprecated.Rd @@ -1,18 +1,11 @@ % Generated by roxygen2: do not edit by hand % Please edit documentation in R/zz_deprecated.R -\docType{data} \name{AMR-deprecated} \alias{AMR-deprecated} -\alias{antibiotics} \alias{ab_class} \alias{ab_selector} \title{Deprecated Functions, Arguments, or Datasets} -\format{ -An object of class \code{deprecated_amr_dataset} (inherits from \code{tbl_df}, \code{tbl}, \code{data.frame}) with 497 rows and 14 columns. -} \usage{ -antibiotics - ab_class(...) ab_selector(...) @@ -20,5 +13,4 @@ ab_selector(...) \description{ These objects are so-called '\link{Deprecated}'. \strong{They will be removed in a future version of this package.} Using these will give a warning with the name of the alternative object it has been replaced by (if there is one). } -\keyword{datasets} \keyword{internal} diff --git a/vignettes/welcome_to_AMR.Rmd b/vignettes/welcome_to_AMR.Rmd index 3e090e180..16422f83b 100644 --- a/vignettes/welcome_to_AMR.Rmd +++ b/vignettes/welcome_to_AMR.Rmd @@ -36,7 +36,7 @@ The `AMR` package is available in `r AMR:::vector_and(vapply(FUN.VALUE = charact This package was intended as a comprehensive toolbox for integrated AMR data analysis. This package can be used for: - * Reference for the taxonomy of microorganisms, since the package contains all microbial (sub)species from the List of Prokaryotic names with Standing in Nomenclature ([LPSN]((https://lpsn.dsmz.de))) and the Global Biodiversity Information Facility ([GBIF](https://www.gbif.org)) ([manual](https://amr-for-r.org/reference/mo_property.html)) + * Reference for the taxonomy of microorganisms, since the package contains all microbial (sub)species from the List of Prokaryotic names with Standing in Nomenclature ([LPSN](https://lpsn.dsmz.de)) and the Global Biodiversity Information Facility ([GBIF](https://www.gbif.org)) ([manual](https://amr-for-r.org/reference/mo_property.html)) * Interpreting raw MIC and disk diffusion values, based on any CLSI or EUCAST guideline ([manual](https://amr-for-r.org/reference/as.sir.html)) * Retrieving antimicrobial drug names, doses and forms of administration from clinical health care records ([manual](https://amr-for-r.org/reference/ab_from_text.html)) * Determining first isolates to be used for AMR data analysis ([manual](https://amr-for-r.org/reference/first_isolate.html))