From 501395d46e7d705a6951c29694467f17cb4b0108 Mon Sep 17 00:00:00 2001
From: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 23 Jul 2025 20:25:40 +0000
Subject: [PATCH] Built site for AMR@3.0.0.9016: 2f86698

---
 404.html                                      |   2 +-
 LICENSE-text.html                             |   2 +-
 articles/AMR.html                             |  10 ++++----
 articles/AMR_files/figure-html/autoplot-2.png | Bin 63675 -> 68087 bytes
 articles/AMR_files/figure-html/mic_plot-1.png | Bin 108206 -> 109478 bytes
 articles/AMR_for_Python.html                  |   2 +-
 articles/AMR_with_tidymodels.html             |   2 +-
 articles/EUCAST.html                          |   2 +-
 articles/PCA.html                             |   2 +-
 articles/WHONET.html                          |   2 +-
 articles/WISCA.html                           |   2 +-
 articles/datasets.html                        |   4 ++--
 articles/index.html                           |   2 +-
 authors.html                                  |   2 +-
 index.html                                    |   4 ++--
 news/index.html                               |   8 +++----
 pkgdown.yml                                   |   2 +-
 reference/AMR-deprecated.html                 |   2 +-
 reference/AMR-options.html                    |   2 +-
 reference/AMR.html                            |   2 +-
 reference/WHOCC.html                          |   2 +-
 reference/WHONET.html                         |   2 +-
 reference/ab_from_text.html                   |   2 +-
 reference/ab_property.html                    |   2 +-
 reference/add_custom_antimicrobials.html      |   2 +-
 reference/add_custom_microorganisms.html      |   2 +-
 reference/age.html                            |  22 +++++++++---------
 reference/age_groups.html                     |   2 +-
 reference/amr-tidymodels.html                 |   2 +-
 reference/antibiogram.html                    |   2 +-
 reference/antimicrobial_selectors.html        |   2 +-
 reference/antimicrobials.html                 |   2 +-
 reference/as.ab.html                          |   2 +-
 reference/as.av.html                          |   2 +-
 reference/as.disk.html                        |   2 +-
 reference/as.mic-2.png                        | Bin 41632 -> 46360 bytes
 reference/as.mic-3.png                        | Bin 49422 -> 52101 bytes
 reference/as.mic-4.png                        | Bin 46120 -> 51370 bytes
 reference/as.mic.html                         |   3 +--
 reference/as.mo.html                          |   2 +-
 reference/as.sir-2.png                        | Bin 33202 -> 33200 bytes
 reference/as.sir.html                         |  10 ++++----
 reference/atc_online.html                     |   2 +-
 reference/av_from_text.html                   |   2 +-
 reference/av_property.html                    |   2 +-
 reference/availability.html                   |   2 +-
 reference/bug_drug_combinations.html          |   2 +-
 reference/clinical_breakpoints.html           |   2 +-
 reference/count.html                          |   2 +-
 reference/custom_eucast_rules.html            |   2 +-
 reference/custom_mdro_guideline.html          |   2 +-
 reference/dosage.html                         |   2 +-
 reference/esbl_isolates.html                  |   2 +-
 reference/eucast_rules.html                   |   2 +-
 reference/example_isolates.html               |   2 +-
 reference/example_isolates_unclean.html       |   2 +-
 reference/export_ncbi_biosample.html          |   2 +-
 reference/first_isolate.html                  |   2 +-
 reference/g.test.html                         |   2 +-
 reference/get_episode.html                    |   2 +-
 reference/ggplot_pca.html                     |   2 +-
 reference/ggplot_sir-10.png                   | Bin 0 -> 46478 bytes
 reference/ggplot_sir-2.png                    | Bin 47408 -> 47090 bytes
 reference/ggplot_sir-5.png                    | Bin 34360 -> 48805 bytes
 reference/ggplot_sir-6.png                    | Bin 21045 -> 34360 bytes
 reference/ggplot_sir-7.png                    | Bin 36287 -> 21050 bytes
 reference/ggplot_sir-8.png                    | Bin 45626 -> 36287 bytes
 reference/ggplot_sir-9.png                    | Bin 46478 -> 45626 bytes
 reference/ggplot_sir.html                     |  14 +++++------
 reference/guess_ab_col.html                   |   2 +-
 reference/index.html                          |   2 +-
 reference/intrinsic_resistant.html            |   2 +-
 reference/italicise_taxonomy.html             |   2 +-
 reference/join.html                           |   2 +-
 reference/key_antimicrobials.html             |   2 +-
 reference/kurtosis.html                       |   2 +-
 reference/like.html                           |   2 +-
 reference/mdro.html                           |   2 +-
 reference/mean_amr_distance.html              |   2 +-
 reference/microorganisms.codes.html           |   2 +-
 reference/microorganisms.groups.html          |   2 +-
 reference/microorganisms.html                 |   2 +-
 reference/mo_matching_score.html              |   2 +-
 reference/mo_property.html                    |   2 +-
 reference/mo_source.html                      |   2 +-
 reference/pca.html                            |   2 +-
 reference/plot-14.png                         | Bin 93668 -> 95453 bytes
 reference/plot-15.png                         | Bin 79220 -> 81118 bytes
 reference/plot-17.png                         | Bin 48785 -> 55112 bytes
 reference/plot-19.png                         | Bin 45141 -> 51225 bytes
 reference/plot-2.png                          | Bin 59610 -> 62752 bytes
 reference/plot-20.png                         | Bin 42907 -> 49038 bytes
 reference/plot-3.png                          | Bin 61484 -> 61489 bytes
 reference/plot-4.png                          | Bin 53209 -> 56174 bytes
 reference/plot.html                           |   9 +------
 reference/proportion.html                     |   2 +-
 reference/random-2.png                        | Bin 43470 -> 49490 bytes
 reference/random.html                         |   3 +--
 reference/resistance_predict.html             |   2 +-
 reference/skewness.html                       |   2 +-
 reference/top_n_microorganisms.html           |   2 +-
 reference/translate.html                      |   2 +-
 search.json                                   |   2 +-
 103 files changed, 110 insertions(+), 119 deletions(-)
 create mode 100644 reference/ggplot_sir-10.png

diff --git a/404.html b/404.html
index d8d9ee498..860eb0cb9 100644
--- a/404.html
+++ b/404.html
@@ -31,7 +31,7 @@
 
     <a class="navbar-brand me-2" href="https://amr-for-r.org/index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/LICENSE-text.html b/LICENSE-text.html
index e934719fe..0c994c750 100644
--- a/LICENSE-text.html
+++ b/LICENSE-text.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/AMR.html b/articles/AMR.html
index 2de3d57d6..7927c834b 100644
--- a/articles/AMR.html
+++ b/articles/AMR.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -91,7 +91,7 @@
 website update since they are based on randomly created values and the
 page was written in <a href="https://rmarkdown.rstudio.com/" class="external-link">R
 Markdown</a>. However, the methodology remains unchanged. This page was
-generated on 19 July 2025.</p>
+generated on 23 July 2025.</p>
 <div class="section level2">
 <h2 id="introduction">Introduction<a class="anchor" aria-label="anchor" href="#introduction"></a>
 </h2>
@@ -147,21 +147,21 @@ make the structure of your data generally look like this:</p>
 </tr></thead>
 <tbody>
 <tr class="odd">
-<td align="center">2025-07-19</td>
+<td align="center">2025-07-23</td>
 <td align="center">abcd</td>
 <td align="center">Escherichia coli</td>
 <td align="center">S</td>
 <td align="center">S</td>
 </tr>
 <tr class="even">
-<td align="center">2025-07-19</td>
+<td align="center">2025-07-23</td>
 <td align="center">abcd</td>
 <td align="center">Escherichia coli</td>
 <td align="center">S</td>
 <td align="center">R</td>
 </tr>
 <tr class="odd">
-<td align="center">2025-07-19</td>
+<td align="center">2025-07-23</td>
 <td align="center">efgh</td>
 <td align="center">Escherichia coli</td>
 <td align="center">R</td>
diff --git a/articles/AMR_files/figure-html/autoplot-2.png b/articles/AMR_files/figure-html/autoplot-2.png
index f7cac3c46848a243826e0b198d4bd74fa37b6b4f..771dfb922523d9e93cbceaac3454bc5c0ffd7452 100644
GIT binary patch
literal 68087
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%0D)rf9hC^_TjM0AGR>s<uY%x
zA=rC$h>QYSTF#37a$Q;j83m#ozzv9wHZ@9-5285VezTwppR^x352xtCu4A7`_I$UA
z4Ukcs{{S%H2II)iRtOYCxEWHzkIGA$XZxEw9;ho7VvC{XX`e9zBXU=eP4V`S0Ej6A
z+n0<^TV^?OC}&%-It+4ra*~bBgs;MTU=trG^tFi|xv(sEE!gpmM~(_o!58^kb!~ld
zcfbngIMft{^UDZ6LZK*ZWBYVU_<AhMiya7&93gv2zKG3LnbzooS|Z{;2|fXjt;p0!
zXyxrT62Z0=&KB|Iu3v44xu;VD^sH&S6rB_fUdHv|^K7MuzB&c$-^J-Rkb?aDw<HY(
zrX-MFAlo7UCW|fV`axoCo-S>s(#j6C-h;i!x<@D9MY(dv@8C}(W(LE7I^U<019J8f
zD7CUWwN*a^p)#W#p=-uHYxbov*RbC3d+wzx#TxEY9Scty&`B=<`ybd0H5Q5X()P|h
z<tGQgyaZH95HPg=Y$Ta8<QNZ`?mB;@9fos|5rtx>hBsTKC|2X|jo5){O`wy>9hMSA
zYwuszd{<oJ4m(=yU(aNYU93l;VWVDYl{{h{@XVH5I<!@TTzhH{7;W&px(Zn^6H$!D
zC3mJ9<=jq?J`G?BZ<rQT&uORKnQ1;V@~9iIxzv`OPy~zwv4CC8nvo|IIPP?xBnHqb
z>8+goMa(xkfiDkEc@so-_3BN`*<%mHMVSGtr@A7{Pcc4I-aZWcfX^^To3`vlwH>!b
zC<y1xQLc!}mgh*~_4ee5wOrtF5MbaqdJf=dl;|if)g)Rqeb(T*cI_IYom2<AtV2bS
zQQ$u<{h}fwHH-6*6bRy}RNDp!FE42d$06VR9!m3O*M>|PndMv4<z{p4B$}UR9S|0-
zR<TT$%bj;AHLtM1a<Pbx`EkA>2hauLW)wLSn$1yJ@%&@N{G2vE$-N4|l-h?wtu^3t
z``nog67BhPvCS;uW7$U^5WH(dL5~K@0#OaFL!qU#AUqcj3rH`Z()}J6dRiiOPqUQv
zIeomF{M+lRRNbf54+*SV$K&{ZWGQd3imkXZC!Q<f&GZw{tZNqsfP4JOxcNL`KR-_+
z1*&D~gym50`Lv+fyv<J<7kBse@;~dBt1L*m^~5X)xP8oQgijMCEj6{esalNLe7;xn
z{G|5_GZT|oSF_&%maVjFAXeVB9!-~3U^|?yzfm3`I`25oFkTl^oLN^_r}DbK;KfID
zk}c=v?2mV^Qi!U2?y3t{Y~Fz38yz>}62Jw~Xih_LK<Y{G?E+os9X-b`gMAdm8|((D
zgbp<R!O&KdY~<irJ7oT9SEuAMIk+ild@jL~K&_cWBy#AppUJ~OmL!2Zz%_gR4O?}B
z#b+q%Bi(Tz(50?@>a{(GFwrzk4=000C(t_V(ZByjW_&z<^K^%pFBJo_iV$znlb|vA
z8I6JFA@vqn0+7|7joBlXi^|4Er*m7`2ec>tf#mvZ0%13^W|})ml7Yb>FGy6$F*@zr
z>68ly#u^iD{n;5ZIep9=B@)(>AlUNCTTc7TG9(j2h{oH@EuD4G7$I$Y%76E7E&zoh
z90}y(?JCK=ydk!g_T@S40+uu!nnZvXs@|(tukO6D&*iKaW>GF}>~bFNV3jw8<jZR|
zPw}{iojOQcvh?hpWRstN-Bz$`P1No`<zDN&{-VY>61z-b$!WLU9M3hAHmaT(dD68=
z?928g+fTk`>=mSngrDAi*JDxa@fDKS`-Fz4u1V&<J5Mhu5ii-69qOGgwfREXxU)=W
zNnv4|v~h0pK>__t4RpY(L8Szut4R+YtZ#G~E)A4+PD2}Q*8M4&`jMWRlNRZ^$g0i(
zU+%3_CjSDdj2rpT8u%r>-h9<L&U=Sl<?dAV{2}zodQoaK^5J;wmTu_r)<Aw}1Vml=
zt={r*c3w!VrEKhfXRp6UN-3&y3=9cS*p_0;_lux_K*IWioHrk1tf*2RvTp{|gb0TE
zYtlHRGJ2qykBMsfErZZ`FopCjQSGAApvOTbYF+!vy432PV5+90qtkB9Fy}cH=JQvo
z)0Y)#i!0o4#~6d61w2kUzlZ(Z6t2?N!HbYmf%azzs=OOD>LHq{hxn)xjy(yJ=y&tQ
zjTu^vPq<_v;bK6t2kagi#3Pf@b{6;j`xQs2t=!U18ZbGvC>vet*+iKyF7SifM{yfM
zcEN`+BxIh*inmMR63%W8gn&0RsGa~X+bu1fQ)>>bm&a(!%V@MPGB)Plw(YfxpoD}D
z5ay3qxCDa2#RRIP;PPXc3+qEx*8llsP?hcRD6dRJFaLFnR*C#S{yr0mx+?S$K$#0`
zETHX3kK|9vPCoKokJBJY8&7V5#;b$m#v3fs5eyr2i+krskeL&Zl+}jp(u4c=!=Vsl
z2CXl2fa|`Jf$GDP1Lr=(;KkhW_SOcI)fRMi6F?*L>dEMC4sq*9zzh*s1bvsm_fDuE
z*<sv;hk23r`)O1@O)(V56e7#e8W6@rVsr4I-VDK@-LLQ0Qd07w#$qZ<$L!^-Ms!VU
z-e@-ylCd_g<$R_xc09&ZsB9EFMi^7bq9P-ALudy#QG+o>hUc1JbN$p_2hMx53B*)Q
zF_{L>gDSpxVcOypL*vrGo$2)n5KWzM$yF%lfgl?co>eYgdIoG!z1{xP<x9bW{)Y3U
zUA|j6N`>C9haOM-My<KX<jY<%ycMFHsIzDjVaaWyJ`Wy5Vtj)uWU3@=yY53cR4?8h
zn?Hcs-qBIiJGxl9L{71F%1LUgpTED>vd>amy@BOL;0o<4QkZBC#)s3`XJe=*Zxb=C
zE^sO99qmCX;Y*5{k4rIuO9b+ufXmdU#s}&U2A-4Y9G)0~At5FH4NPztjzcT%BbW%O
zn2rm7sTtQOyKxxSM%ZbjYgswU??+IPsX$1Exu`Gs#&6}f#@@d@<HA!dEMvXDH^I}2
zEGI{&6UZ8V$!|feGeKpN>_JF#@H1AnANrPLiE?-*M8)}1m-D7SI8vVk5^)s(>r`kq
z<sdaDt;9F_p`Po3=^lxYiP7Ht=Fo$4mACii&7VZqK?OA7Hx98mJ(O_4Dd<d6X;4o&
zcX|f%E>6&4C{uLOyP1r5>K+^gGVN{5RF5CYpS%tRHmIqqleuh=%Pr^~je}q|K&%>!
zU*lVOd<g9T7s-6Otj0jhQ-UDCuB5tnI(=>brx!<|@nsc7am8Ol4kQqt;ujK<05u-R
z90Q2ToC0X2Mx)&(Zv(yH9t;dz(^;^1MFr788+FoDQ3;2p>2W$)>n@xzI#nN_)6j&=
zg^HJu&6{wM86G1&7BQ|G^`o`^8>Zfvq9Ec8wSh#)TBzbkq2WCc;)qm}H`kX+KmaXD
z^fA{@ZrGS%H&=1T5fv<4Bon4wr|+PDy8h=PH<1-bAzPsO`|nTWytgLc9v_w~hDc~a
z9Hyr(DU6_ze03(HFD_@E*?Jf%md8Q(Sb3$lAtMEEOYN~DB9e)@2>!7C7*dCmbcn=l
z){@2aJvx;r^~Tr*LBM)gp%NofX#zT_DsX|q*ylt=X%cqmP28TJSt|303BX<shxW&o
zn~$M)Mx?zF2dd(&m$s8(^9Cz}e0?LJ63xG75AEjJ-Me<lL4czQVR00JI4%UCOWc!N
zQVRiPEn)~e;2ivdf=aj&*OR>i5GN9<6Xc8Mnc-bUKu(p6(JtP<;(dO8FO*3>!piQY
zaY))<y3sz<V*Juqba7Tw&uPZKXZHEr4i`~R0fHI3;;jnwg^004hNVvD)8EEZbXmm!
z%IpTt{UWf4d%IrL#;+}NGp`8$12|G1jSf6WXTzpV{5X3Uk*=+#Mh7c<{c|~fZ_g9Y
zU6yz;y`<>@0nzYj%4k?k13LZ;E^3cNp!k|UgwA}37V-XUo4Ge9**)?kaS$GSMn;G<
zpkV)|rxR010@mwM1Zdd8mFSCkT2gW<!5~Km)fabR2#b@cMwPM47j>2fMH6zvv&kZ}
zrtAzVF`1b|Mf_%Zvjgs|ENVAO#wy4bO&MN9e+MQ3BPi8eTwMH$8{l*~4*Y%{J;#qB
z52T$@f>qZvdME`spBdoP)$mao5Mj0Aew=Kbqt(AW9y%?Li}E4a6$5xn9WttM->&S=
z|J4z+`iDDTrx?DRVnE#=EBy=vwnPYDJ#4;7wB%rw=O>D(<wt667hQT5VIkw<$L&$k
z(Pn4|<~U^ao8L97IjdN`lSumPjIC`I{pl~(O~>7ad3lf~9tD`94<#mbNMD4y&pP5)
zPtu{x8V93hhV62;M!N~)3f8Y%N5(J5LU7*+#Qsq%fUZGOdQm&Z-<+gHzd;CSxPAhp
z1?`6`o==zZT(@k@6!}f|kKD&RoSgCSM<?l+^K00fX<A$~s)PMe3&X_6Gj2FzprWGE
zGN|HpZHUP*+oYCt_}Ql<DBs=_%<S5Z-G72uRG1N46st6{noe;0Vh%k;AcTX}hQkv;
zB@%5NMqP7JfSsnQst<L~u3fvHxlQ*g2OnBv%>zA}p3f=KurC1RCQm@uty-i`ZwD<C
zx$A<(?_Qf$$M_%)Nx(Vj1<GHIigX;HNoB|o6qS@{7#JAbXopMwg|=arfBbD(k71{r
zj`LS!^Co!1<1MylVw|=|`NRSZ$q$NYb8j+3FOiRDwXL5ud42HKk@kO_eqk695n%^s
z8^mHwP;YDAu0CMm_vhjYx-Asm1IL>Il@)AYXV?@gj(6|DVp6~$#Gd@-+)OLJ)8v4{
zRZwZSR&g(LqQB{RQvx|IQ$*E#d-qlYvl;<cCJwGO5V|Yq&3=qn*>FS8eYa)5n7wu1
z&`*~7)Z)`M37Ibv<ChOj&pQu2iG<!b0scC(n%qBA$>Klbayy!QArH#EU9ez6EO)%+
zy6?X#M|#oXk4bq5%6=V2Tm0tN3Ue#n*U3{nhA}v2M{OWOL;E8ylqYUzU8Wz;+Q%*r
zwY9XgjOx)G#WCf5_pUkyvWP&u0yS(JP@4PstshZpHxX>*ad$!iospOYF*tf8AeY)q
zMNPuVZg0idq7Exw<O<8pxb2hb;#}95z$)7>bI8NMh<JCFx{a1A%oPWG8N?PwpqQmy
zFUURwTMtj=*>AsnV6J!ba7bN>u`+GhR8bZ5B2Ul-v-*;)PR9L)bJF3;x{_8IOUZ<W
zFFkH+^B6=O;Ruu}dV3+iPBp=q=r{)?K7nciSvV3(B}|f<4wVLSTMd9oPFrp_LNM^t
zjubro{4l*bUV9%fwQ?6Jaq%;1-;e&XaLyEN7kJS6N~xt!JFGk!GFJK!GW`f@X$_{x
zLmSl)?1$>>OV^dWXo>&5{l%K4YgUIBdrwUh@baqP++u%9g2oTs)PZ4TH{E}2X*l?)
zqpaCxRu!y>?Uz@7EYm*71KCHA+(hy{a#8owK+SepKSBWuS|vhlhQojXE&9XT#%#wF
zK^$0*w|AyTliX_%=#C;h4(i3A1!k5*61<{dcl2{ri48rofcOI<)z|G3Jd^w`o1?yU
zunYKl)jDM<)w36G!apg7N}Z{UjW5|Gprditr4K3>kkV7clsde7tyiw#)9;#rB^Q|z
z+_UE+Kx|=HK3XL@xcK)D<jr@5jM~|i@oW2>;@6eslDS~wkDI!=cry9$ni)jS9APw~
zuYFxkM;enXvj=aYw=ybJ+PMcLu?N%|C>Qd$eETC(y~Q4bSp9lewtre;$JzgzBc*@T
z$t>H?&#xQf!kjP&%NF}M$ee{T+i7;W9lju9<ZGiYJrzOO^GQs0Mbbek$O-k(|1d+G
z(Sz5IP$Z7+Shv01UyXzq!RHAKH&Ge?+Bgc8K5bK3$cTzyt0G^}g82A~xA%+N)!++A
z^i9ZWnu+7Ujy{6N7=<EzonAEl8rMOHwHiA~8XUR}Ow83(g~m-1q)}saEi#V7;v8IY
z6pDAIP)Y=KBTplf&lX`kqSat>4M~U<6ci4o?~{=+0BQsC^lX1>LAfGEpaBHbz@|3Z
zd=rY{c6cZSI=Ek#Niej*pM{z|FU<+%y*B%-4cy!U2(1Cq)=Xc${-P=HdgeYCnK1Fk
zq3f<&b5*}<9lW0H`M9qR=cNnLh88?Gamjo5dZJH^Ri4~e11{PVsHF(0%x0)~d0M4?
zH1+?f0@9Y&8G1EMkd~`PmX1wbB6S$zM^VrjJoC@OW6jl|3SI|9!VcXg_a_gzO}`Yi
zXo!Kc(cYYru?tB3NBF-8GH!~bu~;&EBJSERFfdMbcF-Gra3MJHanlO!nEnS@tj9~&
z?dr-NF7w3#Lr!%B&YfRUQWu*s!8!-QV<jj~qfoas0A!G>Cl~<nDZkLrM95T_g7N3K
zOBG7hmEajOF1O0fU^*(MRwT4pXV^A5c6NilUIX1l+cNP^jf>|t-vq+`1o2)M_Mir4
zVB@j}4<E)LuRyKyXi;GyN%Xj_cp5=JnZzz3uOSYK=?Hs!n)C7yKMT#E${(AGDbjJ+
z3Bs7MB68_d#fsUh+@_+RMr*0nt}S^*XfRY14B+n?)nOZs*I(;U2v~OX_IF;by#oMP
z)sYkuCof=-{jzdci-$8hs3qmf7o+rgZjI!v8#YAAB9IBhuuZJov%T%ltf#+UMpS;f
z$<o?7SzNUZs`Pugqa|Cb#szx$^-d=BS)MVRRrZWh_dST20M*I4JB<g#qH8;<GpWXP
z8xtWC`LJ^oBe;H=xt$t<`7Rf8eTI}9{#uXB*2lJ|st0n@r<o4=((HGSId!z?+@XzM
zKRIjNxqDYAFU<)r+QTq*`SI$4puPCQrbjLMIiohvJG|rR=|@G<E&PQl@AF%yb42E3
zAakZ^Hy1|y1efMQwC9cX#T}*n_9T9#lW@uUu+c4~sY2AE^75qpNy?Essnp##40Kob
z9XI%J74l=cE#$X#b8El4^IU%VEpPS70#42r1=G&+RqBS9(@ka3fqe>d4xOM#Z;O`G
zMU8GGZ9@5&45EGH8@Nr11j&%iwZ+u0;hFZ&n6*eF%ZVYyRpE(=w?=!44s0>EyM-pl
z#KBFmEKdUf5jBsG{&dxtZLY1fG6p|z)<n|QVWy-iGV}NqZ)5CqVg0dHV@R?bdC@}?
z`->Y<qY@;r?%3{$*|B$Z_)KfloV^b>6%05Dailt8yJ1N6(FVz|Ai+F=N<b;y@PWSQ
zji#R7Gcs|In0XbRJCvH1y>r<A&+|}MxJ6R>j}h{9nV#jHRnWhB5Exjbr}JD7IW&$t
z>4-cLa8=^n5dWN~q^Jl56h|SJ7L5_TdA192eQNA>%JZ#%Lm*{N7&(2<cIn|ocI^+(
zFPVe%VN3;(JUV^*@|usIKP6LF;PmrXLo#fZF&<^?g_MUI)>%VG$J8$Uhaw1tVs#UL
z{<S7P05J}E2!uC*-uds|#lRE803uOVMaDOw2V;vAz}Rlj+^SGKmLyAgK(`?Q8_N!;
zIgO6o`7wwGH7mk)7IqGs06W6|e2Am<AUOCL0*bXq=3-yUVea4I8V0YBDDom0gFQ_-
zSs>CUb#>i|Kd|B`j42tbP@UyqNfH5Rr;!Tq*&f3K#Lv||a0kZ@Kd9j*-jK_w74)ds
z^)dmS))^#Ups7K_sa5J<Up29z0wX8I27m~?_|U!&f$Z=syg@9Y_S5?8Y6-<E##b>~
zK64?(!;>r^a`}##o<z4Xn+&~<87O9c>Y1xL;EUJb*7e<1bRrL`d+CCKE{@Ip_PRf8
zDzM2TdwH(52AU<JnddH*2F0LSl&W?6hhW~~E9L;EVCg4vP3ybYn!cB`Ia9iP9)<74
z^s+7t5PUd}TE8sN7sYu2GsI*e?+s$*VM{$@ldZ_g|GW+Mofu|lO;c$A{!o6o{WW`7
z$rXh-X0B^i?nDPCK>;{0Jy^o7C$h3qjiv_uUpugn|BL&4yMG1D)@gG7@J%~uka?{@
za4<iOrmS3-Y*c)H^Ua!e@}=ZwJK3BtOG^{=GSndLS%X|{qg4jMaqw-ENH#Wba+=Bi
zYkT0KF3P^$ZwuI`8zhEX7)rwc2rvU)13eO9avZux6i%H=H5;A#0_><10T00>G!JHi
zp=^g(Jk+b^@7>Gw%75FT9~V*%31}bQv~gn(P9&dzfFBjdvcvY--0EV9eob3c0gM2+
zz(>^cpF#~*!>Mcl2}&K{jbCU^P`}^6?W)5rSdowPD7{2;hUc+uw5#hz`7+`1XC&Iv
zurTyU5(;1tf&BwEK^zw!D!sI2!6b+&VsASEd-R~Rtfiq*6Hf}KB~vgyDG_r#X3)MC
zo<`LP?0g+ep`pe?r+X5<FA?gZ#qHLb8Phj58C-1QovTpcE;8Q^Q6?e4EHt1D$(ApE
z<!*?%#0H?KSEm*5157&s_yeMHDv*BVlXk#cEAF?~e);~xhd6*xlR(+y5%g+5JQpto
z3s)?dbqaggx2|_(My{3Vp%8d_USP^)2R6n5h%4;3?*(%<HRfRNp$yURUD#M)8y+AB
z<zu$xW;ws&fH2!{h}{15?Fej$io6Imph7v~x>)qBy-A3SJO&Iiq{(Gi5eX|2g4v-f
zQhrR1Ik1^br9tMs#@e-|+Dc-=Y<YmYb4WoUW1a{MPZP#3I?9TQipHe9fB$}?_K(K|
z;wKOLqlwHL)4tL@igRGZfg_RsIORwnPBCyD)udG-2|C>p)YYyJE*=yD{J!R~W}hcs
zT@}5Ua{m(A>U@1mr`l!bEf-!d4<qI%i#e`;A7w5wKUovwPN7?{{+n*A+Iy+@`&aDT
zwW|klRxMC<V_GF@;_60{Z}&sjmf8;;^f&1>N7tCHj4nnSQrqxEHPXO8Yv+ZNkP88t
z@Ic*#6P`obr^b6~ivRf<V@S2qBMre6+s5EIWED=uC=&g7NmgU~hJh+yPhG`t`W<JT
z<Yd^!a?s?>1Ufj1Q_>45K~2Gd!7C%Eug79lNpie)?b>S0v-aeXHGqMQPgV>+5N=jq
zhro!$Wf)^XGX+QF#^ogK1RWzmT^*e`l4qmx&O?%0K7hUu>CZ%(J_@=-3Uh|IN<{Yr
z+yl^Gh52I-==3KTH$f%=59G1jqC{U;FFxegK5qoTL&;RUc2eTy3DOpLV1Tr!{j)cA
z{}(WCS^_UZ034l31c3yqt*=$zfK7=I3?(Kdgu(%-0RAzO$^^F23B_kDCrV*2UmW2C
zhA!he*@Z(^2YO^UVwxBzj{kst5q#<xS?Skou6RABnVSP>cK=tqiQ60VJvpNhI4F@Y
z6A%XhBjKQXFf2`*<h<w|^q6`l>op98H4;yn0D~ZD7IX(wEgB{Cam=7Y5FOW$%ba^&
zTRFL#(5I%-(3|)X`iDvhF?Y5dB9S8G`e|x_<m^Dp`d1!9hHB6wIW4mfw8@|pAV>q1
zCVu`ZXTFdk6KXeR6)ktve_XvEqYc2~QzRKfS(z4;2eS>5fWbaRr(Y}%5>A#XyvpYe
z;3JhduO!sQ35dgA;pk%^J2TTR9{8Ykztzt6MOAfC0S0_nRhVH~CCpLDfh1R%FgG9$
zK{Ei5CP-kF>dtZlkRDi%fd3$g(J)*C!^vXO(l9br9<gK{T-<J8z`%J+9|_6Rh0nfO
zh)A$nPxK*^5)C)6bmBw>s!2O($d*;H?L<HvS{7CdNnBDc*l@GqG<0Svd^gTvCc!2$
ztZ5sX8glk)7P@#1C;+l*kgRT_ktE4}0&|gRbfgdN3v&`x%ph=Dhio6{^f|nJRU{i3
zSa$dxQsRJcI2qZ+w|jR5e6~qi{qwWesNL-WhFU;h0E6v#yMH|(Eez(oh`v8k97!-;
z5w*|#PXqmMS^K`zjUcB=pf<K1V=FDHV9Q1kSJLPxd}^ATlfdjkS#T_zQ4v7Y_wP*#
z?r$SZxScfUg(Ou!6=lp*GAdS;M4`pzq9^8vm|{TChWTAEp4~9s`&qIGIFMD^**}<j
z^e?*sJkui|Jb1tnzzqj1-jsw)=*W?)m>0Mgc^(?8>K;Z1<HgY5EDyhya2C-m3>s)*
zw@@H7Gzvqyl|nUne`iC-xmnsmP?NZ<6YNJcG1_P3ek5PMwV)+{aZMQmw^Qcff-m~d
z`2x>0L%EKG%<~0>AQ<e56gv}%Y(L+eEq$dr?OP*)GKN<1RQ{BJ?8jzIH%8r0tmac1
z<~!3PlX55dt}7gkf9*ax2*^$E?3?T%G55pSC?BLW{@1}q$uA3U)x1bf3aiIv+<N89
zJUbxk#95{9fq|i?0{k+qPe->(QT~kf`ArbX)!*@jnr4vh4nW=%d>lSO!CGXQqhOSG
z!-3Yqr;zgs%32H#hrR!tqyMrS`<)*7@Zm#_09Q=zDH(JtE-FgJ0L)Qf24J<_u>j4N
zgZJ@pQY)mHx7Bf8S_yzMfa;jjv}|36UmnVcw1X_aNI6dq6U46^(9|b$2pVxJBtXJ0
zdEqxaG-Rru;^*o&4ucyHmlG&q7YEeq8Np7n6g4kr=wY?%2NV7f@@$`Hi)4?)C2^=C
zbe#K9_{4w$5~}J$dU9Ug)wy^@B>=mLrgo!6VZk2R4(x$S^c{wS4roYJXFy&;e@>if
z{ZyR~qFU>m*R@~r=ne=OH|#2j?-?VG>0*7d(aF*fNm3C(^5ARWGI$)}lL5Iel#@qL
zfse1X)BPMkC1o3eOXJX_Vss>?U_8>kG36qIEOTKEk5$@pc-ah_X#1}XjvqX=hoMo+
zw_`^HvmRS*oiz(sRt+jmPqB}B;bt@;>x%9Z_15U$+3z5nOkuc7?FP8Gjp6O>U5EIP
zO2dEvQek;zw0f)5ZdwnZ;uF2gqHf}io}@!ReTy{<2n7B(9%|#Uc%j7BA|xPz*N)mc
z;AB)9NvP1T7)fd$9mlTIZBgV5H(OA)7{0XqR&`9b*)K|e4NtTUUWv=Oktq#b_d47I
z0~V|wvk<Vl>n}{l{>=qoCL7&F{X<;(`<H9jT4`6z*f;N?K8pGzDjYMM_Yic&BWfk}
z#w`oAjWAM(9*Ov9Z=2mB-D~b@Zva8`01srG*T?4dv+dzKpEaqVq~uR+@9fn6T*kT*
z{#YHo;T-nne^hI5emPHW^QSObL?Shf^%n2`T%!YGxL-Op@=uM;(3XFIK^!otBz(l{
zs>CZNl@(|!L$0sC5`f&LPjk7)mt*8?lgj7KhFd6Pi`zV<nt)O`@7D0Qq_<ua36+%)
z1}9i@q`J2AKAqH<H=C=8A4oF~g1W}DXV3Ny59WcK8z}3Zo6DMY9=>CWFDAJumXsce
zmz$==xKSCv;u{1lMk7OZCaE56criHlMZp!{u&PdA$&L1<l-I_ksr>zLq%P-}_w@3g
z!7<Y><+M&?3JroXbnq&y+;Z?3UN3S(Ai`C^PTPUJgoJPpeHmx3`j?VQ90yt@5{NfF
z(UANn=^YA%aVQCCW|W}l1h^mFFmH6UpNl{|+yEJ1706hlLCw>0s1M+SQS|x;RMWr=
zl+PXi2H$BzzZlmbDMus&xnDInq)`+ctK$+?CMW+RxMtp=JDX98NwiO(tytJ@UATV*
z6c>*v%g&_YP`$TuFg^@=)1gNKN3F6^x28vee`5lZs+IKDy_VsL62o2TjrO`xoxL^j
z(HK=?P#Jq5hJDHpHzG+oNe(5vMID~tZBMcLqM@+ak!S_qFWj<jdeAu0ARr}J&D)=i
zF4Vn-_j}Oj4gty#*Qk&pBisXOm%x+&TCLv0%PWrzn(?_Dt+uJw?Fs|~t3%?l4`={j
zUQ$Uyoq=q3#DS)o>bqSrN(;&UNfcpK5RtSGULooIszTGvH&MP%K;Ep1&`txhN_5gL
z#R6<HMcHf;ZA-ts|N2Z#5&mr>z!MU>O^y#F0TLnjiUN)H5d-h+FeHsoP40Lly7|Fw
zrDsO|Deg29Bc5vmST0Vl1Kmnh1kl3`_Tml6gtW8Q#bb#h0;vZ+K92!wYC3*oVpfF+
z8fG}Ax&eW_`gzFGeJY50L-=x-rU;C=5~(kRf)>v)b^Gq!D)9NjIW1mpi;<{%cIMm}
zLj=~<I6Vtwc(}O}F!b59t-wc9#!&y4Y#{%pbs?dl2If<NrVE0LhA0v{cScp77G_9)
zJmC}e@*8$}1<=1}gs}!VLp`XOR#sKnAt4J&39R*Z7p+I^UqDi^d$Lxny1ZFUb3^2f
zh+CF_&#vobxP1SawjoWNkB{%KByas^4GyxhN_|)KgWnX^cT_Wjbpp;?nk&_R4GXIe
zE-GZ)C@wPRZw@%S*^6n}?ky5sb75zEdT*y}gi@nrwpbiDFN^EY#B@s=Gk7{MbPuDZ
zefTHSfe)OP8tA$f2IGWyrC*I#i40D-U?9X*ye|`_WlJbNfYDu_)&rDxltrN*!r8DO
z2_&<}1Wyf%^sHLf3Es2MzQ%n87Dpr1d8w_+ufmzVqkQPJ{!JFKwkEPgQ+?gt1THjV
z`Cx?P4&6ylFR!!&OJ1v?G;xM#bnVX1x<T$AF7R6SnEhp)!KE9tp^uq{IyO>EW~IYR
z5PzcqAfKsiK3nXxEG#776h&Zj*IUIs<8sDt&3f8wg6jM2FPXzI01vuryG2vs#EF>E
zx)$Yh)Z|VC{Hy{1dAt66u2=2WCV=&cD@NC9Br3Y^DrYeqAQe>+fDxZmc|K4MO(Abi
zGR$l05mdg5Z#BUk1D#R_Vv6E5>;d?D;hPMu{ECc#_-l|Z%o?Lv3g3EWe-`99<ebyw
zG0!$8QExKOe{7SNve4H%wo4fw+!h3ThN;3tRWBleADPYSiJ{e%Qtts)!GJ3$D%K#}
z+1tB`a^x)590`g}W4nnDC@9@8kPzvEz+ws@oA|W8zDvXn!2rf<hRqHp&a@uZe&0Iy
zaNKP2STZU<^TOg$n~i#`9Q>hhR8{w4jKCG8gp<j+X_$IBY<3;xZ@V$Gr&<H)aR0RE
z*^9e@*QHwWzOc^Qa`WtL*{D;_2DfxM9UR+<mgM|apSoU8tK(zOCp)oxj|T1r+t2QH
zx3C!!m)0{b&gefS?v4aLI;6hr!7xT1Pq^1wby#KS5s*S)pl<&PQk?T2Uru@a+Y&FG
zi%64UZc>4;n`0bK?YvZ$nI@v9)h|yW8HrT4l#9!n{M>F$2xcq4Ph)&ZJogUf(qKIv
z#*LfItDOL%d(F&14VaLxz+ZBY=EwRyYqDhH&wQ7xh6dLP@}~>z+Vx>NL|0Ai30Muq
zldH5*w*Vhw9}Q>ep!<OCYnovsWAe1(sZ+vvzxs!T4aB@UC@%ha#a?e7Sql>n4Q)g9
zxl#{`*$TWN^(YmHKTrVK62p$xwA^v~%RZ}g+eLyr0?%HeJ>rYKZ}Z6$2@LYd<1e3t
zL7V^KTds}k*T+OgQr~Qtq3+pJ$W=LrC^5|?=8HSeJc@_!^-&oygsX(Y^|Ao3q@(|o
z!|O$xPS98JB+hiX%!)BV09f+9<1c_D4+zGzt7O>^IO^4zH_O7o@-NlZBqswAs>Gm3
zcw?5s$z>MX6JV)@f}7JV4gHES7#DR;RQdMv{|z7+U#=9J;W7gxcR{5ADVt8Z(2ApA
z_C!!k04Do|V#*t4u*I|MU^f=|%_SBT51XG4_f~IqNXi)tB&@5mZ(gCw2X0$0^h5)w
z1e69X?0D1|ARJX>uGrom70L<0555wpR22fZk^=>+wo1hyI*EJs>=aUS##U{%x-Jey
z+4@sQV$@SE6F?sM`0|$o4)A;Q=uErK?3vhjj^0evjz|C}0#gNG`7pr3m~Sp934QS9
z;b|iDee&b6U=42bbSWVUVQL17LqC%ISmd_^*r>s>knxZE@7<pqz(`IqCm{zZ7n0#x
z#Go~($B~4JplPV+>}}dU_qmimrJ$o!_3Vt0(fRYcckI~Fm4*&!1!d(V`$x!zF?aVY
ztlR0Boj;cA)s`PR!IWe794>rm**}kBEVFCd-|yhln`HiQ*!lRFm^+U4WF^YAN!N*%
z-`o{kaY&7P1m~gte|qC#qET>GdO&_oHXS!)x8SJNkNcurT2s5B0vqLd+}|ktVeWNW
z6l6{d;(yQ~VR8<vc>QDRP@XUP8^x!*+V~F)PtpA$S%}ZQ^y@$0^q&|1kGLAgZ6hIc
zK_J`RrfrJb(gl2NU%D8ct^F$`V{ZxJKOcGfLvIfM{6ETzJtm(?IlTjMH4=4i+buOf
z6ICNmF8Pyr<f!>;8&iGyC<D%?Nm)rLjkuy-5xWdMFByY3M(t^Svb88=x7%k4^h)Zr
zn*jq1#TYPw-l-TP=^N!`!}16QqFitBqbl7iMxqRpX1fWIQB2ga@5?~RP}e|L-&L`g
zbq`~eV*sA`k8&ptF@Uuebq*hY9(bpyt`?qmiPn6|tM20zefbA$WLdb<NCO9ScjeB7
z$IKr;PWvLx5G<Tzk~^`^pwf^7dQC2<P|z9>WAO~igq45HKl$=mgD65}#4R*>ek&<l
z8R51hB$zASm0xeJd7L~vt*WNBJ*m#jgw^sVDxya(mYFj;Wz)fLln<$Y^5h9<2fW=H
z=J@b6i3KuRU&n_!(@;VI)_tbd;U!qHPa>3O9>KG1_s(AjPh>68#3|nW7Vmj_NqFy{
zxKw`TwZ0!la3bjW`QKdT-P^YhunIsCveoc7zcYSZcjEqsLiQb}AqWui5aj2#sdhu`
zBy=<oWXug4H|o@;`+iVOaSF@Q6U2RMXtcewD&{#1IOR0QFEurF)%#cEhZ5Jg<#7Gw
z*_ikw6R_QG*aZ2?XzX9{c11Woi+fZ|4dRISL++MCFgveq2akke022F0<<@_iod4Mk
zFger|4<RF$Nw>(8`vuq(%NUU{-A3R0VxrH+Zm`BJA4Fc?ZzlfP*6E=%dF`*d-~W$i
zoBki(h#!3fU+p1~13E&(CPBwbHLn-t#sF19TL)JJvsPtENg~n>Qz6v>P$e*p2$lj}
z<lT|8f5&*SOTu@OEdJ=t6|p1VF}gYRLMaCn`Q!lDr~oI^6Vz651<(e{J4e8eU-HPj
zNztL7-HfO(U~;TK9@;a9k$T>_bBAPRgj|E}u-!=WNhJ+=aQ*#SG6R`ZA2w?L9YB=5
z-&{e*D5p_C0<i$-Oi>iUF-PtLx&Wc^Ksx3aJr(#WN798=RK7d<b2M?vm%bx>I?Dl0
z`q`Ss+*`-1bnNBd@!cVzpAXkvt?LyT$p7#`?)e<{gleYE{>8Qemzs0+=?FUcK_tFa
zolj~mK#-Nuv77^jPR)yR@<1MXv5x*{H;bg9ZG(vt)T>UE*WeS5#`W9Y_Ok!lBKNnE
zzRf&x-2Cy2<g}r63psDLboH;&o-iNQN@?i6Fe<Z;)wKK5(s1Qyq(UcoeG_4}ChDq8
zWFy+WlVI$N&Em<Qv@FsW42UqO8e)7N47}Oe*_p<i=3YWMtp6pr`NJwrBo<i56LjE;
z>#Svgs2v>WY;Pw-cwl^*c*7&;*{j{W)j7wY5u~ztVPQxUk#?@Lc8xxYp!DDU-de_u
zJIo{Jw9PT0(%)S-)+#Kj@kZ3Nn<Uq33AeJca{>nrd`!!Ii`;O*$tg)r1NDI7_D?qI
z7`)le2wBNCx&@oMKP8}U?IXA?98*qD1mKvN9Hr>51Q3TnvKu2#GYJa?(SG<;47?`*
z=_r(JFy9gE?G5YKUj%mJ1Yr3=P*6OoV|+qFRW}9ZtTe@=V4KIPSIALO;Fv@kEDF5)
z2&rk?sPF%IYP$TB_u0(|kyn3r!N-H!!KLOIeb=`)BCSG2_Z#2~c-1Fq6{pYWBF_Xp
ziA^U!9^^mTFRbLMn2^X%vN#S`Y}}}~de`G!%#~cFpZzwPHj($}%kYGTn%eIs%`I>>
z)4QJ3^=cxDzRsWQ?T5E_Rt&ftpxeC&7r>zFsNh4B#fFaI+o@HTEzXr~r+BPeb6EQ|
zo(a(QB#_7I2>I0nyiL1T4kbx`Tx|kW5OfA-#ynfx9S$egw+V1AdXd5T*InGnTPOb?
zb{pKN&F<^)z<_LZYtyMaPcwC|6b*>+mQu|}U-&<Kc=6_L%#`z*RM|#y&HErE2&}x{
z(_;p(Y{CiMCh{RcY;PLi@2|s-SXx_KODUP?o&erTViuqPHYe^Q%anKhf+m*pTP=B&
zLsNIYBsKg)KE6%s#IMS_Kp?{#<u>rxOO~xWbGrZPa>4slZkfKwHGlnhqrbQ;tZ09*
zIxNes_bHMwrp)jpp!1#L&QEs#xMInoqgK;AsOw=f^njnM3NqtJK;HEGv2Tt@9Kmk$
ziM+q-(BJ6{Z|ky)nk&L20Se`Bbw*z12xOwDpr8UpM4gsFlr_4+E2sivlke0d0*OfA
z7euL*PVkpw;B`O0aPG%9zuNY4zD_0VCXXw-o(Wk79ik`r$_UMbEM0VuS=`7+$r2z_
z)KY73m%x2~3L4d-z9azWsPC<aaQg94R=ehRg#pc~DU;(WIn_x}Y!Ng6<dhVYsUwgp
zBepw1AY^DPJj2Q06A{t8dG@rb#E)M;v}|5#B#5S@8n!JRU9#Hfc=Rg=j7}J1c)BGS
z?tfpp?!e+XZD1U{|Jhyozxl#7+}$LfJt*TUTe<V0zrknxA9>`%A+P^`@5BEW&5X$_
z|IHIl9>tA4BmrUr5!-$-UA~gBs65t=R=ttWbb09`4c)T_*O$c}nP9Gxf9@5QGCX<;
ziCe;e6-vFIDrd`X)(Io+c_GV!R|B<^ky@V8B0@Tz0mE6IY;Lh0YL*8t7#u<hC0KM}
zh21fjd4wt3_2n2aj63v?9IoETVY)n2y_X&%pi#XsP$*VZ`+85z9rf{`8aw1idn6{S
z>#ISOLhf{OYPCEVz<P=5^6yayX`f>CH9ESivzyHybf^S{_Jq&THvg%g*SuS>=I8d)
zR;ueU;#}{z{@~4KKEA7)mOSD5>&Ek|+vnf8YyIb6e=OU+?8*GQ!SnAn81Jd@Pb-|B
z{Y^-*s-aN$4_9fP)mu|bOFE|>O}KRiwfPp_JNr(2huOPiWpmM>g9i^%X($Vci;Ew)
z%Po-An23%=ni?qSZ}LLD<n~SpgZ{I(7NU1*a09p`p}JZFoscK!=uT|6m1qrC^{ISV
zzjhSa+$)yovI^rrVd~*b@+Cbz)=n&v&NzOv;Y~n{Bdu-Y9_za$-4Ar-f``7n7fL^t
z>80~*N{D=XCB{p}V<ha;!3ZG77iNP40yb66A9=)#Zd%lJOk&oTPA{3CTGf5e(Zbj|
zEOR-To4&Lz`s;k#Uw{4eNRGVqA+C;c;#DFKDb3@c-2ZcJw+LJI8^`|3iX-@=xu4&b
zE}NTzhkre(0{=7jbNcH1e+=Q;^*_j@6pDZNzYwK`i!T1S*kkAJIU#oZ``%ywFF$&_
zcoQ}YhHJccvn-FPEg$>-8KO2m);Y76H8Lp1PcC|YY+%g_wH{wnJhj<VG`-azFaMwz
zg|c>w@qf$L{C9kU|NLmYzW<kY%m3}Q_Td^>xK<GjaOhWzARV8CbOe!`8sr?Ls}d#R
zrJLBIvUr%a8x~z$&3Q+~{+}5EqL(T_`rH*zY&2^Q@*`<cfWBWiDu)O#M9%*810X)U
zy>%@Y%MOE&r4g{9TY?1Wqv$2Lhyp9=<OLcW0p=)aV_&-NpReOy)Wr%EvkVPZiU#W;
z8ZrMKGzf?WDUuEj47&yMC$habfS~(J*ZkXWT|~=g7nm;oR8Uv4-n9a}?x{@(Vs|rL
z_GW{Lc$(-1%PJ)7uDt@uLxB!_uEpjNx;{1NBlyh^(t@~x`~<Ihx%6=)I2bfKpC*W5
zk<_r_U{JZ}ksykF*qI2n33#qw#s|>?-u*14Y?*la6{|yBgG#UWS>IieabutAFug!P
zt!?8L>$~@iEpA*cd8_+u{86KUt=BPhw7h7J@GF=S@Ugjjv-AT0n9X+XbD`&oEz<L)
z(uEkx(#`c$Ufz6R`|SfM$I37s`<UE39Rl@7KKcFmKImKf5XMAtx9z0BZru$iK9R8A
ztrasv<iJ~95~wb<)B2C#hV4f!T25AHQ?2i=&p6)kzqR+}VKwJ}yq3Wj+t^Z6W{5#q
zQi)bW=twEFphRgQm9%SP5ZZ8tq!mRWCG9&>4J}9ea#~b6M=N#OPs@G1oB1vGkNe!`
z-aqbNcOJjz`I%`s-{tdOUhmiI^|t%CQC7owsQCfAX*;K>=;L_dUw_>=lcCaJeKYuY
zv>5bfojqZoCF1S|<c%7BEko~w9wAra#J@j<snpz@8;*;525_s+Vwy*)9gre9whw}X
zh5Ose_A!YvBOb9VGR~*NPOhlHe&~YSzXRl`b<<q)kdfK|G2X?ZtnDEhJg#Q;%;g0s
zc(SN|y&Lmi9C`M*uC6*P9E7~H9Fskx<|!;u*}1zhkF_a&dZWlxiZu;np{e}rgqkh~
zOgQ$-$qXQoQc}Sa;=Q;EA`fV6H*ELrK~G(@;Cfx7j_ML5`CQKO`vpt6K3-16EAi9z
zN3i6vqOmacs#Nkdj@<+HBFpjb!EDeJkLU$#H~c&hth~t5$`)xN`CR}U;6mvOZhLW(
zR6>=VESJc!s`eIIKH>$lqXU)e@{ulXUY(W@feAV^pWXExjzW%?S0O`26j;BPi>Zf6
zEXaAoZVFK8KvMPN`q=YMCmbbz`|Y<=ji-;sb=~RRR4R7J3blK#m-NlM$4M`}R$N)x
z5I@4EI7;;a=nP9AE^bqI1M9R%_9!l3_8_Mm`-&r`F}W+=sL0KaXx<a3^0CM&ImkAs
ztnENl9dy5o9IP-s6W^A+rgWAl&O)xzoBauoAMyp^mZP51?C)YFk1^A(%xxIT$|&or
zMYOyzjbGDQ=Z`nw74LdZ)4GAFI;&ba!?j;QK$+cNi;+-xwMDoJU-PZ4Rs7?Ba;K5w
zzWZf*=pWWFFroR*Uv;uE%Z(WU0@8n<rgb~j(6>mlHdSZ3B(qGwRsNNc*7>@iS@d5A
zSYy_bhxY9jmnWGz5G3OOWAscSg}>EmbuIrIJGEV!*5^U2BfL0`t~_7R3(uSo?*vhu
z`1n{6Uy){Sp$#XD_i3aJ068@_GW6nxr#AoKN1yHT)PJ0K;X2&AT*)<sMA|SWJ&Q<~
zD;f)*c^X=Wb)@NU+7Y4=Ci~aTwf~L@#p`yum_rv0j?#0`e9WQclye<=g=#N$lR?_o
z_7}0+zUc+8``7RJ<&M^+fkU7yf%0xZ<iTAhBEb|u&^uiCpNsLa`2UG}%B%k_n9g~g
z6712KRs#NP0FI=QXqBx~^|_>g{9Ah;b2x6QcaDFp8y52XHC@q0X{FkiG5^0(Q}s7V
zg{gd0+g}&AHbj)KzCXHdk<8}xaksQCcpq5B<%B9Pvaymk@GDdKxbaT@^3**~r7y_C
z-N9IN@svyET9@|jB$FzVa87cnpd4C`V1X^~zvIAu0)z4;TzeH7+5*s7lg9>w33IV&
zkRh%q7Fs$C%Me048Iy867;)zA2ww$r=xd}$oYaNLoP2X>yV;R1Fz76Sx5+97<~IQl
z{MXXIB+UdYx5dzes2>99ry0=<(339QF>Z^|6c}mG7ZL5^K<6`Tm;Z=EzGJNy3={P{
zPep-bI|3N4ImGV_=yv2VBi2TgAs9o@6^ueBoCZ8Wi~-fvRxVRzi(|LGZ4BvHigs*Y
zm@z)m!Lco$vpM4-xwYV0gm8l3J0Qj&wF(qnf6^x;jyN*$nn|h6QL_*Vq;MYGbA7=|
zozx4heK=wH@*;;}IEAnJjX@N8Fn}}ZTS3RHg1w@|BvG53KkzTHCVb6uY4h7+liGTG
z6pG(MQl?Y}FbP~aKpq^yQX6_9zB~h_Br}2>FQBHriQ6y}h5;~Z+|Q)a1=%-u$7(pO
z?K28l{;%QhcH{r+TK%6_@1_M9TptSx{uCo5#KEQ6)wBo1#Sd+E8=!Os4dbSx+}g;p
zXCUXRGw(uNiC&T(Is*0x<i%?k4<0;tj$u5m;Q};u#2#fHd9r_L2n;t7(f=AB<C9E>
zaj3t&!X7Rw`S@O<EMhpnh5?a@_TIgF@x8AJQ3p8ABsS3wVL!Tefb1Xzye|eRu0nCm
zl4OUjV~j({7<i)ux#zsl8Nuk#ml*+OU^_&j-ne7reFAkTg9+!SbK2OVi08ZmaSIlX
z*w6q&#SOYK!g!>e?Bs)!)Ly`YYACR7;d_Zj7ryV-ekM^c`uh6*d8WFPHaIY{LoMTl
zFC%3c`ZyF3&+spMH1feKAjUrfZbpH4)<5INe`#$cKM5w~NxbIAD7B%c!SrB4b+X8U
zY*>~)n$!1(U|+0W-*aL`S3~A;kkGLT?b+ddtsn2v<s?}*#sF<&FmcII<>lqu&3>4&
zv+ci{FO}xtVseD0f3}DJ@81PgKgVgWpyB>s6vMxErYE`NKR+Dlhvt`v(SUESEoB=<
z174d|SXMQF!G{iF)hBG2BymVk(NkQBE)E>A^C42jT=NO2eHQrqBOsCxG6z79blr2)
zJX~8ZLMX8wt{*TM`h*Jl2z*XSXN?JiHX_2i+KF-hGcY5<CYBW!8p-Vn7r${p_I|+{
zqH!Vzf`+OC_SvrPFe2gMb|LvQ0kYElL0%dve7j|CHs2Zajj4R)x;U(rJ+Kj~J~I#g
zF=fyiF=?&@7X~&xBT;+_|J30NkdyYqx&q+^ig5}AEzF=(g2z%XJjohro<pt%qzu2e
zK^t`JWzXPcAP4fs>f!>I4A`0;z<;})({wxHcCsZZ^kXUKAAzp?3|>tyU>!^3F0w8`
zQLS<prAj&E7vz#fBOjaqP&JwLR`<)=<~j-At<<x%=7WG20m}MUa3z@$`|oX_Sq;M6
zK2^z#d;r^JyOjJg_r!ORmja4@llYp^yp=L%@51?Ki9Nf)wJ2n~*00s}tXS7R@nGk)
zggs@~dp=u-DlNV$H<*7`VMb8?>L$foV4@yJ`Sl!AgW6>4SSTF=Sh5ZKZ6)%I*f}EJ
zC4I-G`D?3FHo$D=Sz*iNp^jTHP#MFE>$A>1V?Y-5U!JL;=fZDdCw+nUe1&9L%KLUG
z)dl~wMD2P_d4AG5+dEP*SvZIlp?_jJq1_xuq<Nf)se`N}OZGb}9#d^o35x3&ye_lq
zCoVU$&utr)QyA-Nq+0+P%1?oY5+nJ#KDgX=m{y3#ox@2YGl=U;l<(F-0MTiitr|Jv
zf`E}*$pYO6-X86a$0NRv(1SG+^bB=so{bJhgLwq5?L`5S;pKzJLH5IUMxzlMD(VNt
zTMI4S>W>ADPP1i@iD6hg{sf15*uW92P*hl|)v3_0Y8Zl4RGoUSQg4n4d$*8vR$eWX
zAG_uJGIP(erwb`wOn``ASeu>Y_5M*|2ttT|M1W%C-qNgC%LTeoJi9aANek41vYkf`
z{M=sGh*vl&|L{878YIHI!NTLiTi<eee0=6+j`kL;@yd82BVe4^b;l=HmA^62ZSlvH
zpVkWSQnH<;?~ebNXE^HAX^k#*q1n!`N2Kxrl?-pc8qvKj4t5g&1qJ>=B=8JuI(Q6~
zQ9CTX7s%^?HH^Z{5mEg)YC$+5MUjFSabD59Q`5)*PJL-`=J(1?n;7S-ojVA{5MEX@
zf$2CbPoc0{kF&#4;zuKlKEV{v0909R(4_6bX(VP7X^4o%h<mjks{y27v@`~l)|y&j
zm>ZxSUO?o=`vwjVs7gRP*MSvG$ak3$Skds63I%voOz-wE?15u2*-XuYNg7ThG7Wio
z>A5*VgJOXXd_gYc)L^FBM9Q4cbj4(l1n)C*Fv~EO8WdU$QXbdcuOdYO)fC(TCF5_@
z!XTs``>EHAuwC2`t?=qSM@*r&A1qG<tkv!DdR$Hc;u*N~a#U%<Im)JPfDPN!M3Vvm
z8dSn<TNB}lWXBkEP?>_@leJbO*gRBZrPYb<p3=vA=8%sPJ|8mz6^14#$Ok?NLPK5&
zPmFu`J`xs!JRJw7B&6<92&Ww+$igT_NXv>2G&VSe<Ca@MY>l6ihV4IgU|Cv#J&o%I
z$j99Oew}X|C$-C}TS<NY{!&yQGDujr^MYdI1U}kyswJ?MJjPvlov%TIz1ml|#EMOv
zIrJxEc|tH!L65@W;eGIXz>+Od!prF%tx}t<<E_2YU%)WG_`$03)NB-ATDKxk@`k|e
zTh%asP@w_Wr5&Sx6kR1g6o#~sB$K3|NCJ@t5R8o)GuFL~6MSKL>$Jo%MHatS_K}Y`
zgM7+hf@Gn_>Dl>5e?D5OL=<l~n)8i4rUQaZnb{{qsvZ1Ha`eMxlisZ6+%_~a+OTb+
zm=47omP-s?7qI{fk@L+uYxt=UK!aJnBKxBO;yhA`MkC{2E$X;%w_N`!OT6DO+6urT
zEPY=gsXT=hCxP&!!SCH3E+Or~w#8cTqk3@g;TSE%S!5Y%UwM?&d8AB}s+vA){yGec
zP&ZWIfvjhYVB&U#UPpky?n6zpY=h{%@9gY+HDU#U)xyEdbPwol*5qs{6okruTUF7A
z4?RNRxP3%JW{nAZ+w4He5}ys0b)<ZE%5K0I>q{CNI_`_>YC!c>i9J}4v9OFh4Ymbs
ze5~YcZ`DAR3z1`~YXZSte~>+?kOR$mQtJb+N8F%$umr?dOdF3@Y<+V^T}vzE7IYiQ
z!RiCu9vc|;#82Tv0r~=8h$!xJZd(v;=n*V*#iQKOTxXTpufyw9a`Ykhb|~B)?e!5n
zb;2vhDtVc=)^g(_TXrVDyy^T`Yyd08le<#9cs%dey8O7!B~~tADb!3nQj)#K9>7rl
zr2D5P@A~eEHChs3hgY9b)>+kM_#*fD0<|mI#@qu7+v~D%v!n73uj38D?|4~B4eL;e
z0_a-yJA~)sVlb_K0qGt`!5yC&_w_~f#V3-J!Ow5c3$C*ve{H$Vy|6Ir8inqI>&8k@
z2;XS==M7r7^ZsMtFi7oUUuE7uhB1n>fC@63ngZ4@Sh-)!M#=ul$a$h$L|n7e+z9r`
zX1PiEwg!x|I1q8$6s!7+b9q~T7$0Dfy5eEMP;D`e?W^hwO?iWLo4#58R2~zFpfA&z
zk;!g=`sAiyXa`8*TTaf;Qjyw}$!EKa?Hm(15ap(`Je8!gI3T2f^$xkCUCS@pGPe~p
zT{-*pvkW(-ep!@lbEUOaJR6zzsxU2Sgs9Uh<#)U-^8{rDQl0Zu)z!6qm&=HS$Q_o|
zoNHa;C-cmlUB6OTCCzO-FHn0|jRQjt3tHA(bDVp<HtCcgUUa?cj{M#oOYhuFT421s
z*4PYS3AILcxRG;Sduyz-ogf`2gJaKKz4V-DGLx&|4%zUlO5a>PpNgdW0}7%(*=~!y
zZA@B)e`duA`l<vjn>yvk88ghii9CRs_#$@PR74(JNn%M-20gJfH8E+!>%csn^=5$M
z{%8=X+jD7w?zwMz<3{@yV?=?w7uvDER9n|T`?309T7$=+YkZUSM2hz>m;HMZLmH}P
z&XdjJIt<sY_2|0T+o1dCOIN)E5)DhR!TRSvd{=t(gnuY%92p;x576Wnw%56j51Wy5
zB3zh2gDWk}Ug4?L&Mz{Je}=As`Nc7d6jE<eF8B7{Geo($+v}8|XVyr&IHT7kPgjDo
z(?b#sb)gi84EVNqCY$F6a+A_o4qm7EqrNiY*V4LR;1U|~-LL6<t>2gBMRBegdrm*@
z%F(--8)pks6>|L}UO)DhoFKyc?86E_nRFY%lr5q;*7)7hj|x_6Sk4)UYo}hW=%U-2
zZ!EeXuQBUpZp!Pk^KT65`RsjM=sji1RWFO3$4RCDABGW>Fa78d1I+4@%u99=@ds)y
z*O)<)yuhUK$Mj5M_>h8Sm=AT07z34Ougl?|21N?tf3ti`lB0xST&D4`w}`sLx7NCj
zv<aN2{zaA-V>*ThCz}`H`PUoAkT6!Ym3wo}4>SR^bmgo#>&kL#wg?(c?AVB|j#QyY
ze-)rVlTj*}=bYPi{L}acSfZgfV2##ybhDE;o6m1}EOftNtjog9WAbe`HL(I9N5qnH
zD3y5XfkFIvd(UtyvpqZjLG35u72**wTX>5kux0U?b56K9M~Efa^v&XBgCrPKXWe%m
zf{`et5Xz3|wC+LIgDyP4Y)0;eWFVWcJ4E1uM>7L)jc8B6kQV>z`Kd+vRluljDSJRv
z@ggxl-Hm@(ZlUv&JzF>S#70JKicL7YD~cEKbfqn;qO>UR_N3RrI-?IV#j{Xb=5jO~
zZGIDAJ-a+)p&V$beE4eZbsevYxH1d_sP7_eU30Ft4Dtfw5TdLdcGEux9pTi{CC2@=
zB^#^jvf;N0hpI+wrxn}vAiv)BsKjt!eop3G^#o%{0k&wYvqHd5{@PlbrCkc$)}r$g
zl~?&%KT!#w12${MS3ww(Py+>7))Uy}2W~c{(iu#O=Xk4sH~g~Pb76^0Mx9wk8o2ms
z8&2r;;;=Ep!Zt^iwGFB#{@3GY<YozQPgG@Q#Zo*QP3K!&x?C)<Zr!@uN6LT88o1>c
zq!AfkEs`?5%fq8baqwpLnBe}#)cp6<kVC=k1{(-U8==U9562Ea+BE~c-f&@~ZT-m|
zPTr>a7Y7|5+UI-#Hmm$aDSm4*h$ZBai+t3}c0a?_K^V_OekJ`GX#<QpU?Um@S5SJz
z!voD$2`wh+vc}TsFmDylgb<GN8t=}r45v73vk-RB_ecePuSzxt%0FVz;R(f-kO6i#
zaAc?M60(jHwCJ{UY<wjnE?%I}QfbS!PHCD61fjspM>FqO^tE`Dxz_jX&RX@!cmOT9
z!FC6>GJR7zDmI=OE2-YhB)@rw40B+0{eaY-?QZ5z^dMVHH$a#@gaX43TQbg~K%j;V
z?Ww8zt19RO?BQ1o?%q5(f1|%2wFfF@YWcJb;uXrBM_~y0i58*UVBgUwTHn1wo{#6g
z&^u1h+Y(;Qq6c2NEiOv&%Khi5*WDLUyX!2c#o04u%DdmE%IznsLwE)Bp&$>ML3XWC
z&@!eWzG`Q=4&OGm@2b^CAM7jlo1=}C=H&|BJl}%WUjEE{dH>kz%SO)QqLvb@W%k|n
z^&R|UESI1<565h+IenZDyrSUjv6kUvU=qH<I}VWn9Wh`~RL;cswArP5u?PQMV`CYV
zYVa5MiV6pvtO2PKNggP!8&eKE>^bU~vrvhWa(r4+*Lc0|c-Fw~hdnLp18v&s8{byW
zTSJ;bL<%Lm4I7ft`k6yrLWQ1d@v?4f&G)O50oaWwg!90tB0ArD=hQu0*Vf(NwH@#a
zm5o$eQ#be#&NUcFkvf)?!fP41o0J!wvGP2%B;9J1Ud~fFGfCU}#aUX%xF}PxJGKMf
z6WVZ1SRdDA%PG`Cm{EKG<F?A^pWBlnQJw>5(8W<D!z~6WVf&z}6bQ;juhDa(wj2F(
zoLlpYF6^Echf%?{pqJHkZQ~!EBtofVVg3^W;@hhk8X7w2Pb=UWffmIAFWa$KColg)
zM?!*U7^K;0A%qaB6lSKE*Pa+2xzlz6UqCi)Q3Jc9ctdFE%26|uthhNz?B2RhF2ya6
z1m+sc2!z)UI2E?My_#mdN=P>@Fn_El{Lw%@ia?4m?Rd3r@D)PV@m5Wl()4(W$Tj%C
zmX5ZcezN~wIf82<P!}WuFN+i1>87(bWI1ICE;w?d->+31`M@JC+_!bO!j>g}1yqDm
zv!Dj+?RYsRzPYI%GAy__(fL7Y9Ed_cHjKVNi96|#jk@d-ztNDAg0=Dp-vxpmzzKa=
zl(-JF7~m{mM3EV)Hg=y8HxPz1&T&EJ!)MuUI(K77-9k*3wjb3j@lpFWK0nFoRmR+$
zPiW_s=!6};LoGHcO0CZM9SwCeu9p^DqJY1MizHAG0=Z+jv822MYqAfS@GJgzcgfI9
zjklZ!s(Dw_U%__C4sB&SHkNH!c@Qc+m~D`K8|C0yFh|Q%2{Br|*XK466~G`e_U%W=
zo0%MA@Ou|-@m#{DKB@FshbijqnChgk?KZo}Mi#aVIud)=8E>q7SK}~P^_ODowc{`!
zTEwe@n0t2`<E|syvB5dA(ZtQ|TD?nmUvbg#DAuz(Nh^z!!q&fQ+bw>tGOp$Pc01@j
ziMvYn*yLMCN^h9_RG_DQj=#4d(<DW^C2MlVX>f}?hGCFTl&>boW>9~d$;Ty`xUUPX
z4??UfjV6K7yW`fufGxj9#23<AQuE($Noc-XQFv2dKC+;9>(96T2_~!Fs{a`N`RE(W
zG&O-pFKS-<b9el#$ywY3IFvIYy(BK5aB|7-UCNgC&#o?c&-99s?@WzxaWnk8OaRuv
zxa@tRTgqsf!Sq^@M$`B+s2|g?MT>mN12zZ$SH_6?Hrnros9Cs-+Z_vEnU#Z83*B13
zS+O%uyy{uJ-zuw_U$F5LiZ(V-GxDz`Bl=e(g<f?q&n7gr9nJHP7rWk+7H-_UnWf-8
z1fL5{oM2en8o5W=AR+}+sm!%ITyc_jK+L!q<K?X@(+6rT++u9u=A|mv-+z=9|0evy
zMjSvyg>tGdu=i#RQS=yA_q`E}6SW9scW?IO=iTU*DzBG(Cu9-#bAjbxaJEA18W9cl
z9V=UWeyj;!%qYd{lJiks;2k9e3I3L2Pux0HBl93{+Z$)B#4I>>Rs3%11SSBwu<?N%
z;36COM}^EpYdF9CGKHb?`;nIJ)K2Az;aiQ)3i?@`9t6KlpXK62y-UuyDC8Oa@~AsV
zHBUR5YvaK)2b^}MsO+Zn=4n%Yo?U#&Zx>lTz@WSX!HGQRW!y)huEmY009BQ|9!}NQ
ziRs8PpXtRt79)F0_t-scn>dJCvL{hvXBpvvE|U+`YbZ#qvY&9n0Ax*VpMDkZTlc#|
z>#8*8+s!j~TnNJ<as+_=N=m1Li|XVFw|BGr6IFM6`cBI#;Bg?R|9Lc^w@SHtT0*Q~
zchU<0JlGbn`s>handFmfPJLrm<zQ7~Xx-)pS`zw-k4FhJq-Bh)tXF+s#xE5ZRLh<J
zd<h=H?Y3;A5H>M88IdtHUxjiG0|J%-1_8&2XVebVRKD%)E&fK=l6~j1NKSl|JNhub
zek71U4hsWMj=J*dq9WUD^nzn>XRd^63*n>LlF@<|4TkCiOLNAi1_jCE$aW!srD1@x
zhJiaKW&K)klXz0SqKAl*>-NV<;U#z>Kt(%&-|s!LLuSz<EB=FbUP?ZD&xputL>|U<
z1d%->FJ~hVpcgS|`>`e}tQ_AI){)!0_Ufa;F<69Nqe&;AM{`)NE?oKsrJW-8HPohI
zJf{c+ZV#$i1`3w%sliK)B?B!t7op5MKcJq{(vFQMm9Q{2N^3++k6Z4o!z#PEZSt{)
zranFyUvuQ;F&Q#H!gef}jkdslO4hO=<0vf~Am4M+&|{*E3Cx`3ECZjpgJFZdr%{|2
zNu3)DiEG^yOlvfz+V=iC*xzj3WR-fKr?1P*!W~&;nO4<5p3a@a@ZfXdTRSJk2c`fp
zG>kZ$TTMpNdv0nDWM>bBc8t`nWp(vdI9{%G2z!=>3NWn0C8opOrb{HJK8bHJ@iy;Z
zRH}3Sg1bT4{bT*fL0s=a<TlTGGaU}6BV{0?`&Cf-x9H*`H_w9)-~GW2N>b$tu}0C=
zE;-}_+!1Nf;84l+H4O@l!XqwHf*Mv0Y_5Cwx8fRkPi;aK#zexqgQC-%^O3siJiPB}
zv%5p#72B$;$u9X`C{xQVSH1eW%j~BYBU=Qbw>tpVBzXhsWNmafr7)QxHxk~36@>nX
zx(}TKF>(866L+JYTCJZfyB(DUzHT*rdv)tAmtqqg*YquV<2vYe&!t!JoVGM|2c6Hq
zmp&w1Fou%cw?Z%BLa4?U=Y>-)o!7kNw-9dypvE(AE=?udIT`3DDB;qq0FGG|X#c6M
zf~De%#@Izbg0xX3%;AS|?N#ejQ?f<j+0(hG>kEfN#Ogao`n3CZvRj1;_>SN7E>mX=
zKxYzrcowDCVO55ei24eKQ}}FUC^q`i@vxQyKXzW*gTUsU`SV=RqP@SR#td$Aw!R;m
z#j6@XZYrAg0V%*O=36TH&mUjqX~u>VL|@Pq<;e^@a6(zrLoIUT9O^gHXjh;DL479C
zsT98|8ITfRF{a*7w+QJ1)-qxY;J0qizHqYKo8W3Smh~&IuoX5vbHz6s4wKi<ulXqe
zAH~SL@4HYHPrL#p*G)ND))-KKXGJYX$x<oLd&cS;Y6mda81iXy=0u<-&ky8V-wBp6
zt4MMwHXOG~S`yu*3WqaYBw%TeTLV;zU$Mlge6Hl96Mai0XG;QLUUC@*8eU1Bvw*Di
z(E(M!26h2R+-hW}fr;nR(xcgN7rWM7+cro_VkTg$uBfc>mFGkqStbx34i3)?GIuI&
zp%#{v|5Didj+M(9)LAO8t=|dhqKfgy41-f*p8xnB&+c(C+HsXXrX|b(o=Wau^F$T&
zs11de)FU+VXFzhmAW838oyt?x=C5ncjlhON8Z#u`On0&t$4f})ErK#XLn{w`BAI@7
zVAEr-PzO93B|TOGX%!ORu_INb^JH9_<2TVm#6%~UQlhPVP6Ex!u)Q{kRMT)I4>B7Z
zVrwwym-NA?y`DRc;n$v<+veqbLa}C@rI`f~u2AZ?cl8rl&1#1La~D~n#0VU|x07Yh
z!g7{*f?M9yk$rRpR!fjek`ccTW<M1`vq|g2kh8yk9(|)@SPIXfF{3DijXtw5X?pJW
z?r*9CYOm_*oYljW42Fk?f9JEun%yv~W{w(G$&04WsI~5PLaAJC3!W0wdHrRw7a`}2
zSEq8sLel(O$Uqb3rv-(ZnHd>8TaPWxO5Wm{K8OZ1M}ybI18jkon<pZ7r1V*QGy;_c
z9yY*7vQ5Fd(GGG5bC96lPCHrfQ|Wy`9)P{Nk)%TYF}wnkF7z~XXteY@ot>KOhC<LZ
z4A#<zF?Cy))YYvv{o2+Bd~Jk6awcp=2(sF(R7^507<;Re^`)1k3o<#NWUFFB039Vj
zA$5)1XD3=3DsVMe{Ao_fZV>3d@1)oBc;eY70Cle=s7HpIk8BBDwZnmI#}r4u=a3W5
zh9glA$=(bgP8qq2;jzBjR4-r=YC8ckPCvGu1eujyWQ~Q&O8Z^qD!^{ej(6d3122WE
z-n6TA$1RtJH)-&kL)R+H?E%`&levHVjL#nNBt-!Ps5=Nyc@=1}C4&C$4E6!gR<jRP
zGT@?p9E}so%Hqyb6NafCa&<VxMU+{r-hs*(gBJ+$L#{NLxroA)7MwK4p?f&Ac<ljA
z1gavb)6;T)S|aZs_wFd`CF)b+0a;~_Iq<Au#LI1+=bD&~n|H}_=EYx~CdLLk;DzS5
zAuHQH-SJxthAcUCvFPK0Q5gQ!!S8TcpD^CDbTx1Q_{vFUSDuZpDIDue4a36Dy_pyt
z`G3)Qp|g=d!`#Y7G=Voe){Jx{Ytlq6by!ZL&Kc{Cbzl>JW5~%*IvG|&<dsd+sK$O8
z<{%(-pa+>N9}5d=8rv{6GC%YV+JD6`v<=LQ%?pijU#LeNZ8$(KhLcm{1~Z(^xx?z&
zj&oUY9P82aJyMnA`TzTsnfFra_C{fP8pPGZ(k-u=&4+r1OKs)hdK`fp_8{BE+U23e
z;hD7#9vC!5Q)vKw%Eh=AvAU$+4g@@ez9caF`c_BWa6OjdU@%52OX88IYH#J5{HSnC
zetq9~;xTDA!GjGvyLJ8&M<3&eM1e>-RXN!Ez9x4ZpMWq^E#JtKwlx?}F4uY_f7e-I
z_3GWIj5kU8@3)Z1yU5NF^1f3%y`(ttZQi}0dw<XRxD~4Z!n#wiSPHC#U|6)AKB4jM
zEIEFGRt3*I;f;n_`b112HtQ3$Wd_*2dCJYJTU-at#Swu00M*5#tMBCXCM%K+9xS_P
zoe#;{z#gTc2zia+F#+_wYPV4Vc@TGIiA9xeQ0TSSJ8f2g%wRV$t38}XS{V8Dr^fJm
zg{?sNAVMomXfVGs#~cvF%V9A0zSzl;f5sxV!2SuEjuX)qogP?f)JFo~sIZ>Pa%*u@
z+?9+wyH{aTeJaMXyQy<yjn6mH=hLeK<oA!<%`fXv0?D9TB9~?27j-(ML$8P?m`pN_
zWWgSc)$}XC9Di7%9Z<SDN}qI0<jAiZ-TRAO*M3Sv@FWM;2iEW36}>$4WIt6!G|qVm
z!&!W2;_x_2;EQJ|&KH|#Y1|kXhvOkbxNn$i?@gdo(ZFLcRDrqbGrTP$n1Krq2!H!v
znC&#K`02V+w?*kliv=4B!Iuae7?BnPXCpj6N9;BvlO%)+c;p(+C{om8H#qZy<TKex
zHRmMVG<+k*^lm13ycDon8ETcmN>P{YPW6B<8rh1|%n{Rrp<w=#uX%rR^#?$>YDcvE
zzT?*Qf<}cC*wrgz{%I%8s>m?6uT)eA(~=~`BRVWz7N>S+3nsQYC@JjT$AyRNyVAc8
ztd%1@YA%z5x9!vaL-&uF`j5!-e<q~;A2Im<k2%>lUf{<3)pQ<z%n{<v4jf<S1~U`y
znr!5CuMIk{;ugI~68!T`TZc#MPzatE&}`VJW;sP(I7ZuXzMS7q4*NpjAJ~EM(o7#9
z8*^~etW<{yKIllhk5%z}Q~8Zx7pX~@33?LERa5ilj=q*!0gWEv-5B*HBy41j`wpnP
zPyVu9LVu!`k{)b=>&I%Vjsp(hFi~2feOom11v(9S5rMOlUb}b_dPqMv90MofHSS9a
zTZK-{VXa4mq`^5^4kEp8YiQGp0UizM#d0ZApW$Tlu>6>m=AU5ezKbNVppXAtU<U@5
z#tIOIfB52V+ciE2_f)Bfe)J&6j0{GtFAQcw(&4xv@`;{6B}*E=@e}g;OJZWsY6r^p
zK*{i)d<EKuGU*<Sry|Hq43Go)+JSeo_*=pRH+YlrkllxPX>`E*(FxH!V}nk#;5R!7
z98?CGb3!gcFSdSX96sd<r=}T<QaC|_()74^DHI}he}X+fC0G=6AiL)Gv$4nKcM62e
zKgSNP)QBuoaQQ1UR2kUerbOA1Cp7{Z)=y+~1pmCl#>{$C){qe}?CS{`0BXp37Iz2O
z{n22N@nykn`PSe=kqP1C4vUsx-~LISECo8^P?c4K2KR*M=s1I9c6u0r-+1{-bmAp8
zGo>%xu0t+|W=|6!3_%W;3dT{ob98l5O~o$hA<KrL200o%qyVc;vc85Lj6e7`a7V+b
zCsx%0rJ<d~vNO(m)5eA4_Z_g@X)KFzNuIn&0hORkg5GMn;@rGXC$nX+qlr;EeSyOH
zy&mWB>^{$d?B&;I`l+uGGQ}pBB)u`ozqN8RgVGcAd<C}Czh}b|8w7oJ#@)SWToY}%
z8nluL0!cz{PRG~a&s|76G0g9H8e~-p24O62CQ&ME8m9fy1Jj1UDp&U}clI^o2B9Nr
zaOYbx4q?!_@k}`0ut|n~J8Ivg2pr~1Dto3b-}zT}O3QpkDIf-Lv07~(fU)2PKR#vz
zjPj(+53quk#vF}*`o4vZ-S7~c@WmK7d(>Z1M|^Mn;l22HpI|9J%2}d*oc5X#qx%`W
z?lv4xiYCes$bR=yJX-*)QVT{~<>*1+`pEMSrfA0QJZAvxg#&*W=z`XlgmYlJ^1b|^
z-c6H<5u*yd9uvrii4;ka2!K(<K7m8ot~Y9*emHA}0WH4aY-RL=;bhe0_fk^1_-w9u
z4VXgG&Mp!#pss(e`RET??pI~#VSoa7UdqO-5fempqD3RQJf#(zxQ$?qp%uED)1-;<
z*{<4yNY3~07vNo#scu*HB)AS=z!+Jj^jYl3SWFwiSz2(Wo<cZW`hptsjWbzBlKxn#
zDFbU(DoKbOhdpMXD##!xsKfQ}d5ym^*pL@-&9o&Z1Z5)4-KnCO<hJU@B-jP563Kbw
zr+koVb<Fh<!ha!;>F21f!3_w<TlXA>%+v{thT1Pb6WUa`_~!PcX~V>!!|;beL~1=S
zkZd8rrmwOiFFoY64Tf16AlDwF;)`PoHibbe5K8>VSw4x_MTZFSmsRo$d{CH0#}K6q
zwH^~x*R@AWA@SPzZtIjcxA2DSX8!uY3Fy?koGm`M=|W5&D(<;tYU=mv2aI)MFkF=c
zWF?gcykfsZwj1Ap*Moa?-^mrzVonRN_Umyc-%jH>e)9nTJ`Z>+$I<1TC9Pa>XOnfO
zmY$xupy#RR6PdNDYHGYxeSjXm;KA?<&A@QsT<F#t*N5qpr&tSFk+SmD<OemK{T|H{
zb^67;p`_0`Bkv;uy$?S6uw@6qgyUo1Jg(Olqdy+Y>l>AI`u^Fd12p!QJNraur)Yqy
zDT&7X_CPDXtFWb(*9hIdnc&_Yn+!l7*^;<Ys40qi1~4|Csb3jJD=bZ2fGwO-k<7@w
z7`8`#ybd%(i-^d`St8SMum@AINrHDJrV)7EYA9BimR@#quS<>3&DnzWEkcLnvC!?A
z4eW~-v4zfrzU9o$QLT$xS_oc`vFcVl7?Ja-PKtvdh6+{b+xj*pkslvGgXKtw(qclg
zb?0}#ae{ZUEdGDJ-Qk=0e<<F%W(*dZr&vzYc|naxspopgc#(^XFU|bf|F=-5T}){J
z6=Ap1V{N{Ei!L<B*i(K@_knMdo{xx~sJg<f2!2k(Dy%W3EbJ5^({m7_ZV~kh1$J1$
z<OJ?w-wnC2^T9Ex`L8|HY@>-MO<aaCrBJNu0|ImwSff_*QZI~Vf@J6OBGJXr7{`<q
zDk9y0^y3yP)2S2`hj7H{KSX!=Qd}0+hS_G2BK&vuKm`Y49W;$k&puR|zb|_5s6<{P
zImALFP@GY&nnHV5FwOnJz=KwGU{I(Q9Mb+$`quh`Z}SYXLZ)Y*fphD<Cl|-+RfLZ}
zq8??<`skq6zt2J%b~e%2V#t7l3RmlvsN!f+ljWpEI%>mf39b<^OS`~01fBt+zSWuI
zxQDaXG%P(o<z_*Z&?g{<QWHraxEU2-(QS>Z1d6yVKGmU9H-^Xs^`V}Sg+KRPXup;$
zSt3XXPzh$+whv&zI$Rfeo=wM>-uf26lb!{wTcP{(#pcBo4(as@Wzjfwo?^xTW%A(l
zF*ma8%;XP2*wsRhBvlF8lUjmVh0v!bcU+?0?U*iCJMPQXV_*dkh*cZoUt&hKoY2}5
zDtOH%uCe`23Fd*uRcHeIVVSw(ih}!_H~Uv1v-+Y~335vZqrU~x3#pZk+lBW!I5>Rj
zQagB1w!v-Cpaq5z_<Yz4fdqC^bt{_LpT9?EVGT&#?bAf_{p>Jg`}xgOsYvkS_Abc@
z(&kG9_9Wv1jN-6M<f1WVHhYmcn=YjKV9eNp3WLxOUv#;5w@<$aXq%IUt{@L7#<;T~
zlZ_$t7VZ@kq7Tfj@861mVp6m1nv|zo;)-*lA(&Bp1$V!vWZz053LB|mNNhF`&b5Hd
zD2-HTmd6Kq&@E|&Rp?v4MtbOfef+q!B?E8o)cd~qwk-VWA`@_$yoxe`UF6|geDS#j
z3dBDNeG1L@j+Odi>^w7p8!+3hQXbOV2cA?Vx-NZ)Gmmg&thy$9m$K9Mle?KV7)u3u
zc$-YE#Sz1xxBo#0`uf6F;(UY^TrJZ9X^aR}VKygRx)P17&(SP9tN=?=-|BPVfFRzJ
zqCMkl>0gRRnwC5a?`m}NUCPKq_HoVoz+%agY{E7b=lf~}Jvuz^D*~tM6y|uLE$5~B
z;C&&k!lki}OgGHU=T&#(uoaqQ^SkB43Y-L-X-vK)RGC&N7%M>ZwlMd*X|9sD!zdLL
z`lb*NoU$&%JX#h6xXW)qz8&4fwUhG&3tEur1Bm@-l6sTRsc#Oug*+aemkZg8)v(h9
zR_7E+RrdtlFcwFf7c*}}xJf*@^kTQopz%ZJvNpTr7^^RMHbv37_w;T#`<nuWMn^9d
zfA}D2tT_DTPpw?2lD3DOpFMxdDHjwuVhmsmTe3OF0g2)89c4-*tEttBfRc=zO2T2c
zw4WU!CBq#ts=y@AyfDi3Qd*gg6I&PtgyI4jU@F~*)!w6Gxef_NDc<eJ#p{p2k~Xfh
zu~b-`S~_Rr_12iZf@zps*r*H^R1}*BG1)$lvl7Lgp*D2SerFY5BaPI=dktppu<4r=
zqRb%-Ej#}Js4g|U%m~yfeEq!4m4xDurLqtA7FT_aIF5nV+=Dt@@#cAr<QNQ^I@}dA
zzV9N`=aFTh2eF|LEtwHye2X{S{eB|53lL#|82O1zwGKEMn144?GtY1x`cpD4XOyA=
z5U|fUxya_+wX@)abI5>Xj&o+IQ}+&==Bs}j`M3HXw*&Ar<YSD&5{m?G_d0A|_Vv*I
zxI<452*t;y{xECGlp#Zivv*b#fy~6zl&BZjKXONmNb%rNpyK+pR9F8LBOO!e*+VJm
zQv|#%x-e$1a9_!Dz2b%nfNxN28sCPKbpOccyvz!XsygGE>?b>P{xFbAz|rIYaUHcS
z?;4KB)&w3GMayrWU!$-x{rwz@->I>YYyjZ5Ysq0<jDa_{3@w$nq7JgSz*7uE&OrZg
zZAsarfRBgUyV|Si!*e%*q9I=48B9=solZ4&W+T}=V56U)HVPG4zyxi84Gi3HJ?Gc!
zIa-}Lm%xTR_FBE<NBdDmDWW9#){<T0b5tCti;S%zbDFRTDi|^X?1v5Dv~66NuM-6j
z(P&&BdE<7KxGz_fHAcK`nUhN7#sp7~HztGu0-8`|qC#ALzDCbxSvA^+;~TnAxQk7L
z(EXihGP@tc&Pm6g)eKr5Ar`VBK;@YJPkCcci^6~+Fqr7T(q3XxKI~TLHoz3qetu;A
zNnyvg63i8*d)n=a6#d7J2O2*CW-xVSGP~<Jyb#3NP{H3yQ}mcGy#3^O9X#kB7NpP7
zX2OQ2!!Z>Y{`GQqIIk2Mv8XWYj6;=FsgPb-HLrD-Hds+Su3qpNiwY%g(@~s5)@Ujc
z)9<#uoTE+>>()`H)7#ry=z)+2Rg5mi>}YPiL>e!9y?)|+!1*WpQPdi?&ksHEnmJeS
zA?iHZm;_`-D!I(%_#9}<0wa?VOm!x2*#ZWYBwPH<B-twmuYZMo{7=r&xI4eNq9s*%
z@5U*iZQo}rHf+>S(JXyduuyMJozzsd@Ry|@*9WgU|F~83xgO_FbK^B71Bpj6ep#X#
zwQ?P-4@eI1r`WueN*UDwBG`~B)<z&5VD+5Bgd5zWcVT6lI4YrI{ir+Me1yHlC#qRb
z+sUU&aK6bXnRarXsA%Xukxbgv>g*h}Gxxmplb*U3XV>?SUm_M9XA(%RSbF!Je@Mv2
zXG62jBA1)V;c2b{Q%jxa^Kx<z1TFVNB*~L{S?0xE(Q<MI2T|f^$oy3aAU|Ka1@AkW
zzA+^fl@wST>OfNd)T+q(Wj@zp;Bp-(@=Ogk`*Do&nRe|KoNkLIta}gF%Ej|-$G(<`
z!`CX2`}Zu}yl~)wEUSZ$H3*WO{lLhL#%Y=M$L;nxZMVm-U3hBs7~)+{VhEJCeHh7D
z0J|rCGGyLJcByWdsjN@TpcwJdc5dznb3;jQUF=)V3C0L6v1>36b4S|)eVsK@BVTsi
z4hphRYOI2D&yiXf^r-$oPpA`P_1j`#Y%S%BJnB&>DC7sGh5~)Rdw$Q9B|TYnSCcU;
z4^Vb-FH%}`St;uK=*SQT*Q`r6c!i{)i(?$Zk>0Ju-x>hCD6mS)-q1ha&GQtvQKJpf
zlEQe6vxj+>$@K!?^PJy`y;GWVw+z*S@PJSlHe_${2;E_8TG;D#PtUNF3;3HZO^j@q
z(`Y><n8x=2^E#wwR?l+lwixr@8;V{AAh_qM;h*2{50%{$ENQ&=jS0%b!Ara={N1m8
ze0*+fa$G!{)p3lrJp9*nMk6cdx({X)DE@)sf>#)(Jo0sQSb?CYR`h4j_fp7Hl#IE?
z5JS_VjiSaY^*alfv4YHJr2Tpt+1q({DuLl7oozG$OnmOd^CsX(^W`IVqM6*l2vl@Q
z0wp&b>2v>vG{&g}0&1u;V`|h(yu_O`)jE_*%*|Xcotv-Q6n%zKKgtppfTaLYc00Ou
zrrq<M18B)S6Wt*IbM_xXO`Hh+aR65^Ml=7sm_lr8XV!S!W~z0ZS<^g>9+<82d#Oo5
z9ekuiJqtc9`W^i!33(Z%z`9;QX;;L(KuZFPR?@2Uw(=)A`(J#Wzz(7O(cyP<HcQ;w
zhNHS@DiDZ;DDgHA^mhTH%9DRmwjZ5!QAbdNW1}0&5Pv*ugf)Gu>Q}!*=OWc8w%Ue3
zC`_WISxL5XA>{l`%>dE?mNJ7p`%t#1H<y=|zZp63O?+z@RtEF9XrRtwO9)4H31~j}
zOF1le2?zqiX4@dPcy<O)!yWP+UOJ8gxE{jq`PX-20%LiABt5il8GmQ?;q@WNxdgQ%
zI@1xOs_2ba!h(TR0t#qip#r1YprxsH)s0hRkZ?a@>hzgW){R-muzdXJIc(*wsi~o{
z5^UuSn<ZGtI6=zEu*wIZR}Sco;4I!ZKwN<0NW29k>)ONI8uP1Co;ljUOnF?kRl54$
zJ5<4-#?}TZvI)QV>O0FgWb%omD*rGH1fw~a!3gC8hxHGXH1>3!n}Ub|x+?N)396hn
zSrpQx0N}(J7=grXJGB61_<g(Qv5Lx9(NS+N)4DYC(sppkDzWTobz6B*6Rm6@AA=&(
z!)Qu@oP&-k&<3OSa_sQ<nR~8@1%?Eg{8(y131b0aABui^6bJ!^J!oW0(fhCV3cGXX
z)QPlag2K=_gRKQD6n~^o|MjzN4a(nk|KnDY9v%cffy;?e8f*h90Pj=_y}<;!f~2fk
zC&sJ092EP@4>M1Ph78^E7^U5Kk`^Q_9l_iOS^C$u@*XKbT{4!nN6^P3jdPS}<Vd^t
zXu*S7v`V#E12UOz^e+lnJw#tO|9Va#Da>gJL*c4GGO`G|uXHDZ)C|aAa9WodRL2~E
ziZAj9Bkc(0GnO?2^mKq%6iOK^5Rr>OVHRZk25<#%4LZ!)s4Gzu_@Dhdd=$GNpP7~@
zXxZUqK~;U%u3fGeGfx?A18BntORBUPi~uTvhz@-SQb2SrkvNvlikhDbC9;v<^^+5>
zHXaXMQA~QeUeP6^OFBb0!XdmX9}P^}OwSm)pXu(2!aXuT4ngg2_|^h)c^RVQ5pWD|
zumcpFFWk&VU5E`*Z${g**f_Bk4R?#e@ENd~&jtHst>5pMaRI+WfIkLlu&?t9kV-3v
zVy0wVZk61DzK3KcN1Nm5R?;X6N|p^MryloPr*~~5o?C8=%*ulkjSck~DizmH31{cE
z{I%U{=6;`zOH`H#Z8G{{v2e*<{U1N>^gjP<>ek=q$!;B5F!aarr%?}oNSrO^`n%AK
zYqM?2&e^T`Lsd-GRBYz2o665D6b+R~aPD;~&sr%MAjEm&=Gj=-ESGKDSQ6c2-rv_3
zTx(bdj=Hn+(ZO$x+27?hx73a-MpQMuaZy2~?=}2BewukDGD$kkmg{F~W>zHH{@azY
zmQc2PwsO0-aehZrbUs5~UY_&nLwxNOBxZeC7;c?h4dJlnx`?<qNkymcJFx;6+ftuD
ze_lE?lwxXXicL!vjt{n9%W3+A^(~1B2@xYB7vaN!jT-QPvbVQCV{6Ncy{=AlOgA?J
zcsanRZimcW>AAaEVaiptwSm(vU+Qki6wld$Wo2aI*wApoZG7}-MMZ^&cG($B`LVrX
zL)*TN%M<fY%OAv6QtYID0=n(vWt&e#J$<?tB|TW?@O`IY&{+!$89BM<_4Nk!c6Osl
z+Mi5@iru-0G@Mjz9i6}J<VYuktlQq*T?syKQOM`tFmc5<s=Ym_2|F0r6mDgSW4;I5
z`1a1uBin^_TwKzha2FLV_tSx)mA}7#-$=g&R_XkO#iyG#X}}1uy{)Yz@?e-9f57s1
zdq%WHhXjCiVTrnul2f)a*>I8x3<;^Is|y}=&&CA-na9?08ZXeZ!U*?V>YpJYV`V+N
zckgDp>qn)oGd4D6MnJwC<zO%!&taCIYC;RGJ=BQH&W?TmUPVMybi<OLo~5KzcQdD`
zv|-l>XUn_9L>XLGjlPzhj;?OeoCRPDKaYyKE#@{lqy^-ZDc0594Lx{G?=e3=KZ2~g
zx-8W-G(wLbbj2}x@rMY^qdx0n{CVK|_3L=ZSghx8fBI(+Rgh}c)Vw3YW*t8<W7e!$
z7e|NUhDUH1IJ}m(UMFG)cfB)X9MjYLG%%2aeK0~-@sUT>euUA~o7C;ww`*<@l(w#4
z@WZsZwbNo=wKRVJ{{0n@jm}N^(#p!QNlDvYMn{`lTOYims)9d&j>~ZT?!ojDyAc^o
zylHnqGZdBIx^)%f`HL6nuP#o%d`axg$&;5RRHjV%e(>=OYP7`F)z#ZOI{2+)-f5X4
zm+VLQ{EF)8D7=gF=FY7)@Dn>@WVFjYd!mp9ZNh?;N_v&o#}7(u+61#{8l^U!*FywM
zI)<0N^WAB2Y(VXvIcwJJu*((?A3geg-n@AZ_ZKFD<$#-Bvs_6H{$Y=*zu_{+?GrxZ
zd$_CCuHB28J}@w_6p&Bnrde-fung(h`R&n_l{yGCUy<ItZr;3u&Fa7h`#D7`EYF>T
z<!gTTAu8C9{o6TS;@$lJIC0S}{QDpOU;fL@Ys!BHfYbgTfAP@#ZJ~R&zL>dWat|(J
MkA_Oju9JWK4=Lq?&;S4c

literal 63675
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

diff --git a/articles/AMR_files/figure-html/mic_plot-1.png b/articles/AMR_files/figure-html/mic_plot-1.png
index 821dfcffdc02b6bdf22beb92cbadca81150d21e5..e2a5c3308b436dab483a16c789a0af063608aea7 100644
GIT binary patch
literal 109478
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
CBA7-1

literal 108206
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

diff --git a/articles/AMR_for_Python.html b/articles/AMR_for_Python.html
index 4fcc5c23c..1f9552848 100644
--- a/articles/AMR_for_Python.html
+++ b/articles/AMR_for_Python.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/AMR_with_tidymodels.html b/articles/AMR_with_tidymodels.html
index 00a1d4288..bf5bc9977 100644
--- a/articles/AMR_with_tidymodels.html
+++ b/articles/AMR_with_tidymodels.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/EUCAST.html b/articles/EUCAST.html
index 48c30d24a..a82329449 100644
--- a/articles/EUCAST.html
+++ b/articles/EUCAST.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/PCA.html b/articles/PCA.html
index 30f17647d..83b233547 100644
--- a/articles/PCA.html
+++ b/articles/PCA.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/WHONET.html b/articles/WHONET.html
index ea4015ab3..e77cf7de5 100644
--- a/articles/WHONET.html
+++ b/articles/WHONET.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/WISCA.html b/articles/WISCA.html
index 8519eddfa..06f535970 100644
--- a/articles/WISCA.html
+++ b/articles/WISCA.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/datasets.html b/articles/datasets.html
index 1ca05f388..8951572f9 100644
--- a/articles/datasets.html
+++ b/articles/datasets.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -80,7 +80,7 @@
   <main id="main" class="col-md-9"><div class="page-header">
       <img src="../logo.svg" class="logo" alt=""><h1>Download data sets for download / own use</h1>
             
-            <h4 data-toc-skip class="date">19 July 2025</h4>
+            <h4 data-toc-skip class="date">23 July 2025</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/msberends/AMR/blob/main/vignettes/datasets.Rmd" class="external-link"><code>vignettes/datasets.Rmd</code></a></small>
       <div class="d-none name"><code>datasets.Rmd</code></div>
diff --git a/articles/index.html b/articles/index.html
index d38915044..09298a828 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/authors.html b/authors.html
index 0d99dd4ca..b60435a97 100644
--- a/authors.html
+++ b/authors.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/index.html b/index.html
index 7f779368a..d44e335e7 100644
--- a/index.html
+++ b/index.html
@@ -33,7 +33,7 @@
 
     <a class="navbar-brand me-2" href="index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -503,7 +503,7 @@
 <code class="sourceCode R"><span><span class="fu"><a href="https://rdrr.io/r/utils/install.packages.html" class="external-link">install.packages</a></span><span class="op">(</span><span class="st">"AMR"</span>, repos <span class="op">=</span> <span class="st">"beta.amr-for-r.org"</span><span class="op">)</span></span>
 <span></span>
 <span><span class="co"># if this does not work, try to install directly from GitHub using the 'remotes' package:</span></span>
-<span><span class="fu">remotes</span><span class="fu">::</span><span class="fu">install_github</span><span class="op">(</span><span class="st">"msberends/AMR"</span><span class="op">)</span></span></code></pre></div>
+<span><span class="fu">remotes</span><span class="fu">::</span><span class="fu"><a href="https://remotes.r-lib.org/reference/install_github.html" class="external-link">install_github</a></span><span class="op">(</span><span class="st">"msberends/AMR"</span><span class="op">)</span></span></code></pre></div>
 </div>
 </div>
 <div class="section level2">
diff --git a/news/index.html b/news/index.html
index 5bfdfbe49..a5f2bff3c 100644
--- a/news/index.html
+++ b/news/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -49,10 +49,10 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="3.0.0.9015" id="amr-3009015">AMR 3.0.0.9015<a class="anchor" aria-label="anchor" href="#amr-3009015"></a></h2>
+<h2 class="pkg-version" data-toc-text="3.0.0.9016" id="amr-3009016">AMR 3.0.0.9016<a class="anchor" aria-label="anchor" href="#amr-3009016"></a></h2>
 <p>This is primarily a bugfix release, though we added one nice feature too.</p>
 <div class="section level4">
-<h4 id="new-3-0-0-9015">New<a class="anchor" aria-label="anchor" href="#new-3-0-0-9015"></a></h4>
+<h4 id="new-3-0-0-9016">New<a class="anchor" aria-label="anchor" href="#new-3-0-0-9016"></a></h4>
 <ul><li>Integration with the <strong>tidymodels</strong> framework to allow seamless use of MIC and SIR data in modelling pipelines via <code>recipes</code>
 <ul><li>
 <code><a href="../reference/amr-tidymodels.html">step_mic_log2()</a></code> to transform <code>&lt;mic&gt;</code> columns with log2, and <code><a href="../reference/amr-tidymodels.html">step_sir_numeric()</a></code> to convert <code>&lt;sir&gt;</code> columns to numeric</li>
@@ -61,7 +61,7 @@
 </ul></li>
 </ul></div>
 <div class="section level4">
-<h4 id="changed-3-0-0-9015">Changed<a class="anchor" aria-label="anchor" href="#changed-3-0-0-9015"></a></h4>
+<h4 id="changed-3-0-0-9016">Changed<a class="anchor" aria-label="anchor" href="#changed-3-0-0-9016"></a></h4>
 <ul><li>Fixed a bug in <code><a href="../reference/antibiogram.html">antibiogram()</a></code> for when no antimicrobials are set</li>
 <li>Fixed a bug in <code><a href="../reference/antibiogram.html">antibiogram()</a></code> to allow column names containing the <code>+</code> character (<a href="https://github.com/msberends/AMR/issues/222" class="external-link">#222</a>)</li>
 <li>Fixed a bug in <code><a href="../reference/as.ab.html">as.ab()</a></code> for antimicrobial codes with a number in it if they are preceded by a space</li>
diff --git a/pkgdown.yml b/pkgdown.yml
index bf0dd8639..0e2c6caa9 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -10,7 +10,7 @@ articles:
   PCA: PCA.html
   WHONET: WHONET.html
   WISCA: WISCA.html
-last_built: 2025-07-19T12:12Z
+last_built: 2025-07-23T20:21Z
 urls:
   reference: https://amr-for-r.org/reference
   article: https://amr-for-r.org/articles
diff --git a/reference/AMR-deprecated.html b/reference/AMR-deprecated.html
index b7144a3b7..13827b9a0 100644
--- a/reference/AMR-deprecated.html
+++ b/reference/AMR-deprecated.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/AMR-options.html b/reference/AMR-options.html
index 51fc8b977..fbe7e86d0 100644
--- a/reference/AMR-options.html
+++ b/reference/AMR-options.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/AMR.html b/reference/AMR.html
index 2f148125d..de928bc29 100644
--- a/reference/AMR.html
+++ b/reference/AMR.html
@@ -21,7 +21,7 @@ The AMR package is available in English, Arabic, Bengali, Chinese, Czech, Danish
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/WHOCC.html b/reference/WHOCC.html
index 429cdd160..ad1bf84fb 100644
--- a/reference/WHOCC.html
+++ b/reference/WHOCC.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/WHONET.html b/reference/WHONET.html
index 5a61d3890..20c8dc2c6 100644
--- a/reference/WHONET.html
+++ b/reference/WHONET.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ab_from_text.html b/reference/ab_from_text.html
index c00986a43..1bf2c9877 100644
--- a/reference/ab_from_text.html
+++ b/reference/ab_from_text.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ab_property.html b/reference/ab_property.html
index 92947ce4a..4a5ce3e7d 100644
--- a/reference/ab_property.html
+++ b/reference/ab_property.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_custom_antimicrobials.html b/reference/add_custom_antimicrobials.html
index cc65e8afc..f81d5acbf 100644
--- a/reference/add_custom_antimicrobials.html
+++ b/reference/add_custom_antimicrobials.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_custom_microorganisms.html b/reference/add_custom_microorganisms.html
index a44dbddcf..cced9d9f8 100644
--- a/reference/add_custom_microorganisms.html
+++ b/reference/add_custom_microorganisms.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/age.html b/reference/age.html
index ca423df67..d73769294 100644
--- a/reference/age.html
+++ b/reference/age.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -112,16 +112,16 @@
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="va">df</span></span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>    birth_date age age_exact age_at_y2k</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 1  1980-02-27  45  45.38904         19</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 2  1953-07-26  71  71.98082         46</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 3  1949-09-02  75  75.87671         50</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 4  1986-08-03  38  38.95890         13</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 5  1932-11-19  92  92.66301         67</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 6  1949-03-30  76  76.30411         50</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 7  1996-06-23  29  29.07123          3</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 8  1963-09-16  61  61.83836         36</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 9  1952-05-16  73  73.17534         47</span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> 10 1952-11-14  72  72.67671         47</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 1  1980-02-27  45  45.40000         19</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 2  1953-07-26  71  71.99178         46</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 3  1949-09-02  75  75.88767         50</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 4  1986-08-03  38  38.96986         13</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 5  1932-11-19  92  92.67397         67</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 6  1949-03-30  76  76.31507         50</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 7  1996-06-23  29  29.08219          3</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 8  1963-09-16  61  61.84932         36</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 9  1952-05-16  73  73.18630         47</span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> 10 1952-11-14  72  72.68767         47</span>
 </code></pre></div>
     </div>
   </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
diff --git a/reference/age_groups.html b/reference/age_groups.html
index 6f4b05f1c..5d5d0c49b 100644
--- a/reference/age_groups.html
+++ b/reference/age_groups.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/amr-tidymodels.html b/reference/amr-tidymodels.html
index 4acfdc210..0b510f343 100644
--- a/reference/amr-tidymodels.html
+++ b/reference/amr-tidymodels.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/antibiogram.html b/reference/antibiogram.html
index bab5de8be..9045aa61b 100644
--- a/reference/antibiogram.html
+++ b/reference/antibiogram.html
@@ -9,7 +9,7 @@ Adhering to previously described approaches (see Source) and especially the Baye
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/antimicrobial_selectors.html b/reference/antimicrobial_selectors.html
index 93217c5a6..45e946473 100644
--- a/reference/antimicrobial_selectors.html
+++ b/reference/antimicrobial_selectors.html
@@ -17,7 +17,7 @@ my_data_with_all_these_columns %&amp;gt;%
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/antimicrobials.html b/reference/antimicrobials.html
index 4103c3345..82df9a709 100644
--- a/reference/antimicrobials.html
+++ b/reference/antimicrobials.html
@@ -9,7 +9,7 @@ The antibiotics data set has been renamed to antimicrobials. The old name will b
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.ab.html b/reference/as.ab.html
index b78a0decc..2c187424c 100644
--- a/reference/as.ab.html
+++ b/reference/as.ab.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.av.html b/reference/as.av.html
index fa9024d98..70aa8a442 100644
--- a/reference/as.av.html
+++ b/reference/as.av.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.disk.html b/reference/as.disk.html
index 36738f571..8822f5881 100644
--- a/reference/as.disk.html
+++ b/reference/as.disk.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.mic-2.png b/reference/as.mic-2.png
index 754e1980c48982cd1ff7161ee048f15ce8f1c342..5d58f96c35c931f55674822ee6fcff74f8e44e79 100644
GIT binary patch
literal 46360
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

literal 41632
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
YC;jbiRJCRxfZmC*PeUbr&oQ6>0x+WXH2?qr

diff --git a/reference/as.mic-3.png b/reference/as.mic-3.png
index eab7ddad8f12c80c1f4c6e4826ff007cf2f41a9f..37ba619cab0624d97ea3b05cd31f618b6f2b118f 100644
GIT binary patch
literal 52101
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
Z+bxGqWJ;|3Z2QX2jkE(2T9+bI{smK^i>3eo

literal 49422
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

diff --git a/reference/as.mic-4.png b/reference/as.mic-4.png
index b9a4cf787175879674c41852aa5364842bf5f959..697386b3d8f55f42bdd0906f8092569517ee5e9e 100644
GIT binary patch
literal 51370
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

literal 46120
zcmeFZbySu6*FB1gdhBC^B6tKuNdf87W6=iP3ewWu#xYPrHUc6bih$Gx=>|mvDQS>a
zLSob1-1(^Iz3(4)j9-j<-+S*EFXQ_?!iN3qC)Q`Jx#pbf<9S8?(vGc%wo*}1?U0f@
ze~pT2qazj72Hih4;gz<)*W>tSldjCA^Y|BE3+Hk@@Xr=YNi`cPsv{4H|F84yo6x7C
zI!YyV{;Z;7=x~RV?LMW&wTa7hk*VwMQd8^Sv^sm1`Xcqlv%4?S(cGx{uugH``F)x`
z--J1Pyt=(AZg1sezkBS&PT^zmTTlFvb^F%Y7JdIuw-dHJeJVe<vhpE`(iS%TVl+}=
z+&!$mU-4R|xtN`WgEeJPLrJQHhVkclQBmC<VPX;f{XNy0!KdFg{{A84*oSSuzvaJh
z_u%huZ#|~w`u*+KeOt7DfBWv_p1j}RURPjpT=(ny_tBE$>wkTFTh8x)>A;-|#ZUh_
z*J~@>XDd9@7o>AsIF!exyLbylFiiff7q{omEx(Q{`CQs_C)LDv``kY3Y^K3ymz|w`
z_x}2oU<dcT|9sYe-d|l=(#U+MnsQSr;^VJVd~fVSJ$6#J_p={Q$!D53@?pZv!l4Sv
zSFieMat3K~HlOrh+y3ilimv|?mv#8wmoO2HUG3_r2HuhWb4Fp}ZaJfQQ}T`RDwhWb
z2ZhJ-rfkRZ=S(_s?AB3Q(v1CIx-S~1-)gxQz^0<CtQ@$y+%I9;l%O{0D7yO-&&|(&
zvITM#F7rf~Wtg=^ui=+No%y+6#FuVGMMtx;vB{7%GMn<}I^zfH-%`GPxaY@rk#2dB
zlH@#^-EX_l7sSTPtDvT)M!e~wFFl#@lFzdoZQs&2eHB5J!MEYcOS2<(CA5Yo@Ml4q
z)}D)VV@YbM2C=VR9UYi8&ulYklkz{VR#^Dsg=s?9Qo##8Q)PqXUw4D5fVBPcW7c%j
zq<rOV2iTu7=^GkSDtW6L0#vkPwQ}t@cKnzqWoRy3o#A3;W-jZqHvabhj`LiH!@WR@
zj-2!#)!|9y0c;Pw`tEF|uZg+(hDmDbN7c54SLq$O4)G3So$7gxR-c9Q@eo**;`Uu_
zsXJ9NaQ~oo&ECtRyVGQ?ty7}qLZT^&x$?NHO=Dv8z9bT9y?Kv)E}z|yqS)kT#@2in
zhtD)Tyu33XHZ#O%WSXy|c>b6_EMT6HZrU6u#s2FuZgUxomz3o>O*P;go|b7zIe))@
z@U;7~V|Iu6%HU;>t-<X9kx?>1ai-0QR!?lc7u}D;p^D2oCQn^|e;aQYym>6sWp32D
z$6Mf7;++3w@vGtDZbioxnFqfn>k;?8)2Tn~5yki7g~z{_)!UtW@~kGuKklN;PxP3y
zWsn0oG@^S-eJgq<VqU#EBNNDe712RXxwm;&)B8Ic_#8$x^$iS6x{Ezq3q1<k%`@>o
z`_cB;HuKyn)<UD&V;ovJr+?67B0zQ?5uRTet-Zw1_+ZE3XW`*ozNL(rZR9tXd`)n7
zUx+%T2-^?SOu3&6<~MtBT=x0(mG(R*8xFOUVw1w<Wmg<Xk*uChvP}tl)0kzYC-+iR
ztu50+<?PuzqV&FxA3wGo|8~}G;?qHs&b(|T`}eok30r=<-8H-O;kgnTT0L6|Ia9q*
z=iT)?GcH{!6D_$DUcWDS{K8!UpV8bgaSrV~)gT@B?7I5;fM?Gl8yXbT&DxaNR1(w5
zvo$&8o}W5vH`GvzCDfQ{q0<<1^;}t5nY6sTGHwW;RrmSA;9T4&-;?}$Ugmid7b*Qi
zjq#=xfgH{_C;T;IR8-W-lP9I{rt-?lhK2s{Bn|WI3se2oT&ZomS(=<3cFkH%)rhd>
z$-aul3^R@RmAbmRhBzfQH$<j;S)(Mv;M}%@oDG*HRw9Y_&I~mwn3%*NxOy!G74x0#
zv>ZC@)RT4ZD`l4U)P`6T(5A_EwVf5D^ZBRbccOdx&D*~<-IRibu*F&8D;CX=kI3lw
zQb#F+M*>cGGkZ8L{l>=!Y7!okWh~sEg2KYc$PXG49y5(9CSTv(khLo@ndtu1w7oGc
z?X=tYhs|gGqj62nOCy;|=_ZYjD221Frgr$_%_Doea=M%;9F+bP$vEXm)n7qvIdt^H
zVU}GI%a&h*6ALm$VwA}*67wd@pZ0NOeOqt3fT&`{mz^sz(aZGqY#YNujde`r4;kEz
zI3%!i%0GYpLrt8IPibwwRHB?I5DQgf%UEbAU6`O%gzT(d=I_tBk{nQ#KKJ&oF)`h9
zu}blQ>FtSHx$jbi>g(%Q-0ib9qYAW&?rz+c(3d+_kgI4{95QyV(>&|@gGU*I_|S$W
zA*=3x4sdG5a23q|T@l39T;hG$Zhrg*t==*b4W<i7XmJW}<r|h#6n-z)cM@1Td&<Zg
zNd9XUMYhP8Y7cr!X?h%79$fT36wp?1kGsU^<AWVd)djm=Z|fUQt@bft&@1(6+^|dZ
zRZ&q<O!t$FyfEG0sXz9f#_3|Itd^|gK;H`!Ew7d06i;TlZB`JC?oJK3CnYE6?Z|*Y
zNJBDxxz+C|S@L)8`_^#w?%e4sqQRj-K|!x1S1(UIpPZUvY~`$@9{f=iGP68Yts#+V
z(WPzkqp}w1I|2)^e8e6L{4<SS{tJGyLksK9zdrWqSHRp>*p_J|xPytAIo4_FN0Zqh
zezVp{+zJ-aXk3$VPl-1v5()K!ZFq~0#|mG>B8z;e5y#wM{Uv{v%R5C(ovUAp?QT3m
ze!TB@v6knk{3a%6J5cjM{pG0}f3Ig;kT7e@NDq`)8cuzb5iDS#eZKDihx$#9wGj)C
zZ6R00T<72Iq!aw}YKQhG3tqp^|3;DXu@5dU2HG-{(nW24$fDA4-l+|3h*#k<UHEiR
zNAc|0v!5q9gJh~jr)1CDF$h@~tJ@2Q-Kg-T6XJ<*=H=xj_hGTJoIdb7(^8KaN1(Xm
zOxMYf!$s_eW3UccP8}N@iceB*j8kF`lMS35>(Zh3Wx1}V=QWx?r+q}&_C!REoA1m>
zX4g(N`_4S4-7G$o<|GS_B+YD|*Z)=`CdbQrrKF@5yVh0>S3>>$-`G@(sZ@*2g=ScE
zaRycBlSL3`_QPLa`%0{;B9kawy?Qmc7|4Rpppu5te^MbjMlOV3y}&hl<`iF0Mbz-{
zEiIcWzC!}$n#Fcqu2WS_lNDTr39rvRH0l2mro6rd#SAf)GxbHp4jJWw<{03KIY;4q
z_Y<P*>$C+J{tj2FEuHnBi8NF#vDUuW(laqI=CPK0=(N$%xAn1+k$B|HCpkFeW+=@n
zc!+!m7as4yB#)K&F7ly3POUh6tY&O%thBT=seVuqDV)6Yb?0Gz_6X-(+rbD_Ky``2
z$#OQ~xptdAOTh$ZEF@iud-1(ZJFfX3mn&*&i<Uc#oG3-Iwy|kUP~#N}lNX}fN&GiV
zo)0iX^Y==ik{o|&AnY)jfQKA+;mHBdofqoLf<KKFt`)p=9*TXZ|5i3Q;vv2Bi3sN-
zJ0BLTE}9k=o1EgxpC)xW_Uwp?jQocqBrq@<_cyDUsKq~_lZq#8wf_F!F?r==?YdXX
zd`2~A*pw4$7H23#ndVSWlO)!CvR<iTx`|SlL#LBTZN&Z6@rM!vFH94!MoH^0@k`0e
zH{pT4MGn!>EAgsLP)kj-A5q6;#p0<AwP&ZA=g%nP>J+dp9%XeBB>`Fcg@i`|O79V(
z;uNkf#>c57B?3bY5ywr^&R2XZ9~RR+(wZJ`ZEbzpxQ?mnrI?1q>iiolgr`scV+F|Y
zlsrGb`8SxQdPJXT^c($9{ZC=z^SAH`czTZ)>>8C+m=~}7UJ459|F3Z~K)L_G(SJXp
zR&UdP1<?LqLh$4>?hAbfe?<^kE%kWq_h+=glYpP`z(vB8gwzDRozpJ_t#l(krr)pc
z%eTqNUHB0K4Br^5@b>(}Ypentw*H~=Z*%Yr4VE6M91ggYVBc%jMM)|Y|F)>wW;Q)g
zYb_j>GuP>&w`DJtyiB|@Ii=)YuEUtTt>B}&Skad{DK|ZFfYuB%Ha%Iu_}dD5wsZ;#
zTlYRXe)(mB$XK4jK^@m*06(Q{YkdM*J9N2aimyy791*c+ADAtnL2b#_OtkjOai!I3
zh>|(DvQX{OR2j^hZqX%9dA=dP-P|GKT*m$S@A(Sqn|IM~Uts?GUGs-~oA(}Z-hw6S
zSJ79uUq#bz;7WvnS8_K|iz{wPOc=eHeB9`hH&R#NwzP+$YnJ)(;Vw$S(x^ZFJhfU}
zL)T4PTRT>~0$`EjYV-79J$a_fW6kaS#1Ul9R)fz^|JrS_w<7E4bEL63W%do5cX~Oy
zNU0aP=f89r6~eh`8@_ak25?e(D}O`_@#OsN&gN<Su?lkOxX5mY+>WTBd)-NgE%LbI
zR6EQw`OVv7JomDg0C$_Tq(r5pq&$21GI1MM-j&P_`w)Z5=erx%&fwVz+5CvP94<~g
zyJx|{v22N1f8z`a85frr#-4K)E>Avcvp{~{&0xrm{A@8|v$nd@G}e}3c6eH5-qBsY
zM;|4s$sHf3YOoahhimD*x6*q?Y)1+oC!F>;oR~Ajic}-p<-SBVsCuFF^85Pt#&51g
zY!KW}Ct@#q?!orjEUTXNi8{bk$_c8kkqgSdTMk%wEQPGjW)_}gWPB6KD3`Z!+kt^6
zTm_Q0G=ko@TGL_`H}qkl2c10~<p9LMw!0xkzk>SG-h8*ES#&RFNDWAiJS~^<T4O|Y
z(;2&F&5-v!XOc78aQ#OCiO~qgqq?rED5gX<yX+a!@_FVEVyPn@*q3!3m*&2uV4|m#
zlHRPX;Oy*tzVvBO&|82#wQ!GBCr>*eA))fJvRZ*I*Ed(+T$Cb-&wtx6GuqL{y4P3y
z1S{*~xMc#j-zfU$Hih4!GodO(z;v>=EDk6Pcm1{fNbCKCv6|QCa)#pK)66@B3%j@g
zyk&wo8`0dn25h_Hu|m<Q;E0Zhh<MbNA-dP$j_zd1p<$aVwIqe8mAp5)uhv+j>z2(N
z3D}#gcWK9=(~>|4O4d9!Ra8e`N{*Kp)kn+aEKgPhgoGTv>V)eB+(ZvHhz@F8Lk0Oy
z!TsB0;o3^Ix;9pmdb&x}vuFDXdG6o8FD)m>F;;VH#MW`_Srg9X&l!H4zsj|1*J#fx
zIEM&WWCWthbW>lvCTtjHryN{(si*N`-|qM$_f5N0TR8*-Q~-EVm<E$e>Djby?>{eE
zy77(|gM>B-^;St$^#lU0CDo9^<*^|1)ok0gZHO#3v#;;|iugMGWBmI^ldgh%q8~!#
z6TKdco`lb=_4IHbCEt05D1pB8V&$U8sRWN`qCl6Im)DJU<j$bL#^df0jDY+}SF;26
z@?GYLD(22&MT8gP1h;_=tq?vNM>Ojy&;qJ#1U?Ub|7fqp%Hj-3Uc0Cs)nN}BK-Z8b
zS?XDquha89*4%0JiVDgplg&m6n%Q;gs~uzRLGLA5Ia_0HEo4|AxA&;ep>OP+a3p#N
zEywToZ&d7}7Zr@CPT{^t+#XH69Z?CT8!ueA;M^CW!XyQ(<dv8^DlAnuRV~3#I}2c#
zLCQtX;tVvO?zUvlc6Hc3HvrLwNK*@Uo&4F7qYE%~dH8X63i*-`opC_NyBp_fta%M8
zAI(2!J_!<lxXMr=n>4&1IZoC*Q-j|3l9Q9u3o)0BE|-)`zVx6I)=`{)1REywnuiJ7
zP0uvzP>MbG;^o#<L*Gr?X|4y1parSXFe>Ifu9Mm6Z2EO>8dzoNQ7cC+>rnr`GrCMH
zET-s9NRdlph2dQF>yCbT{y{^!gr)-kN!Wcki)k?831{8%!j#<?q5fwl2t43CGZd?x
z?>y9!`qq7MkcF(89Fcb}@z1T>wlRC&5iPGm+sz~e(7naECG&{u%1kpU@(`a%Xkey;
zC$*VkM&1bUOGuXcZWTqvn;kZDewXMyjSk~JWUiFTIC*U&Fl=KN8b$O((l-5H8u6sl
z^-6c*Lb!To883Rh3sgZy!7&!em!+kz^_2$@C4qn$SF5#W+;obk#3s9+aBb33!OM1o
zbr*mwRS;><LPFvJPEEm%pdEXy(*hi8IzRrMBtLuB-af;mDZ!YWr0~`UApNa$0IM-d
z7Are@!)6B8SGl7(@s+x)i4j_2d!9U=7uxt#l_+@VAn1{Tl+fum=m%*94m_p$_UwaV
z*|kM<#cAl_rC9b}LL<A)anHfe%t4wFZ5D<3#bY1Eg!pRwtpsj;eFgLx=f1MowBhfI
zK6JFRuQ~1vp#p}ybe)vqGp;)i7GxdQhYsQuf>1K=P!A3cj?>Q1Ay6F>l>#DXOIDH{
zrAcjR@kfXSlN5qW%5(FrXFu+kM0pxgn#frB0ri91ojk;(7Qs%C=ktO-9dPLVyt^ux
z_tLqCJC#EC&6ep?toy?pOu&O&bvqXp9-ibYz9@<Hri@h-@Zv=rQRzIEdl+UwLT%1V
zNIN|ihC4|qV+n6S?unV6wk3)I;Bekf25~y8gi>FIW&~7Hh<T0_TK}ug&N-Yp1IKpI
zi)JZiUVKCpQ8q5F%OqPwN2#Wcyu1&xb`-#Zwqdwi#x(^6yCyZmSezZfcs&aXJ7WDH
zkozJ5DnZ4>&W^NEym-G{F))Z$PcwRbiNTFXvpaI~=iGzQT)Z1nNA@G=IemToL6BF9
zK;ew;L)KvbkmI)PpcA}8U<sn=W}0gOrgKFU#H*!71Ag$?jAH>gql0ch|E!d#sV4tc
z0RU3ZbMiIm*#0Q*qE9AXwM}G=nJ*$^1G8-w%~3(xafncYlB;^bSKqZdD}a#T>lK$~
z49xJ8?>uN<{_JGVNJg9OY>OeAn3xv9$Pw`S(aVfcvo4<_BAYZBj2RBjp&L@yS;gHt
z8E3{uN})Npuivb#f-_eZPq(pAMaQh_of{s~-{u;MijhbNlEO~DL)~RsxqwnHUON4t
zr5KJSFRBwf4XxAaLjMXWw?Nx@FzR-N{_eeZpV$qjIE-l%9fEOP@uC(Q32840L`&H#
z?qZ%VC##d~Peh5SJl!Kw;+?)$o;%jvq3rj_j&9UC`!sSj>Y&Ds!~BXMO}+^BY)?0;
z{TooG0q{y@=4j0oppb+$33TM%rX5t4t-L1!#N8HYq%M*c=6ig5uJz-Ik%d!JQ)Lne
zK#;x)vWOdho$k)L8mFEfw*b=e?r6ND)?OBQ_N$lB=p;;nrxXQgadwWSEHX0kIRY}K
zxB&U)?b9|V9c11T8a?zQGr1_}o4q6g9lf{>mggswvw<+Vj69Im4ogLY-7D#tcy<B=
zv*#lpGH&FL&wh+&mp+;<P7fYuWMsVMhAhgl+ca`4EKJ1V1^U>HWD!Qjj|u3CZzb>=
ze%XGQvO}Q#x(|Z{eMVwR%B>b2wm{_3_=cIR4s+g{pPxQjbpCL6<2uS$kiN!fWxtLX
z0uJf6wYO`UuAuVCxw{t(HpD8_2>+-IMrJ0uEQMVAk*8MEV_jWY9iz9~7{pz_vI^iP
zr&{$~RCsgIdygHRux-rw1%e_r(%k>r`<SO)<#X=c`3H$4k-`wMTc(XhuM&A&r^i<K
zocR*saC1kY#nL8|T*)QDr!J$}rII}8mbR&V5qN-gC=utjkNAN2M2o@|{s=QyU+$XK
z3SG@_rT~5GC?3PfrCv<_!NJBW3_FTP>^0iJI`WTB(CSrUNt%!70e0x8_+G&k=#6-M
zdc2>xsSD`aeQn#hL9|**{9If~mAaFY?gbXPBN^AmDrod@qQ(FhvP6@FT&NpI$?S4Z
z)m=l7Cv;_+G?q)=DK(l{4lNP32L<LiU@@cTD|WzgE!oGW+$Q13t?=YfHYR7U!!m0D
z4qcz($wl7%Jx*ROv%_0N4s4%YivR?5U0Lc{<0p9`xd}H>Q=Rvvwm3Qel8KpxCFJhi
zyIBo~<w&F8s&_5z5@KflG~ANP@~yy?;@s`Yvfg~mCB?1uh{O5QmVP&*<->+DlTrY$
z_V{v_IEvEOzqzz4z7lJErRm^-120h0yCiw|Od9@hwmvv`Tb^WG8*$-1Q*zLlr&Z)V
zog|}95zq$PG(5nudR6poJrr+oSG1i{&Xy$m^&8RmDAP$SkDrUBOdNl8%xMLr19L{W
zh=X}?+Zq@p<_w*D=k)Z|mAS6WO*J31iMsh>V8YDbGU@xrhno{V&aF&??|Sj<*|R-u
z(UFm=V-8)DXq$Gb8eTAdBdL2t)X}myIZ>xj{Q8mFN9kriGfU<g*q8Ms-`Wb$M4U(#
zC)sZ!s`f<^?P;ScpRM-`eb7+uS+9doOPT%dQdHnHWk8t&Ke}D*;aCv$okebCPx*25
zR`pG*zDGoqb=?pE-b_7~f<>!3lVX7c)2=3~-C2Nu&!!c1d?y5^LQY-%g>gfSUv`g=
zNM(Px2mRz)N^^Wt!J!!!k>`(}edDP5${a|2L$pMwPpD~UTD5BR{ykzP9A<0G5o6tr
z%6`Wk^~5gvmg<3@p{t$M_xrYjT0<Vmyw$QNg`MiCHIt*vhq-WdQNs`C{UiP5U%mqT
z?4-le!4o3{q*T`hYYO#662U>fciW%DhGi`K;&d6Yl!{;VfM=Lu6S?*ER4Up*=n38x
zeLSdqJSbzCO(J3P{(#h$g=Vd3+$34R(YqPvvZyWcx`phApU+g;AtP0y=}NFe(o4$#
zGEu5gy&Nid1GMKRUSj3i^vnB)hg*P8pKugC&c#*Du9ee}X4?EE&UCar8=6p#U3?e!
z%s}nOn}&uOGyC`N55}RMClxG~PY*S+MN=o)S~rytE1HtuW1U@zic+=lpyu^}1t6LA
zB{`<eobj>%M3tyc;51wiXgu`3rM><AA^X{spF<%~?Gs-f|M<#GH4sl)|I?pk!=y9z
zW1S-c&({z?m1tjOQU4n4fqr<y-DZOa>!O~VWM`jla|hscH|t6_RY|oSyoUQ=imR~7
z?I3Ww0r=`@!|IpEB_s;ZZ{K@dcKpeQ@0QPZGhTcS-Wa!04#zC}@`WG0%DZy2_N?Ud
zVo*Ago5F3r2pOO|G61#Kl-&E{#|yN2&v9n7gEu2suZW_zoDzxd?Y%iwC&Q&S@eeD5
zk=q56H<rnV^kfU&SAOQ5l+@HJtO4>Y8$0`HbZ@-C1L;GKy?&S0H|>s9Z7UHt`J6=3
zB~lG8)C@v~SKA0by11t8SEQoNJ95@t7IkYAxI#LK_%9YPK4c!~c0qnTurcdBINRsK
zc0)8$(K?0h%uNC&4WA`h3{CIz=#^|QocoAeWPq-9H_rr(_xa<FhzAo858g~uHRpD1
zWbX<4)QRTy-OPe}@}A*xFUR8E{bk!%aJ+w3Qg~i&>8v{uPi?`jcd)DQjUN-GhwqD2
zv8u?+{;m7<y$;L$jQ190KPJZ>D<YvKH=!45VAm;V@9pbT<L<{39cjx9fkJnGWitJ=
zt1oYZmo3#9TgmajB8UzN9@4u+$IrA6dGkwUqVv8zvky5+hAY2;^`Ozk8xuK?tFO=W
ziJW=Pt#|P~5hB}ZPQ7QHD>-aI&E5=Ygt4sMvB&%D+(FI{hpQc34G+$t4AJN<bFOoR
zM0U4?_GD(8*-urW)NQItKx2uHTlaj!(xV^wC^d5O^78MUXGc3s0}dnayyxkpJq}o&
z$@yUy%0>uuyDySF-iP=eFFx=7Ai`VYLh8xC#n%w;IB7CF+@gF0vG>GeZDC<S`PxNN
zu(+FZtj`-f0Ocb@b`?H133!}dPUuz^TH4w#V}T6(_MO^2LTT3V*b#g*3m__ChDeYi
zOGO&1NU-e5iO15fW~siZC2I&UmZe#A6*SltxAGUTSYoYgoiBVJkC&8N&IBd8v}K}q
zT$jmZmb(H>(&YZJqxFM;71POxYFuU)-Md6b7RL$`&2M-kYy9e&poKypiKa!!bq^9K
z&>E*rFO9`RM~=o34eBDLu2vV#N-N%No?ELD>JQy(xycUv^Vfd@lOV!Al%@K_cw7h1
zI6q0-%G&H-F94WVaU-$)CqEpf^q<z&3j*}ipfF~~9n<a!J@1v?<COTP=Oj(f#d;6V
zfn3Q8b-$yeK*gO&chd-v4tYglra_^vz=KLq$?qG-eFpdW4~uW7fpLq;okk?vI|k#_
zPq=H`_PbFI3ELXgI0If91ONtUeRiW4b8g5n906WE^iDQmOQ&P0US-)*qZ0-4^O~`i
zc_&gtR)_kxd%MI>)s@jwecHcopX!nYFwJL~_Pd@x^7oosjvR5#Fs_d-&M7MTJ6`Tw
zM^b%-Ly6G@Ev-IzUdn(e35;&$d9i{ZzY8wGqi7mT&6ZI80~b|Y{apzZU1N<9NG;zV
z-q)93{0>Ljt@VRqDd@$->onQBhhowgxBqIyYsZB%_vRlrT>P%<{a}u18QktkyCcaN
z-WJD>wr^>l>+-M&*kRixZ?Po4IPm7@BXxr)zB@cC=m+nSVGp^yy?Oe4oZ~}Xg@t}M
z0ZrGh`i`50)V{g&kZb|;(&Xv!P6ZIG5~9wV$Gp3@Kswj!xX8l6QFW^=gX4NOE{-kZ
zipp-Mh2tYEaxWB*b1x9b3Wm_ylC1ae<cSmS4ERU83cFmVYcCOrMp+bm$2Ldia~J-s
zt~Smq;jCr)qetl9W$(vI;Wm$433^oUL^&pd=lHUtxOS=Pl`Gf1r=n$puPttPd}mG&
zY<JT?!wgjN7l=aVP_u^TQ1bJce&;+mozHOnRm=7QJ7P(mrA(|mm;+we<+8mX$akZ(
zPsxjK-VUNAp`yFl+#^DQgJ~x<Cb|K+4LhMB)?;bZzdF0YKQQozfXFA2M}EByY=7u2
zb7_Tu&MjV=-e2Xy(y)QgYoT!I$)dPuk!h*V5oIxu7XZi~Bcr0!xZc(qhsqni??HsP
z#QKoaloK^+XQT|kH%T`rpou41yLeeZ$tvJ_T6_MaioO)i&7<JLVtqf(6>~N8m(Z*g
z$`z!Z0y9MB;w1U|f1C|*sNo85{o^|x3)v1d*N(%577O5zmdNpvX8Smsx~;fW-@O-|
zt~nPCnTycOm<=MGDA`Cd(sr`R83eH2{}BT3!Hm4It|o~2i{vS@E<)HV&hX37ILhF$
zY*p;R$ZCBzGofT-$$Yi#VztNW-n3AMK+Sh;x2Q=$L57eijkMht^og59v0q=1R4u;5
z-mO|8@_}NXOYU`0S6Bbs>pS-K7>PEoU`^mn@Q1^4vb85poEXo|bc`@}+b6Ha?5IbZ
zd*1(>cfTOZZoLu5mu!yA0ItSFo`3u#itM#T;-zmtx3hm0NfuN<6(EsG!P=@zs>j;u
zBVU07h#X#$EOd)<eGe*2VaWp#%DMJtrcQwGTRgwF+f?t!78epy1EMNmGR6V^s(6Xo
zdbW85pucGn7~xO;L{KKG6-cW$DlWydcS}i2*8%j8&E?`|DB}1}PDJ;=bdg79t9y0!
z-f7f0+)=rW8#h{KYc`=2s`hDd26fGX!cGt5${C1wG)wy=PAUF@W_V!WaVhKE4(28T
zj5Vcz^F|U<Lg?m$?E&vcGoFP<%J|sg7rlR0r@-z(igll~sZ(p3F%L^&&DMn%Jo?g}
z&U8B;qMY-Yw+l8VYH0vSTtSp6#Vd0(l0jVNO+NOa6S}6G3r<p_blKNqnK9z|hL!@i
z+;maL@o!J{Rmkf4980TVt$9wVGX+zQqBoYRGRGiw4QBe{TGT3js^ar*6#{5(EwnC}
zFrKtc&<=NBj5TS9c@1=A1fGW=NNm5oUsqV2J7$=tUlCYK_n5gU1MnpyaPy8s`!bfn
z#w7Hij?WX31cE8>D?iEpNhU;sOVh!tAmtBQE<xWj&5nsV5#hGz&gq&NRBo?%3OcIk
zLZF8E7IkwF{y%kHW1y<tjap!!wA^MIo#($l<a1lJ?d$79(vx!^3zmQl#eK~8aYRgv
zq?pTW!#`X0KJ)W?Jv==8bnP6QQXJFU`jdk<58t<eH^Ver8P~r@;WUU5LSUox)AAY=
zM|Gy`qx3hZu<HdGJ!||Ge4%V#jlDu16-@0n)d-m5My1vO1yp~;q5U<SNJA)N4bV7V
zCnT^F)Cd^XIf?|;nNOGQX70m{y1~JvohR5`tR%W$BAeX|P;EV%Hp!o@NrSb{k;o;5
z;f!KdP=O*=p(I>762ztFl}=|I{^?ktTd{NZzCrQFEEVgSzZ9vZ8TqBR=h#u6>q7K7
zbn5zT_mvryzTRG=)#Zglf|jocb<TF+3Iae5w_^%W&Tqhl=Kx37&8w*fReuL+fyIdQ
zm-+-6Zes$YI_l)EL)8Rv`L1m#kjtH<=+}BeGl6tkxA+fW>T}uI*}F@XTd6G)%%*yL
zCDbbbNB_`Rh4bNEV6`xXz0j^;WHPsFC9yc;dn?B?fNPD4TGx{_lr=J8f~Z)U8}l_f
z+~qFO<Hft&6acXRlxUMR#D#nAKQ%tJzE1F=*GAZ2Lpi8vc?UnqnHGYg;7V5Ay>H*X
z7?2r@z5bUKqonr}@FHitXxm5gW_VYm>fqT~UY*;NVqAaRG<)9g*h}sUZ$O_aAG1L%
zvLffQ7u&e1(f2UM4wndd(wLSyCtlCwHb1t+NpH5_(~+SEqI?3l%}ZeM32M-w`Xw2w
zTL;S*B+^?&Bn!DvLGHw*>B-g09IN^wRIjF4mHEFMN0zlixsVZF@STOma$=4K8eh;;
z3WQw97wl4mB_(#wKOjJ#1J*6RTTWejSEi?@uZ?Aj_AGpV$dGV0c#g>p&KYQ~?w@n;
zw$Z{hcPSP_pF9-xRxHlR$;n>$^Clb<T22zYV~w-xWjX=#cADAed&(RR)C0C1sjZ|N
zV<V}ZBoY3&2MH{7dqY4IYSxvhNleg*z68%V^fmcSi5Kk~aDwsBc}S6vx~}5tl(RvW
zx2S)qtYn{A4P;k4CIth_xXiJQJf=<TQgz_E$L3rt*x^z#&lHJsXA|!sx)qYV`+<*D
zF_Ro!X~y+?wlw~P5gj;Ldgp<^q*&JEy=Zwaf)LI$7+ZAj%$K@(GNncJ4lpA+<#&M!
z3JT`}`AP;LBKR@c!D{iMZ=lbt>j`I$Bnl#P#;!*5@AIp26Jf!MO+!s&Q;wzM_2(u=
z_F6>L#G}X%lATP`!^QQLbHyHDY}`G3rO^(Lz6;DByYu)cR1^-4jE0B{PvFPmBWvaI
zcU$=gY#FuBO-GOQRNrmsRL#M|6OUulj^)4DSbNgfO5RGJugRxR^Mj9G`}ygxeT5m)
zz1+fdI~$X9bhL78Yr$qg1c^u4RjVso+gPA7RD2F~aYi6v{``8FK7kRV@UW`Y3s5fX
zhQB6TcX&)_Y~6>>;gG3NV6as|YI3Lh(#TW&ZCkgVMuL)JxjbE=%Wsj_Q&v^g2wxS8
zlnJ^zLLD~E=m!<{3T-Pj8MSMryrRONiSUwv*~!I{dW)sRCM48i5nTk;?wD|Nv$hMz
za6-iSNx8?=IbmlnSPg&WMr#Asw_Z*lpe4Z%Z=i&)Ex(;f9gDhEkm~IVL21a%ac?66
z$L({^=c=l7gJT(JqAkM4ZWXDv6@^R>)J4fC_N~E6@Jv<ZXA<Zv%ti=kWZbHSI%ijV
z;owikH%dAnVZ~XLp0Es(<X=8gioF)4Sh~-&ZT`6K$0{#~C2;|H+ilx+SS&fODIYi(
z*HJXF5_0XOj^%=Ojwm#~M<jiiI(^dV29)>fb94SN=fOz>m^h<hywI6*EU?;8bfhC!
zMefDvTA0ED0s^8yF5Z_bSe#tZ?MDjQsXjVT`=%*C6r}0)1tA~4Xrtlw?0V^T9s3r2
zaA^u!S=G+RN`!tr-q#U6R_A7PB1&Q=OyVV<HFF<_Dl<^?x~Uo^%vh5$=TjRsuA;q;
z>KHQhGeUb!H?F@}SLSjMcZajPLKNg)<Sy~~qtPqAhXv#h^WXX-D-nfd!=~-;+;`ev
zqxbak+HU%w8!}G1<@cgj`V20^+@_m|J0_D~J^8ql<_*ErKitI-`0;xU^c$iS0gJK0
z#e$VMgqvRTA<|-fiA&kdqaqHY4WI_@C0>@3Qv$QjEJg70=r`{M%B2ySR$wbGogD14
z-+OHPbIHAapGG?K36IAXCl7f&uM%GdixpRBR_Ya<ORZ9MNYbitH1Z%*s$TpNBswMM
zqh(#j>`uu`-2t_`U~wq^-BL%2{u3gC_Y`sw*!zJtWWpPi2@VgaZ-J^hKjQ!jK!EM!
zYT75R>N!A`9E5#3C?Tn9Xnq()ACq*=LLlsDRKRYtO??!drV<>TOktwCxx`ajGTp#0
zXy`6kjvOFhQo>T$((%LP>X0pF3a#cwJKV#2&cME_x6&mqBeTsh>AR!vHt-EZ{Xs&U
zzreG!3SX#lQ9nwmuTj^Bd2^lJBu`i;8ZR8wB5YoRp*CM?Q4pouxr9Suu5D6x2NAhE
zno1!=l(fKn-nk0aXi0b&2*r7E0T4(pc(`8?58?)rOyGK{V!^iwC9R-E6(fIk6EWN-
zd9AE_CWK2+*$L(5uf3xMI>RWk&rBpf%xmj6;5lYB?Vx&_-hEl?TrWY9i1lf%tqo3J
z7MppdmT4X)1bt5_@!h)`kfWuQp+fbx!(VG9d3?oYRXrDr#Dp5>JQE3i^)!R)_#GkV
z=@{;k=MfRdP@xair|8SX%L2n~C>hmInP4e9n0d2oPvJ@dY!g2K{K3wHMIyQ-cu0J^
z6trL;+w+dF>O64OP2pa>oI@|+?i&1Qs?{_}O<#PWcW<E`o=j?!*i<F&x*kzjyOapb
zZvd`UxzI(F9&p)x3XnGhkzDAQztTqmBA#Wde|woB6=J)Bs;W^Vp=zb#H0ldI*7n$)
zpX%Jw+y%~vk5mb#-(k!Av4ZKfaGJs!A2%rg!UmjVW#xIe^9T<>H7{4*_}`yd3WM&0
z<-6#b_kkU~ha?X|fd`eH56vPEAvrwvzsy?=woA-;`rT~(>vNk6N8G~cILe3)nwzjA
z%@k8`gZ%yd^~9HkdFyi>EaH>gK#SG3x}(_t)dQmAncq#iotHe{nk<PEj)N928t$So
zN0@(wV7euM(;#$Jznktrj87-1ox|_57FzX`?4ht-JAD7i3}HEa!Yd%qOk*>d>NHUE
z7cY{w4b+|x0QQpQVoN<;ix5=Ng_WfF>H5o6@LeRBfkV|LYImVq0w|U9bOj?RFb+JW
zY)IE&8qJ|_GM1e-syTWyo6szD&|Z7Q&i0u?R&_6xa2&s$s$X#cl%y9oi^M^k@DE5)
zGcJ1;G%WJ>r+sns*_P*Vk0}_8;CWZg&e`qLb4fsTKVY5Xe{z6>2Lu;48WX56G<xy{
zK{hrvRVWU!Sd%NQ1_VSNSwbPt%z$TJp_u!je^{7Vx+%2UN?>jot!8i$MxRt6(oJ<Z
zbg8)&fV<_zDHTrKn@iOW<R*gU2i`9Lkjo2Yys5t(#2$b|NHDMA3ji;5EB%`{sp({(
zmY`J1L5+Z;kh{xmPAgWAl}xx?`0R<mR;tEPEC{z`N}{8;%^vP1pXThpFC6+!#W-dt
zWlgx|`P440^`%sB@<JFoUAQtEGE?|oqy%bTdb%%eo5an-=P8gw-*uLDCZC`>YR}}T
zM|j#GtPIZi@{?3Ry8LzS!9N`jKYl+21CGr5tT(h-G<vdQo%xL78D;(~o5?KnAZChx
zf>_GZ4CSCD1K7UXN(NwS*Hxey6uU7uW-Gk1$o5sL1xc7uJR1C@H}?<R9`B(QakxXD
zE_r3H+puZgZD$@!?rUxE+jH?B=eFIpOhRr>MUS_~%F#dSyEf|84o5l$w`o5m@YP(s
z+zyncDoGwx#;sWeAmy&kp#NHuZs114VVW<XM)TML2yvIrPYrYtdG4WiGJ2UGP;@ff
zS0UgPWn4XhwtRxxJf;~5Wkb{VwgNo*tC<>1$l`4AJ1zcZ{IjdrFY=LiGr*Jq^66Ph
z-dMp>#G+=}t(H3JO`G;6S$!ZL1i1|>r+6e7(O?FZ{8XV`Z3$Bu1T%?lw;-jvnK0B|
zom&B=fB0P@ycRD|f-l()D@4nl3?evYCEcz99oBsw1S@p5hwxyKtzlF$v)yrIGod-z
z4A&9haAcrk4%VEj5v~v=2;@Db`8vYO%G)z>ZBMNOQHl5DO$c7>;`;Mrew<?Lp4#VJ
zhdK+xKYaN>MHTgt<B)Cx%=E~&F<=CD2V91s@r|!|+}oGVtkEkwX?f0r+&8Hq_{!SH
z``Nnf8M26}i(P;IQ34|r=$mGa%=SG&Zh=aoP|H=2N}0o4bCyv$H<(Mf&RbG=K%I*$
ziJk2*Eq=6n-Posr0C+FJwk~NMI8=!g%co!d?Dj71I3x4I75l1i2_5|Ivh9g=3!N@J
z4d*;vbv|+JrhvAhcbl$#w<HX)3H|}$Ft^zj<|g14DdI_MJe;em?9R)Sih=KeRV9(m
z)<w_j$Cog+!Cn`>r`&oaszEdNK^kn}P<?j>694u?)gU{29LjE<>YOB+ti@MJkLy6x
z<s*+w2Nf<e8?8V?sRdwI;WYM|`Aa4_qY80q_i=~7KkXT4W6QsM+3C!-*CLm29Dj>?
z>o;vBsG?;TFmqj?YjeZ>y=DEaeb)E$sO>Pi(`5E%(O`2@IKcm&*|XLYGzaNK9cvav
znuyH1netCPk_M$92!_>bvX`|ymM2R2;0L~Dp`(0kaPE3(7;JCAPbY`Z1$4TMiGfgw
z*VNt0R5SA0q&blcHu%En=$I4T6GGk(kzqG_b6hE8(hc1^mTaE@uHN`RarKX8Xxh?E
z-x3VskqQthgnRL^QRTr{u*2%Rw&sCd=~m{VI-|SEg6@c*<$KxZr#?)Nv^Af;^|c1#
zH4O-~7yM=>@W&cLZ9Fu6O+rsvV4Dq&WKi?!EM5{uOgx9yUpY4U{d&ZTL8~c>Au(wq
z05k2Woew|Wym^xld7cxPI-+8458u7aG$>8<g%v|T6|z-e4BCeuZ$$d1uI2@CEnp6S
z2kU_wc8F87w6rCIwl6>kh9FI=231#u3h@pPZ%RVG=e<!xO^{zi8wif3th}7a06a*c
z0zgD;$#PEB-)4kSjge4&24NZ(LL8CBV^oq}64I~JU{p{g68d^=bsc3wByUXEG)BQP
z*s9tE>81*(P!?e<7r?4SNWsQ+k)DtspQ>e9-td%J*`StV8%z9bj26R6knT7yZ#_)A
z#oOrwYbwJ;1O_TgkITKFkutzY%3qYZd^!&_cz;!38lg#aqIhpKC>(;L6r|fpM1l>{
zdT>(Vs&MbbY4i54k~|pcQ2DAi%OPR;?fpCby&V_*iiai~E3x!tQP2rogB2s-&~EiG
zSi~W5CiAblwjJl+q?z>qBmYg*Zs_!85ItoH^$)~ZB|OSS?)>>9hZD3S279ioPWXC2
zK|&%uTd^;kmS)ft0{M+O4^T|J_QR_6m{cN;;2#=#3&q(0Gdf1AGf5u7aAOA!Wl4*0
zLWn`5hWm4P#vS7x<lAF&L^gv;(CKxEuN-F5QkaN}6yuev;AaRy{;rRd+Dn`nFYe^i
z)Yy9`lW6n&@`}6}07fg{hP#_M&kh?CA4X{JsK1pGYYWx4RZczAmj#Xo|5d;ZhBE<%
z1pgT|IT;yVBD^5p`Ua!N|Ju@1qL@dUm+UIvBWB+M%uUO4^AYiEP&AW=cG@b1sj&Ym
zR9u(+MAPGZq0OVO!(qZGUea*9q=&|v8$w~1E1*j>d=-S`d>jaeSOvtj$cBsO%a)8m
z`b!m$_w#zaj>=DlC)%r!=TbZ2!*i}FL&95m8M&3}wie-@b^h84hJJ;fXEPPma5cuL
zuufVtEyANOhbMw`XBK9n5{$BZg1OA6R}4d~9@xn|3(|Hz`JooGkB%BZQi%AsC=Kz@
zKRkDCrji#TCjHJ7iLK7}SPRlYXb#;;FZz7Il8WjK9q}S5lCV_me8`AHypMfI%tK0M
z5oFOW>c=x@BdMrfbz{cRld$l^%s2!#+2)r~dG1^K?$LjTD&HUE{Xgd<pa1(R75}I0
z|4Wwa|4&S7{*TU>m06f7m(a*HIaMM)N@jttI|+*uNl{fb23{T}!DHv2h^I*`)~pVk
zTY9r=#P>gbkdczQ3daD`VhuP0HG&AVrJ<7F%jEb5l#-I7;<JHMdpPkM<i5pV{$z&#
zI7Ib#OI0@`uh+ZG9{tC`-t3Z*mj7|rn5yq#q2O<y{r^4Vs{f-K@V`9=`@eVKxMu@Y
z-JeG6P2tN^&$tx~4D|-=am=+SX<`Po0Rjy{H-mKb-1&Q2ma6;5GpTWcUdKG=iHRkQ
z!C<D-wCJBL&Lio~$Sq{*^H^X%za|{YnH<5Y$HGB$32rvR(H1}=9fQ-D=wSiPn!$=s
zgWxoU*9sF5(zaQ@-}+~&!Vmg9!Wxx>85SrMmtdSj-T-hS4K*hvp<C02(}$RKL?;?H
zaOL;(#ZgZAU}}pK7>B_GW+D?YUb)4G7_}z8x_i<j$8#_<_G5I+eJ+>!(uQBJQ%zWv
zx8D=^Q_l+wcRb-OAF-!IhnQcxc=2My$A2f2vm}3xdF;N7VaH|+9pCiwEA8=PA`}Od
zhM*S$7WB0nngEZknznU2&yA9CZ6$mLBE)23lr&2rgJo_9n1n4pf7C|&=g|F6ar}|w
z#SMeyuh@OtyS=k}O_s<yV0~hM_V65TWa^;U)lgd?%`?XJ*mheAV&rhokxja17+M+J
zj69}auhc%Az4V`cVA)u4lIo0_VBelR5Z}!pESbV&r$<{-FA<CsB*O@1nLs1pqvcdg
zNt{{DY1?yT{d!3Y(UY}*5%=f4ao@At3+IlO(EJ>jg)xobK8d*atHJ^T=Ri(nr7Wg<
zibc-1;R#(ur^hUX@=#t~ecAH-qXRgpw=N9PD~o3$&Yhv!Xm|0r@ITfV^#}+KJ~=qO
zO!so@e_G7%B4OePvnrwW+_~Ysard*34~HeMT_dedzm+fsZpHYO(^qN>RM5ML6;)MA
zH*Va>JC}B(ORc7aW;FTcxt~`b^GH5(?ls1(=zaUsL{=5n{ioX!XnUwKYQvQ~m}S2`
zS+rvDI{-pW<eyL{ahK$9jlow-`u6Vt&rxxCPwFw~IH#Q^Z;pU*8=KvNVKyQHAm2C;
zW?f@rW7yH%)-(Rju(#)hm`4e{kC0a6!i4#Zf^mQHr|V>-FJI;={rvkAUk!(1AO*^a
zH@%oTMm+M-p>HO1H1s%eFpqL#29ub2RnfG%&#ENMyz}1?b*8XmTePKwF{NjB<}a!L
z@B*Or55bioYkT7N2VCKl_jLJptp5GrqyLg|{Qtc)^#A4t0{?x+zvAWp$xRym`yT&S
z+~YOhd=cN2l$@zgE3vF6&ioVe=l<HS@}Acfw?EoI?*5Zo%4L5~jrN<tKl_dszpnC5
zl`7@G+WKeukqB}b-v^^7VF#l4lD*IB6|b|}xu^7e{cdWjGx{+RL(8k<rCXRkU1_+Z
zV9_|0VAtgA^f15h?QCqOYItk94sm5$<22H@op^z-hQ>yvT(7uz@(N{aldIh0GMWS7
z+>wk!CgC6Z3U`^Bn&!4Ijcxb3F+uyWoA<#d!|f`H(8xyi+~$moR%8u`(>m`5r{n34
zoU%{r;>>DoN>y^H)oV@1y&E~#QN0>^5fY+7-9<$qMW%S8iznURc2F4~2f9v!|LgU8
zOj760ojbs#t=ae3h)qw`wZiv1iCHG)W*Lc9CC%L~$$nj$3Eb6<oHz2Z=Yk9RiGWB`
zcLw`SCGY0{Jtr~+$vs_$D(8=N7Ki!x_@Z9Fe%-2Xd!pbt&h|+Xq~Qwh*S9nEeqPer
za$SDf^MBt;T+Yo|&UfP3JwKoKzGt_8Chb?RsDEvGvXS}M-X<qbtou2#dFJevU(kN5
z^!uL^uvf0E|G8Ff-`(>obN}}tsQ&w2P*MH=CN3Juts51~F<t8q_COeu-j48;20+mj
zVOaWFnu1w)LpT5k+jzPRHL*xyV&r#^bE>{O$`Wc>v~{V!DkKOKzy?DNv9#i@j+hY(
zB~r@kzlp!ST~67z&I0iGq8E)H7*B~dvrH}iR--o!O-<3SU;l+!x6kms@VG5bw_8_m
z2#sd-#A$I7?>uwC_A#I1()6Hz>K9=)uu+#`3cjYI5`>fms}Uonz=#3-aHi~;CXIUR
zH_~VFv!7snqd=V(Pt0X7NyRFbyNu<l^qCL`q+)#|L!DPuRn<2FAEaXP9^$pz<%9c7
z#}mIWU^Jbn4E~*9_%g_|%MTtr2%tALH<!n$e==c<^L5{W)L8mEHI|2e#945ztcq+v
z%KDj!xH%*YO8&gQ5`Qv4I?Ci=GAG~Z)4edMmqTU@li|!}62YaJBoTM$iCSSrF18ey
zYN>Y5sMB9xbMeVbk%Cs{n#bDrEE4Ro`;k&}dwXbWE9b<e`ZJqrVhzXn1qAvrg!l7c
z=XQzNdKYO?Q4O#zrzGf^RB%;z-6-un_>wB&av1+NjsWRk><#hKvD*{6(lHi%b4Vxm
z<4%zT+f5db8Q}1)lMYZ*MV^d}kC&Oe@w6Z%>EMwdZgz1!$x985?iUxue}6j~6?RqS
z@VU9V{Q=U<ypDHfq7^pfMO`}yip7}Tb^OD2260iaE*C?ZsB#9QLzJCwAyZ>h90%5`
z2Co~No8N*JmqIoV?1hLEV|^hlfSbJ_QT#!EycQLC$V7tCWqQC5Q$kEqC;*{EVaPt#
z8W->T+QqoEA<!k3d-(aX=&<@+T@#|kz+a9()}Hpv!P-Ihur&7e6>M=40u8GVvg(8e
zFYz#6DGVu=^-q2uHP0OhMBFAV8y+KGrwWsMs}}KEk+tuk#PSV#$8UFrb0~=mUmOY;
z+kbWd!s+td_Z${19dPbn9154TzW)rtnnAnAw0Ry26*`meH|%1Pa$j5O>i^8>t2vkr
zh<_oY)g*pK=@9V&?}h76uJ7!_qd(2ZN1psiK%6nG!E0dn2^JP-PW&AeMd_{Tubr!2
zvHkzGUJ%HExRzHrgd@r%=$$flm(m&8^J=K_-&*;L{*oklt#)*vbbHHo_CGZVqB`<`
z_P?yEo(XEgB076-lRjiRjX@!p1FCw<{B4SNU%L5(BSR9_)f8lo{wF%ix`_~O^I$XJ
z_`($+-2&@>3btU10&X~F$ElfhikO;(>Y8;6qfLV#j4@UFl+j1<n8ZTa<w=;El_SF=
zFy5*-M4|9P?c_hgmSf)dGlHn%29Z<Bi0sl1%L|#_19mK4*ZJ{f5XZNY*D!`&0V_Zt
zK8`~Qrly49tR5dJ5|WE1{5CB}Uc8Wa=+I}5#7%&^{i0GZ8F2da>9nsBhF?NuUy2H0
zr<gCEEH9sL<IFnRA8I3?gB`XKS0BeDCv$sydz*<X+Zz0YB{lk3@O{vOt9ObFKkcw@
zGrQk|rM#KW^2{ps0x}>XAGG)+{DG0#*+O`4Ft(F%p9<-^2^Ui=*^D-Q1QL1+lC({$
z@!NFM17m82VF9o<aqif$L+JZIdnX$dE(e$znV6J=V-AM*f=g$<=-}k#wdu>*Fm5#G
za6K;l#ee1`=&Vi#fpIrage=(5(2!uc4AJy6+~OgNi;JQdVi|;Jxd7F-qYgqoo#p#=
zLf>w0P|nJTjy`@+%l4|g;P-!I(Wh@dVtXZo;)4AWU>FHvlEU6Hope~=Y}2(#I)z@?
zuLc{VRn}jY2qPRyRV%jkm=7o0Z=rbo3Pf8qTsJ1zr^44<<4bj1Cq6NiLAI|y)~==S
z@QA%CsTcEE7E|fCQ`qClmDC%)wh*rJhl55cJje#%U)aP}F@h!zLYpn=`x3Sl6NWeN
zER2%m{a;q#-@c}!6AlfP5O3Mcrl3K|xw*L&EH)-(EYf2<^~-Wc*NPT@%T0gRVLgTl
zOq@>=@tB_aqU{=GD8Xb$Ckm0K)u;UnAXCDCe+}W-%N|atAOP|*o|`-l2Z5yFhj{aE
z&Ut_Ydtex5X!(gt-*os^&5+Px^Q;@B-WJ1fIUAd)tre#d<iURM-un7Z6z+L~_lGQ%
zS<+kp!ovxSAc+YIrb)=+O3by`XBKW0jcoivV>n#M#=zi9XfUjBCt%sEcz5Gtc_~P<
zFccT|!ud~JlbDUshXiAmK0-|SBZg>2>~B3;L4eR=dBA_LdSGb`QADWNwEVYJ-Iv<B
z635eZLey0Z^-ag&iC!XJe(ABgFj;^bE=r&g_euZon?NAOw{9hTy*Jsk@mF#gAQ6e2
zsqFPb`kXqO2is{$OhiP<!$_iRcsub6R8)T^7^1F+B)Y(7Lt=tZ_oY;PHkp4eH;*kT
zkB6vYn|9HM!hIwNokSYOgid(LH9-s-8yS6uB`yexe&HuOmT*^VQZL5o%+otC!qkf~
ze`y$pQV`;qg0tQhu8f3Xf*<<{5!0$T%}QvWQ&<i9A!Zq6;O?*=!`xb;D%n&IONp4v
zO~tY?fKmkU%lOdY!x$e+!x*jM{ioTCzluT)vlyO?6e-NU)i|pER$A@FZ0rW)&(y4G
zBbV`2_sOm7zChyMninkmAQD&nh#>-5o<y90S)2t9EmapC97lFqTbZ-L!0cP7`N0?m
zn#G-;9&X`9E`X9}Aul`_N$j^kh;hWB4mA4!GJs94BxiQMAa36M3=ocAn97XbhBfKh
zPr;Yz$AG=Vq)4UoF6=JD$(LYg3e3sLAqpz-0YgJW)|jg7B}Sqp$!5f`c)!GIk3=0N
z$%&K0sGueOrVawwFxF}?znOY&tB%gEX3JJ;m)P_b(oO6(r`_j7+;-?Z+S(iDh&?5U
z98CwMZXu*_A!InMUcRp-gWO^eVn#|6`{o8`DTyiMR!W(4b!<|S&iC|2WsP*fe(cgB
zgXj7MTcBXZF22#e0AYGu3IuAMt_QLUk9m6*QyH8S`9*dT^B;DRn25}zF}zk~;qK40
zuvECVMBHjN&CIgnA<u%s=KHuj)cn-jhKK`CewXcOGLZBbQV1{Cb{T0*6mNQ%u6=I~
z0WK4(7<ZFHN_pk*PYOQf83C=OnvAsC@mXS+DzZ4huKE;@{0DZ^sPI^6_UJ=ysKT-c
z0&z(|=@yT*6_u<ExGbeeSdDRVGaMRgbJ*cPZBU3zW?QP=93eLQRZoh9q?x;XCEHg$
zqhy$vy(vmga-WGOR_xS0hUHguiN_hf+}6ryFM@NbtNR7EnmH~tnO*H>9+l2uTXU93
zCX-<ERT7#q95J5m&xF0`x}>XxdY_&nwld6&54STTZy;PNX^ZPjlI(ULA{hAhm$3bk
zpcL^~`3i`6s1}s56iCy3i2Ev-3~eg8OM3+h7vy||hhm`QI^5r!%wg)$;?>T_2R}cP
z@$TF14U=lEIOXP{-ZE@e!?bXUMyumv5sIJkR{^7%R~TD6ikWXCm=Qwc1UgPj@j&uq
zDnr>xFXF@2f0rklEpz!Q42~CKAEN#7=^RAbWhw)snpbBNnBVMExn~D~Q*5OW(Xw@m
z>|gm{nk^)T-=xI1^J%#J(Uvlc2BSVYLt-kpnrXo@dho?R9~pK82B{smP8<waKHfDw
zBia&O0A}93n98`^C!R1dY^taTG*oq09^<JfYSTY!VH#K^tL?tY&c)R1iM|`z<iRwI
zcdd=3i|?A&jbV5=9PZrg?w|aDDuX?C7GsLv`B!sssl@8U<ZRLXZ7PBVw;l{ZpJ;6u
zWdW*y`h7~u8ksoJ&JFH0xyk0u5oB)!W8r0zCMum231jN|n5RQZcT*3G${qe-ji4Hn
zZVMH*Ga=o?HbC)4WK$D0?|A3ut=M*qVyAt{g>3gew~D{*CR#A^{7(ee^iY3Sjmem7
z4c1ypo*4GM-0!o7A|_43I5@qTNhZpz#8OK&i3wrzLp^Du3$`p|kvc9Pn$@(IeKTMX
zqLpxiRl!~UJRFR_6p5%8<d=oRcWj~lRpMDB7foPNTmZMgiPXDIXa4UCrdkT9O|qnA
zO5v($Cjx!H53$+V0ybgElsAo`mN`v4wi@Og=r7827&01P5IMSQ`G<fF@|hvV(KzU@
z&o*gT=wrOJ@6^=58(&Td8Z)PgRtwYjA+9vfd=3k6N~PeA7`A6w1!Heh5Kq^{4a-Q(
z#1E@|I;&BQ{6rUu0b=p8hpB-U7`-|mBhHSPhPAOA+jkOkp5(MZ{fg6Ya{Q&D<7P+d
zO$}eU72m%TVX3oN7esQMw{wSywGJ>7brR~9I5aauBA;WB!WC63!I5mLTfvc8dE?=c
zKos&}*p-~%SG~p>K)ea9*)fl$Opmt2+2){h_s>5&iG3|dEg?(<Vp0*_Yll-NR;YE0
zeh@i@Ox*1Uhs}*<zM5rr1TvW(q0zQ$RBFKwlj%ur97J_U%>MBr;AJjWVt`>Y=NQHU
zD-ny69~o9pmD1T%N+;<wlBg>TTD4K;q)4zSi^FQCKDa>mt+j!F2t?4=cPcQmUS1@i
zd75lXHYGHQN(AR5rW*_ZflaN36~Y%4eUQ&JaXD;SU0I9+Sph`%{a*MqoE8L#B{Dm9
zPr9dE-GU7VCIO@R;q$E8eTmKwwM7{4?lPbYQGb)%MohC&`C((6zV+_ICN|B&>mTl-
zQZgd+&61TZG=LC$i}zlxBwA^h#ruVZV&3rJa|jLrsfSj``ep&z!G1W<zMwm9(7iZ3
zX+}IY!qQ2s+hNo&qS-~&<^k#n#mE6Mdb(5a+wFj+<nIp-|3FvAzUI<W*&P7yr6I(!
z*X@AFLbw2UEyjqFNuViYAtICKG}2ZF#MsHr4A!$?H$qM9xBB$5+mHf2q5^w@gc1M=
z23tj^GVeYH>gL*pXVOu1ivz&q$)EPk2B;|wb?t_`^eAvqBj=kTv<>yxQ<A9+Qvu4(
zdn0>z9(-zUEPXfEULUWuo;-iOUa8t-;Fk0Bz*YA>lSmgDZm%{S(NJMPXYLcrF?UVx
zEBAua*YwdSax9r#bv)$OwGp1yn=R+wUtAj<WmQQrI6h`0NlII^Ov=bXT=C*a7>hrN
zO;c=h+m>SB`#wno^klrw3hP5UYspV-h8@Dd+t$Exec)Iu_youPXlmKsi7*G#^W&?Y
zuN(lR0<i54aJcEe5}VFWvFRGZphrMzR<T_v=(hnks^BoM*tP48AQ4^d$OJ@vzOnGY
z=Vlmn9?G^hfk_C=jykKM&i>EOJ(-VO(9+W4%pFe2BOodEQe|tMMWQCG!hP61VXVe9
z%U&P;s0xRIsW9w+%GTGoncxtxz)%eHkc|ZG?CcuZZ30+V%UA=X3HS*t@sf#vmq=e<
zyU&TDn1n*K?Bl8=017dw9xUo)9aTZZ@ognx6xUQt8~=EwARnt5f(AfmZLt~7({FTE
z#k=>L29=wbn}0#q@*ID}NrW?M1i?;MyN%j7p@vRj?>X_eVfO0j6`E0xH|G%}+w^GU
zn93gQW&{%Q?M2nK@Uw>fvNpSyBr}QYdW#v5Y}luHQT>RfFM#u>EUz4!n8=BpK&+uo
zD<|`tnwU&tIot%wGZ?eK4v?vat$_wZt;<igAk$pa&<MePLi!-dvH?+T@Hp%TT5_f8
z$aOp5u}{tu!)$|+`?~+5z4w5sGTXL<(J~^SWr+b56DWcL1`v>>h}HoGBxgiLB@2=T
z!31WkBS{ny1<65jMnptG1d)6sdx#PQ35Rrg?nB-C?i=0x|NW1Dyw_uNzZ!SkVU=*g
z{`Ovbt-0o!GaWY^DJ@7INz&&7%`Pve-)zRWXY+Ej4m5K5h&i#7{d;Tmi#<Jt$mmpV
z9)d!e+vnkB+L(uz`sib6@a<v|=ii_5`PUeiH&dWNXXWPMNCjlzbC%M|7UzPfAY=>j
zW&gkaAn2Wg+T+XDiayWH!#u+9*l^+CHeYG=9((cu*rejIWH|30u9p!4>HS7d4H3CB
z2>JdQYj*4Zsyn?)f_1kiy%&5IMXEk}KVzgTFk?CLmf<mI%+ZF&2(h!77l7N`GiB>e
z733WvMFYJb!*hNaz6fB$V|DpsX~!S$<;Tu+=7LJc@a!WMspu*?>ti_RHwiYi;(?XY
z4t%?)fYLdM?;}_S!Q>sXFyWO#KKra0()36~*FAIJ&`WH;Yp8;@=gP`3P4`8EN7q~X
z72jQR9?Z4J`_0wwo*^Y7NoTov--$yv4x}g<?ACu<oe7R+z8)|QW2dl$_9$NPLwiVZ
z!^6XqjFdP2mpkjzY1`lk#cJSrV|+cA$B0FZaNyxy?ou$-H25kydMCvm6a5J(mgL8y
z;+ik1COR#({C@p}NUYP+N>feg*1YZ)cdP2_gU*&0HKt{;NEgpzV<!}9S#O{#Cw1ga
zj@6hA<{x4WS+eZ%cA7}HvA@e`SPTVjAr|N=5a1MFI0YSt2u;DX`ivi@<`fe0Bh%AI
zIRK+blB0?yy?V1V5{Qh*4dm6mgd>dR4MGXHtV}5N9Et`jjms?)?+-L;aFM^34^$uJ
z=b<jY-U{_CQL+`%l;_^-o>O_N2j<?ibzhibn^KVAQ@<njs~~2?*40*5pS{j0{wL7l
zsz}w)F+bKXRr04@zU}QB6B{eEI2Un6`EoGpXr1D2<Q_^VDNMY>Bl5OvsV~~+4SLP{
zO|XfN_3!cBE0*iAR`z-S-(`w9KxBf4Bcm?R_Vr!2Z~N%z=x$?-1bk?jE^qmc>#xif
z&<Vo6b|UcDe;`W!p$0YD{XL!@e}hHupN-(opYsSHz>!mi*y(q-s_W{y?jLB5k~j0O
z`C<_}v68b4pdx*CYOn(7|6`Ihq@1rXe!096VJ<U4iEv%KxCwgBz%Bm}(LB1Q18CQY
zGiN&3r%b^4AQfU3a^y=`{4Owb%}{~qKSdMo5h>FFGC89lq82Te%Pk*Gi)4;Q<D#mO
zs(WABeCb%_7Yl<O`&>+*fM<oGO0xU;b$f8CyCClVfh2vTivGt1fXv+<#pZb+Cm#U8
zrk7swoctP!CLwkO&@@S~k3OiPoag%}Gyd%nYT{Xw*t&m3mEuQtHIMyL?b80aj<CXQ
zWRaE=>{wuMJ){i0xi$t9<Uac#c`&+`1=Dnqea-{l4Dl5~9@3*{rKNd>2<hQ_0aPZi
z72|8@tRHkCMIpFFA;m6tLTq&OM-1fn{h=bU1z1q|p~V|hwbK%;nSEuDXo{_M)*)|B
z@;%9K1SKQSh2$d4F<WK;6f{r&<ICcr&*l4waK}iq=}0Q#Ql^r-N+={O=f_i|{GRbs
z=BiA}@ZacASvt+;30ezud?E+%M6TrmdyIe9QeEu_k`Vo&0v8HQD=I;FNaTHd{@G)s
z`0*EKV`^KCzNYh{)W*Iz56vnH_3Cen({(RT0EVy_pHiX%;*7}8mnG|E>^U>~6eFPx
zs9i|j@&kwqxdU`E&skd-Y!Z~c?hM%qdcVnZ`<ez|w?a)U_&b#bvi=ApVhEzuaOyf|
zt+@#XNXh~53?sKbhlyQquv?`1ZC!B>woKM$*n{+&UM~mDRLl(RBZwTXrU0Pv{=R?~
z2;y1>Fj3!-yl5wil=9_QhOU1Km6Jn>PGQuS*0x$(8kA*x!PkHF>ecGO2$@04$7X%q
zvt6FE=ifirNPFQ+G^+@%0%d_0fcPbMCm4Kftc|==(dvPiR!YP2Uy67_4zbrA#Pr2f
zKFAnf$Y~_vLsULwYgVuCy*&n|jud4WKwNrkLHZaO7VAWmDo4~AL2-K?qebSp#*sD<
z<r0Eqva(g2wZKFMh`J#dZ!jBbEp&wjT~%e}!_Ll5QX`P0Z+4J5QxI!Zb=tbI5wMYl
zpnqxD4<cV@?3{_rXK;34uyHhBwiij21-{V}T(8>@H!$9F^2%6BC_m*h4gvDggY-)@
zb=ssRb{%Bt%^0TUHSQKI*`%^|=+piwV$ilrE*)dY23-a87sI4)tswOxVNB9+b}9*@
z97Y2(&WqkZeDI+wX(GFEZFZpgSyD4o&yv(5wr`EFVGseA*BHB)QsYEvBQFC^c)LSC
zr?gBkwIui#^6tSdpu(iN2IZT31SN5gLsBi-6aJ_QkB1bGBzAz#T+g>j_}D`}lor;D
zIC(Vl3Bi|yL8QM)?;R6P7?fS>^<UU&IfZYH6tUd*%CDEh1vo#C$zfy8v@k<}3`-K|
za83TuP4Sxad@bo{f(q@sGCjff5rHTWSgCgQ-53nkKJgmgcB7fqz!!SZ)^4#zJ~n`<
zs-^RlyI}djCkYbX0}&fF3<e_JC!HA{NwREGHb{vPQ|r+sxjWxSWD0plyFxF%UCQXy
zDG2^vBv)Y~UW+iDg+`S<;$Y(Nq;-13_K!aE1{-ys%no7;>_?L=F6Fa+&rA;iVe`S%
zJ`dqO`ep}^&nZ-boPfbqp<k18oS&wD&bp=USO_Y<_yM^eNk#Sm_5*h$JDue&=tKFL
zuwiI++>_}{&<`c&lUf8|1koX_EGioax4jG89bODy9~Iz2|Io;T<FZZ;o4%Om>@>P5
z#u#VchFXX+-1g)4|4UOWT{qD00rC4#p^C@*&>DGC(33q((wG`!8jy3oj~c2nY42y!
zGMHw#GyrW6|3;U!&{La6((OOK5vlAth@lhEl;l7=LLAhQ_xb{VNGji_Bh;XM8DG-+
zb@A%>ffm3fkHS}sr{1a9)@%_QZ;u>c2ZiixjN)izv+#rq8O3+yrVVaEyEX9(gXkNS
z^~DQ=975(Z#sGa0$oezXKC>EqtYB?`yv-oit?m_b4*vOJIJP3yH$Ol|z>2Zh+dBE<
zc1Fi0W)LY-K~PsEYw6zpN9dpEVj>`PorSEHrJ*xF&0=tBGRlAVo}5>G%bXV={XrTX
zg4u&E1m7!=3J)Q_^+8L=$R9D44hm}p;++nIb#ab{;fE>uq1?1!`uQhNSv14NRfdlm
zf(fec==ywsFGN~tU*KqpRqbVi_!G>sb1w)sw3~NHZDSu22Wz{2lsNnB+TZQcPZdy=
zWt=5l4N?QI!+aw_Ye|7(X?U6SL3^!`gc7BfhSPU<mukFRgQ`VCMUtPO(|DPb;?)Lm
z!>p*>SA+;39PXhUOXR_rh&Rvp7(Sj8K49B8M05eJeL|rEmWy-rwC?xBs4#^}Vq*MM
zH!4_?&|{*7j>*zbL=G2G)_w4DORT<uzl%wTVu?%jdUA=zoxj|lrbA7=>`kE3CwR59
z2=?@(G%<2>Q~3zOn=@&t%q-*06~{Nsh4L_Wk1bFbRcbEM-@dr``{IoPlwpLC47a9i
z7ZXbh$Fz7`JcCGF2pIfK9Q_+<!t>Zcd4|y=r!<mzY?|plMxkPNIz|9@>5HtIHyAV7
za^dCuy(AWF`mCFe3(_ENUarf}_D{iLLJ(@LKy9zt%$ynYl!NlB2DvLDrG+w)SS03+
z>64wv$M|txF6ZcIJYvx~Nhbcqa<nfieK2;VwhnEw76s4%zNWtotMxBvgYxzS^&1Kk
zMr}rZO+q><uSAZGQu|5Q0WKs^B-nTE<|UHJ@O^BV?QcnsO~f4n$mbj&C`Q|I&!968
zB+o@yPfykr2;0hGEQXB6=(r7##PGdIN}73JnaQlZFv>ea<WHnt&;Ws<v9XbK?nrm6
zcG5%ZZE$tEtlkTfrg{kzFP#Rvl8vM#fDZfOejD3{U5%d8C7#C-KJK0&DHJ}|UQGG9
zLyXnd*~Gf104N>gR6ZcldARSh#5S@E2*!@=mjjjpM6H<AzQ1uvJa;e0Jbxg5V4n%2
zR3{l|U^q(4_138;xum+EABTtp<{HT`VqH{1nz<#p`MSe=h6`rvn5960o?;vA7Z*oH
zm)7_92e0vqskw9rvtg%h+Eyk+ArV35aDs}X5ViHdp<0o@<6DJH9w9g^7tf1p<d4%q
zsw^Nk&lMxfr1ju0^ddfc5_gx=aqFx=o}vdID~b{vMXXO)TU(Rfm_^{1?Pa{PT7FZd
z$%82n_|C|Q#|q0}Qs#3w<&ixkm@;zm{7GmZju7$KS%ChU{f8|+aVb~2-R64I&&#AB
zBSfZxpF&8Z&uY;*a6<spKS44Tu!(Dte{%Eu=J)U4<8xp5M}|jw8Nl7>=w*~bb2dw5
zG6<j%kp48%oQ;kbYoV6vpARKXvi~_M68ZozJ!u?E()~09o1O5s#5#!sTGGch*c~aR
z`PlTm_yVX>g!D4;obrWPm5J9Kf+it9&sAwmK+cL{_O(i*_t}k~2*ZQm8Is>N{tafF
zo@9_^fZY>$njd{s$DRPmfM&kozgE-#LjXd=CyPSXuZyZI{1NZ=6vBd?1gOKXlRbub
zbh77aHI-OYMGzh=qhY6A`2EL~YTU3P$cMMyT_f@t;9xQ^JEcHYom6SACEYp$FjuF!
z8GR#tnMlwCGmtEV@ae((iTK3)yPrh!)v&o4KtdUf^r-vkzcmBD@Xr8lIQFkU2(<<0
z*eRgSYR$&jHLjN#twcFG+Ch?pGPV%y;@_IlyU5SYLvwU^4DgY9^A+@xN@=)#CoT7+
zaf`5OzUN<iwR;v}$p;D8NudHbIFDmTp(=1m@-atEnEreWLM|cq4uv2seu*3Zi6Wfh
z^hoM41GVwO%R8!%Wrp7TRz?GfNx*iK>-WFt{RGT>47no`X9$8rpCNbZzXA~Gu)WCj
zz%Zm=2BO$kceFrNhTC{@NxNBgJgb6^TK+hdG`J)?gU$#V%@xCuT0gy<U)~olZ7;r?
zf{+OOF1q+NY5D`Wonc>odi}n0$H^&2FYe#g%$@Up2}r07jZMgo!MXg4Z1YBbd7sxR
z^P6i3m<Y~+@%;o=2`zR1j>wm!bnrPxfL>|luz)(Rw^43yrqJa(k7*DT2___lTFmVO
zwY6G$FH8x7jp4{)61GWZDyGDGS^~MFtA_%VB1mli2X2irH%)@vYhB2T4NT@Bm{rYE
z%Uuwun-Bx1kL8c&4bpMx8nsOjDg>+8K}f@ml9Iqe?%2Bb*HYflkhzkc0SSvxK6+h6
zTJL#Q*m->~SR6JlmBbgz^`@}(o|5_yZ3;Uyzd~2H4PZw-CWr$N8M+6dSs^T^)eWr6
zB^#Zz*4)7Ys=(f8Zm&n24@Ipfhd@L+>W}!+($a+D3RpLuJS|PAb>{tn{J+o{6DPDY
z52T+Y3hYHHP1*xi&R1DWk(vM;1X+m*moo|;=2P5}r2B{A!SOq*SUdJjsn%J}W+aZ7
z2^1u4mYX@O-|VC0%x}i`+e0D62|9rXA<gm$t`d*IR@sIRobV^>Es}(BXAqDA*lPur
zE2C-zZO(#lL~Edj4LoU=QO^a?@W$tbw1iV*@Ok!CNIxQ@bmaEHMB!sTS44?RhzOA&
zm=MU2K#l-7{`MyFPX?`wTn*rz03n}L+OZ1{ci1)dD;gaHr*NMYt25N-Ne;W|gk6Nn
z+6)^;FX_}FR94SOol23N7R6Q`#lYd8BxxehB*DDyE>0%fPd=>%957rMS@2e9Y^p`(
z;Ez$geS{c@YXYfK_Ab5T@cCMY`vj90*+OfmStfMm$N7Cw(<XzYr2Qn0^TziPdiwT&
z>&#Nh#g(yd7(Avd{JLh0FjXj2G$aoYSURUM8?ebEKIU`<^C`xl!vUuuX4vLf-tdps
zeUp<5eU1*v{?xB~!Neg50m-~$yPzyCs$=YG1{=Hr;ZpLHylQv|EfVPg)~6G3R<F+q
zYHfbxIg%p=RRUIV^${vhhSBP#3;Xz5jd0O!NBg6^0<~f;iZoUU2Jm_KCsO6_=&_!F
z{0`|efd%7e6u^qR@x<tZ)Qu$5D?<U4rfvNV2ZvO+Kz-<hHA%XOqzi)d0twD~?u50n
zsVcuU(;+!>5G{Qx!tcORNusal#3;0)*rU|_4)UAf+-a0=K>I0(^fxHO2=LDFjk-=V
zOokkD2f*MdB0Nl?qKb`}Q9KOEFf0;UQ{oU>w<E`oq)DrPkgQvc#i=0lZ_+?|EOXiE
zNx}?LB`OlGaI(K}vAHsnBa|@~AF3X$`NeHZwECNz<LKDiR~}l->XnnORw8pUv1S(w
z0}zfQ*g0BdtX}0gydLm(B+TRhA|?*cZgi^OLJDl4=8uTqihc20W@5~|!C^vPdzQ=!
zvo%BhiSGO)7+jeh3GGrv63k;ncCaTS(33)S2NTf7E)I`|upX)3kI7A*RJ6Pq{@X$p
zt4+-s7gPm;QwSf~7q#8Ngu;Sb%!zPAIA9KSv*XxCM@{N?G=A*}=RNE6mO1kHg*M<U
zpMg5=1>FlF(K4;e1f4w!6;C@HHz&@m?N87R<EicvU&nF4^&->0jxJ#_(N9StRApiK
zp2`Or66g*iN)<-9AJOK}opmN4U?O(Y@K4D0CFZ>Cq0WJrL%)+wS_;}hT?AP~{-EvF
zj8X@8Uv;FcKY$K`UYdaYp+fx*DX`Bdnd-_eKet@LqLaNjhUQx*;=U@CfHOiegAgfJ
zp*{t3hd^;Xu7o>m51e5;g%C^FwUu;su*iX4+CM<WB8U7g|LTBoIp&BQ>F+$^L%5!>
zpiOliD0uw6$c#rRLY>YYq5KEy-Q<NV&`YrVnchjprH0!S8pP3fs7cSjmOV>uMc@j0
zT;5@M*;;dfG0GbvF6l1v`j$?(I{ZJU%YYlFo#kG13{iyWRoH0UPm-Er#<Bf}5cUbH
znw<X1Jx?L9Px6Irf6oN7m$F!JUcw0=ci=B{mH#6@$A9YhLa%oJd;<2;0aSk^=rCak
z5l#<8HiHoJcej9a8)L*v7Dm3<G1$u)H5Mt0bn086L~wJCr(K(;^2ZRV#4$Wbp!2=x
zhLI9F3!Ld#BbMnL__pTrn=9Nq_c1=5m(`dZM^KN^Wp#w!WOr?0^*h-9Il2+0l5#|W
zAG8Z25IW*{iEgnhCifG&?npheX_}q<LVCmKXyFwsi~im8OAaRc>CK+!PjU3za_736
z7<=Cot&lR>K*XjP>~p83@@uxXS{FltlR$&ozDDSAHUKrQyQH|$0R3&Wc4Lhe^`F8N
z3P7wE1jGV_i{Y7=S3($K5jV2qXi`4-D*c=CeNec&OzW}()6bbbp8qC$b8GxHkL}D{
zQZ=>QpH;_r3maQ@kYdF~Fl{d=CKevh&RO6kwjJ*dA!_aHBSkx8f8Hh~V_(+RTAu{*
z1VjbW%ch3oN(Qj0m2fM)xA)A2-x&|0W1Ex%nfs~}COqobIgIXc5a|zUv=<Tc-uMUv
zZKdhZSBSyfQ43CuF363aAdrJUuK}*=)w_p%)IvZBuOk?iL?*6$;qlpn*Fou?&H1*+
zF|EQBtEhkDx=}wsNx)jH@8-^h?{*d|kSDj?!qReK?i;s`z?)<X{M!@y?}lq)zDl39
zM#D@Ja8w!721I-+(R)}Y<L2PX1g)qXK%8t}o-BD4FQvZy^K7YvdF|vGt*QTa;uxn9
zvc0t*D?k)>`}dNcWUF0o$qFd{F=zfi^{oB>WRH6>6ES-B;Ke7J>=j3;9;;n#TSPyc
zUb}?-hS#oZTu%g6C^m4Pbh%h)x1hwXRi;#2>T~91_FK2^Y;L{we3;|<wOggz?+V=Y
z;z+)pywr4=!IGZvzL{-1#Fq9rRQ0629lxaV**vOW$5E%L#>3H(8xKkG_qmn-uRs3R
zI*>#Azi&S%dS|o6-oAbNq`SL&RGB=RX0$qgHU9$t@^kx4O5VNu(01`g5|3YTO|y4H
zPgnxmfMK}@;U2$u`BFibv$Wm9R$;Pg==%v1rS;xB8Y?H=JyfBMHm$jo&F`L9ow9J?
z-3QrEG4>xOyd`Su)~%o9MIrhL)wC@MOPZ5u{daDCnA)<)`qo9ew9$wSKDEczZ{1*I
z?P2bEWW9c9qV<Kf-Y|!o*5qV!Ir^rLIF>@H!6%zz!5g#!4jUa-lia|yuhkJgiY`A-
z-x9i(0m&Z5tDhED3RjeWf0mG*zh6qKQJM=zJDAm9*M6rpJ~ofDN4e<H0gs*5YoA?E
z=o=Z8IdSC3jnik&%#e3^FY`~Sk{5FcC7#Zk|N0}jF8&kOA=0%TW#}9i;6L}B|LfiU
zFWl@~6^y(JAdE=VxF=BnI(B|q2iqj#wn)U7e>h!^Dr12P*c}Bsb><C1mr2b2J5eVc
zVZwbm0V=+h=$`W&beao{TgW!TKNG51S&Bt~RN?0#fS+yx05ORM^C-|Yb11?Si5H^S
zg8Ixm`}o}Nunj%2|6}M11|v$L4+47#xCw7AMkGF$5)A=RH}Fl&GH67)E+R70CtLF$
zzjfFC_aPqdFwA89NyP+<&RG{j!>1Ut<f2rejeT98)#AbrFHp)_;<9h=UI)go8ATnE
zlT8oMgkDdnf@J)P)a<`sZu7%Z#W$DXy+%<#efkB=8fkVQ)ACTN&~Uh}{SPUR1?p#`
zmJRv9l#nuMd#g_c7X#nUg9i=3aw=X_NF@Szir%J~8^-{eM1egZt9kb#Q65$cT%q~<
z@64GiC2bdB547T0!kG9cdO)vfkHvuU%a<>?*Xap2>l<m|KZlEOsy6?MNHukN!5Lps
zH@?5vjGb-85_<c_xUW5ae&erlB^F*^9#}@-vxI?1N4L-V#?|-br4KYk*9j>~<OI`d
zY%)w7+fKP&5=(E3P+P;6(XE`A(2<mz#Y20TzhBz*Yhaak+imewS(BEps{)}kv)S*i
z*8!%|-RY^JY-0bDFYFR=R3L6ZMl`%^vDfhC^q)RqnC9Q*n_oSNE952TJhptnHS=s)
zx-rl#6moj195|f6=Kj5VyMC75!xLF`aF?K<5}>i23jTCuh&c&rMs23R*mG}&NZfV2
zHEvG4(j|!vcYJ*VarbdsU+_o`8~x&q8*#N+N`v3ShbwybvKjK@sTja*iBg3vb0@E0
z05}Fe1xkKGc2^)rxXY<N>k{z?G<vU8=6j7+FM98=&Ywj*tWO#5E1sHvO|HNp%P=);
zA?u~}H<9--JsCDj7xju&&g!;XxpL*Fsg4b>M(LM;DtI6tP{I?3Vp$+Aw#NKu!v(qG
zPfh^a3FL!0K_Udm1BH7~-9F@l3zl$H8i6PAkNk5iq7D@tQ2r<7uZSWq`qQ1(t5lvz
zM*}|;*s<dn?7`IGjdR#==iINbO&rV0T%71P{yYr?jYHsHe1Ub97&uLbiyl#_zi@7R
zqNM)**`Wd)5+!xm?_oYW0w>H8tPm-W$yBJk*TA}ou$62!<^MxCNn0ynzA=SZ>yi1s
zUZN%(HAkRB^5rFXV0>;?6aNy+IVWv^_t9PTf7&1Y%0)T0RV%)6OSfr?!62tHwHj+R
z+D|+1j=RucAx#we)*xFfwNo6bg`(RpK>Er!cD;b^s?jIiMj?#p8gQvr=q#}1wkiU!
zt^me7JAPifQ2YmYDnQ3sdDi{)2P{zBQ^WCV8fb7X!H=xQX2YIh2{=)R;uOX+dE4)>
zwf3%D*E|2z31F5rU{3K-@XK6wVgh#|ZJffXp{{<|khAo~srBOUFMn6_d>4DVDG;z*
zv4`|lSry^&-^@gUit(Wf3U`I-y$Lmy{M}Pok4CE^V9Ph~*NTN5Nl-`JlCX#^LG~M~
zy-YUJt~+xA7ynCtES&{SL}pFz)>AS_U?G?Xp(`zDCHuouxR=@*am~8^h2pZt%4-r_
z@gmsYU%q_V;Iq2ZL26lA8%A5#vwo(;6u)7vunfk^CyyWJu)biblWq#s`moW;T+Jj-
zsPr9LKVSY~14ohQVIx*^2A}QC<^L}qS#WRl!p+kEkJs7bPV=?id-v{5Jzv2KSK>o}
z1w&xyRg>#_Nd~MQ{@N7BK5d}l6bSfNVr4a9+Y#~Vl_0hUPV8{zH|TkF17`dJZj0m3
zc15j3V<RZ}YXXvXC>N{qGxxYw-eTQeCT;{TKR~bDcC*AT88lzF#J+6(h3!EvL*70T
z@!0bAy2#9qw{>`n{g5$U=N-n*E!Yk2C5IzL;E=1UuZ}UJ&pi-+-k=Oy!c`CoR5}o$
zu7)@{F|x(@@$y!lH!b#;E~UW{H{PVcSZ?OmqX$5*K79C-m;ylWlQ^r;FG_q<Da%^J
zCY`d*+w?~Ek{f}T!m<Fv50)>A-ni^7VFqyL!Gkfke5l1&qK{?ror$LrhHhO#eGe}D
zNHoXYo<bBj9+!F4)<Z#Gd#b^OP6ax2I?@9pLe-EBttj>hDxkd!v=*d5NUjQ_Gcqbn
z7;{B|4H%KoW3f8w%mXKORkQwOzw^5H%l-b0qo@+InZy#AqJEQ|dq3`o6*>!5OUo|j
z4u7f}2{B!ZKEZ4RrVpRj+o6q;_~Fk4z2rNfot+TUjuUWlad*!pM8~a#GF`@O0_)Bz
ztg@e-cEwXtg3K3a+!@FPBD=dUY?QlV2;vd-?{ouS;iPc|%_bujl3f;GU*Q)l!e^$&
z$ujV(oKI<BEpcx(1&V7rhYw#v?S^Y5o*Zkms)${?EbOZ|!C0?MC7#6KYI3hxLlj|S
z;T3-8-aXjGb`i&458&Csa2FuPw0IAfJe9%~x5R&%Jz2f~?1vRiV0X;wmd9#u_RVrn
z)o|HqX>x0*HF5TjHZxpm#8U$|NCa-s8`&HD4!gSe>NGRl@?p>YjM#qQ8P9;1SVIWH
zK|yOFJ=~4O#5<j2i#@g(Qhp~O-5!Jn!YdeQLET&ld5M(!L=usV!wqJM#~-}sjJK8e
z6UmLN)f;bB+yax0EbONmNCy(b@jZL?BsW;aoP6m`e32UZoiMDa0vlrEiX15B^6WW%
z!zPQqdS<}6K*P|`F#1(2+@B%u5e7w{SiCE0T>LsVmNw*LM>7g$PEdb=p(c3XKt^RM
zdXfQrnCmh;@kE?RJmP~ub2tuMD*=9fMfGOxMQwsB$T8Y2u=SeoJDsc2ox@*L+9Kk}
z!6}$jz2OUw$_pT|_I}Gsfz05_UVAkqdYg=~YgZX#0Q3F9aK`5A!HAJMblq32UoV8a
z7*;*}{QN!8((URsy1NeMGniU^1#k3^Z5NSa?%caq9XM|duJou|x0ZxRyQ;%edFTGQ
z1qz+qy&1;7WN(8bxW1CU*4xxLtqOyLTZ=l{+dsv!!F7FOrGBm*disBs#xgPd*vVY)
z9R>wCiaKT=np9wRy`JK_Y2fY2sK)S2Yj$RG@1DiaU4DhuLd2C1s`5Qwj&0iQP`vi7
z4xabo3P_&rp!9x?T&{EKvMJKl$?*baJO=%}vsWc59y=BbpLuFHR?<yuH=g0<R!##5
zEyBsN3c)%O*(y<Hl)Bg|FCX|ACJwM>P^P-t=c&&=p`*vL<$0RR%T^ENWzCV*$gd&0
zN!9$3PJ=`sUo@!5^Wu_z9In}3Y^^a7sO2lkR{WBg8UP=yljIsh(={R}C`c{vy1L-<
z!Jlf<MWT@H-b-nZaT7ty=@4e;su0TJFsEjLiT8k|(jh95u5@Bdo*Nu+Nrdg<^5&#=
z`>fQ<<2FQ@TR+P_VmQ>ZE>3Ts<6yH9q$V#NYyzPn9xWnTA04iUniw{g`{Wra<)}pU
z3kuTxQQk8WdXyNrCkCz&fDeVA-<pTT@87TH5l1v7@f%z)mK8E;2zjR*Bba4RVzMR;
z(Vf`B%5^L|5N7d*DlPRnw7Hc`t}r6FHp#}_xUm3gh*3D!7FFR(bq@I-PHGHvntv@a
zb!Nw55g4(fv!;O|hVrBpwWg!vE&|QKmHk6Pc2mePftqDJNRZ|Tlt^X|$gSsg9v!QR
zLz+mc9in``+a%u*4={j_ybJny7I00~F*(QRyYy;@w`n(mCd8qG$r*&{d7`aJG2-?T
z7lqHF92=!w)Np@(1@8mO5s=SBWfO?4tJS{rv*^9OO_s<jBP$CkLJsceDY!~K$k_1-
zm=V3R(|dYnL_<RZkKC19z8*3_{Z|`t|3V)&5_eB8PNeYuU9z&q#M2vkm>EfV$IJy9
z!^5rh)e3j$L`FsuqiO_PH6)zG>#3~m;)JHM>zcT+h!C&Vp;yc!-B3!@($mu;?d>S#
zL+f;BWO(lc{`J?EorBAUkb0PdJlmNBxkU2qu?uz3c>V<{ws%zN(5l~m4<lr0JnTI1
z`eR^beF1R4evVT-s!L&t1uZ?E98&mo1Wx2vnS}03`~`Z_1;`)l<tWOXOvf3RL>tw#
z*(NMiVtl?l@BHQ!6jjwaC?BVuDxAOXd$dtbI*Fv>){Rm2^wNlDI?$S}s;Y8N_}Js1
zG(4RWaLsl;G;9C-%{Z_O6fZXlE~1m@?$jiiDr9tk@l)Sl;|qFbH3Ge3+uMbS>CU1H
zb51DboWQaF1>(ORN#}7<Aci56NQ0-uiN|{t5%j)7(P%%eo4s}RVoMyRs#N5M{L-06
zTu`Y*28fs>khZW@%Wu!mYG3j7X{Wd3_hPmUCTVxb=OwzU+=7~w@Q@ruqp}xtplXDa
z8k`X^+h*x^+&+=G1W0NkCZ>f4+z4A)q<rD1MJy025Pf^0%1snlaSi6oXayF?p3lBy
zcJV1v3M2r6{QMEsYc^dRSm?#v+RAwqrg_0~ft2INtHFt{L6X70eY<yR!gOS1XF;@m
zWb17SKb<3My~9v-_2F}Cl9&$qPv*u!xY$)8A&SO^>;uL0Btjkcx^>YAd+~-@>O`j$
z7eXXT;GJ8xZ24e$GWk?G#XKXLFGJ4kzOOHlzJCGTP|l4~nm9LKq2THw>b>}?jY;Fu
zC0w?M^v{rOkdO?wHOKx&v1<DBdvUY8%ZtmHdueq0Xj~w~Qmxz+*Oij8@>irw<wBW+
zrL5*}u?~JfWS$Ky&ZB1M&f&H{F^P`RFL+Y)VjF3K5cUhH?ZWtH*krv(eFFW)jmL45
z;^qv%ym>4t%L|wYjL6OoLfD#KQ=rFw_1b}}zP`RXaPcT=KR3kCk=Ow6quvhuX1<*w
zLF_d(Io_rhU^A|ta_+u<hD|)i_DlN@e8vfJ138?ZLShIKIvD?w0&!x(r3utzu+@G1
z;2nfBx#+T(62GpsdZV>I51yv@_2TI%)51J8-b<-}v~HUHA@}<R3|xFc<PmfGb)m8J
zMQPDx=~amk{_X6;TukQ1NDQ=4!$G2{nO0n-v;)`L&!0bUreD&tDQXo#ECdzi3wS**
zG3ua#+p!8?R$8S9q2^9Id-DqTD%}m<Z~g*i!WY1^!5^u7(MaMTyO#r@;hviN^clyI
zDI72*D&`1J{>YPsTaz#)214+4Wg|Y*j~EEsxF_}D0e!OAxMl(eT&XnYn89qe5l*8M
zSzG*V1YYxI)B5YDQg0uirKS>PVB}cj2*{R4<}MrEbL`-}{G~^jx8KlU^~YxpX0xI<
z-E*lY&LC(i2Gn1mm_<YV`%vt1ej#!V<zCCEnSe6Ori_kvB_&T10e)kVxregjb^&?^
z@g@cH-!G6kD^qb+LB7^*0_is!l!<RDYwp4CFQvf>`V~3*?b?sPspTYsk;6e=T&)*<
zy$&qEuUJ4287WFP(3U#fucIJq_2J9a;s^**I=`CY?$vL9q(YVlHwh4WVD^33O)+>N
zf0@@Nnut({Kvu5tvqbi1pODKX01$A=eX)m0b62(P9`WJMjgfk~Ap1ma)2j$ah{sdf
zcl^b_gtZiAYoccVDAcIB9I0mfWl;s|nTtqC;R>j!`fJ-UV$*~_bFbU6Z(mB~gg`0X
z-W-lh#ON>;Ud|)B7&N$vf!{C;QLnuIQ(oq5xkfpE4SDL{wzYEZ!A?Y+u!Lu!8wg&b
zI0{cxr2s6%^7Y^)YKd(iioJ{-rk+jH&Bzxpa>7c_ao=&f#{5F~_yyk5pQSm1TZ53<
zBl4xfJr~F4IHnD(ZtobGzI+EWn7VKvuu+J^wpOCzpSQ!M59HG+dg<ooI7FW~_+2Zn
zo)44mys+c>kNGv8TP21)CF!4$Mi8NCA>2~9nK@5u4IO3WN2s!2;&dzE6stpk`mZ*I
zP8jU6o>c6YZ)Ws>MNf3G$+e5epj=8*LA|byeVIEMabfeOWGDV2(N9yuD6QZ1U;LcM
zrY3!*Y{gOFeZ*Q3Zce~>R6*#|hFJj#U_?nr;6VN$u3hW|_?|{1%@4L^|M#$t{gnJG
zMC@3UMw6I27^n-zg9f{7l+0Q5o_!V+bYV8m1B3>mUeDlk(AEwBEoMF35frG^i6(Ld
zwLes^UU-yjqd}3nJQfEURy4^?DvJtXUYiQ!Q-<;V5p_6$D+(hFdOA}vzmu|R{`{gq
z6b>SCOZZlB*wX2^f9qbKIi?k*b_jy^HK6R2pI<2vq7twB`Y>#g0>ck4Kc&#Tn|l_I
zkoZN#s7KtvXxSbQ&<2R7qm)B;t5#;8EpEau_+_}?Z5f$K@T+?TtD3vu?(6lp6qq31
z_QHE4%v=)J?nf(c)3ss3^Ph#tc^YHv<T~!<2y(x*mf@y&0(wV>lP<)djXg%SGBWP#
z!tDXP<T%Ln<$=wi=zSg@l%UG)WA@u;`4voYOCMT};sD_C0j9^qkm-o5tN4@h4w(Q#
zX6`;efL-K<c~}QXU!0DFQ20yl<(qhGH+4=oZO^y)ib*)vxD13BH$cgZkA^$vs%{;<
zslzuGo8U?*m>!E)3%dpi*dM+2t*mPM8H%feu>Zje8FxEzEChe=AsdsOr2AlQy@Gji
zcAms$KRj){)0;PK+LQ=#U&M#3N4ORI?zN=o%Huky$+~pjap0SzK$-H16S$~T_Iu8{
zlcEU>d~JLC<ZP$@7z|;RN7^di&GFGFWRCv|QJ{=p&9-kuxPTRhMyyU^EgWJ{SsUZJ
zia{O#q-AtM?drvqAH;W-iH9INB%2YXX&?4CU{r!5R>KMcF`a-%okf0Y=6}gYJvovl
za>QjQow=Y@4jY117bO5OBEdI*qJ0?|-Nj>m7^4~e0(e&p5U3k2HlX2IN{}P~GmxW@
zX(Ye{DhMy!ZQ&^CqOr0hBeOviTWOnBNP<TP`#&Xu1^#J#z_wa(P8Agp&VS?|TVpQ5
z6cvFM|C<3yN<XJpxXPxF`;!}dEv<z6z^OEQrb-c;vXm4crWyFLCS<;0!V8x?zS!5d
zjFjhSobtjjMlJBP9)#EaDr!^1jx}3*G>Y(uuN;1}Z1eZep>noYf<7@Jm1GkAYWKvU
z{men!Q;P5RaVVhVQi=T9Licf)d+QkSQTlIof4}9lb?Bo<fAp%K`knZORmkA~*&QWq
zTn)}-j*c<_L$UHlyaYISatcN&YOspYLCylcvM4jL_3|rhVpo|89HwZT_ep5X5n#bH
z0HE~YTV8AAbw4mgA2Y}C-vcbN@e|ySSF?GYN_rc(S3BzUep0rh0_X*8Pa6g^c>Om<
z`R;m<%n3wJ1(KiE1>Gx`L0AefZ$?t`h>sIiMZ$q)UHb6G=qBxPHUR+yU6TBwq#m6f
zsSw(mJYj<pzAiV0-!r?NkDq^G|8;B8Ku58ZcBk~y<!lMUZS|_iFI7-h#qbf`_bmzA
zC0JKq4DbPvA6x5OTQH=ogk6SvD-|YfD7woNM?l{!EaA>&ds_<Am>8r*Bw<4-$Xhal
z`?fq(&|VHSpVCMY@d5DQT-AcfwWinpT02<SKofYSb$|bTcILxs)D#3pr~U$G|Ax`?
z<!o%Z$M6{A2rL4ga3CLCQonR$KH7eQ%17cUG~3U;u|%7z&>wbf&6mcbBcHL`i50fl
zXZ-?Ul|q_IYaW`BXG2Xz$w_Qo=jj1pU&0I8rfC<}H-K-qVWt|n+)5;!2cBX`YgU!|
z3kkBHL<RL3d%o+)xl0rHx_lHs3SZ!b;{Y1kPH}N<e8I2CZgs6r<nOY?z|Ev5bC4O0
z3E>z7C>+q|7(&YYkoWWRGnrTdeUWUoy`zH^Co^EJR|Ef7{<etV$EXa&U=}rlc_cM7
zuF%(a#Cw=yc88SLCW-AIKYgl()<-yID|=z2eiAJ!9&xKEQl#UU%T~w*S@){wb!r7f
zejWUlrGb^wK?1;ySVtToQMQh`C{u+PRjUWmJAer8Klf=Z%2)w>3B(}wQhN_`Ip6@e
z^)WT)5u+U+Ob{I;q}`Y%*!k6C*Kc{AYd{s_Cl~8@lXEDBJ7WRQAy8@%=N&*(r)@&p
zH%MHRuaF+OhaTZeYy$Mm6d}`(LAwk@dp+N;i+Ux79YYT1*%DX}M+N?2olJa=Rj%D#
zSXXJ`jPNrb1Fz)l5>sj()hLwU!nJacBmh(?=Ybz~-_$}(IEyObH|hv>x8R;VU#yu_
zcw74vg&{Cxykqp&zg7TPaOc)7H3Wa94F$Va{_%%@aIhc+rMbR*0D{7`4{Tm5fH^$f
z^6}wWGVP7K?<mrQEg$g#ylLi;GV)NMo=h~BDH7#41CXjy8h$leXQy$M7jMYNcHdeA
zo6fUbatOe$aiB+9bY_c-i`OAVz4W@TqdyrCpV5zGUY|(~Hnu<RQH~taM8$gV>C+A5
z1yLp)J%0Qi?I+gQ0{yDg`e0#H)<5>L&%z7zy~O1)xPinz2Tz2@&d!cEum<i!+u*0v
z;V!-O+>=R5<K}92M9ni;;bP%Plnw7a!E#=i@hH*S&g=xE#JI4ag*iJu&nO|W-x;ma
zmq=!cRa$_MZxa$K>xN;_mXF;?Bjhup4`7lsWo01$$4vMn{bddXhWn)2>2NrC^5lCk
zv+o$?%h3uq^_^YY_SzQdblkg1{&i67y_oZ@YJ+nA7|ksDi>Ojd-Qqq87vRVol%sGf
zy4?YL(qOnyeM4QuI~550#6R0}4@VJZ=hkpg-eX=`<E(Ds_;FR~pGR(w44(yX>&;ix
zc5y90PT6wA#v7~WiFiG{v}WiEa#`<REo|dT05nCznTy`ca=47h>AFtF8s}xVIY>3t
zc9thY)9Ufcz)^6D*8-E-{qwp5ke0hm?;|+bhvn|UbR@A(s0EV~N_lZ8bhAEf61?8<
zYBo6VfEcVSli$&gC@Q*g@J@eOz0i^ekAr5O$YDI4XJ|r8#LMxkw4l+{fh1a-uVUWu
zq%qqf(R({JUirD{4ZN+ygh^8MS5K%V*jNsoKR9tF<gHoDuvqKv^4H%j3pRf6IuKNH
z2$os++8C}<+Hj!0ODC|*EIcB@Kl3S|`M?;@k2-LcQlP$u0?F2*>2*UWX)-!<VLj6I
z6?Am@3*g%=k#wFnh)7Y+gm;-v*w67F4QIH@K70`6C@Pqj=;!SC9l~FyVJx;5(f^`U
z$a`c2pHAsfe}crGWwgmQ&>wj#M&dr;F<(PeyoX1!4lvk0VB;J+2icQR&aI=~Tl&ZL
zwL4UviUPmlgwL5(b8bT>=77pwai)r_PXvmXh@<aiGmXSp91dn@4YM6SUd%G|E~D=y
zH!S2nmmfvfzntMdGg@by7-+ioJ#h{ro!NVsh-r~PeuigO?nqEdSN=zQ9SHnR2NS6a
zQclc>iP&1E)B4G<<|n#gzI#J`rrpcGf`cs{JPHWtOh4zDR_rfE4jHh|Fgws3GE5dM
zu*foN>clbM>vQbLk+rDO#4L%aXF6Omk!)vICf`|h>ROiPAiVR`PGF)!9Nj|;-W)W+
z-ec779y0y)=p2Zw^iBZ4SNRJ%Q`i1__RMB%BN~O`#DI&-Sz^O`6bkcexn^}EFVZs5
z-2$*>^B@I%4`1uv{@34quh3{boG-s$5yYcDdemFemuQr}`+42t3U2ExNohgB7&Xrj
z7$92F(#tO(If<TJ<4mh-@^8RqUY4E~Da62iJ+ZBI;R^eK`Nr5@s7=>X?-7Nn$_bn{
zQ9kfxe~B_HLgyvIZxXp|XL>CLX`gfebwRhgd6$r|@Mj6v;cyxw7h_j9WmgFsq<`vn
zL5$m9;tJ5B>463h4i|5tsNjh=PdtlHVN2e_h^UL9HvBs|DeuYH(kr*QW05g$P*rZ`
zyOShPsiQz#%74OJOZV&s))PSGP*Cr>&>}0}YUJ9ydfco{pSSJUQSxnEW}#@|w*oj_
zp0C9a^^wF#k+lgPNZ@Ts?6M5sLlda|HFK!T?t7oqO<KO$T5ljlT)y*8*_Gj}X!7un
z(wb{8tmPlqD3s=cx2$%%WYY6fp(e}5))$AYA%O`y&QGc}MAjpF3%$v$Xrt$%T*Ud#
z+}W{=0>*xju2$${B;s&FCKwRxsc5Q<biGDqm#f;0%c9(FX5CQ0D(UZ@&!?cS((06X
zpez`}m9NWox^S!7mF>Nk`|uS)DX+q<s$lrzF$yP?_~Uh)oYGyjs?jenXip}l!JiW|
zFI&5<{3JeFmzx{SfM)4%=2LVOgF1|}@@5)H0FiaiEMd%TOyphryX<gPUVeJ4Fm^)|
zYk^XdlRuf;X0|QL&~bKCznF)dbkOb_x*<V*HPG7FS~Qb3IF+r^mTpTIvV3Du_4+%f
z>P&iu7>{??6~X$MX;}2-#>fP9)sbHr$%I^pbS=v91og$ai~<3HfprV8t2m29X_qhy
zDO*9Jsmcwu&BsBz(O<fBDN2qiKtFsGlq%Y&UP&$j7e23D8F&p|p98kdhSXme%4Oun
zq11`5H$`JX%;d6LZ+iJT4P;z=6m*by1D)I7EhVrq6d5&9mZL#q&~4s}sWtFg&i<N?
z3<#`6*>z6V-yMhqz;qoXD~vT8H^w7jxTJ^Hrf8%L_Nz|WaDW_bzwT5C=2WG*Y=Lnw
zCQ)|o+P_Q9`U|pkUomVooN)wVF%vnA{_=Kxi8{Frq@q;^rGuuN3$uMV*KdDPuHD%~
zjIez>-j|fb0^6X5V|eYO;W20ThH(!ga&X<Xs$OfVZJx5WU6>OJ#glssDRJ@ISo7aJ
zuI$cKMbb8#SfY>g_IYNegm1^6Re<NxuFSYm)b;iCZ+A>7z=oWUf`06>(qTm9Q%6|Y
zwF(HBn3mdkA5Qeh`76<{iUGo^T)J!ts8{j<Pnf2W5{xZsHZ}<rWyqgTzb@Lkb#`i_
zArib2#*t&kl&K{bJ0Z<h2O7LVZ{t&yNU(pROGMUsq1=}Y`K+$GzFX~Ws5MXAOb6hy
zQ3>g-TMrZStsLh>ToF1Kbe}iAK=kH~<gB(Y%Pv=i`F1`DW+krmR^n*9RCDMgtok%F
zh1Nu8A8d5p#Nstw^43G{qkRI2TpeJM?G&KQRBVK%2VG_PgRJvOkEK3{aKAc`kq7<b
zY5)0Hq_w&``1xI*9=oDuXvn0BFw1^mATqsrY6++(e0B>(ypjSuwLT$>MG~_es-n8;
zA9XqyZ)rkh*Iw^3v2=sjKpy+j(zh-1ZpkrHPFzp(^gAb6eE*NAbb%gafBD@RakOuu
z90j{~upaC6*9F`hInqBPR-4rA{5H1R#J_V{>8W3|W_BkzlL#g5kx@WaxxwO<T{@m)
zA}~rFl%Z6SQM_b7&FwJgdc;?QeR81;M1)yZ@lX@3Q8Ino3V+2<3T<ud+QWJQ5t)X<
zG8jkzBy$w`<2Y$fbOWXbfz7{+PW{VSmH4q1d@4gqpUs%W!4T`x3ofWKG;>LlbQyYH
z(uPt7(kOq0Z!J-XYTWv5>?-Q)$52}t)$#2BsSQ19ZtT>)F$k}HcFzORDDjm)yUAaf
z7#dnx(gJ5jMk6h>FfbsoZ<WoI_Vb0YEo0hAw6NCUX^$ryCfw4Wm3kBTd*ql5-;y>2
z<Z}jNy)|VS?Mmp&DR=sR<ew=;MtkD`DP(Lh8AuJkckkX|=Fy&~Xn%H9go5kzOvZpX
z4+E~#3_H9~@yL-?*)dV!p}ubFNIXVH!Bi?U7UiQ5|KO4~LPB6jF_j;>hgsacNLviZ
z)I5I{-5%)&IiOsirdv(Ej`mPw0}MK|>vY&xKb=LvFe+h#XySU=8~CKUNqOJyxyR-#
z-L$pD;A(G%NBo}pezl9PW{lIDAF_{$00I9gF@RFW0VE9H4lBU5>dhXn%k0-bN)~W2
zX#>=;(Cjgow4xw0-^jyd&OPZ2KvY5VwitKru@{j(e<F(fi9;taVt@MdX#&1cssMYW
z0d(10v8)R9ecGiim5d^LdwWvI1u^r751pL*QrPQ`xD}PDgb4s6v6_At;lS9+F^3&N
zeX9|qNbg47xErEAgDzqoAR{s^#$vl!fF@V`;2^NYk@MqZ2D*V=cp>Y1#=9@v^i-=#
zK{&6i;tDNPY*EfeBt4+MZH^ua)Ngx!_$E8Hg+E^px~kO`a?Br2(t%}K?L}M>xw3%P
z7ivAvzmTO~XhO!}I1lM<M`_AIo~Veha6)B;w2)@hieBojh}MegO)jnT;*Ikfa|6Rn
z*Gf6|`ax4JjGXJyHyfOdUFqB-j%W$Mr&AP7BxRDaG35ZBqq1#GGQEyAT$e_aVKc#X
z0mX_XPGh5^TSRlfa#-T7rw%_`H8?O&Zf>0*^{6;9N;nE&amYi1NVE^8em<ZL1gJ06
zDm2W%9Uh$M!?ErKQ1uH4j-7if)_NnYg|2*^1u9p?1TJ^tD_e)oaTOqla+5>oK|v$M
z0#ZD<f0OwLw*i)Nf*SFK`Xo&AMPs2l`=EK!gC}_9aiZLmwP)ShA5I^br%z!9-AqJE
zo}KqR30;^K`!rJvoE*(Q(kp|RXRn<s&La{VKfX~YSYBLcVu})&I{bi1DxyOM!fb3q
za#&b_E}%xPqm@VktKmS5wDKeP0|>1cCvd~Gqu--PF9F>!QsdCI8riak3NKqeF{^sD
zIZg%PMclimi6p8z+tKnq3>k4hjha8EqpU9?WD|&9nV|V6nqfrpr_kZXekTA0W&OYA
z)|K!sNb3So=Z-rxuQXquR!n(-hhquq2te8EDDD0b@6(2u)8Vjsd{1Ie4eV>A9xb_K
z_@JI&q_B`U)R8irF^J?}9p2P?BH@ZI_$y@?a0r;HN@g))x+JIs_&NK#p!*x1%a)AA
z#fJw2jJT#kYT$8aA2w_Y*|5Xo9k{=POw@1O#S@GrJ*eS<u!E=Gu%#3rG0&cz>`Sw1
zNIpDsHz)RzbAO}Rq9TUQ!a!7Axu)r7D4qk~O~j<3=Bh3;0mSBp2$ngM9a1D;ro9GL
zQ12ose}Q4<nl3Y<wxAEm^sva#qRW6TV1@hW&PHP_0%`mM3Ek=RR4q+WqW?GWHKCMJ
zN#wGBNFZw0!i9u=#xG9-dk>|BC77A8%N6|kixdTn=Lzlg{Z7!~JjNq>O8#*`8wo;B
z$Ku^l?1~I~&LMrdGm3f>DJ^5p_Y19j0L(p}M+ag%KVRAw7bdQ)%n#P~>`D~M7rfP{
zDV3b5t^7>cdejcu4i2e0V&60HRdonmli^id_3bdmpjp8;ll|TM_ZFzBf?+_6a~X~_
z0#6Lk`yuEjS0gDP_ff&_K?ul^CTS|hJ_tz%cR3j*xqBC6K`NXCRPrz(Nk~cr{43a<
zA^p0+$_+%MG$2p}-h;-%ee^ic8HpyXTmYmIZUQQ}d7h44MQ%k<tiN0IWE=*0QWWyK
zV986b$nw|M*Q-~E1ohPxczWVQD&e4LV$u(U41t`cgm>?b0R7e@c?{s8Rhu@MoYlvF
zhMB!30xyrGeK>qJZE72$HFo4-GY~6jSOHuKwczNKqO_&iQq<8uOSNs0MM8WW4@>xx
ziwD2w80~7*9^L*G+}viehK|s2maXfz#WB){{Vr*ppcP2_VFGyM7c46-pm4u)`}Ur}
zE#Ht3ZXF2%z8jv~Dy<9t7<z9gM)R^Q)?&$bJZbAcbB{1~H~$G}%~ICN8lMq%pIml|
z%?;?!uX`^7>6%Irb{w+<1frsn4jU?g#ksuT30Nj%9YrEbn#t8@5_yS0-+jSq9o9(K
z5(AKaYhgCAJ9<c=Ic_ruk%Yv?7$lO6l|$1$B{&Cr1=<q$KparQs}Sx;39Swvrf)Ng
zjk}`uD2PW`I|wKBA&i9ymyjmj{f!5;Nf#3=1Jpn0vH{{rwWlkA1kj7I>4$uyKN>WU
zZ|~kegOWpt0_mpNRjI**#6%$gnoA}R8ykH=2FoFH#Tem&K}GVgf;Yz(94zi$dp-(I
ziyBZ!<qZ`!8GRsSXyGGXQ`7oM++~q3#^Tk<=CTqu__GhIH+yIf<~LId_R7G;ssH-)
zO_(Wf2#*1Ev&MUlVp{qJF&1%5Kk3v}?Ks^q;6U9-8e)(UAruj!5_+x!>JAPLQOcN=
trmy`M?(yG}n^>B=TmL~+{@?h=NoJ|Xr-a-SvaEqqilWMqgu|z<{Wr^|WY+)y

diff --git a/reference/as.mic.html b/reference/as.mic.html
index 071651c3a..6a0d73ed1 100644
--- a/reference/as.mic.html
+++ b/reference/as.mic.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -199,7 +199,6 @@
 <span class="r-plt img"><img src="as.mic-1.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="as.mic-2.png" alt="" width="700" height="433"></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in if (any(cols_sub$cols == colours_SIR[3] &amp; cols_sub$count &gt; 0)) {    legend_txt &lt;- c(legend_txt, paste("(I)", plot_name_of_I(cols_sub$guideline)))    legend_col &lt;- c(legend_col, colours_SIR[3])}:</span> missing value where TRUE/FALSE needed</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="fu"><a href="https://ggplot2.tidyverse.org/reference/autoplot.html" class="external-link">autoplot</a></span><span class="op">(</span><span class="va">mic_data</span>, mo <span class="op">=</span> <span class="st">"E. coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
diff --git a/reference/as.mo.html b/reference/as.mo.html
index 76da5e3d5..8362a2303 100644
--- a/reference/as.mo.html
+++ b/reference/as.mo.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/as.sir-2.png b/reference/as.sir-2.png
index 8f53a46a95daab5250d5f2a0164480169d5fdcbd..f19e569514d5363e43c8e807541217363f3d4cf6 100644
GIT binary patch
literal 33200
zcmeFad039?_dc9?V;dqusx3pt+K~oLh6qhE6pa)@lhUMlvk^@Q(M*y^A<dJaBvjI@
zQAP7S&+obJC&TCS`yTJ`-}@f#&vEQy*W-Ea=en<ZU2C1|T<2OY?@^MQF>TQ_Ha4~y
zyLQU%Wn-IU&BiuC_m9bVrR3J#HvDh0uDqNq{*OQX+Y%h{zp1Bp9y-Iu#(jzY8|U$@
z{TLhDUu?T%x9qp}Z7Mr^<3|1+nYNIG`pLzqlm2~p_@LIO!1G)?Q`viWraoln7E+n2
zqP)P>`>$(tv9fx)i_fp%U*sCJ&~>td${vpGt}7cV7mYjSxqV5|Un^HS3m@nnT<W>#
zs_~<{kK!Lyc8aH0+gI3D3`%bfSez|7t9PAz@ZL~nZGkm6IOCb0*rGk0IO(TA*{Rm!
z=!e}m{`U+2Ki?0hdu?tec1s^UdKBGPd*4%OwfV^z4g50wyPl-XI&k2?1%VlCPJDR}
zKTTp|+bo;<){QIZ!Gq&2gHdHA*Ot$@?AKEGC)>-O+*i}t*z!Ke@!Id#w`#w?%X69*
z58F$nT~h?v*!GxMSa62y4V@f5k<IB3?nJUXw&n6K@d^Cpy~R1Wu!?m<Xvj3J@oa22
z7LUVcN|s;Snc7vKtJhJJ(f)o-L~3c=8NK4?$FA*McJJ7STh9u$ZMWBE`2}gj80RF}
z_KH<HO}KZaHY?}(u@C3+1_v4=(jA8j9n&^sOU`wfzwU}<^Ov-TDnV5*a+N*|ChQB{
zuizuHj>o3%u60KSKV3H`Tq~ijFha+!H=)8U$bHl5_wV07|Kgbc=zx$_OX+PXTg#8W
z;v0@<`*X|RT6=kx%+TM`{WYE^@*b)*B@ebROQ^ZJttxe{vTKls^d@f+Bkwml_3noR
z*)|KUk?&uG8!M^%dWqLvUNA{mdZe$~$e|~$*54)Be$d!-l&hj|hvaZqu12X$OKi37
z=li=XTD<DxvZV*tPX2SjY)^jWa@|a$n6mk5I`-Ys!{eiKF7Y}n7#`?$ITU$3Kkk8Y
zfV9w&*Z&q-6l&@9wS8^x3>Zx;u&@{o8MN;$<K)z_Yq!j|YK|&=>&(7X*GtPX)WV@O
z)>P<p<x6Mhohv-Csi(Bmw6%HW&6^jMmDHIfkrQ{Oc5)~u+hP6cKegG|qBAl@D;C%K
z+qPI<NYIEht$zD3G&Hn3pxM5qGh4>v%`BP3g3~ceKHk~DzsaKEMgD0~zN!nH+RiOy
z3F!^_kGUQ`A3c++D7xKCKub663ciEiGo!0jU+Zg&SD}4>fM(B)qmSszmR3$;3oNHy
z#`870`{AKicVl6Cv3>w|q<(hz8O8N?K9&p?h8>zKx7buROd}>-yU}ayp*i*gU6&gg
z8WQvOdj-pT?Ff*z?-&@oCLgSd-Ipdu_b^7HH8HYa@cfin?iZ$WzP&hui|>xYTiCMR
zxA!;OV^W6Kwcs&|b$!~#75mxQOUFUn-@5AZlkkk%lgHGw&mIfIKKuCJ5z^aH>Nq-F
zGMpvVTe`tGx&QlZX?vTsI?0m5wb(@6Oz(|C77ck~9q*PJ*jr}#ino8-Hp{3t!Rn&T
zIJPU-;A)+0eEvT2dVcShC<D%v!LnA}l;Iv1*xJf9Yh12exl)AZReg2a%*!7H64sVm
zSG)BMR*dq*lv!#B8<)nuYUJ5ueqycqi<KhAr3)_0@~J*ipXb>BK}R>hz9-|u;4J~I
zMJc1ht&P4iogX*oeSLj_7FGS$O-Mh>R}4lMGiY!0<;CS)o-4LnSXj6&5aOFDGt_pX
zEZ$-uJ18+xQvJmVcG^rYZJSjC-HmFE(uF#X!<L0lmljTE+w;-xC|rTfuHd~Y+R4Wp
zH^&&4Mce$j)!xspBO}T|p*gnN-DTCj2Zo(zM!RZdM#Zx>HHL*Xmdv**HI*A`yCf54
z(c*h1>$1#ny|Rj`YIO1N(e(@Y{jGH+2b&@-T6`Xlnmg9|Sycs|pZUn51vcfH)br(W
zK^&g!iIQleCucllMy!1;znl~gZT%1(qs`{z_s>iiXG3sU*jn;lu`;;L1shN8x9cg^
zpY-rlBQ0R^EUTq_4mj2M;=PSJqc$$E&3m|2hryDH?~!3Il>9d3i;J3+CvK`;y?S-D
zfq+Jdh9KL^tj%ywo0Ga>!3BfcF3ohCzfN5?M9Ht}+;jnFiI&)<{tg562jk68Zjt$S
zqgl<n$&R%$9-0p`Urpgn%s0*z(27sxv2D5*@%i)WHESAuHDXU6DX&O*vik{^eUar%
z_iPe~tGRC75?9;ctMl~mmbC|;{x#B<F7u!jUN;TLXF<j2NN@GiH!}^K*XPcZY<oG`
zUPm_d(SgSezKta@CU0v!u#g23mQ9vP60qhHlN4^jq^`Z>+RANPlMdoLVYe&hTuwdS
z*wBHM85SnQ$c5(PQMyiq7tSjYul1cvPgrC)s&59DNNQ4VIahDFt;u3MGIA&<3c?QY
zJRZ6<lY5hF(2g0S0SOusk8~^Sdo%m&><jD;t-s@nFA}{ti<c(=Mj#@S5}GYDD*3p!
zF(|KL65Gn-?k9jX$`@@s#gQAL9MSpkq5^zKT;F%mlsl0g7mPBc2b(;5t!lOz)pi==
zbh~cI5?h)K3)bhpCGzjy$DC||MRb0PRy<LUx&l8Yq;21wzd+LZwD8H#M}7Pq@u2nI
zx-LBXsAV*-XG`qGPl;zcH`R`e^rq<BIcRt+jvZ`C(0l#w)RHcRB{$WR*x1sP@LXS7
z))z<Wm!8R%dS+Y}-`DnLR&^Suj%!YkT>8@^Z*)h8dn+0u$=W6yC~mXF?QW`lpm67U
zdw*?!V{&=x?iHTxLA=8cv-&kmk~YFHI5uwFcuir&(wn=tufBQ3jZ3s(kUMVwsqXP?
zH^%F?jc2=h^ZE1VMFtT`x)Dh|yLrn_r*m7SUYWP1>S2)kl}Xd*8@7MMmGVCw6S=*^
zZ4t#ay^*1QjgLvgJtgfqa=dBSv_p-N)90^s{`SGEa8OI$OTZ1Dv2c@BiBU{izM76!
zqo!8&(IDw`V~%~eONnU|Wox!K7CfmAkr_Vu<cx&PVbP=Su5PMrm?nhqH&i)ArszR$
zm}cDbthl*KVt2FRPUb!^%C#K{#Zt54(p)(8?UL^{PGT!s_y^-abw&pY+dpo|mQ_?#
zOe!cWNL$376J=1SdFz0A@^G_Bp|};cEj@6{`KngOQQLt(&fya23-x{3=khC+KIk=U
zPON}e2`v~5a2PnLdHU6)k}iM8Q?M_;GvwaZYA1?a&p7I5uqd86*o>>R?JcvarjU9(
z(>v|zl5JHP`~j}L6^=3m;aWZ;YX(C1uT~8^$WDH=>Vc2(Ba47176vVU^psguED%1i
z$FFmibl>477_|yw+qZAuo>e#uruDT~$Mj1zm&AB<bbJ~0bSQdyq`j}&BOT9{hn*dv
za=U`Rq<Fk#bG%~uX2VA+K|6Au>7}dJ&KJ;JFxVWUvw#17oCUXgj~=at)2ZtCASif{
zwtNBuTf!bZSb-DmFV>y6F9?1k2L`!PP|yRrO8*lv`jXlU7p)#(1eey;SQzoo8e?m#
z^0T$7650m2Pc&lsVjKr!Y$75aJ-Tvt+ogg{YWw!h4GD0t5jOfFj5u)*zT5QmRQ^-~
z084kc7Cnd;vB+5NbyU+6$OvCP{OrZng6V8egXY5UJ{_hd2775Ev|QQhb=``N5#rf$
zyxb6#tmq>mgm_SdGaOSd6;o;^-xQfG-K{MHU=TYp&=^zC?Gr!L@gc@$zR8LiT5yZ*
zbbL0S7i)fztJ_|c)}9~X5cMfo_%;RlbCagu102)PvU<1VQYt);u7^}l(RV8x)n&&&
z-exBY+7O;pb!ANze9_0%hfRRH61zUj6KHF;VOd+w#?|IXOm4U*w8XD*=<p0kZ7Pn`
z>uD+$!Z|-kUJ`~v58a?J+)b8`J)t$(*1Z1n@_4IO9>PO<9#SGbUkoC)dg;u@ZCNG4
z0kjWwW~XnPCB*?#bOm_ao?zKr_3vCIXJ8i@clgjv*$<w0AeN@#1>T615u2fQ4@X!1
z0DBQU7{3#MN{dgw9A`REA3_HH`RhP|^uMaSQno#=IF9KsD7~hlXYJp8Oy1tx?$R*a
zo^&xBXhu%;)<A9H-vn~mR<0sXNI$5IN62DhbDFapSm!@p$Y(+9yEks${AMUvAuyRO
zaJD%fBL3W1NyY`3e0k1~7s#(X%{4O?U}FnbB9#3ffBV0@{eQpk|LzSswZCrsN(Ymq
zZdJ*?%JT>&k>v)>U!tC!$ho&b%Er72b}s%<!12-J$9l*)o*|#v>NWn;Ujx0Zya*<m
zcR%3v4s+c=%D?}vOJJ;@O+#pVji>T=^Xyi;T8Z{cGDAy3Y`=eT6D?mr_-ne><jv>n
zi=OEvBHUjPm;i$`3Ow)Sdg|0Ev*cPpzcb1D;qXQRe0-J?O$Ip)24&MVXKWr>R$$N5
zDl;_tc{E`P46c55+jSLb@5B%9-<u`tCpXz_jwu@K@}#Sm8}{{iT91AmRjXT%wH3{j
ze!gQzFvnZ6=a*TsFXgw04J^dZY|r^Cmj~IIw>3;7X2q##s&&T0M9E&66|95u&fm$)
zwS%2y_Qjs1*RB!f!$DFSuf4uwi}25%-^;yRBmDCcE3fUWu~TMQ{ZZwY@;hE1{PE6d
zTTlE+KNrt!yMFEO`SjxzPkafX+p(X|0gkURpGv>(>6n<v@h^)cp`|W8vX)-v;2$SA
z=_}<%Y;3G0=Dd2mW&!=m+)zhH>F8~WoZx?Ku~Mv#Nq3Jbo5}59`2we^W&d%xg~+CT
zTkq@+HcRHG>ogfoOgwr+Va0UHim{OC;{+Fe3o21%9d_oXSX)F}G41uG5_%W&WuGY-
z2iDoe`p!M~=oXeP`uX?o<rXwL(^k>afAT>YD|xvS$CgG<VdsJ$SCQX=#8A8<GO^Ty
zhdy;w{{4=h8+u)WULt?CJm~29Lv?eQU)BGx&S0KF_Wsp3JEdqJD80jz{`Xn@xu4te
z+344I^#5Va*wJq{@A0>)8sk9eZnxAi9+R<<mAqxqn||%?ugfr(qZ>YY!(*nl)+<`f
zRVnP;R6Y9AKru3}d-wQiZKt{YT!on|4gl+!{(K+Bp*-X6hI|z*Ep7mfFVRL^h)D*o
zPVHLZImuR(KCnlWJ8}E6o4eCuO{?$i3sK4eHm@sqqS2HxIzm4eAy?F^O1(TObPew~
zlhrrh_xsbwo<_2_eJ=)@W#<pDGxG&-Za>dE6qsd!jE>TMeLo9TBm;+C`o+(DPdypp
zH=k46`p9{!yzkZaKliR&(zgGbmma7Bp_8BQ*Oe#P`Zb2fefPF*dX_GdU{(3gl($=^
zaK9){n!;oKm%~VBKy7eAd`(bEL0mGe0efQNZ)6kp`dK=UMx!^<=C^_l?Jiy2$Go)W
zQ*1@Tn}&Q|54oX`VbRmBA)*eDEcdS&kY5}^mmvG{(FfkQvnd6Qp<Xytuk5(nLs@3H
zi(q#U0A;;xLeq2kQqy#9Qy}$_RyS@5ky-f#0(g2`_2?3?Khf;(S$;k|t<OIQM1`LP
z3-q~K!#FNDD~ZzUu0Fuu%q<ods(;$6Xf~YG=j!-))e5`L%&u5qVT+c0K(wyDs6y=z
zcyG{o#-?!&Gb54S1*cp1`6M_D4|K&6woO8s_qiJAUTjK!zQ@n=FPg0+_VwQ`Yiwv#
zxcER_P;NCcqP)1m2W2neh;iNSYB5&CRvKR}$@TZ)%{F#v^VCuS6Qa|+rwb<jE#<$_
zK-JGS6D)|7bbIRDGy9Jm`QwL`l}k3}KURBTQX$R9CymQfI$oWtEK_Ef3HqVA2$$ij
z;$3puNRIFR-q6^FM~^=j;x$X2$K{%5<9O%NZmryLJwXzl$z|%?755`TlmmFMG8a%A
z8;Fc@?n{qLK!TzE!l*>#fs)^%THiBD`_<G!0uDXX-R|o+(qF%n2ah3Oa&u*-+{?#5
zcgcwD(qgln$S)_<Hv-bXr5p&D+-1T{vA-O;f_T$F=T!kyxdDG7-87`@TNWSlqU`X+
z$=nshqdE7<EszA3oZS4VtgG5Mj&JO&(lL^7nJy6f7k#r>wd)2VN$Ll|=eQ#WD;)TU
zU?ZAPj$5t58x(o_=|<U_O3m9u0;}C61a1lH@T3gnM-Z5N*n5Us!qOGb`t9or(}Q59
zXTzRaM)^%;{5gmJ%<{<vIEt}=n7Rb(kp-tAv6|PKJZSteKt@J-bf}Zi+zW$3flZc8
z3$)_RF9R0}Q;K)4z<1{|v*eIZKYaMQtFV?j(2nLUrE#Bv$rGPR4jBsswa$~_(ig1x
z>5*1B<K0`mn8h#u-C2pBkJ)Kh8Y_gre8bC2Zu|D_cRv)n{xrK7HVWwtd7(n4RjJm)
z-Gzj8Rrc-k^fv+b*ws|L0sF%_Ve+5OpcKSDGuJOV=M*z86ZaFI*ztaWjKh#>p*?6!
zp|c$|w<XV-{mCmW8E?@zKS<8Q9d1E%PcVII^QzO6O(q~SvAu^Av+zyX7h>z&#lPRC
zREbtNE8obk<p{kO0i}F$TV0UHTO?hd3#V|K@6ohvjuHaTQHLa1Ru(x>Dt-!zkKd&2
zINVLgz53l!k5a>cDZF-nC--NXY?{lQLFYflnUoWbAS$M-d#Q)yoDKR}u3RRGLdLOQ
zFIsnIijso_O;uIpBIpkGDD}uC?)ji758>X{5d0AXm6e;V>?<aO+&Dil<suVWYxI<9
zrA5U%i#rTI-WI|Y`1q>QWkyVW?R$zf!o<Jb*jEKa?(XdT&x9#&v8=29ji2srbLA2h
zFpjT((3P|%JeCi>+N<{c=ua<DBaqGGIMm+NhpaB*Oc_W4U!GBr6~(#^sm|;<5jrUh
zUn&GHZn0{d1tOMTBNK6eCB7HC2qxd=as0MMC-jV#kBHIdYUC`2LOQCd^C`6&7zhpV
zf3I@k&aX(+X^8V%-(Ilki0BNJ3Iq%FLi5&gDJlQ;$9B(r^q7~|g5nb4gv>~HZixr!
zJ{Oa8qREq4<9t50Q1o1(__=!C8r7P>_<{b~g|Fk5{X{^WO&}L`dx%PffBm3+_S?;_
zK0MEGi_8aiPkgww?#v#o;boo~zOAc%T5zXf<;#ES+wsJ8;qx`Z`td-jP*2hx7ywi9
z#3Djb!U_3wCF{oZCNVTV6Gpn5OGLlKnDDZXifP0k10>+N1N<WKqW)*U-=X02(MME}
zj}K|5?n|d}Q7uu2U!CjfL$Tq#WBb{fH%9a<uO{udAaGc&5IntgSB@MJUoOth%jIvS
zV&l|n2V{o6&Z2Z$y>^Ad?W;TiX75+UtutT4N|833&S?{IqQm?^(PuuzRXe0>7U96n
zgH?&0S&so|v;Es)q_VQ9g~>fpzJ(0DyD@*9$%J}%=CvBpYr!PV1+{-V5jpQOklc0f
zP+hGRG6L~+_dt?%tM;z!)?+}cQz^bKkZ6g@SLgNGDqmd?IObDRov2A^84g>I-BGu5
zrzbOM8L-PQRI*>&e~@>s90OZ7_xQdlc`0I8H2bmYlPljdedId7XBucl8Wuk%H=8)n
z@EB%&PtJpfGJaVP9;rpKUmRz%zJc!d>Ve0qX~^yuc}RBb9MF!?PSV9u$N_KAm83J$
z;bq#LuV&KIbX!OdXTy1^yE75L_^w3{>PBylRRZ7n*MyG?JNS%`7>`4-T<q<i<psAF
zhHL57e-376Z+|&qmLYqK@u`8X`W&Jsx^k5})my#(1BjNe5o}qb7OtQZb0UYY>_Wnk
zHy6cP6FbS0Ou<gvFC?y6+xqJTqC0i#KHaS!{NN>6(G<S~!R~qy6WuID5Lb!v(fjh^
zWPKx;VLsIeZEjx2Ayb6_X({lijGwgYYeVtjva_>jx%E=Q2x8xF>)kV{NHzs|{5CIi
zU#=~2^v_Uem^`>~*__LhZ5daz$B`}%bo9A8V5o-Q6iDNN2fx@*+Z)QL*xBnHQCrD3
zt-E{4_!;Uc_9BgK_TTU5cO2?D4q_^+H;)CXnUh|V;h9^#<@{tLp^6m8(adnc<i4s+
zz41-YKYXsHb^jN#fSugri7}~gaOnpDWN2B2C$y=z0W|;{$ur+SF5a&u_8S}m5pk18
z)VS2zr5~(KX1IYyr!trtMGx?TKIa=6<bL9EAN_S2(Fz`o({=+C<W@WSXKVN{MAK+G
zZ!u~dX8VsE*Lcj>`O3w>d(ANw4)yH-p4alV0cnR{MQT}<ZG4;*-3<Z@R@;6OS*WGC
zlueg2>M!e9K&8m4!anBUnbxG<9emf`#j1h-vndVT7g9R!4nx1Q!iA&+Fikb6Eqhs6
z1eTBjr{34o1;YxpAFD+udCU^8xmwC`a25-)6A15Yf<5l^040>NBgJ7j+BV{B=l9_B
z^u=csR4t6A6MeZkR3pj80(?*Gr(<lw&hXW8Aa15<O`ahO+zHEa;gPbzX~x$@erc=^
z2~hH|?QQYP*Dm4X9T!1y{KQHSY#xAsY42~YnXWZ$^LgUnKzK{}?RusMmwo8iv15t-
z-+jc34ZvP{5a-0lx5=u-*Hfx7h?ONE$#A;({8av<gK=iZ_TRX<J?2&dNBm-^L>tFu
z&i3NBvXnuOFZcV`Ddt~aaNCp4Mi53QVs9#rU9T<H{%Nb%xT|WM$?W=fV}57>ge7=%
z8cfzUDZHPqMH`RWpd3=v(EX1-EoXj>qP!Zr-S7X?E+`3pJMCA>0}}dz0A(<24=*5j
z{pAI(s~kFX=&n3-ol{GYVU|VH&wG3+2@F3>KU2bb?$f+qS+KDNz09Q4EP{#LDKh)<
z+INNMZ<u8B+qbw;Ayy*3xd#c>GFIsL?<^J+#IFObz5c(}Ip?zM??>tSHC9^6<Ym7S
z&Y%90zMO6OZX|zT#pcCNq+eH_rF8da8Y8%{KALbjg-I4Z2gL?(HYMWM&APt-aAs8R
z2PS2ufcJje>)%(g^5*WFsXz0y>niK-tYt9)o7eqz(^SG~o5dw+?7DyTJW$KqdsQOs
zCMN!TT>p=7UEfM3s63s7SmZ6^=%9&sE#xrN_auA}p;Q+oaKd&Ar0uND8w=L$@ZjM_
z$=f(^w`lEohE?3-i$JoOXy>}m!SZiU$B4kIT-I|JUom;cA`UF_<2DQ0xy`F6NTNnB
zeDTkP*OR5|0?#wJ{@PMGTvUpW?;dQPE}x&D-%d4j5b4}<JZEc;4-zZYo@wH+Pi`Gu
zX*T=#@<fDsEnka*L-mb#&$8oLz6;@!^-52_nZa<Osh8(2MG+q$YVp1Y3YXu^lvpc(
zbkO?SO*P$|d)rOnTpt7kh?(lTF538Li{p%}(I1a7GZM&2mhYOgvor5#UpnQECeOa#
z*r#;a$0S*tk8kqK#S3`t+P2t)gJCBy7F++o=W}m3fd4_P$$w3@;7_~t(WgR=jUAHZ
z!nhV-8YK_MPM-=xAsO9NXR7$i$^r;25H;4E`M5M5?1cLrx<O(YI-9U|1&@@Dn-O_&
z;c&tA?FgmOw*`@bAw^woKb*Hu`P;+SuRr}38sOA(t2;X49TP-nNdB*wF5pRiQW6#4
z#!_&LrXnG!a^a@o=cwm|q$e~-YdkUV7Cw2MCjv1UaYPvzLsl=x7_69>c-AscMJ_nq
zho`XZSVUsSZW}vbrNa2*xn~SCq7CmLKBO;XE>8#ktO%I=F6(z!mr$W=U4dPD8fSY_
ztG%GTJ*=f5zVHF}OF-k(GanmT|D;opsiL~bWU3>k(Z;CqGIbY}VGkzTos|R}C%MCI
zQ4?(>0;p6vjhk?)%;43zN%if!`2B8-R*kALuItAI-KJ^1bPq=zrJXVgg7@s~B%;`-
zEESd2?b!E*_a1zIRF>lHzn4f!1Gk%L)T#a#IOTeI_Y%*d+y{y-p32hV(vV7QDui*`
zn}VRv2Q#IgZC!Is4k*V!XHY$>G0f#xg7r^VL;jju>on%0fN&XA6ESUv{%=LGrg}_r
z1^$#%%UtD!ahc6yTj82#fBL|4FtClF?F1@N{mCOKHhC70X5HRtN@HwPwp;-{K~hh7
zxgslOgeyNNI?x1T)|b67anh~b!MZ3+(EjgSHb+H8g&l_EwnEXHL-7ywwal?(^O@Tw
z@)UlAl6OgD@?_H1s5Lce+P1x#l72_ue_@EP+3v*-eP2<@x_!}r#cP6tgunRv$W~2c
z<Ij#}T(@}=0EGe|;L?$5nUST8#$cp7qFSS3;MU7|v|#5y^xH(7@l_SWEmlE}qazj<
z6V|D}a0V=qg-+&_pH8&lA<CdkVIMmnx6qH%cqdo;^eRIhf>AMIL($23ur)=-zAW0P
zBo-A)z3(6Iv?F)lj{5CJg92F~e=0izG*KO1$e<vsFMD(-`vfrMKrwlW@c4#Dlb@vQ
zk=sT~V$<M{`w&S4)RUNU@8o3Eo%AxUFK>UtJM#C;O?81_8H(qZg&|Vs;Id+1DXJ?*
zhbx%(L<S76m2#wNYE_yGS5sjii_^HWPw9FBR4jrJ#*|meO}TLnS!+l->W?Qit;#I$
z5S}U8A{$TNSg1KyP1AJyKskzpK9P$ko;rQL;pt?Bf{rOHY6lR9E)nhk0Gfsg+it^M
z+1Nozb3CdLAKurP+<(iXQu^lZZ+2t(XiZmZxgZjsi!-?w0d30pn!a7wj&!oMODhSf
zuYw2aem?oyfYRX>6?XE==7?A9W90|MA9lTzfDmDUxY<#v_Sv_Bn{&}lve}MgvMNiW
z)%E5YweM92mWQD9D3v9$vP^ib3Fs<STchb?q;v?*JohGZXD;K|C4`+JATmUeQBW$z
z?A!YVB8CT>5F^@2?WGM@;P>b;BZ;t)#4`%(u>thXt(LYQI2xsPcj_2#B`$UEE*;&7
z(SZmm|E6|)`%tZxGH`&dRNqfv7n#9a03ZEQhrwn--I~eCE4z_3NhR0abJ2ZsaYjj$
zGC-rIdCvBz79W!zM7;P6Ytel06vWot1CfAd#WP{bOoeRwq4sps`~zytZ6p4<qcSTk
zSerQiJUvo--`5BN3t>k`Kl)4A`t;nEurj72PM>FIzj^bf>8nYcHHiiBEcQK6?Ay9Z
z#gxEANs_uO*l=8djI#v{Z5_%VHV)Xp96)nMcmvVOS-ZZkm-+=lw`@e!(jU}pS2r<8
zQx>1zYz|kw!+r6>xhoW$p~KpUgpHH5W&NGC>8S0`r#Lgz6(ZvXrbd>$Cg@1{R+3R<
zW=Sw?yQPxbqK;#9-iR)w*gQ+JZ8PdK6}z&ZU{$1}cyno%2lD0gY=@r6I*2BKdo~`u
ze3sS-MH2r#oY{J%ZzN(;6fJw9I7ns;t;}M6Kl8oP?+y1zybf4Hr;0<pT*6xP0GOnf
zqB7yq;pd=Z(_m0s<nPyN#y<Tz?PCyJ@J1@8E|qh4MQ(0n6aD=8dRhelfN8-Y{coXL
z=~{t#!aJw5qP|-NA;M)8O!ZtmTp^8-2nS*o>nYMBxq>MiRyxVe*x4hGXI>!%48CeM
z7!CvHy`86sP$aXY9fVNNjl>+ti{>G((6)n@dj?wL1Re&J>vP}@h&!*ot>=CjVhl&0
zZC^Ft%f&o7W6$F3&rY|N0hb5v%dQk6De^Iy-=Vo%gy&*G{<;U$U)S)2S(1MfoGH|@
z((;8~r@g1dL=Lc`F+4$l(30KFFO^6utD!i$a(?Efho6G;<bipAWanl!vfH5NK++@u
z|GzlXN7Mt75v$14F=`Ro?TGzp(6&_rCsnL1E!#iX)2uht*IwV4GW1O_Zmp*grTU(d
zW3fKT*SyUEBwahiCh2%`9EgC$hT&ArhpDIaCif;$qSctBkL%=Cdq@wg<UID=?`Po)
zzM%xn1~T8`rt)iYJPYZb=xAg8F=v&z{nNIw!WKt}um3BJ0|(}*X;~cjbK&}<kuyu1
zqn7eyg4MlvFzVC+VUu!6Zv^i~Z<NB*a0aTOAE8n@rG1csEV1dT%XyhUa(>o5+U(7y
z?{~el#i2+?0f6+4rQrx=<kiGW9)BVM8o5<TDBkLAlWe-L5ORZF=yR_FbZKvK=_J(e
z5qX`F?}_nI+=B+;)a`qtYKSgB^BZk2jxf+~x<1?mB#d#IFw+^{&e(F4#0$`7zJ>Ma
z!dBc-&N%FH+G-z;h6fgsHq_r4wB2QXzktL#URGGVDy5TsiVc)$(b`fY0L}R6R&YXu
z6w=^ss;<im?21?@q$``)_Ii3dsI4^6g1Nn3aN5Nd+up&-SOvy++De<O=U$dAg{YF9
zoys|}_&{Sf$c0|Vbbx3Mc6JB_&kCQqk-PLCm)BsL5)NJJoU1I!PQe=IHtlgl@*+Sb
zcVx?N+rGZZ<$YvZ?Iv0UO`xJoE)KL<V_0MriPB_ciLx+-n1>`gTs@qg+s3M&w1^6r
zI63b>xkT39T6<`3Yb`kA-0WdQRb_$Qt2TidKWH=L88Ea=Nvb=Kl!VTXzFLx}@*X-n
zccnxm4>V-HE^}<i4aq*vot!P%sUZEKTtWJEk>dzc&0{MO<R91i@6@@UtM@612bX92
znSb6@-ws*B8I|2RcfcsyNS^o<xbFL4Z)-|%H!!hgtu`^VHbXE6q8?4h>Sq*w9ETfq
za;vlaBnk)PA{@FO*SEV5+>J&xDL5UPn+jbLo%m>3fda}(0_Eh*lMP+%lzb+W4PJ|d
z_==zTTn*2VKNzQFS-f1z0kn=87IFx-YXkDWdfoRmt5=I8gd1hbY($up@<#xe`Do4J
zpT~9%bJ9j*j+`BiDHX0E7J;^j#g%Nj6$l?ERj%H4NLBUL$Z*-yBir0pe_YFZB<x3p
zRD7znsMPUF(77l$K-yK`{$NX;`%x%0<vn7)^*#^*cLH=HE87&`7=EakNjh&N<KAHu
z<~EWD;Wjccr@y}L>H`J)e*3EJA)xT;+esVU=uLV#@=0Ll%Nw+PCRh1wvUsofPxn=n
zD}TEK|I@Fh*0)nh&PK)xo;4&Lp;nh}!{=g!kN<(hPzoVLOvWP0M#mRENI$sP?A?;M
zRZn?XE@zLg88)I(qhhxQa-~;<T;A$K#x|$7^o;U=4anZOmBDq3O;g$H+ew-e*7N0s
z!~i^Q#;FLS_HVOZF^?o|2_8vHLMsnKgn~{0)R(528w*pxr^Fmg04O4vP&MRJ$`uLV
z>w}<bqN`Gx3OB;Ilsg;r0hUnd^5f}6$SC>TV5A}KtETfaJur*Pd3S9oQ^|z()Y&<<
zyFjD5K*Pk1MB7Bw5@~}HnaMK<eKP$Ay&U_!V!z$eFgvg#Cp0X~RkXrx1HWxEBDyJ@
z;&xeC@MLG6Ggah0@n-YeR8>{qVzXwGpDKlq1@(AqoeP{_{=i2oXvg}RO&qy^8{$^$
zU9v=2m|v3wCg!hJ=D9`-ggEvl18~tZ1EZ<*C-){{?~Mj1`4RgI*HMi;#0>=y!9}9R
zz8~hiJCDS*Q|iK73Y=Gyd@b6H8_1hcm97Ou^uYv6BSIj2eCmMO26ghL@+&-l!+`QH
z6GCz2sTT5@(ytGW2^a)J<b<E<q2QzeoBgk9`j34CDYA7;8XzdB-zES)n-B_RS|k-5
zjB^o)U&;IJ>hdv)+VuU&mlDU`-&nBz=uQ;J925LG+vfBCAdAc_W#5qXF{)vSQf4m>
zm(<)p4>f!osUKI`mmwa-LTeQSVjXUFI(Oi50bWN3hZS_^f7#*`fqQT1>I3KQ3J<sg
zs#byM2Y>uAR*3&r<9rd}FE|~rGvKt<lzl2Hzwg_`L>Erv>cHRLF6&nDefuUZ@km_p
zCsH=+y%}M*Tq;X0hI!Cz8i-OQ;9|S_pkVuuc8lZM(e-yar66_8>Lu35$xjg>h6G<y
z{+ldL2}Iv_t|7HK{yg{cbc&(kfM2T}KOY~7a*0I{hz{O~x6E5aHJHskW<A|u70}}n
zZSj`GcbB*=4^pb7rm^pEznIc1R!aDnt()1i45p%s6f;aKL4=PF`O#deur@`P7~{Cf
z$pRlWL}kO3nW@Ya|DLExt5~Uo4IAz7N`b&KbAGQ3%EPyXPwo}ael>H)m|o>WG5d_B
z*bY<Qb3Z**eI-(1<ulJ_NU*c|DqwLF6QMxON)zE&^+T#6Cw%o<H3xkQ@ocO97)wtD
z`Q?P|ieZ>@9ib1XhPu^b;fCX>EFmNm<%euCkyhy;cq0DAozeeChkcD;?<nmDx*A|U
z3CJpl=C1<zniXpa+TL`ezgA8*6|til>&ia1s%8(1zo;AA#RBg*yZ#Q8RXdM=HAX3-
zLDMlyyq2`m?Ck6^eXnNOy?g9D?AX&H^}Zp#oOje9d(z~%Kg_0X*gk_p#aO%TdaRhN
zw@sz_a}MFAnqc?)mV6r{bKe)d4_XoU^;q1@)oa(a&GBBjjAP5a9f7(JUHP=9<plks
zIc3Vl;?BW00Ra)I$0qmcXP4VrOBU#M4>S#rB=#B{p8vr=@%wPb&w6fYFnBUy;Z($I
z(m$}Xn|?VNl13Xv$_V89e&w)McA5SRWxlGQ>P3(M-`KIH=ASXrVc+U;t*B3XI$6TW
z3W16vEX$SDiXBmIpaj@W_1%QreA>o6zI$;@0D12xH%FIv+Z}KGX9~~lJY}iw{fnMl
zozmUi9oo8zRnwzIWufRBI%VeK*fQIM!S)ek?aR91+OFcuw}|*C+K&mIY6NaN^&*?z
z-2hOp93^LDWJFi%|Kms1E@A)pa(LI}-Tp&jqu@ra$0I_We6jU%Tcrps>zx*E;WEGf
z?K~js;*kmOEr;1j7r8e8(170eH;eI#lV4s5$g$7U20V#kGG(K?sA%#aXSWN4tDZxr
z1b(D@p%W8HkFeJR5)iDrYgGC$=iEf{#6+bXiWHrgNJ+=n3!FPZ6fE`3kR2TvCUEUx
z(O9tYEV1~c+l-c&&)8p)1hxaWu+d?tnim#F$PV<9J6I~ea4-`Z1gNNBTN4Gbge-yT
z6Tv6S%ySiUpqq$A8C)0I9(Hz$DY4(Z4M@3aiW&fC>^9nfz`Xl&+IGlN)jLBxo_HDb
zBJoRi-pNjdQ}x`4GvR{0rDlVUzoVCIyO;``>aEJP{UjX%Ao}Kx;rRG?`g_tkU&}o1
z^DOc~`{psZTIi%iD5``UM}}fiGrC?_j>R??eDsqLoocz1kIIll;C6I$y!f(m6KK85
zz#?LC(r9whg*@PyO?Lw!`BGpBYSeLdrn0~5V)5rIw`nu0@4G)AtKW~n2ND*Lv)tJr
zJZ=TG=DhI+xx-K2K)VfKAqQf`dmV=#q(;kT$pU?9Kr)h!it8dj2`hKXLWK~?srX?w
zxt&C`&_1tzbk$0&b|q&CizbiBkbiGUnqMGgPU2-Lhi(UGcni=>1OW65bCE^ab|L=r
z@@kp$fXKR^jBMV@rr<P@8$@(K)v-f1_53X91%O5Z-dEMe%3Ps*6})?p&y*!tW%s6Y
zJb|v9zZ-GaDo(&NgFFp2u24z;HvBqxyiL@}b1vW?9}lOPPdZFx@x{a)8#<fN!lclE
zP6pxlk+)nX3Ot)ciBtz6AS^6g^CacLY(|?%m5=Ym{?eQ2>exL!WJB!jInQS5rMs^?
z@lK=8iQ(#t;`Y0rIQabNuGLE_AyM+%Dw-CI>JwFsot+;(e(ZwGXrqnt3eU@=X@G`<
z+7wJbtc#IF7}SJjqTkpmq@l5KU&TI_cV~_goPJPvxInGFx^7(|?9>`e6CWS(horS%
zQKkkh0VO_y_Vx0N^?bd^1tI#Qzh-HFNY{@}l`){lf5O=P#JfnM|3lTnHRI%ZRUy})
zyae=$tFtq>3K7BF7jD1%yY;VZp@G?W@_l4<v<S5k0Vi3R8NRxyrhRAP?R7a&aCzkk
zB4gs=-Ijy1MoR2I7mNLUXQJ^`$=Dh6t!7@kU)sW#H{}fI3{`OoSvD2L!lzO7g5mP0
zthQs#_7D&lyC9uzimg01y~o-EB;s2{nQCf<piDcn$2)Z*L%?!`z)MLTICN+s>9$E}
zjnqK*Q{a~NhQ|>*wr}6^CF3#a&QbDR%IDqX6s1*+RTD2r{OJpI#!u|ld^IOuVa43)
zbPo@R)bQXF*;AlT(XDxR?ZPR3ll6BLP<~i_Gb!G@evWAA>20fRS*b`w;H*OuC=PoL
zfO%ehn1wQeLjuQ{;K1x1{W{BW<zfCN_bFpZ^6C>WHPqC+@{le}YGTS%fn6NJm0IY*
z**j~o*i$FJrxM4G)jRs!X31Pj=QS-cAh|D*tr^{5)bh7R?cFOaUSEnGIo|&fhd=KJ
z?cYK{0@(3kM1+aC*0ycih%gaCo^cz+q7EB`(JG0Gex*fEIHKVHsFp#%ga|;A#G|_N
zcDa}497v}OKl32n*zF#D;>3w}`U#g&?ikB6$>D$V(n&5m8*fYPQPAXZ!8_>SnooR;
z<5v-9+pMjDhNrb!@xl%RxdCqxwYZQKtleXk!0$>(%BgDq(+$?>M_NGK1Jy-M!FX^!
zayw342Hda9l##c(fK5!B#Hl&E*f4sbgn_r6!ZgvsE~d)(;%KM>;nuK>f3$E<jG_|H
zEJ=60IpTyVY8U*4M8r|!j_F6C^i)JHU4o;-t!N2BS0MT%-H~3Vfiep4n&M-xt|;!n
zSiuPggdZ54f}YR(lW5D!I8R1AA1*KlUr;j)dN`djjXsp4c}SpiiN|IoOarY{Pflzt
zw^Nws!(c_H(s^>{iq1*FE_T@?FE!?DaR|dVwioGn5S6l&k6Ih3k%%+XbjFX+2i<{2
zqP6MXS)gXU8p+~#Wu!^F1;-7aMa1aq19XHAd!c001J%+B3s5MFv>f5O-;%zAot<tC
z)Cz}WP50G}^j^|vNv;tTtO)A9qp)Iyk}tVUcV`cG3(}5knUIt8^@ugSanF^#XWxAR
z9_i%SOihhv%Vcz@TY_qr&dvx@Cm=Kn>IGcB4cSqcPKq=&Ymj1ziaXtfIsvVgR_|Xh
zWk2Rff+ScDGy7b0%4_$=qfPKfiO2#FO2OdOf$j5bA&FvrE(rJJu3$1zDhaB<?_He|
zafh{!RRI5z5)f`&w}GbA*4zXrQ4*3#R!b_ARU{`%=a0}0IDNkPeqt+yo*6S{v{Pdt
z@)Dh85wpPa5m!m_G_0QKlqBX6#iZp1Z{4}M(Cw)d<aW;-`qSkElV&3W@8T(|_%HvZ
zFo|qrGaa(g=8BPZs^OXofq@-lW$nIB*KsEO>`e3*a~Eivrp;r*8k#~lA=P1&m&s^8
zdJ7lf{eRE5-4FX1C^})&c_{f<a{=fMIfCHnKu@H;{AYq5+BJ#nrTQ8Ic#GNa$Y3jP
z3VPxw&GrCr5g@S*Ng7Fq>1KIlH_~cS#;~(1+PwS{POSn|3?et6{$%4J=?6xNtm+}%
zA+L4iKL;a^E6U0$pvoBYwI%)ihYyr{o1%=Ej)qu<+-E51AisNHIjH&(+LRAQ7J5Cd
zy~PH~`}g1PFnZ3-N=*SZ1CksO?>%iG>{3jQfDmWba7o38h?^?i8e7jI96e>}{-b+a
zGlV7v`2MMd&_QSv5A%XC<7<m9<MzQEEVn?Jz_a!7lP8J|uuEa}C9|Fv8#eq<YFpt#
z#B%S=_LGRo=tUQU<L-u6=ck1H0-G$nJa$w85UJU4*D&vBJ8wJArLavl0&z7QseHJc
z`{FxzVoy+b5I|TXyM+zaLC!<LnW}XwT62)KQq_v&q8@(6%42|J)lDZWL=RF!IXhFP
zNQFcsFwgvW5}x8V`pQ}zIH@^^ieag8cfW}yx4Q|euTmE+Gv7xrlBnl{Af;qw$(NF7
zn?&OTSSPidE(GN}CQY}R=O%bkle|0fD|ZxTWVN)kD5c!tx_})~$P|T=bo7+-zyVNS
zBpN=yTI$E&LPY??{yZGGlP~t(AUz!XalSxB#F+O*7_9<xf93h}{bs#+xb3Y_rr=ML
z?5SP4+5S@1C|tNes=5B`I-kt90i#2;<Qb?dj?{e3ugg%AN?Q|=NPXA49=qL(1eX%q
zSLNc_NQz<V-iGMMowR8bA_zu0J7;+Er-S9`?AQ~jd3#K+aiihk3CIqrz$m)n(57Kq
zxFDsF2wMfh2Wh;7!{}f|I+3X4x+5>#gJ<@w`G?w-UEqM27CV#@+KaOtM2Mb&0L>K*
z{~P%DNRdp~TjfGx|Lw|+ETv1F{5R)|%I}Y^7eXT>u^vMWYAIK|y}hXz3=Bv~LXcL1
zrR{;(Ua<81-F{Z(3yHHl0uRr^sH7Q%_;5CKkcUYFi*kpWdHTltY5SQjg&Kiwr(RDu
zc(NE+lvlRLs#8Q`G(hmxVx|Q&*j}A3clPYrQY0eODNgrNimObTm3rYBJ%c^I>ffzT
zu%Cr6)-#^^j>A*h-*Qz$ljr8_kyXPDxcX{B!PY4s>CG>*z8yPfg)Ta3GfxW`=?bw%
zkgTTGX=i6Fdbz<!PfSW0jB9CC(3BTZd9zLRYiGAAVI7y}^1r3S0IbZoF@Q*2^vO;d
zlzN{o#J;XOn~T1{d*7pRtzf&V5OUp+AqdC!kSS6fj*pMR1gcfakvH#=Ab@sJRyHp`
zpHUblp~FA*#;SdUT@kljiLj%V$?%ks0lS!leLp%^LYG^$ri?n^2%Skd9RrM=ph-==
za^Ua~OwkjtrcY>M|7T#~``RfE_MWXjVhePtDED9FGIkCaZqi4Bm23QLSJM44h6rdn
z&fvre=dW)rrNiChotXUKf<8-rw2l(lCy^8atqV06;)teiq@H>=)hk&->5Dz{U`M4v
zwjh~NZ}TVlF!B-{2`=(3J%t?qnMR`$w_;o~Id0HA&qhZEMQtjuNB()F$pm`xBN2P3
z4y2D#$tg%>pF#Or2feAcQS&uB1vO6HIZQsG?hPME+;FG~G$1Qv4mLq}sn8JOZ?hWf
zQbI25X@k@+;M7mRd?sK}Q{AYU{YU9{KhJX!B$W3@`o#Y6Xl{{fFL`m&GcVwHd=v+X
zim4%hJ?H+Eu;%x8=3GPzB3B8{SNHr@ebD)q&3Ee3ViP9J9aC<zCiL;6N7DH`QBhIw
zA?E)BN^brS@F*utCLh{+^vfAQwOwVvBILgR9kXc!9%Y30``U=lJ-mCO8$C$s?l}Mf
z@a`Z+nBbJO0|*ppr*|ISbE?B0(&pU_beeyUBmZX%!qUpJgr=6SwsaetbCJIPKV%0k
z%=xORLmwvc!-RR_KE6SN=zG`>HE7j_fPMwT@<j1N8_*5&5Z$@JvCC)aalwyh+SCW1
zjM~EU)32$&)BruyS)1)aV;s&l1CLf1XQGwB^ROr%Npxu*16Xb4$4usgdq0J5l!Z%I
zfXto7J}{I7I*KI1Agr*bk5C&D<<P(c4~oa1z3MTwT+1($k?;v?ZI>32qVXfBN4QXN
z^OS)B5mz`BLH2_^Szp#|fzkT?;%v$i&z_l66lGLmnb3=qe-D}KNxMHMUH4cjtndpf
z5R!+OgZ;?*$mJbBP-m#Cip@^-54Su%mCG=B4g;Lv5G(J`FO8A}s{h15MK+0R$Ooap
z=I@3Q^>fj6zA^b-)eXFkBhKFqEjPV>-NQ-kw;cHEzjJjl!vv&T&UVf_RSZRYVlrYs
zJ3FPmsA8tUBi(~Uw;ghSA!JLp3VJxMp1Da_B2etW{bw08)&MdKm*>wtI;toRai;X8
zQ569QH4R-+9EdV*EgKNNguk#5$Qsy-G-{YCYHBfW8gbAGK~Z|Yh?hwqUh?0!l%23n
zZH4D5b4Hx_QtAHsR|z;l!qG<r`F=5U(I6n)jEY>WPcsg*#@J&*IaOEiD3<c+f=dV$
zm2J;RfAM50!_>Sh<C&6JF;Eb5eafTe)s^$c$E-z`$eX|R2Zk||eIsMA`wxYBGM8Wc
z-f)hBx-YV~tg-hIt2>vaDw7x|=r+(N`Av8XYL`y6KDpoC-X1uLr5?2!uf6D|2kZO)
zqF;`EnNN04O_1kiv*_-Y)n;*LF{wpGHCk`SP{sxgtEl7pGo`vdX?|Iv3~z9k5sb1~
z@`X52F+4P^|8}SnUBv0Z8CEfH^W`tqQ_Dw&2h;I{I&!AB=WukQvP()2a>3Nc1DS&y
zH0$1WdD~Z=ZesSC*)K3WwL!D^bdl1vqc$S}DkbWTEj8<4#D!EAW=0%umH)vGeRKVH
zerT?e#5xk(AYhg?$5Ve0G*fZ881+FcpD8iS02xhTy0pZ<_{{9yEpqb#z(%xcw#-Bi
z6Saycg(J2QI&?t*m1O#kAfD0#B?enWWhre{i0>RYwk(5+fEyk`OMc`H3T^Wbf?=gJ
zE~A@zryzMCy=E-*`_&|vfY(n$@%;KmFHN&u5cdZc+pPWlX)3+cI82fV2n^6$L&}l%
zbYAlF#xVeIB0{iJR@+TpUS2Bd;NDN<elYvvO#V@XHa;}njf)d_w7fnZl5vtnm<^-s
zQj-+pA>PTT-|=u`UZN!+Wf?8eGQkp>z+J-#>)##+bN?!Hv`kE#)PvgFatq*ItAuE{
zpj}B=vR%}R^8*6|zZeO;uK<g?Z`^d`IQ*81YEKUDA;5R-!GUGJEsjdbyUL308-lbr
z8d>b@jJoeOyr(vM-33-tsL4K+y2(8&(34blWOpwU^k@<Zv_vr<1{)h1t`A@w&aRX#
z^yC8X|6%Q;f>>xZI09QDE-1my5!<a;zDDtZ5z7IH-@EH92_h}QeiZE0F3J#U6S$d=
zzq^A*8XDdrE*c|5$gX)1VM%r`%`Oq|K5*iW!ULA`+MGfCJli?7ZhX;B=dm>;h=v*n
zWQKV?M!z+0{Y&!K3&u+}W_2?JNU8XFuN~j?&J~W~L8X`SLGRyx9u*mrO=Ek7SO1VH
zNMvxkt!Me<w2W;9-o?Oa)!;v!5x9uzwv7KyrNxS&@1oDF+p9qSc#NAcIhB&?1?WE9
zU^U1-i#cngd^TD^#H*%R#`5;c^Rre&(8d$MB*W?Wf>KizhG><xlv5#2HWgD0h)AZv
z7T-?}jC%d@z-MH)ZNLng5q6ZfiY&hx%cdd*&!t*dn0nM|KE4(}dSY@gDM*F%h(vfM
z_6%mTs7zLQE)H_W^Q4mSKnAp|5F4%h;55v75t3J9ilJ1tK8iB3=3E+SLeL-7lYim}
zGF=m^vc*481IQ3nL_IW=nwv?15I+b2Na+tvTmgimHX{<4a8rz8XNEiw0ZqL>(7h~U
z^e0e@-f0p-m6Pr%r%6ZN`(IXJRs!u1QfOJ&HC)X*Dwc)D#CJ#6<D7#lNJHgh5&N~F
zR+!I1P^P6v0$@WXqF)Cwi%B}b$b_HwNK<;s6f&uoA=G3_ok_dwQTl3a8^J-3PDqAQ
z#44^3YT@fPfQ75f3x#=}Po@trJ+p!-LuPw<%|C6CNUXrAZ4S5Xs(bb!X{JQe)B6tf
z!CrgoX3~3C9s|WQh{t&y5Vk-fQAb-lxvV>@z|IiGxm^ulL_<DleHCLENH#NC2-xjq
z-Qn)bABKe~G?YyWKw|j*z4XA+l6VV)-P|GqzeEmJxU>W`-JUkUYvRrMpFV+*L#>i#
zr}*|T4d=Ucw%_GCQBQ0G=?G<I!?cq&(HJ7`0&oYb@Wi>w9)qn8l^N~N4k<jkv_t6C
zkG66@wDl?h@x=m-0DR*qm7RP!2>p2EF54%dm_i4;8@-gyEB?ibUkn|@g+9c+*{E=Z
zBx$4Wa-Vuy&wMdZ9_l<_N!#I6b@-fUHlyN$`OC`E=n(Pdjet`3M_zL#U(MCFt*V}q
z5S+oHk870BB?2>{NWQ<P0p){I%Mv5jDc;}1K$qQKXxgB<$zK6JnaB54MBcr-q<hRQ
zVeT2CB&*%?ou8A}jvvg`vdUnUUnziue%r0vlmmRNL$YwN(pWl4Va2{WCZGn^OtqH(
zNKu0<ROQRQr@^HXbSE6s<%B=2{OKkcwwp$Kd|p}mjcFe<HJfbWp9E1sXp0vXRyK=1
zwNeYutdY+1o)>#5fbV-nFJG1T{bF+yGap*DmaC}V(s+;z$9*IIWIT&X9t-R^R0RoE
zt&}Jt!J?Wks&O?hbU-tB55Jo-CP6VZlilV&1E+{82!~>KnEf@z@KP%xnx~~hA3uIP
zy(lAumiHg~wiIswr@EpW3B1NjCFvwPmK<d>eBW71@Yej@IFxkBtG~QX=hY}l>dvGt
z19o-@0R~O15K^;jn^vW-qMKye`_4x|Tol@TK(%0KTOoQcrN#;mXvUrP`Ztf;A!KB5
zj){6W6v2P}K(z3^yMMM$$p`&vVwc}C)}>8g=z!|?62>^LT&r>4ans8yBspXZtC1Ca
zTk1M*3?cv5^*~kqKt)^O_8EuxyFo4ePrCt1`_*c*cQ#Kc;~wBT_s(AN3#Tprx$VI!
z?)zvb$k_+0u--z|{F66WtE1)}=I=3xAy|beHT>w2E!kOo;>Hg_{Lh;j(^BG|r)~Y|
zw?99;c=6&``%aGtZHJCdz<~c)k$^VfSY+|<C_wl<JCnn(+KVoQQ4FR>E&P70h=Vy9
zw5;DI*Zg|n^U7ZVY@IH0&1dK)pS6rZf|k2qmbenBPkD4HI{m2=F%^PKtAqP=ba;^-
zUdgs^Ig<kra-t&Hp4b>KC@*QA<MdA!vWE^0RIGS#j+XP6)w~PFhfPR`3w?pZ(>IJl
zvl^Og4`*k%-?!Al2?0yVlZ@k$La0p9v`1GSsZBKV%j=Vc+7CUI0>T=JUqdJ?l42A7
zeFs=#43{fgQaY>;A&U+PfEAO{%f<peQ%uAXiOG;BH&5fRTxo0=viXJV>=fLY`YfyU
zjAW)%Y|bkzlmlc>gt)3bP0&H8xSFKNkPSU3PM-YJZ?Ga5lUY#z<1+{=sGM9yWD#jQ
zfg*W<UR@&WzOBjdmKkaHAOu7DKr{)`tV8NGr$WlIK?lk1lEoeES4C&J)9yPVY3OW1
zT~o24#25_%QKxQdqV`A%ebge*?Wha>7^&*&)s~Wr;!rL+G?+d3y(E1cQ<~VLiK8A3
zw|k#Q>~!VK*52k4tAs}IAjV#{_8lY25P>s9?a7~qG&7P)f1xE&1~G32!CRJSwZeTQ
zls0-AsG%EjtCix?p9di`5(13-<%jkRWJfd$C=A!wBAZ)f&V=I|>k-xgT#oEYf`*E_
zTnDX%mW2`;k&#hgsFdy|JZS%s$5Q-5!NGHYBw#aJ!6{>nkiRsUML@B(q8kutZ(aCF
z<T{b|j5q&eP9K3{^ZEcJq?c(%WSlk{VyM0k_z^JL9{~J-Hlx-qyE4?i1W8C#Gw@hv
z_*Alb`9CL_jESk*NKkJ&X~LYH0r}Ha<hbXd-gJUQ>=fNFxnSF$i-cDa(Ma>U=snc^
zLd{h){c66T_F^h$0xF8p97uL{N~Vw(Z!9T1%-Yf``<T#;jiMxqiYo7pM`DpwT59zI
zKMZB`Y?=f~#c85lp?+`!(Q4ymOHzaqsYK>b7fIZyG@48`M50?!t+BMW2is^0FAm8C
z`m}YS$4n><L5fW>7n%yzQEVLf_ZZ*0;Z=zOVH#^>`$R_&2cJsh6ZX3NNZBlhw)52M
zK$<*KQ*TH5KypNeo<*-4(y|A|wt{OqTgibiGYd1rzz`B@EejWi7{bz4cH5Z`zmjRc
z9EC*(RIZJrOc<NI1LsB`rQtNeD!&yRrs}uNzXMNq5Q8yD?f|Yfh^~ylNZi~j9?M%4
z*M5}d=eEtiM)Oce)&=23{>)Yjj2ttDAXE&aD}9n8{v$P7oO4w_#LrTll!8b~<4Y`X
zX*a;=GmPUP%{Yz0grp<3_>Ibs(>xc=TBztkI#AN=O<H}(6?~aPN7W_>&aA1O-T~^`
zbmDXQ7zUq8abUjv3X?k($0(EyuQU$BlM;EdypUunG|>b7%GD^EyQ3V!k56-=hi7L2
zB@55sC$_#|7!3|~B$JttpkNt`+1ZI?Pv>=%#N3;NGDz#c&@^6Tzv!_bIR}9Ii5_io
zuTE8bmFu3O+{fRIG~*s2RV_8pUocVSaNe^u*Ajb~(8eK(>koeubllYdTWz*%27`Nj
z0LJ%0O`aao=F79&<`=;=-pm6DU)KBuil61(7!B8v|9Ph5Y{np&EEWnI&pe#@1TCl`
z=N~)9JA5raFRvylg1G(6o<q#Va;I8PZz6iJ0ner^+z4E-p$Hd_$|m!7208&<rVo8r
zuw-yG;rBkxXi|jeA^y#c7Dj%>C1U7|#wHW5-opI+<=smzExzt>KH&#eMY6SHc(51A
z;~Ld4XLNx>>w`@eIU6C&8mb*A_CMyJezHFWoi$k#P5jFss>q0ob30j)JZxOy2(tP5
z08*N)&<LrVPoJ(1_$v-GSd`6D5lEK0)K1xQqs(NAI0K#lg_?aOF+#tJ%yZ1pu`#da
zOedxb>8)nQnDmHb!SH`@?Fi?;@C3uFtyCcbspk|5;nbWraCzS0h)+m1`re8rlLf3X
zU&FR}HyVd!S;W_DM6CWSD_u1ET`-;ySRAGqx1L(?x5kWPyH7K{ZeJfCcn}2X5<b4H
z(cWyin5+YnS|<PHcq=(x<ojA{{(jq8Y$p~HJU~I&_PkI<9rv(})oODtwzC_K4P3b$
zS?R}I>*Kb96JwLf8Cq)Pn$9PThmX7dJm=wm5ML+vqn^@W>pjMV?E==>zyK(g)^QBb
z5+r$)oSgiFoLqu^`HicjUx6scRJ)+iSQbf;{1-$S+p=Fi<>w2FZe|>vR>ovaPv`#n
zdtCEZ^=WR~=ZDXqccmzfb%YR4w^~q8(0q(f`~y(#XOPfdgp3R(FxF4ZLY|eG>Hf5?
zr!nlf)_?dM+}&!Q%=z)miVpKrtM_l9_1DCally;TF!yuB|C2;=lDvX~w~)03q2x~0
zU}Tq<i4~rzI#xKQSrd_Pm*mK+5ihl99s?bi4^g0(-ALxo3`c}Pa~?Z(VPUMmtw5Ga
z%HJtwA%;Ne387d-9gRLOMyT3H%|B3<1*B1Jn-EcC)~3hXCx);4YCt#WwDrtnlMT?Q
zIGflvY6ziGSL<Q|Xas8b*p4cl)xZdf++4(~>Y)+~1k_pFGV>R0kXh+%5KggeSs~Is
z57gY!F?O2+RlF;30(815KGWb0<h*cg9F&lkntfPD^&9?PaM|Zk>R02ad`zohyW)my
zmO5QXA7o}vbF^vJE_rpTl9Gpf^RFR_YM|_B_%t&$C6Q*g%8Yi(WDG)}er5<nra^SX
z65hFqKTs*)M8aUp$HQm8{Llg<crws}3VG=BOqR2yCK3;fVCus_+kiw74EoBmG5qM?
zQ^LVAG9;#=*+4os^Ux7F>X)l6Gmzt98E=w&^Jc#Y<D7N(gI-gQhxUC{D59Hxt~NQ>
z`sDtCPoF*+1{`o58S$xj`zYN(txklk<H6lKyyb_&lm<O2<hEZ3_<Njs_?IsOTVwW|
zZY?x+dvkm(b5f)38f)Cu2)qM~7>3YK;eeeTh)!Jb&2gD_$CoG_nYBC#MPH!jKx!Mb
zeLf8i{iiW`V+T%Zo=Ned;&mF+%Vusa_d}Dz1>?Ja(d4Z@^ua7@6dg$5InfW$1pxH$
zlaX)&wUH6{F-dIS5mvlct<I9IBOFC`YR;S=Kf`<1gCi!q*&ibb<B|&lxpjTHJPnx%
zu!$gy=Dw)`Z7|H>DKIgiT}2!uX%#q}1;xpB^M<@tH<LPy5GR>P7&GqES_r|OtNC9m
z2O~o7Y;@F}R3!1@RQ_tBMz+SN%tkU#`T+Q;Pip}jIDw;9nR5xxr3emFT~?U{Wt%RB
zZ&S~ZRCx#}5&?+antP0t0DO!Kve(Q<6k3UMUvmgXgFEDipTX7<_WZe7f?g|IVDR6s
zeDo2*Nq+F~$rCqcXQKUphVCJ;S1i}-@A$?vGXWuUvGWdJ%7DXW27t?FleKO>IU9Kj
zH6^ADeMm9v{eti{2U;a<!jvTZA+!i&SOk$QMyLynw2qDl5~W7n)tDt@Xw}N}Fag1w
zabRYLY-Y##_ap!Wa_e65NUls=G)8XoKuXg0r7-!Hu0Hd<p{v)JPq1~N5za_898;B1
zU6qnPAA@$AaP%ON%=zC0=AEx6nv4VWo<_Z-DEVEX=R|X)NM#CNM4bXOa5V=qf;t>v
znvh4(Ou7582z@^A7|piDpBpP#-u-`?kNV4nkG=JOzknV4AJg#vs||Xz(tHA&Z30{;
z>C%TFDR2YhMH8OrVL_=zBipY~dmpv55?|g$6QN*Vb+^X7%i&CJyKoTtH^^PklY+eW
zP^CLt-wWw}s{xr0N7s|GRSeUKXeto7dK#YZ6Sple_yaT<!W{8aos#m=J;Y75UvSWm
zGJ1(ZCJ>k&&h{>b$SAU2c6JOD@_;gBUhGmf=_kq~e&rmb79u4iNl(+mosur2Z(`a}
zWJIJ(Y*mRx<h>EC?|*g$jZx)w=sR*(W1RXQ;{-R4qk{o$nZKqLI+=*`w#Et4MKVn#
zRfI{x$R;VnmNfG43dvnbi^KU8(d)1kP1{23+UWqQr0>UUafmQiG*S#f_wdTYA)Do^
zoF_YtXIh<DL<D-7sY|KSP|GRF8S7Mcm+F@o#=Ht<5;CUJnAgq5G#is!JpbIvoQNfo
zTyB?r<CB<aR^!+X3$|4t1nf!zv__BUs>7n2<(E`WTIqx)$`##kpz1GCo^$$+@gQE!
z;RXf<)AOc&x{fSqS|y&{?gq?+4tDZ`fn**-!K_3p28|Az{n*xBcH#_VBX;~gQQCT_
z2u^AOnm;j<+E4e+f=5w@0P3Z&(=BjFd)P=eXV%h!6ekE(L6YC&-vp3gSVk0eI7nOn
z*9_QAJF4nwC{2*?ETfUMhT{^(t6#seRg~?i=qZ$*Xv%~s5HZ0L<T`{IS~0{w!<*tk
z%1C3%+e7+(^GF{9`E1CZW|*+zC%6czl7=@nHZJwaY<X%-vNl{qMBiZZ^yB9^12@ww
zJ-8w5A(R8$@idy-MzB`B_cvAvVXPGKNJCBfGA<CGjW@@?{3E<w#K#T4)D+5GN}yqk
z6x1oRn)h&9;BwG+9D7iwsUmKMN^_8<a+1c&7b+<Ug~sEN#Uy0ZLoCWj1)$ucP9svN
zhwN?%oB9Hn8T-SB51r|s3!%v+*03P_%PK2Kwu|=PI!l@OC=j?LteRc~67(q)R~@@?
zB$lNh8?OQtbLE3ziX<N&#$i$=3<3eIN~M2p$>KrWhs7_ZK@DWw;1RASN~0D;nzL~d
z;CCz^gc%Or4u$}Rn)Ik&Sr3VPMkCD`H!O*M5?3-o9TTTFPwk69+dp-$cs8b>7Ro&P
zqJ0E>Je4-B;^SlFMWcuy^JA9=24gbW4JT-=`F&4sH5-PSW!_UR90=uOkd~rB!E6{)
zPXB^5VR{k!r@gSf-J5|uCDD$U(T#GS+Dl_ts4_G5jeRM2HCZsg)O<Us<&P6n0h*Ur
z(%gX|h<%mA0RlBx?{CE5_uUP=BW;%`f{(YH@M7Y4ZKv_1>vu(~3H>t<<f*7`gl)SA
zhM!N`yXXlfh|ySqEVPk}p_AOxRv8lm>0gnVmcI#{`gxjGlZ=f4&jAyxMl*xJX}Qgz
zAB63ESFn9DBn2K#H|MD+gtQBS4N>~nXU^75bNX&ZsyxgAhi)H{nqt^^tBEf|x=)TM
zMTCblGCo;Zs1x)s2a{CDi9J(aXoAn(&EhYii@AU(xu?n<PLU*TOZjN5JGjWbMHii}
zs{+ok_3R)e1ob_l9e55&dFbiT>;-GIu;?L>Lv1^cgnQLA^^L0I)EV4YS}Uzq7ma~d
zHxw{yg@ue_(Y8qgLR0~99=+5W7yOPz=&~&zV|Ho$5*#I#gsHmp|Nrm3Fyz===6IT;
zdpNyaZBEPeE`^D~E7rNac(LU#rvvNj*<SCwdn|D7Gt+5x2MzDM_fQRN*nj-tx`Q{*
zsXyX)q_B(oMeyfM2Xh~-vs9n1yE<t9zgzz;Q2q1V-BnYsPmlXhRy#PQBFrjdxG16Y
z`|~!tkEI{AdpfI=pi1L!%PPk|f)u=yg;rqQ^4FLwl{V3fk5&4`j{@6StQ~&TyuzZ*
z@nb9pD}%$2r&s+S?OkV3lv$facUA^;n5ogx#)LY6$^Z(AiDX6uQIbF-jgtJJ2|^19
zLSsV4ksytdgJ=sv11+J60!9$YS+eBN1Otsj{?7H=t=d2PXa8;OR#8P2G;cR=xX*dc
zbI!TH{_D&O34PR){NCK+r~fAoocr)^FEx)sni+~}i<nfx!bbCiAC@k`Pw)lW$BJE9
zw6S1$|G6dUI~SJ-4XJ-W*`|l%?*WTgN%bRcBBJq%zrtBrw3%6EJ18q;C@YdPGwWXt
z)irnZmb0}b=;lFY(z8+foF6HH#I5$R*_7W`S9trLNsHRggM6x}&<o#N<f=TgMq#qE
zwM}2p@2aVJNK|qhh2ZlqrXS&Ok<}&PYWy(zQ=fNJ9`D>1fl}T7^-%yf>U%E|kN)Z{
zq$Lx&EPihc-wrM|x3{MdR-VNMTIVC_$`2}DLx=WUT~yx(&HPH2TT}nO^t!#@y)!;R
zTy@LQYelaG%kYOUiPv*e5@r|FHjHoU(U`~$x0iY%wI(?A8F`P7H#EpSC28efivlO5
zdF1wrT1+b@F-*|i7^J~U@h-zz<lpr|@koiA=qNA(0bhXT-_Y3jDMXWWgg-jRO|&&N
zNpqX&f*qO|i=?*(dLi35QDfe!Yi{F?Dxh`~GQSX%oo4F!`ueU_^~_=-&1nQgp=v9E
z`;%Dk4<eF-hk^eVjACuU8`%LF9neW)?wUt?V_<5^LB=Kr<Lc?@X_@WYYr#|s5Kwg*
z@29(MRfcyo;tP`Do7OQjFnIdx*%=zw2xURnH9)}=eR!6Aiz2x*zD#?qRk`vEBttyO
zcC>SJ%>M1FdkLiwBVuaqrFhV=GI7<3oV5ItC^tdS{IZ&IcDcPge+GT!ZII|s;S17*
znWX_pLl&>Zl$DMSt~HO5_^SI7we%x<!R4o8IBpXp@=!I%KDd9Md>qu+8dxiM5YXM~
z4If|cZ^+%tNZi|e*s0`U&R~2Fqh*-4ThFQ4U%S#<NT|vb*lE*s1Q2$dP-Io0^4rbN
zfoIHNc7FH}o)r@qD8}(}b>)fp9=1WEN>jB(A<#g_;}{5^B~w;TCnqHh>vr{irfAwg
zm7m?SV%g0E)CNZhiRpJ5+DDGuG+acttwquAqm-~@i{xLPuK{9y-?Wd+RkH&bWEQ~p
z0egS85Pp(K@FH8s7@+y2*Nc?~6klDue((ihb}mE_RSdT@EkD1tDLg=YSIK&1x0L4j
z7W8G-0&j@(!mVe@m8>fArb(_4TLAUZMV;t<7x-63t6pj&KcaVNj50Z;GU+C-To~$B
z_9ikoDeq^Y7t?<!WAQq87$dzud8+Q?=jc~4cWau0k4Mk0e&QP+_N<0#n2~SwBb6qe
zutZO?ca`B6(D~L(jkT=|6<23IuZmUWK;@xmch17(`IU71yqS}`^!hdF)3Jn)5G2RQ
zLlmHk6B!G17(N@Iz+&SxVV27QbhnMd=0<+2WsUFYEt*w(1YYcX?%|1=?Z9g>MZ$&A
zv17heQ`1>?v4Qp1wIidW4FukG0NZJnlWeNBYF@cIu__VIqC56exU__Uz>a;<lz&UK
zV#q6}+vN6t15N2IQ!Zj7Bvcc0th3v-!?juP!3T5_MKd8c_rqm3H);DnzKEryH6v=>
z2AD*fPUndDy_Tk|hy<WL)-k4Zd8j6Q%=hqSj<&V+lQGMa{bHT(C<}9g>QQj#trYV+
zb@gh22jnIJ)q|Puk%H8ALNPBdZve3{3YeituM&-@s?uTLIz6?FgmS<2v$$mi5XqyS
z0_5aXU^?&LHL<t*(uZ4zH`lke+D(mj&=H8l{E9fOiY8~VwY%ThcNKMHWo1p~hRClM
z)7Wr?MvHAh$7Sp27<j<FV?xFYK3)4D#-T&kr@`pkR{G)A&2*ojea)-(mQOzST>0>r
ze+Qb4O4xR+$nim7Ek+#NbUvU3k9`Hs=0&JNZ3H|7Jm)%Ce--PrryU{J#n1_!X&abp
z2H@-@r{vN;`#END5|_Id3&`0#{B`Sr*rSY{x`mw;F_(MZHBcr8RIKdem3g5yE|u>l
z+l7TbdL1E)-y6YQ^SM_uL0=F?vU0qOM>l$voxdnN4<)ZZwCvgy8Mxo?hlWzEEmfCp
zSubWf3*yRNLO)rg6WZPgj7m#nXPb)`cp7!x(040f&#@d0saw4pu4eq*>B&!hx`2yk
zzuxsrudJM$lAN5JbNNJPp|Xtb${ix&Vt$V|cIi^7c8BB7)GaI*741<Qd5k)NT?Ff8
z3ZMZG?^k?qX>4d{C(tx+1|1nAOWm?g>yu6I+8I0omW|?j?89vx90E-DtP(vIlY@!F
zR+U&Q#!gycXH|?r@4G$<C1inW;}?@R+CYsgQ~JH0At7|_>rX)>64JQ?T5=Y<r^f=R
zdhw+Td~R`PD-+qadUmsWi>Cv;)XXcqQ3xP)&+3%e?;?rkY#3CG9+SzeAlhp^h%f|9
z^n1x@QB1NQK0Js3rzpV!nl{_FnHba4XOT!|0Ax)ayPRWPzS<0dV$R<%!D?xREX>ak
zJ1%9O)6oe8OSA+zF4inI3NTUsY0h>%yKoZ$l)o|{Xo^L~mL}iZ!6Eg4vT{gvggm#I
zL-^08StQU_rWbkszOMNUe#@K3)<ns<x%(Vj+S}Wo2Gyzq8jG~)>=EuQn{3xy?H6Ks
z&$cDHTqjN3ae5w$jQM7QuPhF@^!+I~)dz0Ch(@CYDXPVt#?2LSS-!TmuFirp*3;9&
z?s~4~*uIZGi!#bv=XU(JHEZY)TsnUn?CXQj`@LtE((2EUT~phLQ-P{*O!^eWp|NMz
zb@UGm*r9h6DJM>njO>sNgUCY6vUn@XpC|FlYy}dr-o2nDpLZ0#P!{{lHZ}|sTOBg@
zqJOyH;BF>7ubG_|pQgT(NXSLF0rFB(QlyYc+QR?fT;39K^Rt!9_=h{MlN2tU%pS<l
zr{6YZVxQTXFoG?vg>RWyRS086Pbi6g<Y6|r*m|}N1~Ppe9i3N-7#RigIyyTYIUU-W
zD+ggDv~%!*UH-K3o-b)HaDOMPKaG_{Cr(XHlf0`M$m4|e<Fc@(f4QRK{B3rg`A6sG
zBex}=Tc($zFsF`@mg7RpX|JA@x`WEGn3fy2k$$%B%V&xu35-mo6;jRrezk^()aT~B
z0MYn{dU_TQ7V#K8a5L8_D^Y5wt&PWGtf|LfWO}K^;Y)P+a)LVWdj4<wLt%9Dk=ouJ
zwp=<2|Gek8<lWb03MVvtV*bmeUHcyZYUPhVWHIMGHS4fe^fKp6Sa7MzJO~XPfp0q>
z6u&Fjk%Y;(i7PB#?V8ay5mB?<UFE_nPRyO=bZ*o)axr45&9+oeC8wT%gjM7lsf<li
za4De_2%PELr#D;<cBe?YV5V={RvILcW0+Wgr_~lt?$%<T;;{qFV)fLb==%Zmr#zn0
zh<9=?Yg=uoy;w=ea9)V4*w)fbhVvfs%6b1;748reIn;gHXC~yv%ZHLlMMX3kckhMi
zw2Xj&fCHC4Uc-TVulT=<HV*3gbE{%}%n7R-Zz=VI4ka!#leVbC$FTw7$vpYGb&LYN
zh?~KRs_v|}-F+1Ht5b|TZkiK12`d$%2AsTvHc+GR=VdoV%!4uJs0oXwo!O#35IveM
z9I?uyv>kdzhsNO<O2PfPw0E~}FEe#G&Qvh7wM|Mr5DaxTUFr=GQ!?lPDh9rd&_k>e
z^<5?AXYC)XaJ;gza(j+X(cNfaEE5?e@5lf6<wq-(grZ1gvzc<r<hQ)h$w+*LN8ei=
z-9QQTG_v8?*bMa6<6kdsy#2acZES}rE_$k@lfJ%woRlN(0oOI|mX?+crQBW*obA*x
zjQFKxA(znw4=&}vC=J}uG?l0(NMiRF@Mmu1-?*`K!@f%gF^{<kCcE$J^!=!)b*{qk
z>&E>nB$b=*RS%Lh8A)3>BUKl2Lw@pBa?jtVy3DOvF>$~pp-C?hd)5m55<srUpO`R*
zK6NN?Pe20S@w&VpUZOY+UWpDC@n1fybs5$@C*w8{fBZ})o=LicQ(Ly&g_bkhtSW^y
z^Fi-~WEW!wc5Bv@N}WW&ht`2_!4nYNu^rrklK5gTN$$chLj~&BNWEFd`&CMl0<Mo)
zT^_%EJWS?5<#1lTSwiWi#;^B=$ud6j{nV))CFRTbRrfP;Eeear^ZEA8g(%%AW8*<r
zE}d)+D^}XQ``k|V&+_MTYg)m1x;Dhz(fLbTc85vEQQS+;<*@zh;iQE~{<KlW7|*k2
zn>mmY(RPH-;<y9VaZWM45Z;#cerEq#<icR24sym@GPiceg!#a9Cm@dMCsQ3Vjr1Xe
z)?{Wo<@K*NHUIRRs4p>{l6?t>g(I)kGZK}zmTY?P_2Zj!ZWeN`o|Py)65ktJS<Hjb
zD+NnJz<vrM+AOo2l$45@<Fin)9Ko6q_`AaKNVHsRMp+24<=)5*aR*?bK0AM1z{KPz
zA0bc}fu2|Gs;B&3+{J~LcLWmNbmCy9eY*<rFqY<%tjl1Nf$QkFKusFl*WJ%LnX?XL
z0~VQ=i?GYK&9I&TGI_(U-UI=LrFWm&D$!x+y#R~;f|*gAGYVyQn9JP${rhL?!ipq^
z+t(P7PwZ4Qo$z4&a^J%w6cdUM88i4Rx93cpO`;uv^k4=YxI?2jP%);U$@px^j~~C5
zY3}SyLl5x}2xesD<Qn1k+2FB^+c(!fTy;m`M8C>Dg|HZ7tr*%aG=D#UhWoTg7^Zca
z$63=j-*GPUt*unf0;<pk9v8=JH8L}c$w~z#H0j@qA!TL-C{SgNc3(L<fS^)K7%e*<
z2bT6KuqucYCp*F}8XOew{p|e0Eo-umA!n4Bo-?&G{?4~ZK~R>*XgZBJ7r8<86id)^
zs`>^7Rs~&%(`>o*x;wYD#&8_GtP;YS(;Ei>&w5J2>_>sFFDg$#idx-DgCB-E{{%L^
z_ahU?#!)Dr45M!YMkAnXV|f~(!aQA7(nqW<#@Q=15=tIwB@b?{XSCemHH25BitAL6
z9%$>FEux4{umG|jk6(_00sg%M@!U2|fedSCX^9B_&=awrkpSAVrgso68oHRz3z={E
zf)NO^Ymr#rm^jZIwUnp_r*2?k5|K3uKTsBViU+Tj;9p`BIX2AAdaqnC@vX}#63DfE
zcH8SVYTSr+R?f)CsF}lTmyDtR1I%n|x}{$e*W8J(Qw}!u9Ello1y;9`95_K1jq*tf
z+jFC$YFG?aD~3ug+-^d}9ArHzk{yDY>g=IIhw$;Cq={7V$dE*<LdPm0es@P`d;2*U
z6SM%3X5JeWJ;JG>?UWc3Tv4GGxTT_5iif1f7=2v>pyh+8C=PTaw%7?}rpmpDm{4t@
zvl8d$u-Qk^3D<TlOzoAUJvT<Xc?OsX9uE=_J3pkMu7{Kzf=24{K6w@bM1)OZvqL^o
zkRwlOX%Y1*psX!m9JaeLZg{-CPRVD%OKH!Zk%F%IG;D;F@&V4uG-!5)QQwo((u&Tr
zw1;U&&`nS?tnT0v!6UZETfi}Iglhy*qg&A%BTr`t_F+A5@4^M#w-}O|1P0ieSH_Gh
z?q4<>?WbL3y|q~{u?b7;r}*`j{$*~z5K7{_#-?A+FquV?N%{FyoEDS7AJGgK{JrwK
zz!xw09}`~h6-vVGg}-wvILwI+?*Ci)HsRYdB|<_=HfbI`WbprN;eW?(&ZvhtsxyV_
TZ~5bD3uzwHIhuC({EdGCm6!Ex

literal 33202
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
L!SQ@eyMO!(=CAjg

diff --git a/reference/as.sir.html b/reference/as.sir.html
index a00799001..db368aa09 100644
--- a/reference/as.sir.html
+++ b/reference/as.sir.html
@@ -9,7 +9,7 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -415,10 +415,10 @@ Breakpoints are currently implemented from EUCAST 2011-2025 and CLSI 2011-2025,
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># A tibble: 4 × 18</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   datetime            index method ab_given    mo_given   host_given input_given</span>
 <span class="r-out co"><span class="r-pr">#&gt;</span>   <span style="color: #949494; font-style: italic;">&lt;dttm&gt;</span>              <span style="color: #949494; font-style: italic;">&lt;int&gt;</span> <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>  <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>       <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      <span style="color: #949494; font-style: italic;">&lt;chr&gt;</span>      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 2025-07-19 <span style="color: #949494;">12:13:25</span>     1 MIC    amoxicillin Escherich… human      8          </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 2025-07-19 <span style="color: #949494;">12:13:25</span>     1 MIC    cipro       Escherich… human      0.256      </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> 2025-07-19 <span style="color: #949494;">12:13:26</span>     1 DISK   tobra       Escherich… human      16         </span>
-<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 2025-07-19 <span style="color: #949494;">12:13:26</span>     1 DISK   genta       Escherich… human      18         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">1</span> 2025-07-23 <span style="color: #949494;">20:22:30</span>     1 MIC    amoxicillin Escherich… human      8          </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">2</span> 2025-07-23 <span style="color: #949494;">20:22:30</span>     1 MIC    cipro       Escherich… human      0.256      </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">3</span> 2025-07-23 <span style="color: #949494;">20:22:30</span>     1 DISK   tobra       Escherich… human      16         </span>
+<span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #BCBCBC;">4</span> 2025-07-23 <span style="color: #949494;">20:22:31</span>     1 DISK   genta       Escherich… human      18         </span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;"># ℹ 11 more variables: ab &lt;ab&gt;, mo &lt;mo&gt;, host &lt;chr&gt;, input &lt;chr&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   outcome &lt;sir&gt;, notes &lt;chr&gt;, guideline &lt;chr&gt;, ref_table &lt;chr&gt;, uti &lt;lgl&gt;,</span></span>
 <span class="r-out co"><span class="r-pr">#&gt;</span> <span style="color: #949494;">#   breakpoint_S_R &lt;chr&gt;, site &lt;chr&gt;</span></span>
diff --git a/reference/atc_online.html b/reference/atc_online.html
index 57c32db6e..598d6dc17 100644
--- a/reference/atc_online.html
+++ b/reference/atc_online.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/av_from_text.html b/reference/av_from_text.html
index f88dc9f4d..83c80cbb9 100644
--- a/reference/av_from_text.html
+++ b/reference/av_from_text.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/av_property.html b/reference/av_property.html
index 69658ed0b..44557cc8d 100644
--- a/reference/av_property.html
+++ b/reference/av_property.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/availability.html b/reference/availability.html
index f3f9125d2..1442263fc 100644
--- a/reference/availability.html
+++ b/reference/availability.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/bug_drug_combinations.html b/reference/bug_drug_combinations.html
index 51fd9f24e..ea0b377f2 100644
--- a/reference/bug_drug_combinations.html
+++ b/reference/bug_drug_combinations.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/clinical_breakpoints.html b/reference/clinical_breakpoints.html
index 8d7492ab5..36c607c5a 100644
--- a/reference/clinical_breakpoints.html
+++ b/reference/clinical_breakpoints.html
@@ -21,7 +21,7 @@ Use as.sir() to transform MICs or disks measurements to SIR values."><meta prope
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/count.html b/reference/count.html
index b14ea8000..2262e2177 100644
--- a/reference/count.html
+++ b/reference/count.html
@@ -9,7 +9,7 @@ count_resistant() should be used to count resistant isolates, count_susceptible(
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/custom_eucast_rules.html b/reference/custom_eucast_rules.html
index 3c27e63ef..0448697d2 100644
--- a/reference/custom_eucast_rules.html
+++ b/reference/custom_eucast_rules.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/custom_mdro_guideline.html b/reference/custom_mdro_guideline.html
index bc60a2061..da00f1755 100644
--- a/reference/custom_mdro_guideline.html
+++ b/reference/custom_mdro_guideline.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/dosage.html b/reference/dosage.html
index 132726799..2f4e917d4 100644
--- a/reference/dosage.html
+++ b/reference/dosage.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/esbl_isolates.html b/reference/esbl_isolates.html
index 6c836f48e..ce33e9020 100644
--- a/reference/esbl_isolates.html
+++ b/reference/esbl_isolates.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/eucast_rules.html b/reference/eucast_rules.html
index 959e67031..8856894d4 100644
--- a/reference/eucast_rules.html
+++ b/reference/eucast_rules.html
@@ -9,7 +9,7 @@ To improve the interpretation of the antibiogram before EUCAST rules are applied
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/example_isolates.html b/reference/example_isolates.html
index b1df5bffe..49b85e732 100644
--- a/reference/example_isolates.html
+++ b/reference/example_isolates.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/example_isolates_unclean.html b/reference/example_isolates_unclean.html
index 20c9a3ea9..b30649fa6 100644
--- a/reference/example_isolates_unclean.html
+++ b/reference/example_isolates_unclean.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/export_ncbi_biosample.html b/reference/export_ncbi_biosample.html
index 4bf5981fb..a39f0e859 100644
--- a/reference/export_ncbi_biosample.html
+++ b/reference/export_ncbi_biosample.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/first_isolate.html b/reference/first_isolate.html
index a5298d082..c7575a3b4 100644
--- a/reference/first_isolate.html
+++ b/reference/first_isolate.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/g.test.html b/reference/g.test.html
index a41e21b96..b148c4650 100644
--- a/reference/g.test.html
+++ b/reference/g.test.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/get_episode.html b/reference/get_episode.html
index 2bf54e033..3a2b0505a 100644
--- a/reference/get_episode.html
+++ b/reference/get_episode.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ggplot_pca.html b/reference/ggplot_pca.html
index fd3931afa..da4e7a131 100644
--- a/reference/ggplot_pca.html
+++ b/reference/ggplot_pca.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/ggplot_sir-10.png b/reference/ggplot_sir-10.png
new file mode 100644
index 0000000000000000000000000000000000000000..eb21cafb405a6285ecb375efad832528f8801f5f
GIT binary patch
literal 46478
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

literal 0
HcmV?d00001

diff --git a/reference/ggplot_sir-2.png b/reference/ggplot_sir-2.png
index c2089a703e5cd1eda1bf31e8da7a5a28642be925..87a43b59fc4af21b5f5609c4ddeaeda12647de53 100644
GIT binary patch
literal 47090
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
Ar~m)}

literal 47408
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

diff --git a/reference/ggplot_sir-5.png b/reference/ggplot_sir-5.png
index 2559506f2fcfeea1b926137a732fa8235f67bb7f..51cf67b7e95c1bdac5e57a3952ad202bcec537e8 100644
GIT binary patch
literal 48805
zcmeFZcT`i|);AhJiXz2MM>L3tH0jdp5NQf12vU4N>AiQbAxM#+g3=Tzf&wbNgJ=*b
zfuJBY6e0A`0|dyOQ9S27Z~yMN<Nou#j3KyFcJ^Ltt~uwgtb|?CR%6-0wF7}bu%Oh>
z=^_yH-UtNUUrY?}NYB%kv+#%EFAcSG@E3ko&z1+lpY6`-*W3^Y-cag4n&^?an+U`~
z1nS&reecAnK0kkxD@hazsoPITC{A{J!^_8~eA8)m(b()e@1lF^g|yHWWS|uT2cyd&
z(_0nI2X<9if1){e`O)QXsSD043T$c%<fpQkHgESUqy}HdaSps}-F=2=W0R2f(^LCH
zekUpVh!t+JK&!iekT|;JuQdOqq1$eHql<CB0P*cxQJP=Z`M<yZzZn7Hc=rR&1-5o}
zecnn{r*MpdeFw*r&;`zeA1l_@)&`s{CMPG8mL@xc^l_Ovh0KD}j}|pLJ&0zdt~Wa^
zBd-<NU%OYh?AOsPBItm2H<0GqxRPBJqyF;{DhTcFDa{oy{Dru6p}|=#C@&f{kr;J<
z4V(y?554G!QmEq(y<%)USyWJPE~l{iU5DwhtW&sa=ot<!u5O;NbGNiG@#z|I$-B4J
zVh%DTkI&4A#keP>1?6RBt*-p2^6>CbK=b8y^lOzc|Na#7iVv~_g&m&izBNYWKS&!x
zb5WB-V)c2P4BC|Cwt1j5mq&!;`ELHb2T(?tk|GJww<0FXiq%~Yh#D;>86F>1d(~zj
z7|>%xz7!C!K|>_BBq=(@rp?dK`yE+4vUMZzxDTEW@4r73^WaI^J>~;tq1~x3tE&2K
zY;49K>q|>ZyRSW$vGa^NX@4l@ixgVy>EevF^xAq`R7~3Q=g-ZI?asDYyU)Gm%6nYU
zu~0E<5v^S0RpOAFCTr1D&c)4b79T;P{ryQb-yRi;ct>NH#VaJt$OgSC3P)Z)L5hqg
z)a4znKQVeKLh>rwA1{a7oc+O(|B+*XX;AF<8-v51>(b<<xgi@k^2NT_9%M4*3S8Z^
z;5m%aL6uo9dhYD#CS9B`E^)pQiYzQB@b5KJtT!UBhV?UT-J<un*uc3H82z2q{-WPq
zIz7CM?F6&t4KeDtfq{W&B`n!UL!;3O8KAm5tSQF*P2q9}1dDkCS}^nC+GX}_8VS#z
zuSJbiVSI<egf_3>J~k)`{W|j(F-*Kcc6PR-wihoVDlcpQ?5MHb&75f+52d|3R_DC0
zcUKG6U5<`P8yy|(`~LmAQ|zKMa<|VV91M<CYTMW=^iQ9DtYD6ft*wzrgT8?Q-a4Yx
zM7K0;G%+y|n`ihwb>k>;p?C26$6p_39{!<2JFAy5K0D*vIsWZ7k&>%fQ9`@JVo0wD
zhL{M$O5Y_rw2FLDWm(zDLpF0YH8q;3YzVE?!e!P@5AlhKiEi0|wZ*mC+FF*v!om?2
z78b@NlKSm~-hCW;vTZIx<yI*Ho<?PMHGv1r{O9gcDlv1l6<>}wMK;y;e&K0)*z~uf
zJDe7}n=&VYV;dju@Q#%1xo<GsqT|tP#LX92I%tUD(ROf{F7Q^`WJby5nUoj3%Fg}@
zv27Kxiu?LRL=L5EV$#>y)6+v7BN8d`Y5Wlj%V@FksSjmgQO^!#<4h3fzsAK7s4MV`
z@j-ey0(ph{>ofHU>a(ou8eTN&*%#qgI6Q$+4;5Z|B!efJ@do<%WDjHFy<oN{sF$I{
z7i5S_dDS+C6%<xg4az`vaxAQ?r;Ielv0e1-;#jDfOWgB2P-?zOr_=U-{P?j`&_lyW
zY5h??-L})SH&L!ULcYf>SkueO)+*7C?mUE(sAZ<UoWc&C@x-kV%g7bpH!CYGy_3^o
z<}nhxz-LCyCCKj`9iyG!zWFzDxP_(3UCl9C>U|%9N-rvs?SvRN@|(=Q@}?-Nz(8Mr
z3cYvR>37a)Ik~xFYPi*?;Rw4c62DI#oF!~W8i+i1h#0f@b2hHwMOk|K&4atcwxKO^
zDqWW*zQ1o9KJ&7bL?)BpL`oXKX#{tN9p#IT=9yu=J+LG4nu(vZ1tz?H*evc_dwcsr
z&Db*a<}VzIQ4|a)EGzT<oO=FYcW0hiP(oT21czEZC2H%o;%z^8(i3Nw=^?evygobg
zdif5dgq@;B1!Ko7nj+E3G15qzhiPO628K~-8JR*zaBa4>wk=QH6NcqGF@H%0P0d+L
z`{orcds;N<iHeGDp!;oda_k))11G-_xBa=laAi};C;I=@{QjDKo`X+kXdmf6fnR%J
z_7RU*ua)0E@Mi{2(wc7l_lxefimm@XN@w!kDzOJOcFk_3qEk-~4bX3W`0?{KTiF(I
zEj;+o**@&05#Kt6rSSir`2W|TFfD@#8L;+FCOm!m)bx^}q4yJl53}G1<LOqe==xVZ
z#ZHu@v;o64w&=NAEs58X;^Ms0C2!@X@!?4+(^FIHHw_FrJNCG~`gPGf_n}PJZ2w2l
z{7M;WZ&Fi-4zI4Rrf7NCTU%RiOy*T@V$oA=%W;;Y*c8g)P7e{i$nmkUm2b()ex}Oz
zjnxHZ8who6Z~o+)|0EvYLReX*A7tvEn4aF4sR|$`N7fJf1>o5(UcA_{GqeuxY(h%a
z(@|dHE%zb@j$4yM>jv{pI&&5SDC0?rUV-I#c}^(=pZ=`O<h9)K_DsBqzW!o^vfr}5
zfU*}G^@eH!A-022myL|d4)U<7R#?<WO)kvOUwjxIt}^b^-*f-|eOY%;PnB<NZF6gu
zrcUJL>1y7dj_=<Kzq=%se;l0EadUICLixgHm**y^_7XA!0s>6XKgpZsetzWkd-v`o
z@YV}IZz9tmc+6g2di^3T?dNSsiRsA%6P|6gPdhp~67-gm#)?!%Mn)cHY9)A*U*_^|
zJMCv@H;LDp;f2LEr3Nc1Ueom2wXW|kFO6lyFm!rg*+T17IXO69Pmhmx#ZHa+^jG*S
zJg@f~YEF;~IvS(C$d{EuByXUlB_!V2C=rzPDV2Vt&GeEI`ODX@`&&3U5jVolrFyL}
zZZh-MKkMu4^rCp%F(T6NQ(gH980pf`3BR@R%pmKjB9+|9WHX4F&GprVxQM=vdZWoP
z2~}fAiFlryT`+=b=ct#b4_CI9o0}`{;qG36Y)JN<$U2~tqOvjb;ll?zUteE7-u3`o
zHQT+q!Gt>py&Xt1eL*TuH>-$3o>M<u>LNI$swDiDr@kMa?&yx{@9!@!cEWG2Saz}^
z<O6RXTyYBu3bIgBt6zXY!b@ZBvbKAj=~*i%E>?xt2DXy!wQDO*Cw>0>8BYz^rMWU{
zvVk;HlQuCv?lapghrg~m??IgqdU|?pWo)^*yDFZv5y>qlmfU0q<)U|>Y$kQOr<hX7
z>TlkCc?sLt$gCJ8W#^tCneoY^ZwGeaI=sFin-`IR-cy+qjVvrGI%4pX%i?z3ugMEN
z;m}>c4R>~P(d-?3wx;Z#PhTazcR0;nP@3!4;ZpJTnUqyarmL%~SPuj<K6>hz-|-EN
zix+P_dHQtI+1YtkPSJB}r9LL~Ej(a)Nmtj^?ELx9O>+I-!~MgqatH~Tv;gCju;*W7
zPqk-giMW}Nk{}?-UoAT!P9(S>$C~S=8|}N9qipRlWx4Tg#wXeM@@1Dyg3l9J=G9qw
zd3j`K0;dxNjYiv|y30H!z5Ma~kCs&}r(ulz1yofjs%Kxe;(e1zCV0}G;YvnCO$e?s
z2YXJ-lKTY?hqFa(_E-9u$<w6MAcBRDPg7#IA>wgS<K#yKpO*@5qyB2R0#V~4|3eUh
zT33VWT`q>2WpqynJWA{B?PZ7S<EeCaoRqq}r;Fjsf|9tnIME4e9iN3FKLX)gK`kh_
zA;Ta;@uNqNstiX+1#)aVO&V=ZQ1wZB;gPzrC+w33tQ*tIm*+}N$~`wq;C^}*l=9xb
zovOHWbg{FeyXtVxeg*`O>GPtcXRpH?>C&9#D=z6;<EsK9>#LPujJ{Jp;{y%?E>{kd
zI8!#$<g+lE!{?{O7fq>uDry|)S+L<X-CgK8(_6~l*wApzcl4Q+7;jH?c{!PztNu<e
z0ukz&TKxO$(y8y>&1M{ADuN8*sMx^;6CY)Hk)a|+-7+^#Ts`}#ds&(Ra^r1zxu4JR
z{SPy_^vukNZ_TPVU!heTa!iiegr=F5<@!;efz#XEAJp~X=Dv<@;x#*H{!uuSHtR)$
z(AVSt1WO!FyAT<>U+u+XBP3hiFOmXO-`{L}%6+RTel7-X|8%{}vA2bNRm42v%*-Yh
zvYdVV;|UtXu*aDo&u3$@rw)gQhiiM8kfvs4W`Y!21fhDXcT>*JJl-94PUYBmT&Vo|
z{mHTeku3IhzYt&l(edYdE&9=mQP$FBH{FME=^8pNJXWEF%WssGmDx05c^^knZbqzX
zT38HMN6r`<7{s;1g0#)qDE|J&AZTNZ$f|bfPkZsJQple=-ba5h>lpkJ{?&ZQToXDb
zDr&;c8X8CJE}YCG!6LL<d=H`2JK@uR8`5J?{M*S$kB)0r8<%tgsaY}eq{=Phl%VHd
z0w>)@n^yH59cR?!ocb$}G3sg8l}@1ks-NqPkI!~L5S(TRr7zfB{@X-GEG|@aeUNi4
z#hF9|z?Px*>aq~iZC#6|Y4j*73k&bw&1Dh^pSm$P^X4>rQ}l&bQIZ+zxU=YRWKMhh
zyIzkzV`S;W{i18y$M-Kl@B0Q_<&YEbx~gh3m=r*0Nh(I^`uMCW$ND!y3?PurNs6T9
zuV267uU@^n+2NAt##8@Hd436U^bA*@*S8`SW(ewH-!%M}`nT8eH&wpNC}A5Lnwu+I
zNE@TWJToveNUf~kPSVDg*+!=eui7YiFJHb?Lp#{oPT1SqR~X>(1Wi_7vISVTe2HIM
z^R4G_i$((e5OsuZG1iiso4Xt?k|3xoVsjd~`<nEqYmnf07ND>;a`?t&-NA?ARo-9K
z&mwm}v&*S$<XDKIHn7^u%5-q?k0K;<mz@?QeBUtYpym9JkG#8VQE_=gZ<9yH0uw<(
zxt5icUDY%igqNyGd|w_&l3QOb4wdJ7;$BE3^FLmEfUKPT$h;70FsV{{tND47#hNh+
z|9CMz?LiuW&CA6iqOjvDDd4amX~{%jJO+co9Eh5r_Q%1;+o8r9L6#rVua|Y`Ud$PG
zX)Y=%a#CNzc&|Bj7mVLPvFR*wL56$~rn-v}fe`xf*r?Vnr|;zYhY5C*+^5KTmwwgk
zX&%%G%v%kagG{&M?weHwHNDJ4nw;=eWU!m|6I>F#Uh?iN+Q`UA#W5$zB4=a$+zj=m
zsXuALMYrXcZr|$k5FBp-Fdm2Zoy@U@bqk0?v$!Mh4B24t7}M?i3m6WIV{qoD6N$N#
zGesR2bw|dQq0i^{NhTFSi-lER3xtt9Jbu+~I%jEVsTM7$q5Wj>)j_7GvNAG}lVKIZ
zODn_CW`9L&*BMpNVNhLd&}q@|V);Sbld^K|G8HcZHvCA1h=3F;ej&ww9LdKQ7ER7K
ziU*zO^FYW~W$4$G!yq>U8ZPFtsJfZ6@qKZ;eP7r)X`a@LI07;N%OMqzR?89Vl=Gyp
zNcFqI*_V&_qwCW**o-x79Uc2kOiVUpQEY05Vi*M-q%i(RxFS`Kp^^z3*KyA?GBOI$
znjRiYk#%goB5~gmV`CRq_laCB;BO8n%O$heP2W_LTDDxy^{N!<6Eu&P9Q~5yd`3e2
z1hd;=Hwn2Dj0=a{{`F|c91~9vtW^AS;UcIv26>yF$lYP6H9T77^+v6I{;+&8D=X_L
zYu@ZM&$#ODDK3k7y(IA%^@xg4W#QbV?pYbuOC~0~F$Lb{=H?m5?|=o{jQm0&YXRHi
zkf0Lay8#@;{qFAW`9a3oEu>O&I^%kc2nzD44~n0+#}w|FtxnvG$3_Zc&uv<(sQSJ1
zZQ)^K0ecQ?A!NSH&%<+O>SaDq1$eJqxsqJCtYXm=cQyBVDGCjszlz#&s09U4>X94f
z>t03p*49=7o_gV=v69$6DXfxP;4j2)>OH8THgj)Jh)>M5c<yI+N@En_4?Mf`uSbkh
zm?@ZdL{zmf=PX~i<Y<0fN@qmDY87Q-HoL!3urKMaCdK>3-rlxKoe%1V*)-PNfI=%p
zjt~gg$3IyqU3ZZ-tMemwfKj_?(L{FNOG6xqGu!MvSFgEi4$|L7;L;m2K=^d%_ye4G
zOJgp_b93JIfj|FpL}Q-qiZeNt@j5rR>N;)}?Mn^%AL@QLZVXPM%LGOF0wua>pac7W
zREXNcTQAcuGJc`nB{$YGy0y>9uItnmCsZS#RT?a}JFK_DzUza=)8p56b8VIZrtY<l
zSZ#KW3wrSRuLgY0{{YZ?{J4@2WJ)O}9!jCHL5@+OM_OfS>R)kbu%7Q7cKAi=wRrJZ
zU4L_XYkD=c^uz{aFp1pTYW0!{pAQ4`_Dy8`GAas)C*al|zPF&F`JBQ@WaVL|+oCb*
zpD@F7Dt6P9r{8$D)$Tj_F}xRO6%Q2DG-b93N3$yb)fZ{Mq5N6|Bv-3n`F(<$hsWRD
zb%t8x;ism-`YV0KocH=0^d<_Yfo2eNc)FN}iKqV+)7g@cjL$;7DErFc_A1Q^$%5)W
zG+q@F5~84`rR5M>eoITMxeM*+#zW`^UNKskFY*Ghu%q8G!Y4aDJ>3kam{a(qxw+Yi
zx4n4_W6Ni~uNTQc|0!#ybgz^#*U<cf(?Pwb);sF6bf5lkI=>hn1n$PyoPVJ6So;6P
z;lC#k@xPSBKiQebanzOreoh(5KY8-RPLG%Awz(QKTlE);pTxz9Cqq4+4n28|ecN<S
zPEL?qndsgf`yM}jd>z<?l5YzY5APiOf$Q$}UHJK!4e@A;B8va2J4%b;@Ul-R>`>4T
zLS01euIB8K1(=s1sl}Ld0O4%^=anCQ{rvcUR0a4A$E+3pMs=GjKbHTF>V8<9W?wI@
zuC9Ln>ecWnG;vN`7H49w$RW&Cw-}`pr+{U@?JU1O8^x=b3m8sB^w_brG=h&4Hz)?J
zU0th}puL!^AIH_c-$}iv$kXf<xc2sZtEu<UX=0-)WHCJL9tcF%7Pa+Ap#t#h8-PSw
zhgkp!^RtEqosf{Yq<He&k`gvS&dGGaTL-$jQ8vKC{qLuN0%_cT+;FxS9S&Hq5ZH(F
zRM3f@ifK^*fOw+Q17GTdugZ%kW<}Ke+#<~m-no0`<z#tTSrwIJKqLJovNBDTfLShY
z{Q5O_9007lCdp#6wBIE$|AJ|Gu3sCJc=4}TEaj}RaZjiF-ABa*1qDXvYA<5{fv7?_
zbK5gCjT01ZPV{C2hu&eEs5EU<P(g=Eh40dYVYVdnBrR)8ld8wY+dI1Np*_{t(kIJE
zdDlxnh<uL+L~+H?uG%W6QWtjw<#qm5n_2n<ci1^G^r8^T3KS5zsA<+;nYSxDGm}sY
zu+eSfOXu|Tw9bLOd+isMh_~A|{P83?$KH|^!(15&iP;pG^3`g{u71i`Hy~DSCAoeT
zHd|IA;s6d;`9XTc^4Y#6_?ViS_TzW%+^IB5t_nI1(-4&$J435o02+^}ZA90th|()K
z1@t^JNi3^_W8oZf_v+jaNhlVM8X6kkjL6J()9L6P$Rxq>C}@_O0fb!*pG^E8ibHzF
zIy%^(Xb0xoFPb^@q#NRPP+QR9K?nY~L~@{-np#hhLr)bF1v6~G@8~SgV|rA$0H*S=
z$_o~R^SWkMa51PnfR3IZIW0B?nQr5(r6*RZQmi6MHFdA+_I<e7*e~gO9ohy_bZ*R|
zE&Dcr5wE4zBbNkF=g}Rg6R+w^a{V46z1mXG<HJ7x1zJ?V6<l#nA=~%PPX5^{VsGh!
zEb5rJcr{_ASAn`z4;rWWay%<sevz|V3A=DiL?lSDKl;*9efi``5HXSuGI=UQ=>?Vq
z0tF>UfBIc|e!g4J3Xv5d(FIK-dFY{d@}cp)sOiYaNHZ#|cx;)Fkgx}ibkxiA&_H|b
zkBk7mz$-$Mw6j?Jzr_{!c*@Z%=Mq+w?%zQLUuX|iN=77BRBZQ;&^WsH81VfCaB)1@
zI+riEjl-hq>*-PS)G<fYY?n=69#~S!>mhBN!kw;W;gywM_i0qGqbgiM-i0%<b{%iK
z6f&xxENY>mQQ_*oo6enb7(=@pkhy><!S6%!+1T4#p7o`EU`+|{Bwq#aMOUhbBzGXC
zrpSS3(89vPSxljI#TRvz_{_XszlUPWk4}q<ipq>yUPA;oNP=Ji_a35-bj?ds1c}bT
zA5RH%b6YTmP7rv9w$B~iK{4O1nwoC@e0_tUj+Q(!B3A?wnk$bQx?gp)RS&(X6A(}-
z^&z~|h-``qU_Kx=_29xQTN|6zl4aGO(*d!*TSRKeWEs$XveR~gf`W{^3jvhU<>lo}
zy-1)%gyiH%C-J0&Jz?k8ojc<dy=JBr6ci2%6bPXpJ6H2oVWb=!9L$u9K&Xj7?4>Xs
zua5kniSrU{=KZd6bley{6L#TMz~M+}4BOFx<`Jt20JA7OejfnUjCXVwBOL(XT16Fz
zU;FS=AG^>k7$CqE8Td=CTl`SC+(_+VYQN0=1}r&AP2B5!#6Xf0CZ4281uR%)()H8S
zCKnzoCr9-%3(+nd%BObxZseQ_%|BiM00H7u5I}vV-m)bU7@Lt?)5^6)=+39lpFh7j
zW}%}rckY^%mDNmPr)iJMwN6OWCxANkt-a5}oiW{4F85PDN>oHdBhhcBR5{-YJHu_-
z<o*a!^=&+5lavXP%QC0bt(`nGT$3F+%)kLCjPzGqCAwUod^a%L7)ADmBS+64!^FqE
z$<E$1D4Rq$`)g(Gt3c};8z;o7Bl~aUC|fkW<Us)mDjfTGJ;OYrp}6C#QBTT*|I15X
zqU(ooo1r;^GIDZ6pf&>&(n1f%e7S=z;<QlN6M2FE2?$exVm8grC3e|w-Z)8Pdd0G?
z>$+)cw-5~88oKD?OMqJinxLmGLiyRq=x9dywu8eG;=$kIxoc|U51g`%RggP&?AT(K
zPQXPpX0syuO>UX(&yguq`HQrL7DXLGl2`wixC^?Qv-JW=Fajq@y>5czi-(ga&+T#*
zdI$Zr<~IgTb#y1YcOnK>5_D;tAoALAxcRiShk|{hKK(j;epBzG1T~)i1VWDwMG0cx
z=5*Y+$bN<@lU=;XP>zXzj33w?_UVhCcWaQeL7wTx^E9?7hrHa}D0L$x2?+^3G!P0^
z);X1R9(@l1_!nuVs8j|5Q+XBw(C6&gy1Nt$ps^o9nNJ<o_N=U|WTf=%!ljG!(VMG|
zp2ys9v}78+aN&k2{P~w7o~iHd2Yz2O5h{^5Zqu1$0QjsbW*M~IyJ>iFld?sldY9y#
zw+BSfDxxS%yhELcHzD(6W}&Rox@(=c?dzPJr2WzLK?38Wg?62u`d6;_baay=B+ZOU
zT}O_fU_!{yRFHW$Ha7TU7w?4i6K=+tEPwtl)X?Bp`*z&h0m_2d(c{Oj1N-#(G`qcx
zgF~f{l7%vMVYDTQEM?JT1N=UlV^2}e_@#~iTrNRX3XGmVk_Ga{zhS%(2YGd!Uc1eg
zsiPw#+w>WkckBT9{n>SoN%H0wr*bhJ84Sll)L`7OudDTcqqNr5bwZlE+mx(ao>fw^
z!iQbx&)leP;wPCcJ&udRORVGaJNPE9vD{jo>QV(lbtQ3F-bo7clhfiOWD^Z5pbf3%
zc~l67L~1#&S)me6M&({B3s<tD>WAlI-g(xm8~?$9rXMUDvMlQV=(jhmm5iXl@DuDC
zlW*~W{-#m+C)-sxjWGS`SppzrzhcKe-)Vrxn7JqsNV;Dd8_8dQI%XqFFF4El7fqHu
zsUoUYI`kB=IrWyzeE_0Iq`bVG_$VzkHC2aiQkj~=IjTVgUaO+~oNeTWT$~wq{F*Kj
zMTLNMgOe0qmCdm)@sO<rESi$2(*JPdQ_(k%(jdL8L!xuyv=EC~#6YMgEA~=xy<4QD
z$lJo=s41cdYTv$n<w*L|?8kX*-n@C!7~@_wEI(|tZzlqALXX-*Qn@?r1X+g*FhEwI
zt+43>k>?8<2wp@~RI7BO{k^S&!^YI|bWcz_9*?()*p5+X+8$a*0w%bBS9CpzFZb1C
z*(&<m_wP&XRaI4Ds1DLbEj7VIr#vOE-8P7!(oXT$^=#Stsdfe#8JU!Vj!i=x8~7)H
zv%Bo)R~~^9dl~>GpJ?@}{@$6FL=uT)z-^HWt+@ugK#7lEq4z%nu;$3!rFu96xHp62
zMg^|}HrAGkQNJLp^hg7=`Lc6xhq<ix&d5bdL*Ef7&$HQ3Q*+7znxJI5lYYrmK6P|1
z*?(cQnIHQ0%6i=aDpBccZ9PV9GdFZkpFTY|xHi*QP7(*%C2VMDh}+N4kEjE$O(v8=
zSv_zvN($sR;-*CwRT{4Oq)AP@-+ufk>2*mg)>wO)CW{JzzElgXLiH1|QFZW0zV_Bu
zi301k)He~5au<Cs;2x!kqGz}{IO5yCef#EFV%PEQTcYT=EHDs}pa0tYF$_7w)NXnj
z6Q2o`-kM-#yOD8MZ|{1CWv>*F+j*Ccx(9%I83!Su@}r}}^Ya%^hMPBUcJlo7KrSTO
zLRVkk-S_C;GEb-;Y>}DOL~<CfqGvBufh1thCt!$#s61^htgdB<>GEO-*HJ?|DpZmP
z)U%~0KDhGc>c)9orXKIZ3wloJ#%5;x>T9dB^>?LZWgQ>6mu$FCPkevFAG7%79F_%Q
z%M8Z%j#Jg@=vqu3cr{YQjvoC1+8w<Gd98{F>%e7h`?2Ok&u*JvaWq5T9Pnm@7Umw*
z5s#X%2w@kK;*SeTKnvdqd<o}+3>uH70{WUTa3U<=EqZPrv<6Y=t@}4ASVlwLz)Gr4
zcja3hVzWrN0s~YB58$VMydUN#udOZnBoqDvndzDwoH&?rnkwTvC#L)UcvdJovbiB-
z%VvsQaGhURP!(waTH91^;?ZFgG?!-CZ{Mz8r;f5(o{AVO^`~h$#>Ij4qzxL>d_WLY
zeEWC8(w>~{zhdGS%(6`0Ge@yLjQvX@v@|(WvPTp8)|2ZeuAJgk*L8GseDDjV%1i#j
ziYLB=b>D&eKbJlElR!w(y?pt7YH=|s1XKgLDCJ~zr0Kj8aUOIIEU<Tz^^mLkk_kRA
z<pfwj)kPi4fPFmpiEGr1_e)nrIPZS;r@yMr`Q2YVL4xvaV`oR67{o+(YY)9}5JcK^
z=9<_6QX#(wFHyQxvd<{)eLW<s>X+Z%_)*Ws!`Ko7?HIJ>92VE7**w)Khw!mKS@;!?
zfXG>7-{pE1dVd{Q{iz#0+pA^d<vAwD#!7C&DIwd*z#9<}DGII!2GTD7*MbQ=>l_Ta
z#xDZslrG3Ah*Kxu{lm8LzpTbTS&jcIJtrgS<-vP|!Fl(j;0BM0>b}SeK_|<o4#aEK
zfg5Uq0o_LBmvF48YIhUT<`WSE&-9ZGfK5R-#OHUI3fsh{m4lNmkM(lTdGsc7d<qCu
z%nEUbUI@4-nx09$0dGXEG^Xjvw_);Teo|6W^%U6Pp4)0doy>gwdh7^T6N)=#P{`eF
zQ0(?q5y@(09lfP)LAN3la-bU2LI#!LjZ65=Hq}Tb=!$sXIVgd4jauBbt+xGDJvh9|
zz}IxyZd&|pVcf-IkKCW8DN;=sAW>Yi$SZUo$LZZZ_=96xtyEuMpCCFnc996Rlb^q*
z_?OemqNBTfyI0KZXOO_zcI?=pLXdCiiIDWc#5+S@jsvuy#Kjtl<y15uZF&|5YRzWr
zLWLK%#XL{Ff)vQ#dLSwKTvCfCLE4quS-tqSaMZh(ow_^`h$Hpj%medccWT>f)KW}b
zoLoSOv7Me?yU45hB~T9!jdP*$7*0#5az&oR#2-Sjp^l*ov~e`2<Nt>)(x}GB!*9SM
z@yEgfgB9RCjERf`lEb8{uP-1J35`pDt9uY+Vn}jTwmH*10E<-ZsVx*(Kg4-?c-9M{
z%>!jU@8q{aXl9QAQKs?%YIYtUp=WE@k@31T#KA=pNt`>-r*mxif1)5h-ck_F^?UdQ
z_f@S7J<N=dK6fal6b3v(lK&d8<^z`a14qpM+x96*wX4(3M9vHicp|X7v$IpMVXaE_
zM}PmOJNq`OTZT&yPmituk(zw+<VhpJu5*XliajPf$T@`pVBhHEAJWy9=c&rf&tHfF
zTe8;&;+BFJ>vVCt)=wT2?~D4{*yv~PPX0S{a4Y_w%mGv9yAGq(DyOucRaGKLW!#S+
zD<6OMZr5g~nh7SLZ)jJ)Gg(FeKT!%WQs0&r7pG93i%QTI`7{qJ&rv-IkJXXBYE}K<
zJTeP^_;3%jL2?lD{VDJ;@La%2iM#Vyd77EwH(u2f2n4f(C|EC(YQ^L#Rj>!`q4wYa
zD=;&k6@k~N=Hud8BleYhRqJ26bV+Hm`1e#H#y{>bMFEbVMz@^6D0M?aEj2o;fVPad
z7H4bEzD=B^+Mg1C_P;dlHk7a>8ve28KqLjc%gLDzj}hHNZ2?hjeF-)7H2!!UYFofy
zp*aH%AOnM|S5+k8UOnKZib-%&)J9$A6<IOLEdv?J8m5*sDTDgj+$_q|XZo)_l-5e*
z@1=68``v8=bm1}pLy)s-epq1Q!w2K?(zzzfW*qHukXND{`5{ze2tH<ZK#fGC5n+8R
zpdCR2F@h%QIF*<{sqVOKZlkBChqvs<4o9m7f-7y*GI_yrmY*`m&!`+RWewMAH7b%<
zkt)?9KU^GV>T6?&yLq@iIbgXf2}0#zUdd4S`!|(DUgD~F<sy!hUNSlk1U6wO>n2u=
zFKRgP1PnbDc7K(^Ad6|ir2P!&HaYi&X1O5eDIcH!rGub13_o|sKr=x$#~2Oipp=kI
z{&bt3nM-vxgzfm#G;gJ3%K8G<uJ$%P!8Bm$JKb<jKt*o#=Gq-T%?FF|Z+$`<e%XEh
zy_TzPLj+9P@p$GCc*FEm1}f*jiZDk?^2ZefG(VRSk5YF0Lr2*9AKg1YJXcacxnYL_
zU8o!yd;F2{L3QN(i!=vJJoenHHZ{S9g^CmnBj}V1uA;L*&uimwD^GJpHAAGOn7#k&
zJh`nmcCyT@sKeCrXR=<S4<SiTn9x<}S8VDtvJdzzQDDoBPA>ldkDhzK4<X>DuGo>R
zH*Yk8R_gfmuU*U15Gy_B<KwgA_9@WdC1B)y@Cne&RyB%OD|H3cNAdb@EOjm|7gukH
zV0dPyR5>jQJSMN2IM>prG-I)G$jbHkMqhFdK9^KMP;Qt$GBj6mpRQk!knA^uZYYau
z^EfD_*-=sR)7;ULb@alhxhecPe+wvt-$!YS6-Zjs0i@grU4KPI#pHd1fxxq5(l_NA
z^>=m=4LUL^zjR`YV$W7+y3JzUTaSGOz4k%cXF57MDZ#9ajM0Z3-HO*cD__5PW7h*D
z`XnPGqujTSj;EPFPSA3GbiowYq1d<i{)|z>1oS63mZ3^ZOB?bi^KsScXz-=~EXzeU
zc$i$#*B`shEY=#d(HS&O$G;K`el8^H^Jj7~7SgZMfD*dE3cHyT0#ZBD#@bpvXnmOf
zW<=XValS<|%f=?Dx|4r%mQmECOrP3Dmi$8Buxf-b`fT2jh0BxZpJg-RdY%%udS-X@
zgC*VAuC7j8E`o3y)^7XI+=@7|uflV>J1RT-7}m%yMRHU_#2~l#7cMq)a&oGERb5T7
zKnF^+CCmp<_)R)RPr72WZuXUV9MHn}0Ae)|7%vh^_8w|kUtf=EtEcv+b*-(JK7$(!
zZG2)U3yaTbc7G>Yk4-n|zFj}BfGcX#6j$DnV@y)$^kDOr=mvG=5IWZsAbt+SRwcRs
z$_qfc#qfP1fjq3CYReC<vTxG{aiZ9ybNUx|C=QOuz^F9FPztZkH60jZa8+$CJ=W9q
z@u(m<BM*RDzIK@OF-+px0&VOstsEqCpI?&sJ*sj}J#vw#cVYFFWe$$TK4$f{v$X~K
zE=knpGq|V9b(iJ>DBlOK#Kviq`AxZ4fNp;0eI~}O8I;|3X{sPwq-f{{25xGiawSJs
zV^kXB#Q7u69TMlZ=+At`<W0>J)tc^2dt>A{g@i>#dBIx>l&y~g7{|&l@Fz%FX~z+K
zGO6~B4XbzF6$E^V%P@^uiVKD_==kyD{++;A<^svk84b9q46-_;))o;lv8s<oJ){Ku
z`Y1h1-YJq2aS5cNK3rFq&j!39c^q1&As<smu=rWIxw_8xgY=#fnMHij4Jb<|>-B5H
zww@kx4NMt#eTVy7;50U+vxGjqkAM6-ryOmH+zI}WqfHNYf<NT<5klgM);RDuWNcju
zQB^;M>b@VI^Da*N463|BVQHxkX>1tgw~OO&y-TWEndv`Roa5;~SceAYk8?AfF87=^
z0#MW&J@WJCapi?3skkWRerP{xmJb1#DFd43nM%MK<(Z@f1`F=9m?@Cn?chzm>*}36
zORYr%@2I|2_<3}7xaZs=QeRI`$^;jQUKRtRd)L_|J8Nr>6PR9MFq$Y=fni_=Dmy2q
znYwM~spRNxl+#<I!imy4lf3__uV35o-(jplit(L0ciscDZwywx)t^5kL7|HF^7Pys
zh8pUN3S{3_4r@t=s`A+2Nuk>7Ccmy2G2k8lLF63pyh2Fjzamx%z?>6#a-AF;a(eK1
zik(H%K4Dfb#?#I>pfL69%Js@in}h+u?|=AtU9#RWZjs(@`W^`Xwr0?7^LBLi_~TV8
zOG{UC!uq*c|Hb$A?_u08SKI*NA3FY)c`ZI$1a^ar+M%W8<yXdHPRjjf`vrJ}dvmg~
z6pV2WQN!02WqY5b{RcY*kiA<zeP?++PkQl;UycFlC;gxJ39@tl;U{=Y^(O!R`Q`SX
zrTi#gSUK5vl0wNNC+@+CItbHiynkHyV8^lP*CkD9sn#~y+1A%Da1=lL`bEAjLNz8P
zPx}*1y+dzYR-*;5Hnh_=Sx5iE?7AfILVk+r@fp1rj~{2)JdJhR*eoI5mA15V%@oS?
zQRa_cDAAcAm*q{mWfB5U;VWA_G|)&CI&H^IaQaaHheYlB8f@_Uf9PY6Y4UzOhDKgF
zN@u$Dg6vBS6<aURf4S3J@b|-6XE<js{(e~Z-id)Hzu))2C;q=@C`w%qToQv~D+LhI
z&2jH}0-`ZQC^!QcKyedj@QfLXo$T$KdR-euof!HLoH1mzrwe@Cd`s2s`xS#i78wj|
z@Oyffy^8&e{2p)ilC(=l*S%jCt@>|D56IP^?wuJ7(HGPG9bmZA4n{2lCa}}Y1wbs@
zxyuEtD{khp&eF3X_OfJiu+^$m#{v4a2Q(pYclHkZN0E?gHQQ@GgV16;zq;ObHp0a^
zOTR2r|5#s%A8BT_CLx&kt+TV*&$$Px(N!9Q`|M&ey<0IXeYIU|z@*Ujd#~n^1wZp$
z&gWqtfFzVc>`Z@Uc{cE9X-C7WBv%q)uRt<mB7N_bV^5;Q_wIOhG<=lSY}+VpCv97e
z+lQ_xpHrTn!}p~)I68{$-*K-zSSOUdN?!g{KX}^DBOV?Qud+Xpdu{6uYlXQg8)^kp
zutB@LRWBXgyTdM6LYE9#RTDM|#@6)0s2<L%TAP@rV^xDOx-cME^N{)8N38(HiOI<z
zt~0O2_U;g2j0ia5tR)s_>^<_tKqY2Maes+wc&cj8yBl@QSthUV>l)9{e#<NErGIVa
zP|Dn@^1RU`c<uYsa>SCIm>1220X$t0J?eVkMPT8G*r^Tb)5s@v1<z}HT3el&TuL-x
zAjq78z4RrkqY2SM$?4=brw7FvRw+*_u+bd`d(YFnFg$*NJ+%JvUXxwt+vIk7Z6%B8
zJez&9o*o{`LO$fyOKiH_7&k=f(K651chYsoi+)avFz}Y~d3V)}aGYVvq~nFL#&2&0
zg>HuZqolxHW{fY(Rs#AaWH3X^`pyD9odKNk6@x2ROgPT0*qN(1?|J74CO=Bwj~|8;
ziUQ%Of(<=>p%W4b%_@9n5QehOLBJ_@x|Q};g9#*&&0iq}%TITm<4noB_wU~q*nZEh
z3(1SSnEoBaj0yFHLqV&JW}ER=3@z>bRAN@W)b5f!%w^w5?rBNl!>rGK78A4m@h2<9
zGg$w2cz=-$Y*F%+nL|je-0}UhE%XmkUn|Eo_Hmr?ZVR@sLRj_s18Rb1dh<N&h>^5W
zl)8J0=?3u<?^OeX1B!}@Wb#ZtbU*cz6BF7DRnM^mRW>D_^KGlJ9$bU3i;+wQCO{20
zp*sii4&lP(#T(|5?@F_?CvJ=6mZW+p9pF6Qc0=Iq;d-~3+T(Evj{IIW?)?XFtrc=<
zR`XSl?vGZ!6rLG$J#f%wUh55I_tL!rfxB#Qn(B02n=a@}H^24vCO(s~>sZL|ve(;t
zUi?i~mXGReX$axmWoft9Dqz1^3k;pU6YT(0is^vN9a87_?;{~kfMj}zfJmeW-*tA8
zO;85(I6VlR7$!M6xg6x`{c<ug%CGQkk1wWAzB<}nSxw-bqHcb<2Lrm{`M4bM8HSRF
z7%BYG&*I`-Rs5m99eQU7R7V~kA2`uR+wX9BFAaEGlbmdAy9-^0F9h$Ng=TWCjQyiY
z4Ly>^Y43S9At~=@{tRptB_6N*lnZ`FL2lYacw=Qcujl7Ow{+mlisjz({3R3FZ}_$u
zLPu6_WNa)>r6?4G^QMR%RTEe8*2XrIrL?~Nmy6@q+L?a!XF*-6hP87LH6oG2_o1Vw
z$IonjIR@OpCU>G$m%ix*UF_#$IfwZC*Ice8p7ZPy%#?6L&t!ex*}PqUya2jqt*i(J
zAw96Ny=Xu-EoJ(0;j+7)Spx7nONgL|)UgqZalNgSu_*nFhNx-2Yj*0gDPt2*E&Pmp
zh$tg!;;OADKu)%w_he>A+`=Yr2${>hJK-bIt#UCP7m7IXO!G#;95uoiTbeCTI896j
zZ4<c59@&w(Rm8_dri0~}*Z0kFiSwQkdFS!ClV;!fHhM&t{j!i%l1GQ`L0ib|pmdFv
z!b*Qqu&QZBh8yia8m>b7sBt9lJ$S7J5#a5Vf{pL0@Ycp)#*REQN_h;%!P;6L8J;R~
zhUq}AS#=eq48+R$qnD07x!6cv&VdcPJLF|z8zOA3zWZ}6!p*^Qbk~{v8RZ2&2kI5x
zsJnk=?|J-#)UoeyIko;OW`ID(MW0+Oro++)UIWu|VF&>>H3uo&bryBLn5FM~GzA;l
z($W&e{*f`H5Ax0Th!cm4ffchj1yUTDz%Zlp)MABcwhef;SFm?nin;}eX>4qKyj1D4
zM%?eqaDRl78c+_+JP=pSA<q|2&qJ#pIeW78BjA$`n4u%HdM{$Vx8F~p$)oyW-vImR
z%b45>VqE!OpTj%h6=KeZTbY%%`G0^7GV!p2`&4nkAhHP29JqPnSw47*9^Q#Qu;ZT2
zU3L{%?n}V!`h^_0$NtozzhX5@KiBY2Arx+wF?B*{GxoFkt9}klFZe$X&==c%7-v}q
zE)Iy^%sv0)W_OS$F0qz;+mal+m;CtG-QsG+HP*F=*Gri%e}1-{k|a&n4|^)S!ohy=
z>-jxPfkRCb)n852=@lPUpQThRpM6e43_8+tPk34QS9h3p2VWc(w>w}Mxs-C_Id)#N
zHe{W525T6*(e-Q|x6`|Nn-Y!x!OtpN<pEWvF6Dw}Nz`0_S13D>e@Z8O<5!yspT?l>
z#z4#rei)n(tb_0iW~m`OsOujz{e2<N`}<E<j7~(~m-lpWopNiyx;>D3UH)JplRMaJ
zm#V$pyFF+()s*%1j-P~(yoLMn;>>Sp0}=N0%e2LG6o%uRBSs9Jifk)Z1F|oeOWf}k
zh0;)V^s*Jub<#L-j&@_D`n_`<l&b5P<YT-=`yy+KEE5@HT?{1M#T1g?Us#)3e3tNS
zUbRNAMr?pk;}?AGaH3ocwx1?;bZ0;FgHFtt9{taH=VXnO>c6g5%jw#EGq*yb;Zu1;
z<->p!8V}!j-vjS<kMTMm{|jFcE)dAa(;`X}c$()D>tgTEC4qs;nzGBeg3LVhy(~?9
zx7I@(qP4qQIGp`&&ad&#9viyka%eb`(2ZG8^cQwnQTT!TxpZ}aR3q|(^c*AAp`OAU
zY-BD)-ZZ5#O{!3dEm*B%Cusl7_o_)#xI;QI6m;VUek-`8pP#Q;s__c8+C?yudQf*J
z*npPE<K9yF>E#XlwmN<xRW|>Co2SUDpYpHiY;&YHO^k>UNaiGap~@)-SsB$__s((;
zaHFQ5SynKI+W0BYUKyB8o7Nm^h~-7`P72BQd*?X>1%<L>eJgi*@0y$HvOl5C;==B$
zI(ue7l`%;U#`43?m7A_f)d!OW5(QcB=m@YrBkajje`kF+5VO#wXbu6|6aSal)*3j)
zQll0U&Gw`7{QCFxS7C8%8%(n~0xi=C*RFBhjL6#^`ly=Dlyxs7k6*a_b$=z!1;3h@
z!;3ziy6vGCIP>$Sg~F;g@tLvSK6m!j@YZmClClVrYMDFY>tM0LOIv`<tL+ZCHBeyr
zR*psu5zS&-tZEVYliaY(Fwk@wOfs{(2eb#|hw#|0x<x6N?lcWIhAq$}ea$!QZ0pN)
z`7W`W_>t|)_16a+8pxz~PKcA2_RMZ`kyuT<ytck_w7wp<tUVC^bHlH`tKRZDK>wT&
z<~hy&2500uB_B%hPTu`qLiLFLQx%w*OGn80asqz<SoXHg-HfhhyHo}?)?Jo^CW1*`
z5v^kEL4EuKtA`89pLt^@412${PEIbbp8k--P4Koc>oL@)S*jUP+PL%~giS+H#Kx;>
zTRmrs8)F5fdRI5gb&-{o8{L}AR!(Pd*Hce#t*hffT!TMqIJ1VE%cHnw1HC>p@9e(N
zP(-XX!}7hXR-LK;Q5@~+ukpb|z2g4VCAI}Fn~H)w2Whq4;%&}9Il5T`9~c=$X%`uD
z_+*8Kyj;oWT)SZhYd_&p1CRTDmx;>w6}k_RD{+#z>I=UY2kI>6v2U8~HHr2e99Yir
zo;h-C$i3}+{0`LfB6rQIej1#au37ywxS;nb=zc&a?py@}(Q=&mEy;=(Zymq!`{YdC
z(TJ*T6+ZF92D>S>McN;KY=w-sQoMZ%g4N3Y<%Ie&VVw}^>W}&maC@*06NB+{u35FY
z-lMLK(AMlvX=#_bA8IT2jPGJm{qE53b@Y{Voy`H>x+2e!HhHyvJLbgyDsetAME|gO
ze(_NK*6BkY@eUf|cQb}c7NyhU7EfGAzDDk_EcZ#=$n<eIyums+p3ci>zT)g9X5m-T
zZ4L3%LPJ#ZHSg76sNlB|zAr4&9PD*uZgKM1P@(8mx&^f4iBCb!R<xwul)>w2&ytS|
z{m!a3BVm?)Lre~Qj5`|0PBELGzO-GJZra@A?R#RR%w;(VQy4ko#q>@D;%{Y&m@gbD
zgH{XfL6gkP$3_lh2j?M)a+3ZBmDAH#PX};2ADt7QK@Qjs70R5M?`By~^!~a^d_aeH
z)8*M(X<QfaJ39{0ikq)!P9=Tf?3fJZeh|kIuQ1@fZ*C!DB4kO^{{Hx>$&hNA&3*Bz
z=5IR@#Yj~%wsl`xi;CDVlODsMPzs~_k@_IW>-k50L}{vYlq^=Q4u3n@@&3X>ktNx7
z=%z*7&etR7h8nW50;W}imBT!*rl3CH(e_xHvJ2LobcqQSL6c0=zpHSX^!lz65g&@*
zkca)lQ*zGz!JdjCv9ZhI0<32gz2Rf!=9*fUKApBU;-fWXz0RbhVE#6RM&{F=V+NA%
z3*Cf%Epbn}Je~fO^Xpm^-FaUoc{=Z#x>#q-$qwt8gRBL9!7>di0foJF?RML$AFp(a
z=t5=Fh@DP4Tom3HXK$7`w6Znlmo9$7-YH|Z7GRal|CE1~5vw0?*L&1jbXIG?aVXe@
z&1G!Gtj3I1O=6u6iy00a>dH;gvK<phE+iYErfrV%OT^gqq~Hf-K1o?tZ@1UUO{ZT$
zIP)A1Ehj5>Sm&a02^2a<Bx{&ruo+E|hLYWC#>SM}MNZr4usK^HQ-i~evpVVA@{VCE
zY@|nf?H*nDe*x{JS^4Qz82q=dkWX}`?sx)Kt7_>~6zAEVR}4vqx455f9UF!UN|JrG
z?8WL`bFq^Q$$xtWFJM|Xq&bv#UMc7jWta1AXBlVNx%r)VZ5RKo6Fk4_D!g3CYzXnS
zg7OYRnp%-`8kWy3v-q1~$C!`(Df9PZMt7P9+l3Hli&@4f=Z2n@2Uzs6CSFvE-QuR6
z=ZXnzc9gRjwwI(U+$qK;)i6KcPg_<p7oKDEV0LDF=dl~}yL&;W*;t*R?N^CLif>&5
z4yo=J#_;EW=C6NJU$#mb((9eU3;nW9n;UaQZ3$c12+hE)bCA6M#W5dB(T!yy+dsH4
zuF$z{6-0}%bl&?te@_2=+wgYp>e3YQpKd0$hO_v0l%W4cn5A>hZpys#+}-o%t{K#&
z1~!h(^2h$zYG}~XrxfC>oqd@8j9&2dXP9QhwHNuC!@u8TW1A)FMRV91@H)=<tIWgY
z)rRHe6On(eWuMa_Der3KvGr_Ave_w)8x?y(_BCL&_Hb-1X>>+m*tQD7tov(4Z;D|r
zv%e4R)`?NL0@;{g(xGLOp}}^#WfH5KHo}v(n5LLEeS5^8)3<k@qwNpkUtGBPNy=AM
zA><zooP~5uu-7{$iAD4uq@IR)#97%8zacX#C%pVSe<4v^r(ro&HppIluk&X*Bw)D*
zJ+f!h`TIlFwC)K0zrD==ixIc;iCJ!Qac54Kfj{i!^KB5IDYPGI@<JZQc1G6lhbW)o
z7_DGSGraRVXGnkNWnLG3$0g6|y`yB`52n4rqGuEH_j&J^i1v0(-<HNbYl_fk>GtxS
z=L-A7er7!MqQi3)I5Et2|6CF@mux-xS}V%xmXmHa4H54A4+W~+ep!ikW>a)_&p_Bu
z0@r~4KoVos@hcyoU&ibuZ$$vBY@T)zh1EZx^}R_A<%qaV6Wp-K8Te)_fUJsY*7IPw
z8kD=^B`Yg?%dvFisT>`VS>QNh5sm8CTlp!a08zW|PgsM{sd0wMj7cDIyAsoN-J^R0
zmGpc3Rf4$Y=q9v}?cKpPg}?H9M6+m{G>YV&6z<^FKQSUUa7yIK#cM-L7w`MuV^6Im
zfPK)?*vM#yz+L{k?55kBXtfbyGt<+3Xe=R`&%Xr(K{kL=B!KDMAXX{!d+(V|0(9-g
z<_IXc``Ex&_K)fJ%YWY*W6o1cKLM92q}GpugxVe}Oa$iw03XlD^l5OgVjrfC9UsWm
z%_{JP?_gj9whg;oU|nRER8v@kIyI&!l+c`f;LMj?!}mk^u$@A1AlF}oGS2?-0PM=9
zNOdt%^&D|p!wT=Yn>MDee$QpbWA0$P2mBdD+$FRt3eF<VLanA%IQ^_6fDw)l>>Xm8
zntX5|ELk~hcsdT8=(w?*p>$5*nRdP?F7_J9&`OwLq#`y?09wq!cv_)R*r<C)dxLpk
zE#$P=teyEXD2}0L$(}zKRxQpl#htsnh@k>+&9T(2Sb9P~aD2$g7ys0rLbt-}GEmOx
zt=*Nacm8=qFo|hEt%h%iZ9*qZH8JSmrojV|;KM>UdQmRG_wchd(Fb}geK&C8cb7-}
zoi1zT=QE>{WwQ1^oZZ52{#oY7XjExTw>8luvnA54hkK)cCe>&(UQIft-AzLjuBod@
zP_tfOFc*2JH1eLL!8GW%>K~}4l7fGNCFJFRsr!wkXm4#Y9sBvV!m~?y$DTN9^jH1W
z`f@TPPDWOCnG$vOKjPVr_-{3U+0uT&Jt4$hLEP)24V%QcoI_U<r8@_bwy(3z)qO2O
z5D%N8&AnXxS?8)%{ORR)m9QFWuAdeQ4Uuxh0y2*PpP^Y9kZSF+PW|iN_>iOFPmxYU
z-t1VQYrUCh%)4qfV4ss2cEpte-<IL3GCKmXywmvx)8I#-JaJ$~W@W5OemmY1GkVX&
ztIxxV4y&Dyy;G|bI3K&`tI3_eocxEmbws^b!hOs%Mf<t+LP?l!g8`Br-v4?yr+Im=
za+&MMSN<pEtkZE6ZD{GlgPz;oO1q;6d8jA&Y*^e)Z^>4fu@%Rm^RH6Wc-E`pz1LQQ
z(hTcfpLo{9OC<~7n@H9jz`T?U{Bkw~72zIx72g?emn&DkV}sk(`QrDVZ);+w6}Ve@
zcF6$tiBC;U-Sy@S4TN29ffc#AGnNByfUjMssk^*4$?WJ}F~%<=u6X*~{sNnJnNz@1
zcmZ?He}uJCj>=^^f8J+M5VgRCWfQ2dRU+^;Y0KAAh|iCu9zEu@{o>zl?%&+2WLm<5
zxHkQfc-4VQtSv4+jdONcOF%W$>V7%h5`sYMMdvhvV65PlwO^U4Nr7cr7GexuO>#Kw
z5+R>q5^o|b2!XG^Jb2SwE<E+w*(KohzLOOFF?y`9Ma^4$_IWKC7^C@`uV6Sjj{xd|
zviD4hJS<{3!Ll=K*R=qGwGTL-hj4O#-`^_+S3Ah^sWHTnc1CFPmLDP;>N{S$+vE;S
z9_DCsaIw=IL9xDdxyq6}w6{Lx5p}JB6Ffj6JXPl&doo)uJ%n#v!_NNU(39eK-%0rR
zkqj|l6^L(#EsAsl%AMEUnp?oLe4S}9_VV6<0dT1JvYUgWmER7wBX|@0D~Sh9aeq}W
zE-qGx#5Fc|;}=*xsb3?I(L``4^BZI~TPb(#d=XFj{B5Wb#?wiYxBmcy(!U;_ojC4A
z<9q*XNF%z_xoD5hi^muw5K;;D8Wz^v=;=#rG9n3@NAz|GJZi99tM0sfd_NKLHo^)K
z$EqR}o~nnI@y_FK<N!;P8NDNj1bF&*_|lF;2f5F;X$3fdS)el(OQ3K7MaHRCLw?>_
zG5T^t+3LBW{tWG2W7wi$LM2Fn3}pvy6j<l**{XQmza3t>x57F%pYbLvKSS?9+=e~9
z;}KKc;T;z?Ju3>LHNyk?(Du>4dpbSO2F-2~&0Y4Hu^v^}YpA*_kH6yIu!54{1leK*
zhsGcI$qU>apgpsd?xRhI4w5WtQubiSnrX2NrfloMgLQp}Lzp<`6)r!og0e<Vo+lMv
zUW*JC-+7V{Y?yzmS(q9q@2GSj2t^9Pu!g3f#^~gNhAr&O<7@zaD>kZE(D&8RHKtQy
zapccbRR~FFew&v^(FgvSj?WMj;s<8*Fz^3D90uCqH(|q$(hjIpxcRC8yUyGkT5TXR
zEuQZ?{<{#`_+EtWinWy`al14fmj7GOw#04MSrWA>E-e--1jE}R*gq09(s5@&Qc_;^
zR{@TAzZ5L`Pwhj+uof%BPv_f#f2f-0Ov!%vbp2z>j}tq0omn~fu3Z0ErSGi59S={>
zz@64$C86}zY=He~l17ErzW|o}Ysg_uzslE1_(~@+9pc1RXUJ<0gX9InPCI*XAo`QQ
zjPfV8<040TIt3j}*`_pI)-S^nObFwjS{58)tXx9q0CA`V!dgqbq{a9?gX?W4S1PDH
zD}1{|g=~1LTL^bpX1nU&NX3%BlZt1*Erqdv41IO9tO~xpPkc6&{Ug-?sVX!0@agZG
z=HB`|LdH~wA&@EYWYb(vNbxSl8eE9}|G83h<ZV$eeZ&hO!`15=w9ce>(TX1oeAK-V
zoc`(b{Qdz}^U2xFEdmjZvHf=)x*N+My%|U2evr1miH1vUtA)yV(y+snvU7#u9m|-O
zX--XXNV|}Y=ARb%Dvs6Libj<_ka1nc`Dd`j!(cBOIRu5S3FTw|&(}crxWD9Srq!4u
zqKeI)hW6cFZ;@Gs0c?mFjW|QNaL2)|m$qMk%D^2~*QY%s$hGOzI)|rKWzeQ|q&3}E
zLBC=eF7q29WSx+SD@SDQPA@%I*KJAOpUgSK>Mqy%s3OQI{GSaq`c@4YXGzYNEU0vB
zRoJ?lw2jBNYRV6Hc}Bi;z`k(%Jqt(_8F=nuC(%B73u{I3u1$&0b6Y`UV+7Rm22U%C
zzx7TB%C0ebm83r)6fK?eQ+LXa5r7xn+zFNx#7Tz2XEgro^8E6g)>{99!658Z=`BOd
z=qTbo8{)G;rx3}^-;OxsAzHX!=0UH#MFeJ4b-NyrxJ^|tScIB`NwhC)TdNF?<khzD
zrHlU)1D%H<`j<8s#dzvDjgv)qz}66=FT@D{KkU5+R8(8nEeN85N-%?xM52-fB!hwq
zB?y9n3}O*Pa?TWp!c_@UB#}@er3exvXDCG}k))vHD3Wt5poHpm(0l*yz4yKD{=458
zugB=$aqkdCs!pA=_u6aCHP@V;)PH~41@Zsj2E>jYWC(8B5kY&D=D=HqwL@>M4-)?=
z+R(5hxC2G09XUqVVhQW#rg*}H|9L3g8j?vn6dLD;L<p>b*@VRy;-BS<x8X&wlX>NH
zN8awzXK2)@`$Xj$BoX8rB;>>{CjZ~wMFjM4Vnxc-`NR9M9S#87E(H!8psgOm%fQg`
z_9b5tgo45mRXj#z!d*B;-F&6LM(V$N6`TAjS9<$7jbhP%>Rg-5p1p2NJ~LDSdn=Q@
z)~{`6`33dGk|D)hT^m8aJIk$ZSnlQzyQ>*#O!xUQuPHjIL+<zyo^BOy7l%Yhu^NNi
zpC$iHYm`c7F_Ul0;}@FX8no1)AAedC?mC9QCpWy+ai^d8-^;1h?aaK<d>_Fv$dgx@
zG7==J7JC|=ocssQIthR=*Mm1A1ET}q1Qk5wEMA>CO#JhtPj_)f&wRDaRyo2Of7`4g
z@H?R;Nbex#ga!eJoq0ITx>n86neg{A)8+LI$ge8Oy7Br2V8_gZhCkd@99X|l9)6JU
zB-fR*%fx!|{SATkSq8OvZS>5ViJ*lu#cY}fXI%N`cl@BuP-N1-T&YmI9SC^BezysD
zZeaU94EVI{r>*pFrac??^5hLX6i*s~rw4J-I8M~xRq<-9<-jfG!SuDp(=+Lk@psnt
zJLx>y{IfV{-^e1bLA4YVNu5iR!@X&F!+pQTQmu<)ez@-RpJtgHODxu&%7Z$bFhZCh
zlv!q?jz9uJqOD(@|GVpfef7A8#wReBN}|E|@#zb2xAg)Uf4n^YXI;$T`aX1Z+YNI5
z`K}{UjGi4d3o<yh`e&V9p*7=b?owi8GaNO%P7S!n%Bdgxl+EL%GTwc3zYcV&R;GNq
zs`TXcpAuP@cWQStO#q$o-pbs{kvo|hun?$TA1|C+{wa0v@7;EVSuG;9DH0nmnF)8M
z;V)|--Na<VDQ&Pc)`EG5u#m@G%HrV|44ti*t0v*UE5$dA92GXaE)6nN5@`Z*NAHLp
zeO%+eSkI4vwsSG)!)=!sk_HeISg%cMVDSMO@gjYacRK!}JTJw~q=Ak=0B>TG2<uzN
zOOWMGa!1JAc88<62O0X3it^dMA<u+tlq{}b@hBarEe3#G&tD9aj2=J`P_!vFD|H$|
zb=i3s<mp!q4TW+B)GCsCmomw7HIzo+Zky4I0c(z=RmidZ2>CRgAtiMi0ocM?#_*$h
zFhI77Oe_l_Gu^(>w66yuho|!T&uB9kk{H9aax7JoXUP@SB%Q;tt#-I3E9)JFz}SA1
zmX^i<6ol2n;^KZpC{Z{;(`xp@R1|W_Hu;*8gV{SwX)E{2?7g!qV2|DIa=y+I9-GO}
z>>i!wxo==}S#Kc1?yT?R`v?1KV2+^gOMicLT8+6#y!>qG@Y%?sVbJWWtOi!BcK0r(
zv4{LArD!0!o51v+yk|>_A`W3HMmLP)?>j2wWzH9E&<#Qr2{bnz^VqanM#xRRmH-x@
z4zAupi;hd766$MC<;73jHB_tXv=z=dB}$`P5b|5k0FtuDiQD<D{FecmNNQ0UUED`r
z)U)F-syomRxpojJcJ}YSU(2NYix*Otcn-LDYfu9*Q+mA~vstH}r$5~dA`G%>Y|bB)
zMNG=w&;wih-#5dchw-ytFO9L+hg`~xS3sn$M#iaWMc|RvQ}|XWZY9gQNO@yCO`6fJ
zre-R84#W?6P&UWr%t~D$xNy@>+p^Cu9UxpGoP6%v`yGXSl?5#R7Uk7Wbjk8&FNm7d
zLO*!6e#AwTr87q#(qJHf$I@26&r1aQ<9kg$*JXmg&f%sOs{##p|6=$T4L1^bPO+<T
z`Y+Q)OLbsKo#;sa;;O361!ECC_fGTB<eR5s<#v~dLTeXc{MRBf;)Z|+)LhiLo^18|
z@*D|9YHXu%fgLn@G*us%?0p%oQZep29yoWUQWMpB9c1>l$nVII>}^7`_`b_G2~*fM
z%056sH=CN6Snq-x)j#m{YaWybBZwl&z4fIrj0<RRKj!cn4APFN&_c;QWgB1Vg?@U0
zSbRe=EO(A-$`+ZDU{QAec3$V^cv|F^)oa&P>#CK7Wx&Z|;uf~gkGYeKuH=|N+rXNg
z&jL%#0du5%nYxwFszMh`y0RkWHP(VN1JrV=y#+Xt4u5gx!<~%$l<?K%Z!SQe0?gQO
z0xg7M37d~}J8!&u5gU_3Q=CEuDHSc6anOl98vXX@tOW_)RuT(uD~c-CV|1-_tjbho
zwWeV4!3{Ac!P3$7LhAiW+(~@v8XH`pY`XSvEfexrr^+D9O{SXvc1^p_8Mxdj;;>;n
zt<EH@14V%e#A3gBdV=U^$AuhpJ{gXU<Mmz?{*1YIcV}wZ1~h)f|KP6cs^OV9A^yE%
zaAtC{To~?7o<%(t<F))%jRHFn?I{x9fNZT67?cmNrAyuZyRxYmeDK#G!xqIyFTAN>
zr|2s}psJbd!8MGSR^NJeFCO9<rVBVyxv%ab51IRzBY~B-C)G-RWx@#HVEi6gxK+x=
z5SmELWHthfWd$%^6*}rz36Ditu75RBX=7Z92s8ciKt{i*OzvtiRrH#M6@*DTPpRq|
zfB>e7eEiV;t5i^c*No=DKeh%MwrZKNhy;vtSi)7UHA18j?axCKS3cg(^E|yOifU7L
zE!+3x^w*fp&sjVu{}%$E7aJ*7BfHsHJ;|^VR=%h*CA)q&pjMd&BpE4)JSaMIPl$k)
zpyI0B3$N67C|eCHSx8fq;tN%SAOXgLYra58-i3rLrG*cNJe!kbmlC0D+91QkhA6_6
zP8%+ZsGkM&)`sU0gV&p50Y@FJ=<TV>`Soj&>Dg__aNxmytzAGF3k~}++eCnBz9Gn-
z5D5e{>zwk*%;MB$19(X+Kx-;=);pMX#2?=KfRpL_SzHTl_pjYD8CL}q#1;gj@%4GG
zW6i!0nPq==SaAByztaX?ZPEZJxCKRO-y{R}QDs!(uqiU%S3hosjd|ou>9d3y8<QmK
z%16IRRY<j8<*yK#v%DMIi{%1MfAit)m=%m0f@;<<a#j9yATAnIk3WG=fgM%z@weoi
zgFk@QMjBgMzqa?mdsUhi17P^20_c*m|GgT_{SFvkyXLyX$riBEBnH;Ae!jQ1*?OQU
zYkEwj)D0%SwxP&YszWBho-kKIV)GeKtpLXR7A&=4Rb&aD4cxWwXp$K0q#EjS7?a|_
zWg^F4xP@VE6gfn?a_F!9?>kiJ#v;Etz(*N75L)3Gd->(?z6UCNk6x4!n1jj)Mf7_!
z3;sQsuM@_!Tju;hTb7wx$h2}Te>q1BR;=y|IA~WXF9hW7A~H25FgoB4Gxrq^L+>9<
zy%2Z?k2ObQcWxx8P7njUK+aSdWZS!1p!jqJ)Ty-^7YXN$248m#yp&;`d@zY2#(UKM
zIMkBW@%0ut+lR*Y?(U7E)NW)6z(}_U&G^iWi8lf;(slyd&tdQ$ps5E3c>xu?n0mF;
zhLC}wHXi8gl$p0Rtl6!!h^TyC9o!QLu$vv-5LV#PmK{t!C`LOa!1cEll0bNIpdDtV
zBUG6bm;1_$XL-+M=nM51!j(6`3h|~4u97SIH@09~{Em2uy4f%2fdDq8N|)O_;_?{h
zw^*Or{&~mXXriN%QbIQQO|_F}Ak{BcC*CKt4#)kr&gmR}uz$zL+v4}O-2HQ@s`G%@
zlgRIe0Fb&51c*MfR3M$f1gL>j#LF44cB28@@6%B@9@fyEr-xM5l;)ZAjGZq|2{hq;
z<DBe5a8&R*nu(8pSs^s+79j$)lzm(u2sv7TFv92=x<6tMm$6vN)RW&ion+OOWiHzz
z8Nda4LuiM5!_Ts?Sm&@Xs=r_U+robasx&<vd(*MIFav$EL!wg@$b)Z!x+Td9EWI$Q
z(6-1a`RWC8)%eBQ=4Ty2BmUw=+ei}vT7E=8%YXUf6GPBXT>tFC%w^+pr6SN1nQsCB
zA0hfBLE*2%=>~|{AGDDjqN<38hldJ~X8v<%<L;w0iJ<f%!csf^W9V)UBUd9^OBro}
zK<1id+RJa=X6mX-{ZCTr$tuU6kwRXTPX3__29~6z4m|-T6^;tm3yZ7|Et@Xd8UEtV
zCqf|rC3BvgN^6~U;jDAJOeMT90EKesLlRX*_Z;M3alrSoF6e3lw2lM7ADd}lS5>5@
znmYrsDzU+?+N2Eaf}u^txmzU=gf0T;l_&6Mcdm8z86X21R!RfSGCZS}e0vh`umAYt
zj|3GurkIM|sAxySU6p{b#Zxst6(3GRD+2Tu8hxyi$mFho0EhCg2&M3DTEMPj3M2t+
zC?$_5U2xq8gk?Dh2HPgj2g0rl$SNvY`2n=vY8n>zV-MdU52GG|<6cA0?U6qWC^?FF
zGHml?mn8v^dkKh#z^K3YON51`*aXx?q&WwewEDB0S2qazezA*H6ciLF;#x>^fD2EX
zNu0v9c+$9edWx2hKC|_JlfNRrONelc@G@8)$bB&u4E<9?-E;X{b2HEts-Ob!*?6Y~
zpf?%0O)z)l16*d#GyxykVY<J2P*<4R+{M>2&*x6>CsHAq94@er@cHMvJ7j^_%bYtt
zS)6(BbvHBw<k@8)5vbflmnO-?wUgNuwi)uDWR{IoaLHAH#$$Ieu-|fEk@4FUXus|T
z>Ke#2P@(`MgZx{x9g;gAP{%L=E~ga`dHsd%&z~6#0#6%?13oW$1(Qq1Wn3DtxsmNp
zMi_l};Pz%*KP^n_Kn46t`x~H<myw`3%6h2E>hH2GcS0`MlM{-AwZ94wb&-Do+FHhd
z2WhQFHxx{m)y-JGdnqBR2OwYZ=THW0y3&wxjY@K8|2<{TPlcK9_d85Hw<5^z24K2M
z@Me~mJ-}!?q<2&iR0;f`M-bTs`1>YzvYD9~=Ae@fU$krm46(_qd8J-myFfPtV7<ve
zYimBUmkynI7f>s4&%%CJ5h$#ilT*0f75;x1(*KSG`kO#aM!K}yt7V&Xt*$F86Z~JJ
z7Qa{Ce@&hI2Mgg}25_$D0DOwvA^alriEgNIc>kON1tRC0hc7+`tU3;&uORH0A>0o0
zt3A_DFq<M}ZpWxg*$AOgH^a>g_RUa~8b=wU0K->|1Ee4BP;|;jJbHl+TD_gO*2516
zvl{GlBc{e1ms{Tn1I~-58Gnj!{+ST2v;3>xU3WPD`SSHZFfs`c0f1gN@t-e;V;e>?
zBV<RPI&!*v;<5&6I48nW)`yh5VXP_9vo~5>sY~JQrj8oBy9Y?PszENg0L9;<7q3r8
z*DFjtQDt0Tf=Uaw_%m92%kRtnuaJV1ivZR5u5*~3<D!npqZbB%A9Mk{F#so?qr9A)
z2i^<C^r|zS=LS83fgrJq0SsYYi@*!QhOWqf(7gybsv`8Q3IP9b(}IybBc!aYn*XZC
zSyhzl4_x58P^MF=A&VJ+lT!)0H5v$vvI+&ia!Qkxw*0U8T5a!N3q;2$+ZvGDiG~Z$
zzn$k*3uwM_-=8{>QTf-rGVtQd+(7((t`8D><+!m)-ibk^$b$=OJ^U8Rm_y7W#%teU
z9=ysQ8sqyAS*(6z5l<IDNcyyu)_*cX8nvD-Nkm|WV_!B0gP8)7ExaEfp8%xC3_QW~
zsU0qsEPM__Ab;YHq)$oJfEuM8D(QLzpK$*KwH(7TZ6(|%tJYB?c6N4qAeZN*!+i*W
z>cO$z;*4usB?szR&YzjBXL2r~P>xL@K*IMDZfM<=!$)-V@br`hiwKga4N$jTi0q!d
zqj?^cpl{jX>Fz#r?5&_`WwQfIFZ3I9MdE$M_cOTrJ-?k-%KRLd%<qE8IIkZM<sm|L
zNI~V~N}BFkN<cnCy<D|uqs18wcydY-?cKbn+C&dTc+LMx#&tQtM=zvz<U*l7yX!1W
z02MnA*Qtfb<>uvyyEX`yR37s(qcfKUfLP~j;%4IwJ(KTezsbTJwZTD^H5Ixc%^yX9
zBBu`TRp!XFSHdYXtT8z0re5{B^`c`NRm{{xJg*!<mxh2K1~l&hfZD>sEP@7;{Pf#`
z?w%e|&ToFbnA|zYL1f`B6oXiXCycOe(n8MS3n!5^XhDrP5t8t6lkicRqc#ixl=1}-
zp(;{&Yi)*x#QgYU4m{cIYVQ}K_b<IV!^Ab+3ozKrNU+)ytuw0NnXrK|A_lJBLl?ik
zIA5Vnt@ZH5_z%d+yH!%>3xa6jAk7DsH)~+Q?rA0J(o%Q=o6snZf$x4HxZcb)^+zU_
z`0vjn3L(;<t)4{H3p4-9*0muF100>e#wfZ0Qx?eNQeUZa+E5O1pkG15_$Cemb%nzO
zxeQqeQ2O-&BxNf0)+7%Sc-Iz1L85$fTBMTCci0u1aj@rH<3&t-91xHQ4NZAv$PDG8
zbzFj>y_OW+WTgk6hkMTAuY_s{B>GS5Eh0EdMIXIbhh>L?`W{l4A6`@OJRi5oCXmE+
z=p4>Ib@Z{CkXf}th2Q$3U7o(ej<t9^%KUrgjqfxqT`*<g4Qx&msPooTQlC70aYtnS
z;w=#;;f0Qy8<quKOM%lch@#Zf+iNUzc&{flj*-g`W^|l!15juEO$mv1ZrYBLpTGVG
z!c#w>daVr{XGp1`92*Vr<Tyk2dn{54JSktDzq@Y{&2YYsa;U_ZE%nqwhHtu=izfTK
zPw)HdRp48jQLU-T@tj9FpKluU9>H)4o}>{3d5e=mr;Uu=qfBlV7<KpJyG~wqJC##B
zA@a8T>T{KzCtHCBpGhY0NRXB`xucULuO#A=Jx0&A5M^bP`^jab>bXY$7M|SRUcoL9
zHXDU5xw2H9W)$A;Y>(&Dk4<0`L&+*EbhCua2uE*>_Iz#A_9_{mvamUeg02CGEK7Y*
zZCBZWpsHSRNeL#euy9!w)CbHyjcrj8E=UbE4}wyRHlu>W-Q$(lznY>-)~n|<4DW`?
zUTeLXL20Fj#pS84dp6Oe7}7G6vK2S=@_y3hK3<b?@>c5!y0Z*j-{g7iHDBruJ+X<@
zC||GV$0dnO+yF5u3Ihz}hKV~O19wA8GTSrChwh8>u_-kf`hM!l^Df<;3&m);sn5hq
z%#&p%RX%yJ8@ZD`^V#BzBDY;fc4lUI*HYz0Se~4K3{A4w_yPs!u|_Kl#8*evTll=(
zO3Xs^wp<Mix@zif=P`MukUY8VX{f|J4$ac{bBouxX@Dw5QIHL=D3mldttYl_pXg<O
ze|f`jHcvTZ#RvuObZL?)GF;pigjYcu#j&~ew{0KaQAaj2^cm~sBv184U@jeJ>Uui%
z5!{t9B~#@~V3!lnH1ysCyw$8P%?_zc+w9}DX~m=R4vbP$)tSFfekYGaij1780D_@!
zhWO|J{ArajVUrKc5)|ZG^UYb5Mr0zsVQPz0&tBeeIUVb=yZJ{^yD3kGEr5pPdnc~K
zxE_(GDc%j0;)#fNQ8{7d+imABw<cJptf#~5;ie8~fCaQHRU&>&SWulw<h22Sh>3w+
z-h1)qHRPN~7NeI(?yYv1$0#B-2XgHurZ;Y^OaO*OQPtDa3;nG!gaKfGGYX6j)Tza(
zZrSnK5kMW0#N)57i*f*S$SujEkNq*@GHA^kvqP@j*+logs<N6G14%a@GqVBzl(9a9
zdy|X@qbQu{1o%EMK*pYxk&(bVQ7uMqi@0Mf7K1{<Y5~q)fAgJq2q@|Wq}rYXOP~Rr
z@#9}2s|7@sFD*Qmenji9qcHyXhl=CjNWaxO(8aI<9}3i*|D5lDg!|;T=F}xbVqaLn
zX^;@s;x{V6+1#<plaZIVKm*V@nJ_<5L-MU5-2vym^O%fsIC@H;?oXce?w<zqCX2IL
z6B3JSh|DL3=~qojNrx?XnZ#X}hXbd3Xt+goEQu0E9M)sP1r&}yRy~F`H3c}ubDs%q
z;IQrc-IbFABrF#NXC7t%k^<{!6q%OqIQnx|QGUBeWFb~xC=Qk0rc1G8+YM;?3>arQ
z#x2_qkZMlZq>GQ1pP=J-f*9+?6jnnF3g$T!Nz6T4=Z9)#LtOzy+Kya<f>$$lJQ|&o
zBK2)W<)2w<TY<1@-FUE*3JdxY=lw(X{{3CLWMGg0L-lybg7_O68knAu-tQBox0_4z
z?s<+U)lfFO3vHso^ogrwsqogj9m1xS`XIHWN6%T|I;I78r{2(3a{AIR)~(wnJsDGX
z%sNTgtsB-DSa|tdhQRS1yu|>9e+BK5NkoMM>bHoA>EWUA#|P}OU`3Vm6P63;5rp#k
z%fw!mg_HvxdnCwPEi1Hu!hkH~HyLWJw?HxE6srv!3yL%?=412T!0%~6`E<-rEO_<C
z7iIyiu9ycjy;}@z9bHU3onfA;83dQE!}=<yw{X!iG3n!)+8(7(@&gjcOWWKkj}P7r
zaU)Xu*ufl--o*X;4fJu}g^$crptQ`<u>mGeg%<S(g+bWn&Sx5`uy^+vyl8*sL{=EJ
zf@6<%lv~AAc>}Ma5Gb7{mq~cF9JledwYQudDnNIco=FhWPH$sEZL9&uZ}o<r9yqGX
zhl}HkfV%h?i_CZ$^>lYTOoHprUwFrGPaJ@4WWFoUByB1ilBcW5eRC0W@(0+Y2iBWC
zQv}=?#?{OYGy9}@T_}<c6L)|T5vBy~vlX><Gw{qN9sVC!3Y_s3`5L+`A^QLyB=aV7
z+u(*}lou3ozZxd8+f){Lzz-Q%g{}MB&bXm96Y>1U9rnjdZS1SRFn{FE^mopG0b8dE
z**dCl?p3R7%hS$N&t0v1iZikuk!ij?vZEhnkilIQ>sE&EQPUso?UnM9j<95%aNFp?
z1{~V?E*J}vn`e!%wqae8VpibF=ns0K_F-ig)DFy>I)6Np8{wI-=ib;$^~z!PIho9c
z$idR*qL1jRbgrN5Vuj;m?v$V)`P<ui$7ZVn<p20;aHYX@yp>NtlF!zRYw7)GEm|kc
zSpsB|wM4zQ*2gF+Wfe(G0-~ZgS%|U~yr)QtPqK=Zc$?;?rrz`cZchtm!=eX<dgI0G
z3;Cj2H<vHzq)I>9=}&#@#mPa%&I+DW^tCfIhhAwWEUL&Q&ps*4diBccCICVGsr&Am
zuU$lku@U!NGV)g7s8MhI4(dax=E}z5gwY&ZaBdXiGiRAqhCnh<wY4!-b2+^&7g`oh
zuv-vqZ^~!)zK;NQ%RzIkN}C~!q>yVd`7OgNuic|+WAY8I9}a+hdHPv)0JLLFb#)hM
z0U6E+SRaYUoVAmHW0qtFxN`^SUlhYwo}JLq#4`v{>e0vBoC+|)X$uVz9nX7Uy9%15
zZ<AD*oldS-*MLK=_J`qxGDtg9cwXwB;^&BLS@EZUh>j6Yy>rq=kR_af`E^edx0Q#0
z@cQC17F%y&a58F*72Ws|8vp_^<z}2VJ+Nc2;#Qz-69R3a8J4FI^NWmNc?}KjdI%<-
zH%?9{5S{DXZh}FlfEH5L`9giCd`eVQxhOw>@d|V;N^Rk9D9+#l)rWLd4v13RgkZE4
z1EvGVf!{O>HGu&NdTjngcuo${cvLhWyBq&=fIcfPVmrQmbsmGiPl>nih0`5^&w{(H
zeaFxGXk{5cRzTOtrhW?_F~E2lfJ6LDnWdbOkr4%j1=FUuxlKff%gO7|Bz?aaeY#A9
zD^C0ph_EgCn?W8@J6AXXhx8nW9M{pueLa1B?9z3{2SSEC21v15>9kg!_szW?T$1IM
zPSzSY4RCD1Qch}{YdpHtpj8jlN1j1Py4b!ef8-L%1S$w7wkahVs=#|oFd(~5o2PF#
zpECyf=z0bQ>wVBqumF%xkd|Rp!4bNASI{Qw8lqK&`Jlm1h^n(Vli+{?lSF^#@nvu<
zC{b^Ph*WIZxn{=~?VW|k<J&=2ocSlmO`)TLiZg|6{lX}ytD4Z+$P*{zC0@0juU^S^
z>;t9etF4OIl<05#HZ?`7dr)RiBn9d2g$y;oBCtgA=~(g6yQrF&nAk#-)?|RKmf$!o
zVYjJxc;QF*wwWsv%zQGfQ=g){2YQ<U;4z#BYOqGFyV|=i0%k>ybjMLsog0FJjtR;B
zKuOtt4r%Kif$Nb*wSvZAJg3zG$aT^XT~RNVkQUGZCrPWO%ST9PV=wLf3+X0cB_X*v
z#hvXsIQ{eD<D-fmASZMd0^USshpF#O8|2fz4nk5$e)lPIkNa-N)3JMbH|0nx6KVRZ
z?|M5*fwZkGIHBIrRs?aMq*0EkoC1~lkGb%G5@BB)Q_v`eIq!${(fp1p3Uk7>MA(Xr
zz-f#hvF(A_!U;zL=z~t-?sS^59YgbJe5S{Vpv+l3P}pG^UN!yAK@zs^X&VxP&05>I
zvk|9B!h(1zVp9>QG7c7nxS_W9V!fl~v+svX4J0sIzii=v5CL}QW;EpYt3xzdMJAJ!
zfG^`;t`-aFjr|pG-3dF~6+V~|U%h6ELfMP_{4+|HpJQ4Y6Qx^v;4pmlYZh^F53J=v
z#93sT!^DT?ZQ8pJw74`8rMy6p4$2<~SUWm!-D)uHE_ccBEPd@w6oi22&|Ea+iq;ys
z(7hWI;O&G<*o0wWN<0`?n;PD{xq2S8?Ep*Ib0#(C9SFYcKcME%0CKRm0c5D@aqnA4
zMvF(CpjKO1URDrBA$u6pDMVbVY{)7SjqnIAGB-vyesc~3*DfljFqvRxDyrvyu{B6}
z@oT5}eTI%?&7lx;A}r|ThnjqCuK0!A%EiwV&15;Ltk<tg^PnQX1_fY`VoM?jeXpEC
zH~yrdWmJ&#O90O4b->?O_00TNC@xdd(fryuPhrgeGSRttc4~@T|MeRqyyxKfe#ERc
ziAM{1XH3V@V1wtmiio&{w7}6ysf1P+C;czw==x=_3h31VgTWCbjirU8V{))lj2_nm
z;JJ2aZtYTK8Kf&EN#J0?9s8vW@?OU=Ye#qos<3Tq9YQ_v&i%QiF!501lsB-3(xF{S
z`j&A`d9r-g+nl8us&v*$&_Pp%M89ij*bG86XA4k6k!WOV(xIp}Sz~T2mmJ^*aefM-
zRV&dla{JXk9WJLD+?grjM$PigczlQ0>+&zV22V6S5TOdr+-E|yTZ*}yiXQp4jJj*;
zKEm@!73RS6$hWEX1|??wmSdticj1q*2}nTyZ~M}e#m4M!F2Mh`i}?Td8+*gLAiPe3
z&}q+NbBQHHR2d`;Ib~blgIKboS1l`eM#w^MWhxP9N_Gmp9#FjbdV@ORd*`GF?cK@1
zAX0XKSe1dF*Z2G*RJkraw4>ikA)t6zW{<5sScy$4KlXksJ{k(Nop+!>&>t12@lv-L
z#N_(<Ct9+KG<d3nCe)xF^#{ObhFiD*^aM`Z&h)i+3-VS8On|3GfI_SO0Et;+Llor*
zJ^-G?$~2j-u+BH&HBh(<Xe&#pLGJptO@9fJDm$S-@Q$1+e;ktKI}~&3S~XHVxPz(<
zIbQ9?wzx8w$-LQfWPViT+fmz@d4uom-IJi;VFcZr7F#<zKl^dO^d_Kz|4qYC$zo9j
zB@KzIGRdFP3+|pwCa;Q%J$zU~jIxW&CZ?zT5K~qa6eU@m=QA{hYoy(#VX)&e(gG}Q
z@9+Qe<y`6G1MD(RgE;_>Y%B;#fb~x%l%ynxX@a;MIM#@@;qqW_T8+5QLLNK??Jd7F
zFlfmg^X5fbV{9Sj9eH}lu>lc%*j&XVxPv7+YMBJeUb=>ca`sS?JJ{G{Foz74VN>$k
zn?dtCb*RDJ(-Wf$4we$;EGb8J2BE_ePET;4uJJ0Ko_H?7ZPKxc=kc6qeK~N)!J!$1
z{KN1yAh#KP`6Z)IKUki+r|~o;NQ^}c=M8+yg~TbT3Ut_U;3R-EgaqUj6s)~P@HZ5h
zsjPz86aaJ#h|X=pRhsv%85npIkpk!%#H|&lV9;I_1dCk-`r2eT+{q09?JHs-51HtL
z7>Yqo^9-~g>-J}(A~xKY3kK($ty3tB_&f#HNl++-JnLCQ&WHQ*sAx44a0-2pT8sRK
zu?c}*w>-}&VDK3Mbv~!JT#m<Nj=c2%E3)j5u>tMa5WCrA?Acek8L6qg!&rv^pa!OE
z_}swy4Pb(cR?ngvjlklf&(m*}jTj^i39>TS(s8msg{R;h8yh<SC(IQ<&#TYKfF>|}
zUdeFxkBDsOXILpTwdwJ(vDq@@=>p{w6ESci04L6{4d@W}@v2&=cs!y&icnK1K*%9w
zK<0pRDV;%#jvn)ZhUOIK$0Cp4LHMMlO7c5j9$>l6zrl7RABS=Gz`uioy3dA*-^89t
z2#eaNMWY*!qZ>DY1D_b_FY0vi|15oq6zgRrcKpRgG`JHc+s7i&1*HRItY#*F-e({8
zSS{tbk}S8f4Ah)Z(D5v_F5DD2b;>{hMJCNrW+u{c0qX$6V@ly!1KPjKEITX9ukB95
zZ;jpOPJG{vRjOe%`5M|LmM5?&7$8`Mq$sZc!I4~k<48PJ{+(Ij*y^OqFOz}_yt0d!
zQIm$?AW?mS?i;8diKCWyO|UKg-hk&;LRo#l@s(6m)l%|YW5WVi7W1PZz>wHr0|7OI
z4`oH!+N?=AWBJ(?aEUSPgfk;%AtKOl-^g*!!Z@+YYC%yR32;0I4DbYecQ+{k1>Z14
z0^T>pa{?hd-Gxbpl_v{`4~FOTKn-P7U&sob_Y}Zx1(b_PM>4$h`Ig{enKm99Q2YuI
zI?7tgm8j5CVFCS(_?Wo3{?%^V+|4olDbB|@%C9lrbz{y5)9Q^K>*pO0GeI2<Rd4XW
zfFaJWBO(|pK-N$*6)~JyI3E+Om0rUI`C)+FIMmDApq21g`D}mhm7b#v$^GEI4JPG?
ziI*||gy{fjOr!jrp|2_=tw8y)LY0fs*LK6?MP>ho&nyK911R4w2UKvs=LSfLP66zk
zyEQYgbp;t38cWwo-dImv0*;tCq9$8DTRs(ljSpv^_E)8}wY8-o(3RX=<&r}Ue3v#|
zd2_i<&S@|(fI`AhdT82OCkm@6n{&`f$tmATa&0aP82918{Bl-=e+NlQdnmZUNcwNM
zp;`e8JG?XK^y$;pi(M@NH|u`RdG3Y`-rI;d;>!R0)`-8jg6+RKj_BR)ti(bE<c__G
zDo+Ez?775|aB<6aLj&6iHN&$<A6vque8U_IJr6a5@9@G}BCkK#LOEXUwh1c}p}R-R
z17f$dyxAbc)_bBJiqtpZ;$~P$HQj3{RQ(FHRBReZ)h977)((-U=~eqMlufkhoSO26
z4uXn&bI#M(ge<PR216Mvv^)ET$cZtoV^IVeZm7`G5{_a_S;tW_y1NZwqC^`j>3)}z
z>O1i={w}PCV6?XUjHHRz&;uXnrnwIisKFmE(i`lnkzY=?HP;Z=-kK+FCHM-k&0L&c
zr+Jqn{>lzN0?FL&l-lN@CD3h3iFW&h8zl}qo3-XcW!HrTEomjN;;o0R3Q<U2@bqb2
zC<t5lqU&Wr4=XgwQ?k7~G+dk_-#?<|0ToI@eB{bB45L27H$cN=h4Wgvmg4yIREHVH
z-`UfXv<wHzFSlEUXA|Auiy6zduYk9*paAHau7vnbfGKrBL7S+suzer&b#i&Y<*OyO
z@FYp&;eq&lwO65y5#R^qfG<xy3#fMH!%Nu-2@Cfrx=p{ytu8;;y3Rc_l_yp=-Plp?
zWViU8`P23uU`6%-$MQvIfJFXaKL)lX%;meOhy(YlwQRu=+`!f`%FTNJPE5vD;wuKu
z=(p{l-ac}I&Vf@2%+;mUyZJI?>F!yk*-Ln4513$c814;*LfL5wUQyjFOJx9hSMb_E
zvxOJhyjAVp+ES8|epC9SL&2F#d06DcGBGeH^FgfTmp7(zIS>EUj8mrUZdqy$K+qjY
z&K@j&yIeSv&<y#$Vln{sJPFX9xN+m=&Hh1|W(qhmthqohvW`1DEi22;2hiDPP-pZ4
zC(TgVuGn?8%Q`o<5CiXE)(dN=p={Gw296Q%A?$^&*>@-s?W$K%x~?1@575_4#&<Y9
z8AY=2??{sV3`x>&K$6aeFZ;6V)>U^TNr!J!Q9TgTX&ICPD^U*HnRK2$Fs!o=WrcoJ
zinECxRwUj{onRX#EA9E}=K-2x>i=te>>%~rP6#eGNSOkn)iY1LfuGU=w@f>%m=Ue{
z)R!efOx_Mc;vy&@&%r)k4Tfc)bY~QR)qra$wSRO_f7ajM=M`O#Pt;1MTx=zWiQ~X*
zodU8VNC1A|CfCPhV*nj+fVf^&sg8yI18?<s{0F>sp!q0AouMuN^0D^u4&Z~17Pe{i
z=ouOw2NUuu?cJKt1-$~RwcNN=zB^Ac6Vd}Ekl!XnO|+$B8kZ{f@jig+sSU1civaLV
zF*_ORXXF=Xv|gpYeI_C48ypmO!pc-y`GZfah2{yx!#1+d-h72mXD4Qu0Q?jIxDe3&
zT;CL}?!yK!?|f$<r}8CElaK#p+eCa;5vJqIm-!MJ1d>tLC|3f=g7Zvv2g}kJ9JC~k
zHZAn)f6A!sDvPo8@6zkm)qkq2V9CErukFf=>iK@;jD!dE*|<~?H2`g=IVK4=^Zh%6
znNLQ3yiJ0>G%;LU@4k6yAITrCBdCkroW(R%r}>3udRximN#Ije+Kw;xj<7hyEysew
zy%i*F_5fs;>FDagSx2K*fct$PsQ7lLf7x~TiC~5WJ{S1?UlN)iT66)bWNH~!X4opq
zYsqUL?`93H`Co8=aBuDLJsIVdhG%6buGfO=P~-eMSZWp(t!mUg4F@=@4=eJvT?Ar$
zH!hO>Z=qP1XIJCz5bo>2dKP>A&(b~r&w8f6i`1mo|IKozI{f~E5>o1K|2i4|k2A-~
zNB{LDa!>y2KKxl4|C#mhS<sD|-|$R=8zi7z*nZv#RjkMpJT&!VAn~7fY5<_x8c4}=
z(aY9A&%m0-EpvCc*HptXxf&H`05bToMXL_BGqG6H7&oK+JC!+Xz~S>T?`Aw+diVMH
z3Uuei-xo!7=)-;a;1a-B9eFl!cwe5XE4rxJskhjAd{1lZL48}!{C3mRHu?AmSO=Jl
z7G1B#)XiJo1^@6+^HM4LS~CwfH_hl}QxpX`+|T-L*N8ldcG*?QPJi|ULH|lA;<={X
zYSP|q31K=WPpGZ0Zxe-rR?wl4A%pY#!ObFLlIdakWuNQVW985=!NvT9*_UNjZ~;g-
zL6;J>T+-g{tDEudd<!|pq{1NvIpTVq8|D8PbKiRZ)G7WB-MzupR0@={e+^&Dhyja0
zmrx!ka4n}gatC-(5bW5oIq+Q-6!S)PjU?T@E2>BR)A8Z8BINl}d?G@5p1_(m+5b!b
z+<hQ#_D|9i_z;csmrei28fGCX`ZlVLMG%#sS*N}^lm|Tk@zE_f$D6!`{uF?Oo#zPh
z<<cmu_~_Rts}S?G>$5{Wp-tTa6F*Yp(Qp50K=Wk0d^rN<F6-^xQ%h!Ne?OwY=)U_E
z7iztZp)*~WaI7}fQ{}$dMcBeS<I6xzAVUfd(DR5KiUj^5X06ctXVuNP4%MWDMytO$
zOFJl&c#IT492~X%jyWVl|MlCq>rxv6Np#RJO-osbIP|Ys{ojq?-wA(ce*3IGG-IW=
zo3SvNd${iD8QbivqCV~>i17(-a>6TSb>>%*<_}2FTcHM4{V9o9kK^c^efI{z7)xR9
zJZcJ{b7}Q6aPr>;gL$5&sBhPGbzL?g(e94OpC%bX+x4@hwjrF(B5r#=)o<$VycqZ|
zb;f^tMcmyy4+EKH>JQ9E+&<AMRTmR3S(Bb_Jt#ZPrj!f(W?9tSaV15LNHR8VWp%YV
z4u9d~f`RSKm7FON2WWg4=;%ZN%iZ^Ef@U++tMV3Ae|EtMctI#TBs_P|8E`k1wBH=%
zP?C>Z;f=0ebd%eBf{%0rUcQ;Tdl5JWw?UQ$Y~yMH)SH{x<wXF0zJi)8QhlS{%XSvZ
zWhL;_$jMb`G~4`cR+aWe>bV&>NQ&+?q1pJ#{P96Qq>s>b7e%`6#^d2Xkm_pV$5m+2
zCbiRRQthlv1JZ9xX^tQYME?EP{LqbMWy&;NGI1+#h&pO)T-m>q>9Q^`FYG|%->Qx9
z^!pn<61a~Pf~GwCMFPUvNm&q)I6q%`_~B#GYOfC(DbG)gKRyZF{UbhU>R*^IKByKr
z`7ceqA3`lUnvm`6La}4xMjXOCo`})c2%sW{ccx_vazvW(Oxz_p_Y2w-4!kh1&6a(H
z{e!Y<?uTmykBNrkXoon&BeWdBwosS(qAj6I;ut0lm=+8r0Q7}l;fbz?mah~nO=vHa
zpl=~LrvsFVAsV}1Wg8Y{UTF1>7!I4ry7hNZYJ(LYJV&k(wHYi|2&VP~W$4^Faw?C3
zZLS^64{#u5?d;6#Yy{#ISnE_VM}}4+O@aJ-u}YP+q$o(|9Am$AfdxUwmx;0l@m`?`
z!38hBCg6JYz<PE`!{@-(p^b3%{PSUwKJfJ(t1N5ai1}IF%T>_J)yAZ&rxy?7cM~`2
zp1$GT)YZM&>VfhEGFLNFjd|eh`3^pmzFhv*IZ4?LkS2N@=gxO#Mz%E;VO^bof(cLT
zu$_4UY2&6^#ou|1R)F#Fkwd7zbK>7AGp)_viN*gs@1VL$2gI5`X(5%2!8Xc|+^YY5
z@b>?|k>&pn^cViuJ^+BqPn_1xh$#T}4hgj(VLNjWC91Iz1x7k%FaSVSZ^(ki_h&=j
zlA_hiDACL1!gTjIBPGG^^CNakqm>m3lfH$nzfBVO4>b?62mgkecS1>zc$~q+aVkC$
zphJ!7Ih?p(0^rC%OK@PQosS1ZrH!XbuT>eSD3J`D6+rbkh+;Cbb>#os$3g7o&Pw!`
z|1oF4&PGYzXidX5ez7$EzX|*v%2WOmWV9F|fT_RKjSwGYL_u!T0P4XdsC*<(IKSUm
zbV3i?yy}mcczbc+lnokSs!&Z|<JK5pV7qJ(b^?j&R(4er%Tfvwf7!?S{sa=IgIt5`
zAAwNYqDwI-uR+vLa?A^|@wp=$<h1Mt7Bugv=z10#F$Gg}SXoVVb$}~J!?txea3iRl
zqKm#(p};aXGD1><zBZkW7=<rkN-WZ8jfaFr!s%#k(dtQ*33!}zG4Bk5!7(L1n`*qq
zqQN{mQt@n)dmk2o%$%B}Iy41=07C*lYtNeq<!j?b=@)=5khA9^a`x;)Xe)5`n6Z6k
zi7s1i)i4uuW2cG`-O;bZ^8X^sC>zDVfN=bXYchW@(wYCldjfRAj+XEI3E<(sKlyH7
zNaU%?{&JB@rkc)6%{=T>0pd)p*!t^#1+mL(w&#K?pd!rWJD-n#VJ3VUXBfP?yi4qi
z4-M7TJMi>b=sW<A<8A^j@i8w(`Op^dZ1K`+tq9QuSL|xMC3OA^cuz&C`?VYTf~nMF
zV3&B_ynY=I$z947zGzoqhA<k;vB1Ql_~^od2-5eZqSE3pXDL34Kti0<a{^)F@~+nN
zDN?O|f0#}NX8%d1Q^_c7%FSDq4S&|{UmQp|TmhW}&Do(5?k4HFq(t9RXQ3&L^tOSx
z<wW4T#o&P+(S?O>^s69o@HwB2UM>{p%au0!<00qdf~-<#A(=k;1_;M&-5uIJweyd$
zKV`JUy2}Bvyok;5U>mE#P7Bm#7qzop1UKF7Uwm}1L_p-pGF)6*13TueY=V>;Jdh{l
zL#8EN_Y_JDpu@P=D7E@v>woe9pbx}EP}k`Z7puz5yjy}7qp#(qY5VW^Fvx2MK71JH
zNe`2_0D7tMCbMqyOYDJRl;0k3URRAJMDI?FgbS2I*;qMH+Mhcvr|2mg0*EOu5O%IW
z(`~yj_=Z3$1m|wv-`7jUPhIk5*M)bE7_t#Lh{<md2R)#bN_-n{Q&i!#R)2WF^>9eX
zM;7{RV+I&^wsaq$Xjg=^3_$KO3?4T=u*rkLxH<P2S}v=op#y}_KRb7E{dxWW`tAS0
z9r#P=+V~DCHr4?W6f%i`6pP4mOx1U|9gY{M)T*AVIp3O$&3STN>HU)jU{0=_cO#ia
z$IJhT85m0_w>c-llgPndcL=k24Om^RN{9Okr$*-Z+rEl?J{Y#}+rA9iRyqMW(e*#^
z0N@>4NqMwrOGUN*;|Nd-yb#}X0K+TPz~l}GndBN!V&xbwhl#I`kJM)Ko59QTM5B;;
zn7zIG4R4i+ZY<sb1uao!;8Ha0Vm5wzD)#aN)uV!w9j6jBQ?Od;xY+A1rQ)DZV6nw(
zsZ*n*1Mr-OzOA-=@2^9fs<#0>yuQ~$9PmbtJ*W%kuXnhYTz)2r4|%w{;o3O%^$A)*
z*v4c3P8061GJ+vl5LL4Kyc79t*Tp5DFPv)GcT8(<M?rfDdV<R`%;cIAbp2;OKYgv-
z!OMSM`{Je)RUo=9@r2f0c>B%IyDro{HR9PkhZVNCvVL^uc~g~~+eS=vRwJKdmtfyu
z)P08E8ob1cNY)txD~$o5FwVH;+MtAwTXN7;%@wPQQ7_Mf#>;lq9pwG+!b!{Qs+WNy
z?4BRDHZGXV(stEuEe>9wJki(H#lCIVYNaERFT4}SnW;uB97H!VV0F2}#LL8I=e@bB
zI8@)~g@f~WgYVZ+=X?@z!N+tWqgHO(mtr2a;eEBS#XWUn^@8AN2gJ+6J4}-r!|;i`
z_R@8|P++0Ks>2cSU31)L!t#U(5_gBQiT*b?t)=W^me-+8na=6`Gb-o$X-n{TdkB#(
zUjpndvc;`1K@IH8P^{d}z5xvqnp(`$lJ<~LBSw};_@PB)8tYu@)Z6wHQJW9L>@r7z
zgbF0T{>@oW$|j=6ahKz!!HWf23!=rnW#S%;DgTRJvoq`mcWzW;qVc)M(LW$H2<NZP
zAC4H_N5w}4S6z7U;Rmn=EyLzGn|RvuMVE2Y*J`6S3RF6F{|pkZ%esLn^#vce4%<&%
z6B*Y(UzR&DQBs!sIzb3U%g8o<%8g6L8)=?iTxi&VZai!&Oq5@2HY7WvSb>Pu!Lw<T
zIwgC2nKnWit$8Oq7H^koOHDO+=fM0A{E?8M^l))t*SMeGKTYzl(P`y}xgcejy72q5
zQWDaC>(;`Lk8^#XG(iLu^nTH56E;A2A{Tl!2|U8!aeyRtafkINMKjePXyO1JxZ?}7
zkzNW)9nML>20nxxMftpASxVCv^3Vnr@RTYM%AK0R_Wrxso0?G0mV|uQPl2@`b^UnA
zP!|Y*=AzW9GXm$x(b+|uQgy%b@Jl=^>KhM-WjtZpb5^gmj-w>8h@m2=*4J-<f=1!6
z%STb7>gCqZ;~!x42-jx|nj?>?8=kglf!^$vclc5(cUqMe%)BIMrRPR1?^!Y18p4E&
zdqQ}p+!-&vG@cx(US7vips#zH?w<V1Jkogu4onRYG1|KiqM-ZL$}vDv1=fGkH5h~a
zb%%Vm-JbnQ4Jx=J*e`NeX0D{Y`pPEmB?Vw~B6RLCvc1Qwh~1IPI_BYHRmNBVheu;$
zV*Kh1jRYq&(T#%b-9$EGnIm$t#aIx1DkH6X*0&UZWt}kT-7kpc0JtMFDg^@CfXD;@
zay1ZHN*y~Z#X;0yiAY2~l0I}?xUo3~5PxQ1fX&}osDS~a2uJM*>_b+U0?`Hk8qZr<
z;-j>%%HHf<@P4AsqgBv8`((M~{Qh3a_W@Z?uJcdi!{HuZw^b(9PufV6H6<=qG9Hu9
zA)WA<><nMgKQ>d=Olmo*2TqqU(D-&naXxX&!Ea&%uuWDJ2blk*NQgNo5IYDz7dQ^7
zk=JA9<|MS2Avk{gbjppIurNs8vOqTyc@$xMSaLpn!Yumd_3PKaaaiRYw4M0|F$g17
zmsQ*@qC+vb{~a4}Jd*fEFH7G!Z>qfIa=Brv8!BC61CoMBoBPV^mw67(ectr`Y0WEq
zo#L)T!4<6*yUA4vMya#8^?m#Jn0esT1asX}-$M^S?4oHy@H$BE-{N66ji}c0v5&sm
z0W^8XxWWb&*Ic{?&kgm=m}R0l%a$Gl)XE_;rqZ$9Dm!_SyrqoVutqUwP}UXoS~mfm
zt5#;}Nm0M+Lg|P3m&xih{Vny}wn7L1fRLfe&u!+m^<)(>L8*c1NG19_Eb{0EwoZUW
z*m{ci=<OBGsT9d-C9yggxwRI$zFvyPdoi|^jl08L?K-Q_EhoPe9|d0en{O1Qt6UT8
zbx$#wuU~gQ)#PI;OR?l2M=6~ST&RwRE|AE)!raT=HR;Qzi`tu`-P~D1SfRhGVq-@n
zdzB<dm$Vch*g$(X=jHM<kiRH4UW>tA*98*d;M*~C1)?JHmouo#+=MKs2n()TH4+gQ
znS2zDJEY{+46A4`izWv{hR(O`oA(y`;eMa?ro{U-ovE0J*(%dv1ykZiCC3bzN->r>
zjYIJGNLlk(%TYKw%?>~Q*v-=?Jn_DF!%CyP+r5vX#d8qH$|4_89gD9YR^*EqS~`_G
zV9gjNtCLGjbyyH0T-Hr>04?Ws^C4!ndr)xnR{Px_5s5E^JkIs9hDKGJwz5AKPa11q
zxyllvoYx+JPft%*pxZ%oPLkl+ywrLT9^>QC9052iZ)e+o7AB7YT6qK@Ur4<qcsHvy
zFoP5unDrc#=7#wdXu+DCvWYAz_J%_Xm<j-KOT%d|R_9j@=w3(Kj2|S=u58w68yJ?d
zbUfao8Oy8D+uEwzVkqCjvh)&*#i}GFJD1@<);%o&l4A@I8+_o)%iWG)>-s07WTs7K
zoZt3JzlI5-Z^J_ZLIv&B!t}LpNiR)-Y82mOCHkbW&yegeK#C4E7zOn02be2jPtXC{
zRT5dkbnk?h0NoCB*s(S9+czCdUcp6`aUW6aw`W(a+5E<`v>LPmcH2H>q<fs|K1MM7
z!^!kUa9~rNa|8vM>^yAo`?;Tk#MPEe9m3Ybc!)rNfXM{QK^gJ7MyWc#e&9b{Qtpqm
z>QVhUv!uCMa{`FS-9xP4H16usQ=Sf#Ro72TaV^6s=q(ly4{^9gA-8eTZ(6o{WkHzz
z3O7O<5*uxLw)8Ue%5ZH6^RJ~_VVAO8KmBs9>R=Kd9d;LLnG&yNVq;X4Qc7bNRKu2#
zegOFhyt`R>4Q%aa2xA%!$u-ttHt;0<;Tc$?hG%=6*$)xDj7Mk4jfXamQ=JnZKFA<r
z;D50-2kM}>pgr*1G<gn|0Qd!39g7l3hTN*YuRO=sVE@jUGKv-NrVK|UMvm0;Llgw8
z6~x3mAdbrW4b*7q77WY8s~_(*g*!#&Eraw0m}YbAPpd&q1gtk_`uv|--0&Y<n9G=a
z#fp}wen4P3|6mUm_2P`uvq6<Q7JZ*rj!eN3<&k^sUcBxKR}hJM``niH;hmHFxGs4v
zSaR3bJ>XLJydoiY>7t&d`fm60L4hv<Wey#9SS-<&>%JQ4`dH*y=A_Tm#B4ojNnxee
zh?L?xmti#4TfRBv+7eV^ZBWc8gT8fZaD)(ldJ4G7TLnOta6|?hp)=vn*O1?EJ1l<3
zOBiq@(zJ(bf?C0&WzKOXup(QccBova`#c#M)R5TKqWd%@MM+AT_DDr&NXVAh{rM=C
z;eA0S4Y4IRMh&RM>o6ul=JG0ZtVAO5O@->(r8rC0AaamK&=j+S1h|Sl0@1L58Xtp-
zmB32Q%87}IS2Va8wl~Qept03&x)}hBX;*?O@X&nQe*XMvdpm4wM`VeG@uQ79ij&Vy
zt{81m&&0mjucA!o?d|;@OO#)7S)>_!bUZY}pkMyA@<grs1j!Cj;ITCDV4ZJ<F26}R
za0iH-OX1?xN1k65@N+ufUtu^ayp)`foLu!5vg2NsVPX(NVP`fIVPj=#c&21Pi_ZM3
zJt$p0Hz-;(_&QlsZ74Y6p10IJ;r^Us>bmXm*w~M5Q-;PuM_YEL+z^S^X6NLj)WnXg
zM;i~w0og7;At8aYvAMaLdX4)|c7L%hpPX=fUwMn&&5~*wlwm#n{Nxh}Ny$P+uk&FG
z$_0Z=PvHk_fo`G%T4V$C-|p7?_FR$fTgC?(&<!;Z>bV&1uIz*uLuzhpJm-@%<~-uE
zeuQf$C>5Etf3^luofpO;xbr^rlY69<hKGkenHU(7L6wH*>JE<CxjD?t`<83kVa{SL
zs@dn>yOi6%3+JZdy5F-j5k;%4@#Y%c5Rq!c#k=X?^wv8=|Gv1(FXyZbJd~Z@4-VcM
zxED}A`^LSk52bkLMg{S1Q8kRdc|+TO*55vCVTFLgpEw#F9sPvE-%rPVgZFi0dzwfB
zXy{Ht0lO-7xlOC=bbJFP?W#a!2HfaFU}?9}wn-)p6ug}yS-I(B%2$2kDp=Nj1<}xk
z1hEb-Y%vV%nLf_W?*CfOIliIFvRW1RtbRNV`O3RRK%J;TP)$vZ;;@IQWV(j-N@haK
zqno)aH_8o7<Hsuv(hb|*W(mEp?f9|({V}QsD&~4|ma!jW`CV!o8#TGiDDOQMyDle;
zzcu!lQ7S<7Z7Ig!kJO7Ccl)%5tCAOIS~Z{711GDZcfRL0Z;SCz_f^?_UqE*Ve~vIc
zZTIpbO8;$>VIa(+@%IUh^e85^wENME)ahq-caV`;&gVDF<pK_Xe3nw{`?IvFO-ma6
za{P67l=Yg($Ior88JG06-RkS30*+9qsJ`ivbC=fCc|keZn*}TOPEKzfVZ_OE)E}Ed
z&4#*x^YG5!+Lh>Dp=20YZUMqOkBjN-(v8C-BL_?c4!6^|f+`v(?e5)-76z+?`T6-z
zaOkJB*=@;XDVvZLX%N*VVFDAV#@~p$qNU|<GL~dW5u33pD{1t62iedF!L7`A%PV;c
zU18aUVS0AGBr)`C?#dAp;am;3{;X@+6L^g$4yKQBIBoJ9)6kJzBKbvxcyZfbZ(g4H
zYF;+o?Qa!bzTqo?5{#ubW!HsC5D%8C-uRp|GHNSt7HONVAqp+d4+{#IPu!nhHWY-h
zY@PKD{yw*`u&~1_bn=TOOhlI4&-v3&k49{Y!OfkPFl@-b`52S|{Z?m$S1UTg+!@+8
z4-(*7-&2hnCokJ~1fMN*&$>Bj1iXl;phGHj9pGY#=HugI1WCRJmvJ71G^w)%N;wYp
zv2VV9{aOJ7@?9@=Gjd_g8Hm@p-VWmjnF!hfA#&48g;iaaW5-SrSq63`y#;$ivwCK;
z-F_gXJd>06a3tVC7t#*%6T_n!*<|L+c@@5$Co2jZeH_a#e0PhnjwSNWTkk5rV&81D
z(}JUN^N#v``7Tdpb|IQqMtwMk@Q(R+pEVLk@)Jo3SbP$4e;_x~;@;&lU^@4TcFjA`
zrOfZE?kI2F+QmQ+!3dF?YH6{im=Bfrffyx+iVRrAInbHYOuQP6d-v{LHDBar!mrLT
z(YTv$+Cbtf8C;^if;aly%;GGr1c*>*W|2lCjvSims=>Una=8rJ?7JlW>~AG3!wppM
z#{J@QavN8-I{ohxX%l^{!tJvn-{>=ccKWppM8a{Hfp(Auokg=)QQJ&PSFi!*8K_DR
zoGZI3U|b5f<`63FrI~v8tfml2u&ukuHkX=%fy+<k{+HG?A~!epfl=~Phwr*EV-Q|%
z81`@8%w7Sdpexxw^G=Hjn@#l;b$XlFbWjW9KD)bHS&e!=>wDGa({n;JIi?|}&-yZU
z^w{8cF1Qg6fuMIYv(gH}p`76Hk=qMk6?R4ZD7unSfF|D3V6}o(+F_cOg@c3RQ~tEe
zt$p*gX&_-K_`QdLi3xW=rF8$=8#uJIBf`TsHTuWemwbGEDbM&gj_l>?rTTT)OD)cF
zu0`!W)45J~;i%f$+A*AayTR(IqH^HmmOeNfRw>Ys-@?emR8uM^PzC}JTM{h_OQk{$
z0T?KKt_jM+Y_nM>1Rv4p_(V7|arz?hHBWK_wA&Kw3OEYWlF>yv1J(PSKqu0~X=5Ut
z!iMLkMLKgXVGD1H7A^ga`?^o*8N`{$Dk%8XAqqZPrXk3#SpzCpb2F*S4l_xcy(O6j
zYmkY{cvoc}98!lnOMw5tUeszhtM|$_r_73vlV$ENmSJ2;sW&~BpK{&W53ufI|2~-)
z|3YER|IPqYrA$M<bP5uksbJ{V-zv^hkI15JBZVuA%Uxl=<7KMX?S8I-|GpFZd@jLK
zRaJGazCmL|dh~5-YN|V2U5sVdMrM;-X32`1p-6>0?iA{ob)a5o7<}8BMwF&H0L&xi
z>|@T>c^x4@Ky9MPdDgD2t)U49>phVp{$h13!`eZQ0~7YYw^{#Ga&CiOyiR-&M<$aw
z9o^4>(Zk36?>RrRm?=t1F2{Y0NTwVJ*ekZ@7uURcoaKm6!)F+^qZ~w6P7;D>G`c7$
zjQ0{9$|roe?ynGN2ovIUxiF@rX=QM<K<F{7e_CJwR5KW}tK4~6^i`Np1?Qnrtjjfl
z!?U31?9dMZkYeMZHuEjmqsS-AW3mTg3^C}~;16h&;w%l0^7Heje;!%P=DJ_QixH}N
zw&Lt=TR@LvL-!hhok<d=!`a2fMR{I4aR2*V8eY@9v9w;)rr@-oU4=H9)ys*m{K+eg
zz4xNU*1d;iSS?5;Pro;s(yqzG#AMdiSgfI+G7zVoi%>P);w+s#JXX~RZ-PiArJ~QP
zZ2kF<CwIhpv42?vQ7m%9$YMR=0-ZUJsA%lK(~SM^tML36Qs#H+@~;%9FgA<`yG<xv
z!%DVL<uV?7ppv>++Dgl;;kz~zirIbQzSF{|PoJ>ggLN|`<)o!aki~=s(xNC6)uQ*E
zy1-~a2aQI1UT<Y&WL$l)-+>xJl>bMNtw?`Ea&JZPo9yic4U<n`t^Oiy7`9GdRHPSK
zYj6s$e4S$-SMOEGYWm7tt@S7}Ul&<eS;=D$A3hvjih4u|IXo>K?XcxYn**8~=~|ka
zewh#Y;5SVRuKUVVvpYsr=mw~o;Tfo&J#!|1oN)cSVFqpT-BtaW_7X__l)y12;<0$Z
z4lnwryOo$KeeCR}cT6rHu!e17C|nE6ApIjt3$>E!U3)3j<JU*`4z5EapHRzSvf8w%
z1Eo<_g7S{#l@<Ri9m9sr&oO4Ti2)xfx<7pQKwfl^o#pYz!D=X*IJXIb2^?Sc$vkiq
zPT9RmrMF5V;plqXC%2w&+WJ=<mCqHNk$XNOp`;YxiNR1re+FO19P3m&jq{||qZS3{
z8MEAeh*w71v?KX%kYN5nhl>|=&Zp85*2Z1|c09ElPxcukGI6r7tnG2K2T7kLmoYVL
zp_~`&9gR0V+_@m{II$mG;5$1Yk8mCo)3vogRCxpgsS$zs?@|g1zih?pD0)TXbs(73
zl5dIVEwvu%q(vmGpXG_xt)*^lZSk@`zm6!3{IB>gbA;{I@zQ2Lx1R@fw{oX%accN8
z-XzP$!P|0Wz3n{)a)g<~n5cVq+Xz$fvZ6(YgG`?j{oL?a%5CP=yz67Pig0MS6887>
zAbf<69UlvHMV&7)9qglB=&aG+dz$k7yuvHwLW@39!G|z>nD4jYq@+kKGkb!);+$)?
zlrr_s!T+PVbAM{`%;I<m5DF2gyHqq@Lb<sh5L`e3H54omq{tRcfPi3ItAbpjF>*2F
z0=v$R6aqwuq9j^h7Xt*U5CRAZblajOfQ4{bZb@A*B|(Vcl7!s$1^pv-=9%Zm=gf1?
znKRFv=gjAejbT3;tzgX01%u{>MM*G_AUAw+wTWC{tKyPP1O2z1HgAi6`rgQ!j-Cy&
z$wPKRXV6X9)Nh`CoWAM7)?q_7dY=siIt^R2+@MQS&QHZ)jPlgGBB~c*2O&<#Xoi|A
zCM^s0adK{8O(v4qL5<7r=6e}~b<dPF;{Fj@3|&v-Kp*u)!`l}68BdQ6EoaN@fh8M7
zk~gv(y_^mz1Q~lQWS`0kWMV^m$vo9wl}0~G^OP~1fY2fd^&Lw+r1`Uq2rRF7+N;}M
z`P2K=WYab+RE0-4{Ma@T{83NmG3rqovV5>tgYo&v=AH0^eySqT!Sjg|Jpt!K%@HoP
zlw_Kv>T3y1=sy^9%T7X}m}z-asQ`EsV_p5Kh>6lqd8nVYDTqGgTCip8Y`ypL<Bqb8
zu-Tv0SG)<!E*#~p2(@_;p))h<TlYj;j1=gp+w#7uHDHnQJ1~7mX@EA>r=+%6nmD%-
zB~$KO1Tn7B_`_{yzz7_CDRQ;`&jn1_#4VAyu8s*6lmvtNR9ZI`9Js-z#5bhSPSc1^
znM9=LKMTT4rVT^kni5rGbjFs!gitahFOto2y_4ffK4GHVcl?RG-BUZAP}Mj7L!NRT
z&$cC(ICfFWCATzOv4fkSS`x0++poU^>E$#=<=|!dHD6!xxcN`2h+&=a7}xz;g=3=`
zE87E%^_y?!NdE{DK#?#CI&|=Nz(TWbiE`%`WcLNA(6XNa;#sjK6w*~B!D}PLEdR}v
z0aw;8SN?573qmPmHtV}#;P7&Bq-=&X+~uEU?%sTDjZ^CfH*Q@>Rz=E0l0+mXZ2luM
z)3K{@^rVLBd-Z;#Zr8y0Oq5+u+xH=6<fZcLT=pAW#*zI&-|3c@eu*esF@^L6J@p!B
z9#52}!>0lPXM$B(O3@a{Jm#03T_7I!ab5_Q?*WW`4?oL}L;dRtrxik!IGjx7#4#S5
zTy--6HirDt`5oHN(IU2^RaxLL7CMkrN-8~OxeIJ>S$HH*3ny<Vy+aWb<wGL-zl>x2
zYnv@6PG*EnE3PbEKnEGBVN-&J;WR&>8Z;L@T>ljfWcl$Nr_>Ak;{{MS79WScxB3Uw
zl^SK|J@!nHVM>pcHx+VRNx@&n%oD4lXRIXZZt`SIhW%8df_N<%KIPMTPh!sY5v2s0
z2Vi<_#;D;6Y1nW){ai<Z7k%j=EFH1nZr#=VE#+0W!eaIC`~rJw3lR={``)&dMY|iv
z4B;m~L&Fw-l}mBo6!Mn?5|1PYN=MEtg`7qa;OU<o!i2rWb9S?LJxLAnOK}|<s&lBs
z?+_>lVal?Xbq;@fzLp(9qG_F!0QVC~^ZIA#!kxTY8;nmW(wUU>E>dPC^8_B`%wvDk
z13VB<4tyfssxh{w&Z85x()_Rce^rbx<kzfRny$+{U@?$=`8I1JyyiNov+xm)U)A(i
zgmtbmtL4?#x=anxN)`h+FAHd;K(D;uF4E7p9QK?ECJ?T+__vG*Fo=h8cr~aWw4vb8
zzvuw}#hEPWKwV!YzN>A|YPMryp&tj$Sgn=7S8*DW!5ET0hN@)9=SHH^-?r>^XzZ6$
zE$>_^-z4zjNtwMMi>*2tsk)&v+!YI+G-?Xc*z2#|2NN1*AdLZ|XAfpRxmWL>n=l}H
z5Z1}U4vZ_&|2-csuwCo&<t$~oq>Xx=4JWfUdS_e-gg`LIdGT8n^Qu1UO)-~q*~OS9
zA7NF(Qj~2`D+`@Bxj11I{oaZ$t`fR1v+hTTLYps2mM9OMv?XN9{f#gjtwiA+x<4-#
zO^q$dH$<b4S089|Yq}m$vL(8V+h)0$#2r}t>siQRj*IblkHd<th2<PtRo#q&roK=J
z(?Xo?xbd5e9t5uy`Ye=-noKw(E$ZB7{*+@ntV)khu&WvyQ(}x#Ax%>F?_|W{MaMjU
z!fsV7ISEBTsQ3mWuO|U7mL7?gKY*mfDU=<RA~}S5BI9^h!|Zl23P4q6pt;ut42S3u
zrZ<qr2<V8lY7)y)fL`ODTUqo1B6VKVgv21`-tyKC;~(y~pjhY8BzEgDz`2WVg-yr`
zsIrel`0hE)pSJrPoSQa#)zrz-QF5rYlGg&Z4V}dlj`XRIonk_pErIGEi(AnXlL1_%
z11%OHe)&>b+;fnAnuZj#r-ANHkMP^1=~a*HQ7`P}@x_KS=t2ay;byiMbEC2Q<Mvuf
zeLE&2wiBVBH*WWAKl+8;n<e+!<!)f7pxJtM^!Gz(_+DFsg-QcFP*7z3JySG(PiWv%
zjy~Eav)S3Y_#%dPeaNHmKxt=gqBm7ZV^p9u+ZLX8L-NqD+z-ktABx-i68HbJXY`qE
Z!b2i%ev|e0;?2MF=!jFFH-(=o`XBr*@4x^6

literal 34360
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

diff --git a/reference/ggplot_sir-6.png b/reference/ggplot_sir-6.png
index 3d8f9068b78d0bd2ec9a8b587fa6525009b943ec..2559506f2fcfeea1b926137a732fa8235f67bb7f 100644
GIT binary patch
literal 34360
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

literal 21045
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

diff --git a/reference/ggplot_sir-7.png b/reference/ggplot_sir-7.png
index 3542a22c6eded1c87c17ed541c811542217ca709..40e5918fe9e7e06ffe86acbd31462f5c957524bb 100644
GIT binary patch
literal 21050
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
MmIt!FJ@do=0j635$N&HU

literal 36287
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

diff --git a/reference/ggplot_sir-8.png b/reference/ggplot_sir-8.png
index e30dc90e24a7aaffdbe7037fe106987d9885011c..3542a22c6eded1c87c17ed541c811542217ca709 100644
GIT binary patch
literal 36287
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

literal 45626
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

diff --git a/reference/ggplot_sir-9.png b/reference/ggplot_sir-9.png
index eb21cafb405a6285ecb375efad832528f8801f5f..e30dc90e24a7aaffdbe7037fe106987d9885011c 100644
GIT binary patch
literal 45626
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

literal 46478
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

diff --git a/reference/ggplot_sir.html b/reference/ggplot_sir.html
index 93eb09cd3..b5f25ee58 100644
--- a/reference/ggplot_sir.html
+++ b/reference/ggplot_sir.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -219,14 +219,14 @@
 <span class="r-in"><span>      alpha <span class="op">=</span> <span class="fl">0.25</span></span></span>
 <span class="r-in"><span>    <span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in names(colours_SIR) &lt;- sir_order:</span> 'names' attribute [6] must be the same length as the vector [4]</span>
+<span class="r-plt img"><img src="ggplot_sir-5.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span> <span class="op">&amp;&amp;</span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># you can alter the colours with colour names:</span></span></span>
 <span class="r-in"><span>  <span class="va">example_isolates</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://dplyr.tidyverse.org/reference/select.html" class="external-link">select</a></span><span class="op">(</span><span class="va">AMX</span><span class="op">)</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
 <span class="r-in"><span>    <span class="fu">ggplot_sir</span><span class="op">(</span>colours <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span>SI <span class="op">=</span> <span class="st">"yellow"</span><span class="op">)</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="ggplot_sir-5.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="ggplot_sir-6.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span> <span class="op">&amp;&amp;</span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># but you can also use the built-in colour-blind friendly colours for</span></span></span>
 <span class="r-in"><span>  <span class="co"># your plots, where "S" is green, "I" is yellow and "R" is red:</span></span></span>
@@ -242,7 +242,7 @@
 <span class="r-in"><span>      Value4 <span class="op">=</span> <span class="st">"S"</span>, Value5 <span class="op">=</span> <span class="st">"I"</span>, Value6 <span class="op">=</span> <span class="st">"R"</span></span></span>
 <span class="r-in"><span>    <span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="ggplot_sir-6.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="ggplot_sir-7.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span> <span class="op">&amp;&amp;</span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># resistance of ciprofloxacine per age group</span></span></span>
 <span class="r-in"><span>  <span class="va">example_isolates</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
@@ -260,14 +260,14 @@
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> (`geom_col()`).</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>Removed 6 rows containing missing values or values outside the scale range</span>
 <span class="r-wrn co"><span class="r-pr">#&gt;</span> (`geom_text()`).</span>
-<span class="r-plt img"><img src="ggplot_sir-7.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="ggplot_sir-8.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span> <span class="op">&amp;&amp;</span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># a shorter version which also adjusts data label colours:</span></span></span>
 <span class="r-in"><span>  <span class="va">example_isolates</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
 <span class="r-in"><span>    <span class="fu"><a href="https://dplyr.tidyverse.org/reference/select.html" class="external-link">select</a></span><span class="op">(</span><span class="va">AMX</span>, <span class="va">NIT</span>, <span class="va">FOS</span>, <span class="va">TMP</span>, <span class="va">CIP</span><span class="op">)</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
 <span class="r-in"><span>    <span class="fu">ggplot_sir</span><span class="op">(</span>colours <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-plt img"><img src="ggplot_sir-8.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="ggplot_sir-9.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span> <span class="op">&amp;&amp;</span> <span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://dplyr.tidyverse.org" class="external-link">"dplyr"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="co"># it also supports groups (don't forget to use the group var on `x` or `facet`):</span></span></span>
 <span class="r-in"><span>  <span class="va">example_isolates</span> <span class="op"><a href="https://magrittr.tidyverse.org/reference/pipe.html" class="external-link">%&gt;%</a></span></span></span>
@@ -285,7 +285,7 @@
 <span class="r-in"><span>    <span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
 <span class="r-msg co"><span class="r-pr">#&gt;</span> <span style="color: #0000BB;">ℹ Using column '</span><span style="color: #0000BB; font-weight: bold;">mo</span><span style="color: #0000BB;">' as input for </span><span style="color: #0000BB; background-color: #EEEEEE;">`mo_is_gram_negative()`</span></span>
-<span class="r-plt img"><img src="ggplot_sir-9.png" alt="" width="700" height="433"></span>
+<span class="r-plt img"><img src="ggplot_sir-10.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="co"># }</span></span></span>
 </code></pre></div>
     </div>
diff --git a/reference/guess_ab_col.html b/reference/guess_ab_col.html
index d20b01b6f..f821e4fff 100644
--- a/reference/guess_ab_col.html
+++ b/reference/guess_ab_col.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/index.html b/reference/index.html
index 7b11857df..a980b964c 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/intrinsic_resistant.html b/reference/intrinsic_resistant.html
index e2bf5f0dd..96149848c 100644
--- a/reference/intrinsic_resistant.html
+++ b/reference/intrinsic_resistant.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/italicise_taxonomy.html b/reference/italicise_taxonomy.html
index d500d9617..6cea7a377 100644
--- a/reference/italicise_taxonomy.html
+++ b/reference/italicise_taxonomy.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/join.html b/reference/join.html
index 6558c251f..88b2c4c7a 100644
--- a/reference/join.html
+++ b/reference/join.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/key_antimicrobials.html b/reference/key_antimicrobials.html
index b01dff082..8ef2541f3 100644
--- a/reference/key_antimicrobials.html
+++ b/reference/key_antimicrobials.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/kurtosis.html b/reference/kurtosis.html
index 2779e9de1..53d5ba00b 100644
--- a/reference/kurtosis.html
+++ b/reference/kurtosis.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/like.html b/reference/like.html
index b3217df76..fc861c54a 100644
--- a/reference/like.html
+++ b/reference/like.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mdro.html b/reference/mdro.html
index 5439d97f0..1211fc1f9 100644
--- a/reference/mdro.html
+++ b/reference/mdro.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mean_amr_distance.html b/reference/mean_amr_distance.html
index 583719342..76e75c624 100644
--- a/reference/mean_amr_distance.html
+++ b/reference/mean_amr_distance.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/microorganisms.codes.html b/reference/microorganisms.codes.html
index 631d35665..32ace57b5 100644
--- a/reference/microorganisms.codes.html
+++ b/reference/microorganisms.codes.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/microorganisms.groups.html b/reference/microorganisms.groups.html
index 464bec4c2..4d80f53b2 100644
--- a/reference/microorganisms.groups.html
+++ b/reference/microorganisms.groups.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/microorganisms.html b/reference/microorganisms.html
index e95131374..42d014a05 100644
--- a/reference/microorganisms.html
+++ b/reference/microorganisms.html
@@ -9,7 +9,7 @@ This data set is carefully crafted, yet made 100% reproducible from public and a
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mo_matching_score.html b/reference/mo_matching_score.html
index 0daf9c84d..c4eef7308 100644
--- a/reference/mo_matching_score.html
+++ b/reference/mo_matching_score.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mo_property.html b/reference/mo_property.html
index 5e386e033..292467165 100644
--- a/reference/mo_property.html
+++ b/reference/mo_property.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/mo_source.html b/reference/mo_source.html
index fc0c78b61..083c438da 100644
--- a/reference/mo_source.html
+++ b/reference/mo_source.html
@@ -9,7 +9,7 @@ This is the fastest way to have your organisation (or analysis) specific codes p
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/pca.html b/reference/pca.html
index 5d02e71d6..5dc7e22a1 100644
--- a/reference/pca.html
+++ b/reference/pca.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/plot-14.png b/reference/plot-14.png
index 01f1a573ba16c9d321947edc55b931cf7fbcfc90..28ffdfb4d3a2a6274579706e28dc4efd3317add4 100644
GIT binary patch
literal 95453
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
P0a@zl>gTe~DWM4fN7o{%

literal 93668
zcmc$`cT`i+*DZ>oVga!sNVSA2(u;Jl00E>UB25GWNE0bRIw+u`AfZO85_*$fLQ@0;
z0%+(pQbP?=1B8&fBmUlZ#~b6maliY=eR~WgB!_eM*=O&y=9+WvywTB8WjM)tl7@zc
z0jhRakA~)`7Yz;VljFz0J0o$Q{(v9Ho@l7v1wTRCxq}V>KTbSTGj^k);RvJtI}|yy
zYC}VFnFe}S*}yAlY0Sqr$tIaXA>vcoiZ^bJ#DqrATn@W<_vo+Gtb(u`7sdF~bWb}q
zH`^F%|4=q#8d!R3a&NWqsc~MF+M%x{w`>m^=ib&m(tOP5%e{I&Iuky3EbaY7O)+sI
zo~Rnlsxiznj~PvFTio%Qj&hi-Cy@NRHwekdZd13hbAS8zfAc>U6Tt-<n)ZQk;rg3G
z$AjH=T?$jBoQ4&mj@@paUt03DVhQC{)05|<%ulyPQ_gwt7{oEKNtq7fMrECb%WR@T
zm79mET&MDV6)8N>lfl0~<>+TAp8a>2?=9>h#9B}0ee{*dn_z&iu4dEH@L8;S`6AGi
zG|H?Wg744gv{5n{=81&Ntna*noUG;J6DQSs`u-;KLN9pf>g@RLkHNMI_7l0H?glX*
zwSig0ZU{i@5YDfq7-(o-tDo`s&uBHy>HI!=@JpcBy&&d)@3&t#YX0vfpZ*1}LkF+Z
zG<E-fJousqO&W{2?`re4;LBBl3+%CA<Xs8-pY{_MN6Ce1w4ct^^<m6MaL#T-+jRPu
z?N%_ZMVI;|g2pw5m+I~aWL-f+9d?Xz#-7#SGvmi0FY%5rOE0rt%a+69B-1;0?ilsT
z(9p05a#Al7d^y1m=JvTucYf6GkBqfgx6Io#OC6F2%u~}Esx!YJ6ZYxnD7jHt+V<nn
z*QgNXjNDiVobhH@tcr)nCUbfhb-XTU+S=l;%)1Yh0{l5WI1N(VW&JwStn&F6<g?}H
z-DQ`Q>Qmmzo)YK|WndG!bTiDu({tag_l3?2?EFS4x%DB>f*^SMvY4-@{yhnsw}*xQ
zy^P^MS^Mv$PA1=<!w0W#AwM_%UpQFc?-2DDnwc0G8A)FQPois#k=5PJ6x{DBbud0I
z5fBh@xp!9dAyUtLp}Di$w?BngR;{m~(As#GJD;k3Vj)PRt8Z*e48MMgSgGmXk;i;K
zO>?2C<vknjLg+-3E}nW%Ix^3zN6T7TTHOC0^6qSHwi;~f6|zo_`uypea$ueglujIS
zDC;W2D|Po`bb~emv!o7fh`7lp@D5EekUQ3(AUyw47q4t{qUn#LIO#P6IaJA=aW&%A
z$ti-ghU^ba31U_y*;X(?(Qmgy*OrFnu@P88Q9RlydnKq;)#P+6crct|bBmpcSz5{M
zZV|!iSv^^dWn*L_0|NuQ6<@Zyck5+A_{s#hOQ*pv6R(t|Q>RxTCvPNc*+SaJ?sQqw
z(7ZD<wFWEiZ~O19Ed%)ln%6PO{=4&Z%~PxT+>+I#Aq0=wqbT)^k6UF=+}zfc3Hw4&
zH}1N7dg&+zScM)IVJ)_kr%-?!9%jvdRK7qjj@H4lao<O5<fA;rO_DTuC}l;Arw=-l
z?S8?l^~>F>uA!(HG^LXat7x6N8l|S`L1Yel=w5{ujwus~QbX0$)O49wKeurn&~n3f
z70l1gdHuv_4cYv1MMSs}HO{~JuBxBYI~k>L_29IR9WCF6iVD&<<)dt16}PZa<ZE6;
z0nSJ?a?BaFK1%)x9_fOC0FxT4Eo>z|CN_pe$$zhb03$zuW~mJe%$rr47D~mcAFVcZ
z{)jZ|!!4t2lU!S(NZV%)LQ&w`mgD21O9b>vy%DyKwi4f&2sdB}^)XxNl3N+&%dr_C
z>E{?!qHNyWeUgasf%y4vEe%l=zw?bpsv(d!)Oeza45LHi<0)|)A$PB?dO}?ogVUhc
z@@oOs2RG0-cq^##$H&A(lTosv@|n>J-<`E`T|9pX=y+;@MT0pa_{4c0&8Q7*T5~4H
z`knxNQ^co!=~5KBVGP5=tN@lSwdu4ZeEzh3I%cC>gr0&>gQVCwJMV{;cF8)Z_kMb7
zzdT(2GBS@~b`gz2lSX(M%IneHu_zIGql@zF|4yLH^3}vzQc`ljRt(uXO6KZZdP(s2
z6N*RIS6A=ETeA3<78SWPzh$~!!Dwsp=I&$@Ld9*O7~FlYefmQegWTNQ@zH>Z3MHQC
zwnDS`#Gx62;sD0k@##}_cHci=^Wp@J5l;5@$b>d)p|}kpXx_rYg1>Pt23$S%@yNod
zOp^qK<|nMYj41_)NMoA{K`sv=@Yw~%qvKaiDjbc?u|?eEnv9H@R39H7+$4drM7ROl
zs`&VkRZ?0SCuG06G2g>wT4D|LgpY`oHjd?~oVAize5bCVp<%`oU2Tj2w-mY%t;v%r
zPg*Kv?1YtCNSB877g-eDz4}R$=Ni-mVul?Y^cq8OYp9T6kYp_`N7%Y5S}~NDzUd8&
z2l||71lFg&?4(+@2w^`or~+A6Sz77_ivfXjSLs6xn(K!QeaI}qg~NS)MNUqxmD#~U
zc||`uuac~N^+(-J{h;OTt{77V?RP7~yBH6pMK;PfPA!Ppf$};Ot^ENa9`1Vj`uqC&
z`W5PUq5U<^(gdm*_a17=-M>ADhWMFcllIZ2Fi$_lRLWPj@js!s@`?%q`K|3y377F&
zc$nq3zBpPMsabD}TC6N9`|j=Iv*JnYftV$#X9x|M;W9HbhhSS~&^t^HakI~>J4nJc
zQUYw!&c6CAp^TB9el#?JezD#7*zT3>TG@-?{1?NSY?PFp3l=I&c|#P?%h3f2hJNR}
z&I(h4{GvN%G9{&?B6j@%uxoB)uRUuF9+9>{>{E>ly{wt%)o);)g(zG#sag3<zW2s2
z)s;80Q)*=u6~~a8vlrn?ofv1Oo#|-dF*Drk>})t@$sam3O78r(7K<M)-4Z8Np^mP4
z?IFSEFV%_1!BjZ8xKCOcXlAy^2WaSF!*;Xq+Y-ig^S*jtGG{m%kt4AFdUA~MA~!8K
z_H*+E22xN;N=iMLmp2fe{^!_3EnP#sE+{)VIQ;zetJnZb8dESfG4bglsBm>7#ch+&
z0oq`W+;DPo>Sh!~FBYOJ)ONM5MrFrtNWv*KsH5p^F`cl~)4{)+(v6v$@C3SJ%74oD
z69bkg(zGXejt3LbBzCA+sY8>9ui%1awjgZFZ<z&K^>s{%8RX=+`-xJ1cd?7y_8oCI
zBCAM<+bik2Gl}?z`!mFq>VXL4rKc4c6*Et@>%SEU8O^c3#u#-vzC|UWE!aI0iZ91^
zIEBlC8$*9?WQz(Hs>xmmVK(;)M+JzLy6xg==sTBMz`D;XEF?sk4GeJ!mq=w-`J|wH
zDx5~P#w#i+#=4SC^!44I1gy7xZ5}h*yNexwBwx4xbZk8KT_adI(rPvSs6|U_SvfgI
zS7OlNl~Vu~PRXb$XY|Y?7gAeV#sa8-vf}l%Pv1~I^D9K@%IBx=e7f<dY>s}D*-P4K
zc*9*ZqL|RP&V0H7z7<F-Wwz5=GZn9>18zk{HhDi7#gAA^Y67?i&G#ox2dqlL=(bvA
zY{=q35#<At;T@K2Ax`p?N~~+BtE+><7gt=EjYl%7(4X`29LC#YuM?%NqB1E&=kN;U
zGhQsA2m`6~1Q4P>TdKaBEB&LRs`eL==qU63xo8ZY@t?W$$dqXUv$Ys99MY$bKzdY>
zB&$scgsrWuf~KJdVo1}gIlnEI+1~F@67CO+wr}Czzkh!}$KYv^1@Tny@A>`7W!KKm
zPCD-Bws_Cw^Pv-@-NZ<T3+Zrh(U#M=o@sQ^l9NwTJ{8E?yguv_rLa4f&c&JF_5dr6
zsCR}@#0@M<O_%gW&4vaCZ^GLU+(Q%jXlif=u@jCk#}gQN&b?uD_wZ1tcs|o^s-e+w
z2rLd-MEw;gVSi>)0j#V*^~ZS-C0JG6OJ83@(H?N6v<+~7NHiQd)G)iglekh(B4nj^
zi4P{pxV7~4_BwJ_DLk{3hAZ8OQrln{T_Kzr9v*gPs~Y?D%k`b-1vvNoG8k`MiW($z
zRQ1e}BC~qmosVCM$RSgBfF|}ALbfH6>mVMASB+4Yg3?fH7+8Bczcg#cGuEf&oR^wu
z%X#<bx|_8Dm=DzZ+-PE*W3bSwYdaV|*4d3-_ZL64^~L`uMI0m-i`56$Ks=Iw6Gofz
za&x;*G(D?FCSSD=M&U=v`ws;xtasLC8ZN>7!I?z!ocpn)8l&z8<IHv9;ICR<Osk^q
z=ZD~)`L3L-wHl-*9*3J&3Z4Lu?BD#jd2F#EVKj1=S}lsGdu*;U5;vv~?{v95T>d6)
zJU;Hz_(ods!7w$+@`Wh8#~cAKzND63bN<oG5zw>qX~f6cKg`;Jdjv8M7a|c&&&XvG
zz9&9VNj?t_Z2o$jT9l+=kZl<mMD-eJDnO>;yP@*m!M{~MSOu{C1twWw3c~LJbXQH9
zR$jJelXCP5068Nn;*wnz$wb<5P>0Kg#h{G#CP4cBYtgCfVn0(vEWb?vz!&Td0!rXi
zo<xNUE=7Lw^))dnSbZ#V5`fbo$E`k?r%A6&%Q<m5<#V8JXu&9+_c&%yHorG^>(hOt
zn2oK^LT`?XRH?Ko3mp??ERR|>I5{m#fXeL<4T*_*mS|pWg4cXT{OPx{su|*?Etik)
zQ={Nl5qcaOwMu*_xaEQnA~eV-rFK&!+Ce=5g7ZBn&pZ-Tl$qJ<X(jn4m4q-v*9TO&
z!@xMQ8!tTGA<+2xi1JTMSlCBn3!!*9!3BA%uhbZ$l6;6J&`kIDy?bJ%`6vcme71XX
za<U;o2;61;d{5STQhFM8-kq41DD3v`(@#*H+!F6z4Y_SnW~Yn0C70N__5APK?&gTm
zF`0U5ECGWIo(#49_X?F9uiisC`(5(um`fliq;}>*vGmXY(b5sO>QP2QH9iF&TKc}U
zTM;dq*r|BE4dSGgp-0CgEP8M)ol7iV!~HBlcu4KUuXiU5WpQ`L7zoebgg1y?3|APz
zV)Yb~mZzUrk3bAHau+BEP?F{g^Sj^8+1%&ebXSuM5xWqx$1tZh>*ph*)oyv9MY<9r
z8QtXYRiqJ!*|qt#C$K{6`icyp((>KT=Nt<`6`|&ve-4#8dx<WX9`u8c^JFbc?2GkT
zj*FoahKLK{&9HHg0kZ(khyCN@<Jae1q0Gxpa#TPYgm8XF<f<WUDxcB$&2h!TL)S3V
znPlr@-k)Xd8K{ZS2ztI??zYd-j#n}cm@IHe?>h1K5`o{W-X43W&Jvmm%FYJwXRdHm
z@a63&)HuK?+DDXsA3b$bWqToRL33;?reps;jIOriWpcs8+H~UT(N@(nj0gR^rxL_`
ztshhgYP%mGA(mcbyUL!?(LGM+32`|%fRrPrVqFC1b(b5em&z18pG!{Dj!onVJ#n@=
z=)=jT3k)p9s$70$%6bJ54>(+Dthd)a7wM;kMRPlemZqXfl>mmOqeoh(aj=@C4JiP?
z8y?T|!e(gq`#1iRO&Vj|rFENIQ)1;K-O(HA=k9`B+9<M-FSD{t*s_dIeuBLT?N(Fo
z&w;<`d{l8`!56H4d7a<QcI*%+tipM3dzD#jcR$T$YSix&D&+qC`$m=J<$kbihTi^u
zAy1+!C?EVq4?BaR%uby2M6{x=;ZI6zk>0@C$2w*>{Ko+M=E}VL?pO%sOsHiYS+Wu1
zE?ZajVT2BnET8RX4D#bGQ0?a&(|SVZ3eswZUXK2;VUUkpCRv)aEG=|OH$$bpapzT`
z0SafKvZh$v=3tP;a2X+pZcS2LnqV(ZQ0&84!(1bZu*ZXcr|V~G4zYTG!s}RiWB6G&
z;_g1~J)+(PhMQYnCa={I$I&mkl4Lf^%gga-5)rf115y$mq`v0go1nfS&Wg}8e;iUO
zudK`pj}pBYexIS~3t#gTIV7w)s^AQaG2Y-O9+KL<C>*d84#_DjboREgvbv{)e?2Pq
z`E=l0Df6R>s)s#1JYJ57LpomzoZ1rZ8*w(OT{&U@d!Y)wM%W!L%y9FWjOTwRx#TJ5
zFi>bH6d#Rjj<`8_yvvgN=fD8mxc3qb%^=fJ^LGzfLWeFNhw$^*zYs&#`aU+MnAT`~
z{P>aQ<4_->UT9vDwgV5a4am>Q2+jcVq6OupwV3hb1`{Ovk}kY*Ay{>8VF7DsWX27Z
z-QS+t%+dDC{Y?V%DjQN<uLLmT$i9hBRm-ykU5|m}cFh{QO0)X)<dy8wQvFpgQ;j%5
ze#f7dZbv6z{0)XDTlnAI@58-=0`BsjDwxu<gyfgQIM!Tkz{T7L0r@GEw<}q$G7}&e
zBgEwDb_4Vy4CZ3*<irpjD+&VWmE*zE7ad5XmzS61m9bxhpW9CKn_!kkLNH(a$-7g%
zN<}W9#Uq*APaba^6OM8>r*w97E`8-&Pg|=Z6_ux-EAGOKvr*wBvxV<!9s;I;-Q8Ra
zcnUL8Njy$^xlo|d0I}~fm#ew3=yO}LE|O>WsrI;tLA(e(7dAqfS*#RMza`mmR5GzJ
z(RK)bF#&&iXEFHU@Dv?xSZ?*($hSe1Bfog;HxR5V@BRzc&99rE6esrxyt3T>rsD^=
z$Fdh-H6T#n8OQ>n&l;9hjUM&8e>KXhIg=E?m7oUM-6f?WG<mq#>|5-6GM%C~ey9yx
z=Oq;6i8*XQ<F!UjjG%;_`xH@+h2B1J=U%Imd$;81n?`$c^sn#AsLlh($xJu47XT7q
znY%YWwT!-%`J~gY&-W7Ph7}YP*koERL&x&)T$1?_<d=`9OkDCmKAW?@!zp))S!h(|
zNL5U0d{IqyZdM^l3Tj*T+_L^_iGz~)$k6V`nxte)-Wy})xgdVNGgJmCz+aDAyz_GN
zb4F@&<#xXUrS|DEfK_V3=JX`LYm0n;z7%TgF!xC)u52XgEbKXyXQ*$=mYki|YzF4g
zyY{Lmcd4Uv7q0)X+wAqAgrQ2eB${5K8W!J>0%Cd2($HA3UGoxsWD&hV3#TNYEa;2(
zs5L@_O-I}&!zfad$D$I=(3L3d0%Hly<933ABy&;r8F#MIYGznPk@2(4YFsV{^YL9a
zf*2H+ors*c{s~-`6o!W|$f!M0BXnQ9(Z=Vl<lkk9P|QiDJ+WoCztwlDLDaebeZzHS
z34l}uRsK9N0Hlg@T$!<+#?`2*-0JEVwPjORp8~?-YvX7w!G9;ELL4kJTDLXA3qhLw
zmMWyiN}G`p$4p5;{Duj1ky~LN8-OO|Y?eCLj5-?o3nzkncI!lf@yPKSm;B`%ipQ^S
z?^MpD^70FD5n_A45t$@G+<$yTSjBdxJr)V-PU(+B0?<@Av71peix3O&V$ku)_cBu!
zWSl+JVu_j_8~p`(*hpIUJ+{uZWfICu=QTXr5#;6DHmwn;QfTXi>i~of2A!>C0X1($
z7G_CDoRoxW<(}aNoEx3;8H{>{o<)Sz6)-qo0%ZPpNIQzI6V+K4WSL&pcfcwE<l6{{
z6BzhXJ)_cZacvQFPX#c1gS>6lB^ubz`>B2i04lTVx~HfNbxe5;vU2aULuasb%QS_5
zV9D&FOVmb24N}#wBVUsJ$)*}IB$Cm`^B5H7UHjS<fY$?F^j6#Z)angJ#CVjk+j!oc
zW-Td3Fm^^J;ycPdn*m!Y$u95`Wycrt^hL1}&XFAVg^b46CJHh@G-(|CM~Gk5lUt9=
zf+#R~L`-~qw)dV5J%FLqn&QOT{NT7oH>9;ikzeNx?f9F3{jxgkb^u313kchZg|SQ5
zX`9D_>|grnaK)3qIKyV!v01b<kC#3jFtsdF;xEYg8L8!sutfJt=q0Ea|Mhu1r}t<7
zSuA7XjSf|ICV;|&_z&>ZwFmG$EFDDQ_c*JgzxU=gZDg<1+Zr%7oCkD$V>Yrp6k#4A
zO9wgv;<N$kJ)1P=EP<H{bPG%>3ybUO%n$~KhK2(}LpvGNvJrsYV`E7;@N3JDZ)sOU
zEbU-C;)xi*nRvExz}c04rhwq`hPvpl7gjyN$M~>YWJGn$)QkD;ZY=*7?zLpmioOdN
zGe94Crreoa^^&~japCKsm%}TrMEKpfBTQ|Mt<AVGzt7v~pu>RP82ujP>E}n*-AlfE
zc1iHhbKh7MmQY+AP%CJ@SbS;>f7|=>=g%wiY1wWDHO=A7se<;gkj;&a+R>js8xJVh
z0kxWZ%IscfXlMmB5QFkpN3QTNMf1*`ro8m7m+d8Xzdp-BlDVPXilikoK-J<^*iSIQ
zCccFjZ#HC2d9Z*XGWtTKvRTv?NIv_2DtQ2XCQaVV{ntH1P{jq5A|*Avv(OEX^iol(
z+~lf?imf<mV4*K}{$G-{Sb3@v2U=RKXfShn2}nDO+y(B$j!|+sq6I3egGEEgmqBIz
zY!+$THRw@y_o`^$m_>|xDQX81@xkEw{4==4+~3l5dTFS1=MPxB)HZkuAkl&bwOu>K
zRHX_4W`zK!3h;#_%oBmaseJ@QyReCg31yZgymiVMR+%^?4_7KHE-sb@$01sfLnLk+
zZf;P0Qi?JH)DF&h>xE?uM1?z6-K=`i53nYS(Hjpzn#n>H5d7^_Ra-?7`!|2$|Ix6o
zmpwEd#i>Cmpf##kylr<1dF8rMA%<yL`QT(UHW6oQ`KtDxEZ@?FW7Ybd93A(J1H=<R
zr4<u=44^@36QDn8eqj{AaR&&;H7Mx5_B-n_P}iJR<UyZ8{u4a1B{Y8p22+!|KWPNl
z1@P7*s3D@h#&M`5UbW;s;G3k;U=T%-nx0J8cn?mj!_W8UNvedjbVJLS5%i?2tn3rz
zGiq{~wl{CYs*~LzBTwz^b2_ZWq&0x@)>J?34N5Ze^GCi$ZrQL6qPx1fcDJ@Xp?df4
zcfN9$C8H0P(-oN1v-J@GD>ZaymG80MY&<>19(tREqmXgejtz%#cn<p9Y|*hx-R;eK
zLhA&eVRmk=Hy#CzmQqcor3w5B#Jw}Qp4AFXm~nZZttE?m(`qsCB!;qo++j>F-~2F$
zwqZnW9eK_o#-=~zq!NZDGr@{=g^=LOuc4EG9%2w6sAHpaXBrc9u60@Reev2W5-tb%
zljn^U{n3gJ95kZn+}!;9gn|Uk<Ax^ozae+6*g(K0$Do~+jV-T9B#D1s5l)%hUY(K?
zs+s$27T!?w6I2SIXa<D1ggBZ!9j#qocH|dzqAgupUw&)*Ajg|@($E8!^$@3zz^6wX
zrD;s~mKDjDz^xHy&8_fjc=+QSkPRMUbHFNbiE{5C^i!V}81y)G?*=q4V28S?ZxAIr
zfN08PT<L5^u6L&M*-FIi&3YjGxuHl+m>W;D41`Mc0vv1MO4J5qeqCi&R+a*l+5<CV
zq}=Lbs1l&c&r?Id+EQuvxIj*ILmgnXd_|~#x8v)dw~Ons5kmsZ#W6s9=HcW*VxAd_
zoM*z#l`2*DS(MoC#S-Ji^!eGn=RP&<hJu)$K^0L4!0k&(N}4&qq@l8R(ENW+3lLIx
z=Tn?UD(Wf=3JNZB5fhF1a<a~hd?Va2udRZoEfZvyzBGAt>FNNrPx_}PQ87aF!Xw#a
zPCMCu&`Hi>;FV<pRT8^lTJ_8p4KNZ;NiGHHImaPXr#dTCY39T3RIeauv)JI9=HK60
z87}~cEox-Hpy8-}3eHa`1UUL*C19#XQ~JTPXq?*tWuJMTj}Oc4o0IZ{Lf%EUEjKy)
z`K|2IPqo&kWv9gn-jR?tr-21R;H^wHbgJq0Gjg%CqD75608R>+ui?QC;2~g^q5+0v
zq%W^cPoLsh<|FLaf~fFj5=6^etL_xbeIFl#b^On!)b>5L=Vne=*P|If{^JE$OQ|Ya
zG*_Tl5r)m8PH(gA_qIArZ{<vQRLIVJ)4nJJ<a#SkfWMyDruunWNhOl)&K#*UFfvjq
z1#6WP`cV$<eBaQpuQ=~PK}`$BoYx+W;$k$1>$nn4q1V~i*zjB3V_?w-UY#@d+i&GI
zlbgOh0734T+I9w8p)ykWoWx?%H9e=;%)Wk~*pi-?fHqw}4i=U!$SP+S=jY!58Lb=8
z@;jP5>36RdyCKmXp1v9m8fT8U7}xv082IfWCo3EAD`K(`Qs+nB-5jASQhN9wQf`tO
zr~}(8{W|vsIyP^#nXyjhZSb^lBLixEHg_5x*BdOo5BqxM8taOaY^|LoI2Mv=*T`2^
zSy|*pv>GM%z_v7?Cfp&2l;|=|EZtKF2S!#ESE-*7*9oV0&WB#HU;>QTAl>Y4KI-w0
zNkW&F9Gg+x)${F%i7uCPDLR|`y*uaM#)9lF0@4I1a<^hoMVl0Q6M@*>^zZC0U@<n&
z3N0F^6PI911Rbs6{Z_Zrobb^C;R`aX?GLs58glgRoBLE}uW4oG5){edsBR`nY9eI0
zM%DNOPnOM4gcA7X11&Ft^0@gl{{v2g&^M)VPFSIVp+UB2v$^qhA8i_%x382+z_o52
z{a7|L<TNb$zW+<}WJS4}tB&&Fd7MgBdl@D=z~4~!8#w5%P<@NL1fGw9dRsqCHbe9p
zyE(3;zGXSVbTw<c;%w3Rr>3IR(;XbyEY{=Ew8&Sz<OAziy9Z=i5$C4TWJFCJB|6CR
zc&Q|^{NB4GAhrPV0{l(3PI)VrUo;f1f#q~?&1_w8dt~s@fDcYiZ(1p~w2&L(Oz`b3
zi4RAfpb0E~_g6pH`Gk4YG@P<a?AVx6=$+*JVY|GtjLI0%U}3NkqJJq2ZC|#bFVc8k
z>g#ag>LD5tSaUiMrtiomD?Y#)r2|WVl;faC&R-y9X6AQGHo5-#U-8L5n7p~RVwBl4
z&!~!|W3vBE<1h^(KZt8`9%+7mzS1?^$hFEZrNHxvjEoP6iqEs3&!2cM9m!F3!(@G!
zdCkLR@aj<w?7Yj}vy7zQZ?6}=W+>C}^W9X-CF~DP8IBNMjB$pBnN;|1E!5M_n#E}a
zkV?+AT>l8jz^`r5yyC2v{z0b;N0fo`N=tPwVDg=HMj)$z!NcS~1p%oX)*>4E`57^A
z>Qo2}CTHOQP`c6g0N!;;-i@u^q(As87hRX)bCkJ))z9w9ZS^(y=(9L%n|T<mv7C}7
zci!ujmnzPx+~3Gr^T^6f|M5Vuq9gh=P2+yxVPOF*5cB)hyy3kv0%McS;o5O!>Ik5A
zp;=j34`SdhD>NR8K$;B!Xm`;SVvyi2%ki|8w27y>DK6f4<PHioi2YcN2T@u=B8iQ9
zM93*-SRW-tsNF3A?MPbKDSCs{`e1x!cJnS76RO%ebji{H2?$4xe-;RpPEDb)4IgMj
zq%4RKR%e-w|3QfV9dC<klq8r?m!A+yFz4|cgu<7>U!GcZo>21kZVkx;p9CrZ+U8eD
zkG2vy%}d@t7sUftGQl2!UI)c$&ok-gRA}~N<~hX?b{_##+YLvKrF6{rKkHT?${Quk
zffJDEi2Z3koBGUK`Ni5AvX2noE*GUpt`B$={VMku+r*XV$5~&C01RIsnMGgXvB9}F
z-!BzEbgV-Q!-)Yg68H3CkqpE;v<^T*c2rCa0L1bQ`%IKKw6&TP3;5rmxVX55Co>>8
zy#5HX$av|jb|rG?+$J-ePR5`x&u0N`1UNz3&p*Hsfor#dnA6XNT0X#viJM%W|FM6z
zwh7=gMLdCWB}W_k0w#6kul!ypbv$?=VTc$W#RiJUfM0GuKN&&2ah!71Fk<#>gL*Wm
z0BL4k^RtQwz;S-WIs}2EN&yI;>EA@y`)k%`JLSMs%!2^gva=S5cl+{R@~Jcob_yXR
z;P`}ktE$B4Q;fPowVFKf9a~uP-m=4NfYm4_k@E%=xSwcZm{k6Jp8h7Xmk+5X^}P&7
zgZHdL@ayXkLx%LKk%r)v7bs!y9<`+YjCy2Z@-iYKf)T365;~xoOh*zX#yy;UlY8gJ
z@uv<IeMRN^aqg<gAQs#f9VouG;PSWV3@m<mSXh1GmnxSNfYQ*hu`z9FNy+4=u+-=c
zXDDET@Pz$k1A%6vGp*S-B9q~dJp{LQQY814q52BKfMBpi4+vHb%vek>=78MrxcaOI
z@$42D<i-T$Am$9u55RF!vpUskaoPS)b1&dQZ$nQde*9SI?BGDc*uhI&r&^>#EVqBx
z-)kOs9IrKAUS38}4HvXM^BanFJM?Sz&C(Pj&52AiX2Z6+HbJ}Lk}ZOWiBIlIhriB)
zW7^zh^2u83E|Is{w!Qa$k-SgSdTy4ck_ElyK7~P`s+=#T=>UD-(O6QCx%QxLv$bjb
z!B$}PibhsLo2aa&nVDJ523EsL7tdGGnFx^X^XjBo@M5wds^}^G#%y%1`=GLDo7tk&
zEAQ>q{FE2|UIYDn<--1};S-i&92e&uf=q=51_uWdBE-OA14?K(;`#qRwW+vNIBC(l
z5~e~<N-W78TJt+vBuLngMdwzIv%V_MX*c4K88-XmE9xTu_I(2zA5Tx3m7s}&hT(&2
z>xxixkx?~7Kh3mrQHCz!=QCj%Q+|~-ue>}>uBU~4ayT8bG_iqjlYe#VDS7gjBKddM
zJMU7`06rJiLIGV31xtXNDb!Nx_+k52wxpRh>$SBYo9hqq2ZijR`uaV0#nF$j1Kf2m
z2~rz=y$;rLbo4D|4AdaQxYOJU;=@kOl|@MxrhD|aN>rhGofUH8V|3>Gdv?T-HA|TO
zsGlCCa}$veeksH=27)y19|Jx>7K1onMI|$A)&7<gRCw8x<(<CgC{8<nykE*g^(@?u
zhu?%4cf-<gq2&p_0Ak6~0_psK@{%W<=he#p@vB?;%=f;4ZGad##$~b1wlh<_?DOcl
zM%;*nML{UPWc~KmLm@8LWZ%X9f>lQ;2SiNAOuza<xL7yv8n*QF($NH#Q15x>f6b4=
zQ6wa&_g5es3cDzli2qdHGj7Ou#=&PhN1gq%eYT$~zE%*M*k%hO!^(U%gK=uZ8bNTn
zj>0^J$5S=|7VuH5E^~}7ClHDx5kiX%FLZ&q&V=g60Mn4KZIoOMYIY;AIAd)9dk9yP
z)j*{95UMM{yKZ#C@OY0R8A=BaDPKb55z(c3FZ4t=d7EpQgJKYMwEc<9Vt#36PD2_s
zw0bl#NY~z&RP%{_vG-E7dS-kf=ssfPRJ9jj|3vG4m7De=AO&o>>(upJKo6FmZS|Dy
z?gcy>G8gvr-OC#-th)+tt3pbfN$1n)K!9r00jbkQ)Nf=6O9FMd^)rSRB(~QeG6-A@
zUrs6l4j<;wg;Kzsc22cM#zTOv+Y4oN1uOjgDO6@<-`o=12|2xH(as&s&lze-TsT@;
zv%@q68!z);F<F}m^R-2@S!Pd_GhPcl1R^xjv}VUmL0hoO=u^NWtX%ojlQJ13r~82P
zqV0H6iLp;Y(;=H8eB`MJo$&@X0VSi7ePO}s$?AuNKAk(bypCh3#nExj!oB;WONa?h
z-PxMEdMGM?@db{td<AGTy)i^e4468Ke%Xq^r<8E>XJKyc<l-Qyc=(~k-rJBV_wmt3
zeGlp;9sGl)@y6K^n1vl5j{D0#9|NELV7fiNbeKlq_SmWhS9YRD&m|A>NX~%~W+lL1
zxj2zAiQ|CEyx+!g@3BGdcptudqn6U2QC;-V?rqz0x`JUn)~J$Q=QY`B*RA93&g;xu
zautg?jFK0g-~hql#rNmxNsDL*oHFPfmwF8f>n{edUkyL_EhTwtxR1GRziMCj@RI*p
zqe?tsgJiq1#YVf2Ia<zxlN$YnMqJ>l@IIn@h-PpFFkN)@gwPuRCF<HLukMgbr(}kf
zhsQ1$j#Juyc&JxC4NV$$L@n&LaNNXt<gN|1g$zmqxfqCZeAR`8g^AowalOEjRru7|
znNt`_wY5PZ=T04)o%JAg5X(63F3$Abh~|C2h+Ju6F`CAnK-!1Z2K=yTun;NClJiNm
zri*+`Y{*UYxW;_vFfbeBWlj9N7#+c-Wf85|Tk1VAL8|E<UhZR)_~vqdbK|?kun$O6
zXSip9)`$Vd7E{0)%m$5+jRfM*sUY)uMgZJ%6lnXE4Ce6vH$lsL?u{AT)kYxJJMA^&
zAyRgGF2!7L^BD>4n1V9#tW(m@aA{wru+6GK^tHs^Qm8x<vWrD|<?_a!J)*ur8!c}G
zg%cNc7}Z&4@8OrCXf5DPaehO*U^o;36K!F@uzMo328RiiZvoB(;K;nwx#Wi6jE{-m
zs6}xdQ5Lx#tL|4_^{coD<MI8t(TjVO6kef(2?FzJIIU23o3B5hFdHsS)PovgOFHcR
z7m8x!?^uX5>8-@GsD?3*1q<s5qm#v;aL_TOYOVPXi=Uu9l@=GiK%(1(py9g#I<V1v
z+gI^^^Fx~vKTER`L-)@-<`X?d$WN}`sHh`Si=qZ(nG-}fL$jjb42eV9ZC+t4;NhPe
z@d3}XXN1}?)>x17R-CWVl`Vju-iDv8rBUJCFuZ0u#YFCOYEhH=5U<TTp-AnYcA-Ti
z3Vn2<DP-7VEI%W@ZCR|%LRUg6#{`y|ll-Dbm3XrqR2ECp08_HW))@OWbcK8s_gS=+
zI~MFUzSI!*u)+^QVz&nthd^?y58)Vmg-z>d-*lcsWcPlq4oNC{Aoa^eqTdUpQOrg4
zEhc3B(@e(M;NO3Cks3vrRi|if?L2;aj3)g_g&-v?)=2Q9=u9*BS7$|m5)Sbyr1ii%
zDqD>fV(j#HP~0P)<{^9b22uNcZIgGrrh>$HYX9Dvi`{R%k~<yVcFf2d9n7*#sDaTE
zV=VTz3+Q;vMNrGV8y4<o-<gwkCOmNQoV&UVs@ZydY4LUBr?>&1SzCk>x{_Rl9<A$c
zVt2U(3c2R&#PSUjgklB<GdpMdY@@ph`Hi%K!8c&^NW%b!_!n(|v}~S6eSe0<em&2%
z9xH?sV&k24<qvWJ&>wcU2`Wj0`8Ix^=$JK5!qK#D(&ES={GxWPhf@?MkmYW*A=?&h
z$2K+_zabGoL>~ab$vxGSf(0?9#B=t(()*h{;1PF=-lGllt9X%@w>+_%($j_BM@1F-
zG@j5{Sq6N9DH3<Nvc|~$S#<S&xo7|VfeR4e|7i5j^qjq+4XwGl04$Sf@>Czg@E6Ob
zMa<F`l{^Lnct0q=H4vcI<^{ExQY1`ng!|}39K$Lh_WYEeb|3%J+m5H}JGqyTj%1t@
z!&I2*mxA>~W>imzW~7*?jSh)4?_MKU0?9Vufx@<Of2A}9j#U%KeHdBox)Vgx-&p0l
zoBQv~3<7RY04fXYAX+)U@%v|hptPXw_YSweRmr$ZUI`F}?tWvge@5IKu)s0fqyV8#
zpI0;Ci)cGNm~6n=Eug2EiZeAdjHP-$78e&2dFD-_C!4->V*obtS-NG@nwqh6ro$87
zeAYk_9*~F{AmV(#V^ZFTF$zSYEwH%JdSSfCV?N+kqKB$#=xJ+rpMv#sx}rqWi;9ZO
zu}bQCa5ynjolM~folr^`@`74sD7FChDp_d0kGxEW$ro>zM`~tDx07jUL@rQmC_w7&
zR^PS$PeJz}AgB_Y$`;sH<nh4vEbI4v|Iu&qK2QipK4V_CM{8v%U1=MwEB*8-$c^RX
zQ;^-m@){aRSPfx?c3d0wU+zA5!z`!U50upUSTA_D;et#)aI>BPmbHeRP8aiJAXA3l
z1UwOmL#TwhBZb=jkKON7Q;CQaP^gXpMoG2_BNVft0*!_!T+bQ9T;z>zQ@Y1`=HL>1
zwC{f3YwM(H#envbhQ-B5Xk*=><%o!A_Z+lREU1sp+5e-#)97`;v4BhZ|8^|v+E6V{
zptT>;m$-bAD+(fR@<Eelg{`Wzu1?{`{3)REFC)e|k0?i@9Imxft0~Zyh``CBCk{Oi
z;Rn9rD{@N-HOerl>Q~hV9|xA)0kC5hK_IxKN?6kos}X?6Z$D=P(h#+^pVOB}o5n0X
zho=Iv5^$E>rxmw<8v@n5t)i?<6JssLtl=GxG6WoI1N*Y#e~kR;k3Wf`K=A}vY5+8W
z<uEc5Of9T6JRTG<mQ)2OXi7s*5>S`Rp={19N<Rw=3X&T|AIL_^ul<+?#hn(y0Eh_|
zIo)+=BT(lXgXyL1J9+**sAV9~6|Yvgh`kBMfQ0vA-T!R=G5_oYF{WZjUn*IvD3RFd
zKZfCa)Zkxt?#(MP<U5E{lsnYQYRZG!`$$i&&CN|-P%J(BdfQ4(mA$yMJ`XIU6NGx6
zZ#T1_5$bO)&}Z9)xdF2V$MYXo<VNVYeE-Z7{Jmefw!}<D$T{1RzBHZo@yno4Jc&=C
zOgk)*3R@2g9+j&jBmmbgN9QNP{03<Ft{+kEs4E~M9R&~VoS&axtGf5{nQ$JctPQYi
zN2{|R*l=k0<fsz{IGrt~3ApHuBy@vJYPZrbaQVOi8=yrGoONi5tvsg^8cgqOV9Uqa
zZJiCBfI;C*QZk->0|U}ftRu7?ziv$S@V80R(fZ(C2Fl!`&ZXwpK+{SZqWGXusVbL_
z#DaNRtE-m|+1%PHj4l%xzH6mwVPWweRgLKF=_%F4W@qgWcXvh^2=m9pyt}EP>o`)e
zYyhRxpssm8M1=}63kbf#|5@66IWlgu?-qp#?PEABU=jBkOVETGhj7#i<lLJ_PzyI=
zk;WsDk7Nl633>kc{M*(oR7!i>db7cJd2w;1|9=+YG{J_84j`{NomIUZ0?q3A1c@$7
z0n49i4S;7;Hh-*lD^VT;Rj&H1Dyw*x>|(w>!W@C}SnOBO&7m}aBDWM_&dqO<6Il#2
za3qQd#Tqs2_Gv`7O<SE+JxmoSE->)rfX95El&F1Lh(MU+B{y{UMM#ewOm~{l#^dHO
zkM2`e#>_dc96!w1q=R_E4V5_NLD}EC!^Eg)e-bxUatDIDI#hJw2(CbBUqwg@l;@!7
z@PKuO02{F8_h<jwN*Vfqt(>?i%{9Pz@+(U+p%34nZMYkNuppEeBeW5Yp{RAHP)3iU
z6v_?a#kY$G9k2oHm-<s+nsneMYf)`_U`N63P^oPzcMdSd2ZGHNpHMCv!j$Lk(Chl$
z3rAOCmL631kvGR1x`Hiv;@zR$ABXeQQ-Lvv+O7f7ncEiT#_a?q11bU#2e#+myaJMj
z5L9Vy#Z$w?WJKE&efC`f;CKjY6f9?E{j+%J^ERb1(suBaM*P3iqyz4OJ04gW+Gn1J
zB@P`W?27|0Js_T4iCn-UooOK8QJ;|VDNRhD(Jv2W#F(B3J-K$#Txay|K{p1Cz>bwD
zI~SLg*p2jku9!eNS)04p6W-@59el11gu6x-%fgyEA}dC9kn7;x48Y2=T*stdnmDP=
z%=<5zoeViFETS@<o3|3%i*HI98jNEW{nyKrVCY0t-UVz1WZCRy4t=Si6atAn;wpIV
z)Yhm7?8EP_0CLPiB*zR<MvAIk4EEhtEVbFuoB4Oh+;=KH`x4y>HVs&u_lO{OdP5~g
zC@V?3qZD7gaUUd_=k%i_Mulytl;<?w`*f{c(<x!!I)9fDuz7^^lx`RX6R!R9&3xdH
z$~Vm9xKfcCOQ<A>c2|LLR>ei0Q!NhiJaYuNsIfZ)c!LRX&?*v&2)=w=V7nT(GnNlh
zJoO-}YEvx)(5!XXHm4jN9hXE)Ew#Om(cIz(S>oPsnSBo%P#`%YWLx+7k~WSx^{_#@
z`QuEkpQ`*(ptZ9-A$oKZuP$5pG+{(`vsd3^#HkYc7q9@O-U(-hyPWzUAAh!aZ4vdw
zh%@oCZ|8~jz9hbS&A_o$<!BW;<!3%;p5>?6MGW`I(6hY1Bn|`A4=1Z#B~bdy@3Pxt
zs{VXC<<Z6+uZD<_UC5S>45Hv9V|Q6BNW%k9`*IBts7SvhtA?ChR>JkZNw3vr<}9eX
zD(hij3#E3y9agGMr~GFk+ieN=q`ld8Z`rJ=;cy}Zl*0GLA!htgijohUlgrR=C18)7
zjD$qfD90VSnl>4HQpj+j{=#CxgSI2-&AG2D>dM0(nVQ6#oA{6E<P8*L^gnva<mm9I
zS2M=kC9ll6FRy^@^;;9=AkD!ONI^Hn1|`^GQOK1O;%*4)zR!2-$uc;%E}s^p<r;Ej
zCj|tw0+>{u9~WNU=*z_TTb&*geeMzSWCwqXPum*p@RvpsE1vtKnLm%z^I6da-TLh)
zE_V-+<OcUnA%4UmKbR!BHRwG*Vp@PSTY+;<$AO4sCOH2LN=1+1Fwe;DsAKOo7Y7)l
z+!G;veSLLSFzFq3etqZXUGG2iK7rx>$Z7KU?ya`sVkC?a4+>3Xd@u>3*U6Y3EViV%
z8-S>vXHVAtfTpWP7RGKkG`LOIRJ-A|9^^JAszF$R(;n{CRaq}O#UsNU740FhQdD|l
zYHeUl;ks~I+e@A<i`dnlb4E{!2k(L%Q3xd2#opfjeRtFcEAUp4Ugv!dztBVIC%`YL
zA1m;u5V(C6%&ms>jg5_S4T9i6wsLsBSsmH@L|TpY3V&2yWbx<Elk4hCUICkV77FZd
z?rs+|(*%0n>}R^w(%bN2+**dn0p%G{R2@B?)Sl$-u!R662WZpBfG8u@ddd{>)Wdw#
z$!2#lv$Bf=Idtpqr!>`IWe2`<#jYyMaUPcni)ecY#3axH*@0qui-%zuiobOWZ6k0H
z2yO|1)qFWxk)Z3+qk5_R;0hn2L7nyEG7(SMD4Fhyd#3xRS~K(DqaTu28fa+{?jV)M
zfgBr<Hr-a$ubTc#S5fsgYeK19vV9!tbK$NGlxJ+A1;@PdYwN!AddaC!w2p{~7fxY7
zR(fP4w)UW>WQJ>AznH54MXsdQ4(i&P%XIV~ZwAE5OY7@>ZaQ7)@uzVA5vnEC9ga>M
zuYLTzpIh9;{-O82>Xq)iQ&N%xQi5jYBVVjrge&Sjz9vZAJ;)z(%zS^o!K2is*@4*`
zTi|c2yvxL~*La&3{uWgUe`xnKs>dm0rzx`rYIuKaXgp53OGzR|t(IrV5YayD=<uq|
z@6L^JHU^DuIZ?BngPYzJ%d`tD%G64h)x`S2q`EQw9LJ9ouF0Lp7Cpn#Y7gt{^E7L;
zCfjxK$mvH-D{As><G-F?F&P_McJy8kJ{xp*(p9FCbo$g-MZYs5T&i{_<IX9@+Lf1O
z@&^MEs0eBeU#8<n{IBN}=j7NwP*(nWvtj+R+bA^L1fqbf*--znUO4}yY9s=Aed}DO
zG<5fg3-Mr!@J}w0d$hj#y1J_`pl9);)!Oo_ck6I3epVvept411@=IlSTtR|)!q<No
zx!&rCu&--7e-^!1X&6L7*UXIku%@yB#Er9H57D%{3v=qmxX;RRo!zgiP(2YAOi@9B
zf}B3-tzWJ8&&Ok<%jdI^{8btAgC-6R0rfZaksp}OKVpM<`U09HD%J8s&oSFIaeCUG
zJB$it%eaEc$w>vT_cq-iuFGxkDnU~kJSxXL*^o`$eo+t^{Nd_dmZFCJ-C~FS{3wXu
zyoQDB47j>NW4Am&m3@HJizFd|6@CjmQ|5_hUWG^o;Qx?OIzQs#>^$BrLk!b&WE)}N
zQuH;EQ&I}hQAu6baqS)`{w|&DhSLmS+5Rd6e~-KLp+{wX<rvoK`|GnK!`D<J<ojjd
z`H`;2Vsz70oE+j~V%R@`T{Pky9eu4gokwq$U-W7P{u+J!s8;`v{AV{!1>OLaGELj^
z?J?^ykT)VEOHU=a;Y@+q9<w4p$9wo5qGM%9wn9eS_~3!=9#{EuHBU=!x$JQFI%nL*
z?nD@uzYD<jnVy?bC@$F3DYe|9BH`!_LnyeNHyXS4vs<&)L0>Ig-*}9rWM290^uhwW
zhq1YxDT7zEg{fva@0(-g{AZO3qNQv}ZqK_4#7k32$#m5=K+Wml=C}+6`~F_s!8Yyl
zu->e29+OqW#v;lrn?jiogmp=sS&TT7a_WD)00;>Kz1vuA-!8;iU??UBqiDH-GntT5
zY}H!0Djw<PoR><Xqe;7V!7Iw}lg=CkD&Wz@A?>r}D6CJqB>Lq0Nhq$PcPomzSEUU^
zuf)VeHg$D%vE3x;TA3-cXf&8~W^T*r$gWqIx6MypLcnM;$Hc_+ZX@Zcc`t^O;~}=N
z#qHW#HJwOt{N;?3wZJ3d@`tq}rM<mf5Bv&bvnEqNf>rV0QT2;nCeJrT9~c<0XBz|&
z3(<t#7r;R508G;~Y2Cm)kpH|3XhLG88DKvwdGhgs_e01zd-Y9<gvI1f0r{%=PoejZ
zRzg|(llL!big*Ji#ySQ$+ArO$G={8)%zx=k((B+}nfUg()}nfqC~9$?hUN#~?C%hZ
zHQA~ovJX!?PPG_H-W(EyB0R<hP!^1`f4;_-o&ho@y-vl_^*gL_U0#F8rw~77tRmul
z^b*)vJoKe}=6$DzP|`G9i-zXI2*9%WxrK#_`K2}>Gbhfy7(WMP`~1tUQpN7cZ~mmR
z$NT*m;_&z-6=;|B^Wh1{c1C8V5TVU0oIpXnjDgWjYQ$5_pJ%~;Ii;qR@0I%x$%HY=
z{w8wS-T=%Biw-!wV$*tUzsw7`nACY%vtQrooa1WKxfLeMmhUpBB&9^p*M57m-aYvY
zEdLKs2A6uD3aA+qJUWRjBkpIC;9UUNXfFVAYD42*G^ekwUIubB)Tmy<y^?{;(Utdx
z^Qs&eG|-d!;W}r8n`~>G-;5r-v9=QlyhJp|0B=jPD~Y$p`mybGfmnGgDcu?yA%4#f
zp&`^A$@}PZ?1pBGK3Knp!VU}XzO$34(Uc><1>_3Nc86x6WzI>TwN6P(DL%J109W2>
zVgH*Le$uvGd%a<)-G3rv=_LjQPD{&iU;~`1wqx9_H~T`_s}zp|H9WoD!Pg+9Wj$KD
z2;DUEa7A#lZPoQ=TYz*|mVV&oR4{O#3yz%~l7T%X<VQlav?`hIoBj!NgaNsU_7tx%
z?N8yp2F3NBpg_OAX`tSIh^|{{Gh}8uy5csq5>85H1R1wpnNB!6C%~%36@k{k>Mma_
zdX9xR(RDR+huHxMmIlnkBv5C|-8^$#b3;zG(4@q=?NIo|8wkkJ!$CS`W@Ayv@hlC;
z6QKh*&k&9L<P`ZX*O36mXC*zXlY|B-e-VmY=S!sq`5xmBK;^CJ>^w2#_1^Na=!oZc
z_k;mv>~attCrkgZkf0#@R|i2KbD!mMOAtmAAvxLEc4|DSq|oWUd>yjI7Dl61>8pb?
zM*E1y1D;S#zoy`q=QkZ(ls*><iIcYEiyCEk@kt$^$eoF|Q1qQ@d5=K7ef#z$5Eq%Z
z#JgXgy|zD-wCLU|MMLAC2JYzs{V~Qh`IQ$`pj1*);<Owb9DD_~bvu)Yw4hX(J}H3k
zdPu}356JTrO{|=HbTaY-GfT?+%^!s(BNwIu-Psb~cZ<*qrmMP8-sk4$FS)_CWVoj2
z`9SvvDz*|ttxk8gkkHk0(;WDxKmIhBbXE5{3tH%D`G+o7;{2)3J_r<SyE6Yxga`HI
z8O5u=-Jt?tPas$Dg1te~hl6gBnx;R%s2tKQtP6Keaj|Qu8$n5|x?%6WVOS_@3R;z?
z&0}?Dd?Yuxyi$QfnEa~`iFt_;FYSON$Je}wbt7C-TE9$87*dMaYqra9BM5@DTbXZO
zx61?7hu8xgPFYMM2?v~KU<a(lR}pAH94b<Acg_$$I^Y`-b2bI9u#m*IoaBIT55~O^
zn@EO_Bd^VuA~x1Kgu7X!os)`G?cZ}Mc)$FALTWVFW?iY~{cDB2+L<s~{ieSH|KbKn
zNtijedXKhu8r<=M%}aM1E0S~``s}<_K94VIx8|{aAb8PaY<6}8>HpsH_nYPlhHr1z
zcW+Z8sI8v^`qL-N8%4!SIr;g5PEIbstl?IuNGyJsuZzH7KxlrxMvb8P4o={!AsSZu
ziu^YvmDXu!elj2310~-WK4M<iW#|`D{h)aJ$qcyVpQ-c&sBPA*$X&2XK--W8D{X`K
zx_9r$Jnla*@h30!NSB-Q#m;akr{g}WcyX2k4Auyz9?sSo)YuL2Siv+Ol5V}9`?THh
z>fe*m1cdCJ4h+ir{P{@?GFcF~!CIjL(FTi2CW7-Rz^rUb#)Q@9Z8wqzTH?(`#>9(M
z^pr_6z|ob+$jr&oAc>woI8909+1ekuY7j9j=7Gke%k#d_Dee&NWlI=y!jL#f2;S{6
z{CnGhr$czhDa@z5TA{lQTOCO`<1+9&6W?3ry9~K~Umx`MgW*B4`;p`p;NEp#ytLTH
z#%AZ2oy2AP4{iiUXeZ+8olyFnly2Q$VGPtHaEiA}seS!$m@K|tU`SBhNOz7^m08R8
zx9SDzrdMh(`^pEk?rUOHs(pan*dhXiT!6^E8ujBMG*V-i0Jt`P>TZrWN87uU-$|M^
z6iH~&PVxbwYZL|qR;u2E2V3z5;yR|L^4|tT4sQ4s7uZVU*ADh~4%hQk?q2*yW6se5
zf2wv{M~9qLpXmcLv$~=G`h!;X+Bxw|?NoD?$W~@hv-sH<Rg`-!54*y)$~Pc)Y(b4=
zT=5s`nVXwif=I>a7x9YS3f5X){lXvos#_nTthFZJErXv<V(YSH!8!r6HeE#psFfIJ
zCF2zGjEXqj$2<n02r$vMFn#!OjHia=9RTYB{=DSU^rn!B+|W{3XN~oE?Td2%Sx_-m
zyKc<=+VqD3WkBI%?c90LJ5ErZ`##h|qU0Q&K25<j-;WS2rKsPLaQ_72n~B_olOZp<
zqAV>W#2dsfx8B5qjb>7&=Ta@z@~+$ob#!3ll=ng)@2`n=1!A}4+MUtMQqDBKswZX_
ztk^}Lyn1x1_L|DO?T<LzQOuIo-yNNPC-o&7;ib0Sr@v3F(seEw;77T5wNrdUaKO1l
zZGroNXKVlT0pB*QaKqjjEuu@Rbm7@e-!AY@o!OYPx%s#pfXm_buU`v+ZJo|8P&Y^p
zX#Pf7{WQaFU0{!+5ESMajSARJJYL-*L-c`aVV{bl0bKlX1E8)tU<F11e<d*qIX2;j
zI%L)PQSuJ=*fl8d79o*-IK0}Wi6jydbq;S@ihqG8CG(ztkpIv%1eMM`PbT6h)Zn?l
zY@6aG-}T})4UOOFqvqS0_g#td&`6h|l9_zK%-xl(Ff%m;)9=pw;6+*Ke`xLeo4fk<
z_Wa#4SfHRgCAtmB5H+Dt==;<cAACR+yQ1HD!#DKG*enL=rsd!RAPa^1lw)IKGXT`1
z?!b-D>-H18h&BeH1)$}Jy1Jru<$l0rq~Hol!unZT09<yjf^tcCm<gUbSo>nV3>X$F
zx03;AqP9705WE-ln#Xq3FTyF09z1xU<q8nS-;ZQKX`U<9Jm$uIL+JW-xn<x$u-~HM
z4{H0#B}yk;vH<c{N}9E+5kkwf{HdWI<lOuhm&<3id($HoYa|>d4vr1<4?QfrcR`0a
z{f9!gn=$4fu+ePDQCImdJ9i}HWaYt;w^&8!s7@tn+xVZpR4MhpzO;w@Utha4m-Wxn
z2Gld9|N3I4-JB1&LxGwP>%2YeFQ0k6oqTNoY#j9Q0bBmn5Fmw~0x}n+2e0-+w5$3h
zCcm6q4Fp|k!AuaC6{nwn00<#l2cPXf6F%zz1v6cLK#x@LsesrIez8mkjDd9N*De|8
zNidshCqn-RY3~`;^z(fShbAftDhPs92_Vu9(wm|{=mOH4B3+8~UPQ%$l+Zg$01+wD
zdr=XPkO0!FNC^-^C)B_*@mIe8`>cEKo68H9%axG%OlHpPv(G+zuKoxG^acV+GB(&G
zWlCQ$a-bwc7kyQ-qzwa*RV4@!()=PKZf=;Z)g6FEt||oWRr`d5gv5D9V_6*sO((Rf
z?DLLaQQdr>fDuKSjfe920&a^t(^K`}ioFsuP*PSCI^(!^uR_+=bW0R|O!`h+6jM!s
z^Z-pbY*4z+@ab<$NN)k)p|n}RUw;eQ2Lw04M+MHjV4{uR{tN{rm>uAa6-DAk&eG7h
ziC35)<}zf9z(Ey9VtKyKxHm!hmL`E@uWZ^s)(n(FBBnJysZ|w$R=^husw|=*``uPa
zY6rTAso>p7EcoBhJyw41uQTg6;el#SQ6012e1=*S1LhNr7}Y){AOVZRzTdPKymnr3
zD~e54VikK#23b5!WjP1MX7GiWU~0iDB&w@>G+9etdcAFbBvkAIbN+Md@4t(+W_MnA
zrNivCKUCrUEw81QetD;nPbcC|6)!((?MYbsK*4*|T{mi3O<1b|Ns7xoDa=-*d2ndQ
zqc1Lz^>fQMpFe&aAt;zu*lF36C;;5=Lj`apSW+I}hm7o_CJ%n>w{+{@F18Q2v%n}L
zvaa{7e_miY8FiGFnt}thG|moikdj{By1>Jvt(SFJkb#b4cv9o%%Xc_Gl!rY@y9O4i
zlIy?vleRqx$H`xB^RUMiBDb^=@y!$K3;Px2S4dt)%p?r$ap!1<W_N@9wVRrZWxr@w
z@XDNgUrL$Ps!wMGj)<m)DDk>XrtKl(3Hb8(_{Rv%3OrGS*#E92CjK5cz2+dGd4F*j
zHCHVxeWETBYs|ak1d5kqR^{=UuG%4@>r+WQ*w86#3dp7ml%|*`mlvVZ_@R+rk2`ks
z;QgFtSK4S4Yk?*+*x)*YjGkUyY9@c7aX)>ZL*)ea$)Y_-n`#aEixE6@a+7_oWQFw)
zyQs2-GQ3V;CedJUhA9&Y@=MvG_{>63ONMj`gIpR1j?MvV(b}IV_FENiq3>c7uo<(|
z)Z3jyHNsc8Jr!@k5xC{&V*b2`iSoBz3}1n8@<|t}{t}`@rDTzYq^i53G~}N(%zB#g
zQ-<fD9pQ6o@K5QQ-ZgV#&kvqoky!rFmnb$|#>=1Eaqv*#sN$f3%*xvKwV=`8rYq#0
zHx{P~Tk&CjOSSYo@~NW+;K{SG+vPB}fyv|7ImfA8BqFC1WJ8_x9qfTCp-`d@4i6|5
z{H%Xg%<F^fmpm|Ze4SN_{ulGjApXM9GtDd_Y!%3-T~QS@yh6sy&YgmyqkZz`vkt(_
zEsV^j8;6ZPOG$zKIq?|&5YExL689m3Q4Z%@?M2g>ZhzK%q!_I&a$d%|?J9FL00Ciw
zfSJh2b~Kjp%<mEsE%+0ils<ucJ^|a{!TJXC;xm4~+(y>ylqo`TLe;avJQqGIiLN)J
zCV2s5vWoSp$_UJV*tH+y7J!?GQ|Qnv`udvgcv5qB?Q?c&n(Y)1nkSS4tWu>D5Ly;h
zs~baBufrM|u7)DcZ_TZW;r2e;)O|%6Zhvg42(`aK1Ibx?)gnC`(6uV+`GQSIa;ef<
zW8IB_j-m|}#FxG~^`cq0VA{LSwt{>$>I0mvIi*UMG<i~I8<i9<oqOJVt?*-@t(k0L
z$Y_)+rhS-0x}c+eP|V~)jZ!O7I^G`wIUe6Upo&bX<M^5Cy@Sb%=amqz1NpEqW9`On
zI}Kfi;<t?S8-=F*Ebtv(p~P){o%d%Vcoo)bTlm3Bh;@~gucsq^11!!lNSsf+(L_>9
zGWOS(9^kUkf=uuKQrwJmC*nIO(-Z~qt|$2)^evs)gT@Y1f9ji=HH=pcTOKmQ(?lQM
z*#iGepHyUNVl=7@K{F&9*ZjI@{QBAJlW4l8MXS+QFSf-hA~HM=k*>|0j#c1*jnB_3
z!SN8=F`N{nW(tMwWD%W1@iX?BwT_Dq58Gu~>&BDdn{uN%3o)Nvp3pviT>lJM;oz(7
zdeX|EAd8Suc-$F#K6OOLO6=j+=OZTenLAn2(om9P6%|R+peO>j>4>&CjNmx>&D;XB
z?ZiSa!#AP#f&tSbIUTfh5p;%)TOdlB2xA36epc3nk!!PF|2p$6(rp_C!WI50;?^8e
ziBlA{)#xa@Hafk%vZjN57O5r!g_$558yj8l)}ko|_!o$k)6W?=4!}m6=CR+A6_nr!
zZQs0OGiV&t#*QF#Iw`E&#42pa&fO20Zw(Vw8$CXE^*1<Ha(t)!`S9bDO&+i6J!8}2
z8P0Xq<<qG)RW$P8rN_*`@#(j-JeUh>=H^IDN{UYMDg#f)4`@BJhO#pE=N>0SHr;52
zA8irTZq7`XFK5o#Fu?U}Y;2Cvfn<<a3(Y>rHaFwqs6n_T=PrhS;e|@!!@WfHIh~1z
zsh+p17}!hq$~0_CS|hz6VNb5=4OCDJygc_O4CK0yZ8re9wa4ncaYZj)ypT0KI%r7p
zhCzdC8YVMcq}!!yZt6ds3Oymh5uc!>Bs1P~bx{*vr1Acu6D#4?3kjmX`Sp#3nN60r
zm#>(Q8+)PN8jAWieGd{Rj`*ThG{D){VBG)6>K7+AW%Lq{;<aOZhDNve?Zqt6hczKs
zXpSIEhn@%!z<FMI4%>qXoN?tBt8O6bD7d!ZUamG{aZ4k<fh57{6)=s%P)ATp@JtrA
zNb}s97Pe|WY6TOEEkJA^;7S!&GH`_51WnWGC!_Abr=cGt3&%?tvLr<L&@MEtvca<i
z-d}Kpjz8npv@?W9XvZM|Kr;eGi!C8=c7j~B>7QH`82=4(E@`!RBGZKqe`=ivR!E6n
zxrfRPc>k#ryPFu$|M%8(JPXUC63x1_>v^1y<O@QFi38dXXF6_I{Q-&mzBYWtLsO8^
z*+pU}98*S?2a>*V)+DzUA^}!2;nA(JG_smJCDmfu-!6-@xAQ;`ay;z~^kwxQ(>hOj
zXuu5~R%_pa*`ZP-^EFfZo8lt~-1GDEI8%;Uz^6$N5_j+0+Rj&dG6E!D9L!@>4|?$J
z;5T92gQ464H*Qq-)Ey4!>oobcUpAVXo23L!f`BjYjj5$raPjfLb`CVgmvo!md96`?
z=`18n0ea!w1XrQ0eZ`P07Fv*9_w)fX|0)SSj@|*W&;Bf*{5n!oAL{MlmnNUqiIJ`L
zJDDD|g#nBjd>bUJ(-QW{-ZHmhTm*>Cx>CrE6I;H^;LWkpq_wGhj~Ww-&Pwypo$VCM
z)}oyFf}YToKD<6NksYa-aq@C{9|BqbmGhcrK|(O~OB-sEzu;oF@nQxvFh^I52}WWs
zA$6cOTfUm0ugz?rt6PSjqs+om@pPfI-`%~YRlJ)%iUPo2aWC$RqC4R3?t3(wEM!nY
zax%ZdY1k`mtzQ42e|OPy^%wecZ$_ZV2;vnZ>t=&(2$lp@`a#*~2vJjUnCYp>1)eyd
zhfUP20!gh;`dCgrAmJL4-}p|ygOJH&0hAc&M`>5|4iE(W{W<u@{IXZ)A4k%Vf9x^;
zPw?8Ha}59zV2bEe3PMab5gmt90QM98_uewX5u00EG`Qtu*InsL9#N^8y$cKX0E>Py
zV|HZ@3QCY5C+)H~_94+Ao8xXRLU597zBEnJZHgtEJ1;Xe_>)#(0LWsGLl(N80~fIO
zBzM9jD4TmLnd<R^WXlr$S}wriADm0-R1o4$10S0_cZgtZyJIslJl~rKM=2ik#n1u-
z>dON+GJo3c3y3l!tUWts>$s@0((7$Db5L0%a=wsIz|*u~!w69VnfNt6s))9Sc806I
z(dI_Fy1Kn%w3Ouga#%G<?8Ir9bCdsbkgCGyJjOT`zLh(7#&YGFj<>hBcch!-X8YfK
z?2t~lZC4%X2EX}uvG@JVkk8Yn8@0`w3O_Lzy6Wn;Z{EDzO*CIx$Pm!HMFFzx@espv
z>~ec|Va}T{9Vyo1_sDR=-`<GLBU*reGqz+wChH7nrg$bH(`^J4@NSm4wR&91Oo;s*
z*VpZjYSim*dc*X<&#XQBT$Zum0{?!ngFhVJ6%vAFR=aWI#zOk&Ik*R!jZ`Q?OsDo2
zgWl<z*a<u-ruofv#<i@=>enYGCv(hZ1PXg^H9LqO*jiEK85kNS0bx^R^x05emUmgb
z^Jj?$f{ces{aFYW4R!UevP)AU4-5<pQb(DfUDCb|-rl!zRV&<d;2g-Y$TvVL+KUD4
zbbptY*MhQ`)H%q3xb}Z_XaBpLEcS2{`au046S)h$r9O6j$qKO=#}Fs}F=B@hJCIP%
z+TXVMZA_3OzTOSUXEjW(72fVoUkbPY31b6^<=+pgE7t5+<ay`n8`_N2$rEOR2N?Em
z;18sD-hRt;Y>?wzB8RuQ3>V~J<H#VB?SFl*0A^2)-)6!aPxL%@bLjX}au-hqxe3O<
zsCVyPJ1_vQMnrB#`JkIt{HK~oH5&JgKkY(IqjvuO`%IahbSud5*L@D#98IGNq#;<R
z_aS)m$4WI0%8@nD!GcwRSaJ3KGl=NP_FxMU$0B5@#;5xpXHSo}yO2YCo{@{lJg~G3
ziAt3h;vWgfPR;zCA^X0z*3S@nNm`8MohyFHC)1P6JNQ)$3biBm*O4hFvwCYe>;2qO
zgG)P4a7sN&=i4zYVmpMTngX)O3+R~M!h$TB3F%!)p0^E>FTc%j7y+oFlPTjJ#CgGQ
z1jVZnpww^DG#Qy1T#=u@u<B*|R|~je{Q~(M5jxIR$VSt+v_1U+XlhM5<fImLLqd+{
z5u2!$UGSLoe;o!_z5t9Y!b+Qcz0jmTwIDm>AggIomGi=Sf8yUSy!X8d9Hx(-h94+`
z-ZUBY{#W8_I333+c1X@uKy-0y_dfuAu!^oNWuHDd<sut+_^+JHik}2TJV3(i2bqYi
z^(j7}8K}`Xh(y*8%r~f`zcmyosDA?|y*#La%SvsbV5%B75Xggr16#Hou?kiF;mamb
ze;;HqQ!-Jm&9oW0fyh^{*U&TWkAW5^dCdr~a({V?qksg2OZ$C^0EVNJ6yaeRo&roF
zmY}sFTlf05>$Nz*6|P&13=V^2MH0$(-SHi=C4ICJgyfdjuwv3FqQnb@2FKRR2`_oT
zjnoec5!^v1!V7&=VIl4NY>;3bux7A5Pr!)`CJPyT05(yy188@TM}p=btheFmRW<O<
z8udq5c$olZW#Jd2h$ZXV{dEaa&#EVy_@xF{@J*n!QLomz?O9xiU8gu^YXZ35C?gV*
zlM6s8)()UTy^xS*;$DZM<&tkSncZ{b`$AyGV-}2hHc?pvDza%kPhLzvJcR)Ha#Ayh
zrV%_#09Kqh0E)+D8*KH|QC+M#?kLF{A+evzN1r5Q#@M{SknWp|%#D_D+8S;--btBG
zg*t-TLL14QLI=*G7!q^@)QNi|YnsgEk;qt2G)j<<#>02wX~#z+t6=X~Xz*I#v{~J-
zW#Fy-)PkIx-<@ErRbc$FVbw9sO?v$<E=l;p$703^P*5^$@TN=N_V^^PeQ7$GjI$e*
zz}QkuZhsne<l<qEk&L|4m8|pd;X_@$8k$DC>ON`TIM3A$P`9`RbURbb_8DRWTa6yD
z!$c%Mh`My@G8Hv3TvyI9`eoJlx((|@0*lisXU~lWs}5i^OJYjpT09@?NwFsBwR7%0
zs+=Z^Z9oa?G`3XS5OF(HWPY#f5EXO(=8rm^sJttw^>YbBYY~Nn3vlHljS36SvS8kN
z-Rlg7(Jd`KD1KEAn+D9AFA6GgP*8!{?Qo<8{!oI2Mch1Z$13;HR1hLCRq#UY7;St&
z%YgCVtA2s5%v}E@CnqO%x6o<s7`gJ>{YPrhO$1W1=d%aU{01r#Mr_u09*^VqWKQ&#
z-x8`t!dy;zl}`TnTaKrr1d=SsTolK?)BmdBBtCN)1H*RaY-|}1VY+fUrY|8VBlsTf
zu%UEb{VI&6dY_BSNby^BuwjZxNpsB2V&i^&_2}}<;<>KDp&R?=jA~<6{qimcEot*X
zK!ilvNb7Q?5)YzQycm>3uRLMP>>G$*V)g;yUij_ZYcU!!@>kBW3lthrO<m+xIZ{?=
zY3}as7RdCZ(U)`!0!F8$TQD8ofx*FdViiNmWm$s!{L-VtO3asD-&II5V2tUI1a*0a
z!%TZl(m8d*KP3mMCBV;LxB<>i9YMye1VL6o5q|zr%$ghp9BiB*I1IWJsdzMV9|(g)
zfGP+Nc7=#1dQupUuG3JBX5FW0f#sQjzzb+NEOcqqKAT874-aiyU~oOa_ZK3te!a45
zjayH^@pnc+_2(<l#T$-@#7HJ3Bs>p}j=y;M@?~IO!3hV%vBGDdpe1fY7Mr^eA7qy*
zO!~P^I>{kw+%Fj(QBzS-6?-P&#cY2j(7r{!*Zo+vcUbDRHZ8rY1M<64!O3w_tO+Aq
zaD-3yqA|9*0!wAC+Z2#(F$NG^K!0sX5<@cby>g`X;>VcOd*FcFb*SHUvy046bM9|)
zAqBcC)|U_=g>zlbn7HjS<c_+w#by?QuQiL;@iWpl7-*J9sDSrIbP7@yYBB3S<&Chb
zwjhzU-%-Nvcvk`7`_~--aY&$xjPzRdBdsNkH%M27Y_tmr4z@xVleZ%W^7s@62-3e~
zH!+!l)R4zl!20|M^pis%-nqcB$;rtgB7%aAbs(-k1cJI*IgHtLeyjdjwoJ-mAa1%t
z+GYhG`W6dak~4kA9C?78fCU&@+EvSe(<u?DuPtp$Iw1Jbb<_Fv$93R9$vmg1NqRm|
z9Iyg@dS1XV=AIZ#)&yw8DrPtKhSZ>svam$6egL@GX(L-kx|VOl{R_MK=H}<Apcb}v
zrRtwz?p|YjefM)tj<v?}^T)~wtaX8gyzKwN5|CKXmi$2<csIZ8dGZ-4o9QW#n9;CA
z1!n>jw-#u}8teb%VrXPkdgfHbq546!=c*$-U2i;CwZ92nhq;^EH*2a&_&1%r$O<Ig
z8sJZH!0QFQmy$r`${(@dU40Y>`a6yKg$n;od52j(qWpj7nEA235Kela3zzNNYHT<{
zt#AL*Nj?G?R@xY$u$77l@&n{+GtNHi9Dl5r`KKn!{+1vVLTvhAs3saT2w=dE&ICZR
zp<A*Tr9T<t!zcnUQV#5qHp2Sy&ShZoORhrY*X(1%7oufXQ}&jNN~4pI02eQukaE+W
z5PNk=*i~%CxQO?b5S)V)`Yl6=JMTdidi*h*<f&m8j5C`K__d~qsC1pIKPoD1KJbH&
z*~G|8pt9r-vqS8EQo>}1q?vrs{&v+PYjUaX-9k02m0nBzdhq(=1Dw?aXjZP-OXXuY
zn|bTWNZI+n6{4oU)cU%d2$y4gHi!-1b0qL8`x$)7UtPw8e)e=+hi3uXdVXIHo9xGS
zS}v}xmobVrJLpSGKdVD8^%UcQxGZ3PVT;3U7+u$~=x_N^tHC6APAtvjwsV6>kO+za
z9A>@@AT;NKGOWv(+1%EwW-tdON$f)@63YcL%|vwFi^6nCmE1mD(D?*1kbc;pp4cug
z#Pjg*@Ex*TR|cnj2jVBxC0Zr7odlXe8KoFeqB$A$KSVG7>LDDamU?>S)93^4;Qwb>
z{TV(PM1s}7opa8C=*XcqrmtrM$~b;}lZSbrpnn5)_zaxow8bSQAw6qgLv7#s=gNZr
z9e4)N<bNq>^rA^U-4L}RPypj&FW)^bw}w~LjbSk|yF$|TAst`~D4l?Y2k@Fs1e{Jj
zK~ZqP?*+13-mx;HASXUL)bCi;b%t1TD)L=}^9G!+YVWUGERmXOiY(`E-8a}wFAv#=
zu1l83H24ByicT2#vlxXcA*=n%k-wm9e1)2N#h$KTkb$3yin8%fCO0=XMP#t-BVEGU
zQ7XA7i&_BAg*7iGoYaN(4jugHfClGBwA*N|wwOr-c`ZA}OiR1;Emg2okOUkMBE9GO
zLM`|cHmDVDxDkBJOfQZEmk(V)dZh@=_3!J{Fu%U5k~ZoDr-5dQI5r~7kn*S%a#$d+
z9yZWPy_xro<3fff8QkB(0)XkGJ}?8@7G}6fb8qvBN%YD<&-rhz-P+f{XU&nHZIoUC
zqyyV(#$h@#2YL0|%zCVYILo@68wb2Jb@VY@_A0y~LihS(be*CMHa~TA1c)n+z$;?K
zJEeWAk#_JnP}mGAEyAaaO6K-`#4YOS>u&{#u-^pJp1u8Ka(R-+q8D($R*DOK)P$bD
zb@jQk`3{{A_xJac1*BOByCi%1s;Lv8jBb(ywqW$L8-AMqM%yup$9s{JldJ!?>U8g@
z_=Rw#R@{;ec+ka|Ec2?(GIlRI%1biJ{X(ff!4VNQ(RO-jVm=`w>9!qVmOulnj3m_S
z%@EJpeoHS+JT);HwbJWR0@M4-%N6((<S3esPw0-tA8Si+>62t~v1ZrT7e2x;a-NmQ
zYj7Zkvl_b30SgrOwunOqml}WhfX6vG%hZ6XMlT1|z&GyX3}>`118IJ*fCs$~ie3%W
z<YdxVLm!EIcdj!8NXDsw$@7!h%}h@A{hSK#F9!j+$HI$f3ca-d5{TT2<F<Wa=|*5C
zCE?Wq%qYP!VA1o;V)REz{pL@Bt=WxQ64|I&`KbNP9mTE3cdo^qrY0X>-VZkqib8k+
z0k)g$k`<_jHUE@mQV-7RlupKM#hmkKY%T}lMU%Fqq&cGmlH_jg&(>N-x3fzOKWpW3
zlTdnnldDwhu3e~~HqfutKLgEg>R^(r%Ss;~k77a?E$h7sq5Kz4&#m|}@WhP8Cp1jo
z9}6*zV!8Em7obI(jvtwx4cj%q<7P=ETv8Q~3zuN=sX}X?V?0Z$_E@rR+Nyu7xZ|#)
znXS+y${r&EqWYn_QLsLrzjIXqG8J8y8mIPn0}vNFW{rMN8*8M2(X#JjDOSSHU6+&n
z?32RmlOrqwi3wiyG>ZH-Q$$3?Q|W^Oop$sHyNuUI3D=2_?ox74BMuv@zqP{?2HMDA
z%?Q>Sy0x_xQfuAz(N<UJCy}P@etQohF?eQ=i1BN7eRpZWn<!8nf7V>LMefh@hOhqn
zzP18ZZWbP0JO^DmA=ltCzy;hMWSFT6st9N>@FN|zO}5~Lj{ys!Xf{xLd<OUzk|P&L
zLPX#Q;pV+ROvK~Qq$+D6GNqIY0&$4sXYoi#t%|n9Z@;yaW1sd}v;xTA-Dp=DtaxkC
zq4W*J<w+CZ8}KlE5Cv9er?ez5D{Umu-*H|!M@uTxGbD@W)z<E{S@eJ<-D?ze{WNYx
zemAbLC$`%s1DYysQ%W?*NX~9@2Mcd;_)1%PLz>?3y-aVgm&Z>|Kzsc6l9eam9*gi~
ztC0QM@B$g^vESZIq}9cDDzYoUM}Eui@DR8?#GOYhs9uXphBi6cCF&PwPacwz;8IC{
zQ&ZFGQ{>@B0l+a*Ttb32QQVSbhspvkIzq*tLD$K_(n+?u?b5?buQrYWF%LK~6e@l@
zZQB3TCD_&34B(9sq@%YR<94bZt6zvyfx8_rKhAmGF&n7P!V3rXyKVxKSiDG_IPak4
z{)?xF1A`LcQTyF#i9BrH5^#OrX=kndl%|6o-<LqUe;YxFM}p+m8*z+x`+ywSorr)I
z*45Pk@#!(|&y?4Q&BUPn#%0f>C<iB}F^zs#!~ifSPC}ki++tv4T;04M1A!pT>?uz7
zVzdBd-~lKDcz;W7-(nWqjx=%m*Y3Gf5gckxZ&Y%dvOwxE5v&AUO$;rJjs5IEc2-LB
z1IV_;;03Z+JAlD3Yj~d{Lm*38$}mf*_qP#eX+neiK-b7f@(0Q=-&MgxPtT*gH2fy$
zj|%!c*SXyT3XA|)P{4sc;X!|5VR{?_fnXu&yS_gX)9G4M?gq>gfrNkb01}=?*{LBs
zS6_iBk$i+sa0N_rvNYB;8H$}~2YRfd7tqZ0^`rQnm9ua@{(YMxMn3r^DzEMedsNU^
zN2fd(SV)xTYTZE3App3^!RHh7fY5&o^cnDaZ>2hj2RtK<jPY%7&YXe$JAf6Wr7<8)
zxtEw4d>eq-NbrDLHnO1TBKk~H^)drP(8R=qAUx1ZqQ&((!<g)?mid-|hV1Hgi+>ay
z7A)siG7bw;GgtjBM@yan=~9kJK>g-Xi~2zkYC`P6gBfgrPR!eQ2~g+CNluB7R3$l>
zRUx)UodA_cFSBf8cM(u|@?+`2l>(~@UjT#PxFmHyJ(VrZsbr~~8yqg73mNjEgwgXr
z#>AORuCD!UyGA=H67XuK*OzQ~3dr_#`?H}I$hqtLgbXB80;^z^fOq25%2l>N!>+;`
zs(9q|3G$$dLziH;eEhy?#MgeDvi#-6#=36kB-auPW~(HA`!$Tk$iU#7ScL|ZKThrF
zeZf_o%f46*8KZuyZctnYi$$2p7u@PoUxQRzwu|I*RCY}}?p1CZY|B@d7LXiezgcq+
z-E`qJ<=V+1Gqz-1mel4H7P7<&r&derYb%dKSQ;!(@Vl(U)n}yE2j?JdU6Rs~-8}Mq
zg?IY7n>q)_gL7@T;Qo_~$;0rL)spFW7jhHjaLLH3%E}3rvoD&3mW}{Wm<NR*Nx*&G
z(oC0d$-w&4B+7Ap1Bp%N=l@?~Qzft}{9n1ss&@V_ZP{Wd!&!^jjD~4c(qG}17fEgp
z2wcT>>D_UIVa4Hrfw|=_(O&fHQ1i0sPfD{KJZy-@j;btmIfPne(Ax7CyH<x@^Qdv=
z8Ir_n5BptFcmzW;VxsL6W{=LO7#@5S8nm!NbMXBPqwIwQuXF^T=@Z3U@8h?T2&$oB
zo?zvE0rlt)=WqCXv?wPCo(p7qa>#)&ydhoosXksIb96A6q7`WOdL9Ca>Knk_X0K!f
z{*;!KWsku`-@Ufk=yIaa_@C^`dsASbTckzqb{8;T%d7>hNe61s{^oSjkrhPp=dl<I
zkQEUTv9>cx1uYZ<T>%&knWC$77o~rHR}GOwYltgy*Y!sy$rc2~AFj=EWM!X3dFfYg
zfi()Dm;^A*q)b}j$WUiWl7~ujOo4E1&Q&gChA5d_^}NN(n=snorI2(^%0jOYsgc0y
zJw8MUrxx&cAc`TD#|53^3<@4!By?$4yC6!Ey;_i<Gg^br1Hatd7nr>x3yD30YD=F5
z><MG~s4?7E25YFUeqGwA_a4ah;{jf&Uil+TK4y7(YUYoBmh*UBeSLtI=#>eh{+dir
z9gVSspWD&Mz)a8V*DARkRnaT=RyF)yH_XWhue!z`5%y+h*@LZ5R*(Q7K{(-Q^0H<8
z3P*GZix0F;r+JwW6TU_-{_J+5yvwK*iBjG~Kk9CRhJ|9W4x@44hn*k^#pRiRhVr#A
z#EY4H;e#OVsvuM9?q`VR>q{8KP#)nV4Vj*pLHhv~51lNW^SXE*F%`e<=^}f!LYW$#
zmcBgBxpW>roh;t?)_V;7q9F!p#V@V6!ON4q#yz&9cx~{ca{wPxN!)ith*w#htfG>~
zGl>KPw=9|*ph=g70Hc&3=u-JWo*97GSa{lSUpYygT}ZJQIQ!rH^;Fp`M|~(=m&`%`
z2E0q;&F$n~$;1pC$rn|Lku`Kt!79=FICHYF>Lae%<16=8uFkHj!kFfDeUF5dM{u_D
zoK9>jUS)`Tzos-_l)?Ko5YY(nJN;v>B{fBdQ=>tp#j11FCk^r+=eic6oqbQ*3cG6(
zgIIB6f;4LN7X3A2#W2hM_QGz5;7#a~c2~=8>602Xa$x?z;AOH*=adZ7swUjG%FHmX
z-dt#DNMg4pSm9Zr#<-x<a7_`ml<yE9ZQ(B*<_a2KASZKm1S>(Gg}tabFnCC>*slkZ
zt78$(Chm`xWyZQTjr4}|5Fz;`s$M?xGXvf_$A<9X=D=l7bw>JR^|X(3{{G~MuZ80^
zP924U&AE@C*1-Fz)T2M2M-F9jE~(&+bB>b`R6Tj>+PCkgnA(3tmgWr+(~)f!kDD~Q
z>fZV46q`YpiVAIO)D8?j5ku7(@0-ye8wy-&ES>5{I!ab*8u~ZPA+kVH78WWe`8m>g
zyHXJhGt5$EMu#qe-{d>4#6~CZ2>ncRe(8O#-mr#@N%QS-)w~e>u5TMg>cGd<A3<1I
z2(i?$;FyefvNYzaQ>6`CKhINe$HA~XXFR1oxC*)BazK|T&Nrx_*H57yZCX80zou5N
zt@pV{CL&Sp%cLnh+i>%-*T#TMdP2s*?{sxWZ4B-j?h-r^VVF1M61$Bv@W~_eB@M6E
z*96p0mmqO<5T6_RR8wCilD!C2vC8JH3ac|W<ng3@E2jn}ur$LG{!&Q!;Ac*hjs7r)
zPaoD^ol*ECtzKTG{~m%-?LevP(e#Y$DCV#bm&M@st7<LFG_iiwX=<YSnA@9}f;4KV
zL&MdF(p>e*rN-hE^GXEjN6_BOwZ?%~%K>k0>Z___Lw@amc}sjvzIKHNTQm9z?-o{q
za`~mG-=ash7$GRKE(!199X=M#i9Srv>U4*azWicy&gw1g?BADZry4`BljVPU2X@d4
z?L<W$npEXP!LwGpOCp7~^gK<UAHOewd4s{R*Jnou?+)DIQJp&0?23N}`aPt)Ew4HW
ziJlb3&$BtQ@dV{6_?K5yClB4(`Yv3(rOvl2dBa~%ieGxytv=7QWhp>7Eb}MuV#d$m
zT2@p}tZE#yQx^mw2W9p@?LQ|^h*W2%y!YfCA6RLu8|@@X!IT0HKBpEz&4wnAdF3k>
zw@u!qq6R3y()5%(bVC3K7}>;(A|GUROi8gGb|-!aPq%dMhs7jVY5JRU4s>cVJXQEm
zjZa1%H(vJp5Y1HGOYiSiF)C7wh1{tiBoD>sQ281MHuP8sI?I>C=(mRQ{~4sOQ@W3R
zOHk#GX*yxa5lx;G<J?))0z^P{L(yCNZoe*x`cA#Iw;Y+Q=qH6fH44vqp3xD1E2c8D
zo2&(Ve+qGpmL)BQ{V0RL=Q4^HO>u;V8|UntrZbm58Slj*_%s9(yi$-FP@#CQVgwbc
zX?#Amnkk?m*PC*8^kA+FEmQC1&ERWvZ(!)FV=$eEw~@?ldI^?%q)_)%wZCyX;fL$C
z+acFTx-v@`+xJJnwJ%@-b55jr?@=32Dhk05j<AY~&OmK^vINL5$3yPEGe8PoEqV1d
z-=)>8d5zh(&WdMiPNt+}%oA$;zTP&YWtTaUe6zEC`pb6h(Pp>mld(!TU~nS>53lq&
zk2hOOV;6wXk5};<Ctnr&ZPBb<U!O@pq_u;O`~Y2Qm?o~$gQ7>N8R!Q%Grq70t4If}
zOD9_}P2NT#VccJG$}bnX1nyW;um^+E_bpd9d@@lh<_-i2Y6t>gp>sX<i1OwD6Yhh0
zE~z;Chjcju0=X7?a`+ZxJm7k|tlGoXhGBf8{i+{fa5u#Bi0d#**xvqUCD97)qUW2o
z>TfrON_&hi)A4)IMPK}`mrsX$h~8ybU>S+&9Psu%Rhwrs?Q-(?EPQ!U{;9iUHHXp7
zEdh1yO#eb8FkntbmLd<1VBYdt{ca6kwD_fqpF<M`r0>+$(B9wt?unmw4#Yd`2tQH0
zdZ;z*Nw#7D3WY9w25ab1n(+{+oy4w@J`8Adxs`>T#M{3F1$7FjRx<LI^U#q-e>^C?
zQ^KxZTiP@@<i<`=G>vLYT^aaHq#MHeax{!jI~n2ihp%v$UO9J*O}BAel`n>U_hFW2
zLjdo9ML)Q^<OQ<r_1zC9h|<!caG;}>hRK>DP*36z_RCcLKTxjj=q~A+K9pameIHQo
zpmmq&dUtTcC-8A>PB$~UjvHvZ;b$qyLwDuY<}-_bO@Fp%@cE1sDHwBue<DcU2lv5p
zK$q0vq;7C0@3jd|VxJ&fxd){m9ilo4dXAYu84nJu+loj;W`M^>zcKKfXzhfA20IL4
zNO8Nj?%UQM$<&FO%5RIh!_Z$D_LiZ$)G|eZ*r84YHc@bWwQ%nA;FN=GSaC&Y0YTlO
zrMEkH+iN<1?#u`;zqFh4c<zV1xu9ky!lO`~yb`|3y0uXK;Y9Ujy6Kf4KBky-k8mW1
zT0jkx33N#nar~JLr;g1p$$qeDu3apFETJy4*H>Rz4rxGu4YJ-IsUGq>r5fY^E3r|6
zNIf9(zSD(7V8*F^*GrZT!FD|dH4CvX#wfkymertl$NV5~$~ZWw?OGG0&;mJARgd%M
z2_R6H2QSfRYTn!6>?SdlHOI0hpuN<w1#lwZP9)pn?1z8^o!*w!;RR(yj$aFhXtyKu
zuTOx(s?;heAfn^>K?`5RfU{up))Y}6<U9}3F>jQQ(6C;%lLD$hj+*uGqL`Ck6uay#
z>&Jo7R(>a+ZP*X+S6V#1|CsaO&KdcZA6<c;2syq%=wGO0gGicpeOSmJkT~vb4=K^u
zDO|Z-Z85o<SZG_SKE~~BrPS3|;N}$gZa&Hf7i<JBC$bq|fyIvfs3`Pqo_5W=s<#WA
zt&^%_cxi8#$hF*-)t+(JO7}(&@nQLB1xy5+4ZG;Ot9G^1k6N57@Ifvop-y8V<Q0aJ
zd8;Sk^;t=?T?Q?LUzXcGEfy~NV^vu4#cIu{-^9r3&{oaf=oa3p8l7~4CvzvMY66tM
zeK7kTKOH@*H2WHXP#ufx_t7vWwfbw`OFz5S*$R7K55>1D{)%|gP`_q%-K19GZr5!e
z{BWH`A-B-@s8!d+PnjkqY}rK|0w%NjpOA_^<x}!_*XhrX!?$mETd<y(Gj*3}+e#Ni
z*iH{uZ`D58GJ{XwFaI4B0jlr0?gBjWL+v5Qq|Sf#2i^+qM}c;{SFaEt4@+rk-D(ZU
z-c?bBr?%a_E%X*RRyY@r>zGyz4vY<%7CR5#u%=2@PvD`?>HiSdbAF=j{9P(a1gA!r
zW>Ot?x1)|iIRy^xAV}qE%*Li-r&578;2LlQiuXka>uAJ`XWW%zx+5;Y9RIoJtjS3*
z1Ky3sBs=}L@$(CJPIHldJzX4q#or@J>A+!kh)a2n6%qB1Dh&_Fp*4QTAE*b(xIL$_
zDGMohi1_qnVBclwi?b-j^6|N#2)JD{wRsFPTO;q+r=>pzB7#|r?bmA9_BisRTA#8?
zg{M#*p%gF$Vmpo$gr^18DwPt#uP?Al%U{^Lx*pf0bE}LTHbyv?CTt@`CB^Q?4jVON
z%lG=Ki@HAf!_Y>hE$I=jq~{}*O?KT|^~_(`YouTM2|sr*ys5H&AlhDE5&l-}Mg7U`
zJ!#3%AI+&;xVR6${{1{$&()&L!be*jtnG4LSoS8Gi7@oBJYmyUY&H3n&Dz%l^ICaS
zb?8XVkE4{n&tIY(&YN~McMX5op|Uf;&q+m7=MSy#T^VZ$PrXpWulQ<x?>-k!_K}<`
zQbD<DyY9jVc-NJ-2I{@1okZ2J8nG7Eh;V(e9gV5SCl8N|9yy`@HL0YTtxTYU4P&xj
z1w-vU8SE(WDg>>3p63_%<G`gI*3DcEWcs^QDBWZGbO%LdKVkTn|Gx82FMaDkT_#xu
zd1HEOGp2PQpY1Kb4JUYOJb3GEx`!`oF-{+P1T`m9TX@81|9*?4U#w}Ckmm2^78%#i
z!um#?($M~=x$YLJ4V|9Kxz&0vC7`h>JP37l#?D$k|M=~zXTv!B`>JLt7{z0qyaDy@
z^8A&tD%?KEuU|?vJjhjfw>;xfhlWg;;;w1N0p))-hV7mlmV#UC9&RiAY@UJi`eR4O
zrE;~y`pH#|1U*>VYdmW<X4g)TkNZDsOZ*ZfTFpJ1ML$IEG*|zfa{9*GA=bsg^kN<j
zllG3q$<}t^luFL>n*6suD@W3{5d7q@dqK@=6#*)98-6Mj3dOtGC))gjbGWaw8(zOm
z-DoQcvxfpMiFSc<Bgl>3e&xwd)T2c`NxJA*OmD#f|L+Vg;Xf{<pXOq5E~YGf^$YY)
z)?d%F?11{Nb)nJ6`k;oq+Lx;uikWdo4VlvY7@)7eKGZDK{mEB~l}Ei$uXyKX@lKa|
zp`C~bxDrd|!s$jzRGFZ&ZK-9`jjW)}u2V4`@wo{s#Z@7+>vIbWQ)Ckt3pt8+Zh_QQ
z=Q~Tye>N8QO1{QYx}|laP>p1ry{0D(pwDvX_bliOKlE4``GVae9;@d#41By##A32f
zyaj_X>5^-ge<%JXirM^NeQ44%{4!fUkYK3EwND($eWfACjuEz2a1R6)1Qv1XYErDU
z{C7qEGuPm&rm2Ls1q$Y83AcVa9n)d+U`vaZ`D`t-k~6X3$5p_u`S{6Y@rB_sw6S@u
zR%X)8WkAArQselG7or+T%T`ZrrpJo-AA@(%)40^QR#6)L>CL*I9Fp*<_~XZq_Q2gq
zHf*xNH<YF1-B3V@-m*+_RkApIy~L_zYQ_T}?AUI8)%cZPCJg(cnQT&2#nGGL=ckT8
z5i3eQOD8|xjmIsI{4-?4ZFO<v7l2AEX(K7}241S!(gJtfF(uA0y&Eoe>!{97sqw5@
zJg^AqU*=7-#Bcb8kg-NE&o>x5%NK*$^hSL~J}vtAQ3^HV&N_}zFkJ>lE;7rY4U0O*
zcWr7PFqihon^}+DrC9yLl{o!sls}=re5#h1_2p>x#wVps&N4{djxfy0K|iR$E#KQ>
zZ^9vA*xElq7R2oW#h%lY<Y1ER&5oq=Va48<*anLEeWurpH~So_8=FmsdnBhPc7S^V
z#qVb{!cwjPs6;bFCb*m8Lbz}gV}G1i0D_eF0abDcsHEnZ)o08CtAUYy&@c?i0a&MQ
z>5|b0lcdDFggg9sW6RQ0?%&Q^_^gOd4+b_(%@!C>RO|mo3!s&rl=;)I-Uok>rT0l8
zQH-?E-&H}|WM8f4x^T-2KbrHB*{U3JC?3A+l$&stSGR)Z>{;`;OKrurV4+Eew46vo
zigzApRaNo5qFJWXG*H*t_LG|jY7A~5{2*@pnDLT{sS(7z^V`*V4(eMMG}lQBJ=wWf
zM8{UH>jGkeN=nO_Xz1Kw?bt(a74&@}ZSrA_^Y+6c-=N)blj+a<_>pGS@7_`0Xk|f<
zk56oB>ZtH#>~%uDB9xi$?uVVY>9wI-4!xXHe&3D?6#(6Q;(hukL}$oUN89_tYah^`
zc1d%c-4i9|T3jXD&P66_-5S<}YYN;|C@ek>5wJbR_nX?2yKJ(?$Shw6?RI3XzuO|R
zHFg5qLG`48B9Z?*Df&AgdANCo$gIX{)M7e3=_QK2lbTq*pu(rurVsH?wY8&ROSf-5
z1T%sLOKwz2Vci|@!XuPLLjlz5usnmcm6a#S7_6sMCK|0?_&SW^I^br%Z53asmwF{M
zvVC5l`Rx(28O7Q5Evw)*ra`^J+y4zXE^iYY)ZDxY<rc_ONw#<*^U%Nm<+Un}>OX%T
zb%1+cv#C`;1R|Lgxoz(UJseL;Ozd$xB3*b|O@RrJ%evgkXNvm@f)a-Ua09PJ9EU6A
zsPo_A&I+ct9j|sFhIx{KOHvzR!guwUb#6KokMrjVm#?{=Iv!8!pfgSi*hsIsC%z#|
zo`e5+PN(#68>g7<xA4a}M&HURR4mrU#87^H&F|6Wjr;27hX9vV+<5AVnyuUituzOb
zqHyWLb91^C!H0zRt-BBs=R{$qfAzi|>-h}YoP+=kXQKa`S$J)xtnUID69mkjjZm3f
z)kS8&%8#}hlVX7pq!cOfVXoJd2`prRJaSW<gtXElaHAd8x`dDmknOpVq@R8_VK8TX
z{~)k*ud%|{^ToQ$Z?Mu*x6Z_kfeAMctP*}O&%83Xdd@mys9s!F_OKt!oj_J|kiv8U
zdyKt;=+7muEUk>(`Uc;%=2IyQnC91id>UvH^|0iP8$YhvlH?A>g;9LWK=BgbTpV#`
zYS7=`zxW^{8|Hi<#^`jX60bP=rPxMJ49qtNxikRE$3qGo$`(MQPE-<YJKO~t=W>G|
z++!rSi!&+xdS-LG4c`7uQ}$oz8|gqFTxMQgo`4>!-dCWGH7`w&nQT7P1l^{y{O7Nq
znQ+}TQ3tXTl0KRTe6CTx3~$)iuU}V3&P<UM^;^{khZZI#{<OW8&Xc`{m_FQ2k~N>-
z8VDcbpkY^0^QjtG!FR_TJ>yL(dBC!q9xEcAJ$v>m@2rKek?4LpqVGLd*CYqUmM?zH
z`#um9yj8g*kT*qDCMckIQS1$+fUwWGK*xhu?<?%&{FeG(=qMcQs~)*^pYj<Rt~y{+
zA;YhX1{D##Sfo#8J};!7ApwTJ%a@fE+LrzUG_q7N>&GWWv&qt)8&+|~lj*AWxU~0%
zQ6L&<z)eUU&_@hkh7O>C-WnQ*mtNo6p2yO1`24x(<`j8A=iW4ZHp;ZpmiuJy$fm^K
ze#1oBPD{k8$1g+M;_@%rv`HEjOQYc+<^O)>s|e+C)rs@p2RP*!7sKl)%cYZfZheS&
zdy1Vr#KvT(c%_K`bl5PiXVBD&29y&lpY*hXl~IwBJ^bP5D5wU5b$;sM3tE*UDcBEP
zN8n?3oia%0jbYC5`FG3gu7_Dl$}jIU$vqj`?oMLRa!Qn`ijHnl>>HPOGT3`7jqtM#
zcYSc7z>(=ckn#I_Zj&=p?5*a%QBs6NO1D>_dU$9dJS@~oSu@_m%g2YE0`;mia4c_E
z2|6<Z@|sSPIdvG<WbRC4SWm-Xuf}~$Vd3%Z-rCwyRRDK_@AR$6ddzjoC3o*!%^UD4
z-eJkc)KFW4Mp8Ts28$HP%leXjTmVk6w|CnGO|@|^`E+OE!3Cf;KSwL_Tk0Df^zN10
z+)!L=eEF~<EBMMbM;Z-{F4=%`SM)z1=ff=??zX@y>tek^b6+M~`NB|AEV)!Pj0OOZ
zZ6)fJ^5?xFhJ=3Um~AU3pdS+M`}h!eF8cVAGZXNTZ;^Cv*@=l&zKo{b<rxrD+(od(
z)@)ZyajyZ22~<5@YF_8Td3b393n&-InhttauLi})Z%;QtTZs|%n*HO)Qk6rJ&c$x0
zUX@K>ZM`=m@oM18P2V4!Y}N(_?-HF#6OPZUC(o(aO8E{<kN5W7y0jNki)YEZZ2I0m
z$iMITi{gv%|AiWNo#86yr>>4BPfS8ssprTGD3o(+U#oy!__Jy#I4m+z?`jxiopHV5
z=;){ol<OKydxKRvdoHd%%`?z1rB}^WAT*dHRau!t1DqhFU9hG0n=x<Tl666_f)zwR
zK@WQn)Xdcu*K|$(`dd#M$F<&1obdOoIY&PQh&!WBl<Ru6__J&fV!@HpkazLr|7Bc1
zPET!c;cUVN<5=D-0v(zQWl4?OeSRUK%u||gD}zD9eZ%V#;mr_IklI*b5(g!qs@7nF
z7As}KJxR82I_7JN&lH!YSZ+P!6ZIKc!J>PUnosA&kS`}LP$a&$GG587EV(s%@jvVE
zxr0!b+B)I9$%*J0A`O?R)#n|r8Ys^jJ3)Td6Nz=78_`1l*|w+S&URhzTZebnU;dJK
z;ZM%{r;RLTfsdU22O#_tA4R#g#f8g^?`^s8AyKHw;V9X3%fsMZ)l|t%HvRbjiS{_9
z&rCTgWi}~rkv>>YNr0$PykDPcNA@DEY(PH5tcVh%F8?0p(^ncQ&wORwd4E&0Q=Ub*
zpX0hKU}h;^_?685{eZwsweL^Vc5X3ElDYU(OXm*Wf8O^|55CeMDav%^Tmpp%Sz?&0
zT?+#G14>I$Z>sX=9moE>0`4^#z=E5Luby%T1YGIyl1}Ks?HjXjq;Jgw@8BXQjbp;W
z*o37tp86aL-|1+vdE+K4`d(qQ5OWByYO|;Xccx{aP^bgGEWbZ_1|6QSq^YD>l$@K4
z`K!d*H(pg^Z$k16s)p(X2isWHS6fbwD-4TGZ$W<Nr@IEs@6E=X2)A?bWDEtw>Ma`_
zuAcq<*5F6{xwWQU%No+n5ULQq4EL|efH#~qD~vvq^Xb!#z|Fa?7Z89{N{(hZPWD<1
zIuf9kIr4U^@l5)x8hR6+7<pyIlcTL>2+1zR9f)h)0HmUgoMi$Ka5DAh6)-)oewf3T
zhskQg!wE$44;)?TC}f4y-CFaK&mazw6-IFh2oz~_2B;SAgfYB~*Ddf`{>h(NzpAG`
zNJg;|Suxfx{nA5<75&@EOuj>W=sy3J{cZk13+K$ZKYn+w(gy`Q7Q;wKneF4ptc>MT
z8qSkki5pOOa_>&{9!qy;XXp76dpo;@{BCI(*65~Ckqm8npZf2Kl)`xo>imM;EV0Yh
z2rd|`!oqzrq;xUiCkX2W75j!@HQdFitK1wU+Y7t@bXDYxWgl<t<m#Qg0l~vnd4=q?
zp@dTjlmLP^RSjKTX((NopU=$h4?}=%uppW_ia~|!QXyW>enZmv+p0yd(6O}4iYj9`
z^T5Q!@u5QCXOe5ijlm68^+wCJ3RBz$M7{7AI4X^hGWmA_=C8Hn-vN2TaxySg36vWY
z<4GIGD`@anO*9{hWMh17)hWs^Gcx+PIXH|wnzmTp+JBiRo&yC&EJtS-=?1`HYzw3^
zkm~_WJf^s}WC?nFps_I|WjW>h?GCcf<Tt`RuezkaOqE?!|6Lc`ae19L_I2Hj(KlNo
z!mSjVl+7`zubRm{A9RF<z35$$<NIoSDuZ^Ls#?5n_402yRN!oWY=<IQG-MOBu&~SO
zWfvk`H(rUyg7n>HRIx5lUi9k7SxSVv+&?FxyKsBL5etW1I!)*A*8SJw?i6LL`e$vm
zSv&Bj8qWun_RSJk%;JJiuKfNbb)Yyv8EV+m^{Q8RjA*k2d(bb$9(M{M)-@)gJS0NJ
zerkv!Fl_9)>wm+_1)+IL_SONVP>~<O)07erx{HCUcgad0AsRTyltp*S*;2lnv%4$U
zQ9f<Vjd*e4QR(BT-)yYqmTAwAU;Jm+bEUz~F4CH7Y|%GM=7*1mEw$2x8S^@`p3Z;_
zklB+pC|BQtJV>EjFB1C!P1}typzb|O`@)k!OdZ6~H?iKKmk$1W+&*_eXRpj3N$qAk
zi>yUIZLzjE;aSO^c=wVb{z{4ShaQm?yv^4qp5)2aPDdg394E@ZEj6WIsYQP?4=3{L
zQUskjqLBLXIyjn|y<&U_!a?C%ege&X7yPJW>Y_gVF8^;cYrchjg{J$5zwiY6kzL91
zwf#a06-lR)H$=Y>da=8n6UOaZ=HCUtzEP-Y5>>>Mij{^BhtYgklua7Gy|{5e5i^3v
ziE<Cnb0uMSoDN4$xQ~u3EyQ+`okt~2<h~!LX=;Et{c<SZkqHFf|4j2;k2xEaz9buU
zl^-^Ic6TaaVqNbY@a4&T7p$i8>R5`j0|RHFN%Vefdy=B$utGCg*=Vz{LDrNjp4OKF
zI4Fk6BEp_%`oFd!=YYtw;B&(c#pd}+zKq-1AR^jRUbkq!y%1Q&xO&(6{JK60bAw5L
zZO`TRg394@1*SGnx+xY#>K=LDFRYR*LjJ;k2F){P-iEn>XA4OgRw65dyb|9Jlq-$+
zz43#>imau4+}=7wTj(NY>wux`O1yb<b)N)v{!b<9z;UC8Xzsq!cZP{km(J@zB*$>r
zODB@H*Pj2IF1k(`a3jyqH0hS@aES#5$jl{?<!dw|jqXaov-p-ezvO~htXqPf$SrYk
z%~ZwE5ChmV#><!IhlhtlU+nWtEo|+xv^+h{MSIP@Cn&$>*V0jy&msrEmX7W;zwslJ
z^D)8=dv6{TM(g~=rj`EK5e+Mv!_;?h=y}`eS5pg(ZXyj7G324&p-2Q?H6@^>2rz+N
zpH6YoOR?^qp-%dg5(Qrze0a&sGu%nD*#Y8ynR@6<Gi_~`0$N8DYxWlY%7R?(HC%kx
z+N!+ai>m0E8Y@V;SXToFg?`v!*gc<?HS0~vHR}-CCWlc^X8hCK#8=pBefi`uHkaNf
zDlv-E`kmUVXmSb64gTZLMoFaDW8(F1d@<7f{y9Bn>yua)ekUb+>&|b_!112e(Ud-n
zJ~u1uU$c3!F`FWJ9H(Q`EOtrgw@(A6-_-4UBPSj8m}7Aye_qxS$Tid1WB69%`h`}^
zK-ytO5#B13H}LqkF-lTd)wwtn>m}2|BJ1<Sj^W`)a4;~5g?c@fP~)QY_-3coGO%Re
ztQ%0?pFutsp`e```koa{7uh5?D^W@7+ZFY%HTv2kzv;=+?`JV9^Sd@9_OiUUsqD6A
zYEsUOXMKl89n^^Ct369boRE8t`pfe!J#d~rQM5KwJB)6%TG@exF{j+`9-G>w(d;j|
z`8fNVDE+WYJJfvodjfWV(5&+iUB|Xy&TaC7`EhmERL!Y)zrz<z#BddSu}ZgJd%#3K
zbh%Egl1VhzRba*VD8;lNGd><E?!<w?aSi~q^ScMiTQ`otdQ<=YGJNtD?wTFOf4`hQ
zeleQC=9<;jVqxYpQ$Z-YUAh#vq9L2Cs9dq>$~j3-dM=fyD}DF)cVz7R4&_HjN9zDj
z`OswOVr!%+t}Vr?*>G)qc4H#H>KL|gHH$+aPi8MjK^0tYQ~hm5>OTLDf%sEEifL30
zeG~n*_TmEd7cLPkj=cMrTmzqxQ)lxohq6cn{y1OEn)Y`Br7AOAL~`ptRi44E*b1Jp
z6y^5Cv_>6JES^6)=SS=5zjx#J0OOA#WB13-`re+(#9mAEH}hv4@3utikS&icS<f^+
z5oyxe_7s?juR1ADrc%;Q5Np2{*P%7w8Rrlhz3%5uc@X!GJqGK2;Zw?Ys859HL1S|?
z{0HG1w3=xwCgum!pBp~te3J`t|HF(kfg^mB9d;yZdh?UOU2uM%S9&>gFinE*&Uq-n
zBz6OVYS!%Tp+NWt;H9|}Q_Xtk+5tPvPSdKpeD##OOlAifH0Qdwk3XZLaT1&Mu$(kM
z2i$j8&mCzv%WFBy56-wFgDvQ}?)q_K6*C@K6tSyHZYa3A{aR11uv36-y?dJMrfH|C
zY~LdVcT{n{r<gF6C)kmGJ{;xm7Il?rDdO4RNprZWU7l=aHlmZ*BqtpmJlzJx$XGi?
zW<@hw>?xxzmkES(So5~3KQ~D^Q^?*9ZO$T}`l_kPDE#!Yrf3VRof)+4{@2|yw@VE_
zo<*FAaruy~mRvvli1&r;#l@~>%D@lM&Dz%i!k6&lr(>v9-6Wg!WV42Ee-!yMA%eIo
zR~jFFKjmVB^(h8nmxbEG04?6Tpn~w``~8s@8C65njUP$0sI?ROte1?4OAp|H>j$TH
zr+VjHKeN(yz?57-gK{Ywt?IRwjf;0G%a`l5zx8duEvfqHVf%5T>&<+W3C4@<U^8m8
z_0V*K?>E-LyTY*k`_d;1m>1eh$20hE5PKD2y8fp8fRR8yp;$u|yh1tEs`+S#JLl@5
z3Lz=Bb^_&_()G~}@(thILgr&5+_pCLF*vJf;?g&<fH4i~LmeN+02=MG!GXJGgIZ5$
zc(2pF<tlOD`PWkmU6|QWlTP-tq<+8r?<YQ=0-t|&e6jth{!W_atH)5kNNZu`SG&AV
zK($Z)ON+@Uz^Vl^V-CgGvF?<Yhc(DGz_U=h^Mu)&#J$m%?8fa_Li`f+l1TzZ-$o)J
z?j!n_w-?OtHYPXt*Y*`Nq$_NAqj|0iNA)6^lG0@7=Iuq`KQ{j2guABe<K0Q<jY|_P
z{~u#-9Tipgz7Nlkihy*NG?Gd;k8~s5poE09bfZ!Vh;%F6NQ0yzCEd+X(%mq?{Py^K
zKHu+et@mB)eP=EI7@RqC&e>=0ec#u8-PcvLre0cyLb!KU{>!wys>pI#&YWOf^H?j$
zK3F{%_VTlKm|!I8In!k}J{7tMF0XTGk&#wyXqr+yI-y^058=O~s>z8QOPPn0%D+y0
zFz^gX4q<#*sH*>+0vU{_-U`KKWqW^|g*22LSb?<Cy{WE0u4OoAD6Dxeix<W|w}R%#
z1+iTx>5JW&lROY1O0&6Bu0M_2Q!0`*+zA7DTT^Vbq~GP?x#3Pq`%jQSdRPA9dZ(an
zI3|&JuGBdxVHogg@3#HP05wgiEjn*jK#SjeLRuVt*x!d+q39tGVVOJA@tVfSrZqQ%
zNh@{5aPl+ml!vN`jXVtal%kI!?{1TmVcqc#m&Awn4n_Ol=|g@XX1XCmG9xU>RRj>n
z{(H+_8R02j<&`Su2^|Vu8>ccfg3pI!i#tz56!H@#D#D<M$|?2E@q6beZ7*P!uFJXG
z{3&=K0Et9%5y|j2w6B@8r>}jkgx)6G&&A5>EUPrh+;Bj1evSk9!FuM~*J!m<hUzHH
zjSKs}fX5j?SPqcR-R_#nJxU4+W*I`KQlLvat7pIP8fVE8*`fa>$<*h5ke0gmSvs-@
zI0m3<isz>JxwR6_$Ts0jhACq=)pFQD_a9fQ+6gz6cPtWS?(=~HfrRdGLQ(g=w6Xq^
zqFUUHW%p;GLpcSX5*4;TGqFFLpj<Kf{fav_L33}g=YaPluef+B=YxKYY@!t#$Tf<%
zj^PX6_W{ruH(AcFlL<PUQq7PYPc7aisy7^cv%YyDle1djknA9T={Ww=2NyewzhV_~
zUTW7G{c~XhDl2<VEfXqFVv~}lBu!S7_{!W_d?zM!hmHWhUj&HnYV98)+hA*fdRhqp
zK!Fd##p&)0uY<gE#BFo1;^BGsNAsvDi0_rIGOFEL{HL?wwqOcg=$uRPbvCWQYz2d}
zH&yq8$t!BI<LSUXt4G#BzgV815~hE%BXB0gbL#DCdZO6SRU6D*ozxd3{wT(&J}C@8
zkS*9NdM;i@oV17pY<DS!$IXxXZ59TTpYI$%SD)l5-C_5$9Lu;y_&L;wAd%6(xb+eG
z+68>agzLnjzqi+g;BKzv-FaE9<16ly;DUI~K%o76I|dqxs~nJ^QdM<zw|yC+C_Z)f
z$cyC4ul4=c+h}s$_1Aq>%xrl9t)S^R(JyW`e$j9T##D4r2(UAY10T@eH)FU{on{j-
ztfhpbaORfDfds_wFZS2@L`OKkfE^q~W-LXmQ)E2x$G`@qGRNX5*g-+-V!U`?Z*L>x
zWhPOtUXv%js;i()2~1MOUYui_S|%+gK7~-jegT~~Tejx&{z4O>%Av>3<Q_}q%{~oB
zNCo$tLfKi5cIRgffRldRVX-Y!x6Ae}v7K^+nKu9-?=x|<y8zL-ZDG*in_wPN4>bAo
z3a(q8+28Wm`bCsa56zt)qb((noDx!TQYwdBaF}ywL@G`?TEGz7CP8j9f|{<(-%3XA
z#(3hM4YaHLKF3)<K3)wbjWG6D@mOMCa_?8@!0>I8Xpi$qLxk4AaOZ;+vs>OOQgOGh
z-A_Lch~qgq(GJ}`G3rOtr!|*D<u*6F|KYU?_0p5}m*(E@^wpu6r~wWa8TXCRZu%Aj
zEOO2dEVi-CaBpHS?b*9Qq*JrjC`6#|P_cp6=;&x44tDdXz9*<CW~g$%$kdyMc8J?;
z`botCt7+$~Xb}!7$6gRT$I(46Q_7=Ei=VxW_FJ6#h2M{`!+Zg#B{=t7ON+3N^4Yw<
zQ6jM)gFA{F$bp>#fVx^M>gmt-4?L3+6D5jjGhf#?a@P#SGRRvSB=S>UZh|JK3<Bxq
zXW@KP45DGQr<>F|t{0oQ8NzvP_11I1v?pn&qAe5oPp3qee=fi%qisgutH(Htj|Ajz
zRvODpGS{bY@>Hgz$CNATMHYw3(@p*_C~+Uh&mGu#9=P$ZDeYc4P<T`E7GKCL+55IZ
zm}hD!y?B1QU_ysbcBG@pzrlql^`&zVBf*kTt)TOEWe)^J9Mv6G+^K!K=y%e%AjcR*
zp#yB;HVT!MV{X1!C&=By2BMQ2n=d3@i;EsCn288%=3jv^y|4JD`$kl$81TCt)S8Fh
zzl6Peu|)@V2DkKIfzd}|6{tLB(U(umKE8|o<&VkxtX>pOP#4vCGHcT-%pCu5N!23J
zN(U73rrYja2LN#6kl^aOO&@PfjZ>MsPLI#DBu7e0%FyK06zoAd4?t~80f;(|0^k=(
z$U=gqbmWH*ln;H?lRtj^$bAzKsKlaS*y3|W-aY`y3cS0bDm#0CtUAPNn()v{3>yZ1
zykf2$0D6<&D4WK>b0(*@m44zVx4P0ly2rG#_V_}SVmn&Qxdek~M(x$abZZzaVp3;-
z=`Fz65h1q{I)KjedGdQNg^Jl;xddf{#H^P+1qG<=ImOhq*!ae4BD(zA7fWlSuWK0$
z_dzG;cU&^8Z(ybv!7mOFR*}+5q0g0y`k*zFS~H%#FVc=c4HD<q9UL*CXO>`JMyu|k
z009Pqc?{<^wE$mLubuSF7s}1mP!h*lW6Rs->{C+Os@67Y3%HGHzknk9k(3V>TXHHe
z6VL+MBx4C3BGzXA(naDJBVVn7Xq``mULY~{LxsiXvW*vV8MqieFC_3PelTVsa5$FR
z`+odj{Dy&2k3tx<n5>C|_<4gME}~kVNVc4om4XgG<lS~b=UG^s^m_Le{RW#?<iv1E
zK3Nea@bb>_HV##p-bUr=Zq|7#srhfkU8n>q36#6KBGFDrizlfA7D|4V{Gd5f@h9hl
zu>gK%#aknDvULJKmUTB{j+f$&ZY%y=AxZ6}bhSC2Z$Yxgs8u>-j{#3go&Fsh`J~pX
z`^D$!C`7%=seO)4=k*6V!{^`?;O~E14*_*i@@0Ys(~1kRva^zQBY<VW%SP(ES8c;?
zyPx3Q!%me9yxWMn;ACa(85|fWgMwf>W1~N%8UXL&fI9H5E&XS2tJAw}04o&$SV^E<
z_>G2h)53eDB7^e<Ul4SZA!|neDOAb!m<<4^OEM421bTz6NKU%TW;agU72L(P_DfTE
z-Hgj;n`%;kJ(Fcz-m<s6^sTCLmkIF%=9=h!gGHzBL5m>SQuE1R(+<Ee?T%?rAGw)r
z=AqzF=HTj<_$Hb1J$hZ{>|#?`T3W-C6*dXFv8fZby>OYp)ftqXc|r2VxBk|(sI{{H
zt!w$<NwJ;vfkxpx*<;?=e+yend9jG&E5BvA?Aq_hsutKde+0@T0bpIgAiAKc>X=={
ze`FRE&~~j;Y2%wsogyZ$UxGs`V(uU?=&iWWtWlH9l^*@F6SJ1tRXA6jWi(uWpyC~(
z)*emN{aLC0h1>uxL*2+S{n6|%drc%Mz@XaNp$nU{0LZ4HcGQj-`a<G0-Hb|{vW7@+
zy3msPCV1ytsYTvwk{J*6^xV_i5M<~dz_)I~TcJDYYH;CKj$~fU&TwCNLK|A4sZUxQ
zdY#!9$*lHKppi1h%7P0{!b_2Dn;&47@!p5S;9u%Zc>D=eCt1d@6m_1+S~Gv?p4=mX
zqI+@rD)88^D@$}t6r*YXtxvW88jdop5Y)5x=ad4CRFw(vJ4zl|`&;(&2>~p3wjfPA
zD?l<?RF+awR#v}1MiPW1bl4kAJ~nR}+Ss95y#i5nf7KJoB4%_3YL3%0+;M|seAQ*P
z_mek1SF)>Zjx9ZZQF9sg2j+ImgY8rIXxaYD1yK2N>WB@`3}$oTNj$V7dKa!olK;A!
zH9IZKFx<NL-Xh=B@UXMwdQ2}UUHNZ-YONcj>m&Kt6jv4~TV;Xh4(bkAzz2V5VhRRV
zkKScGsbTU5>eG^8Dfi!$cCR+h?VPQLq{s}c9;skYu1^@ksP-BS6Nztf*qof7g*R|=
zr)n>c+OgtuxsPsUP`GziePF(;PLL-2i-MIMpf4#e#gd%^u6=#U6T<BKu?n@xQ_~^Z
znDn!_Ahu~l7O3pXhA=ghh~c+);xsYxMu}%Q`O|QDkiEw;6WY59v?ZRJn40cS8D>SK
z^d5SYovFoi=a_IM(P}kQFL{E=cqXK7a_`ZKZotSp9OVZr>8ny%70b{vZ-XDa6#h{Y
zpKe>MWC=5ETS@<JWFr`8K@2=`WwOes1t{H*ay&tv4`my1#$#n?XZLJc@Q>GwOV9+_
zfM37L2Q9#f$?`t#W$94WPdse};c_d0i2Z}iY|FSi`fVD>^_QH5Xp%)e_qV-P37&<M
zXen_ERA;uPZfpFf&H?Gkt)pM4iI~b|^m<4D(s9b*ojoIM@FWyK$3BmE_B<&LZkw(r
zIlA)8BJf@I{T~PzfMN!k+5gKa05=p@^Yaq%f8j-Bq2O&iqu2i;vhTpt&UD}O|2o1u
zAqB+{z5k&l{J$T9eFAzf7CTMQX@4KIj~0Dg?j$u6a|g972o+#puz>c!GZy5Q1~lAX
zg;^Y2$g}{i>Fm5Pim}@O{~l<{b8a*ycQ~UOn*dgZP3Tj;XWQ<PVhH*Ok)E9r_XY2b
z40#|D01b*DWQk6BYV})@4VR6)m9{Ft1EioPzv&e}0|7DWqnnc<)Zq%Vwj5;W4rKEh
zf#?h54N%0A2gL^koW#81ogKI847I073XYh35Dam50fV2<IYBQ$bFQusknkAOB3B2z
z*Au{9C{wh;2A3;i0q&TCrkq^Ya-x+g_?tYnJJAoc1K{!@p~=So6eJFBH6Neuk0=$z
zOKkLhj*EMnu{7XVvXNZw>gIM)?zuBLkQ1-8MJkxBy2I55D=Tq=wW1L=qherRn&h;x
zIYdwTglO75D_&KofudsUnjFm4AK>MUe;SvqRtJoSzem_BtUHCb<ojT9J6(RhXf4T}
z#QGA%;3oQA?tEMD&wR6~(CqYqCZLnuWA=idZfT`&UtlHm>0l`!hfc;Y7Olc2?)#gq
z<MU7)%Gtc9p+#B+KEZ*gHy3S)7AFw8dm=eaJ^lT=An%==_UyY2Koo*n3!|vV?j^zI
z)&;x-6n<ks^^3KrxY!UQ9pxM74Qs=u;M<I0!&R(#0%lqh6utBee#??8k}2H_lvQ|f
z8i<xa%NVr}P*iJ6Tlqx51t=JXOHQEbvV&CqR&r6ee-RUSv#PSh9|R;T-MTK1Rs%Cv
zK7k%MNkj^!9}Y4K`2(m%VPLo)F}GB&>7Ak7MS8<fq)^SY50*X*Nvw<vNf>VKO})Bd
z5|5tG_|8hW1E^YoxU6ViKzVAg0ay-7s9A}D4&kGM<4fdd3L!`Hv*vI5PFQKv!v6QA
zdv5`qB(%<p4fOvdnAuY|+t+rwp#grHuX<Hkrp5Q~;25P#K6H46NgHO2hG6<R>-2%A
z65y#)&i;T(Q|oYaRRM@>56K;-nPDCCj-C#ORH%R)W-?d_q%55X2CGU1j>xSxOSdfk
zS@@ut>YvqiZt>$#81~w04WTA_P^F8@ZTk$y4pbaRnPKe6S(*45t>RyV^;vG^s`X(1
zyV*9>FYa#qSX|UkUv*jZaiurpy3m?XpWV8k88`9TwVG~SU1eH!{{8mk|4v~Aiwt8x
zWA@K>sNm>ARfdH2`+rTs8Yh+B%OhC}p)Y7PSr|6pUAJXFgj<oCRX$dH@c>Nz>;xfA
z>Y)FeKzI+)FI@)Xv~y|G)PPhhK0nCzE2;g~0TDu0ZQSnPkE-)YnfUaPO9nF6#QJyb
zkfG38`shOXD)`{aQAnG7c(45~M2AM3#IS{DH}93&YnM;RMM#1C|N25TUsh+$+m-52
zksT6r@l=Q6o^jmntW{h!<l@7|!VlIy(~A1A$!n4?c$-D>hPDQi@u1=<ZUz`L!?XTo
z{$~^9Ahj1UV*7(0@TFD)s}OY&-Lz+LFrYOzmvI-n{`_bVQw~Ks$nVQDHXU3s14F~_
zrA!<Da!X~5M(=o9Y=*e%a<mIJ&o!7>Z*8!{8orpHk7fLRP%%%V7xedp*~otYtGB;o
zQ$Z9#)G*Y&n#qoM&7n7&!^^5M-DBmo@I}yGp#8<z-al^g+VYF|Fu4$I^2!Cgtp#|%
zVe%~w{mVSX$V6p^z)-7#0}OW*4R`Xu=2`RQi&U#0xQ*$P+x=HV9%Q0!)}={x$UACl
zu^g`0^c+|?<h>ayJG18}r#3^s?smTS%D>&)avqBO41FG;-K_r?z0TjC{C}X=?H`Fw
zZ*iO*=<vw2O-wRYPp+uI#04y)xS;wVwL~jUHZHEk1O9c_#v09Sro3^oGWRUNkWk4Q
z+JFESRu}Xvh(%EFBHC*Za7G}ZgDC;)!%46DX+(Brwz1n5D|>ZzXhrPhu09!zeHb?6
zhrJadA_A2fpzjcJeC)ay0N*=D!olg=$>3~1=e;MSMWw;I@Z?wvzR;2GU|Pu7L8&}H
z(D-fl{NI~RPR^9F4oF^3kf$}12+()i#D94Sw9s0qz`6uDh;0O{6#RDDh^v#0zy(8p
zxL+%bf4?F(Hy8JEc=hN8GF?==Uk!90g4+vz2ml?YMXZkw%@so%bExqEqc>^yTRI0?
zVNHgH0Z7t1`BUHPGX3qLUBp4f10lVygVZAM8Pd9ebnnh$m(^`e!mkSa6;pE^Ri&7~
z9hlo2EHEJz@qS?)m7RMY2wp(xnFN#`6E++`O{M^w_<PFG{?u0euK^F!spiKY@hUr2
zoFFRwefLd-R*DxO9j2L;a_rgE2}Vwh+pP+6(|?~Y3GyFli$wWv0OL)Pe^DQZ$e?<m
zv~RsJP37{R>zy^%6#OmnLJq(zh+Un(9NVrcuux!U@UJT6O=LZ~`BQTKHp$&(auJs5
z5^=hG<aG^F{%36NY`X~lpvl?1`0E7NfteV{Npab*p5J?vT2pE>TAC+IsP4kgw+3@N
zHb|op-J{CSc&<?o{wL#syvi)~>jG89nnD}ZEo6YHruOUanF@e2?E>;MJ|NAlN1gs3
z4ES+g`Iw<^a9h4K4C!=&f`MZB>Qx}YUI1igs=~9u*w-x4_vMTpW7oHtp^V^3J-bq^
zf2>gLM||o^lwqX5heXxov_I77@VKqNz?luCRe~<}@g!sN8y49QW%A!<^?hLWpHF=f
z8L!p;L8(aMh2UdizlHSAv9U*F`MS+`D@#fI;NrfuU0~K0yc#`wcYsNC2CbXA)LC_V
z!(ni>68*K{4o&{@qS^m6vy{8lPsk*Tq0C*a*aErQjb<=<jp+k(Gw!gCU`;#eTupSY
zBzrJlq}bf;is4*bTpl1V5=8}2euossp`I_J^Z3)JPX{LrQT>3p!{eNLD?A?SDjP|{
zb5*)N0W?}6Hw`JgyrQD^v?H_MXT_=nB|Yeshy`BH@m!TQ@?ycrcwJOqGLX<eK^gr1
zK%-dsgp)YPwcTrJ(wgFf0H8G(L;NID>i|^&<W?~tsmfv!=6ED?oU!lPI9VVPZka6R
z?dr^b669vwlo)NqUPKdss|)WsVYZk0y1irDW@FIwQI)u2^>ZK&i1EVTCfpFKTc{QA
zs@q3RioATL%0{dbVogd!)R0|fkXG2*VtNo^xI-Ld@#lAfT381(U##OEAmGDnUfxGm
z38P^Lfw)rk{yH3R0bK(F;d>1QO#U_60CT%L-5P_Ei2wmFu=Yi(O;&DmDi16+lp|I+
zVdsd+wgN3Re^LJIQ&?@c`)1YE=$*XZT}y|^uA^Pxg9hJ;-#-rg^=9fLth+s3Edwr(
zuAP4ST5gP^*pyXE*JWvdpAv-@#CaeURR#f9lbL~mp#ZrxBk6PaKhA(u-tlJuJrFX~
z`rmwri7{yKmLB(ixIKLJdnO@45#B<ywE+}3L~T1GiJ#Zg0#`F-pvsZJUHf?r*><-S
zBPsB9)9L$Gej8H9!WSSOLS<+8k9H(0N=vCSe|vpie)~{j^LSYLA=G(Pk>%DL5ZG*w
zJY7Mnm;sPARxa*P5bi$Dc$3_Ohd6p$DC!E)73C$<otTU}I>T_4xJ2tNXO?8nPk;dh
zuZJq&Ctf|a0QtQh;BYhL|HDE5hpPSY7ZjoTkvdx{ug+);0chXuUPV>?=u`j^V2Rwv
z?z%A|j!FDAoN5XkM7_3n`C;nm(wi^b-<Y5-OqwFy%rbFE!ez~*!MWY9*krISO6ZT$
zv9NUCmq}Psb%v2g?LX8|$}j;U!VS&M^R%jBAO&`xoSYoQI1Ua23CUu(b(;beuKcUM
zDz4Xxw44cPX-%Fj$UM2SPnXfq-Cz8|@0hE^^Yz@p(E`qyfm2|89>RBy9S#%PWE|X{
zWOzwS>sYeVa_~4uNY`ZWgINXn)y_XG@8;4mb5DiU6PFHx$F|;#$PGOKqHWguCQei3
z3v}ihxpj@?DX{|Y6IS1xNd;tv#ee@ky*^=YV<SW(Bq2N!KHL_!H&@TCV8Ym2U9pV`
zVVS8H$OD17@6<!l-ERR>ZO90D6BZ+#QC!CG>W}<dGyI7NFJYO~mHmCAKGuO+`>B1*
zqUf)6b-Jd;m|4ofIZyPQ_}5q35wCtQK7pf3VvwNZ1WDxxP&7dGalL|tUAm?|lNoAZ
zEU$jl$vsiU+@eauQ~j(sIcjt$Inp(yy=P@Gxya}bbXGW=&hKwE)zq9yXAKqjNn`=N
zhoKsd9sMPpva<|OBVh-EXxr8>st+GNP=f&0yX@><-njBx%!jQ{LQjNp4Gi621qZaB
z=5chK4CXJk;C{N)-sa;WsxTRMF?5dd*<YDK@hikz1)fdk1A<s1>?|vDSvENUlTULZ
zq6gfqE4e4r3mWQMT@{zB-RuopEq{mtn?pXI+0U5jr46rwI9J~=$Ijk`D!11pmgW?b
zaPGjA-?l$9hULb3Xgea#vw}iWv!aQ<PV!q>-+eKNAGCQ&riq;gvCpcKnTvWz=sV|3
zH%grEghCk<X5$^ew1{Mt$sOkN0*>|WXUs5pJ5b<!+hMky%{la`v^5KG`+b(;K;3T$
zaMNLs!D+A%=r3I<z==pnMUmdDsAL7TTmyrHtu+k|LW{~q=d)l##uOG7?yjrJO4P5h
z8F?5S21UjQ1xWQDOalLpq7q)dm&F+{@o8gGW&21;)1#x0k2<(}zkQ$zGpww2W!vQ9
zJ8>~Xh4!s14@oqyOs-<ImDTP;o2{J!l-b;^#5Q90K?ZRq@<|Vf`5Uph`xLJV#{*;T
zGBhDvb3pQnL7sMujNQ)o_YayJqp5{et`lcCaq*fXW)<AHK48CULrI=jscr$N<pq1*
zcu9oNxk-sGE_|u!w=b%pC$|61TL&Fr9h90H9Oi!6VWuwL#E0K4q7MYFw@uq|4rlEv
zqMEjgOJ?VD!$9(=t%Ppx4+DF!rxL0X2#Jp4DkXRP0fDbNL9@O<h!KM9W8i8Z)$V>o
zPy(PY=apX(Y-Lf4;7;{0u+Q?8J@?gBy|IcK^<;m;5`Rk<nJSKxX0NMy*_OVV>CZLc
z68hvXp=yi?_Zb3nLW)11?<ZvGB6;Yc`uiDm)OzSxFf9aO|4->r*RY|cM2P7<{1oJd
zr>i?z4;(llxAYV3?v2J_b64N<Tcci2w1UT%vwrUOo94EGIUhbj^Z&&c2W6dST*6y(
z^-eg4iuBi!NuUxc;$>?MxObBP>0=Vh{K`FaX<sAFbAyA^P1<rEdDhh_d3PEVU_D?n
zW$Y?Ao~A=Q2ikbg6+!uJ@RQ%szGb?F2*|r|AcpoO|INJ46TN|7W%=v<D_RlXF0-H&
zYthNeyQjN1<bk#>?^euL&U_HK#+Wj^3~)i(fXn50@Y}UsUVFncyja6GZ|`L_@ri6y
zn~3hS8H*uym}KK-jZt_ADyEw1L;sBCDNm_piZu?jv;oVs-7;7~{OmjlA{0;#)qV_#
z0z_s$mTN;_Uw>M>p*(&zw^r@LY<mO{<^L8zPEOuvxYKT5(Q-bd-5rOmRD}P-XA-=d
zMN&B}44b=f`T0v&<_qFmdo!~tDl;iE%MAEiod#Wo^4`$I^W0f-Z*(^zj8$CE6#5Hi
zo!`c;&-OLh8idp{J)wGdL(l-xI(O#OKoLXnBh7CiY#?hO5JK&#y106H$hVA0iq?KB
zINPe$J>Gz0`lqRKq>%{a<k|i!2)YMs1KJY&*c{*b*D2<Um%k(y@skNc_JUz37D0~f
zbM0n()6Y67((r8M37TzR10}OGfS1ws)Y&(bJI?=?qu<P_<3E?K>hL;#-bCNTM4UMh
zzvpLuxX`k;5bmobnSMquxM$AH7h-w2xfm@Y2Uli0m&3k_q3^!cCFiWvtzD_AZF{b0
z%(bT4^d|9%iH=7;Er8ff`}Q6pn}Xu96Ocm;)91w<*ZWo8>}h9T_UG}(koE^$Oa6JU
zSJ&9v^-h7Q?931lE*$_Q5(<n}qA*;8L(?3;7pZ3EOzm*~V6>Ns+y%=Sw!R?1H)HQS
z9+%bX2F{#}yzAUk^YZX!4<l2Qa7NKkBXk>LY*#Z!cV-?Yo=*K`!JiKpS!opF0qOot
zIAkxoN!QR!>uDdlhxj+4yU|1ub}ZW+cFpQ--l?4rQSt>iEW}*Bl+cz`p}$gE(*3Dk
zN>iHSi+^aDV?i`sKNr+xA^tK#HN1v_-)k(b%a8ZHl|jA0;^vu;+mobJWRHPL5^@4j
zD-}@!q`4w&t`(#rub%WS$O7FyN5%av&N^<}H<uwthDG|VBa1bctM0L_oW%5bN?lP8
zIM~v8p0oKg<xd(GVwE*^)G|1iGY;dLfEZBS{O*3FHm*&K<~9N70ieV0-q|gtR3rTJ
z=^W&)K6}kz2|_}A1hOv{a6M#06>7+TS5VDQD!q_hrSjdf|A*FM*Gf26QWSz#K|nSe
zV$n(1;hsFiUlLr+qsJy36x}`{#mo%#)$fsz{K;skhuS^sKqXb@j|fQRdWHWuv32nW
zqte^nb<^Dv;nJWgIsXb&E~wAT&lNvTzT-_tDGm$p$6jfxgw%(%IN>@sw(Jc_6@03z
z>|&OgjRnn%V1I9*Jz<vkvF8C3_Sl`KLPFW66NYV(-l!RppjU~T@?hu8hx@`y%pDMy
z5@gOzw6)_8j=c5()2P4lhd%`PPo(@g^HDdheA&s~&Xz2=K>F+gM{(a2BYtCJBc{gw
zBC=s~$il8nXZjpB>_mc(e_+>vdwhZMi&_<)VotoNrqGrdKzXsNYAk}@yL+^|(o~;z
z)L!**rCxR)vsau7!Xj)sYKAs^L9mN`XpXqM-I^?;1c2fRd*1#aXd$cuV)u;CF||^w
zE$k|&p41|FsGn^&SmM6F<T7(gocyvZe_b2$rcv`!#kcWswErBGkS7m+seL3f%HNW^
zjkddTC2E<cAI;S$c#Maz_38<tVei-YPD|JRM)xB)dSGT-dpvJp{Y6pj0fH9Kp=`_R
zx{896!5fl%|2352*`Pfa&#0rDJ0ZL+h|TEvi-Vo+aV6ZuPp`$cg%YRVDTr<zcd^s!
ze>49F$xkt3J4@9po<6uB^%bMxus?tgAc65Dndt?^%RW}aaZgp%sIfn;3yubpdjV~<
zG2PXkX_FL9xN{z19ZxI)dOGnHUXE<uU~YWiJP3R^Ji_*Ae=j?yi-83aRY^V^Z}x~l
zDT`D`Yh15S(y;pJd|fB0X<fkdE;(WCy6n${sbPwEl)Nl6L!o7t6JhCGK&#Hojo(h&
z7W#}-4!`<w1`5VFCthMB>Wiyq`<_#%c+0oUCaighVD;cqbEgUm0dfP}L6iVpuju~R
zKm92w=>l%;@gc=yGx~W<FtjFLI{R<_w(`g3i)T&8&t2E~l%}SKn;5UvOtqgs2(Z0&
zCvqsTkn;<<3S{+~bWa{NdyqC0n9=fDF+^~ZY_NLnhL|3A(wp3i>hPsp_0QJpMivxh
zLp-N!cw{Fa2cW1B2&YTRd--uOFH^fmJbQ$T@p(!7UOedE02rc#QW5Cwr7v@rSRV~$
z1Cx8G#uDwdm_IidfwyyeH1~`*0V-~|6UPIiDerC`X^qdw5HA2QMR`hxsLe~FMk@o&
zjePP(VVG*!x#t}}534JC-aqW|cdA+pPDw;+e%{liTO0P{7Ri0K&*0PO^DU=uxe;<-
zBOmEJ`rNzhe4`C$5)&?rNcDxyYwzTTRSt=h*IZHr%?{ymP8v_*9ki63R9*^!hg3!-
zeK3^Tu-jwV37*=Yp@_wz%QDkvW4{tgNybl|OxW3~bAG(W8j}!C7LxPo0LcxCLJ#!%
zihvEE(4Yb`T|gGf;!1l&XLf8)>rY{l1}rVCm3#d<UEdCxqa9zuoEXGtsGiT4caGeT
zl>@!QpFl-q?w+v|EL+piPy{DA@nh>=ta@Oz)AJKhte{8#O=$h2&}<4f<Lo2ppG)r4
zfMp}wJPl7S&UBvY#yiky<&&|pLKvFqce#Z|^){iZN-A&*dyV5Ut)Qb`_A2SK@H(|s
z<1gRnqv-Bezg1G$GehEF_*F69cWJ2;gaRlnIrD$S-Dl%^(}y`oX3n3cLZ9nFhNgGa
z%pvQ6TUjXHQjb)p@^EMv1Sjc?@TAp!XV%(_KHY`1qPB*yUGd<PIZEzh()@~-E2I;N
z*e$6P4PLRH<>PPkrTe-1)LgMf5unK{boDix$3tNQ=^m*b);G}PciH|u>j|@?o*XS+
zFHhqNiAjx=2kOh6m_&4A#Q^xt(WjI&LU135v~ul?<aDD$kZ!Z6K#P13UKGtX60ZsC
z9+xL{7(V`abnq~PzXdy9G;;lb>(*J7BhD0w^eN^MeYYl#+3I1CxyT`oVG_+JyL_U!
z_>JiS<$Y=g3drP3E`-^Kl(pA<s_HewVsh?;4g}QF&Wzhabdy)80w{4j{I6rW;;S#o
z4~>>c`q!*5`%lKO{LyiKF?!x66U6lKY*4l{+VJw^0XSIzK(r$m9ORxlOox3T1zD{{
z<yz|_TvoLYSf}**x{OJ-s)$CqK*MDU*qe?5L^JC$1FpB?cxYdfKeg;B0qB5(BZg7^
zoJmRiXEY~D>mTY=->BSdUoh(6_PG?Pykr9-wqRNBcH3gDZjQaln`&1;{9uk+3;xEw
zllc8#G93Ej)#)}2UsvZPvt;~g9Q;|2>ZAyokHgy7KdyA<e`PM=99z5$pw+Tl)@x^I
zKLAUu=7e5wOLOeuAGYtmrnB%IOka1t0Vrx2vO}xyL3dl*<<E#drbcjiTQ9sva<TM6
zPvD?L!@zeHlSf^^+3IyeT1Jr!AR&D8vzEZCoue4-!z^aQmT9#q(_C%E+`bj9WgOp`
zHgtcEE=G=~DyOPLXN>7SOJj6$w$P<q`#76x<u(0gYi>;D%8I@7<8RF8IF28*O;^{w
z-rC9WRo;(HWc-1|>hHx`{>h}(<77*JQ<O)IDs?Nv?oSz+WzQnd&6z6X3QD&*Da%Gk
zs5~ONJHao>f44e^Dv{>v^Dzw$%*4m1gjn6*Jh}%Ow5jzzJGyx^J8-Mp{6kA|nb&g1
z6Wb?_78Cms%_*0x&f+&+5P6wc^sPPQ6>9gi!yvBrjfc6|aG1ZIyJ%2Ad))agLXO->
z%pYA|*i3D0gZHu;PHDaJ-F&~8-CDEJDElL~?#M4@8N<&6e;cFm%6_S>35Y_Ak(b~Y
z|E$C9!Hl3Q-vVb{5-G|>?UyV;o<DdP7R&?>E<Bq7-N)gF%SyzuX+PR)LDblCB9zPL
zJ=b(g`^>ZDkFGaBPi`iZ8MUq63953t{LDOa!J2%1!xQ(=G&!IG{SM#iV`VtAz@yR6
zAOBOkL<}vqbPMXh5U7DI>Z1ajHGfFBLV|)W*t6+1@HX^_6hhF80x-V|7dW!6SdDGf
zRV?JI6%4{<w6zNzM@OD%TApm6p=(pU#%0E0U1<=USGJvH+_;73uz3t8)~LFUo}T%M
zT`#4tyGd-gKa0yh@H@W3!^h7{b%3-&cu+1Y-WM8WJEHArK}KV~b7Hom7jm}OS(d{l
zEj1vL|LpPIi-GEYn9a6C57L3qpgZFSU2LDZ@!D<d`4hKK#h$~V%^zmBXa><V$gT1d
zPit{&86sN>O@szQXGf|uE22;uuxsDX4`~=#E`-i{hYvvyU&ddhvZub5QH+qxjsFaS
zrV&X_&OKaq-kU$%f#jEy078Z=Wq;r@JOdqLUhfmUSN_ovMQM0a)g&vURN7C-4cLkB
z7oc$}3<NHzfC$lI?w%<E3T221fTZ6q4LJTU7hn?yg0#F=20hr4uif+YwI*UAgE6~4
zvTOG2C%>c(3})C)Hil>)KsrKkjJ!_<1OvgR&Si97L4v|}<@XA4ls+Nd>GVL7w9E%d
zmhivM8U)R1Cc3X8`E|q}wll>pFws|a{T4ey3NoAWz8d6!1OXLIhXvrGO1anVvs&ET
zEVcv8(OT|9d`>qjZ-GFe?G}oR;sD<OZMZ^R_&ccBEB8z<ufrdh-Js;7$Aa2!;<<3v
z1!zevbHBy%ZSS&uFZO!{h@t%Zk0E)GawreC+D0<UmwWB{e8TEa@Soo}M`9=`3Z#`)
z7k@A99|pBhh693)^>tj$i9y}<2u%FS61xRQ!IFa$ugbYSTnG<#N2bbDGEg9>brcmB
zzjf77&6nkT`Ap{fB%HiSLuaVwsk+#k?eVQ1dR&106cpOk=g(@*zfs8V_VoRfk+G2D
zD9XaZqOMa?)=$XNcvd&0InkQP6cIN+Z!Evyp{6z%(R(bUq^@2+;qc1J%3U$hxRRMZ
zC03O|r=s%CO}0ClTE56GD#07T&Q6eT?Q<TNkX?*Jyr7rk(b!Q;&_f<O`J}ppBKB}r
zbQd)4=jniGcH_ffNDBx77X}opxE=?K3r0Hiavm@@k&Gnp7d61a@qn~Iw1GGZRmsWt
zk(U^)j9kM{$NCFaPEO8x5v|gz+dCG>Jn@XXXvW}EF!XQx{(P5{xg(mntp$N``>533
zN7#YjbGXl@a>1B))r9vfVNADHZm||bN`~vyr=_HHkjNegQt`^Hu|e=+Z2{b(oT?uD
zE3)qo1v5RZoQD~R00i|ZSm`At+kAn~EG2R4{KiRC4WC9jkTDs6Ttf>zL^7gR`JCd!
zXw)l<O>rRfuH{oZs*SOSM4npEe%Za7T12=DOd9HkZT>V!vb({FKD*Eb*OdO>my%8(
z+PC}d)lc^IAk9Iu-bPxk#Uk`}qC&E$`204TbF#v9+n;!;zrV7*!-1C#O3NT$<0vm6
zsH?*jD|5B<;o%&eDBSq|$~toKg9D@qzIel5gK!=}yqVmlP>#os`OR8Ge?A-APL8Kw
z9!h&PmqJ2?vdN~wi`JoE{rYG8&?ADK#*y%UUz#KZHgwsB@88RrDvqcG_lKEpKCjQj
z*<@!JB-eg=zW3@WN3T4amCV+B2=)1Ph4w%~v54NIKy59_K6cJ)cp<u5m{CT|zsD*p
zTe@dTj{;fC;N6svasm`uDHbZMH{Mw7F@!`PG&M}O<}tspzFu2@lpk?%qO|VkdG%}O
z17XUC@bE%TGWa<!IdSlOfE{lxGgac7w1I5}aNU+qqL-NHvAI*msCfb-SS83RhK=NI
zu4;K#vm!M|!X<~u^^E2nTq!U_gBm-O%|3J++k$U7jIti2$H~R_XBgpcHk0y9DwCNR
zUmW?eNYn=4c<54-l$_w><Hx!Sh15p@WJg^4tN?NhJtc~r$hU3v16mk@z}S$Y>WdS(
zpri4_riB1}NK&yH+9%W{YEW~GJfGJyao0fr{}Bs(7wG20B}w|@4e$<W|8}ctU;ZKc
z)!Qfkd?gRxS4RzgK?L!lYb|0Wj(F5ozA(CaQ==IAVs;<ZnQs4Uc=$?T7oQ6&(Yp?2
zzXerJzy_pDO8s&84Bv7J5ipG12mdoy={i(?8k;AZ#Mzg1Em-oD;6Eph1Gp(2+U}G=
zO;Bver@UeY*|oFu^z@hoM^D{sxJT2%s)N8Bu8v7zu^@C4i%yksThbI%ZstjWV+l#D
zFC-mG_n_Uj`1(QGK%F;e?cL&R;j&|XGGwFcrcgag2yG94A1DTG|5W%8uVFPQG@Lcs
zj+B$LVe3HopuwY4w87;Mfy%8-?-+RMlA_ZkJ)0+v3LVHL5K#f24pG7_Y5k2Bx?i9y
z^NjN;%O|zYN>*-xr-YUKTYK7CdBaL17yYpWgfd7T!25MW8@wuGRQJrIigBSlf+PNE
z`Q&IC9Q0FAGCcAhl>C6*)mAKl{RN}lQ<kxN;{^B}^}HbK5~e@aR4$JQ|D2>MeVgX3
za3Q@+C*O?!JniXPC+XNRNk1n+rx7r2fKL%GY3o3YvqP$yKWA@f==V%56A?@IW1@X_
zn-8U*c~MK+B@VVxd?xC<<@B}Dv9SZlr~Kl;$DpoTu@49G#It<h20aH(1P{$u8eCSd
z`8}21PM)>^TbMSKOZ$bpclQY~QuE0tyjfI|owIFIAEE>eSc_Wx2thZSSg7+lTCs!J
zL-`t~NjsA%cJKz!n(^r`#iDIlWmA|Rr}--6PyckeFD*mFk}_B-|K+kAC2GJgH)v60
zWga@G3u#le5mKTletKOy^)xX60iXEPwUI~LVi_S`<Fu1o*o4lE<9*bbrVDdb<`MWO
z0y&qKdV<%O3o}HZ#n;0lf+VD*v=AOb$ZLVQTE%hCIF+$xZr4TF1o!@D_n$nZD2CKl
zQF;T;mt{io*+lVs(--JL(j#@G=CuPn*?}9u;XN-qNCv6VmT+xyI!z#WtaQwGPMbdk
zeHl5ZnBK<*X1d9m_RiOzD1E?v@4BbsohJ)FQHorTNj7`qBE2_&D(d^yBjbaOd;jL-
z(YxtfCVKkpx)27hxanUJguWPWe{etmVe=;Yt3dI04VnCsV$AlO-eFHI;Mg5CQKAQf
zK){qF_#jbqCXw#t?+sQdC%WsUqgkxA&OdsAh-#U&?C~nE`MnA6la0amOWh;XkGP>i
zoaJA`S=kD=o$KfJYDDDispsq9v(7_~T`r`Y#1K6B^(mu(WsfG9np920^NF#t!C?}W
zOu?bL4&B>Q8n`GA=5PdkvQSm-X0X+jR)AKZjMKOLu9}%NLFR5p-fXx&HF#X|fL~Xf
zKJe|mANoQ{rjE<xJKwklWz)hPU|@%ar)P2a3;qFp@?nHQs1RIQiRRuvt|pB17pRxC
z5V-7`Q}H!Ga^Ui%gNh>tt?PZT^$gxGv~+^}lX8z9R8#vNC|GhSaT4H4e6h7%{krL!
zp5OO6!?!Jxtff&#M)AP51oc<Q-r)<rSEl5?f0pMU^CT5w5p=H2b^_3LT;C<Vpc}Gc
zDb$OUXGFthQLGt8t@OuiB9P6u{TZSfEf0qWRihsuCIcAiH=@bpSiqPF1fef7T364c
z7h~z%R#ghnYvRwm0Zy#5i~5xUvHrC3F$yrF>gwvYhhOeq+EHtt`9P+cjLTsFYFL;X
zjRPW#4@qKICS@Hm64>=TypB3ap%A1UL5%fKrufWnu@MbO-;JmT*ZlX!v3zMvDtFjH
z#?05Qi6+F|6LEODRk$Ap0x`LujS#j>h8;MaZWM8*J+Y9xh>XOtw6p{<i#<q2F@2q8
zYwkl1fuTrQI={VcT5^Sly$%!2-D@3Zc^w@?>H4hLxyJ2RuhL;GbD8Jw!{6wLKmBBz
z2s@Ajyrc+#%SA>5XF7OrDCj3~z22RvF3_hcYAK>tW*g;Bp@HrFI2n?JSpWlI-R|%*
z>q!wU2i#QPa&I#VJ}PgR0S1yv$h--Z+My7Zj5nj`x)QCPXphGnjcRXXs$*BUAosK(
zbbZ!=cRSQ`2U|AkqEE3dW}@t)E<7ARY#YP2M&^<OejAvzAH>L><{tL*4xL^C3neI|
z4Ft@6rrv)NDA-TH<zf%?_Rd&XVSsVTsccXCrOnS!HDmJ+13+*0&Sw!_{rxJGL4}du
zj&|Wf8v~Iya}U~;>5t)nuo!lCJ=L~P33?wBJC>8Pi@76v#2xG5PJm0Ak(l0XU2T<|
zFZ`|6+bCzh6*cJe^i&NZVvxivf?^(DO)4ksyX-9V?(GkXH#G%6f^zjj-!8nh^BBUL
zi#<QXaspE3?W1rpQ|z4coLKsobP?s1cSFf9$ZpG&N5%Y~iY}!*VmR6#EW32R;CfwA
z{0=ANj@r%HHinR=#y&;`s)iDMMZRODx^k(c46hr^$jn?MmwL4`T4Pq68p`P7SC6^1
zwWTW`E<6_;xhh!PE#%CjrdS#a%#(2F=C-NY>)V>3?T+=L=F6*aX#`g?g^6(6V=4jN
zJvK?(H!+Lyt%9|nv%0oB=IxLCoz$6gK9#LNCEQfOS5BiP2%m1p`Yao;7fV@LF-=uI
zqR-ClKyh*{@g+{0&_^BPi@BlI1v>k$PEEz&j`6msKYAWGQU<*T^oITKbHLa*LkUuC
z%%xWzeuLY-3K_KR+~S}fC@c=?c@}DDlxL@P@>Lj{QkQC)-D<8i7NM<s4?;#S#NQOB
zCgu`kI^1b+k)&kOSwCQ6!8^U}z%syUpu>N-=T({8ON`S*)=;HqW<0aw#moQYjz3kQ
z1?q%2GY%dPpkgY?_4BJIJfnrNJ=)vhEEG9VxtHx#r77DLSjR%A^NeZEO<%KFZsyIV
zd3C^~AZ__&MRUd&@8JjDupa5GG67sP`@5Zu5)kHdQcFsn_*E<W$o;;}lxf+((oyZ5
zLII&tStp7U0k3Mcm?k#$us&tlfUclYcD}F{>#ypA{KD;hpE-5@ab|Jx7FIIsJKXje
zP<<cJ2Oci&ZbM_BkR9{lXsEvL&u`LL0*DuUub%eyC??P^E5SR}V!GKoMZnknNzl<*
zn^W=1$y@l^*CE{xDC({5y$!He$?J(d1Ij?6&niNlGSIQ!S2V~JXo3CQdc!<WNEXw5
z0u73VI0KGmmIk1(IJ)E}pTKX`Ar0(RqCd9YBpRf!&;SKJe)?k;2;eQZHE!jn(R>rp
z@&%MO)o~Ks);A&<EJhgx;vk2Rg=pF-5zO7aRWL&k+o_4)nUD0>?mS8;;@{~9*3_m5
zz_RstJ0T3A12Mm7kO}0Q%W4;~TESRV5yLUq%TSZa9N_Pb+Pu#TNTbqSPA|f^{Ho<C
zoU>36559;(EDQ3&PSV94^e)IX+?28id84;D&;gO_B}5NZ>cxv?b5PdnT0us$ieX@p
zO^l7L1g?ZAQn0S|_S(5URC?MMcdx2W7l_gZJS?B_jPX%Y)l~seKYsv+y9@I|`I_35
z%Pgkt?t*e6n-H>JvKvn7Vv=aQwz8i`Jdl%-VN=whg&syt2)}%Ea$rCDljXEQIDO%$
zv}<<yocglKVql{}R*s?09aUznKsQXm@q48~S>EzFJByzuX^`j_pN-8bNe}cOJ?^`~
z$Ecf_(RN^uwwuylQhf;|h(tj=2?=5V^g1HQPPAiAu_MTu-uI4rYJujC7eF(LroG6c
zsf8s7N4~xnyvou%c|odH8(LQb&AGd|HrG0Zs|t+H#`NwL6<ym}v4-QGV@&-9sZeC(
z3$hbH?Ri|{_UreWeZ_5u2b$w=HD$!vSMy<mgZx10GtUFW(j@)7myr_D8W?OI2*;to
z5A77EaGJm)bNu&q)6D1jX1*UbHO&PfWNbCb6kuDfrFziZs|ppvSu!2tJ3w_dxuq1R
zQLigr#DXk?Act`q?nQ%oSXI1;vGf+hv5f>GW9jbVQkhq>Rwti7T^{9u7hde4Upp0}
z{5=bAL))@;<Ye6)d#1z*V+lG;+x{ZF^r?#X)mud^3Lh#${92<<bo3VxULY>WdyZ+J
zS$q%u1<Hl#^g%9cqOM_a)GuD2RxS1V0z{rKrC0=KG<1l(&fk{Yc`C>4A+x6FpTtse
z#=toWrS=1d3Mg_vRLK+*CWJ5}Bgx`cOgifJIb;O-=Cl$NoqQeZo4Nq0kAKp?UJlqz
zQbNw5$-5p+v_Ru<2EqdX7;F$Mn=H&X7yEc>-D;$VXU?Rr8$HzPV!zK6fe&J}e}+je
zQQ8S1T>tFJ|DztZ?Vg`}u#wQ8Ar4YKP1i+9`s~T=^vvK^18Nt|uwAT@>QC+=xHlSf
zwEQy)%X759FAYNI!A*XS^&(iXm(#R)x}rD<8Wc_h?1MTS>y1>$ZXO0bfRwrmQBCo=
zHsDAZuCeF)$B^^pOXqqSuX;4utBl>SLkhQv&)N=L8>58-fL<h2hZ<{%E-0&H`=9!`
zGLI&4h`Czs3^#bb;LjITiKOX^YO{rF2fw{{!;E;*%ue5uX5%3(`{ktc-FxsD*;(jD
zr}+$f&|OmN+|bgGv5!~lXgeMd5B4BRzXWBOGJs9g+9J3f2SENt#l`**F$Q`g=sRdB
znzI%lriTI|2yIp2L5+`@oHUFy79+3=P__gj6=?ArY1?Oeyz8M}Gdv%8{Uu=1oGr|D
zOyV9A>-ndH{gHYEN+@+anJ9dMk@-_Gk5f)E8ZeRPlasjUEN$MIyAv?R9zQbnE|YV3
z#ID1(@1)?|M8I~tI<`n0Ir6DdZijXFfVMpc=@0jl?c6yV#NZL7@oxjsMS|3hoR3cn
zcx2n6{GNa2QT12GzUn<PdQ9i)rI55=dYE7M;>7d-$K0=GPqjxCviQLa{Bm|3w`R}n
zMLn#se54MnHZmi~eEgc5y}UIb0Yz3-KogzL+1gSfC1Y|4n=T$@*S72ZfY@4g1KK0-
zZR7#uD%+K1y6@#ux1zTr>}!JW(Oq^_OLJ$WG-$`$<Y!CsKHMTpqC*}UyvA8cydpNq
zN*3y=>OA*()zHQurHBejVs`X(oxYQbrirh`lZ?4Cc$<O)qR#}oneKt-2KnNTbUP$?
z{x;Fn$M#<P1BfY^uv4AZUfp1{#(KHu11wzqj3|Pf-)6N>$5Lu3rRr^FOOy=K8UFn)
z{>XFvC8q3EL)}AENl4p-Fl*)C#HYe?&<Wyw?d7239%DJ3sVu|w?-kKsBk>JzVVq{w
zTf)#qo8qWv4=F<w`%JXXnI4n==b#e=C8&6v9hu_3gFLDy2JE~XMs@vHz<n|k2a;s$
z+A9cyFJ81(JylP)gplFSEMhKYkyuBhZH*Od=;-R^7ZenP0Xej*)(P+Jn{B-|5k#6(
z>lPXWX>oT9(t`0{t70#7ymutc&e-P8-4VskLS=Ujs3PmTZMI8WlxlrjeylVbB(eV#
z&yqs4-J`;Hqr1IJYb<*|)3|L6ii648v|CkCpptT2JCQP*av*b8hH@C2@Xu@-vS<Ax
zQm9`Xx&)xfTR8B|Hhl3H9wn4rTkF~Pfy@Dz^&x019`FaPK4B1~ny4pmX}fhR;f1y@
zw)l<(9>-;^L8V}={uiVqBzGO#Do0<6J7j-7qR%hpsufWe69YnzugZ+-%S9pcfr#5I
z&|SgGRUw>hRX@k#zCZ8XmOzeN$hz1lSea7t$uZ2gXd{=M8!TG(DD=}=Xk-}m>jzVd
zLuDENlt1~21}STq&TZ`K84`v_={$rMf=hi(f9crv&rbQi?<i@>`DN4YJ#8yt?E6`X
z3s#8s-E^SBRUK`c`cLfa1-)!8mf{;kw-V3*E1JW7|BUU*ctkFF$v;a21g_dna30N*
zyNBZrg?8?b?=tyRdCL|(@Dz^`g~jCVbG?V(c}!(;_xZ6tWl!0pS{E*QFmbf1{h{xW
zk%@mN6q3ZM1|q!H@OT-I|9=Q&`f9B@5eQU*i=)vXO$&=T0K}f(R;gUSfM-FR^(?3M
z-iT;9J`zmo17mu_Rt2{Qq}8Cj;92rEm{a!o*>Dn2@LOB0Etp2eD8(Y^5Sg`SAXfMd
zjscv#B&20BQ6Ts!faFzAibO2|<u^Ipk8H+&VB=)L-1bX2;K1(#?`J(r&qg53XlwgL
z=m>tB20ca90KZI4(jD;tK%b?>dZ<C+>43U0rJn)d0oEDk|A8XGloyCZ|1U84|Ml*-
zqdNq-O5}fhoZ{v~_LL^uU-mg0J-Y*3I?%wU0|#1Cjc?%aH|#T-xc4MCrbx&p^vxf6
zbl9A=``-zvL<N=%a0+ZuT>iCM3VYni?X@V7#}J4PUA+C=)9jkfMB*zgQX`7bJ@h$A
z9F<|`PFLjp+rE$F<aMMV)4L(~OtKGjth&PD^8GB_)sS;MQj)|A2%>b4N$Uh+(a}n&
zgHuRd?*lT=K5k%dc~o-kxK#;kw7QCQO1eJuL_tDPHqp#^gF5MtF)OCvR`viv3ZJdR
ze_+;&`+n~LRj6Q@#5KE+>o<Ff+rV+e6e$ZIRcvQy^W{rJ8`$LgppWla?Ub8f1e<8>
z{gg)=Q(OivXBU#y%uL9&gb8b7$pIA^spu?VEIC3@A(lnk3i#gQfP`;RKbK)83*!_A
zyL2UaiC%>%8@(xn5ORvP1aYPa64i0f0sMo>QG0NQ>xS;Vy1|Vi@r=RKX%_HVED<M+
zjbJqpN;h~9>6+YEeCr^STS8Vh%DXY3tgg?4ybo1q51JMCBiYM0>FEzpzd^lzEjwGn
z{Ukd027)1zh1+-#H^K!^`)CkwzK3u@oblSN0F1VLa`jPzb=*XT<|ChPz|G|ms-de1
zSla7Mw2yuC-rwQT`!v_le<oI|K2iP0PVo5m;wDGC$%vQ)Bz=Cyl$Rd~VTOnIXmT7f
zH-cnR6p~xCodq^-f6(C;2HDJ({U9Jr75y9%0%4A(6f8HRhdWx8+d}B*r+{+91qrvQ
zF^&{)uiw1@5j@%<6haodY`4!3;)}VY^1A1cT@42>o0SpmJC;^}^Mz^eSV5>pBqheF
zVSjfZOMZaBq<!(YMlIZymWSyZ8~Z`pRUqGHUQaQ9JD8+NLj~Ybxg(GM-Z&0kEZ1{0
z93*P<q{cvtt5Bdq{JD{J<hj!%G-SP&#qPe&U+mI5&k37cysc1u+(`;xg3nc)V`~`&
zTvmQ%{xIix00Ed_n@wR<F&9znR`E9U(1!ln(TWTG+r4%#2ylm)Y_GI{w(||-jhH@s
z?n{dG-VsS#EFHv067puz#eGg8kQ+D*k-6#Gs8%neDVA>U9%N~eS|#{hJxiW!ny`&e
zrdL)QH%B<;VdwH?-q&--)6Y!jhl>u9lfdEok<fjtcW6EAoU?RHvN7C7Cx6&kIrz#3
z6~O|wjf~epJ2wkiC=`DN^wf=NNIUF$!1b1$$>?1JvacN-xbPc|bh;yZsFM2rNG!i2
z)E!9WXBPs{=DZZ$Ap;}{s-KXO(pV}yrJYqwVN~xpV6$~p={#lPnFl;hff<m`cYolK
zn*vHvVa`IkJRcco(RehED4<B*xxCz0#xedyk2#0X?O4fUggWCHMjsNfIrDT<=(I28
z1~~y!7JKSW@EPJ79{LuZ?U=>f751b7_U^*}<pQAB)@c-;TgiaNLSD_IJJQ%1pC;SN
zhAtz-(Q?~)s6F_&qu?F>5d0j7rt|?F6yOdH(5laW5Jx~m)2-B~9v5OxCilBl?w=N&
za{~XUPNO=@#QoXR#7F@?)j>93=X^aM*Nr$_jj3qM^*k_F9@0WIX3NLWBueUmE&&$0
z0Uy%OU}?HT-baD7fudrK32sVz272OH)$Yxaoc}}Ed&g59|9``uW0oyMb`(mXvUfS6
zBxEI<B4lOnqhXIEk)5)RO;%=Pm65%-tg`pMU#IWyciq?HabNfEI{zik_?*xC{eHck
z>$Mb0r)N6oV&wq-x-A;+`+sT3h}h^OC|&*zph|~B6|XtUV9r5Wg1a%O7bl<Qrk)43
zuc~>{&a<a$+H|s!$@V*7OOyz1x{uG4ov63TlSBfBB|Fgv&)=!q*zf_cg!tD-B;4y4
zh4gTsDZec;(8@u#T{S*wH)88VktOB6tSY(Ikp6IaeDJXZik-vNOmS=p@-?@$5}l2%
zOH~iQgmgM8HZP5Xto@Q<8(r|cUb#<e2tZ@~r0dt>qe{s`iL!$vwy8gI#NmJ}OFECO
z4g+^*og-yyYE!kPC3(17k6?mfrjR%!;ObYl_cDWzfYhut2396q^Ht~7-FC%IAy%}|
zVpZoz@|#$i5~WpHE7tM31Q%9_7bQeugsq3TwPdvaj+7TkAT_Dyaiu|>m}_JVwl7rH
zdb8mXJC*3VjjNei+Er?=CJt?7<+e<u-D=|3eS~kI@QG6T?Rpw&wI3Ds6X)h*J2%<Z
zNG6E!@5`wuXa#p{KuKl-b53I*Z7=wM{q6<S>ZhCLwX6-?j9i;yr@e~A8)ayVC3Gp+
z>MA5kZ}*lwI}qWa)MyZcty%4$k-D-aXL-XV^!T@B>}<qIJ){!MhPYZQkLUdOz2<78
z)k}}^{DiHCLCG?>oynnBQ~P&pnwX|$5^S0@Qmh@aa5!h3>vu%+(274}XiUE<CaeW1
z;tr^I0>oF=h#tf8kEXq&-g^TD#Z92%r%zvpuXhV}5CEURg%Q%4%Y?f|h3MC}MP^zF
z_zP}Kntx6SO+r`K+QcAzs?2sn&Azp`;{+t@k<|;-44=HSo>rOf$L_gA^Ba06VgVdk
z{Cp?!xHq;s!wpQ!GDrd{IW5f$Kh|}+jNAclo@H>1#K`4}xYWf88t><g6Mxfd9(Dst
zX1Pj!{L^E5&9MLE-BN}Z{{<TuNGOhop2MY}@8IpKNOsWYG+T8RAuy9x3vb}5bxN5S
zzO1<ANfOOA^Y&P-wG;|nT$`F1l=^$Plx~w{AVn<?raK?0Nt`11W@IOYC}lN3wuqXS
z32qTZ;1*Gu#e0QWk^g{7?^y=31D)Od`nE@7O`E`^fBwP9Yit;_WD<qVL!i9f#&>OB
za+W|O)3D+APdl3qaU45Q?ZkU#CSJa1UPBkHw<Z6r1wh|LCTx8UhO=Bo?3=uB+YzV&
zc5W}RWm83{-~gqw3PGfROt8r20U~-gz1w1;L(>b|XMBV+r~PIDG*~OGu^<7!*P2tj
zjJ^K+c;p(D{iR=&FXX7Qv#;0tRIXK${?r|=YMSmG>VC?D1BQK@rZ3?M5F)G~i@#)$
z=MvQrVUk-}>FF0BNr-T)+m+gk8U#E!`Q&Bm{4!AYqd3JIX$&jD3@5eeEPg%z(FJN1
zuK$#8r;seIoOSVpcBV6SL(|~TSfMbYN1lyU?j?Z%>Y|U~{(q6ocV-+O0<j{3I<)<=
zbh6vlSg7l-clhaj{Lkq%TKqCbgcY_|yuAK6LE91<C_PAVYy`N$w~Yi&Azn;zhW$3B
zlmV??TOH`F(I2KAVb5~&3`eAXNFw1Mx8<j|0ydgyETw#$=%hDS=7kC$FRLgkmcMGf
z_>(kOC5T#bDL@yUVi<)DE!&%ov;6}DQ;Ly%5V3ol<<r~!*!#gmS(6`sl{d@b!c}U0
zqC>i3L-ZXh94++ub!!EC8u6P*B&X78t8hK@Nab6DzDMm@e|e7RuQe4+#T{&(6dzwb
zU?0g&dU`XszmFX%o@rBGk-(^T@BTVgjG~Y*m_w_MWJ`Pv#ePM}qR(<+SF~oaaW$o#
zDLKXrma$w2S}I*Y=acK7{?QuoGD^0UF+wCAe>XuERbljaA-<G~OxX}xM7~=Qh;zkJ
zB!r!5g`3?I&Z}Ji@%`)4&6h-8-qWEXx%nWF08xVU8UH#;>Wl3GZ_A@OnfGs?pIe%@
z5F#xDYEET8O_O|rNWY4%!A|o;aPYJmlSx3XX6Ug?G&VQXlo{T-b9iv}MG?YPkd>sl
zwKg39+9Zt8MX@te)I`-*>w0DzGsJPkrMpQcvXT?tP~KQ<o_%DuY18#1P6WI*H3l_2
z4@RW?uzIFLf0IHIcPuqFieSGgmakVD7gf=y!fUa}Zo^i2OXhD!GX07VVo*C%bY7BD
zR`I-Yjg~fo^?lQ35c|dm3Zf-iC;|CsNu*G<1OmOkpGyhA*?td+5iqU`#O||N(rdbU
zz>JQ#FzG%BChk~r?gvK!kxbuEY_+cYUr1OgWxsCy63Yik5p&_d{7~S6oR{aFD{Ki?
z51N-Kg?5fp2-N5Xev_*gYpb`RKl=>W_(-W0z!ra|O?Bg3fM{61jjrZzF({%!RM1>0
zuDY>4^=4{r_kMkkJB#-kp_<kP(6LmWlpAhXHAmPao(I$OZ!652zxux*NTst6sn3xn
zGuN^sSwKR)1gHs|?1Y$T&bF~Dyu5KPl?VRW*RYPusmOYYMOJN0C82{~qZn}IYIWrN
zUe@ffr2|hMT#>y^ODa{rP($Fj-8tU>m2%<|!5j1Ub1H6vorCZxhM1t2z<{PV6+1*+
zdxN8pPL`qeE+PVakd-0~kw4FiYbIdzYxB@9@^Xx8_qw1!T=aAzPt&Qyn1LRQzLzF8
z$?p854YBG&8J}ZH=Yg-~eZhzAZ*AhT#coT1Zy(y<yy@z8>?EVnK!B`#+O|cVx<C-&
z($K>jtr9Pe|2*D;8Qw@nZ&~vrCN(Xs67t%RW^D~fF?ohGRc5gUSL=HGooWcqLRGTv
zr3l}~NVmDC^0}K-7DBPA(?HwywD0p*JiaftGv(3RhygNop1(Tgz1J;gKJo3L8W>_O
zr=<XZn57C1MKM!v_%{26-on5G?qcDazq6)ut~tFk?Gs|ZOP6I^e({u1X|EXWvT)w-
zlto`P@*IipOB<}*hR<aE?eyek4gSDbh}_-jsMqjI0Ym)I+hq*)Xz6ETJyM=kkCLT(
zOf$lNG~@k)NNWPptkXuT`LkYDGtA+@aC8p^4sL2IF{uls^E+RP?$qe*iIcv}lM&>>
z104<Nm5!wS*Z}F?)tusPk;lW`tDhn}+$R%wbMx*Q3F3MlOK#l9IIHvCXY_DPhb7&d
zp~R1gha%8uJt!;BN1~twUj2+BI$GapRA2SO3)9&Fx*HvXG%94QVM_5;C6C_z6Rtd9
zrPtw1IqPx!A|mwwi{DXQ<iIOESY$P>?N4DtsLB_#^K79+M`?8Y_bnzUwD-}DVyj#l
zC!!|Df6N(7{@B)u9{Q8|8G7E*YVywsQ^0+)Oyz6}Sz1bP*x@1X!<dg|B2})Nwa0(J
zN3?<Dn*?+ByMu>m0Swq7p+Y8t{Be+-J#S)hag=ghO^%3&_{d+mdaH{z2WK3*4;<<f
zMnn=uEqFj~hjP}9hMNk=2WX*)HHsUjB(Lp2mc^4w_-e%v0qEfBBe|6Cmd^z}c7_d3
zT$2ut#wIYLPL+zQcwBdwZH-rv-n)R0c&`N;{$&y{l5JkRXa6Q}Xzm&!O2Ga*?aENT
zvD^^+LDy*n=Xa}x(LZ{|PFx6-e;9ix^MEMu#V026Io?Q0pRuAv^pOEHT2siv;M4c6
zq7Lb}jSipV8~6y&_d8ol!~I=zK}G_uji<Te-@M&{#;#bO`J2+E7J(3bY#-m_La33|
zQTK>2;5k!~pOFGR*BxQZIV2f7OjgfhnGsR5m~T4z?MR<4E&l!R6I&I9zR6c<&r)M!
zV<iwrGXMIU)OTVDpF?O%F7YpV1kblN9%A)U^^8?D`H2Mt3y<ij2cH6S#LLewgJ1i-
zdE1iOZG1{`sf{1Nr}~!7T^mX$CmrZ8MTilEe_g~UrWi4X--lhAgZdoJpgtEz)>U#^
zVvp^=3-}WUNItMKTO3nG!fH9P?7vX835eb5#J2>F^{)*PQ@1qJ@tZX@Z)hgfZ?BBY
zoUUC!@*z@X%KK<PO7}yPK*&3fPkyjYq(RXXL=*ipik|~ihYGlE`8`q4OI!`3)%#V9
z@Shm2x5i7OCBB<(JpgYS)uY^(g^a1I`;<&A{?Wd8-Bt+#E|(B@RL1I_rx;X~Ala5y
z1x2J$>97ZQ6CUjot4M-a?f)i}YnoQml!waY1-L>jzy5!ua@JEWw;X`j@1TlE2lZT<
z6GR&l!u=Qf|09(fq8rp--q^eS2!wox-X~_r5uzcHaNobdehS8#(Pl07!d*KDu(ptv
zIjr8h!g`NG1Ex$|EjnZJO``BvJ#|M2Eyo{zy+^iZ_qZkA>T1xx#RTi=-5C(asp)Dw
zd>SHd`|E?Tx<?R$#|~k4pSPCk8$pLiilmd<GWCLUau>1!%`C7nk=oaHHh$CO9cb6p
z;cyw;Bb5sFr=d438?%EY!<K2m^HOP<RRl;6+T3HyxALtR|6`}xmn(YqRlhg#gJNoG
zOM`z1_6m^yB1V->vj*XIIC$_7!j{!@J6_DzV4uRns9IK!d?cQ<xr0J`>WA^htp2vz
z&2MA-A{3y=`2rHwS85NRHcDk+6&FSVizS*q%<7^7^u*l9D#Mfj=x&f=qE?F!eJHx4
z!FlBq?fhkv<sSAiT?4x#pX_#d+&+TN3??*45l(S<G-3SoWy9!xd(mLl9AX#xaJPx(
z0`phm7oI%(vtq<VsgIY_sVd#e4p)ETc5a67c>1XJ1w01*6iYqblj8mX{3Fz%1gjhD
zhsL{yBKzk|+R+T!muZpY%NUks-h>S^(fJtf%{beCuZk|HmG27}!u;bHqK3~$U~hIe
z0!vgyIyo_in8|jEtRD#y@@X`%T~E+q3yBvQJ{O)X_OVsfA)Gqyd+NYF^t)5Q{WZ4u
z#bhCRgGTsKD?@*K*}}K02Cx3xl;MPvnm9Ek47bImYHt!=Gx0BVv{qc&-ug#5|1rI<
zjuu6vmIaFvTIF2#;|F*d$ZT#e#k70D90dhlzDvIuobB-ygRzymf7E;hw|1)^T3e9b
z=GS@N(xt?2-P_U8IhG)~XJlZ}DT3_FyD2stFNWlqe((+8F(x4;?-rOti5jeJ&lvsk
zJXfoET2X$<7aPKJb)U`mzE*Q4atkk8NONr0uB)d;m*w99amJt1br^~MDRfV>6jjDl
ziy%5!@ds#wj+U0afhA{iolX}rhdaRGk;;l=zBJSKa=y3;yvnZa*eO5%ZR@JsCxNkx
z+8P87DKfGrn>sgdDz`dNQD3YLC?fuf#M3M5`rc<KPM-e@`YY#&l(+pAvsYbB3y>A$
zc_i|QV3z`O&TpO@WOnA^-dmdfy<z}Z2Jl?NRZrS__VV=9ZfqFxT22ao&SB8TrCCrA
z<lolxM`GgUt4%-rTyi$d!g8V{JKz3!O8H%IN)xG)W=-gO+&rDKyIw}Fd1R@?8=^qO
zk%AULHwvd$VF$Cf(F#n$wgzV6AvL$Qf{2(h@M_6F>K(-KT$!=*f`yynjN#vZtLN^%
z&w_MmY^i{@q<U&<N)B<vRhIxL@E|u4nx;@D`lY5x(=M0n=b>ye)i*Hx8crn^v3Y_!
zj6<Z|zf`7soHRbQ$6Ea^%OsW$wMT@7hZLRsWpnkeP5P8JapF^}aqzTCw^`WYwOOh-
z3RYCjrXzlWL$U-BmlD=D+F4wcUzp$)cEoGA6gDr07ATXklq_DRP^h60AUDj4^kJx^
z>HD7oA^j+g{+^x@8;0APH(E<>SbPhC87m!Yy22ZLJ-f>OYu|d+h0UCPeY@-~gK<Lc
zAsH-#S(NANoo5U0^dE5=%%#sVU8|X&f?cAfjrYR=jMXjA3yn7v^m1*9U)GxAxNG_1
zWt(Mgo0ZC@A>3lG$J|Gp&+PSow_YRvx1d@u&>|E-O4v3T(Muf!k|Xxy<*YTFJ_g*=
z)}+KJ&~(B@f(C(Cv-c`TuFIHPde@S(0#nV^=djU_U6poU)+1<_UJAyNwx8>K$|S#(
zkzgi3p{WHXFSFL@gK;pwy%%y_HNvS|exGaF+|s*t-Lh1x-t5318x)gvI+-7nKK$#%
zjT=;B-SQXnT;MZ{Cr|&u;*lUJ<1`JNaCa^1B>If9vDb+h2ZW`(2`AXK=~+_tWayB5
zH?-a^W<iCSA9tnElXP!6<B?6T0TKa@l$kovj%4NLN`Dg|3ux|3Rf-ngtsAi^^`WEi
zKhH78ja_*-!w6C&V$B5N2^IiPGQ<WysX;7KClIP8qqYu`;4A0$*<XnGK-V7RSsY`!
zL{Fuuq3>$*I6il3_`G;=+&M$f*Q((*r(D`Yu^l1&HOqL(4Wv2X7?`Z54DY$@E<C6$
z8ZsM|6d7*JPy$D&;bW&T@zODOtL@2pe-zT4uEKT*yTX!{4I2~h_LHOMZP;l1$zQd8
zHuN{ovUezZxlEo@SsFWX=j9ZM!)|AndfdG}dQz|sAg%YWp<*i(0vTNk2|@iat=_9I
z*$@Pce)N3Y=c~&Kea-Q+C#jk9c9kUye%8a;AEW=Sd_OToYGDBQs1sBZ2nIxE>#c)D
z=IJBcKQ)SNtCo&)ygX~xf6tlkm)P30pKr_~-mIDl8Li-b<S>>7kwgh=r8P(7$S=5(
zHZAMSB`~Y39apa*>|imJ(0SevYY}^nqibp|zhojzVtM}gL@f%zG);?HK^gO&k9`0X
zIX*#(zkZOxZKr^1sRy44r(<tvGU;dEMK2oUOWY1;wYJTkVEkEa8u1e>df>-+b?akh
z=ZrNUs88No#IiMfT6r4Ea1C#Zr1DzC+R7HxFt2NM(m8r6xbG<tU0`_S<<Az@AyQZE
zMgPLfee&0D&hX)A`!bSqe;AWEqQjyR6BARhygBV^=_*Om1Np}INV3n#v5%VdF*1Cy
zqJ)#mX3;{99jVUDh}l+t((nbO2D)d3g%h8)2ys<VbKXwQt@SwGn;Qq+@+0O<{WH`a
zN`NmqFNX}Ph!Lyg7<NCFkRv#8>3cI)zOcaiU~R7K;(e(t4bM%rrMyJ|Kv#>M?P^9o
zVRycyy*%x;&pCvbhbW3X6TQkiH|jc83gcJh^?i3hb?1_a<+b6q@;g2{U>k(+=AH7E
z%>#+|7uFZ9YAO@IdE4&_jHziaRujR%pvX$&Er*8o1c?g#Rb9px0Ri(oz<FHL4E6lV
z;?HD7bBf@Fv&WK;Dd3vqvKoYAeVe00dNf@37;Iu^w>X~vgr040D&xa5kDX8T#1Z`~
z98OtJ*dj`thzqrHzD<(0i)~LdCmUww-fVJ-ma`PyO_m~kRqtxvq;-m5==))tQ|WGr
zO=C{_7fW_=wYy(GADkBW7*oD>qbFweTB*yIVf%iIxyjZMzO$b{X><wI`&P3Qt|k4L
zrfk+k=A4%MW@V)Q*$A4NaGJNk!?^!V^Y)si$0ax%Mp-`dvxrSa`Vt}PmmlVGnxVrC
zM488~ayU$PxxL$lTAsf4qP^4|PELmFecmY36>kE+_)yjUc7<wwOAhPqvyXEPNIw;J
z?n?^Q3AV9gWONcf-G}XnE}*pm-1_?Q2?;Du+t-r*UR^o&U}OF1aNf|LJS0Ea?UJqn
z+AqU$)R9*Sd8RzGM`H|&=Li)-fWd_wqE`8p@QY>oQ5bA2GWOJhJKA|AR9(XPhhF~H
zpGXlc=6SUzeq9nn-FWG9j)T`0zDHL7eV3@_aA+_TeRQw`XZ>je`hzhdss@u3>vju-
zj{u?8$;2`}8lFs*x<7xipSHzGsLY>p83EU$$2H7oj+D7N1*_ydf!#%f8QLCRcCpzH
zkoDk<#E>B%cm0hVTUw{=s`dtQblpVPVfWK|-KHjiSO0`;;$t9r>N?Vv`1bO95Rzx*
zNXh^NA@^T!D3c!w!DqBGEgCH3j1%g--|=gxTGt_a)aHZ^v&?ZlB|m?4!1(^PF37Cn
zN9nQU9e;ws#Ov}GstL!qK3fk5ezBJL$WlnPJb)6Y&tH-_b=p25>OD3y^R#HfeI=jV
zMX)Nfu|JroIypYD<psjUwtbCrmR_IpMFwf*!OLE=l)Ukk9T^m?umg|uZk_kd8{9Ac
z*=KI!)fPVac@{Uqi}GPYCQdWwL^x(w>0Rw}HvGOi>@b&ZeXc!#q;08*Eq84l=1a3b
ze*QEMXnq|r+MjTLjx=XkLvvl&Yc1uL%?nF)((JJt%U^D=S#9lw)&G7@P7}e4niz*r
z%j;mtk*n-D7m8!9187}Kp+7qR!P}?l?f42CVe(6?--9hiz|XF65RNsm`5ewcu-<~0
zJ=8lx=l{>}rrbYxGuBjoCaC$a>JRvbI{gPZPMpF2AQZ7p|G6$$v|b?bo{Gvz)J1N}
zxLV(41u>A&<}vI|Qu+-1fo<S~8L69GCEgiv2<J9S;En(;jL?!kLh0IrvCZ8))4!ne
z0hak~0H1c%6SPGq5sJju^z801VN}I?<=EJ_pZ=9&^ABM+D1ex?1Q4hqwGnY~9wZni
zg;F(55hS3w4!y<lNzbAw(6w@Sn6_Im3*r~xI&=0JxK6$f+dBL8RO*xv9%gvyeoK@O
z-h#iD8Br01Tm)U)g-|><{^Ly8ZOYJ&gsZzJt#LaKG#_oz3D{#%uX@w0>V?8wWB@TK
z6vwHus4r6d@7g!H$BDJ#FlR?s)0PlpCwi!bcVM%IgRksNeR29SSno-wft8Itagn~T
z029;VgZK4r8^MV$(ZyJg<}VBC_LR_tsCkqoPaqgKtvSGHIXJA&X%Q!<y}tF48;L>E
zzUt)?bEzc8pGIJ>6IIh3$A3dHu>_%~*5dmQK^h?i{#sCdG3jZf2ziyx4m8HhMx-{W
zKZlfp>m>f&q=dT%Yr2apyj*&v(#L^3fr=7)mMi`D{uNEu%nHCNHw4q;=2Jf5C`6-4
z0Q37eywq4)topwcX2t3(f}*20t#CXn$K5k*bhH}K9sPK6Tl9#KFpare)+vvnG33c!
zKb;O$_!U7wNH)mp70c!G!n8!%T4CGohG0xcSGji<jCUJ2CPFviC9c&AFu|4m|1%mG
zW)80zPe)^u{ZM%AYo<x_2h0d@!xcnDZfoBt&AzMfF!RbXfRO*bn@eF6)|{X%D?!Cj
z?*#?*|4AS>a+cf=Yba0v%b6jDjpbrtYhhMet{i?a*BMj>lHaySwe|~?0^JCJ$^FoY
zD@f(2GC7>VkY&l?3@g-Xp80^Fq0vncndsSce=-8^(7PsZNQC|bQjk;t@{t6DHylM)
zEKdCIJv0#G)KLHZu>1t@*?<27bZh_9zsi~!Q!i*L4;Nc$n}fY`J-ViKwA_IkNrv-O
z2NG%i+B`{gJ>_3N3gU1t4ozj11}g##$e=**7!Ux=@clU9t5-qvir~CIHgHP6Xb7C*
z$QpCD!IfLjPmXqANVqp53!XxW3qOUVw+Br1A<+gwU}&G+1*Kfk!qi2f<9P*{yQKcW
zQMN>KOMv9+gN^+Kq!#E~7GGHev0KbccfQkkPy^DVzZ#W|<44Ob2_iNlrw~Yxy%#$d
z1c}U!x?i4BBkZs_Ud5GD*dg?V1srq*&v9chk+)rRI)tyttgUcU+ye+GUGzQP8*rsr
zLJ1A--T|<R#iVFZy6}2EkZ`NGR9^(@DX)q)vx-rG@VGeKgyXEEd&Q>Cb8{0DQ!vZk
zzJ0st@z=)4`{Jja2+JT(#1lAc;ACCoGhIUgsH<!Ja07*m@3p%umkd60(Pci3*ew<J
zPr>94A;buvB^vN>p@TUahVKAa6_yH6k}+6j5e$Sdk%KprQPNdFdOu@Z+X*J68%AE#
zuFP2cBpkP-29nyLnU=`4)p|;N1ZQ-$f+s3ItAK}uoV!5;dpi_8l*+wLE-dg>^;${(
z$u5HA+{;L<P`_T$_r<v&#q*=K7N?-b{{(l~B^U#0ZOTqn*7$=A!sRMX)s7<h#`S)L
z*nI_@1v9`AwTcI#&KlHV;}CjH4TSVGvU5fP4^y$@a1$l~x@U+IB}X9i%E<w~VakWh
zm(uRZ_AQTl48O1UU#IYYnL+aU`1$?x-0E)$6-y=Jx>vklC}usX6~S!%=|9oY4895)
zs{t@yAxI4&#<qITtQ;$C1yJ4a1D(#v>8fLG>9HzxXCka1Sx$37x{sH^T&|K0quqX!
zh2KXl^AN(C@e?Y{&3}j-+ha2`tw(UJ^W8RP7m#&i0ykX%@|nHku7uH2PNQc$0D;Uy
zT$=!1Ern~YPPKPb1HYS!jiqJd9)vZ(htYumtAiTVUSjwYdX9BwBt3vYxjWtxEWkix
z|4cymh%k9I$NTAUm>-8n;n>>OQFGw5u?%>~g5l9D*UR;!z7+UZdTL{Dxkylz`R`a&
zMJd)M^lvpxKjVj=#KYSCA3(nMx(S!GZeQgQ9~NwjMwQQJ#A#r}gec0raQ*bv)AXi%
z(SI1J_tYQn^h+o4Ukaj{ZVG2JVQ9oQFULtI*#@Qhnmqe{m=a7l3zIW;)eKQ%EvKH)
zR_dz$njIIluYdu}3?#_^+7sbwO{}>FX*iL<c?Px!m)^B73#<PW0qOwjbwgs-d)kJM
zhtI*4h@Po$UbX^QfJg~ner9gYh4S?+C(cLFz>h=#)Jan_UULq(>t0aU8{5a1fdjJv
z>n;ROTn<kh+WP@E-?!unAQJ7?c=C8*M2$)>HI3|5@*~<4vU*p1fUI5Lxr4v&93w^C
zN}!?^zDO|MxDx67p4>R!52Yv${)>G$t?(TNAJm1?0%4Mn%o6PmIpfKPv}d2^%KzK&
z?mqJCMFsG<h2kKoyf5?CudirENwC}Dmpvk+JZEBa`0dAzSxoGiB%`zo*MOY87sF%o
zxlDI_aQm`k!W-3h&qMMhaelZ_agva8Zta*C=*R!rNG&hnSdg2XXRF_`koZL-Wrg2}
z@D9cn7n9mYE6*2v<4GM{5>iKrt?fdh(ted1=`n-6Zi;OvU}%?ARlY3It-o}g{f`{i
z@+$7Bj3+l??PPTh)1~0)=WkhM=P3p)Fkd2kYHG{FEQiR}F*4IYkM6#CQsgo>sTO5^
zQd_h0p{4N*`}sHdfmf!8I5JKVgy^H$Y3{LSl6<pN$}E2Lr>ieDrn-;KxwE9&D~I&;
zT@K4P1d13-%@l$LLcIc>;AXzl9`Em%&5qQ_yfylM<wi?ue9O#1d9Gf3t7L~mwfXgP
zTsx9;V#34ntCNfbcp;~afCz<0inFP2bU^hJPjBxKWJA}A`;qpAOJg<Q49bX9U0P9c
zkRwkTqWQ*kty)mKHXTPK!Q)#a&deO#w#-bLTr32$pOs$@yH7nd!dFW_|AMCai?$m4
zP3G{(Z&P~1VIU5vnLDn(`fn`&H8o+>=ptB-L3>$^br-=nB7q!*gMw}HFliS?eB2$;
z3LSl4z2#L+YIGSBh`dFZ&w^D&CC8x3-P9w@e@I1h>ibWc7`oa^+Salgs&mGd@5)cq
z7n0t#nCMa!9TMH}Q;8(qD8Xk~)+COK@>TxNd+w2r|2B;JoR$`*-Ft*A69^E<(rYGM
z;OO|?*k}V2Y7N@HZ0-zLFZ{6+b<bKnk96S0;7>e5IuWAGMLo@{Adk;dfAC;;^5tu?
zdeIrB0|T{A-=JFw_Xr-JP8Ko{(yG*VZ`;zvV-Bnf4Zw3B?;mbc@8v9>+Otx9{_h~C
zE~X}}Ja6;k-6eaDb#d^~`hWWLse+!44u}5{u0~+P2;VUMEf^jG5kOWzB@f394JX+L
z4<0;LQ;R?)X9YY)*`e$l!D4b#H!QPA>5^WT!&K17UL?u$lc-9LQoF98k&}dnF(Pzg
zV$w&s+AO)QY`;E@mDFS?RIV5Y#;RU-XqV2gSFl>rDE^V(QrSo1h*rMT7E__8arRbm
zssr6+qsUE{>o%fizTk*ycv#o!ygko%{rb8yLXF+`1dL9KyfhCIAGBef-(zS-h}ca*
zMrNL)U$OnuD0H;18Z?^<$m7HhsSsgKQv2M$UJYe*6>|U|;yAtPr-~yN4XH!XNSgGe
z7l|augHq2I8OM@)DIZsi8;WFj62vMRiZ5`}URg3lKB$&6)UqP>IZORiH-|9ajztML
z5ZQ%Rv2c~kt(uxgr0i<rmh1zcEL+{DW5w8Xslw~N`+aa&PAKD8ssA1`KUecyE6Hs~
zJlvvUIw#~$X|Zs-CjZr?M>@u>FEiw5&E-^2Pw3azrikRWc;8^3#G$hR0gRJmW52jE
zbdM46;C^u7Gps%&z;NR<Yx+#z3-I6bUb?gpwXe)6Ed0LvR+V6;fNdC$0Y<Tdi;0I1
zC24zcj-RDx^XPKR>+%`_4QKpyms8#ZMw|VkaY+~4y5Bfl%U3FO{>?4k?YH^YXP}qi
zeOKv8+$WE%#(;suc^bNnG@jYP@Ct=WF^BdFE%VP|w$rU*{D;$ByqkHZTvP2Ex7joz
zESyUvG6gw3hIES_@h{)^v|qRwMYnqoeZo=e!Y;~G`x>zkRDO2PAmU(#aBnZdR|fhZ
zcr3Pxz7%-{6P7PP@z00DG6!eaVzFQEqHQ#L1reW9jRU@|#V#ub^)@m`U$WOr49(xa
zt+~+oBv$3Fm9{+10w?t@F=oMhEK2Xq4njbg{NeoP1&JR-jtl!03rFqy6&)V~D{(hi
z_3tN7;*fh8H5SIVZrv(~`XFAAX<=cpqRYZT<sBW#i93*{rYM<reULZr-}hO{sC2NZ
zaZ4pS2-ewHl|)Q%d+j_+5)-^?omaD7@*10H`uq6bcf*taaDv<zCtf0}hj0)pn@qfl
z(dzE$HCc2cfz@BxSs;62lCem>HSqrFo(sbRKuYX`GWDsIj}J6#^o^CE;X^Pu8Bq$3
z2bCfD?#;UIsI)ly>4|~<Qx&>yE!%_L>Yvm5iPZr^KmE7Ky-k|>4yqQ$c{$dDkM+M=
zGxZb?Cw{>9_v-1kv8^2U_NQc{XukGn36wU=4|H`&D@IwV?>4!D`Hh=Z>QSl2I&OHt
zQKX9W;OzJZ)r%bTeKlON=xQGrh*o`8VZGwX&-eQKAdbUB_{t_;1mkZ#n#>|+5{}=>
z^Et|z95%oX{j3v3L0o5|UmK60xWh*w&FGL<x4#?<W1X9mUHi=?rkDJG44wVeffE(|
zO;2>cd_h{)Yr>b<Z+W<s60rk7PDTJ!u=%<xWf>Xsl?GLd-cDhxQsO(5KD+gz!JK>g
z5U5mFV(pZ)L&+%k)HUN!rX0x9We8G5FtFEdkw@trr(s7IWoAlW|G5THEHzRGwZ8b!
zSVCRJ|LDv71Ky3Eo}MdAfVh<QZNm{*cm}q(R<oju8J9Jj6dXYE{4tp(;q6<K9p|>8
z?GTm>JrJB-0|`9<>b-H5Vqvqe&yZbHc2M(Ze3}RF@28Ko5|5kTWO7^=qB^k8vh9z-
z+Lil^yOyl<(HIygDPtIgIt=V4FPbYbDCaIe&kcCEA47ci-aWEK(#p<{jv-LF-Int$
z1*Nu+h0|FV;?JRp<5+iHQP%0z$@)&!2^h+gA&0(lWQYBhd{a4ZzH5PjNYY-)xDhR9
zX=x<$oSBh@upe_F&p$)V{M4<~S|%o@gNGT1tmMq1ROEzXAnQ+i#LUgWmv=&<3(Rvo
z4+l+7I|?Cx?S#w&9J#8xe<C6KchWrs68_}md|hfWC^4-Xzrm&LUIf>xrMv<B{gisI
zUofeVM0ewY<5$M_f&qbn1*lbQ?QmiNegyB08{Jy!>guQ1PuH4)B-_@_fteuQv9~1a
zsA=r1D_zF(ih_!DT0fVS$!_Vu0CDDe%*G3ciAp;H!LOag$9gtsX7Rt>s>`pm^0Yx@
z438eOE31Abes}eX(#PY{-1f}@+FLr^HQ?PA6&Yy?m6F>z%q5QXshDe~-Z~l@JrAO_
zKBSc^puI<PZw^_26`UTgnFs?{_I*I}SJ}VmeS)@l0(HaN3RYGIv=QC(8R7=IMO4yy
zc5Bl#3eoX2!wyU!s~VI;FB2k~qZSN}>SNq1q9F1+LcRj~!APwGi9tlrQyg5v6rqw+
zQl`EQ3=ELK4Vi#V!;2vRZ5}^zQY@&7fP;IE1L?=Ft@b)FppH0sh-<bW>f;!(DH8X;
z_>AasbsU-Y$#>gvdSibpBbo8W;DA*XKA8+G_QwJ+0gA1X5WG9?24(b$sZ*HjWqy9P
z3P30!dCBB^0KUDwJ=?>COK;B5(A1oX(BfBRAcG2I6gfPLKucSqi#`Tn0Y<fV9GSn!
zVT0`GBydwfDu5($ts=4uOZQkDW;?#rnpNw)%e$ij7n=60t6YpltbgcN^+|uh{zkJR
zr@Zm(EoV2s?XaZ|y{(2(J>Vg~ii?Zy55>nbcMnfLy?^Ug9SZSzwj#O|0TKy5jzMG<
z)FIZ3K#a()-@DQ*M7XP-MXrgWuJp8<8{ILGc5|t3YauKz{bV!yMLThDYfom@&~vZ?
zQ3aC5P;-S4q29Z$+VoTi<iHY(B$dUmDqsuF%-~;@UaiIV;lFZa)B2Gyu_`3>(r*zO
zXzEjk(d#HFD<Am==uslNCC}V$Xe65ASQsk?+*%@$9mokMLEvKHqiUzu%2eV-?WvH<
zO`!`5i%A1jzZ1tIVU7!8xMx)<JWtAg23ZDmcTJ97`Fh!F9r38wr1WQ>jaN&tAnrTM
zM~$}L8*zWK+k13Ar>F1S^ztnQL8f6wWy!uS97-LkrT4#bpFe;8O87MhrFzgq?+S?G
z+C{)qj+_6vanFMrmkLI9JJtSvj;c+b?JEGCuiRpP#^%D}?9#bm!*WJCmptP9l9Ut^
zGq8yA7ri-+K{KA9L+7LeHlLM$ltmlz+^MnO5wY#x`t^0{!B1KYbKa#qvOj|g=$_9}
z5PMjZL(!>4qb=31(j%lLb(_Ba4gVQ^>bPk0CvHe`c6KWPJL1fJ;R0Dw<$Aeq+QM<l
z^2H9BgPre9Cn{=copQ(L+FU67O=&Rs6=nZ1tM#t!e|bhy4GJPTBp&$%V=EkDEk9u?
zz?7@`jd7T*yq#yc+H<id^IUbS>~i+?jScJRjidz`sEW)(!2)&);ZaWTx<^-p`l7`=
z{-kKw$9p!^<Ok=LZjN4#GSV<E+>x|mspQO&Vx+|9IvaoIb-C5|=`l)mt>F0$?Cdb{
zl8^^?PV><<jT+55O{a9c{JpF)(&Q1o+>?#rr~kGHw7HS5$d^l)8WhGNb|>D=9PHaJ
zNGXn|ayuVjTFR^KWiLYM)G(?Y`S$Gtoe}H7S1(e%xX$u<{e4q4%NsX3U>;B|!S(TH
zXCPsDISt8)kmGcAxt09mpj*x&y@mu<%JaKtnznwMkChsmZJ*V=f@maP?Q<1z4i_u=
zrQ(l9)2h;F&*)P`?Py%f39N|JSap1EJSNlb*{j|lQ1e<<gVa&$&VH!g8Q*`E8lE5A
z1#{q`MH%76M8?MM%bJ;)ks+<HgC%3D{k{rq_2ojH+W*0;yQ|B_PL#PAB=;A6!l6VB
z4XWrz@!Yw4H+CPOar@g(Nx5jHC5BWzc`lb;rW&8mwZUt>c5k|V=EX>s$mb5Xtul${
zuWBoaYT1%^iP?98P5wgpwqR@4YVGXR7kbXYn=(ol5%lUj6`@xlvAF2eZIiXO(n(Fd
zH@>sJ;UVjI5glu&P`ZqtvzNy_v=bU9-_YM*u0rcx7&t5v5F2gV9CPqBeEL5P!rm*Z
zRlhQj>_nxerFm<k`+^n2x))mQMVSTKy8F)`h{C=>+~!z{3dlHF|1)5{Q~?LEgR1rj
zA*O|xk~P~=lv&wNgv@jkd{ffavjgI<*Y@`8{TB2{Be?i}8>oEF!sarZOcfT`w*43)
zGSWPX-a&t%b(Ktgs#86@)It>%Ovgyrd|zmkSEPM^vTvK^G_~5QhJvUM*JUr=XBV8T
z1g;!BukcK_^%<Dij3v|c9FCK;{rZVDDq!dikz>9r_MY7Ms3_;bjqyla&j%MFjBt!1
zxvZ@0f{>6CCgAWc`nrbD=~@ruEV$IAx)aak!;+;eC;K80JR+!kl7ktzIrvwo2Jb><
zu`@?k1J|q^Vpd}Av!x^|*_(JRARwD7t##Fzd~~{4Xux|>v^{i*5D8c?%gw^do<pB`
zG#HGxc<t|OVOL1DCBk3I585?&s0~BR*-fwvuMn>W@AKznLuqpj)8NZck>eE{6jbuf
zw*TS^0YU%AD5WGXWflls9lcvvcp2|pU;xj|>Gti^J>ztmxyC;08p$U%Pu7Dfhf!W7
zulXL8+K92bb6PLcFDc&r&pB(O_cEFXt-saPm8(j&{!s~S{pzO=Js6A^%dlP+%od&-
zORCVr{M4}HMO1F+qkU`Mc~@@u48{DDtOPXM{zG$9@>7C#JS}9hJ;H5AOCV@v#nPP*
zFQ4F76*7WQ;Jd1k-y4gG@FITxyw%p}!oT{S<T_ucENzNG;`P$&<pM6@ltr%k5xD^@
zC~|pp4>iNON``we*WP^M+B^&0=#1AEeN1Ib(tpK?9fsa;4ZQW?QisR*!=SQbK5FXx
zwb;QEqQ~X*%Dmo!o1S^v;sAlcgG4_5n-XoEWy403V$`#M3&lP6KWe5~RPaA6Kjh+W
zQe+i+{Nfg$2tk4BV3y5BYFBo-M|Rk4G)qi?7QNJ7J%hG35<B>qsrR~Xgmkh}KlwNE
z|7gW#46m#{cqs0^`INF-kiX!1JrvDimj5tQP<@m0@$;Y9=r-yUtOUo;)$DqHRB98I
zMKy~oiy(75XNaYDiyUrmE4aCxI1}&qTEte#-=ACf{qvgi$?q@+?WKdMcFXXCXQ*Tn
zgapkHTV66TzN0U&y@t}S*mwN+S@wg7t--tDB|nfNlpHhTPl5^OkK1C;B?OlQD73JU
zo+J%97P1VVom40Sn&lyd?)+N(YC4YTs&g6lqDSli^h{#8+))6@M@i}rAD+S$f-WW*
zGwZL3T^HGgrS~UZMk=HwW@NIUZfd-1bIvflS1RIj-SPVm<53TJ5qIwf$M2?_jaN%Y
z&gg1t5+Y?Q)d#sS#DKbE`_x<WBroBQ#ueb~@~YnwI~yc@@V6+DQsz(qNrs<E)o&GO
z_dZ3as5$k**Pyrg>##YmhRDLvUIru#_m{4V$y3wQA_0my{|vwF-|_fgU(}RR(KLk1
z4AU2J6|va!nPRNFwQgg}ybQzi^qE!v6K{-ERQj)7J(D<wm_A$8&5>_&SDx`aAW;7V
zaXET_mrRe>);L}5JMNbi2mYbS{BhI#cTbJy_O~8?K1P3@`q`xXrC)%!LZN^M(pdd$
zZv&zC@7}%g!?S(xpetBQlK90PO&?n)KUoF|=PQgPm7Fl#N2~W)FeeHZ$Q|g1w*pXg
z^(X9jf#}-~GNd$w!ELs!0BJ|9);HGNzz(s=HXnK)sGFE@06a~I%y*}E{IK)MIdu_)
z9~PBfsaOLG<M{g*FI~!9+kX9V^TdTc!;&D@jeOX9kzh>J6EW1%tkr11@abPGaN*$l
zd(Nlvi|;SN$IVoNw66TnjiqOMlS??xtFj?a-unUhB92d5N&6nWN75mIfnwu7$Z#V$
zb`VJ-1edhi4dlbVl5XQ($1%T$OtIDQgXq|o9r3k))F^|tR~mW!x2ukt)S^!ujdqrW
zj+>XSYA%r)!6a8(u(sxG?X5OPEY}S0FDr5VDoS;h;JrU(zGCfavsT8-wyDs!4N!_J
zi|j2J6p|XC2T(N;2wPhS1<oQR*2C{T2cJZ<6pKD!KZJzBQ&2eHKrX&dJB`sc^m4k4
zQ9z7f6@`P>{bY1X5yA8ucr4)|KT$?N2!NNCH<**~71l<6l=lxSb@|Yuq%ThUI)@6u
z!|>M}J|EeeOY-?KrI^r&Q(NG#O5yaxwU4OFf8u@yuRevm!^7FpO9Psj;i=GGlV1&w
zLb^IbR}NBAIK=0sUA#T&G$Y4$w{y6|rcz&ebT-)d9MR8(?QfNpRdc`mFsPjblz|~i
zj}U?LU;(02k{}}H+O@Tqr~@48PJ+AYL=?;q$tP;G%oLTCrAm$cte{SefLA?8RM31o
z{_x;3`%6@Oxp@5o6IN>3zO<@l?NYba#%SmbZ`v<1Barc-A{;BPw$OHsE3dhNrt7&q
zJ;I)%U={yiAus2+!7n@RO2S1jqK^Q5U>4^chI;${y;g5Nh@4bxlfW2f%)3Ew3tn;|
zr5L-ctf+YEL({n719f!;p-L@gY0omr|J2GWCJavfCQ?p|JuRv&zipp9NjEgGtlwf_
zp=er2RmM4xI<#~3&V~IffAtwE;>2T_!39UZr4=<E$m*1l@)}xj)O!8L)KE)n77x+v
zwLN6}5NUdkStwgJ`9|y?-QUiJ1*?&5;e#r!xjf}-x6P@hO71**G_-)Xxxe+t<p{Vv
zvY$!dXIAq7?uWLH>+Gx-B~{-2IgR;LI|Z8$P^zv}+P67*;3wp?q0?P^?`t9h%DOWy
zNF~)Tpl;6_0sI?3x?FkJm`w9&==pW;-pL;#xVo}XoQc|r9s5>q_pj;Gk7Wl!<*lQf
zQ}+={LP=b8OBiAd26M~AQ@LveM*`iBdG~Z`q~FO@t}WcM<6!I|ZGvCXHS?~%S}w4I
zifb!3Jl}!Z_dp$g#^!zBTwWjiURRl^Wqu)rf&&f^zE*vL`Kx0tUAk`~>uX2>`4Ja5
zR=7|5gH~?nmsQBYK=qq4MfFJ9>O{s?r}h9I&)+i)P~3LNMc_xw+m7;!>T2{~pr2_k
zW@n*x5{SG_aYW88vNv$`lH1JcH{WKQoaWm%JbtyOSvFNIrKjz3YF_S!zuWH{8)1lH
zMx*=U1fLIFMa+u3?je#=A6E_KUQ$7Wo$-?-F;IKrSlCJU*Ut`|uz@Gw)}EjZ$C**Q
zsLehm@5oynq-bUz0rDMnzoBL1JJEb8ACrsU$vd-=RX5ca)M`p;fI9pA_P<IgwfP1C
z%>XOarYUU%O|eik`{k~<zKBi<%6DmLY0H-NiG0uG*f<uAIE?T4v!`A4TFM<dI{ud@
z`VF$Lh#^_4Pg`?^=nVzC8d^9mtvmzz9GyFN0*A2$!vor&DeMFE*pP@FH0{WDJlFD!
z44z`CrZYBwS7*wN4H5Rb^e_&_81&MP**>KUtcU}0^a+fek}?Z&bFh0rt;Rbg|M*4k
zc|2n<^^(VRev`hf;>n-k0wIE!3Kh?kfD1$dXZG&g?JOL#3HLZ`uTLi`-{<C-vMcY6
z$e^K$awxX8Maf)l`MUO|W&`KNUbPGKqhN>XuM)dVY{!i`k9^Hoyg=>7B`oY5SwA^%
z(g0;FAns|y&q`hbAgMWr3LvIB&v95gNp^8TWLc}>rL>ENCnHAGTRryLf!Zk>ZF%b(
z%F-gfEw*VVcIG#BXsDfB&FIIuhAjGpm0Lft$ExOkQGw>+LFvy8x_dfRIpFpU%Ho>d
zb-J;7^TCMxC8hVC9tlr4WYn&;m2B0^9k<`Y-4_t46%cp*$=&#XN{U*diOKo-`DJJZ
zL2m(>u%EG}s2L)UzuTKa%H4!U<pGcJ86L>IjE*f>n@*s-w91_%p2<h5%6vlA*|qt%
zX7JgzG4>&1#DaN%bOb6oJL&YkhK}Lr`_wyh0!;n<?T?(PJ5u^=lNz(T>#Ci<vsC%`
zbNxY5KpjC?iAxeRh|&v3(k=8YdrHLTI96^6G5xZwY|@G&Kls`dKNnV9BVID!BJ3le
z(sKqiv_7`b658LYv%Dh!pMzE-{@S@I4o*&6VychW4tjd}@ou|=SRpHCn3i=PLU5lT
z*KuPP`T!lNA?q7hTBrcQVl-0Ovw8$HvtO)roZT<6nVA?f?_+#tk2ZubcO#`K?ShKq
zQ+n4wRk$t0SGZM`D+QBfXvY1wgI7gK2_FeK1rn+k?v>g{k`7fBXYTW)bPfg0P%*sd
z+BUm#`Ld;oi{<_MVW_wnxoa8AerDduFHT=8)<4EG^8Qt*mafKRogJFdM?<x_ihcQm
zGxc223dQf#Dp+XE67k=dh6tQ~vdL=Jz}~w4`=<)xiuW%T^Cq*zoAP-w8j{3wwnY*$
z8--;DA9=37hb|qD@iKQ)j7I+E5Zk-z&Ag<_4e{A3^%sU-`4*d>>B?nT4`w2(bLj7(
zd+t<0Nq>=6>Cx3?OZ}w=&UGJO6?y9jNy`DjQ;lxD4_Bv8^Cn91*22B*?lBY}d3itX
z>&hd(A(H&hj<fL<4@W?XK|%@WT7F1K2pW7f$%Tc_b=5&7ta(&p@r@Dp4&%6Lc3T_#
zepq41o)vtw{17yz%c3S^T;KZlrEja?B_I2`?`m@WyffvD-G>G`%0fS^;-R;3jVDPA
zyE9)XmTK2BA#29YK|;@}(sP8w8rtfi0+1k|>JQR$zmo|$$20cxM~KMcjPH{^JiFK<
zoMtX_I%*vMGLpROe56Ik`&FK8`t>u|O6yJmG@A{(3>%QP)%)sCY8q@xSF&wya6L37
zzD_UnHqtc4uYiHWK<|yb30bs9r&-e>R`z!6*X;tH;^APzn2}pW5v<+EN$=_|O5uNa
z9l*m}85QN!llvC0VOUw1N>=`)^lN2MLyRhy=y3F`<&TM4f{*uA&`Rd*dshjxZ_Qlv
zEn9^1ZcNLly)oRyEGN!cH#8Ne#A?nfBeFeJH2CZ^<XDb&>M>D^Y1W*>p~kkk6N?=M
z_#b{6g1Apql!Iex+h}>?9;ni4{HtLEDuVe5IXfOo@2{*atk2oLW0~KX_mN><(lotU
znng^mulCTOx?$(@n8)*`boxAr)!$EYiq*g6D@_wu?wh#n`N__nexG#o*Sr8i7;wM>
z;DaYwy>5&n5E(8<!I~YHe*}~Ij*g)Vpm^##PJ$KB>@3{?2EE2yCkBBDr_$yy2N1!m
zO*g6N6h01gvEqJfIO5o?j3CqnI(r98!fmDf%meD%+Yxg0VZD9Z`KUy1{jaQvZw2RT
zOsCJ>LwrC^qSf$8Yh>$KSI#+JeA(&X-FNRuZNFb9+>`TwS?ha4R1iL5Vq(Hq4I065
zNT86N`ThIiInX6WjEgq5C7}?FneHLQimP?MuaS3$;Mw&@)#{g>cq^^L>=Z-KYr8Wo
zU;oG*Ly2(M3zF8W`fOu@Z3no?&c^@JDsL3jGSz7aVZDn6Q$k_3-r$mxOk+$80~3-*
zlDTva?%~6WFqpDau+5ObA;}zo$(@CzSFc_vX>6S_+-J+p-L~*)vb5q#P$S!@fJ)DO
zbUSidp|MQaAw>C6)pOP6U|1VYPD0Owbw6Vt?N?f6gDB@I&+2Ujg${M{gD0C^b!!YX
zXU;I%hO29?^sQZ}QB+jKU{ipK@QbP$7pDHaB|~a)R8t`M2SH5h*4)@^_`+B44M{3n
zs%ZGNdw=3HWOfIK9q$ulfOR~V&3pd0|13*1a%#sE4dAu8?osUgnky?_El}3fuW=Bq
zuJuukeyo*I?Ce64v6E9VKYgEN2QXmrTUg2J-tWAlxqVE<a-j>~5`U=Yh-AC`SgJEN
z7kX<F>lI5yt+Nc%x=Y0IUi-G3zT<lQbIFbu!__BgedYXR#!v2z#24wESb;=P*~z6+
zH<oZCu_JV{A%sdvCj>Anv)I|mef3<w{}&s6a_$xIBF%coAoCCoZ!%pVyeGXo@$xjX
zOpH;HITDoN<eWCF-W+#Z+$BRcs;muX9jhVec>B_4N@s0NIO4~mrES^74mZvnbqvuZ
zE8bLx(bL52xg{kfk2K|GnHNCpbwmxsU_L0i|0skoOdf3(gqbD=eD1fM%UG1abqhdL
z`CP}0BemQ~o`ugEK^<{cVNnD9n0(Q!nnksjO*g?`JZ(&^Q?yi}Lnnz@##w#z^%@LS
zj&9u2F`^%QwsqyZ-Q1chNA*U+iXMphWrueg!s6E*{27<O=XDTKzfL#L`4br&u2t2Q
z)#p?f5xxE6zqJ5$uHNa`BrG;n>A^)VF27z=fKn!X|Bo2&iR`L{e!+h(Ru>?`(?}m+
z0z{danVk=6B)`F}UXTUyb?M(9$}YP^@2XB5Vbk0L^A1+;+z*2-eZCv{S~^q`#y57{
z;IP40-E-i?a_e3FWCl161V>R`Azt9Zb5^O}{scn{EFl8&zbb#7X(1O8|E}p3et4w<
z@;tf<=sBswnixP9_=8b6Yj;4sBI8)X?a3G`LYW+RChz0oT5XKi$}X=#naJ*fcvi0#
z@u|;u2;Da9w1CnLC($sHI7?^WX%$$2-;l37`bJvfuQW3pBq_Gn!GYSw%fll|P<tAI
z;2F{MOkwOI>?JyM*{}-+SC`n|-ZsZRoP4s8pr9YIha!I$X^O|Q{ZU~7&~ujRGSC&y
z&{1Di?l?|}nSIKWh_^a^Dm=Z>d4?fH=9o;|Q%9@Pem0&yJM7M+@zjrzJ0xBy4Q>-0
z_Gz(MO>=WiguJ+tUgss@*snC?m<WP+#vEo7fIJvQjo=}y;Z6NA3_~}Z*&Wn4sUu2~
z@CL^27Llkuwr=}@wNBNq$XswcCCeLpba#~Gm8B%ryd=~kAI<8snWQf#e2}UU<UBac
za%R?Js@Rtaa9fdc%yHUt-qJ`p8$e81A6)aBVBTuLYMJa74$>;5g2M{JC1mix7SAmt
zwB_5{+RA_czS}6P=|wJk0aI+%m%Y~~o(}I$M3gz~k$?T#+nOdD6~lFd!0G+<M={eV
zow3LG4Z|kQW#l)CN(neS8g*nwNG6&x4hBW!<k3D=_OpMtzBR*}ME88Sr?;gi0|W1e
z4KO;st+-C1Z<-O*8Zc_$34HJ4bP-z|Z$Y5xz)V4WZ^O}RX&MSdHo@*uBKDNypLwRG
z=_{Jr`n^JzFE2i<-$}C=0<&s5ysz#eRZXD^KtQ`Y5O3~jKTf2uG4BV9naG-#P%0Zb
z{KI9YvDTO)R`d(^sP|nVe^Ws{;E}w`gi$jesZu9!u~tl~xE_O3R|SZZ)=x9$Ue#;K
zJ6(_C2!0k7O8Wl5z5PBD-%@-Ym?(TlS($~M1Gp?QO=Y}QR*d|eJ9j!Hw|dlb;;*yC
z6bygJYDsaJ9+rP~qm{|c>h?ATB2n%3hgqrcU7C5ctkb6LnCH?D`>HbrTNxbEm-k0`
zHxer<y>tGBjgb%tjjS$hcy+9|-m8`YLpq7+l~rddU?>kzhj0yeaq(DWM)vHDHY($g
zB3*t)Sx-M!oPoM3tMc$hZ?}(8yor4@d=8#`!MoD(Iqs@1C5a-^6x-(v;Um!M#h?E#
zw({n?w07yVHzu~jS$A#Naa}~j)_==f7ZsoFTV-gucdkzdMCNkiCHlh?{+p}-H!igr
zaUpJjki^y7mFrq=7Z?wuM~}FEy790aeyf@B%Ibe)y-os5=IsVDc1K(;J?X>78cDg6
zmoX}|Wy8~9j601&{Y%9HIAu2BY5qb;YK2D+Y7mR<{JpeeJbrkMLf=I{ddReCByO(5
zMJE9UAq2bt$0tXMz{K-%KhVtPr1y#)E<te63LO&@DKb#*V15FV2NO)~FVxUPcx#zM
zwqe*xPIk6s7EY%cA@pz}HD5zZ>pj5)v6dMR4-bQmo}P>EG|m^(1t{J)$aG~@ds#!P
zSzx;6S?8uxh{(97Lw{^6<G{0$W>xV<!=pv*BS1P(005=6nH7mfoJc_|P-u-82XlBq
zK_@g6q)q)n6e;FBN8akLxS(%;;b%=vP2m#`A%{!L6)VzJGptF5-@v+%xY(a(81*kh
zfDwdYb#ILs%s-^<fq)n?1Qi*reTZd)oGf0LFd#~78?u36VI{piJve<b$$4Pk-M6j-
zoJY$_M9%0)hgktTNu-5q&T=T#{!!ZMFAy_yH<YqUxrY!5{HPP9O=L7wf1PK1lbxdj
z&j>_l0k{4kJ~+hk+ti#3#NB)iphaq-RXMSP@i612a3Og3`B(C=2a7fONpIe)>MP+B
z2GmcABJ3>-j)`{_6$2ps5Ff^<Q`Hh`&7JxT>sL7!#1CpUM{bb4YOZBY@)>Yi8Qg5Z
zCtCkcbMGD1)b_Ot2kassil87xq)1mo?+6N^N*54NK#&?F6e$6OgGh(ayY$|qcN7p1
z2pW(Mp@$ZbE`)Md^!(oYePev@`2M-~j=RS=gCp$h?7j9{bItk8`8*T1qylWX%HRz*
zS5}bFs}ZC0kKN?w6Cbvy#X%m@$*@w3w@2KdFG)D2ldr5gA*1EvfkaS1zy{!chnst~
zUdA#9{R%X-;~Q+j0cdC%>jEZA3N`lZRVwGFAb5PapZ+<4hUeL@DZ)mJG!2BWX$OPb
zsGSSDP=p5C9RI6h_XgZZv;XCO1|LsJIn7^4ohH$``y0}zmbZHVnfk^P@@Gw)oleT#
z0aJyF%GrHAlW?N`t^pEhk?3iHrz*{v$GMVO|B;i+VE<cLF0T!L^m0n)>QR>crSo<r
zK(F(z(O%*?S)%SRn9M)||4&WL$}MXkR{EVLxB&to@p6~-@-lCgBYp{0mCs*&!HfZO
z6lG|`zCdy&Da{|jh%T~!7ZFKUZ+{KR(u@{|oIB`dK>Sps>zeL`C0n4|a#*l33Bi!C
z26b5s2+-<iYx988sW*lX?8^us{y345cQh2u>IMUpWMD-!we!M6TLyC4CL~L%c1-?^
zS6=+dYh>uYIS;=Ia$)~X#h#I`WXTQW<8}xLyW`x;*NF=Mk=Ve-HM!L@aIebM0iRcY
z$}+b|$r@!JzWNp|LgmH)c(-joe*BmOsh=wY0s*AI6?HmEU)$*xnsinbz|ZJ30n9`(
z@sNv;&#Py+6R^fU<TYLSoCb-Xs=N^s5E(V6V+dwDONI<k(^Vt}+6t4sgE(-tb^T^f
zw{s99fCiU<&7m9e{BNkOTlSTB;kNs~FKEQquViN%fn;ohU>&ook)!MsN7Uu5DHXmh
zr1?>B54sAVZ2&Kts<l9OW;l9m^H$EJ#n4MlZF+x({b836O3=LZlY3edLZZE!4&8X(
z?0Ikrq7DJQD;k6p=L~+veVJ&#;TET-^P(Y0>io2|4FA)mw-DEnEB!;j1tDu?69ESJ
zAG>%_ocB3*2A|SqWa%L3VVR`847=q9(L8G01DW89z~8?{;zZ&DmWQ2cmBvq<-P4?N
zX3q-`HQy#ZE!%n2>Uo0&rdo4VV`+o^h7@6ZnjLHiTYc|C>iYE*w8^Pt#i(1(?7Wom
zGIwq0=jx01Q16b>t3H^mCC)(k6Z0A|8Ox_yS_Az=5^6Kx;IN<GEE~s*OEOZ*o2%Rh
z1GaI?i>SDEd0JwyFTzbu2Ot@=Enx#VX-$Qfr1!N`|M}=2e69eJaoOnp8=ZABdP{R}
zno1vVajCJjc$0H4UI85m;^Qcqg2w@&hc94Mx(W<GkyrZ(e*zjNjwEp>AKHK?64Ld)
zQ+?i&q>Cof78EQxf;@aaK%>!%U*Ua`cNNgWs@vY<V^}7@Y=|f`@4g0+v9(>p1G?&}
zCxC{(fOhV$<sUyLfpBHqEp1(*svh#lhm`FeZ+*W&q_jG}xPI6PcEeFE9jaTmMzf2G
z)^rND|H;7ThPfJfynwgxbE&rvCFbz*J^Ut`qnEa|e0-iE=+o$!=Vb(_=MW_yzxyO4
z-Vp2#YiaHBxq>{m2GUxv^Kjt(+!`&De9`K|eQ^7(cLQO)LA_;vcAHxS=m++K3@1Yk
zkw2mV_UQBP3ZDFg>k1ANtBuz7>X{T&R6@vQ3eQdLh1lp|4^KGc%~L-Vg$4y3S|4mJ
zECM>g08pUR)<M$AD1m2v2)WhA=(%c2;+e~EJYK9ESIY4zRl@DzAs{RKp!s^KHjzrM
z@!q-@{&kk*Se1usfV;|-wlZMAb@CqQl&|&R?~OF9(hsat>gqWYi-b4gDDk5E!np9y
z(<PJR0$%d+?aO$O<@gLaU&Fz#L1x;Dg>O~7r<5gOe)tfy>TDj$PIqA43hkl$CCGCz
zS<O;@wfOI*J2jnGd|ETAHLN-yaa@rHBGI!i!5ht}t$mA6zyrM9?Y2xR(9xr8_0|z2
za)RZ6&R<1g9rEdGjRyFJv!L%rXq)WRI{x0o@KNcq9@={1^vC$`?T+gaHz&WWF#MUU
zz+$o!2N9I@kOLOWoxZB_QCsqXaqA}i)bu8><Z1+gB_nF`89)X=zm~HQJFZ_~kJ~v0
zUf(-VPRw5pwqRmHhMyaH7W6BX+K<sQ*1rt7WYnO&k)K3@i}{c$DP#=#kF{KRE_MoV
z5bK*??-U~b2|BHD?l}jKV>%S3Hc6YG`bVjTz6Q=`lqS8rQrEmb*A;o!hDf;tJkX=v
z*<gOJtYWvoMAO7YMhFW_!((&QPq%xGYvVN=RuH{mc<I9{b2u7>jQc=%#07|r`n<du
z+q{qG0mV<@1}UJfVo3!&rYxxcB8lrc2k}cZ3?Bk&WEwh<w;(NO@N<}+<<n!G+=QHj
zc^mBcwgAdflCsj`<8E=HWb$&Aj>m0r9l!cv>e8G=u{%BXbqlesXJUAtdL0g=88F;2
zSK;bvpp*&jm^?3-<CdK{kF6HAM4w>dkUY=IKF$DhrlXS*5+07*5IoS)*S`ha=Sfg;
zwzwU9WIgl6KX*8>w79r<(dOpC_(UB-y)>d72iCU+?$tAfk5J$<{eOf^A#aLTR>^gm
z^1QaWO$aFGHNG0IU#|Q~8--y-M|#ZLPp3JZeEIR@Z9DmrL{kBdDp0R5{S@MT284tg
zqT6UtpuP^VCxHM~+@lDh6%Wn<5$0K+%#-mN&t>JIV3C<-+Sd2=8}dn3x_3-_C)VPz
zYmX1}%$_P1g&U2zWD63v3UFA{fE{S|zbjZd&wQ<Q49d?1+Ge=;fru28n)4qZz)S|h
zID(%6<69JPc|fQtg6zmHEU7QBA$mqHZ!!&HcQ$~C1D;nZkJ?emzVU~Z^i1>R)=Z!J
z#Mhr>uiUD+gWMDUjDB*$@x2Mu<cDt!YW%$&7HPmUR|F!(dN~DHP%zg0Ml3~#B0z4H
zf8FttPdKPc_x>)gN53*8VCQHw;1Xg3!+!X1@l0z<!QmYrrGU0{aBgNs2A6ym#2I=t
zMS8ztSpoIPs2ivkDMLSP6#0)*e&=~NbtlM;-O1eQFqvEEITWW=2t~DY8I&e*6*RbX
zu995&LvIGlixU7)@*s|2D-eUUnz4MM^tsSF4p{_7IMfJisgKJ#$z8C(Yx90pG5VgQ
z)=*vuBBGCli~BrgaeNF)uG&GiF|`@{xhd*RTO=l=u1DCs_qgYM!e}rEtq7O0MqknA
zo%s~JdMVG{jm^q!et{FgeI^N*5aN-yU2e$mu>xRuQ<T%RyC%g3z=<`51RqP5#2|qQ
zsk`2qw%YO`&yNe%viW=7H#>pdiI-WUPl(!WAzpmzGxHO$^AV2~0TDmo!j7$lhSZhH
z+Frl&wluK8268kL&+T|PR8%zf!ty_7Uio`wwg7U^BF{Ls(Q)*qPJgzKli!Q*<skQk
z;vydYI0vFn4UUZJKc4Xz08-!e<q`h=k|l$A=GtGGia$1r0jS9RYplSJ|1JND28<2)
zcMhQG*jqpd&i*O-WfCy!1OAG*R*bSxg1ShM7^b$M;WZd6eAxij32s~T3CUn+KmS$@
z;0}9{j{~E4vkM27Fpyi|B_H?nI@byGHG<w#G8vmWQ-EjvN(_bOK^PU><p>O5!|&g}
z2gZpN1PAd^EgfIKrcSA;s3fzo9L>d$vPG7@oQH>=rU9#w2Fh@GL*!m|-EWq<6IJ^1
z^AAv{D+T#hgq8*K>n1Uc4Ax0C=&{VEpK^D?4n+0TK5-Br!?{>nkZSpc^)gf;?6%vb
z)_aiOfFj7mAZR_9#uFz0@`*gC(u0`ft(+~~e)<;3LiC$Lv`C1$Q`|bc7QuHl;sNcN
z02u-1>R?LvBGHyU`;RTve0D9;076s}US|YFj3?ydIabzbQpn%&Q6{|4%36Px0mX0b
z-(dF!IuVkWdfITb2jf7|FNJ)ZFRrJXI8MOSRlQ8==LbWB4hD*6|Gs@N**^Z6LLYps
zJx`#=<PDo-BqcN-(?~g(KWQ*~V<V&p41e0?0h{K``p0E=vm$1A`_>yNd@nt1fAosq
zw!UP?&&Vbs%FH08^lp453q1Bw9O(xVpF>3OT)LQi`e?VmG85;q!*J>Ew|@g?w}3x!
z0Y9ipO(7Ryy1-hU&UK08#kaoh%=h-2Mc<A;8$v(1K1+BosLIt#C@E<6S&aQ~P2=9W
z3Zr1V{^bd#2`7LES^l}@qzAfJoOHCBKYUm{H3rUMeeoapq;!89Vw7HGsyTyUx*Wj~
zF=CMzQeL;)H-D7v=Sx>~2BzOKMWK}@qr4%heU9|pd}?5!qrzE!1}cr$2}iRPZ5%fi
zOUg$>ku1;7bv&d(_8@JsQ-R!$I60jnG*Q7W-H-ST88m+YAHmIVUHTwa#eXWNN}?Wy
z<5P-!Ult2#Uxc(d^pJy8kUX_JN{^2L_dsGJ-_+o`D@V|DV4%O7dU+R-!At%Jm9Tyn
zzwUN5a4)BrD@WC9b9Ck%dXOrA`WkkuP#qum;mhaRD!1}qFJ6&ZhCm=^e{Z&bnK=0T
zjp)p$1BNQNmDoJv87;&Eq%~Im9_!amJ|og={{SETvB)O$1FQRhE^~`tAI%c+-Ums3
zvDnC`Ja_yI#oY^`KYP=!zHn?qv*TMR(+1C?&RQTuW)^8}|N6O)uaj*Mzo*T*p$AKb
z1G7wG^;D58lV$iiV|3gFK4K*4d=bnFXU&9zgX%MTiKisL=noccPq^hB%(lAH;q=^T
zJ)U!kt9ys90tz0wbzpul%6+{Rv7YmdG48Fg8xhCyx|McM=B!9o>pl2*lC|fJE(wO1
z9t#i7FLQ4=+xcE2Cl%#h>D+e&i2F7FRJ^i>tDcE^7_ey>4()7oAH?$IsL;}64*X|T
zX${WKse}`DqcdJLjW?8D^6w8*<LjL?r~69t?nv&PbkNdv<b4Wu+Igvm&UiBo{Nx1<
zNYkuNVLhjwHPp8B+(Q+G-Mx_27T+baDQZ`pUtSp;pYGoTh|i;-jIp@I+0C<DmxvF{
z3{r{a04+r7?Ak+?A=e(8S6C$m1DT0fAYoctd{cM?xk~V)ZPkWcCt)QK;bCEeq!Ran
zCnn)(o=~?}>t_er@sP@spk3AL$#_RM8q)aTA*AZ_1aX)|YFtvYV$29h(_D1L@JPN5
zQ_?5<F*`xKNlJ~6ud~W83Z{D8!Blj-C%stK3$K`J`~E<0r|HdJV&vuL=X7M~nvU*4
zNVJ_>^6ZATig<K+!KOszMk&=h8!D!eUiBA_WFWQtbzZ~TdgZOoB;~Xk1SmIY{DiS=
zsQ?e1J)rGJ4%xR#%ZV5Jz;|fU*}dvxNzzN=AmsBJ;-~FgQV=V4JM1SXC+E?xJ3cDc
zrAx84&g>}=;Sj^5;n|qvB&fZeanakIjvRmmG^cjEcEBu4FN}Yp%#h*!xAIs(%R!>a
zU>4AiR;rmhRwAk`Uj5XK(aC<aQ*%}HAXNMu<GHN~7s3c8p~CeXca&8kD8ctFpe!`L
zMs@B3=d*cdvq-(Q7#$K7;-=4V?*A_y?;>BU)!hN5-CQjEL0wmL7$TyhsR1{^9J0j4
zq7NeL+eF=<=~Xk?=I`cAbPDp?9(*=E#w-O7C|Qt=R@|+2oc_uNsdwDib!N6GsISml
z_8Apgdosyf_g8rLNO$zE?e(c|-^A#492j~R54Mf6ml57r$-`$%?{Z{bRVRuy(O6(Z
zZ;g(^`)j3c+T08Vec3>b&`^Jxw22pB51E}D9mp|IDEuI*ke_>bDlf0<z72{dNq%`w
zy7GGd$}+IZ>!!Q`V3v!JxYrjG0U>^zL_Tk28+bYU0u#+3<!%IsFi|OLmbZLDh~Quq
zNGkCAJpgb985vnPq)TF31f<jpAUv)jw{Jj(NNf4o*cQCUDs0bHWyNUq_1lss!TpB^
z7@P|zi!&!I+G8LFMy?1<uyStRofa9{sd+6-p^c;L`Wr~;hnwDGU_(d|dc|hl@in1h
z*d!v&+nC=2uXC9Je$P~=OkD+Gv<y)CPhuttS}m+StDmRfN=iYJLPC3K1!A-iiQQGb
z`bm3|2<w|q3P3nj1^_jZ%4bG*SS~}TcIR<e^Kgftf}`nG@s;87d@TyuL;72YQ}MU!
z&&eJETdt7@cy-fP2YJmPI>@D7aiT0Xv7OP2iqR5sOs(#&odzHXwsnMr02atwlS7m`
z#c#|r+r#3$DBXGXCK{%>yyhiOk$&k5F_QJ8kx__6n{P5{duOh^UOwqP@-zfbdEL6J
zg+#^wqs_6ABuTHPAXbg<xqAygfpx2c=y_p6L_6q#UpjstN*DqlyR_|#H#KsBp`pie
z$0(UTK@HHbQ(2i{b=8cDDrHYsS9kZl&8N~c_jPV?Gmo566g|5kyFm5e7j53r{kj*+
z(&|^}ZR01$D!&1&hRUA`05Z&X@7|@7p(S?3oEXxk*D=yLg&Po247knS`sDa;(eB3`
zq)&{u(l^V$l@?6d{a!4Hi*-rSj@YNXu_j6V(z{i3@sV~oeQ1AYG8Q@eSPrYq=jpOG
z-0-=ZUBUMKs1iZ0dh7y8FTC0Ro;G8$cEs>v@E0l#(3DS^KE0r(upmgF;cOiQ)b3N7
zAo>LD#68{t)Jnb*q+GD{mKOb7s{K;j-3&4Ja*i%!)Z_;SF#o1v7G|h(sC{F)D4-q2
z5E#9?>gK`@UKU4(Fp2E{gk~0FZ~wn>893;5!NNY+UockfzPqB;ykoZpC}B;&HEA9m
zI+?NWDQ^?^I_)Od`&S>*-4`p_SEf{{H)ntN@TsxZ4d-D39BbmA_!29jRTg%SPe>l?
z?%9*$4`_8K`|FfbT-Y}&{|wiygOZ<#Z=XJ~TO#3Nj(HnQQpeN7udO?Ce;QTxT|L?b
zx|@>64K51-XBj3yy9#$f+kO1_{+CY{sZ8=yzd_q_5u5R9yC-BFlLPXsE?@q+)B^O%
za+UqAhJMlZ@;X_DY5}G42Ommb4$?5ntdD%!%r(%5)^*p&zJFJ+9gykWw>eB16LUQI
zb>S6h0VuFq02RKVCFy_RDSZ~oPj&KE!WPFqD9Sy6im|bEtoMyo;BO5VH1l@%_J)9P
zs-M)SU~15S5DUN|a-dCGw--W%{<^c`XA*KVum!oN5#>#C@$BV}jwbiH=Iu^nvS|az
zy@?unj^~2pp^4@NPl`rQ7kmf3EN6yhXlM6$>6;F@&9wX9s;DTs@AQt}kn!*F=jWnN
z)hwp9kSH*6(N6tsd0Jv*Xs4WB4D#!_HH1BU5(#q~XmI+&d3RGV9h3{#Kx*0UTjfDN
z1P6;ZF)%Sn1JUVK%u|J`{G+RT0*#c`Gj`uk3W6@tgVw)yvf-!GXIHZ_GBXK~{{rV_
zKNe{0CiS7&L8m^xhNksSs_WOy&V09)t&}7pA)>&jRRb2&BM1z_$PEzG!tA|4FVL$Y
zz<%$dMBSWL^iOT?IjOd*B8TK(cP+^SioJ5iIcv!H8OBzBj&MA$`rV(7R9uz5nc(-H
z#k(I(Gu}CZkC$FMf={@7*Y{sAS#KX#pv?S+-<s)KSu2t7=k{EGEI(5;<7++jP!%cz
z`|zQ$#u`gIRWsQ_|HtihmI9!L0?7CG8Iyb#=o^p@URkk*pOV`31H*G13rJXI+lzfY
z5EZIOTA*>i-II}#5nKP(jL8RE<r?82EW}6RO`l}zf&X>#IW0{rb$;(H%i&ii(O8UY
z>z?cbBX0T{BUgw114b=q69Yl|!v4C_s<enOV*2T*o{n3Gp+a+FQ2{p574wtP?I?DJ
zc78v2*}ZJ0`i6&VDq$i{+`_$bmyI>CB6nqw9nxGRsB$N-zW$ISk1%}!NI!U=X?3@`
zuAu;;^Z-ieJ<!(gfluE%W%-%)!F(-!2)Yn^a<=s{@eD*`4!a{E|N8#haWB^ePR|9W
zlXAF|lk;kEKCk>g%06IacLBiqqRN1T?alL$D^?|;eHJz%lyyT%3s=U(OLUO^+9nfy
z=Ri~HLJ<C!f@Y>x`_cIz07F6?$HXa+cAB3tCZw~@?_5osv!Q^Zl{-WDn=3(_-sGBt
zI0cx7liFB^X-h`My38yOOrXfp7{~??{PJVFhm{LmkrSX~q;nj4ULOv6EECyi>!6cs
zR+=E;<9})aHW5KxdLY?q^LXBlKWVsm^DDh{-SOTyW%X3FSp8<9W5DR7V-%;D+Q&)A
z=-mvPu=<R+Ke=b*KRLY5YaOTo2Nd*XOZz1l;u)h^YkvR5emzKjY}Z8dOaWF(1%#+0
zk#V)16n+&fN(P7H)4g>`se(iF>2HFEh2zXM(k@;uQ!2wkopDos-N9$YG<|0;zBjm2
zIYwjXst1;jk>Rj~x1AooWPHWG>AS&=GFr_#bJ9p%JL+GWkBbdzj0SZdKfQJ(PUhM}
zgj9?4!yhD$3Gd7)pl*^(;cgBV=zY(Ak1uY$3sCH~Bm)D=Nkx78$NRRK?!e$+$)rFp
zzcC?w%{Tj+utGxv1B>CGKeJs=cpiS8$1CCz8Px343JWE@HnY8BcS4(8=dnDvEeyr)
zsW8=?x6cYBm!u%`S@rex((){k*{H>=??=*cyoOKS2oERJS#i^NE4)DtC;N-5L*Jlw
z-auV9^Bf2@{RZXcdznyN)795%R}2_ZTl%sOmPg?HuW!c-Kp@i&3+EVs9!$0EsG*Wd
zyUFwCM<?rJ@%r+pWCS<#2mI-{%V=pWVce*}rBBg${-N*7JBDex9ysaPbt$yLW=|mI
zj#`S1qoa#*+nQSvMLrWmv|Dul6%5&w$~y@(4_%>=7d|Ien|AL$+?VY3cYp2JxIqY4
zX*g|W>^C4ik2$<$GPaPFiy4_e=*0E9S+<e_*~GSM=can^!)g>!8-xqVraH#P##!w;
z^>drQOQD0rTe{&Imse3scnT8Vw>l=<OlGxP0uF7L%u%z(5>A%&gkQ%aunSanEt7@S
z&Nem%xerNiN?6<2xZa?l@iM@)D2_E^S3*(E4?(eE|8{dU0sXsAlB0XaC<?mVDmsgu
zd(wSy8dYcB+U$uC&ix^gLTqrM@N~K_;u()i1*-|B5h&4b01tv9GV2yl(G;i%U|Uc&
zXtMrUpchpGB&|;$v0fXc50tNOdN%lZkAAQk)-l<yY<-WDGojgG=1bV%NzlbaoQFwN
zWoGAjbb^YS<FKUr=0xc7-iC@~=tre@O)u3>@88jVT0RrREs_J-$pfuK-~x0_Rv>S2
z9bP+gzG1z7)d}c`pYYO!dNI?5o)k$h`YO;|bkkFGEE%3HiH=WweW+g*JQep&yOm@}
zuh)nRN29!Qcn4{+A^FK^vdAqMN^=DQxh-_>mxUq{iOft$;fA5>RzO9OWTaxdC)V2t
zV}&xl$HQ~<TsY}H>jIno@hF^m+<v5N=6Ho?T?wNPNTj1F_g*kLfOgPd11C=&P{k|o
zr#Ad>HO|k{tG9bW1C#=)?1v_jC~{7pJ+m^t+J4;Kt;CykeW<S>vC>QT=jmW?LYo8{
zqNxd}%Hd4X#-OXg5Ks~_RkF-@V=igA9zt!XgqnS@pHC8UW~Wz_EL>v65hmO{*oV74
z5D_O-Q1zx?LbP-BCIsSl_1x4I&@sj4enlqR<Vx~5D<|JF3}ynNp#%evf<i457vARq
zkB-$d_RSmn4>HcnzO@~izy)1SQg=l2aqk=ld<osS2k+5UeT!61qOGPZN)bE_xIkE#
z-Mpp4pQL>J$WP5>V=U+(yeLg$m$vyk1W4>AtC?By74OM-TZ`b5N9uzLyf^!jSP<9<
zr<#NY+y`m9o#2hq;a}wZAE5CN$j!ztvKMaJg8H?oXeZ~{q1>^tu{7mFH}8EgMSi^A
z>0hC{>{q1YJ)?t1t=HkJ$Bpw!y?<H3xJ36xhOkF-!l&+e$bjDFnI6f!=I|)JfGZW_
z6wcldA6c8ItT|1)wdY5DB)z0r^W~!m6D^EH!#1uzZMd<pLo2@283MUt5i)(w;h9^d
z=}8-VgJuds!nLP&$|*JYXwUbc0eX`h5}`G5#!A4R{{y+z%{*2J=;W0Cv6XDPtfJZU
zgdr6)L6OWtk~N95?qBC;By^1>Y#U#`#|UAjoo^6-wWr3Vs#?GMSrp;k+;tCp_9`=a
zfyCjNyOYIFGZdQJ$ZNkV-k(EX(asKzcZ)e#fIyC48jVgYLgV-o<_Oheq6<vlTf5C2
zQA3OP4@PMRKuHE7V}0)zsYsDvZ@q0p7G4$yfy}2?RV+$6Ep8Fe0^1wWJ2Ob##934W
zZ)4`1A$gq95RJ+s@VSq0>bE2i$o<#FDT4cy1tqEOU%R!W){{@)baOkZmEw0Bv67;5
zm>NIy1#tF`KPkVXrkR;pB+iZLvY0}N2Ou}A<&~Dku>v{0Uw{OoMk#X5v6sPh;z5y(
z+h88pi9^y`4o(^dJZT+0WieW?o~SCj@p-vr+inzFW<xA!awqoQ?8-4d(Wc~$QO|9Y
zga^PG%}qh5+&T{tDSA5nSZzyUgB82aL<YVtN#xCJL(jp%!Q-R8AK0MaV60Ip_|-!5
zh6&?~+w;|#Zsc;_^gu7Ip@%5u*S~+fO&a2Nd){rs2%0op*86s~xaKR&`idBMnC^SO
zSU5W7Hfd83f3EETN-ESNDxaao#>ZWi#DquWy9CE;;3llgeyE+p)zZ^7K#*;MPAhgv
zdPmGBBjEA+kH5c+Fq{I7znGN76i^@qT8vdXR4WUNumM)#k><TOasAD=K<kpTCFCR!
zku~DO&<Wc=56;T<Lr1RKH{gX<4fc@IQZ8%HP8R*z2SHCCZVA&aO9`B6)WAKgZ3WKF
zW(eK5!zpTs+>c0HEp72qAKn5wrozNg6%=xz`0}vAC5(TkhTgt*X7bT@(Ef93=BAu?
zlC<|p!$#e06EK&Ji7(hn)TU!r{h)b0(y1|j+anu+N;o~u;WgQM`ul{<#5P_MuJ!Q_
zm<M3#u{Jg*K_K6)#<n`Ly(Z{b8L)Cu2s3o5gxLarc<&1y;z^M6yq6mxKGDf77C-JM
zc-_Hm9lmzY3hwlZjePp&?^hg&-^w{UIlBnsf|VcasPh``q`&Ju^XISeezcGX7TiRg
z=E|`8cCxr0CiqO;#V$vS^_|4W3X2N?PsXR3;KeBjH?!}N#7~$rU2eQZ>?b+Zd!mow
zfn85V(0gJ}^_7)-`042AOl5cITdUW<kn!JUq6m=Y%kS;wVhxSh8GkKc5W9}J5OIs0
zegpG*!&BI+^$SGbb|uAik^GkMjuNklW6YN+bF46Da;{Ym&FPPB`{&|?E5nX_yCzx?
z8BFea3mk<zQf5uz;_Octf1TRkJy}#o?~6VUhJZ#(z?>)@vuv@KljV&P(8oN5iVujo
zZhWA+oBBbXMGiU%zdHVeB{KL?`ga<rp_PS6q|-lH61dyapikNZ4m;)CCQ%!@JRX^9
zG4H;Nm;Pn}Qp^M4KM$r7*0iGt3zZAO-Z?AQQkf)*fv_>;w+joR-kDkSY)E5F$Kskn
z!s$-st6=Zrz@N%b&L&+0Z<@7P!o2Go?eqI%qWd4RBC_ZKb`qTNBM(P7d4oz7uE<Bx
zSboBOtlmYo$Z3WmN|Z43?H7$90phs|7@LjkVaBd9P~h-=u`j9W&D;~asYX$CO)<Yg
z%5SNX21{A$`%~YHr0|2?SjHtDh@;#phjfNyuGdq|a6h)i`I_Z-%Y|^>E^|HzBtn$>
zEtFMS`jm-nAz`#M<Hu4JkgDND*#aTrQW_eXRJMFM%?^KBV-ZfR<MUN`K+hhM&-@`;
zRaK=7PBxKC|6byh3ia`scMCSJmh2c>9qMb`Ng(Mvb2|%^(|iFw#VXhkgiKr~o!8&f
z+kbZ+HWKE%7T9QDY<yC+LP96$@fA*!!j6c`85|jQML$2>20|idWY%BPyZ&QyI=va_
zF*Fyh%`T3#T+M@9+@k>!jb*Zi(<z{z)(1t_tpo61=9M*cK7#H{!YJjQiN2Org&c+f
zMSa<yuls3>tQ{G%axr((_?m=k!eJvO(Qe;!!*TIy$4nl$HKMr8KDurLMpuJfG3#5a
z1}Zj#Agjw<igjJD6XmRNF8L0;US-OUdVQS?QCs_>I47M2O!nW^;rk%(aw8C%;0F_E
z;BKTM66hD-S*BfSy!hFtATKYT*(#3}Kh;F&pR9UN5fkX$^T+ixb%<|19P)*3m>eyD
zdHgt+*KlhV%#O6wYTHc)OTLzkIa$lLbbawcYySibCF`~HZnD&!e4-QbAgazs8;txU
z+j10Apb)e^-QFj7V9`#G#PF(zFT5=w5puoH$EofPBp6uqjvsia-!78?Ufz9CZ;e9Y
zbOGE$=^4U_9$TMIMxLDorF-f=)?)94>-b}qNPgvdJhRII;kAIf?A94P9<Sh@%7L56
zdH??XGgo^5wi&(I&DvxHld7{q00#K0Ec+>Srrm)JW48XuVH>yCj@Oyd`4%TPEcpx_
zJ5#?->e&J5%`k}B?A4+)BOQ;g-x|UYo4!ijIo$$EsY2r0-r{$JvPwXknz!F?y;}#q
zzq(Rl$|EfV8rcLYO@=@~AWX11MR#Lv4Xv}bwCs^H?<Z?(MOn`5G^0D_?0X>{zy^|h
z`$<~bu#^$3cG>??92goS&iwnEzXwn!g=J+9&ZczlQpFw6&<a0M$!#Ayu(qE;qY|1X
zdQR#W(|LJ#dCB*+MewCWFG_354VPl(iEUwtB3v2U+uJ)bX{_FC<Hy@dm9PzIMC0n3
zI<N4$LmhVrsmH&%?k1i$O-mB8<H{#)sDN5c?zRFiojSxzOC4nEcD&!K4DD_{Eay~6
zYtG5H(kUPW9yEK{sVn~|X~G|L(u9tPJ}i9!mu^=$9YNK?Fr943qrIFH@d=^;$=!z7
zaLK(9bzwolg%twL!|7N<d(nOH2j%SisObHKe$PcqpdYN>(#M9JQ|=FO%UH%okM}1C
zEckIJCQ`&-zBFnEs$n+5VsDGPtZ}Lyd1s{QNKnV5#T^>XwWPR@u`$_Oi@_mx7aE`O
z>}`PEcZ9)-0s=uT4AL%u(oF|Vk=xCKy(N(XU&T7RkMuEp<<D$i0e4zGmzwEgb+t=+
zmj7{NPj7w6vxeMUAv-%ehM9K$UvlrST!O7sFuUIahQcl<el*fT=yi$ANu1HR^MG=H
zfg7A46)s#|#c*JY80h3n712)<w+NCLZlV3a1lXv+LtujeklDY*?KsB!b?E+y37)m7
zb}mIL4L;?v(tTH9f2>-NabQdMqyXF01RKBJ--l4+xDh_Y7L~KqPL+AM;5PkB&~d)Y
zHJn&Cst&ENB2oClJnJ@P*|%14{1eO8sq*8xDtyDkUXJqp`!7MaMe~#M!#<7YX=F|z
z$;D?s+*K2Rs)Z}Ga9K~~Gt9Z4O8k7~<n>OC@qzWbY-c`_JxdGeSowE=H~*|VffVlM
zcCcXK5|_{|TGQQI64+rXxVyWX<cns{x2b#?o=JzqdhefRR8<N797v+f2DbdMv<Ff>
zxS4RIWxd~U3ME(=93FBzI@X(GqP-?vf#QqTP9}PldVOuAkY8%kA#L0Vnf<I{!FgAA
zdU9wg$J=Ams;NBpRaz$!+Ej*2GM;EwHA(jL{T42^_hRlY8ITZ>gIe@n6g%%Ie=mBf
z${%Bgjf1rX?Tn(#c3NYH3AP@~<()QfYfnqJ-}j0EHoi09|6gD@Bf2(@Gs%NX?#nCL
zSu#r2VZGOY&lM1m%=s%ZA+B;_E!iWttgKA1OU1|&i(PR`WmR3zSG`BgrNpzY>MZ6b
zw=A4z2W8{uhnv~htac<!!E+AKb>7EwOwHK!PU-J9a#69(n?a%c_l^!n=fc)%m?S0o
z>5JPH_i0@PPW!UVv?lkK7r*ATPmEl6y?y+BIL%`X>x!TBc&<L4l+|EzTrp*BSGU{~
zrS8eqx72kl6^E47lt=ZhorjKJbzn6w2XVZP(&6(0Jm5>d3Em*s5TI>rosIk(ql-C(
zSo`sTIsd6JelBA-+3p9*o><FxqgVvmXg;}t=god@^G4}%|B1=isKmp=MXc0;t|7>!
zRs8BY`oe1&dh2w)?s}M4ru4pF+wf*vFuVo4tnwE3;(&w!6;#w$YHBHu_1~HHJI9Pq
z&N9COGQZ+}Xb@qXIOep{hd$W=4SYS?MfKR0t)UGZG{Iowld!j_X`kCX1V=PBgs{zG
zbMD-^Bylk@*5&xr#Z2;mwy5j5%92SdVHCtU(-#eT6xc>Nd0!=<v!LFH4bDZkCR$gv
zZXlOwKlyw10YdGhi}$$d6jY~X)~jugm%G9Zato?D=h6YQ%a!0QU^hB@fO6+qXZLuq
zol|<U7}_#*w3ghXmFjzLG_$;XQ_H9aUDx?FlwOb4oYA}n?25P)1a0BAZy}Q0Y<#m9
z+V8nPW>boHMxXd;8a3^NXoV3PIgIQuo!7#@vP!aS!y5_E1<I+(4e`fUtL-P<orXUl
z)<;vP_AwTVM7PyBp_xDTju9o?da{_-)wW^2TF=-(z$xD7V4Q3bLFX1`V{6;!hJK)>
zogBy1fS5}&Sa|+JiadFCajn{=W+9CuCc1L}J2}|+9gVT7pWXw)n_bA0%whEuG3V&4
ze3X5hQzBv=G#-Ad06e@6KymBo2NJ|Dk<N?B+k<YOEB)&5W}}~8!C}@>S)i6;-<5uf
z2Q{+sO*`#Z`VI(EmrQ83+;5W%9iLY!Mbdqx<g`^rL@_GRipCvY6i09|GEzuO+l@9&
zG6sWI86_q5nF*6cQ^5`F09k<VIm-_D=^EinOY`dCc8`B{&XxP7qn*qVMK6ev^Y&2R
z$rryfpVa50p|Si2%~?rN!3~6j7R#DKX{%+-k;>wu`^j1TvA3`5$-YK)BY%hz%ICdU
za=ouKj70BNESeDGW@=XwNY_hIsIRa-k@2;B3#P~StZaIvFG)CUCb<D4s%K?^yFpEz
z2lS}wvc|z&Vk|B#m7YGM?rm(Ynqoo&kKEzK?w7`B$25KdQqEnyCu*qK|KLs;(g!7q
zd_YMhCFs!J$wBRws6}oTJIqWo$khJl;8Kbl*?2&-J6c>#&2Di5x@uv37y>+&&r+R3
zY!B)#p$d7M2<w!>&t3HE{VgDVionfx1?j)Ah@I^D&J=`Fa^!R}Vwgkf!j)Qpg;~Wo
zJyYTIUvn4=>PXu{A`Knc_2C<_mSLASjxAx*UD`rtZ9w>J0o!M{hd^Fj?aroZoHVF)
zc&PwdI>-sorQEfO&(cTNRapr2^m@@#1gt_M@6rTM@^r@ulmfS*0W?gIW3>W2u<Lzm
zFJT8L-BN?9m7nu?BJuHRp!^<i@$GT8;v-&u6Ew$N2S}5Ajs%?XY5NM>T_x{Rg4gLA
zj<w{3y1{1oMEq6?R%7IWdGPiG7s92mo95e5ZZ4S5$r3ki%l|{!9wbLbVJZ$DSx!!l
z2LM(by?m&hhQ>zpb@<lyHWD}C2+JKF8uH@*9wEa&`^IRXZqVk99%|m)r1W`xrFSXK
zMF>Cz(I1;aR)~Q>{l||lauSd%bfLzPfyh|!AYwQ#Y}*Pg=xryhLqvOyUi`b|h~f5*
zoxFGH=c|Ft#Yq`Z=UU7Pc;vp(`97@VLSIoqNl6%0Ym*3a8S^9Efk4x}kiGR-Jx56N
zhEkAtopk(Km~(&2C;61jse#ydznawyJIe6mZgnXrKAN)yRitU5>8fWfw0a*mB$huu
zcQBcCVgInw%jogXO1}|`fc&ptzb0jun7(HL-J)Mn81EE<f~7+S1_mH@v$61I?kfY6
z6XSd=_@yyEnNZFuiYvJdwk3SP7!G*3)i8Uf0z49joG;f$q=^q6&;A-58Tl;?i(;(;
zT|uhvPm2JDm048Uw}t~03cKZ2SMT8xxYm^bnr7sez`(n#i<@AFy@9DK9V)?K-Gix@
z^UsU|chnjy8r-zbsNU-rVk{wLi57R<!*bqmWn&9!Kv6#&T}G`-ZV%37;7aueagBqV
z`6YYGrUz-lme|+{lGD@0ouc{Uyzp6jON`%i)^!RC@LuB(Y5=`(oIGYeciTctVJ^pb
zB8JuSWaQm95E=Wloxxi8@CYM!i_bNTJt>ZK+WSo5>5TSjav3^O#!RmJP&Jx$rjA#w
z9|;D($6Ni(U06k`85eHPsY|a=x_KGY9y`Mnau^;88V>7dhcbO^rh+{AW%^N2Na%3I
zbH>wcZKOP8`f-ctS^o2McR_sa6P-z`f98DDAz7()8VDfBT&hD4Q==M`lw3~?q7n!b
z2|YBE&DEwScaLLMYiN71yqt+gBMJNbCwbW#6V9JpqLdE~;&)8xsDLpMvsm9pTe$@F
zC55eYdAyW416*llhh$R9c^~5SO-wX)RTn(i*pqm3y`!D9tPNemehVUW&cv13=$*7X
zB_=(8j@E3BNRDdYKL#LzIVIwxFGU%BXpi@L4z*PCd~uz4!PnGp-`)OHVr##B7<AAB
z@X`8?1P^F&XiAENOgU<gO35{KnP$7G9~QJbIe2oF(Rnb#FYp{hruuEsELphno?r7K
zR(Scx;<FQPb1qr{E%?g4qwUf`t0OMc2v2KO|1(%F%Xz~_JYiyP)w18?(I;g#n~n06
zfeQ3Q?|TFqRtJYbKK-oM*EwA=AMP3)n{<b|_LseMnMqsh9Zg!c1y}5nxZEgH@^IhV
z%0A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
IqZhva10aOPZ~y=R

diff --git a/reference/plot-15.png b/reference/plot-15.png
index 2788f4bef684accc5ca305ce453f9b124491aeda..e05cedec1bfc96a741a1e400034e4d78a0b13884 100644
GIT binary patch
literal 81118
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

literal 79220
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%0Amnei%7Tq^Ny=#Ft}ytfyjD-}l+Pj^
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
SQTcO$bY#!|-5l#93I72?j6hic

diff --git a/reference/plot-17.png b/reference/plot-17.png
index 8078c86c8e4a99762f9243c1ae222b4582f08116..a06c20a8e32855f417383f8b4c4ce6453b8641dc 100644
GIT binary patch
literal 55112
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
F{TKB-FE0Q9

literal 48785
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
UGduzRHa0dz*+Vk%`;K1zUu?Kv9{>OV

diff --git a/reference/plot-19.png b/reference/plot-19.png
index dc63afc54235771c904115ad3a1fc148d57c619d..a90eab3e3e9bffba25449bcaed98d39adc528d2c 100644
GIT binary patch
literal 51225
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
C^}rth

literal 45141
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
SH^GvgyrR64T<or+7yk<)?!=P-

diff --git a/reference/plot-2.png b/reference/plot-2.png
index 016f4803e8b9f54058320f44f36f46cdef9fcea8..2f293236aa12c499eac193c22b65ff6d81824c71 100644
GIT binary patch
literal 62752
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

literal 59610
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

diff --git a/reference/plot-20.png b/reference/plot-20.png
index ddf7bce78f624fd00e845e11bebae62183c3487a..918ed77559bdf85ee9d48bd38a11a2cf9a66960e 100644
GIT binary patch
literal 49038
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
M)Rp6Q9R2<O0J4-~1ONa4

literal 42907
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

diff --git a/reference/plot-3.png b/reference/plot-3.png
index c1cb8426aa8c833b7983e9c225177403ae6115bd..16486d07bbf7dfafc33fa75312c17009266f15ce 100644
GIT binary patch
delta 39183
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
Ip1Jye0JE7}r~m)}

delta 39852
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

diff --git a/reference/plot-4.png b/reference/plot-4.png
index dced0a0adcd0577716764aac6df700e85906609e..62dbd73a415c9e2c496a63cd8cdcc70fa89924f1 100644
GIT binary patch
literal 56174
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%0ANrF+**cuvs=S!<(fGSQpabMMvtyp&(
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
B9lZbm

literal 53209
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
Jw%BH0#6Pfk%_aZ<

diff --git a/reference/plot.html b/reference/plot.html
index dcfc0094c..7d82af117 100644
--- a/reference/plot.html
+++ b/reference/plot.html
@@ -9,7 +9,7 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -437,8 +437,6 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>    <span class="fu">scale_y_mic</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span></span></span>
 <span class="r-in"><span>    <span class="fu">scale_colour_sir</span><span class="op">(</span><span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>Removed 5 rows containing missing values or values outside the scale range</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> (`geom_point()`).</span>
 <span class="r-plt img"><img src="plot-14.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="kw">if</span> <span class="op">(</span><span class="kw"><a href="https://rdrr.io/r/base/library.html" class="external-link">require</a></span><span class="op">(</span><span class="st"><a href="https://ggplot2.tidyverse.org" class="external-link">"ggplot2"</a></span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span></span>
 <span class="r-in"><span>  <span class="va">plain</span> <span class="op">+</span></span></span>
@@ -448,8 +446,6 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span>      name <span class="op">=</span> <span class="st">"Support in 27 languages"</span></span></span>
 <span class="r-in"><span>    <span class="op">)</span></span></span>
 <span class="r-in"><span><span class="op">}</span></span></span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> <span class="warning">Warning: </span>Removed 5 rows containing missing values or values outside the scale range</span>
-<span class="r-wrn co"><span class="r-pr">#&gt;</span> (`geom_point()`).</span>
 <span class="r-plt img"><img src="plot-15.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="co"># }</span></span></span>
 <span class="r-in"><span></span></span>
@@ -460,16 +456,13 @@ Especially the scale_*_mic() functions are relevant wrappers to plot MIC values
 <span class="r-in"><span><span class="co"># when providing the microorganism and antibiotic, colours will show interpretations:</span></span></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_mic_values</span>, mo <span class="op">=</span> <span class="st">"S. aureus"</span>, ab <span class="op">=</span> <span class="st">"ampicillin"</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="plot-17.png" alt="" width="700" height="433"></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in if (any(cols_sub$cols == colours_SIR[2] &amp; cols_sub$count &gt; 0)) {    legend_txt &lt;- c(legend_txt, "(SDD) Susceptible dose-dependent")    legend_col &lt;- c(legend_col, colours_SIR[2])}:</span> missing value where TRUE/FALSE needed</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_disk_values</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="plot-18.png" alt="" width="700" height="433"></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_disk_values</span>, mo <span class="op">=</span> <span class="st">"Escherichia coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="plot-19.png" alt="" width="700" height="433"></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in if (any(cols_sub$cols == colours_SIR[3] &amp; cols_sub$count &gt; 0)) {    legend_txt &lt;- c(legend_txt, paste("(I)", plot_name_of_I(cols_sub$guideline)))    legend_col &lt;- c(legend_col, colours_SIR[3])}:</span> missing value where TRUE/FALSE needed</span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_disk_values</span>, mo <span class="op">=</span> <span class="st">"Escherichia coli"</span>, ab <span class="op">=</span> <span class="st">"cipro"</span>, language <span class="op">=</span> <span class="st">"nl"</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="plot-20.png" alt="" width="700" height="433"></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in if (any(cols_sub$cols == colours_SIR[3] &amp; cols_sub$count &gt; 0)) {    legend_txt &lt;- c(legend_txt, paste("(I)", plot_name_of_I(cols_sub$guideline)))    legend_col &lt;- c(legend_col, colours_SIR[3])}:</span> missing value where TRUE/FALSE needed</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="fu">plot</span><span class="op">(</span><span class="va">some_sir_values</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="plot-21.png" alt="" width="700" height="433"></span>
diff --git a/reference/proportion.html b/reference/proportion.html
index ee0295c33..722d11c43 100644
--- a/reference/proportion.html
+++ b/reference/proportion.html
@@ -9,7 +9,7 @@ resistance() should be used to calculate resistance, susceptibility() should be
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/random-2.png b/reference/random-2.png
index 2c4c400a05f595418eb67a17ed7ef496ba81e803..b2afd1332cad77496d1b391cf96a827e789b433a 100644
GIT binary patch
literal 49490
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

literal 43470
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
WiP;#Y`Ib3XrYNT@`$XpO#s2}Q9Rc_N

diff --git a/reference/random.html b/reference/random.html
index 82c6ef70b..3aa3dea3a 100644
--- a/reference/random.html
+++ b/reference/random.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -128,7 +128,6 @@
 <span class="r-in"><span><span class="co"># `plot()` and `ggplot2::autoplot()` allow for coloured bars if `mo` and `ab` are set</span></span></span>
 <span class="r-in"><span><span class="fu"><a href="plot.html">plot</a></span><span class="op">(</span><span class="va">disks</span>, mo <span class="op">=</span> <span class="st">"Escherichia coli"</span>, ab <span class="op">=</span> <span class="st">"CIP"</span>, guideline <span class="op">=</span> <span class="st">"CLSI 2025"</span><span class="op">)</span></span></span>
 <span class="r-plt img"><img src="random-2.png" alt="" width="700" height="433"></span>
-<span class="r-err co"><span class="r-pr">#&gt;</span> <span class="error">Error in if (any(cols_sub$cols == colours_SIR[3] &amp; cols_sub$count &gt; 0)) {    legend_txt &lt;- c(legend_txt, paste("(I)", plot_name_of_I(cols_sub$guideline)))    legend_col &lt;- c(legend_col, colours_SIR[3])}:</span> missing value where TRUE/FALSE needed</span>
 <span class="r-in"><span></span></span>
 <span class="r-in"><span><span class="co"># \donttest{</span></span></span>
 <span class="r-in"><span><span class="fu">random_mic</span><span class="op">(</span><span class="fl">25</span>, <span class="st">"Klebsiella pneumoniae"</span><span class="op">)</span> <span class="co"># range 0.0625-64</span></span></span>
diff --git a/reference/resistance_predict.html b/reference/resistance_predict.html
index 8f112ce4f..9ed31c76f 100644
--- a/reference/resistance_predict.html
+++ b/reference/resistance_predict.html
@@ -9,7 +9,7 @@ NOTE: These functions are deprecated and will be removed in a future version. Us
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/skewness.html b/reference/skewness.html
index bc4ebe2ec..d416c97ff 100644
--- a/reference/skewness.html
+++ b/reference/skewness.html
@@ -9,7 +9,7 @@ When negative ('left-skewed'): the left tail is longer; the mass of the distribu
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/top_n_microorganisms.html b/reference/top_n_microorganisms.html
index 592e1ae81..557d91694 100644
--- a/reference/top_n_microorganisms.html
+++ b/reference/top_n_microorganisms.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/translate.html b/reference/translate.html
index 9405cde3b..66bf4f0b2 100644
--- a/reference/translate.html
+++ b/reference/translate.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">AMR (for R)</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9015</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.0.0.9016</small>
 
 
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/search.json b/search.json
index a662ecc75..f4de86ff9 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://amr-for-r.org/articles/AMR.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Conduct AMR data analysis","text":"Conducting AMR data analysis unfortunately requires -depth knowledge different scientific fields, makes hard right. least, requires: Good questions (always start !) reliable data thorough understanding (clinical) epidemiology, understand clinical epidemiological relevance possible bias results thorough understanding (clinical) microbiology/infectious diseases, understand microorganisms causal infections implications pharmaceutical treatment, well understanding intrinsic acquired microbial resistance Experience data analysis microbiological tests results, understand determination limitations MIC values interpretations SIR values Availability biological taxonomy microorganisms probably normalisation factors pharmaceuticals, defined daily doses (DDD) Available (inter-)national guidelines, profound methods apply course, instantly provide knowledge experience. AMR package, aimed providing (1) tools simplify antimicrobial resistance data cleaning, transformation analysis, (2) methods easily incorporate international guidelines (3) scientifically reliable reference data, including requirements mentioned . AMR package enables standardised reproducible AMR data analysis, application evidence-based rules, determination first isolates, translation various codes microorganisms antimicrobial agents, determination (multi-drug) resistant microorganisms, calculation antimicrobial resistance, prevalence future trends.","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"Conduct AMR data analysis","text":"tutorial, create fake demonstration data work . can skip Cleaning data already data ready. start analysis, try make structure data generally look like :","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"needed-r-packages","dir":"Articles","previous_headings":"Preparation","what":"Needed R packages","title":"Conduct AMR data analysis","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2 RStudio. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. also use cleaner package, can used cleaning data creating frequency tables. AMR package contains data set example_isolates_unclean, might look data users extracted laboratory systems: AMR data analysis, like microorganism column contain valid, --date taxonomy, antibiotic columns cleaned SIR values well.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"dplyr\", \"ggplot2\", \"AMR\")) example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows  # we will use 'our_data' as the data set name for this tutorial our_data <- example_isolates_unclean"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"taxonomy-of-microorganisms","dir":"Articles","previous_headings":"Preparation","what":"Taxonomy of microorganisms","title":"Conduct AMR data analysis","text":".mo(), users can transform arbitrary microorganism names codes current taxonomy. AMR package contains --date taxonomic data. specific, currently included data retrieved 24 Jun 2024. codes AMR packages come .mo() short, still human readable. importantly, .mo() supports kinds input: first character codes denote taxonomic kingdom, Bacteria (B), Fungi (F), Protozoa (P). AMR package also contain functions directly retrieve taxonomic properties, name, genus, species, family, order, even Gram-stain. start mo_ use .mo() internally, still arbitrary user input can used: Now can thus clean data: Apparently, uncertainty translation taxonomic codes. Let’s check : ’s good.","code":"as.mo(\"Klebsiella pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"K. pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLEPNE\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLPN\") #> Class 'mo' #> [1] B_KLBSL_PNMN mo_family(\"K. pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"K. pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"K. pneumoniae\") #> [1] \"pneumoniae\"  mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\"  mo_ref(\"K. pneumoniae\") #> [1] \"Trevisan, 1887\"  mo_snomed(\"K. pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\" our_data$bacteria <- as.mo(our_data$bacteria, info = TRUE) #> ℹ Retrieved values from the `microorganisms.codes` data set for \"ESCCOL\", #>   \"KLEPNE\", \"STAAUR\", and \"STRPNE\". #> ℹ Microorganism translation was uncertain for four microorganisms. Run #>   `mo_uncertainties()` to review these uncertainties, or use #>   `add_custom_microorganisms()` to add custom entries. mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See `?mo_matching_score`. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #> -------------------------------------------------------------------------------- #> \"K. pneumoniae\" -> Klebsiella pneumoniae (B_KLBSL_PNMN, 0.786) #> Also matched: Klebsiella pneumoniae complex (0.707), Klebsiella #>               pneumoniae ozaenae (0.707), Klebsiella pneumoniae pneumoniae (0.688), #>               Klebsiella pneumoniae rhinoscleromatis (0.658), Klebsiella pasteurii #>               (0.500), Klebsiella planticola (0.500), Kingella potus (0.400), #>               Kluyveromyces pseudotropicale (0.386), Kluyveromyces pseudotropicalis #>               (0.363), and Kosakonia pseudosacchari (0.361) #> -------------------------------------------------------------------------------- #> \"S. aureus\" -> Staphylococcus aureus (B_STPHY_AURS, 0.690) #> Also matched: Staphylococcus aureus aureus (0.643), Staphylococcus #>               argenteus (0.625), Staphylococcus aureus anaerobius (0.625), #>               Staphylococcus auricularis (0.615), Salmonella Aurelianis (0.595), #>               Salmonella Aarhus (0.588), Salmonella Amounderness (0.587), #>               Staphylococcus argensis (0.587), Streptococcus australis (0.587), and #>               Salmonella choleraesuis arizonae (0.562) #> -------------------------------------------------------------------------------- #> \"S. pneumoniae\" -> Streptococcus pneumoniae (B_STRPT_PNMN, 0.750) #> Also matched: Streptococcus pseudopneumoniae (0.700), Streptococcus #>               phocae salmonis (0.552), Serratia proteamaculans quinovora (0.545), #>               Streptococcus pseudoporcinus (0.536), Staphylococcus piscifermentans #>               (0.533), Staphylococcus pseudintermedius (0.532), Serratia #>               proteamaculans proteamaculans (0.526), Streptococcus gallolyticus #>               pasteurianus (0.526), Salmonella Portanigra (0.524), and Streptococcus #>               periodonticum (0.519) #>  #> Only the first 10 other matches of each record are shown. Run #> `print(mo_uncertainties(), n = ...)` to view more entries, or save #> `mo_uncertainties()` to an object."},{"path":"https://amr-for-r.org/articles/AMR.html","id":"antibiotic-results","dir":"Articles","previous_headings":"Preparation","what":"Antibiotic results","title":"Conduct AMR data analysis","text":"column antibiotic test results must also cleaned. AMR package comes three new data types work test results: mic minimal inhibitory concentrations (MIC), disk disk diffusion diameters, sir SIR data interpreted already. package can also determine SIR values based MIC disk diffusion values, read .sir() page. now, just clean SIR columns data using dplyr: basically cleaning, time start data inclusion.","code":"# method 1, be explicit about the columns: our_data <- our_data %>%   mutate_at(vars(AMX:GEN), as.sir)  # method 2, let the AMR package determine the eligible columns our_data <- our_data %>%   mutate_if(is_sir_eligible, as.sir)  # result: our_data #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   #>  7 J8         A        2016-06-14 B_ESCHR_COLI   R     S     S     S   #>  8 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   #>  9 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   #> 10 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"first-isolates","dir":"Articles","previous_headings":"Preparation","what":"First isolates","title":"Conduct AMR data analysis","text":"need know isolates can actually use analysis without repetition bias. conduct analysis antimicrobial resistance, must include first isolate every patient per episode (Hindler et al., Clin Infect Dis. 2007). , easily get overestimate underestimate resistance antibiotic. Imagine patient admitted MRSA found 5 different blood cultures following weeks (yes, countries like Netherlands blood drawing policies). resistance percentage oxacillin isolates overestimated, included MRSA . clearly selection bias. Clinical Laboratory Standards Institute (CLSI) appoints follows: (…) preparing cumulative antibiogram guide clinical decisions empirical antimicrobial therapy initial infections, first isolate given species per patient, per analysis period (eg, one year) included, irrespective body site, antimicrobial susceptibility profile, phenotypical characteristics (eg, biotype). first isolate easily identified, cumulative antimicrobial susceptibility test data prepared using first isolate generally comparable cumulative antimicrobial susceptibility test data calculated methods, providing duplicate isolates excluded. M39-A4 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 4th Edition. CLSI, 2014. Chapter 6.4 AMR package includes methodology first_isolate() function able apply four different methods defined Hindler et al. 2007: phenotype-based, episode-based, patient-based, isolate-based. right method depends goals analysis, default phenotype-based method case method properly correct duplicate isolates. Read methods first_isolate() page. outcome function can easily added data: 91% suitable resistance analysis! can now filter filter() function, also dplyr package: future use, two syntaxes can shortened: end 2 724 isolates analysis. Now data looks like: Time analysis.","code":"our_data <- our_data %>%   mutate(first = first_isolate(info = TRUE)) #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'bacteria' as input for `col_mo`. #> ℹ Using column 'date' as input for `col_date`. #> ℹ Using column 'patient_id' as input for `col_patient_id`. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> => Found 2,724 'phenotype-based' first isolates (90.8% of total where a #>    microbial ID was available) our_data_1st <- our_data %>%   filter(first == TRUE) our_data_1st <- our_data %>%   filter_first_isolate() our_data_1st #> # A tibble: 2,724 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   TRUE  #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   TRUE  #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   TRUE  #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   TRUE  #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   TRUE  #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   TRUE  #>  7 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   TRUE  #>  8 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   TRUE  #>  9 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   TRUE  #> 10 P4         A        2011-06-21 B_ESCHR_COLI   S     S     S     S   TRUE  #> # ℹ 2,714 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"analysing-the-data","dir":"Articles","previous_headings":"","what":"Analysing the data","title":"Conduct AMR data analysis","text":"base R summary() function gives good first impression, comes support new mo sir classes now data set:","code":"summary(our_data_1st) #>   patient_id          hospital              date            #>  Length:2724        Length:2724        Min.   :2011-01-01   #>  Class :character   Class :character   1st Qu.:2013-04-07   #>  Mode  :character   Mode  :character   Median :2015-06-03   #>                                        Mean   :2015-06-09   #>                                        3rd Qu.:2017-08-11   #>                                        Max.   :2019-12-27   #>    bacteria               AMX                    AMC                 #>  Class :mo             Class:sir              Class:sir              #>  <NA>  :0              %S   :41.6% (n=1133)   %S   :52.6% (n=1432)   #>  Unique:4              %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)      #>  #1    :B_ESCHR_COLI   %I   :16.4% (n=446)    %I   :12.2% (n=333)    #>  #2    :B_STPHY_AURS   %R   :42.0% (n=1145)   %R   :35.2% (n=959)    #>  #3    :B_STRPT_PNMN   %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)      #>     CIP                    GEN                  first         #>  Class:sir              Class:sir              Mode:logical   #>  %S   :52.5% (n=1431)   %S   :61.0% (n=1661)   TRUE:2724      #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)                     #>  %I   : 6.5% (n=176)    %I   : 3.0% (n=82)                    #>  %R   :41.0% (n=1117)   %R   :36.0% (n=981)                   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)  glimpse(our_data_1st) #> Rows: 2,724 #> Columns: 9 #> $ patient_id <chr> \"J3\", \"R7\", \"P3\", \"P10\", \"B7\", \"W3\", \"M3\", \"J3\", \"G6\", \"P4\"… #> $ hospital   <chr> \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\",… #> $ date       <date> 2012-11-21, 2018-04-03, 2014-09-19, 2015-12-10, 2015-03-02… #> $ bacteria   <mo> \"B_ESCHR_COLI\", \"B_KLBSL_PNMN\", \"B_ESCHR_COLI\", \"B_ESCHR_COL… #> $ AMX        <sir> R, R, R, S, S, R, R, S, S, S, S, R, S, S, R, R, R, R, S, R,… #> $ AMC        <sir> I, I, S, I, S, S, S, S, S, S, S, S, S, S, S, S, S, R, S, S,… #> $ CIP        <sir> S, S, S, S, S, R, S, S, S, S, S, S, S, S, S, S, S, S, S, S,… #> $ GEN        <sir> S, S, S, S, S, S, S, S, S, S, S, R, S, S, S, S, S, S, S, S,… #> $ first      <lgl> TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE,…  # number of unique values per column: sapply(our_data_1st, n_distinct) #> patient_id   hospital       date   bacteria        AMX        AMC        CIP  #>        260          3       1854          4          3          3          3  #>        GEN      first  #>          3          1"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"availability-of-species","dir":"Articles","previous_headings":"Analysing the data","what":"Availability of species","title":"Conduct AMR data analysis","text":"just get idea species distributed, create frequency table count() based name microorganisms:","code":"our_data %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1518 #> 2 Staphylococcus aureus      730 #> 3 Streptococcus pneumoniae   426 #> 4 Klebsiella pneumoniae      326  our_data_1st %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1321 #> 2 Staphylococcus aureus      682 #> 3 Streptococcus pneumoniae   402 #> 4 Klebsiella pneumoniae      319"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"select-and-filter-with-antibiotic-selectors","dir":"Articles","previous_headings":"Analysing the data","what":"Select and filter with antibiotic selectors","title":"Conduct AMR data analysis","text":"Using -called antibiotic class selectors, can select filter columns based antibiotic class antibiotic results :","code":"our_data_1st %>%   select(date, aminoglycosides()) #> ℹ For `aminoglycosides()` using column 'GEN' (gentamicin) #> # A tibble: 2,724 × 2 #>    date       GEN   #>    <date>     <sir> #>  1 2012-11-21   S   #>  2 2018-04-03   S   #>  3 2014-09-19   S   #>  4 2015-12-10   S   #>  5 2015-03-02   S   #>  6 2018-03-31   S   #>  7 2015-10-25   S   #>  8 2019-06-19   S   #>  9 2015-04-27   S   #> 10 2011-06-21   S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, betalactams()) #> ℹ For `betalactams()` using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 2,724 × 3 #>    bacteria     AMX   AMC   #>    <mo>         <sir> <sir> #>  1 B_ESCHR_COLI   R     I   #>  2 B_KLBSL_PNMN   R     I   #>  3 B_ESCHR_COLI   R     S   #>  4 B_ESCHR_COLI   S     I   #>  5 B_ESCHR_COLI   S     S   #>  6 B_STPHY_AURS   R     S   #>  7 B_ESCHR_COLI   R     S   #>  8 B_ESCHR_COLI   S     S   #>  9 B_STPHY_AURS   S     S   #> 10 B_ESCHR_COLI   S     S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, where(is.sir)) #> # A tibble: 2,724 × 5 #>    bacteria     AMX   AMC   CIP   GEN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   R     I     S     S   #>  2 B_KLBSL_PNMN   R     I     S     S   #>  3 B_ESCHR_COLI   R     S     S     S   #>  4 B_ESCHR_COLI   S     I     S     S   #>  5 B_ESCHR_COLI   S     S     S     S   #>  6 B_STPHY_AURS   R     S     R     S   #>  7 B_ESCHR_COLI   R     S     S     S   #>  8 B_ESCHR_COLI   S     S     S     S   #>  9 B_STPHY_AURS   S     S     S     S   #> 10 B_ESCHR_COLI   S     S     S     S   #> # ℹ 2,714 more rows  # filtering using AB selectors is also possible: our_data_1st %>%   filter(any(aminoglycosides() == \"R\")) #> ℹ For `aminoglycosides()` using column 'GEN' (gentamicin) #> # A tibble: 981 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J5         A        2017-12-25 B_STRPT_PNMN   R     S     S     R   TRUE  #>  2 X1         A        2017-07-04 B_STPHY_AURS   R     S     S     R   TRUE  #>  3 B3         A        2016-07-24 B_ESCHR_COLI   S     S     S     R   TRUE  #>  4 V7         A        2012-04-03 B_ESCHR_COLI   S     S     S     R   TRUE  #>  5 C9         A        2017-03-23 B_ESCHR_COLI   S     S     S     R   TRUE  #>  6 R1         A        2018-06-10 B_STPHY_AURS   S     S     S     R   TRUE  #>  7 S2         A        2013-07-19 B_STRPT_PNMN   S     S     S     R   TRUE  #>  8 P5         A        2019-03-09 B_STPHY_AURS   S     S     S     R   TRUE  #>  9 Q8         A        2019-08-10 B_STPHY_AURS   S     S     S     R   TRUE  #> 10 K5         A        2013-03-15 B_STRPT_PNMN   S     S     S     R   TRUE  #> # ℹ 971 more rows  our_data_1st %>%   filter(all(betalactams() == \"R\")) #> ℹ For `betalactams()` using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows  # even works in base R (since R 3.0): our_data_1st[all(betalactams() == \"R\"), ] #> ℹ For `betalactams()` using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"generate-antibiograms","dir":"Articles","previous_headings":"Analysing the data","what":"Generate antibiograms","title":"Conduct AMR data analysis","text":"Since AMR v2.0 (March 2023), easy create different types antibiograms, support 20 different languages. four antibiogram types, proposed Klinker et al. (2021, DOI 10.1177/20499361211011373), supported new antibiogram() function: Traditional Antibiogram (TA) e.g, susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Combination Antibiogram (CA) e.g, sdditional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Syndromic Antibiogram (SA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Weighted-Incidence Syndromic Combination Antibiogram (WISCA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure section, show use antibiogram() function create antibiogram types. starters, included example_isolates data set looks like:","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"traditional-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Traditional Antibiogram","title":"Conduct AMR data analysis","text":"create traditional antibiogram, simply state antibiotics used. antibiotics argument antibiogram() function supports (combination) previously mentioned antibiotic class selectors: Notice antibiogram() function automatically prints right format using Quarto R Markdown (page), even applies italics taxonomic names (using italicise_taxonomy() internally). also uses language OS either English, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. next example, force language Spanish using language argument:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             mo_transform = \"gramstain\",             antibiotics = aminoglycosides(),             ab_transform = \"name\",             language = \"es\") #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"combined-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Combined Antibiogram","title":"Conduct AMR data analysis","text":"create combined antibiogram, use antibiotic codes names plus + character like :","code":"combined_ab <- antibiogram(example_isolates,                            antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),                            ab_transform = NULL) combined_ab"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"syndromic-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Syndromic Antibiogram","title":"Conduct AMR data analysis","text":"create syndromic antibiogram, syndromic_group argument must used. can column data, e.g. ifelse() calculations based certain columns:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems()),             syndromic_group = \"ward\") #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"weighted-incidence-syndromic-combination-antibiogram-wisca","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Weighted-Incidence Syndromic Combination Antibiogram (WISCA)","title":"Conduct AMR data analysis","text":"create Weighted-Incidence Syndromic Combination Antibiogram (WISCA), simply set wisca = TRUE antibiogram() function, use dedicated wisca() function. Unlike traditional antibiograms, WISCA provides syndrome-based susceptibility estimates, weighted pathogen incidence antimicrobial susceptibility patterns. WISCA uses Bayesian decision model integrate data multiple pathogens, improving empirical therapy guidance, especially low-incidence infections. pathogen-agnostic, meaning results syndrome-based rather stratified microorganism. reliable results, ensure data includes first isolates (use first_isolate()) consider filtering top n species (use top_n_microorganisms()), WISCA outcomes meaningful based robust incidence estimates. patient- syndrome-specific WISCA, run function grouped tibble, .e., using group_by() first:","code":"example_isolates %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),         minimum = 10) # Recommended threshold: ≥30 example_isolates %>%   top_n_microorganisms(n = 10) %>%   group_by(age_group = age_groups(age, c(25, 50, 75)),            gender) %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-antibiograms","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Plotting antibiograms","title":"Conduct AMR data analysis","text":"Antibiograms can plotted using autoplot() ggplot2 packages, since AMR package provides extension function:  calculate antimicrobial resistance sensible way, also correcting results, use resistance() susceptibility() functions.","code":"autoplot(combined_ab)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"resistance-percentages","dir":"Articles","previous_headings":"Analysing the data","what":"Resistance percentages","title":"Conduct AMR data analysis","text":"functions resistance() susceptibility() can used calculate antimicrobial resistance susceptibility. specific analyses, functions proportion_S(), proportion_SI(), proportion_I(), proportion_IR() proportion_R() can used determine proportion specific antimicrobial outcome. functions contain minimum argument, denoting minimum required number test results returning value. functions otherwise return NA. default minimum = 30, following CLSI M39-A4 guideline applying microbial epidemiology. per EUCAST guideline 2019, calculate resistance proportion R (proportion_R(), equal resistance()) susceptibility proportion S (proportion_SI(), equal susceptibility()). functions can used : can used conjunction group_by() summarise(), dplyr package:","code":"our_data_1st %>% resistance(AMX) #> [1] 0.4203377 our_data_1st %>%   group_by(hospital) %>%   summarise(amoxicillin = resistance(AMX)) #> # A tibble: 3 × 2 #>   hospital amoxicillin #>   <chr>          <dbl> #> 1 A              0.340 #> 2 B              0.551 #> 3 C              0.370"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"interpreting-mic-and-disk-diffusion-values","dir":"Articles","previous_headings":"Analysing the data","what":"Interpreting MIC and Disk Diffusion Values","title":"Conduct AMR data analysis","text":"Minimal inhibitory concentration (MIC) values disk diffusion diameters can interpreted clinical breakpoints (SIR) using .sir(). ’s example randomly generated MIC values Klebsiella pneumoniae ciprofloxacin: allows direct interpretation according EUCAST CLSI breakpoints, facilitating automated AMR data processing.","code":"set.seed(123) mic_values <- random_mic(100) sir_values <- as.sir(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\")  my_data <- tibble(MIC = mic_values, SIR = sir_values) my_data #> # A tibble: 100 × 2 #>         MIC SIR   #>       <mic> <sir> #>  1 <=0.0001   S   #>  2   0.0160   S   #>  3 >=8.0000   R   #>  4   0.0320   S   #>  5   0.0080   S   #>  6  64.0000   R   #>  7   0.0080   S   #>  8   0.1250   S   #>  9   0.0320   S   #> 10   0.0002   S   #> # ℹ 90 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-mic-and-sir-interpretations","dir":"Articles","previous_headings":"Analysing the data","what":"Plotting MIC and SIR Interpretations","title":"Conduct AMR data analysis","text":"can visualise MIC distributions SIR interpretations using ggplot2, using new scale_y_mic() y-axis scale_colour_sir() colour-code SIR categories.  plot provides intuitive way assess susceptibility patterns across different groups incorporating clinical breakpoints. straightforward less manual approach, ggplot2’s function autoplot() extended package directly plot MIC disk diffusion values:   Author: Dr. Matthijs Berends, 23rd Feb 2025","code":"# add a group my_data$group <- rep(c(\"A\", \"B\", \"C\", \"D\"), each = 25)   ggplot(my_data,        aes(x = group, y = MIC, colour = SIR)) +   geom_jitter(width = 0.2, size = 2) +   geom_boxplot(fill = NA, colour = \"grey40\") +   scale_y_mic() +   scale_colour_sir() +   labs(title = \"MIC Distribution and SIR Interpretation\",        x = \"Sample Groups\",        y = \"MIC (mg/L)\") autoplot(mic_values) # by providing `mo` and `ab`, colours will indicate the SIR interpretation: autoplot(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\")"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"AMR for Python","text":"AMR package R powerful tool antimicrobial resistance (AMR) analysis. provides extensive features handling microbial antimicrobial data. However, work primarily Python, now intuitive option available: AMR Python package. Python package wrapper around AMR R package. uses rpy2 package internally. Despite need R installed, Python users can now easily work AMR data directly Python code.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"prerequisites","dir":"Articles","previous_headings":"","what":"Prerequisites","title":"AMR for Python","text":"package tested virtual environment (venv). can set environment running: can activate environment, venv ready work .","code":"# linux and macOS: python -m venv /path/to/new/virtual/environment  # Windows: python -m venv C:\\path\\to\\new\\virtual\\environment"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"install-amr","dir":"Articles","previous_headings":"","what":"Install AMR","title":"AMR for Python","text":"Since Python package available official Python Package Index, can just run: Make sure R installed. need install AMR R package, installed automatically. Linux: macOS (using Homebrew): Windows, visit CRAN download page download install R.","code":"pip install AMR # Ubuntu / Debian sudo apt install r-base # Fedora: sudo dnf install R # CentOS/RHEL sudo yum install R brew install r"},{"path":[]},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"cleaning-taxonomy","dir":"Articles","previous_headings":"Examples of Usage","what":"Cleaning Taxonomy","title":"AMR for Python","text":"’s example demonstrates clean microorganism drug names using AMR Python package:","code":"import pandas as pd import AMR  # Sample data data = {     \"MOs\": ['E. coli', 'ESCCOL', 'esco', 'Esche coli'],     \"Drug\": ['Cipro', 'CIP', 'J01MA02', 'Ciproxin'] } df = pd.DataFrame(data)  # Use AMR functions to clean microorganism and drug names df['MO_clean'] = AMR.mo_name(df['MOs']) df['Drug_clean'] = AMR.ab_name(df['Drug'])  # Display the results print(df)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"explanation","dir":"Articles","previous_headings":"Examples of Usage > Cleaning Taxonomy","what":"Explanation","title":"AMR for Python","text":"mo_name: function standardises microorganism names. , different variations Escherichia coli (“E. coli”, “ESCCOL”, “esco”, “Esche coli”) converted correct, standardised form, “Escherichia coli”. ab_name: Similarly, function standardises antimicrobial names. different representations ciprofloxacin (e.g., “Cipro”, “CIP”, “J01MA02”, “Ciproxin”) converted standard name, “Ciprofloxacin”.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"calculating-amr","dir":"Articles","previous_headings":"Examples of Usage","what":"Calculating AMR","title":"AMR for Python","text":"","code":"import AMR import pandas as pd  df = AMR.example_isolates result = AMR.resistance(df[\"AMX\"]) print(result) [0.59555556]"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"generating-antibiograms","dir":"Articles","previous_headings":"Examples of Usage","what":"Generating Antibiograms","title":"AMR for Python","text":"One core functions AMR package generating antibiogram, table summarises antimicrobial susceptibility bacterial isolates. ’s can generate antibiogram Python: example, generate antibiogram selecting various antibiotics.","code":"result2a = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]]) print(result2a) result2b = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]], mo_transform = \"gramstain\") print(result2b)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"taxonomic-data-sets-now-in-python","dir":"Articles","previous_headings":"Examples of Usage","what":"Taxonomic Data Sets Now in Python!","title":"AMR for Python","text":"Python user, might like important data sets AMR R package, microorganisms, antimicrobials, clinical_breakpoints, example_isolates, now available regular Python data frames:","code":"AMR.microorganisms AMR.antimicrobials"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"conclusion","dir":"Articles","previous_headings":"","what":"Conclusion","title":"AMR for Python","text":"AMR Python package, Python users can now effortlessly call R functions AMR R package. eliminates need complex rpy2 configurations provides clean, easy--use interface antimicrobial resistance analysis. examples provided demonstrate can applied typical workflows, standardising microorganism antimicrobial names calculating resistance. just running import AMR, users can seamlessly integrate robust features R AMR package Python workflows. Whether ’re cleaning data analysing resistance patterns, AMR Python package makes easy work AMR data Python.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-1-using-antimicrobial-selectors","dir":"Articles","previous_headings":"","what":"Example 1: Using Antimicrobial Selectors","title":"AMR with tidymodels","text":"leveraging power tidymodels AMR package, ’ll build reproducible machine learning workflow predict Gramstain microorganism two important antibiotic classes: aminoglycosides beta-lactams.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Objective","title":"AMR with tidymodels","text":"goal build predictive model using tidymodels framework determine Gramstain microorganism based microbial data. : Preprocess data using selector functions aminoglycosides() betalactams(). Define logistic regression model prediction. Use structured tidymodels workflow preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Data Preparation","title":"AMR with tidymodels","text":"begin loading required libraries preparing example_isolates dataset AMR package. Prepare data: Explanation: aminoglycosides() betalactams() dynamically select columns antimicrobials classes. drop_na() ensures model receives complete cases training.","code":"# Load required libraries library(AMR)          # For AMR data analysis library(tidymodels)   # For machine learning workflows, and data manipulation (dplyr, tidyr, ...) # Your data could look like this: example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # Select relevant columns for prediction data <- example_isolates %>%   # select AB results dynamically   select(mo, aminoglycosides(), betalactams()) %>%   # replace NAs with NI (not-interpretable)    mutate(across(where(is.sir),                  ~replace_na(.x, \"NI\")),           # make factors of SIR columns           across(where(is.sir),                  as.integer),           # get Gramstain of microorganisms           mo = as.factor(mo_gramstain(mo))) %>%   # drop NAs - the ones without a Gramstain (fungi, etc.)   drop_na() #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `betalactams()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define tidymodels workflow, consists three steps: preprocessing, model specification, fitting.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"create recipe preprocess data modelling. recipe includes least one preprocessing operation, like step_corr(), necessary parameters can estimated training set using prep(): Explanation: recipe(mo ~ ., data = data) take mo column outcome columns predictors. step_corr() removes predictors (.e., antibiotic columns) higher correlation 90%. Notice recipe contains just antimicrobial selector functions - need define columns specifically. preparation (retrieved prep()) can see columns variables ‘AMX’ ‘CTX’ removed correlate much existing, variables.","code":"# Define the recipe for data preprocessing resistance_recipe <- recipe(mo ~ ., data = data) %>%   step_corr(c(aminoglycosides(), betalactams()), threshold = 0.9) resistance_recipe #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Operations #> • Correlation filter on: c(aminoglycosides(), betalactams()) prep(resistance_recipe) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `betalactams()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem) #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Training information #> Training data contained 1968 data points and no incomplete rows. #>  #> ── Operations #> • Correlation filter on: AMX CTX | Trained"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"define logistic regression model since resistance prediction binary classification task. Explanation: logistic_reg() sets logistic regression model. set_engine(\"glm\") specifies use R’s built-GLM engine.","code":"# Specify a logistic regression model logistic_model <- logistic_reg() %>%   set_engine(\"glm\") # Use the Generalised Linear Model engine logistic_model #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"bundle recipe model together workflow, organises entire modelling process.","code":"# Combine the recipe and model into a workflow resistance_workflow <- workflow() %>%   add_recipe(resistance_recipe) %>% # Add the preprocessing recipe   add_model(logistic_model) # Add the logistic regression model resistance_workflow #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: logistic_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 1 Recipe Step #>  #> • step_corr() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"train model, split data training testing sets. , fit workflow training set evaluate performance. Explanation: initial_split() splits data training testing sets. fit() trains workflow training set. Notice fit(), antimicrobial selector functions internally called . training, functions called since stored recipe. Next, evaluate model testing data. Explanation: predict() generates predictions testing set. metrics() computes evaluation metrics like accuracy kappa. appears can predict Gram stain 99.5% accuracy based AMR results aminoglycosides beta-lactam antibiotics. ROC curve looks like :","code":"# Split data into training and testing sets set.seed(123) # For reproducibility data_split <- initial_split(data, prop = 0.8) # 80% training, 20% testing training_data <- training(data_split) # Training set testing_data <- testing(data_split)   # Testing set  # Fit the workflow to the training data fitted_workflow <- resistance_workflow %>%   fit(training_data) # Train the model # Make predictions on the testing set predictions <- fitted_workflow %>%   predict(testing_data)                # Generate predictions probabilities <- fitted_workflow %>%   predict(testing_data, type = \"prob\") # Generate probabilities  predictions <- predictions %>%   bind_cols(probabilities) %>%   bind_cols(testing_data) # Combine with true labels  predictions #> # A tibble: 394 × 24 #>    .pred_class   `.pred_Gram-negative` `.pred_Gram-positive` mo        GEN   TOB #>    <fct>                         <dbl>                 <dbl> <fct>   <int> <int> #>  1 Gram-positive              1.07e- 1             8.93 e- 1 Gram-p…     5     5 #>  2 Gram-positive              3.17e- 8             1.000e+ 0 Gram-p…     5     1 #>  3 Gram-negative              9.99e- 1             1.42 e- 3 Gram-n…     5     5 #>  4 Gram-positive              2.22e-16             1    e+ 0 Gram-p…     5     5 #>  5 Gram-negative              9.46e- 1             5.42 e- 2 Gram-n…     5     5 #>  6 Gram-positive              1.07e- 1             8.93 e- 1 Gram-p…     5     5 #>  7 Gram-positive              2.22e-16             1    e+ 0 Gram-p…     1     5 #>  8 Gram-positive              2.22e-16             1    e+ 0 Gram-p…     4     4 #>  9 Gram-negative              1   e+ 0             2.22 e-16 Gram-n…     1     1 #> 10 Gram-positive              6.05e-11             1.000e+ 0 Gram-p…     4     4 #> # ℹ 384 more rows #> # ℹ 18 more variables: AMK <int>, KAN <int>, PEN <int>, OXA <int>, FLC <int>, #> #   AMX <int>, AMC <int>, AMP <int>, TZP <int>, CZO <int>, FEP <int>, #> #   CXM <int>, FOX <int>, CTX <int>, CAZ <int>, CRO <int>, IPM <int>, MEM <int>  # Evaluate model performance metrics <- predictions %>%   metrics(truth = mo, estimate = .pred_class) # Calculate performance metrics  metrics #> # A tibble: 2 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989   # To assess some other model properties, you can make our own `metrics()` function our_metrics <- metric_set(accuracy, kap, ppv, npv) # add Positive Predictive Value and Negative Predictive Value metrics2 <- predictions %>%   our_metrics(truth = mo, estimate = .pred_class) # run again on our `our_metrics()` function  metrics2 #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989 #> 3 ppv      binary         0.987 #> 4 npv      binary         1 predictions %>%   roc_curve(mo, `.pred_Gram-negative`) %>%   autoplot()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Conclusion","title":"AMR with tidymodels","text":"post, demonstrated build machine learning pipeline tidymodels framework AMR package. combining selector functions like aminoglycosides() betalactams() tidymodels, efficiently prepared data, trained model, evaluated performance. workflow extensible antimicrobial classes resistance patterns, empowering users analyse AMR data systematically reproducibly.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-2-predicting-esbl-presence-using-raw-mics","dir":"Articles","previous_headings":"","what":"Example 2: Predicting ESBL Presence Using Raw MICs","title":"AMR with tidymodels","text":"second example, demonstrate use <mic> columns directly tidymodels workflows using AMR-specific recipe steps. includes transformation log2 scale using step_mic_log2(), prepares MIC values use classification models. approach idea formed basis publication DOI: 10.3389/fmicb.2025.1582703 model presence extended-spectrum beta-lactamases (ESBL).","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Objective","title":"AMR with tidymodels","text":"goal : Use raw MIC values predict whether bacterial isolate produces ESBL. Apply AMR-aware preprocessing tidymodels recipe. Train classification model evaluate predictive performance.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Data Preparation","title":"AMR with tidymodels","text":"use esbl_isolates dataset comes AMR package. Explanation: esbl_isolates: Contains MIC test results ESBL status isolate. mutate(esbl = ...): Converts target column ordered factor classification.","code":"# Load required libraries library(AMR) library(tidymodels)  # View the esbl_isolates data set esbl_isolates #> # A tibble: 500 × 19 #>    esbl  genus   AMC   AMP   TZP   CXM   FOX   CTX   CAZ   GEN   TOB   TMP   SXT #>    <lgl> <chr> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> #>  1 FALSE Esch…    32    32     4    64    64  8.00  8.00     1     1  16.0    20 #>  2 FALSE Esch…    32    32     4    64    64  4.00  8.00     1     1  16.0   320 #>  3 FALSE Esch…     4     2    64     8     4  8.00  0.12    16    16   0.5    20 #>  4 FALSE Kleb…    32    32    16    64    64  8.00  8.00     1     1   0.5    20 #>  5 FALSE Esch…    32    32     4     4     4  0.25  2.00     1     1  16.0   320 #>  6 FALSE Citr…    32    32    16    64    64 64.00 32.00     1     1   0.5    20 #>  7 FALSE Morg…    32    32     4    64    64 16.00  2.00     1     1   0.5    20 #>  8 FALSE Prot…    16    32     4     1     4  8.00  0.12     1     1  16.0   320 #>  9 FALSE Ente…    32    32     8    64    64 32.00  4.00     1     1   0.5    20 #> 10 FALSE Citr…    32    32    32    64    64  8.00 64.00     1     1  16.0   320 #> # ℹ 490 more rows #> # ℹ 6 more variables: NIT <mic>, FOS <mic>, CIP <mic>, IPM <mic>, MEM <mic>, #> #   COL <mic>  # Prepare a binary outcome and convert to ordered factor data <- esbl_isolates %>%   mutate(esbl = factor(esbl, levels = c(FALSE, TRUE), ordered = TRUE))"},{"path":[]},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"use step_mic_log2() function log2-transform MIC values, ensuring MICs numeric properly scaled. MIC predictors can easily agnostically selected using new all_mic_predictors(): Explanation: remove_role(): Removes irrelevant variables like genus. step_mic_log2(): Applies log2(.numeric(...)) MIC predictors one go. prep(): Finalises recipe based training data.","code":"# Split into training and testing sets set.seed(123) split <- initial_split(data) training_data <- training(split) testing_data <- testing(split)  # Define the recipe mic_recipe <- recipe(esbl ~ ., data = training_data) %>%   remove_role(genus, old_role = \"predictor\") %>%  # Remove non-informative variable   step_mic_log2(all_mic_predictors()) #%>%         # Log2 transform all MIC predictors  # prep()  mic_recipe #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:          1 #> predictor:       17 #> undeclared role:  1 #>  #> ── Operations #> • Log2 transformation of MIC columns: all_mic_predictors()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"use simple logistic regression model ESBL presence, though recent models xgboost (link parsnip manual) much precise. Explanation: logistic_reg(): Specifies binary classification model. set_engine(\"glm\"): Uses base R GLM engine.","code":"# Define the model model <- logistic_reg(mode = \"classification\") %>%   set_engine(\"glm\")  model #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"","code":"# Create workflow workflow_model <- workflow() %>%   add_recipe(mic_recipe) %>%   add_model(model)  workflow_model #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: logistic_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 1 Recipe Step #>  #> • step_mic_log2() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"Explanation: fit(): Trains model processed training data. predict(): Produces predictions unseen test data. metric_set(): Allows evaluating multiple classification metrics. appears can predict ESBL gene presence positive predictive value (PPV) 92.1% negative predictive value (NPV) 91.9 using simplistic logistic regression model.","code":"# Fit the model fitted <- fit(workflow_model, training_data)  # Generate predictions predictions <- predict(fitted, testing_data) %>%   bind_cols(testing_data)  # Evaluate model performance our_metrics <- metric_set(accuracy, kap, ppv, npv) metrics <- our_metrics(predictions, truth = esbl, estimate = .pred_class)  metrics #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.92  #> 2 kap      binary         0.840 #> 3 ppv      binary         0.921 #> 4 npv      binary         0.919"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"visualising-predictions","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Visualising Predictions","title":"AMR with tidymodels","text":"can visualise predictions comparing predicted actual ESBL status.","code":"library(ggplot2)  ggplot(predictions, aes(x = esbl, fill = .pred_class)) +   geom_bar(position = \"stack\") +   labs(title = \"Predicted vs Actual ESBL Status\",        x = \"Actual ESBL\",        y = \"Count\") +   theme_minimal()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Conclusion","title":"AMR with tidymodels","text":"example, showcased new AMR-specific recipe steps simplify working <mic> columns tidymodels. step_mic_log2() transformation converts ordered MICs log2-transformed numerics, improving compatibility classification models. pipeline enables realistic, reproducible, interpretable modelling antimicrobial resistance data.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-3-predicting-amr-over-time","dir":"Articles","previous_headings":"","what":"Example 3: Predicting AMR Over Time","title":"AMR with tidymodels","text":"third example, aim predict antimicrobial resistance (AMR) trends time using tidymodels. model resistance three antibiotics (amoxicillin AMX, amoxicillin-clavulanic acid AMC, ciprofloxacin CIP), based historical data grouped year hospital ward.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Objective","title":"AMR with tidymodels","text":"goal : Prepare dataset aggregating resistance data time. Define regression model predict AMR trends. Use tidymodels preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Data Preparation","title":"AMR with tidymodels","text":"start transforming example_isolates dataset structured time-series format. Explanation: mo_name(mo): Converts microbial codes proper species names. resistance(): Converts AMR results numeric values (proportion resistant isolates). group_by(year, ward, species): Aggregates resistance rates year ward.","code":"# Load required libraries library(AMR) library(tidymodels)  # Transform dataset data_time <- example_isolates %>%   top_n_microorganisms(n = 10) %>% # Filter on the top #10 species   mutate(year = as.integer(format(date, \"%Y\")),  # Extract year from date          gramstain = mo_gramstain(mo)) %>% # Get taxonomic names   group_by(year, gramstain) %>%   summarise(across(c(AMX, AMC, CIP),                     function(x) resistance(x, minimum = 0),                    .names = \"res_{.col}\"),              .groups = \"drop\") %>%    filter(!is.na(res_AMX) & !is.na(res_AMC) & !is.na(res_CIP)) # Drop missing values #> ℹ Using column 'mo' as input for `col_mo`.  data_time #> # A tibble: 32 × 5 #>     year gramstain     res_AMX res_AMC res_CIP #>    <int> <chr>           <dbl>   <dbl>   <dbl> #>  1  2002 Gram-negative   1      0.105   0.0606 #>  2  2002 Gram-positive   0.838  0.182   0.162  #>  3  2003 Gram-negative   1      0.0714  0      #>  4  2003 Gram-positive   0.714  0.244   0.154  #>  5  2004 Gram-negative   0.464  0.0938  0      #>  6  2004 Gram-positive   0.849  0.299   0.244  #>  7  2005 Gram-negative   0.412  0.132   0.0588 #>  8  2005 Gram-positive   0.882  0.382   0.154  #>  9  2006 Gram-negative   0.379  0       0.1    #> 10  2006 Gram-positive   0.778  0.333   0.353  #> # ℹ 22 more rows"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define modelling workflow, consists preprocessing step, model specification, fitting process.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"Explanation: step_dummy(): Encodes categorical variables (ward, species) numerical indicators. step_normalize(): Normalises year variable. step_nzv(): Removes near-zero variance predictors.","code":"# Define the recipe resistance_recipe_time <- recipe(res_AMX ~ year + gramstain, data = data_time) %>%   step_dummy(gramstain, one_hot = TRUE) %>%  # Convert categorical to numerical   step_normalize(year) %>%  # Normalise year for better model performance   step_nzv(all_predictors())  # Remove near-zero variance predictors  resistance_recipe_time #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:   1 #> predictor: 2 #>  #> ── Operations #> • Dummy variables from: gramstain #> • Centering and scaling for: year #> • Sparse, unbalanced variable filter on: all_predictors()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"use linear regression model predict resistance trends. Explanation: linear_reg(): Defines linear regression model. set_engine(\"lm\"): Uses R’s built-linear regression engine.","code":"# Define the linear regression model lm_model <- linear_reg() %>%   set_engine(\"lm\") # Use linear regression  lm_model #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"combine preprocessing recipe model workflow.","code":"# Create workflow resistance_workflow_time <- workflow() %>%   add_recipe(resistance_recipe_time) %>%   add_model(lm_model)  resistance_workflow_time #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: linear_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 3 Recipe Steps #>  #> • step_dummy() #> • step_normalize() #> • step_nzv() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"split data training testing sets, fit model, evaluate performance. Explanation: initial_split(): Splits data training testing sets. fit(): Trains workflow. predict(): Generates resistance predictions. metrics(): Evaluates model performance.","code":"# Split the data set.seed(123) data_split_time <- initial_split(data_time, prop = 0.8) train_time <- training(data_split_time) test_time <- testing(data_split_time)  # Train the model fitted_workflow_time <- resistance_workflow_time %>%   fit(train_time)  # Make predictions predictions_time <- fitted_workflow_time %>%   predict(test_time) %>%   bind_cols(test_time)   # Evaluate model metrics_time <- predictions_time %>%   metrics(truth = res_AMX, estimate = .pred)  metrics_time #> # A tibble: 3 × 3 #>   .metric .estimator .estimate #>   <chr>   <chr>          <dbl> #> 1 rmse    standard      0.0774 #> 2 rsq     standard      0.711  #> 3 mae     standard      0.0704"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"visualising-predictions-1","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Visualising Predictions","title":"AMR with tidymodels","text":"plot resistance trends time amoxicillin.  Additionally, can visualise resistance trends ggplot2 directly add linear models :","code":"library(ggplot2)  # Plot actual vs predicted resistance over time ggplot(predictions_time, aes(x = year)) +   geom_point(aes(y = res_AMX, color = \"Actual\")) +   geom_line(aes(y = .pred, color = \"Predicted\")) +   labs(title = \"Predicted vs Actual AMX Resistance Over Time\",        x = \"Year\",        y = \"Resistance Proportion\") +   theme_minimal() ggplot(data_time, aes(x = year, y = res_AMX, color = gramstain)) +   geom_line() +   labs(title = \"AMX Resistance Trends\",        x = \"Year\",        y = \"Resistance Proportion\") +   # add a linear model directly in ggplot2:   geom_smooth(method = \"lm\",               formula = y ~ x,               alpha = 0.25) +   theme_minimal()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Conclusion","title":"AMR with tidymodels","text":"example, demonstrated analyze AMR trends time using tidymodels. aggregating resistance rates year hospital ward, built predictive model track changes resistance amoxicillin (AMX), amoxicillin-clavulanic acid (AMC), ciprofloxacin (CIP). method can extended antibiotics resistance patterns, providing valuable insights AMR dynamics healthcare settings.","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Apply EUCAST rules","text":"EUCAST rules? European Committee Antimicrobial Susceptibility Testing (EUCAST) states website: EUCAST expert rules (see ) tabulated collection expert knowledge interpretive rules, expected resistant phenotypes expected susceptible phenotypes applied antimicrobial susceptibility testing order reduce testing, reduce errors make appropriate recommendations reporting particular resistances. Europe, lot medical microbiological laboratories already apply rules (Brown et al., 2015). package features latest insights expected resistant phenotypes (v1.2, 2023).","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"Apply EUCAST rules","text":"rules can used discard improbable bug-drug combinations data. example, Klebsiella produces beta-lactamase prevents ampicillin (amoxicillin) working . words, practically every strain Klebsiella resistant ampicillin. Sometimes, laboratory data can still contain strains Klebsiella susceptible ampicillin. antibiogram available identification available, antibiogram re-interpreted based identification. eucast_rules() function resolves , applying latest ‘EUCAST Expected Resistant Phenotypes’ guideline: convenient function mo_is_intrinsic_resistant() uses guideline, allows check one specific microorganisms antimicrobials: EUCAST rules can used correction, can also used filling known resistance susceptibility based results antimicrobials drugs. process called interpretive reading, basically form imputation:","code":"oops <- tibble::tibble(   mo = c(     \"Klebsiella pneumoniae\",     \"Escherichia coli\"   ),   ampicillin = as.sir(\"S\") ) oops #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   S        #> 2 Escherichia coli        S    eucast_rules(oops, info = FALSE, overwrite = TRUE) #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   R        #> 2 Escherichia coli        S mo_is_intrinsic_resistant(   c(\"Klebsiella pneumoniae\", \"Escherichia coli\"),   \"ampicillin\" ) #> [1]  TRUE FALSE  mo_is_intrinsic_resistant(   \"Klebsiella pneumoniae\",   c(\"ampicillin\", \"kanamycin\") ) #> [1]  TRUE FALSE data <- tibble::tibble(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylenicillin   FOX = \"S\"  # Cefoxitin ) data eucast_rules(data, overwrite = TRUE)"},{"path":[]},{"path":"https://amr-for-r.org/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"Conduct principal component analysis (PCA) for AMR","text":"PCA, need transform AMR data first. example_isolates data set package looks like: Now transform data set resistance percentages per taxonomic order genus:","code":"library(AMR) library(dplyr) glimpse(example_isolates) #> Rows: 2,000 #> Columns: 46 #> $ date    <date> 2002-01-02, 2002-01-03, 2002-01-07, 2002-01-07, 2002-01-13, 2… #> $ patient <chr> \"A77334\", \"A77334\", \"067927\", \"067927\", \"067927\", \"067927\", \"4… #> $ age     <dbl> 65, 65, 45, 45, 45, 45, 78, 78, 45, 79, 67, 67, 71, 71, 75, 50… #> $ gender  <chr> \"F\", \"F\", \"F\", \"F\", \"F\", \"F\", \"M\", \"M\", \"F\", \"F\", \"M\", \"M\", \"M… #> $ ward    <chr> \"Clinical\", \"Clinical\", \"ICU\", \"ICU\", \"ICU\", \"ICU\", \"Clinical\"… #> $ mo      <mo> \"B_ESCHR_COLI\", \"B_ESCHR_COLI\", \"B_STPHY_EPDR\", \"B_STPHY_EPDR\",… #> $ PEN     <sir> R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, S,… #> $ OXA     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ FLC     <sir> NA, NA, R, R, R, R, S, S, R, S, S, S, NA, NA, NA, NA, NA, R, R… #> $ AMX     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ AMC     <sir> I, I, NA, NA, NA, NA, S, S, NA, NA, S, S, I, I, R, I, I, NA, N… #> $ AMP     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ TZP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CZO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ FEP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CXM     <sir> I, I, R, R, R, R, S, S, R, S, S, S, S, S, NA, S, S, R, R, S, S… #> $ FOX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ CTX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ CAZ     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, S, S, R, R, … #> $ CRO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ GEN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TOB     <sir> NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, S, S, NA, NA, NA… #> $ AMK     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ KAN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TMP     <sir> R, R, S, S, R, R, R, R, S, S, NA, NA, S, S, S, S, S, R, R, R, … #> $ SXT     <sir> R, R, S, S, NA, NA, NA, NA, S, S, NA, NA, S, S, S, S, S, NA, N… #> $ NIT     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R,… #> $ FOS     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ LNZ     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ CIP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, NA, S, S… #> $ MFX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ VAN     <sir> R, R, S, S, S, S, S, S, S, S, NA, NA, R, R, R, R, R, S, S, S, … #> $ TEC     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ TCY     <sir> R, R, S, S, S, S, S, S, S, I, S, S, NA, NA, I, R, R, S, I, R, … #> $ TGC     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ DOX     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ ERY     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ CLI     <sir> R, R, NA, NA, NA, R, NA, NA, NA, NA, NA, NA, R, R, R, R, R, NA… #> $ AZM     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ IPM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ MEM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ MTR     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CHL     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ COL     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, R, R, R, R, … #> $ MUP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ RIF     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… resistance_data <- example_isolates %>%   group_by(     order = mo_order(mo), # group on anything, like order     genus = mo_genus(mo)   ) %>% #  and genus as we do here   summarise_if(is.sir, resistance) %>% # then get resistance of all drugs   select(     order, genus, AMC, CXM, CTX,     CAZ, GEN, TOB, TMP, SXT   ) # and select only relevant columns  head(resistance_data) #> # A tibble: 6 × 10 #> # Groups:   order [5] #>   order             genus          AMC   CXM   CTX   CAZ   GEN   TOB   TMP   SXT #>   <chr>             <chr>        <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 (unknown order)   (unknown ge…    NA    NA    NA    NA    NA    NA    NA    NA #> 2 Actinomycetales   Schaalia        NA    NA    NA    NA    NA    NA    NA    NA #> 3 Bacteroidales     Bacteroides     NA    NA    NA    NA    NA    NA    NA    NA #> 4 Campylobacterales Campylobact…    NA    NA    NA    NA    NA    NA    NA    NA #> 5 Caryophanales     Gemella         NA    NA    NA    NA    NA    NA    NA    NA #> 6 Caryophanales     Listeria        NA    NA    NA    NA    NA    NA    NA    NA"},{"path":"https://amr-for-r.org/articles/PCA.html","id":"perform-principal-component-analysis","dir":"Articles","previous_headings":"","what":"Perform principal component analysis","title":"Conduct principal component analysis (PCA) for AMR","text":"new pca() function automatically filter rows contain numeric values selected variables, now need : result can reviewed good old summary() function: Good news. first two components explain total 93.3% variance (see PC1 PC2 values Proportion Variance. can create -called biplot base R biplot() function, see antimicrobial resistance per drug explain difference per microorganism.","code":"pca_result <- pca(resistance_data) #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. summary(pca_result) #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\" #> Importance of components: #>                           PC1    PC2    PC3     PC4     PC5     PC6       PC7 #> Standard deviation     2.1539 1.6807 0.6138 0.33879 0.20808 0.03140 1.232e-16 #> Proportion of Variance 0.5799 0.3531 0.0471 0.01435 0.00541 0.00012 0.000e+00 #> Cumulative Proportion  0.5799 0.9330 0.9801 0.99446 0.99988 1.00000 1.000e+00 #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\""},{"path":"https://amr-for-r.org/articles/PCA.html","id":"plotting-the-results","dir":"Articles","previous_headings":"","what":"Plotting the results","title":"Conduct principal component analysis (PCA) for AMR","text":"can’t see explanation points. Perhaps works better new ggplot_pca() function, automatically adds right labels even groups:  can also print ellipse per group, edit appearance:","code":"biplot(pca_result) ggplot_pca(pca_result) ggplot_pca(pca_result, ellipse = TRUE) +   ggplot2::labs(title = \"An AMR/PCA biplot!\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"import-of-data","dir":"Articles","previous_headings":"","what":"Import of data","title":"Work with WHONET data","text":"tutorial assumes already imported WHONET data e.g. readxl package. RStudio, can done using menu button ‘Import Dataset’ tab ‘Environment’. Choose option ‘Excel’ select exported file. Make sure date fields imported correctly. example syntax look like : package comes example data set WHONET. use analysis.","code":"library(readxl) data <- read_excel(path = \"path/to/your/file.xlsx\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"Work with WHONET data","text":"First, load relevant packages yet . use tidyverse analyses. . don’t know yet, suggest read website: https://www.tidyverse.org/. transform variables simplify automate analysis: Microorganisms transformed microorganism codes (called mo) using Catalogue Life reference data set, contains ~70,000 microorganisms taxonomic kingdoms Bacteria, Fungi Protozoa. tranformation .mo(). function also recognises almost WHONET abbreviations microorganisms. Antimicrobial results interpretations clean valid. words, contain values \"S\", \"\" \"R\". exactly .sir() function . errors warnings, values transformed succesfully. also created package dedicated data cleaning checking, called cleaner package. freq() function can used create frequency tables. let’s check data, couple frequency tables: Frequency table Class: character Length: 500 Available: 500 (100%, NA: 0 = 0%) Unique: 38 Shortest: 11 Longest: 40 (omitted 28 entries, n = 57 [11.4%]) Frequency table Class: factor > ordered > sir (numeric) Length: 500 Levels: 5: S < SDD < < R < NI Available: 481 (96.2%, NA: 19 = 3.8%) Unique: 3 Drug: Amoxicillin/clavulanic acid (AMC, J01CR02/QJ01CR02) Drug group: Beta-lactams/penicillins %SI: 78.59%","code":"library(dplyr) # part of tidyverse library(ggplot2) # part of tidyverse library(AMR) # this package library(cleaner) # to create frequency tables # transform variables data <- WHONET %>%   # get microbial ID based on given organism   mutate(mo = as.mo(Organism)) %>%   # transform everything from \"AMP_ND10\" to \"CIP_EE\" to the new `sir` class   mutate_at(vars(AMP_ND10:CIP_EE), as.sir) # our newly created `mo` variable, put in the mo_name() function data %>% freq(mo_name(mo), nmax = 10) # our transformed antibiotic columns # amoxicillin/clavulanic acid (J01CR02) as an example data %>% freq(AMC_ND2)"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"a-first-glimpse-at-results","dir":"Articles","previous_headings":"","what":"A first glimpse at results","title":"Work with WHONET data","text":"easy ggplot already give lot information, using included ggplot_sir() function:","code":"data %>%   group_by(Country) %>%   select(Country, AMP_ND2, AMC_ED20, CAZ_ED10, CIP_ED5) %>%   ggplot_sir(translate_ab = \"ab\", facet = \"Country\", datalabels = FALSE)"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Estimating Empirical Coverage with WISCA","text":"Clinical guidelines empirical antimicrobial therapy require probabilistic reasoning: chance regimen cover likely infecting organisms, culture results available? purpose WISCA, Weighted-Incidence Syndromic Combination Antibiogram. WISCA Bayesian approach integrates: Pathogen prevalence (often species causes syndrome), Regimen susceptibility (often regimen works pathogen known), estimate overall empirical coverage antimicrobial regimens, quantified uncertainty. vignette explains WISCA works, useful, apply using AMR package.","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"why-traditional-antibiograms-fall-short","dir":"Articles","previous_headings":"","what":"Why traditional antibiograms fall short","title":"Estimating Empirical Coverage with WISCA","text":"standard antibiogram gives : clinicians don’t know species priori. need choose regimen covers likely pathogens, without knowing one present. Traditional antibiograms calculate susceptibility % just number resistant isolates divided total number tested isolates. Therefore, traditional antibiograms: Fragment information organism, weight real-world prevalence, account combination therapy sample size, provide uncertainty.","code":"Species → Antibiotic → Susceptibility %"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"the-idea-of-wisca","dir":"Articles","previous_headings":"","what":"The idea of WISCA","title":"Estimating Empirical Coverage with WISCA","text":"WISCA asks: “probability regimen cover pathogen, given syndrome?” means combining two things: Incidence pathogen syndrome, Susceptibility pathogen regimen. can write : Coverage=∑(Incidencei×Susceptibilityi)\\text{Coverage} = \\sum_i (\\text{Incidence}_i \\times \\text{Susceptibility}_i) example, suppose: E. coli causes 60% cases, 90% E. coli susceptible drug. Klebsiella causes 40% cases, 70% Klebsiella susceptible. : Coverage=(0.6×0.9)+(0.4×0.7)=0.82\\text{Coverage} = (0.6 \\times 0.9) + (0.4 \\times 0.7) = 0.82 real data, incidence susceptibility estimated samples, carry uncertainty. WISCA models probabilistically, using conjugate Bayesian distributions.","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"pathogen-incidence","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Pathogen incidence","title":"Estimating Empirical Coverage with WISCA","text":"Let: KK number pathogens, α=(1,1,…,1)\\alpha = (1, 1, \\ldots, 1) Dirichlet prior (uniform), n=(n1,…,nK)n = (n_1, \\ldots, n_K) observed counts per species. posterior incidence : p∼Dirichlet(α1+n1,…,αK+nK)p \\sim \\text{Dirichlet}(\\alpha_1 + n_1, \\ldots, \\alpha_K + n_K) simulate , use: xi∼Gamma(αi+ni,1),pi=xi∑j=1Kxjx_i \\sim \\text{Gamma}(\\alpha_i + n_i,\\ 1), \\quad p_i = \\frac{x_i}{\\sum_{j=1}^{K} x_j}","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"susceptibility","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Susceptibility","title":"Estimating Empirical Coverage with WISCA","text":"pathogen–regimen pair prior data: Prior: Beta(α0,β0)\\text{Beta}(\\alpha_0, \\beta_0), default α0=β0=1\\alpha_0 = \\beta_0 = 1 Data: SS susceptible NN tested SS category also include values SDD (susceptible, dose-dependent) (intermediate [CLSI], susceptible, increased exposure [EUCAST]). posterior : θ∼Beta(α0+S,β0+N−S)\\theta \\sim \\text{Beta}(\\alpha_0 + S,\\ \\beta_0 + N - S)","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"final-coverage-estimate","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Final coverage estimate","title":"Estimating Empirical Coverage with WISCA","text":"Putting together: Simulate pathogen incidence: 𝐩∼Dirichlet\\boldsymbol{p} \\sim \\text{Dirichlet} Simulate susceptibility: θi∼Beta(1+Si,1+Ri)\\theta_i \\sim \\text{Beta}(1 + S_i,\\ 1 + R_i) Combine: Coverage=∑=1Kpi⋅θi\\text{Coverage} = \\sum_{=1}^{K} p_i \\cdot \\theta_i Repeat simulation (e.g. 1000×) summarise: Mean = expected coverage Quantiles = credible interval","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"prepare-data-and-simulate-synthetic-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Prepare data and simulate synthetic syndrome","title":"Estimating Empirical Coverage with WISCA","text":"","code":"library(AMR) data <- example_isolates  # Structure of our data data #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # Add a fake syndrome column data$syndrome <- ifelse(data$mo %like% \"coli\", \"UTI\", \"No UTI\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"basic-wisca-antibiogram","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Basic WISCA antibiogram","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"CIP\", \"GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"use-combination-regimens","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Use combination regimens","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"stratify-by-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Stratify by syndrome","title":"Estimating Empirical Coverage with WISCA","text":"AMR package available 28 languages, can used wisca() function :","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = \"syndrome\") wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = gsub(\"UTI\", \"UCI\", data$syndrome),       language = \"Spanish\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"sensible-defaults-which-can-be-customised","dir":"Articles","previous_headings":"","what":"Sensible defaults, which can be customised","title":"Estimating Empirical Coverage with WISCA","text":"simulations = 1000: number Monte Carlo draws conf_interval = 0.95: coverage interval width combine_SI = TRUE: count “” “SDD” susceptible","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"limitations","dir":"Articles","previous_headings":"","what":"Limitations","title":"Estimating Empirical Coverage with WISCA","text":"assumes data representative adjustment patient-level covariates, although passed onto syndromic_group argument WISCA model resistance time, might want use tidymodels , wrote basic introduction","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"summary","dir":"Articles","previous_headings":"","what":"Summary","title":"Estimating Empirical Coverage with WISCA","text":"WISCA enables: Empirical regimen comparison, Syndrome-specific coverage estimation, Fully probabilistic interpretation. available AMR package via either:","code":"wisca(...)  antibiogram(..., wisca = TRUE)"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"reference","dir":"Articles","previous_headings":"","what":"Reference","title":"Estimating Empirical Coverage with WISCA","text":"Bielicki, JA, et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data. J Antimicrob Chemother. 71(3):794-802. https://doi.org/10.1093/jac/dkv397","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Download data sets for download / own use","text":"data set 78 679 rows 26 columns, containing following column names:mo, fullname, status, kingdom, phylum, class, order, family, genus, species, subspecies, rank, ref, oxygen_tolerance, source, lpsn, lpsn_parent, lpsn_renamed_to, mycobank, mycobank_parent, mycobank_renamed_to, gbif, gbif_parent, gbif_renamed_to, prevalence, snomed. data set R available microorganisms, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (1.8 MB) Download tab-separated text file (17.7 MB) Download Microsoft Excel workbook (8.7 MB) Download Apache Feather file (8.3 MB) Download Apache Parquet file (3.8 MB) Download IBM SPSS Statistics data file (28.4 MB) Download Stata DTA file (89.5 MB) NOTE: exported files SPSS Stata contain first 50 SNOMED codes per record, file size otherwise exceed 100 MB; file size limit GitHub. file structures compression techniques inefficient. Advice? Use R instead. ’s free much better many ways. tab-separated text file Microsoft Excel workbook contain SNOMED codes comma separated values. Example content Included (sub)species per taxonomic kingdom: First 6 rows filtering genus Escherichia:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antimicrobials-antibiotic-and-antifungal-drugs","dir":"Articles","previous_headings":"","what":"antimicrobials: Antibiotic and Antifungal Drugs","title":"Download data sets for download / own use","text":"data set 497 rows 14 columns, containing following column names:ab, cid, name, group, atc, atc_group1, atc_group2, abbreviations, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antimicrobials, load AMR package. last updated 1 June 2025 09:54:40 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (45 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (78 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (0.4 MB) Download Stata DTA file (10 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain ATC codes, common abbreviations, trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"clinical_breakpoints-interpretation-from-mic-values-disk-diameters-to-sir","dir":"Articles","previous_headings":"","what":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","title":"Download data sets for download / own use","text":"data set 40 217 rows 14 columns, containing following column names:guideline, type, host, method, site, mo, rank_index, ab, ref_tbl, disk_dose, breakpoint_S, breakpoint_R, uti, is_SDD. data set R available clinical_breakpoints, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (88 kB) Download tab-separated text file (3.7 MB) Download Microsoft Excel workbook (2.4 MB) Download Apache Feather file (1.8 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (6.6 MB) Download Stata DTA file (11.1 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-groups-species-groups-and-microbiological-complexes","dir":"Articles","previous_headings":"","what":"microorganisms.groups: Species Groups and Microbiological Complexes","title":"Download data sets for download / own use","text":"data set 534 rows 4 columns, containing following column names:mo_group, mo, mo_group_name, mo_name. data set R available microorganisms.groups, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (50 kB) Download Microsoft Excel workbook (20 kB) Download Apache Feather file (19 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (65 kB) Download Stata DTA file (83 kB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"intrinsic_resistant-intrinsic-bacterial-resistance","dir":"Articles","previous_headings":"","what":"intrinsic_resistant: Intrinsic Bacterial Resistance","title":"Download data sets for download / own use","text":"data set 271 905 rows 2 columns, containing following column names:mo ab. data set R available intrinsic_resistant, load AMR package. last updated 28 March 2025 10:17:49 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (0.1 MB) Download tab-separated text file (10.1 MB) Download Microsoft Excel workbook (2.9 MB) Download Apache Feather file (2.3 MB) Download Apache Parquet file (0.3 MB) Download IBM SPSS Statistics data file (14.8 MB) Download Stata DTA file (22.6 MB) Example content Example rows filtering Enterobacter cloacae:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"dosage-dosage-guidelines-from-eucast","dir":"Articles","previous_headings":"","what":"dosage: Dosage Guidelines from EUCAST","title":"Download data sets for download / own use","text":"data set 759 rows 9 columns, containing following column names:ab, name, type, dose, dose_times, administration, notes, original_txt, eucast_version. data set R available dosage, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (4 kB) Download tab-separated text file (66 kB) Download Microsoft Excel workbook (37 kB) Download Apache Feather file (28 kB) Download Apache Parquet file (9 kB) Download IBM SPSS Statistics data file (97 kB) Download Stata DTA file (0.2 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates: Example Data for Practice","title":"Download data sets for download / own use","text":"data set 2 000 rows 46 columns, containing following column names:date, patient, age, gender, ward, mo, PEN, OXA, FLC, AMX, AMC, AMP, TZP, CZO, FEP, CXM, FOX, CTX, CAZ, CRO, GEN, TOB, AMK, KAN, TMP, SXT, NIT, FOS, LNZ, CIP, MFX, VAN, TEC, TCY, TGC, DOX, ERY, CLI, AZM, IPM, MEM, MTR, CHL, COL, MUP, RIF. data set R available example_isolates, load AMR package. last updated 15 June 2024 13:33:49 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates_unclean-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates_unclean: Example Data for Practice","title":"Download data sets for download / own use","text":"data set 3 000 rows 8 columns, containing following column names:patient_id, hospital, date, bacteria, AMX, AMC, CIP, GEN. data set R available example_isolates_unclean, load AMR package. last updated 27 August 2022 18:49:37 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-codes-common-laboratory-codes","dir":"Articles","previous_headings":"","what":"microorganisms.codes: Common Laboratory Codes","title":"Download data sets for download / own use","text":"data set 6 036 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 4 May 2025 16:50:25 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (27 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (98 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (68 kB) Download IBM SPSS Statistics data file (0.2 MB) Download Stata DTA file (0.2 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antivirals-antiviral-drugs","dir":"Articles","previous_headings":"","what":"antivirals: Antiviral Drugs","title":"Download data sets for download / own use","text":"data set 120 rows 11 columns, containing following column names:av, name, atc, cid, atc_group, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antivirals, load AMR package. last updated 20 October 2023 12:51:48 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (17 kB) Download Microsoft Excel workbook (16 kB) Download Apache Feather file (16 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (32 kB) Download Stata DTA file (78 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Matthijs S. Berends. Author, maintainer. Dennis Souverein. Author, contributor. Erwin E. . Hassing. Author, contributor. Aislinn Cook. Contributor. Andrew P. Norgan. Contributor. Anita Williams. Contributor. Annick Lenglet. Contributor. Anthony Underwood. Contributor. Anton Mymrikov. Contributor. Bart C. Meijer. Contributor. Christian F. Luz. Contributor. Dmytro Mykhailenko. Contributor. Eric H. L. C. M. Hazenberg. Contributor. Gwen Knight. Contributor. Jane Hawkey. Contributor. Jason Stull. Contributor. Javier Sanchez. Contributor. Jonas Salm. Contributor. Judith M. Fonville. Contributor. Kathryn Holt. Contributor. Larisse Bolton. Contributor. Matthew Saab. Contributor. Natacha Couto. Contributor. Peter Dutey-Magni. Contributor. Rogier P. Schade. Contributor. Sofia Ny. Contributor. Alex W. Friedrich. Thesis advisor. Bhanu N. M. Sinha. Thesis advisor. Casper J. Albers. Thesis advisor. Corinna Glasner. Thesis advisor.","code":""},{"path":"https://amr-for-r.org/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). “AMR: R Package Working Antimicrobial Resistance Data.” Journal Statistical Software, 104(3), 1–31. doi:10.18637/jss.v104.i03.","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/index.html","id":"the-amr-package-for-r-","dir":"","previous_headings":"","what":"Antimicrobial Resistance Data Analysis","title":"Antimicrobial Resistance Data Analysis","text":"Provides --one solution antimicrobial resistance (AMR) data analysis One Health approach Peer-reviewed, used 175 countries, available 28 languages Generates antibiograms - traditional, combined, syndromic, even WISCA Provides full microbiological taxonomy ~79 000 distinct species extensive info ~620 antimicrobial drugs Applies CLSI 2011-2025 EUCAST 2011-2025 clinical veterinary breakpoints, ECOFFs, MIC disk zone interpretation Corrects duplicate isolates, calculates predicts AMR per antimicrobial class Integrates WHONET, ATC, EARS-Net, PubChem, LOINC, SNOMED CT, NCBI 100% free costs dependencies, highly suitable places limited resources Now available Python ! Click read . amr--r.org doi.org/10.18637/jss.v104.i03","code":""},{"path":"https://amr-for-r.org/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Antimicrobial Resistance Data Analysis","text":"AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. team many different researchers around globe make successful durable project! work published Journal Statistical Software (Volume 104(3); DOI 10.18637/jss.v104.i03) formed basis two PhD theses (DOI 10.33612/diss.177417131 DOI 10.33612/diss.192486375). installing package, R knows ~79 000 distinct microbial species (updated June 2024) ~620 antimicrobial antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI 2011-2025 EUCAST 2011-2025 included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen University Medical Center Groningen.","code":""},{"path":"https://amr-for-r.org/index.html","id":"used-in-over-175-countries-available-in-28-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, available in 28 languages","title":"Antimicrobial Resistance Data Analysis","text":"Since first public release early 2018, R package used almost countries world. Click map enlarge see country names. help contributors corners world, AMR package available  English,  Arabic,  Bengali,  Chinese,  Czech,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Hindi,  Indonesian,  Italian,  Japanese,  Korean,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swahili,  Swedish,  Turkish,  Ukrainian,  Urdu,  Vietnamese. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"filtering-and-selecting-data","dir":"","previous_headings":"Practical examples","what":"Filtering and selecting data","title":"Antimicrobial Resistance Data Analysis","text":"One powerful functions package, aside calculating plotting AMR, selecting filtering based antimicrobial columns. can done using -called antimicrobial selectors, work base R, dplyr data.table. defined row filter Gram-negative bacteria intrinsic resistance cefotaxime (mo_is_gram_negative() mo_is_intrinsic_resistant()) column selection two antibiotic groups (aminoglycosides() carbapenems()), reference data microorganisms antimicrobials AMR package make sure get meant.","code":"# AMR works great with dplyr, but it's not required or neccesary library(AMR) library(dplyr, warn.conflicts = FALSE)  example_isolates %>%   mutate(bacteria = mo_fullname()) %>%   # filtering functions for microorganisms:   filter(mo_is_gram_negative(),          mo_is_intrinsic_resistant(ab = \"cefotax\")) %>%   # antimicrobial selectors:   select(bacteria,          aminoglycosides(),          carbapenems()) #> ℹ Using column 'mo' as input for `mo_fullname()` #> ℹ Using column 'mo' as input for `mo_is_gram_negative()` #> ℹ Using column 'mo' as input for `mo_is_intrinsic_resistant()` #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant #>   Phenotypes' v1.2 (2023). This note will be shown once per session. #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 35 × 7 #>    bacteria                     GEN   TOB   AMK   KAN   IPM   MEM   #>    <chr>                        <sir> <sir> <sir> <sir> <sir> <sir> #>  1 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  2 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  3 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  4 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  5 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  6 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  7 Stenotrophomonas maltophilia R     R     R     R     R     R     #>  8 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  9 Pseudomonas aeruginosa       S     S     S     R     NA    S     #> 10 Pseudomonas aeruginosa       S     S     S     R     S     S     #> # ℹ 25 more rows"},{"path":"https://amr-for-r.org/index.html","id":"generating-antibiograms","dir":"","previous_headings":"Practical examples","what":"Generating antibiograms","title":"Antimicrobial Resistance Data Analysis","text":"AMR package supports generating traditional, combined, syndromic, even weighted-incidence syndromic combination antibiograms (WISCA). used inside R Markdown Quarto, table printed right output format automatically (markdown, LaTeX, HTML, etc.). combination antibiograms, clear combined antimicrobials yield higher empiric coverage: Like many functions package, antibiogram() comes support 28 languages often detected automatically based system language:","code":"antibiogram(example_isolates,             antimicrobials = c(aminoglycosides(), carbapenems())) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") antibiogram(example_isolates,             antimicrobials = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian"},{"path":"https://amr-for-r.org/index.html","id":"interpreting-and-plotting-mic-and-sir-values","dir":"","previous_headings":"Practical examples","what":"Interpreting and plotting MIC and SIR values","title":"Antimicrobial Resistance Data Analysis","text":"AMR package allows interpretation MIC disk diffusion values based CLSI EUCAST. Moreover, ggplot2 package extended new scale functions, allow plotting log2-distributed MIC values SIR values.","code":"library(ggplot2) library(AMR)  # generate some random values some_mic_values <- random_mic(size = 100) some_groups <- sample(LETTERS[1:5], 20, replace = TRUE) interpretation <- as.sir(some_mic_values,                          guideline = \"EUCAST 2024\",                          mo = \"E. coli\", # or any code or name resembling a known species                          ab = \"Cipro\")   # or any code or name resembling an antibiotic  # create the plot ggplot(data.frame(mic = some_mic_values,                   group = some_groups,                   sir = interpretation),        aes(x = group, y = mic, colour = sir)) +   theme_minimal() +   geom_boxplot(fill = NA, colour = \"grey30\") +   geom_jitter(width = 0.25) +      # NEW scale function: plot MIC values to x, y, colour or fill   scale_y_mic() +      # NEW scale function: write out S/I/R in any of the 20 supported languages   #                     and set colourblind-friendly colours   scale_colour_sir()"},{"path":"https://amr-for-r.org/index.html","id":"calculating-resistance-per-group","dir":"","previous_headings":"Practical examples","what":"Calculating resistance per group","title":"Antimicrobial Resistance Data Analysis","text":"manual approach, can use resistance susceptibility() function: use antimicrobial selectors select series antibiotic columns:","code":"example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance() for gentamicin and tobramycin   # and get their 95% confidence intervals using sir_confidence_interval():   summarise(across(c(GEN, TOB),                    list(total_R = resistance,                         conf_int = function(x) sir_confidence_interval(x, collapse = \"-\")))) #> # A tibble: 3 × 5 #>   ward       GEN_total_R GEN_conf_int TOB_total_R TOB_conf_int #>   <chr>            <dbl> <chr>              <dbl> <chr>        #> 1 Clinical         0.229 0.205-0.254        0.315 0.284-0.347  #> 2 ICU              0.290 0.253-0.33         0.400 0.353-0.449  #> 3 Outpatient       0.2   0.131-0.285        0.368 0.254-0.493 library(AMR) library(dplyr)  out <- example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance(), over all aminoglycosides and polymyxins:   summarise(across(c(aminoglycosides(), polymyxins()),             resistance)) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `polymyxins()` using column 'COL' (colistin) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `across(c(aminoglycosides(), polymyxins()), resistance)`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = #> \"Outpatient\" (`minimum` = 30). out #> # A tibble: 3 × 6 #>   ward         GEN   TOB   AMK   KAN   COL #>   <chr>      <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 Clinical   0.229 0.315 0.626     1 0.780 #> 2 ICU        0.290 0.400 0.662     1 0.857 #> 3 Outpatient 0.2   0.368 0.605    NA 0.889 # transform the antibiotic columns to names: out %>% set_ab_names() #> # A tibble: 3 × 6 #>   ward       gentamicin tobramycin amikacin kanamycin colistin #>   <chr>           <dbl>      <dbl>    <dbl>     <dbl>    <dbl> #> 1 Clinical        0.229      0.315    0.626         1    0.780 #> 2 ICU             0.290      0.400    0.662         1    0.857 #> 3 Outpatient      0.2        0.368    0.605        NA    0.889 # transform the antibiotic column to ATC codes: out %>% set_ab_names(property = \"atc\") #> # A tibble: 3 × 6 #>   ward       J01GB03 J01GB01 J01GB06 J01GB04 J01XB01 #>   <chr>        <dbl>   <dbl>   <dbl>   <dbl>   <dbl> #> 1 Clinical     0.229   0.315   0.626       1   0.780 #> 2 ICU          0.290   0.400   0.662       1   0.857 #> 3 Outpatient   0.2     0.368   0.605      NA   0.889"},{"path":"https://amr-for-r.org/index.html","id":"what-else-can-you-do-with-this-package","dir":"","previous_headings":"","what":"What else can you do with this package?","title":"Antimicrobial Resistance Data Analysis","text":"package intended comprehensive toolbox integrated AMR data analysis. package can used : Reference taxonomy microorganisms, since package contains microbial (sub)species List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF) (manual) Interpreting raw MIC disk diffusion values, based CLSI EUCAST guideline (manual) Retrieving antimicrobial drug names, doses forms administration clinical health care records (manual) Determining first isolates used AMR data analysis (manual) Calculating antimicrobial resistance (tutorial) Determining multi-drug resistance (MDR) / multi-drug resistant organisms (MDRO) (tutorial) Calculating (empirical) susceptibility mono therapy combination therapies (tutorial) Apply AMR functions predictive modelling (tutorial) Getting properties microorganism (like Gram stain, species, genus family) (manual) Getting properties antimicrobial (like name, code EARS-Net/ATC/LOINC/PubChem, defined daily dose trade name) (manual) Plotting antimicrobial resistance (tutorial) Applying EUCAST expert rules (manual) Getting SNOMED codes microorganism, getting properties microorganism based SNOMED code (manual) Getting LOINC codes antibiotic, getting properties antibiotic based LOINC code (manual) Machine reading EUCAST CLSI guidelines 2011-2021 translate MIC values disk diffusion diameters SIR (link) Principal component analysis AMR (tutorial)","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"latest-official-version","dir":"","previous_headings":"Get this package","what":"Latest official version","title":"Antimicrobial Resistance Data Analysis","text":"package available official R network (CRAN). Install package R CRAN using command: downloaded installed automatically. RStudio, click menu Tools > Install Packages… type “AMR” press Install. Note: functions website may available latest release. use functions data sets mentioned website, install latest beta version.","code":"install.packages(\"AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"latest-beta-version","dir":"","previous_headings":"Get this package","what":"Latest beta version","title":"Antimicrobial Resistance Data Analysis","text":"Please read Developer Guideline . install latest unpublished beta version:","code":"install.packages(\"AMR\", repos = \"beta.amr-for-r.org\")  # if this does not work, try to install directly from GitHub using the 'remotes' package: remotes::install_github(\"msberends/AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"get-started","dir":"","previous_headings":"","what":"Get started","title":"Antimicrobial Resistance Data Analysis","text":"find conduct AMR data analysis, please continue reading get started click link ‘’ menu.","code":""},{"path":"https://amr-for-r.org/index.html","id":"partners","dir":"","previous_headings":"","what":"Partners","title":"Antimicrobial Resistance Data Analysis","text":"initial development package part , related , made possible following non-profit organisations initiatives:","code":""},{"path":"https://amr-for-r.org/index.html","id":"copyright","dir":"","previous_headings":"","what":"Copyright","title":"Antimicrobial Resistance Data Analysis","text":"R package free, open-source software licensed GNU General Public License v2.0 (GPL-2). nutshell, means package: May used commercial purposes May used private purposes May used patent purposes May modified, although: Modifications must released license distributing package Changes made code must documented May distributed, although: Source code must made available package distributed copy license copyright notice must included package. Comes LIMITATION liability Comes warranty","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"objects -called 'Deprecated'. removed future version package. Using give warning name alternative object replaced (one).","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"","code":"ab_class(...)  ab_selector(...)"},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":null,"dir":"Reference","previous_headings":"","what":"Options for the AMR package — AMR-options","title":"Options for the AMR package — AMR-options","text":"overview package-specific options() can set AMR package.","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Options for the AMR package — AMR-options","text":"AMR_antibiogram_formatting_type  numeric (1-22) use antibiogram(), indicate formatting type use. AMR_breakpoint_type  character use .sir(), indicate breakpoint type use. must either \"ECOFF\", \"animal\", \"human\". AMR_capped_mic_handling  character use .sir(), indicate capped MIC values (<, <=, >, >=) interpreted. Must one \"standard\", \"strict\", \"relaxed\", \"inverse\" - default \"standard\". AMR_cleaning_regex  regular expression (case-insensitive) use .mo() mo_* functions, clean user input. default outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". AMR_custom_ab  file location RDS file, use custom antimicrobial drugs package. explained add_custom_antimicrobials(). AMR_custom_mo  file location RDS file, use custom microorganisms package. explained add_custom_microorganisms(). AMR_eucastrules  character set default types rules eucast_rules() function, must one : \"breakpoints\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expert\"). AMR_guideline  character set default guideline interpreting MIC values disk diffusion diameters .sir(). Can guideline name (e.g., \"CLSI\") name year (e.g. \"CLSI 2019\"). default latest implemented EUCAST guideline, currently \"EUCAST 2025\". Supported guideline currently EUCAST (2011-2025) CLSI (2011-2025). AMR_ignore_pattern  regular expression ignore (.e., make NA) match given .mo() mo_* functions. AMR_include_PKPD  logical use .sir(), indicate PK/PD clinical breakpoints must applied last resort - default TRUE. AMR_substitute_missing_r_breakpoint  logical use .sir(), indicate missing R breakpoints must substituted \"R\" - default FALSE. AMR_include_screening  logical use .sir(), indicate clinical breakpoints screening allowed - default FALSE. AMR_keep_synonyms  logical use .mo() mo_* functions, indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE. AMR_locale  character set language AMR package, can one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). default current system language (supported, English otherwise). AMR_mo_source  file location manual code list used .mo() mo_* functions. explained set_mo_source().","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"saving-settings-between-sessions","dir":"Reference","previous_headings":"","what":"Saving Settings Between Sessions","title":"Options for the AMR package — AMR-options","text":"Settings R saved globally thus lost R exited. can save options .Rprofile file, user-specific file. can edit using:   file, can set options ...   ...add Portuguese language support antimicrobials, allow PK/PD rules interpreting MIC values .sir().","code":"utils::file.edit(\"~/.Rprofile\") options(AMR_locale = \"pt\")  options(AMR_include_PKPD = TRUE)"},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"share-options-within-team","dir":"Reference","previous_headings":"","what":"Share Options Within Team","title":"Options for the AMR package — AMR-options","text":"global approach, e.g. within (data) team, save options file remote file location, shared network drive, user read file automatically start-. work way: Save plain text file e.g. \"X:/team_folder/R_options.R\" fill preferred settings. user, open .Rprofile file using utils::file.edit(\"~/.Rprofile\") put :   Reload R/RStudio check settings getOption(), e.g. getOption(\"AMR_locale\") set value. Now team settings configured one place, can maintained .","code":"source(\"X:/team_folder/R_options.R\")"},{"path":"https://amr-for-r.org/reference/AMR.html","id":null,"dir":"Reference","previous_headings":"","what":"The AMR Package — AMR","title":"The AMR Package — AMR","text":"Welcome AMR package. AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. team many different researchers around globe make successful durable project! work published Journal Statistical Software (Volume 104(3); doi:10.18637/jss.v104.i03 ) formed basis two PhD theses (doi:10.33612/diss.177417131  doi:10.33612/diss.192486375 ). installing package, R knows ~79 000 distinct microbial species (updated June 2024) ~620 antimicrobial antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI 2011-2025 EUCAST 2011-2025 included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen University Medical Center Groningen. AMR package available English, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":"https://amr-for-r.org/reference/AMR.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"The AMR Package — AMR","text":"cite AMR publications use: Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). \"AMR: R Package Working Antimicrobial Resistance Data.\" Journal Statistical Software, 104(3), 1-31. doi:10.18637/jss.v104.i03 BibTeX entry LaTeX users :","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/reference/AMR.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"The AMR Package — AMR","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/AMR.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"The AMR Package — AMR","text":"Maintainer: Matthijs S. Berends m.s.berends@umcg.nl (ORCID) Authors: Dennis Souverein (ORCID) [contributor] Erwin E. . Hassing [contributor] contributors: Aislinn Cook (ORCID) [contributor] Andrew P. Norgan (ORCID) [contributor] Anita Williams (ORCID) [contributor] Annick Lenglet (ORCID) [contributor] Anthony Underwood (ORCID) [contributor] Anton Mymrikov [contributor] Bart C. Meijer [contributor] Christian F. Luz (ORCID) [contributor] Dmytro Mykhailenko [contributor] Eric H. L. C. M. Hazenberg [contributor] Gwen Knight (ORCID) [contributor] Jane Hawkey (ORCID) [contributor] Jason Stull (ORCID) [contributor] Javier Sanchez (ORCID) [contributor] Jonas Salm [contributor] Judith M. Fonville [contributor] Kathryn Holt (ORCID) [contributor] Larisse Bolton (ORCID) [contributor] Matthew Saab [contributor] Natacha Couto (ORCID) [contributor] Peter Dutey-Magni (ORCID) [contributor] Rogier P. Schade [contributor] Sofia Ny (ORCID) [contributor] Alex W. Friedrich (ORCID) [thesis advisor] Bhanu N. M. Sinha (ORCID) [thesis advisor] Casper J. Albers (ORCID) [thesis advisor] Corinna Glasner (ORCID) [thesis advisor]","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":null,"dir":"Reference","previous_headings":"","what":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"antimicrobial drugs official names, ATC codes, ATC groups defined daily dose (DDD) included package, using Collaborating Centre Drug Statistics Methodology.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"","code":"as.ab(\"meropenem\") #> Class 'ab' #> [1] MEM ab_name(\"J01DH02\") #> [1] \"Meropenem\"  ab_tradenames(\"flucloxacillin\") #>  [1] \"bactopen\"             \"cloxacap\"             \"cloxacillinhydrate\"   #>  [4] \"cloxypen\"             \"floxacillin\"          \"floxacillinanhydrous\" #>  [7] \"floxapen\"             \"floxapensalt\"         \"fluclomix\"            #> [10] \"flucloxacilina\"       \"flucloxacilline\"      \"flucloxacillinum\"     #> [13] \"flucloxin\"            \"fluorochloroxacillin\" \"galfloxin\"            #> [16] \"latocillin\"           \"orbeninhydrate\"       \"rimaflox\"             #> [19] \"staphobristol\"        \"zoxin\""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 500 Isolates - WHONET Example — WHONET","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"example data set exact structure export file WHONET. files can used package, example data set shows. antimicrobial results example_isolates data set. patient names created using online surname generators place practice purposes.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET"},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"tibble 500 observations 53 variables: Identification number ID sample Specimen number ID specimen Organism Name microorganism. analysis, transform valid microbial class, using .mo(). Country Country origin Laboratory Name laboratory Last name Fictitious last name patient First name Fictitious initial patient Sex Fictitious gender patient Age Fictitious age patient Age category Age group, can also looked using age_groups() Date admissionDate hospital admission Specimen dateDate specimen received laboratory Specimen type Specimen type group Specimen type (Numeric) Translation \"Specimen type\" Reason Reason request Differential Diagnosis Isolate number ID isolate Organism type Type microorganism, can also looked using mo_type() Serotype Serotype microorganism Beta-lactamase Microorganism produces beta-lactamase? ESBL Microorganism produces extended spectrum beta-lactamase? Carbapenemase Microorganism produces carbapenemase? MRSA screening test Microorganism possible MRSA? Inducible clindamycin resistance Clindamycin can induced? Comment comments Date data entryDate data entered WHONET AMP_ND10:CIP_EE 28 different antimicrobials. can lookup abbreviations antimicrobials data set, use e.g. ab_name(\"AMP\") get official name immediately. analysis, transform valid antimicrobial class, using .sir().","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET #> # A tibble: 500 × 53 #>    `Identification number` `Specimen number` Organism Country         Laboratory #>    <chr>                               <int> <chr>    <chr>           <chr>      #>  1 fe41d7bafa                           1748 SPN      Belgium         National … #>  2 91f175ec37                           1767 eco      The Netherlands National … #>  3 cc4015056e                           1343 eco      The Netherlands National … #>  4 e864b692f5                           1894 MAP      Denmark         National … #>  5 3d051fe345                           1739 PVU      Belgium         National … #>  6 c80762a08d                           1846 103      The Netherlands National … #>  7 8022d3727c                           1628 103      Denmark         National … #>  8 f3dc5f553d                           1493 eco      The Netherlands National … #>  9 15add38f6c                           1847 eco      France          National … #> 10 fd41248def                           1458 eco      Germany         National … #> # ℹ 490 more rows #> # ℹ 48 more variables: `Last name` <chr>, `First name` <chr>, Sex <chr>, #> #   Age <dbl>, `Age category` <chr>, `Date of admission` <date>, #> #   `Specimen date` <date>, `Specimen type` <chr>, #> #   `Specimen type (Numeric)` <dbl>, Reason <chr>, `Isolate number` <int>, #> #   `Organism type` <chr>, Serotype <chr>, `Beta-lactamase` <lgl>, ESBL <lgl>, #> #   Carbapenemase <lgl>, `MRSA screening test` <lgl>, …"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Use function e.g. clinical texts health care records. returns list antimicrobial drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"ab_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_ab = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_ab type = \"drug\": column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"function also internally used .ab(), although searches first drug name throw note drug names returned. Note: .ab() function may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"default, function search antimicrobial drug names. text elements searched official names, ATC codes brand names. uses .ab() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(abx = ab_from_text(clinical_text)) returned AB codes can transformed official names, groups, etc. ab_* functions ab_name() ab_group(), using translate_ab argument. using collapse, function return character:df %>% mutate(abx = ab_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"# mind the bad spelling of amoxicillin in this line, # straight from a true health care record: ab_from_text(\"28/03/2020 regular amoxicilliin 500mg po tid\") #> [[1]] #> Class 'ab' #> [1] AMX #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") #> [[1]] #> Class 'ab' #> [1] AMX CIP #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"dose\") #> [[1]] #> [1] 500 400 #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"admin\") #> [[1]] #> [1] \"oral\" \"iv\"   #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", collapse = \", \") #> [1] \"AMX, CIP\" # \\donttest{ # if you want to know which antibiotic groups were administered, do e.g.: abx <- ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") ab_group(abx[[1]]) #> [1] \"Beta-lactams/penicillins\" \"Fluoroquinolones\"          if (require(\"dplyr\")) {   tibble(clinical_text = c(     \"given 400mg cipro and 500 mg amox\",     \"started on doxy iv today\"   )) %>%     mutate(       abx_codes = ab_from_text(clinical_text),       abx_doses = ab_from_text(clinical_text, type = \"doses\"),       abx_admin = ab_from_text(clinical_text, type = \"admin\"),       abx_coll = ab_from_text(clinical_text, collapse = \"|\"),       abx_coll_names = ab_from_text(clinical_text,         collapse = \"|\",         translate_ab = \"name\"       ),       abx_coll_doses = ab_from_text(clinical_text,         type = \"doses\",         collapse = \"|\"       ),       abx_coll_admin = ab_from_text(clinical_text,         type = \"admin\",         collapse = \"|\"       )     ) } #> Loading required package: dplyr #>  #> Attaching package: ‘dplyr’ #> The following objects are masked from ‘package:stats’: #>  #>     filter, lag #> The following objects are masked from ‘package:base’: #>  #>     intersect, setdiff, setequal, union #> # A tibble: 2 × 8 #>   clinical_text            abx_codes abx_doses abx_admin abx_coll abx_coll_names #>   <chr>                    <list>    <list>    <list>    <chr>    <chr>          #> 1 given 400mg cipro and 5… <ab [2]>  <dbl [2]> <chr [1]> CIP|AMX  Ciprofloxacin… #> 2 started on doxy iv today <ab [1]>  <dbl [1]> <chr [1]> DOX      Doxycycline    #> # ℹ 2 more variables: abx_coll_doses <chr>, abx_coll_admin <chr> # }"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antibiotic — ab_property","title":"Get Properties of an Antibiotic — ab_property","text":"Use functions return specific property antibiotic antimicrobials data set. input values evaluated internally .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"ab_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  ab_cid(x, ...)  ab_synonyms(x, ...)  ab_tradenames(x, ...)  ab_group(x, language = get_AMR_locale(), ...)  ab_atc(x, only_first = FALSE, ...)  ab_atc_group1(x, language = get_AMR_locale(), ...)  ab_atc_group2(x, language = get_AMR_locale(), ...)  ab_loinc(x, ...)  ab_ddd(x, administration = \"oral\", ...)  ab_ddd_units(x, administration = \"oral\", ...)  ab_info(x, language = get_AMR_locale(), ...)  ab_url(x, open = FALSE, ...)  ab_property(x, property = \"name\", language = get_AMR_locale(), ...)  set_ab_names(data, ..., property = \"name\", language = get_AMR_locale(),   snake_case = NULL)"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antibiotic — ab_property","text":"x (vector ) text can coerced valid antibiotic drug code .ab(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. lead e.g. \"polymyxin B\" \"polymyxin b\". ... case set_ab_names() data data.frame: columns select (supports tidy selection column1:column4), otherwise arguments passed .ab(). only_first logical indicate whether first ATC code must returned, giving preference J0-codes (.e., antimicrobial drug group). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antimicrobials data set: vector_or(colnames(antimicrobials), sort = FALSE). data data.frame columns need renamed, character vector column names. snake_case logical indicate whether names -called snake case: lower case spaces/slashes replaced underscore (_).","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antibiotic — ab_property","text":"integer case ab_cid() named list case ab_info() multiple ab_atc()/ab_synonyms()/ab_tradenames() double case ab_ddd() data.frame case set_ab_names() character cases","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antibiotic — ab_property","text":"output translated possible. function ab_url() return direct URL official website. warning returned required ATC code available. function set_ab_names() special column renaming function data.frames. renames columns names resemble antimicrobial drugs. always makes sure new column names unique. property = \"atc\" set, preference given ATC codes J-group.","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antibiotic — ab_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antibiotic — ab_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"# all properties: ab_name(\"AMX\") #> [1] \"Amoxicillin\" ab_atc(\"AMX\") #> [1] \"J01CA04\"  \"QG51AA03\" \"QJ01CA04\" ab_cid(\"AMX\") #> [1] 33613 ab_synonyms(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_tradenames(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_group(\"AMX\") #> [1] \"Beta-lactams/penicillins\" ab_atc_group1(\"AMX\") #> [1] \"Beta-lactam antibacterials, penicillins\" ab_atc_group2(\"AMX\") #> [1] \"Penicillins with extended spectrum\" ab_url(\"AMX\") #>                                                             Amoxicillin  #> \"https://atcddd.fhi.no/atc_ddd_index//?code=J01CA04&showdescription=no\"   # smart lowercase transformation ab_name(x = c(\"AMC\", \"PLB\")) #> [1] \"Amoxicillin/clavulanic acid\" \"Polymyxin B\"                 ab_name(x = c(\"AMC\", \"PLB\"), tolower = TRUE) #> [1] \"amoxicillin/clavulanic acid\" \"polymyxin B\"                  # defined daily doses (DDD) ab_ddd(\"AMX\", \"oral\") #> [1] 1.5 ab_ddd_units(\"AMX\", \"oral\") #> [1] \"g\" ab_ddd(\"AMX\", \"iv\") #> [1] 3 ab_ddd_units(\"AMX\", \"iv\") #> [1] \"g\"  ab_info(\"AMX\") # all properties as a list #> $ab #> [1] \"AMX\" #>  #> $cid #> [1] 33613 #>  #> $name #> [1] \"Amoxicillin\" #>  #> $group #> [1] \"Beta-lactams/penicillins\" #>  #> $atc #> [1] \"J01CA04\"  \"QG51AA03\" \"QJ01CA04\" #>  #> $atc_group1 #> [1] \"Beta-lactam antibacterials, penicillins\" #>  #> $atc_group2 #> [1] \"Penicillins with extended spectrum\" #>  #> $tradenames #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           #>  #> $loinc #>  [1] \"101498-4\" \"15-8\"     \"16-6\"     \"16365-9\"  \"17-4\"     \"18-2\"     #>  [7] \"18861-5\"  \"18862-3\"  \"19-0\"     \"20-8\"     \"21-6\"     \"22-4\"     #> [13] \"25274-2\"  \"25310-4\"  \"3344-9\"   \"55614-2\"  \"55615-9\"  \"55616-7\"  #> [19] \"6976-5\"   \"6977-3\"   \"80133-2\"  #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 1.5 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 3 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all ab_* functions use as.ab() internally, so you can go from 'any' to 'any': ab_atc(\"AMP\") #> [1] \"J01CA01\"  \"QJ01CA01\" \"QJ51CA01\" \"QS01AA19\" \"S01AA19\"  ab_group(\"J01CA01\") #> [1] \"Beta-lactams/penicillins\" ab_loinc(\"ampicillin\") #>  [1] \"101477-8\" \"101478-6\" \"18864-9\"  \"18865-6\"  \"20374-5\"  \"21066-6\"  #>  [7] \"23618-2\"  \"27-3\"     \"28-1\"     \"29-9\"     \"30-7\"     \"31-5\"     #> [13] \"32-3\"     \"33-1\"     \"3355-5\"   \"33562-0\"  \"33919-2\"  \"34-9\"     #> [19] \"43883-8\"  \"43884-6\"  \"6979-9\"   \"6980-7\"   \"87604-5\"  ab_name(\"21066-6\") #> [1] \"Ampicillin\" ab_name(6249) #> [1] \"Ampicillin\" ab_name(\"J01CA01\") #> [1] \"Ampicillin\"  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  \"QJ01DD04\"  # use set_ab_names() for renaming columns colnames(example_isolates) #>  [1] \"date\"    \"patient\" \"age\"     \"gender\"  \"ward\"    \"mo\"      \"PEN\"     #>  [8] \"OXA\"     \"FLC\"     \"AMX\"     \"AMC\"     \"AMP\"     \"TZP\"     \"CZO\"     #> [15] \"FEP\"     \"CXM\"     \"FOX\"     \"CTX\"     \"CAZ\"     \"CRO\"     \"GEN\"     #> [22] \"TOB\"     \"AMK\"     \"KAN\"     \"TMP\"     \"SXT\"     \"NIT\"     \"FOS\"     #> [29] \"LNZ\"     \"CIP\"     \"MFX\"     \"VAN\"     \"TEC\"     \"TCY\"     \"TGC\"     #> [36] \"DOX\"     \"ERY\"     \"CLI\"     \"AZM\"     \"IPM\"     \"MEM\"     \"MTR\"     #> [43] \"CHL\"     \"COL\"     \"MUP\"     \"RIF\"     colnames(set_ab_names(example_isolates)) #>  [1] \"date\"                          \"patient\"                       #>  [3] \"age\"                           \"gender\"                        #>  [5] \"ward\"                          \"mo\"                            #>  [7] \"benzylpenicillin\"              \"oxacillin\"                     #>  [9] \"flucloxacillin\"                \"amoxicillin\"                   #> [11] \"amoxicillin_clavulanic_acid\"   \"ampicillin\"                    #> [13] \"piperacillin_tazobactam\"       \"cefazolin\"                     #> [15] \"cefepime\"                      \"cefuroxime\"                    #> [17] \"cefoxitin\"                     \"cefotaxime\"                    #> [19] \"ceftazidime\"                   \"ceftriaxone\"                   #> [21] \"gentamicin\"                    \"tobramycin\"                    #> [23] \"amikacin\"                      \"kanamycin\"                     #> [25] \"trimethoprim\"                  \"trimethoprim_sulfamethoxazole\" #> [27] \"nitrofurantoin\"                \"fosfomycin\"                    #> [29] \"linezolid\"                     \"ciprofloxacin\"                 #> [31] \"moxifloxacin\"                  \"vancomycin\"                    #> [33] \"teicoplanin\"                   \"tetracycline\"                  #> [35] \"tigecycline\"                   \"doxycycline\"                   #> [37] \"erythromycin\"                  \"clindamycin\"                   #> [39] \"azithromycin\"                  \"imipenem\"                      #> [41] \"meropenem\"                     \"metronidazole\"                 #> [43] \"chloramphenicol\"               \"colistin\"                      #> [45] \"mupirocin\"                     \"rifampicin\"                    colnames(set_ab_names(example_isolates, NIT:VAN)) #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     set_ab_names()    # this does the same:   example_isolates %>%     rename_with(set_ab_names)    # set_ab_names() works with any AB property:   example_isolates %>%     set_ab_names(property = \"atc\")    example_isolates %>%     set_ab_names(where(is.sir)) %>%     colnames()    example_isolates %>%     set_ab_names(NIT:VAN) %>%     colnames() } #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # }"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Antimicrobials — add_custom_antimicrobials","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"add_custom_antimicrobials() can add custom antimicrobial drug names codes.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"add_custom_antimicrobials(x)  clear_custom_antimicrobials()"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"x data.frame resembling antimicrobials data set, least containing columns \"ab\" \"name\".","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"Important: Due R works, add_custom_antimicrobials() function run every R session - added antimicrobials stored sessions thus lost R exited. two ways circumvent automate process adding antimicrobials: Method 1: Using package option AMR_custom_ab, preferred method. use method: Create data set structure antimicrobials data set (containing least columns \"ab\" \"name\") save saveRDS() location choice, e.g. \"~/my_custom_ab.rds\", remote location. Set file location package option AMR_custom_ab: options(AMR_custom_ab = \"~/my_custom_ab.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_antimicrobials() function. Method 2: Loading antimicrobial additions directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_antimicrobials() clear previously added antimicrobials.","code":"# Add custom antimicrobial codes: options(AMR_custom_ab = \"~/my_custom_ab.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_antimicrobials(    data.frame(ab = \"TESTAB\",               name = \"Test Antibiotic\",               group = \"Test Group\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"# \\donttest{ # returns a wildly guessed result: as.ab(\"testab\") #> Class 'ab' #> [1] THA  # now add a custom entry - it will be considered by as.ab() and # all ab_*() functions add_custom_antimicrobials(   data.frame(     ab = \"TESTAB\",     name = \"Test Antibiotic\",     # you can add any property present in the     # 'antimicrobials' data set, such as 'group':     group = \"Test Group\"   ) ) #> ℹ Added one record to the internal `antimicrobials` data set.  # \"testab\" is now a new antibiotic: as.ab(\"testab\") #> Class 'ab' #> [1] TESTAB ab_name(\"testab\") #> [1] \"Test Antibiotic\" ab_group(\"testab\") #> [1] \"Test Group\"  ab_info(\"testab\") #> $ab #> [1] \"TESTAB\" #>  #> $cid #> [1] NA #>  #> $name #> [1] \"Test Antibiotic\" #>  #> $group #> [1] \"Test Group\" #>  #> $atc #> [1] NA #>  #> $atc_group1 #> [1] NA #>  #> $atc_group2 #> [1] NA #>  #> $tradenames #> [1] NA #>  #> $loinc #> [1] NA #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] NA #>  #> $ddd$oral$units #> [1] NA #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] NA #>  #> $ddd$iv$units #> [1] NA #>  #>  #>    # Add Co-fluampicil, which is one of the many J01CR50 codes, see # https://atcddd.fhi.no/ddd/list_of_ddds_combined_products/ add_custom_antimicrobials(   data.frame(     ab = \"COFLU\",     name = \"Co-fluampicil\",     atc = \"J01CR50\",     group = \"Beta-lactams/penicillins\"   ) ) #> ℹ Added one record to the internal `antimicrobials` data set. ab_atc(\"Co-fluampicil\") #> [1] \"J01CR50\" ab_name(\"J01CR50\") #> [1] \"Co-fluampicil\"  # even antimicrobial selectors work # see ?amr_selector x <- data.frame(   random_column = \"some value\",   coflu = as.sir(\"S\"),   ampicillin = as.sir(\"R\") ) x #>   random_column coflu ampicillin #> 1    some value     S          R x[, betalactams()] #> ℹ For `betalactams()` using columns 'coflu' (co-fluampicil) and #>   'ampicillin' #>   coflu ampicillin #> 1     S          R # }"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Microorganisms — add_custom_microorganisms","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"add_custom_microorganisms() can add custom microorganisms, non-taxonomic outcome laboratory analysis.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"add_custom_microorganisms(x)  clear_custom_microorganisms()"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"x data.frame resembling microorganisms data set, least containing column \"genus\" (case-insensitive).","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"function fill missing taxonomy , specific taxonomic columns missing, see Examples. Important: Due R works, add_custom_microorganisms() function run every R session - added microorganisms stored sessions thus lost R exited. two ways circumvent automate process adding microorganisms: Method 1: Using package option AMR_custom_mo, preferred method. use method: Create data set structure microorganisms data set (containing least column \"genus\") save saveRDS() location choice, e.g. \"~/my_custom_mo.rds\", remote location. Set file location package option AMR_custom_mo: options(AMR_custom_mo = \"~/my_custom_mo.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_microorganisms() function. Method 2: Loading microorganism directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_microorganisms() clear previously added microorganisms.","code":"# Add custom microorganism codes: options(AMR_custom_mo = \"~/my_custom_mo.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_microorganisms(    data.frame(genus = \"Enterobacter\",               species = \"asburiae/cloacae\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"# \\donttest{ # a combination of species is not formal taxonomy, so # this will result in \"Enterobacter cloacae cloacae\", # since it resembles the input best: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae\"  # now add a custom entry - it will be considered by as.mo() and # all mo_*() functions add_custom_microorganisms(   data.frame(     genus = \"Enterobacter\",     species = \"asburiae/cloacae\"   ) ) #> ℹ Added Enterobacter asburiae/cloacae to the internal `microorganisms` data #>   set.  # E. asburiae/cloacae is now a new microorganism: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # its code: as.mo(\"Enterobacter asburiae/cloacae\") #> Class 'mo' #> [1] CUSTOM1_ENTRB_ASB/  # all internal algorithms will work as well: mo_name(\"Ent asburia cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # and even the taxonomy was added based on the genus! mo_family(\"E. asburiae/cloacae\") #> [1] \"Enterobacteriaceae\" mo_gramstain(\"Enterobacter asburiae/cloacae\") #> [1] \"Gram-negative\"  mo_info(\"Enterobacter asburiae/cloacae\") #> $mo #> [1] \"CUSTOM1_ENTRB_ASB/\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Enterobacter\" #>  #> $species #> [1] \"asburiae/cloacae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] NA #>  #> $url #> [1] \"\" #>  #> $ref #> [1] \"Self-added, 2025\" #>  #> $snomed #> [1] NA #>  #> $lpsn #> [1] NA #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] NA #>  #> $group_members #> character(0) #>    # the function tries to be forgiving: add_custom_microorganisms(   data.frame(     GENUS = \"BACTEROIDES / PARABACTEROIDES SLASHLINE\",     SPECIES = \"SPECIES\"   ) ) #> ℹ Added Bacteroides/Parabacteroides to the internal `microorganisms` data #>   set. mo_name(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"Bacteroides/Parabacteroides\" mo_rank(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"genus\"  # taxonomy still works, even though a slashline genus was given as input: mo_family(\"Bacteroides/Parabacteroides\") #> [1] \"Bacteroidaceae\"   # for groups and complexes, set them as species or subspecies: add_custom_microorganisms(   data.frame(     genus = \"Citrobacter\",     species = c(\"freundii\", \"braakii complex\"),     subspecies = c(\"complex\", \"\")   ) ) #> ℹ Added Citrobacter braakii complex and Citrobacter freundii complex to the #>   internal `microorganisms` data set. mo_name(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Citrobacter freundii complex\" \"Citrobacter braakii complex\"  mo_species(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"freundii complex\" \"braakii complex\"  mo_gramstain(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Gram-negative\" \"Gram-negative\" # }"},{"path":"https://amr-for-r.org/reference/age.html","id":null,"dir":"Reference","previous_headings":"","what":"Age in Years of Individuals — age","title":"Age in Years of Individuals — age","text":"Calculates age years based reference date, system date default.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Age in Years of Individuals — age","text":"","code":"age(x, reference = Sys.Date(), exact = FALSE, na.rm = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/age.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Age in Years of Individuals — age","text":"x Date(s), character (vectors) coerced .POSIXlt(). reference Reference date(s) (default today), character (vectors) coerced .POSIXlt(). exact logical indicate whether age calculation exact, .e. decimals. divides number days year--date (YTD) x number days year reference (either 365 366). na.rm logical indicate whether missing values removed. ... Arguments passed .POSIXlt(), origin.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Age in Years of Individuals — age","text":"integer (decimals) exact = FALSE, double (decimals) otherwise","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Age in Years of Individuals — age","text":"Ages 0 returned NA warning. Ages 120 give warning. function vectorises x reference, meaning either can length 1 argument larger length.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Age in Years of Individuals — age","text":"","code":"# 10 random pre-Y2K birth dates df <- data.frame(birth_date = as.Date(\"2000-01-01\") - runif(10) * 25000)  # add ages df$age <- age(df$birth_date)  # add exact ages df$age_exact <- age(df$birth_date, exact = TRUE)  # add age at millenium switch df$age_at_y2k <- age(df$birth_date, \"2000-01-01\")  df #>    birth_date age age_exact age_at_y2k #> 1  1980-02-27  45  45.38904         19 #> 2  1953-07-26  71  71.98082         46 #> 3  1949-09-02  75  75.87671         50 #> 4  1986-08-03  38  38.95890         13 #> 5  1932-11-19  92  92.66301         67 #> 6  1949-03-30  76  76.30411         50 #> 7  1996-06-23  29  29.07123          3 #> 8  1963-09-16  61  61.83836         36 #> 9  1952-05-16  73  73.17534         47 #> 10 1952-11-14  72  72.67671         47"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Split Ages into Age Groups — age_groups","title":"Split Ages into Age Groups — age_groups","text":"Split ages age groups defined split argument. allows easier demographic (antimicrobial resistance) analysis. function returns ordered factor.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split Ages into Age Groups — age_groups","text":"","code":"age_groups(x, split_at = c(0, 12, 25, 55, 75), names = NULL,   na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split Ages into Age Groups — age_groups","text":"x Age, e.g. calculated age(). split_at Values split x - default age groups 0-11, 12-24, 25-54, 55-74 75+. See Details. names Optional names given various age groups. na.rm logical indicate whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Split Ages into Age Groups — age_groups","text":"Ordered factor","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Split Ages into Age Groups — age_groups","text":"split ages, input split_at argument can : numeric vector. value e.g. c(10, 20) split x 0-9, 10-19 20+. value 50 split x 0-49 50+. default split young children (0-11), youth (12-24), young adults (25-54), middle-aged adults (55-74) elderly (75+). character: \"children\" \"kids\", equivalent : c(0, 1, 2, 4, 6, 13, 18). split 0, 1, 2-3, 4-5, 6-12, 13-17 18+. \"elderly\" \"seniors\", equivalent : c(65, 75, 85). split 0-64, 65-74, 75-84, 85+. \"fives\", equivalent : 1:20 * 5. split 0-4, 5-9, ..., 95-99, 100+. \"tens\", equivalent : 1:10 * 10. split 0-9, 10-19, ..., 90-99, 100+.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split Ages into Age Groups — age_groups","text":"","code":"ages <- c(3, 8, 16, 54, 31, 76, 101, 43, 21)  # split into 0-49 and 50+ age_groups(ages, 50) #> [1] 0-49 0-49 0-49 50+  0-49 50+  50+  0-49 0-49 #> Levels: 0-49 < 50+  # split into 0-19, 20-49 and 50+ age_groups(ages, c(20, 50)) #> [1] 0-19  0-19  0-19  50+   20-49 50+   50+   20-49 20-49 #> Levels: 0-19 < 20-49 < 50+ age_groups(ages, c(20, 50), names = c(\"Under 20 years\", \"20 to 50 years\", \"Over 50 years\")) #> [1] Under 20 years Under 20 years Under 20 years Over 50 years  20 to 50 years #> [6] Over 50 years  Over 50 years  20 to 50 years 20 to 50 years #> Levels: Under 20 years < 20 to 50 years < Over 50 years  # split into groups of ten years age_groups(ages, 1:10 * 10) #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+ age_groups(ages, split_at = \"tens\") #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+  # split into groups of five years age_groups(ages, 1:20 * 5) #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+ age_groups(ages, split_at = \"fives\") #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+  # split specifically for children age_groups(ages, c(1, 2, 4, 6, 13, 18)) #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+ age_groups(ages, \"children\") #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+  # \\donttest{ # resistance of ciprofloxacin per age group if (require(\"dplyr\") && require(\"ggplot2\")) {   example_isolates %>%     filter_first_isolate() %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(       x = \"age_group\",       minimum = 0,       x.title = \"Age Group\",       title = \"Ciprofloxacin resistance per age group\"     ) } #> Loading required package: ggplot2  # }"},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":null,"dir":"Reference","previous_headings":"","what":"AMR Extensions for Tidymodels — amr-tidymodels","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"family functions allows using AMR-specific data types <mic> <sir> inside tidymodels pipelines.","code":""},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"","code":"all_mic()  all_mic_predictors()  all_sir()  all_sir_predictors()  step_mic_log2(recipe, ..., role = NA, trained = FALSE, columns = NULL,   skip = FALSE, id = recipes::rand_id(\"mic_log2\"))  step_sir_numeric(recipe, ..., role = NA, trained = FALSE, columns = NULL,   skip = FALSE, id = recipes::rand_id(\"sir_numeric\"))"},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"recipe recipe object. step added sequence operations recipe. ... One selector functions choose variables step. See selections() details. role used step since new variables created. trained logical indicate quantities preprocessing estimated. skip logical. step skipped recipe baked bake()? operations baked prep() run, operations may able conducted new data (e.g. processing outcome variable(s)). Care taken using skip = TRUE may affect computations subsequent operations. id character string unique step identify .","code":""},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"can read online AMR tidymodels introduction. Tidyselect helpers include: all_mic() all_mic_predictors() select <mic> columns all_sir() all_sir_predictors() select <sir> columns Pre-processing pipeline steps include: step_mic_log2() convert MIC columns numeric (via .numeric()) apply log2 transform, used all_mic_predictors() step_sir_numeric() convert SIR columns numeric (via .numeric()), used all_sir_predictors(): \"S\" = 1, \"\"/\"SDD\" = 2, \"R\" = 3. values rendered NA. Keep mind processing, especially model allow NA values. steps integrate recipes::recipe() work like standard preprocessing steps. useful preparing data modelling, especially classification models.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"","code":"if (require(\"tidymodels\")) {    # The below approach formed the basis for this paper: DOI 10.3389/fmicb.2025.1582703   # Presence of ESBL genes was predicted based on raw MIC values.     # example data set in the AMR package   esbl_isolates    # Prepare a binary outcome and convert to ordered factor   data <- esbl_isolates %>%     mutate(esbl = factor(esbl, levels = c(FALSE, TRUE), ordered = TRUE))    # Split into training and testing sets   split <- initial_split(data)   training_data <- training(split)   testing_data <- testing(split)    # Create and prep a recipe with MIC log2 transformation   mic_recipe <- recipe(esbl ~ ., data = training_data) %>%      # Optionally remove non-predictive variables     remove_role(genus, old_role = \"predictor\") %>%      # Apply the log2 transformation to all MIC predictors     step_mic_log2(all_mic_predictors()) %>%      # And apply the preparation steps     prep()    # View prepped recipe   mic_recipe    # Apply the recipe to training and testing data   out_training <- bake(mic_recipe, new_data = NULL)   out_testing <- bake(mic_recipe, new_data = testing_data)    # Fit a logistic regression model   fitted <- logistic_reg(mode = \"classification\") %>%     set_engine(\"glm\") %>%     fit(esbl ~ ., data = out_training)    # Generate predictions on the test set   predictions <- predict(fitted, out_testing) %>%     bind_cols(out_testing)    # Evaluate predictions using standard classification metrics   our_metrics <- metric_set(accuracy, kap, ppv, npv)   metrics <- our_metrics(predictions, truth = esbl, estimate = .pred_class)    # Show performance   metrics } #> Loading required package: tidymodels #> ── Attaching packages ────────────────────────────────────── tidymodels 1.3.0 ── #> ✔ broom        1.0.8     ✔ rsample      1.3.0 #> ✔ dials        1.4.0     ✔ tibble       3.3.0 #> ✔ infer        1.0.9     ✔ tidyr        1.3.1 #> ✔ modeldata    1.4.0     ✔ tune         1.3.0 #> ✔ parsnip      1.3.2     ✔ workflows    1.2.0 #> ✔ purrr        1.1.0     ✔ workflowsets 1.1.1 #> ✔ recipes      1.3.1     ✔ yardstick    1.3.2 #> ── Conflicts ───────────────────────────────────────── tidymodels_conflicts() ── #> ✖ purrr::discard() masks scales::discard() #> ✖ dplyr::filter()  masks stats::filter() #> ✖ dplyr::lag()     masks stats::lag() #> ✖ recipes::step()  masks stats::step() #> Warning: glm.fit: fitted probabilities numerically 0 or 1 occurred #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.936 #> 2 kap      binary         0.872 #> 3 ppv      binary         0.925 #> 4 npv      binary         0.948"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Create detailed antibiograms options traditional, combination, syndromic, Bayesian WISCA methods. Adhering previously described approaches (see Source) especially Bayesian WISCA model (Weighted-Incidence Syndromic Combination Antibiogram) Bielicki et al., functions provide flexible output formats including plots tables, ideal integration R Markdown Quarto reports.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"antibiogram(x, antimicrobials = where(is.sir), mo_transform = \"shortname\",   ab_transform = \"name\", syndromic_group = NULL, add_total_n = FALSE,   only_all_tested = FALSE, digits = ifelse(wisca, 1, 0),   formatting_type = getOption(\"AMR_antibiogram_formatting_type\",   ifelse(wisca, 14, 18)), col_mo = NULL, language = get_AMR_locale(),   minimum = 30, combine_SI = TRUE, sep = \" + \", sort_columns = TRUE,   wisca = FALSE, simulations = 1000, conf_interval = 0.95,   interval_side = \"two-tailed\", info = interactive(), ...)  wisca(x, antimicrobials = where(is.sir), ab_transform = \"name\",   syndromic_group = NULL, only_all_tested = FALSE, digits = 1,   formatting_type = getOption(\"AMR_antibiogram_formatting_type\", 14),   col_mo = NULL, language = get_AMR_locale(), combine_SI = TRUE,   sep = \" + \", sort_columns = TRUE, simulations = 1000,   conf_interval = 0.95, interval_side = \"two-tailed\",   info = interactive(), ...)  retrieve_wisca_parameters(wisca_model, ...)  # S3 method for class 'antibiogram' plot(x, ...)  # S3 method for class 'antibiogram' autoplot(object, ...)  # S3 method for class 'antibiogram' knit_print(x, italicise = TRUE,   na = getOption(\"knitr.kable.NA\", default = \"\"), ...)"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Bielicki JA et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data Journal Antimicrobial Chemotherapy 71(3); doi:10.1093/jac/dkv397 Bielicki JA et al. (2020). Evaluation coverage 3 antibiotic regimens neonatal sepsis hospital setting across Asian countries JAMA Netw Open. 3(2):e1921124; doi:10.1001/jamanetworkopen.2019.21124 Klinker KP et al. (2021). Antimicrobial stewardship antibiograms: importance moving beyond traditional antibiograms. Therapeutic Advances Infectious Disease, May 5;8:20499361211011373; doi:10.1177/20499361211011373 Barbieri E et al. (2021). Development Weighted-Incidence Syndromic Combination Antibiogram (WISCA) guide choice empiric antibiotic treatment urinary tract infection paediatric patients: Bayesian approach Antimicrobial Resistance & Infection Control May 1;10(1):74; doi:10.1186/s13756-021-00939-2 M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"x data.frame containing least column microorganisms columns antimicrobial results (class 'sir', see .sir()). antimicrobials vector specifying antimicrobials containing SIR values include antibiogram (see Examples). evaluated using guess_ab_col(). can : antimicrobial name code match (see guess_ab_col()) column x antimicrobial selector, aminoglycosides() carbapenems() combination , using c(), e.g.: c(aminoglycosides(), \"AMP\", \"AMC\") c(aminoglycosides(), carbapenems()) Column indices using numbers Combination therapy, indicated using \"+\", without antimicrobial selectors, e.g.: \"cipro + genta\" \"TZP+TOB\" c(\"TZP\", \"TZP+GEN\", \"TZP+TOB\") carbapenems() + \"GEN\" carbapenems() + c(\"\", \"GEN\") carbapenems() + c(\"\", aminoglycosides()) mo_transform character transform microorganism input - must \"name\", \"shortname\" (default), \"gramstain\", one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Can also NULL transform input NA consider microorganisms 'unknown'. ab_transform character transform antimicrobial input - must one column names antimicrobials data set (defaults \"name\"): \"ab\", \"cid\", \"name\", \"group\", \"atc\", \"atc_group1\", \"atc_group2\", \"abbreviations\", \"synonyms\", \"oral_ddd\", \"oral_units\", \"iv_ddd\", \"iv_units\", \"loinc\". Can also NULL transform input. syndromic_group column name x, values calculated split rows x, e.g. using ifelse() case_when(). See Examples. add_total_n (deprecated favour formatting_type) logical indicate whether n_tested available numbers per pathogen added table (default TRUE). add lowest highest number available isolates per antimicrobial (e.g, E. coli 200 isolates available ciprofloxacin 150 amoxicillin, returned number \"150-200\"). option unavailable wisca = TRUE; case, use retrieve_wisca_parameters() get parameters used WISCA. only_all_tested (combination antibiograms): logical indicate isolates must tested antimicrobials, see Details. digits Number digits use rounding antimicrobial coverage, defaults 1 WISCA 0 otherwise. formatting_type Numeric value (1–22 WISCA, 1-12 non-WISCA) indicating 'cells' antibiogram table formatted. See Details > Formatting Type list options. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). language Language translate text, defaults system language (see get_AMR_locale()). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether susceptibility determined results either S, SDD, , instead S (default TRUE). sep separating character antimicrobial columns combination antibiograms. sort_columns logical indicate whether antimicrobial columns must sorted name. wisca logical indicate whether Weighted-Incidence Syndromic Combination Antibiogram (WISCA) must generated (default FALSE). use Bayesian decision model estimate regimen coverage probabilities using Monte Carlo simulations. Set simulations, conf_interval, interval_side adjust. simulations (WISCA) numerical value set number Monte Carlo simulations. conf_interval numerical value set confidence interval (default 0.95). interval_side side confidence interval, either \"two-tailed\" (default), \"left\" \"right\". info logical indicate info printed - default TRUE interactive mode. ... used R Markdown Quarto: arguments passed knitr::kable() (otherwise, use). wisca_model outcome wisca() antibiogram(..., wisca = TRUE). object antibiogram() object. italicise logical indicate whether microorganism names knitr table made italic, using italicise_taxonomy(). na Character use showing NA values.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"functions return table values 0 100 susceptibility, resistance. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine one four available algorithms: isolate-based, patient-based, episode-based, phenotype-based. estimating antimicrobial coverage, especially creating WISCA, outcome might become reliable including top n species encountered data. can filter top n using top_n_microorganisms(). example, use top_n_microorganisms(your_data, n = 10) pre-processing step include top 10 species data. numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). ideal e.g. advanced plotting.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"formatting-type","dir":"Reference","previous_headings":"","what":"Formatting Type","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"formatting 'cells' table can set argument formatting_type. examples, 5 indicates antimicrobial coverage (4-6 confidence level), 15 number susceptible isolates, 300 number tested (.e., available) isolates: 5 15 300 15/300 5 (300) 5% (300) 5 (N=300) 5% (N=300) 5 (15/300) 5% (15/300) 5 (N=15/300) 5% (N=15/300) 5 (4-6) 5% (4-6%) - default WISCA 5 (4-6,300) 5% (4-6%,300) 5 (4-6,N=300) 5% (4-6%,N=300) - default non-WISCA 5 (4-6,15/300) 5% (4-6%,15/300) 5 (4-6,N=15/300) 5% (4-6%,N=15/300) default can set globally package option AMR_antibiogram_formatting_type, e.g. options(AMR_antibiogram_formatting_type = 5). note WISCA, total numbers tested susceptible isolates less useful report, since included Bayesian model apparent susceptibility confidence level. Set digits (defaults 0) alter rounding susceptibility percentages.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"antibiogram-types","dir":"Reference","previous_headings":"","what":"Antibiogram Types","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"various antibiogram types, summarised Klinker et al. (2021, doi:10.1177/20499361211011373 ), supported antibiogram(). clinical coverage estimations, use WISCA whenever possible, since provides precise coverage estimates accounting pathogen incidence antimicrobial susceptibility, shown Bielicki et al. (2020, doi:10.1001/jamanetworkopen.2019.21124 ). See section Explaining WISCA page. note WISCA pathogen-agnostic, meaning outcome stratied pathogen, rather syndrome. Traditional Antibiogram Case example: Susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Code example:   Combination Antibiogram Case example: Additional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Code example:   Syndromic Antibiogram Case example: Susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Code example:   Weighted-Incidence Syndromic Combination Antibiogram (WISCA) WISCA can applied antibiogram, see section Explaining WISCA page information. Code example:   WISCA uses sophisticated Bayesian decision model combine local pooled antimicrobial resistance data. approach evaluates local patterns can also draw multi-centre datasets improve regimen accuracy, even low-incidence infections like paediatric bloodstream infections (BSIs).","code":"antibiogram(your_data,             antimicrobials = \"TZP\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\")) antibiogram(your_data,             antimicrobials = penicillins(),             syndromic_group = \"ward\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             wisca = TRUE)  # this is equal to: wisca(your_data,       antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"grouped-tibbles","dir":"Reference","previous_headings":"","what":"Grouped tibbles","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"type antibiogram, grouped tibbles can also used calculate susceptibilities various groups. Code example:","code":"library(dplyr) your_data %>%   group_by(has_sepsis, is_neonate, sex) %>%   wisca(antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"stepped-approach-for-clinical-insight","dir":"Reference","previous_headings":"","what":"Stepped Approach for Clinical Insight","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"clinical practice, antimicrobial coverage decisions evolve microbiological data becomes available. theoretical stepped approach ensures empirical coverage can continuously assessed improve patient outcomes: Initial Empirical Therapy (Admission / Pre-Culture Data) admission, pathogen information available. Action: broad-spectrum coverage based local resistance patterns syndromic antibiograms. Using pathogen-agnostic yet incidence-weighted WISCA preferred. Code example:   Refinement Gram Stain Results blood culture becomes positive, Gram stain provides initial crucial first stratification (Gram-positive vs. Gram-negative). Action: narrow coverage based Gram stain-specific resistance patterns. Code example:   Definitive Therapy Based Species Identification cultivation pathogen, full pathogen identification allows precise targeting therapy. Action: adjust treatment pathogen-specific antibiograms, minimizing resistance risks. Code example:   structuring antibiograms around stepped approach, clinicians can make data-driven adjustments stage, ensuring optimal empirical targeted therapy reducing unnecessary broad-spectrum antimicrobial use.","code":"antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = NA) # all pathogens set to `NA`  # preferred: use WISCA wisca(your_data,       antimicrobials = selected_regimens) antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"gramstain\") # all pathogens set to Gram-pos/Gram-neg antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"shortname\") # all pathogens set to 'G. species', e.g., E. coli"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"inclusion-in-combination-antibiograms","dir":"Reference","previous_headings":"","what":"Inclusion in Combination Antibiograms","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Note combination antibiograms, important realise susceptibility can calculated two ways, can set only_all_tested argument (default FALSE). See example two antimicrobials, Drug Drug B, antibiogram() works calculate %SI:","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - --------------------------------------------------------------------"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"plotting","dir":"Reference","previous_headings":"","what":"Plotting","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"types antibiograms listed can plotted (using ggplot2::autoplot() base R's plot() barplot()). mentioned , numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). outcome antibiogram() can also used directly R Markdown / Quarto (.e., knitr) reports. case, knitr::kable() applied automatically microorganism names even printed italics default (see argument italicise). can also use functions specific 'table reporting' packages transform output antibiogram() needs, e.g. flextable::as_flextable() gt::gt().","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"explaining-wisca","dir":"Reference","previous_headings":"","what":"Explaining WISCA","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"WISCA (Weighted-Incidence Syndromic Combination Antibiogram) estimates probability empirical coverage combination regimens. weights susceptibility pathogen prevalence within clinical syndrome provides credible intervals around expected coverage. background, interpretation, examples, see WISCA vignette.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Implementation: Dr. Larisse Bolton Dr. Matthijs Berends","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ # Traditional antibiogram ----------------------------------------------  antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()) ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram: 10 × 7 #> # Type:           Non-WISCA with 95% CI #>    Pathogen       Amikacin    Gentamicin Imipenem Kanamycin Meropenem Tobramycin #>    <chr>          <chr>       <chr>      <chr>    <chr>     <chr>     <chr>      #>  1 CoNS           0% (0-8%,N… 86% (82-9… 52% (37… 0% (0-8%… 52% (37-… 22% (12-3… #>  2 E. coli        100% (98-1… 98% (96-9… 100% (9… NA        100% (99… 97% (96-9… #>  3 E. faecalis    0% (0-9%,N… 0% (0-9%,… 100% (9… 0% (0-9%… NA        0% (0-9%,… #>  4 K. pneumoniae  NA          90% (79-9… 100% (9… NA        100% (93… 90% (79-9… #>  5 P. aeruginosa  NA          100% (88-… NA       0% (0-12… NA        100% (88-… #>  6 P. mirabilis   NA          94% (80-9… 94% (79… NA        NA        94% (80-9… #>  7 S. aureus      NA          99% (97-1… NA       NA        NA        98% (92-1… #>  8 S. epidermidis 0% (0-8%,N… 79% (71-8… NA       0% (0-8%… NA        51% (40-6… #>  9 S. hominis     NA          92% (84-9… NA       NA        NA        85% (74-9… #> 10 S. pneumoniae  0% (0-3%,N… 0% (0-3%,… NA       0% (0-3%… NA        0% (0-3%,… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = aminoglycosides(),   ab_transform = \"atc\",   mo_transform = \"gramstain\" ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   Pathogen      J01GB01            J01GB03             J01GB04         J01GB06   #>   <chr>         <chr>              <chr>               <chr>           <chr>     #> 1 Gram-negative 96% (94-97%,N=686) 96% (95-98%,N=684)  0% (0-10%,N=35) 98% (96-… #> 2 Gram-positive 34% (31-38%,N=665) 63% (60-66%,N=1170) 0% (0-1%,N=436) 0% (0-1%… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = carbapenems(),   ab_transform = \"name\",   mo_transform = \"name\" ) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram: 5 × 3 #> # Type:           Non-WISCA with 95% CI #>   Pathogen                                 Imipenem             Meropenem        #>   <chr>                                    <chr>                <chr>            #> 1 Coagulase-negative Staphylococcus (CoNS) 52% (37-67%,N=48)    52% (37-67%,N=4… #> 2 Enterococcus faecalis                    100% (91-100%,N=38)  NA               #> 3 Escherichia coli                         100% (99-100%,N=422) 100% (99-100%,N… #> 4 Klebsiella pneumoniae                    100% (93-100%,N=51)  100% (93-100%,N… #> 5 Proteus mirabilis                        94% (79-99%,N=32)    NA               #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Combined antibiogram -------------------------------------------------  # combined antimicrobials yield higher empiric coverage antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   mo_transform = \"gramstain\" ) #> # An Antibiogram: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # you can use any antimicrobial selector with `+` too: antibiogram(example_isolates,   antimicrobials = ureidopenicillins() + c(\"\", \"GEN\", \"tobra\"),   mo_transform = \"gramstain\" ) #> ℹ For `ureidopenicillins()` using column 'TZP' (piperacillin/tazobactam) #> # An Antibiogram: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # names of antimicrobials do not need to resemble columns exactly: antibiogram(example_isolates,   antimicrobials = c(\"Cipro\", \"cipro + genta\"),   mo_transform = \"gramstain\",   ab_transform = \"name\",   sep = \" & \" ) #> # An Antibiogram: 2 × 3 #> # Type:           Non-WISCA with 95% CI #>   Pathogen      Ciprofloxacin      `Ciprofloxacin & Gentamicin` #>   <chr>         <chr>              <chr>                        #> 1 Gram-negative 91% (88-93%,N=684) 99% (97-99%,N=694)           #> 2 Gram-positive 77% (74-80%,N=724) 93% (91-94%,N=847)           #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Syndromic antibiogram ------------------------------------------------  # the data set could contain a filter for e.g. respiratory specimens antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()),   syndromic_group = \"ward\" ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram: 14 × 8 #> # Type:           Non-WISCA with 95% CI #>    `Syndromic Group` Pathogen   Amikacin Gentamicin Imipenem Kanamycin Meropenem #>    <chr>             <chr>      <chr>    <chr>      <chr>    <chr>     <chr>     #>  1 Clinical          CoNS       NA       89% (84-9… 57% (39… NA        57% (39-… #>  2 ICU               CoNS       NA       79% (68-8… NA       NA        NA        #>  3 Outpatient        CoNS       NA       84% (66-9… NA       NA        NA        #>  4 Clinical          E. coli    100% (9… 98% (96-9… 100% (9… NA        100% (99… #>  5 ICU               E. coli    100% (9… 99% (95-1… 100% (9… NA        100% (97… #>  6 Clinical          K. pneumo… NA       92% (81-9… 100% (9… NA        100% (92… #>  7 Clinical          P. mirabi… NA       100% (88-… NA       NA        NA        #>  8 Clinical          S. aureus  NA       99% (95-1… NA       NA        NA        #>  9 ICU               S. aureus  NA       100% (95-… NA       NA        NA        #> 10 Clinical          S. epider… NA       82% (72-9… NA       NA        NA        #> 11 ICU               S. epider… NA       72% (60-8… NA       NA        NA        #> 12 Clinical          S. hominis NA       96% (85-9… NA       NA        NA        #> 13 Clinical          S. pneumo… 0% (0-5… 0% (0-5%,… NA       0% (0-5%… NA        #> 14 ICU               S. pneumo… 0% (0-1… 0% (0-12%… NA       0% (0-12… NA        #> # ℹ 1 more variable: Tobramycin <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # now define a data set with only E. coli ex1 <- example_isolates[which(mo_genus() == \"Escherichia\"), ] #> ℹ Using column 'mo' as input for `mo_genus()`  # with a custom language, though this will be determined automatically # (i.e., this table will be in Spanish on Spanish systems) antibiogram(ex1,   antimicrobials = aminoglycosides(),   ab_transform = \"name\",   syndromic_group = ifelse(ex1$ward == \"ICU\",     \"UCI\", \"No UCI\"   ),   language = \"es\" ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   `Grupo sindrómico` Patógeno Amikacina            Gentamicina       Tobramicina #>   <chr>              <chr>    <chr>                <chr>             <chr>       #> 1 No UCI             E. coli  100% (97-100%,N=119) 98% (96-99%,N=32… 98% (96-99… #> 2 UCI                E. coli  100% (93-100%,N=52)  99% (95-100%,N=1… 96% (92-99… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # WISCA antibiogram ----------------------------------------------------  # WISCA are not stratified by species, but rather on syndromes antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   syndromic_group = \"ward\",   wisca = TRUE ) #> # An Antibiogram: 3 × 4 #> # Type:           WISCA with 95% CI #>   `Syndromic Group` `Piperacillin/tazobactam` Piperacillin/tazobactam + Gentam…¹ #>   <chr>             <chr>                     <chr>                              #> 1 Clinical          73.6% (68.3-78.8%)        92.3% (90.8-93.8%)                 #> 2 ICU               57.2% (49.8-65.1%)        84.9% (81.8-87.8%)                 #> 3 Outpatient        57.1% (47.2-66.8%)        74.4% (69-79.6%)                   #> # ℹ abbreviated name: ¹​`Piperacillin/tazobactam + Gentamicin` #> # ℹ 1 more variable: `Piperacillin/tazobactam + Tobramycin` <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Print the output for R Markdown / Quarto -----------------------------  ureido <- antibiogram(example_isolates,   antimicrobials = ureidopenicillins(),   syndromic_group = \"ward\",   wisca = TRUE ) #> ℹ For `ureidopenicillins()` using column 'TZP' (piperacillin/tazobactam)  # in an Rmd file, you would just need to return `ureido` in a chunk, # but to be explicit here: if (requireNamespace(\"knitr\")) {   cat(knitr::knit_print(ureido)) } #>  #>  #> |Syndromic Group |Piperacillin/tazobactam | #> |:---------------|:-----------------------| #> |Clinical        |73.4% (67.8-78.8%)      | #> |ICU             |57.2% (49.6-65.3%)      | #> |Outpatient      |56.9% (47.1-66.9%)      |   # Generate plots with ggplot2 or base R --------------------------------  ab1 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\" ) ab2 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\",   syndromic_group = \"ward\" )  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab1) }  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab2) }   plot(ab1)  plot(ab2)  # }"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":null,"dir":"Reference","previous_headings":"","what":"Antimicrobial Selectors — antimicrobial_selectors","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions allow filtering rows selecting columns based antimicrobial test results specific antimicrobial class group, without need define columns antimicrobial abbreviations. can used base R, tidyverse, tidymodels, data.table. Simply puy, column name resembles antimicrobial drug, picked functions matches pharmaceutical class, code name: column names \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" included following selection:","code":"library(dplyr) my_data_with_all_these_columns %>%   select(cephalosporins())"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"aminoglycosides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  aminopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  antifungals(only_sir_columns = FALSE, return_all = TRUE, ...)  antimycobacterials(only_sir_columns = FALSE, return_all = TRUE, ...)  betalactams(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  betalactams_with_inhibitor(only_sir_columns = FALSE, return_all = TRUE,   ...)  carbapenems(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_1st(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_2nd(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_3rd(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_4th(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_5th(only_sir_columns = FALSE, return_all = TRUE, ...)  fluoroquinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  glycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  isoxazolylpenicillins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lincosamides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lipoglycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  macrolides(only_sir_columns = FALSE, return_all = TRUE, ...)  monobactams(only_sir_columns = FALSE, return_all = TRUE, ...)  nitrofurans(only_sir_columns = FALSE, return_all = TRUE, ...)  oxazolidinones(only_sir_columns = FALSE, return_all = TRUE, ...)  penicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  phenicols(only_sir_columns = FALSE, return_all = TRUE, ...)  polymyxins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  quinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  rifamycins(only_sir_columns = FALSE, return_all = TRUE, ...)  streptogramins(only_sir_columns = FALSE, return_all = TRUE, ...)  sulfonamides(only_sir_columns = FALSE, return_all = TRUE, ...)  tetracyclines(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  trimethoprims(only_sir_columns = FALSE, return_all = TRUE, ...)  ureidopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  amr_class(amr_class, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  amr_selector(filter, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  administrable_per_os(only_sir_columns = FALSE, return_all = TRUE, ...)  administrable_iv(only_sir_columns = FALSE, return_all = TRUE, ...)  not_intrinsic_resistant(only_sir_columns = FALSE, col_mo = NULL,   version_expected_phenotypes = 1.2, ...)"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE. only_treatable logical indicate whether antimicrobial drugs excluded laboratory tests (default TRUE), gentamicin-high (GEH) imipenem/EDTA (IPE). return_all logical indicate whether matched columns must returned (default TRUE). FALSE, first unique antimicrobial returned, e.g. columns \"genta\" \"gentamicin\" exist data, first hit gentamicin returned. ... Ignored, place allow future extensions. amr_class antimicrobial class part , \"carba\" \"carbapenems\". columns group, atc_group1 atc_group2 antimicrobials data set searched (case-insensitive) value. filter expression evaluated antimicrobials data set, name %like% \"trim\". col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\".","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"used inside selecting filtering, returns character vector column names, additional class \"amr_selector\". used individually, returns 'ab' vector possible antimicrobials function able select filter.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions can used data set calls selecting columns filtering rows. work base R, Tidyverse, data.table. heavily inspired Tidyverse selection helpers everything(), limited dplyr verbs. Nonetheless, convenient use dplyr functions select(), filter() summarise(), see Examples. selectors can also used tidymodels packages recipe parsnip. See info tutorial using antimicrobial selectors predictive modelling. columns data functions called searched known antimicrobial names, abbreviations, brand names, codes (ATC, EARS-Net, , etc.) according antimicrobials data set. means selector aminoglycosides() pick column names like 'gen', 'genta', 'J01GB03', 'tobra', 'Tobracin', etc. amr_class() function can used filter/select manually defined antimicrobial class. searches results antimicrobials data set within columns group, atc_group1 atc_group2. administrable_per_os() administrable_iv() functions also rely antimicrobials data set - antimicrobials matched DDD (defined daily dose) resp. oral IV treatment available antimicrobials data set. amr_selector() function can used internally filter antimicrobials data set results, see Examples. allows filtering (part ) certain name, /group name even minimum DDDs oral treatment. function yields highest flexibility, also least user-friendly, since requires hard-coded filter set. not_intrinsic_resistant() function can used select antimicrobials pose intrinsic resistance microorganisms data set. example, data set contains microorganism codes names E. coli K. pneumoniae contains column \"vancomycin\", column removed (rather, unselected) using function. currently applies 'EUCAST Expected Resistant Phenotypes' v1.2 (2023) determine intrinsic resistance, using eucast_rules() function internally. determination, function quite slow terms performance.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"full-list-of-supported-antimicrobial-classes","dir":"Reference","previous_headings":"","what":"Full list of supported (antimicrobial) classes","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"aminoglycosides() can select:  amikacin (AMK), amikacin/fosfomycin (AKF), apramycin (APR), arbekacin (ARB), astromicin (AST), bekanamycin (BEK), dibekacin (DKB), framycetin (FRM), gentamicin (GEN), gentamicin-high (GEH), habekacin (HAB), hygromycin (HYG), isepamicin (ISE), kanamycin (KAN), kanamycin-high (KAH), kanamycin/cephalexin (KAC), micronomicin (MCR), neomycin (NEO), netilmicin (NET), pentisomicin (PIM), plazomicin (PLZ), propikacin (PKA), ribostamycin (RST), sisomicin (SIS), streptoduocin (STR), streptomycin (STR1), streptomycin-high (STH), tobramycin (TOB), tobramycin-high (TOH) aminopenicillins() can select:  amoxicillin (AMX) ampicillin (AMP) antifungals() can select:  amorolfine (AMO), amphotericin B (AMB), amphotericin B-high (AMH), anidulafungin (ANI), butoconazole (), caspofungin (CAS), ciclopirox (CIX), clotrimazole (CTR), econazole (ECO), fluconazole (FLU), flucytosine (FCT), fosfluconazole (FFL), griseofulvin (GRI), hachimycin (HCH), ibrexafungerp (IBX), isavuconazole (ISV), isoconazole (ISO), itraconazole (ITR), ketoconazole (KET), manogepix (MGX), micafungin (MIF), miconazole (MCZ), nystatin (NYS), oteseconazole (OTE), pimaricin (PMR), posaconazole (POS), rezafungin (RZF), ribociclib (RBC), sulconazole (SUC), terbinafine (TRB), terconazole (TRC), voriconazole (VOR) antimycobacterials() can select:  4-aminosalicylic acid (AMA), calcium aminosalicylate (CLA), capreomycin (CAP), clofazimine (CLF), delamanid (DLM), enviomycin (ENV), ethambutol (ETH), ethambutol/isoniazid (ETI), ethionamide (ETI1), isoniazid (INH), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), morinamide (MRN), p-aminosalicylic acid (PAS), pretomanid (PMD), protionamide (PTH), pyrazinamide (PZA), rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP), simvastatin/fenofibrate (SMF), sodium aminosalicylate (SDA), streptomycin/isoniazid (STI), terizidone (TRZ), thioacetazone (TAT), thioacetazone/isoniazid (THI1), tiocarlide (TCR), viomycin (VIO) betalactams() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), biapenem (BIA), carbenicillin (CRB), carindacillin (CRN), carumonam (CAR), cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), doripenem (DOR), epicillin (EPC), ertapenem (ETP), flucloxacillin (FLC), hetacillin (HET), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), latamoxef (LTM), lenampicillin (LEN), loracarbef (LOR), mecillinam (MEC), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), panipenem (PAN), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tebipenem (TBP), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC), tigemonam (TMN) betalactams_with_inhibitor() can select:  amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin/sulbactam (SAM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefoperazone/sulbactam (CSL), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefpodoxime/clavulanic acid (CDC), ceftaroline/avibactam (CPA), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), ceftolozane/tazobactam (CZT), ceftriaxone/beta-lactamase inhibitor (CEB), imipenem/relebactam (IMR), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), mezlocillin/sulbactam (MSU), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), ticarcillin/clavulanic acid (TCC) carbapenems() can select:  biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP) cephalosporins() can select:  cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), latamoxef (LTM), loracarbef (LOR) cephalosporins_1st() can select:  cefacetrile (CAC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefroxadine (CRD), ceftezole (CTL), cephradine (CED) cephalosporins_2nd() can select:  cefaclor (CEC), cefamandole (MAN), cefmetazole (CMZ), cefonicid (CID), ceforanide (CND), cefotetan (CTT), cefotiam (CTF), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefprozil (CPR), cefuroxime (CXM), cefuroxime axetil (CXA), loracarbef (LOR) cephalosporins_3rd() can select:  cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefetamet (CAT), cefetamet pivoxil (CPI), cefixime (CFM), cefmenoxime (CMX), cefodizime (DIZ), cefoperazone (CFP), cefoperazone/sulbactam (CSL), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotiam hexetil (CHE), cefovecin (FOV), cefpimizole (CFZ), cefpiramide (CPM), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefsulodin (CFS), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), latamoxef (LTM) cephalosporins_4th() can select:  cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetecol (CCL), cefoselis (CSE), cefozopran (ZOP), cefpirome (CPO), cefquinome (CEQ) cephalosporins_5th() can select:  ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT) fluoroquinolones() can select:  besifloxacin (BES), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) glycopeptides() can select:  avoparcin (AVO), bleomycin (BLM), dalbavancin (DAL), norvancomycin (NVA), oritavancin (ORI), ramoplanin (RAM), teicoplanin (TEC), teicoplanin-macromethod (TCM), telavancin (TLV), vancomycin (VAN), vancomycin-macromethod (VAM) isoxazolylpenicillins() can select:  cloxacillin (CLO), dicloxacillin (DIC), flucloxacillin (FLC), meticillin (MET), oxacillin (OXA), oxacillin screening test (OXA-S) lincosamides() can select:  clindamycin (CLI), lincomycin (LIN), pirlimycin (PRL) lipoglycopeptides() can select:  dalbavancin (DAL), oritavancin (ORI), telavancin (TLV) macrolides() can select:  acetylmidecamycin (ACM), acetylspiramycin (ASP), azithromycin (AZM), clarithromycin (CLR), dirithromycin (DIR), erythromycin (ERY), flurithromycin (FLR1), gamithromycin (GAM), josamycin (JOS), kitasamycin (KIT), meleumycin (MEL), midecamycin (MID), miocamycin (MCM), nafithromycin (ZWK), oleandomycin (OLE), rokitamycin (ROK), roxithromycin (RXT), solithromycin (SOL), spiramycin (SPI), telithromycin (TLT), tildipirosin (TIP), tilmicosin (TIL), troleandomycin (TRL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) monobactams() can select:  aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), carumonam (CAR), tigemonam (TMN) nitrofurans() can select:  furazidin (FUR), furazolidone (FRZ), nifurtoinol (NFR), nitrofurantoin (NIT), nitrofurazone (NIZ) oxazolidinones() can select:  cadazolid (CDZ), cycloserine (CYC), linezolid (LNZ), tedizolid (TZD), thiacetazone (THA) penicillins() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), carbenicillin (CRB), carindacillin (CRN), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), epicillin (EPC), flucloxacillin (FLC), hetacillin (HET), lenampicillin (LEN), mecillinam (MEC), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC) phenicols() can select:  chloramphenicol (CHL), florfenicol (FLR), thiamphenicol (THI) polymyxins() can select:  colistin (COL), polymyxin B (PLB), polymyxin B/polysorbate 80 (POP) quinolones() can select:  besifloxacin (BES), cinoxacin (CIN), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), flumequine (FLM), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nalidixic acid (NAL), nalidixic acid screening test (NAL-S), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), oxolinic acid (OXO), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pipemidic acid (PPA), piromidic acid (PIR), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rosoxacin (ROS), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) rifamycins() can select:  rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP) streptogramins() can select:  pristinamycin (PRI) quinupristin/dalfopristin (QDA) sulfonamides() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfamoxole (SLF8), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13) tetracyclines() can select:  cetocycline (CTO), chlortetracycline (CTE), clomocycline (CLM1), demeclocycline (DEM), doxycycline (DOX), eravacycline (ERV), lymecycline (LYM), metacycline (MTC), minocycline (MNO), omadacycline (OMC), oxytetracycline (OXY), penimepicycline (PNM1), rolitetracycline (RLT), sarecycline (SRC), tetracycline (TCY), tetracycline screening test (TCY-S), tigecycline (TGC) trimethoprims() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadiazine/trimethoprim (SLT1), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfadimidine/trimethoprim (SLT2), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamerazine/trimethoprim (SLT3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfametrole/trimethoprim (SLT4), sulfamoxole (SLF8), sulfamoxole/trimethoprim (SLT5), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13), trimethoprim (TMP), trimethoprim/sulfamethoxazole (SXT) ureidopenicillins() can select:  azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # you can use the selectors separately to retrieve all possible antimicrobials: carbapenems() #> ℹ in `carbapenems()`: Imipenem/EDTA (`IPE`) and meropenem/nacubactam #>   (`MNC`) are not included since `only_treatable = TRUE`. #> ℹ This 'ab' vector was retrieved using `carbapenems()`, which should #>   normally be used inside a `dplyr` verb or `data.frame` call, e.g.: #>   • your_data %>% select(carbapenems()) #>   • your_data %>% select(column_a, column_b, carbapenems()) #>   • your_data %>% filter(any(carbapenems() == \"R\")) #>   • your_data[, carbapenems()] #>   • your_data[, c(\"column_a\", \"column_b\", carbapenems())] #> Class 'ab' #>  [1] BIA DOR ETP IMR IPM MEM MEV PAN RIA RIT RZM TBP   # Though they are primarily intended to use for selections and filters. # Examples sections below are split into 'dplyr', 'base R', and 'data.table':  # \\donttest{ if (FALSE) { # \\dontrun{ # dplyr -------------------------------------------------------------------  library(dplyr, warn.conflicts = FALSE)  example_isolates %>% select(carbapenems())  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates %>% select(mo, aminoglycosides())  # you can combine selectors like you are used with tidyverse # e.g., for betalactams, but not the ones with an enzyme inhibitor: example_isolates %>% select(betalactams(), -betalactams_with_inhibitor())  # select only antimicrobials with DDDs for oral treatment example_isolates %>% select(administrable_per_os())  # get AMR for all aminoglycosides e.g., per ward: example_isolates %>%   group_by(ward) %>%   summarise(across(aminoglycosides(),                    resistance))  # You can combine selectors with '&' to be more specific: example_isolates %>%   select(penicillins() & administrable_per_os())  # get AMR for only drugs that matter - no intrinsic resistance: example_isolates %>%   filter(mo_genus() %in% c(\"Escherichia\", \"Klebsiella\")) %>%   group_by(ward) %>%   summarise_at(not_intrinsic_resistant(),                resistance)  # get susceptibility for antimicrobials whose name contains \"trim\": example_isolates %>%   filter(first_isolate()) %>%   group_by(ward) %>%   summarise(across(amr_selector(name %like% \"trim\"), susceptibility))  # this will select columns 'IPM' (imipenem) and 'MEM' (meropenem): example_isolates %>%   select(carbapenems())  # this will select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB': example_isolates %>%   select(mo, aminoglycosides())  # any() and all() work in dplyr's filter() too: example_isolates %>%   filter(     any(aminoglycosides() == \"R\"),     all(cephalosporins_2nd() == \"R\")   )  # also works with c(): example_isolates %>%   filter(any(c(carbapenems(), aminoglycosides()) == \"R\"))  # not setting any/all will automatically apply all(): example_isolates %>%   filter(aminoglycosides() == \"R\")  # this will select columns 'mo' and all antimycobacterial drugs ('RIF'): example_isolates %>%   select(mo, amr_class(\"mycobact\"))  # get bug/drug combinations for only glycopeptides in Gram-positives: example_isolates %>%   filter(mo_is_gram_positive()) %>%   select(mo, glycopeptides()) %>%   bug_drug_combinations() %>%   format()  data.frame(   some_column = \"some_value\",   J01CA01 = \"S\" ) %>% # ATC code of ampicillin   select(penicillins()) # only the 'J01CA01' column will be selected  # with recent versions of dplyr, this is all equal: x <- example_isolates[carbapenems() == \"R\", ] y <- example_isolates %>% filter(carbapenems() == \"R\") z <- example_isolates %>% filter(if_all(carbapenems(), ~ .x == \"R\")) identical(x, y) && identical(y, z)  } # } # base R ------------------------------------------------------------------  # select columns 'IPM' (imipenem) and 'MEM' (meropenem) example_isolates[, carbapenems()] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 2,000 × 2 #>    IPM   MEM   #>    <sir> <sir> #>  1   NA    NA  #>  2   NA    NA  #>  3   NA    NA  #>  4   NA    NA  #>  5   NA    NA  #>  6   NA    NA  #>  7   NA    NA  #>  8   NA    NA  #>  9   NA    NA  #> 10   NA    NA  #> # ℹ 1,990 more rows  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates[, c(\"mo\", aminoglycosides())] #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 2,000 × 5 #>    mo           GEN   TOB   AMK   KAN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   NA    NA    NA    NA  #>  2 B_ESCHR_COLI   NA    NA    NA    NA  #>  3 B_STPHY_EPDR   NA    NA    NA    NA  #>  4 B_STPHY_EPDR   NA    NA    NA    NA  #>  5 B_STPHY_EPDR   NA    NA    NA    NA  #>  6 B_STPHY_EPDR   NA    NA    NA    NA  #>  7 B_STPHY_AURS   NA    S     NA    NA  #>  8 B_STPHY_AURS   NA    S     NA    NA  #>  9 B_STPHY_EPDR   NA    NA    NA    NA  #> 10 B_STPHY_EPDR   NA    NA    NA    NA  #> # ℹ 1,990 more rows  # select only antimicrobials with DDDs for oral treatment example_isolates[, administrable_per_os()] #> ℹ For `administrable_per_os()` using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 23 #>    OXA   FLC   AMX   AMC   AMP   CXM   KAN   TMP   NIT   FOS   LNZ   CIP   MFX   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  2   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  3   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  4   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  5   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  6   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  7   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  8   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  9   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    S     NA  #> 10   NA    S     NA    NA    NA    S     NA    S     NA    NA    NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 10 more variables: VAN <sir>, TCY <sir>, DOX <sir>, ERY <sir>, CLI <sir>, #> #   AZM <sir>, MTR <sir>, CHL <sir>, COL <sir>, RIF <sir>  # filter using any() or all() example_isolates[any(carbapenems() == \"R\"), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … subset(example_isolates, any(carbapenems() == \"R\")) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter on any or all results in the carbapenem columns (i.e., IPM, MEM): example_isolates[any(carbapenems()), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering any of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 962 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  7 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  8 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  9 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #> 10 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #> # ℹ 952 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … example_isolates[all(carbapenems()), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering all of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 756 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-04-14 F30196     73 M      Outpat… B_STRPT_GRPB    S     NA    S     S   #>  2 2003-04-08 114570     74 M      ICU     B_STRPT_PYGN    S     NA    S     S   #>  3 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  4 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  5 2003-08-14 F71508      0 F      Clinic… B_STRPT_GRPB    S     NA    S     S   #>  6 2003-10-16 650870     63 F      ICU     B_ESCHR_COLI    R     NA    NA    R   #>  7 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  9 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> 10 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> # ℹ 746 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter with multiple antimicrobial selectors using c() example_isolates[all(c(carbapenems(), aminoglycosides()) == \"R\"), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 26 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  2 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  4 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  5 2008-12-06 501361     43 F      Clinical B_STNTR_MLTP   R     NA    NA    R   #>  6 2011-05-09 207325     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2012-03-12 582258     80 M      ICU      B_STPHY_CONS   R     R     R     R   #>  8 2012-05-19 C25552     89 F      Outpati… B_STPHY_CONS   R     R     R     R   #>  9 2012-07-17 F05015     83 M      ICU      B_STPHY_CONS   R     R     R     R   #> 10 2012-07-20 404299     66 F      Clinical B_STPHY_CONS   R     R     R     R   #> # ℹ 16 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter + select in one go: get penicillins in carbapenem-resistant strains example_isolates[any(carbapenems() == \"R\"), penicillins()] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `penicillins()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> # A tibble: 55 × 7 #>    PEN   OXA   FLC   AMX   AMC   AMP   TZP   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    NA    NA    NA    NA  #>  2   NA    NA    NA    NA    NA    NA    NA  #>  3   R     NA    NA    R     R     R     R   #>  4   NA    NA    NA    NA    NA    NA    R   #>  5   NA    NA    NA    NA    NA    NA    R   #>  6   NA    NA    NA    NA    NA    NA    R   #>  7   NA    NA    NA    NA    NA    NA    R   #>  8   NA    NA    NA    NA    NA    NA    R   #>  9   R     NA    NA    NA    S     NA    S   #> 10   R     NA    NA    NA    S     NA    S   #> # ℹ 45 more rows  # You can combine selectors with '&' to be more specific. For example, # penicillins() would select benzylpenicillin ('peni G') and # administrable_per_os() would select erythromycin. Yet, when combined these # drugs are both omitted since benzylpenicillin is not administrable per os # and erythromycin is not a penicillin: example_isolates[, penicillins() & administrable_per_os()] #> ℹ For `penicillins()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> ℹ For `administrable_per_os()` using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 5 #>    OXA   FLC   AMX   AMC   AMP   #>    <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA  #>  2   NA    NA    NA    I     NA  #>  3   NA    R     NA    NA    NA  #>  4   NA    R     NA    NA    NA  #>  5   NA    R     NA    NA    NA  #>  6   NA    R     NA    NA    NA  #>  7   NA    S     R     S     R   #>  8   NA    S     R     S     R   #>  9   NA    R     NA    NA    NA  #> 10   NA    S     NA    NA    NA  #> # ℹ 1,990 more rows  # amr_selector() applies a filter in the `antimicrobials` data set and is thus # very flexible. For instance, to select antimicrobials with an oral DDD # of at least 1 gram: example_isolates[, amr_selector(oral_ddd > 1 & oral_units == \"g\")] #> ℹ For `amr_selector(oral_ddd > 1 & oral_units == \"g\")` using columns 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'KAN' (kanamycin), 'FOS' #>   (fosfomycin), 'LNZ' (linezolid), 'VAN' (vancomycin), 'ERY' (erythromycin), #>   'CLI' (clindamycin), 'MTR' (metronidazole), and 'CHL' (chloramphenicol) #> # A tibble: 2,000 × 13 #>    OXA   FLC   AMX   AMC   AMP   KAN   FOS   LNZ   VAN   ERY   CLI   MTR   CHL   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  2   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  3   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  4   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  5   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  6   NA    R     NA    NA    NA    NA    NA    NA    S     R     R     NA    NA  #>  7   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  8   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  9   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #> 10   NA    S     NA    NA    NA    NA    NA    NA    S     S     NA    NA    NA  #> # ℹ 1,990 more rows   # data.table --------------------------------------------------------------  # data.table is supported as well, just use it in the same way as with # base R, but add `with = FALSE` if using a single AB selector.  if (require(\"data.table\")) {   dt <- as.data.table(example_isolates)    # this does not work, it returns column *names*   dt[, carbapenems()] } #> Loading required package: data.table #>  #> Attaching package: ‘data.table’ #> The following object is masked from ‘package:purrr’: #>  #>     transpose #> The following objects are masked from ‘package:dplyr’: #>  #>     between, first, last #> The following objects are masked from ‘package:AMR’: #>  #>     %like%, like #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: It should never be needed to print an antimicrobial selector class. Are you #> using data.table? Then add the argument `with = FALSE`, see our examples at #> `?amr_selector`. #> Class 'amr_selector' #> [1] IPM MEM if (require(\"data.table\")) {   # so `with = FALSE` is required   dt[, carbapenems(), with = FALSE] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>         IPM   MEM #>       <sir> <sir> #>    1:  <NA>  <NA> #>    2:  <NA>  <NA> #>    3:  <NA>  <NA> #>    4:  <NA>  <NA> #>    5:  <NA>  <NA> #>   ---             #> 1996:  <NA>  <NA> #> 1997:     S     S #> 1998:     S     S #> 1999:     S     S #> 2000:     S     S  # for multiple selections or AB selectors, `with = FALSE` is not needed: if (require(\"data.table\")) {   dt[, c(\"mo\", aminoglycosides())] } #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>                 mo   GEN   TOB   AMK   KAN #>               <mo> <sir> <sir> <sir> <sir> #>    1: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    2: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    3: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    4: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    5: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>   ---                                      #> 1996: B_STRPT_PNMN     R     R     R     R #> 1997: B_ESCHR_COLI     S     S     S  <NA> #> 1998: B_STPHY_CONS     S  <NA>  <NA>  <NA> #> 1999: B_ESCHR_COLI     S     S  <NA>  <NA> #> 2000: B_KLBSL_PNMN     S     S  <NA>  <NA> if (require(\"data.table\")) {   dt[, c(carbapenems(), aminoglycosides())] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>         IPM   MEM   GEN   TOB   AMK   KAN #>       <sir> <sir> <sir> <sir> <sir> <sir> #>    1:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    2:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    3:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    4:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    5:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>   ---                                     #> 1996:  <NA>  <NA>     R     R     R     R #> 1997:     S     S     S     S     S  <NA> #> 1998:     S     S     S  <NA>  <NA>  <NA> #> 1999:     S     S     S     S  <NA>  <NA> #> 2000:     S     S     S     S  <NA>  <NA>  # row filters are also supported: if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), ] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>            date patient   age gender       ward           mo   PEN   OXA   FLC #>          <Date>  <char> <num> <char>     <char>         <mo> <sir> <sir> <sir> #>   1: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   2: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   3: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   4: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   5: 2002-02-05  067927    45      F        ICU B_SERRT_MRCS     R  <NA>  <NA> #>  ---                                                                           #> 905: 2005-04-12  D71461    70      M        ICU B_ESCHR_COLI     R  <NA>  <NA> #> 906: 2009-11-12  650870    69      F Outpatient B_ESCHR_COLI     R  <NA>  <NA> #> 907: 2012-06-14  8CBCF2    41      F   Clinical B_STPHY_CONS     R     S     S #> 908: 2012-10-11  175532    78      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #> 909: 2013-11-23  A97263    77      M   Clinical B_KLBSL_PNMN     R  <NA>  <NA> #>        AMX   AMC   AMP   TZP   CZO   FEP   CXM   FOX   CTX   CAZ   CRO   GEN #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   2:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   3:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   4:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   5:     R     R     R  <NA>     R  <NA>     R     R  <NA>  <NA>  <NA>  <NA> #>  ---                                                                         #> 905:     S     S     S     S  <NA>     S     S     S     S     S     S     S #> 906:     S     S     S     S     S     S     S     S     S     S     S     S #> 907:  <NA>     S  <NA>  <NA>     S     S     S     S     S     R     S     S #> 908:     R     S     R     S  <NA>     S     R     R     S     S     S     S #> 909:     R     S     R     S  <NA>     S     S     S     S     S     S     S #>        TOB   AMK   KAN   TMP   SXT   NIT   FOS   LNZ   CIP   MFX   VAN   TEC #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   2:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   3:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   4:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   5:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>  ---                                                                         #> 905:     S     S  <NA>  <NA>     S     S  <NA>     R     S  <NA>     R     R #> 906:     S     S  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #> 907:  <NA>  <NA>  <NA>     S     S  <NA>  <NA>  <NA>     S  <NA>     S  <NA> #> 908:     S  <NA>  <NA>     R     R     R  <NA>     R     R     R     R     R #> 909:     S  <NA>  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #>        TCY   TGC   DOX   ERY   CLI   AZM   IPM   MEM   MTR   CHL   COL   MUP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   2:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   3:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   4:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   5:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>  ---                                                                         #> 905:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 906:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 907:  <NA>  <NA>  <NA>     S     S     S     S     S  <NA>  <NA>     R  <NA> #> 908:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #> 909:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #>        RIF #>      <sir> #>   1:     R #>   2:     R #>   3:     R #>   4:     R #>   5:     R #>  ---       #> 905:     R #> 906:     R #> 907:  <NA> #> 908:     R #> 909:     R if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), penicillins(), with = FALSE] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `penicillins()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #>        PEN   OXA   FLC   AMX   AMC   AMP   TZP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   2:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   3:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   4:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   5:     R  <NA>  <NA>     R     R     R  <NA> #>  ---                                           #> 905:     R  <NA>  <NA>     S     S     S     S #> 906:     R  <NA>  <NA>     S     S     S     S #> 907:     R     S     S  <NA>     S  <NA>  <NA> #> 908:     R  <NA>  <NA>     R     S     R     S #> 909:     R  <NA>  <NA>     R     S     R     S # }"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Two data sets containing antimicrobials antivirals. Use .ab() one ab_* functions retrieve values antimicrobials data set. Three identifiers included data set: antimicrobial ID (ab, primarily used package) defined WHONET/EARS-Net, ATC code (atc) defined , Compound ID (cid) found PubChem. properties data set derived one codes. Note drugs multiple ATC codes. antibiotics data set renamed antimicrobials. old name removed future version.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials  antibiotics  antivirals"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"object class deprecated_amr_dataset (inherits tbl_df, tbl, data.frame) 497 rows 14 columns. object class tbl_df (inherits tbl, data.frame) 120 rows 11 columns.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antimicrobials-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antimicrobials data set: a tibble with 497 observations and 14 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"ab antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. cid Compound ID found PubChem. unique identifier. name Official name used WHONET/EARS-Net . unique identifier. group short concise group name, based WHONET WHOCC definitions atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, like J01CR02 (last updated May 4th, 2025): atc_group1 Official pharmacological subgroup (3rd level ATC code) defined WHOCC, like \"Macrolides, lincosamides streptogramins\" atc_group2 Official chemical subgroup (4th level ATC code) defined WHOCC, like \"Macrolides\" abbr List abbreviations used many countries, also antimicrobial susceptibility testing (AST) synonyms Synonyms (often trade names) drug, found PubChem based compound ID ATC properties (last updated May 4th, 2025): oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 180 drugs oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral (intravenous) treatment, currently available 153 drugs iv_units Units iv_ddd LOINC: loinc codes associated name antimicrobial drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use ab_loinc() retrieve quickly, see ab_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antivirals-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antivirals data set: a tibble with 120 observations and 11 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"av Antiviral ID used package (ACI), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. Combinations codes contain + indicate , ATA+COBI atazanavir/cobicistat. name Official name used WHONET/EARS-Net . unique identifier. atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, see Details cid Compound ID found PubChem. unique identifier. atc_group Official pharmacological subgroup (3rd level ATC code) defined WHOCC synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral treatment iv_units Units iv_ddd loinc codes associated name antiviral drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use av_loinc() retrieve quickly, see av_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Collaborating Centre Drug Statistics Methodology, Guidelines ATC classification DDD assignment, Oslo Accessed https://atcddd.fhi./atc_ddd_index/ May 4th, 2025. Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Accessed https://loinc.org October 19th, 2023. European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. note ATC codes unique. example, J01CR02 officially ATC code \"amoxicillin beta-lactamase inhibitor\". Consequently, two items antimicrobials data set return \"J01CR02\":   Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":"ab_atc(\"amoxicillin/clavulanic acid\") ab_atc(\"amoxicillin/sulbactam\")"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials #> # A tibble: 497 × 14 #>    ab        cid name   group atc   atc_group1 atc_group2 abbreviations synonyms #>    <ab>    <dbl> <chr>  <chr> <lis> <chr>      <chr>      <list>        <named > #>  1 AMA      4649 4-ami… Anti… <chr> Drugs for… Aminosali… <chr [1]>     <chr>    #>  2 ACM   6450012 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  3 ASP  49787020 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  4 ALS      8954 Aldes… Othe… <chr> Drugs for… Drugs for… <chr [1]>     <chr>    #>  5 AMK     37768 Amika… Amin… <chr> Aminoglyc… Other ami… <chr [6]>     <chr>    #>  6 AKF        NA Amika… Amin… <chr> NA         NA         <chr [1]>     <chr>    #>  7 AMO     54260 Amoro… Anti… <chr> Antifunga… Other ant… <chr [1]>     <chr>    #>  8 AMX     33613 Amoxi… Beta… <chr> Beta-lact… Penicilli… <chr [4]>     <chr>    #>  9 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [6]>     <chr>    #> 10 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> # ℹ 487 more rows #> # ℹ 5 more variables: oral_ddd <dbl>, oral_units <chr>, iv_ddd <dbl>, #> #   iv_units <chr>, loinc <list> antivirals #> # A tibble: 120 × 11 #>    av       name      atc      cid atc_group synonyms oral_ddd oral_units iv_ddd #>    <av>     <chr>     <chr>  <dbl> <chr>     <list>      <dbl> <chr>       <dbl> #>  1 ABA      Abacavir  J05A… 4.41e5 Nucleosi… <chr>         0.6 g              NA #>  2 ACI      Aciclovir J05A… 1.35e8 Nucleosi… <chr>         4   g               4 #>  3 ADD      Adefovir… J05A… 6.09e4 Nucleosi… <chr>        10   mg             NA #>  4 AME      Amenamev… J05A… 1.14e7 Other an… <chr>         0.4 g              NA #>  5 AMP      Amprenav… J05A… 6.50e4 Protease… <chr>         1.2 g              NA #>  6 ASU      Asunapre… J05A… 1.61e7 Antivira… <chr>         0.2 g              NA #>  7 ATA      Atazanav… J05A… 1.48e5 Protease… <chr>         0.3 g              NA #>  8 ATA+COBI Atazanav… J05A… 8.66e7 Antivira… <chr>        NA   NA             NA #>  9 ATA+RIT  Atazanav… J05A… 2.51e7 Antivira… <chr>         0.3 g              NA #> 10 BAM      Baloxavi… J05A… 1.24e8 Other an… <chr>        40   mg             NA #> # ℹ 110 more rows #> # ℹ 2 more variables: iv_units <chr>, loinc <list>"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antibiotic ID — as.ab","title":"Transform Input to an Antibiotic ID — as.ab","text":"Use function determine antimicrobial drug code one antimicrobials. data set antimicrobials searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"as.ab(x, flag_multiple_results = TRUE, language = get_AMR_locale(),   info = interactive(), ...)  is.ab(x)  ab_reset_session()"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antibiotic ID — as.ab","text":"x character vector determine antibiotic ID. flag_multiple_results logical indicate whether note printed console probably one antibiotic drug code name can retrieved single input value. language Language coerce input values 28 supported languages - default system language supported (see get_AMR_locale()). info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antibiotic ID — as.ab","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antibiotic ID — as.ab","text":"entries antimicrobials data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .ab() can correct different forms misspelling: Wrong spelling drug names (\"tobramicin\" \"gentamycin\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"mreopenem\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use ab_* functions get properties based returned antibiotic ID, see Examples. Note: .ab() ab_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems. can add manual codes considered .ab() ab_* functions, see add_custom_antimicrobials().","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antibiotic ID — as.ab","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antibiotic ID — as.ab","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antibiotic ID — as.ab","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"# these examples all return \"ERY\", the ID of erythromycin: as.ab(\"J01FA01\") #> Class 'ab' #> [1] ERY as.ab(\"J 01 FA 01\") #> Class 'ab' #> [1] ERY as.ab(\"Erythromycin\") #> Class 'ab' #> [1] ERY as.ab(\"eryt\") #> Class 'ab' #> [1] ERY as.ab(\"ERYT\") #> Class 'ab' #> [1] ERY as.ab(\"ERY\") #> Class 'ab' #> [1] ERY as.ab(\"eritromicine\") # spelled wrong, yet works #> Class 'ab' #> [1] ERY as.ab(\"Erythrocin\") # trade name #> Class 'ab' #> [1] ERY  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  \"QJ01DD04\"  # use ab_* functions to get a specific properties (see ?ab_property); # they use as.ab() internally: ab_name(\"J01FA01\") #> [1] \"Erythromycin\" ab_name(\"eryt\") #> [1] \"Erythromycin\"  # \\donttest{ if (require(\"dplyr\")) {   # you can quickly rename 'sir' columns using set_ab_names() with dplyr:   example_isolates %>%     set_ab_names(where(is.sir), property = \"atc\") } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           J01CE01 J01CF04 J01CF05 #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir>   <sir>   <sir>   #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R       NA      S     #> # ℹ 1,990 more rows #> # ℹ 37 more variables: J01CA04 <sir>, J01CR02 <sir>, J01CA01 <sir>, #> #   J01CR05 <sir>, J01DB04 <sir>, J01DE01 <sir>, J01DC02 <sir>, J01DC01 <sir>, #> #   J01DD01 <sir>, J01DD02 <sir>, J01DD04 <sir>, J01GB03 <sir>, J01GB01 <sir>, #> #   J01GB06 <sir>, J01GB04 <sir>, J01EA01 <sir>, J01EE01 <sir>, J01XE01 <sir>, #> #   J01XX01 <sir>, J01XX08 <sir>, J01MA02 <sir>, J01MA14 <sir>, J01XA01 <sir>, #> #   J01XA02 <sir>, J01AA07 <sir>, J01AA12 <sir>, J01AA02 <sir>, … # }"},{"path":"https://amr-for-r.org/reference/as.av.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antiviral Drug ID — as.av","title":"Transform Input to an Antiviral Drug ID — as.av","text":"Use function determine antiviral drug code one antiviral drugs. data set antivirals searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"as.av(x, flag_multiple_results = TRUE, info = interactive(), ...)  is.av(x)"},{"path":"https://amr-for-r.org/reference/as.av.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antiviral Drug ID — as.av","text":"x character vector determine antiviral drug ID. flag_multiple_results logical indicate whether note printed console probably one antiviral drug code name can retrieved single input value. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antiviral Drug ID — as.av","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antiviral Drug ID — as.av","text":"entries antivirals data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .av() can correct different forms misspelling: Wrong spelling drug names (\"acyclovir\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"aycclovir\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use av_* functions get properties based returned antiviral drug ID, see Examples. Note: .av() av_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antiviral Drug ID — as.av","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antiviral Drug ID — as.av","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antiviral Drug ID — as.av","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"# these examples all return \"ACI\", the ID of aciclovir: as.av(\"J05AB01\") #> Class 'av' #> [1] ACI as.av(\"J 05 AB 01\") #> Class 'av' #> [1] ACI as.av(\"Aciclovir\") #> Class 'av' #> [1] ACI as.av(\"aciclo\") #> Class 'av' #> [1] ACI as.av(\"   aciclo 123\") #> Class 'av' #> [1] ACI as.av(\"ACICL\") #> Class 'av' #> [1] ACI as.av(\"ACI\") #> Class 'av' #> [1] ACI as.av(\"Virorax\") # trade name #> Class 'av' #> [1] ACI as.av(\"Zovirax\") # trade name #> Class 'av' #> [1] ACI  as.av(\"acyklofir\") # severe spelling error, yet works #> Class 'av' #> [1] ACI  # use av_* functions to get a specific properties (see ?av_property); # they use as.av() internally: av_name(\"J05AB01\") #> [1] \"Aciclovir\" av_name(\"acicl\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Disk Diffusion Diameters — as.disk","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"transforms vector new class disk, disk diffusion growth zone size (around antibiotic disk) millimetres 0 50.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"as.disk(x, na.rm = FALSE)  NA_disk_  is.disk(x)"},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"object class disk (inherits integer) length 1.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"x Vector. na.rm logical indicating whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"integer additional class disk","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"Interpret disk values SIR values .sir(). supports guidelines EUCAST CLSI. Disk diffusion growth zone sizes must 0 50 millimetres. Values higher 50 lower 100 maximised 50. others input values outside 0-50 range return NA. NA_disk_ missing value new disk class.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"# transform existing disk zones to the `disk` class (using base R) df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = 20,   CIP = 14,   GEN = 18,   TOB = 16 ) df[, 2:5] <- lapply(df[, 2:5], as.disk) str(df) #> 'data.frame':\t1 obs. of  5 variables: #>  $ microorganism: chr \"Escherichia coli\" #>  $ AMP          : 'disk' int 20 #>  $ CIP          : 'disk' int 14 #>  $ GEN          : 'disk' int 18 #>  $ TOB          : 'disk' int 16  # \\donttest{ # transforming is easier with dplyr: if (require(\"dplyr\")) {   df %>% mutate(across(AMP:TOB, as.disk)) } #>      microorganism AMP CIP GEN TOB #> 1 Escherichia coli  20  14  18  16 # }  # interpret disk values, see ?as.sir as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R  # interpret whole data set, pretend to be all from urinary tract infections: as.sir(df, uti = TRUE) #>      microorganism AMP  CIP GEN TOB #> 1 Escherichia coli   S <NA>   S   S"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"transforms vectors new class mic, treats input decimal numbers, maintaining operators (\">=\") allowing valid MIC values known field (medical) microbiology.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"as.mic(x, na.rm = FALSE, keep_operators = \"all\")  is.mic(x)  NA_mic_  rescale_mic(x, mic_range, keep_operators = \"edges\", as.mic = TRUE)  mic_p50(x, na.rm = FALSE, ...)  mic_p90(x, na.rm = FALSE, ...)  # S3 method for class 'mic' droplevels(x, as.mic = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"x character numeric vector. na.rm logical indicating whether missing values removed. keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values, e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). .mic logical indicate whether mic class kept - default TRUE rescale_mic() FALSE droplevels(). setting FALSE rescale_mic(), output factor levels acknowledge mic_range. ... Arguments passed methods.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"Ordered factor additional class mic, mathematical operations acts numeric vector. Bear mind outcome mathematical operation MICs return numeric value.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"interpret MIC values SIR values, use .sir() MIC values. supports guidelines EUCAST (2011-2025) CLSI (2011-2025). class MIC values quite special data type: formally ordered factor valid MIC values factor levels (make sure valid MIC values retained), mathematical operation acts decimal numbers:   makes possible maintain operators often come MIC values, \">=\" \"<=\", even filtering using numeric values data analysis, e.g.:   -called group generic functions implemented MIC class (!, !=, <, >=, exp(), log2()). mathematical functions also implemented (quantile(), median(), fivenum()). Since sd() var() non-generic functions, extended. Use mad() alternative, use e.g. sd(.numeric(x)) x vector MIC values. Using .double() .numeric() MIC values remove operators return numeric vector. use .integer() MIC values R convention factors, return index factor levels (often useless regular users). function .mic() detects input contains class mic. input data.frame list, iterates columns/items returns logical vector. Use droplevels() drop unused levels. default, return plain factor. Use droplevels(..., .mic = TRUE) maintain mic class. rescale_mic(), existing MIC ranges can limited defined range MIC values. can useful better compare MIC distributions. ggplot2, use one scale_*_mic() functions plot MIC values. allows custom MIC ranges plot intermediate log2 levels missing MIC values. NA_mic_ missing value new mic class, analogous e.g. base R's NA_character_. Use mic_p50() mic_p90() get 50th 90th percentile MIC values. return 'normal' numeric values.","code":"x <- random_mic(10) x #> Class 'mic' #>  [1] 16     1      8      8      64     >=128  0.0625 32     32     16  is.factor(x) #> [1] TRUE  x[1] * 2 #> [1] 32  median(x) #> [1] 26 x[x > 4] #> Class 'mic' #> [1] 16    8     8     64    >=128 32    32    16  df <- data.frame(x, hospital = \"A\") subset(df, x > 4) # or with dplyr: df %>% filter(x > 4) #>        x hospital #> 1     16        A #> 5     64        A #> 6  >=128        A #> 8     32        A #> 9     32        A #> 10    16        A"},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"mic_data <- as.mic(c(\">=32\", \"1.0\", \"1\", \"1.00\", 8, \"<=0.128\", \"8\", \"16\", \"16\")) mic_data #> Class 'mic' #> [1] >=32    1       1       1       8       <=0.128 8       16      16      is.mic(mic_data) #> [1] TRUE  # this can also coerce combined MIC/SIR values: as.mic(\"<=0.002; S\") #> Class 'mic' #> [1] <=0.002  # mathematical processing treats MICs as numeric values fivenum(mic_data) #> [1]  0.128  1.000  8.000 16.000 32.000 quantile(mic_data) #>     0%    25%    50%    75%   100%  #>  0.128  1.000  8.000 16.000 32.000  all(mic_data < 512) #> [1] TRUE  # rescale MICs using rescale_mic() rescale_mic(mic_data, mic_range = c(4, 16)) #> Class 'mic' #> [1] >=16 <=4  <=4  <=4  8    <=4  8    >=16 >=16  # interpret MIC values as.sir(   x = as.mic(2),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R as.sir(   x = as.mic(c(0.01, 2, 4, 8)),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] S R R R  # plot MIC values, see ?plot plot(mic_data)  plot(mic_data, mo = \"E. coli\", ab = \"cipro\")  #> Error in if (any(cols_sub$cols == colours_SIR[3] & cols_sub$count > 0)) {    legend_txt <- c(legend_txt, paste(\"(I)\", plot_name_of_I(cols_sub$guideline)))    legend_col <- c(legend_col, colours_SIR[3])}: missing value where TRUE/FALSE needed  if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\") }  if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\", language = \"nl\") # Dutch }"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Use function get valid microorganism code (mo) based arbitrary user input. Determination done using intelligent rules complete taxonomic tree kingdoms Animalia, Archaea, Bacteria, Chromista, Protozoa, microbial species kingdom Fungi (see Source). input can almost anything: full name (like \"Staphylococcus aureus\"), abbreviated name (\"S. aureus\"), abbreviation known field (\"MRSA\"), just genus. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"as.mo(x, Becker = FALSE, Lancefield = FALSE,   minimum_matching_score = NULL,   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE),   reference_df = get_mo_source(),   ignore_pattern = getOption(\"AMR_ignore_pattern\", NULL),   cleaning_regex = getOption(\"AMR_cleaning_regex\", mo_cleaning_regex()),   only_fungi = getOption(\"AMR_only_fungi\", FALSE),   language = get_AMR_locale(), info = interactive(), ...)  is.mo(x)  mo_uncertainties()  mo_renamed()  mo_failures()  mo_reset_session()  mo_cleaning_regex()"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"x character vector data.frame one two columns. Becker logical indicate whether staphylococci categorised coagulase-negative staphylococci (\"CoNS\") coagulase-positive staphylococci (\"CoPS\") instead species, according Karsten Becker et al. (see Source). Please see Details full list staphylococcal species converted. excludes Staphylococcus aureus default, use Becker = \"\" also categorise S. aureus \"CoPS\". Lancefield logical indicate whether beta-haemolytic Streptococcus categorised Lancefield groups instead species, according Rebecca C. Lancefield (see Source). streptococci categorised first group, e.g. Streptococcus dysgalactiae group C, although officially also categorised groups G L. . Please see Details full list streptococcal species converted. excludes enterococci default (group D), use Lancefield = \"\" also categorise enterococci group D. minimum_matching_score numeric value set lower limit MO matching score. left blank, determined automatically based character length x, taxonomic kingdom human pathogenicity. keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). reference_df data.frame used extra reference translating x valid mo. See set_mo_source() get_mo_source() automate usage codes (e.g. used analysis organisation). ignore_pattern Perl-compatible regular expression (case-insensitive) matches x must return NA. can convenient exclude known non-relevant input can also set package option AMR_ignore_pattern, e.g. options(AMR_ignore_pattern = \"(reported|contaminated flora)\"). cleaning_regex Perl-compatible regular expression (case-insensitive) clean input x. Every matched part x removed. default, outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". default can set package option AMR_cleaning_regex. only_fungi logical indicate fungi must found, making sure e.g. misspellings always return records kingdom Fungi. can set globally microorganism functions package option AMR_only_fungi, .e. options(AMR_only_fungi = TRUE). language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). info logical indicate info must printed, e.g. progress bar 25 items coerced, list old taxonomic names. default TRUE interactive mode. ... arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"character vector additional class mo","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"microorganism (MO) code package (class: mo) human-readable typically looks like examples:   Values coerced considered 'unknown' return MO code UNKNOWN warning. Use mo_* functions get properties based returned code, see Examples. .mo() function uses novel scientifically validated (doi:10.18637/jss.v104.i03 ) matching score algorithm (see Matching Score Microorganisms ) match input available microbial taxonomy package. implicates e.g. \"E. coli\" (microorganism highly prevalent humans) return microbial ID Escherichia coli Entamoeba coli (microorganism less prevalent humans), although latter alphabetically come first.","code":"Code               Full name   ---------------    --------------------------------------   B_KLBSL            Klebsiella   B_KLBSL_PNMN       Klebsiella pneumoniae   B_KLBSL_PNMN_RHNS  Klebsiella pneumoniae rhinoscleromatis   |   |    |    |   |   |    |    |   |   |    |    \\---> subspecies, a 3-5 letter acronym   |   |    \\----> species, a 3-6 letter acronym   |   \\----> genus, a 4-8 letter acronym   \\----> kingdom: A (Archaea), AN (Animalia), B (Bacteria),                   C (Chromista), F (Fungi), PL (Plantae),                   P (Protozoa)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coping-with-uncertain-results","dir":"Reference","previous_headings":"","what":"Coping with Uncertain Results","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Results non-exact taxonomic input based matching score. lowest allowed score can set minimum_matching_score argument. default determined based character length input, taxonomic kingdom, human pathogenicity taxonomic outcome. values matched uncertainty, message shown suggest user inspect results mo_uncertainties(), returns data.frame specifications. increase quality matching, cleaning_regex argument used clean input. must regular expression matches parts input removed input matched available microbial taxonomy. matched Perl-compatible case-insensitive. default value cleaning_regex outcome helper function mo_cleaning_regex(). three helper functions can run using .mo() function: Use mo_uncertainties() get data.frame prints pretty format taxonomic names guessed. output contains matching score matches (see Matching Score Microorganisms ). Use mo_failures() get character vector values coerced valid value. Use mo_renamed() get data.frame values coerced based old, previously accepted taxonomic names.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"for-mycologists","dir":"Reference","previous_headings":"","what":"For Mycologists","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"matching score algorithm gives precedence bacteria fungi. analysing fungi, sure use only_fungi = TRUE, better yet, add code run every session:   make sure bacteria 'non-fungi' returned .mo(), mo_* functions.","code":"options(AMR_only_fungi = TRUE)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coagulase-negative-and-coagulase-positive-staphylococci","dir":"Reference","previous_headings":"","what":"Coagulase-negative and Coagulase-positive Staphylococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Becker = TRUE, following staphylococci converted corresponding coagulase group: Coagulase-negative: S. americanisciuri, S. argensis, S. arlettae, S. auricularis, S. borealis, S. brunensis, S. caeli, S. caledonicus, S. canis, S. capitis, S. capitis capitis, S. capitis urealyticus, S. capitis ureolyticus, S. caprae, S. carnosus, S. carnosus carnosus, S. carnosus utilis, S. casei, S. caseolyticus, S. chromogenes, S. cohnii, S. cohnii cohnii, S. cohnii urealyticum, S. cohnii urealyticus, S. condimenti, S. croceilyticus, S. debuckii, S. devriesei, S. durrellii, S. edaphicus, S. epidermidis, S. equorum, S. equorum equorum, S. equorum linens, S. felis, S. fleurettii, S. gallinarum, S. haemolyticus, S. hominis, S. hominis hominis, S. hominis novobiosepticus, S. jettensis, S. kloosii, S. lentus, S. lloydii, S. lugdunensis, S. marylandisciuri, S. massiliensis, S. microti, S. muscae, S. nepalensis, S. pasteuri, S. petrasii, S. petrasii croceilyticus, S. petrasii jettensis, S. petrasii petrasii, S. petrasii pragensis, S. pettenkoferi, S. piscifermentans, S. pragensis, S. pseudoxylosus, S. pulvereri, S. ratti, S. rostri, S. saccharolyticus, S. saprophyticus, S. saprophyticus bovis, S. saprophyticus saprophyticus, S. schleiferi, S. schleiferi schleiferi, S. sciuri, S. sciuri carnaticus, S. sciuri lentus, S. sciuri rodentium, S. sciuri sciuri, S. shinii, S. simulans, S. stepanovicii, S. succinus, S. succinus casei, S. succinus succinus, S. taiwanensis, S. urealyticus, S. ureilyticus, S. veratri, S. vitulinus, S. vitulus, S. warneri, S. xylosus Coagulase-positive: S. agnetis, S. argenteus, S. coagulans, S. cornubiensis, S. delphini, S. hyicus, S. hyicus chromogenes, S. hyicus hyicus, S. intermedius, S. lutrae, S. pseudintermedius, S. roterodami, S. schleiferi coagulans, S. schweitzeri, S. simiae, S. singaporensis based : Becker K et al. (2014). Coagulase-Negative Staphylococci. Clin Microbiol Rev. 27(4): 870-926; doi:10.1128/CMR.00109-13 Becker K et al. (2019). Implications identifying recently defined members S. aureus complex, S. argenteus S. schweitzeri: position paper members ESCMID Study Group staphylococci Staphylococcal Diseases (ESGS). Clin Microbiol Infect; doi:10.1016/j.cmi.2019.02.028 Becker K et al. (2020). Emergence coagulase-negative staphylococci. Expert Rev Anti Infect Ther. 18(4):349-366; doi:10.1080/14787210.2020.1730813 newly named staphylococcal species, S. brunensis (2024) S. shinii (2023), looked scientific reference make sure species considered correct coagulase group.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"lancefield-groups-in-streptococci","dir":"Reference","previous_headings":"","what":"Lancefield Groups in Streptococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Lancefield = TRUE, following streptococci converted corresponding Lancefield group: Streptococcus Group : S. pyogenes Streptococcus Group B: S. agalactiae Streptococcus Group C: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis, S. equi, S. equi equi, S. equi ruminatorum, S. equi zooepidemicus Streptococcus Group F: S. anginosus, S. anginosus anginosus, S. anginosus whileyi, S. constellatus, S. constellatus constellatus, S. constellatus pharyngis, S. constellatus viborgensis, S. intermedius Streptococcus Group G: S. canis, S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis Streptococcus Group H: S. sanguinis Streptococcus Group K: S. salivarius, S. salivarius salivarius, S. salivarius thermophilus Streptococcus Group L: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis based : Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"# \\donttest{ # These examples all return \"B_STPHY_AURS\", the ID of S. aureus: as.mo(c(   \"sau\", # WHONET code   \"stau\",   \"STAU\",   \"staaur\",   \"S. aureus\",   \"S aureus\",   \"Sthafilokkockus aureus\", # handles incorrect spelling   \"Staphylococcus aureus (MRSA)\",   \"MRSA\", # Methicillin Resistant S. aureus   \"VISA\", # Vancomycin Intermediate S. aureus   \"VRSA\", # Vancomycin Resistant S. aureus   115329001 # SNOMED CT code )) #> Class 'mo' #>  [1] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #>  [6] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #> [11] B_STPHY_AURS B_STPHY_AURS  # Dyslexia is no problem - these all work: as.mo(c(   \"Ureaplasma urealyticum\",   \"Ureaplasma urealyticus\",   \"Ureaplasmium urealytica\",   \"Ureaplazma urealitycium\" )) #> Class 'mo' #> [1] B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY  # input will get cleaned up with the input given in the `cleaning_regex` argument, # which defaults to `mo_cleaning_regex()`: cat(mo_cleaning_regex(), \"\\n\") #> ([^A-Za-z- \\(\\)\\[\\]{}]+|([({]|\\[).+([})]|\\])|(^| )( ?[a-z-]+[-](resistant|susceptible) ?|e?spp([^a-z]+|$)|e?ssp([^a-z]+|$)|serogr.?up[a-z]*|e?ss([^a-z]+|$)|e?sp([^a-z]+|$)|var([^a-z]+|$)|serovar[a-z]*|sube?species|biovar[a-z]*|e?species|Ig[ADEGM]|e?subsp|biotype|titer|dummy))   as.mo(\"Streptococcus group A\") #> Class 'mo' #> [1] B_STRPT_GRPA  as.mo(\"S. epidermidis\") # will remain species: B_STPHY_EPDR #> Class 'mo' #> [1] B_STPHY_EPDR as.mo(\"S. epidermidis\", Becker = TRUE) # will not remain species: B_STPHY_CONS #> Class 'mo' #> [1] B_STPHY_CONS  as.mo(\"S. pyogenes\") # will remain species: B_STRPT_PYGN #> Class 'mo' #> [1] B_STRPT_PYGN as.mo(\"S. pyogenes\", Lancefield = TRUE) # will not remain species: B_STRPT_GRPA #> Class 'mo' #> [1] B_STRPT_GRPA  # All mo_* functions use as.mo() internally too (see ?mo_property): mo_genus(\"E. coli\") #> [1] \"Escherichia\" mo_gramstain(\"ESCO\") #> [1] \"Gram-negative\" mo_is_intrinsic_resistant(\"ESCCOL\", ab = \"vanco\") #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant #>   Phenotypes' v1.2 (2023). This note will be shown once per session. #> [1] TRUE # }"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":null,"dir":"Reference","previous_headings":"","what":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Clean existing SIR values, interpret minimum inhibitory concentration (MIC) values disk diffusion diameters according EUCAST CLSI. .sir() transforms input new class sir, ordered factor containing levels S, SDD, , R, NI. Breakpoints currently implemented EUCAST 2011-2025 CLSI 2011-2025, see Details. breakpoints used interpretation available clinical_breakpoints data set.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"as.sir(x, ...)  NA_sir_  is.sir(x)  is_sir_eligible(x, threshold = 0.05)  # Default S3 method as.sir(x, S = \"^(S|U)+$\", I = \"^(I)+$\", R = \"^(R)+$\",   NI = \"^(N|NI|V)+$\", SDD = \"^(SDD|D|H)+$\", info = interactive(), ...)  # S3 method for class 'mic' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   language = get_AMR_locale(), verbose = FALSE, info = interactive(),   conserve_capped_values = NULL, ...)  # S3 method for class 'disk' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   language = get_AMR_locale(), verbose = FALSE, info = interactive(),   ...)  # S3 method for class 'data.frame' as.sir(x, ..., col_mo = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   language = get_AMR_locale(), verbose = FALSE, info = interactive(),   parallel = FALSE, max_cores = -1, conserve_capped_values = NULL)  sir_interpretation_history(clean = FALSE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpretations minimum inhibitory concentration (MIC) values disk diffusion diameters: CLSI M39: Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. CLSI M100: Performance Standard Antimicrobial Susceptibility Testing, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m100/. CLSI VET01: Performance Standards Antimicrobial Disk Dilution Susceptibility Tests Bacteria Isolated Animals, 2019-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/veterinary-medicine/documents/vet01/. EUCAST Breakpoint tables interpretation MICs zone diameters, 2011-2025, European Committee Antimicrobial Susceptibility Testing (EUCAST). https://www.eucast.org/clinical_breakpoints. WHONET source machine-reading clinical breakpoints (read ), 1989-2025, Collaborating Centre Surveillance Antimicrobial Resistance. https://whonet.org/.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"x Vector values (class mic: MIC values mg/L, class disk: disk diffusion radius millimetres). ... using data.frame: selection columns apply .sir() . Supports tidyselect language (.mic), starts_with(...), column1:column4, can thus also antimicrobial selectors .sir(df, penicillins()). Otherwise: arguments passed methods. threshold Maximum fraction invalid antimicrobial interpretations x, see Examples. S, , R, NI, SDD case-independent regular expression translate input result. regular expression run non-letters whitespaces removed input. info logical print information process, defaults TRUE interactive sessions. mo vector (column name) characters can coerced valid microorganism codes .mo(), can left empty determine automatically. ab vector (column name) characters can coerced valid antimicrobial drug code .ab(). guideline guideline name (column name) use SIR interpretation. Defaults EUCAST 2025 (latest implemented EUCAST guideline clinical_breakpoints data set), can set package option AMR_guideline. Currently supports EUCAST (2011-2025) CLSI (2011-2025), see Details. Using column name allows straightforward interpretation historical data, must analysed context , example, different years. uti (Urinary Tract Infection) vector (column name) logicals (TRUE FALSE) specify whether UTI specific interpretation guideline chosen. using .sir() data.frame, can also column containing logicals left blank, data set searched column 'specimen', rows within column containing 'urin' ('urine', 'urina') regarded isolates UTI. See Examples. capped_mic_handling character string controls MIC values cap (.e., starting <, <=, >, >=) interpreted. Supports following options: \"none\" <= >= treated -. < > treated -. \"conservative\" <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < always returns \"S\", > always returns \"R\". \"standard\" (default) <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < > treated -. \"inverse\" <= >= treated -. < always returns \"S\", > always returns \"R\". default \"standard\" setting ensures cautious handling uncertain values preserving interpretability. option can also set package option AMR_capped_mic_handling. add_intrinsic_resistance (useful using EUCAST guideline) logical indicate whether intrinsic antibiotic resistance must also considered applicable bug-drug combinations, meaning e.g. ampicillin always return \"R\" Klebsiella species. Determination based intrinsic_resistant data set, based 'EUCAST Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021). reference_data data.frame used interpretation, defaults clinical_breakpoints data set. Changing argument allows using interpretation guidelines. argument must contain data set equal structure clinical_breakpoints data set (column names column types). Please note guideline argument ignored reference_data manually set. substitute_missing_r_breakpoint logical indicate missing clinical breakpoints R (resistant) must substituted R - default FALSE. (especially CLSI) breakpoints breakpoint S, meaning outcome can \"S\" NA. Setting TRUE convert NAs cases \"R\". Can also set package option AMR_substitute_missing_r_breakpoint. include_screening logical indicate clinical breakpoints screening allowed - default FALSE. Can also set package option AMR_include_screening. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". host vector (column name) characters indicate host. useful veterinary breakpoints, requires breakpoint_type = \"animal\". values can text resembling animal species, even 28 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). language Language convert values set host using animal breakpoints. Use one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). verbose logical indicate notes printed interpretation MIC values disk diffusion values. conserve_capped_values Deprecated, use capped_mic_handling instead. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). parallel logical indicate parallel computing must used, defaults FALSE. requires additional packages, used parallel package part base R. Windows R < 4.0.0 parallel::parLapply() used, cases efficient parallel::mclapply() used. max_cores Maximum number cores use parallel = TRUE. Use negative value subtract number available number cores, e.g. value -2 8-core machine means 6 cores used. Defaults -1. never used cores variables analyse. available number cores detected using parallelly::availableCores() package installed, base R's parallel::detectCores() otherwise. clean logical indicate whether previously stored results forgotten returning 'logbook' results.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Ordered factor new class sir","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Note: clinical breakpoints package validated , imported , WHONET. public use AMR package endorsed CLSI EUCAST. See clinical_breakpoints information. NA_sir_ missing value new sir class, analogous e.g. base R's NA_character_.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"how-it-works","dir":"Reference","previous_headings":"","what":"How it Works","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":".sir() function can work four ways: cleaning raw / untransformed data. data cleaned contain valid values, namely: S susceptible, intermediate 'susceptible, increased exposure', R resistant, NI non-interpretable, SDD susceptible dose-dependent. can set using regular expression. Furthermore, .sir() try best clean intelligence. example, mixed values SIR interpretations MIC values \"<0.25; S\" coerced \"S\". Combined interpretations multiple test methods (seen laboratory records) \"S; S\" coerced \"S\", value like \"S; \" return NA warning input invalid. interpreting minimum inhibitory concentration (MIC) values according EUCAST CLSI. must clean MIC values first using .mic(), also gives columns new data class mic. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   Operators like \"<=\" stripped interpretation. using capped_mic_handling = \"conservative\", MIC value e.g. \">2\" always return \"R\", even breakpoint according chosen guideline \">=4\". prevent capped values raw laboratory data treated conservatively. default behaviour (capped_mic_handling = \"standard\") considers \">2\" lower \">=4\" might case return \"S\" \"\". Note: using CLSI guideline, MIC values must log2-based doubling dilutions. Values format, automatically rounded nearest log2 level CLSI instructs, warning thrown. interpreting disk diffusion diameters according EUCAST CLSI. must clean disk zones first using .disk(), also gives columns new data class disk. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   interpreting complete data set, automatic determination MIC values, disk diffusion diameters, microorganism names codes, antimicrobial test results. done simply running .sir(your_data). points 2, 3 4: Use sir_interpretation_history() retrieve data.frame results previous .sir() calls. also contains notes interpretation, exact input output values.","code":"your_data %>% mutate_if(is.mic, as.sir) your_data %>% mutate(across(where(is.mic), as.sir)) your_data %>% mutate_if(is.mic, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.mic, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.mic, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE) your_data %>% mutate_if(is.disk, as.sir) your_data %>% mutate(across(where(is.disk), as.sir)) your_data %>% mutate_if(is.disk, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.disk, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.disk, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"supported-guidelines","dir":"Reference","previous_headings":"","what":"Supported Guidelines","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpreting MIC values well disk diffusion diameters, currently implemented guidelines : clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. guideline argument must set e.g., \"EUCAST 2025\" \"CLSI 2025\". simply using \"EUCAST\" (default) \"CLSI\" input, latest included version guideline automatically selected. Importantly, using column name data instead, allows straightforward interpretation historical data must analysed context , example, different years. can set data set using reference_data argument. guideline argument ignored. also possible set default guideline package option AMR_guideline (e.g. .Rprofile file), :","code":"options(AMR_guideline = \"CLSI\")   options(AMR_guideline = \"CLSI 2018\")   options(AMR_guideline = \"EUCAST 2020\")   # or to reset:   options(AMR_guideline = NULL)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"working-with-veterinary-breakpoints","dir":"Reference","previous_headings":"","what":"Working with Veterinary Breakpoints","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using veterinary breakpoints (.e., setting breakpoint_type = \"animal\"), column animal species must available set manually using host argument. column must contain names like \"dogs\", \"cats\", \"cattle\", \"swine\", \"horses\", \"poultry\", \"aquatic\". animal names like \"goats\", \"rabbits\", \"monkeys\" also recognised may available guidelines. Matching case-insensitive accepts Latin-based synonyms (e.g., \"bovine\" cattle \"canine\" dogs). Regarding choice veterinary guidelines, might best options set analysis:","code":"options(AMR_guideline = \"CLSI\")   options(AMR_breakpoint_type = \"animal\")"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"after-interpretation","dir":"Reference","previous_headings":"","what":"After Interpretation","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using .sir(), can use eucast_rules() defined EUCAST (1) apply inferred susceptibility resistance based results antimicrobials (2) apply intrinsic resistance based taxonomic properties microorganism. determine isolates multi-drug resistant, sure run mdro() (applies MDR/PDR/XDR guideline 2012 default) data set contains S//R values. Read interpreting multidrug-resistant organisms .","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"function .sir() detects input contains class sir. input data.frame list, iterates columns/items returns logical vector. base R function .double() can used retrieve quantitative values sir object: \"S\" = 1, \"\"/\"SDD\" = 2, \"R\" = 3. values rendered NA. Note: use .integer(), since (R works internally) return factor level indices, aforementioned quantitative values. function is_sir_eligible() returns TRUE column contains 5% potentially invalid antimicrobial interpretations, FALSE otherwise. threshold 5% can set threshold argument. input data.frame, iterates columns returns logical vector.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  summary(example_isolates[, 1:10]) # see all SIR results at a glance #>       date              patient               age           gender          #>  Min.   :2002-01-02   Length:2000        Min.   : 0.00   Length:2000        #>  1st Qu.:2005-07-31   Class :character   1st Qu.:63.00   Class :character   #>  Median :2009-07-31   Mode  :character   Median :74.00   Mode  :character   #>  Mean   :2009-11-20                      Mean   :70.69                      #>  3rd Qu.:2014-05-30                      3rd Qu.:82.00                      #>  Max.   :2017-12-28                      Max.   :97.00                      #>      ward                mo                  PEN                 #>  Length:2000        Class :mo             Class:sir              #>  Class :character   <NA>  :0              %S   :25.6% (n=417)    #>  Mode  :character   Unique:90             %SDD : 0.0% (n=0)      #>                     #1    :B_ESCHR_COLI   %I   : 0.7% (n=11)     #>                     #2    :B_STPHY_CONS   %R   :73.7% (n=1201)   #>                     #3    :B_STPHY_AURS   %NI  : 0.0% (n=0)      #>     OXA                   FLC                   AMX                #>  Class:sir             Class:sir             Class:sir             #>  %S   :68.8% (n=251)   %S   :70.5% (n=665)   %S   :40.2% (n=543)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)     %I   : 0.2% (n=3)     #>  %R   :31.2% (n=114)   %R   :29.5% (n=278)   %R   :59.6% (n=804)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      # create some example data sets, with combined MIC values and disk zones df_wide <- data.frame(   microorganism = \"Escherichia coli\",   amoxicillin = as.mic(8),   cipro = as.mic(0.256),   tobra = as.disk(16),   genta = as.disk(18),   ERY = \"R\" ) df_long <- data.frame(   bacteria = rep(\"Escherichia coli\", 4),   antibiotic = c(\"amoxicillin\", \"cipro\", \"tobra\", \"genta\"),   mics = as.mic(c(0.01, 1, 4, 8)),   disks = as.disk(c(6, 10, 14, 18)),   guideline = c(\"EUCAST 2021\", \"EUCAST 2022\", \"EUCAST 2023\", \"EUCAST 2024\") ) # and clean previous SIR interpretation logs x <- sir_interpretation_history(clean = TRUE)   # For INTERPRETING disk diffusion and MIC values -----------------------  # most basic application: as.sir(df_wide) #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R  # return a 'logbook' about the results: sir_interpretation_history() #> # A tibble: 4 × 18 #>   datetime            index method ab_given    mo_given   host_given input_given #>   <dttm>              <int> <chr>  <chr>       <chr>      <chr>      <chr>       #> 1 2025-07-19 12:13:25     1 MIC    amoxicillin Escherich… human      8           #> 2 2025-07-19 12:13:25     1 MIC    cipro       Escherich… human      0.256       #> 3 2025-07-19 12:13:26     1 DISK   tobra       Escherich… human      16          #> 4 2025-07-19 12:13:26     1 DISK   genta       Escherich… human      18          #> # ℹ 11 more variables: ab <ab>, mo <mo>, host <chr>, input <chr>, #> #   outcome <sir>, notes <chr>, guideline <chr>, ref_table <chr>, uti <lgl>, #> #   breakpoint_S_R <chr>, site <chr>  # \\donttest{ # using parallel computing, which is available in base R: as.sir(df_wide, parallel = TRUE, info = TRUE) #> ℹ Returning previously coerced values for various antimicrobials. Run #>   `ab_reset_session()` to reset this. This note will be shown once per #>   session. #>  #> Running in parallel mode using 3 out of 4 cores, on columns 'amoxicillin', #> 'cipro', 'tobra', 'genta', and 'ERY'... #>  DONE #>  #>  #> ℹ Run `sir_interpretation_history()` to retrieve a logbook with all details #>   of the breakpoint interpretations. #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R   ## Using dplyr ------------------------------------------------- if (require(\"dplyr\")) {   # approaches that all work without additional arguments:   df_wide %>% mutate_if(is.mic, as.sir)   df_wide %>% mutate_if(function(x) is.mic(x) | is.disk(x), as.sir)   df_wide %>% mutate(across(where(is.mic), as.sir))    df_wide %>% mutate_at(vars(amoxicillin:tobra), as.sir)   df_wide %>% mutate(across(amoxicillin:tobra, as.sir))    df_wide %>% mutate(across(aminopenicillins(), as.sir))    # approaches that all work with additional arguments:   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       guideline = \"guideline\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     # given certain columns, e.g. from 'cipro' to 'genta'     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           guideline = \"CLSI\"         )       }     ))    # for veterinary breakpoints, add 'host':   df_long$animal_species <- c(\"cats\", \"dogs\", \"horses\", \"cattle\")   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))    # to include information about urinary tract infections (UTI)   data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     from_the_bladder = c(TRUE, FALSE)   ) %>%     as.sir(uti = \"from_the_bladder\")    data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     specimen = c(\"urine\", \"blood\")   ) %>%     as.sir() # automatically determines urine isolates    df_wide %>%     mutate_at(vars(cipro:genta), as.sir, mo = \"E. coli\", uti = TRUE) } #> ℹ For `aminopenicillins()` using column 'amoxicillin' #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `mics = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Interpreting MIC values: 'antibiotic' (ASP, acetylspiramycin), CLSI 2025... #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           8  <NA>     S     S   R   ## Using base R ------------------------------------------------   # for single values as.sir(   x = as.mic(2),   mo = as.mo(\"S. pneumoniae\"),   ab = \"AMP\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R  as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R   # For CLEANING existing SIR values -------------------------------------  as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", \"A\", \"B\", \"C\")) #> Warning: in `as.sir()`: 3 results in index '21' truncated (38%) that were invalid #> antimicrobial interpretations: \"A\", \"B\", and \"C\" #> Class 'sir' #> [1] S    SDD  I    R    NI   <NA> <NA> <NA> as.sir(\"<= 0.002; S\") # will return \"S\" #> Class 'sir' #> [1] S sir_data <- as.sir(c(rep(\"S\", 474), rep(\"I\", 36), rep(\"R\", 370))) is.sir(sir_data) #> [1] TRUE plot(sir_data) # for percentages  barplot(sir_data) # for frequencies   # as common in R, you can use as.integer() to return factor indices: as.integer(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  3  4  5 NA  # but for computational use, as.double() will return 1 for S, 2 for I/SDD, and 3 for R: as.double(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  2  3 NA NA  # the dplyr way if (require(\"dplyr\")) {   example_isolates %>%     mutate_at(vars(PEN:RIF), as.sir)   # same:   example_isolates %>%     as.sir(PEN:RIF)    # fastest way to transform all columns with already valid AMR results to class `sir`:   example_isolates %>%     mutate_if(is_sir_eligible, as.sir)    # since dplyr 1.0.0, this can also be the more impractical:   # example_isolates %>%   #   mutate(across(where(is_sir_eligible), as.sir)) } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":null,"dir":"Reference","previous_headings":"","what":"Get ATC Properties from WHOCC Website — atc_online_property","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Gets data WHOCC website determine properties Anatomical Therapeutic Chemical (ATC) (e.g. antimicrobial), name, defined daily dose (DDD) standard unit.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"atc_online_property(atc_code, property, administration = \"O\",   url = \"https://atcddd.fhi.no/atc_ddd_index/?code=%s&showdescription=no\",   url_vet = \"https://atcddd.fhi.no/atcvet/atcvet_index/?code=%s&showdescription=no\")  atc_online_groups(atc_code, ...)  atc_online_ddd(atc_code, ...)  atc_online_ddd_units(atc_code, ...)"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"https://atcddd.fhi./atc_ddd_alterations__cumulative/ddd_alterations/abbrevations/","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"atc_code character (vector) ATC code(s) antimicrobials, coerced .ab() ab_atc() internally valid ATC code. property Property ATC code. Valid values \"ATC\", \"Name\", \"DDD\", \"U\" (\"unit\"), \"Adm.R\", \"Note\" groups. last option, hierarchical groups ATC code returned, see Examples. administration Type administration using property = \"Adm.R\", see Details. url URL website WHOCC. sign %s can used placeholder ATC codes. url_vet URL website WHOCC veterinary medicine. sign %s can used placeholder ATC_vet codes (start \"Q\"). ... Arguments pass atc_property.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Options argument administration: \"Implant\" = Implant \"Inhal\" = Inhalation \"Instill\" = Instillation \"N\" = nasal \"O\" = oral \"P\" = parenteral \"R\" = rectal \"SL\" = sublingual/buccal \"TD\" = transdermal \"V\" = vaginal Abbreviations return values using property = \"U\" (unit): \"g\" = gram \"mg\" = milligram \"mcg\" = microgram \"U\" = unit \"TU\" = thousand units \"MU\" = million units \"mmol\" = millimole \"ml\" = millilitre (e.g. eyedrops) N.B. function requires internet connection works following packages installed: curl, rvest, xml2.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"# \\donttest{ if (requireNamespace(\"curl\") && requireNamespace(\"rvest\") && requireNamespace(\"xml2\")) {   # oral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"O\")   atc_online_ddd(ab_atc(\"amox\"))    # parenteral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"P\")    atc_online_property(\"J01CA04\", property = \"groups\") # search hierarchical groups of amoxicillin } #> Loading required namespace: rvest #> ℹ in `atc_online_property()`: no properties found for ATC QG51AA03. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QG51AA03&showdescription=no. #> ℹ in `atc_online_property()`: no properties found for ATC QJ01CA04. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QJ01CA04&showdescription=no. #> [1] \"ANTIINFECTIVES FOR SYSTEMIC USE\"         #> [2] \"ANTIBACTERIALS FOR SYSTEMIC USE\"         #> [3] \"BETA-LACTAM ANTIBACTERIALS, PENICILLINS\" #> [4] \"Penicillins with extended spectrum\"      # }"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Use function e.g. clinical texts health care records. returns list antiviral drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_av = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_av type = \"drug\": column name antivirals data set translate antibiotic abbreviations , using av_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .av().","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"function also internally used .av(), although searches first drug name throw note drug names returned. Note: .av() function may use long regular expression match brand names antiviral drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"default, function search antiviral drug names. text elements searched official names, ATC codes brand names. uses .av() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(avx = av_from_text(clinical_text)) returned AV codes can transformed official names, groups, etc. av_* functions av_name() av_group(), using translate_av argument. using collapse, function return character:df %>% mutate(avx = av_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(\"28/03/2020 valaciclovir po tid\") #> [[1]] #> Class 'av' #> [1] VALA #>  av_from_text(\"28/03/2020 valaciclovir po tid\", type = \"admin\") #> [[1]] #> [1] \"oral\" #>"},{"path":"https://amr-for-r.org/reference/av_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antiviral Drug — av_property","title":"Get Properties of an Antiviral Drug — av_property","text":"Use functions return specific property antiviral drug antivirals data set. input values evaluated internally .av().","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"av_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  av_cid(x, ...)  av_synonyms(x, ...)  av_tradenames(x, ...)  av_group(x, language = get_AMR_locale(), ...)  av_atc(x, ...)  av_loinc(x, ...)  av_ddd(x, administration = \"oral\", ...)  av_ddd_units(x, administration = \"oral\", ...)  av_info(x, language = get_AMR_locale(), ...)  av_url(x, open = FALSE, ...)  av_property(x, property = \"name\", language = get_AMR_locale(), ...)"},{"path":"https://amr-for-r.org/reference/av_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antiviral Drug — av_property","text":"x (vector ) text can coerced valid antiviral drug code .av(). language Language returned text - default system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. ... arguments passed .av(). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antivirals data set: vector_or(colnames(antivirals), sort = FALSE).","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antiviral Drug — av_property","text":"integer case av_cid() named list case av_info() multiple av_atc()/av_synonyms()/av_tradenames() double case av_ddd() character cases","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antiviral Drug — av_property","text":"output translated possible. function av_url() return direct URL official website. warning returned required ATC code available.","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antiviral Drug — av_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antiviral Drug — av_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"# all properties: av_name(\"ACI\") #> [1] \"Aciclovir\" av_atc(\"ACI\") #> [1] \"J05AB01\" av_cid(\"ACI\") #> [1] 135398513 av_synonyms(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_tradenames(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_group(\"ACI\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_url(\"ACI\") #>                                                              Aciclovir  #> \"https://atcddd.fhi.no/atc_ddd_index/?code=J05AB01&showdescription=no\"   # lowercase transformation av_name(x = c(\"ACI\", \"VALA\")) #> [1] \"Aciclovir\"    \"Valaciclovir\" av_name(x = c(\"ACI\", \"VALA\"), tolower = TRUE) #> [1] \"aciclovir\"    \"valaciclovir\"  # defined daily doses (DDD) av_ddd(\"ACI\", \"oral\") #> [1] 4 av_ddd_units(\"ACI\", \"oral\") #> [1] \"g\" av_ddd(\"ACI\", \"iv\") #> [1] 4 av_ddd_units(\"ACI\", \"iv\") #> [1] \"g\"  av_info(\"ACI\") # all properties as a list #> $av #> [1] \"ACI\" #>  #> $cid #> [1] 135398513 #>  #> $name #> [1] \"Aciclovir\" #>  #> $group #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" #>  #> $atc #> [1] \"J05AB01\" #>  #> $tradenames #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            #>  #> $loinc #> [1] \"\" #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 4 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 4 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all av_* functions use as.av() internally, so you can go from 'any' to 'any': av_atc(\"ACI\") #> [1] \"J05AB01\" av_group(\"J05AB01\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_loinc(\"abacavir\") #> [1] \"29113-8\" \"30273-7\" \"30287-7\" \"30303-2\" \"78772-1\" \"78773-9\" \"79134-3\" #> [8] \"80118-3\" av_name(\"29113-8\") #> [1] \"Abacavir\" av_name(135398513) #> [1] \"Aciclovir\" av_name(\"J05AB01\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/availability.html","id":null,"dir":"Reference","previous_headings":"","what":"Check Availability of Columns — availability","title":"Check Availability of Columns — availability","text":"Easy check data availability columns data set. makes easy get idea antimicrobial combinations can used calculation e.g. susceptibility() resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check Availability of Columns — availability","text":"","code":"availability(tbl, width = NULL)"},{"path":"https://amr-for-r.org/reference/availability.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check Availability of Columns — availability","text":"tbl data.frame list. width Number characters present visual availability - default filling width console.","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check Availability of Columns — availability","text":"data.frame column names tbl row names","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check Availability of Columns — availability","text":"function returns data.frame columns \"resistant\" \"visual_resistance\". values columns calculated resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check Availability of Columns — availability","text":"","code":"availability(example_isolates) #>         count available     visual_availabilty resistant      visual_resistance #> date     2000    100.0% |####################|                                  #> patient  2000    100.0% |####################|                                  #> age      2000    100.0% |####################|                                  #> gender   2000    100.0% |####################|                                  #> ward     2000    100.0% |####################|                                  #> mo       2000    100.0% |####################|                                  #> PEN      1629     81.5% |################----|     73.7% |##############------| #> OXA       365     18.3% |###-----------------|     31.2% |######--------------| #> FLC       943     47.2% |#########-----------|     29.5% |#####---------------| #> AMX      1350     67.5% |#############-------|     59.6% |###########---------| #> AMC      1879     94.0% |##################--|     23.7% |####----------------| #> AMP      1350     67.5% |#############-------|     59.6% |###########---------| #> TZP      1001     50.0% |##########----------|     12.6% |##------------------| #> CZO       446     22.3% |####----------------|     44.6% |########------------| #> FEP       724     36.2% |#######-------------|     14.2% |##------------------| #> CXM      1789     89.5% |#################---|     26.3% |#####---------------| #> FOX       818     40.9% |########------------|     27.4% |#####---------------| #> CTX       943     47.2% |#########-----------|     15.5% |###-----------------| #> CAZ      1811     90.6% |##################--|     66.5% |#############-------| #> CRO       943     47.2% |#########-----------|     15.5% |###-----------------| #> GEN      1855     92.8% |##################--|     24.6% |####----------------| #> TOB      1351     67.6% |#############-------|     34.4% |######--------------| #> AMK       692     34.6% |######--------------|     63.7% |############--------| #> KAN       471     23.6% |####----------------|    100.0% |####################| #> TMP      1499     75.0% |###############-----|     38.1% |#######-------------| #> SXT      1759     88.0% |#################---|     20.5% |####----------------| #> NIT       743     37.2% |#######-------------|     17.1% |###-----------------| #> FOS       351     17.6% |###-----------------|     42.2% |########------------| #> LNZ      1023     51.2% |##########----------|     69.3% |#############-------| #> CIP      1409     70.5% |#############-------|     16.2% |###-----------------| #> MFX       211     10.6% |##------------------|     33.6% |######--------------| #> VAN      1861     93.1% |##################--|     38.3% |#######-------------| #> TEC       976     48.8% |#########-----------|     75.7% |###############-----| #> TCY      1200     60.0% |###########---------|     29.8% |#####---------------| #> TGC       798     39.9% |########------------|     12.7% |##------------------| #> DOX      1136     56.8% |###########---------|     27.7% |#####---------------| #> ERY      1894     94.7% |##################--|     57.2% |###########---------| #> CLI      1520     76.0% |###############-----|     61.2% |############--------| #> AZM      1894     94.7% |##################--|     57.2% |###########---------| #> IPM       889     44.5% |########------------|      6.2% |#-------------------| #> MEM       829     41.5% |########------------|      5.9% |#-------------------| #> MTR        34      1.7% |--------------------|     14.7% |##------------------| #> CHL       154      7.7% |#-------------------|     21.4% |####----------------| #> COL      1640     82.0% |################----|     81.2% |################----| #> MUP       270     13.5% |##------------------|      5.9% |#-------------------| #> RIF      1003     50.2% |##########----------|     69.6% |#############-------| # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     select_if(is.sir) %>%     availability() } #>     count available       visual_availabilty resistant        visual_resistance #> PEN   467    100.0% |######################|    100.0% |######################| #> OXA     0      0.0% |----------------------|                                    #> FLC     0      0.0% |----------------------|                                    #> AMX   392     83.9% |##################----|     50.0% |###########-----------| #> AMC   467    100.0% |######################|     13.1% |##--------------------| #> AMP   392     83.9% |##################----|     50.0% |###########-----------| #> TZP   416     89.1% |###################---|      5.5% |#---------------------| #> CZO    82     17.6% |###-------------------|      2.4% |----------------------| #> FEP   317     67.9% |##############--------|      2.8% |----------------------| #> CXM   465     99.6% |######################|      5.4% |#---------------------| #> FOX   377     80.7% |#################-----|      6.9% |#---------------------| #> CTX   459     98.3% |#####################-|      2.4% |----------------------| #> CAZ   460     98.5% |#####################-|      2.4% |----------------------| #> CRO   459     98.3% |#####################-|      2.4% |----------------------| #> GEN   460     98.5% |#####################-|      2.0% |----------------------| #> TOB   462     98.9% |#####################-|      2.6% |----------------------| #> AMK   171     36.6% |########--------------|      0.0% |----------------------| #> KAN     0      0.0% |----------------------|                                    #> TMP   396     84.8% |##################----|     39.1% |########--------------| #> SXT   465     99.6% |######################|     31.6% |######----------------| #> NIT   458     98.1% |#####################-|      2.8% |----------------------| #> FOS    61     13.1% |##--------------------|      0.0% |----------------------| #> LNZ   467    100.0% |######################|    100.0% |######################| #> CIP   456     97.6% |#####################-|     12.5% |##--------------------| #> MFX    57     12.2% |##--------------------|    100.0% |######################| #> VAN   467    100.0% |######################|    100.0% |######################| #> TEC   467    100.0% |######################|    100.0% |######################| #> TCY     3      0.6% |----------------------|     66.7% |##############--------| #> TGC    68     14.6% |###-------------------|      0.0% |----------------------| #> DOX     0      0.0% |----------------------|                                    #> ERY   467    100.0% |######################|    100.0% |######################| #> CLI   467    100.0% |######################|    100.0% |######################| #> AZM   467    100.0% |######################|    100.0% |######################| #> IPM   422     90.4% |###################---|      0.0% |----------------------| #> MEM   418     89.5% |###################---|      0.0% |----------------------| #> MTR     2      0.4% |----------------------|      0.0% |----------------------| #> CHL     0      0.0% |----------------------|                                    #> COL   240     51.4% |###########-----------|      0.0% |----------------------| #> MUP     0      0.0% |----------------------|                                    #> RIF   467    100.0% |######################|    100.0% |######################| # }"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Bug-Drug Combinations — bug_drug_combinations","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"Determine antimicrobial resistance (AMR) bug-drug combinations data set least 30 (default) isolates available per species. Use format() result prettify publishable/printable format, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"bug_drug_combinations(x, col_mo = NULL, FUN = mo_shortname,   include_n_rows = FALSE, ...)  # S3 method for class 'bug_drug_combinations' format(x, translate_ab = \"name (ab, atc)\",   language = get_AMR_locale(), minimum = 30, combine_SI = TRUE,   add_ab_group = TRUE, remove_intrinsic_resistant = FALSE,   decimal.mark = getOption(\"OutDec\"), big.mark = ifelse(decimal.mark ==   \",\", \".\", \",\"), ...)"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). FUN function call mo column transform microorganism codes - default mo_shortname(). include_n_rows logical indicate total number rows must included output. ... Arguments passed FUN. translate_ab character length 1 containing column names antimicrobials data set. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, summed, resistance based R - default TRUE. add_ab_group logical indicate group antimicrobials must included first column. remove_intrinsic_resistant logical indicate rows columns 100% resistance tested antimicrobials must removed table. decimal.mark character used indicate numeric     decimal point. big.mark character; empty used mark every     big.interval decimals (hence big)     decimal point.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function bug_drug_combinations() returns data.frame columns \"mo\", \"ab\", \"S\", \"SDD\", \"\", \"R\", \"total\".","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function format() calculates resistance per bug-drug combination returns table ready reporting/publishing. Use combine_SI = TRUE (default) test R vs. S+combine_SI = FALSE test R+vs. S. table can also directly used R Markdown / Quarto without need e.g. knitr::kable().","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ x <- bug_drug_combinations(example_isolates) head(x) #> # A tibble: 6 × 8 #>   mo                ab        S   SDD     I     R    NI total #>   <chr>             <chr> <int> <int> <int> <int> <int> <int> #> 1 (unknown species) AMC      15     0     0     0     0    15 #> 2 (unknown species) AMK       0     0     0     0     0     0 #> 3 (unknown species) AMP      15     0     0     1     0    16 #> 4 (unknown species) AMX      15     0     0     1     0    16 #> 5 (unknown species) AZM       3     0     0     3     0     6 #> 6 (unknown species) CAZ       0     0     0     0     0     0 #> Use 'format()' on this result to get a publishable/printable format. format(x, translate_ab = \"name (atc)\") #> # A tibble: 39 × 12 #>    Group     Drug  CoNS  `E. coli` `E. faecalis` `K. pneumoniae` `P. aeruginosa` #>    <chr>     <chr> <chr> <chr>     <chr>         <chr>           <chr>           #>  1 \"Aminogl… Amik… \"100… \"  0.0% … \"100.0% (39/… \"\"              \"\"              #>  2 \"\"        Gent… \" 13… \"  2.0% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  3 \"\"        Kana… \"100… \"\"        \"100.0% (39/… \"\"              \"100.0% (30/30… #>  4 \"\"        Tobr… \" 78… \"  2.6% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  5 \"Antimyc… Rifa… \"\"    \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  6 \"Beta-la… Amox… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  7 \"\"        Amox… \" 42… \" 13.1% … \"\"            \" 10.3% (6/58)\" \"100.0% (30/30… #>  8 \"\"        Ampi… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  9 \"\"        Benz… \" 77… \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> 10 \"\"        Fluc… \" 42… \"\"        \"\"            \"\"              \"\"              #> # ℹ 29 more rows #> # ℹ 5 more variables: `P. mirabilis` <chr>, `S. aureus` <chr>, #> #   `S. epidermidis` <chr>, `S. hominis` <chr>, `S. pneumoniae` <chr>  # Use FUN to change to transformation of microorganism codes bug_drug_combinations(example_isolates,   FUN = mo_gramstain ) #> # A tibble: 80 × 8 #>    mo            ab        S   SDD     I     R    NI total #>    <chr>         <chr> <int> <int> <int> <int> <int> <int> #>  1 Gram-negative AMC     463     0    89   174     0   726 #>  2 Gram-negative AMK     251     0     0     5     0   256 #>  3 Gram-negative AMP     226     0     0   405     0   631 #>  4 Gram-negative AMX     226     0     0   405     0   631 #>  5 Gram-negative AZM       1     0     2   696     0   699 #>  6 Gram-negative CAZ     607     0     0    27     0   634 #>  7 Gram-negative CHL       1     0     0    30     0    31 #>  8 Gram-negative CIP     610     0    11    63     0   684 #>  9 Gram-negative CLI      18     0     1   709     0   728 #> 10 Gram-negative COL     309     0     0    78     0   387 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format.  bug_drug_combinations(example_isolates,   FUN = function(x) {     ifelse(x == as.mo(\"Escherichia coli\"),       \"E. coli\",       \"Others\"     )   } ) #> # A tibble: 80 × 8 #>    mo      ab        S   SDD     I     R    NI total #>    <chr>   <chr> <int> <int> <int> <int> <int> <int> #>  1 E. coli AMC     332     0    74    61     0   467 #>  2 E. coli AMK     171     0     0     0     0   171 #>  3 E. coli AMP     196     0     0   196     0   392 #>  4 E. coli AMX     196     0     0   196     0   392 #>  5 E. coli AZM       0     0     0   467     0   467 #>  6 E. coli CAZ     449     0     0    11     0   460 #>  7 E. coli CHL       0     0     0     0     0     0 #>  8 E. coli CIP     398     0     1    57     0   456 #>  9 E. coli CLI       0     0     0   467     0   467 #> 10 E. coli COL     240     0     0     0     0   240 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format. # }"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Data set containing clinical breakpoints interpret MIC disk diffusion SIR values, according international guidelines. dataset contain breakpoints humans, 7 different animal groups, ECOFFs. breakpoints currently implemented: clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. Use .sir() transform MICs disks measurements SIR values.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"tibble 40 217 observations 14 variables: guideline Name guideline type Breakpoint type, either \"ECOFF\", \"animal\", \"human\" host Host infectious agent. mostly useful veterinary breakpoints either \"ECOFF\", \"aquatic\", \"cats\", \"cattle\", \"dogs\", \"horse\", \"human\", \"poultry\", \"swine\" method Testing method, either \"DISK\" \"MIC\" site Body site breakpoint must applied, e.g. \"Oral\" \"Respiratory\" mo Microbial ID, see .mo() rank_index Taxonomic rank index mo 1 (subspecies/infraspecies) 5 (unknown microorganism) ab Antimicrobial code used package, EARS-Net WHONET, see .ab() ref_tbl Info guideline rule can found disk_dose Dose used disk diffusion method breakpoint_S Lowest MIC value highest number millimetres leads \"S\" breakpoint_R Highest MIC value lowest number millimetres leads \"R\", can NA uti logical value (TRUE/FALSE) indicate whether rule applies urinary tract infection (UTI) is_SDD logical value (TRUE/FALSE) indicate whether intermediate range \"S\" \"R\" interpreted \"SDD\", instead \"\". currently applies 48 breakpoints.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"different-types-of-breakpoints","dir":"Reference","previous_headings":"","what":"Different Types of Breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Supported types breakpoints ECOFF, animal, human. ECOFF (Epidemiological cut-) values used antimicrobial susceptibility testing differentiate wild-type non-wild-type strains bacteria fungi. default \"human\", can also set package option AMR_breakpoint_type. Use .sir(..., breakpoint_type = ...) interpret raw data using specific breakpoint type, e.g. .sir(..., breakpoint_type = \"ECOFF\") use ECOFFs.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"imported-from-whonet","dir":"Reference","previous_headings":"","what":"Imported From WHONET","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Clinical breakpoints package validated imported WHONET, free desktop Windows application developed supported Collaborating Centre Surveillance Antimicrobial Resistance. can read website. developers WHONET AMR package contact sharing work. highly appreciate great development WHONET software. import reproduction script can found : https://github.com/msberends/AMR/blob/main/data-raw/_reproduction_scripts/reproduction_of_clinical_breakpoints.R.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"response-from-clsi-and-eucast","dir":"Reference","previous_headings":"","what":"Response From CLSI and EUCAST","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"CEO CLSI chairman EUCAST endorsed work public use AMR package (consequently use breakpoints) June 2023, future development distributing clinical breakpoints discussed meeting CLSI, EUCAST, , developers WHONET software, developers AMR package.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-note","dir":"Reference","previous_headings":"","what":"Download Note","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"AMR package (WHONET software well) contains rather complex internal methods apply guidelines. example, breakpoints must applied certain species groups (case package available microorganisms.groups data set). important considered implementing breakpoints use.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints #> # A tibble: 40,217 × 14 #>    guideline   type  host  method site    mo            rank_index ab   ref_tbl  #>    <chr>       <chr> <chr> <chr>  <chr>   <mo>               <dbl> <ab> <chr>    #>  1 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  2 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  3 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  4 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  5 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  6 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  7 EUCAST 2025 human human DISK   NA      B_ACNTB                3 AMK  Acineto… #>  8 EUCAST 2025 human human DISK   Uncomp… B_ACNTB                3 AMK  Acineto… #>  9 EUCAST 2025 human human MIC    NA      B_ACNTB                3 AMK  Acineto… #> 10 EUCAST 2025 human human MIC    Uncomp… B_ACNTB                3 AMK  Acineto… #> # ℹ 40,207 more rows #> # ℹ 5 more variables: disk_dose <chr>, breakpoint_S <dbl>, breakpoint_R <dbl>, #> #   uti <lgl>, is_SDD <lgl>"},{"path":"https://amr-for-r.org/reference/count.html","id":null,"dir":"Reference","previous_headings":"","what":"Count Available Isolates — count","title":"Count Available Isolates — count","text":"functions can used count resistant/susceptible microbial isolates. functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. count_resistant() used count resistant isolates, count_susceptible() used count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Count Available Isolates — count","text":"","code":"count_resistant(..., only_all_tested = FALSE)  count_susceptible(..., only_all_tested = FALSE)  count_S(..., only_all_tested = FALSE)  count_SI(..., only_all_tested = FALSE)  count_I(..., only_all_tested = FALSE)  count_IR(..., only_all_tested = FALSE)  count_R(..., only_all_tested = FALSE)  count_all(..., only_all_tested = FALSE)  n_sir(..., only_all_tested = FALSE)  count_df(data, translate_ab = \"name\", language = get_AMR_locale(),   combine_SI = TRUE)"},{"path":"https://amr-for-r.org/reference/count.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Count Available Isolates — count","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count Available Isolates — count","text":"integer","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Count Available Isolates — count","text":"functions meant count isolates. Use resistance()/susceptibility() functions calculate microbial resistance/susceptibility. function count_resistant() equal function count_R(). function count_susceptible() equal function count_SI(). function n_sir() alias count_all(). can used count available isolates, .e. input antimicrobials available result (S, R). use equal n_distinct(). function equal count_susceptible(...) + count_resistant(...). function count_df() takes variable data sir class (created .sir()) counts number S's, 's R's. also supports grouped variables. function sir_df() works exactly like count_df(), adds percentage S, R.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Count Available Isolates — count","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Count Available Isolates — count","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":[]},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Count Available Isolates — count","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info.  # base R ------------------------------------------------------------ count_resistant(example_isolates$AMX) # counts \"R\" #> [1] 804 count_susceptible(example_isolates$AMX) # counts \"S\" and \"I\" #> [1] 546 count_all(example_isolates$AMX) # counts \"S\", \"I\" and \"R\" #> [1] 1350  # be more specific count_S(example_isolates$AMX) #> [1] 543 count_SI(example_isolates$AMX) #> [1] 546 count_I(example_isolates$AMX) #> [1] 3 count_IR(example_isolates$AMX) #> [1] 807 count_R(example_isolates$AMX) #> [1] 804  # Count all available isolates count_all(example_isolates$AMX) #> [1] 1350 n_sir(example_isolates$AMX) #> [1] 1350  # n_sir() is an alias of count_all(). # Since it counts all available isolates, you can # calculate back to count e.g. susceptible isolates. # These results are the same: count_susceptible(example_isolates$AMX) #> [1] 546 susceptibility(example_isolates$AMX) * n_sir(example_isolates$AMX) #> [1] 546  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = count_R(CIP),       I = count_I(CIP),       S = count_S(CIP),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Number of available isolates for a whole antibiotic class   # (i.e., in this data set columns GEN, TOB, AMK, KAN)   example_isolates %>%     group_by(ward) %>%     summarise(across(aminoglycosides(), n_sir))    # Count co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy.   # Please mind that `susceptibility()` calculates percentages right away instead.   example_isolates %>% count_susceptible(AMC) # 1433   example_isolates %>% count_all(AMC) # 1879    example_isolates %>% count_susceptible(GEN) # 1399   example_isolates %>% count_all(GEN) # 1855    example_isolates %>% count_susceptible(AMC, GEN) # 1764   example_isolates %>% count_all(AMC, GEN) # 1936    # Get number of S+I vs. R immediately of selected columns   example_isolates %>%     select(AMX, CIP) %>%     count_df(translate = FALSE)    # It also supports grouping variables   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     count_df(translate = FALSE) } #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 12 × 4 #>    ward       antibiotic interpretation value #>    <chr>      <chr>      <ord>          <int> #>  1 Clinical   AMX        SI               357 #>  2 Clinical   AMX        R                487 #>  3 Clinical   CIP        SI               741 #>  4 Clinical   CIP        R                128 #>  5 ICU        AMX        SI               158 #>  6 ICU        AMX        R                270 #>  7 ICU        CIP        SI               362 #>  8 ICU        CIP        R                 85 #>  9 Outpatient AMX        SI                31 #> 10 Outpatient AMX        R                 47 #> 11 Outpatient CIP        SI                78 #> 12 Outpatient CIP        R                 15 # }"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom EUCAST Rules — custom_eucast_rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"Define custom EUCAST rules organisation specific analysis use output function eucast_rules().","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"custom_eucast_rules(...)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"... Rules formula notation, see instructions, Examples.","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"organisations adoption EUCAST rules. function can used define custom EUCAST rules used eucast_rules() function.","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   two custom EUCAST rules: TZP (piperacillin/tazobactam) \"S\", aminopenicillins (ampicillin amoxicillin) must made \"S\", TZP \"R\", aminopenicillins must made \"R\". rules can also printed console, immediately clear work:   rules (part tilde, example TZP == \"S\" TZP == \"R\") must evaluable data set: able run filter data set without errors. means example column TZP must exist. create sample data set test rules set:","code":"x <- custom_eucast_rules(TZP == \"S\" ~ aminopenicillins == \"S\",                          TZP == \"R\" ~ aminopenicillins == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"S\" then set to  S : #>      amoxicillin (AMX), ampicillin (AMP) #> #>   2. If TZP is \"R\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) df <- data.frame(mo = c(\"Escherichia coli\", \"Klebsiella pneumoniae\"),                  TZP = as.sir(\"R\"),                  ampi = as.sir(\"S\"),                  cipro = as.sir(\"S\")) df #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    S     S  eucast_rules(df,              rules = \"custom\",              custom_rules = x,              info = FALSE,              overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    R     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"using-taxonomic-properties-in-rules","dir":"Reference","previous_headings":"","what":"Using taxonomic properties in rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"one exception columns used rules: column names microorganisms data set can also used, exist data set. column names : \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Thus, next example work well, despite fact df data set contain column genus:","code":"y <- custom_eucast_rules(   TZP == \"S\" & genus == \"Klebsiella\" ~ aminopenicillins == \"S\",   TZP == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\" )  eucast_rules(df,              rules = \"custom\",              custom_rules = y,              info = FALSE,              overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"rules set (y object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"usage-of-multiple-antimicrobials-and-antimicrobial-group-names","dir":"Reference","previous_headings":"","what":"Usage of multiple antimicrobials and antimicrobial group names","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"can define antimicrobial groups instead single antimicrobials rule consequence, part tilde (~). examples , antimicrobial group aminopenicillins includes ampicillin amoxicillin. Rules can also applied multiple antimicrobials antimicrobial groups simultaneously. Use c() function combine multiple antimicrobials. instance, following example sets aminopenicillins ureidopenicillins \"R\" column TZP (piperacillin/tazobactam) \"R\":   35 antimicrobial groups allowed rules (case-insensitive) can used combination: aminoglycosides(amikacin, amikacin/fosfomycin, apramycin, arbekacin, astromicin, bekanamycin, dibekacin, framycetin, gentamicin, gentamicin-high, habekacin, hygromycin, isepamicin, kanamycin, kanamycin-high, kanamycin/cephalexin, micronomicin, neomycin, netilmicin, pentisomicin, plazomicin, propikacin, ribostamycin, sisomicin, streptoduocin, streptomycin, streptomycin-high, tobramycin, tobramycin-high) aminopenicillins(amoxicillin ampicillin) antifungals(amorolfine, amphotericin B, amphotericin B-high, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole) antimycobacterials(4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin) betalactams(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, biapenem, carbenicillin, carindacillin, carumonam, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, ciclacillin, clometocillin, cloxacillin, dicloxacillin, doripenem, epicillin, ertapenem, flucloxacillin, hetacillin, imipenem, imipenem/EDTA, imipenem/relebactam, latamoxef, lenampicillin, loracarbef, mecillinam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, tebipenem, temocillin, ticarcillin, ticarcillin/clavulanic acid, tigemonam) betalactams_with_inhibitor(amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin/sulbactam, aztreonam/avibactam, aztreonam/nacubactam, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefoperazone/sulbactam, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefpodoxime/clavulanic acid, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, ceftolozane/tazobactam, ceftriaxone/beta-lactamase inhibitor, imipenem/relebactam, meropenem/nacubactam, meropenem/vaborbactam, mezlocillin/sulbactam, penicillin/novobiocin, penicillin/sulbactam, piperacillin/sulbactam, piperacillin/tazobactam, ticarcillin/clavulanic acid) carbapenems(biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem) cephalosporins(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) cephalosporins_1st(cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine) cephalosporins_2nd(cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef) cephalosporins_3rd(cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefetamet, cefetamet pivoxil, cefixime, cefmenoxime, cefodizime, cefoperazone, cefoperazone/sulbactam, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotiam hexetil, cefovecin, cefpimizole, cefpiramide, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefsulodin, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, latamoxef) cephalosporins_4th(cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome) cephalosporins_5th(ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam) cephalosporins_except_caz(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) fluoroquinolones(besifloxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, pazufloxacin, pefloxacin, pefloxacin screening test, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) glycopeptides(avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod) glycopeptides_except_lipo(avoparcin, bleomycin, norvancomycin, ramoplanin, teicoplanin, teicoplanin-macromethod, vancomycin, vancomycin-macromethod) isoxazolylpenicillins(cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test) lincosamides(clindamycin, lincomycin, pirlimycin) lipoglycopeptides(dalbavancin, oritavancin, telavancin) macrolides(acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin) monobactams(aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam) nitrofurans(furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone) oxazolidinones(cadazolid, cycloserine, linezolid, tedizolid, thiacetazone) penicillins(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, carbenicillin, carindacillin, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, temocillin, ticarcillin, ticarcillin/clavulanic acid) phenicols(chloramphenicol, florfenicol, thiamphenicol) polymyxins(colistin, polymyxin B, polymyxin B/polysorbate 80) quinolones(besifloxacin, cinoxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nalidixic acid screening test, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pefloxacin screening test, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) rifamycins(rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine) streptogramins(pristinamycin quinupristin/dalfopristin) sulfonamides(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea) tetracyclines(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline) tetracyclines_except_tgc(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test) trimethoprims(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadiazine/trimethoprim, sulfadimethoxine, sulfadimidine, sulfadimidine/trimethoprim, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamerazine/trimethoprim, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfametrole/trimethoprim, sulfamoxole, sulfamoxole/trimethoprim, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea, trimethoprim, trimethoprim/sulfamethoxazole) ureidopenicillins(azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam)","code":"x <- custom_eucast_rules(TZP == \"R\" ~ c(aminopenicillins, ureidopenicillins) == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"R\" then set to \"R\": #>      amoxicillin (AMX), ampicillin (AMP), azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"x <- custom_eucast_rules(   AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",   AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\" ) x #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP)  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): eucast_rules(example_isolates,   rules = \"custom\",   custom_rules = x,   info = FALSE,   overwrite = TRUE,   verbose = TRUE ) #> # A tibble: 8 × 9 #>     row col   mo_fullname     old   new   rule  rule_group rule_name rule_source #>   <int> <chr> <chr>           <ord> <chr> <chr> <chr>      <chr>     <chr>       #> 1    33 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 2    33 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 3    34 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 4    34 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 5   531 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 6   531 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 7  1485 AMP   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 8  1485 AMX   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'…  # combine rule sets x2 <- c(   x,   custom_eucast_rules(TZP == \"R\" ~ carbapenems == \"R\") ) x2 #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   3. If TZP is  R  then set to  R : #>      biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), #>      imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), #>      meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), #>      razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP)"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom MDRO Guideline — custom_mdro_guideline","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Define custom MDRO guideline organisation specific analysis use output function mdro().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"custom_mdro_guideline(..., as_factor = TRUE)  # S3 method for class 'custom_mdro_guideline' c(x, ..., as_factor = NULL)"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"... Guideline rules formula notation, see instructions, Examples. as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector. combining rules sets (using c()) value inherited first set default. x Existing custom MDRO rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data.","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   row/isolate matches first rule, value first ~ (case 'Elderly Type ') set MDRO value. Otherwise, second rule tried . number rules unlimited. can print rules set console overview. Colours help reading console supports colours.   outcome function can used guideline argument mdro() function:   Rules can also combined custom rules using c():","code":"custom <- custom_mdro_guideline(CIP == \"R\" & age > 60 ~ \"Elderly Type A\",                                 ERY == \"R\" & age > 60 ~ \"Elderly Type B\") custom #> A set of custom MDRO rules: #>   1. If CIP is R and age is higher than 60 then: Elderly Type A #>   2. If ERY is R and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B x <- mdro(example_isolates, guideline = custom) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> => Found 930 custom defined MDROs out of 2000 isolates (46.5%)  table(x) #> x #>       Negative  Elderly Type A  Elderly Type B #>           1070             198             732 x <- mdro(example_isolates,           guideline = c(custom,                         custom_mdro_guideline(ERY == \"R\" & age > 50 ~ \"Elderly Type C\"))) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B < Elderly Type C. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> - Custom MDRO rule 3: ERY == \"R\" & age > 50 (109 rows matched) #> => Found 1039 custom defined MDROs out of 2000 isolates (52.0%)  table(x) #> x #>       Negative  Elderly Type A  Elderly Type B  Elderly Type C #>            961             198             732             109"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"usage-of-multiple-antimicrobials-and-antimicrobial-group-names","dir":"Reference","previous_headings":"","what":"Usage of multiple antimicrobials and antimicrobial group names","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"can define antimicrobial groups instead single antimicrobials rule , part tilde (~). Use () () specify scope antimicrobial group:   35 antimicrobial selectors supported use rules: aminoglycosides() can select:  amikacin, amikacin/fosfomycin, apramycin, arbekacin, astromicin, bekanamycin, dibekacin, framycetin, gentamicin, gentamicin-high, habekacin, hygromycin, isepamicin, kanamycin, kanamycin-high, kanamycin/cephalexin, micronomicin, neomycin, netilmicin, pentisomicin, plazomicin, propikacin, ribostamycin, sisomicin, streptoduocin, streptomycin, streptomycin-high, tobramycin, tobramycin-high aminopenicillins() can select:  amoxicillin ampicillin antifungals() can select:  amorolfine, amphotericin B, amphotericin B-high, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole antimycobacterials() can select:  4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin betalactams() can select:  amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, biapenem, carbenicillin, carindacillin, carumonam, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, ciclacillin, clometocillin, cloxacillin, dicloxacillin, doripenem, epicillin, ertapenem, flucloxacillin, hetacillin, imipenem, imipenem/EDTA, imipenem/relebactam, latamoxef, lenampicillin, loracarbef, mecillinam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, tebipenem, temocillin, ticarcillin, ticarcillin/clavulanic acid, tigemonam betalactams_with_inhibitor() can select:  amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin/sulbactam, aztreonam/avibactam, aztreonam/nacubactam, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefoperazone/sulbactam, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefpodoxime/clavulanic acid, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, ceftolozane/tazobactam, ceftriaxone/beta-lactamase inhibitor, imipenem/relebactam, meropenem/nacubactam, meropenem/vaborbactam, mezlocillin/sulbactam, penicillin/novobiocin, penicillin/sulbactam, piperacillin/sulbactam, piperacillin/tazobactam, ticarcillin/clavulanic acid carbapenems() can select:  biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem cephalosporins() can select:  cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef cephalosporins_1st() can select:  cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine cephalosporins_2nd() can select:  cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef cephalosporins_3rd() can select:  cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefetamet, cefetamet pivoxil, cefixime, cefmenoxime, cefodizime, cefoperazone, cefoperazone/sulbactam, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotiam hexetil, cefovecin, cefpimizole, cefpiramide, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefsulodin, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, latamoxef cephalosporins_4th() can select:  cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome cephalosporins_5th() can select:  ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam fluoroquinolones() can select:  besifloxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, pazufloxacin, pefloxacin, pefloxacin screening test, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin glycopeptides() can select:  avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod isoxazolylpenicillins() can select:  cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test lincosamides() can select:  clindamycin, lincomycin, pirlimycin lipoglycopeptides() can select:  dalbavancin, oritavancin, telavancin macrolides() can select:  acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin monobactams() can select:  aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam nitrofurans() can select:  furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone oxazolidinones() can select:  cadazolid, cycloserine, linezolid, tedizolid, thiacetazone penicillins() can select:  amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, carbenicillin, carindacillin, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, temocillin, ticarcillin, ticarcillin/clavulanic acid phenicols() can select:  chloramphenicol, florfenicol, thiamphenicol polymyxins() can select:  colistin, polymyxin B, polymyxin B/polysorbate 80 quinolones() can select:  besifloxacin, cinoxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nalidixic acid screening test, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pefloxacin screening test, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin rifamycins() can select:  rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine streptogramins() can select:  pristinamycin quinupristin/dalfopristin sulfonamides() can select:  brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea tetracyclines() can select:  cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline trimethoprims() can select:  brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadiazine/trimethoprim, sulfadimethoxine, sulfadimidine, sulfadimidine/trimethoprim, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamerazine/trimethoprim, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfametrole/trimethoprim, sulfamoxole, sulfamoxole/trimethoprim, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea, trimethoprim, trimethoprim/sulfamethoxazole ureidopenicillins() can select:  azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam","code":"custom_mdro_guideline(   AMX == \"R\"                       ~ \"My MDRO #1\",   any(cephalosporins_2nd() == \"R\") ~ \"My MDRO #2\",   all(glycopeptides() == \"R\")      ~ \"My MDRO #3\" )"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"x <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) x #> A set of custom MDRO rules: #>   1. If CIP is  R  and age is higher than 60 then: Elderly Type A #>   2. If ERY is  R  and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): out <- mdro(example_isolates, guideline = x) table(out) #> out #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732   out <- mdro(example_isolates, guideline = x, verbose = TRUE) head(out) #>    row_number microorganism           MDRO #> V1          1          <NA> Elderly Type B #> V2          2          <NA> Elderly Type B #> V3          3          <NA>       Negative #> V4          4          <NA>       Negative #> V5          5          <NA>       Negative #> V6          6          <NA>       Negative #>                                   reason #> V1 matched rule 2: ERY == \"R\" & age > 60 #> V2 matched rule 2: ERY == \"R\" & age > 60 #> V3                      no rules matched #> V4                      no rules matched #> V5                      no rules matched #> V6                      no rules matched #>                               all_nonsusceptible_columns        guideline #> V1 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V2 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V3                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V4                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V5                PEN, FLC, CXM, CAZ, TMP, ERY, AZM, COL Custom guideline #> V6           PEN, FLC, CXM, CAZ, TMP, ERY, CLI, AZM, COL Custom guideline  # you can create custom guidelines using selectors (see ?antimicrobial_selectors) my_guideline <- custom_mdro_guideline(   AMX == \"R\" ~ \"Custom MDRO 1\",   all(cephalosporins_2nd() == \"R\") ~ \"Custom MDRO 2\" ) my_guideline #> A set of custom MDRO rules: #>   1. If AMX is  R  then: Custom MDRO 1 #>   2. If all of cephalosporins_2nd() is  R  then: Custom MDRO 2 #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Custom MDRO 1 < Custom MDRO 2  out <- mdro(example_isolates, guideline = my_guideline) #> ℹ For `cephalosporins_2nd()` using columns 'CXM' (cefuroxime) and 'FOX' #>   (cefoxitin) #> ℹ Assuming a filter on all 2 cephalosporins_2nd. Wrap around `all()` or #>   `any()` to prevent this note. table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>          1144           804            52"},{"path":"https://amr-for-r.org/reference/dosage.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"EUCAST breakpoints used package based dosages data set. can retrieved eucast_dosage().","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage"},{"path":"https://amr-for-r.org/reference/dosage.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"tibble 759 observations 9 variables: ab Antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available name Official name antimicrobial drug used WHONET/EARS-Net type Type dosage, either \"high_dosage\", \"standard_dosage\", \"uncomplicated_uti\" dose Dose, \"2 g\" \"25 mg/kg\" dose_times Number times dose must administered administration Route administration, either \"\", \"im\", \"iv\", \"oral\" notes Additional dosage notes original_txt Original text PDF file EUCAST eucast_version Version number EUCAST Clinical Breakpoints guideline dosages apply, either 15, 14, 13.1, 12, 11","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage #> # A tibble: 759 × 9 #>    ab   name            type  dose  dose_times administration notes original_txt #>    <ab> <chr>           <chr> <chr>      <int> <chr>          <chr> <chr>        #>  1 AMK  Amikacin        stan… 25-3…          1 iv             \"\"    \"25-30 mg/k… #>  2 AMX  Amoxicillin     high… 2 g            6 iv             \"\"    \"2 g x 6 iv\" #>  3 AMX  Amoxicillin     stan… 1 g            3 iv             \"\"    \"1 g x 3-4 … #>  4 AMX  Amoxicillin     high… 0.75…          3 oral           \"\"    \"0.75-1 g x… #>  5 AMX  Amoxicillin     stan… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  6 AMX  Amoxicillin     unco… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  7 AMC  Amoxicillin/cl… high… 2 g …          3 iv             \"\"    \"(2 g amoxi… #>  8 AMC  Amoxicillin/cl… stan… 1 g …          3 iv             \"\"    \"(1 g amoxi… #>  9 AMC  Amoxicillin/cl… high… 0.87…          3 oral           \"\"    \"(0.875 g a… #> 10 AMC  Amoxicillin/cl… stan… 0.5 …          3 oral           \"\"    \"(0.5 g amo… #> # ℹ 749 more rows #> # ℹ 1 more variable: eucast_version <dbl>"},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 500 ESBL Isolates — esbl_isolates","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"data set containing 500 microbial isolates MIC values common antibiotics binary esbl column extended-spectrum beta-lactamase (ESBL) production. data set contains randomised fictitious data reflects reality can used practise AMR-related machine learning, e.g., classification modelling tidymodels.","code":""},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"","code":"esbl_isolates"},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"tibble 500 observations 19 variables: esbl Logical indicator isolate ESBL-producing genus Genus microorganism AMC:COL MIC values 17 antimicrobial agents, transformed class mic (see .mic())","code":""},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"See tidymodels integration example using data set.","code":""},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"","code":"esbl_isolates #> # A tibble: 500 × 19 #>    esbl  genus   AMC   AMP   TZP   CXM   FOX   CTX   CAZ   GEN   TOB   TMP   SXT #>    <lgl> <chr> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> #>  1 FALSE Esch…    32    32     4    64    64  8.00  8.00     1     1  16.0    20 #>  2 FALSE Esch…    32    32     4    64    64  4.00  8.00     1     1  16.0   320 #>  3 FALSE Esch…     4     2    64     8     4  8.00  0.12    16    16   0.5    20 #>  4 FALSE Kleb…    32    32    16    64    64  8.00  8.00     1     1   0.5    20 #>  5 FALSE Esch…    32    32     4     4     4  0.25  2.00     1     1  16.0   320 #>  6 FALSE Citr…    32    32    16    64    64 64.00 32.00     1     1   0.5    20 #>  7 FALSE Morg…    32    32     4    64    64 16.00  2.00     1     1   0.5    20 #>  8 FALSE Prot…    16    32     4     1     4  8.00  0.12     1     1  16.0   320 #>  9 FALSE Ente…    32    32     8    64    64 32.00  4.00     1     1   0.5    20 #> 10 FALSE Citr…    32    32    32    64    64  8.00 64.00     1     1  16.0   320 #> # ℹ 490 more rows #> # ℹ 6 more variables: NIT <mic>, FOS <mic>, CIP <mic>, IPM <mic>, MEM <mic>, #> #   COL <mic>"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply EUCAST Rules — eucast_rules","title":"Apply EUCAST Rules — eucast_rules","text":"Apply rules clinical breakpoints notes expected resistant phenotypes defined European Committee Antimicrobial Susceptibility Testing (EUCAST, https://www.eucast.org), see Source. Use eucast_dosage() get data.frame advised dosages certain bug-drug combination, based dosage data set. improve interpretation antibiogram EUCAST rules applied, non-EUCAST rules can applied default, see Details.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"eucast_rules(x, col_mo = NULL, info = interactive(),   rules = getOption(\"AMR_eucastrules\", default = c(\"breakpoints\",   \"expected_phenotypes\")), verbose = FALSE, version_breakpoints = 15,   version_expected_phenotypes = 1.2, version_expertrules = 3.3,   ampc_cephalosporin_resistance = NA, only_sir_columns = any(is.sir(x)),   custom_rules = NULL, overwrite = FALSE, ...)  eucast_dosage(ab, administration = \"iv\", version_breakpoints = 15)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Apply EUCAST Rules — eucast_rules","text":"EUCAST Expert Rules. Version 2.0, 2012. Leclercq et al. EUCAST expert rules antimicrobial susceptibility testing. Clin Microbiol Infect. 2013;19(2):141-60; doi:10.1111/j.1469-0691.2011.03703.x EUCAST Expert Rules, Intrinsic Resistance Exceptional Phenotypes Tables. Version 3.1, 2016. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.2, 2020. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.3, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 9.0, 2019. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 10.0, 2020. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 11.0, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 12.0, 2022. (link)","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply EUCAST Rules — eucast_rules","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). info logical indicate whether progress printed console - default print interactive sessions. rules character vector specifies rules applied. Must one \"breakpoints\", \"expected_phenotypes\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expected_phenotypes\"). default value can set another value using package option AMR_eucastrules: options(AMR_eucastrules = \"\"). using \"custom\", sure fill argument custom_rules . Custom rules can created custom_eucast_rules(). verbose logical turn Verbose mode (default ). Verbose mode, function apply rules data, instead returns data set logbook form extensive info rows columns effected way. Using Verbose mode takes lot time. version_breakpoints version number use EUCAST Clinical Breakpoints guideline. Can \"15.0\", \"14.0\", \"13.1\", \"12.0\", \"11.0\", \"10.0\". version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\". version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\". ampc_cephalosporin_resistance (applies rules contains \"expert\" \"\") character value applied cefotaxime, ceftriaxone ceftazidime AmpC de-repressed cephalosporin-resistant mutants - default NA. Currently works version_expertrules 3.2 higher; versions 'EUCAST Expert Rules Enterobacterales' state results cefotaxime, ceftriaxone ceftazidime reported note, results suppressed (emptied) three drugs. value NA (default) argument remove results three drugs, e.g. value \"R\" make results drugs resistant. Use NULL FALSE alter results three drugs AmpC de-repressed cephalosporin-resistant mutants. Using TRUE equal using \"R\".  EUCAST Expert Rules v3.2, rule applies : Citrobacter braakii, Citrobacter freundii, Citrobacter gillenii, Citrobacter murliniae, Citrobacter rodenticum, Citrobacter sedlakii, Citrobacter werkmanii, Citrobacter youngae, Enterobacter, Hafnia alvei, Klebsiella aerogenes, Morganella morganii, Providencia, Serratia. only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. custom_rules Custom rules apply, created custom_eucast_rules(). overwrite logical indicating whether overwrite existing SIR values (default: FALSE). FALSE, non-SIR values modified (.e., value already S, R). ensure compliance EUCAST guidelines, remain FALSE, EUCAST notes often state organism \"tested susceptibility individual agents reported resistant\". ... Column names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning. ab (vector ) text can coerced valid antimicrobial drug code .ab(). administration Route administration, either \"\", \"im\", \"iv\", \"oral\".","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply EUCAST Rules — eucast_rules","text":"input x, possibly edited values antimicrobials. , verbose = TRUE, data.frame original new values affected bug-drug combinations.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply EUCAST Rules — eucast_rules","text":"Note: function translate MIC values SIR values. Use .sir() . Note: ampicillin (AMP, J01CA01) available amoxicillin (AMX, J01CA04) , latter used rules dependency ampicillin. drugs interchangeable comes expression antimicrobial resistance. file containing EUCAST rules located : https://github.com/msberends/AMR/blob/main/data-raw/eucast_rules.tsv.  Note: Old taxonomic names replaced current taxonomy applicable. example, Ochrobactrum anthropi renamed Brucella anthropi 2020; original EUCAST rules v3.1 v3.2 yet contain new taxonomic name. AMR package contains full microbial taxonomy updated June 24th, 2024, see microorganisms.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"custom-rules","dir":"Reference","previous_headings":"","what":"Custom Rules","title":"Apply EUCAST Rules — eucast_rules","text":"Custom rules can created using custom_eucast_rules(), e.g.:","code":"x <- custom_eucast_rules(AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",                          AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\")  eucast_rules(example_isolates, rules = \"custom\", custom_rules = x)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"-other-rules","dir":"Reference","previous_headings":"","what":"'Other' Rules","title":"Apply EUCAST Rules — eucast_rules","text":"processing, two non-EUCAST rules drug combinations can applied improve efficacy EUCAST rules, reliability data (analysis). rules : drug enzyme inhibitor set S drug without enzyme inhibitor S drug without enzyme inhibitor set R drug enzyme inhibitor R Important examples include amoxicillin amoxicillin/clavulanic acid, trimethoprim trimethoprim/sulfamethoxazole. Needless say, rules work, drugs must available data set. Since rules officially approved EUCAST, applied default. use rules, include \"\" rules argument, use eucast_rules(..., rules = \"\"). can also set package option AMR_eucastrules, .e. run options(AMR_eucastrules = \"\").","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Apply EUCAST Rules — eucast_rules","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"# \\donttest{ a <- data.frame(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylpenicillin   FOX = \"S\", # Cefoxitin   stringsAsFactors = FALSE )  head(a) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   -   -   -   -   S   S #> 2  Enterococcus faecalis   -   -   -   -   -   S   S #> 3       Escherichia coli   -   -   -   -   -   S   S #> 4  Klebsiella pneumoniae   -   -   -   -   -   S   S #> 5 Pseudomonas aeruginosa   -   -   -   -   -   S   S   # apply EUCAST rules: some results wil be changed b <- eucast_rules(a, overwrite = TRUE) #> Warning: in `eucast_rules()`: not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir))  head(b) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   S   R   R   S   S   S #> 2  Enterococcus faecalis   -   -   R   R   R   S   R #> 3       Escherichia coli   R   -   -   -   -   R   S #> 4  Klebsiella pneumoniae   R   R   -   -   -   R   S #> 5 Pseudomonas aeruginosa   R   R   -   -   R   R   R   # do not apply EUCAST rules, but rather get a data.frame # containing all details about the transformations: c <- eucast_rules(a, overwrite = TRUE, verbose = TRUE) #> Warning: in `eucast_rules()`: not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir)) head(c) #>   row col           mo_fullname old new rule          rule_group #> 1   1 AMX Staphylococcus aureus   -   S              Breakpoints #> 2   1 CXM Staphylococcus aureus   -   S              Breakpoints #> 3   1 CAZ Staphylococcus aureus   -   R      Expected phenotypes #> 4   1 COL Staphylococcus aureus   -   R      Expected phenotypes #> 5   2 CAZ Enterococcus faecalis   -   R      Expected phenotypes #> 6   2 COL Enterococcus faecalis   -   R      Expected phenotypes #>                                                         rule_name #> 1                                                  Staphylococcus #> 2                                                  Staphylococcus #> 3 Table 4: Expected resistant phenotype in gram-positive bacteria #> 4 Table 4: Expected resistant phenotype in gram-positive bacteria #> 5 Table 4: Expected resistant phenotype in gram-positive bacteria #> 6 Table 4: Expected resistant phenotype in gram-positive bacteria #>                                         rule_source #> 1   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 2   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 3 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 4 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 5 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 6 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 # }  # Dosage guidelines:  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\") #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v15.0 (2025). This note will be shown once per session. #> # A tibble: 3 × 5 #>   ab   name          standard_dosage  high_dosage  eucast_version #>   <ab> <chr>         <chr>            <chr>                 <dbl> #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA                       15 #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA                       15 #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv             15  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\", version_breakpoints = 10) #> # A tibble: 3 × 5 #>   ab   name          standard_dosage high_dosage eucast_version #>   <ab> <chr>         <chr>           <chr>                <dbl> #> 1 TOB  Tobramycin    NA              NA                      NA #> 2 GEN  Gentamicin    NA              NA                      NA #> 3 CIP  Ciprofloxacin NA              NA                      NA"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 2 000 Example Isolates — example_isolates","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"data set containing 2 000 microbial isolates full antibiograms. data set contains randomised fictitious data, reflects reality can used practise AMR data analysis. examples, please read tutorial website.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"tibble 2 000 observations 46 variables: date Date receipt laboratory patient ID patient age Age patient gender Gender patient, either \"F\" \"M\" ward Ward type patient admitted, either \"Clinical\", \"ICU\", \"Outpatient\" mo ID microorganism created .mo(), see also microorganisms data set PEN:RIF 40 different antimicrobials class sir (see .sir()); column names occur antimicrobials data set can translated set_ab_names() ab_name()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Unclean Data — example_isolates_unclean","title":"Data Set with Unclean Data — example_isolates_unclean","text":"data set containing 3 000 microbial isolates cleaned consequently ready AMR data analysis. data set can used practice.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Unclean Data — example_isolates_unclean","text":"tibble 3 000 observations 8 variables: patient_id ID patient date date receipt laboratory hospital ID hospital, C bacteria info microorganism can transformed .mo(), see also microorganisms AMX:GEN 4 different antimicrobials transformed .sir()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Unclean Data — example_isolates_unclean","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":null,"dir":"Reference","previous_headings":"","what":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"Export Data Set NCBI BioSample Antibiogram","code":""},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"","code":"export_ncbi_biosample(x, filename = paste0(\"biosample_\", format(Sys.time(),   \"%Y-%m-%d-%H%M%S\"), \".xlsx\"), type = \"pathogen MIC\",   columns = where(is.mic), save_as_xlsx = TRUE)"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"x data set. filename character string specifying file name. type character string specifying type data set, either \"pathogen MIC\" \"beta-lactamase MIC\", see https://www.ncbi.nlm.nih.gov/biosample/docs/.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine First Isolates — first_isolate","title":"Determine First Isolates — first_isolate","text":"Determine first isolates microorganisms every patient per episode (needed) per specimen type. functions support four methods summarised Hindler et al. 2007 (doi:10.1086/511864 ). determine patient episodes necessarily based microorganisms, use is_new_episode() also supports grouping dplyr package.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine First Isolates — first_isolate","text":"","code":"first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, col_testcode = NULL, col_specimen = NULL,   col_icu = NULL, col_keyantimicrobials = NULL, episode_days = 365,   testcodes_exclude = NULL, icu_exclude = FALSE, specimen_group = NULL,   type = \"points\", method = c(\"phenotype-based\", \"episode-based\",   \"patient-based\", \"isolate-based\"), ignore_I = TRUE, points_threshold = 2,   info = interactive(), include_unknown = FALSE,   include_untested_sir = TRUE, ...)  filter_first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, episode_days = 365, method = c(\"phenotype-based\",   \"episode-based\", \"patient-based\", \"isolate-based\"), ...)"},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine First Isolates — first_isolate","text":"Methodology functions strictly based : M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. Hindler JF Stelling J (2007). Analysis Presentation Cumulative Antibiograms: New Consensus Guideline Clinical Laboratory Standards Institute. Clinical Infectious Diseases, 44(6), 867-873. doi:10.1086/511864","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine First Isolates — first_isolate","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_date Column name result date (date received lab) - default first column date class. col_patient_id Column name unique IDs patients - default first column starts 'patient' 'patid' (case insensitive). col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). col_testcode Column name test codes. Use col_testcode = NULL exclude certain test codes (test codes screening). case testcodes_exclude ignored. col_specimen Column name specimen type group. col_icu Column name logicals (TRUE/FALSE) whether ward department Intensive Care Unit (ICU). can also logical vector length rows x. col_keyantimicrobials (useful method = \"phenotype-based\") column name key antimicrobials determine first isolates, see key_antimicrobials(). default first column starts 'key' followed 'ab' 'antibiotics' 'antimicrobials' (case insensitive). Use col_keyantimicrobials = FALSE prevent . Can also output key_antimicrobials(). episode_days Episode days genus/species combination determined 'first isolate' . default 365 days based guideline CLSI, see Source. testcodes_exclude character vector test codes excluded (case-insensitive). icu_exclude logical indicate whether ICU isolates excluded (rows value TRUE column set col_icu). specimen_group Value column set col_specimen filter . type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. method method apply, either \"phenotype-based\", \"episode-based\", \"patient-based\" \"isolate-based\" (can abbreviated), see Details. default \"phenotype-based\" antimicrobial test results present data, \"episode-based\" otherwise. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details. info logical indicate info printed - default TRUE interactive mode. include_unknown logical indicate whether 'unknown' microorganisms included , .e. microbial code \"UNKNOWN\", defaults FALSE. WHONET users, means records organism code \"con\" (contamination) excluded default. Isolates microbial ID NA always excluded first isolate. include_untested_sir logical indicate whether also rows without antibiotic results still eligible becoming first isolate. Use include_untested_sir = FALSE always return FALSE rows. checks data set columns class sir consequently requires transforming columns antibiotic results using .sir() first. ... Arguments passed first_isolate() using filter_first_isolate(), otherwise arguments passed key_antimicrobials() (universal, gram_negative, gram_positive).","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine First Isolates — first_isolate","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine First Isolates — first_isolate","text":"methodology implemented functions strictly based recommendations outlined CLSI Guideline M39 research overview Hindler et al. (2007, doi:10.1086/511864 ). conduct epidemiological analyses antimicrobial resistance data, -called first isolates included prevent overestimation underestimation antimicrobial resistance. Different methods can used , see . functions context-aware. means x argument can left blank used inside data.frame call, see Examples. first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names. isolates microbial ID NA excluded first isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"different-methods","dir":"Reference","previous_headings":"","what":"Different methods","title":"Determine First Isolates — first_isolate","text":"According previously-mentioned sources, different methods (algorithms) select first isolates increasing reliability: isolate-based, patient-based, episode-based phenotype-based. methods select combination taxonomic genus species (subspecies). mentioned methods covered first_isolate() function:","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"isolate-based","dir":"Reference","previous_headings":"","what":"Isolate-based","title":"Determine First Isolates — first_isolate","text":"method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"patient-based","dir":"Reference","previous_headings":"","what":"Patient-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient , set episode_days Inf. method makes sure duplicate isolates selected patient. method preferred e.g. identify first MRSA finding patient determine incidence. Conversely, large longitudinal data set, mean isolates excluded found years initial isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"episode-based","dir":"Reference","previous_headings":"","what":"Episode-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, 14, 30, 60 365. Short episodes common analysing specific hospital ward data ICU cases, long episodes common analysing regional national data. common method correct duplicate isolates. Patients categorised episodes based ID dates (e.g., date specimen receipt laboratory result). common method, take account antimicrobial test results. means e.g. methicillin-resistant Staphylococcus aureus (MRSA) isolate differentiated wildtype Staphylococcus aureus isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"phenotype-based","dir":"Reference","previous_headings":"","what":"Phenotype-based","title":"Determine First Isolates — first_isolate","text":"reliable method, since also weighs antibiogram (antimicrobial test results) yielding -called 'first weighted isolates'. two different methods weigh antibiogram: Using type = \"points\" argument points_threshold (default) method weighs antimicrobial drugs available data set. difference S R (vice versa) counts 0.5 points, difference S R (vice versa) counts 1 point. sum points exceeds points_threshold, defaults 2, isolate selected first weighted isolate. antimicrobials internally selected using all_antimicrobials() function. output function need passed first_isolate() function. Using type = \"keyantimicrobials\" argument ignore_I method weighs specific antimicrobial drugs, called key antimicrobials. difference S R (vice versa) key antimicrobials select isolate first weighted isolate. ignore_I = FALSE, also differences S R (vice versa) lead . Key antimicrobials internally selected using key_antimicrobials() function, can also added manually variable data set col_keyantimicrobials argument. Another option pass output key_antimicrobials() function directly col_keyantimicrobials argument. default method phenotype-based (using type = \"points\") episode-based (using episode_days = 365). makes sure every genus-species combination selected per patient per year, taking account antimicrobial test results. antimicrobial test results available data set, episode-based method applied default.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine First Isolates — first_isolate","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  example_isolates[first_isolate(info = TRUE), ] #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'date' as input for `col_date`. #> ℹ Using column 'patient' as input for `col_patient_id`. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # \\donttest{ # get all first Gram-negatives example_isolates[which(first_isolate(info = FALSE) & mo_is_gram_negative()), ] #> ℹ Using column 'mo' as input for `mo_is_gram_negative()` #> # A tibble: 441 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  7 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #>  8 2002-03-16 4FC193     69 M      Clinical B_PSDMN_AERG   R     NA    NA    R   #>  9 2002-04-01 496896     46 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> 10 2002-04-23 EE2510     69 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> # ℹ 431 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   # filter on first isolates using dplyr:   example_isolates %>%     filter(first_isolate(info = TRUE)) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # short-hand version:   example_isolates %>%     filter_first_isolate(info = FALSE) } #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # flag the first isolates per group:   example_isolates %>%     group_by(ward) %>%     mutate(first = first_isolate(info = TRUE)) %>%     select(ward, date, patient, mo, first) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #>  #> Group: ward = \"Clinical\" #> ℹ Excluding 9 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 865 'phenotype-based' first isolates (70.1% of total where a #>    microbial ID was available) #>  #> Group: ward = \"ICU\" #> ℹ Excluding 6 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 452 'phenotype-based' first isolates (70.0% of total where a #>    microbial ID was available) #>  #> Group: ward = \"Outpatient\" #> ℹ Excluding 1 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 99 'phenotype-based' first isolates (82.5% of total where a #>    microbial ID was available) #> # A tibble: 2,000 × 5 #> # Groups:   ward [3] #>    ward     date       patient mo           first #>    <chr>    <date>     <chr>   <mo>         <lgl> #>  1 Clinical 2002-01-02 A77334  B_ESCHR_COLI TRUE  #>  2 Clinical 2002-01-03 A77334  B_ESCHR_COLI FALSE #>  3 ICU      2002-01-07 067927  B_STPHY_EPDR TRUE  #>  4 ICU      2002-01-07 067927  B_STPHY_EPDR FALSE #>  5 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  6 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  7 Clinical 2002-01-14 462729  B_STPHY_AURS TRUE  #>  8 Clinical 2002-01-14 462729  B_STPHY_AURS FALSE #>  9 ICU      2002-01-16 067927  B_STPHY_EPDR TRUE  #> 10 ICU      2002-01-17 858515  B_STPHY_EPDR TRUE  #> # ℹ 1,990 more rows # }"},{"path":"https://amr-for-r.org/reference/g.test.html","id":null,"dir":"Reference","previous_headings":"","what":"G-test for Count Data — g.test","title":"G-test for Count Data — g.test","text":"g.test() performs chi-squared contingency table tests goodness--fit tests, just like chisq.test() reliable (1). G-test can used see whether number observations category fits theoretical expectation (called G-test goodness--fit), see whether proportions one variable different different values variable (called G-test independence).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"G-test for Count Data — g.test","text":"","code":"g.test(x, y = NULL, p = rep(1/length(x), length(x)), rescale.p = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"G-test for Count Data — g.test","text":"code function identical chisq.test(), except : calculation statistic changed \\(2 * sum(x * log(x / E))\\) Yates' continuity correction removed apply G-test possibility simulate p values simulate.p.value removed","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"G-test for Count Data — g.test","text":"x numeric vector matrix. x y can also     factors. y numeric vector; ignored x matrix.      x factor, y factor length. p vector probabilities length x.     error given entry p negative. rescale.p logical scalar; TRUE p rescaled     (necessary) sum 1.  rescale.p FALSE,     p sum 1, error given.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"G-test for Count Data — g.test","text":"list class \"htest\" containing following   components: statistic value chi-squared test statistic. parameter degrees freedom approximate     chi-squared distribution test statistic, NA     p-value computed Monte Carlo simulation. p.value p-value test. method character string indicating type test     performed, whether Monte Carlo simulation continuity     correction used. data.name character string giving name(s) data. observed observed counts. expected expected counts null hypothesis. residuals Pearson residuals,     (observed - expected) / sqrt(expected). stdres standardized residuals,     (observed - expected) / sqrt(V), V     residual cell variance (Agresti, 2007, section 2.4.5     case x matrix, n * p * (1 - p) otherwise).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"G-test for Count Data — g.test","text":"x matrix one row column, x vector y given, goodness--fit test performed (x treated one-dimensional contingency table). entries x must non-negative integers. case, hypothesis tested whether population probabilities equal p, equal p given. x matrix least two rows columns, taken two-dimensional contingency table: entries x must non-negative integers.  Otherwise, x y must vectors factors length; cases missing values removed, objects coerced factors, contingency table computed .  Pearson's chi-squared test performed null hypothesis joint distribution cell counts 2-dimensional contingency table product row column marginals. p-value computed asymptotic chi-squared distribution test statistic. contingency table case simulation done random sampling set contingency tables given marginals, works marginals strictly positive. Note usual sampling situation assumed chi-squared test (G-test) rather Fisher's exact test. goodness--fit case simulation done random sampling discrete distribution specified p, sample size n = sum(x). simulation done R may slow.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-goodness-of-fit-likelihood-ratio-test-","dir":"Reference","previous_headings":"","what":"G-test Of Goodness-of-Fit (Likelihood Ratio Test)","title":"G-test for Count Data — g.test","text":"Use G-test goodness--fit one nominal variable two values (male female, red, pink white flowers). compare observed counts numbers observations category expected counts, calculate using kind theoretical expectation (1:1 sex ratio 1:2:1 ratio genetic cross). expected number observations category small, G-test may give inaccurate results, use exact test instead (fisher.test()). G-test goodness--fit alternative chi-square test goodness--fit (chisq.test()); tests advantages disadvantages, results two tests usually similar.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-independence","dir":"Reference","previous_headings":"","what":"G-test of Independence","title":"G-test for Count Data — g.test","text":"Use G-test independence two nominal variables, two possible values. want know whether proportions one variable different among values variable. also possible G-test independence two nominal variables. example, Jackson et al. (2013) also data children 3, analysis old vs. young, thigh vs. arm, reaction vs. reaction, analyzed together. Fisher's exact test (fisher.test()) exact test, G-test still approximation. 2x2 table, Fisher's Exact test may slower still run seconds, even sum observations multiple millions. G-test independence alternative chi-square test independence (chisq.test()), give approximately results.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"how-the-test-works","dir":"Reference","previous_headings":"","what":"How the Test Works","title":"G-test for Count Data — g.test","text":"Unlike exact test goodness--fit (fisher.test()), G-test directly calculate probability obtaining observed results something extreme. Instead, like almost statistical tests, G-test intermediate step; uses data calculate test statistic measures far observed data null expectation. use mathematical relationship, case chi-square distribution, estimate probability obtaining value test statistic. G-test uses log ratio two likelihoods test statistic, also called likelihood ratio test log-likelihood ratio test. formula calculate G-statistic : \\(G = 2 * sum(x * log(x / E))\\) E expected values. Since chi-square distributed, p value can calculated R :   df degrees freedom. two categories want find ones significantly different null expectation, can use method testing category vs. sum categories, Bonferroni correction. use G-tests category, course.","code":"p <- stats::pchisq(G, df, lower.tail = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"G-test for Count Data — g.test","text":"McDonald, J.H. 2014. Handbook Biological Statistics (3rd ed.). Sparky House Publishing, Baltimore, Maryland.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"G-test for Count Data — g.test","text":"","code":"# = EXAMPLE 1 = # Shivrain et al. (2006) crossed clearfield rice (which are resistant # to the herbicide imazethapyr) with red rice (which are susceptible to # imazethapyr). They then crossed the hybrid offspring and examined the # F2 generation, where they found 772 resistant plants, 1611 moderately # resistant plants, and 737 susceptible plants. If resistance is controlled # by a single gene with two co-dominant alleles, you would expect a 1:2:1 # ratio.  x <- c(772, 1611, 737) g.test(x, p = c(1, 2, 1) / 4) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 4.1471, p-value = 0.1257 #>   # There is no significant difference from a 1:2:1 ratio. # Meaning: resistance controlled by a single gene with two co-dominant # alleles, is plausible.   # = EXAMPLE 2 = # Red crossbills (Loxia curvirostra) have the tip of the upper bill either # right or left of the lower bill, which helps them extract seeds from pine # cones. Some have hypothesized that frequency-dependent selection would # keep the number of right and left-billed birds at a 1:1 ratio. Groth (1992) # observed 1752 right-billed and 1895 left-billed crossbills.  x <- c(1752, 1895) g.test(x) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 5.6085, p-value = 0.01787 #>   # There is a significant difference from a 1:1 ratio. # Meaning: there are significantly more left-billed birds."},{"path":"https://amr-for-r.org/reference/get_episode.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Clinical or Epidemic Episodes — get_episode","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"functions determine items vector can considered (start ) new episode. can used determine clinical episodes epidemiological analysis. get_episode() function returns index number episode per group, is_new_episode() function returns TRUE every new get_episode() index. absolute relative episode determination supported.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"get_episode(x, episode_days = NULL, case_free_days = NULL, ...)  is_new_episode(x, episode_days = NULL, case_free_days = NULL, ...)"},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"x Vector dates (class Date POSIXt), sorted internally determine episodes. episode_days Episode length days specify time period new episode begins, can also less day Inf, see Details. case_free_days (inter-epidemic) interval length days new episode start, can also less day Inf, see Details. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode(): integer vector is_new_episode(): logical vector","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"Episodes can determined two ways: absolute relative. Absolute method uses episode_days define episode length days, new episode start. common use case AMR data analysis microbial epidemiology: episodes S. aureus bacteraemia ICU patients example. episode length 30 days, new S. aureus isolates ICU episode 30 days considered different (new) episode. Thus, method counts since start previous episode. Relative method uses case_free_days quantify duration case-free days (inter-epidemic interval), new episode start. common use case infectious disease epidemiology: episodes norovirus outbreaks hospital example. case-free period 14 days, new norovirus cases time considered different (new) episode. Thus, methods counts since last case previous episode. table: ** marks start new episode, 8 January 2023 7 days since start previous episode (1 January 2023).  *** marks start new episode, 21 January 2023 7 days since last case previous episode (8 January 2023). Either episode_days case_free_days must provided function.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"difference-between-get-episode-and-is-new-episode-","dir":"Reference","previous_headings":"","what":"Difference between get_episode() and is_new_episode()","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode() function returns index number episode, cases/patients/isolates first episode number 1, cases/patients/isolates second episode number 2, etc. is_new_episode() function hand, returns TRUE every new get_episode() index. specify, setting episode_days = 365 (using method 1 explained ), two functions differ:","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names allows different isolate selection methods. dplyr package required functions work, episode functions support variable grouping work conveniently inside dplyr verbs filter(), mutate() summarise().","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"# difference between absolute and relative determination of episodes: x <- data.frame(dates = as.Date(c(   \"2021-01-01\",   \"2021-01-02\",   \"2021-01-05\",   \"2021-01-08\",   \"2021-02-21\",   \"2021-02-22\",   \"2021-02-23\",   \"2021-02-24\",   \"2021-03-01\",   \"2021-03-01\" ))) x$absolute <- get_episode(x$dates, episode_days = 7) x$relative <- get_episode(x$dates, case_free_days = 7) x #>         dates absolute relative #> 1  2021-01-01        1        1 #> 2  2021-01-02        1        1 #> 3  2021-01-05        1        1 #> 4  2021-01-08        2        1 #> 5  2021-02-21        3        2 #> 6  2021-02-22        3        2 #> 7  2021-02-23        3        2 #> 8  2021-02-24        3        2 #> 9  2021-03-01        4        2 #> 10 2021-03-01        4        2   # `example_isolates` is a data set available in the AMR package. # See ?example_isolates df <- example_isolates[sample(seq_len(2000), size = 100), ]  get_episode(df$date, episode_days = 60) # indices #>   [1] 43  9  7 14 28 40 49 29 19 27 10 44 18 22 42 12  8 36 13  3 46  5  4 35 38 #>  [26] 16 22 23 16 10 42 13  2 45 18 19 39 32 22 36 40 45 39 40 11 23 25 39 26 23 #>  [51] 25 12 17 23 30 30 34 16 21 37 40 26 11  7  4 16 43 22 47 37 39 31 25 41  1 #>  [76] 45 39 23 32 45 20 22 15 14 13 43  9 38 29  6 48 24 21 23 44 19 31  1  3 33 is_new_episode(df$date, episode_days = 60) # TRUE/FALSE #>   [1]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [13]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [25]  TRUE  TRUE FALSE  TRUE FALSE FALSE FALSE FALSE  TRUE  TRUE FALSE FALSE #>  [37]  TRUE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE  TRUE FALSE #>  [49]  TRUE FALSE FALSE FALSE  TRUE FALSE  TRUE FALSE  TRUE FALSE  TRUE  TRUE #>  [61] FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE  TRUE #>  [73] FALSE  TRUE  TRUE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE  TRUE FALSE #>  [85] FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE FALSE FALSE FALSE FALSE #>  [97] FALSE FALSE FALSE  TRUE  # filter on results from the third 60-day episode only, using base R df[which(get_episode(df$date, 60) == 3), ] #> # A tibble: 2 × 46 #>   date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #> 1 2002-11-04 304347     62 M      Clinical B_STRPT_PNMN   S     NA    NA    S   #> 2 2002-10-18 E55128     57 F      ICU      B_STPHY_AURS   R     NA    S     R   #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, RIF <sir>  # the functions also work for less than a day, e.g. to include one per hour: get_episode(   c(     Sys.time(),     Sys.time() + 60 * 60   ),   episode_days = 1 / 24 ) #> [1] 1 2  # \\donttest{ if (require(\"dplyr\")) {   # is_new_episode() can also be used in dplyr verbs to determine patient   # episodes based on any (combination of) grouping variables:   df %>%     mutate(condition = sample(       x = c(\"A\", \"B\", \"C\"),       size = 100,       replace = TRUE     )) %>%     group_by(patient, condition) %>%     mutate(new_episode = is_new_episode(date, 365)) %>%     select(patient, date, condition, new_episode) %>%     arrange(patient, condition, date) } #> # A tibble: 100 × 4 #> # Groups:   patient, condition [96] #>    patient date       condition new_episode #>    <chr>   <date>     <chr>     <lgl>       #>  1 022060  2004-05-04 A         TRUE        #>  2 060287  2007-03-11 A         TRUE        #>  3 0E2483  2007-04-06 C         TRUE        #>  4 101305  2006-12-13 A         TRUE        #>  5 141061  2014-10-22 A         TRUE        #>  6 146F70  2009-08-14 A         TRUE        #>  7 15D386  2004-08-01 B         TRUE        #>  8 187841  2008-04-22 C         TRUE        #>  9 195736  2008-08-29 C         TRUE        #> 10 195736  2008-08-29 C         FALSE       #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward, patient) %>%     transmute(date,       patient,       new_index = get_episode(date, 60),       new_logical = is_new_episode(date, 60)     ) %>%     arrange(patient, ward, date) } #> # A tibble: 100 × 5 #> # Groups:   ward, patient [91] #>    ward     date       patient new_index new_logical #>    <chr>    <date>     <chr>       <int> <lgl>       #>  1 ICU      2004-05-04 022060          1 TRUE        #>  2 Clinical 2007-03-11 060287          1 TRUE        #>  3 Clinical 2007-04-06 0E2483          1 TRUE        #>  4 Clinical 2006-12-13 101305          1 TRUE        #>  5 Clinical 2014-10-22 141061          1 TRUE        #>  6 Clinical 2009-08-14 146F70          1 TRUE        #>  7 ICU      2004-08-01 15D386          1 TRUE        #>  8 Clinical 2008-04-22 187841          1 TRUE        #>  9 Clinical 2008-08-29 195736          1 TRUE        #> 10 Clinical 2008-08-29 195736          1 FALSE       #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward) %>%     summarise(       n_patients = n_distinct(patient),       n_episodes_365 = sum(is_new_episode(date, episode_days = 365)),       n_episodes_60 = sum(is_new_episode(date, episode_days = 60)),       n_episodes_30 = sum(is_new_episode(date, episode_days = 30))     ) } #> # A tibble: 3 × 5 #>   ward       n_patients n_episodes_365 n_episodes_60 n_episodes_30 #>   <chr>           <int>          <int>         <int>         <int> #> 1 Clinical           58             14            38            44 #> 2 ICU                26              7            20            23 #> 3 Outpatient          7              4             6             7  # grouping on patients and microorganisms leads to the same # results as first_isolate() when using 'episode-based': if (require(\"dplyr\")) {   x <- df %>%     filter_first_isolate(       include_unknown = TRUE,       method = \"episode-based\"     )    y <- df %>%     group_by(patient, mo) %>%     filter(is_new_episode(date, 365)) %>%     ungroup()    identical(x, y) } #> [1] FALSE  # but is_new_episode() has a lot more flexibility than first_isolate(), # since you can now group on anything that seems relevant: if (require(\"dplyr\")) {   df %>%     group_by(patient, mo, ward) %>%     mutate(flag_episode = is_new_episode(date, 365)) %>%     select(group_vars(.), flag_episode) } #> # A tibble: 100 × 4 #> # Groups:   patient, mo, ward [96] #>    patient mo            ward     flag_episode #>    <chr>   <mo>          <chr>    <lgl>        #>  1 917895  B_STPHY_CPTS  ICU      TRUE         #>  2 022060  B_ENTRBC_CLOC ICU      TRUE         #>  3 C36883  B_ESCHR_COLI  Clinical TRUE         #>  4 5DF436  B_STPHY_AURS  ICU      TRUE         #>  5 971739  B_STPHY_CONS  Clinical TRUE         #>  6 488175  B_ESCHR_COLI  Clinical TRUE         #>  7 5DB1C8  B_STPHY_CPTS  Clinical TRUE         #>  8 BC9909  B_ENTRBC_CLOC Clinical TRUE         #>  9 5B78D5  B_STPHY_AURS  Clinical TRUE         #> 10 284FFF  B_STPHY_EPDR  Clinical TRUE         #> # ℹ 90 more rows # }"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":null,"dir":"Reference","previous_headings":"","what":"PCA Biplot with ggplot2 — ggplot_pca","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"Produces ggplot2 variant -called biplot PCA (principal component analysis), flexible appealing base R biplot() function.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"ggplot_pca(x, choices = 1:2, scale = 1, pc.biplot = TRUE,   labels = NULL, labels_textsize = 3, labels_text_placement = 1.5,   groups = NULL, ellipse = TRUE, ellipse_prob = 0.68,   ellipse_size = 0.5, ellipse_alpha = 0.5, points_size = 2,   points_alpha = 0.25, arrows = TRUE, arrows_colour = \"darkblue\",   arrows_size = 0.5, arrows_textsize = 3, arrows_textangled = TRUE,   arrows_alpha = 0.75, base_textsize = 10, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"ggplot_pca() function based ggbiplot() function ggbiplot package Vince Vu, found GitHub: https://github.com/vqv/ggbiplot (retrieved: 2 March 2020, latest commit: 7325e88; 12 February 2015). per GPL-2 licence demands documentation code changes, changes made based source code : Rewritten code remove dependency packages plyr, scales grid Parametrised options, like arrow ellipse settings Hardened input possibilities defining exact type user input every argument Added total amount explained variance caption plot Cleaned syntax based lintr package, fixed grammatical errors added integrity checks Updated documentation","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"x object returned pca(), prcomp() princomp(). choices length 2 vector specifying components plot. default     biplot strict sense. scale variables scaled lambda ^ scale     observations scaled lambda ^ (1-scale)     lambda singular values computed     princomp. Normally 0 <= scale <= 1, warning     issued specified scale outside range. pc.biplot true, use Gabriel (1971) refers \"principal component     biplot\", lambda = 1 observations scaled sqrt(n)     variables scaled sqrt(n).  inner products     variables approximate covariances distances observations     approximate Mahalanobis distance. labels optional vector labels observations. set, labels placed respective points. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). labels_textsize size text used labels. labels_text_placement Adjustment factor placement variable names (>=1 means away arrow head). groups optional vector groups labels, length labels. set, points labels coloured according groups. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). ellipse logical indicate whether normal data ellipse drawn group (set groups). ellipse_prob Statistical size ellipse normal probability. ellipse_size size ellipse line. ellipse_alpha alpha (transparency) ellipse line. points_size size points. points_alpha alpha (transparency) points. arrows logical indicate whether arrows drawn. arrows_colour colour arrow text. arrows_size size (thickness) arrow lines. arrows_textsize size text end arrows. arrows_textangled logical whether text end arrows angled. arrows_alpha alpha (transparency) arrows text. base_textsize text size plot elements except labels arrows. ... Arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"colours labels points can changed adding another scale layer colour, scale_colour_viridis_d() scale_colour_brewer().","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    summary(pca_result)    # old base R plotting method:   biplot(pca_result, main = \"Base R biplot\")    # new ggplot2 plotting method using this package:   if (require(\"ggplot2\")) {     ggplot_pca(pca_result) +       labs(title = \"ggplot2 biplot\")   }   if (require(\"ggplot2\")) {     # still extendible with any ggplot2 function     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"ggplot2 biplot\")   } } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (`minimum` = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # }"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":null,"dir":"Reference","previous_headings":"","what":"AMR Plots with ggplot2 — ggplot_sir","title":"AMR Plots with ggplot2 — ggplot_sir","text":"Use functions create bar plots AMR data analysis. functions rely ggplot2 functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"ggplot_sir(data, position = NULL, x = \"antibiotic\",   fill = \"interpretation\", facet = NULL, breaks = seq(0, 1, 0.1),   limits = NULL, translate_ab = \"name\", combine_SI = TRUE,   minimum = 30, language = get_AMR_locale(), nrow = NULL, colours = c(S   = \"#3CAEA3\", SDD = \"#8FD6C4\", SI = \"#3CAEA3\", I = \"#F6D55C\", IR = \"#ED553B\",   R = \"#ED553B\"), datalabels = TRUE, datalabels.size = 2.5,   datalabels.colour = \"grey15\", title = NULL, subtitle = NULL,   caption = NULL, x.title = \"Antimicrobial\", y.title = \"Proportion\", ...)  geom_sir(position = NULL, x = c(\"antibiotic\", \"interpretation\"),   fill = \"interpretation\", translate_ab = \"name\", minimum = 30,   language = get_AMR_locale(), combine_SI = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"AMR Plots with ggplot2 — ggplot_sir","text":"data data.frame column(s) class sir (see .sir()). position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". x Variable show x axis, either \"antibiotic\" (default) \"interpretation\" grouping variable. fill Variable categorise using plots legend, either \"antibiotic\" (default) \"interpretation\" grouping variable. facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. nrow (using facet) number rows. colours named vactor colour used filling. default colours colour-blind friendly. datalabels Show datalabels using labels_sir_count(). datalabels.size Size datalabels. datalabels.colour Colour datalabels. title Text show title plot. subtitle Text show subtitle plot. caption Text show caption plot. x.title Text show x axis description. y.title Text show y axis description. ... arguments passed geom_sir() , case scale_sir_colours(), named values set colours. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Plots with ggplot2 — ggplot_sir","text":"default, names antimicrobials shown plots using ab_name(). can set translate_ab argument. See count_df(). geom_sir() take variable data sir class (created .sir()) using sir_df() plot bars percentage S, , R. default behaviour bars stacked different antimicrobials x axis. Additional functions include: facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() sets colours bars (green S, yellow , red R). multilingual support. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage amount isolates using ggplot2::geom_text(). ggplot_sir() wrapper around functions uses data first input. makes possible use function pipe (%>%). See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"# \\donttest{ if (require(\"ggplot2\") && require(\"dplyr\")) {   # get antimicrobial results for drugs against a UTI:   ggplot(example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)) +     geom_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # prettify the plot using some additional functions:   df <- example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)   ggplot(df) +     geom_sir() +     scale_y_percent() +     scale_sir_colours(aesthetics = \"fill\") +     labels_sir_count() +     theme_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # or better yet, simplify this using the wrapper function - a single command:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # get only proportions and no counts:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(datalabels = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # add other ggplot2 arguments as you like:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(       width = 0.5,       colour = \"black\",       size = 1,       linetype = 2,       alpha = 0.25     ) } #> Error in names(colours_SIR) <- sir_order: 'names' attribute [6] must be the same length as the vector [4] if (require(\"ggplot2\") && require(\"dplyr\")) {   # you can alter the colours with colour names:   example_isolates %>%     select(AMX) %>%     ggplot_sir(colours = c(SI = \"yellow\")) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # but you can also use the built-in colour-blind friendly colours for   # your plots, where \"S\" is green, \"I\" is yellow and \"R\" is red:   data.frame(     x = c(\"Value1\", \"Value2\", \"Value3\"),     y = c(1, 2, 3),     z = c(\"Value4\", \"Value5\", \"Value6\")   ) %>%     ggplot() +     geom_col(aes(x = x, y = y, fill = z)) +     scale_sir_colours(       aesthetics = \"fill\",       Value4 = \"S\", Value5 = \"I\", Value6 = \"R\"     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # resistance of ciprofloxacine per age group   example_isolates %>%     mutate(first_isolate = first_isolate()) %>%     filter(       first_isolate == TRUE,       mo == as.mo(\"Escherichia coli\")     ) %>%     # age_groups() is also a function in this AMR package:     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(x = \"age_group\") } #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_col()`). #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_text()`).  if (require(\"ggplot2\") && require(\"dplyr\")) {   # a shorter version which also adjusts data label colours:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(colours = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # it also supports groups (don't forget to use the group var on `x` or `facet`):   example_isolates %>%     filter(mo_is_gram_negative(), ward != \"Outpatient\") %>%     # select only UTI-specific drugs     select(ward, AMX, NIT, FOS, TMP, CIP) %>%     group_by(ward) %>%     ggplot_sir(       x = \"ward\",       facet = \"antibiotic\",       nrow = 1,       title = \"AMR of Anti-UTI Drugs Per Ward\",       x.title = \"Ward\",       datalabels = FALSE     ) } #> ℹ Using column 'mo' as input for `mo_is_gram_negative()`  # }"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":null,"dir":"Reference","previous_headings":"","what":"Guess Antibiotic Column — guess_ab_col","title":"Guess Antibiotic Column — guess_ab_col","text":"tries find column name data set based information antimicrobials data set. Also supports WHONET abbreviations.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"guess_ab_col(x = NULL, search_string = NULL, verbose = FALSE,   only_sir_columns = FALSE)"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Guess Antibiotic Column — guess_ab_col","text":"x data.frame. search_string text search x , checked .ab() value column x. verbose logical indicate whether additional info printed. only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Guess Antibiotic Column — guess_ab_col","text":"column name x, NULL result found.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Guess Antibiotic Column — guess_ab_col","text":"can look antibiotic (trade) name abbreviation search x antimicrobials data set column containing name code antibiotic.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"df <- data.frame(   amox = \"S\",   tetr = \"R\" )  guess_ab_col(df, \"amoxicillin\") #> [1] \"amox\" guess_ab_col(df, \"J01AA07\") # ATC code of tetracycline #> [1] \"tetr\"  guess_ab_col(df, \"J01AA07\", verbose = TRUE) #> Auto-guessing columns suitable for analysis #> ... #>  OK. #> ℹ Using column 'amox' as input for AMX (amoxicillin). #> ℹ Using column 'tetr' as input for TCY (tetracycline). #> ℹ Using column 'tetr' as input for J01AA07 (tetracycline). #> [1] \"tetr\"  # WHONET codes df <- data.frame(   AMP_ND10 = \"R\",   AMC_ED20 = \"S\" ) guess_ab_col(df, \"ampicillin\") #> [1] \"AMP_ND10\" guess_ab_col(df, \"J01CR02\") #> [1] \"AMC_ED20\" guess_ab_col(df, \"augmentin\") #> [1] \"AMC_ED20\""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Data set containing 'EUCAST Expected Resistant Phenotypes' bug-drug combinations microorganisms antimicrobials data sets.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant"},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"tibble 271 905 observations 2 variables: mo Microorganism ID occurs microorganisms$mo. Names can retrieved using mo_name(). ab Antimicrobial ID occurs antimicrobials$ab. Names can retrieved using ab_name().","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"data set currently based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). data set internally used : not_intrinsic_resistant() (antimicrobial selector) mo_is_intrinsic_resistant()","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant #> # A tibble: 271,905 × 2 #>    mo          ab   #>    <mo>        <ab> #>  1 B_GRAMP     ATM  #>  2 B_GRAMP     COL  #>  3 B_GRAMP     NAL  #>  4 B_GRAMP     PLB  #>  5 B_GRAMP     TEM  #>  6 B_ANAER-POS ATM  #>  7 B_ANAER-POS COL  #>  8 B_ANAER-POS NAL  #>  9 B_ANAER-POS PLB  #> 10 B_ANAER-POS TEM  #> # ℹ 271,895 more rows"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":null,"dir":"Reference","previous_headings":"","what":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"According binomial nomenclature, lowest four taxonomic levels (family, genus, species, subspecies) printed italics. function finds taxonomic names within strings makes italic.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))  italicize_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"string character (vector). type Type conversion taxonomic names, either \"markdown\", \"html\" \"ansi\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"function finds taxonomic names makes italic based microorganisms data set. taxonomic names can italicised using markdown (default) adding * taxonomic names, <> <\/> using html. using 'ansi', ANSI colours added using \\033[3m \\033[23m taxonomic names. multiple ANSI colours available, conversion occur. function also supports abbreviation genus followed species, \"E. coli\" \"K. pneumoniae ozaenae\".","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(\"An overview of Staphylococcus aureus isolates\") #> [1] \"An overview of *Staphylococcus aureus* isolates\" italicise_taxonomy(\"An overview of S. aureus isolates\") #> [1] \"An overview of *S. aureus* isolates\"  cat(italicise_taxonomy(\"An overview of S. aureus isolates\", type = \"ansi\")) #> An overview of S. aureus isolates"},{"path":"https://amr-for-r.org/reference/join.html","id":null,"dir":"Reference","previous_headings":"","what":"Join microorganisms to a Data Set — join","title":"Join microorganisms to a Data Set — join","text":"Join data set microorganisms easily existing data set character vector.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join microorganisms to a Data Set — join","text":"","code":"inner_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  left_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  right_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  full_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  semi_join_microorganisms(x, by = NULL, ...)  anti_join_microorganisms(x, by = NULL, ...)"},{"path":"https://amr-for-r.org/reference/join.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join microorganisms to a Data Set — join","text":"x Existing data set join, character vector. case character vector, resulting data.frame contain column 'x' values. variable join - left empty search column class mo (created .mo()) \"mo\" column name exists x, otherwise column name x values exist microorganisms$mo (= \"bacteria_id\"), another column microorganisms (named, like = c(\"bacteria_id\" = \"fullname\")). suffix non-joined duplicate variables x y, suffixes added output disambiguate . character vector length 2. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join microorganisms to a Data Set — join","text":"data.frame","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Join microorganisms to a Data Set — join","text":"Note: opposed join() functions dplyr, character vectors supported default existing columns get suffix \"2\" newly joined columns get suffix. dplyr package installed, join functions used. Otherwise, much slower merge() interaction() functions base R used.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Join microorganisms to a Data Set — join","text":"","code":"left_join_microorganisms(as.mo(\"K. pneumoniae\")) #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list> left_join_microorganisms(\"B_KLBSL_PNMN\") #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>  df <- data.frame(   date = seq(     from = as.Date(\"2018-01-01\"),     to = as.Date(\"2018-01-07\"),     by = 1   ),   bacteria = as.mo(c(     \"S. aureus\", \"MRSA\", \"MSSA\", \"STAAUR\",     \"E. coli\", \"E. coli\", \"E. coli\"   )),   stringsAsFactors = FALSE ) colnames(df) #> [1] \"date\"     \"bacteria\"  df_joined <- left_join_microorganisms(df, \"bacteria\") colnames(df_joined) #>  [1] \"date\"                \"bacteria\"            \"fullname\"            #>  [4] \"status\"              \"kingdom\"             \"phylum\"              #>  [7] \"class\"               \"order\"               \"family\"              #> [10] \"genus\"               \"species\"             \"subspecies\"          #> [13] \"rank\"                \"ref\"                 \"oxygen_tolerance\"    #> [16] \"source\"              \"lpsn\"                \"lpsn_parent\"         #> [19] \"lpsn_renamed_to\"     \"mycobank\"            \"mycobank_parent\"     #> [22] \"mycobank_renamed_to\" \"gbif\"                \"gbif_parent\"         #> [25] \"gbif_renamed_to\"     \"prevalence\"          \"snomed\"               # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     left_join_microorganisms() %>%     colnames() } #> Joining, by = \"mo\" #>  [1] \"date\"                \"patient\"             \"age\"                 #>  [4] \"gender\"              \"ward\"                \"mo\"                  #>  [7] \"PEN\"                 \"OXA\"                 \"FLC\"                 #> [10] \"AMX\"                 \"AMC\"                 \"AMP\"                 #> [13] \"TZP\"                 \"CZO\"                 \"FEP\"                 #> [16] \"CXM\"                 \"FOX\"                 \"CTX\"                 #> [19] \"CAZ\"                 \"CRO\"                 \"GEN\"                 #> [22] \"TOB\"                 \"AMK\"                 \"KAN\"                 #> [25] \"TMP\"                 \"SXT\"                 \"NIT\"                 #> [28] \"FOS\"                 \"LNZ\"                 \"CIP\"                 #> [31] \"MFX\"                 \"VAN\"                 \"TEC\"                 #> [34] \"TCY\"                 \"TGC\"                 \"DOX\"                 #> [37] \"ERY\"                 \"CLI\"                 \"AZM\"                 #> [40] \"IPM\"                 \"MEM\"                 \"MTR\"                 #> [43] \"CHL\"                 \"COL\"                 \"MUP\"                 #> [46] \"RIF\"                 \"fullname\"            \"status\"              #> [49] \"kingdom\"             \"phylum\"              \"class\"               #> [52] \"order\"               \"family\"              \"genus\"               #> [55] \"species\"             \"subspecies\"          \"rank\"                #> [58] \"ref\"                 \"oxygen_tolerance\"    \"source\"              #> [61] \"lpsn\"                \"lpsn_parent\"         \"lpsn_renamed_to\"     #> [64] \"mycobank\"            \"mycobank_parent\"     \"mycobank_renamed_to\" #> [67] \"gbif\"                \"gbif_parent\"         \"gbif_renamed_to\"     #> [70] \"prevalence\"          \"snomed\"              # }"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"functions can used determine first weighted isolates considering phenotype isolate selection (see first_isolate()). Using phenotype-based method determine first isolates reliable methods disregard phenotypes.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"key_antimicrobials(x = NULL, col_mo = NULL, universal = c(\"ampicillin\",   \"amoxicillin/clavulanic acid\", \"cefuroxime\", \"piperacillin/tazobactam\",   \"ciprofloxacin\", \"trimethoprim/sulfamethoxazole\"),   gram_negative = c(\"gentamicin\", \"tobramycin\", \"colistin\", \"cefotaxime\",   \"ceftazidime\", \"meropenem\"), gram_positive = c(\"vancomycin\", \"teicoplanin\",   \"tetracycline\", \"erythromycin\", \"oxacillin\", \"rifampin\"),   antifungal = c(\"anidulafungin\", \"caspofungin\", \"fluconazole\", \"miconazole\",   \"nystatin\", \"voriconazole\"), only_sir_columns = any(is.sir(x)), ...)  all_antimicrobials(x = NULL, only_sir_columns = any(is.sir(x)), ...)  antimicrobials_equal(y, z, type = c(\"points\", \"keyantimicrobials\"),   ignore_I = TRUE, points_threshold = 2, ...)"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank determine automatically. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). universal Names broad-spectrum antimicrobial drugs, case-insensitive. Set NULL ignore. See Details default antimicrobial drugs. gram_negative Names antibiotic drugs Gram-positives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. gram_positive Names antibiotic drugs Gram-negatives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. antifungal Names antifungal drugs fungi, case-insensitive. Set NULL ignore. See Details default antifungal drugs. only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... Ignored, place allow future extensions. y, z character vectors compare. type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"key_antimicrobials() all_antimicrobials() functions context-aware. means x argument can left blank used inside data.frame call, see Examples. function key_antimicrobials() returns character vector 12 antimicrobial results every isolate. function all_antimicrobials() returns character vector antimicrobial drug results every isolate. vectors can compared using antimicrobials_equal(), check two isolates generally antibiogram. Missing invalid values replaced dot (\".\") key_antimicrobials() ignored antimicrobials_equal(). Please see first_isolate() function important functions enable 'phenotype-based' method determination first isolates. default antimicrobial drugs used rows (set universal) : Ampicillin Amoxicillin/clavulanic acid Cefuroxime Ciprofloxacin Piperacillin/tazobactam Trimethoprim/sulfamethoxazole default antimicrobial drugs used Gram-negative bacteria (set gram_negative) : Cefotaxime Ceftazidime Colistin Gentamicin Meropenem Tobramycin default antimicrobial drugs used Gram-positive bacteria (set gram_positive) : Erythromycin Oxacillin Rifampin Teicoplanin Tetracycline Vancomycin default antimicrobial drugs used fungi (set antifungal) : Anidulafungin Caspofungin Fluconazole Miconazole Nystatin Voriconazole","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # output of the `key_antimicrobials()` function could be like this: strainA <- \"SSSRR.S.R..S\" strainB <- \"SSSIRSSSRSSS\"  # those strings can be compared with: antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\") #> [1] TRUE # TRUE, because I is ignored (as well as missing values)  antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\", ignore_I = FALSE) #> [1] FALSE # FALSE, because I is not ignored and so the 4th [character] differs  # \\donttest{ if (require(\"dplyr\")) {   # set key antimicrobials to a new variable   my_patients <- example_isolates %>%     mutate(keyab = key_antimicrobials(antifungal = NULL)) %>% # no need to define `x`     mutate(       # now calculate first isolates       first_regular = first_isolate(col_keyantimicrobials = FALSE),       # and first WEIGHTED isolates       first_weighted = first_isolate(col_keyantimicrobials = \"keyab\")     )    # Check the difference in this data set, 'weighted' results in more isolates:   sum(my_patients$first_regular, na.rm = TRUE)   sum(my_patients$first_weighted, na.rm = TRUE) } #> [1] 1383 # }"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":null,"dir":"Reference","previous_headings":"","what":"Kurtosis of the Sample — kurtosis","title":"Kurtosis of the Sample — kurtosis","text":"Kurtosis measure \"tailedness\" probability distribution real-valued random variable. normal distribution kurtosis 3 excess kurtosis 0.","code":""},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(x, na.rm = FALSE, excess = FALSE)  # Default S3 method kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'matrix' kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'data.frame' kurtosis(x, na.rm = FALSE, excess = FALSE)"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Kurtosis of the Sample — kurtosis","text":"x vector values, matrix data.frame. na.rm logical indicate whether NA values stripped computation proceeds. excess logical indicate whether excess kurtosis returned, defined kurtosis minus 3.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(rnorm(10000)) #> [1] 3.069947 kurtosis(rnorm(10000), excess = TRUE) #> [1] -0.02599697"},{"path":"https://amr-for-r.org/reference/like.html","id":null,"dir":"Reference","previous_headings":"","what":"Vectorised Pattern Matching with Keyboard Shortcut — like","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Convenient wrapper around grepl() match pattern: x %like% pattern. always returns logical vector always case-insensitive (use x %like_case% pattern case-sensitive matching). Also, pattern can long x compare items index vectors, can length iterate cases.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"like(x, pattern, ignore.case = TRUE)  x %like% pattern  x %unlike% pattern  x %like_case% pattern  x %unlike_case% pattern"},{"path":"https://amr-for-r.org/reference/like.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Idea like function data.table package, although altered explained Details.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"x character vector matches sought, object can coerced .character() character vector. pattern character vector containing regular expressions (character string fixed = TRUE) matched given character vector. Coerced .character() character string possible. ignore.case FALSE, pattern matching case sensitive TRUE, case ignored matching.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"like() %like%/%unlike% functions: case-insensitive (use %like_case%/%unlike_case% case-sensitive matching) Support multiple patterns Check pattern valid regular expression sets fixed = TRUE , greatly improve speed (vectorised pattern) Always use compatibility Perl unless fixed = TRUE, greatly improve speed Using RStudio? %like%/%unlike% functions can also directly inserted code Addins menu can keyboard shortcut like Shift+Ctrl+L Shift+Cmd+L (see menu Tools > Modify Keyboard Shortcuts...). keep pressing shortcut, inserted text iterated %like% -> %unlike% -> %like_case% -> %unlike_case%.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"# data.table has a more limited version of %like%, so unload it: try(detach(\"package:data.table\", unload = TRUE), silent = TRUE) #> Warning: ‘data.table’ namespace cannot be unloaded: #>   namespace ‘data.table’ is imported by ‘prodlim’ so cannot be unloaded  a <- \"This is a test\" b <- \"TEST\" a %like% b #> [1] TRUE b %like% a #> [1] FALSE  # also supports multiple patterns a <- c(\"Test case\", \"Something different\", \"Yet another thing\") b <- c(\"case\", \"diff\", \"yet\") a %like% b #> [1] TRUE TRUE TRUE a %unlike% b #> [1] FALSE FALSE FALSE  a[1] %like% b #> [1]  TRUE FALSE FALSE a %like% b[1] #> [1]  TRUE FALSE FALSE  # \\donttest{ # get isolates whose name start with 'Entero' (case-insensitive) example_isolates[which(mo_name() %like% \"^entero\"), ] #> ℹ Using column 'mo' as input for `mo_name()` #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_name() %like% \"^ent\") } #> ℹ Using column 'mo' as input for `mo_name()` #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/mdro.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Determine isolates multidrug-resistant organisms (MDRO) according international, national, custom guidelines.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"mdro(x = NULL, guideline = \"CMI 2012\", col_mo = NULL, esbl = NA,   carbapenemase = NA, mecA = NA, mecC = NA, vanA = NA, vanB = NA,   info = interactive(), pct_required_classes = 0.5, combine_SI = TRUE,   verbose = FALSE, only_sir_columns = any(is.sir(x)), ...)  brmo(x = NULL, only_sir_columns = any(is.sir(x)), ...)  mrgn(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE,   ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = any(is.sir(x)),   verbose = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/mdro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank automatic determination. guideline specific guideline follow, see sections Supported international / national guidelines Using Custom Guidelines . left empty, publication Magiorakos et al. (see ) followed. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). esbl logical values, column name containing logical values, indicating presence ESBL gene (production proteins). carbapenemase logical values, column name containing logical values, indicating presence carbapenemase gene (production proteins). mecA logical values, column name containing logical values, indicating presence mecA gene (production proteins). mecC logical values, column name containing logical values, indicating presence mecC gene (production proteins). vanA logical values, column name containing logical values, indicating presence vanA gene (production proteins). vanB logical values, column name containing logical values, indicating presence vanB gene (production proteins). info logical indicate whether progress printed console - default print interactive sessions. pct_required_classes Minimal required percentage antimicrobial classes must available per isolate, rounded . example, default guideline, 17 antimicrobial classes must available S. aureus. Setting pct_required_classes argument 0.5 (default) means every S. aureus isolate least 8 different classes must available. lower number available classes return NA isolate. combine_SI logical indicate whether values S must merged one, resistance considered isolates R, . default behaviour mdro() function, follows redefinition EUCAST interpretation (increased exposure) 2019, see section 'Interpretation S, R' . using combine_SI = FALSE, resistance considered isolates R . verbose logical turn Verbose mode (default ). Verbose mode, function return MDRO results, instead returns data set logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... Column names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"verbose set TRUE: data.frame containing columns row_number, microorganism, MDRO, reason, all_nonsusceptible_columns, guideline CMI 2012 paper - function mdr_cmi2012() mdro(): Ordered factor levels Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant (XDR) < Pandrug-resistant (PDR) TB guideline - function mdr_tb() mdro(..., guideline = \"TB\"): Ordered factor levels Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant < Extensively drug-resistant German guideline - function mrgn() mdro(..., guideline = \"MRGN\"): Ordered factor levels Negative < 3MRGN < 4MRGN Everything else, except custom guidelines: Ordered factor levels Negative < Positive, unconfirmed < Positive. value \"Positive, unconfirmed\" means , according guideline, entirely sure isolate multi-drug resistant confirmed additional (e.g. genotypic) tests","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"functions context-aware. means x argument can left blank used inside data.frame call, see Examples. pct_required_classes argument, values 1 divided 100. support fractions (0.75 3/4) percentages (75). Note: Every test involves Enterobacteriaceae family, internally performed using newly named order Enterobacterales, since Enterobacteriaceae family taxonomically reclassified Adeolu et al. 2016. , Enterobacteriaceae family Enterobacteriales () order. species old Enterobacteriaceae family still new Enterobacterales (without ) order, divided multiple families. way tests performed now mdro() function makes sure results 2016 2016 identical.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"supported-international-national-guidelines","dir":"Reference","previous_headings":"","what":"Supported International / National Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Please suggest implement guidelines letting us know. Currently supported guidelines (case-insensitive): guideline = \"CMI 2012\" (default) Magiorakos AP, Srinivasan et al. \"Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.\" Clinical Microbiology Infection (2012) (doi:10.1111/j.1469-0691.2011.03570.x ) guideline = \"EUCAST 3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) Also: guideline = \"EUCAST 3.2\" former European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST 3.1\" former European international guideline - EUCAST Expert Rules Version 3.1 \"Intrinsic Resistance Exceptional Phenotypes Tables\" (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization \"Companion handbook guidelines programmatic management drug-resistant tuberculosis\" (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7; doi:10.1186/s13756-015-0047-6 guideline = \"BRMO 2024\" (simply guideline = \"BRMO\") Dutch national guideline - Samenwerkingverband Richtlijnen Infectiepreventie (SRI) (2024) \"Bijzonder Resistente Micro-Organismen (BRMO)\" (link) Also: guideline = \"BRMO 2017\" former Dutch national guideline - Werkgroep Infectiepreventie (WIP), RIVM, last revision 2017: \"Bijzonder Resistente Micro-Organismen (BRMO)\"","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"using-custom-guidelines","dir":"Reference","previous_headings":"","what":"Using Custom Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. Custom guidelines can set custom_mdro_guideline() function.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"out <- mdro(example_isolates) #> Warning: in `mdro()`: NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with `pct_required_classes`) str(out) #>  Ord.factor w/ 4 levels \"Negative\"<\"Multi-drug-resistant (MDR)\"<..: NA NA 1 1 1 1 NA NA 1 1 ... table(out) #> out #>                         Negative       Multi-drug-resistant (MDR)  #>                             1617                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0   out <- mdro(example_isolates, guideline = \"EUCAST 3.3\") table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1994                     0                     6   # \\donttest{ if (require(\"dplyr\")) {   # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     count(MDRO) } #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `MDRO = mdro()`. #> Caused by warning: #> ! in `mdro()`: NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with `pct_required_classes`) #> # A tibble: 3 × 2 #>   MDRO                           n #>   <ord>                      <int> #> 1 Negative                    1617 #> 2 Multi-drug-resistant (MDR)   128 #> 3 NA                           255 # }"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Mean AMR Distance — mean_amr_distance","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Calculates normalised mean antimicrobial resistance multiple observations, help identify similar isolates without comparing antibiograms hand.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"mean_amr_distance(x, ...)  # S3 method for class 'sir' mean_amr_distance(x, ..., combine_SI = TRUE)  # S3 method for class 'data.frame' mean_amr_distance(x, ..., combine_SI = TRUE)  amr_distance_from_row(amr_distance, row)"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"x vector class sir, mic disk, data.frame containing columns classes. ... Variables select. Supports tidyselect language (.mic), starts_with(...), column1:column4, can thus also antimicrobial selectors. combine_SI logical indicate whether values S, SDD, must merged one, input consists S+vs. R (susceptible vs. resistant) - default TRUE. amr_distance outcome mean_amr_distance(). row index, row number.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"mean AMR distance effectively Z-score; normalised numeric value compare AMR test results can help identify similar isolates, without comparing antibiograms hand. MIC values (see .mic()) transformed log2() first; distance thus calculated (log2(x) - mean(log2(x))) / sd(log2(x)). SIR values (see .sir()) transformed using \"S\" = 1, \"\" = 2, \"R\" = 3. combine_SI TRUE (default), \"\" considered 1. data sets, mean AMR distance calculated per column, mean per row returned, see Examples. Use amr_distance_from_row() subtract distances distance one row, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"interpretation","dir":"Reference","previous_headings":"","what":"Interpretation","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Isolates distances less 0.01 difference considered similar. Differences lower 0.025 considered suspicious.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"sir <- random_sir(10) sir #> Class 'sir' #>  [1] R R I R I I S R S I mean_amr_distance(sir) #>  [1]  1.1618950  1.1618950 -0.7745967  1.1618950 -0.7745967 -0.7745967 #>  [7] -0.7745967  1.1618950 -0.7745967 -0.7745967  mic <- random_mic(10) mic #> Class 'mic' #>  [1] 0.032 0.5   1     >=8   4     0.016 >=8   1     0.004 0.008 mean_amr_distance(mic) #>  [1] -0.7311752  0.2104422  0.4478776  1.1601837  0.9227483 -0.9686106 #>  [7]  1.1601837  0.4478776 -1.4434813 -1.2060459 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1] -0.7311752  0.2104422  0.4478776  1.1601837  0.9227483 -0.9686106 #>  [7]  1.1601837  0.4478776 -1.4434813 -1.2060459  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 50 49 38 33 31 17 42 43 46 37 mean_amr_distance(disk) #>  [1]  1.15131286  1.05032051 -0.06059541 -0.56555720 -0.76754191 -2.18143490 #>  [7]  0.34337401  0.44436637  0.74734344 -0.16158777  y <- data.frame(   id = LETTERS[1:10],   amox = random_sir(10, ab = \"amox\", mo = \"Escherichia coli\"),   cipr = random_disk(10, ab = \"cipr\", mo = \"Escherichia coli\"),   gent = random_mic(10, ab = \"gent\", mo = \"Escherichia coli\"),   tobr = random_mic(10, ab = \"tobr\", mo = \"Escherichia coli\") ) y #>    id amox cipr gent tobr #> 1   A    I   27  >=2    8 #> 2   B    S   28    1    8 #> 3   C    R   33    1    8 #> 4   D    R   32    1   16 #> 5   E    I   25  0.5   16 #> 6   F    I   19  0.5    8 #> 7   G    S   23  0.5   16 #> 8   H    R   27  0.5    8 #> 9   I    S   29    1    8 #> 10  J    R   32  0.5   16 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.08471751 -0.21572693  0.55391610  0.98093500 -0.26046456 -1.08721162 #>  [7] -0.37467261 -0.14625651 -0.15862291  0.62338653 y$amr_distance <- mean_amr_distance(y, is.mic(y)) #> ℹ Calculating mean AMR distance based on columns \"gent\" and \"tobr\" y[order(y$amr_distance), ] #>    id amox cipr gent tobr amr_distance #> 6   F    I   19  0.5    8   -0.8163565 #> 8   H    R   27  0.5    8   -0.8163565 #> 2   B    S   28    1    8   -0.1012596 #> 3   C    R   33    1    8   -0.1012596 #> 9   I    S   29    1    8   -0.1012596 #> 5   E    I   25  0.5   16    0.1518893 #> 7   G    S   23  0.5   16    0.1518893 #> 10  J    R   32  0.5   16    0.1518893 #> 1   A    I   27  >=2    8    0.6138374 #> 4   D    R   32    1   16    0.8669863  if (require(\"dplyr\")) {   y %>%     mutate(       amr_distance = mean_amr_distance(y),       check_id_C = amr_distance_from_row(amr_distance, id == \"C\")     ) %>%     arrange(check_id_C) } #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>    id amox cipr gent tobr amr_distance check_id_C #> 1   C    R   33    1    8   0.55391610 0.00000000 #> 2   J    R   32  0.5   16   0.62338653 0.06947042 #> 3   D    R   32    1   16   0.98093500 0.42701889 #> 4   A    I   27  >=2    8   0.08471751 0.46919859 #> 5   H    R   27  0.5    8  -0.14625651 0.70017262 #> 6   I    S   29    1    8  -0.15862291 0.71253901 #> 7   B    S   28    1    8  -0.21572693 0.76964304 #> 8   E    I   25  0.5   16  -0.26046456 0.81438066 #> 9   G    S   23  0.5   16  -0.37467261 0.92858871 #> 10  F    I   19  0.5    8  -1.08721162 1.64112773 if (require(\"dplyr\")) {   # support for groups   example_isolates %>%     filter(mo_genus() == \"Enterococcus\" & mo_species() != \"\") %>%     select(mo, TCY, carbapenems()) %>%     group_by(mo) %>%     mutate(dist = mean_amr_distance(.)) %>%     arrange(mo, dist) } #> ℹ Using column 'mo' as input for `mo_genus()` #> ℹ Using column 'mo' as input for `mo_species()` #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Calculating mean AMR distance based on columns \"TCY\", \"IPM\", and \"MEM\" #> # A tibble: 63 × 5 #> # Groups:   mo [4] #>    mo           TCY   IPM   MEM     dist #>    <mo>         <sir> <sir> <sir>  <dbl> #>  1 B_ENTRC_AVIM   S     S     NA   0     #>  2 B_ENTRC_AVIM   S     S     NA   0     #>  3 B_ENTRC_CSSL   NA    S     NA  NA     #>  4 B_ENTRC_FACM   S     S     NA  -2.66  #>  5 B_ENTRC_FACM   S     R     R   -0.423 #>  6 B_ENTRC_FACM   S     R     R   -0.423 #>  7 B_ENTRC_FACM   NA    R     R    0.224 #>  8 B_ENTRC_FACM   NA    R     R    0.224 #>  9 B_ENTRC_FACM   NA    R     R    0.224 #> 10 B_ENTRC_FACM   NA    R     R    0.224 #> # ℹ 53 more rows"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"data set containing commonly used codes microorganisms, laboratory systems WHONET. Define set_mo_source(). searched using .mo() consequently mo_* functions.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"tibble 6 036 observations 2 variables: code Commonly used code microorganism. unique identifier. mo ID microorganism microorganisms data set","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 6,036 × 2 #>    code  mo                #>    <chr> <mo>              #>  1 1011  B_GRAMP           #>  2 1012  B_GRAMP           #>  3 1013  B_GRAMN           #>  4 1014  B_GRAMN           #>  5 1015  F_YEAST           #>  6 103   B_ESCHR_COLI      #>  7 104   B_SLMNL_ENTR_ENTR #>  8 1100  B_STRPT           #>  9 1101  B_STRPT_VIRI      #> 10 1102  B_STRPT_HAEM      #> # ℹ 6,026 more rows  # 'ECO' or 'eco' is the WHONET code for E. coli: microorganisms.codes[microorganisms.codes$code == \"ECO\", ] #> # A tibble: 1 × 2 #>   code  mo           #>   <chr> <mo>         #> 1 ECO   B_ESCHR_COLI  # and therefore, 'eco' will be understood as E. coli in this package: mo_info(\"eco\") #> $mo #> [1] \"B_ESCHR_COLI\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Escherichia\" #>  #> $species #> [1] \"coli\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/escherichia-coli\" #>  #> $ref #> [1] \"Castellani et al., 1919\" #>  #> $snomed #>  [1] \"1095001000112106\" \"715307006\"        \"737528008\"        \"416989002\"        #>  [5] \"116397003\"        \"414097009\"        \"414098004\"        \"414099007\"        #>  [9] \"414100004\"        \"116395006\"        \"735270003\"        \"116396007\"        #> [13] \"83285000\"         \"116394005\"        \"112283007\"        \"710886005\"        #> [17] \"710887001\"        \"710888006\"        \"710889003\"        \"414132004\"        #> [21] \"721892009\"        \"416812001\"        \"416740004\"        \"417216001\"        #> [25] \"457541006\"        \"710253004\"        \"416530004\"        \"417189006\"        #> [29] \"409800005\"        \"713925008\"        \"444771000124108\"  \"838549008\"        #>  #> $lpsn #> [1] \"776057\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"11286021\" #>  #> $group_members #> character(0) #>   # works for all AMR functions: mo_is_intrinsic_resistant(\"eco\", ab = \"vancomycin\") #> [1] TRUE"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"data set containing species groups microbiological complexes, used clinical breakpoints table.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"tibble 534 observations 4 variables: mo_group ID species group / microbiological complex mo ID microorganism belonging species group / microbiological complex mo_group_name Name species group / microbiological complex, retrieved mo_name() mo_name Name microorganism belonging species group / microbiological complex, retrieved mo_name()","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups #> # A tibble: 534 × 4 #>    mo_group       mo           mo_group_name                   mo_name           #>    <mo>           <mo>         <chr>                           <chr>             #>  1 B_ACNTB_BMNN-C B_ACNTB_BMNN Acinetobacter baumannii complex Acinetobacter ba… #>  2 B_ACNTB_BMNN-C B_ACNTB_CLCC Acinetobacter baumannii complex Acinetobacter ca… #>  3 B_ACNTB_BMNN-C B_ACNTB_LCTC Acinetobacter baumannii complex Acinetobacter di… #>  4 B_ACNTB_BMNN-C B_ACNTB_NSCM Acinetobacter baumannii complex Acinetobacter no… #>  5 B_ACNTB_BMNN-C B_ACNTB_PITT Acinetobacter baumannii complex Acinetobacter pi… #>  6 B_ACNTB_BMNN-C B_ACNTB_SFRT Acinetobacter baumannii complex Acinetobacter se… #>  7 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex    Bacteroides frag… #>  8 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex    Bacteroides ovat… #>  9 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex    Bacteroides thet… #> 10 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex    Bacteroides vulg… #> # ℹ 524 more rows  # these are all species in the Bacteroides fragilis group, as per WHONET: microorganisms.groups[microorganisms.groups$mo_group == \"B_BCTRD_FRGL-C\", ] #> # A tibble: 5 × 4 #>   mo_group       mo           mo_group_name                mo_name               #>   <mo>           <mo>         <chr>                        <chr>                 #> 1 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex Bacteroides fragilis  #> 2 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex Bacteroides ovatus    #> 3 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex Bacteroides thetaiot… #> 4 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex Bacteroides vulgatus  #> 5 B_BCTRD_FRGL-C B_PRBCT_DSTS Bacteroides fragilis complex Parabacteroides dist…"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"data set containing full microbial taxonomy (last updated: June 24th, 2024) six kingdoms. data set backbone AMR package. MO codes can looked using .mo() microorganism properties can looked using mo_* functions. data set carefully crafted, yet made 100% reproducible public authoritative taxonomic sources (using script), namely: List Prokaryotic names Standing Nomenclature (LPSN) bacteria, MycoBank fungi, Global Biodiversity Information Facility (GBIF) others taxons.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"tibble 78 679 observations 26 variables: mo ID microorganism used package. unique identifier. fullname Full name, like \"Escherichia coli\". taxonomic ranks genus, species subspecies, 'pasted' text genus, species, subspecies. taxonomic ranks higher genus, name taxon. unique identifier. status  Status taxon, either \"accepted\", \"validly published\", \"synonym\", \"unknown\" kingdom, phylum, class, order, family, genus, species, subspecies Taxonomic rank microorganism. Note fungi, phylum equal taxonomic division. Also, fungi, subkingdom subdivision left since occur bacterial taxonomy. rank Text taxonomic rank microorganism, \"species\" \"genus\" ref Author(s) year related scientific publication. contains first surname year latest authors, e.g. \"Wallis et al. 2006 emend. Smith Jones 2018\" becomes \"Smith et al., 2018\". field directly retrieved source specified column source. Moreover, accents removed comply CRAN allows ASCII characters. oxygen_tolerance  Oxygen tolerance, either \"aerobe\", \"anaerobe\", \"anaerobe/microaerophile\", \"facultative anaerobe\", \"likely facultative anaerobe\", \"microaerophile\". data retrieved BacDive (see Source). Items contain \"likely\" missing BacDive extrapolated species within genus guess oxygen tolerance. Currently 68.3% ~39 000 bacteria data set contain oxygen tolerance. source Either \"GBIF\", \"LPSN\", \"Manually added\", \"MycoBank\", \"manually added\" (see Source) lpsn Identifier ('Record number') List Prokaryotic names Standing Nomenclature (LPSN). first/highest LPSN identifier keep one identifier per row. example, Acetobacter ascendens LPSN Record number 7864 11011. first available microorganisms data set. unique identifier, though available ~33 000 records. lpsn_parent LPSN identifier parent taxon lpsn_renamed_to LPSN identifier currently valid taxon mycobank Identifier ('MycoBank #') MycoBank. unique identifier, though available ~18 000 records. mycobank_parent MycoBank identifier parent taxon mycobank_renamed_to MycoBank identifier currently valid taxon gbif Identifier ('taxonID') Global Biodiversity Information Facility (GBIF). unique identifier, though available ~49 000 records. gbif_parent GBIF identifier parent taxon gbif_renamed_to GBIF identifier currently valid taxon prevalence Prevalence microorganism based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ), see mo_matching_score() full explanation snomed Systematized Nomenclature Medicine (SNOMED) code microorganism, version July 16th, 2024 (see Source). Use mo_snomed() retrieve quickly, see mo_property().","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Taxonomic entries imported order importance: List Prokaryotic names Standing Nomenclature (LPSN): Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. MycoBank: Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. Global Biodiversity Information Facility (GBIF): GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Furthermore, sources used additional details: BacDive: Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Systematized Nomenclature Medicine - Clinical Terms (SNOMED-CT): Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). Accessed https://www.cdc.gov/phin/php/phinvads/ July 16th, 2024. Grimont et al. (2007). Antigenic Formulae Salmonella Serovars, 9th Edition. Collaborating Centre Reference Research Salmonella (WHOCC-SALM). Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Please note entries based LPSN, MycoBank, GBIF (see ). Since sources incorporate entries based (recent) publications International Journal Systematic Evolutionary Microbiology (IJSEM), can happen year publication sometimes later one might expect. example, Staphylococcus pettenkoferi described first time Diagnostic Microbiology Infectious Disease 2002 (doi:10.1016/s0732-8893(02)00399-1 ), 2007 publication IJSEM followed (doi:10.1099/ijs.0.64381-0 ). Consequently, AMR package returns 2007 mo_year(\"S. pettenkoferi\").","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"included-taxa","dir":"Reference","previous_headings":"","what":"Included Taxa","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Included taxonomic data LPSN, MycoBank, GBIF : ~39 000 (sub)species kingdoms Archaea Bacteria ~28 000 species kingdom Fungi. kingdom Fungi large taxon almost 300,000 different (sub)species, microbial (rather macroscopic, like mushrooms). , fungi fit scope package. relevant fungi covered (species Aspergillus, Candida, Cryptococcus, Histoplasma, Pneumocystis, Saccharomyces Trichophyton). ~8 100 (sub)species kingdom Protozoa ~1 600 (sub)species 39 relevant genera kingdom Animalia (Strongyloides Taenia) ~22 000 previously accepted names included (sub)species (taxonomically renamed) complete taxonomic tree included (sub)species: kingdom subspecies identifier parent taxons year first author related scientific publication","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"manual-additions","dir":"Reference","previous_headings":"","what":"Manual additions","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"convenience, entries added manually: ~1 500 entries Salmonella, city-like serovars groups H 37 species groups (beta-haemolytic Streptococcus groups K, coagulase-negative Staphylococcus (CoNS), Mycobacterium tuberculosis complex, etc.), group compositions stored microorganisms.groups data set 1 entry Blastocystis (B.  hominis), although officially exist (Noel et al. 2005, PMID 15634993) 1 entry Moraxella (M. catarrhalis), formally named Branhamella catarrhalis (Catlin, 1970) though change never accepted within field clinical microbiology 8 'undefined' entries (unknown, unknown Gram-negatives, unknown Gram-positives, unknown yeast, unknown fungus, unknown anaerobic Gram-pos/Gram-neg bacteria) syntax used transform original data cleansed R format, can found .","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms #> # A tibble: 78,679 × 26 #>    mo          fullname   status kingdom phylum class order family genus species #>    <mo>        <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #>  1 B_GRAMN     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  2 B_GRAMP     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  3 B_ANAER-NEG (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  4 B_ANAER-POS (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  5 B_ANAER     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  6 F_FUNGUS    (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  7   UNKNOWN   (unknown … unkno… (unkno… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  8 P_PROTOZOAN (unknown … unkno… Protoz… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  9 F_YEAST     (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #> 10 F_AABRN     Aabaarnia  unkno… Fungi   Ascom… Leca… Ostr… \"\"     Aaba… \"\"      #> # ℹ 78,669 more rows #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Matching Score for Microorganisms — mo_matching_score","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm used .mo() mo_* functions determine probable match taxonomic records based user input.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_matching_score(x, n)"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"x user input value(s). n full taxonomic name, exists microorganisms$fullname.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm originally developed 2018 subsequently described : Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 . Later, work Bartlett et al. bacterial pathogens infecting humans (2022, doi:10.1099/mic.0.001269 ) incorporated, optimalisations algorithm made.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_reset_session() #> ℹ Reset 17 previously matched input values.  as.mo(\"E. coli\") #> Class 'mo' #> [1] B_ESCHR_COLI mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See `?mo_matching_score`. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #>  #> Only the first 10 other matches of each record are shown. Run #> `print(mo_uncertainties(), n = ...)` to view more entries, or save #> `mo_uncertainties()` to an object.  mo_matching_score(   x = \"E. coli\",   n = c(\"Escherichia coli\", \"Entamoeba coli\") ) #> [1] 0.6875000 0.3809524"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of a Microorganism — mo_property","title":"Get Properties of a Microorganism — mo_property","text":"Use functions return specific property microorganism based latest accepted taxonomy. input values evaluated internally .mo(), makes possible use microbial abbreviations, codes names input. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of a Microorganism — mo_property","text":"","code":"mo_name(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_fullname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_shortname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_subspecies(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_species(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_genus(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_family(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_order(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_class(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_phylum(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_kingdom(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_domain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_type(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_status(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_pathogenicity(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gramstain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_negative(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_positive(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_yeast(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_intrinsic_resistant(x, ab, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_oxygen_tolerance(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_anaerobic(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_snomed(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_ref(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_authors(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_year(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_lpsn(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_mycobank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gbif(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_rank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_taxonomy(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_synonyms(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_current(x, language = get_AMR_locale(), ...)  mo_group_members(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_info(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_url(x, open = FALSE, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_property(x, property = \"fullname\", language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of a Microorganism — mo_property","text":"x character (vector) can coerced valid microorganism code .mo(). Can left blank auto-guessing column containing microorganism codes used data set, see Examples. language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). ... arguments passed .mo(), 'minimum_matching_score', 'ignore_pattern', 'remove_from_input'. ab (vector ) text can coerced valid antibiotic drug code .ab(). open Browse URL using browseURL(). property One column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\", must \"shortname\".","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of a Microorganism — mo_property","text":"integer case mo_year() ordered factor case mo_pathogenicity() list case mo_taxonomy(), mo_synonyms(), mo_snomed(), mo_info() logical case mo_is_anaerobic(), mo_is_gram_negative(), mo_is_gram_positive(), mo_is_intrinsic_resistant(), mo_is_yeast() named character case mo_synonyms() mo_url() character cases","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of a Microorganism — mo_property","text":"functions , default, keep old taxonomic properties, synonyms automatically replaced current taxonomy. Take example Enterobacter aerogenes, initially named 1960 renamed Klebsiella aerogenes 2017: mo_genus(\"Enterobacter aerogenes\") return \"Klebsiella\" (note renaming) mo_genus(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Enterobacter\" (-per-session warning name outdated) mo_ref(\"Enterobacter aerogenes\") return \"Tindall et al., 2017\" (note renaming) mo_ref(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Hormaeche et al., 1960\" (-per-session warning name outdated) short name (mo_shortname()) returns first character genus full species, \"E. coli\", species subspecies. Exceptions abbreviations staphylococci (\"CoNS\", Coagulase-Negative Staphylococci) beta-haemolytic streptococci (\"GBS\", Group B Streptococci). Please bear mind e.g. E. coli mean Escherichia coli (kingdom Bacteria) well Entamoeba coli (kingdom Protozoa). Returning full name done using .mo() internally, giving priority bacteria human pathogens, .e. \"E. coli\" considered Escherichia coli. result, mo_fullname(mo_shortname(\"Entamoeba coli\")) returns \"Escherichia coli\". Since top-level taxonomy sometimes referred 'kingdom' sometimes 'domain', functions mo_kingdom() mo_domain() return exact results. Determination human pathogenicity (mo_pathogenicity()) strongly based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ). function returns factor levels Pathogenic, Potentially pathogenic, Non-pathogenic, Unknown. Determination Gram stain (mo_gramstain()) based taxonomic kingdom phylum. Originally, Cavalier-Smith defined -called subkingdoms Negibacteria Posibacteria (2002, PMID 11837318), considered phyla Posibacteria: Actinobacteria, Chloroflexi, Firmicutes, Tenericutes. phyla later renamed Actinomycetota, Chloroflexota, Bacillota, Mycoplasmatota (2021, PMID 34694987). Bacteria phyla considered Gram-positive AMR package, except members class Negativicutes (within phylum Bacillota) Gram-negative. bacteria considered Gram-negative. Species outside kingdom Bacteria return value NA. Functions mo_is_gram_negative() mo_is_gram_positive() always return TRUE FALSE (NA input NA MO code UNKNOWN), thus always return FALSE species outside taxonomic kingdom Bacteria. Determination yeasts (mo_is_yeast()) based taxonomic kingdom class. Budding yeasts yeasts reproduce asexually process called budding, new cell develops small protrusion parent cell. Taxonomically, members phylum Ascomycota, class Saccharomycetes (also called Hemiascomycetes) Pichiomycetes. True yeasts quite specifically refers yeasts underlying order Saccharomycetales (Saccharomyces cerevisiae). Thus, microorganisms member taxonomic class Saccharomycetes Pichiomycetes, function return TRUE. returns FALSE otherwise (NA input NA MO code UNKNOWN). Determination intrinsic resistance (mo_is_intrinsic_resistant()) based intrinsic_resistant data set, based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). mo_is_intrinsic_resistant() function can vectorised argument x (input microorganisms) ab (input antimicrobials). Determination bacterial oxygen tolerance (mo_oxygen_tolerance()) based BacDive, see Source. function mo_is_anaerobic() returns TRUE oxygen tolerance \"anaerobe\", indicting obligate anaerobic species genus. always returns FALSE species outside taxonomic kingdom Bacteria. function mo_url() return direct URL online database entry, also shows scientific reference concerned species. MycoBank URL used fungi wherever available , LPSN URL bacteria wherever available, GBIF link otherwise. SNOMED codes (mo_snomed()) last updated July 16th, 2024. See Source microorganisms data set info. Old taxonomic names (-called 'synonyms') can retrieved mo_synonyms() (scientific reference name), current taxonomic name can retrieved mo_current(). functions return full names. output translated possible.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Get Properties of a Microorganism — mo_property","text":"function uses .mo() internally, uses advanced algorithm translate arbitrary user input valid taxonomy using -called matching score. can read public algorithm MO matching score page.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of a Microorganism — mo_property","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of a Microorganism — mo_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of a Microorganism — mo_property","text":"","code":"# taxonomic tree -----------------------------------------------------------  mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_phylum(\"Klebsiella pneumoniae\") #> [1] \"Pseudomonadota\" mo_class(\"Klebsiella pneumoniae\") #> [1] \"Gammaproteobacteria\" mo_order(\"Klebsiella pneumoniae\") #> [1] \"Enterobacterales\" mo_family(\"Klebsiella pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"Klebsiella pneumoniae\") #> [1] \"pneumoniae\" mo_subspecies(\"Klebsiella pneumoniae\") #> [1] \"\"   # full names and short names -----------------------------------------------  mo_name(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_fullname(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_shortname(\"Klebsiella pneumoniae\") #> [1] \"K. pneumoniae\"   # other properties ---------------------------------------------------------  mo_pathogenicity(\"Klebsiella pneumoniae\") #> [1] Pathogenic #> Levels: Pathogenic < Potentially pathogenic < Non-pathogenic < Unknown mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\" mo_snomed(\"Klebsiella pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_rank(\"Klebsiella pneumoniae\") #> [1] \"species\" mo_url(\"Klebsiella pneumoniae\") #>                                Klebsiella pneumoniae  #> \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\"  mo_is_yeast(c(\"Candida\", \"Trichophyton\", \"Klebsiella\")) #> [1]  TRUE FALSE FALSE  mo_group_members(c(   \"Streptococcus group A\",   \"Streptococcus group C\",   \"Streptococcus group G\",   \"Streptococcus group L\" )) #> $`Streptococcus Group A` #> [1] \"Streptococcus pyogenes\" #>  #> $`Streptococcus Group C` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #> [4] \"Streptococcus equi\"                      #> [5] \"Streptococcus equi equi\"                 #> [6] \"Streptococcus equi ruminatorum\"          #> [7] \"Streptococcus equi zooepidemicus\"        #>  #> $`Streptococcus Group G` #> [1] \"Streptococcus canis\"                     #> [2] \"Streptococcus dysgalactiae\"              #> [3] \"Streptococcus dysgalactiae dysgalactiae\" #> [4] \"Streptococcus dysgalactiae equisimilis\"  #>  #> $`Streptococcus Group L` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #>    # scientific reference -----------------------------------------------------  mo_ref(\"Klebsiella aerogenes\") #> [1] \"Tindall et al., 2017\" mo_authors(\"Klebsiella aerogenes\") #> [1] \"Tindall et al.\" mo_year(\"Klebsiella aerogenes\") #> [1] 2017 mo_synonyms(\"Klebsiella aerogenes\") #>   Hormaeche et al., 1960     Bascomb et al., 1971  #> \"Enterobacter aerogenes\"     \"Klebsiella mobilis\"  mo_lpsn(\"Klebsiella aerogenes\") #> [1] \"777146\" mo_gbif(\"Klebsiella aerogenes\") #> [1] \"9281703\" mo_mycobank(\"Candida albicans\") #> [1] \"256187\" mo_mycobank(\"Candida krusei\") #> [1] \"337013\" mo_mycobank(\"Candida krusei\", keep_synonyms = TRUE) #> Warning: Function `as.mo()` returned one old taxonomic name. Use `as.mo(..., #> keep_synonyms = FALSE)` to clean the input to currently accepted taxonomic #> names, or set the R option `AMR_keep_synonyms` to `FALSE`. This warning #> will be shown once per session. #> [1] \"268707\"   # abbreviations known in the field -----------------------------------------  mo_genus(\"MRSA\") #> [1] \"Staphylococcus\" mo_species(\"MRSA\") #> [1] \"aureus\" mo_shortname(\"VISA\") #> [1] \"S. aureus\" mo_gramstain(\"VISA\") #> [1] \"Gram-positive\"  mo_genus(\"EHEC\") #> [1] \"Escherichia\" mo_species(\"EIEC\") #> [1] \"coli\" mo_name(\"UPEC\") #> [1] \"Escherichia coli\"   # known subspecies ---------------------------------------------------------  mo_fullname(\"K. pneu rh\") #> [1] \"Klebsiella pneumoniae rhinoscleromatis\" mo_shortname(\"K. pneu rh\") #> [1] \"K. pneumoniae\"  # \\donttest{ # Becker classification, see ?as.mo ----------------------------------------  mo_fullname(\"Staph epidermidis\") #> [1] \"Staphylococcus epidermidis\" mo_fullname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"Coagulase-negative Staphylococcus (CoNS)\" mo_shortname(\"Staph epidermidis\") #> [1] \"S. epidermidis\" mo_shortname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"CoNS\"   # Lancefield classification, see ?as.mo ------------------------------------  mo_fullname(\"Strep agalactiae\") #> [1] \"Streptococcus agalactiae\" mo_fullname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"Streptococcus Group B\" mo_shortname(\"Strep agalactiae\") #> [1] \"S. agalactiae\" mo_shortname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"GBS\"   # language support  --------------------------------------------------------  mo_gramstain(\"Klebsiella pneumoniae\", language = \"de\") # German #> [1] \"Gramnegativ\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"nl\") # Dutch #> [1] \"Gram-negatief\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"es\") # Spanish #> [1] \"Gram negativo\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"el\") # Greek #> [1] \"Αρνητικό κατά Gram\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"uk\") # Ukrainian #> [1] \"Грамнегативні\"  # mo_type is equal to mo_kingdom, but mo_kingdom will remain untranslated mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_kingdom(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, no effect #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, translated #> [1] \"细菌\"  mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"de\") #> [1] \"Streptococcus Gruppe A\" mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"uk\") #> [1] \"Streptococcus Група A\"   # other --------------------------------------------------------------------  # gram stains and intrinsic resistance can be used as a filter in dplyr verbs if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_gram_positive()) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for `mo_is_gram_positive()` #> ℹ Using column 'mo' as input for `mo_genus()` #> # A tibble: 18 × 2 #>    `mo_genus()`        n #>    <chr>           <int> #>  1 Staphylococcus    840 #>  2 Streptococcus     275 #>  3 Enterococcus       83 #>  4 Corynebacterium    17 #>  5 Micrococcus         6 #>  6 Gemella             3 #>  7 Aerococcus          2 #>  8 Cutibacterium       1 #>  9 Dermabacter         1 #> 10 Fusibacter          1 #> 11 Globicatella        1 #> 12 Granulicatella      1 #> 13 Lactobacillus       1 #> 14 Leuconostoc         1 #> 15 Listeria            1 #> 16 Paenibacillus       1 #> 17 Rothia              1 #> 18 Schaalia            1 if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_intrinsic_resistant(ab = \"vanco\")) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for `mo_is_intrinsic_resistant()` #> ℹ Using column 'mo' as input for `mo_genus()` #> # A tibble: 19 × 2 #>    `mo_genus()`         n #>    <chr>            <int> #>  1 Escherichia        467 #>  2 Klebsiella          77 #>  3 Proteus             39 #>  4 Pseudomonas         30 #>  5 Serratia            25 #>  6 Enterobacter        23 #>  7 Citrobacter         11 #>  8 Haemophilus          9 #>  9 Acinetobacter        6 #> 10 Morganella           6 #> 11 Pantoea              4 #> 12 Salmonella           3 #> 13 Neisseria            2 #> 14 Stenotrophomonas     2 #> 15 Campylobacter        1 #> 16 Enterococcus         1 #> 17 Hafnia               1 #> 18 Leuconostoc          1 #> 19 Pseudescherichia     1  # get a list with the complete taxonomy (from kingdom to subspecies) mo_taxonomy(\"Klebsiella pneumoniae\") #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>   # get a list with the taxonomy, the authors, Gram-stain, # SNOMED codes, and URL to the online database mo_info(\"Klebsiella pneumoniae\") #> $mo #> [1] \"B_KLBSL_PNMN\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\" #>  #> $ref #> [1] \"Trevisan, 1887\" #>  #> $snomed #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  #> $lpsn #> [1] \"777151\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"3221874\" #>  #> $group_members #> character(0) #>  # }"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":null,"dir":"Reference","previous_headings":"","what":"User-Defined Reference Data Set for Microorganisms — mo_source","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"functions can used predefine reference used .mo() consequently mo_* functions (mo_genus() mo_gramstain()). fastest way organisation (analysis) specific codes picked translated package, since bother setting .","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"","code":"set_mo_source(path, destination = getOption(\"AMR_mo_source\",   \"~/mo_source.rds\"))  get_mo_source(destination = getOption(\"AMR_mo_source\", \"~/mo_source.rds\"))"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"path Location reference file, can text file (comma-, tab- pipe-separated) Excel file (see Details). Can also \"\", NULL FALSE delete reference file. destination Destination compressed data file - default user's home directory.","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"reference file can text file separated commas (CSV) tabs pipes, Excel file (either 'xls' 'xlsx' format) R object file (extension '.rds'). use Excel file, need readxl package installed. set_mo_source() check file validity: must data.frame, must column named \"mo\" contains values microorganisms$mo microorganisms$fullname must reference column defined values. tests pass, set_mo_source() read file R ask export \"~/mo_source.rds\". CRAN policy disallows packages write file system, although 'exceptions may allowed interactive sessions package obtains confirmation user'. reason, function works interactive sessions user can specifically confirm allow file created. destination file can set destination argument defaults user's home directory. can also set package option AMR_mo_source, e.g. options(AMR_mo_source = \"/location/file.rds\"). created compressed data file \"mo_source.rds\" used default MO determination (function .mo() consequently mo_* functions like mo_genus() mo_gramstain()). location timestamp original file saved attribute compressed data file. function get_mo_source() return data set reading \"mo_source.rds\" readRDS(). original file changed (checking location timestamp original file), call set_mo_source() update data file automatically used interactive session. Reading Excel file (.xlsx) one row size 8-9 kB. compressed file created set_mo_source() size 0.1 kB can read get_mo_source() couple microseconds (millionths second).","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"how-to-setup","dir":"Reference","previous_headings":"","what":"How to Setup","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"Imagine data sheet Excel file. first column contains organisation specific codes, second column contains valid taxonomic names:   save \"/Users//Documents/ourcodes.xlsx\". Now set source:   now created file \"~/mo_source.rds\" contents Excel file. first column foreign values 'mo' column kept creating RDS file. now can use functions:   edit Excel file , say, adding row 4 like :   ...new usage MO function package update data file:   delete reference data file, just use \"\", NULL FALSE input set_mo_source():   original file (previous case Excel file) moved deleted, mo_source.rds file removed upon next use .mo() mo_* function.","code":"|         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 |                    |                       | set_mo_source(\"/Users/me/Documents/ourcodes.xlsx\") #> NOTE: Created mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>       \"Organisation XYZ\" and \"mo\" as.mo(\"lab_mo_ecoli\") #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_mo_kpneumoniae\") #> [1] \"Klebsiella\"  # other input values still work too as.mo(c(\"Escherichia coli\", \"E. coli\", \"lab_mo_ecoli\")) #> NOTE: Translation to one microorganism was guessed with uncertainty. #>       Use mo_uncertainties() to review it. #> Class 'mo' #> [1] B_ESCHR_COLI B_ESCHR_COLI B_ESCHR_COLI |         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 | lab_Staph_aureus   | Staphylococcus aureus | 5 |                    |                       | as.mo(\"lab_mo_ecoli\") #> NOTE: Updated mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>        \"Organisation XYZ\" and \"mo\" #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_Staph_aureus\") #> [1] \"Staphylococcus\" set_mo_source(NULL) #> Removed mo_source file '/Users/me/mo_source.rds'"},{"path":"https://amr-for-r.org/reference/pca.html","id":null,"dir":"Reference","previous_headings":"","what":"Principal Component Analysis (for AMR) — pca","title":"Principal Component Analysis (for AMR) — pca","text":"Performs principal component analysis (PCA) based data set automatic determination afterwards plotting groups labels, automatic filtering suitable (.e. non-empty numeric) variables.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"pca(x, ..., retx = TRUE, center = TRUE, scale. = TRUE, tol = NULL,   rank. = NULL)"},{"path":"https://amr-for-r.org/reference/pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Principal Component Analysis (for AMR) — pca","text":"x data.frame containing numeric columns. ... Columns x selected PCA, can unquoted since supports quasiquotation. retx logical value indicating whether rotated variables     returned. center logical value indicating whether variables     shifted zero centered. Alternately, vector     length equal number columns x can supplied.     value passed scale. scale. logical value indicating whether variables     scaled unit variance analysis takes     place.  default FALSE consistency S,     general scaling advisable.  Alternatively, vector length     equal number columns x can supplied.      value passed scale. tol value indicating magnitude components     omitted. (Components omitted     standard deviations less equal tol times     standard deviation first component.)  default null     setting, components omitted (unless rank. specified     less min(dim(x)).).  settings tol     tol = 0 tol = sqrt(.Machine$double.eps),     omit essentially constant components. rank. optionally, number specifying maximal rank, .e.,     maximal number principal components used.  Can set     alternative addition tol, useful notably     desired rank considerably smaller dimensions matrix.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Principal Component Analysis (for AMR) — pca","text":"object classes pca prcomp","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Principal Component Analysis (for AMR) — pca","text":"pca() function takes data.frame input performs actual PCA R function prcomp(). result pca() function prcomp object, additional attribute non_numeric_cols vector column names columns contain numeric values. probably groups labels, used ggplot_pca().","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    pca_result   summary(pca_result)   # old base R plotting method:   biplot(pca_result) } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (`minimum` = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # new ggplot2 plotting method using this package: if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) }  if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"Title here\") }  # }"},{"path":"https://amr-for-r.org/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Plotting Helpers for AMR Data Analysis — plot","title":"Plotting Helpers for AMR Data Analysis — plot","text":"Functions plot classes sir, mic disk, support base R ggplot2. Especially scale_*_mic() functions relevant wrappers plot MIC values ggplot2. allows custom MIC ranges plot intermediate log2 levels missing MIC values.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"scale_x_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_y_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_colour_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_fill_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_x_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_colour_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I =   \"#F6D55C\", R = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_fill_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\",   R = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  # S3 method for class 'mic' plot(x, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   main = deparse(substitute(x)), ylab = translate_AMR(\"Frequency\", language   = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'mic' autoplot(object, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' plot(x, main = deparse(substitute(x)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Disk diffusion diameter (mm)\", language = language),   mo = NULL, ab = NULL, guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' autoplot(object, mo = NULL, ab = NULL,   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language), xlab = translate_AMR(\"Disk diffusion diameter (mm)\",   language = language), guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'sir' plot(x, ylab = translate_AMR(\"Percentage\", language =   language), xlab = translate_AMR(\"Antimicrobial Interpretation\", language =   language), main = deparse(substitute(x)), language = get_AMR_locale(),   ...)  # S3 method for class 'sir' autoplot(object, title = deparse(substitute(object)),   xlab = translate_AMR(\"Antimicrobial Interpretation\", language = language),   ylab = translate_AMR(\"Frequency\", language = language), colours_SIR = c(S   = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R = \"#ED553B\"),   language = get_AMR_locale(), ...)  facet_sir(facet = c(\"interpretation\", \"antibiotic\"), nrow = NULL)  scale_y_percent(breaks = function(x) seq(0, max(x, na.rm = TRUE), 0.1),   limits = c(0, NA))  scale_sir_colours(..., aesthetics, colours_SIR = c(S = \"#3CAEA3\", SDD =   \"#8FD6C4\", I = \"#F6D55C\", R = \"#ED553B\"))  theme_sir()  labels_sir_count(position = NULL, x = \"antibiotic\",   translate_ab = \"name\", minimum = 30, language = get_AMR_locale(),   combine_SI = TRUE, datalabels.size = 3, datalabels.colour = \"grey15\")"},{"path":"https://amr-for-r.org/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plotting Helpers for AMR Data Analysis — plot","text":"keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values (using rescale_mic()), e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). Note: rescales values filter - use ggplot2 limits argument separately exclude values plot. ... Arguments passed methods. colours_SIR Colours use filling bars, must vector three values (order S, R). default colours colour-blind friendly. language Language used translate 'Susceptible', 'Increased exposure'/'Intermediate' 'Resistant' - default system language (see get_AMR_locale()) can overwritten setting package option AMR_locale, e.g. options(AMR_locale = \"de\"), see translate. Use language = NULL prevent translation. eucast_I logical indicate whether '' must interpreted \"Susceptible, increased exposure\". TRUE default AMR interpretation guideline set EUCAST (default). FALSE, interpreted \"Intermediate\". x, object Values created .mic(), .disk() .sir() (random_* variants, random_mic()). mo (vector ) text can coerced valid microorganism code .mo(). ab (vector ) text can coerced valid antimicrobial drug code .ab(). guideline Interpretation guideline use - default latest included EUCAST guideline, see Details. main, title Title plot. xlab, ylab Axis title. expand logical indicate whether range x axis expanded lowest highest value. MIC values, intermediate values factors 2 starting highest MIC value. disk diameters, whole diameter range filled. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. nrow (using facet) number rows. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. aesthetics Aesthetics apply colours - default \"fill\" can also (combination ) \"alpha\", \"colour\", \"fill\", \"linetype\", \"shape\" \"size\". position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. datalabels.size Size datalabels. datalabels.colour Colour datalabels.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Plotting Helpers for AMR Data Analysis — plot","text":"autoplot() functions return ggplot model extendible ggplot2 function.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-mic-functions","dir":"Reference","previous_headings":"","what":"The scale_*_mic() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_mic(), scale_y_mic(), scale_colour_mic(), scale_fill_mic() functions allow plot mic class (MIC values) continuous, logarithmic scale. also allow rescale MIC range 'inside' 'outside' range required, retain operators MIC values (>=) desired. Missing intermediate log2 levels plotted .","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-sir-functions","dir":"Reference","previous_headings":"","what":"The scale_*_sir() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_sir(), scale_colour_sir(), scale_fill_sir() functions allow plot sir class right order (S < SDD < < R < NI). default, translate S//R values interpretative text (\"Susceptible\", \"Resistant\", etc.) 28 supported languages (use language = NULL keep S//R). Also, except scale_x_sir(), set colour-blind friendly colours colour fill aesthetics.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"additional-ggplot-functions","dir":"Reference","previous_headings":"","what":"Additional ggplot2 Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"package contains functions extend ggplot2 package, help visualising AMR data results. functions internally used ggplot_sir() . facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() allows set colours aesthetic, even shape linetype. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage number isolates, using ggplot2::geom_text(). interpretation \"\" named \"Increased exposure\" EUCAST guidelines since 2019, named \"Intermediate\" cases. interpreting MIC values well disk diffusion diameters, default guideline EUCAST 2025, unless package option AMR_guideline set. See .sir() information.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"some_mic_values <- random_mic(size = 100) some_disk_values <- random_disk(size = 100, mo = \"Escherichia coli\", ab = \"cipro\") some_sir_values <- random_sir(50, prob_SIR = c(0.55, 0.05, 0.30))  # \\donttest{ # Plotting using ggplot2's autoplot() for MIC, disk, and SIR ----------- if (require(\"ggplot2\")) {   autoplot(some_mic_values) }  if (require(\"ggplot2\")) {   # when providing the microorganism and antibiotic, colours will show interpretations:   autoplot(some_mic_values, mo = \"Escherichia coli\", ab = \"cipro\") }  if (require(\"ggplot2\")) {   autoplot(some_mic_values, mo = \"Staph aureus\", ab = \"Ceftaroline\", guideline = \"CLSI\") }   if (require(\"ggplot2\")) {   # support for 27 languages, various guidelines, and many options   autoplot(some_disk_values,     mo = \"Escherichia coli\", ab = \"cipro\",     guideline = \"CLSI 2024\", language = \"no\",     title = \"Disk diffusion from the North\"   ) }    # Plotting using scale_x_mic() ----------------------------------------- if (require(\"ggplot2\")) {   mic_plot <- ggplot(     data.frame(       mics = as.mic(c(0.25, \"<=4\", 4, 8, 32, \">=32\")),       counts = c(1, 1, 2, 2, 3, 3)     ),     aes(mics, counts)   ) +     geom_col()   mic_plot +     labs(title = \"without scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic() +     labs(title = \"with scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(keep_operators = \"all\") +     labs(title = \"with scale_x_mic() keeping all operators\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(1, 16)) +     labs(title = \"with scale_x_mic() using a manual 'within' range\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(0.032, 256)) +     labs(title = \"with scale_x_mic() using a manual 'outside' range\") }    # Plotting using scale_y_mic() ----------------------------------------- some_groups <- sample(LETTERS[1:5], 20, replace = TRUE)  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey30\", fill = NA) +     scale_y_mic() }  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey30\", fill = NA) +     scale_y_mic(mic_range = c(NA, 0.25)) }    # Plotting using scale_x_sir() ----------------------------------------- if (require(\"ggplot2\")) {   ggplot(     data.frame(       x = c(\"I\", \"R\", \"S\"),       y = c(45, 323, 573)     ),     aes(x, y)   ) +     geom_col() +     scale_x_sir() }    # Plotting using scale_y_mic() and scale_colour_sir() ------------------ if (require(\"ggplot2\")) {   plain <- ggplot(     data.frame(       mic = some_mic_values,       group = some_groups,       sir = as.sir(some_mic_values,         mo = \"E. coli\",         ab = \"cipro\"       )     ),     aes(x = group, y = mic, colour = sir)   ) +     theme_minimal() +     geom_boxplot(fill = NA, colour = \"grey30\") +     geom_jitter(width = 0.25)    plain }  if (require(\"ggplot2\")) {   # and now with our MIC and SIR scale functions:   plain +     scale_y_mic() +     scale_colour_sir() } #> Warning: Removed 5 rows containing missing values or values outside the scale range #> (`geom_point()`).  if (require(\"ggplot2\")) {   plain +     scale_y_mic(mic_range = c(0.005, 32), name = \"Our MICs!\") +     scale_colour_sir(       language = \"pt\",       name = \"Support in 27 languages\"     ) } #> Warning: Removed 5 rows containing missing values or values outside the scale range #> (`geom_point()`).  # }  # Plotting using base R's plot() ---------------------------------------  plot(some_mic_values)  # when providing the microorganism and antibiotic, colours will show interpretations: plot(some_mic_values, mo = \"S. aureus\", ab = \"ampicillin\")  #> Error in if (any(cols_sub$cols == colours_SIR[2] & cols_sub$count > 0)) {    legend_txt <- c(legend_txt, \"(SDD) Susceptible dose-dependent\")    legend_col <- c(legend_col, colours_SIR[2])}: missing value where TRUE/FALSE needed  plot(some_disk_values)  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\")  #> Error in if (any(cols_sub$cols == colours_SIR[3] & cols_sub$count > 0)) {    legend_txt <- c(legend_txt, paste(\"(I)\", plot_name_of_I(cols_sub$guideline)))    legend_col <- c(legend_col, colours_SIR[3])}: missing value where TRUE/FALSE needed plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\", language = \"nl\")  #> Error in if (any(cols_sub$cols == colours_SIR[3] & cols_sub$count > 0)) {    legend_txt <- c(legend_txt, paste(\"(I)\", plot_name_of_I(cols_sub$guideline)))    legend_col <- c(legend_col, colours_SIR[3])}: missing value where TRUE/FALSE needed  plot(some_sir_values)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate Antimicrobial Resistance — proportion","title":"Calculate Antimicrobial Resistance — proportion","text":"functions can used calculate (co-)resistance susceptibility microbial isolates (.e. percentage S, SI, , IR R). functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. resistance() used calculate resistance, susceptibility() used calculate susceptibility.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"resistance(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  susceptibility(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  sir_confidence_interval(..., ab_result = \"R\", minimum = 30,   as_percent = FALSE, only_all_tested = FALSE, confidence_level = 0.95,   side = \"both\", collapse = FALSE)  proportion_R(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_IR(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_I(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_SI(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_S(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)  sir_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Calculate Antimicrobial Resistance — proportion","text":"M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate Antimicrobial Resistance — proportion","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. Use multiple columns calculate (lack ) co-resistance: probability one two drugs resistant susceptible result. See Examples. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. as_percent logical indicate whether output must returned hundred fold % sign (character). value 0.123456 returned \"12.3%\". only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . ab_result Antibiotic results test , must one values \"S\", \"SDD\", \"\", \"R\". confidence_level confidence level returned confidence interval. calculation, number S SI isolates, R isolates compared total number available isolates R, S, using binom.test(), .e., Clopper-Pearson method. side side confidence interval return. default \"\" length 2 vector, can also (abbreviated ) \"min\"/\"left\"/\"lower\"/\"less\" \"max\"/\"right\"/\"higher\"/\"greater\". collapse logical indicate whether output values 'collapsed', .e. merged together one value, character value use collapsing. data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate Antimicrobial Resistance — proportion","text":"double , as_percent = TRUE, character.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate Antimicrobial Resistance — proportion","text":"automated comprehensive analysis, consider using antibiogram() wisca(), streamline many aspects susceptibility reporting , importantly, also support WISCA. functions described offer hands-, manual approach greater customisation. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine data set one four available algorithms. function resistance() equal function proportion_R(). function susceptibility() equal function proportion_SI(). Since AMR v3.0, proportion_SI() proportion_I() include dose-dependent susceptibility ('SDD'). Use sir_confidence_interval() calculate confidence interval, relies binom.test(), .e., Clopper-Pearson method. function returns vector length 2 default antimicrobial resistance. Change side argument \"left\"/\"min\" \"right\"/\"max\" return single value, change ab_result argument e.g. c(\"S\", \"\") test antimicrobial susceptibility, see Examples. functions meant count isolates, calculate proportion resistance/susceptibility. Use count_*() functions count isolates. function susceptibility() essentially equal count_susceptible()/count_all(). Low counts can influence outcome - proportion_*() functions may camouflage , since return proportion (albeit dependent minimum argument). function proportion_df() takes variable data sir class (created .sir()) calculates proportions S, , R. also supports grouped variables. function sir_df() works exactly like proportion_df(), adds number isolates.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Calculate Antimicrobial Resistance — proportion","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Calculate Antimicrobial Resistance — proportion","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # base R ------------------------------------------------------------ # determines %R resistance(example_isolates$AMX) #> [1] 0.5955556 sir_confidence_interval(example_isolates$AMX) #> [1] 0.5688204 0.6218738 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975 ) #> [1] 0.5650148 0.6255670 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975,   collapse = \", \" ) #> [1] \"0.565, 0.626\"  # determines %S+I: susceptibility(example_isolates$AMX) #> [1] 0.4044444 sir_confidence_interval(example_isolates$AMX,   ab_result = c(\"S\", \"I\") ) #> [1] 0.3781262 0.4311796  # be more specific proportion_S(example_isolates$AMX) #> [1] 0.4022222 proportion_SI(example_isolates$AMX) #> [1] 0.4044444 proportion_I(example_isolates$AMX) #> [1] 0.002222222 proportion_IR(example_isolates$AMX) #> [1] 0.5977778 proportion_R(example_isolates$AMX) #> [1] 0.5955556  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       r = resistance(CIP),       n = n_sir(CIP)     ) # n_sir works like n_distinct in dplyr, see ?n_sir } #> # A tibble: 3 × 3 #>   ward           r     n #>   <chr>      <dbl> <int> #> 1 Clinical   0.147   869 #> 2 ICU        0.190   447 #> 3 Outpatient 0.161    93 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       cipro_R = resistance(CIP),       ci_min = sir_confidence_interval(CIP, side = \"min\"),       ci_max = sir_confidence_interval(CIP, side = \"max\"),     ) } #> # A tibble: 3 × 4 #>   ward       cipro_R ci_min ci_max #>   <chr>        <dbl>  <dbl>  <dbl> #> 1 Clinical     0.147 0.124   0.173 #> 2 ICU          0.190 0.155   0.230 #> 3 Outpatient   0.161 0.0932  0.252 if (require(\"dplyr\")) {   # scoped dplyr verbs with antimicrobial selectors   # (you could also use across() of course)   example_isolates %>%     group_by(ward) %>%     summarise_at(       c(aminoglycosides(), carbapenems()),       resistance     ) } #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `KAN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = #> \"Outpatient\" (`minimum` = 30). #> # A tibble: 3 × 7 #>   ward         GEN   TOB   AMK   KAN    IPM    MEM #>   <chr>      <dbl> <dbl> <dbl> <dbl>  <dbl>  <dbl> #> 1 Clinical   0.229 0.315 0.626     1 0.0498 0.0458 #> 2 ICU        0.290 0.400 0.662     1 0.0862 0.0894 #> 3 Outpatient 0.2   0.368 0.605    NA 0.0541 0.0541 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = resistance(CIP, as_percent = TRUE),       SI = susceptibility(CIP, as_percent = TRUE),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Calculate co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy:   example_isolates %>% susceptibility(AMC) # %SI = 76.3%   example_isolates %>% count_all(AMC) #   n = 1879    example_isolates %>% susceptibility(GEN) # %SI = 75.4%   example_isolates %>% count_all(GEN) #   n = 1855    example_isolates %>% susceptibility(AMC, GEN) # %SI = 94.1%   example_isolates %>% count_all(AMC, GEN) #   n = 1939     # See Details on how `only_all_tested` works. Example:   example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN),       denominator = count_all(AMC, GEN),       proportion = susceptibility(AMC, GEN)     )    example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN, only_all_tested = TRUE),       denominator = count_all(AMC, GEN, only_all_tested = TRUE),       proportion = susceptibility(AMC, GEN, only_all_tested = TRUE)     )     example_isolates %>%     group_by(ward) %>%     summarise(       cipro_p = susceptibility(CIP, as_percent = TRUE),       cipro_n = count_all(CIP),       genta_p = susceptibility(GEN, as_percent = TRUE),       genta_n = count_all(GEN),       combination_p = susceptibility(CIP, GEN, as_percent = TRUE),       combination_n = count_all(CIP, GEN)     )    # Get proportions S/I/R immediately of all sir columns   example_isolates %>%     select(AMX, CIP) %>%     proportion_df(translate = FALSE)    # It also supports grouping variables   # (use sir_df to also include the count)   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     sir_df(translate = FALSE) } #> # A tibble: 12 × 7 #>    ward       antibiotic interpretation value ci_min ci_max isolates #>    <chr>      <chr>      <ord>          <dbl>  <dbl>  <dbl>    <int> #>  1 Clinical   AMX        SI             0.423 0.389   0.457      357 #>  2 Clinical   AMX        R              0.577 0.543   0.611      487 #>  3 Clinical   CIP        SI             0.853 0.827   0.876      741 #>  4 Clinical   CIP        R              0.147 0.124   0.173      128 #>  5 ICU        AMX        SI             0.369 0.323   0.417      158 #>  6 ICU        AMX        R              0.631 0.583   0.677      270 #>  7 ICU        CIP        SI             0.810 0.770   0.845      362 #>  8 ICU        CIP        R              0.190 0.155   0.230       85 #>  9 Outpatient AMX        SI             0.397 0.288   0.515       31 #> 10 Outpatient AMX        R              0.603 0.485   0.712       47 #> 11 Outpatient CIP        SI             0.839 0.748   0.907       78 #> 12 Outpatient CIP        R              0.161 0.0932  0.252       15 # }"},{"path":"https://amr-for-r.org/reference/random.html","id":null,"dir":"Reference","previous_headings":"","what":"Random MIC Values/Disk Zones/SIR Generation — random","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"functions can used generating random MIC values disk diffusion diameters, AMR data analysis practice. providing microorganism antimicrobial drug, generated results reflect reality much possible.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(size = NULL, mo = NULL, ab = NULL, skew = \"right\",   severity = 1, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, skew = \"left\",   severity = 1, ...)  random_sir(size = NULL, prob_SIR = c(0.33, 0.33, 0.33), ...)"},{"path":"https://amr-for-r.org/reference/random.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"size Desired size returned vector. used data.frame call dplyr verb, get current (group) size left blank. mo character can coerced valid microorganism code .mo(). Can length size. ab character can coerced valid antimicrobial drug code .ab(). skew Direction skew MIC disk values, either \"right\" \"left\". left-skewed distribution majority data right. severity Skew severity; higher values increase skewedness. Default 2; use 0 prevent skewedness. ... Ignored, place allow future extensions. prob_SIR vector length 3: probabilities \"S\" (1st value), \"\" (2nd value) \"R\" (3rd value).","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"class mic random_mic() (see .mic()) class disk random_disk() (see .disk())","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"Internally, MIC disk zone values sampled based clinical breakpoints defined clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument. MICs sampled log2 scale disks linearly, using weighted probabilities. weights based skew severity arguments: skew = \"right\" places emphasis lower MIC higher disk values. skew = \"left\" places emphasis higher MIC lower disk values. severity controls exponential bias applied.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(25) #> Class 'mic' #>  [1] 1      0.064  2      0.016  128    0.001  0.004  0.008  64     0.064  #> [11] 0.002  0.001  0.016  0.004  0.0005 0.0005 0.125  0.032  0.032  8      #> [21] 2      8      0.008  0.0005 8      random_disk(25) #> Class 'disk' #>  [1] 46 38 45 47 24 28 45 43 19 23 44 19 31 22 40 39 39 36 35 14 34 45 21 19 39 random_sir(25) #> Class 'sir' #>  [1] I S R I R I S S S R R R I I R R I S R R S I S R I  # add more skewedness, make more realistic by setting a bug and/or drug: disks <- random_disk(100, severity = 2, mo = \"Escherichia coli\", ab = \"CIP\") plot(disks)  # `plot()` and `ggplot2::autoplot()` allow for coloured bars if `mo` and `ab` are set plot(disks, mo = \"Escherichia coli\", ab = \"CIP\", guideline = \"CLSI 2025\")  #> Error in if (any(cols_sub$cols == colours_SIR[3] & cols_sub$count > 0)) {    legend_txt <- c(legend_txt, paste(\"(I)\", plot_name_of_I(cols_sub$guideline)))    legend_col <- c(legend_col, colours_SIR[3])}: missing value where TRUE/FALSE needed  # \\donttest{ random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 2      0.032  32     0.5    0.001  0.008  0.002  4      0.0005 1      #> [11] 0.001  1      8      0.002  0.25   2      0.016  0.004  0.25   0.125  #> [21] 0.002  0.5    0.004  >=256  0.0005 random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] 4   >=8 4   >=8 4   >=8 4   4   4   4   4   4   >=8 >=8 4   >=8 4   4   4   #> [20] 4   4   4   4   4   4   random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] <=0.25 0.5    <=0.25 <=0.25 <=0.25 0.5    <=0.25 <=0.25 <=0.25 <=0.25 #> [11] <=0.25 <=0.25 0.5    <=0.25 <=0.25 <=0.25 0.5    <=0.25 0.5    <=0.25 #> [21] <=0.25 0.5    <=0.25 0.5    0.5     random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 33 26 16 27 29 33 24 17 17 15 16 26 26 14 17 29 25 25 24 32 32 34 18 31 10 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 19 20 11 14 12 12 17 16 12 10 15 22 19 21 19 17 18 19 21 17 21 15 17 12 19 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 27 24 31 22 35 28 26 32 24 18 35 33 24 28 33 25 35 25 32 24 26 20 23 22 33 # }"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":null,"dir":"Reference","previous_headings":"","what":"Predict Antimicrobial Resistance — resistance_predict","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Create prediction model predict antimicrobial resistance next years. Standard errors (SE) returned columns se_min se_max. See Examples real live example. NOTE: functions deprecated removed future version. Use AMR package combined tidymodels framework instead, written basic short introduction website.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"resistance_predict(x, col_ab, col_date = NULL, year_min = NULL,   year_max = NULL, year_every = 1, minimum = 30, model = NULL,   I_as_S = TRUE, preserve_measurements = TRUE, info = interactive(), ...)  sir_predict(x, col_ab, col_date = NULL, year_min = NULL, year_max = NULL,   year_every = 1, minimum = 30, model = NULL, I_as_S = TRUE,   preserve_measurements = TRUE, info = interactive(), ...)  # S3 method for class 'resistance_predict' plot(x, main = paste(\"Resistance Prediction of\",   x_name), ...)  ggplot_sir_predict(x, main = paste(\"Resistance Prediction of\", x_name),   ribbon = TRUE, ...)  # S3 method for class 'resistance_predict' autoplot(object,   main = paste(\"Resistance Prediction of\", x_name), ribbon = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Predict Antimicrobial Resistance — resistance_predict","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_ab Column name x containing antimicrobial interpretations (\"R\", \"\" \"S\"). col_date Column name date, used calculate years column consist years already - default first column date class. year_min Lowest year use prediction model, dafaults lowest year col_date. year_max Highest year use prediction model - default 10 years today. year_every Unit sequence lowest year found data year_max. minimum Minimal amount available isolates per year include. Years containing less observations estimated model. model statistical model choice. generalised linear regression model binomial distribution (.e. using glm(..., family = binomial), assuming period zero resistance followed period increasing resistance leading slowly resistance. See Details valid options. I_as_S logical indicate whether values \"\" treated \"S\" (otherwise treated \"R\"). default, TRUE, follows redefinition EUCAST interpretation (increased exposure) 2019, see section Interpretation S, R . preserve_measurements logical indicate whether predictions years actually available data overwritten original data. standard errors years NA. info logical indicate whether textual analysis printed name summary() statistical model. ... Arguments passed functions. main Title plot. ribbon logical indicate whether ribbon shown (default) error bars. object Model data plotted.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Predict Antimicrobial Resistance — resistance_predict","text":"data.frame extra class resistance_predict columns: year value, estimated preserve_measurements = FALSE, combination observed estimated otherwise se_min, lower bound standard error minimum 0 (standard error never go 0%) se_max upper bound standard error maximum 1 (standard error never go 100%) observations, total number available observations year, .e. \\(S + + R\\) observed, original observed resistant percentages estimated, estimated resistant percentages, calculated model Furthermore, model available attribute: attributes(x)$model, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Valid options statistical model (argument model) : \"binomial\" \"binom\" \"logit\": generalised linear regression model binomial distribution \"loglin\" \"poisson\": generalised log-linear regression model poisson distribution \"lin\" \"linear\": linear regression model","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Predict Antimicrobial Resistance — resistance_predict","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"x <- resistance_predict(example_isolates,   col_ab = \"AMX\",   year_min = 2010,   model = \"binomial\" ) #> Warning: The `resistance_predict()` function is deprecated and will be removed in a #> future version, see `?AMR-deprecated`. Use the tidymodels framework #> instead, for which we have written a basic and short introduction on our #> website: https://amr-for-r.org/articles/AMR_with_tidymodels.html #> This warning will be shown once per session. plot(x)  # \\donttest{ if (require(\"ggplot2\")) {   ggplot_sir_predict(x) }   # using dplyr: if (require(\"dplyr\")) {   x <- example_isolates %>%     filter_first_isolate() %>%     filter(mo_genus(mo) == \"Staphylococcus\") %>%     resistance_predict(\"PEN\", model = \"binomial\")   print(plot(x))    # get the model from the object   mymodel <- attributes(x)$model   summary(mymodel) }  #> NULL #>  #> Call: #> glm(formula = df_matrix ~ year, family = binomial) #>  #> Coefficients: #>             Estimate Std. Error z value Pr(>|z|) #> (Intercept) 35.76101   72.29172   0.495    0.621 #> year        -0.01720    0.03603  -0.477    0.633 #>  #> (Dispersion parameter for binomial family taken to be 1) #>  #>     Null deviance: 5.3681  on 11  degrees of freedom #> Residual deviance: 5.1408  on 10  degrees of freedom #> AIC: 50.271 #>  #> Number of Fisher Scoring iterations: 4 #>   # create nice plots with ggplot2 yourself if (require(\"dplyr\") && require(\"ggplot2\")) {   data <- example_isolates %>%     filter(mo == as.mo(\"E. coli\")) %>%     resistance_predict(       col_ab = \"AMX\",       col_date = \"date\",       model = \"binomial\",       info = FALSE,       minimum = 15     )   head(data)   autoplot(data) }  # }"},{"path":"https://amr-for-r.org/reference/skewness.html","id":null,"dir":"Reference","previous_headings":"","what":"Skewness of the Sample — skewness","title":"Skewness of the Sample — skewness","text":"Skewness measure asymmetry probability distribution real-valued random variable mean. negative ('left-skewed'): left tail longer; mass distribution concentrated right histogram. positive ('right-skewed'): right tail longer; mass distribution concentrated left histogram. normal distribution skewness 0.","code":""},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Skewness of the Sample — skewness","text":"","code":"skewness(x, na.rm = FALSE)  # Default S3 method skewness(x, na.rm = FALSE)  # S3 method for class 'matrix' skewness(x, na.rm = FALSE)  # S3 method for class 'data.frame' skewness(x, na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/skewness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Skewness of the Sample — skewness","text":"x vector values, matrix data.frame. na.rm logical value indicating whether NA values stripped computation proceeds.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Skewness of the Sample — skewness","text":"","code":"skewness(runif(1000)) #> [1] -0.03886098"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter Top n Microorganisms — top_n_microorganisms","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function filters data set include top n microorganisms based specified property, taxonomic family genus. example, can filter data set top 3 species, species top 5 genera, top 3 species top 5 genera.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"top_n_microorganisms(x, n, property = \"species\", n_for_each = NULL,   col_mo = NULL, ...)"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"x data frame containing microbial data. n integer specifying maximum number unique values property include output. property character string indicating microorganism property use filtering. Must one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". NULL, raw values col_mo used without transformation. using \"species\" (default) \"subpecies\", genus added make sure (sub)species still belongs right genus. n_for_each optional integer specifying maximum number rows retain value selected property. NULL, rows within top n groups included. col_mo character string indicating column x contains microorganism names codes. Defaults first column class mo. Values coerced using .mo(). ... Additional arguments passed mo_property() property NULL.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function useful preprocessing data creating antibiograms analyses require focused subsets microbial data. example, can filter data set include isolates top 10 species.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"# filter to the top 3 species: top_n_microorganisms(example_isolates,   n = 3 ) #> # A tibble: 1,015 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  5 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  7 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #>  8 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   R     NA    R     NA  #>  9 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   S     NA    S     NA  #> 10 2002-02-21 A56499     64 M      Clinical B_STPHY_CONS   S     NA    S     NA  #> # ℹ 1,005 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to any species in the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\" ) #> # A tibble: 1,742 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,732 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to the top 3 species in each of the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\", n_for_each = 3 ) #> # A tibble: 1,497 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  8 2003-09-05 F35553     52 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #> 10 2003-09-28 1B0933     80 M      Clinical B_ENTRC        NA    NA    NA    NA  #> # ℹ 1,487 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/translate.html","id":null,"dir":"Reference","previous_headings":"","what":"Translate Strings from the AMR Package — translate","title":"Translate Strings from the AMR Package — translate","text":"language-dependent output AMR functions, mo_name(), mo_gramstain(), mo_type() ab_name().","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Translate Strings from the AMR Package — translate","text":"","code":"get_AMR_locale()  set_AMR_locale(language)  reset_AMR_locale()  translate_AMR(x, language = get_AMR_locale())"},{"path":"https://amr-for-r.org/reference/translate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate Strings from the AMR Package — translate","text":"language Language choose. Use one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). x Text translate.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate Strings from the AMR Package — translate","text":"currently 28 supported languages English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). languages translations available antimicrobial drugs colloquial microorganism names. permanently silence -per-session language note non-English operating system, can set package option AMR_locale .Rprofile file like :   save file. Please read adding updating language Wiki.","code":"# Open .Rprofile file utils::file.edit(\"~/.Rprofile\")  # Then add e.g. Italian support to that file using: options(AMR_locale = \"Italian\")"},{"path":"https://amr-for-r.org/reference/translate.html","id":"changing-the-default-language","dir":"Reference","previous_headings":"","what":"Changing the Default Language","title":"Translate Strings from the AMR Package — translate","text":"system language used default (returned Sys.getenv(\"LANG\") , LANG set, Sys.getlocale(\"LC_COLLATE\")), language supported. language used can overwritten two ways checked order: Setting package option AMR_locale, either using e.g. set_AMR_locale(\"German\") running e.g. options(AMR_locale = \"German\"). Note setting R option works session. Save command options(AMR_locale = \"(language)\") .Rprofile file apply every session. Run utils::file.edit(\"~/.Rprofile\") edit .Rprofile file. Setting system variable LANGUAGE LANG, e.g. adding LANGUAGE=\"de_DE.utf8\" .Renviron file home directory. Thus, package option AMR_locale set, system variables LANGUAGE LANG ignored.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Translate Strings from the AMR Package — translate","text":"","code":"# Current settings (based on system language) ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negative Staphylococcus (CoNS)\"  # setting another language set_AMR_locale(\"Dutch\") #> ℹ Using Dutch (Nederlands) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacine\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negatieve Staphylococcus (CNS)\"  # setting yet another language set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Koagulase-negative Staphylococcus (KNS)\"  # set_AMR_locale() understands endonyms, English exonyms, and ISO 639-1: set_AMR_locale(\"Deutsch\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"de\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/Clavulansäure\"  # reset to system default reset_AMR_locale() #> ℹ Using the English language (English) for the AMR package for this #>   session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/clavulanic acid\""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-3009015","dir":"Changelog","previous_headings":"","what":"AMR 3.0.0.9015","title":"AMR 3.0.0.9015","text":"primarily bugfix release, though added one nice feature .","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"new-3-0-0-9015","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 3.0.0.9015","text":"step_mic_log2() transform <mic> columns log2, step_sir_numeric() convert <sir> columns numeric New tidyselect helpers: all_mic(), all_mic_predictors(), all_sir(), all_sir_predictors()","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-3-0-0-9015","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.0.9015","text":"Fixed bug antibiogram() antimicrobials set Fixed bug antibiogram() allow column names containing + character (#222) Fixed bug .ab() antimicrobial codes number preceded space Fixed bug eucast_rules() using specific custom rules Fixed bug .sir() allow tidyselect language (#220) Fixed bug .sir() pick right breakpoint uti = FALSE (#216) Fixed bug ggplot_sir() using combine_SI = FALSE (#213) Fixed plotting contain separate colour SDD (susceptible dose-dependent) (#223) Fixed specific Dutch translations antimicrobials Added names age_groups() custom names can given (#215) Added note .sir() make explicit higher-level taxonomic breakpoints used (#218) Updated random_mic() random_disk() set skewedness distribution allow multiple microorganisms","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-300","dir":"Changelog","previous_headings":"","what":"AMR 3.0.0","title":"AMR 3.0.0","text":"CRAN release: 2025-06-02 package now supports tools AMR data analysis clinical settings, also veterinary environmental microbiology. made possible collaboration University Prince Edward Island’s Atlantic Veterinary College, Canada. celebrate great improvement package, also updated package logo reflect change.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"breaking-3-0-0","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 3.0.0","text":"Dataset antibiotics renamed antimicrobials data set contains just antibiotics. Using antibiotics still work, now returns warning. Removed functions references used deprecated rsi class, replaced sir equivalents two years ago. Functions resistance_predict() sir_predict() now deprecated removed future version. Use tidymodels framework instead, wrote basic introduction.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"new-3-0-0","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 3.0.0","text":"Function .sir() now extensive support veterinary breakpoints CLSI. Use breakpoint_type = \"animal\" set host argument variable contains animal species names. clinical_breakpoints data set contains breakpoints, can downloaded download page. (new) antimicrobials data set contains veterinary antimicrobials, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antimicrobials (start “Q”) ab_url() now supports retrieving WHOCC url ATCvet pages antibiogram() function now supports creating true Weighted-Incidence Syndromic Combination Antibiograms (WISCA), powerful Bayesian method estimating regimen coverage probabilities using pathogen incidence antimicrobial susceptibility data. WISCA offers improved precision syndrome-specific treatment, even datasets sparse data. dedicated wisca() function also available easy usage. Added full support 8 new languages: Arabic, Bengali, Hindi, Indonesian, Korean, Swahili, Urdu, Vietnamese. AMR package now available 28 languages. MycoBank now integrated primary taxonomic source fungi. microorganisms data set enriched new columns (mycobank, mycobank_parent, mycobank_renamed_to) provide detailed information fungal species. remarkable addition 20,000 new fungal records New function mo_mycobank() retrieve MycoBank record number, analogous existing functions mo_lpsn() mo_gbif(). .mo() function mo_*() functions now include only_fungi argument, allowing users restrict results solely fungal species. ensures fungi prioritised bacteria microorganism identification. can also set globally new AMR_only_fungi option. Also updated kingdoms, welcoming total 2,149 new records 2023 927 2024. Breakpoint 2024 2025 CLSI EUCAST now supported, adding 10,000 new clinical breakpoints clinical_breakpoints data set usage .sir(). EUCAST 2025 now new default guideline MIC disk diffusion interpretations. Added Expected Resistant Phenotypes EUCAST (v1.2). default rules eucast_rules() now: c(\"breakpoints\", \"expected_phenotypes\"). Updated intrinsic_resistant data set, now based EUCAST Expected Resistant Phenotypes v1.2 .sir() now brings additional factor levels: “NI” non-interpretable “SDD” susceptible dose-dependent. Currently, clinical_breakpoints data set contains 24 breakpoints can return value “SDD” instead “”. EUCAST interpretive rules (using eucast_rules()) now available EUCAST 12 (2022), 13 (2023), 14 (2024), 15 (2025). EUCAST dosage tables (dosage data set) now available EUCAST 13 (2023), 14 (2024), 15 (2025). New function group scale_*_mic(), namely: scale_x_mic(), scale_y_mic(), scale_colour_mic() scale_fill_mic(). allow easy plotting MIC values. allow manual range definition plotting missing intermediate log2 levels. New function group scale_*_sir(), namely: scale_x_sir(), scale_colour_sir() scale_fill_sir(). allow plot sir class, translates system language default. also set colourblind-safe colours plots. New function rescale_mic(), allows users rescale MIC values manually set range. powerhouse behind scale_*_mic() functions, can used independently , instance, compare equality MIC distributions rescaling range first. using R heavy lifting, ‘AMR’ Python Package developed run AMR R package natively Python. Python package always version number R package, built automatically every code change. antimicrobial selectors (aminoglycosides() betalactams()) now supported tidymodels packages recipe parsnip. See info tutorial using AMR functions predictive modelling. New function top_n_microorganisms() filter data set top n taxonomic property, e.g., filter top 3 species, filter species top 5 genera, filter top 3 species top 5 genera New function mo_group_members() retrieve member microorganisms microorganism group. example, mo_group_members(\"Strep group C\") returns vector microorganisms belong group. New functions mic_p50() mic_p90() retrieve 50th 90th percentile MIC values.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-3-0-0","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.0","text":"Support parallel computing greatly improve speed using parallel package (part base R). Use .sir(your_data, parallel = TRUE) run SIR interpretation using multiple cores. now possible use column names arguments guideline, ab, mo, uti: .sir(..., ab = \"column1\", mo = \"column2\", uti = \"column3\"). greatly improves flexibility users. Users can now set criteria (using regular expressions) considered S, , R, SDD, NI. get quantitative values, .double() sir object return 1 S, 2 SDD/, 3 R (NI become NA). functions using sir classes (e.g., summary()) updated reflect change contain NI SDD. Following CLSI interpretation rules, values outside log2-dilution range rounded upwards nearest log2-level interpretation. using CLSI guideline. Combined MIC values (e.g., CLSI) now supported argument conserve_capped_values .sir() replaced capped_mic_handling, allows greater flexibility handling capped MIC values (<, <=, >, >=). four available options (\"standard\", \"strict\", \"relaxed\", \"inverse\") provide full control whether values interpreted conservatively ignored. Using conserve_capped_values now deprecated returns warning. Added argument info silence console messages Argument antibiotics renamed antimicrobials. Using antibiotics still work, now returns warning. Added argument formatting_type set 22 options formatting ‘cells’. defaults 18 non-WISCA 14 WISCA, changing output antibiograms cells info. reason, add_total_n now deprecated FALSE default since denominators added cells dependent formatting_type setting ab_transform argument now defaults \"name\", displaying antibiotic column names instead codes ‘Antibiotic selectors’ now called ‘antimicrobial selectors’ since scope broader just antibiotics. documentation updated, ab_class() ab_selector() replaced amr_class() amr_selector(). old functions now deprecated removed future version. Added selectors isoxazolylpenicillins(), monobactams(), nitrofurans(), phenicols(), rifamycins(), sulfonamides() using antimicrobial selectors exclude non-treatable drugs (gentamicin-high using aminoglycosides()), function now always returns warning can included using only_treatable = FALSE Added new argument return_all selectors, defaults TRUE include match. FALSE, old behaviour, first hit unique antimicrobial returned. selectors can now run separate command retrieve vector possible antimicrobials selector can select selectors lincosamides() macrolides() overlap anymore - antibiotic now classified either Fixed selector fluoroquinolones(), now really selects second-generation quinolones (first-generation quinolones contain fluorine group) Added agents used screening, ID ending -S: benzylpenicillin screening test (PEN-S), beta-lactamase screening test (BLA-S), cefotaxime screening test (CTX-S), clindamycin inducible screening test (CLI-S), nalidixic acid screening test (NAL-S), norfloxacin screening test (-S), oxacillin screening test (OXA-S), pefloxacin screening test (PEF-S), tetracycline screening test (TCY-S). ID cefoxitin screening renamed FOX1 FOX-S, old code remains work. reason, antimicrobial selectors cephalosporins(), cephalosporins_3rd(), lincosamides(), isoxazolylpenicillins(), quinolones(), fluoroquinolones(), tetracyclines() now contain argument only_treatable = TRUE (similar antimicrobial selectors contain non-treatable drugs) Added amorolfine (AMO, D01AE16), antimycotic, now also part antifungals() selector Added cefepime/enmetazobactam (FPE), 4th gen cephalosporin Added tigemonam (TNM), monobactam Added bleomycin (BLM), glycopeptide Added efflux (EFF), allow mapping AMRFinderPlus Updated ATC codes, trade names, DDDs Added valid levels: 4096, 6 powers 0.0625, 5 powers 192 (192, 384, 576, 768, 960) Fixed bug .mic() failed translation scientifically formatted numbers Added new argument keep_operators .mic(). can \"\" (default), \"none\", \"edges\". argument also available new rescale_mic() scale_*_mic() functions. Comparisons MIC values now strict. example, >32 higher (never equal ) 32. Thus, .mic(\">32\") == .mic(32) now returns FALSE, .mic(\">32\") > .mic(32) now returns TRUE. Sorting MIC values (using sort()) fixed manner; <0.001 now gets sorted 0.001, >0.001 gets sorted 0.001. Intermediate log2 levels used MIC plotting now common values instead following strict dilution range .mic() now returns vector TRUE/FALSE input data.frame, just like .sir() eucast_rules() now argument overwrite (default: FALSE) indicate whether non-NA values overwritten Disks 0 5 mm now allowed, newly allowed range disk diffusion (.disk()) now 0 50 mm Updated italicise_taxonomy() support HTML output custom_eucast_rules() now supports multiple antimicrobials antimicrobial groups affected single rule mo_info() now contains extra element rank group_members (contents new mo_group_members() function) Updated ATC codes WHOCC Updated antimicrobial DDDs WHOCC Fix using manual value mo_transform antibiogram() Fixed bug antibiogram() returns empty data set Argument only_sir_columns now defaults TRUE column data set contains class ‘sir’ (functions eucast_rules(), key_antimicrobials(), mdro(), etc.) Added Sensititre codes animals, antimicrobials microorganisms Fix mapping ‘high level’ antimicrobials .ab() (amphotericin B-high, gentamicin-high, kanamycin-high, streptomycin-high, tobramycin-high) Improved overall algorithm .ab() better performance accuracy, including new function as_reset_session() remove earlier coercions. weight given genus species combinations cases subspecies miswritten, result correct genus species Genera World Health Organization’s () Priority Pathogen List now highest prevalence Fixed bug sir_confidence_interval() isolates available Updated prevalence calculation include genera World Health Organization’s () Priority Pathogen List Improved algorithm first_isolate() using phenotype-based method, prioritise records highest availability SIR values scale_y_percent() can now cope ranges outside 0-100% range Verbose Mode (verbose = TRUE) now includes guideline name Implemented new Dutch national MDRO guideline (SRI-richtlijn BRMO, Nov 2024) Added arguments esbl, carbapenemase, mecA, mecC, vanA, vanB denote column names logical values indicating presence genes (production proteins) Added upport antimicrobial selectors use custom rule (custom_mdro_guideline()) Added console colours support sir class Positron","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"other-3-0-0","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 3.0.0","text":"New website domain: https://amr--r.org! old domain remain work. Added Dr. Larisse Bolton Aislinn Cook contributors fantastic implementation WISCA mathematically solid way Added Matthew Saab, Dr. Jordan Stull, Prof. Javier Sanchez contributors tremendous input veterinary breakpoints interpretations Added Prof. Kathryn Holt, Dr. Jane Hawkey, Dr. Natacha Couto contributors many suggestions, ideas bugfixes Greatly improved vctrs integration, Tidyverse package working background many Tidyverse functions. users, means functions dplyr’s bind_rows(), rowwise() c_across() now supported e.g. columns class mic. Despite , AMR package still zero-dependent package, including dplyr vctrs. Greatly updated expanded documentation Stopped support SAS (.xpt) files, since file structure extremely inefficient requires disk space GitHub allows single commit.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"older-versions-3-0-0","dir":"Changelog","previous_headings":"","what":"Older Versions","title":"AMR 3.0.0","text":"changelog contains changes AMR v3.0 (June 2025) later. prior v2 versions, please see v2 archive. prior v1 versions, please see v1 archive.","code":""}]
+[{"path":"https://amr-for-r.org/articles/AMR.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Conduct AMR data analysis","text":"Conducting AMR data analysis unfortunately requires -depth knowledge different scientific fields, makes hard right. least, requires: Good questions (always start !) reliable data thorough understanding (clinical) epidemiology, understand clinical epidemiological relevance possible bias results thorough understanding (clinical) microbiology/infectious diseases, understand microorganisms causal infections implications pharmaceutical treatment, well understanding intrinsic acquired microbial resistance Experience data analysis microbiological tests results, understand determination limitations MIC values interpretations SIR values Availability biological taxonomy microorganisms probably normalisation factors pharmaceuticals, defined daily doses (DDD) Available (inter-)national guidelines, profound methods apply course, instantly provide knowledge experience. AMR package, aimed providing (1) tools simplify antimicrobial resistance data cleaning, transformation analysis, (2) methods easily incorporate international guidelines (3) scientifically reliable reference data, including requirements mentioned . AMR package enables standardised reproducible AMR data analysis, application evidence-based rules, determination first isolates, translation various codes microorganisms antimicrobial agents, determination (multi-drug) resistant microorganisms, calculation antimicrobial resistance, prevalence future trends.","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"Conduct AMR data analysis","text":"tutorial, create fake demonstration data work . can skip Cleaning data already data ready. start analysis, try make structure data generally look like :","code":""},{"path":"https://amr-for-r.org/articles/AMR.html","id":"needed-r-packages","dir":"Articles","previous_headings":"Preparation","what":"Needed R packages","title":"Conduct AMR data analysis","text":"many uses R, need additional packages AMR data analysis. package works closely together tidyverse packages dplyr ggplot2 RStudio. tidyverse tremendously improves way conduct data science - allows natural way writing syntaxes creating beautiful plots R. also use cleaner package, can used cleaning data creating frequency tables. AMR package contains data set example_isolates_unclean, might look data users extracted laboratory systems: AMR data analysis, like microorganism column contain valid, --date taxonomy, antibiotic columns cleaned SIR values well.","code":"library(dplyr) library(ggplot2) library(AMR)  # (if not yet installed, install with:) # install.packages(c(\"dplyr\", \"ggplot2\", \"AMR\")) example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows  # we will use 'our_data' as the data set name for this tutorial our_data <- example_isolates_unclean"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"taxonomy-of-microorganisms","dir":"Articles","previous_headings":"Preparation","what":"Taxonomy of microorganisms","title":"Conduct AMR data analysis","text":".mo(), users can transform arbitrary microorganism names codes current taxonomy. AMR package contains --date taxonomic data. specific, currently included data retrieved 24 Jun 2024. codes AMR packages come .mo() short, still human readable. importantly, .mo() supports kinds input: first character codes denote taxonomic kingdom, Bacteria (B), Fungi (F), Protozoa (P). AMR package also contain functions directly retrieve taxonomic properties, name, genus, species, family, order, even Gram-stain. start mo_ use .mo() internally, still arbitrary user input can used: Now can thus clean data: Apparently, uncertainty translation taxonomic codes. Let’s check : ’s good.","code":"as.mo(\"Klebsiella pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"K. pneumoniae\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLEPNE\") #> Class 'mo' #> [1] B_KLBSL_PNMN as.mo(\"KLPN\") #> Class 'mo' #> [1] B_KLBSL_PNMN mo_family(\"K. pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"K. pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"K. pneumoniae\") #> [1] \"pneumoniae\"  mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\"  mo_ref(\"K. pneumoniae\") #> [1] \"Trevisan, 1887\"  mo_snomed(\"K. pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\" our_data$bacteria <- as.mo(our_data$bacteria, info = TRUE) #> ℹ Retrieved values from the `microorganisms.codes` data set for \"ESCCOL\", #>   \"KLEPNE\", \"STAAUR\", and \"STRPNE\". #> ℹ Microorganism translation was uncertain for four microorganisms. Run #>   `mo_uncertainties()` to review these uncertainties, or use #>   `add_custom_microorganisms()` to add custom entries. mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See `?mo_matching_score`. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #> -------------------------------------------------------------------------------- #> \"K. pneumoniae\" -> Klebsiella pneumoniae (B_KLBSL_PNMN, 0.786) #> Also matched: Klebsiella pneumoniae complex (0.707), Klebsiella #>               pneumoniae ozaenae (0.707), Klebsiella pneumoniae pneumoniae (0.688), #>               Klebsiella pneumoniae rhinoscleromatis (0.658), Klebsiella pasteurii #>               (0.500), Klebsiella planticola (0.500), Kingella potus (0.400), #>               Kluyveromyces pseudotropicale (0.386), Kluyveromyces pseudotropicalis #>               (0.363), and Kosakonia pseudosacchari (0.361) #> -------------------------------------------------------------------------------- #> \"S. aureus\" -> Staphylococcus aureus (B_STPHY_AURS, 0.690) #> Also matched: Staphylococcus aureus aureus (0.643), Staphylococcus #>               argenteus (0.625), Staphylococcus aureus anaerobius (0.625), #>               Staphylococcus auricularis (0.615), Salmonella Aurelianis (0.595), #>               Salmonella Aarhus (0.588), Salmonella Amounderness (0.587), #>               Staphylococcus argensis (0.587), Streptococcus australis (0.587), and #>               Salmonella choleraesuis arizonae (0.562) #> -------------------------------------------------------------------------------- #> \"S. pneumoniae\" -> Streptococcus pneumoniae (B_STRPT_PNMN, 0.750) #> Also matched: Streptococcus pseudopneumoniae (0.700), Streptococcus #>               phocae salmonis (0.552), Serratia proteamaculans quinovora (0.545), #>               Streptococcus pseudoporcinus (0.536), Staphylococcus piscifermentans #>               (0.533), Staphylococcus pseudintermedius (0.532), Serratia #>               proteamaculans proteamaculans (0.526), Streptococcus gallolyticus #>               pasteurianus (0.526), Salmonella Portanigra (0.524), and Streptococcus #>               periodonticum (0.519) #>  #> Only the first 10 other matches of each record are shown. Run #> `print(mo_uncertainties(), n = ...)` to view more entries, or save #> `mo_uncertainties()` to an object."},{"path":"https://amr-for-r.org/articles/AMR.html","id":"antibiotic-results","dir":"Articles","previous_headings":"Preparation","what":"Antibiotic results","title":"Conduct AMR data analysis","text":"column antibiotic test results must also cleaned. AMR package comes three new data types work test results: mic minimal inhibitory concentrations (MIC), disk disk diffusion diameters, sir SIR data interpreted already. package can also determine SIR values based MIC disk diffusion values, read .sir() page. now, just clean SIR columns data using dplyr: basically cleaning, time start data inclusion.","code":"# method 1, be explicit about the columns: our_data <- our_data %>%   mutate_at(vars(AMX:GEN), as.sir)  # method 2, let the AMR package determine the eligible columns our_data <- our_data %>%   mutate_if(is_sir_eligible, as.sir)  # result: our_data #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   #>  7 J8         A        2016-06-14 B_ESCHR_COLI   R     S     S     S   #>  8 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   #>  9 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   #> 10 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"first-isolates","dir":"Articles","previous_headings":"Preparation","what":"First isolates","title":"Conduct AMR data analysis","text":"need know isolates can actually use analysis without repetition bias. conduct analysis antimicrobial resistance, must include first isolate every patient per episode (Hindler et al., Clin Infect Dis. 2007). , easily get overestimate underestimate resistance antibiotic. Imagine patient admitted MRSA found 5 different blood cultures following weeks (yes, countries like Netherlands blood drawing policies). resistance percentage oxacillin isolates overestimated, included MRSA . clearly selection bias. Clinical Laboratory Standards Institute (CLSI) appoints follows: (…) preparing cumulative antibiogram guide clinical decisions empirical antimicrobial therapy initial infections, first isolate given species per patient, per analysis period (eg, one year) included, irrespective body site, antimicrobial susceptibility profile, phenotypical characteristics (eg, biotype). first isolate easily identified, cumulative antimicrobial susceptibility test data prepared using first isolate generally comparable cumulative antimicrobial susceptibility test data calculated methods, providing duplicate isolates excluded. M39-A4 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 4th Edition. CLSI, 2014. Chapter 6.4 AMR package includes methodology first_isolate() function able apply four different methods defined Hindler et al. 2007: phenotype-based, episode-based, patient-based, isolate-based. right method depends goals analysis, default phenotype-based method case method properly correct duplicate isolates. Read methods first_isolate() page. outcome function can easily added data: 91% suitable resistance analysis! can now filter filter() function, also dplyr package: future use, two syntaxes can shortened: end 2 724 isolates analysis. Now data looks like: Time analysis.","code":"our_data <- our_data %>%   mutate(first = first_isolate(info = TRUE)) #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'bacteria' as input for `col_mo`. #> ℹ Using column 'date' as input for `col_date`. #> ℹ Using column 'patient_id' as input for `col_patient_id`. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> => Found 2,724 'phenotype-based' first isolates (90.8% of total where a #>    microbial ID was available) our_data_1st <- our_data %>%   filter(first == TRUE) our_data_1st <- our_data %>%   filter_first_isolate() our_data_1st #> # A tibble: 2,724 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J3         A        2012-11-21 B_ESCHR_COLI   R     I     S     S   TRUE  #>  2 R7         A        2018-04-03 B_KLBSL_PNMN   R     I     S     S   TRUE  #>  3 P3         A        2014-09-19 B_ESCHR_COLI   R     S     S     S   TRUE  #>  4 P10        A        2015-12-10 B_ESCHR_COLI   S     I     S     S   TRUE  #>  5 B7         A        2015-03-02 B_ESCHR_COLI   S     S     S     S   TRUE  #>  6 W3         A        2018-03-31 B_STPHY_AURS   R     S     R     S   TRUE  #>  7 M3         A        2015-10-25 B_ESCHR_COLI   R     S     S     S   TRUE  #>  8 J3         A        2019-06-19 B_ESCHR_COLI   S     S     S     S   TRUE  #>  9 G6         A        2015-04-27 B_STPHY_AURS   S     S     S     S   TRUE  #> 10 P4         A        2011-06-21 B_ESCHR_COLI   S     S     S     S   TRUE  #> # ℹ 2,714 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"analysing-the-data","dir":"Articles","previous_headings":"","what":"Analysing the data","title":"Conduct AMR data analysis","text":"base R summary() function gives good first impression, comes support new mo sir classes now data set:","code":"summary(our_data_1st) #>   patient_id          hospital              date            #>  Length:2724        Length:2724        Min.   :2011-01-01   #>  Class :character   Class :character   1st Qu.:2013-04-07   #>  Mode  :character   Mode  :character   Median :2015-06-03   #>                                        Mean   :2015-06-09   #>                                        3rd Qu.:2017-08-11   #>                                        Max.   :2019-12-27   #>    bacteria               AMX                    AMC                 #>  Class :mo             Class:sir              Class:sir              #>  <NA>  :0              %S   :41.6% (n=1133)   %S   :52.6% (n=1432)   #>  Unique:4              %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)      #>  #1    :B_ESCHR_COLI   %I   :16.4% (n=446)    %I   :12.2% (n=333)    #>  #2    :B_STPHY_AURS   %R   :42.0% (n=1145)   %R   :35.2% (n=959)    #>  #3    :B_STRPT_PNMN   %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)      #>     CIP                    GEN                  first         #>  Class:sir              Class:sir              Mode:logical   #>  %S   :52.5% (n=1431)   %S   :61.0% (n=1661)   TRUE:2724      #>  %SDD : 0.0% (n=0)      %SDD : 0.0% (n=0)                     #>  %I   : 6.5% (n=176)    %I   : 3.0% (n=82)                    #>  %R   :41.0% (n=1117)   %R   :36.0% (n=981)                   #>  %NI  : 0.0% (n=0)      %NI  : 0.0% (n=0)  glimpse(our_data_1st) #> Rows: 2,724 #> Columns: 9 #> $ patient_id <chr> \"J3\", \"R7\", \"P3\", \"P10\", \"B7\", \"W3\", \"M3\", \"J3\", \"G6\", \"P4\"… #> $ hospital   <chr> \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\", \"A\",… #> $ date       <date> 2012-11-21, 2018-04-03, 2014-09-19, 2015-12-10, 2015-03-02… #> $ bacteria   <mo> \"B_ESCHR_COLI\", \"B_KLBSL_PNMN\", \"B_ESCHR_COLI\", \"B_ESCHR_COL… #> $ AMX        <sir> R, R, R, S, S, R, R, S, S, S, S, R, S, S, R, R, R, R, S, R,… #> $ AMC        <sir> I, I, S, I, S, S, S, S, S, S, S, S, S, S, S, S, S, R, S, S,… #> $ CIP        <sir> S, S, S, S, S, R, S, S, S, S, S, S, S, S, S, S, S, S, S, S,… #> $ GEN        <sir> S, S, S, S, S, S, S, S, S, S, S, R, S, S, S, S, S, S, S, S,… #> $ first      <lgl> TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE,…  # number of unique values per column: sapply(our_data_1st, n_distinct) #> patient_id   hospital       date   bacteria        AMX        AMC        CIP  #>        260          3       1854          4          3          3          3  #>        GEN      first  #>          3          1"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"availability-of-species","dir":"Articles","previous_headings":"Analysing the data","what":"Availability of species","title":"Conduct AMR data analysis","text":"just get idea species distributed, create frequency table count() based name microorganisms:","code":"our_data %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1518 #> 2 Staphylococcus aureus      730 #> 3 Streptococcus pneumoniae   426 #> 4 Klebsiella pneumoniae      326  our_data_1st %>%   count(mo_name(bacteria), sort = TRUE) #> # A tibble: 4 × 2 #>   `mo_name(bacteria)`          n #>   <chr>                    <int> #> 1 Escherichia coli          1321 #> 2 Staphylococcus aureus      682 #> 3 Streptococcus pneumoniae   402 #> 4 Klebsiella pneumoniae      319"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"select-and-filter-with-antibiotic-selectors","dir":"Articles","previous_headings":"Analysing the data","what":"Select and filter with antibiotic selectors","title":"Conduct AMR data analysis","text":"Using -called antibiotic class selectors, can select filter columns based antibiotic class antibiotic results :","code":"our_data_1st %>%   select(date, aminoglycosides()) #> ℹ For `aminoglycosides()` using column 'GEN' (gentamicin) #> # A tibble: 2,724 × 2 #>    date       GEN   #>    <date>     <sir> #>  1 2012-11-21   S   #>  2 2018-04-03   S   #>  3 2014-09-19   S   #>  4 2015-12-10   S   #>  5 2015-03-02   S   #>  6 2018-03-31   S   #>  7 2015-10-25   S   #>  8 2019-06-19   S   #>  9 2015-04-27   S   #> 10 2011-06-21   S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, betalactams()) #> ℹ For `betalactams()` using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 2,724 × 3 #>    bacteria     AMX   AMC   #>    <mo>         <sir> <sir> #>  1 B_ESCHR_COLI   R     I   #>  2 B_KLBSL_PNMN   R     I   #>  3 B_ESCHR_COLI   R     S   #>  4 B_ESCHR_COLI   S     I   #>  5 B_ESCHR_COLI   S     S   #>  6 B_STPHY_AURS   R     S   #>  7 B_ESCHR_COLI   R     S   #>  8 B_ESCHR_COLI   S     S   #>  9 B_STPHY_AURS   S     S   #> 10 B_ESCHR_COLI   S     S   #> # ℹ 2,714 more rows  our_data_1st %>%   select(bacteria, where(is.sir)) #> # A tibble: 2,724 × 5 #>    bacteria     AMX   AMC   CIP   GEN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   R     I     S     S   #>  2 B_KLBSL_PNMN   R     I     S     S   #>  3 B_ESCHR_COLI   R     S     S     S   #>  4 B_ESCHR_COLI   S     I     S     S   #>  5 B_ESCHR_COLI   S     S     S     S   #>  6 B_STPHY_AURS   R     S     R     S   #>  7 B_ESCHR_COLI   R     S     S     S   #>  8 B_ESCHR_COLI   S     S     S     S   #>  9 B_STPHY_AURS   S     S     S     S   #> 10 B_ESCHR_COLI   S     S     S     S   #> # ℹ 2,714 more rows  # filtering using AB selectors is also possible: our_data_1st %>%   filter(any(aminoglycosides() == \"R\")) #> ℹ For `aminoglycosides()` using column 'GEN' (gentamicin) #> # A tibble: 981 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 J5         A        2017-12-25 B_STRPT_PNMN   R     S     S     R   TRUE  #>  2 X1         A        2017-07-04 B_STPHY_AURS   R     S     S     R   TRUE  #>  3 B3         A        2016-07-24 B_ESCHR_COLI   S     S     S     R   TRUE  #>  4 V7         A        2012-04-03 B_ESCHR_COLI   S     S     S     R   TRUE  #>  5 C9         A        2017-03-23 B_ESCHR_COLI   S     S     S     R   TRUE  #>  6 R1         A        2018-06-10 B_STPHY_AURS   S     S     S     R   TRUE  #>  7 S2         A        2013-07-19 B_STRPT_PNMN   S     S     S     R   TRUE  #>  8 P5         A        2019-03-09 B_STPHY_AURS   S     S     S     R   TRUE  #>  9 Q8         A        2019-08-10 B_STPHY_AURS   S     S     S     R   TRUE  #> 10 K5         A        2013-03-15 B_STRPT_PNMN   S     S     S     R   TRUE  #> # ℹ 971 more rows  our_data_1st %>%   filter(all(betalactams() == \"R\")) #> ℹ For `betalactams()` using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows  # even works in base R (since R 3.0): our_data_1st[all(betalactams() == \"R\"), ] #> ℹ For `betalactams()` using columns 'AMX' (amoxicillin) and 'AMC' #>   (amoxicillin/clavulanic acid) #> # A tibble: 462 × 9 #>    patient_id hospital date       bacteria     AMX   AMC   CIP   GEN   first #>    <chr>      <chr>    <date>     <mo>         <sir> <sir> <sir> <sir> <lgl> #>  1 M7         A        2013-07-22 B_STRPT_PNMN   R     R     S     S   TRUE  #>  2 R10        A        2013-12-20 B_STPHY_AURS   R     R     S     S   TRUE  #>  3 R7         A        2015-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  4 R8         A        2019-10-25 B_STPHY_AURS   R     R     S     S   TRUE  #>  5 B6         A        2016-11-20 B_ESCHR_COLI   R     R     R     R   TRUE  #>  6 I7         A        2015-08-19 B_ESCHR_COLI   R     R     S     S   TRUE  #>  7 N3         A        2014-12-29 B_STRPT_PNMN   R     R     R     S   TRUE  #>  8 Q2         A        2019-09-22 B_ESCHR_COLI   R     R     S     S   TRUE  #>  9 X7         A        2011-03-20 B_ESCHR_COLI   R     R     S     R   TRUE  #> 10 V1         A        2018-08-07 B_STPHY_AURS   R     R     S     S   TRUE  #> # ℹ 452 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"generate-antibiograms","dir":"Articles","previous_headings":"Analysing the data","what":"Generate antibiograms","title":"Conduct AMR data analysis","text":"Since AMR v2.0 (March 2023), easy create different types antibiograms, support 20 different languages. four antibiogram types, proposed Klinker et al. (2021, DOI 10.1177/20499361211011373), supported new antibiogram() function: Traditional Antibiogram (TA) e.g, susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Combination Antibiogram (CA) e.g, sdditional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Syndromic Antibiogram (SA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Weighted-Incidence Syndromic Combination Antibiogram (WISCA) e.g, susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) male patients age >=65 years heart failure section, show use antibiogram() function create antibiogram types. starters, included example_isolates data set looks like:","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"traditional-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Traditional Antibiogram","title":"Conduct AMR data analysis","text":"create traditional antibiogram, simply state antibiotics used. antibiotics argument antibiogram() function supports (combination) previously mentioned antibiotic class selectors: Notice antibiogram() function automatically prints right format using Quarto R Markdown (page), even applies italics taxonomic names (using italicise_taxonomy() internally). also uses language OS either English, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. next example, force language Spanish using language argument:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems())) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             mo_transform = \"gramstain\",             antibiotics = aminoglycosides(),             ab_transform = \"name\",             language = \"es\") #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"combined-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Combined Antibiogram","title":"Conduct AMR data analysis","text":"create combined antibiogram, use antibiotic codes names plus + character like :","code":"combined_ab <- antibiogram(example_isolates,                            antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),                            ab_transform = NULL) combined_ab"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"syndromic-antibiogram","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Syndromic Antibiogram","title":"Conduct AMR data analysis","text":"create syndromic antibiogram, syndromic_group argument must used. can column data, e.g. ifelse() calculations based certain columns:","code":"antibiogram(example_isolates,             antibiotics = c(aminoglycosides(), carbapenems()),             syndromic_group = \"ward\") #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"weighted-incidence-syndromic-combination-antibiogram-wisca","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Weighted-Incidence Syndromic Combination Antibiogram (WISCA)","title":"Conduct AMR data analysis","text":"create Weighted-Incidence Syndromic Combination Antibiogram (WISCA), simply set wisca = TRUE antibiogram() function, use dedicated wisca() function. Unlike traditional antibiograms, WISCA provides syndrome-based susceptibility estimates, weighted pathogen incidence antimicrobial susceptibility patterns. WISCA uses Bayesian decision model integrate data multiple pathogens, improving empirical therapy guidance, especially low-incidence infections. pathogen-agnostic, meaning results syndrome-based rather stratified microorganism. reliable results, ensure data includes first isolates (use first_isolate()) consider filtering top n species (use top_n_microorganisms()), WISCA outcomes meaningful based robust incidence estimates. patient- syndrome-specific WISCA, run function grouped tibble, .e., using group_by() first:","code":"example_isolates %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),         minimum = 10) # Recommended threshold: ≥30 example_isolates %>%   top_n_microorganisms(n = 10) %>%   group_by(age_group = age_groups(age, c(25, 50, 75)),            gender) %>%   wisca(antibiotics = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-antibiograms","dir":"Articles","previous_headings":"Analysing the data > Generate antibiograms","what":"Plotting antibiograms","title":"Conduct AMR data analysis","text":"Antibiograms can plotted using autoplot() ggplot2 packages, since AMR package provides extension function:  calculate antimicrobial resistance sensible way, also correcting results, use resistance() susceptibility() functions.","code":"autoplot(combined_ab)"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"resistance-percentages","dir":"Articles","previous_headings":"Analysing the data","what":"Resistance percentages","title":"Conduct AMR data analysis","text":"functions resistance() susceptibility() can used calculate antimicrobial resistance susceptibility. specific analyses, functions proportion_S(), proportion_SI(), proportion_I(), proportion_IR() proportion_R() can used determine proportion specific antimicrobial outcome. functions contain minimum argument, denoting minimum required number test results returning value. functions otherwise return NA. default minimum = 30, following CLSI M39-A4 guideline applying microbial epidemiology. per EUCAST guideline 2019, calculate resistance proportion R (proportion_R(), equal resistance()) susceptibility proportion S (proportion_SI(), equal susceptibility()). functions can used : can used conjunction group_by() summarise(), dplyr package:","code":"our_data_1st %>% resistance(AMX) #> [1] 0.4203377 our_data_1st %>%   group_by(hospital) %>%   summarise(amoxicillin = resistance(AMX)) #> # A tibble: 3 × 2 #>   hospital amoxicillin #>   <chr>          <dbl> #> 1 A              0.340 #> 2 B              0.551 #> 3 C              0.370"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"interpreting-mic-and-disk-diffusion-values","dir":"Articles","previous_headings":"Analysing the data","what":"Interpreting MIC and Disk Diffusion Values","title":"Conduct AMR data analysis","text":"Minimal inhibitory concentration (MIC) values disk diffusion diameters can interpreted clinical breakpoints (SIR) using .sir(). ’s example randomly generated MIC values Klebsiella pneumoniae ciprofloxacin: allows direct interpretation according EUCAST CLSI breakpoints, facilitating automated AMR data processing.","code":"set.seed(123) mic_values <- random_mic(100) sir_values <- as.sir(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\")  my_data <- tibble(MIC = mic_values, SIR = sir_values) my_data #> # A tibble: 100 × 2 #>         MIC SIR   #>       <mic> <sir> #>  1 <=0.0001   S   #>  2   0.0160   S   #>  3 >=8.0000   R   #>  4   0.0320   S   #>  5   0.0080   S   #>  6  64.0000   R   #>  7   0.0080   S   #>  8   0.1250   S   #>  9   0.0320   S   #> 10   0.0002   S   #> # ℹ 90 more rows"},{"path":"https://amr-for-r.org/articles/AMR.html","id":"plotting-mic-and-sir-interpretations","dir":"Articles","previous_headings":"Analysing the data","what":"Plotting MIC and SIR Interpretations","title":"Conduct AMR data analysis","text":"can visualise MIC distributions SIR interpretations using ggplot2, using new scale_y_mic() y-axis scale_colour_sir() colour-code SIR categories.  plot provides intuitive way assess susceptibility patterns across different groups incorporating clinical breakpoints. straightforward less manual approach, ggplot2’s function autoplot() extended package directly plot MIC disk diffusion values:   Author: Dr. Matthijs Berends, 23rd Feb 2025","code":"# add a group my_data$group <- rep(c(\"A\", \"B\", \"C\", \"D\"), each = 25)   ggplot(my_data,        aes(x = group, y = MIC, colour = SIR)) +   geom_jitter(width = 0.2, size = 2) +   geom_boxplot(fill = NA, colour = \"grey40\") +   scale_y_mic() +   scale_colour_sir() +   labs(title = \"MIC Distribution and SIR Interpretation\",        x = \"Sample Groups\",        y = \"MIC (mg/L)\") autoplot(mic_values) # by providing `mo` and `ab`, colours will indicate the SIR interpretation: autoplot(mic_values, mo = \"K. pneumoniae\", ab = \"cipro\", guideline = \"EUCAST 2024\")"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"AMR for Python","text":"AMR package R powerful tool antimicrobial resistance (AMR) analysis. provides extensive features handling microbial antimicrobial data. However, work primarily Python, now intuitive option available: AMR Python package. Python package wrapper around AMR R package. uses rpy2 package internally. Despite need R installed, Python users can now easily work AMR data directly Python code.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"prerequisites","dir":"Articles","previous_headings":"","what":"Prerequisites","title":"AMR for Python","text":"package tested virtual environment (venv). can set environment running: can activate environment, venv ready work .","code":"# linux and macOS: python -m venv /path/to/new/virtual/environment  # Windows: python -m venv C:\\path\\to\\new\\virtual\\environment"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"install-amr","dir":"Articles","previous_headings":"","what":"Install AMR","title":"AMR for Python","text":"Since Python package available official Python Package Index, can just run: Make sure R installed. need install AMR R package, installed automatically. Linux: macOS (using Homebrew): Windows, visit CRAN download page download install R.","code":"pip install AMR # Ubuntu / Debian sudo apt install r-base # Fedora: sudo dnf install R # CentOS/RHEL sudo yum install R brew install r"},{"path":[]},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"cleaning-taxonomy","dir":"Articles","previous_headings":"Examples of Usage","what":"Cleaning Taxonomy","title":"AMR for Python","text":"’s example demonstrates clean microorganism drug names using AMR Python package:","code":"import pandas as pd import AMR  # Sample data data = {     \"MOs\": ['E. coli', 'ESCCOL', 'esco', 'Esche coli'],     \"Drug\": ['Cipro', 'CIP', 'J01MA02', 'Ciproxin'] } df = pd.DataFrame(data)  # Use AMR functions to clean microorganism and drug names df['MO_clean'] = AMR.mo_name(df['MOs']) df['Drug_clean'] = AMR.ab_name(df['Drug'])  # Display the results print(df)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"explanation","dir":"Articles","previous_headings":"Examples of Usage > Cleaning Taxonomy","what":"Explanation","title":"AMR for Python","text":"mo_name: function standardises microorganism names. , different variations Escherichia coli (“E. coli”, “ESCCOL”, “esco”, “Esche coli”) converted correct, standardised form, “Escherichia coli”. ab_name: Similarly, function standardises antimicrobial names. different representations ciprofloxacin (e.g., “Cipro”, “CIP”, “J01MA02”, “Ciproxin”) converted standard name, “Ciprofloxacin”.","code":""},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"calculating-amr","dir":"Articles","previous_headings":"Examples of Usage","what":"Calculating AMR","title":"AMR for Python","text":"","code":"import AMR import pandas as pd  df = AMR.example_isolates result = AMR.resistance(df[\"AMX\"]) print(result) [0.59555556]"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"generating-antibiograms","dir":"Articles","previous_headings":"Examples of Usage","what":"Generating Antibiograms","title":"AMR for Python","text":"One core functions AMR package generating antibiogram, table summarises antimicrobial susceptibility bacterial isolates. ’s can generate antibiogram Python: example, generate antibiogram selecting various antibiotics.","code":"result2a = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]]) print(result2a) result2b = AMR.antibiogram(df[[\"mo\", \"AMX\", \"CIP\", \"TZP\"]], mo_transform = \"gramstain\") print(result2b)"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"taxonomic-data-sets-now-in-python","dir":"Articles","previous_headings":"Examples of Usage","what":"Taxonomic Data Sets Now in Python!","title":"AMR for Python","text":"Python user, might like important data sets AMR R package, microorganisms, antimicrobials, clinical_breakpoints, example_isolates, now available regular Python data frames:","code":"AMR.microorganisms AMR.antimicrobials"},{"path":"https://amr-for-r.org/articles/AMR_for_Python.html","id":"conclusion","dir":"Articles","previous_headings":"","what":"Conclusion","title":"AMR for Python","text":"AMR Python package, Python users can now effortlessly call R functions AMR R package. eliminates need complex rpy2 configurations provides clean, easy--use interface antimicrobial resistance analysis. examples provided demonstrate can applied typical workflows, standardising microorganism antimicrobial names calculating resistance. just running import AMR, users can seamlessly integrate robust features R AMR package Python workflows. Whether ’re cleaning data analysing resistance patterns, AMR Python package makes easy work AMR data Python.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-1-using-antimicrobial-selectors","dir":"Articles","previous_headings":"","what":"Example 1: Using Antimicrobial Selectors","title":"AMR with tidymodels","text":"leveraging power tidymodels AMR package, ’ll build reproducible machine learning workflow predict Gramstain microorganism two important antibiotic classes: aminoglycosides beta-lactams.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Objective","title":"AMR with tidymodels","text":"goal build predictive model using tidymodels framework determine Gramstain microorganism based microbial data. : Preprocess data using selector functions aminoglycosides() betalactams(). Define logistic regression model prediction. Use structured tidymodels workflow preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Data Preparation","title":"AMR with tidymodels","text":"begin loading required libraries preparing example_isolates dataset AMR package. Prepare data: Explanation: aminoglycosides() betalactams() dynamically select columns antimicrobials classes. drop_na() ensures model receives complete cases training.","code":"# Load required libraries library(AMR)          # For AMR data analysis library(tidymodels)   # For machine learning workflows, and data manipulation (dplyr, tidyr, ...) # Your data could look like this: example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # Select relevant columns for prediction data <- example_isolates %>%   # select AB results dynamically   select(mo, aminoglycosides(), betalactams()) %>%   # replace NAs with NI (not-interpretable)    mutate(across(where(is.sir),                  ~replace_na(.x, \"NI\")),           # make factors of SIR columns           across(where(is.sir),                  as.integer),           # get Gramstain of microorganisms           mo = as.factor(mo_gramstain(mo))) %>%   # drop NAs - the ones without a Gramstain (fungi, etc.)   drop_na() #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `betalactams()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem)"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define tidymodels workflow, consists three steps: preprocessing, model specification, fitting.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"create recipe preprocess data modelling. recipe includes least one preprocessing operation, like step_corr(), necessary parameters can estimated training set using prep(): Explanation: recipe(mo ~ ., data = data) take mo column outcome columns predictors. step_corr() removes predictors (.e., antibiotic columns) higher correlation 90%. Notice recipe contains just antimicrobial selector functions - need define columns specifically. preparation (retrieved prep()) can see columns variables ‘AMX’ ‘CTX’ removed correlate much existing, variables.","code":"# Define the recipe for data preprocessing resistance_recipe <- recipe(mo ~ ., data = data) %>%   step_corr(c(aminoglycosides(), betalactams()), threshold = 0.9) resistance_recipe #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Operations #> • Correlation filter on: c(aminoglycosides(), betalactams()) prep(resistance_recipe) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `betalactams()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'TZP' #>   (piperacillin/tazobactam), 'CZO' (cefazolin), 'FEP' (cefepime), 'CXM' #>   (cefuroxime), 'FOX' (cefoxitin), 'CTX' (cefotaxime), 'CAZ' (ceftazidime), #>   'CRO' (ceftriaxone), 'IPM' (imipenem), and 'MEM' (meropenem) #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:    1 #> predictor: 20 #>  #> ── Training information #> Training data contained 1968 data points and no incomplete rows. #>  #> ── Operations #> • Correlation filter on: AMX CTX | Trained"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"define logistic regression model since resistance prediction binary classification task. Explanation: logistic_reg() sets logistic regression model. set_engine(\"glm\") specifies use R’s built-GLM engine.","code":"# Specify a logistic regression model logistic_model <- logistic_reg() %>%   set_engine(\"glm\") # Use the Generalised Linear Model engine logistic_model #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"bundle recipe model together workflow, organises entire modelling process.","code":"# Combine the recipe and model into a workflow resistance_workflow <- workflow() %>%   add_recipe(resistance_recipe) %>% # Add the preprocessing recipe   add_model(logistic_model) # Add the logistic regression model resistance_workflow #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: logistic_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 1 Recipe Step #>  #> • step_corr() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"train model, split data training testing sets. , fit workflow training set evaluate performance. Explanation: initial_split() splits data training testing sets. fit() trains workflow training set. Notice fit(), antimicrobial selector functions internally called . training, functions called since stored recipe. Next, evaluate model testing data. Explanation: predict() generates predictions testing set. metrics() computes evaluation metrics like accuracy kappa. appears can predict Gram stain 99.5% accuracy based AMR results aminoglycosides beta-lactam antibiotics. ROC curve looks like :","code":"# Split data into training and testing sets set.seed(123) # For reproducibility data_split <- initial_split(data, prop = 0.8) # 80% training, 20% testing training_data <- training(data_split) # Training set testing_data <- testing(data_split)   # Testing set  # Fit the workflow to the training data fitted_workflow <- resistance_workflow %>%   fit(training_data) # Train the model # Make predictions on the testing set predictions <- fitted_workflow %>%   predict(testing_data)                # Generate predictions probabilities <- fitted_workflow %>%   predict(testing_data, type = \"prob\") # Generate probabilities  predictions <- predictions %>%   bind_cols(probabilities) %>%   bind_cols(testing_data) # Combine with true labels  predictions #> # A tibble: 394 × 24 #>    .pred_class   `.pred_Gram-negative` `.pred_Gram-positive` mo        GEN   TOB #>    <fct>                         <dbl>                 <dbl> <fct>   <int> <int> #>  1 Gram-positive              1.07e- 1             8.93 e- 1 Gram-p…     5     5 #>  2 Gram-positive              3.17e- 8             1.000e+ 0 Gram-p…     5     1 #>  3 Gram-negative              9.99e- 1             1.42 e- 3 Gram-n…     5     5 #>  4 Gram-positive              2.22e-16             1    e+ 0 Gram-p…     5     5 #>  5 Gram-negative              9.46e- 1             5.42 e- 2 Gram-n…     5     5 #>  6 Gram-positive              1.07e- 1             8.93 e- 1 Gram-p…     5     5 #>  7 Gram-positive              2.22e-16             1    e+ 0 Gram-p…     1     5 #>  8 Gram-positive              2.22e-16             1    e+ 0 Gram-p…     4     4 #>  9 Gram-negative              1   e+ 0             2.22 e-16 Gram-n…     1     1 #> 10 Gram-positive              6.05e-11             1.000e+ 0 Gram-p…     4     4 #> # ℹ 384 more rows #> # ℹ 18 more variables: AMK <int>, KAN <int>, PEN <int>, OXA <int>, FLC <int>, #> #   AMX <int>, AMC <int>, AMP <int>, TZP <int>, CZO <int>, FEP <int>, #> #   CXM <int>, FOX <int>, CTX <int>, CAZ <int>, CRO <int>, IPM <int>, MEM <int>  # Evaluate model performance metrics <- predictions %>%   metrics(truth = mo, estimate = .pred_class) # Calculate performance metrics  metrics #> # A tibble: 2 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989   # To assess some other model properties, you can make our own `metrics()` function our_metrics <- metric_set(accuracy, kap, ppv, npv) # add Positive Predictive Value and Negative Predictive Value metrics2 <- predictions %>%   our_metrics(truth = mo, estimate = .pred_class) # run again on our `our_metrics()` function  metrics2 #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.995 #> 2 kap      binary         0.989 #> 3 ppv      binary         0.987 #> 4 npv      binary         1 predictions %>%   roc_curve(mo, `.pred_Gram-negative`) %>%   autoplot()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion","dir":"Articles","previous_headings":"Example 1: Using Antimicrobial Selectors","what":"Conclusion","title":"AMR with tidymodels","text":"post, demonstrated build machine learning pipeline tidymodels framework AMR package. combining selector functions like aminoglycosides() betalactams() tidymodels, efficiently prepared data, trained model, evaluated performance. workflow extensible antimicrobial classes resistance patterns, empowering users analyse AMR data systematically reproducibly.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-2-predicting-esbl-presence-using-raw-mics","dir":"Articles","previous_headings":"","what":"Example 2: Predicting ESBL Presence Using Raw MICs","title":"AMR with tidymodels","text":"second example, demonstrate use <mic> columns directly tidymodels workflows using AMR-specific recipe steps. includes transformation log2 scale using step_mic_log2(), prepares MIC values use classification models. approach idea formed basis publication DOI: 10.3389/fmicb.2025.1582703 model presence extended-spectrum beta-lactamases (ESBL).","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Objective","title":"AMR with tidymodels","text":"goal : Use raw MIC values predict whether bacterial isolate produces ESBL. Apply AMR-aware preprocessing tidymodels recipe. Train classification model evaluate predictive performance.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Data Preparation","title":"AMR with tidymodels","text":"use esbl_isolates dataset comes AMR package. Explanation: esbl_isolates: Contains MIC test results ESBL status isolate. mutate(esbl = ...): Converts target column ordered factor classification.","code":"# Load required libraries library(AMR) library(tidymodels)  # View the esbl_isolates data set esbl_isolates #> # A tibble: 500 × 19 #>    esbl  genus   AMC   AMP   TZP   CXM   FOX   CTX   CAZ   GEN   TOB   TMP   SXT #>    <lgl> <chr> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> #>  1 FALSE Esch…    32    32     4    64    64  8.00  8.00     1     1  16.0    20 #>  2 FALSE Esch…    32    32     4    64    64  4.00  8.00     1     1  16.0   320 #>  3 FALSE Esch…     4     2    64     8     4  8.00  0.12    16    16   0.5    20 #>  4 FALSE Kleb…    32    32    16    64    64  8.00  8.00     1     1   0.5    20 #>  5 FALSE Esch…    32    32     4     4     4  0.25  2.00     1     1  16.0   320 #>  6 FALSE Citr…    32    32    16    64    64 64.00 32.00     1     1   0.5    20 #>  7 FALSE Morg…    32    32     4    64    64 16.00  2.00     1     1   0.5    20 #>  8 FALSE Prot…    16    32     4     1     4  8.00  0.12     1     1  16.0   320 #>  9 FALSE Ente…    32    32     8    64    64 32.00  4.00     1     1   0.5    20 #> 10 FALSE Citr…    32    32    32    64    64  8.00 64.00     1     1  16.0   320 #> # ℹ 490 more rows #> # ℹ 6 more variables: NIT <mic>, FOS <mic>, CIP <mic>, IPM <mic>, MEM <mic>, #> #   COL <mic>  # Prepare a binary outcome and convert to ordered factor data <- esbl_isolates %>%   mutate(esbl = factor(esbl, levels = c(FALSE, TRUE), ordered = TRUE))"},{"path":[]},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"use step_mic_log2() function log2-transform MIC values, ensuring MICs numeric properly scaled. MIC predictors can easily agnostically selected using new all_mic_predictors(): Explanation: remove_role(): Removes irrelevant variables like genus. step_mic_log2(): Applies log2(.numeric(...)) MIC predictors one go. prep(): Finalises recipe based training data.","code":"# Split into training and testing sets set.seed(123) split <- initial_split(data) training_data <- training(split) testing_data <- testing(split)  # Define the recipe mic_recipe <- recipe(esbl ~ ., data = training_data) %>%   remove_role(genus, old_role = \"predictor\") %>%  # Remove non-informative variable   step_mic_log2(all_mic_predictors()) #%>%         # Log2 transform all MIC predictors  # prep()  mic_recipe #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:          1 #> predictor:       17 #> undeclared role:  1 #>  #> ── Operations #> • Log2 transformation of MIC columns: all_mic_predictors()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"use simple logistic regression model ESBL presence, though recent models xgboost (link parsnip manual) much precise. Explanation: logistic_reg(): Specifies binary classification model. set_engine(\"glm\"): Uses base R GLM engine.","code":"# Define the model model <- logistic_reg(mode = \"classification\") %>%   set_engine(\"glm\")  model #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"","code":"# Create workflow workflow_model <- workflow() %>%   add_recipe(mic_recipe) %>%   add_model(model)  workflow_model #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: logistic_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 1 Recipe Step #>  #> • step_mic_log2() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Logistic Regression Model Specification (classification) #>  #> Computational engine: glm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"Explanation: fit(): Trains model processed training data. predict(): Produces predictions unseen test data. metric_set(): Allows evaluating multiple classification metrics. appears can predict ESBL gene presence positive predictive value (PPV) 92.1% negative predictive value (NPV) 91.9 using simplistic logistic regression model.","code":"# Fit the model fitted <- fit(workflow_model, training_data)  # Generate predictions predictions <- predict(fitted, testing_data) %>%   bind_cols(testing_data)  # Evaluate model performance our_metrics <- metric_set(accuracy, kap, ppv, npv) metrics <- our_metrics(predictions, truth = esbl, estimate = .pred_class)  metrics #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.92  #> 2 kap      binary         0.840 #> 3 ppv      binary         0.921 #> 4 npv      binary         0.919"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"visualising-predictions","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Visualising Predictions","title":"AMR with tidymodels","text":"can visualise predictions comparing predicted actual ESBL status.","code":"library(ggplot2)  ggplot(predictions, aes(x = esbl, fill = .pred_class)) +   geom_bar(position = \"stack\") +   labs(title = \"Predicted vs Actual ESBL Status\",        x = \"Actual ESBL\",        y = \"Count\") +   theme_minimal()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion-1","dir":"Articles","previous_headings":"Example 2: Predicting ESBL Presence Using Raw MICs","what":"Conclusion","title":"AMR with tidymodels","text":"example, showcased new AMR-specific recipe steps simplify working <mic> columns tidymodels. step_mic_log2() transformation converts ordered MICs log2-transformed numerics, improving compatibility classification models. pipeline enables realistic, reproducible, interpretable modelling antimicrobial resistance data.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"example-3-predicting-amr-over-time","dir":"Articles","previous_headings":"","what":"Example 3: Predicting AMR Over Time","title":"AMR with tidymodels","text":"third example, aim predict antimicrobial resistance (AMR) trends time using tidymodels. model resistance three antibiotics (amoxicillin AMX, amoxicillin-clavulanic acid AMC, ciprofloxacin CIP), based historical data grouped year hospital ward.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"objective-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Objective","title":"AMR with tidymodels","text":"goal : Prepare dataset aggregating resistance data time. Define regression model predict AMR trends. Use tidymodels preprocess, train, evaluate model.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"data-preparation-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Data Preparation","title":"AMR with tidymodels","text":"start transforming example_isolates dataset structured time-series format. Explanation: mo_name(mo): Converts microbial codes proper species names. resistance(): Converts AMR results numeric values (proportion resistant isolates). group_by(year, ward, species): Aggregates resistance rates year ward.","code":"# Load required libraries library(AMR) library(tidymodels)  # Transform dataset data_time <- example_isolates %>%   top_n_microorganisms(n = 10) %>% # Filter on the top #10 species   mutate(year = as.integer(format(date, \"%Y\")),  # Extract year from date          gramstain = mo_gramstain(mo)) %>% # Get taxonomic names   group_by(year, gramstain) %>%   summarise(across(c(AMX, AMC, CIP),                     function(x) resistance(x, minimum = 0),                    .names = \"res_{.col}\"),              .groups = \"drop\") %>%    filter(!is.na(res_AMX) & !is.na(res_AMC) & !is.na(res_CIP)) # Drop missing values #> ℹ Using column 'mo' as input for `col_mo`.  data_time #> # A tibble: 32 × 5 #>     year gramstain     res_AMX res_AMC res_CIP #>    <int> <chr>           <dbl>   <dbl>   <dbl> #>  1  2002 Gram-negative   1      0.105   0.0606 #>  2  2002 Gram-positive   0.838  0.182   0.162  #>  3  2003 Gram-negative   1      0.0714  0      #>  4  2003 Gram-positive   0.714  0.244   0.154  #>  5  2004 Gram-negative   0.464  0.0938  0      #>  6  2004 Gram-positive   0.849  0.299   0.244  #>  7  2005 Gram-negative   0.412  0.132   0.0588 #>  8  2005 Gram-positive   0.882  0.382   0.154  #>  9  2006 Gram-negative   0.379  0       0.1    #> 10  2006 Gram-positive   0.778  0.333   0.353  #> # ℹ 22 more rows"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"defining-the-workflow-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Defining the Workflow","title":"AMR with tidymodels","text":"now define modelling workflow, consists preprocessing step, model specification, fitting process.","code":""},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"preprocessing-with-a-recipe-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time > Defining the Workflow","what":"1. Preprocessing with a Recipe","title":"AMR with tidymodels","text":"Explanation: step_dummy(): Encodes categorical variables (ward, species) numerical indicators. step_normalize(): Normalises year variable. step_nzv(): Removes near-zero variance predictors.","code":"# Define the recipe resistance_recipe_time <- recipe(res_AMX ~ year + gramstain, data = data_time) %>%   step_dummy(gramstain, one_hot = TRUE) %>%  # Convert categorical to numerical   step_normalize(year) %>%  # Normalise year for better model performance   step_nzv(all_predictors())  # Remove near-zero variance predictors  resistance_recipe_time #>  #> ── Recipe ────────────────────────────────────────────────────────────────────── #>  #> ── Inputs #> Number of variables by role #> outcome:   1 #> predictor: 2 #>  #> ── Operations #> • Dummy variables from: gramstain #> • Centering and scaling for: year #> • Sparse, unbalanced variable filter on: all_predictors()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"specifying-the-model-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time > Defining the Workflow","what":"2. Specifying the Model","title":"AMR with tidymodels","text":"use linear regression model predict resistance trends. Explanation: linear_reg(): Defines linear regression model. set_engine(\"lm\"): Uses R’s built-linear regression engine.","code":"# Define the linear regression model lm_model <- linear_reg() %>%   set_engine(\"lm\") # Use linear regression  lm_model #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"building-the-workflow-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time > Defining the Workflow","what":"3. Building the Workflow","title":"AMR with tidymodels","text":"combine preprocessing recipe model workflow.","code":"# Create workflow resistance_workflow_time <- workflow() %>%   add_recipe(resistance_recipe_time) %>%   add_model(lm_model)  resistance_workflow_time #> ══ Workflow ════════════════════════════════════════════════════════════════════ #> Preprocessor: Recipe #> Model: linear_reg() #>  #> ── Preprocessor ──────────────────────────────────────────────────────────────── #> 3 Recipe Steps #>  #> • step_dummy() #> • step_normalize() #> • step_nzv() #>  #> ── Model ─────────────────────────────────────────────────────────────────────── #> Linear Regression Model Specification (regression) #>  #> Computational engine: lm"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"training-and-evaluating-the-model-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Training and Evaluating the Model","title":"AMR with tidymodels","text":"split data training testing sets, fit model, evaluate performance. Explanation: initial_split(): Splits data training testing sets. fit(): Trains workflow. predict(): Generates resistance predictions. metrics(): Evaluates model performance.","code":"# Split the data set.seed(123) data_split_time <- initial_split(data_time, prop = 0.8) train_time <- training(data_split_time) test_time <- testing(data_split_time)  # Train the model fitted_workflow_time <- resistance_workflow_time %>%   fit(train_time)  # Make predictions predictions_time <- fitted_workflow_time %>%   predict(test_time) %>%   bind_cols(test_time)   # Evaluate model metrics_time <- predictions_time %>%   metrics(truth = res_AMX, estimate = .pred)  metrics_time #> # A tibble: 3 × 3 #>   .metric .estimator .estimate #>   <chr>   <chr>          <dbl> #> 1 rmse    standard      0.0774 #> 2 rsq     standard      0.711  #> 3 mae     standard      0.0704"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"visualising-predictions-1","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Visualising Predictions","title":"AMR with tidymodels","text":"plot resistance trends time amoxicillin.  Additionally, can visualise resistance trends ggplot2 directly add linear models :","code":"library(ggplot2)  # Plot actual vs predicted resistance over time ggplot(predictions_time, aes(x = year)) +   geom_point(aes(y = res_AMX, color = \"Actual\")) +   geom_line(aes(y = .pred, color = \"Predicted\")) +   labs(title = \"Predicted vs Actual AMX Resistance Over Time\",        x = \"Year\",        y = \"Resistance Proportion\") +   theme_minimal() ggplot(data_time, aes(x = year, y = res_AMX, color = gramstain)) +   geom_line() +   labs(title = \"AMX Resistance Trends\",        x = \"Year\",        y = \"Resistance Proportion\") +   # add a linear model directly in ggplot2:   geom_smooth(method = \"lm\",               formula = y ~ x,               alpha = 0.25) +   theme_minimal()"},{"path":"https://amr-for-r.org/articles/AMR_with_tidymodels.html","id":"conclusion-2","dir":"Articles","previous_headings":"Example 3: Predicting AMR Over Time","what":"Conclusion","title":"AMR with tidymodels","text":"example, demonstrated analyze AMR trends time using tidymodels. aggregating resistance rates year hospital ward, built predictive model track changes resistance amoxicillin (AMX), amoxicillin-clavulanic acid (AMC), ciprofloxacin (CIP). method can extended antibiotics resistance patterns, providing valuable insights AMR dynamics healthcare settings.","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Apply EUCAST rules","text":"EUCAST rules? European Committee Antimicrobial Susceptibility Testing (EUCAST) states website: EUCAST expert rules (see ) tabulated collection expert knowledge interpretive rules, expected resistant phenotypes expected susceptible phenotypes applied antimicrobial susceptibility testing order reduce testing, reduce errors make appropriate recommendations reporting particular resistances. Europe, lot medical microbiological laboratories already apply rules (Brown et al., 2015). package features latest insights expected resistant phenotypes (v1.2, 2023).","code":""},{"path":"https://amr-for-r.org/articles/EUCAST.html","id":"examples","dir":"Articles","previous_headings":"","what":"Examples","title":"Apply EUCAST rules","text":"rules can used discard improbable bug-drug combinations data. example, Klebsiella produces beta-lactamase prevents ampicillin (amoxicillin) working . words, practically every strain Klebsiella resistant ampicillin. Sometimes, laboratory data can still contain strains Klebsiella susceptible ampicillin. antibiogram available identification available, antibiogram re-interpreted based identification. eucast_rules() function resolves , applying latest ‘EUCAST Expected Resistant Phenotypes’ guideline: convenient function mo_is_intrinsic_resistant() uses guideline, allows check one specific microorganisms antimicrobials: EUCAST rules can used correction, can also used filling known resistance susceptibility based results antimicrobials drugs. process called interpretive reading, basically form imputation:","code":"oops <- tibble::tibble(   mo = c(     \"Klebsiella pneumoniae\",     \"Escherichia coli\"   ),   ampicillin = as.sir(\"S\") ) oops #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   S        #> 2 Escherichia coli        S    eucast_rules(oops, info = FALSE, overwrite = TRUE) #> # A tibble: 2 × 2 #>   mo                    ampicillin #>   <chr>                 <sir>      #> 1 Klebsiella pneumoniae   R        #> 2 Escherichia coli        S mo_is_intrinsic_resistant(   c(\"Klebsiella pneumoniae\", \"Escherichia coli\"),   \"ampicillin\" ) #> [1]  TRUE FALSE  mo_is_intrinsic_resistant(   \"Klebsiella pneumoniae\",   c(\"ampicillin\", \"kanamycin\") ) #> [1]  TRUE FALSE data <- tibble::tibble(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylenicillin   FOX = \"S\"  # Cefoxitin ) data eucast_rules(data, overwrite = TRUE)"},{"path":[]},{"path":"https://amr-for-r.org/articles/PCA.html","id":"transforming","dir":"Articles","previous_headings":"","what":"Transforming","title":"Conduct principal component analysis (PCA) for AMR","text":"PCA, need transform AMR data first. example_isolates data set package looks like: Now transform data set resistance percentages per taxonomic order genus:","code":"library(AMR) library(dplyr) glimpse(example_isolates) #> Rows: 2,000 #> Columns: 46 #> $ date    <date> 2002-01-02, 2002-01-03, 2002-01-07, 2002-01-07, 2002-01-13, 2… #> $ patient <chr> \"A77334\", \"A77334\", \"067927\", \"067927\", \"067927\", \"067927\", \"4… #> $ age     <dbl> 65, 65, 45, 45, 45, 45, 78, 78, 45, 79, 67, 67, 71, 71, 75, 50… #> $ gender  <chr> \"F\", \"F\", \"F\", \"F\", \"F\", \"F\", \"M\", \"M\", \"F\", \"F\", \"M\", \"M\", \"M… #> $ ward    <chr> \"Clinical\", \"Clinical\", \"ICU\", \"ICU\", \"ICU\", \"ICU\", \"Clinical\"… #> $ mo      <mo> \"B_ESCHR_COLI\", \"B_ESCHR_COLI\", \"B_STPHY_EPDR\", \"B_STPHY_EPDR\",… #> $ PEN     <sir> R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, R, S,… #> $ OXA     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ FLC     <sir> NA, NA, R, R, R, R, S, S, R, S, S, S, NA, NA, NA, NA, NA, R, R… #> $ AMX     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ AMC     <sir> I, I, NA, NA, NA, NA, S, S, NA, NA, S, S, I, I, R, I, I, NA, N… #> $ AMP     <sir> NA, NA, NA, NA, NA, NA, R, R, NA, NA, NA, NA, NA, NA, R, NA, N… #> $ TZP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CZO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ FEP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CXM     <sir> I, I, R, R, R, R, S, S, R, S, S, S, S, S, NA, S, S, R, R, S, S… #> $ FOX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, NA,… #> $ CTX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ CAZ     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, S, S, R, R, … #> $ CRO     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ GEN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TOB     <sir> NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, S, S, NA, NA, NA… #> $ AMK     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ KAN     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ TMP     <sir> R, R, S, S, R, R, R, R, S, S, NA, NA, S, S, S, S, S, R, R, R, … #> $ SXT     <sir> R, R, S, S, NA, NA, NA, NA, S, S, NA, NA, S, S, S, S, S, NA, N… #> $ NIT     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R,… #> $ FOS     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ LNZ     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ CIP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, NA, NA, NA, NA, S, S… #> $ MFX     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ VAN     <sir> R, R, S, S, S, S, S, S, S, S, NA, NA, R, R, R, R, R, S, S, S, … #> $ TEC     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… #> $ TCY     <sir> R, R, S, S, S, S, S, S, S, I, S, S, NA, NA, I, R, R, S, I, R, … #> $ TGC     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ DOX     <sir> NA, NA, S, S, S, S, S, S, S, NA, S, S, NA, NA, NA, R, R, S, NA… #> $ ERY     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ CLI     <sir> R, R, NA, NA, NA, R, NA, NA, NA, NA, NA, NA, R, R, R, R, R, NA… #> $ AZM     <sir> R, R, R, R, R, R, S, S, R, S, S, S, R, R, R, R, R, R, R, R, S,… #> $ IPM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, S, S, NA, S, S… #> $ MEM     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ MTR     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ CHL     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ COL     <sir> NA, NA, R, R, R, R, R, R, R, R, R, R, NA, NA, NA, R, R, R, R, … #> $ MUP     <sir> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA… #> $ RIF     <sir> R, R, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, R, R, R, R, R, N… resistance_data <- example_isolates %>%   group_by(     order = mo_order(mo), # group on anything, like order     genus = mo_genus(mo)   ) %>% #  and genus as we do here   summarise_if(is.sir, resistance) %>% # then get resistance of all drugs   select(     order, genus, AMC, CXM, CTX,     CAZ, GEN, TOB, TMP, SXT   ) # and select only relevant columns  head(resistance_data) #> # A tibble: 6 × 10 #> # Groups:   order [5] #>   order             genus          AMC   CXM   CTX   CAZ   GEN   TOB   TMP   SXT #>   <chr>             <chr>        <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 (unknown order)   (unknown ge…    NA    NA    NA    NA    NA    NA    NA    NA #> 2 Actinomycetales   Schaalia        NA    NA    NA    NA    NA    NA    NA    NA #> 3 Bacteroidales     Bacteroides     NA    NA    NA    NA    NA    NA    NA    NA #> 4 Campylobacterales Campylobact…    NA    NA    NA    NA    NA    NA    NA    NA #> 5 Caryophanales     Gemella         NA    NA    NA    NA    NA    NA    NA    NA #> 6 Caryophanales     Listeria        NA    NA    NA    NA    NA    NA    NA    NA"},{"path":"https://amr-for-r.org/articles/PCA.html","id":"perform-principal-component-analysis","dir":"Articles","previous_headings":"","what":"Perform principal component analysis","title":"Conduct principal component analysis (PCA) for AMR","text":"new pca() function automatically filter rows contain numeric values selected variables, now need : result can reviewed good old summary() function: Good news. first two components explain total 93.3% variance (see PC1 PC2 values Proportion Variance. can create -called biplot base R biplot() function, see antimicrobial resistance per drug explain difference per microorganism.","code":"pca_result <- pca(resistance_data) #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. summary(pca_result) #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\" #> Importance of components: #>                           PC1    PC2    PC3     PC4     PC5     PC6       PC7 #> Standard deviation     2.1539 1.6807 0.6138 0.33879 0.20808 0.03140 1.232e-16 #> Proportion of Variance 0.5799 0.3531 0.0471 0.01435 0.00541 0.00012 0.000e+00 #> Cumulative Proportion  0.5799 0.9330 0.9801 0.99446 0.99988 1.00000 1.000e+00 #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\""},{"path":"https://amr-for-r.org/articles/PCA.html","id":"plotting-the-results","dir":"Articles","previous_headings":"","what":"Plotting the results","title":"Conduct principal component analysis (PCA) for AMR","text":"can’t see explanation points. Perhaps works better new ggplot_pca() function, automatically adds right labels even groups:  can also print ellipse per group, edit appearance:","code":"biplot(pca_result) ggplot_pca(pca_result) ggplot_pca(pca_result, ellipse = TRUE) +   ggplot2::labs(title = \"An AMR/PCA biplot!\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"import-of-data","dir":"Articles","previous_headings":"","what":"Import of data","title":"Work with WHONET data","text":"tutorial assumes already imported WHONET data e.g. readxl package. RStudio, can done using menu button ‘Import Dataset’ tab ‘Environment’. Choose option ‘Excel’ select exported file. Make sure date fields imported correctly. example syntax look like : package comes example data set WHONET. use analysis.","code":"library(readxl) data <- read_excel(path = \"path/to/your/file.xlsx\")"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"preparation","dir":"Articles","previous_headings":"","what":"Preparation","title":"Work with WHONET data","text":"First, load relevant packages yet . use tidyverse analyses. . don’t know yet, suggest read website: https://www.tidyverse.org/. transform variables simplify automate analysis: Microorganisms transformed microorganism codes (called mo) using Catalogue Life reference data set, contains ~70,000 microorganisms taxonomic kingdoms Bacteria, Fungi Protozoa. tranformation .mo(). function also recognises almost WHONET abbreviations microorganisms. Antimicrobial results interpretations clean valid. words, contain values \"S\", \"\" \"R\". exactly .sir() function . errors warnings, values transformed succesfully. also created package dedicated data cleaning checking, called cleaner package. freq() function can used create frequency tables. let’s check data, couple frequency tables: Frequency table Class: character Length: 500 Available: 500 (100%, NA: 0 = 0%) Unique: 38 Shortest: 11 Longest: 40 (omitted 28 entries, n = 57 [11.4%]) Frequency table Class: factor > ordered > sir (numeric) Length: 500 Levels: 5: S < SDD < < R < NI Available: 481 (96.2%, NA: 19 = 3.8%) Unique: 3 Drug: Amoxicillin/clavulanic acid (AMC, J01CR02/QJ01CR02) Drug group: Beta-lactams/penicillins %SI: 78.59%","code":"library(dplyr) # part of tidyverse library(ggplot2) # part of tidyverse library(AMR) # this package library(cleaner) # to create frequency tables # transform variables data <- WHONET %>%   # get microbial ID based on given organism   mutate(mo = as.mo(Organism)) %>%   # transform everything from \"AMP_ND10\" to \"CIP_EE\" to the new `sir` class   mutate_at(vars(AMP_ND10:CIP_EE), as.sir) # our newly created `mo` variable, put in the mo_name() function data %>% freq(mo_name(mo), nmax = 10) # our transformed antibiotic columns # amoxicillin/clavulanic acid (J01CR02) as an example data %>% freq(AMC_ND2)"},{"path":"https://amr-for-r.org/articles/WHONET.html","id":"a-first-glimpse-at-results","dir":"Articles","previous_headings":"","what":"A first glimpse at results","title":"Work with WHONET data","text":"easy ggplot already give lot information, using included ggplot_sir() function:","code":"data %>%   group_by(Country) %>%   select(Country, AMP_ND2, AMC_ED20, CAZ_ED10, CIP_ED5) %>%   ggplot_sir(translate_ab = \"ab\", facet = \"Country\", datalabels = FALSE)"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Estimating Empirical Coverage with WISCA","text":"Clinical guidelines empirical antimicrobial therapy require probabilistic reasoning: chance regimen cover likely infecting organisms, culture results available? purpose WISCA, Weighted-Incidence Syndromic Combination Antibiogram. WISCA Bayesian approach integrates: Pathogen prevalence (often species causes syndrome), Regimen susceptibility (often regimen works pathogen known), estimate overall empirical coverage antimicrobial regimens, quantified uncertainty. vignette explains WISCA works, useful, apply using AMR package.","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"why-traditional-antibiograms-fall-short","dir":"Articles","previous_headings":"","what":"Why traditional antibiograms fall short","title":"Estimating Empirical Coverage with WISCA","text":"standard antibiogram gives : clinicians don’t know species priori. need choose regimen covers likely pathogens, without knowing one present. Traditional antibiograms calculate susceptibility % just number resistant isolates divided total number tested isolates. Therefore, traditional antibiograms: Fragment information organism, weight real-world prevalence, account combination therapy sample size, provide uncertainty.","code":"Species → Antibiotic → Susceptibility %"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"the-idea-of-wisca","dir":"Articles","previous_headings":"","what":"The idea of WISCA","title":"Estimating Empirical Coverage with WISCA","text":"WISCA asks: “probability regimen cover pathogen, given syndrome?” means combining two things: Incidence pathogen syndrome, Susceptibility pathogen regimen. can write : Coverage=∑(Incidencei×Susceptibilityi)\\text{Coverage} = \\sum_i (\\text{Incidence}_i \\times \\text{Susceptibility}_i) example, suppose: E. coli causes 60% cases, 90% E. coli susceptible drug. Klebsiella causes 40% cases, 70% Klebsiella susceptible. : Coverage=(0.6×0.9)+(0.4×0.7)=0.82\\text{Coverage} = (0.6 \\times 0.9) + (0.4 \\times 0.7) = 0.82 real data, incidence susceptibility estimated samples, carry uncertainty. WISCA models probabilistically, using conjugate Bayesian distributions.","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"pathogen-incidence","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Pathogen incidence","title":"Estimating Empirical Coverage with WISCA","text":"Let: KK number pathogens, α=(1,1,…,1)\\alpha = (1, 1, \\ldots, 1) Dirichlet prior (uniform), n=(n1,…,nK)n = (n_1, \\ldots, n_K) observed counts per species. posterior incidence : p∼Dirichlet(α1+n1,…,αK+nK)p \\sim \\text{Dirichlet}(\\alpha_1 + n_1, \\ldots, \\alpha_K + n_K) simulate , use: xi∼Gamma(αi+ni,1),pi=xi∑j=1Kxjx_i \\sim \\text{Gamma}(\\alpha_i + n_i,\\ 1), \\quad p_i = \\frac{x_i}{\\sum_{j=1}^{K} x_j}","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"susceptibility","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Susceptibility","title":"Estimating Empirical Coverage with WISCA","text":"pathogen–regimen pair prior data: Prior: Beta(α0,β0)\\text{Beta}(\\alpha_0, \\beta_0), default α0=β0=1\\alpha_0 = \\beta_0 = 1 Data: SS susceptible NN tested SS category also include values SDD (susceptible, dose-dependent) (intermediate [CLSI], susceptible, increased exposure [EUCAST]). posterior : θ∼Beta(α0+S,β0+N−S)\\theta \\sim \\text{Beta}(\\alpha_0 + S,\\ \\beta_0 + N - S)","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"final-coverage-estimate","dir":"Articles","previous_headings":"The Bayesian engine behind WISCA","what":"Final coverage estimate","title":"Estimating Empirical Coverage with WISCA","text":"Putting together: Simulate pathogen incidence: 𝐩∼Dirichlet\\boldsymbol{p} \\sim \\text{Dirichlet} Simulate susceptibility: θi∼Beta(1+Si,1+Ri)\\theta_i \\sim \\text{Beta}(1 + S_i,\\ 1 + R_i) Combine: Coverage=∑=1Kpi⋅θi\\text{Coverage} = \\sum_{=1}^{K} p_i \\cdot \\theta_i Repeat simulation (e.g. 1000×) summarise: Mean = expected coverage Quantiles = credible interval","code":""},{"path":[]},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"prepare-data-and-simulate-synthetic-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Prepare data and simulate synthetic syndrome","title":"Estimating Empirical Coverage with WISCA","text":"","code":"library(AMR) data <- example_isolates  # Structure of our data data #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # Add a fake syndrome column data$syndrome <- ifelse(data$mo %like% \"coli\", \"UTI\", \"No UTI\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"basic-wisca-antibiogram","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Basic WISCA antibiogram","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"CIP\", \"GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"use-combination-regimens","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Use combination regimens","title":"Estimating Empirical Coverage with WISCA","text":"","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"))"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"stratify-by-syndrome","dir":"Articles","previous_headings":"Practical use in the AMR package","what":"Stratify by syndrome","title":"Estimating Empirical Coverage with WISCA","text":"AMR package available 28 languages, can used wisca() function :","code":"wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = \"syndrome\") wisca(data,       antimicrobials = c(\"AMC\", \"AMC + CIP\", \"AMC + GEN\"),       syndromic_group = gsub(\"UTI\", \"UCI\", data$syndrome),       language = \"Spanish\")"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"sensible-defaults-which-can-be-customised","dir":"Articles","previous_headings":"","what":"Sensible defaults, which can be customised","title":"Estimating Empirical Coverage with WISCA","text":"simulations = 1000: number Monte Carlo draws conf_interval = 0.95: coverage interval width combine_SI = TRUE: count “” “SDD” susceptible","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"limitations","dir":"Articles","previous_headings":"","what":"Limitations","title":"Estimating Empirical Coverage with WISCA","text":"assumes data representative adjustment patient-level covariates, although passed onto syndromic_group argument WISCA model resistance time, might want use tidymodels , wrote basic introduction","code":""},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"summary","dir":"Articles","previous_headings":"","what":"Summary","title":"Estimating Empirical Coverage with WISCA","text":"WISCA enables: Empirical regimen comparison, Syndrome-specific coverage estimation, Fully probabilistic interpretation. available AMR package via either:","code":"wisca(...)  antibiogram(..., wisca = TRUE)"},{"path":"https://amr-for-r.org/articles/WISCA.html","id":"reference","dir":"Articles","previous_headings":"","what":"Reference","title":"Estimating Empirical Coverage with WISCA","text":"Bielicki, JA, et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data. J Antimicrob Chemother. 71(3):794-802. https://doi.org/10.1093/jac/dkv397","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-full-microbial-taxonomy","dir":"Articles","previous_headings":"","what":"microorganisms: Full Microbial Taxonomy","title":"Download data sets for download / own use","text":"data set 78 679 rows 26 columns, containing following column names:mo, fullname, status, kingdom, phylum, class, order, family, genus, species, subspecies, rank, ref, oxygen_tolerance, source, lpsn, lpsn_parent, lpsn_renamed_to, mycobank, mycobank_parent, mycobank_renamed_to, gbif, gbif_parent, gbif_renamed_to, prevalence, snomed. data set R available microorganisms, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (1.8 MB) Download tab-separated text file (17.7 MB) Download Microsoft Excel workbook (8.7 MB) Download Apache Feather file (8.3 MB) Download Apache Parquet file (3.8 MB) Download IBM SPSS Statistics data file (28.4 MB) Download Stata DTA file (89.5 MB) NOTE: exported files SPSS Stata contain first 50 SNOMED codes per record, file size otherwise exceed 100 MB; file size limit GitHub. file structures compression techniques inefficient. Advice? Use R instead. ’s free much better many ways. tab-separated text file Microsoft Excel workbook contain SNOMED codes comma separated values. Example content Included (sub)species per taxonomic kingdom: First 6 rows filtering genus Escherichia:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antimicrobials-antibiotic-and-antifungal-drugs","dir":"Articles","previous_headings":"","what":"antimicrobials: Antibiotic and Antifungal Drugs","title":"Download data sets for download / own use","text":"data set 497 rows 14 columns, containing following column names:ab, cid, name, group, atc, atc_group1, atc_group2, abbreviations, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antimicrobials, load AMR package. last updated 1 June 2025 09:54:40 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (45 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (78 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (0.4 MB) Download Stata DTA file (10 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain ATC codes, common abbreviations, trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"clinical_breakpoints-interpretation-from-mic-values-disk-diameters-to-sir","dir":"Articles","previous_headings":"","what":"clinical_breakpoints: Interpretation from MIC values & disk diameters to SIR","title":"Download data sets for download / own use","text":"data set 40 217 rows 14 columns, containing following column names:guideline, type, host, method, site, mo, rank_index, ab, ref_tbl, disk_dose, breakpoint_S, breakpoint_R, uti, is_SDD. data set R available clinical_breakpoints, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (88 kB) Download tab-separated text file (3.7 MB) Download Microsoft Excel workbook (2.4 MB) Download Apache Feather file (1.8 MB) Download Apache Parquet file (0.1 MB) Download IBM SPSS Statistics data file (6.6 MB) Download Stata DTA file (11.1 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-groups-species-groups-and-microbiological-complexes","dir":"Articles","previous_headings":"","what":"microorganisms.groups: Species Groups and Microbiological Complexes","title":"Download data sets for download / own use","text":"data set 534 rows 4 columns, containing following column names:mo_group, mo, mo_group_name, mo_name. data set R available microorganisms.groups, load AMR package. last updated 26 March 2025 16:19:17 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (50 kB) Download Microsoft Excel workbook (20 kB) Download Apache Feather file (19 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (65 kB) Download Stata DTA file (83 kB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"intrinsic_resistant-intrinsic-bacterial-resistance","dir":"Articles","previous_headings":"","what":"intrinsic_resistant: Intrinsic Bacterial Resistance","title":"Download data sets for download / own use","text":"data set 271 905 rows 2 columns, containing following column names:mo ab. data set R available intrinsic_resistant, load AMR package. last updated 28 March 2025 10:17:49 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (0.1 MB) Download tab-separated text file (10.1 MB) Download Microsoft Excel workbook (2.9 MB) Download Apache Feather file (2.3 MB) Download Apache Parquet file (0.3 MB) Download IBM SPSS Statistics data file (14.8 MB) Download Stata DTA file (22.6 MB) Example content Example rows filtering Enterobacter cloacae:","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"dosage-dosage-guidelines-from-eucast","dir":"Articles","previous_headings":"","what":"dosage: Dosage Guidelines from EUCAST","title":"Download data sets for download / own use","text":"data set 759 rows 9 columns, containing following column names:ab, name, type, dose, dose_times, administration, notes, original_txt, eucast_version. data set R available dosage, load AMR package. last updated 20 April 2025 10:55:31 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (4 kB) Download tab-separated text file (66 kB) Download Microsoft Excel workbook (37 kB) Download Apache Feather file (28 kB) Download Apache Parquet file (9 kB) Download IBM SPSS Statistics data file (97 kB) Download Stata DTA file (0.2 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates: Example Data for Practice","title":"Download data sets for download / own use","text":"data set 2 000 rows 46 columns, containing following column names:date, patient, age, gender, ward, mo, PEN, OXA, FLC, AMX, AMC, AMP, TZP, CZO, FEP, CXM, FOX, CTX, CAZ, CRO, GEN, TOB, AMK, KAN, TMP, SXT, NIT, FOS, LNZ, CIP, MFX, VAN, TEC, TCY, TGC, DOX, ERY, CLI, AZM, IPM, MEM, MTR, CHL, COL, MUP, RIF. data set R available example_isolates, load AMR package. last updated 15 June 2024 13:33:49 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"example_isolates_unclean-example-data-for-practice","dir":"Articles","previous_headings":"","what":"example_isolates_unclean: Example Data for Practice","title":"Download data sets for download / own use","text":"data set 3 000 rows 8 columns, containing following column names:patient_id, hospital, date, bacteria, AMX, AMC, CIP, GEN. data set R available example_isolates_unclean, load AMR package. last updated 27 August 2022 18:49:37 UTC. Find info contents, (scientific) source, structure data set . Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"microorganisms-codes-common-laboratory-codes","dir":"Articles","previous_headings":"","what":"microorganisms.codes: Common Laboratory Codes","title":"Download data sets for download / own use","text":"data set 6 036 rows 2 columns, containing following column names:code mo. data set R available microorganisms.codes, load AMR package. last updated 4 May 2025 16:50:25 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (27 kB) Download tab-separated text file (0.1 MB) Download Microsoft Excel workbook (98 kB) Download Apache Feather file (0.1 MB) Download Apache Parquet file (68 kB) Download IBM SPSS Statistics data file (0.2 MB) Download Stata DTA file (0.2 MB) Example content","code":""},{"path":"https://amr-for-r.org/articles/datasets.html","id":"antivirals-antiviral-drugs","dir":"Articles","previous_headings":"","what":"antivirals: Antiviral Drugs","title":"Download data sets for download / own use","text":"data set 120 rows 11 columns, containing following column names:av, name, atc, cid, atc_group, synonyms, oral_ddd, oral_units, iv_ddd, iv_units, loinc. data set R available antivirals, load AMR package. last updated 20 October 2023 12:51:48 UTC. Find info contents, (scientific) source, structure data set . Direct download links: Download original R Data Structure (RDS) file (6 kB) Download tab-separated text file (17 kB) Download Microsoft Excel workbook (16 kB) Download Apache Feather file (16 kB) Download Apache Parquet file (13 kB) Download IBM SPSS Statistics data file (32 kB) Download Stata DTA file (78 kB) tab-separated text, Microsoft Excel, SPSS, Stata files contain trade names LOINC codes comma separated values. Example content","code":""},{"path":"https://amr-for-r.org/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Matthijs S. Berends. Author, maintainer. Dennis Souverein. Author, contributor. Erwin E. . Hassing. Author, contributor. Aislinn Cook. Contributor. Andrew P. Norgan. Contributor. Anita Williams. Contributor. Annick Lenglet. Contributor. Anthony Underwood. Contributor. Anton Mymrikov. Contributor. Bart C. Meijer. Contributor. Christian F. Luz. Contributor. Dmytro Mykhailenko. Contributor. Eric H. L. C. M. Hazenberg. Contributor. Gwen Knight. Contributor. Jane Hawkey. Contributor. Jason Stull. Contributor. Javier Sanchez. Contributor. Jonas Salm. Contributor. Judith M. Fonville. Contributor. Kathryn Holt. Contributor. Larisse Bolton. Contributor. Matthew Saab. Contributor. Natacha Couto. Contributor. Peter Dutey-Magni. Contributor. Rogier P. Schade. Contributor. Sofia Ny. Contributor. Alex W. Friedrich. Thesis advisor. Bhanu N. M. Sinha. Thesis advisor. Casper J. Albers. Thesis advisor. Corinna Glasner. Thesis advisor.","code":""},{"path":"https://amr-for-r.org/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). “AMR: R Package Working Antimicrobial Resistance Data.” Journal Statistical Software, 104(3), 1–31. doi:10.18637/jss.v104.i03.","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/index.html","id":"the-amr-package-for-r-","dir":"","previous_headings":"","what":"Antimicrobial Resistance Data Analysis","title":"Antimicrobial Resistance Data Analysis","text":"Provides --one solution antimicrobial resistance (AMR) data analysis One Health approach Peer-reviewed, used 175 countries, available 28 languages Generates antibiograms - traditional, combined, syndromic, even WISCA Provides full microbiological taxonomy ~79 000 distinct species extensive info ~620 antimicrobial drugs Applies CLSI 2011-2025 EUCAST 2011-2025 clinical veterinary breakpoints, ECOFFs, MIC disk zone interpretation Corrects duplicate isolates, calculates predicts AMR per antimicrobial class Integrates WHONET, ATC, EARS-Net, PubChem, LOINC, SNOMED CT, NCBI 100% free costs dependencies, highly suitable places limited resources Now available Python ! Click read . amr--r.org doi.org/10.18637/jss.v104.i03","code":""},{"path":"https://amr-for-r.org/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Antimicrobial Resistance Data Analysis","text":"AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. team many different researchers around globe make successful durable project! work published Journal Statistical Software (Volume 104(3); DOI 10.18637/jss.v104.i03) formed basis two PhD theses (DOI 10.33612/diss.177417131 DOI 10.33612/diss.192486375). installing package, R knows ~79 000 distinct microbial species (updated June 2024) ~620 antimicrobial antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI 2011-2025 EUCAST 2011-2025 included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen University Medical Center Groningen.","code":""},{"path":"https://amr-for-r.org/index.html","id":"used-in-over-175-countries-available-in-28-languages","dir":"","previous_headings":"Introduction","what":"Used in over 175 countries, available in 28 languages","title":"Antimicrobial Resistance Data Analysis","text":"Since first public release early 2018, R package used almost countries world. Click map enlarge see country names. help contributors corners world, AMR package available  English,  Arabic,  Bengali,  Chinese,  Czech,  Danish,  Dutch,  Finnish,  French,  German,  Greek,  Hindi,  Indonesian,  Italian,  Japanese,  Korean,  Norwegian,  Polish,  Portuguese,  Romanian,  Russian,  Spanish,  Swahili,  Swedish,  Turkish,  Ukrainian,  Urdu,  Vietnamese. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"filtering-and-selecting-data","dir":"","previous_headings":"Practical examples","what":"Filtering and selecting data","title":"Antimicrobial Resistance Data Analysis","text":"One powerful functions package, aside calculating plotting AMR, selecting filtering based antimicrobial columns. can done using -called antimicrobial selectors, work base R, dplyr data.table. defined row filter Gram-negative bacteria intrinsic resistance cefotaxime (mo_is_gram_negative() mo_is_intrinsic_resistant()) column selection two antibiotic groups (aminoglycosides() carbapenems()), reference data microorganisms antimicrobials AMR package make sure get meant.","code":"# AMR works great with dplyr, but it's not required or neccesary library(AMR) library(dplyr, warn.conflicts = FALSE)  example_isolates %>%   mutate(bacteria = mo_fullname()) %>%   # filtering functions for microorganisms:   filter(mo_is_gram_negative(),          mo_is_intrinsic_resistant(ab = \"cefotax\")) %>%   # antimicrobial selectors:   select(bacteria,          aminoglycosides(),          carbapenems()) #> ℹ Using column 'mo' as input for `mo_fullname()` #> ℹ Using column 'mo' as input for `mo_is_gram_negative()` #> ℹ Using column 'mo' as input for `mo_is_intrinsic_resistant()` #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant #>   Phenotypes' v1.2 (2023). This note will be shown once per session. #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 35 × 7 #>    bacteria                     GEN   TOB   AMK   KAN   IPM   MEM   #>    <chr>                        <sir> <sir> <sir> <sir> <sir> <sir> #>  1 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  2 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  3 Pseudomonas aeruginosa       I     S     NA    R     S     NA    #>  4 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  5 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  6 Pseudomonas aeruginosa       S     S     S     R     S     S     #>  7 Stenotrophomonas maltophilia R     R     R     R     R     R     #>  8 Pseudomonas aeruginosa       S     S     S     R     NA    S     #>  9 Pseudomonas aeruginosa       S     S     S     R     NA    S     #> 10 Pseudomonas aeruginosa       S     S     S     R     S     S     #> # ℹ 25 more rows"},{"path":"https://amr-for-r.org/index.html","id":"generating-antibiograms","dir":"","previous_headings":"Practical examples","what":"Generating antibiograms","title":"Antimicrobial Resistance Data Analysis","text":"AMR package supports generating traditional, combined, syndromic, even weighted-incidence syndromic combination antibiograms (WISCA). used inside R Markdown Quarto, table printed right output format automatically (markdown, LaTeX, HTML, etc.). combination antibiograms, clear combined antimicrobials yield higher empiric coverage: Like many functions package, antibiogram() comes support 28 languages often detected automatically based system language:","code":"antibiogram(example_isolates,             antimicrobials = c(aminoglycosides(), carbapenems())) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) antibiogram(example_isolates,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             mo_transform = \"gramstain\") antibiogram(example_isolates,             antimicrobials = c(\"cipro\", \"tobra\", \"genta\"), # any arbitrary name or code will work             mo_transform = \"gramstain\",             ab_transform = \"name\",             language = \"uk\") # Ukrainian"},{"path":"https://amr-for-r.org/index.html","id":"interpreting-and-plotting-mic-and-sir-values","dir":"","previous_headings":"Practical examples","what":"Interpreting and plotting MIC and SIR values","title":"Antimicrobial Resistance Data Analysis","text":"AMR package allows interpretation MIC disk diffusion values based CLSI EUCAST. Moreover, ggplot2 package extended new scale functions, allow plotting log2-distributed MIC values SIR values.","code":"library(ggplot2) library(AMR)  # generate some random values some_mic_values <- random_mic(size = 100) some_groups <- sample(LETTERS[1:5], 20, replace = TRUE) interpretation <- as.sir(some_mic_values,                          guideline = \"EUCAST 2024\",                          mo = \"E. coli\", # or any code or name resembling a known species                          ab = \"Cipro\")   # or any code or name resembling an antibiotic  # create the plot ggplot(data.frame(mic = some_mic_values,                   group = some_groups,                   sir = interpretation),        aes(x = group, y = mic, colour = sir)) +   theme_minimal() +   geom_boxplot(fill = NA, colour = \"grey30\") +   geom_jitter(width = 0.25) +      # NEW scale function: plot MIC values to x, y, colour or fill   scale_y_mic() +      # NEW scale function: write out S/I/R in any of the 20 supported languages   #                     and set colourblind-friendly colours   scale_colour_sir()"},{"path":"https://amr-for-r.org/index.html","id":"calculating-resistance-per-group","dir":"","previous_headings":"Practical examples","what":"Calculating resistance per group","title":"Antimicrobial Resistance Data Analysis","text":"manual approach, can use resistance susceptibility() function: use antimicrobial selectors select series antibiotic columns:","code":"example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance() for gentamicin and tobramycin   # and get their 95% confidence intervals using sir_confidence_interval():   summarise(across(c(GEN, TOB),                    list(total_R = resistance,                         conf_int = function(x) sir_confidence_interval(x, collapse = \"-\")))) #> # A tibble: 3 × 5 #>   ward       GEN_total_R GEN_conf_int TOB_total_R TOB_conf_int #>   <chr>            <dbl> <chr>              <dbl> <chr>        #> 1 Clinical         0.229 0.205-0.254        0.315 0.284-0.347  #> 2 ICU              0.290 0.253-0.33         0.400 0.353-0.449  #> 3 Outpatient       0.2   0.131-0.285        0.368 0.254-0.493 library(AMR) library(dplyr)  out <- example_isolates %>%   # group by ward:   group_by(ward) %>%   # calculate AMR using resistance(), over all aminoglycosides and polymyxins:   summarise(across(c(aminoglycosides(), polymyxins()),             resistance)) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `polymyxins()` using column 'COL' (colistin) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `across(c(aminoglycosides(), polymyxins()), resistance)`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = #> \"Outpatient\" (`minimum` = 30). out #> # A tibble: 3 × 6 #>   ward         GEN   TOB   AMK   KAN   COL #>   <chr>      <dbl> <dbl> <dbl> <dbl> <dbl> #> 1 Clinical   0.229 0.315 0.626     1 0.780 #> 2 ICU        0.290 0.400 0.662     1 0.857 #> 3 Outpatient 0.2   0.368 0.605    NA 0.889 # transform the antibiotic columns to names: out %>% set_ab_names() #> # A tibble: 3 × 6 #>   ward       gentamicin tobramycin amikacin kanamycin colistin #>   <chr>           <dbl>      <dbl>    <dbl>     <dbl>    <dbl> #> 1 Clinical        0.229      0.315    0.626         1    0.780 #> 2 ICU             0.290      0.400    0.662         1    0.857 #> 3 Outpatient      0.2        0.368    0.605        NA    0.889 # transform the antibiotic column to ATC codes: out %>% set_ab_names(property = \"atc\") #> # A tibble: 3 × 6 #>   ward       J01GB03 J01GB01 J01GB06 J01GB04 J01XB01 #>   <chr>        <dbl>   <dbl>   <dbl>   <dbl>   <dbl> #> 1 Clinical     0.229   0.315   0.626       1   0.780 #> 2 ICU          0.290   0.400   0.662       1   0.857 #> 3 Outpatient   0.2     0.368   0.605      NA   0.889"},{"path":"https://amr-for-r.org/index.html","id":"what-else-can-you-do-with-this-package","dir":"","previous_headings":"","what":"What else can you do with this package?","title":"Antimicrobial Resistance Data Analysis","text":"package intended comprehensive toolbox integrated AMR data analysis. package can used : Reference taxonomy microorganisms, since package contains microbial (sub)species List Prokaryotic names Standing Nomenclature (LPSN) Global Biodiversity Information Facility (GBIF) (manual) Interpreting raw MIC disk diffusion values, based CLSI EUCAST guideline (manual) Retrieving antimicrobial drug names, doses forms administration clinical health care records (manual) Determining first isolates used AMR data analysis (manual) Calculating antimicrobial resistance (tutorial) Determining multi-drug resistance (MDR) / multi-drug resistant organisms (MDRO) (tutorial) Calculating (empirical) susceptibility mono therapy combination therapies (tutorial) Apply AMR functions predictive modelling (tutorial) Getting properties microorganism (like Gram stain, species, genus family) (manual) Getting properties antimicrobial (like name, code EARS-Net/ATC/LOINC/PubChem, defined daily dose trade name) (manual) Plotting antimicrobial resistance (tutorial) Applying EUCAST expert rules (manual) Getting SNOMED codes microorganism, getting properties microorganism based SNOMED code (manual) Getting LOINC codes antibiotic, getting properties antibiotic based LOINC code (manual) Machine reading EUCAST CLSI guidelines 2011-2021 translate MIC values disk diffusion diameters SIR (link) Principal component analysis AMR (tutorial)","code":""},{"path":[]},{"path":"https://amr-for-r.org/index.html","id":"latest-official-version","dir":"","previous_headings":"Get this package","what":"Latest official version","title":"Antimicrobial Resistance Data Analysis","text":"package available official R network (CRAN). Install package R CRAN using command: downloaded installed automatically. RStudio, click menu Tools > Install Packages… type “AMR” press Install. Note: functions website may available latest release. use functions data sets mentioned website, install latest beta version.","code":"install.packages(\"AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"latest-beta-version","dir":"","previous_headings":"Get this package","what":"Latest beta version","title":"Antimicrobial Resistance Data Analysis","text":"Please read Developer Guideline . install latest unpublished beta version:","code":"install.packages(\"AMR\", repos = \"beta.amr-for-r.org\")  # if this does not work, try to install directly from GitHub using the 'remotes' package: remotes::install_github(\"msberends/AMR\")"},{"path":"https://amr-for-r.org/index.html","id":"get-started","dir":"","previous_headings":"","what":"Get started","title":"Antimicrobial Resistance Data Analysis","text":"find conduct AMR data analysis, please continue reading get started click link ‘’ menu.","code":""},{"path":"https://amr-for-r.org/index.html","id":"partners","dir":"","previous_headings":"","what":"Partners","title":"Antimicrobial Resistance Data Analysis","text":"initial development package part , related , made possible following non-profit organisations initiatives:","code":""},{"path":"https://amr-for-r.org/index.html","id":"copyright","dir":"","previous_headings":"","what":"Copyright","title":"Antimicrobial Resistance Data Analysis","text":"R package free, open-source software licensed GNU General Public License v2.0 (GPL-2). nutshell, means package: May used commercial purposes May used private purposes May used patent purposes May modified, although: Modifications must released license distributing package Changes made code must documented May distributed, although: Source code must made available package distributed copy license copyright notice must included package. Comes LIMITATION liability Comes warranty","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":null,"dir":"Reference","previous_headings":"","what":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"objects -called 'Deprecated'. removed future version package. Using give warning name alternative object replaced (one).","code":""},{"path":"https://amr-for-r.org/reference/AMR-deprecated.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deprecated Functions, Arguments, or Datasets — AMR-deprecated","text":"","code":"ab_class(...)  ab_selector(...)"},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":null,"dir":"Reference","previous_headings":"","what":"Options for the AMR package — AMR-options","title":"Options for the AMR package — AMR-options","text":"overview package-specific options() can set AMR package.","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"options","dir":"Reference","previous_headings":"","what":"Options","title":"Options for the AMR package — AMR-options","text":"AMR_antibiogram_formatting_type  numeric (1-22) use antibiogram(), indicate formatting type use. AMR_breakpoint_type  character use .sir(), indicate breakpoint type use. must either \"ECOFF\", \"animal\", \"human\". AMR_capped_mic_handling  character use .sir(), indicate capped MIC values (<, <=, >, >=) interpreted. Must one \"standard\", \"strict\", \"relaxed\", \"inverse\" - default \"standard\". AMR_cleaning_regex  regular expression (case-insensitive) use .mo() mo_* functions, clean user input. default outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". AMR_custom_ab  file location RDS file, use custom antimicrobial drugs package. explained add_custom_antimicrobials(). AMR_custom_mo  file location RDS file, use custom microorganisms package. explained add_custom_microorganisms(). AMR_eucastrules  character set default types rules eucast_rules() function, must one : \"breakpoints\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expert\"). AMR_guideline  character set default guideline interpreting MIC values disk diffusion diameters .sir(). Can guideline name (e.g., \"CLSI\") name year (e.g. \"CLSI 2019\"). default latest implemented EUCAST guideline, currently \"EUCAST 2025\". Supported guideline currently EUCAST (2011-2025) CLSI (2011-2025). AMR_ignore_pattern  regular expression ignore (.e., make NA) match given .mo() mo_* functions. AMR_include_PKPD  logical use .sir(), indicate PK/PD clinical breakpoints must applied last resort - default TRUE. AMR_substitute_missing_r_breakpoint  logical use .sir(), indicate missing R breakpoints must substituted \"R\" - default FALSE. AMR_include_screening  logical use .sir(), indicate clinical breakpoints screening allowed - default FALSE. AMR_keep_synonyms  logical use .mo() mo_* functions, indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE. AMR_locale  character set language AMR package, can one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). default current system language (supported, English otherwise). AMR_mo_source  file location manual code list used .mo() mo_* functions. explained set_mo_source().","code":""},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"saving-settings-between-sessions","dir":"Reference","previous_headings":"","what":"Saving Settings Between Sessions","title":"Options for the AMR package — AMR-options","text":"Settings R saved globally thus lost R exited. can save options .Rprofile file, user-specific file. can edit using:   file, can set options ...   ...add Portuguese language support antimicrobials, allow PK/PD rules interpreting MIC values .sir().","code":"utils::file.edit(\"~/.Rprofile\") options(AMR_locale = \"pt\")  options(AMR_include_PKPD = TRUE)"},{"path":"https://amr-for-r.org/reference/AMR-options.html","id":"share-options-within-team","dir":"Reference","previous_headings":"","what":"Share Options Within Team","title":"Options for the AMR package — AMR-options","text":"global approach, e.g. within (data) team, save options file remote file location, shared network drive, user read file automatically start-. work way: Save plain text file e.g. \"X:/team_folder/R_options.R\" fill preferred settings. user, open .Rprofile file using utils::file.edit(\"~/.Rprofile\") put :   Reload R/RStudio check settings getOption(), e.g. getOption(\"AMR_locale\") set value. Now team settings configured one place, can maintained .","code":"source(\"X:/team_folder/R_options.R\")"},{"path":"https://amr-for-r.org/reference/AMR.html","id":null,"dir":"Reference","previous_headings":"","what":"The AMR Package — AMR","title":"The AMR Package — AMR","text":"Welcome AMR package. AMR package peer-reviewed, free open-source R package zero dependencies simplify analysis prediction Antimicrobial Resistance (AMR) work microbial antimicrobial data properties, using evidence-based methods. aim provide standard clean reproducible AMR data analysis, can therefore empower epidemiological analyses continuously enable surveillance treatment evaluation setting. team many different researchers around globe make successful durable project! work published Journal Statistical Software (Volume 104(3); doi:10.18637/jss.v104.i03 ) formed basis two PhD theses (doi:10.33612/diss.177417131  doi:10.33612/diss.192486375 ). installing package, R knows ~79 000 distinct microbial species (updated June 2024) ~620 antimicrobial antiviral drugs name code (including ATC, EARS-Net, ASIARS-Net, PubChem, LOINC SNOMED CT), knows valid SIR MIC values. integral clinical breakpoint guidelines CLSI 2011-2025 EUCAST 2011-2025 included, even epidemiological cut-(ECOFF) values. supports can read data format, including WHONET data. package works Windows, macOS Linux versions R since R-3.0 (April 2013). designed work setting, including limited resources. created routine data analysis academic research Faculty Medical Sciences University Groningen University Medical Center Groningen. AMR package available English, Arabic, Bengali, Chinese, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swahili, Swedish, Turkish, Ukrainian, Urdu, Vietnamese. Antimicrobial drug (group) names colloquial microorganism names provided languages.","code":""},{"path":"https://amr-for-r.org/reference/AMR.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"The AMR Package — AMR","text":"cite AMR publications use: Berends MS, Luz CF, Friedrich AW, Sinha BNM, Albers CJ, Glasner C (2022). \"AMR: R Package Working Antimicrobial Resistance Data.\" Journal Statistical Software, 104(3), 1-31. doi:10.18637/jss.v104.i03 BibTeX entry LaTeX users :","code":"@Article{,   title = {{AMR}: An {R} Package for Working with Antimicrobial Resistance Data},   author = {Matthijs S. Berends and Christian F. Luz and Alexander W. Friedrich and Bhanu N. M. Sinha and Casper J. Albers and Corinna Glasner},   journal = {Journal of Statistical Software},   year = {2022},   volume = {104},   number = {3},   pages = {1--31},   doi = {10.18637/jss.v104.i03}, }"},{"path":"https://amr-for-r.org/reference/AMR.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"The AMR Package — AMR","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/AMR.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"The AMR Package — AMR","text":"Maintainer: Matthijs S. Berends m.s.berends@umcg.nl (ORCID) Authors: Dennis Souverein (ORCID) [contributor] Erwin E. . Hassing [contributor] contributors: Aislinn Cook (ORCID) [contributor] Andrew P. Norgan (ORCID) [contributor] Anita Williams (ORCID) [contributor] Annick Lenglet (ORCID) [contributor] Anthony Underwood (ORCID) [contributor] Anton Mymrikov [contributor] Bart C. Meijer [contributor] Christian F. Luz (ORCID) [contributor] Dmytro Mykhailenko [contributor] Eric H. L. C. M. Hazenberg [contributor] Gwen Knight (ORCID) [contributor] Jane Hawkey (ORCID) [contributor] Jason Stull (ORCID) [contributor] Javier Sanchez (ORCID) [contributor] Jonas Salm [contributor] Judith M. Fonville [contributor] Kathryn Holt (ORCID) [contributor] Larisse Bolton (ORCID) [contributor] Matthew Saab [contributor] Natacha Couto (ORCID) [contributor] Peter Dutey-Magni (ORCID) [contributor] Rogier P. Schade [contributor] Sofia Ny (ORCID) [contributor] Alex W. Friedrich (ORCID) [thesis advisor] Bhanu N. M. Sinha (ORCID) [thesis advisor] Casper J. Albers (ORCID) [thesis advisor] Corinna Glasner (ORCID) [thesis advisor]","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":null,"dir":"Reference","previous_headings":"","what":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"antimicrobial drugs official names, ATC codes, ATC groups defined daily dose (DDD) included package, using Collaborating Centre Drug Statistics Methodology.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/WHOCC.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"WHOCC: WHO Collaborating Centre for Drug Statistics Methodology — WHOCC","text":"","code":"as.ab(\"meropenem\") #> Class 'ab' #> [1] MEM ab_name(\"J01DH02\") #> [1] \"Meropenem\"  ab_tradenames(\"flucloxacillin\") #>  [1] \"bactopen\"             \"cloxacap\"             \"cloxacillinhydrate\"   #>  [4] \"cloxypen\"             \"floxacillin\"          \"floxacillinanhydrous\" #>  [7] \"floxapen\"             \"floxapensalt\"         \"fluclomix\"            #> [10] \"flucloxacilina\"       \"flucloxacilline\"      \"flucloxacillinum\"     #> [13] \"flucloxin\"            \"fluorochloroxacillin\" \"galfloxin\"            #> [16] \"latocillin\"           \"orbeninhydrate\"       \"rimaflox\"             #> [19] \"staphobristol\"        \"zoxin\""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 500 Isolates - WHONET Example — WHONET","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"example data set exact structure export file WHONET. files can used package, example data set shows. antimicrobial results example_isolates data set. patient names created using online surname generators place practice purposes.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET"},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"tibble 500 observations 53 variables: Identification number ID sample Specimen number ID specimen Organism Name microorganism. analysis, transform valid microbial class, using .mo(). Country Country origin Laboratory Name laboratory Last name Fictitious last name patient First name Fictitious initial patient Sex Fictitious gender patient Age Fictitious age patient Age category Age group, can also looked using age_groups() Date admissionDate hospital admission Specimen dateDate specimen received laboratory Specimen type Specimen type group Specimen type (Numeric) Translation \"Specimen type\" Reason Reason request Differential Diagnosis Isolate number ID isolate Organism type Type microorganism, can also looked using mo_type() Serotype Serotype microorganism Beta-lactamase Microorganism produces beta-lactamase? ESBL Microorganism produces extended spectrum beta-lactamase? Carbapenemase Microorganism produces carbapenemase? MRSA screening test Microorganism possible MRSA? Inducible clindamycin resistance Clindamycin can induced? Comment comments Date data entryDate data entered WHONET AMP_ND10:CIP_EE 28 different antimicrobials. can lookup abbreviations antimicrobials data set, use e.g. ab_name(\"AMP\") get official name immediately. analysis, transform valid antimicrobial class, using .sir().","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/WHONET.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 500 Isolates - WHONET Example — WHONET","text":"","code":"WHONET #> # A tibble: 500 × 53 #>    `Identification number` `Specimen number` Organism Country         Laboratory #>    <chr>                               <int> <chr>    <chr>           <chr>      #>  1 fe41d7bafa                           1748 SPN      Belgium         National … #>  2 91f175ec37                           1767 eco      The Netherlands National … #>  3 cc4015056e                           1343 eco      The Netherlands National … #>  4 e864b692f5                           1894 MAP      Denmark         National … #>  5 3d051fe345                           1739 PVU      Belgium         National … #>  6 c80762a08d                           1846 103      The Netherlands National … #>  7 8022d3727c                           1628 103      Denmark         National … #>  8 f3dc5f553d                           1493 eco      The Netherlands National … #>  9 15add38f6c                           1847 eco      France          National … #> 10 fd41248def                           1458 eco      Germany         National … #> # ℹ 490 more rows #> # ℹ 48 more variables: `Last name` <chr>, `First name` <chr>, Sex <chr>, #> #   Age <dbl>, `Age category` <chr>, `Date of admission` <date>, #> #   `Specimen date` <date>, `Specimen type` <chr>, #> #   `Specimen type (Numeric)` <dbl>, Reason <chr>, `Isolate number` <int>, #> #   `Organism type` <chr>, Serotype <chr>, `Beta-lactamase` <lgl>, ESBL <lgl>, #> #   Carbapenemase <lgl>, `MRSA screening test` <lgl>, …"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Use function e.g. clinical texts health care records. returns list antimicrobial drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"ab_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_ab = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_ab type = \"drug\": column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"function also internally used .ab(), although searches first drug name throw note drug names returned. Note: .ab() function may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"default, function search antimicrobial drug names. text elements searched official names, ATC codes brand names. uses .ab() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(abx = ab_from_text(clinical_text)) returned AB codes can transformed official names, groups, etc. ab_* functions ab_name() ab_group(), using translate_ab argument. using collapse, function return character:df %>% mutate(abx = ab_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/ab_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antimicrobial Drug Names and Doses from Clinical Text — ab_from_text","text":"","code":"# mind the bad spelling of amoxicillin in this line, # straight from a true health care record: ab_from_text(\"28/03/2020 regular amoxicilliin 500mg po tid\") #> [[1]] #> Class 'ab' #> [1] AMX #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") #> [[1]] #> Class 'ab' #> [1] AMX CIP #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"dose\") #> [[1]] #> [1] 500 400 #>  ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", type = \"admin\") #> [[1]] #> [1] \"oral\" \"iv\"   #>   ab_from_text(\"500 mg amoxi po and 400mg cipro iv\", collapse = \", \") #> [1] \"AMX, CIP\" # \\donttest{ # if you want to know which antibiotic groups were administered, do e.g.: abx <- ab_from_text(\"500 mg amoxi po and 400mg cipro iv\") ab_group(abx[[1]]) #> [1] \"Beta-lactams/penicillins\" \"Fluoroquinolones\"          if (require(\"dplyr\")) {   tibble(clinical_text = c(     \"given 400mg cipro and 500 mg amox\",     \"started on doxy iv today\"   )) %>%     mutate(       abx_codes = ab_from_text(clinical_text),       abx_doses = ab_from_text(clinical_text, type = \"doses\"),       abx_admin = ab_from_text(clinical_text, type = \"admin\"),       abx_coll = ab_from_text(clinical_text, collapse = \"|\"),       abx_coll_names = ab_from_text(clinical_text,         collapse = \"|\",         translate_ab = \"name\"       ),       abx_coll_doses = ab_from_text(clinical_text,         type = \"doses\",         collapse = \"|\"       ),       abx_coll_admin = ab_from_text(clinical_text,         type = \"admin\",         collapse = \"|\"       )     ) } #> Loading required package: dplyr #>  #> Attaching package: ‘dplyr’ #> The following objects are masked from ‘package:stats’: #>  #>     filter, lag #> The following objects are masked from ‘package:base’: #>  #>     intersect, setdiff, setequal, union #> # A tibble: 2 × 8 #>   clinical_text            abx_codes abx_doses abx_admin abx_coll abx_coll_names #>   <chr>                    <list>    <list>    <list>    <chr>    <chr>          #> 1 given 400mg cipro and 5… <ab [2]>  <dbl [2]> <chr [1]> CIP|AMX  Ciprofloxacin… #> 2 started on doxy iv today <ab [1]>  <dbl [1]> <chr [1]> DOX      Doxycycline    #> # ℹ 2 more variables: abx_coll_doses <chr>, abx_coll_admin <chr> # }"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antibiotic — ab_property","title":"Get Properties of an Antibiotic — ab_property","text":"Use functions return specific property antibiotic antimicrobials data set. input values evaluated internally .ab().","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"ab_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  ab_cid(x, ...)  ab_synonyms(x, ...)  ab_tradenames(x, ...)  ab_group(x, language = get_AMR_locale(), ...)  ab_atc(x, only_first = FALSE, ...)  ab_atc_group1(x, language = get_AMR_locale(), ...)  ab_atc_group2(x, language = get_AMR_locale(), ...)  ab_loinc(x, ...)  ab_ddd(x, administration = \"oral\", ...)  ab_ddd_units(x, administration = \"oral\", ...)  ab_info(x, language = get_AMR_locale(), ...)  ab_url(x, open = FALSE, ...)  ab_property(x, property = \"name\", language = get_AMR_locale(), ...)  set_ab_names(data, ..., property = \"name\", language = get_AMR_locale(),   snake_case = NULL)"},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antibiotic — ab_property","text":"x (vector ) text can coerced valid antibiotic drug code .ab(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. lead e.g. \"polymyxin B\" \"polymyxin b\". ... case set_ab_names() data data.frame: columns select (supports tidy selection column1:column4), otherwise arguments passed .ab(). only_first logical indicate whether first ATC code must returned, giving preference J0-codes (.e., antimicrobial drug group). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antimicrobials data set: vector_or(colnames(antimicrobials), sort = FALSE). data data.frame columns need renamed, character vector column names. snake_case logical indicate whether names -called snake case: lower case spaces/slashes replaced underscore (_).","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antibiotic — ab_property","text":"integer case ab_cid() named list case ab_info() multiple ab_atc()/ab_synonyms()/ab_tradenames() double case ab_ddd() data.frame case set_ab_names() character cases","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antibiotic — ab_property","text":"output translated possible. function ab_url() return direct URL official website. warning returned required ATC code available. function set_ab_names() special column renaming function data.frames. renames columns names resemble antimicrobial drugs. always makes sure new column names unique. property = \"atc\" set, preference given ATC codes J-group.","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antibiotic — ab_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antibiotic — ab_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/ab_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antibiotic — ab_property","text":"","code":"# all properties: ab_name(\"AMX\") #> [1] \"Amoxicillin\" ab_atc(\"AMX\") #> [1] \"J01CA04\"  \"QG51AA03\" \"QJ01CA04\" ab_cid(\"AMX\") #> [1] 33613 ab_synonyms(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_tradenames(\"AMX\") #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           ab_group(\"AMX\") #> [1] \"Beta-lactams/penicillins\" ab_atc_group1(\"AMX\") #> [1] \"Beta-lactam antibacterials, penicillins\" ab_atc_group2(\"AMX\") #> [1] \"Penicillins with extended spectrum\" ab_url(\"AMX\") #>                                                             Amoxicillin  #> \"https://atcddd.fhi.no/atc_ddd_index//?code=J01CA04&showdescription=no\"   # smart lowercase transformation ab_name(x = c(\"AMC\", \"PLB\")) #> [1] \"Amoxicillin/clavulanic acid\" \"Polymyxin B\"                 ab_name(x = c(\"AMC\", \"PLB\"), tolower = TRUE) #> [1] \"amoxicillin/clavulanic acid\" \"polymyxin B\"                  # defined daily doses (DDD) ab_ddd(\"AMX\", \"oral\") #> [1] 1.5 ab_ddd_units(\"AMX\", \"oral\") #> [1] \"g\" ab_ddd(\"AMX\", \"iv\") #> [1] 3 ab_ddd_units(\"AMX\", \"iv\") #> [1] \"g\"  ab_info(\"AMX\") # all properties as a list #> $ab #> [1] \"AMX\" #>  #> $cid #> [1] 33613 #>  #> $name #> [1] \"Amoxicillin\" #>  #> $group #> [1] \"Beta-lactams/penicillins\" #>  #> $atc #> [1] \"J01CA04\"  \"QG51AA03\" \"QJ01CA04\" #>  #> $atc_group1 #> [1] \"Beta-lactam antibacterials, penicillins\" #>  #> $atc_group2 #> [1] \"Penicillins with extended spectrum\" #>  #> $tradenames #>  [1] \"acuotricina\"     \"alfamox\"         \"alfida\"          \"amitron\"         #>  [5] \"amoclen\"         \"amodex\"          \"amoksicillin\"    \"amolin\"          #>  [9] \"amopen\"          \"amopenixin\"      \"amophar\"         \"amoran\"          #> [13] \"amoxi\"           \"amoxicaps\"       \"amoxicilina\"     \"amoxicilline\"    #> [17] \"amoxicillinum\"   \"amoxidal\"        \"amoxiden\"        \"amoxil\"          #> [21] \"amoxillat\"       \"amoxina\"         \"amoxine\"         \"amoxipen\"        #> [25] \"amoxivet\"        \"amoxycillin\"     \"amoxycillinsalt\" \"amoxyke\"         #> [29] \"anemolin\"        \"aspenil\"         \"atoksilin\"       \"bristamox\"       #> [33] \"cemoxin\"         \"ciblor\"          \"clamoxyl\"        \"damoxy\"          #> [37] \"danoxillin\"      \"delacillin\"      \"demoksil\"        \"dispermox\"       #> [41] \"efpenix\"         \"eupen\"           \"flemoxin\"        \"flemoxine\"       #> [45] \"galenamox\"       \"gramidil\"        \"hiconcil\"        \"himinomax\"       #> [49] \"histocillin\"     \"ibiamox\"         \"imacillin\"       \"izoltil\"         #> [53] \"kentrocyllin\"    \"lamoxy\"          \"largopen\"        \"larotid\"         #> [57] \"matasedrin\"      \"metifarma\"       \"moksilin\"        \"moxacin\"         #> [61] \"moxal\"           \"moxaline\"        \"moxatag\"         \"neotetranase\"    #> [65] \"novabritine\"     \"ospamox\"         \"pacetocin\"       \"pamocil\"         #> [69] \"paradroxil\"      \"pasetocin\"       \"penamox\"         \"piramox\"         #> [73] \"promoxil\"        \"quimiopen\"       \"remoxil\"         \"riotapen\"        #> [77] \"robamox\"         \"sawacillin\"      \"siganopen\"       \"simplamox\"       #> [81] \"sintopen\"        \"sumox\"           \"topramoxin\"      \"trifamox\"        #> [85] \"trimox\"          \"unicillin\"       \"utimox\"          \"velamox\"         #> [89] \"vetramox\"        \"wymox\"           \"zamocillin\"      \"zamocilline\"     #> [93] \"zimox\"           #>  #> $loinc #>  [1] \"101498-4\" \"15-8\"     \"16-6\"     \"16365-9\"  \"17-4\"     \"18-2\"     #>  [7] \"18861-5\"  \"18862-3\"  \"19-0\"     \"20-8\"     \"21-6\"     \"22-4\"     #> [13] \"25274-2\"  \"25310-4\"  \"3344-9\"   \"55614-2\"  \"55615-9\"  \"55616-7\"  #> [19] \"6976-5\"   \"6977-3\"   \"80133-2\"  #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 1.5 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 3 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all ab_* functions use as.ab() internally, so you can go from 'any' to 'any': ab_atc(\"AMP\") #> [1] \"J01CA01\"  \"QJ01CA01\" \"QJ51CA01\" \"QS01AA19\" \"S01AA19\"  ab_group(\"J01CA01\") #> [1] \"Beta-lactams/penicillins\" ab_loinc(\"ampicillin\") #>  [1] \"101477-8\" \"101478-6\" \"18864-9\"  \"18865-6\"  \"20374-5\"  \"21066-6\"  #>  [7] \"23618-2\"  \"27-3\"     \"28-1\"     \"29-9\"     \"30-7\"     \"31-5\"     #> [13] \"32-3\"     \"33-1\"     \"3355-5\"   \"33562-0\"  \"33919-2\"  \"34-9\"     #> [19] \"43883-8\"  \"43884-6\"  \"6979-9\"   \"6980-7\"   \"87604-5\"  ab_name(\"21066-6\") #> [1] \"Ampicillin\" ab_name(6249) #> [1] \"Ampicillin\" ab_name(\"J01CA01\") #> [1] \"Ampicillin\"  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") #> [1] \"J01DD04\"  \"QJ01DD04\"  # use set_ab_names() for renaming columns colnames(example_isolates) #>  [1] \"date\"    \"patient\" \"age\"     \"gender\"  \"ward\"    \"mo\"      \"PEN\"     #>  [8] \"OXA\"     \"FLC\"     \"AMX\"     \"AMC\"     \"AMP\"     \"TZP\"     \"CZO\"     #> [15] \"FEP\"     \"CXM\"     \"FOX\"     \"CTX\"     \"CAZ\"     \"CRO\"     \"GEN\"     #> [22] \"TOB\"     \"AMK\"     \"KAN\"     \"TMP\"     \"SXT\"     \"NIT\"     \"FOS\"     #> [29] \"LNZ\"     \"CIP\"     \"MFX\"     \"VAN\"     \"TEC\"     \"TCY\"     \"TGC\"     #> [36] \"DOX\"     \"ERY\"     \"CLI\"     \"AZM\"     \"IPM\"     \"MEM\"     \"MTR\"     #> [43] \"CHL\"     \"COL\"     \"MUP\"     \"RIF\"     colnames(set_ab_names(example_isolates)) #>  [1] \"date\"                          \"patient\"                       #>  [3] \"age\"                           \"gender\"                        #>  [5] \"ward\"                          \"mo\"                            #>  [7] \"benzylpenicillin\"              \"oxacillin\"                     #>  [9] \"flucloxacillin\"                \"amoxicillin\"                   #> [11] \"amoxicillin_clavulanic_acid\"   \"ampicillin\"                    #> [13] \"piperacillin_tazobactam\"       \"cefazolin\"                     #> [15] \"cefepime\"                      \"cefuroxime\"                    #> [17] \"cefoxitin\"                     \"cefotaxime\"                    #> [19] \"ceftazidime\"                   \"ceftriaxone\"                   #> [21] \"gentamicin\"                    \"tobramycin\"                    #> [23] \"amikacin\"                      \"kanamycin\"                     #> [25] \"trimethoprim\"                  \"trimethoprim_sulfamethoxazole\" #> [27] \"nitrofurantoin\"                \"fosfomycin\"                    #> [29] \"linezolid\"                     \"ciprofloxacin\"                 #> [31] \"moxifloxacin\"                  \"vancomycin\"                    #> [33] \"teicoplanin\"                   \"tetracycline\"                  #> [35] \"tigecycline\"                   \"doxycycline\"                   #> [37] \"erythromycin\"                  \"clindamycin\"                   #> [39] \"azithromycin\"                  \"imipenem\"                      #> [41] \"meropenem\"                     \"metronidazole\"                 #> [43] \"chloramphenicol\"               \"colistin\"                      #> [45] \"mupirocin\"                     \"rifampicin\"                    colnames(set_ab_names(example_isolates, NIT:VAN)) #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     set_ab_names()    # this does the same:   example_isolates %>%     rename_with(set_ab_names)    # set_ab_names() works with any AB property:   example_isolates %>%     set_ab_names(property = \"atc\")    example_isolates %>%     set_ab_names(where(is.sir)) %>%     colnames()    example_isolates %>%     set_ab_names(NIT:VAN) %>%     colnames() } #>  [1] \"date\"           \"patient\"        \"age\"            \"gender\"         #>  [5] \"ward\"           \"mo\"             \"PEN\"            \"OXA\"            #>  [9] \"FLC\"            \"AMX\"            \"AMC\"            \"AMP\"            #> [13] \"TZP\"            \"CZO\"            \"FEP\"            \"CXM\"            #> [17] \"FOX\"            \"CTX\"            \"CAZ\"            \"CRO\"            #> [21] \"GEN\"            \"TOB\"            \"AMK\"            \"KAN\"            #> [25] \"TMP\"            \"SXT\"            \"nitrofurantoin\" \"fosfomycin\"     #> [29] \"linezolid\"      \"ciprofloxacin\"  \"moxifloxacin\"   \"vancomycin\"     #> [33] \"TEC\"            \"TCY\"            \"TGC\"            \"DOX\"            #> [37] \"ERY\"            \"CLI\"            \"AZM\"            \"IPM\"            #> [41] \"MEM\"            \"MTR\"            \"CHL\"            \"COL\"            #> [45] \"MUP\"            \"RIF\"            # }"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Antimicrobials — add_custom_antimicrobials","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"add_custom_antimicrobials() can add custom antimicrobial drug names codes.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"add_custom_antimicrobials(x)  clear_custom_antimicrobials()"},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"x data.frame resembling antimicrobials data set, least containing columns \"ab\" \"name\".","code":""},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"Important: Due R works, add_custom_antimicrobials() function run every R session - added antimicrobials stored sessions thus lost R exited. two ways circumvent automate process adding antimicrobials: Method 1: Using package option AMR_custom_ab, preferred method. use method: Create data set structure antimicrobials data set (containing least columns \"ab\" \"name\") save saveRDS() location choice, e.g. \"~/my_custom_ab.rds\", remote location. Set file location package option AMR_custom_ab: options(AMR_custom_ab = \"~/my_custom_ab.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_antimicrobials() function. Method 2: Loading antimicrobial additions directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_antimicrobials() clear previously added antimicrobials.","code":"# Add custom antimicrobial codes: options(AMR_custom_ab = \"~/my_custom_ab.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_antimicrobials(    data.frame(ab = \"TESTAB\",               name = \"Test Antibiotic\",               group = \"Test Group\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Antimicrobials — add_custom_antimicrobials","text":"","code":"# \\donttest{ # returns a wildly guessed result: as.ab(\"testab\") #> Class 'ab' #> [1] THA  # now add a custom entry - it will be considered by as.ab() and # all ab_*() functions add_custom_antimicrobials(   data.frame(     ab = \"TESTAB\",     name = \"Test Antibiotic\",     # you can add any property present in the     # 'antimicrobials' data set, such as 'group':     group = \"Test Group\"   ) ) #> ℹ Added one record to the internal `antimicrobials` data set.  # \"testab\" is now a new antibiotic: as.ab(\"testab\") #> Class 'ab' #> [1] TESTAB ab_name(\"testab\") #> [1] \"Test Antibiotic\" ab_group(\"testab\") #> [1] \"Test Group\"  ab_info(\"testab\") #> $ab #> [1] \"TESTAB\" #>  #> $cid #> [1] NA #>  #> $name #> [1] \"Test Antibiotic\" #>  #> $group #> [1] \"Test Group\" #>  #> $atc #> [1] NA #>  #> $atc_group1 #> [1] NA #>  #> $atc_group2 #> [1] NA #>  #> $tradenames #> [1] NA #>  #> $loinc #> [1] NA #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] NA #>  #> $ddd$oral$units #> [1] NA #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] NA #>  #> $ddd$iv$units #> [1] NA #>  #>  #>    # Add Co-fluampicil, which is one of the many J01CR50 codes, see # https://atcddd.fhi.no/ddd/list_of_ddds_combined_products/ add_custom_antimicrobials(   data.frame(     ab = \"COFLU\",     name = \"Co-fluampicil\",     atc = \"J01CR50\",     group = \"Beta-lactams/penicillins\"   ) ) #> ℹ Added one record to the internal `antimicrobials` data set. ab_atc(\"Co-fluampicil\") #> [1] \"J01CR50\" ab_name(\"J01CR50\") #> [1] \"Co-fluampicil\"  # even antimicrobial selectors work # see ?amr_selector x <- data.frame(   random_column = \"some value\",   coflu = as.sir(\"S\"),   ampicillin = as.sir(\"R\") ) x #>   random_column coflu ampicillin #> 1    some value     S          R x[, betalactams()] #> ℹ For `betalactams()` using columns 'coflu' (co-fluampicil) and #>   'ampicillin' #>   coflu ampicillin #> 1     S          R # }"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Custom Microorganisms — add_custom_microorganisms","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"add_custom_microorganisms() can add custom microorganisms, non-taxonomic outcome laboratory analysis.","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"add_custom_microorganisms(x)  clear_custom_microorganisms()"},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"x data.frame resembling microorganisms data set, least containing column \"genus\" (case-insensitive).","code":""},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"function fill missing taxonomy , specific taxonomic columns missing, see Examples. Important: Due R works, add_custom_microorganisms() function run every R session - added microorganisms stored sessions thus lost R exited. two ways circumvent automate process adding microorganisms: Method 1: Using package option AMR_custom_mo, preferred method. use method: Create data set structure microorganisms data set (containing least column \"genus\") save saveRDS() location choice, e.g. \"~/my_custom_mo.rds\", remote location. Set file location package option AMR_custom_mo: options(AMR_custom_mo = \"~/my_custom_mo.rds\"). can even remote file location, https URL. Since options saved R sessions, best save option .Rprofile file loaded start-R. , open .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"), add text save file:   Upon package load, file loaded run add_custom_microorganisms() function. Method 2: Loading microorganism directly .Rprofile file. Note definitions stored user-specific R file, suboptimal workflow. use method: Edit .Rprofile file using e.g. utils::file.edit(\"~/.Rprofile\"). Add text like save file:   Use clear_custom_microorganisms() clear previously added microorganisms.","code":"# Add custom microorganism codes: options(AMR_custom_mo = \"~/my_custom_mo.rds\") # Add custom antibiotic drug codes:  AMR::add_custom_microorganisms(    data.frame(genus = \"Enterobacter\",               species = \"asburiae/cloacae\")  )"},{"path":[]},{"path":"https://amr-for-r.org/reference/add_custom_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add Custom Microorganisms — add_custom_microorganisms","text":"","code":"# \\donttest{ # a combination of species is not formal taxonomy, so # this will result in \"Enterobacter cloacae cloacae\", # since it resembles the input best: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae\"  # now add a custom entry - it will be considered by as.mo() and # all mo_*() functions add_custom_microorganisms(   data.frame(     genus = \"Enterobacter\",     species = \"asburiae/cloacae\"   ) ) #> ℹ Added Enterobacter asburiae/cloacae to the internal `microorganisms` data #>   set.  # E. asburiae/cloacae is now a new microorganism: mo_name(\"Enterobacter asburiae/cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # its code: as.mo(\"Enterobacter asburiae/cloacae\") #> Class 'mo' #> [1] CUSTOM1_ENTRB_ASB/  # all internal algorithms will work as well: mo_name(\"Ent asburia cloacae\") #> [1] \"Enterobacter asburiae/cloacae\"  # and even the taxonomy was added based on the genus! mo_family(\"E. asburiae/cloacae\") #> [1] \"Enterobacteriaceae\" mo_gramstain(\"Enterobacter asburiae/cloacae\") #> [1] \"Gram-negative\"  mo_info(\"Enterobacter asburiae/cloacae\") #> $mo #> [1] \"CUSTOM1_ENTRB_ASB/\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Enterobacter\" #>  #> $species #> [1] \"asburiae/cloacae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] NA #>  #> $url #> [1] \"\" #>  #> $ref #> [1] \"Self-added, 2025\" #>  #> $snomed #> [1] NA #>  #> $lpsn #> [1] NA #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] NA #>  #> $group_members #> character(0) #>    # the function tries to be forgiving: add_custom_microorganisms(   data.frame(     GENUS = \"BACTEROIDES / PARABACTEROIDES SLASHLINE\",     SPECIES = \"SPECIES\"   ) ) #> ℹ Added Bacteroides/Parabacteroides to the internal `microorganisms` data #>   set. mo_name(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"Bacteroides/Parabacteroides\" mo_rank(\"BACTEROIDES / PARABACTEROIDES\") #> [1] \"genus\"  # taxonomy still works, even though a slashline genus was given as input: mo_family(\"Bacteroides/Parabacteroides\") #> [1] \"Bacteroidaceae\"   # for groups and complexes, set them as species or subspecies: add_custom_microorganisms(   data.frame(     genus = \"Citrobacter\",     species = c(\"freundii\", \"braakii complex\"),     subspecies = c(\"complex\", \"\")   ) ) #> ℹ Added Citrobacter braakii complex and Citrobacter freundii complex to the #>   internal `microorganisms` data set. mo_name(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Citrobacter freundii complex\" \"Citrobacter braakii complex\"  mo_species(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"freundii complex\" \"braakii complex\"  mo_gramstain(c(\"C. freundii complex\", \"C. braakii complex\")) #> [1] \"Gram-negative\" \"Gram-negative\" # }"},{"path":"https://amr-for-r.org/reference/age.html","id":null,"dir":"Reference","previous_headings":"","what":"Age in Years of Individuals — age","title":"Age in Years of Individuals — age","text":"Calculates age years based reference date, system date default.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Age in Years of Individuals — age","text":"","code":"age(x, reference = Sys.Date(), exact = FALSE, na.rm = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/age.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Age in Years of Individuals — age","text":"x Date(s), character (vectors) coerced .POSIXlt(). reference Reference date(s) (default today), character (vectors) coerced .POSIXlt(). exact logical indicate whether age calculation exact, .e. decimals. divides number days year--date (YTD) x number days year reference (either 365 366). na.rm logical indicate whether missing values removed. ... Arguments passed .POSIXlt(), origin.","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Age in Years of Individuals — age","text":"integer (decimals) exact = FALSE, double (decimals) otherwise","code":""},{"path":"https://amr-for-r.org/reference/age.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Age in Years of Individuals — age","text":"Ages 0 returned NA warning. Ages 120 give warning. function vectorises x reference, meaning either can length 1 argument larger length.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Age in Years of Individuals — age","text":"","code":"# 10 random pre-Y2K birth dates df <- data.frame(birth_date = as.Date(\"2000-01-01\") - runif(10) * 25000)  # add ages df$age <- age(df$birth_date)  # add exact ages df$age_exact <- age(df$birth_date, exact = TRUE)  # add age at millenium switch df$age_at_y2k <- age(df$birth_date, \"2000-01-01\")  df #>    birth_date age age_exact age_at_y2k #> 1  1980-02-27  45  45.40000         19 #> 2  1953-07-26  71  71.99178         46 #> 3  1949-09-02  75  75.88767         50 #> 4  1986-08-03  38  38.96986         13 #> 5  1932-11-19  92  92.67397         67 #> 6  1949-03-30  76  76.31507         50 #> 7  1996-06-23  29  29.08219          3 #> 8  1963-09-16  61  61.84932         36 #> 9  1952-05-16  73  73.18630         47 #> 10 1952-11-14  72  72.68767         47"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Split Ages into Age Groups — age_groups","title":"Split Ages into Age Groups — age_groups","text":"Split ages age groups defined split argument. allows easier demographic (antimicrobial resistance) analysis. function returns ordered factor.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Split Ages into Age Groups — age_groups","text":"","code":"age_groups(x, split_at = c(0, 12, 25, 55, 75), names = NULL,   na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Split Ages into Age Groups — age_groups","text":"x Age, e.g. calculated age(). split_at Values split x - default age groups 0-11, 12-24, 25-54, 55-74 75+. See Details. names Optional names given various age groups. na.rm logical indicate whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Split Ages into Age Groups — age_groups","text":"Ordered factor","code":""},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Split Ages into Age Groups — age_groups","text":"split ages, input split_at argument can : numeric vector. value e.g. c(10, 20) split x 0-9, 10-19 20+. value 50 split x 0-49 50+. default split young children (0-11), youth (12-24), young adults (25-54), middle-aged adults (55-74) elderly (75+). character: \"children\" \"kids\", equivalent : c(0, 1, 2, 4, 6, 13, 18). split 0, 1, 2-3, 4-5, 6-12, 13-17 18+. \"elderly\" \"seniors\", equivalent : c(65, 75, 85). split 0-64, 65-74, 75-84, 85+. \"fives\", equivalent : 1:20 * 5. split 0-4, 5-9, ..., 95-99, 100+. \"tens\", equivalent : 1:10 * 10. split 0-9, 10-19, ..., 90-99, 100+.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/age_groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Split Ages into Age Groups — age_groups","text":"","code":"ages <- c(3, 8, 16, 54, 31, 76, 101, 43, 21)  # split into 0-49 and 50+ age_groups(ages, 50) #> [1] 0-49 0-49 0-49 50+  0-49 50+  50+  0-49 0-49 #> Levels: 0-49 < 50+  # split into 0-19, 20-49 and 50+ age_groups(ages, c(20, 50)) #> [1] 0-19  0-19  0-19  50+   20-49 50+   50+   20-49 20-49 #> Levels: 0-19 < 20-49 < 50+ age_groups(ages, c(20, 50), names = c(\"Under 20 years\", \"20 to 50 years\", \"Over 50 years\")) #> [1] Under 20 years Under 20 years Under 20 years Over 50 years  20 to 50 years #> [6] Over 50 years  Over 50 years  20 to 50 years 20 to 50 years #> Levels: Under 20 years < 20 to 50 years < Over 50 years  # split into groups of ten years age_groups(ages, 1:10 * 10) #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+ age_groups(ages, split_at = \"tens\") #> [1] 0-9   0-9   10-19 50-59 30-39 70-79 100+  40-49 20-29 #> 11 Levels: 0-9 < 10-19 < 20-29 < 30-39 < 40-49 < 50-59 < 60-69 < ... < 100+  # split into groups of five years age_groups(ages, 1:20 * 5) #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+ age_groups(ages, split_at = \"fives\") #> [1] 0-4   5-9   15-19 50-54 30-34 75-79 100+  40-44 20-24 #> 21 Levels: 0-4 < 5-9 < 10-14 < 15-19 < 20-24 < 25-29 < 30-34 < ... < 100+  # split specifically for children age_groups(ages, c(1, 2, 4, 6, 13, 18)) #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+ age_groups(ages, \"children\") #> [1] 2-3   6-12  13-17 18+   18+   18+   18+   18+   18+   #> Levels: 0 < 1 < 2-3 < 4-5 < 6-12 < 13-17 < 18+  # \\donttest{ # resistance of ciprofloxacin per age group if (require(\"dplyr\") && require(\"ggplot2\")) {   example_isolates %>%     filter_first_isolate() %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(       x = \"age_group\",       minimum = 0,       x.title = \"Age Group\",       title = \"Ciprofloxacin resistance per age group\"     ) } #> Loading required package: ggplot2  # }"},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":null,"dir":"Reference","previous_headings":"","what":"AMR Extensions for Tidymodels — amr-tidymodels","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"family functions allows using AMR-specific data types <mic> <sir> inside tidymodels pipelines.","code":""},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"","code":"all_mic()  all_mic_predictors()  all_sir()  all_sir_predictors()  step_mic_log2(recipe, ..., role = NA, trained = FALSE, columns = NULL,   skip = FALSE, id = recipes::rand_id(\"mic_log2\"))  step_sir_numeric(recipe, ..., role = NA, trained = FALSE, columns = NULL,   skip = FALSE, id = recipes::rand_id(\"sir_numeric\"))"},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"recipe recipe object. step added sequence operations recipe. ... One selector functions choose variables step. See selections() details. role used step since new variables created. trained logical indicate quantities preprocessing estimated. skip logical. step skipped recipe baked bake()? operations baked prep() run, operations may able conducted new data (e.g. processing outcome variable(s)). Care taken using skip = TRUE may affect computations subsequent operations. id character string unique step identify .","code":""},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"can read online AMR tidymodels introduction. Tidyselect helpers include: all_mic() all_mic_predictors() select <mic> columns all_sir() all_sir_predictors() select <sir> columns Pre-processing pipeline steps include: step_mic_log2() convert MIC columns numeric (via .numeric()) apply log2 transform, used all_mic_predictors() step_sir_numeric() convert SIR columns numeric (via .numeric()), used all_sir_predictors(): \"S\" = 1, \"\"/\"SDD\" = 2, \"R\" = 3. values rendered NA. Keep mind processing, especially model allow NA values. steps integrate recipes::recipe() work like standard preprocessing steps. useful preparing data modelling, especially classification models.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/amr-tidymodels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"AMR Extensions for Tidymodels — amr-tidymodels","text":"","code":"if (require(\"tidymodels\")) {    # The below approach formed the basis for this paper: DOI 10.3389/fmicb.2025.1582703   # Presence of ESBL genes was predicted based on raw MIC values.     # example data set in the AMR package   esbl_isolates    # Prepare a binary outcome and convert to ordered factor   data <- esbl_isolates %>%     mutate(esbl = factor(esbl, levels = c(FALSE, TRUE), ordered = TRUE))    # Split into training and testing sets   split <- initial_split(data)   training_data <- training(split)   testing_data <- testing(split)    # Create and prep a recipe with MIC log2 transformation   mic_recipe <- recipe(esbl ~ ., data = training_data) %>%      # Optionally remove non-predictive variables     remove_role(genus, old_role = \"predictor\") %>%      # Apply the log2 transformation to all MIC predictors     step_mic_log2(all_mic_predictors()) %>%      # And apply the preparation steps     prep()    # View prepped recipe   mic_recipe    # Apply the recipe to training and testing data   out_training <- bake(mic_recipe, new_data = NULL)   out_testing <- bake(mic_recipe, new_data = testing_data)    # Fit a logistic regression model   fitted <- logistic_reg(mode = \"classification\") %>%     set_engine(\"glm\") %>%     fit(esbl ~ ., data = out_training)    # Generate predictions on the test set   predictions <- predict(fitted, out_testing) %>%     bind_cols(out_testing)    # Evaluate predictions using standard classification metrics   our_metrics <- metric_set(accuracy, kap, ppv, npv)   metrics <- our_metrics(predictions, truth = esbl, estimate = .pred_class)    # Show performance   metrics } #> Loading required package: tidymodels #> ── Attaching packages ────────────────────────────────────── tidymodels 1.3.0 ── #> ✔ broom        1.0.8     ✔ rsample      1.3.0 #> ✔ dials        1.4.0     ✔ tibble       3.3.0 #> ✔ infer        1.0.9     ✔ tidyr        1.3.1 #> ✔ modeldata    1.4.0     ✔ tune         1.3.0 #> ✔ parsnip      1.3.2     ✔ workflows    1.2.0 #> ✔ purrr        1.1.0     ✔ workflowsets 1.1.1 #> ✔ recipes      1.3.1     ✔ yardstick    1.3.2 #> ── Conflicts ───────────────────────────────────────── tidymodels_conflicts() ── #> ✖ purrr::discard() masks scales::discard() #> ✖ dplyr::filter()  masks stats::filter() #> ✖ dplyr::lag()     masks stats::lag() #> ✖ recipes::step()  masks stats::step() #> Warning: glm.fit: fitted probabilities numerically 0 or 1 occurred #> # A tibble: 4 × 3 #>   .metric  .estimator .estimate #>   <chr>    <chr>          <dbl> #> 1 accuracy binary         0.936 #> 2 kap      binary         0.872 #> 3 ppv      binary         0.925 #> 4 npv      binary         0.948"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Create detailed antibiograms options traditional, combination, syndromic, Bayesian WISCA methods. Adhering previously described approaches (see Source) especially Bayesian WISCA model (Weighted-Incidence Syndromic Combination Antibiogram) Bielicki et al., functions provide flexible output formats including plots tables, ideal integration R Markdown Quarto reports.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"antibiogram(x, antimicrobials = where(is.sir), mo_transform = \"shortname\",   ab_transform = \"name\", syndromic_group = NULL, add_total_n = FALSE,   only_all_tested = FALSE, digits = ifelse(wisca, 1, 0),   formatting_type = getOption(\"AMR_antibiogram_formatting_type\",   ifelse(wisca, 14, 18)), col_mo = NULL, language = get_AMR_locale(),   minimum = 30, combine_SI = TRUE, sep = \" + \", sort_columns = TRUE,   wisca = FALSE, simulations = 1000, conf_interval = 0.95,   interval_side = \"two-tailed\", info = interactive(), ...)  wisca(x, antimicrobials = where(is.sir), ab_transform = \"name\",   syndromic_group = NULL, only_all_tested = FALSE, digits = 1,   formatting_type = getOption(\"AMR_antibiogram_formatting_type\", 14),   col_mo = NULL, language = get_AMR_locale(), combine_SI = TRUE,   sep = \" + \", sort_columns = TRUE, simulations = 1000,   conf_interval = 0.95, interval_side = \"two-tailed\",   info = interactive(), ...)  retrieve_wisca_parameters(wisca_model, ...)  # S3 method for class 'antibiogram' plot(x, ...)  # S3 method for class 'antibiogram' autoplot(object, ...)  # S3 method for class 'antibiogram' knit_print(x, italicise = TRUE,   na = getOption(\"knitr.kable.NA\", default = \"\"), ...)"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Bielicki JA et al. (2016). Selecting appropriate empirical antibiotic regimens paediatric bloodstream infections: application Bayesian decision model local pooled antimicrobial resistance surveillance data Journal Antimicrobial Chemotherapy 71(3); doi:10.1093/jac/dkv397 Bielicki JA et al. (2020). Evaluation coverage 3 antibiotic regimens neonatal sepsis hospital setting across Asian countries JAMA Netw Open. 3(2):e1921124; doi:10.1001/jamanetworkopen.2019.21124 Klinker KP et al. (2021). Antimicrobial stewardship antibiograms: importance moving beyond traditional antibiograms. Therapeutic Advances Infectious Disease, May 5;8:20499361211011373; doi:10.1177/20499361211011373 Barbieri E et al. (2021). Development Weighted-Incidence Syndromic Combination Antibiogram (WISCA) guide choice empiric antibiotic treatment urinary tract infection paediatric patients: Bayesian approach Antimicrobial Resistance & Infection Control May 1;10(1):74; doi:10.1186/s13756-021-00939-2 M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"x data.frame containing least column microorganisms columns antimicrobial results (class 'sir', see .sir()). antimicrobials vector specifying antimicrobials containing SIR values include antibiogram (see Examples). evaluated using guess_ab_col(). can : antimicrobial name code match (see guess_ab_col()) column x antimicrobial selector, aminoglycosides() carbapenems() combination , using c(), e.g.: c(aminoglycosides(), \"AMP\", \"AMC\") c(aminoglycosides(), carbapenems()) Column indices using numbers Combination therapy, indicated using \"+\", without antimicrobial selectors, e.g.: \"cipro + genta\" \"TZP+TOB\" c(\"TZP\", \"TZP+GEN\", \"TZP+TOB\") carbapenems() + \"GEN\" carbapenems() + c(\"\", \"GEN\") carbapenems() + c(\"\", aminoglycosides()) mo_transform character transform microorganism input - must \"name\", \"shortname\" (default), \"gramstain\", one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Can also NULL transform input NA consider microorganisms 'unknown'. ab_transform character transform antimicrobial input - must one column names antimicrobials data set (defaults \"name\"): \"ab\", \"cid\", \"name\", \"group\", \"atc\", \"atc_group1\", \"atc_group2\", \"abbreviations\", \"synonyms\", \"oral_ddd\", \"oral_units\", \"iv_ddd\", \"iv_units\", \"loinc\". Can also NULL transform input. syndromic_group column name x, values calculated split rows x, e.g. using ifelse() case_when(). See Examples. add_total_n (deprecated favour formatting_type) logical indicate whether n_tested available numbers per pathogen added table (default TRUE). add lowest highest number available isolates per antimicrobial (e.g, E. coli 200 isolates available ciprofloxacin 150 amoxicillin, returned number \"150-200\"). option unavailable wisca = TRUE; case, use retrieve_wisca_parameters() get parameters used WISCA. only_all_tested (combination antibiograms): logical indicate isolates must tested antimicrobials, see Details. digits Number digits use rounding antimicrobial coverage, defaults 1 WISCA 0 otherwise. formatting_type Numeric value (1–22 WISCA, 1-12 non-WISCA) indicating 'cells' antibiogram table formatted. See Details > Formatting Type list options. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). language Language translate text, defaults system language (see get_AMR_locale()). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether susceptibility determined results either S, SDD, , instead S (default TRUE). sep separating character antimicrobial columns combination antibiograms. sort_columns logical indicate whether antimicrobial columns must sorted name. wisca logical indicate whether Weighted-Incidence Syndromic Combination Antibiogram (WISCA) must generated (default FALSE). use Bayesian decision model estimate regimen coverage probabilities using Monte Carlo simulations. Set simulations, conf_interval, interval_side adjust. simulations (WISCA) numerical value set number Monte Carlo simulations. conf_interval numerical value set confidence interval (default 0.95). interval_side side confidence interval, either \"two-tailed\" (default), \"left\" \"right\". info logical indicate info printed - default TRUE interactive mode. ... used R Markdown Quarto: arguments passed knitr::kable() (otherwise, use). wisca_model outcome wisca() antibiogram(..., wisca = TRUE). object antibiogram() object. italicise logical indicate whether microorganism names knitr table made italic, using italicise_taxonomy(). na Character use showing NA values.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"functions return table values 0 100 susceptibility, resistance. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine one four available algorithms: isolate-based, patient-based, episode-based, phenotype-based. estimating antimicrobial coverage, especially creating WISCA, outcome might become reliable including top n species encountered data. can filter top n using top_n_microorganisms(). example, use top_n_microorganisms(your_data, n = 10) pre-processing step include top 10 species data. numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). ideal e.g. advanced plotting.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"formatting-type","dir":"Reference","previous_headings":"","what":"Formatting Type","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"formatting 'cells' table can set argument formatting_type. examples, 5 indicates antimicrobial coverage (4-6 confidence level), 15 number susceptible isolates, 300 number tested (.e., available) isolates: 5 15 300 15/300 5 (300) 5% (300) 5 (N=300) 5% (N=300) 5 (15/300) 5% (15/300) 5 (N=15/300) 5% (N=15/300) 5 (4-6) 5% (4-6%) - default WISCA 5 (4-6,300) 5% (4-6%,300) 5 (4-6,N=300) 5% (4-6%,N=300) - default non-WISCA 5 (4-6,15/300) 5% (4-6%,15/300) 5 (4-6,N=15/300) 5% (4-6%,N=15/300) default can set globally package option AMR_antibiogram_formatting_type, e.g. options(AMR_antibiogram_formatting_type = 5). note WISCA, total numbers tested susceptible isolates less useful report, since included Bayesian model apparent susceptibility confidence level. Set digits (defaults 0) alter rounding susceptibility percentages.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"antibiogram-types","dir":"Reference","previous_headings":"","what":"Antibiogram Types","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"various antibiogram types, summarised Klinker et al. (2021, doi:10.1177/20499361211011373 ), supported antibiogram(). clinical coverage estimations, use WISCA whenever possible, since provides precise coverage estimates accounting pathogen incidence antimicrobial susceptibility, shown Bielicki et al. (2020, doi:10.1001/jamanetworkopen.2019.21124 ). See section Explaining WISCA page. note WISCA pathogen-agnostic, meaning outcome stratied pathogen, rather syndrome. Traditional Antibiogram Case example: Susceptibility Pseudomonas aeruginosa piperacillin/tazobactam (TZP) Code example:   Combination Antibiogram Case example: Additional susceptibility Pseudomonas aeruginosa TZP + tobramycin versus TZP alone Code example:   Syndromic Antibiogram Case example: Susceptibility Pseudomonas aeruginosa TZP among respiratory specimens (obtained among ICU patients ) Code example:   Weighted-Incidence Syndromic Combination Antibiogram (WISCA) WISCA can applied antibiogram, see section Explaining WISCA page information. Code example:   WISCA uses sophisticated Bayesian decision model combine local pooled antimicrobial resistance data. approach evaluates local patterns can also draw multi-centre datasets improve regimen accuracy, even low-incidence infections like paediatric bloodstream infections (BSIs).","code":"antibiogram(your_data,             antimicrobials = \"TZP\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\")) antibiogram(your_data,             antimicrobials = penicillins(),             syndromic_group = \"ward\") antibiogram(your_data,             antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),             wisca = TRUE)  # this is equal to: wisca(your_data,       antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"grouped-tibbles","dir":"Reference","previous_headings":"","what":"Grouped tibbles","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"type antibiogram, grouped tibbles can also used calculate susceptibilities various groups. Code example:","code":"library(dplyr) your_data %>%   group_by(has_sepsis, is_neonate, sex) %>%   wisca(antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"))"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"stepped-approach-for-clinical-insight","dir":"Reference","previous_headings":"","what":"Stepped Approach for Clinical Insight","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"clinical practice, antimicrobial coverage decisions evolve microbiological data becomes available. theoretical stepped approach ensures empirical coverage can continuously assessed improve patient outcomes: Initial Empirical Therapy (Admission / Pre-Culture Data) admission, pathogen information available. Action: broad-spectrum coverage based local resistance patterns syndromic antibiograms. Using pathogen-agnostic yet incidence-weighted WISCA preferred. Code example:   Refinement Gram Stain Results blood culture becomes positive, Gram stain provides initial crucial first stratification (Gram-positive vs. Gram-negative). Action: narrow coverage based Gram stain-specific resistance patterns. Code example:   Definitive Therapy Based Species Identification cultivation pathogen, full pathogen identification allows precise targeting therapy. Action: adjust treatment pathogen-specific antibiograms, minimizing resistance risks. Code example:   structuring antibiograms around stepped approach, clinicians can make data-driven adjustments stage, ensuring optimal empirical targeted therapy reducing unnecessary broad-spectrum antimicrobial use.","code":"antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = NA) # all pathogens set to `NA`  # preferred: use WISCA wisca(your_data,       antimicrobials = selected_regimens) antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"gramstain\") # all pathogens set to Gram-pos/Gram-neg antibiogram(your_data,             antimicrobials = selected_regimens,             mo_transform = \"shortname\") # all pathogens set to 'G. species', e.g., E. coli"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"inclusion-in-combination-antibiograms","dir":"Reference","previous_headings":"","what":"Inclusion in Combination Antibiograms","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Note combination antibiograms, important realise susceptibility can calculated two ways, can set only_all_tested argument (default FALSE). See example two antimicrobials, Drug Drug B, antibiogram() works calculate %SI:","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - --------------------------------------------------------------------"},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"plotting","dir":"Reference","previous_headings":"","what":"Plotting","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"types antibiograms listed can plotted (using ggplot2::autoplot() base R's plot() barplot()). mentioned , numeric values antibiogram stored long format attribute long_numeric. can retrieve using attributes(x)$long_numeric, x outcome antibiogram() wisca(). outcome antibiogram() can also used directly R Markdown / Quarto (.e., knitr) reports. case, knitr::kable() applied automatically microorganism names even printed italics default (see argument italicise). can also use functions specific 'table reporting' packages transform output antibiogram() needs, e.g. flextable::as_flextable() gt::gt().","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"explaining-wisca","dir":"Reference","previous_headings":"","what":"Explaining WISCA","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"WISCA (Weighted-Incidence Syndromic Combination Antibiogram) estimates probability empirical coverage combination regimens. weights susceptibility pathogen prevalence within clinical syndrome provides credible intervals around expected coverage. background, interpretation, examples, see WISCA vignette.","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"Implementation: Dr. Larisse Bolton Dr. Matthijs Berends","code":""},{"path":"https://amr-for-r.org/reference/antibiogram.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate Traditional, Combination, Syndromic, or WISCA Antibiograms — antibiogram","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ # Traditional antibiogram ----------------------------------------------  antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()) ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram: 10 × 7 #> # Type:           Non-WISCA with 95% CI #>    Pathogen       Amikacin    Gentamicin Imipenem Kanamycin Meropenem Tobramycin #>    <chr>          <chr>       <chr>      <chr>    <chr>     <chr>     <chr>      #>  1 CoNS           0% (0-8%,N… 86% (82-9… 52% (37… 0% (0-8%… 52% (37-… 22% (12-3… #>  2 E. coli        100% (98-1… 98% (96-9… 100% (9… NA        100% (99… 97% (96-9… #>  3 E. faecalis    0% (0-9%,N… 0% (0-9%,… 100% (9… 0% (0-9%… NA        0% (0-9%,… #>  4 K. pneumoniae  NA          90% (79-9… 100% (9… NA        100% (93… 90% (79-9… #>  5 P. aeruginosa  NA          100% (88-… NA       0% (0-12… NA        100% (88-… #>  6 P. mirabilis   NA          94% (80-9… 94% (79… NA        NA        94% (80-9… #>  7 S. aureus      NA          99% (97-1… NA       NA        NA        98% (92-1… #>  8 S. epidermidis 0% (0-8%,N… 79% (71-8… NA       0% (0-8%… NA        51% (40-6… #>  9 S. hominis     NA          92% (84-9… NA       NA        NA        85% (74-9… #> 10 S. pneumoniae  0% (0-3%,N… 0% (0-3%,… NA       0% (0-3%… NA        0% (0-3%,… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = aminoglycosides(),   ab_transform = \"atc\",   mo_transform = \"gramstain\" ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   Pathogen      J01GB01            J01GB03             J01GB04         J01GB06   #>   <chr>         <chr>              <chr>               <chr>           <chr>     #> 1 Gram-negative 96% (94-97%,N=686) 96% (95-98%,N=684)  0% (0-10%,N=35) 98% (96-… #> 2 Gram-positive 34% (31-38%,N=665) 63% (60-66%,N=1170) 0% (0-1%,N=436) 0% (0-1%… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  antibiogram(example_isolates,   antimicrobials = carbapenems(),   ab_transform = \"name\",   mo_transform = \"name\" ) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram: 5 × 3 #> # Type:           Non-WISCA with 95% CI #>   Pathogen                                 Imipenem             Meropenem        #>   <chr>                                    <chr>                <chr>            #> 1 Coagulase-negative Staphylococcus (CoNS) 52% (37-67%,N=48)    52% (37-67%,N=4… #> 2 Enterococcus faecalis                    100% (91-100%,N=38)  NA               #> 3 Escherichia coli                         100% (99-100%,N=422) 100% (99-100%,N… #> 4 Klebsiella pneumoniae                    100% (93-100%,N=51)  100% (93-100%,N… #> 5 Proteus mirabilis                        94% (79-99%,N=32)    NA               #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Combined antibiogram -------------------------------------------------  # combined antimicrobials yield higher empiric coverage antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   mo_transform = \"gramstain\" ) #> # An Antibiogram: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # you can use any antimicrobial selector with `+` too: antibiogram(example_isolates,   antimicrobials = ureidopenicillins() + c(\"\", \"GEN\", \"tobra\"),   mo_transform = \"gramstain\" ) #> ℹ For `ureidopenicillins()` using column 'TZP' (piperacillin/tazobactam) #> # An Antibiogram: 2 × 4 #> # Type:           Non-WISCA with 95% CI #>   Pathogen  Piperacillin/tazobac…¹ Piperacillin/tazobac…² Piperacillin/tazobac…³ #>   <chr>     <chr>                  <chr>                  <chr>                  #> 1 Gram-neg… 88% (85-91%,N=641)     99% (97-99%,N=691)     98% (97-99%,N=693)     #> 2 Gram-pos… 86% (82-89%,N=345)     98% (96-98%,N=1044)    95% (93-97%,N=550)     #> # ℹ abbreviated names: ¹​`Piperacillin/tazobactam`, #> #   ²​`Piperacillin/tazobactam + Gentamicin`, #> #   ³​`Piperacillin/tazobactam + Tobramycin` #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # names of antimicrobials do not need to resemble columns exactly: antibiogram(example_isolates,   antimicrobials = c(\"Cipro\", \"cipro + genta\"),   mo_transform = \"gramstain\",   ab_transform = \"name\",   sep = \" & \" ) #> # An Antibiogram: 2 × 3 #> # Type:           Non-WISCA with 95% CI #>   Pathogen      Ciprofloxacin      `Ciprofloxacin & Gentamicin` #>   <chr>         <chr>              <chr>                        #> 1 Gram-negative 91% (88-93%,N=684) 99% (97-99%,N=694)           #> 2 Gram-positive 77% (74-80%,N=724) 93% (91-94%,N=847)           #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Syndromic antibiogram ------------------------------------------------  # the data set could contain a filter for e.g. respiratory specimens antibiogram(example_isolates,   antimicrobials = c(aminoglycosides(), carbapenems()),   syndromic_group = \"ward\" ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # An Antibiogram: 14 × 8 #> # Type:           Non-WISCA with 95% CI #>    `Syndromic Group` Pathogen   Amikacin Gentamicin Imipenem Kanamycin Meropenem #>    <chr>             <chr>      <chr>    <chr>      <chr>    <chr>     <chr>     #>  1 Clinical          CoNS       NA       89% (84-9… 57% (39… NA        57% (39-… #>  2 ICU               CoNS       NA       79% (68-8… NA       NA        NA        #>  3 Outpatient        CoNS       NA       84% (66-9… NA       NA        NA        #>  4 Clinical          E. coli    100% (9… 98% (96-9… 100% (9… NA        100% (99… #>  5 ICU               E. coli    100% (9… 99% (95-1… 100% (9… NA        100% (97… #>  6 Clinical          K. pneumo… NA       92% (81-9… 100% (9… NA        100% (92… #>  7 Clinical          P. mirabi… NA       100% (88-… NA       NA        NA        #>  8 Clinical          S. aureus  NA       99% (95-1… NA       NA        NA        #>  9 ICU               S. aureus  NA       100% (95-… NA       NA        NA        #> 10 Clinical          S. epider… NA       82% (72-9… NA       NA        NA        #> 11 ICU               S. epider… NA       72% (60-8… NA       NA        NA        #> 12 Clinical          S. hominis NA       96% (85-9… NA       NA        NA        #> 13 Clinical          S. pneumo… 0% (0-5… 0% (0-5%,… NA       0% (0-5%… NA        #> 14 ICU               S. pneumo… 0% (0-1… 0% (0-12%… NA       0% (0-12… NA        #> # ℹ 1 more variable: Tobramycin <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram  # now define a data set with only E. coli ex1 <- example_isolates[which(mo_genus() == \"Escherichia\"), ] #> ℹ Using column 'mo' as input for `mo_genus()`  # with a custom language, though this will be determined automatically # (i.e., this table will be in Spanish on Spanish systems) antibiogram(ex1,   antimicrobials = aminoglycosides(),   ab_transform = \"name\",   syndromic_group = ifelse(ex1$ward == \"ICU\",     \"UCI\", \"No UCI\"   ),   language = \"es\" ) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # An Antibiogram: 2 × 5 #> # Type:           Non-WISCA with 95% CI #>   `Grupo sindrómico` Patógeno Amikacina            Gentamicina       Tobramicina #>   <chr>              <chr>    <chr>                <chr>             <chr>       #> 1 No UCI             E. coli  100% (97-100%,N=119) 98% (96-99%,N=32… 98% (96-99… #> 2 UCI                E. coli  100% (93-100%,N=52)  99% (95-100%,N=1… 96% (92-99… #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # WISCA antibiogram ----------------------------------------------------  # WISCA are not stratified by species, but rather on syndromes antibiogram(example_isolates,   antimicrobials = c(\"TZP\", \"TZP+TOB\", \"TZP+GEN\"),   syndromic_group = \"ward\",   wisca = TRUE ) #> # An Antibiogram: 3 × 4 #> # Type:           WISCA with 95% CI #>   `Syndromic Group` `Piperacillin/tazobactam` Piperacillin/tazobactam + Gentam…¹ #>   <chr>             <chr>                     <chr>                              #> 1 Clinical          73.6% (68.3-78.8%)        92.3% (90.8-93.8%)                 #> 2 ICU               57.2% (49.8-65.1%)        84.9% (81.8-87.8%)                 #> 3 Outpatient        57.1% (47.2-66.8%)        74.4% (69-79.6%)                   #> # ℹ abbreviated name: ¹​`Piperacillin/tazobactam + Gentamicin` #> # ℹ 1 more variable: `Piperacillin/tazobactam + Tobramycin` <chr> #> # Use `ggplot2::autoplot()` or base R `plot()` to create a plot of this antibiogram, #> # or use it directly in R Markdown or https://quarto.org, see ?antibiogram   # Print the output for R Markdown / Quarto -----------------------------  ureido <- antibiogram(example_isolates,   antimicrobials = ureidopenicillins(),   syndromic_group = \"ward\",   wisca = TRUE ) #> ℹ For `ureidopenicillins()` using column 'TZP' (piperacillin/tazobactam)  # in an Rmd file, you would just need to return `ureido` in a chunk, # but to be explicit here: if (requireNamespace(\"knitr\")) {   cat(knitr::knit_print(ureido)) } #>  #>  #> |Syndromic Group |Piperacillin/tazobactam | #> |:---------------|:-----------------------| #> |Clinical        |73.4% (67.8-78.8%)      | #> |ICU             |57.2% (49.6-65.3%)      | #> |Outpatient      |56.9% (47.1-66.9%)      |   # Generate plots with ggplot2 or base R --------------------------------  ab1 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\" ) ab2 <- antibiogram(example_isolates,   antimicrobials = c(\"AMC\", \"CIP\", \"TZP\", \"TZP+TOB\"),   mo_transform = \"gramstain\",   syndromic_group = \"ward\" )  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab1) }  if (requireNamespace(\"ggplot2\")) {   ggplot2::autoplot(ab2) }   plot(ab1)  plot(ab2)  # }"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":null,"dir":"Reference","previous_headings":"","what":"Antimicrobial Selectors — antimicrobial_selectors","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions allow filtering rows selecting columns based antimicrobial test results specific antimicrobial class group, without need define columns antimicrobial abbreviations. can used base R, tidyverse, tidymodels, data.table. Simply puy, column name resembles antimicrobial drug, picked functions matches pharmaceutical class, code name: column names \"cefazolin\", \"kefzol\", \"CZO\" \"J01DB04\" included following selection:","code":"library(dplyr) my_data_with_all_these_columns %>%   select(cephalosporins())"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"aminoglycosides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  aminopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  antifungals(only_sir_columns = FALSE, return_all = TRUE, ...)  antimycobacterials(only_sir_columns = FALSE, return_all = TRUE, ...)  betalactams(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  betalactams_with_inhibitor(only_sir_columns = FALSE, return_all = TRUE,   ...)  carbapenems(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_1st(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_2nd(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_3rd(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  cephalosporins_4th(only_sir_columns = FALSE, return_all = TRUE, ...)  cephalosporins_5th(only_sir_columns = FALSE, return_all = TRUE, ...)  fluoroquinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  glycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  isoxazolylpenicillins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lincosamides(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  lipoglycopeptides(only_sir_columns = FALSE, return_all = TRUE, ...)  macrolides(only_sir_columns = FALSE, return_all = TRUE, ...)  monobactams(only_sir_columns = FALSE, return_all = TRUE, ...)  nitrofurans(only_sir_columns = FALSE, return_all = TRUE, ...)  oxazolidinones(only_sir_columns = FALSE, return_all = TRUE, ...)  penicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  phenicols(only_sir_columns = FALSE, return_all = TRUE, ...)  polymyxins(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  quinolones(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  rifamycins(only_sir_columns = FALSE, return_all = TRUE, ...)  streptogramins(only_sir_columns = FALSE, return_all = TRUE, ...)  sulfonamides(only_sir_columns = FALSE, return_all = TRUE, ...)  tetracyclines(only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  trimethoprims(only_sir_columns = FALSE, return_all = TRUE, ...)  ureidopenicillins(only_sir_columns = FALSE, return_all = TRUE, ...)  amr_class(amr_class, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  amr_selector(filter, only_sir_columns = FALSE, only_treatable = TRUE,   return_all = TRUE, ...)  administrable_per_os(only_sir_columns = FALSE, return_all = TRUE, ...)  administrable_iv(only_sir_columns = FALSE, return_all = TRUE, ...)  not_intrinsic_resistant(only_sir_columns = FALSE, col_mo = NULL,   version_expected_phenotypes = 1.2, ...)"},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE. only_treatable logical indicate whether antimicrobial drugs excluded laboratory tests (default TRUE), gentamicin-high (GEH) imipenem/EDTA (IPE). return_all logical indicate whether matched columns must returned (default TRUE). FALSE, first unique antimicrobial returned, e.g. columns \"genta\" \"gentamicin\" exist data, first hit gentamicin returned. ... Ignored, place allow future extensions. amr_class antimicrobial class part , \"carba\" \"carbapenems\". columns group, atc_group1 atc_group2 antimicrobials data set searched (case-insensitive) value. filter expression evaluated antimicrobials data set, name %like% \"trim\". col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\".","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"used inside selecting filtering, returns character vector column names, additional class \"amr_selector\". used individually, returns 'ab' vector possible antimicrobials function able select filter.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"functions can used data set calls selecting columns filtering rows. work base R, Tidyverse, data.table. heavily inspired Tidyverse selection helpers everything(), limited dplyr verbs. Nonetheless, convenient use dplyr functions select(), filter() summarise(), see Examples. selectors can also used tidymodels packages recipe parsnip. See info tutorial using antimicrobial selectors predictive modelling. columns data functions called searched known antimicrobial names, abbreviations, brand names, codes (ATC, EARS-Net, , etc.) according antimicrobials data set. means selector aminoglycosides() pick column names like 'gen', 'genta', 'J01GB03', 'tobra', 'Tobracin', etc. amr_class() function can used filter/select manually defined antimicrobial class. searches results antimicrobials data set within columns group, atc_group1 atc_group2. administrable_per_os() administrable_iv() functions also rely antimicrobials data set - antimicrobials matched DDD (defined daily dose) resp. oral IV treatment available antimicrobials data set. amr_selector() function can used internally filter antimicrobials data set results, see Examples. allows filtering (part ) certain name, /group name even minimum DDDs oral treatment. function yields highest flexibility, also least user-friendly, since requires hard-coded filter set. not_intrinsic_resistant() function can used select antimicrobials pose intrinsic resistance microorganisms data set. example, data set contains microorganism codes names E. coli K. pneumoniae contains column \"vancomycin\", column removed (rather, unselected) using function. currently applies 'EUCAST Expected Resistant Phenotypes' v1.2 (2023) determine intrinsic resistance, using eucast_rules() function internally. determination, function quite slow terms performance.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"full-list-of-supported-antimicrobial-classes","dir":"Reference","previous_headings":"","what":"Full list of supported (antimicrobial) classes","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"aminoglycosides() can select:  amikacin (AMK), amikacin/fosfomycin (AKF), apramycin (APR), arbekacin (ARB), astromicin (AST), bekanamycin (BEK), dibekacin (DKB), framycetin (FRM), gentamicin (GEN), gentamicin-high (GEH), habekacin (HAB), hygromycin (HYG), isepamicin (ISE), kanamycin (KAN), kanamycin-high (KAH), kanamycin/cephalexin (KAC), micronomicin (MCR), neomycin (NEO), netilmicin (NET), pentisomicin (PIM), plazomicin (PLZ), propikacin (PKA), ribostamycin (RST), sisomicin (SIS), streptoduocin (STR), streptomycin (STR1), streptomycin-high (STH), tobramycin (TOB), tobramycin-high (TOH) aminopenicillins() can select:  amoxicillin (AMX) ampicillin (AMP) antifungals() can select:  amorolfine (AMO), amphotericin B (AMB), amphotericin B-high (AMH), anidulafungin (ANI), butoconazole (), caspofungin (CAS), ciclopirox (CIX), clotrimazole (CTR), econazole (ECO), fluconazole (FLU), flucytosine (FCT), fosfluconazole (FFL), griseofulvin (GRI), hachimycin (HCH), ibrexafungerp (IBX), isavuconazole (ISV), isoconazole (ISO), itraconazole (ITR), ketoconazole (KET), manogepix (MGX), micafungin (MIF), miconazole (MCZ), nystatin (NYS), oteseconazole (OTE), pimaricin (PMR), posaconazole (POS), rezafungin (RZF), ribociclib (RBC), sulconazole (SUC), terbinafine (TRB), terconazole (TRC), voriconazole (VOR) antimycobacterials() can select:  4-aminosalicylic acid (AMA), calcium aminosalicylate (CLA), capreomycin (CAP), clofazimine (CLF), delamanid (DLM), enviomycin (ENV), ethambutol (ETH), ethambutol/isoniazid (ETI), ethionamide (ETI1), isoniazid (INH), isoniazid/sulfamethoxazole/trimethoprim/pyridoxine (IST), morinamide (MRN), p-aminosalicylic acid (PAS), pretomanid (PMD), protionamide (PTH), pyrazinamide (PZA), rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP), simvastatin/fenofibrate (SMF), sodium aminosalicylate (SDA), streptomycin/isoniazid (STI), terizidone (TRZ), thioacetazone (TAT), thioacetazone/isoniazid (THI1), tiocarlide (TCR), viomycin (VIO) betalactams() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), biapenem (BIA), carbenicillin (CRB), carindacillin (CRN), carumonam (CAR), cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), doripenem (DOR), epicillin (EPC), ertapenem (ETP), flucloxacillin (FLC), hetacillin (HET), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), latamoxef (LTM), lenampicillin (LEN), loracarbef (LOR), mecillinam (MEC), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), panipenem (PAN), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), tebipenem (TBP), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC), tigemonam (TMN) betalactams_with_inhibitor() can select:  amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin/sulbactam (SAM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefoperazone/sulbactam (CSL), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefpodoxime/clavulanic acid (CDC), ceftaroline/avibactam (CPA), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), ceftolozane/tazobactam (CZT), ceftriaxone/beta-lactamase inhibitor (CEB), imipenem/relebactam (IMR), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), mezlocillin/sulbactam (MSU), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), ticarcillin/clavulanic acid (TCC) carbapenems() can select:  biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP) cephalosporins() can select:  cefacetrile (CAC), cefaclor (CEC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefamandole (MAN), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetamet (CAT), cefetamet pivoxil (CPI), cefetecol (CCL), cefetrizole (CZL), cefiderocol (FDC), cefixime (CFM), cefmenoxime (CMX), cefmetazole (CMZ), cefodizime (DIZ), cefonicid (CID), cefoperazone (CFP), cefoperazone/sulbactam (CSL), ceforanide (CND), cefoselis (CSE), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotetan (CTT), cefotiam (CTF), cefotiam hexetil (CHE), cefovecin (FOV), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefozopran (ZOP), cefpimizole (CFZ), cefpiramide (CPM), cefpirome (CPO), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefprozil (CPR), cefquinome (CEQ), cefroxadine (CRD), cefsulodin (CFS), cefsumide (CSU), ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftezole (CTL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), cefuroxime (CXM), cefuroxime axetil (CXA), cephradine (CED), latamoxef (LTM), loracarbef (LOR) cephalosporins_1st() can select:  cefacetrile (CAC), cefadroxil (CFR), cefalexin (LEX), cefaloridine (RID), cefalotin (CEP), cefapirin (HAP), cefatrizine (CTZ), cefazedone (CZD), cefazolin (CZO), cefroxadine (CRD), ceftezole (CTL), cephradine (CED) cephalosporins_2nd() can select:  cefaclor (CEC), cefamandole (MAN), cefmetazole (CMZ), cefonicid (CID), ceforanide (CND), cefotetan (CTT), cefotiam (CTF), cefoxitin (FOX), cefoxitin screening test (FOX-S), cefprozil (CPR), cefuroxime (CXM), cefuroxime axetil (CXA), loracarbef (LOR) cephalosporins_3rd() can select:  cefcapene (CCP), cefcapene pivoxil (CCX), cefdinir (CDR), cefditoren (DIT), cefditoren pivoxil (DIX), cefetamet (CAT), cefetamet pivoxil (CPI), cefixime (CFM), cefmenoxime (CMX), cefodizime (DIZ), cefoperazone (CFP), cefoperazone/sulbactam (CSL), cefotaxime (CTX), cefotaxime screening test (CTX-S), cefotaxime/clavulanic acid (CTC), cefotaxime/sulbactam (CTS), cefotiam hexetil (CHE), cefovecin (FOV), cefpimizole (CFZ), cefpiramide (CPM), cefpodoxime (CPD), cefpodoxime proxetil (CPX), cefpodoxime/clavulanic acid (CDC), cefsulodin (CFS), ceftazidime (CAZ), ceftazidime/avibactam (CZA), ceftazidime/clavulanic acid (CCV), cefteram (CEM), cefteram pivoxil (CPL), ceftibuten (CTB), ceftiofur (TIO), ceftizoxime (CZX), ceftizoxime alapivoxil (CZP), ceftriaxone (CRO), ceftriaxone/beta-lactamase inhibitor (CEB), latamoxef (LTM) cephalosporins_4th() can select:  cefepime (FEP), cefepime/amikacin (CFA), cefepime/clavulanic acid (CPC), cefepime/enmetazobactam (FPE), cefepime/nacubactam (FNC), cefepime/tazobactam (FPT), cefepime/zidebactam (FPZ), cefetecol (CCL), cefoselis (CSE), cefozopran (ZOP), cefpirome (CPO), cefquinome (CEQ) cephalosporins_5th() can select:  ceftaroline (CPT), ceftaroline/avibactam (CPA), ceftobiprole (BPR), ceftobiprole medocaril (CFM1), ceftolozane/tazobactam (CZT) fluoroquinolones() can select:  besifloxacin (BES), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) glycopeptides() can select:  avoparcin (AVO), bleomycin (BLM), dalbavancin (DAL), norvancomycin (NVA), oritavancin (ORI), ramoplanin (RAM), teicoplanin (TEC), teicoplanin-macromethod (TCM), telavancin (TLV), vancomycin (VAN), vancomycin-macromethod (VAM) isoxazolylpenicillins() can select:  cloxacillin (CLO), dicloxacillin (DIC), flucloxacillin (FLC), meticillin (MET), oxacillin (OXA), oxacillin screening test (OXA-S) lincosamides() can select:  clindamycin (CLI), lincomycin (LIN), pirlimycin (PRL) lipoglycopeptides() can select:  dalbavancin (DAL), oritavancin (ORI), telavancin (TLV) macrolides() can select:  acetylmidecamycin (ACM), acetylspiramycin (ASP), azithromycin (AZM), clarithromycin (CLR), dirithromycin (DIR), erythromycin (ERY), flurithromycin (FLR1), gamithromycin (GAM), josamycin (JOS), kitasamycin (KIT), meleumycin (MEL), midecamycin (MID), miocamycin (MCM), nafithromycin (ZWK), oleandomycin (OLE), rokitamycin (ROK), roxithromycin (RXT), solithromycin (SOL), spiramycin (SPI), telithromycin (TLT), tildipirosin (TIP), tilmicosin (TIL), troleandomycin (TRL), tulathromycin (TUL), tylosin (TYL), tylvalosin (TYL1) monobactams() can select:  aztreonam (ATM), aztreonam/avibactam (AZA), aztreonam/nacubactam (ANC), carumonam (CAR), tigemonam (TMN) nitrofurans() can select:  furazidin (FUR), furazolidone (FRZ), nifurtoinol (NFR), nitrofurantoin (NIT), nitrofurazone (NIZ) oxazolidinones() can select:  cadazolid (CDZ), cycloserine (CYC), linezolid (LNZ), tedizolid (TZD), thiacetazone (THA) penicillins() can select:  amoxicillin (AMX), amoxicillin/clavulanic acid (AMC), amoxicillin/sulbactam (AXS), ampicillin (AMP), ampicillin/sulbactam (SAM), apalcillin (APL), aspoxicillin (APX), azidocillin (AZD), azlocillin (AZL), bacampicillin (BAM), benzathine benzylpenicillin (BNB), benzathine phenoxymethylpenicillin (BNP), benzylpenicillin (PEN), benzylpenicillin screening test (PEN-S), carbenicillin (CRB), carindacillin (CRN), ciclacillin (CIC), clometocillin (CLM), cloxacillin (CLO), dicloxacillin (DIC), epicillin (EPC), flucloxacillin (FLC), hetacillin (HET), lenampicillin (LEN), mecillinam (MEC), metampicillin (MTM), meticillin (MET), mezlocillin (MEZ), mezlocillin/sulbactam (MSU), nafcillin (NAF), oxacillin (OXA), oxacillin screening test (OXA-S), penamecillin (PNM), penicillin/novobiocin (PNO), penicillin/sulbactam (PSU), pheneticillin (PHE), phenoxymethylpenicillin (PHN), piperacillin (PIP), piperacillin/sulbactam (PIS), piperacillin/tazobactam (TZP), piridicillin (PRC), pivampicillin (PVM), pivmecillinam (PME), procaine benzylpenicillin (PRB), propicillin (PRP), sarmoxicillin (SRX), sulbenicillin (SBC), sultamicillin (SLT6), talampicillin (TAL), temocillin (TEM), ticarcillin (TIC), ticarcillin/clavulanic acid (TCC) phenicols() can select:  chloramphenicol (CHL), florfenicol (FLR), thiamphenicol (THI) polymyxins() can select:  colistin (COL), polymyxin B (PLB), polymyxin B/polysorbate 80 (POP) quinolones() can select:  besifloxacin (BES), cinoxacin (CIN), ciprofloxacin (CIP), ciprofloxacin/metronidazole (CIM), ciprofloxacin/ornidazole (CIO), ciprofloxacin/tinidazole (CIT), clinafloxacin (CLX), danofloxacin (DAN), delafloxacin (DFX), difloxacin (DIF), enoxacin (ENX), enrofloxacin (ENR), finafloxacin (FIN), fleroxacin (FLE), flumequine (FLM), garenoxacin (GRN), gatifloxacin (GAT), gemifloxacin (GEM), grepafloxacin (GRX), lascufloxacin (LSC), levofloxacin (LVX), levofloxacin/ornidazole (LEO), levonadifloxacin (LND), lomefloxacin (LOM), marbofloxacin (MAR), metioxate (MXT), miloxacin (MIL), moxifloxacin (MFX), nadifloxacin (NAD), nalidixic acid (NAL), nalidixic acid screening test (NAL-S), nemonoxacin (NEM), nifuroquine (NIF), nitroxoline (NTR), norfloxacin (), norfloxacin screening test (-S), norfloxacin/metronidazole (NME), norfloxacin/tinidazole (NTI), ofloxacin (OFX), ofloxacin/ornidazole (OOR), orbifloxacin (ORB), oxolinic acid (OXO), pazufloxacin (PAZ), pefloxacin (PEF), pefloxacin screening test (PEF-S), pipemidic acid (PPA), piromidic acid (PIR), pradofloxacin (PRA), premafloxacin (PRX), prulifloxacin (PRU), rosoxacin (ROS), rufloxacin (RFL), sarafloxacin (SAR), sitafloxacin (SIT), sparfloxacin (SPX), temafloxacin (TMX), tilbroquinol (TBQ), tioxacin (TXC), tosufloxacin (TFX), trovafloxacin (TVA) rifamycins() can select:  rifabutin (RIB), rifampicin (RIF), rifampicin/ethambutol/isoniazid (REI), rifampicin/isoniazid (RFI), rifampicin/pyrazinamide/ethambutol/isoniazid (RPEI), rifampicin/pyrazinamide/isoniazid (RPI), rifamycin (RFM), rifapentine (RFP) streptogramins() can select:  pristinamycin (PRI) quinupristin/dalfopristin (QDA) sulfonamides() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfamoxole (SLF8), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13) tetracyclines() can select:  cetocycline (CTO), chlortetracycline (CTE), clomocycline (CLM1), demeclocycline (DEM), doxycycline (DOX), eravacycline (ERV), lymecycline (LYM), metacycline (MTC), minocycline (MNO), omadacycline (OMC), oxytetracycline (OXY), penimepicycline (PNM1), rolitetracycline (RLT), sarecycline (SRC), tetracycline (TCY), tetracycline screening test (TCY-S), tigecycline (TGC) trimethoprims() can select:  brodimoprim (BDP), sulfadiazine (SDI), sulfadiazine/tetroxoprim (SLT), sulfadiazine/trimethoprim (SLT1), sulfadimethoxine (SUD), sulfadimidine (SDM), sulfadimidine/trimethoprim (SLT2), sulfafurazole (SLF), sulfaisodimidine (SLF1), sulfalene (SLF2), sulfamazone (SZO), sulfamerazine (SLF3), sulfamerazine/trimethoprim (SLT3), sulfamethizole (SLF4), sulfamethoxazole (SMX), sulfamethoxypyridazine (SLF5), sulfametomidine (SLF6), sulfametoxydiazine (SLF7), sulfametrole/trimethoprim (SLT4), sulfamoxole (SLF8), sulfamoxole/trimethoprim (SLT5), sulfanilamide (SLF9), sulfaperin (SLF10), sulfaphenazole (SLF11), sulfapyridine (SLF12), sulfathiazole (SUT), sulfathiourea (SLF13), trimethoprim (TMP), trimethoprim/sulfamethoxazole (SXT) ureidopenicillins() can select:  azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobial_selectors.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Antimicrobial Selectors — antimicrobial_selectors","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # you can use the selectors separately to retrieve all possible antimicrobials: carbapenems() #> ℹ in `carbapenems()`: Imipenem/EDTA (`IPE`) and meropenem/nacubactam #>   (`MNC`) are not included since `only_treatable = TRUE`. #> ℹ This 'ab' vector was retrieved using `carbapenems()`, which should #>   normally be used inside a `dplyr` verb or `data.frame` call, e.g.: #>   • your_data %>% select(carbapenems()) #>   • your_data %>% select(column_a, column_b, carbapenems()) #>   • your_data %>% filter(any(carbapenems() == \"R\")) #>   • your_data[, carbapenems()] #>   • your_data[, c(\"column_a\", \"column_b\", carbapenems())] #> Class 'ab' #>  [1] BIA DOR ETP IMR IPM MEM MEV PAN RIA RIT RZM TBP   # Though they are primarily intended to use for selections and filters. # Examples sections below are split into 'dplyr', 'base R', and 'data.table':  # \\donttest{ if (FALSE) { # \\dontrun{ # dplyr -------------------------------------------------------------------  library(dplyr, warn.conflicts = FALSE)  example_isolates %>% select(carbapenems())  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates %>% select(mo, aminoglycosides())  # you can combine selectors like you are used with tidyverse # e.g., for betalactams, but not the ones with an enzyme inhibitor: example_isolates %>% select(betalactams(), -betalactams_with_inhibitor())  # select only antimicrobials with DDDs for oral treatment example_isolates %>% select(administrable_per_os())  # get AMR for all aminoglycosides e.g., per ward: example_isolates %>%   group_by(ward) %>%   summarise(across(aminoglycosides(),                    resistance))  # You can combine selectors with '&' to be more specific: example_isolates %>%   select(penicillins() & administrable_per_os())  # get AMR for only drugs that matter - no intrinsic resistance: example_isolates %>%   filter(mo_genus() %in% c(\"Escherichia\", \"Klebsiella\")) %>%   group_by(ward) %>%   summarise_at(not_intrinsic_resistant(),                resistance)  # get susceptibility for antimicrobials whose name contains \"trim\": example_isolates %>%   filter(first_isolate()) %>%   group_by(ward) %>%   summarise(across(amr_selector(name %like% \"trim\"), susceptibility))  # this will select columns 'IPM' (imipenem) and 'MEM' (meropenem): example_isolates %>%   select(carbapenems())  # this will select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB': example_isolates %>%   select(mo, aminoglycosides())  # any() and all() work in dplyr's filter() too: example_isolates %>%   filter(     any(aminoglycosides() == \"R\"),     all(cephalosporins_2nd() == \"R\")   )  # also works with c(): example_isolates %>%   filter(any(c(carbapenems(), aminoglycosides()) == \"R\"))  # not setting any/all will automatically apply all(): example_isolates %>%   filter(aminoglycosides() == \"R\")  # this will select columns 'mo' and all antimycobacterial drugs ('RIF'): example_isolates %>%   select(mo, amr_class(\"mycobact\"))  # get bug/drug combinations for only glycopeptides in Gram-positives: example_isolates %>%   filter(mo_is_gram_positive()) %>%   select(mo, glycopeptides()) %>%   bug_drug_combinations() %>%   format()  data.frame(   some_column = \"some_value\",   J01CA01 = \"S\" ) %>% # ATC code of ampicillin   select(penicillins()) # only the 'J01CA01' column will be selected  # with recent versions of dplyr, this is all equal: x <- example_isolates[carbapenems() == \"R\", ] y <- example_isolates %>% filter(carbapenems() == \"R\") z <- example_isolates %>% filter(if_all(carbapenems(), ~ .x == \"R\")) identical(x, y) && identical(y, z)  } # } # base R ------------------------------------------------------------------  # select columns 'IPM' (imipenem) and 'MEM' (meropenem) example_isolates[, carbapenems()] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 2,000 × 2 #>    IPM   MEM   #>    <sir> <sir> #>  1   NA    NA  #>  2   NA    NA  #>  3   NA    NA  #>  4   NA    NA  #>  5   NA    NA  #>  6   NA    NA  #>  7   NA    NA  #>  8   NA    NA  #>  9   NA    NA  #> 10   NA    NA  #> # ℹ 1,990 more rows  # select columns 'mo', 'AMK', 'GEN', 'KAN' and 'TOB' example_isolates[, c(\"mo\", aminoglycosides())] #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 2,000 × 5 #>    mo           GEN   TOB   AMK   KAN   #>    <mo>         <sir> <sir> <sir> <sir> #>  1 B_ESCHR_COLI   NA    NA    NA    NA  #>  2 B_ESCHR_COLI   NA    NA    NA    NA  #>  3 B_STPHY_EPDR   NA    NA    NA    NA  #>  4 B_STPHY_EPDR   NA    NA    NA    NA  #>  5 B_STPHY_EPDR   NA    NA    NA    NA  #>  6 B_STPHY_EPDR   NA    NA    NA    NA  #>  7 B_STPHY_AURS   NA    S     NA    NA  #>  8 B_STPHY_AURS   NA    S     NA    NA  #>  9 B_STPHY_EPDR   NA    NA    NA    NA  #> 10 B_STPHY_EPDR   NA    NA    NA    NA  #> # ℹ 1,990 more rows  # select only antimicrobials with DDDs for oral treatment example_isolates[, administrable_per_os()] #> ℹ For `administrable_per_os()` using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 23 #>    OXA   FLC   AMX   AMC   AMP   CXM   KAN   TMP   NIT   FOS   LNZ   CIP   MFX   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  2   NA    NA    NA    I     NA    I     NA    R     NA    NA    R     NA    NA  #>  3   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  4   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    NA    NA  #>  5   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  6   NA    R     NA    NA    NA    R     NA    R     NA    NA    NA    NA    NA  #>  7   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  8   NA    S     R     S     R     S     NA    R     NA    NA    NA    NA    NA  #>  9   NA    R     NA    NA    NA    R     NA    S     NA    NA    NA    S     NA  #> 10   NA    S     NA    NA    NA    S     NA    S     NA    NA    NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 10 more variables: VAN <sir>, TCY <sir>, DOX <sir>, ERY <sir>, CLI <sir>, #> #   AZM <sir>, MTR <sir>, CHL <sir>, COL <sir>, RIF <sir>  # filter using any() or all() example_isolates[any(carbapenems() == \"R\"), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … subset(example_isolates, any(carbapenems() == \"R\")) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> # A tibble: 55 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2004-06-09 529296     69 M      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  4 2005-04-21 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  5 2005-04-22 452212     82 F      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  8 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  9 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> 10 2008-01-22 1710B8     82 M      Clinical B_PROTS_MRBL   R     NA    NA    NA  #> # ℹ 45 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter on any or all results in the carbapenem columns (i.e., IPM, MEM): example_isolates[any(carbapenems()), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering any of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 962 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  7 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  8 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  9 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #> 10 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #> # ℹ 952 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … example_isolates[all(carbapenems()), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Filtering all of columns 'IPM' and 'MEM' to contain value \"S\", \"I\" or \"R\" #> # A tibble: 756 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-04-14 F30196     73 M      Outpat… B_STRPT_GRPB    S     NA    S     S   #>  2 2003-04-08 114570     74 M      ICU     B_STRPT_PYGN    S     NA    S     S   #>  3 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  4 2003-04-08 114570     74 M      ICU     B_STRPT_GRPA    S     NA    S     S   #>  5 2003-08-14 F71508      0 F      Clinic… B_STRPT_GRPB    S     NA    S     S   #>  6 2003-10-16 650870     63 F      ICU     B_ESCHR_COLI    R     NA    NA    R   #>  7 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-10-20 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  9 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> 10 2003-11-04 2FC253     87 F      ICU     B_ESCHR_COLI    R     NA    NA    NA  #> # ℹ 746 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter with multiple antimicrobial selectors using c() example_isolates[all(c(carbapenems(), aminoglycosides()) == \"R\"), ] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 26 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2004-11-03 D65308     80 F      ICU      B_STNTR_MLTP   R     NA    NA    R   #>  2 2005-04-22 452212     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  3 2007-02-21 8BBC46     61 F      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  4 2007-12-15 401043     72 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  5 2008-12-06 501361     43 F      Clinical B_STNTR_MLTP   R     NA    NA    R   #>  6 2011-05-09 207325     82 F      ICU      B_ENTRC_FACM   NA    NA    NA    NA  #>  7 2012-03-12 582258     80 M      ICU      B_STPHY_CONS   R     R     R     R   #>  8 2012-05-19 C25552     89 F      Outpati… B_STPHY_CONS   R     R     R     R   #>  9 2012-07-17 F05015     83 M      ICU      B_STPHY_CONS   R     R     R     R   #> 10 2012-07-20 404299     66 F      Clinical B_STPHY_CONS   R     R     R     R   #> # ℹ 16 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter + select in one go: get penicillins in carbapenem-resistant strains example_isolates[any(carbapenems() == \"R\"), penicillins()] #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `penicillins()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> # A tibble: 55 × 7 #>    PEN   OXA   FLC   AMX   AMC   AMP   TZP   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    NA    NA    NA    NA  #>  2   NA    NA    NA    NA    NA    NA    NA  #>  3   R     NA    NA    R     R     R     R   #>  4   NA    NA    NA    NA    NA    NA    R   #>  5   NA    NA    NA    NA    NA    NA    R   #>  6   NA    NA    NA    NA    NA    NA    R   #>  7   NA    NA    NA    NA    NA    NA    R   #>  8   NA    NA    NA    NA    NA    NA    R   #>  9   R     NA    NA    NA    S     NA    S   #> 10   R     NA    NA    NA    S     NA    S   #> # ℹ 45 more rows  # You can combine selectors with '&' to be more specific. For example, # penicillins() would select benzylpenicillin ('peni G') and # administrable_per_os() would select erythromycin. Yet, when combined these # drugs are both omitted since benzylpenicillin is not administrable per os # and erythromycin is not a penicillin: example_isolates[, penicillins() & administrable_per_os()] #> ℹ For `penicillins()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #> ℹ For `administrable_per_os()` using columns 'OXA' (oxacillin), 'FLC' #>   (flucloxacillin), 'AMX' (amoxicillin), 'AMC' (amoxicillin/clavulanic acid), #>   'AMP' (ampicillin), 'CXM' (cefuroxime), 'KAN' (kanamycin), 'TMP' #>   (trimethoprim), 'NIT' (nitrofurantoin), 'FOS' (fosfomycin), 'LNZ' #>   (linezolid), 'CIP' (ciprofloxacin), 'MFX' (moxifloxacin), 'VAN' #>   (vancomycin), 'TCY' (tetracycline), 'DOX' (doxycycline), 'ERY' #>   (erythromycin), 'CLI' (clindamycin), 'AZM' (azithromycin), 'MTR' #>   (metronidazole), 'CHL' (chloramphenicol), 'COL' (colistin), and 'RIF' #>   (rifampicin) #> # A tibble: 2,000 × 5 #>    OXA   FLC   AMX   AMC   AMP   #>    <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA  #>  2   NA    NA    NA    I     NA  #>  3   NA    R     NA    NA    NA  #>  4   NA    R     NA    NA    NA  #>  5   NA    R     NA    NA    NA  #>  6   NA    R     NA    NA    NA  #>  7   NA    S     R     S     R   #>  8   NA    S     R     S     R   #>  9   NA    R     NA    NA    NA  #> 10   NA    S     NA    NA    NA  #> # ℹ 1,990 more rows  # amr_selector() applies a filter in the `antimicrobials` data set and is thus # very flexible. For instance, to select antimicrobials with an oral DDD # of at least 1 gram: example_isolates[, amr_selector(oral_ddd > 1 & oral_units == \"g\")] #> ℹ For `amr_selector(oral_ddd > 1 & oral_units == \"g\")` using columns 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), 'KAN' (kanamycin), 'FOS' #>   (fosfomycin), 'LNZ' (linezolid), 'VAN' (vancomycin), 'ERY' (erythromycin), #>   'CLI' (clindamycin), 'MTR' (metronidazole), and 'CHL' (chloramphenicol) #> # A tibble: 2,000 × 13 #>    OXA   FLC   AMX   AMC   AMP   KAN   FOS   LNZ   VAN   ERY   CLI   MTR   CHL   #>    <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>  1   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  2   NA    NA    NA    I     NA    NA    NA    R     R     R     R     NA    NA  #>  3   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  4   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  5   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #>  6   NA    R     NA    NA    NA    NA    NA    NA    S     R     R     NA    NA  #>  7   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  8   NA    S     R     S     R     NA    NA    NA    S     S     NA    NA    NA  #>  9   NA    R     NA    NA    NA    NA    NA    NA    S     R     NA    NA    NA  #> 10   NA    S     NA    NA    NA    NA    NA    NA    S     S     NA    NA    NA  #> # ℹ 1,990 more rows   # data.table --------------------------------------------------------------  # data.table is supported as well, just use it in the same way as with # base R, but add `with = FALSE` if using a single AB selector.  if (require(\"data.table\")) {   dt <- as.data.table(example_isolates)    # this does not work, it returns column *names*   dt[, carbapenems()] } #> Loading required package: data.table #>  #> Attaching package: ‘data.table’ #> The following object is masked from ‘package:purrr’: #>  #>     transpose #> The following objects are masked from ‘package:dplyr’: #>  #>     between, first, last #> The following objects are masked from ‘package:AMR’: #>  #>     %like%, like #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: It should never be needed to print an antimicrobial selector class. Are you #> using data.table? Then add the argument `with = FALSE`, see our examples at #> `?amr_selector`. #> Class 'amr_selector' #> [1] IPM MEM if (require(\"data.table\")) {   # so `with = FALSE` is required   dt[, carbapenems(), with = FALSE] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>         IPM   MEM #>       <sir> <sir> #>    1:  <NA>  <NA> #>    2:  <NA>  <NA> #>    3:  <NA>  <NA> #>    4:  <NA>  <NA> #>    5:  <NA>  <NA> #>   ---             #> 1996:  <NA>  <NA> #> 1997:     S     S #> 1998:     S     S #> 1999:     S     S #> 2000:     S     S  # for multiple selections or AB selectors, `with = FALSE` is not needed: if (require(\"data.table\")) {   dt[, c(\"mo\", aminoglycosides())] } #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>                 mo   GEN   TOB   AMK   KAN #>               <mo> <sir> <sir> <sir> <sir> #>    1: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    2: B_ESCHR_COLI  <NA>  <NA>  <NA>  <NA> #>    3: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    4: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>    5: B_STPHY_EPDR  <NA>  <NA>  <NA>  <NA> #>   ---                                      #> 1996: B_STRPT_PNMN     R     R     R     R #> 1997: B_ESCHR_COLI     S     S     S  <NA> #> 1998: B_STPHY_CONS     S  <NA>  <NA>  <NA> #> 1999: B_ESCHR_COLI     S     S  <NA>  <NA> #> 2000: B_KLBSL_PNMN     S     S  <NA>  <NA> if (require(\"data.table\")) {   dt[, c(carbapenems(), aminoglycosides())] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #>         IPM   MEM   GEN   TOB   AMK   KAN #>       <sir> <sir> <sir> <sir> <sir> <sir> #>    1:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    2:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    3:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    4:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>    5:  <NA>  <NA>  <NA>  <NA>  <NA>  <NA> #>   ---                                     #> 1996:  <NA>  <NA>     R     R     R     R #> 1997:     S     S     S     S     S  <NA> #> 1998:     S     S     S  <NA>  <NA>  <NA> #> 1999:     S     S     S     S  <NA>  <NA> #> 2000:     S     S     S     S  <NA>  <NA>  # row filters are also supported: if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), ] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #>            date patient   age gender       ward           mo   PEN   OXA   FLC #>          <Date>  <char> <num> <char>     <char>         <mo> <sir> <sir> <sir> #>   1: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   2: 2002-01-19  738003    71      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #>   3: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   4: 2002-01-22  F35553    50      M        ICU B_PROTS_MRBL     R  <NA>  <NA> #>   5: 2002-02-05  067927    45      F        ICU B_SERRT_MRCS     R  <NA>  <NA> #>  ---                                                                           #> 905: 2005-04-12  D71461    70      M        ICU B_ESCHR_COLI     R  <NA>  <NA> #> 906: 2009-11-12  650870    69      F Outpatient B_ESCHR_COLI     R  <NA>  <NA> #> 907: 2012-06-14  8CBCF2    41      F   Clinical B_STPHY_CONS     R     S     S #> 908: 2012-10-11  175532    78      M   Clinical B_ESCHR_COLI     R  <NA>  <NA> #> 909: 2013-11-23  A97263    77      M   Clinical B_KLBSL_PNMN     R  <NA>  <NA> #>        AMX   AMC   AMP   TZP   CZO   FEP   CXM   FOX   CTX   CAZ   CRO   GEN #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   2:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S  <NA>     S  <NA> #>   3:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   4:  <NA>     I  <NA>  <NA>  <NA>  <NA>     S  <NA>     S     S     S  <NA> #>   5:     R     R     R  <NA>     R  <NA>     R     R  <NA>  <NA>  <NA>  <NA> #>  ---                                                                         #> 905:     S     S     S     S  <NA>     S     S     S     S     S     S     S #> 906:     S     S     S     S     S     S     S     S     S     S     S     S #> 907:  <NA>     S  <NA>  <NA>     S     S     S     S     S     R     S     S #> 908:     R     S     R     S  <NA>     S     R     R     S     S     S     S #> 909:     R     S     R     S  <NA>     S     S     S     S     S     S     S #>        TOB   AMK   KAN   TMP   SXT   NIT   FOS   LNZ   CIP   MFX   VAN   TEC #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   2:     S  <NA>  <NA>     S     S  <NA>  <NA>     R  <NA>  <NA>     R     R #>   3:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   4:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>   5:  <NA>  <NA>  <NA>     S     S     R  <NA>     R     S  <NA>     R     R #>  ---                                                                         #> 905:     S     S  <NA>  <NA>     S     S  <NA>     R     S  <NA>     R     R #> 906:     S     S  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #> 907:  <NA>  <NA>  <NA>     S     S  <NA>  <NA>  <NA>     S  <NA>     S  <NA> #> 908:     S  <NA>  <NA>     R     R     R  <NA>     R     R     R     R     R #> 909:     S  <NA>  <NA>     S     S     S  <NA>     R     S  <NA>     R     R #>        TCY   TGC   DOX   ERY   CLI   AZM   IPM   MEM   MTR   CHL   COL   MUP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   2:  <NA>  <NA>  <NA>     R     R     R     S  <NA>  <NA>  <NA>  <NA>  <NA> #>   3:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   4:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>   5:     R     R     R     R     R     R     S  <NA>  <NA>  <NA>     R  <NA> #>  ---                                                                         #> 905:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 906:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>  <NA>  <NA> #> 907:  <NA>  <NA>  <NA>     S     S     S     S     S  <NA>  <NA>     R  <NA> #> 908:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #> 909:  <NA>  <NA>  <NA>     R     R     R     S     S  <NA>  <NA>     S  <NA> #>        RIF #>      <sir> #>   1:     R #>   2:     R #>   3:     R #>   4:     R #>   5:     R #>  ---       #> 905:     R #> 906:     R #> 907:  <NA> #> 908:     R #> 909:     R if (require(\"data.table\")) {   dt[any(carbapenems() == \"S\"), penicillins(), with = FALSE] } #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ For `penicillins()` using columns 'PEN' (benzylpenicillin), 'OXA' #>   (oxacillin), 'FLC' (flucloxacillin), 'AMX' (amoxicillin), 'AMC' #>   (amoxicillin/clavulanic acid), 'AMP' (ampicillin), and 'TZP' #>   (piperacillin/tazobactam) #>        PEN   OXA   FLC   AMX   AMC   AMP   TZP #>      <sir> <sir> <sir> <sir> <sir> <sir> <sir> #>   1:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   2:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   3:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   4:     R  <NA>  <NA>  <NA>     I  <NA>  <NA> #>   5:     R  <NA>  <NA>     R     R     R  <NA> #>  ---                                           #> 905:     R  <NA>  <NA>     S     S     S     S #> 906:     R  <NA>  <NA>     S     S     S     S #> 907:     R     S     S  <NA>     S  <NA>  <NA> #> 908:     R  <NA>  <NA>     R     S     R     S #> 909:     R  <NA>  <NA>     R     S     R     S # }"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Two data sets containing antimicrobials antivirals. Use .ab() one ab_* functions retrieve values antimicrobials data set. Three identifiers included data set: antimicrobial ID (ab, primarily used package) defined WHONET/EARS-Net, ATC code (atc) defined , Compound ID (cid) found PubChem. properties data set derived one codes. Note drugs multiple ATC codes. antibiotics data set renamed antimicrobials. old name removed future version.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials  antibiotics  antivirals"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"object class deprecated_amr_dataset (inherits tbl_df, tbl, data.frame) 497 rows 14 columns. object class tbl_df (inherits tbl, data.frame) 120 rows 11 columns.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antimicrobials-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antimicrobials data set: a tibble with 497 observations and 14 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"ab antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. cid Compound ID found PubChem. unique identifier. name Official name used WHONET/EARS-Net . unique identifier. group short concise group name, based WHONET WHOCC definitions atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, like J01CR02 (last updated May 4th, 2025): atc_group1 Official pharmacological subgroup (3rd level ATC code) defined WHOCC, like \"Macrolides, lincosamides streptogramins\" atc_group2 Official chemical subgroup (4th level ATC code) defined WHOCC, like \"Macrolides\" abbr List abbreviations used many countries, also antimicrobial susceptibility testing (AST) synonyms Synonyms (often trade names) drug, found PubChem based compound ID ATC properties (last updated May 4th, 2025): oral_ddd Defined Daily Dose (DDD), oral treatment, currently available 180 drugs oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral (intravenous) treatment, currently available 153 drugs iv_units Units iv_ddd LOINC: loinc codes associated name antimicrobial drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use ab_loinc() retrieve quickly, see ab_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"for-the-antivirals-data-set-a-tibble-with-observations-and-variables-","dir":"Reference","previous_headings":"","what":"For the antivirals data set: a tibble with 120 observations and 11 variables:","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"av Antiviral ID used package (ACI), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available. unique identifier. Combinations codes contain + indicate , ATA+COBI atazanavir/cobicistat. name Official name used WHONET/EARS-Net . unique identifier. atc ATC codes (Anatomical Therapeutic Chemical) defined WHOCC, see Details cid Compound ID found PubChem. unique identifier. atc_group Official pharmacological subgroup (3rd level ATC code) defined WHOCC synonyms Synonyms (often trade names) drug, found PubChem based compound ID oral_ddd Defined Daily Dose (DDD), oral treatment oral_units Units oral_ddd iv_ddd Defined Daily Dose (DDD), parenteral treatment iv_units Units iv_ddd loinc codes associated name antiviral drug Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Use av_loinc() retrieve quickly, see av_property().","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Collaborating Centre Drug Statistics Methodology, Guidelines ATC classification DDD assignment, Oslo Accessed https://atcddd.fhi./atc_ddd_index/ May 4th, 2025. Logical Observation Identifiers Names Codes (LOINC), Version 2.76 (18 September, 2023). Accessed https://loinc.org October 19th, 2023. European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"Properties based ATC code available ATC available. properties : atc_group1, atc_group2, oral_ddd, oral_units, iv_ddd iv_units. note ATC codes unique. example, J01CR02 officially ATC code \"amoxicillin beta-lactamase inhibitor\". Consequently, two items antimicrobials data set return \"J01CR02\":   Synonyms (.e. trade names) derived PubChem Compound ID (column cid) consequently available CID available.","code":"ab_atc(\"amoxicillin/clavulanic acid\") ab_atc(\"amoxicillin/sulbactam\")"},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Sets with 617 Antimicrobial Drugs — antimicrobials","text":"","code":"antimicrobials #> # A tibble: 497 × 14 #>    ab        cid name   group atc   atc_group1 atc_group2 abbreviations synonyms #>    <ab>    <dbl> <chr>  <chr> <lis> <chr>      <chr>      <list>        <named > #>  1 AMA      4649 4-ami… Anti… <chr> Drugs for… Aminosali… <chr [1]>     <chr>    #>  2 ACM   6450012 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  3 ASP  49787020 Acety… Macr… <chr> NA         NA         <chr [1]>     <chr>    #>  4 ALS      8954 Aldes… Othe… <chr> Drugs for… Drugs for… <chr [1]>     <chr>    #>  5 AMK     37768 Amika… Amin… <chr> Aminoglyc… Other ami… <chr [6]>     <chr>    #>  6 AKF        NA Amika… Amin… <chr> NA         NA         <chr [1]>     <chr>    #>  7 AMO     54260 Amoro… Anti… <chr> Antifunga… Other ant… <chr [1]>     <chr>    #>  8 AMX     33613 Amoxi… Beta… <chr> Beta-lact… Penicilli… <chr [4]>     <chr>    #>  9 AMC  23665637 Amoxi… Beta… <chr> Beta-lact… Combinati… <chr [6]>     <chr>    #> 10 AXS    465441 Amoxi… Beta… <chr> NA         NA         <chr [1]>     <chr>    #> # ℹ 487 more rows #> # ℹ 5 more variables: oral_ddd <dbl>, oral_units <chr>, iv_ddd <dbl>, #> #   iv_units <chr>, loinc <list> antivirals #> # A tibble: 120 × 11 #>    av       name      atc      cid atc_group synonyms oral_ddd oral_units iv_ddd #>    <av>     <chr>     <chr>  <dbl> <chr>     <list>      <dbl> <chr>       <dbl> #>  1 ABA      Abacavir  J05A… 4.41e5 Nucleosi… <chr>         0.6 g              NA #>  2 ACI      Aciclovir J05A… 1.35e8 Nucleosi… <chr>         4   g               4 #>  3 ADD      Adefovir… J05A… 6.09e4 Nucleosi… <chr>        10   mg             NA #>  4 AME      Amenamev… J05A… 1.14e7 Other an… <chr>         0.4 g              NA #>  5 AMP      Amprenav… J05A… 6.50e4 Protease… <chr>         1.2 g              NA #>  6 ASU      Asunapre… J05A… 1.61e7 Antivira… <chr>         0.2 g              NA #>  7 ATA      Atazanav… J05A… 1.48e5 Protease… <chr>         0.3 g              NA #>  8 ATA+COBI Atazanav… J05A… 8.66e7 Antivira… <chr>        NA   NA             NA #>  9 ATA+RIT  Atazanav… J05A… 2.51e7 Antivira… <chr>         0.3 g              NA #> 10 BAM      Baloxavi… J05A… 1.24e8 Other an… <chr>        40   mg             NA #> # ℹ 110 more rows #> # ℹ 2 more variables: iv_units <chr>, loinc <list>"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antibiotic ID — as.ab","title":"Transform Input to an Antibiotic ID — as.ab","text":"Use function determine antimicrobial drug code one antimicrobials. data set antimicrobials searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"as.ab(x, flag_multiple_results = TRUE, language = get_AMR_locale(),   info = interactive(), ...)  is.ab(x)  ab_reset_session()"},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antibiotic ID — as.ab","text":"x character vector determine antibiotic ID. flag_multiple_results logical indicate whether note printed console probably one antibiotic drug code name can retrieved single input value. language Language coerce input values 28 supported languages - default system language supported (see get_AMR_locale()). info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antibiotic ID — as.ab","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antibiotic ID — as.ab","text":"entries antimicrobials data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .ab() can correct different forms misspelling: Wrong spelling drug names (\"tobramicin\" \"gentamycin\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"mreopenem\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use ab_* functions get properties based returned antibiotic ID, see Examples. Note: .ab() ab_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems. can add manual codes considered .ab() ab_* functions, see add_custom_antimicrobials().","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antibiotic ID — as.ab","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antibiotic ID — as.ab","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antibiotic ID — as.ab","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.ab.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antibiotic ID — as.ab","text":"","code":"# these examples all return \"ERY\", the ID of erythromycin: as.ab(\"J01FA01\") #> Class 'ab' #> [1] ERY as.ab(\"J 01 FA 01\") #> Class 'ab' #> [1] ERY as.ab(\"Erythromycin\") #> Class 'ab' #> [1] ERY as.ab(\"eryt\") #> Class 'ab' #> [1] ERY as.ab(\"ERYT\") #> Class 'ab' #> [1] ERY as.ab(\"ERY\") #> Class 'ab' #> [1] ERY as.ab(\"eritromicine\") # spelled wrong, yet works #> Class 'ab' #> [1] ERY as.ab(\"Erythrocin\") # trade name #> Class 'ab' #> [1] ERY  # spelling from different languages and dyslexia are no problem ab_atc(\"ceftriaxon\") #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephtriaxone\") # small spelling error #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"cephthriaxone\") # or a bit more severe #> [1] \"J01DD04\"  \"QJ01DD04\" ab_atc(\"seephthriaaksone\") # and even this works #> [1] \"J01DD04\"  \"QJ01DD04\"  # use ab_* functions to get a specific properties (see ?ab_property); # they use as.ab() internally: ab_name(\"J01FA01\") #> [1] \"Erythromycin\" ab_name(\"eryt\") #> [1] \"Erythromycin\"  # \\donttest{ if (require(\"dplyr\")) {   # you can quickly rename 'sir' columns using set_ab_names() with dplyr:   example_isolates %>%     set_ab_names(where(is.sir), property = \"atc\") } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           J01CE01 J01CF04 J01CF05 #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir>   <sir>   <sir>   #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R       NA      NA    #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R       NA      S     #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R       NA      R     #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R       NA      S     #> # ℹ 1,990 more rows #> # ℹ 37 more variables: J01CA04 <sir>, J01CR02 <sir>, J01CA01 <sir>, #> #   J01CR05 <sir>, J01DB04 <sir>, J01DE01 <sir>, J01DC02 <sir>, J01DC01 <sir>, #> #   J01DD01 <sir>, J01DD02 <sir>, J01DD04 <sir>, J01GB03 <sir>, J01GB01 <sir>, #> #   J01GB06 <sir>, J01GB04 <sir>, J01EA01 <sir>, J01EE01 <sir>, J01XE01 <sir>, #> #   J01XX01 <sir>, J01XX08 <sir>, J01MA02 <sir>, J01MA14 <sir>, J01XA01 <sir>, #> #   J01XA02 <sir>, J01AA07 <sir>, J01AA12 <sir>, J01AA02 <sir>, … # }"},{"path":"https://amr-for-r.org/reference/as.av.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to an Antiviral Drug ID — as.av","title":"Transform Input to an Antiviral Drug ID — as.av","text":"Use function determine antiviral drug code one antiviral drugs. data set antivirals searched abbreviations, official names synonyms (brand names).","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"as.av(x, flag_multiple_results = TRUE, info = interactive(), ...)  is.av(x)"},{"path":"https://amr-for-r.org/reference/as.av.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to an Antiviral Drug ID — as.av","text":"x character vector determine antiviral drug ID. flag_multiple_results logical indicate whether note printed console probably one antiviral drug code name can retrieved single input value. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed internal functions.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to an Antiviral Drug ID — as.av","text":"character vector additional class ab","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to an Antiviral Drug ID — as.av","text":"entries antivirals data set three different identifiers: human readable EARS-Net code (column ab, used ECDC WHONET), ATC code (column atc, used ), CID code (column cid, Compound ID, used PubChem). data set contains 5,000 official brand names many different countries, found PubChem. drugs contain multiple ATC codes. properties searched user input. .av() can correct different forms misspelling: Wrong spelling drug names (\"acyclovir\"), corrects audible similarities f/ph, x/ks, c/z/s, t/th, etc. many vowels consonants Switching two characters (\"aycclovir\", often case clinical data, doctors typed fast) Digitalised paper records, leaving artefacts like 0/o/O (zero O's), B/8, n/r, etc. Use av_* functions get properties based returned antiviral drug ID, see Examples. Note: .av() av_* functions may use long regular expression match brand names antimicrobial drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Input to an Antiviral Drug ID — as.av","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"whocc","dir":"Reference","previous_headings":"","what":"WHOCC","title":"Transform Input to an Antiviral Drug ID — as.av","text":"package contains ~550 antibiotic, antimycotic antiviral drugs Anatomical Therapeutic Chemical (ATC) codes, ATC groups Defined Daily Dose (DDD) World Health Organization Collaborating Centre Drug Statistics Methodology (WHOCC, https://atcddd.fhi.) Pharmaceuticals Community Register European Commission (https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm). become gold standard international drug utilisation monitoring research. WHOCC located Oslo Norwegian Institute Public Health funded Norwegian government. European Commission executive European Union promotes general interest. NOTE: WHOCC copyright allow use commercial purposes, unlike info package. See https://atcddd.fhi./copyright_disclaimer/.","code":""},{"path":"https://amr-for-r.org/reference/as.av.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Input to an Antiviral Drug ID — as.av","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.av.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to an Antiviral Drug ID — as.av","text":"","code":"# these examples all return \"ACI\", the ID of aciclovir: as.av(\"J05AB01\") #> Class 'av' #> [1] ACI as.av(\"J 05 AB 01\") #> Class 'av' #> [1] ACI as.av(\"Aciclovir\") #> Class 'av' #> [1] ACI as.av(\"aciclo\") #> Class 'av' #> [1] ACI as.av(\"   aciclo 123\") #> Class 'av' #> [1] ACI as.av(\"ACICL\") #> Class 'av' #> [1] ACI as.av(\"ACI\") #> Class 'av' #> [1] ACI as.av(\"Virorax\") # trade name #> Class 'av' #> [1] ACI as.av(\"Zovirax\") # trade name #> Class 'av' #> [1] ACI  as.av(\"acyklofir\") # severe spelling error, yet works #> Class 'av' #> [1] ACI  # use av_* functions to get a specific properties (see ?av_property); # they use as.av() internally: av_name(\"J05AB01\") #> [1] \"Aciclovir\" av_name(\"acicl\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Disk Diffusion Diameters — as.disk","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"transforms vector new class disk, disk diffusion growth zone size (around antibiotic disk) millimetres 0 50.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"as.disk(x, na.rm = FALSE)  NA_disk_  is.disk(x)"},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"object class disk (inherits integer) length 1.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"x Vector. na.rm logical indicating whether missing values removed.","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"integer additional class disk","code":""},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"Interpret disk values SIR values .sir(). supports guidelines EUCAST CLSI. Disk diffusion growth zone sizes must 0 50 millimetres. Values higher 50 lower 100 maximised 50. others input values outside 0-50 range return NA. NA_disk_ missing value new disk class.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.disk.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Disk Diffusion Diameters — as.disk","text":"","code":"# transform existing disk zones to the `disk` class (using base R) df <- data.frame(   microorganism = \"Escherichia coli\",   AMP = 20,   CIP = 14,   GEN = 18,   TOB = 16 ) df[, 2:5] <- lapply(df[, 2:5], as.disk) str(df) #> 'data.frame':\t1 obs. of  5 variables: #>  $ microorganism: chr \"Escherichia coli\" #>  $ AMP          : 'disk' int 20 #>  $ CIP          : 'disk' int 14 #>  $ GEN          : 'disk' int 18 #>  $ TOB          : 'disk' int 16  # \\donttest{ # transforming is easier with dplyr: if (require(\"dplyr\")) {   df %>% mutate(across(AMP:TOB, as.disk)) } #>      microorganism AMP CIP GEN TOB #> 1 Escherichia coli  20  14  18  16 # }  # interpret disk values, see ?as.sir as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R  # interpret whole data set, pretend to be all from urinary tract infections: as.sir(df, uti = TRUE) #>      microorganism AMP  CIP GEN TOB #> 1 Escherichia coli   S <NA>   S   S"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"transforms vectors new class mic, treats input decimal numbers, maintaining operators (\">=\") allowing valid MIC values known field (medical) microbiology.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"as.mic(x, na.rm = FALSE, keep_operators = \"all\")  is.mic(x)  NA_mic_  rescale_mic(x, mic_range, keep_operators = \"edges\", as.mic = TRUE)  mic_p50(x, na.rm = FALSE, ...)  mic_p90(x, na.rm = FALSE, ...)  # S3 method for class 'mic' droplevels(x, as.mic = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"x character numeric vector. na.rm logical indicating whether missing values removed. keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values, e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). .mic logical indicate whether mic class kept - default TRUE rescale_mic() FALSE droplevels(). setting FALSE rescale_mic(), output factor levels acknowledge mic_range. ... Arguments passed methods.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"Ordered factor additional class mic, mathematical operations acts numeric vector. Bear mind outcome mathematical operation MICs return numeric value.","code":""},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"interpret MIC values SIR values, use .sir() MIC values. supports guidelines EUCAST (2011-2025) CLSI (2011-2025). class MIC values quite special data type: formally ordered factor valid MIC values factor levels (make sure valid MIC values retained), mathematical operation acts decimal numbers:   makes possible maintain operators often come MIC values, \">=\" \"<=\", even filtering using numeric values data analysis, e.g.:   -called group generic functions implemented MIC class (!, !=, <, >=, exp(), log2()). mathematical functions also implemented (quantile(), median(), fivenum()). Since sd() var() non-generic functions, extended. Use mad() alternative, use e.g. sd(.numeric(x)) x vector MIC values. Using .double() .numeric() MIC values remove operators return numeric vector. use .integer() MIC values R convention factors, return index factor levels (often useless regular users). function .mic() detects input contains class mic. input data.frame list, iterates columns/items returns logical vector. Use droplevels() drop unused levels. default, return plain factor. Use droplevels(..., .mic = TRUE) maintain mic class. rescale_mic(), existing MIC ranges can limited defined range MIC values. can useful better compare MIC distributions. ggplot2, use one scale_*_mic() functions plot MIC values. allows custom MIC ranges plot intermediate log2 levels missing MIC values. NA_mic_ missing value new mic class, analogous e.g. base R's NA_character_. Use mic_p50() mic_p90() get 50th 90th percentile MIC values. return 'normal' numeric values.","code":"x <- random_mic(10) x #> Class 'mic' #>  [1] 16     1      8      8      64     >=128  0.0625 32     32     16  is.factor(x) #> [1] TRUE  x[1] * 2 #> [1] 32  median(x) #> [1] 26 x[x > 4] #> Class 'mic' #> [1] 16    8     8     64    >=128 32    32    16  df <- data.frame(x, hospital = \"A\") subset(df, x > 4) # or with dplyr: df %>% filter(x > 4) #>        x hospital #> 1     16        A #> 5     64        A #> 6  >=128        A #> 8     32        A #> 9     32        A #> 10    16        A"},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mic.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Input to Minimum Inhibitory Concentrations (MIC) — as.mic","text":"","code":"mic_data <- as.mic(c(\">=32\", \"1.0\", \"1\", \"1.00\", 8, \"<=0.128\", \"8\", \"16\", \"16\")) mic_data #> Class 'mic' #> [1] >=32    1       1       1       8       <=0.128 8       16      16      is.mic(mic_data) #> [1] TRUE  # this can also coerce combined MIC/SIR values: as.mic(\"<=0.002; S\") #> Class 'mic' #> [1] <=0.002  # mathematical processing treats MICs as numeric values fivenum(mic_data) #> [1]  0.128  1.000  8.000 16.000 32.000 quantile(mic_data) #>     0%    25%    50%    75%   100%  #>  0.128  1.000  8.000 16.000 32.000  all(mic_data < 512) #> [1] TRUE  # rescale MICs using rescale_mic() rescale_mic(mic_data, mic_range = c(4, 16)) #> Class 'mic' #> [1] >=16 <=4  <=4  <=4  8    <=4  8    >=16 >=16  # interpret MIC values as.sir(   x = as.mic(2),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R as.sir(   x = as.mic(c(0.01, 2, 4, 8)),   mo = as.mo(\"Streptococcus pneumoniae\"),   ab = \"AMX\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] S R R R  # plot MIC values, see ?plot plot(mic_data)  plot(mic_data, mo = \"E. coli\", ab = \"cipro\")   if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\") }  if (require(\"ggplot2\")) {   autoplot(mic_data, mo = \"E. coli\", ab = \"cipro\", language = \"nl\") # Dutch }"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":null,"dir":"Reference","previous_headings":"","what":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Use function get valid microorganism code (mo) based arbitrary user input. Determination done using intelligent rules complete taxonomic tree kingdoms Animalia, Archaea, Bacteria, Chromista, Protozoa, microbial species kingdom Fungi (see Source). input can almost anything: full name (like \"Staphylococcus aureus\"), abbreviated name (\"S. aureus\"), abbreviation known field (\"MRSA\"), just genus. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"as.mo(x, Becker = FALSE, Lancefield = FALSE,   minimum_matching_score = NULL,   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE),   reference_df = get_mo_source(),   ignore_pattern = getOption(\"AMR_ignore_pattern\", NULL),   cleaning_regex = getOption(\"AMR_cleaning_regex\", mo_cleaning_regex()),   only_fungi = getOption(\"AMR_only_fungi\", FALSE),   language = get_AMR_locale(), info = interactive(), ...)  is.mo(x)  mo_uncertainties()  mo_renamed()  mo_failures()  mo_reset_session()  mo_cleaning_regex()"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"x character vector data.frame one two columns. Becker logical indicate whether staphylococci categorised coagulase-negative staphylococci (\"CoNS\") coagulase-positive staphylococci (\"CoPS\") instead species, according Karsten Becker et al. (see Source). Please see Details full list staphylococcal species converted. excludes Staphylococcus aureus default, use Becker = \"\" also categorise S. aureus \"CoPS\". Lancefield logical indicate whether beta-haemolytic Streptococcus categorised Lancefield groups instead species, according Rebecca C. Lancefield (see Source). streptococci categorised first group, e.g. Streptococcus dysgalactiae group C, although officially also categorised groups G L. . Please see Details full list streptococcal species converted. excludes enterococci default (group D), use Lancefield = \"\" also categorise enterococci group D. minimum_matching_score numeric value set lower limit MO matching score. left blank, determined automatically based character length x, taxonomic kingdom human pathogenicity. keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). reference_df data.frame used extra reference translating x valid mo. See set_mo_source() get_mo_source() automate usage codes (e.g. used analysis organisation). ignore_pattern Perl-compatible regular expression (case-insensitive) matches x must return NA. can convenient exclude known non-relevant input can also set package option AMR_ignore_pattern, e.g. options(AMR_ignore_pattern = \"(reported|contaminated flora)\"). cleaning_regex Perl-compatible regular expression (case-insensitive) clean input x. Every matched part x removed. default, outcome mo_cleaning_regex(), removes texts brackets texts \"species\" \"serovar\". default can set package option AMR_cleaning_regex. only_fungi logical indicate fungi must found, making sure e.g. misspellings always return records kingdom Fungi. can set globally microorganism functions package option AMR_only_fungi, .e. options(AMR_only_fungi = TRUE). language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). info logical indicate info must printed, e.g. progress bar 25 items coerced, list old taxonomic names. default TRUE interactive mode. ... arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"character vector additional class mo","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"microorganism (MO) code package (class: mo) human-readable typically looks like examples:   Values coerced considered 'unknown' return MO code UNKNOWN warning. Use mo_* functions get properties based returned code, see Examples. .mo() function uses novel scientifically validated (doi:10.18637/jss.v104.i03 ) matching score algorithm (see Matching Score Microorganisms ) match input available microbial taxonomy package. implicates e.g. \"E. coli\" (microorganism highly prevalent humans) return microbial ID Escherichia coli Entamoeba coli (microorganism less prevalent humans), although latter alphabetically come first.","code":"Code               Full name   ---------------    --------------------------------------   B_KLBSL            Klebsiella   B_KLBSL_PNMN       Klebsiella pneumoniae   B_KLBSL_PNMN_RHNS  Klebsiella pneumoniae rhinoscleromatis   |   |    |    |   |   |    |    |   |   |    |    \\---> subspecies, a 3-5 letter acronym   |   |    \\----> species, a 3-6 letter acronym   |   \\----> genus, a 4-8 letter acronym   \\----> kingdom: A (Archaea), AN (Animalia), B (Bacteria),                   C (Chromista), F (Fungi), PL (Plantae),                   P (Protozoa)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coping-with-uncertain-results","dir":"Reference","previous_headings":"","what":"Coping with Uncertain Results","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Results non-exact taxonomic input based matching score. lowest allowed score can set minimum_matching_score argument. default determined based character length input, taxonomic kingdom, human pathogenicity taxonomic outcome. values matched uncertainty, message shown suggest user inspect results mo_uncertainties(), returns data.frame specifications. increase quality matching, cleaning_regex argument used clean input. must regular expression matches parts input removed input matched available microbial taxonomy. matched Perl-compatible case-insensitive. default value cleaning_regex outcome helper function mo_cleaning_regex(). three helper functions can run using .mo() function: Use mo_uncertainties() get data.frame prints pretty format taxonomic names guessed. output contains matching score matches (see Matching Score Microorganisms ). Use mo_failures() get character vector values coerced valid value. Use mo_renamed() get data.frame values coerced based old, previously accepted taxonomic names.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"for-mycologists","dir":"Reference","previous_headings":"","what":"For Mycologists","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"matching score algorithm gives precedence bacteria fungi. analysing fungi, sure use only_fungi = TRUE, better yet, add code run every session:   make sure bacteria 'non-fungi' returned .mo(), mo_* functions.","code":"options(AMR_only_fungi = TRUE)"},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"coagulase-negative-and-coagulase-positive-staphylococci","dir":"Reference","previous_headings":"","what":"Coagulase-negative and Coagulase-positive Staphylococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Becker = TRUE, following staphylococci converted corresponding coagulase group: Coagulase-negative: S. americanisciuri, S. argensis, S. arlettae, S. auricularis, S. borealis, S. brunensis, S. caeli, S. caledonicus, S. canis, S. capitis, S. capitis capitis, S. capitis urealyticus, S. capitis ureolyticus, S. caprae, S. carnosus, S. carnosus carnosus, S. carnosus utilis, S. casei, S. caseolyticus, S. chromogenes, S. cohnii, S. cohnii cohnii, S. cohnii urealyticum, S. cohnii urealyticus, S. condimenti, S. croceilyticus, S. debuckii, S. devriesei, S. durrellii, S. edaphicus, S. epidermidis, S. equorum, S. equorum equorum, S. equorum linens, S. felis, S. fleurettii, S. gallinarum, S. haemolyticus, S. hominis, S. hominis hominis, S. hominis novobiosepticus, S. jettensis, S. kloosii, S. lentus, S. lloydii, S. lugdunensis, S. marylandisciuri, S. massiliensis, S. microti, S. muscae, S. nepalensis, S. pasteuri, S. petrasii, S. petrasii croceilyticus, S. petrasii jettensis, S. petrasii petrasii, S. petrasii pragensis, S. pettenkoferi, S. piscifermentans, S. pragensis, S. pseudoxylosus, S. pulvereri, S. ratti, S. rostri, S. saccharolyticus, S. saprophyticus, S. saprophyticus bovis, S. saprophyticus saprophyticus, S. schleiferi, S. schleiferi schleiferi, S. sciuri, S. sciuri carnaticus, S. sciuri lentus, S. sciuri rodentium, S. sciuri sciuri, S. shinii, S. simulans, S. stepanovicii, S. succinus, S. succinus casei, S. succinus succinus, S. taiwanensis, S. urealyticus, S. ureilyticus, S. veratri, S. vitulinus, S. vitulus, S. warneri, S. xylosus Coagulase-positive: S. agnetis, S. argenteus, S. coagulans, S. cornubiensis, S. delphini, S. hyicus, S. hyicus chromogenes, S. hyicus hyicus, S. intermedius, S. lutrae, S. pseudintermedius, S. roterodami, S. schleiferi coagulans, S. schweitzeri, S. simiae, S. singaporensis based : Becker K et al. (2014). Coagulase-Negative Staphylococci. Clin Microbiol Rev. 27(4): 870-926; doi:10.1128/CMR.00109-13 Becker K et al. (2019). Implications identifying recently defined members S. aureus complex, S. argenteus S. schweitzeri: position paper members ESCMID Study Group staphylococci Staphylococcal Diseases (ESGS). Clin Microbiol Infect; doi:10.1016/j.cmi.2019.02.028 Becker K et al. (2020). Emergence coagulase-negative staphylococci. Expert Rev Anti Infect Ther. 18(4):349-366; doi:10.1080/14787210.2020.1730813 newly named staphylococcal species, S. brunensis (2024) S. shinii (2023), looked scientific reference make sure species considered correct coagulase group.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"lancefield-groups-in-streptococci","dir":"Reference","previous_headings":"","what":"Lancefield Groups in Streptococci","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Lancefield = TRUE, following streptococci converted corresponding Lancefield group: Streptococcus Group : S. pyogenes Streptococcus Group B: S. agalactiae Streptococcus Group C: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis, S. equi, S. equi equi, S. equi ruminatorum, S. equi zooepidemicus Streptococcus Group F: S. anginosus, S. anginosus anginosus, S. anginosus whileyi, S. constellatus, S. constellatus constellatus, S. constellatus pharyngis, S. constellatus viborgensis, S. intermedius Streptococcus Group G: S. canis, S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis Streptococcus Group H: S. sanguinis Streptococcus Group K: S. salivarius, S. salivarius salivarius, S. salivarius thermophilus Streptococcus Group L: S. dysgalactiae, S. dysgalactiae dysgalactiae, S. dysgalactiae equisimilis based : Lancefield RC (1933). serological differentiation human groups hemolytic streptococci. J Exp Med. 57(4): 571-95; doi:10.1084/jem.57.4.571","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.mo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Transform Arbitrary Input to Valid Microbial Taxonomy — as.mo","text":"","code":"# \\donttest{ # These examples all return \"B_STPHY_AURS\", the ID of S. aureus: as.mo(c(   \"sau\", # WHONET code   \"stau\",   \"STAU\",   \"staaur\",   \"S. aureus\",   \"S aureus\",   \"Sthafilokkockus aureus\", # handles incorrect spelling   \"Staphylococcus aureus (MRSA)\",   \"MRSA\", # Methicillin Resistant S. aureus   \"VISA\", # Vancomycin Intermediate S. aureus   \"VRSA\", # Vancomycin Resistant S. aureus   115329001 # SNOMED CT code )) #> Class 'mo' #>  [1] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #>  [6] B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS B_STPHY_AURS #> [11] B_STPHY_AURS B_STPHY_AURS  # Dyslexia is no problem - these all work: as.mo(c(   \"Ureaplasma urealyticum\",   \"Ureaplasma urealyticus\",   \"Ureaplasmium urealytica\",   \"Ureaplazma urealitycium\" )) #> Class 'mo' #> [1] B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY B_URPLS_URLY  # input will get cleaned up with the input given in the `cleaning_regex` argument, # which defaults to `mo_cleaning_regex()`: cat(mo_cleaning_regex(), \"\\n\") #> ([^A-Za-z- \\(\\)\\[\\]{}]+|([({]|\\[).+([})]|\\])|(^| )( ?[a-z-]+[-](resistant|susceptible) ?|e?spp([^a-z]+|$)|e?ssp([^a-z]+|$)|serogr.?up[a-z]*|e?ss([^a-z]+|$)|e?sp([^a-z]+|$)|var([^a-z]+|$)|serovar[a-z]*|sube?species|biovar[a-z]*|e?species|Ig[ADEGM]|e?subsp|biotype|titer|dummy))   as.mo(\"Streptococcus group A\") #> Class 'mo' #> [1] B_STRPT_GRPA  as.mo(\"S. epidermidis\") # will remain species: B_STPHY_EPDR #> Class 'mo' #> [1] B_STPHY_EPDR as.mo(\"S. epidermidis\", Becker = TRUE) # will not remain species: B_STPHY_CONS #> Class 'mo' #> [1] B_STPHY_CONS  as.mo(\"S. pyogenes\") # will remain species: B_STRPT_PYGN #> Class 'mo' #> [1] B_STRPT_PYGN as.mo(\"S. pyogenes\", Lancefield = TRUE) # will not remain species: B_STRPT_GRPA #> Class 'mo' #> [1] B_STRPT_GRPA  # All mo_* functions use as.mo() internally too (see ?mo_property): mo_genus(\"E. coli\") #> [1] \"Escherichia\" mo_gramstain(\"ESCO\") #> [1] \"Gram-negative\" mo_is_intrinsic_resistant(\"ESCCOL\", ab = \"vanco\") #> ℹ Determining intrinsic resistance based on 'EUCAST Expected Resistant #>   Phenotypes' v1.2 (2023). This note will be shown once per session. #> [1] TRUE # }"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":null,"dir":"Reference","previous_headings":"","what":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Clean existing SIR values, interpret minimum inhibitory concentration (MIC) values disk diffusion diameters according EUCAST CLSI. .sir() transforms input new class sir, ordered factor containing levels S, SDD, , R, NI. Breakpoints currently implemented EUCAST 2011-2025 CLSI 2011-2025, see Details. breakpoints used interpretation available clinical_breakpoints data set.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"as.sir(x, ...)  NA_sir_  is.sir(x)  is_sir_eligible(x, threshold = 0.05)  # Default S3 method as.sir(x, S = \"^(S|U)+$\", I = \"^(I)+$\", R = \"^(R)+$\",   NI = \"^(N|NI|V)+$\", SDD = \"^(SDD|D|H)+$\", info = interactive(), ...)  # S3 method for class 'mic' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   language = get_AMR_locale(), verbose = FALSE, info = interactive(),   conserve_capped_values = NULL, ...)  # S3 method for class 'disk' as.sir(x, mo = NULL, ab = deparse(substitute(x)),   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   language = get_AMR_locale(), verbose = FALSE, info = interactive(),   ...)  # S3 method for class 'data.frame' as.sir(x, ..., col_mo = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"), uti = NULL,   capped_mic_handling = getOption(\"AMR_capped_mic_handling\", \"standard\"),   add_intrinsic_resistance = FALSE,   reference_data = AMR::clinical_breakpoints,   substitute_missing_r_breakpoint = getOption(\"AMR_substitute_missing_r_breakpoint\",   FALSE), include_screening = getOption(\"AMR_include_screening\", FALSE),   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), host = NULL,   language = get_AMR_locale(), verbose = FALSE, info = interactive(),   parallel = FALSE, max_cores = -1, conserve_capped_values = NULL)  sir_interpretation_history(clean = FALSE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpretations minimum inhibitory concentration (MIC) values disk diffusion diameters: CLSI M39: Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. CLSI M100: Performance Standard Antimicrobial Susceptibility Testing, 2011-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m100/. CLSI VET01: Performance Standards Antimicrobial Disk Dilution Susceptibility Tests Bacteria Isolated Animals, 2019-2025, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/veterinary-medicine/documents/vet01/. EUCAST Breakpoint tables interpretation MICs zone diameters, 2011-2025, European Committee Antimicrobial Susceptibility Testing (EUCAST). https://www.eucast.org/clinical_breakpoints. WHONET source machine-reading clinical breakpoints (read ), 1989-2025, Collaborating Centre Surveillance Antimicrobial Resistance. https://whonet.org/.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"x Vector values (class mic: MIC values mg/L, class disk: disk diffusion radius millimetres). ... using data.frame: selection columns apply .sir() . Supports tidyselect language (.mic), starts_with(...), column1:column4, can thus also antimicrobial selectors .sir(df, penicillins()). Otherwise: arguments passed methods. threshold Maximum fraction invalid antimicrobial interpretations x, see Examples. S, , R, NI, SDD case-independent regular expression translate input result. regular expression run non-letters whitespaces removed input. info logical print information process, defaults TRUE interactive sessions. mo vector (column name) characters can coerced valid microorganism codes .mo(), can left empty determine automatically. ab vector (column name) characters can coerced valid antimicrobial drug code .ab(). guideline guideline name (column name) use SIR interpretation. Defaults EUCAST 2025 (latest implemented EUCAST guideline clinical_breakpoints data set), can set package option AMR_guideline. Currently supports EUCAST (2011-2025) CLSI (2011-2025), see Details. Using column name allows straightforward interpretation historical data, must analysed context , example, different years. uti (Urinary Tract Infection) vector (column name) logicals (TRUE FALSE) specify whether UTI specific interpretation guideline chosen. using .sir() data.frame, can also column containing logicals left blank, data set searched column 'specimen', rows within column containing 'urin' ('urine', 'urina') regarded isolates UTI. See Examples. capped_mic_handling character string controls MIC values cap (.e., starting <, <=, >, >=) interpreted. Supports following options: \"none\" <= >= treated -. < > treated -. \"conservative\" <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < always returns \"S\", > always returns \"R\". \"standard\" (default) <= >= return \"NI\" (non-interpretable) MIC within breakpoint guideline range. < > treated -. \"inverse\" <= >= treated -. < always returns \"S\", > always returns \"R\". default \"standard\" setting ensures cautious handling uncertain values preserving interpretability. option can also set package option AMR_capped_mic_handling. add_intrinsic_resistance (useful using EUCAST guideline) logical indicate whether intrinsic antibiotic resistance must also considered applicable bug-drug combinations, meaning e.g. ampicillin always return \"R\" Klebsiella species. Determination based intrinsic_resistant data set, based 'EUCAST Expert Rules' 'EUCAST Intrinsic Resistance Unusual Phenotypes' v3.3 (2021). reference_data data.frame used interpretation, defaults clinical_breakpoints data set. Changing argument allows using interpretation guidelines. argument must contain data set equal structure clinical_breakpoints data set (column names column types). Please note guideline argument ignored reference_data manually set. substitute_missing_r_breakpoint logical indicate missing clinical breakpoints R (resistant) must substituted R - default FALSE. (especially CLSI) breakpoints breakpoint S, meaning outcome can \"S\" NA. Setting TRUE convert NAs cases \"R\". Can also set package option AMR_substitute_missing_r_breakpoint. include_screening logical indicate clinical breakpoints screening allowed - default FALSE. Can also set package option AMR_include_screening. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". host vector (column name) characters indicate host. useful veterinary breakpoints, requires breakpoint_type = \"animal\". values can text resembling animal species, even 28 supported languages package. foreign languages, sure set language set_AMR_locale() (though automatically guessed based system language). language Language convert values set host using animal breakpoints. Use one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). verbose logical indicate notes printed interpretation MIC values disk diffusion values. conserve_capped_values Deprecated, use capped_mic_handling instead. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). parallel logical indicate parallel computing must used, defaults FALSE. requires additional packages, used parallel package part base R. Windows R < 4.0.0 parallel::parLapply() used, cases efficient parallel::mclapply() used. max_cores Maximum number cores use parallel = TRUE. Use negative value subtract number available number cores, e.g. value -2 8-core machine means 6 cores used. Defaults -1. never used cores variables analyse. available number cores detected using parallelly::availableCores() package installed, base R's parallel::detectCores() otherwise. clean logical indicate whether previously stored results forgotten returning 'logbook' results.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Ordered factor new class sir","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"Note: clinical breakpoints package validated , imported , WHONET. public use AMR package endorsed CLSI EUCAST. See clinical_breakpoints information. NA_sir_ missing value new sir class, analogous e.g. base R's NA_character_.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"how-it-works","dir":"Reference","previous_headings":"","what":"How it Works","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":".sir() function can work four ways: cleaning raw / untransformed data. data cleaned contain valid values, namely: S susceptible, intermediate 'susceptible, increased exposure', R resistant, NI non-interpretable, SDD susceptible dose-dependent. can set using regular expression. Furthermore, .sir() try best clean intelligence. example, mixed values SIR interpretations MIC values \"<0.25; S\" coerced \"S\". Combined interpretations multiple test methods (seen laboratory records) \"S; S\" coerced \"S\", value like \"S; \" return NA warning input invalid. interpreting minimum inhibitory concentration (MIC) values according EUCAST CLSI. must clean MIC values first using .mic(), also gives columns new data class mic. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   Operators like \"<=\" stripped interpretation. using capped_mic_handling = \"conservative\", MIC value e.g. \">2\" always return \"R\", even breakpoint according chosen guideline \">=4\". prevent capped values raw laboratory data treated conservatively. default behaviour (capped_mic_handling = \"standard\") considers \">2\" lower \">=4\" might case return \"S\" \"\". Note: using CLSI guideline, MIC values must log2-based doubling dilutions. Values format, automatically rounded nearest log2 level CLSI instructs, warning thrown. interpreting disk diffusion diameters according EUCAST CLSI. must clean disk zones first using .disk(), also gives columns new data class disk. Also, sure column microorganism names codes. found automatically, can set manually using mo argument. Example apply using dplyr:   interpreting complete data set, automatic determination MIC values, disk diffusion diameters, microorganism names codes, antimicrobial test results. done simply running .sir(your_data). points 2, 3 4: Use sir_interpretation_history() retrieve data.frame results previous .sir() calls. also contains notes interpretation, exact input output values.","code":"your_data %>% mutate_if(is.mic, as.sir) your_data %>% mutate(across(where(is.mic), as.sir)) your_data %>% mutate_if(is.mic, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.mic, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.mic, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE) your_data %>% mutate_if(is.disk, as.sir) your_data %>% mutate(across(where(is.disk), as.sir)) your_data %>% mutate_if(is.disk, as.sir, ab = \"column_with_antibiotics\", mo = \"column_with_microorganisms\") your_data %>% mutate_if(is.disk, as.sir, ab = c(\"cipro\", \"ampicillin\", ...), mo = c(\"E. coli\", \"K. pneumoniae\", ...))  # for veterinary breakpoints, also set `host`: your_data %>% mutate_if(is.disk, as.sir, host = \"column_with_animal_species\", guideline = \"CLSI\")  # fast processing with parallel computing: as.sir(your_data, ..., parallel = TRUE)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"supported-guidelines","dir":"Reference","previous_headings":"","what":"Supported Guidelines","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"interpreting MIC values well disk diffusion diameters, currently implemented guidelines : clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. guideline argument must set e.g., \"EUCAST 2025\" \"CLSI 2025\". simply using \"EUCAST\" (default) \"CLSI\" input, latest included version guideline automatically selected. Importantly, using column name data instead, allows straightforward interpretation historical data must analysed context , example, different years. can set data set using reference_data argument. guideline argument ignored. also possible set default guideline package option AMR_guideline (e.g. .Rprofile file), :","code":"options(AMR_guideline = \"CLSI\")   options(AMR_guideline = \"CLSI 2018\")   options(AMR_guideline = \"EUCAST 2020\")   # or to reset:   options(AMR_guideline = NULL)"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"working-with-veterinary-breakpoints","dir":"Reference","previous_headings":"","what":"Working with Veterinary Breakpoints","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using veterinary breakpoints (.e., setting breakpoint_type = \"animal\"), column animal species must available set manually using host argument. column must contain names like \"dogs\", \"cats\", \"cattle\", \"swine\", \"horses\", \"poultry\", \"aquatic\". animal names like \"goats\", \"rabbits\", \"monkeys\" also recognised may available guidelines. Matching case-insensitive accepts Latin-based synonyms (e.g., \"bovine\" cattle \"canine\" dogs). Regarding choice veterinary guidelines, might best options set analysis:","code":"options(AMR_guideline = \"CLSI\")   options(AMR_breakpoint_type = \"animal\")"},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"after-interpretation","dir":"Reference","previous_headings":"","what":"After Interpretation","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"using .sir(), can use eucast_rules() defined EUCAST (1) apply inferred susceptibility resistance based results antimicrobials (2) apply intrinsic resistance based taxonomic properties microorganism. determine isolates multi-drug resistant, sure run mdro() (applies MDR/PDR/XDR guideline 2012 default) data set contains S//R values. Read interpreting multidrug-resistant organisms .","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"function .sir() detects input contains class sir. input data.frame list, iterates columns/items returns logical vector. base R function .double() can used retrieve quantitative values sir object: \"S\" = 1, \"\"/\"SDD\" = 2, \"R\" = 3. values rendered NA. Note: use .integer(), since (R works internally) return factor level indices, aforementioned quantitative values. function is_sir_eligible() returns TRUE column contains 5% potentially invalid antimicrobial interpretations, FALSE otherwise. threshold 5% can set threshold argument. input data.frame, iterates columns returns logical vector.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/as.sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Interpret MIC and Disk Diffusion as SIR, or Clean Existing SIR Data — as.sir","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  summary(example_isolates[, 1:10]) # see all SIR results at a glance #>       date              patient               age           gender          #>  Min.   :2002-01-02   Length:2000        Min.   : 0.00   Length:2000        #>  1st Qu.:2005-07-31   Class :character   1st Qu.:63.00   Class :character   #>  Median :2009-07-31   Mode  :character   Median :74.00   Mode  :character   #>  Mean   :2009-11-20                      Mean   :70.69                      #>  3rd Qu.:2014-05-30                      3rd Qu.:82.00                      #>  Max.   :2017-12-28                      Max.   :97.00                      #>      ward                mo                  PEN                 #>  Length:2000        Class :mo             Class:sir              #>  Class :character   <NA>  :0              %S   :25.6% (n=417)    #>  Mode  :character   Unique:90             %SDD : 0.0% (n=0)      #>                     #1    :B_ESCHR_COLI   %I   : 0.7% (n=11)     #>                     #2    :B_STPHY_CONS   %R   :73.7% (n=1201)   #>                     #3    :B_STPHY_AURS   %NI  : 0.0% (n=0)      #>     OXA                   FLC                   AMX                #>  Class:sir             Class:sir             Class:sir             #>  %S   :68.8% (n=251)   %S   :70.5% (n=665)   %S   :40.2% (n=543)   #>  %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     %SDD : 0.0% (n=0)     #>  %I   : 0.0% (n=0)     %I   : 0.0% (n=0)     %I   : 0.2% (n=3)     #>  %R   :31.2% (n=114)   %R   :29.5% (n=278)   %R   :59.6% (n=804)   #>  %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)     %NI  : 0.0% (n=0)      # create some example data sets, with combined MIC values and disk zones df_wide <- data.frame(   microorganism = \"Escherichia coli\",   amoxicillin = as.mic(8),   cipro = as.mic(0.256),   tobra = as.disk(16),   genta = as.disk(18),   ERY = \"R\" ) df_long <- data.frame(   bacteria = rep(\"Escherichia coli\", 4),   antibiotic = c(\"amoxicillin\", \"cipro\", \"tobra\", \"genta\"),   mics = as.mic(c(0.01, 1, 4, 8)),   disks = as.disk(c(6, 10, 14, 18)),   guideline = c(\"EUCAST 2021\", \"EUCAST 2022\", \"EUCAST 2023\", \"EUCAST 2024\") ) # and clean previous SIR interpretation logs x <- sir_interpretation_history(clean = TRUE)   # For INTERPRETING disk diffusion and MIC values -----------------------  # most basic application: as.sir(df_wide) #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R  # return a 'logbook' about the results: sir_interpretation_history() #> # A tibble: 4 × 18 #>   datetime            index method ab_given    mo_given   host_given input_given #>   <dttm>              <int> <chr>  <chr>       <chr>      <chr>      <chr>       #> 1 2025-07-23 20:22:30     1 MIC    amoxicillin Escherich… human      8           #> 2 2025-07-23 20:22:30     1 MIC    cipro       Escherich… human      0.256       #> 3 2025-07-23 20:22:30     1 DISK   tobra       Escherich… human      16          #> 4 2025-07-23 20:22:31     1 DISK   genta       Escherich… human      18          #> # ℹ 11 more variables: ab <ab>, mo <mo>, host <chr>, input <chr>, #> #   outcome <sir>, notes <chr>, guideline <chr>, ref_table <chr>, uti <lgl>, #> #   breakpoint_S_R <chr>, site <chr>  # \\donttest{ # using parallel computing, which is available in base R: as.sir(df_wide, parallel = TRUE, info = TRUE) #> ℹ Returning previously coerced values for various antimicrobials. Run #>   `ab_reset_session()` to reset this. This note will be shown once per #>   session. #>  #> Running in parallel mode using 3 out of 4 cores, on columns 'amoxicillin', #> 'cipro', 'tobra', 'genta', and 'ERY'... #>  DONE #>  #>  #> ℹ Run `sir_interpretation_history()` to retrieve a logbook with all details #>   of the breakpoint interpretations. #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           S     I     S     S   R   ## Using dplyr ------------------------------------------------- if (require(\"dplyr\")) {   # approaches that all work without additional arguments:   df_wide %>% mutate_if(is.mic, as.sir)   df_wide %>% mutate_if(function(x) is.mic(x) | is.disk(x), as.sir)   df_wide %>% mutate(across(where(is.mic), as.sir))    df_wide %>% mutate_at(vars(amoxicillin:tobra), as.sir)   df_wide %>% mutate(across(amoxicillin:tobra, as.sir))    df_wide %>% mutate(across(aminopenicillins(), as.sir))    # approaches that all work with additional arguments:   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       guideline = \"guideline\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     # given certain columns, e.g. from 'cipro' to 'genta'     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           guideline = \"CLSI\"         )       }     ))    # for veterinary breakpoints, add 'host':   df_long$animal_species <- c(\"cats\", \"dogs\", \"horses\", \"cattle\")   df_long %>%     # given a certain data type, e.g. MIC values     mutate_if(is.mic, as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_long %>%     mutate(across(       where(is.mic),       function(x) {         as.sir(x,           mo = \"bacteria\",           ab = \"antibiotic\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))   df_wide %>%     mutate_at(vars(cipro:genta), as.sir,       mo = \"bacteria\",       ab = \"antibiotic\",       host = \"animal_species\",       guideline = \"CLSI\"     )   df_wide %>%     mutate(across(       cipro:genta,       function(x) {         as.sir(x,           mo = \"bacteria\",           host = \"animal_species\",           guideline = \"CLSI\"         )       }     ))    # to include information about urinary tract infections (UTI)   data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     from_the_bladder = c(TRUE, FALSE)   ) %>%     as.sir(uti = \"from_the_bladder\")    data.frame(     mo = \"E. coli\",     nitrofuratoin = c(\"<= 2\", 32),     specimen = c(\"urine\", \"blood\")   ) %>%     as.sir() # automatically determines urine isolates    df_wide %>%     mutate_at(vars(cipro:genta), as.sir, mo = \"E. coli\", uti = TRUE) } #> ℹ For `aminopenicillins()` using column 'amoxicillin' #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `mics = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Interpreting MIC values: 'antibiotic' (ASP, acetylspiramycin), CLSI 2025... #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #> Interpreting disk diffusion zones: 'antibiotic' (ASP, acetylspiramycin), #> CLSI 2025... #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `cipro = (function (x, ...) ...`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `across(...)`. #> Caused by warning: #> ! Some MICs were converted to the nearest higher log2 level, following the #> CLSI interpretation guideline. #>      microorganism amoxicillin cipro tobra genta ERY #> 1 Escherichia coli           8  <NA>     S     S   R   ## Using base R ------------------------------------------------   # for single values as.sir(   x = as.mic(2),   mo = as.mo(\"S. pneumoniae\"),   ab = \"AMP\",   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R  as.sir(   x = as.disk(18),   mo = \"Strep pneu\", # `mo` will be coerced with as.mo()   ab = \"ampicillin\", # and `ab` with as.ab()   guideline = \"EUCAST\" ) #> Class 'sir' #> [1] R   # For CLEANING existing SIR values -------------------------------------  as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", \"A\", \"B\", \"C\")) #> Warning: in `as.sir()`: 3 results in index '21' truncated (38%) that were invalid #> antimicrobial interpretations: \"A\", \"B\", and \"C\" #> Class 'sir' #> [1] S    SDD  I    R    NI   <NA> <NA> <NA> as.sir(\"<= 0.002; S\") # will return \"S\" #> Class 'sir' #> [1] S sir_data <- as.sir(c(rep(\"S\", 474), rep(\"I\", 36), rep(\"R\", 370))) is.sir(sir_data) #> [1] TRUE plot(sir_data) # for percentages  barplot(sir_data) # for frequencies   # as common in R, you can use as.integer() to return factor indices: as.integer(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  3  4  5 NA  # but for computational use, as.double() will return 1 for S, 2 for I/SDD, and 3 for R: as.double(as.sir(c(\"S\", \"SDD\", \"I\", \"R\", \"NI\", NA))) #> [1]  1  2  2  3 NA NA  # the dplyr way if (require(\"dplyr\")) {   example_isolates %>%     mutate_at(vars(PEN:RIF), as.sir)   # same:   example_isolates %>%     as.sir(PEN:RIF)    # fastest way to transform all columns with already valid AMR results to class `sir`:   example_isolates %>%     mutate_if(is_sir_eligible, as.sir)    # since dplyr 1.0.0, this can also be the more impractical:   # example_isolates %>%   #   mutate(across(where(is_sir_eligible), as.sir)) } #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":null,"dir":"Reference","previous_headings":"","what":"Get ATC Properties from WHOCC Website — atc_online_property","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Gets data WHOCC website determine properties Anatomical Therapeutic Chemical (ATC) (e.g. antimicrobial), name, defined daily dose (DDD) standard unit.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"atc_online_property(atc_code, property, administration = \"O\",   url = \"https://atcddd.fhi.no/atc_ddd_index/?code=%s&showdescription=no\",   url_vet = \"https://atcddd.fhi.no/atcvet/atcvet_index/?code=%s&showdescription=no\")  atc_online_groups(atc_code, ...)  atc_online_ddd(atc_code, ...)  atc_online_ddd_units(atc_code, ...)"},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"https://atcddd.fhi./atc_ddd_alterations__cumulative/ddd_alterations/abbrevations/","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"atc_code character (vector) ATC code(s) antimicrobials, coerced .ab() ab_atc() internally valid ATC code. property Property ATC code. Valid values \"ATC\", \"Name\", \"DDD\", \"U\" (\"unit\"), \"Adm.R\", \"Note\" groups. last option, hierarchical groups ATC code returned, see Examples. administration Type administration using property = \"Adm.R\", see Details. url URL website WHOCC. sign %s can used placeholder ATC codes. url_vet URL website WHOCC veterinary medicine. sign %s can used placeholder ATC_vet codes (start \"Q\"). ... Arguments pass atc_property.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"Options argument administration: \"Implant\" = Implant \"Inhal\" = Inhalation \"Instill\" = Instillation \"N\" = nasal \"O\" = oral \"P\" = parenteral \"R\" = rectal \"SL\" = sublingual/buccal \"TD\" = transdermal \"V\" = vaginal Abbreviations return values using property = \"U\" (unit): \"g\" = gram \"mg\" = milligram \"mcg\" = microgram \"U\" = unit \"TU\" = thousand units \"MU\" = million units \"mmol\" = millimole \"ml\" = millilitre (e.g. eyedrops) N.B. function requires internet connection works following packages installed: curl, rvest, xml2.","code":""},{"path":"https://amr-for-r.org/reference/atc_online.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get ATC Properties from WHOCC Website — atc_online_property","text":"","code":"# \\donttest{ if (requireNamespace(\"curl\") && requireNamespace(\"rvest\") && requireNamespace(\"xml2\")) {   # oral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"O\")   atc_online_ddd(ab_atc(\"amox\"))    # parenteral DDD (Defined Daily Dose) of amoxicillin   atc_online_property(\"J01CA04\", \"DDD\", \"P\")    atc_online_property(\"J01CA04\", property = \"groups\") # search hierarchical groups of amoxicillin } #> Loading required namespace: rvest #> ℹ in `atc_online_property()`: no properties found for ATC QG51AA03. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QG51AA03&showdescription=no. #> ℹ in `atc_online_property()`: no properties found for ATC QJ01CA04. Please #>   check #>   https://atcddd.fhi.no/atcvet/atcvet_index/?code=QJ01CA04&showdescription=no. #> [1] \"ANTIINFECTIVES FOR SYSTEMIC USE\"         #> [2] \"ANTIBACTERIALS FOR SYSTEMIC USE\"         #> [3] \"BETA-LACTAM ANTIBACTERIALS, PENICILLINS\" #> [4] \"Penicillins with extended spectrum\"      # }"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Use function e.g. clinical texts health care records. returns list antiviral drugs, doses forms administration found texts.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(text, type = c(\"drug\", \"dose\", \"administration\"),   collapse = NULL, translate_av = FALSE, thorough_search = NULL,   info = interactive(), ...)"},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"text Text analyse. type Type property search , either \"drug\", \"dose\" \"administration\", see Examples. collapse character pass paste(, collapse = ...) return one character per element text, see Examples. translate_av type = \"drug\": column name antivirals data set translate antibiotic abbreviations , using av_property(). default FALSE. Using TRUE equal using \"name\". thorough_search logical indicate whether input must extensively searched misspelling faulty input values. Setting TRUE take considerably time using FALSE. default, turn TRUE input elements contain maximum three words. info logical indicate whether progress bar printed - default TRUE interactive mode. ... Arguments passed .av().","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"list,  character collapse NULL","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"function also internally used .av(), although searches first drug name throw note drug names returned. Note: .av() function may use long regular expression match brand names antiviral drugs. may fail systems.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-type","dir":"Reference","previous_headings":"","what":"Argument type","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"default, function search antiviral drug names. text elements searched official names, ATC codes brand names. uses .av() internally, correct misspelling. type = \"dose\" (similar, like \"dosing\", \"doses\"), text elements searched numeric values higher 100 resemble years. output numeric. supports unit (g, mg, IE, etc.) multiple values one clinical text, see Examples. type = \"administration\" (abbreviations, like \"admin\", \"adm\"), text elements searched form drug administration. supports following forms (including common abbreviations): buccal, implant, inhalation, instillation, intravenous, nasal, oral, parenteral, rectal, sublingual, transdermal vaginal. Abbreviations oral ('po', 'per os') become \"oral\", values intravenous ('iv', 'intraven') become \"iv\". supports multiple values one clinical text, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"argument-collapse","dir":"Reference","previous_headings":"","what":"Argument collapse","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"Without using collapse, function return list. can convenient use e.g. inside mutate()):df %>% mutate(avx = av_from_text(clinical_text)) returned AV codes can transformed official names, groups, etc. av_* functions av_name() av_group(), using translate_av argument. using collapse, function return character:df %>% mutate(avx = av_from_text(clinical_text, collapse = \"|\"))","code":""},{"path":"https://amr-for-r.org/reference/av_from_text.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Retrieve Antiviral Drug Names and Doses from Clinical Text — av_from_text","text":"","code":"av_from_text(\"28/03/2020 valaciclovir po tid\") #> [[1]] #> Class 'av' #> [1] VALA #>  av_from_text(\"28/03/2020 valaciclovir po tid\", type = \"admin\") #> [[1]] #> [1] \"oral\" #>"},{"path":"https://amr-for-r.org/reference/av_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of an Antiviral Drug — av_property","title":"Get Properties of an Antiviral Drug — av_property","text":"Use functions return specific property antiviral drug antivirals data set. input values evaluated internally .av().","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"av_name(x, language = get_AMR_locale(), tolower = FALSE, ...)  av_cid(x, ...)  av_synonyms(x, ...)  av_tradenames(x, ...)  av_group(x, language = get_AMR_locale(), ...)  av_atc(x, ...)  av_loinc(x, ...)  av_ddd(x, administration = \"oral\", ...)  av_ddd_units(x, administration = \"oral\", ...)  av_info(x, language = get_AMR_locale(), ...)  av_url(x, open = FALSE, ...)  av_property(x, property = \"name\", language = get_AMR_locale(), ...)"},{"path":"https://amr-for-r.org/reference/av_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of an Antiviral Drug — av_property","text":"x (vector ) text can coerced valid antiviral drug code .av(). language Language returned text - default system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. tolower logical indicate whether first character every output transformed lower case character. ... arguments passed .av(). administration Way administration, either \"oral\" \"iv\". open Browse URL using utils::browseURL(). property One column names one antivirals data set: vector_or(colnames(antivirals), sort = FALSE).","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of an Antiviral Drug — av_property","text":"integer case av_cid() named list case av_info() multiple av_atc()/av_synonyms()/av_tradenames() double case av_ddd() character cases","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of an Antiviral Drug — av_property","text":"output translated possible. function av_url() return direct URL official website. warning returned required ATC code available.","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of an Antiviral Drug — av_property","text":"World Health Organization () Collaborating Centre Drug Statistics Methodology: https://atcddd.fhi./atc_ddd_index/ European Commission Public Health PHARMACEUTICALS - COMMUNITY REGISTER: https://ec.europa.eu/health/documents/community-register/html/reg_hum_atc.htm","code":""},{"path":"https://amr-for-r.org/reference/av_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of an Antiviral Drug — av_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/av_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of an Antiviral Drug — av_property","text":"","code":"# all properties: av_name(\"ACI\") #> [1] \"Aciclovir\" av_atc(\"ACI\") #> [1] \"J05AB01\" av_cid(\"ACI\") #> [1] 135398513 av_synonyms(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_tradenames(\"ACI\") #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            av_group(\"ACI\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_url(\"ACI\") #>                                                              Aciclovir  #> \"https://atcddd.fhi.no/atc_ddd_index/?code=J05AB01&showdescription=no\"   # lowercase transformation av_name(x = c(\"ACI\", \"VALA\")) #> [1] \"Aciclovir\"    \"Valaciclovir\" av_name(x = c(\"ACI\", \"VALA\"), tolower = TRUE) #> [1] \"aciclovir\"    \"valaciclovir\"  # defined daily doses (DDD) av_ddd(\"ACI\", \"oral\") #> [1] 4 av_ddd_units(\"ACI\", \"oral\") #> [1] \"g\" av_ddd(\"ACI\", \"iv\") #> [1] 4 av_ddd_units(\"ACI\", \"iv\") #> [1] \"g\"  av_info(\"ACI\") # all properties as a list #> $av #> [1] \"ACI\" #>  #> $cid #> [1] 135398513 #>  #> $name #> [1] \"Aciclovir\" #>  #> $group #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" #>  #> $atc #> [1] \"J05AB01\" #>  #> $tradenames #>  [1] \"acicloftal\"        \"aciclovier\"        \"aciclovirum\"       #>  [4] \"activir\"           \"acyclofoam\"        \"acycloguanosine\"   #>  [7] \"acyclovir\"         \"acyclovir lauriad\" \"avaclyr\"           #> [10] \"cargosil\"          \"cyclovir\"          \"genvir\"            #> [13] \"gerpevir\"          \"hascovir\"          \"maynar\"            #> [16] \"novirus\"           \"poviral\"           \"sitavig\"           #> [19] \"sitavir\"           \"vipral\"            \"viropump\"          #> [22] \"virorax\"           \"zovirax\"           \"zyclir\"            #>  #> $loinc #> [1] \"\" #>  #> $ddd #> $ddd$oral #> $ddd$oral$amount #> [1] 4 #>  #> $ddd$oral$units #> [1] \"g\" #>  #>  #> $ddd$iv #> $ddd$iv$amount #> [1] 4 #>  #> $ddd$iv$units #> [1] \"g\" #>  #>  #>   # all av_* functions use as.av() internally, so you can go from 'any' to 'any': av_atc(\"ACI\") #> [1] \"J05AB01\" av_group(\"J05AB01\") #> [1] \"Nucleosides and nucleotides excl. reverse transcriptase inhibitors\" av_loinc(\"abacavir\") #> [1] \"29113-8\" \"30273-7\" \"30287-7\" \"30303-2\" \"78772-1\" \"78773-9\" \"79134-3\" #> [8] \"80118-3\" av_name(\"29113-8\") #> [1] \"Abacavir\" av_name(135398513) #> [1] \"Aciclovir\" av_name(\"J05AB01\") #> [1] \"Aciclovir\""},{"path":"https://amr-for-r.org/reference/availability.html","id":null,"dir":"Reference","previous_headings":"","what":"Check Availability of Columns — availability","title":"Check Availability of Columns — availability","text":"Easy check data availability columns data set. makes easy get idea antimicrobial combinations can used calculation e.g. susceptibility() resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check Availability of Columns — availability","text":"","code":"availability(tbl, width = NULL)"},{"path":"https://amr-for-r.org/reference/availability.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check Availability of Columns — availability","text":"tbl data.frame list. width Number characters present visual availability - default filling width console.","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check Availability of Columns — availability","text":"data.frame column names tbl row names","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check Availability of Columns — availability","text":"function returns data.frame columns \"resistant\" \"visual_resistance\". values columns calculated resistance().","code":""},{"path":"https://amr-for-r.org/reference/availability.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check Availability of Columns — availability","text":"","code":"availability(example_isolates) #>         count available     visual_availabilty resistant      visual_resistance #> date     2000    100.0% |####################|                                  #> patient  2000    100.0% |####################|                                  #> age      2000    100.0% |####################|                                  #> gender   2000    100.0% |####################|                                  #> ward     2000    100.0% |####################|                                  #> mo       2000    100.0% |####################|                                  #> PEN      1629     81.5% |################----|     73.7% |##############------| #> OXA       365     18.3% |###-----------------|     31.2% |######--------------| #> FLC       943     47.2% |#########-----------|     29.5% |#####---------------| #> AMX      1350     67.5% |#############-------|     59.6% |###########---------| #> AMC      1879     94.0% |##################--|     23.7% |####----------------| #> AMP      1350     67.5% |#############-------|     59.6% |###########---------| #> TZP      1001     50.0% |##########----------|     12.6% |##------------------| #> CZO       446     22.3% |####----------------|     44.6% |########------------| #> FEP       724     36.2% |#######-------------|     14.2% |##------------------| #> CXM      1789     89.5% |#################---|     26.3% |#####---------------| #> FOX       818     40.9% |########------------|     27.4% |#####---------------| #> CTX       943     47.2% |#########-----------|     15.5% |###-----------------| #> CAZ      1811     90.6% |##################--|     66.5% |#############-------| #> CRO       943     47.2% |#########-----------|     15.5% |###-----------------| #> GEN      1855     92.8% |##################--|     24.6% |####----------------| #> TOB      1351     67.6% |#############-------|     34.4% |######--------------| #> AMK       692     34.6% |######--------------|     63.7% |############--------| #> KAN       471     23.6% |####----------------|    100.0% |####################| #> TMP      1499     75.0% |###############-----|     38.1% |#######-------------| #> SXT      1759     88.0% |#################---|     20.5% |####----------------| #> NIT       743     37.2% |#######-------------|     17.1% |###-----------------| #> FOS       351     17.6% |###-----------------|     42.2% |########------------| #> LNZ      1023     51.2% |##########----------|     69.3% |#############-------| #> CIP      1409     70.5% |#############-------|     16.2% |###-----------------| #> MFX       211     10.6% |##------------------|     33.6% |######--------------| #> VAN      1861     93.1% |##################--|     38.3% |#######-------------| #> TEC       976     48.8% |#########-----------|     75.7% |###############-----| #> TCY      1200     60.0% |###########---------|     29.8% |#####---------------| #> TGC       798     39.9% |########------------|     12.7% |##------------------| #> DOX      1136     56.8% |###########---------|     27.7% |#####---------------| #> ERY      1894     94.7% |##################--|     57.2% |###########---------| #> CLI      1520     76.0% |###############-----|     61.2% |############--------| #> AZM      1894     94.7% |##################--|     57.2% |###########---------| #> IPM       889     44.5% |########------------|      6.2% |#-------------------| #> MEM       829     41.5% |########------------|      5.9% |#-------------------| #> MTR        34      1.7% |--------------------|     14.7% |##------------------| #> CHL       154      7.7% |#-------------------|     21.4% |####----------------| #> COL      1640     82.0% |################----|     81.2% |################----| #> MUP       270     13.5% |##------------------|      5.9% |#-------------------| #> RIF      1003     50.2% |##########----------|     69.6% |#############-------| # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     filter(mo == as.mo(\"Escherichia coli\")) %>%     select_if(is.sir) %>%     availability() } #>     count available       visual_availabilty resistant        visual_resistance #> PEN   467    100.0% |######################|    100.0% |######################| #> OXA     0      0.0% |----------------------|                                    #> FLC     0      0.0% |----------------------|                                    #> AMX   392     83.9% |##################----|     50.0% |###########-----------| #> AMC   467    100.0% |######################|     13.1% |##--------------------| #> AMP   392     83.9% |##################----|     50.0% |###########-----------| #> TZP   416     89.1% |###################---|      5.5% |#---------------------| #> CZO    82     17.6% |###-------------------|      2.4% |----------------------| #> FEP   317     67.9% |##############--------|      2.8% |----------------------| #> CXM   465     99.6% |######################|      5.4% |#---------------------| #> FOX   377     80.7% |#################-----|      6.9% |#---------------------| #> CTX   459     98.3% |#####################-|      2.4% |----------------------| #> CAZ   460     98.5% |#####################-|      2.4% |----------------------| #> CRO   459     98.3% |#####################-|      2.4% |----------------------| #> GEN   460     98.5% |#####################-|      2.0% |----------------------| #> TOB   462     98.9% |#####################-|      2.6% |----------------------| #> AMK   171     36.6% |########--------------|      0.0% |----------------------| #> KAN     0      0.0% |----------------------|                                    #> TMP   396     84.8% |##################----|     39.1% |########--------------| #> SXT   465     99.6% |######################|     31.6% |######----------------| #> NIT   458     98.1% |#####################-|      2.8% |----------------------| #> FOS    61     13.1% |##--------------------|      0.0% |----------------------| #> LNZ   467    100.0% |######################|    100.0% |######################| #> CIP   456     97.6% |#####################-|     12.5% |##--------------------| #> MFX    57     12.2% |##--------------------|    100.0% |######################| #> VAN   467    100.0% |######################|    100.0% |######################| #> TEC   467    100.0% |######################|    100.0% |######################| #> TCY     3      0.6% |----------------------|     66.7% |##############--------| #> TGC    68     14.6% |###-------------------|      0.0% |----------------------| #> DOX     0      0.0% |----------------------|                                    #> ERY   467    100.0% |######################|    100.0% |######################| #> CLI   467    100.0% |######################|    100.0% |######################| #> AZM   467    100.0% |######################|    100.0% |######################| #> IPM   422     90.4% |###################---|      0.0% |----------------------| #> MEM   418     89.5% |###################---|      0.0% |----------------------| #> MTR     2      0.4% |----------------------|      0.0% |----------------------| #> CHL     0      0.0% |----------------------|                                    #> COL   240     51.4% |###########-----------|      0.0% |----------------------| #> MUP     0      0.0% |----------------------|                                    #> RIF   467    100.0% |######################|    100.0% |######################| # }"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Bug-Drug Combinations — bug_drug_combinations","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"Determine antimicrobial resistance (AMR) bug-drug combinations data set least 30 (default) isolates available per species. Use format() result prettify publishable/printable format, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"bug_drug_combinations(x, col_mo = NULL, FUN = mo_shortname,   include_n_rows = FALSE, ...)  # S3 method for class 'bug_drug_combinations' format(x, translate_ab = \"name (ab, atc)\",   language = get_AMR_locale(), minimum = 30, combine_SI = TRUE,   add_ab_group = TRUE, remove_intrinsic_resistant = FALSE,   decimal.mark = getOption(\"OutDec\"), big.mark = ifelse(decimal.mark ==   \",\", \".\", \",\"), ...)"},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). FUN function call mo column transform microorganism codes - default mo_shortname(). include_n_rows logical indicate total number rows must included output. ... Arguments passed FUN. translate_ab character length 1 containing column names antimicrobials data set. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, summed, resistance based R - default TRUE. add_ab_group logical indicate group antimicrobials must included first column. remove_intrinsic_resistant logical indicate rows columns 100% resistance tested antimicrobials must removed table. decimal.mark character used indicate numeric     decimal point. big.mark character; empty used mark every     big.interval decimals (hence big)     decimal point.","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function bug_drug_combinations() returns data.frame columns \"mo\", \"ab\", \"S\", \"SDD\", \"\", \"R\", \"total\".","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"function format() calculates resistance per bug-drug combination returns table ready reporting/publishing. Use combine_SI = TRUE (default) test R vs. S+combine_SI = FALSE test R+vs. S. table can also directly used R Markdown / Quarto without need e.g. knitr::kable().","code":""},{"path":"https://amr-for-r.org/reference/bug_drug_combinations.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Bug-Drug Combinations — bug_drug_combinations","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # \\donttest{ x <- bug_drug_combinations(example_isolates) head(x) #> # A tibble: 6 × 8 #>   mo                ab        S   SDD     I     R    NI total #>   <chr>             <chr> <int> <int> <int> <int> <int> <int> #> 1 (unknown species) AMC      15     0     0     0     0    15 #> 2 (unknown species) AMK       0     0     0     0     0     0 #> 3 (unknown species) AMP      15     0     0     1     0    16 #> 4 (unknown species) AMX      15     0     0     1     0    16 #> 5 (unknown species) AZM       3     0     0     3     0     6 #> 6 (unknown species) CAZ       0     0     0     0     0     0 #> Use 'format()' on this result to get a publishable/printable format. format(x, translate_ab = \"name (atc)\") #> # A tibble: 39 × 12 #>    Group     Drug  CoNS  `E. coli` `E. faecalis` `K. pneumoniae` `P. aeruginosa` #>    <chr>     <chr> <chr> <chr>     <chr>         <chr>           <chr>           #>  1 \"Aminogl… Amik… \"100… \"  0.0% … \"100.0% (39/… \"\"              \"\"              #>  2 \"\"        Gent… \" 13… \"  2.0% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  3 \"\"        Kana… \"100… \"\"        \"100.0% (39/… \"\"              \"100.0% (30/30… #>  4 \"\"        Tobr… \" 78… \"  2.6% … \"100.0% (39/… \" 10.3% (6/58)\" \"  0.0% (0/30)\" #>  5 \"Antimyc… Rifa… \"\"    \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  6 \"Beta-la… Amox… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  7 \"\"        Amox… \" 42… \" 13.1% … \"\"            \" 10.3% (6/58)\" \"100.0% (30/30… #>  8 \"\"        Ampi… \" 93… \" 50.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #>  9 \"\"        Benz… \" 77… \"100.0% … \"\"            \"100.0% (58/58… \"100.0% (30/30… #> 10 \"\"        Fluc… \" 42… \"\"        \"\"            \"\"              \"\"              #> # ℹ 29 more rows #> # ℹ 5 more variables: `P. mirabilis` <chr>, `S. aureus` <chr>, #> #   `S. epidermidis` <chr>, `S. hominis` <chr>, `S. pneumoniae` <chr>  # Use FUN to change to transformation of microorganism codes bug_drug_combinations(example_isolates,   FUN = mo_gramstain ) #> # A tibble: 80 × 8 #>    mo            ab        S   SDD     I     R    NI total #>    <chr>         <chr> <int> <int> <int> <int> <int> <int> #>  1 Gram-negative AMC     463     0    89   174     0   726 #>  2 Gram-negative AMK     251     0     0     5     0   256 #>  3 Gram-negative AMP     226     0     0   405     0   631 #>  4 Gram-negative AMX     226     0     0   405     0   631 #>  5 Gram-negative AZM       1     0     2   696     0   699 #>  6 Gram-negative CAZ     607     0     0    27     0   634 #>  7 Gram-negative CHL       1     0     0    30     0    31 #>  8 Gram-negative CIP     610     0    11    63     0   684 #>  9 Gram-negative CLI      18     0     1   709     0   728 #> 10 Gram-negative COL     309     0     0    78     0   387 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format.  bug_drug_combinations(example_isolates,   FUN = function(x) {     ifelse(x == as.mo(\"Escherichia coli\"),       \"E. coli\",       \"Others\"     )   } ) #> # A tibble: 80 × 8 #>    mo      ab        S   SDD     I     R    NI total #>    <chr>   <chr> <int> <int> <int> <int> <int> <int> #>  1 E. coli AMC     332     0    74    61     0   467 #>  2 E. coli AMK     171     0     0     0     0   171 #>  3 E. coli AMP     196     0     0   196     0   392 #>  4 E. coli AMX     196     0     0   196     0   392 #>  5 E. coli AZM       0     0     0   467     0   467 #>  6 E. coli CAZ     449     0     0    11     0   460 #>  7 E. coli CHL       0     0     0     0     0     0 #>  8 E. coli CIP     398     0     1    57     0   456 #>  9 E. coli CLI       0     0     0   467     0   467 #> 10 E. coli COL     240     0     0     0     0   240 #> # ℹ 70 more rows #> Use 'format()' on this result to get a publishable/printable format. # }"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Data set containing clinical breakpoints interpret MIC disk diffusion SIR values, according international guidelines. dataset contain breakpoints humans, 7 different animal groups, ECOFFs. breakpoints currently implemented: clinical microbiology: EUCAST 2011-2025 CLSI 2011-2025; veterinary microbiology: EUCAST 2021-2025 CLSI 2019-2025; ECOFFs (Epidemiological Cut-Values): EUCAST 2020-2025 CLSI 2022-2025. Use .sir() transform MICs disks measurements SIR values.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints"},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"tibble 40 217 observations 14 variables: guideline Name guideline type Breakpoint type, either \"ECOFF\", \"animal\", \"human\" host Host infectious agent. mostly useful veterinary breakpoints either \"ECOFF\", \"aquatic\", \"cats\", \"cattle\", \"dogs\", \"horse\", \"human\", \"poultry\", \"swine\" method Testing method, either \"DISK\" \"MIC\" site Body site breakpoint must applied, e.g. \"Oral\" \"Respiratory\" mo Microbial ID, see .mo() rank_index Taxonomic rank index mo 1 (subspecies/infraspecies) 5 (unknown microorganism) ab Antimicrobial code used package, EARS-Net WHONET, see .ab() ref_tbl Info guideline rule can found disk_dose Dose used disk diffusion method breakpoint_S Lowest MIC value highest number millimetres leads \"S\" breakpoint_R Highest MIC value lowest number millimetres leads \"R\", can NA uti logical value (TRUE/FALSE) indicate whether rule applies urinary tract infection (UTI) is_SDD logical value (TRUE/FALSE) indicate whether intermediate range \"S\" \"R\" interpreted \"SDD\", instead \"\". currently applies 48 breakpoints.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"different-types-of-breakpoints","dir":"Reference","previous_headings":"","what":"Different Types of Breakpoints","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Supported types breakpoints ECOFF, animal, human. ECOFF (Epidemiological cut-) values used antimicrobial susceptibility testing differentiate wild-type non-wild-type strains bacteria fungi. default \"human\", can also set package option AMR_breakpoint_type. Use .sir(..., breakpoint_type = ...) interpret raw data using specific breakpoint type, e.g. .sir(..., breakpoint_type = \"ECOFF\") use ECOFFs.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"imported-from-whonet","dir":"Reference","previous_headings":"","what":"Imported From WHONET","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"Clinical breakpoints package validated imported WHONET, free desktop Windows application developed supported Collaborating Centre Surveillance Antimicrobial Resistance. can read website. developers WHONET AMR package contact sharing work. highly appreciate great development WHONET software. import reproduction script can found : https://github.com/msberends/AMR/blob/main/data-raw/_reproduction_scripts/reproduction_of_clinical_breakpoints.R.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"response-from-clsi-and-eucast","dir":"Reference","previous_headings":"","what":"Response From CLSI and EUCAST","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"CEO CLSI chairman EUCAST endorsed work public use AMR package (consequently use breakpoints) June 2023, future development distributing clinical breakpoints discussed meeting CLSI, EUCAST, , developers WHONET software, developers AMR package.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-note","dir":"Reference","previous_headings":"","what":"Download Note","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"AMR package (WHONET software well) contains rather complex internal methods apply guidelines. example, breakpoints must applied certain species groups (case package available microorganisms.groups data set). important considered implementing breakpoints use.","code":""},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/clinical_breakpoints.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Clinical Breakpoints for SIR Interpretation — clinical_breakpoints","text":"","code":"clinical_breakpoints #> # A tibble: 40,217 × 14 #>    guideline   type  host  method site    mo            rank_index ab   ref_tbl  #>    <chr>       <chr> <chr> <chr>  <chr>   <mo>               <dbl> <ab> <chr>    #>  1 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  2 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 MEM  A. xylo… #>  3 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  4 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 SXT  A. xylo… #>  5 EUCAST 2025 human human DISK   NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  6 EUCAST 2025 human human MIC    NA      B_ACHRMB_XYLS          2 TZP  A. xylo… #>  7 EUCAST 2025 human human DISK   NA      B_ACNTB                3 AMK  Acineto… #>  8 EUCAST 2025 human human DISK   Uncomp… B_ACNTB                3 AMK  Acineto… #>  9 EUCAST 2025 human human MIC    NA      B_ACNTB                3 AMK  Acineto… #> 10 EUCAST 2025 human human MIC    Uncomp… B_ACNTB                3 AMK  Acineto… #> # ℹ 40,207 more rows #> # ℹ 5 more variables: disk_dose <chr>, breakpoint_S <dbl>, breakpoint_R <dbl>, #> #   uti <lgl>, is_SDD <lgl>"},{"path":"https://amr-for-r.org/reference/count.html","id":null,"dir":"Reference","previous_headings":"","what":"Count Available Isolates — count","title":"Count Available Isolates — count","text":"functions can used count resistant/susceptible microbial isolates. functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. count_resistant() used count resistant isolates, count_susceptible() used count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Count Available Isolates — count","text":"","code":"count_resistant(..., only_all_tested = FALSE)  count_susceptible(..., only_all_tested = FALSE)  count_S(..., only_all_tested = FALSE)  count_SI(..., only_all_tested = FALSE)  count_I(..., only_all_tested = FALSE)  count_IR(..., only_all_tested = FALSE)  count_R(..., only_all_tested = FALSE)  count_all(..., only_all_tested = FALSE)  n_sir(..., only_all_tested = FALSE)  count_df(data, translate_ab = \"name\", language = get_AMR_locale(),   combine_SI = TRUE)"},{"path":"https://amr-for-r.org/reference/count.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Count Available Isolates — count","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count Available Isolates — count","text":"integer","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Count Available Isolates — count","text":"functions meant count isolates. Use resistance()/susceptibility() functions calculate microbial resistance/susceptibility. function count_resistant() equal function count_R(). function count_susceptible() equal function count_SI(). function n_sir() alias count_all(). can used count available isolates, .e. input antimicrobials available result (S, R). use equal n_distinct(). function equal count_susceptible(...) + count_resistant(...). function count_df() takes variable data sir class (created .sir()) counts number S's, 's R's. also supports grouped variables. function sir_df() works exactly like count_df(), adds percentage S, R.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Count Available Isolates — count","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":"https://amr-for-r.org/reference/count.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Count Available Isolates — count","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":[]},{"path":"https://amr-for-r.org/reference/count.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Count Available Isolates — count","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info.  # base R ------------------------------------------------------------ count_resistant(example_isolates$AMX) # counts \"R\" #> [1] 804 count_susceptible(example_isolates$AMX) # counts \"S\" and \"I\" #> [1] 546 count_all(example_isolates$AMX) # counts \"S\", \"I\" and \"R\" #> [1] 1350  # be more specific count_S(example_isolates$AMX) #> [1] 543 count_SI(example_isolates$AMX) #> [1] 546 count_I(example_isolates$AMX) #> [1] 3 count_IR(example_isolates$AMX) #> [1] 807 count_R(example_isolates$AMX) #> [1] 804  # Count all available isolates count_all(example_isolates$AMX) #> [1] 1350 n_sir(example_isolates$AMX) #> [1] 1350  # n_sir() is an alias of count_all(). # Since it counts all available isolates, you can # calculate back to count e.g. susceptible isolates. # These results are the same: count_susceptible(example_isolates$AMX) #> [1] 546 susceptibility(example_isolates$AMX) * n_sir(example_isolates$AMX) #> [1] 546  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = count_R(CIP),       I = count_I(CIP),       S = count_S(CIP),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Number of available isolates for a whole antibiotic class   # (i.e., in this data set columns GEN, TOB, AMK, KAN)   example_isolates %>%     group_by(ward) %>%     summarise(across(aminoglycosides(), n_sir))    # Count co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy.   # Please mind that `susceptibility()` calculates percentages right away instead.   example_isolates %>% count_susceptible(AMC) # 1433   example_isolates %>% count_all(AMC) # 1879    example_isolates %>% count_susceptible(GEN) # 1399   example_isolates %>% count_all(GEN) # 1855    example_isolates %>% count_susceptible(AMC, GEN) # 1764   example_isolates %>% count_all(AMC, GEN) # 1936    # Get number of S+I vs. R immediately of selected columns   example_isolates %>%     select(AMX, CIP) %>%     count_df(translate = FALSE)    # It also supports grouping variables   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     count_df(translate = FALSE) } #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> # A tibble: 12 × 4 #>    ward       antibiotic interpretation value #>    <chr>      <chr>      <ord>          <int> #>  1 Clinical   AMX        SI               357 #>  2 Clinical   AMX        R                487 #>  3 Clinical   CIP        SI               741 #>  4 Clinical   CIP        R                128 #>  5 ICU        AMX        SI               158 #>  6 ICU        AMX        R                270 #>  7 ICU        CIP        SI               362 #>  8 ICU        CIP        R                 85 #>  9 Outpatient AMX        SI                31 #> 10 Outpatient AMX        R                 47 #> 11 Outpatient CIP        SI                78 #> 12 Outpatient CIP        R                 15 # }"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom EUCAST Rules — custom_eucast_rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"Define custom EUCAST rules organisation specific analysis use output function eucast_rules().","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"custom_eucast_rules(...)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"... Rules formula notation, see instructions, Examples.","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"organisations adoption EUCAST rules. function can used define custom EUCAST rules used eucast_rules() function.","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   two custom EUCAST rules: TZP (piperacillin/tazobactam) \"S\", aminopenicillins (ampicillin amoxicillin) must made \"S\", TZP \"R\", aminopenicillins must made \"R\". rules can also printed console, immediately clear work:   rules (part tilde, example TZP == \"S\" TZP == \"R\") must evaluable data set: able run filter data set without errors. means example column TZP must exist. create sample data set test rules set:","code":"x <- custom_eucast_rules(TZP == \"S\" ~ aminopenicillins == \"S\",                          TZP == \"R\" ~ aminopenicillins == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"S\" then set to  S : #>      amoxicillin (AMX), ampicillin (AMP) #> #>   2. If TZP is \"R\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) df <- data.frame(mo = c(\"Escherichia coli\", \"Klebsiella pneumoniae\"),                  TZP = as.sir(\"R\"),                  ampi = as.sir(\"S\"),                  cipro = as.sir(\"S\")) df #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    S     S  eucast_rules(df,              rules = \"custom\",              custom_rules = x,              info = FALSE,              overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    R     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"using-taxonomic-properties-in-rules","dir":"Reference","previous_headings":"","what":"Using taxonomic properties in rules","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"one exception columns used rules: column names microorganisms data set can also used, exist data set. column names : \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". Thus, next example work well, despite fact df data set contain column genus:","code":"y <- custom_eucast_rules(   TZP == \"S\" & genus == \"Klebsiella\" ~ aminopenicillins == \"S\",   TZP == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\" )  eucast_rules(df,              rules = \"custom\",              custom_rules = y,              info = FALSE,              overwrite = TRUE) #>                      mo TZP ampi cipro #> 1      Escherichia coli   R    S     S #> 2 Klebsiella pneumoniae   R    R     S"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"rules set (y object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"usage-of-multiple-antimicrobials-and-antimicrobial-group-names","dir":"Reference","previous_headings":"","what":"Usage of multiple antimicrobials and antimicrobial group names","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"can define antimicrobial groups instead single antimicrobials rule consequence, part tilde (~). examples , antimicrobial group aminopenicillins includes ampicillin amoxicillin. Rules can also applied multiple antimicrobials antimicrobial groups simultaneously. Use c() function combine multiple antimicrobials. instance, following example sets aminopenicillins ureidopenicillins \"R\" column TZP (piperacillin/tazobactam) \"R\":   35 antimicrobial groups allowed rules (case-insensitive) can used combination: aminoglycosides(amikacin, amikacin/fosfomycin, apramycin, arbekacin, astromicin, bekanamycin, dibekacin, framycetin, gentamicin, gentamicin-high, habekacin, hygromycin, isepamicin, kanamycin, kanamycin-high, kanamycin/cephalexin, micronomicin, neomycin, netilmicin, pentisomicin, plazomicin, propikacin, ribostamycin, sisomicin, streptoduocin, streptomycin, streptomycin-high, tobramycin, tobramycin-high) aminopenicillins(amoxicillin ampicillin) antifungals(amorolfine, amphotericin B, amphotericin B-high, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole) antimycobacterials(4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin) betalactams(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, biapenem, carbenicillin, carindacillin, carumonam, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, ciclacillin, clometocillin, cloxacillin, dicloxacillin, doripenem, epicillin, ertapenem, flucloxacillin, hetacillin, imipenem, imipenem/EDTA, imipenem/relebactam, latamoxef, lenampicillin, loracarbef, mecillinam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, tebipenem, temocillin, ticarcillin, ticarcillin/clavulanic acid, tigemonam) betalactams_with_inhibitor(amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin/sulbactam, aztreonam/avibactam, aztreonam/nacubactam, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefoperazone/sulbactam, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefpodoxime/clavulanic acid, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, ceftolozane/tazobactam, ceftriaxone/beta-lactamase inhibitor, imipenem/relebactam, meropenem/nacubactam, meropenem/vaborbactam, mezlocillin/sulbactam, penicillin/novobiocin, penicillin/sulbactam, piperacillin/sulbactam, piperacillin/tazobactam, ticarcillin/clavulanic acid) carbapenems(biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem) cephalosporins(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) cephalosporins_1st(cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine) cephalosporins_2nd(cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef) cephalosporins_3rd(cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefetamet, cefetamet pivoxil, cefixime, cefmenoxime, cefodizime, cefoperazone, cefoperazone/sulbactam, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotiam hexetil, cefovecin, cefpimizole, cefpiramide, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefsulodin, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, latamoxef) cephalosporins_4th(cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome) cephalosporins_5th(ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam) cephalosporins_except_caz(cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef) fluoroquinolones(besifloxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, pazufloxacin, pefloxacin, pefloxacin screening test, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) glycopeptides(avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod) glycopeptides_except_lipo(avoparcin, bleomycin, norvancomycin, ramoplanin, teicoplanin, teicoplanin-macromethod, vancomycin, vancomycin-macromethod) isoxazolylpenicillins(cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test) lincosamides(clindamycin, lincomycin, pirlimycin) lipoglycopeptides(dalbavancin, oritavancin, telavancin) macrolides(acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin) monobactams(aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam) nitrofurans(furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone) oxazolidinones(cadazolid, cycloserine, linezolid, tedizolid, thiacetazone) penicillins(amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, carbenicillin, carindacillin, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, temocillin, ticarcillin, ticarcillin/clavulanic acid) phenicols(chloramphenicol, florfenicol, thiamphenicol) polymyxins(colistin, polymyxin B, polymyxin B/polysorbate 80) quinolones(besifloxacin, cinoxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nalidixic acid screening test, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pefloxacin screening test, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin) rifamycins(rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine) streptogramins(pristinamycin quinupristin/dalfopristin) sulfonamides(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea) tetracyclines(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline) tetracyclines_except_tgc(cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test) trimethoprims(brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadiazine/trimethoprim, sulfadimethoxine, sulfadimidine, sulfadimidine/trimethoprim, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamerazine/trimethoprim, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfametrole/trimethoprim, sulfamoxole, sulfamoxole/trimethoprim, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea, trimethoprim, trimethoprim/sulfamethoxazole) ureidopenicillins(azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam)","code":"x <- custom_eucast_rules(TZP == \"R\" ~ c(aminopenicillins, ureidopenicillins) == \"R\") x #> A set of custom EUCAST rules: #> #>   1. If TZP is \"R\" then set to \"R\": #>      amoxicillin (AMX), ampicillin (AMP), azlocillin (AZL), mezlocillin (MEZ), piperacillin (PIP), piperacillin/tazobactam (TZP)"},{"path":"https://amr-for-r.org/reference/custom_eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom EUCAST Rules — custom_eucast_rules","text":"","code":"x <- custom_eucast_rules(   AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",   AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\" ) x #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP)  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): eucast_rules(example_isolates,   rules = \"custom\",   custom_rules = x,   info = FALSE,   overwrite = TRUE,   verbose = TRUE ) #> # A tibble: 8 × 9 #>     row col   mo_fullname     old   new   rule  rule_group rule_name rule_source #>   <int> <chr> <chr>           <ord> <chr> <chr> <chr>      <chr>     <chr>       #> 1    33 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 2    33 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 3    34 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 4    34 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 5   531 AMP   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 6   531 AMX   Klebsiella pne… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 7  1485 AMP   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'… #> 8  1485 AMX   Klebsiella oxy… R     I     \"rep… Custom EU… Custom E… Object 'x'…  # combine rule sets x2 <- c(   x,   custom_eucast_rules(TZP == \"R\" ~ carbapenems == \"R\") ) x2 #> A set of custom EUCAST rules: #>  #>   1. If AMC is  R  and genus is \"Klebsiella\" then set to  R : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   2. If AMC is  I  and genus is \"Klebsiella\" then set to  I : #>      amoxicillin (AMX), ampicillin (AMP) #>  #>   3. If TZP is  R  then set to  R : #>      biapenem (BIA), doripenem (DOR), ertapenem (ETP), imipenem (IPM), #>      imipenem/EDTA (IPE), imipenem/relebactam (IMR), meropenem (MEM), #>      meropenem/nacubactam (MNC), meropenem/vaborbactam (MEV), panipenem (PAN), #>      razupenem (RZM), ritipenem (RIT), ritipenem acoxil (RIA), tebipenem (TBP)"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":null,"dir":"Reference","previous_headings":"","what":"Define Custom MDRO Guideline — custom_mdro_guideline","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Define custom MDRO guideline organisation specific analysis use output function mdro().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"custom_mdro_guideline(..., as_factor = TRUE)  # S3 method for class 'custom_mdro_guideline' c(x, ..., as_factor = NULL)"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"... Guideline rules formula notation, see instructions, Examples. as_factor logical indicate whether returned value ordered factor (TRUE, default), otherwise character vector. combining rules sets (using c()) value inherited first set default. x Existing custom MDRO rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"list containing custom rules","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data.","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"basics","dir":"Reference","previous_headings":"","what":"Basics","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"familiar case_when() function dplyr package, recognise input method set rules. Rules must set using R considers 'formula notation'. rule written tilde (~) consequence rule written tilde:   row/isolate matches first rule, value first ~ (case 'Elderly Type ') set MDRO value. Otherwise, second rule tried . number rules unlimited. can print rules set console overview. Colours help reading console supports colours.   outcome function can used guideline argument mdro() function:   Rules can also combined custom rules using c():","code":"custom <- custom_mdro_guideline(CIP == \"R\" & age > 60 ~ \"Elderly Type A\",                                 ERY == \"R\" & age > 60 ~ \"Elderly Type B\") custom #> A set of custom MDRO rules: #>   1. If CIP is R and age is higher than 60 then: Elderly Type A #>   2. If ERY is R and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B x <- mdro(example_isolates, guideline = custom) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> => Found 930 custom defined MDROs out of 2000 isolates (46.5%)  table(x) #> x #>       Negative  Elderly Type A  Elderly Type B #>           1070             198             732 x <- mdro(example_isolates,           guideline = c(custom,                         custom_mdro_guideline(ERY == \"R\" & age > 50 ~ \"Elderly Type C\"))) #> Determining MDROs based on custom rules, resulting in factor levels: Negative < Elderly Type A < Elderly Type B < Elderly Type C. #> - Custom MDRO rule 1: CIP == \"R\" & age > 60 (198 rows matched) #> - Custom MDRO rule 2: ERY == \"R\" & age > 60 (732 rows matched) #> - Custom MDRO rule 3: ERY == \"R\" & age > 50 (109 rows matched) #> => Found 1039 custom defined MDROs out of 2000 isolates (52.0%)  table(x) #> x #>       Negative  Elderly Type A  Elderly Type B  Elderly Type C #>            961             198             732             109"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"sharing-rules-among-multiple-users","dir":"Reference","previous_headings":"","what":"Sharing rules among multiple users","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"rules set (custom object case) exported shared file location using saveRDS() collaborate multiple users. custom rules set imported using readRDS().","code":""},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"usage-of-multiple-antimicrobials-and-antimicrobial-group-names","dir":"Reference","previous_headings":"","what":"Usage of multiple antimicrobials and antimicrobial group names","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"can define antimicrobial groups instead single antimicrobials rule , part tilde (~). Use () () specify scope antimicrobial group:   35 antimicrobial selectors supported use rules: aminoglycosides() can select:  amikacin, amikacin/fosfomycin, apramycin, arbekacin, astromicin, bekanamycin, dibekacin, framycetin, gentamicin, gentamicin-high, habekacin, hygromycin, isepamicin, kanamycin, kanamycin-high, kanamycin/cephalexin, micronomicin, neomycin, netilmicin, pentisomicin, plazomicin, propikacin, ribostamycin, sisomicin, streptoduocin, streptomycin, streptomycin-high, tobramycin, tobramycin-high aminopenicillins() can select:  amoxicillin ampicillin antifungals() can select:  amorolfine, amphotericin B, amphotericin B-high, anidulafungin, butoconazole, caspofungin, ciclopirox, clotrimazole, econazole, fluconazole, flucytosine, fosfluconazole, griseofulvin, hachimycin, ibrexafungerp, isavuconazole, isoconazole, itraconazole, ketoconazole, manogepix, micafungin, miconazole, nystatin, oteseconazole, pimaricin, posaconazole, rezafungin, ribociclib, sulconazole, terbinafine, terconazole, voriconazole antimycobacterials() can select:  4-aminosalicylic acid, calcium aminosalicylate, capreomycin, clofazimine, delamanid, enviomycin, ethambutol, ethambutol/isoniazid, ethionamide, isoniazid, isoniazid/sulfamethoxazole/trimethoprim/pyridoxine, morinamide, p-aminosalicylic acid, pretomanid, protionamide, pyrazinamide, rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine, simvastatin/fenofibrate, sodium aminosalicylate, streptomycin/isoniazid, terizidone, thioacetazone, thioacetazone/isoniazid, tiocarlide, viomycin betalactams() can select:  amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, aztreonam, aztreonam/avibactam, aztreonam/nacubactam, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, biapenem, carbenicillin, carindacillin, carumonam, cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, ciclacillin, clometocillin, cloxacillin, dicloxacillin, doripenem, epicillin, ertapenem, flucloxacillin, hetacillin, imipenem, imipenem/EDTA, imipenem/relebactam, latamoxef, lenampicillin, loracarbef, mecillinam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, panipenem, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, razupenem, ritipenem, ritipenem acoxil, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, tebipenem, temocillin, ticarcillin, ticarcillin/clavulanic acid, tigemonam betalactams_with_inhibitor() can select:  amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin/sulbactam, aztreonam/avibactam, aztreonam/nacubactam, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefoperazone/sulbactam, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefpodoxime/clavulanic acid, ceftaroline/avibactam, ceftazidime/avibactam, ceftazidime/clavulanic acid, ceftolozane/tazobactam, ceftriaxone/beta-lactamase inhibitor, imipenem/relebactam, meropenem/nacubactam, meropenem/vaborbactam, mezlocillin/sulbactam, penicillin/novobiocin, penicillin/sulbactam, piperacillin/sulbactam, piperacillin/tazobactam, ticarcillin/clavulanic acid carbapenems() can select:  biapenem, doripenem, ertapenem, imipenem, imipenem/EDTA, imipenem/relebactam, meropenem, meropenem/nacubactam, meropenem/vaborbactam, panipenem, razupenem, ritipenem, ritipenem acoxil, tebipenem cephalosporins() can select:  cefacetrile, cefaclor, cefadroxil, cefalexin, cefaloridine, cefalotin, cefamandole, cefapirin, cefatrizine, cefazedone, cefazolin, cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetamet, cefetamet pivoxil, cefetecol, cefetrizole, cefiderocol, cefixime, cefmenoxime, cefmetazole, cefodizime, cefonicid, cefoperazone, cefoperazone/sulbactam, ceforanide, cefoselis, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotetan, cefotiam, cefotiam hexetil, cefovecin, cefoxitin, cefoxitin screening test, cefozopran, cefpimizole, cefpiramide, cefpirome, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefprozil, cefquinome, cefroxadine, cefsulodin, cefsumide, ceftaroline, ceftaroline/avibactam, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftezole, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, cefuroxime, cefuroxime axetil, cephradine, latamoxef, loracarbef cephalosporins_1st() can select:  cefacetrile, cefadroxil, cefalexin, cefaloridine, cefalotin, cefapirin, cefatrizine, cefazedone, cefazolin, cefroxadine, ceftezole, cephradine cephalosporins_2nd() can select:  cefaclor, cefamandole, cefmetazole, cefonicid, ceforanide, cefotetan, cefotiam, cefoxitin, cefoxitin screening test, cefprozil, cefuroxime, cefuroxime axetil, loracarbef cephalosporins_3rd() can select:  cefcapene, cefcapene pivoxil, cefdinir, cefditoren, cefditoren pivoxil, cefetamet, cefetamet pivoxil, cefixime, cefmenoxime, cefodizime, cefoperazone, cefoperazone/sulbactam, cefotaxime, cefotaxime screening test, cefotaxime/clavulanic acid, cefotaxime/sulbactam, cefotiam hexetil, cefovecin, cefpimizole, cefpiramide, cefpodoxime, cefpodoxime proxetil, cefpodoxime/clavulanic acid, cefsulodin, ceftazidime, ceftazidime/avibactam, ceftazidime/clavulanic acid, cefteram, cefteram pivoxil, ceftibuten, ceftiofur, ceftizoxime, ceftizoxime alapivoxil, ceftriaxone, ceftriaxone/beta-lactamase inhibitor, latamoxef cephalosporins_4th() can select:  cefepime, cefepime/amikacin, cefepime/clavulanic acid, cefepime/enmetazobactam, cefepime/nacubactam, cefepime/tazobactam, cefepime/zidebactam, cefetecol, cefoselis, cefozopran, cefpirome, cefquinome cephalosporins_5th() can select:  ceftaroline, ceftaroline/avibactam, ceftobiprole, ceftobiprole medocaril, ceftolozane/tazobactam fluoroquinolones() can select:  besifloxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, pazufloxacin, pefloxacin, pefloxacin screening test, pradofloxacin, premafloxacin, prulifloxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin glycopeptides() can select:  avoparcin, bleomycin, dalbavancin, norvancomycin, oritavancin, ramoplanin, teicoplanin, teicoplanin-macromethod, telavancin, vancomycin, vancomycin-macromethod isoxazolylpenicillins() can select:  cloxacillin, dicloxacillin, flucloxacillin, meticillin, oxacillin, oxacillin screening test lincosamides() can select:  clindamycin, lincomycin, pirlimycin lipoglycopeptides() can select:  dalbavancin, oritavancin, telavancin macrolides() can select:  acetylmidecamycin, acetylspiramycin, azithromycin, clarithromycin, dirithromycin, erythromycin, flurithromycin, gamithromycin, josamycin, kitasamycin, meleumycin, midecamycin, miocamycin, nafithromycin, oleandomycin, rokitamycin, roxithromycin, solithromycin, spiramycin, telithromycin, tildipirosin, tilmicosin, troleandomycin, tulathromycin, tylosin, tylvalosin monobactams() can select:  aztreonam, aztreonam/avibactam, aztreonam/nacubactam, carumonam, tigemonam nitrofurans() can select:  furazidin, furazolidone, nifurtoinol, nitrofurantoin, nitrofurazone oxazolidinones() can select:  cadazolid, cycloserine, linezolid, tedizolid, thiacetazone penicillins() can select:  amoxicillin, amoxicillin/clavulanic acid, amoxicillin/sulbactam, ampicillin, ampicillin/sulbactam, apalcillin, aspoxicillin, azidocillin, azlocillin, bacampicillin, benzathine benzylpenicillin, benzathine phenoxymethylpenicillin, benzylpenicillin, benzylpenicillin screening test, carbenicillin, carindacillin, ciclacillin, clometocillin, cloxacillin, dicloxacillin, epicillin, flucloxacillin, hetacillin, lenampicillin, mecillinam, metampicillin, meticillin, mezlocillin, mezlocillin/sulbactam, nafcillin, oxacillin, oxacillin screening test, penamecillin, penicillin/novobiocin, penicillin/sulbactam, pheneticillin, phenoxymethylpenicillin, piperacillin, piperacillin/sulbactam, piperacillin/tazobactam, piridicillin, pivampicillin, pivmecillinam, procaine benzylpenicillin, propicillin, sarmoxicillin, sulbenicillin, sultamicillin, talampicillin, temocillin, ticarcillin, ticarcillin/clavulanic acid phenicols() can select:  chloramphenicol, florfenicol, thiamphenicol polymyxins() can select:  colistin, polymyxin B, polymyxin B/polysorbate 80 quinolones() can select:  besifloxacin, cinoxacin, ciprofloxacin, ciprofloxacin/metronidazole, ciprofloxacin/ornidazole, ciprofloxacin/tinidazole, clinafloxacin, danofloxacin, delafloxacin, difloxacin, enoxacin, enrofloxacin, finafloxacin, fleroxacin, flumequine, garenoxacin, gatifloxacin, gemifloxacin, grepafloxacin, lascufloxacin, levofloxacin, levofloxacin/ornidazole, levonadifloxacin, lomefloxacin, marbofloxacin, metioxate, miloxacin, moxifloxacin, nadifloxacin, nalidixic acid, nalidixic acid screening test, nemonoxacin, nifuroquine, nitroxoline, norfloxacin, norfloxacin screening test, norfloxacin/metronidazole, norfloxacin/tinidazole, ofloxacin, ofloxacin/ornidazole, orbifloxacin, oxolinic acid, pazufloxacin, pefloxacin, pefloxacin screening test, pipemidic acid, piromidic acid, pradofloxacin, premafloxacin, prulifloxacin, rosoxacin, rufloxacin, sarafloxacin, sitafloxacin, sparfloxacin, temafloxacin, tilbroquinol, tioxacin, tosufloxacin, trovafloxacin rifamycins() can select:  rifabutin, rifampicin, rifampicin/ethambutol/isoniazid, rifampicin/isoniazid, rifampicin/pyrazinamide/ethambutol/isoniazid, rifampicin/pyrazinamide/isoniazid, rifamycin, rifapentine streptogramins() can select:  pristinamycin quinupristin/dalfopristin sulfonamides() can select:  brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadimethoxine, sulfadimidine, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfamoxole, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea tetracyclines() can select:  cetocycline, chlortetracycline, clomocycline, demeclocycline, doxycycline, eravacycline, lymecycline, metacycline, minocycline, omadacycline, oxytetracycline, penimepicycline, rolitetracycline, sarecycline, tetracycline, tetracycline screening test, tigecycline trimethoprims() can select:  brodimoprim, sulfadiazine, sulfadiazine/tetroxoprim, sulfadiazine/trimethoprim, sulfadimethoxine, sulfadimidine, sulfadimidine/trimethoprim, sulfafurazole, sulfaisodimidine, sulfalene, sulfamazone, sulfamerazine, sulfamerazine/trimethoprim, sulfamethizole, sulfamethoxazole, sulfamethoxypyridazine, sulfametomidine, sulfametoxydiazine, sulfametrole/trimethoprim, sulfamoxole, sulfamoxole/trimethoprim, sulfanilamide, sulfaperin, sulfaphenazole, sulfapyridine, sulfathiazole, sulfathiourea, trimethoprim, trimethoprim/sulfamethoxazole ureidopenicillins() can select:  azlocillin, mezlocillin, piperacillin, piperacillin/tazobactam","code":"custom_mdro_guideline(   AMX == \"R\"                       ~ \"My MDRO #1\",   any(cephalosporins_2nd() == \"R\") ~ \"My MDRO #2\",   all(glycopeptides() == \"R\")      ~ \"My MDRO #3\" )"},{"path":"https://amr-for-r.org/reference/custom_mdro_guideline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Define Custom MDRO Guideline — custom_mdro_guideline","text":"","code":"x <- custom_mdro_guideline(   CIP == \"R\" & age > 60 ~ \"Elderly Type A\",   ERY == \"R\" & age > 60 ~ \"Elderly Type B\" ) x #> A set of custom MDRO rules: #>   1. If CIP is  R  and age is higher than 60 then: Elderly Type A #>   2. If ERY is  R  and age is higher than 60 then: Elderly Type B #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Elderly Type A < Elderly Type B  # run the custom rule set (verbose = TRUE will return a logbook instead of the data set): out <- mdro(example_isolates, guideline = x) table(out) #> out #>       Negative Elderly Type A Elderly Type B  #>           1070            198            732   out <- mdro(example_isolates, guideline = x, verbose = TRUE) head(out) #>    row_number microorganism           MDRO #> V1          1          <NA> Elderly Type B #> V2          2          <NA> Elderly Type B #> V3          3          <NA>       Negative #> V4          4          <NA>       Negative #> V5          5          <NA>       Negative #> V6          6          <NA>       Negative #>                                   reason #> V1 matched rule 2: ERY == \"R\" & age > 60 #> V2 matched rule 2: ERY == \"R\" & age > 60 #> V3                      no rules matched #> V4                      no rules matched #> V5                      no rules matched #> V6                      no rules matched #>                               all_nonsusceptible_columns        guideline #> V1 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V2 PEN, TMP, SXT, LNZ, VAN, TEC, TCY, ERY, CLI, AZM, RIF Custom guideline #> V3                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V4                     PEN, FLC, CXM, CAZ, ERY, AZM, COL Custom guideline #> V5                PEN, FLC, CXM, CAZ, TMP, ERY, AZM, COL Custom guideline #> V6           PEN, FLC, CXM, CAZ, TMP, ERY, CLI, AZM, COL Custom guideline  # you can create custom guidelines using selectors (see ?antimicrobial_selectors) my_guideline <- custom_mdro_guideline(   AMX == \"R\" ~ \"Custom MDRO 1\",   all(cephalosporins_2nd() == \"R\") ~ \"Custom MDRO 2\" ) my_guideline #> A set of custom MDRO rules: #>   1. If AMX is  R  then: Custom MDRO 1 #>   2. If all of cephalosporins_2nd() is  R  then: Custom MDRO 2 #>   3. Otherwise: Negative #>  #> Unmatched rows will return NA. #> Results will be of class 'factor', with ordered levels: Negative < Custom MDRO 1 < Custom MDRO 2  out <- mdro(example_isolates, guideline = my_guideline) #> ℹ For `cephalosporins_2nd()` using columns 'CXM' (cefuroxime) and 'FOX' #>   (cefoxitin) #> ℹ Assuming a filter on all 2 cephalosporins_2nd. Wrap around `all()` or #>   `any()` to prevent this note. table(out) #> out #>      Negative Custom MDRO 1 Custom MDRO 2  #>          1144           804            52"},{"path":"https://amr-for-r.org/reference/dosage.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"EUCAST breakpoints used package based dosages data set. can retrieved eucast_dosage().","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage"},{"path":"https://amr-for-r.org/reference/dosage.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"tibble 759 observations 9 variables: ab Antimicrobial ID used package (AMC), using official EARS-Net (European Antimicrobial Resistance Surveillance Network) codes available name Official name antimicrobial drug used WHONET/EARS-Net type Type dosage, either \"high_dosage\", \"standard_dosage\", \"uncomplicated_uti\" dose Dose, \"2 g\" \"25 mg/kg\" dose_times Number times dose must administered administration Route administration, either \"\", \"im\", \"iv\", \"oral\" notes Additional dosage notes original_txt Original text PDF file EUCAST eucast_version Version number EUCAST Clinical Breakpoints guideline dosages apply, either 15, 14, 13.1, 12, 11","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/dosage.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Treatment Dosages as Defined by EUCAST — dosage","text":"","code":"dosage #> # A tibble: 759 × 9 #>    ab   name            type  dose  dose_times administration notes original_txt #>    <ab> <chr>           <chr> <chr>      <int> <chr>          <chr> <chr>        #>  1 AMK  Amikacin        stan… 25-3…          1 iv             \"\"    \"25-30 mg/k… #>  2 AMX  Amoxicillin     high… 2 g            6 iv             \"\"    \"2 g x 6 iv\" #>  3 AMX  Amoxicillin     stan… 1 g            3 iv             \"\"    \"1 g x 3-4 … #>  4 AMX  Amoxicillin     high… 0.75…          3 oral           \"\"    \"0.75-1 g x… #>  5 AMX  Amoxicillin     stan… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  6 AMX  Amoxicillin     unco… 0.5 g          3 oral           \"\"    \"0.5 g x 3 … #>  7 AMC  Amoxicillin/cl… high… 2 g …          3 iv             \"\"    \"(2 g amoxi… #>  8 AMC  Amoxicillin/cl… stan… 1 g …          3 iv             \"\"    \"(1 g amoxi… #>  9 AMC  Amoxicillin/cl… high… 0.87…          3 oral           \"\"    \"(0.875 g a… #> 10 AMC  Amoxicillin/cl… stan… 0.5 …          3 oral           \"\"    \"(0.5 g amo… #> # ℹ 749 more rows #> # ℹ 1 more variable: eucast_version <dbl>"},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 500 ESBL Isolates — esbl_isolates","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"data set containing 500 microbial isolates MIC values common antibiotics binary esbl column extended-spectrum beta-lactamase (ESBL) production. data set contains randomised fictitious data reflects reality can used practise AMR-related machine learning, e.g., classification modelling tidymodels.","code":""},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"","code":"esbl_isolates"},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"tibble 500 observations 19 variables: esbl Logical indicator isolate ESBL-producing genus Genus microorganism AMC:COL MIC values 17 antimicrobial agents, transformed class mic (see .mic())","code":""},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"See tidymodels integration example using data set.","code":""},{"path":"https://amr-for-r.org/reference/esbl_isolates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 500 ESBL Isolates — esbl_isolates","text":"","code":"esbl_isolates #> # A tibble: 500 × 19 #>    esbl  genus   AMC   AMP   TZP   CXM   FOX   CTX   CAZ   GEN   TOB   TMP   SXT #>    <lgl> <chr> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> <mic> #>  1 FALSE Esch…    32    32     4    64    64  8.00  8.00     1     1  16.0    20 #>  2 FALSE Esch…    32    32     4    64    64  4.00  8.00     1     1  16.0   320 #>  3 FALSE Esch…     4     2    64     8     4  8.00  0.12    16    16   0.5    20 #>  4 FALSE Kleb…    32    32    16    64    64  8.00  8.00     1     1   0.5    20 #>  5 FALSE Esch…    32    32     4     4     4  0.25  2.00     1     1  16.0   320 #>  6 FALSE Citr…    32    32    16    64    64 64.00 32.00     1     1   0.5    20 #>  7 FALSE Morg…    32    32     4    64    64 16.00  2.00     1     1   0.5    20 #>  8 FALSE Prot…    16    32     4     1     4  8.00  0.12     1     1  16.0   320 #>  9 FALSE Ente…    32    32     8    64    64 32.00  4.00     1     1   0.5    20 #> 10 FALSE Citr…    32    32    32    64    64  8.00 64.00     1     1  16.0   320 #> # ℹ 490 more rows #> # ℹ 6 more variables: NIT <mic>, FOS <mic>, CIP <mic>, IPM <mic>, MEM <mic>, #> #   COL <mic>"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":null,"dir":"Reference","previous_headings":"","what":"Apply EUCAST Rules — eucast_rules","title":"Apply EUCAST Rules — eucast_rules","text":"Apply rules clinical breakpoints notes expected resistant phenotypes defined European Committee Antimicrobial Susceptibility Testing (EUCAST, https://www.eucast.org), see Source. Use eucast_dosage() get data.frame advised dosages certain bug-drug combination, based dosage data set. improve interpretation antibiogram EUCAST rules applied, non-EUCAST rules can applied default, see Details.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"eucast_rules(x, col_mo = NULL, info = interactive(),   rules = getOption(\"AMR_eucastrules\", default = c(\"breakpoints\",   \"expected_phenotypes\")), verbose = FALSE, version_breakpoints = 15,   version_expected_phenotypes = 1.2, version_expertrules = 3.3,   ampc_cephalosporin_resistance = NA, only_sir_columns = any(is.sir(x)),   custom_rules = NULL, overwrite = FALSE, ...)  eucast_dosage(ab, administration = \"iv\", version_breakpoints = 15)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Apply EUCAST Rules — eucast_rules","text":"EUCAST Expert Rules. Version 2.0, 2012. Leclercq et al. EUCAST expert rules antimicrobial susceptibility testing. Clin Microbiol Infect. 2013;19(2):141-60; doi:10.1111/j.1469-0691.2011.03703.x EUCAST Expert Rules, Intrinsic Resistance Exceptional Phenotypes Tables. Version 3.1, 2016. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.2, 2020. (link) EUCAST Intrinsic Resistance Unusual Phenotypes. Version 3.3, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 9.0, 2019. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 10.0, 2020. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 11.0, 2021. (link) EUCAST Breakpoint tables interpretation MICs zone diameters. Version 12.0, 2022. (link)","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Apply EUCAST Rules — eucast_rules","text":"x data set antimicrobials columns, amox, AMX AMC. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). info logical indicate whether progress printed console - default print interactive sessions. rules character vector specifies rules applied. Must one \"breakpoints\", \"expected_phenotypes\", \"expert\", \"\", \"custom\", \"\", defaults c(\"breakpoints\", \"expected_phenotypes\"). default value can set another value using package option AMR_eucastrules: options(AMR_eucastrules = \"\"). using \"custom\", sure fill argument custom_rules . Custom rules can created custom_eucast_rules(). verbose logical turn Verbose mode (default ). Verbose mode, function apply rules data, instead returns data set logbook form extensive info rows columns effected way. Using Verbose mode takes lot time. version_breakpoints version number use EUCAST Clinical Breakpoints guideline. Can \"15.0\", \"14.0\", \"13.1\", \"12.0\", \"11.0\", \"10.0\". version_expected_phenotypes version number use EUCAST Expected Phenotypes. Can \"1.2\". version_expertrules version number use EUCAST Expert Rules Intrinsic Resistance guideline. Can \"3.3\", \"3.2\", \"3.1\". ampc_cephalosporin_resistance (applies rules contains \"expert\" \"\") character value applied cefotaxime, ceftriaxone ceftazidime AmpC de-repressed cephalosporin-resistant mutants - default NA. Currently works version_expertrules 3.2 higher; versions 'EUCAST Expert Rules Enterobacterales' state results cefotaxime, ceftriaxone ceftazidime reported note, results suppressed (emptied) three drugs. value NA (default) argument remove results three drugs, e.g. value \"R\" make results drugs resistant. Use NULL FALSE alter results three drugs AmpC de-repressed cephalosporin-resistant mutants. Using TRUE equal using \"R\".  EUCAST Expert Rules v3.2, rule applies : Citrobacter braakii, Citrobacter freundii, Citrobacter gillenii, Citrobacter murliniae, Citrobacter rodenticum, Citrobacter sedlakii, Citrobacter werkmanii, Citrobacter youngae, Enterobacter, Hafnia alvei, Klebsiella aerogenes, Morganella morganii, Providencia, Serratia. only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. custom_rules Custom rules apply, created custom_eucast_rules(). overwrite logical indicating whether overwrite existing SIR values (default: FALSE). FALSE, non-SIR values modified (.e., value already S, R). ensure compliance EUCAST guidelines, remain FALSE, EUCAST notes often state organism \"tested susceptibility individual agents reported resistant\". ... Column names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning. ab (vector ) text can coerced valid antimicrobial drug code .ab(). administration Route administration, either \"\", \"im\", \"iv\", \"oral\".","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Apply EUCAST Rules — eucast_rules","text":"input x, possibly edited values antimicrobials. , verbose = TRUE, data.frame original new values affected bug-drug combinations.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Apply EUCAST Rules — eucast_rules","text":"Note: function translate MIC values SIR values. Use .sir() . Note: ampicillin (AMP, J01CA01) available amoxicillin (AMX, J01CA04) , latter used rules dependency ampicillin. drugs interchangeable comes expression antimicrobial resistance. file containing EUCAST rules located : https://github.com/msberends/AMR/blob/main/data-raw/eucast_rules.tsv.  Note: Old taxonomic names replaced current taxonomy applicable. example, Ochrobactrum anthropi renamed Brucella anthropi 2020; original EUCAST rules v3.1 v3.2 yet contain new taxonomic name. AMR package contains full microbial taxonomy updated June 24th, 2024, see microorganisms.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"custom-rules","dir":"Reference","previous_headings":"","what":"Custom Rules","title":"Apply EUCAST Rules — eucast_rules","text":"Custom rules can created using custom_eucast_rules(), e.g.:","code":"x <- custom_eucast_rules(AMC == \"R\" & genus == \"Klebsiella\" ~ aminopenicillins == \"R\",                          AMC == \"I\" & genus == \"Klebsiella\" ~ aminopenicillins == \"I\")  eucast_rules(example_isolates, rules = \"custom\", custom_rules = x)"},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"-other-rules","dir":"Reference","previous_headings":"","what":"'Other' Rules","title":"Apply EUCAST Rules — eucast_rules","text":"processing, two non-EUCAST rules drug combinations can applied improve efficacy EUCAST rules, reliability data (analysis). rules : drug enzyme inhibitor set S drug without enzyme inhibitor S drug without enzyme inhibitor set R drug enzyme inhibitor R Important examples include amoxicillin amoxicillin/clavulanic acid, trimethoprim trimethoprim/sulfamethoxazole. Needless say, rules work, drugs must available data set. Since rules officially approved EUCAST, applied default. use rules, include \"\" rules argument, use eucast_rules(..., rules = \"\"). can also set package option AMR_eucastrules, .e. run options(AMR_eucastrules = \"\").","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Apply EUCAST Rules — eucast_rules","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/eucast_rules.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Apply EUCAST Rules — eucast_rules","text":"","code":"# \\donttest{ a <- data.frame(   mo = c(     \"Staphylococcus aureus\",     \"Enterococcus faecalis\",     \"Escherichia coli\",     \"Klebsiella pneumoniae\",     \"Pseudomonas aeruginosa\"   ),   VAN = \"-\", # Vancomycin   AMX = \"-\", # Amoxicillin   COL = \"-\", # Colistin   CAZ = \"-\", # Ceftazidime   CXM = \"-\", # Cefuroxime   PEN = \"S\", # Benzylpenicillin   FOX = \"S\", # Cefoxitin   stringsAsFactors = FALSE )  head(a) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   -   -   -   -   S   S #> 2  Enterococcus faecalis   -   -   -   -   -   S   S #> 3       Escherichia coli   -   -   -   -   -   S   S #> 4  Klebsiella pneumoniae   -   -   -   -   -   S   S #> 5 Pseudomonas aeruginosa   -   -   -   -   -   S   S   # apply EUCAST rules: some results wil be changed b <- eucast_rules(a, overwrite = TRUE) #> Warning: in `eucast_rules()`: not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir))  head(b) #>                       mo VAN AMX COL CAZ CXM PEN FOX #> 1  Staphylococcus aureus   -   S   R   R   S   S   S #> 2  Enterococcus faecalis   -   -   R   R   R   S   R #> 3       Escherichia coli   R   -   -   -   -   R   S #> 4  Klebsiella pneumoniae   R   R   -   -   -   R   S #> 5 Pseudomonas aeruginosa   R   R   -   -   R   R   R   # do not apply EUCAST rules, but rather get a data.frame # containing all details about the transformations: c <- eucast_rules(a, overwrite = TRUE, verbose = TRUE) #> Warning: in `eucast_rules()`: not all columns with antimicrobial results are of #> class 'sir'. Transform them on beforehand, with e.g.: #>   - a %>% as.sir(CXM:AMX) #>   - a %>% mutate_if(is_sir_eligible, as.sir) #>   - a %>% mutate(across(where(is_sir_eligible), as.sir)) head(c) #>   row col           mo_fullname old new rule          rule_group #> 1   1 AMX Staphylococcus aureus   -   S              Breakpoints #> 2   1 CXM Staphylococcus aureus   -   S              Breakpoints #> 3   1 CAZ Staphylococcus aureus   -   R      Expected phenotypes #> 4   1 COL Staphylococcus aureus   -   R      Expected phenotypes #> 5   2 CAZ Enterococcus faecalis   -   R      Expected phenotypes #> 6   2 COL Enterococcus faecalis   -   R      Expected phenotypes #>                                                         rule_name #> 1                                                  Staphylococcus #> 2                                                  Staphylococcus #> 3 Table 4: Expected resistant phenotype in gram-positive bacteria #> 4 Table 4: Expected resistant phenotype in gram-positive bacteria #> 5 Table 4: Expected resistant phenotype in gram-positive bacteria #> 6 Table 4: Expected resistant phenotype in gram-positive bacteria #>                                         rule_source #> 1   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 2   'EUCAST Clinical Breakpoint Tables' v15.0, 2025 #> 3 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 4 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 5 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 #> 6 'EUCAST Expected Resistant Phenotypes' v1.2, 2023 # }  # Dosage guidelines:  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\") #> ℹ Dosages for antimicrobial drugs, as meant for 'EUCAST Clinical Breakpoint #>   Tables' v15.0 (2025). This note will be shown once per session. #> # A tibble: 3 × 5 #>   ab   name          standard_dosage  high_dosage  eucast_version #>   <ab> <chr>         <chr>            <chr>                 <dbl> #> 1 TOB  Tobramycin    6-7 mg/kg x 1 iv NA                       15 #> 2 GEN  Gentamicin    6-7 mg/kg x 1 iv NA                       15 #> 3 CIP  Ciprofloxacin 0.4 g x 2 iv     0.4 g x 3 iv             15  eucast_dosage(c(\"tobra\", \"genta\", \"cipro\"), \"iv\", version_breakpoints = 10) #> # A tibble: 3 × 5 #>   ab   name          standard_dosage high_dosage eucast_version #>   <ab> <chr>         <chr>           <chr>                <dbl> #> 1 TOB  Tobramycin    NA              NA                      NA #> 2 GEN  Gentamicin    NA              NA                      NA #> 3 CIP  Ciprofloxacin NA              NA                      NA"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 2 000 Example Isolates — example_isolates","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"data set containing 2 000 microbial isolates full antibiograms. data set contains randomised fictitious data, reflects reality can used practise AMR data analysis. examples, please read tutorial website.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates"},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"tibble 2 000 observations 46 variables: date Date receipt laboratory patient ID patient age Age patient gender Gender patient, either \"F\" \"M\" ward Ward type patient admitted, either \"Clinical\", \"ICU\", \"Outpatient\" mo ID microorganism created .mo(), see also microorganisms data set PEN:RIF 40 different antimicrobials class sir (see .sir()); column names occur antimicrobials data set can translated set_ab_names() ab_name()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 2 000 Example Isolates — example_isolates","text":"","code":"example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with Unclean Data — example_isolates_unclean","title":"Data Set with Unclean Data — example_isolates_unclean","text":"data set containing 3 000 microbial isolates cleaned consequently ready AMR data analysis. data set can used practice.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean"},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with Unclean Data — example_isolates_unclean","text":"tibble 3 000 observations 8 variables: patient_id ID patient date date receipt laboratory hospital ID hospital, C bacteria info microorganism can transformed .mo(), see also microorganisms AMX:GEN 4 different antimicrobials transformed .sir()","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with Unclean Data — example_isolates_unclean","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/example_isolates_unclean.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with Unclean Data — example_isolates_unclean","text":"","code":"example_isolates_unclean #> # A tibble: 3,000 × 8 #>    patient_id hospital date       bacteria      AMX   AMC   CIP   GEN   #>    <chr>      <chr>    <date>     <chr>         <chr> <chr> <chr> <chr> #>  1 J3         A        2012-11-21 E. coli       R     I     S     S     #>  2 R7         A        2018-04-03 K. pneumoniae R     I     S     S     #>  3 P3         A        2014-09-19 E. coli       R     S     S     S     #>  4 P10        A        2015-12-10 E. coli       S     I     S     S     #>  5 B7         A        2015-03-02 E. coli       S     S     S     S     #>  6 W3         A        2018-03-31 S. aureus     R     S     R     S     #>  7 J8         A        2016-06-14 E. coli       R     S     S     S     #>  8 M3         A        2015-10-25 E. coli       R     S     S     S     #>  9 J3         A        2019-06-19 E. coli       S     S     S     S     #> 10 G6         A        2015-04-27 S. aureus     S     S     S     S     #> # ℹ 2,990 more rows"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":null,"dir":"Reference","previous_headings":"","what":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"Export Data Set NCBI BioSample Antibiogram","code":""},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"","code":"export_ncbi_biosample(x, filename = paste0(\"biosample_\", format(Sys.time(),   \"%Y-%m-%d-%H%M%S\"), \".xlsx\"), type = \"pathogen MIC\",   columns = where(is.mic), save_as_xlsx = TRUE)"},{"path":"https://amr-for-r.org/reference/export_ncbi_biosample.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Export Data Set as NCBI BioSample Antibiogram — export_ncbi_biosample","text":"x data set. filename character string specifying file name. type character string specifying type data set, either \"pathogen MIC\" \"beta-lactamase MIC\", see https://www.ncbi.nlm.nih.gov/biosample/docs/.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine First Isolates — first_isolate","title":"Determine First Isolates — first_isolate","text":"Determine first isolates microorganisms every patient per episode (needed) per specimen type. functions support four methods summarised Hindler et al. 2007 (doi:10.1086/511864 ). determine patient episodes necessarily based microorganisms, use is_new_episode() also supports grouping dplyr package.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine First Isolates — first_isolate","text":"","code":"first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, col_testcode = NULL, col_specimen = NULL,   col_icu = NULL, col_keyantimicrobials = NULL, episode_days = 365,   testcodes_exclude = NULL, icu_exclude = FALSE, specimen_group = NULL,   type = \"points\", method = c(\"phenotype-based\", \"episode-based\",   \"patient-based\", \"isolate-based\"), ignore_I = TRUE, points_threshold = 2,   info = interactive(), include_unknown = FALSE,   include_untested_sir = TRUE, ...)  filter_first_isolate(x = NULL, col_date = NULL, col_patient_id = NULL,   col_mo = NULL, episode_days = 365, method = c(\"phenotype-based\",   \"episode-based\", \"patient-based\", \"isolate-based\"), ...)"},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Determine First Isolates — first_isolate","text":"Methodology functions strictly based : M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/. Hindler JF Stelling J (2007). Analysis Presentation Cumulative Antibiograms: New Consensus Guideline Clinical Laboratory Standards Institute. Clinical Infectious Diseases, 44(6), 867-873. doi:10.1086/511864","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine First Isolates — first_isolate","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_date Column name result date (date received lab) - default first column date class. col_patient_id Column name unique IDs patients - default first column starts 'patient' 'patid' (case insensitive). col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). col_testcode Column name test codes. Use col_testcode = NULL exclude certain test codes (test codes screening). case testcodes_exclude ignored. col_specimen Column name specimen type group. col_icu Column name logicals (TRUE/FALSE) whether ward department Intensive Care Unit (ICU). can also logical vector length rows x. col_keyantimicrobials (useful method = \"phenotype-based\") column name key antimicrobials determine first isolates, see key_antimicrobials(). default first column starts 'key' followed 'ab' 'antibiotics' 'antimicrobials' (case insensitive). Use col_keyantimicrobials = FALSE prevent . Can also output key_antimicrobials(). episode_days Episode days genus/species combination determined 'first isolate' . default 365 days based guideline CLSI, see Source. testcodes_exclude character vector test codes excluded (case-insensitive). icu_exclude logical indicate whether ICU isolates excluded (rows value TRUE column set col_icu). specimen_group Value column set col_specimen filter . type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. method method apply, either \"phenotype-based\", \"episode-based\", \"patient-based\" \"isolate-based\" (can abbreviated), see Details. default \"phenotype-based\" antimicrobial test results present data, \"episode-based\" otherwise. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details. info logical indicate info printed - default TRUE interactive mode. include_unknown logical indicate whether 'unknown' microorganisms included , .e. microbial code \"UNKNOWN\", defaults FALSE. WHONET users, means records organism code \"con\" (contamination) excluded default. Isolates microbial ID NA always excluded first isolate. include_untested_sir logical indicate whether also rows without antibiotic results still eligible becoming first isolate. Use include_untested_sir = FALSE always return FALSE rows. checks data set columns class sir consequently requires transforming columns antibiotic results using .sir() first. ... Arguments passed first_isolate() using filter_first_isolate(), otherwise arguments passed key_antimicrobials() (universal, gram_negative, gram_positive).","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine First Isolates — first_isolate","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine First Isolates — first_isolate","text":"methodology implemented functions strictly based recommendations outlined CLSI Guideline M39 research overview Hindler et al. (2007, doi:10.1086/511864 ). conduct epidemiological analyses antimicrobial resistance data, -called first isolates included prevent overestimation underestimation antimicrobial resistance. Different methods can used , see . functions context-aware. means x argument can left blank used inside data.frame call, see Examples. first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names. isolates microbial ID NA excluded first isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"different-methods","dir":"Reference","previous_headings":"","what":"Different methods","title":"Determine First Isolates — first_isolate","text":"According previously-mentioned sources, different methods (algorithms) select first isolates increasing reliability: isolate-based, patient-based, episode-based phenotype-based. methods select combination taxonomic genus species (subspecies). mentioned methods covered first_isolate() function:","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"isolate-based","dir":"Reference","previous_headings":"","what":"Isolate-based","title":"Determine First Isolates — first_isolate","text":"method require selection, isolates included. , however, respect arguments set first_isolate() function. example, default setting include_unknown (FALSE) omit selection rows without microbial ID.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"patient-based","dir":"Reference","previous_headings":"","what":"Patient-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient , set episode_days Inf. method makes sure duplicate isolates selected patient. method preferred e.g. identify first MRSA finding patient determine incidence. Conversely, large longitudinal data set, mean isolates excluded found years initial isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"episode-based","dir":"Reference","previous_headings":"","what":"Episode-based","title":"Determine First Isolates — first_isolate","text":"include every genus-species combination per patient episode , set episode_days sensible number days. Depending type analysis, 14, 30, 60 365. Short episodes common analysing specific hospital ward data ICU cases, long episodes common analysing regional national data. common method correct duplicate isolates. Patients categorised episodes based ID dates (e.g., date specimen receipt laboratory result). common method, take account antimicrobial test results. means e.g. methicillin-resistant Staphylococcus aureus (MRSA) isolate differentiated wildtype Staphylococcus aureus isolate.","code":""},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"phenotype-based","dir":"Reference","previous_headings":"","what":"Phenotype-based","title":"Determine First Isolates — first_isolate","text":"reliable method, since also weighs antibiogram (antimicrobial test results) yielding -called 'first weighted isolates'. two different methods weigh antibiogram: Using type = \"points\" argument points_threshold (default) method weighs antimicrobial drugs available data set. difference S R (vice versa) counts 0.5 points, difference S R (vice versa) counts 1 point. sum points exceeds points_threshold, defaults 2, isolate selected first weighted isolate. antimicrobials internally selected using all_antimicrobials() function. output function need passed first_isolate() function. Using type = \"keyantimicrobials\" argument ignore_I method weighs specific antimicrobial drugs, called key antimicrobials. difference S R (vice versa) key antimicrobials select isolate first weighted isolate. ignore_I = FALSE, also differences S R (vice versa) lead . Key antimicrobials internally selected using key_antimicrobials() function, can also added manually variable data set col_keyantimicrobials argument. Another option pass output key_antimicrobials() function directly col_keyantimicrobials argument. default method phenotype-based (using type = \"points\") episode-based (using episode_days = 365). makes sure every genus-species combination selected per patient per year, taking account antimicrobial test results. antimicrobial test results available data set, episode-based method applied default.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/first_isolate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine First Isolates — first_isolate","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  example_isolates[first_isolate(info = TRUE), ] #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Using column 'date' as input for `col_date`. #> ℹ Using column 'patient' as input for `col_patient_id`. #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # \\donttest{ # get all first Gram-negatives example_isolates[which(first_isolate(info = FALSE) & mo_is_gram_negative()), ] #> ℹ Using column 'mo' as input for `mo_is_gram_negative()` #> # A tibble: 441 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  4 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #>  5 2002-02-05 067927     45 F      ICU      B_SERRT_MRCS   R     NA    NA    R   #>  6 2002-02-27 066895     85 F      Clinical B_KLBSL_PNMN   R     NA    NA    R   #>  7 2002-03-08 4FC193     69 M      Clinical B_ESCHR_COLI   R     NA    NA    R   #>  8 2002-03-16 4FC193     69 M      Clinical B_PSDMN_AERG   R     NA    NA    R   #>  9 2002-04-01 496896     46 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> 10 2002-04-23 EE2510     69 F      ICU      B_ESCHR_COLI   R     NA    NA    NA  #> # ℹ 431 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   # filter on first isolates using dplyr:   example_isolates %>%     filter(first_isolate(info = TRUE)) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #> ℹ Excluding 16 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 1,387 'phenotype-based' first isolates (69.4% of total where a #>    microbial ID was available) #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # short-hand version:   example_isolates %>%     filter_first_isolate(info = FALSE) } #> # A tibble: 1,387 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #>  6 2002-01-17 495616     67 M      Clinical B_STPHY_EPDR   R     NA    S     NA  #>  7 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  8 2002-01-21 462081     75 F      Clinical B_CTRBC_FRND   R     NA    NA    R   #>  9 2002-01-22 F35553     50 M      ICU      B_PROTS_MRBL   R     NA    NA    NA  #> 10 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #> # ℹ 1,377 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … if (require(\"dplyr\")) {   # flag the first isolates per group:   example_isolates %>%     group_by(ward) %>%     mutate(first = first_isolate(info = TRUE)) %>%     select(ward, date, patient, mo, first) } #> ℹ Determining first isolates using an episode length of 365 days #> ℹ Basing inclusion on all antimicrobial results, using a points threshold #>   of 2 #>  #> Group: ward = \"Clinical\" #> ℹ Excluding 9 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 865 'phenotype-based' first isolates (70.1% of total where a #>    microbial ID was available) #>  #> Group: ward = \"ICU\" #> ℹ Excluding 6 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 452 'phenotype-based' first isolates (70.0% of total where a #>    microbial ID was available) #>  #> Group: ward = \"Outpatient\" #> ℹ Excluding 1 isolates with a microbial ID 'UNKNOWN' (in column 'mo') #> => Found 99 'phenotype-based' first isolates (82.5% of total where a #>    microbial ID was available) #> # A tibble: 2,000 × 5 #> # Groups:   ward [3] #>    ward     date       patient mo           first #>    <chr>    <date>     <chr>   <mo>         <lgl> #>  1 Clinical 2002-01-02 A77334  B_ESCHR_COLI TRUE  #>  2 Clinical 2002-01-03 A77334  B_ESCHR_COLI FALSE #>  3 ICU      2002-01-07 067927  B_STPHY_EPDR TRUE  #>  4 ICU      2002-01-07 067927  B_STPHY_EPDR FALSE #>  5 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  6 ICU      2002-01-13 067927  B_STPHY_EPDR FALSE #>  7 Clinical 2002-01-14 462729  B_STPHY_AURS TRUE  #>  8 Clinical 2002-01-14 462729  B_STPHY_AURS FALSE #>  9 ICU      2002-01-16 067927  B_STPHY_EPDR TRUE  #> 10 ICU      2002-01-17 858515  B_STPHY_EPDR TRUE  #> # ℹ 1,990 more rows # }"},{"path":"https://amr-for-r.org/reference/g.test.html","id":null,"dir":"Reference","previous_headings":"","what":"G-test for Count Data — g.test","title":"G-test for Count Data — g.test","text":"g.test() performs chi-squared contingency table tests goodness--fit tests, just like chisq.test() reliable (1). G-test can used see whether number observations category fits theoretical expectation (called G-test goodness--fit), see whether proportions one variable different different values variable (called G-test independence).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"G-test for Count Data — g.test","text":"","code":"g.test(x, y = NULL, p = rep(1/length(x), length(x)), rescale.p = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"G-test for Count Data — g.test","text":"code function identical chisq.test(), except : calculation statistic changed \\(2 * sum(x * log(x / E))\\) Yates' continuity correction removed apply G-test possibility simulate p values simulate.p.value removed","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"G-test for Count Data — g.test","text":"x numeric vector matrix. x y can also     factors. y numeric vector; ignored x matrix.      x factor, y factor length. p vector probabilities length x.     error given entry p negative. rescale.p logical scalar; TRUE p rescaled     (necessary) sum 1.  rescale.p FALSE,     p sum 1, error given.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"G-test for Count Data — g.test","text":"list class \"htest\" containing following   components: statistic value chi-squared test statistic. parameter degrees freedom approximate     chi-squared distribution test statistic, NA     p-value computed Monte Carlo simulation. p.value p-value test. method character string indicating type test     performed, whether Monte Carlo simulation continuity     correction used. data.name character string giving name(s) data. observed observed counts. expected expected counts null hypothesis. residuals Pearson residuals,     (observed - expected) / sqrt(expected). stdres standardized residuals,     (observed - expected) / sqrt(V), V     residual cell variance (Agresti, 2007, section 2.4.5     case x matrix, n * p * (1 - p) otherwise).","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"G-test for Count Data — g.test","text":"x matrix one row column, x vector y given, goodness--fit test performed (x treated one-dimensional contingency table). entries x must non-negative integers. case, hypothesis tested whether population probabilities equal p, equal p given. x matrix least two rows columns, taken two-dimensional contingency table: entries x must non-negative integers.  Otherwise, x y must vectors factors length; cases missing values removed, objects coerced factors, contingency table computed .  Pearson's chi-squared test performed null hypothesis joint distribution cell counts 2-dimensional contingency table product row column marginals. p-value computed asymptotic chi-squared distribution test statistic. contingency table case simulation done random sampling set contingency tables given marginals, works marginals strictly positive. Note usual sampling situation assumed chi-squared test (G-test) rather Fisher's exact test. goodness--fit case simulation done random sampling discrete distribution specified p, sample size n = sum(x). simulation done R may slow.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-goodness-of-fit-likelihood-ratio-test-","dir":"Reference","previous_headings":"","what":"G-test Of Goodness-of-Fit (Likelihood Ratio Test)","title":"G-test for Count Data — g.test","text":"Use G-test goodness--fit one nominal variable two values (male female, red, pink white flowers). compare observed counts numbers observations category expected counts, calculate using kind theoretical expectation (1:1 sex ratio 1:2:1 ratio genetic cross). expected number observations category small, G-test may give inaccurate results, use exact test instead (fisher.test()). G-test goodness--fit alternative chi-square test goodness--fit (chisq.test()); tests advantages disadvantages, results two tests usually similar.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"g-test-of-independence","dir":"Reference","previous_headings":"","what":"G-test of Independence","title":"G-test for Count Data — g.test","text":"Use G-test independence two nominal variables, two possible values. want know whether proportions one variable different among values variable. also possible G-test independence two nominal variables. example, Jackson et al. (2013) also data children 3, analysis old vs. young, thigh vs. arm, reaction vs. reaction, analyzed together. Fisher's exact test (fisher.test()) exact test, G-test still approximation. 2x2 table, Fisher's Exact test may slower still run seconds, even sum observations multiple millions. G-test independence alternative chi-square test independence (chisq.test()), give approximately results.","code":""},{"path":"https://amr-for-r.org/reference/g.test.html","id":"how-the-test-works","dir":"Reference","previous_headings":"","what":"How the Test Works","title":"G-test for Count Data — g.test","text":"Unlike exact test goodness--fit (fisher.test()), G-test directly calculate probability obtaining observed results something extreme. Instead, like almost statistical tests, G-test intermediate step; uses data calculate test statistic measures far observed data null expectation. use mathematical relationship, case chi-square distribution, estimate probability obtaining value test statistic. G-test uses log ratio two likelihoods test statistic, also called likelihood ratio test log-likelihood ratio test. formula calculate G-statistic : \\(G = 2 * sum(x * log(x / E))\\) E expected values. Since chi-square distributed, p value can calculated R :   df degrees freedom. two categories want find ones significantly different null expectation, can use method testing category vs. sum categories, Bonferroni correction. use G-tests category, course.","code":"p <- stats::pchisq(G, df, lower.tail = FALSE)"},{"path":"https://amr-for-r.org/reference/g.test.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"G-test for Count Data — g.test","text":"McDonald, J.H. 2014. Handbook Biological Statistics (3rd ed.). Sparky House Publishing, Baltimore, Maryland.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/g.test.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"G-test for Count Data — g.test","text":"","code":"# = EXAMPLE 1 = # Shivrain et al. (2006) crossed clearfield rice (which are resistant # to the herbicide imazethapyr) with red rice (which are susceptible to # imazethapyr). They then crossed the hybrid offspring and examined the # F2 generation, where they found 772 resistant plants, 1611 moderately # resistant plants, and 737 susceptible plants. If resistance is controlled # by a single gene with two co-dominant alleles, you would expect a 1:2:1 # ratio.  x <- c(772, 1611, 737) g.test(x, p = c(1, 2, 1) / 4) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 4.1471, p-value = 0.1257 #>   # There is no significant difference from a 1:2:1 ratio. # Meaning: resistance controlled by a single gene with two co-dominant # alleles, is plausible.   # = EXAMPLE 2 = # Red crossbills (Loxia curvirostra) have the tip of the upper bill either # right or left of the lower bill, which helps them extract seeds from pine # cones. Some have hypothesized that frequency-dependent selection would # keep the number of right and left-billed birds at a 1:1 ratio. Groth (1992) # observed 1752 right-billed and 1895 left-billed crossbills.  x <- c(1752, 1895) g.test(x) #>  #> \tG-test of goodness-of-fit (likelihood ratio test) #>  #> data:  x #> X-squared = 5.6085, p-value = 0.01787 #>   # There is a significant difference from a 1:1 ratio. # Meaning: there are significantly more left-billed birds."},{"path":"https://amr-for-r.org/reference/get_episode.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Clinical or Epidemic Episodes — get_episode","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"functions determine items vector can considered (start ) new episode. can used determine clinical episodes epidemiological analysis. get_episode() function returns index number episode per group, is_new_episode() function returns TRUE every new get_episode() index. absolute relative episode determination supported.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"get_episode(x, episode_days = NULL, case_free_days = NULL, ...)  is_new_episode(x, episode_days = NULL, case_free_days = NULL, ...)"},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"x Vector dates (class Date POSIXt), sorted internally determine episodes. episode_days Episode length days specify time period new episode begins, can also less day Inf, see Details. case_free_days (inter-epidemic) interval length days new episode start, can also less day Inf, see Details. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode(): integer vector is_new_episode(): logical vector","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"Episodes can determined two ways: absolute relative. Absolute method uses episode_days define episode length days, new episode start. common use case AMR data analysis microbial epidemiology: episodes S. aureus bacteraemia ICU patients example. episode length 30 days, new S. aureus isolates ICU episode 30 days considered different (new) episode. Thus, method counts since start previous episode. Relative method uses case_free_days quantify duration case-free days (inter-epidemic interval), new episode start. common use case infectious disease epidemiology: episodes norovirus outbreaks hospital example. case-free period 14 days, new norovirus cases time considered different (new) episode. Thus, methods counts since last case previous episode. table: ** marks start new episode, 8 January 2023 7 days since start previous episode (1 January 2023).  *** marks start new episode, 21 January 2023 7 days since last case previous episode (8 January 2023). Either episode_days case_free_days must provided function.","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"difference-between-get-episode-and-is-new-episode-","dir":"Reference","previous_headings":"","what":"Difference between get_episode() and is_new_episode()","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"get_episode() function returns index number episode, cases/patients/isolates first episode number 1, cases/patients/isolates second episode number 2, etc. is_new_episode() function hand, returns TRUE every new get_episode() index. specify, setting episode_days = 365 (using method 1 explained ), two functions differ:","code":""},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"other","dir":"Reference","previous_headings":"","what":"Other","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"first_isolate() function wrapper around is_new_episode() function, efficient data sets containing microorganism codes names allows different isolate selection methods. dplyr package required functions work, episode functions support variable grouping work conveniently inside dplyr verbs filter(), mutate() summarise().","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/get_episode.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Clinical or Epidemic Episodes — get_episode","text":"","code":"# difference between absolute and relative determination of episodes: x <- data.frame(dates = as.Date(c(   \"2021-01-01\",   \"2021-01-02\",   \"2021-01-05\",   \"2021-01-08\",   \"2021-02-21\",   \"2021-02-22\",   \"2021-02-23\",   \"2021-02-24\",   \"2021-03-01\",   \"2021-03-01\" ))) x$absolute <- get_episode(x$dates, episode_days = 7) x$relative <- get_episode(x$dates, case_free_days = 7) x #>         dates absolute relative #> 1  2021-01-01        1        1 #> 2  2021-01-02        1        1 #> 3  2021-01-05        1        1 #> 4  2021-01-08        2        1 #> 5  2021-02-21        3        2 #> 6  2021-02-22        3        2 #> 7  2021-02-23        3        2 #> 8  2021-02-24        3        2 #> 9  2021-03-01        4        2 #> 10 2021-03-01        4        2   # `example_isolates` is a data set available in the AMR package. # See ?example_isolates df <- example_isolates[sample(seq_len(2000), size = 100), ]  get_episode(df$date, episode_days = 60) # indices #>   [1] 43  9  7 14 28 40 49 29 19 27 10 44 18 22 42 12  8 36 13  3 46  5  4 35 38 #>  [26] 16 22 23 16 10 42 13  2 45 18 19 39 32 22 36 40 45 39 40 11 23 25 39 26 23 #>  [51] 25 12 17 23 30 30 34 16 21 37 40 26 11  7  4 16 43 22 47 37 39 31 25 41  1 #>  [76] 45 39 23 32 45 20 22 15 14 13 43  9 38 29  6 48 24 21 23 44 19 31  1  3 33 is_new_episode(df$date, episode_days = 60) # TRUE/FALSE #>   [1]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [13]  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE  TRUE #>  [25]  TRUE  TRUE FALSE  TRUE FALSE FALSE FALSE FALSE  TRUE  TRUE FALSE FALSE #>  [37]  TRUE  TRUE FALSE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE  TRUE FALSE #>  [49]  TRUE FALSE FALSE FALSE  TRUE FALSE  TRUE FALSE  TRUE FALSE  TRUE  TRUE #>  [61] FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE FALSE  TRUE #>  [73] FALSE  TRUE  TRUE FALSE FALSE FALSE FALSE FALSE  TRUE FALSE  TRUE FALSE #>  [85] FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE FALSE FALSE FALSE FALSE #>  [97] FALSE FALSE FALSE  TRUE  # filter on results from the third 60-day episode only, using base R df[which(get_episode(df$date, 60) == 3), ] #> # A tibble: 2 × 46 #>   date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>   <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #> 1 2002-11-04 304347     62 M      Clinical B_STRPT_PNMN   S     NA    NA    S   #> 2 2002-10-18 E55128     57 F      ICU      B_STPHY_AURS   R     NA    S     R   #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, RIF <sir>  # the functions also work for less than a day, e.g. to include one per hour: get_episode(   c(     Sys.time(),     Sys.time() + 60 * 60   ),   episode_days = 1 / 24 ) #> [1] 1 2  # \\donttest{ if (require(\"dplyr\")) {   # is_new_episode() can also be used in dplyr verbs to determine patient   # episodes based on any (combination of) grouping variables:   df %>%     mutate(condition = sample(       x = c(\"A\", \"B\", \"C\"),       size = 100,       replace = TRUE     )) %>%     group_by(patient, condition) %>%     mutate(new_episode = is_new_episode(date, 365)) %>%     select(patient, date, condition, new_episode) %>%     arrange(patient, condition, date) } #> # A tibble: 100 × 4 #> # Groups:   patient, condition [96] #>    patient date       condition new_episode #>    <chr>   <date>     <chr>     <lgl>       #>  1 022060  2004-05-04 A         TRUE        #>  2 060287  2007-03-11 A         TRUE        #>  3 0E2483  2007-04-06 C         TRUE        #>  4 101305  2006-12-13 A         TRUE        #>  5 141061  2014-10-22 A         TRUE        #>  6 146F70  2009-08-14 A         TRUE        #>  7 15D386  2004-08-01 B         TRUE        #>  8 187841  2008-04-22 C         TRUE        #>  9 195736  2008-08-29 C         TRUE        #> 10 195736  2008-08-29 C         FALSE       #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward, patient) %>%     transmute(date,       patient,       new_index = get_episode(date, 60),       new_logical = is_new_episode(date, 60)     ) %>%     arrange(patient, ward, date) } #> # A tibble: 100 × 5 #> # Groups:   ward, patient [91] #>    ward     date       patient new_index new_logical #>    <chr>    <date>     <chr>       <int> <lgl>       #>  1 ICU      2004-05-04 022060          1 TRUE        #>  2 Clinical 2007-03-11 060287          1 TRUE        #>  3 Clinical 2007-04-06 0E2483          1 TRUE        #>  4 Clinical 2006-12-13 101305          1 TRUE        #>  5 Clinical 2014-10-22 141061          1 TRUE        #>  6 Clinical 2009-08-14 146F70          1 TRUE        #>  7 ICU      2004-08-01 15D386          1 TRUE        #>  8 Clinical 2008-04-22 187841          1 TRUE        #>  9 Clinical 2008-08-29 195736          1 TRUE        #> 10 Clinical 2008-08-29 195736          1 FALSE       #> # ℹ 90 more rows  if (require(\"dplyr\")) {   df %>%     group_by(ward) %>%     summarise(       n_patients = n_distinct(patient),       n_episodes_365 = sum(is_new_episode(date, episode_days = 365)),       n_episodes_60 = sum(is_new_episode(date, episode_days = 60)),       n_episodes_30 = sum(is_new_episode(date, episode_days = 30))     ) } #> # A tibble: 3 × 5 #>   ward       n_patients n_episodes_365 n_episodes_60 n_episodes_30 #>   <chr>           <int>          <int>         <int>         <int> #> 1 Clinical           58             14            38            44 #> 2 ICU                26              7            20            23 #> 3 Outpatient          7              4             6             7  # grouping on patients and microorganisms leads to the same # results as first_isolate() when using 'episode-based': if (require(\"dplyr\")) {   x <- df %>%     filter_first_isolate(       include_unknown = TRUE,       method = \"episode-based\"     )    y <- df %>%     group_by(patient, mo) %>%     filter(is_new_episode(date, 365)) %>%     ungroup()    identical(x, y) } #> [1] FALSE  # but is_new_episode() has a lot more flexibility than first_isolate(), # since you can now group on anything that seems relevant: if (require(\"dplyr\")) {   df %>%     group_by(patient, mo, ward) %>%     mutate(flag_episode = is_new_episode(date, 365)) %>%     select(group_vars(.), flag_episode) } #> # A tibble: 100 × 4 #> # Groups:   patient, mo, ward [96] #>    patient mo            ward     flag_episode #>    <chr>   <mo>          <chr>    <lgl>        #>  1 917895  B_STPHY_CPTS  ICU      TRUE         #>  2 022060  B_ENTRBC_CLOC ICU      TRUE         #>  3 C36883  B_ESCHR_COLI  Clinical TRUE         #>  4 5DF436  B_STPHY_AURS  ICU      TRUE         #>  5 971739  B_STPHY_CONS  Clinical TRUE         #>  6 488175  B_ESCHR_COLI  Clinical TRUE         #>  7 5DB1C8  B_STPHY_CPTS  Clinical TRUE         #>  8 BC9909  B_ENTRBC_CLOC Clinical TRUE         #>  9 5B78D5  B_STPHY_AURS  Clinical TRUE         #> 10 284FFF  B_STPHY_EPDR  Clinical TRUE         #> # ℹ 90 more rows # }"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":null,"dir":"Reference","previous_headings":"","what":"PCA Biplot with ggplot2 — ggplot_pca","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"Produces ggplot2 variant -called biplot PCA (principal component analysis), flexible appealing base R biplot() function.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"ggplot_pca(x, choices = 1:2, scale = 1, pc.biplot = TRUE,   labels = NULL, labels_textsize = 3, labels_text_placement = 1.5,   groups = NULL, ellipse = TRUE, ellipse_prob = 0.68,   ellipse_size = 0.5, ellipse_alpha = 0.5, points_size = 2,   points_alpha = 0.25, arrows = TRUE, arrows_colour = \"darkblue\",   arrows_size = 0.5, arrows_textsize = 3, arrows_textangled = TRUE,   arrows_alpha = 0.75, base_textsize = 10, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"ggplot_pca() function based ggbiplot() function ggbiplot package Vince Vu, found GitHub: https://github.com/vqv/ggbiplot (retrieved: 2 March 2020, latest commit: 7325e88; 12 February 2015). per GPL-2 licence demands documentation code changes, changes made based source code : Rewritten code remove dependency packages plyr, scales grid Parametrised options, like arrow ellipse settings Hardened input possibilities defining exact type user input every argument Added total amount explained variance caption plot Cleaned syntax based lintr package, fixed grammatical errors added integrity checks Updated documentation","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"x object returned pca(), prcomp() princomp(). choices length 2 vector specifying components plot. default     biplot strict sense. scale variables scaled lambda ^ scale     observations scaled lambda ^ (1-scale)     lambda singular values computed     princomp. Normally 0 <= scale <= 1, warning     issued specified scale outside range. pc.biplot true, use Gabriel (1971) refers \"principal component     biplot\", lambda = 1 observations scaled sqrt(n)     variables scaled sqrt(n).  inner products     variables approximate covariances distances observations     approximate Mahalanobis distance. labels optional vector labels observations. set, labels placed respective points. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). labels_textsize size text used labels. labels_text_placement Adjustment factor placement variable names (>=1 means away arrow head). groups optional vector groups labels, length labels. set, points labels coloured according groups. using pca() function input x, determined automatically based attribute non_numeric_cols, see pca(). ellipse logical indicate whether normal data ellipse drawn group (set groups). ellipse_prob Statistical size ellipse normal probability. ellipse_size size ellipse line. ellipse_alpha alpha (transparency) ellipse line. points_size size points. points_alpha alpha (transparency) points. arrows logical indicate whether arrows drawn. arrows_colour colour arrow text. arrows_size size (thickness) arrow lines. arrows_textsize size text end arrows. arrows_textangled logical whether text end arrows angled. arrows_alpha alpha (transparency) arrows text. base_textsize text size plot elements except labels arrows. ... Arguments passed functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"colours labels points can changed adding another scale layer colour, scale_colour_viridis_d() scale_colour_brewer().","code":""},{"path":"https://amr-for-r.org/reference/ggplot_pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"PCA Biplot with ggplot2 — ggplot_pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    summary(pca_result)    # old base R plotting method:   biplot(pca_result, main = \"Base R biplot\")    # new ggplot2 plotting method using this package:   if (require(\"ggplot2\")) {     ggplot_pca(pca_result) +       labs(title = \"ggplot2 biplot\")   }   if (require(\"ggplot2\")) {     # still extendible with any ggplot2 function     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"ggplot2 biplot\")   } } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (`minimum` = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # }"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":null,"dir":"Reference","previous_headings":"","what":"AMR Plots with ggplot2 — ggplot_sir","title":"AMR Plots with ggplot2 — ggplot_sir","text":"Use functions create bar plots AMR data analysis. functions rely ggplot2 functions.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"ggplot_sir(data, position = NULL, x = \"antibiotic\",   fill = \"interpretation\", facet = NULL, breaks = seq(0, 1, 0.1),   limits = NULL, translate_ab = \"name\", combine_SI = TRUE,   minimum = 30, language = get_AMR_locale(), nrow = NULL, colours = c(S   = \"#3CAEA3\", SDD = \"#8FD6C4\", SI = \"#3CAEA3\", I = \"#F6D55C\", IR = \"#ED553B\",   R = \"#ED553B\"), datalabels = TRUE, datalabels.size = 2.5,   datalabels.colour = \"grey15\", title = NULL, subtitle = NULL,   caption = NULL, x.title = \"Antimicrobial\", y.title = \"Proportion\", ...)  geom_sir(position = NULL, x = c(\"antibiotic\", \"interpretation\"),   fill = \"interpretation\", translate_ab = \"name\", minimum = 30,   language = get_AMR_locale(), combine_SI = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"AMR Plots with ggplot2 — ggplot_sir","text":"data data.frame column(s) class sir (see .sir()). position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". x Variable show x axis, either \"antibiotic\" (default) \"interpretation\" grouping variable. fill Variable categorise using plots legend, either \"antibiotic\" (default) \"interpretation\" grouping variable. facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. nrow (using facet) number rows. colours named vactor colour used filling. default colours colour-blind friendly. datalabels Show datalabels using labels_sir_count(). datalabels.size Size datalabels. datalabels.colour Colour datalabels. title Text show title plot. subtitle Text show subtitle plot. caption Text show caption plot. x.title Text show x axis description. y.title Text show y axis description. ... arguments passed geom_sir() , case scale_sir_colours(), named values set colours. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"AMR Plots with ggplot2 — ggplot_sir","text":"default, names antimicrobials shown plots using ab_name(). can set translate_ab argument. See count_df(). geom_sir() take variable data sir class (created .sir()) using sir_df() plot bars percentage S, , R. default behaviour bars stacked different antimicrobials x axis. Additional functions include: facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() sets colours bars (green S, yellow , red R). multilingual support. default colours colour-blind friendly, maintaining convention e.g. 'susceptible' green 'resistant' red. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage amount isolates using ggplot2::geom_text(). ggplot_sir() wrapper around functions uses data first input. makes possible use function pipe (%>%). See Examples.","code":""},{"path":"https://amr-for-r.org/reference/ggplot_sir.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"AMR Plots with ggplot2 — ggplot_sir","text":"","code":"# \\donttest{ if (require(\"ggplot2\") && require(\"dplyr\")) {   # get antimicrobial results for drugs against a UTI:   ggplot(example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)) +     geom_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # prettify the plot using some additional functions:   df <- example_isolates %>% select(AMX, NIT, FOS, TMP, CIP)   ggplot(df) +     geom_sir() +     scale_y_percent() +     scale_sir_colours(aesthetics = \"fill\") +     labels_sir_count() +     theme_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # or better yet, simplify this using the wrapper function - a single command:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir() }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # get only proportions and no counts:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(datalabels = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # add other ggplot2 arguments as you like:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(       width = 0.5,       colour = \"black\",       size = 1,       linetype = 2,       alpha = 0.25     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # you can alter the colours with colour names:   example_isolates %>%     select(AMX) %>%     ggplot_sir(colours = c(SI = \"yellow\")) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # but you can also use the built-in colour-blind friendly colours for   # your plots, where \"S\" is green, \"I\" is yellow and \"R\" is red:   data.frame(     x = c(\"Value1\", \"Value2\", \"Value3\"),     y = c(1, 2, 3),     z = c(\"Value4\", \"Value5\", \"Value6\")   ) %>%     ggplot() +     geom_col(aes(x = x, y = y, fill = z)) +     scale_sir_colours(       aesthetics = \"fill\",       Value4 = \"S\", Value5 = \"I\", Value6 = \"R\"     ) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # resistance of ciprofloxacine per age group   example_isolates %>%     mutate(first_isolate = first_isolate()) %>%     filter(       first_isolate == TRUE,       mo == as.mo(\"Escherichia coli\")     ) %>%     # age_groups() is also a function in this AMR package:     group_by(age_group = age_groups(age)) %>%     select(age_group, CIP) %>%     ggplot_sir(x = \"age_group\") } #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_col()`). #> Warning: Removed 6 rows containing missing values or values outside the scale range #> (`geom_text()`).  if (require(\"ggplot2\") && require(\"dplyr\")) {   # a shorter version which also adjusts data label colours:   example_isolates %>%     select(AMX, NIT, FOS, TMP, CIP) %>%     ggplot_sir(colours = FALSE) }  if (require(\"ggplot2\") && require(\"dplyr\")) {   # it also supports groups (don't forget to use the group var on `x` or `facet`):   example_isolates %>%     filter(mo_is_gram_negative(), ward != \"Outpatient\") %>%     # select only UTI-specific drugs     select(ward, AMX, NIT, FOS, TMP, CIP) %>%     group_by(ward) %>%     ggplot_sir(       x = \"ward\",       facet = \"antibiotic\",       nrow = 1,       title = \"AMR of Anti-UTI Drugs Per Ward\",       x.title = \"Ward\",       datalabels = FALSE     ) } #> ℹ Using column 'mo' as input for `mo_is_gram_negative()`  # }"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":null,"dir":"Reference","previous_headings":"","what":"Guess Antibiotic Column — guess_ab_col","title":"Guess Antibiotic Column — guess_ab_col","text":"tries find column name data set based information antimicrobials data set. Also supports WHONET abbreviations.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"guess_ab_col(x = NULL, search_string = NULL, verbose = FALSE,   only_sir_columns = FALSE)"},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Guess Antibiotic Column — guess_ab_col","text":"x data.frame. search_string text search x , checked .ab() value column x. verbose logical indicate whether additional info printed. only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Guess Antibiotic Column — guess_ab_col","text":"column name x, NULL result found.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Guess Antibiotic Column — guess_ab_col","text":"can look antibiotic (trade) name abbreviation search x antimicrobials data set column containing name code antibiotic.","code":""},{"path":"https://amr-for-r.org/reference/guess_ab_col.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Guess Antibiotic Column — guess_ab_col","text":"","code":"df <- data.frame(   amox = \"S\",   tetr = \"R\" )  guess_ab_col(df, \"amoxicillin\") #> [1] \"amox\" guess_ab_col(df, \"J01AA07\") # ATC code of tetracycline #> [1] \"tetr\"  guess_ab_col(df, \"J01AA07\", verbose = TRUE) #> Auto-guessing columns suitable for analysis #> ... #>  OK. #> ℹ Using column 'amox' as input for AMX (amoxicillin). #> ℹ Using column 'tetr' as input for TCY (tetracycline). #> ℹ Using column 'tetr' as input for J01AA07 (tetracycline). #> [1] \"tetr\"  # WHONET codes df <- data.frame(   AMP_ND10 = \"R\",   AMC_ED20 = \"S\" ) guess_ab_col(df, \"ampicillin\") #> [1] \"AMP_ND10\" guess_ab_col(df, \"J01CR02\") #> [1] \"AMC_ED20\" guess_ab_col(df, \"augmentin\") #> [1] \"AMC_ED20\""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"Data set containing 'EUCAST Expected Resistant Phenotypes' bug-drug combinations microorganisms antimicrobials data sets.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant"},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"tibble 271 905 observations 2 variables: mo Microorganism ID occurs microorganisms$mo. Names can retrieved using mo_name(). ab Antimicrobial ID occurs antimicrobials$ab. Names can retrieved using ab_name().","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"data set currently based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). data set internally used : not_intrinsic_resistant() (antimicrobial selector) mo_is_intrinsic_resistant()","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/intrinsic_resistant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set Denoting Bacterial Intrinsic Resistance — intrinsic_resistant","text":"","code":"intrinsic_resistant #> # A tibble: 271,905 × 2 #>    mo          ab   #>    <mo>        <ab> #>  1 B_GRAMP     ATM  #>  2 B_GRAMP     COL  #>  3 B_GRAMP     NAL  #>  4 B_GRAMP     PLB  #>  5 B_GRAMP     TEM  #>  6 B_ANAER-POS ATM  #>  7 B_ANAER-POS COL  #>  8 B_ANAER-POS NAL  #>  9 B_ANAER-POS PLB  #> 10 B_ANAER-POS TEM  #> # ℹ 271,895 more rows"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":null,"dir":"Reference","previous_headings":"","what":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"According binomial nomenclature, lowest four taxonomic levels (family, genus, species, subspecies) printed italics. function finds taxonomic names within strings makes italic.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))  italicize_taxonomy(string, type = c(\"markdown\", \"ansi\", \"html\"))"},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"string character (vector). type Type conversion taxonomic names, either \"markdown\", \"html\" \"ansi\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"function finds taxonomic names makes italic based microorganisms data set. taxonomic names can italicised using markdown (default) adding * taxonomic names, <> <\/> using html. using 'ansi', ANSI colours added using \\033[3m \\033[23m taxonomic names. multiple ANSI colours available, conversion occur. function also supports abbreviation genus followed species, \"E. coli\" \"K. pneumoniae ozaenae\".","code":""},{"path":"https://amr-for-r.org/reference/italicise_taxonomy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Italicise Taxonomic Families, Genera, Species, Subspecies — italicise_taxonomy","text":"","code":"italicise_taxonomy(\"An overview of Staphylococcus aureus isolates\") #> [1] \"An overview of *Staphylococcus aureus* isolates\" italicise_taxonomy(\"An overview of S. aureus isolates\") #> [1] \"An overview of *S. aureus* isolates\"  cat(italicise_taxonomy(\"An overview of S. aureus isolates\", type = \"ansi\")) #> An overview of S. aureus isolates"},{"path":"https://amr-for-r.org/reference/join.html","id":null,"dir":"Reference","previous_headings":"","what":"Join microorganisms to a Data Set — join","title":"Join microorganisms to a Data Set — join","text":"Join data set microorganisms easily existing data set character vector.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join microorganisms to a Data Set — join","text":"","code":"inner_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  left_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  right_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  full_join_microorganisms(x, by = NULL, suffix = c(\"2\", \"\"), ...)  semi_join_microorganisms(x, by = NULL, ...)  anti_join_microorganisms(x, by = NULL, ...)"},{"path":"https://amr-for-r.org/reference/join.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join microorganisms to a Data Set — join","text":"x Existing data set join, character vector. case character vector, resulting data.frame contain column 'x' values. variable join - left empty search column class mo (created .mo()) \"mo\" column name exists x, otherwise column name x values exist microorganisms$mo (= \"bacteria_id\"), another column microorganisms (named, like = c(\"bacteria_id\" = \"fullname\")). suffix non-joined duplicate variables x y, suffixes added output disambiguate . character vector length 2. ... Ignored, place allow future extensions.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join microorganisms to a Data Set — join","text":"data.frame","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Join microorganisms to a Data Set — join","text":"Note: opposed join() functions dplyr, character vectors supported default existing columns get suffix \"2\" newly joined columns get suffix. dplyr package installed, join functions used. Otherwise, much slower merge() interaction() functions base R used.","code":""},{"path":"https://amr-for-r.org/reference/join.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Join microorganisms to a Data Set — join","text":"","code":"left_join_microorganisms(as.mo(\"K. pneumoniae\")) #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list> left_join_microorganisms(\"B_KLBSL_PNMN\") #> # A tibble: 1 × 26 #>   mo           fullname   status kingdom phylum class order family genus species #>   <mo>         <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #> 1 B_KLBSL_PNMN Klebsiell… accep… Bacter… Pseud… Gamm… Ente… Enter… Kleb… pneumo… #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>  df <- data.frame(   date = seq(     from = as.Date(\"2018-01-01\"),     to = as.Date(\"2018-01-07\"),     by = 1   ),   bacteria = as.mo(c(     \"S. aureus\", \"MRSA\", \"MSSA\", \"STAAUR\",     \"E. coli\", \"E. coli\", \"E. coli\"   )),   stringsAsFactors = FALSE ) colnames(df) #> [1] \"date\"     \"bacteria\"  df_joined <- left_join_microorganisms(df, \"bacteria\") colnames(df_joined) #>  [1] \"date\"                \"bacteria\"            \"fullname\"            #>  [4] \"status\"              \"kingdom\"             \"phylum\"              #>  [7] \"class\"               \"order\"               \"family\"              #> [10] \"genus\"               \"species\"             \"subspecies\"          #> [13] \"rank\"                \"ref\"                 \"oxygen_tolerance\"    #> [16] \"source\"              \"lpsn\"                \"lpsn_parent\"         #> [19] \"lpsn_renamed_to\"     \"mycobank\"            \"mycobank_parent\"     #> [22] \"mycobank_renamed_to\" \"gbif\"                \"gbif_parent\"         #> [25] \"gbif_renamed_to\"     \"prevalence\"          \"snomed\"               # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     left_join_microorganisms() %>%     colnames() } #> Joining, by = \"mo\" #>  [1] \"date\"                \"patient\"             \"age\"                 #>  [4] \"gender\"              \"ward\"                \"mo\"                  #>  [7] \"PEN\"                 \"OXA\"                 \"FLC\"                 #> [10] \"AMX\"                 \"AMC\"                 \"AMP\"                 #> [13] \"TZP\"                 \"CZO\"                 \"FEP\"                 #> [16] \"CXM\"                 \"FOX\"                 \"CTX\"                 #> [19] \"CAZ\"                 \"CRO\"                 \"GEN\"                 #> [22] \"TOB\"                 \"AMK\"                 \"KAN\"                 #> [25] \"TMP\"                 \"SXT\"                 \"NIT\"                 #> [28] \"FOS\"                 \"LNZ\"                 \"CIP\"                 #> [31] \"MFX\"                 \"VAN\"                 \"TEC\"                 #> [34] \"TCY\"                 \"TGC\"                 \"DOX\"                 #> [37] \"ERY\"                 \"CLI\"                 \"AZM\"                 #> [40] \"IPM\"                 \"MEM\"                 \"MTR\"                 #> [43] \"CHL\"                 \"COL\"                 \"MUP\"                 #> [46] \"RIF\"                 \"fullname\"            \"status\"              #> [49] \"kingdom\"             \"phylum\"              \"class\"               #> [52] \"order\"               \"family\"              \"genus\"               #> [55] \"species\"             \"subspecies\"          \"rank\"                #> [58] \"ref\"                 \"oxygen_tolerance\"    \"source\"              #> [61] \"lpsn\"                \"lpsn_parent\"         \"lpsn_renamed_to\"     #> [64] \"mycobank\"            \"mycobank_parent\"     \"mycobank_renamed_to\" #> [67] \"gbif\"                \"gbif_parent\"         \"gbif_renamed_to\"     #> [70] \"prevalence\"          \"snomed\"              # }"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":null,"dir":"Reference","previous_headings":"","what":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"functions can used determine first weighted isolates considering phenotype isolate selection (see first_isolate()). Using phenotype-based method determine first isolates reliable methods disregard phenotypes.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"key_antimicrobials(x = NULL, col_mo = NULL, universal = c(\"ampicillin\",   \"amoxicillin/clavulanic acid\", \"cefuroxime\", \"piperacillin/tazobactam\",   \"ciprofloxacin\", \"trimethoprim/sulfamethoxazole\"),   gram_negative = c(\"gentamicin\", \"tobramycin\", \"colistin\", \"cefotaxime\",   \"ceftazidime\", \"meropenem\"), gram_positive = c(\"vancomycin\", \"teicoplanin\",   \"tetracycline\", \"erythromycin\", \"oxacillin\", \"rifampin\"),   antifungal = c(\"anidulafungin\", \"caspofungin\", \"fluconazole\", \"miconazole\",   \"nystatin\", \"voriconazole\"), only_sir_columns = any(is.sir(x)), ...)  all_antimicrobials(x = NULL, only_sir_columns = any(is.sir(x)), ...)  antimicrobials_equal(y, z, type = c(\"points\", \"keyantimicrobials\"),   ignore_I = TRUE, points_threshold = 2, ...)"},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank determine automatically. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). universal Names broad-spectrum antimicrobial drugs, case-insensitive. Set NULL ignore. See Details default antimicrobial drugs. gram_negative Names antibiotic drugs Gram-positives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. gram_positive Names antibiotic drugs Gram-negatives, case-insensitive. Set NULL ignore. See Details default antibiotic drugs. antifungal Names antifungal drugs fungi, case-insensitive. Set NULL ignore. See Details default antifungal drugs. only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... Ignored, place allow future extensions. y, z character vectors compare. type Type determine weighed isolates; can \"keyantimicrobials\" \"points\", see Details. ignore_I logical indicate whether antibiotic interpretations \"\" ignored type = \"keyantimicrobials\", see Details. points_threshold Minimum number points require differences antibiogram lead inclusion isolate type = \"points\", see Details.","code":""},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"key_antimicrobials() all_antimicrobials() functions context-aware. means x argument can left blank used inside data.frame call, see Examples. function key_antimicrobials() returns character vector 12 antimicrobial results every isolate. function all_antimicrobials() returns character vector antimicrobial drug results every isolate. vectors can compared using antimicrobials_equal(), check two isolates generally antibiogram. Missing invalid values replaced dot (\".\") key_antimicrobials() ignored antimicrobials_equal(). Please see first_isolate() function important functions enable 'phenotype-based' method determination first isolates. default antimicrobial drugs used rows (set universal) : Ampicillin Amoxicillin/clavulanic acid Cefuroxime Ciprofloxacin Piperacillin/tazobactam Trimethoprim/sulfamethoxazole default antimicrobial drugs used Gram-negative bacteria (set gram_negative) : Cefotaxime Ceftazidime Colistin Gentamicin Meropenem Tobramycin default antimicrobial drugs used Gram-positive bacteria (set gram_positive) : Erythromycin Oxacillin Rifampin Teicoplanin Tetracycline Vancomycin default antimicrobial drugs used fungi (set antifungal) : Anidulafungin Caspofungin Fluconazole Miconazole Nystatin Voriconazole","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/key_antimicrobials.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"(Key) Antimicrobials for First Weighted Isolates — key_antimicrobials","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # output of the `key_antimicrobials()` function could be like this: strainA <- \"SSSRR.S.R..S\" strainB <- \"SSSIRSSSRSSS\"  # those strings can be compared with: antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\") #> [1] TRUE # TRUE, because I is ignored (as well as missing values)  antimicrobials_equal(strainA, strainB, type = \"keyantimicrobials\", ignore_I = FALSE) #> [1] FALSE # FALSE, because I is not ignored and so the 4th [character] differs  # \\donttest{ if (require(\"dplyr\")) {   # set key antimicrobials to a new variable   my_patients <- example_isolates %>%     mutate(keyab = key_antimicrobials(antifungal = NULL)) %>% # no need to define `x`     mutate(       # now calculate first isolates       first_regular = first_isolate(col_keyantimicrobials = FALSE),       # and first WEIGHTED isolates       first_weighted = first_isolate(col_keyantimicrobials = \"keyab\")     )    # Check the difference in this data set, 'weighted' results in more isolates:   sum(my_patients$first_regular, na.rm = TRUE)   sum(my_patients$first_weighted, na.rm = TRUE) } #> [1] 1383 # }"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":null,"dir":"Reference","previous_headings":"","what":"Kurtosis of the Sample — kurtosis","title":"Kurtosis of the Sample — kurtosis","text":"Kurtosis measure \"tailedness\" probability distribution real-valued random variable. normal distribution kurtosis 3 excess kurtosis 0.","code":""},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(x, na.rm = FALSE, excess = FALSE)  # Default S3 method kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'matrix' kurtosis(x, na.rm = FALSE, excess = FALSE)  # S3 method for class 'data.frame' kurtosis(x, na.rm = FALSE, excess = FALSE)"},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Kurtosis of the Sample — kurtosis","text":"x vector values, matrix data.frame. na.rm logical indicate whether NA values stripped computation proceeds. excess logical indicate whether excess kurtosis returned, defined kurtosis minus 3.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/kurtosis.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Kurtosis of the Sample — kurtosis","text":"","code":"kurtosis(rnorm(10000)) #> [1] 3.069947 kurtosis(rnorm(10000), excess = TRUE) #> [1] -0.02599697"},{"path":"https://amr-for-r.org/reference/like.html","id":null,"dir":"Reference","previous_headings":"","what":"Vectorised Pattern Matching with Keyboard Shortcut — like","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Convenient wrapper around grepl() match pattern: x %like% pattern. always returns logical vector always case-insensitive (use x %like_case% pattern case-sensitive matching). Also, pattern can long x compare items index vectors, can length iterate cases.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"like(x, pattern, ignore.case = TRUE)  x %like% pattern  x %unlike% pattern  x %like_case% pattern  x %unlike_case% pattern"},{"path":"https://amr-for-r.org/reference/like.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"Idea like function data.table package, although altered explained Details.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"x character vector matches sought, object can coerced .character() character vector. pattern character vector containing regular expressions (character string fixed = TRUE) matched given character vector. Coerced .character() character string possible. ignore.case FALSE, pattern matching case sensitive TRUE, case ignored matching.","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"logical vector","code":""},{"path":"https://amr-for-r.org/reference/like.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"like() %like%/%unlike% functions: case-insensitive (use %like_case%/%unlike_case% case-sensitive matching) Support multiple patterns Check pattern valid regular expression sets fixed = TRUE , greatly improve speed (vectorised pattern) Always use compatibility Perl unless fixed = TRUE, greatly improve speed Using RStudio? %like%/%unlike% functions can also directly inserted code Addins menu can keyboard shortcut like Shift+Ctrl+L Shift+Cmd+L (see menu Tools > Modify Keyboard Shortcuts...). keep pressing shortcut, inserted text iterated %like% -> %unlike% -> %like_case% -> %unlike_case%.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/like.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Vectorised Pattern Matching with Keyboard Shortcut — like","text":"","code":"# data.table has a more limited version of %like%, so unload it: try(detach(\"package:data.table\", unload = TRUE), silent = TRUE) #> Warning: ‘data.table’ namespace cannot be unloaded: #>   namespace ‘data.table’ is imported by ‘prodlim’ so cannot be unloaded  a <- \"This is a test\" b <- \"TEST\" a %like% b #> [1] TRUE b %like% a #> [1] FALSE  # also supports multiple patterns a <- c(\"Test case\", \"Something different\", \"Yet another thing\") b <- c(\"case\", \"diff\", \"yet\") a %like% b #> [1] TRUE TRUE TRUE a %unlike% b #> [1] FALSE FALSE FALSE  a[1] %like% b #> [1]  TRUE FALSE FALSE a %like% b[1] #> [1]  TRUE FALSE FALSE  # \\donttest{ # get isolates whose name start with 'Entero' (case-insensitive) example_isolates[which(mo_name() %like% \"^entero\"), ] #> ℹ Using column 'mo' as input for `mo_name()` #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_name() %like% \"^ent\") } #> ℹ Using column 'mo' as input for `mo_name()` #> # A tibble: 106 × 46 #>    date       patient   age gender ward    mo            PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>   <mo>          <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinic… B_ENTRC_FACM    NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinic… B_ENTRC_FCLS    NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU     B_ENTRC         NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #>  8 2003-08-13 F35553     52 M      ICU     B_ENTRC_FCLS    NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU     B_ENTRC         NA    NA    NA    NA  #> 10 2003-09-05 F35553     52 M      ICU     B_ENTRBC_CLOC   R     NA    NA    R   #> # ℹ 96 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, … # }"},{"path":"https://amr-for-r.org/reference/mdro.html","id":null,"dir":"Reference","previous_headings":"","what":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Determine isolates multidrug-resistant organisms (MDRO) according international, national, custom guidelines.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"mdro(x = NULL, guideline = \"CMI 2012\", col_mo = NULL, esbl = NA,   carbapenemase = NA, mecA = NA, mecC = NA, vanA = NA, vanB = NA,   info = interactive(), pct_required_classes = 0.5, combine_SI = TRUE,   verbose = FALSE, only_sir_columns = any(is.sir(x)), ...)  brmo(x = NULL, only_sir_columns = any(is.sir(x)), ...)  mrgn(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_tb(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE, ...)  mdr_cmi2012(x = NULL, only_sir_columns = any(is.sir(x)), verbose = FALSE,   ...)  eucast_exceptional_phenotypes(x = NULL, only_sir_columns = any(is.sir(x)),   verbose = FALSE, ...)"},{"path":"https://amr-for-r.org/reference/mdro.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"x data.frame antimicrobials columns, like AMX amox. Can left blank automatic determination. guideline specific guideline follow, see sections Supported international / national guidelines Using Custom Guidelines . left empty, publication Magiorakos et al. (see ) followed. col_mo Column name names codes microorganisms (see .mo()) - default first column class mo. Values coerced using .mo(). esbl logical values, column name containing logical values, indicating presence ESBL gene (production proteins). carbapenemase logical values, column name containing logical values, indicating presence carbapenemase gene (production proteins). mecA logical values, column name containing logical values, indicating presence mecA gene (production proteins). mecC logical values, column name containing logical values, indicating presence mecC gene (production proteins). vanA logical values, column name containing logical values, indicating presence vanA gene (production proteins). vanB logical values, column name containing logical values, indicating presence vanB gene (production proteins). info logical indicate whether progress printed console - default print interactive sessions. pct_required_classes Minimal required percentage antimicrobial classes must available per isolate, rounded . example, default guideline, 17 antimicrobial classes must available S. aureus. Setting pct_required_classes argument 0.5 (default) means every S. aureus isolate least 8 different classes must available. lower number available classes return NA isolate. combine_SI logical indicate whether values S must merged one, resistance considered isolates R, . default behaviour mdro() function, follows redefinition EUCAST interpretation (increased exposure) 2019, see section 'Interpretation S, R' . using combine_SI = FALSE, resistance considered isolates R . verbose logical turn Verbose mode (default ). Verbose mode, function return MDRO results, instead returns data set logbook form extensive info isolates MDRO-positive, . only_sir_columns logical indicate whether antimicrobial columns must included transformed class sir beforehand. Defaults FALSE columns x class sir. ... Column names antimicrobials. automatically detect antimicrobial column names, provide named arguments; guess_ab_col() used detection. manually specify column, provide name (case-insensitive) argument, e.g. AMX = \"amoxicillin\". skip specific antimicrobial, set NULL, e.g. TIC = NULL exclude ticarcillin. manually defined column exist data, skipped warning.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"verbose set TRUE: data.frame containing columns row_number, microorganism, MDRO, reason, all_nonsusceptible_columns, guideline CMI 2012 paper - function mdr_cmi2012() mdro(): Ordered factor levels Negative < Multi-drug-resistant (MDR) < Extensively drug-resistant (XDR) < Pandrug-resistant (PDR) TB guideline - function mdr_tb() mdro(..., guideline = \"TB\"): Ordered factor levels Negative < Mono-resistant < Poly-resistant < Multi-drug-resistant < Extensively drug-resistant German guideline - function mrgn() mdro(..., guideline = \"MRGN\"): Ordered factor levels Negative < 3MRGN < 4MRGN Everything else, except custom guidelines: Ordered factor levels Negative < Positive, unconfirmed < Positive. value \"Positive, unconfirmed\" means , according guideline, entirely sure isolate multi-drug resistant confirmed additional (e.g. genotypic) tests","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"functions context-aware. means x argument can left blank used inside data.frame call, see Examples. pct_required_classes argument, values 1 divided 100. support fractions (0.75 3/4) percentages (75). Note: Every test involves Enterobacteriaceae family, internally performed using newly named order Enterobacterales, since Enterobacteriaceae family taxonomically reclassified Adeolu et al. 2016. , Enterobacteriaceae family Enterobacteriales () order. species old Enterobacteriaceae family still new Enterobacterales (without ) order, divided multiple families. way tests performed now mdro() function makes sure results 2016 2016 identical.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"supported-international-national-guidelines","dir":"Reference","previous_headings":"","what":"Supported International / National Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Please suggest implement guidelines letting us know. Currently supported guidelines (case-insensitive): guideline = \"CMI 2012\" (default) Magiorakos AP, Srinivasan et al. \"Multidrug-resistant, extensively drug-resistant pandrug-resistant bacteria: international expert proposal interim standard definitions acquired resistance.\" Clinical Microbiology Infection (2012) (doi:10.1111/j.1469-0691.2011.03570.x ) guideline = \"EUCAST 3.3\" (simply guideline = \"EUCAST\") European international guideline - EUCAST Expert Rules Version 3.3 \"Intrinsic Resistance Unusual Phenotypes\" (link) Also: guideline = \"EUCAST 3.2\" former European international guideline - EUCAST Expert Rules Version 3.2 \"Intrinsic Resistance Unusual Phenotypes\" (link) guideline = \"EUCAST 3.1\" former European international guideline - EUCAST Expert Rules Version 3.1 \"Intrinsic Resistance Exceptional Phenotypes Tables\" (link) guideline = \"TB\" international guideline multi-drug resistant tuberculosis - World Health Organization \"Companion handbook guidelines programmatic management drug-resistant tuberculosis\" (link) guideline = \"MRGN\" German national guideline - Mueller et al. (2015) Antimicrobial Resistance Infection Control 4:7; doi:10.1186/s13756-015-0047-6 guideline = \"BRMO 2024\" (simply guideline = \"BRMO\") Dutch national guideline - Samenwerkingverband Richtlijnen Infectiepreventie (SRI) (2024) \"Bijzonder Resistente Micro-Organismen (BRMO)\" (link) Also: guideline = \"BRMO 2017\" former Dutch national guideline - Werkgroep Infectiepreventie (WIP), RIVM, last revision 2017: \"Bijzonder Resistente Micro-Organismen (BRMO)\"","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"using-custom-guidelines","dir":"Reference","previous_headings":"","what":"Using Custom Guidelines","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"Using custom MDRO guideline importance custom rules determine MDROs hospital, e.g., rules dependent ward, state contact isolation variables data. Custom guidelines can set custom_mdro_guideline() function.","code":""},{"path":"https://amr-for-r.org/reference/mdro.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/mdro.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Determine Multidrug-Resistant Organisms (MDRO) — mdro","text":"","code":"out <- mdro(example_isolates) #> Warning: in `mdro()`: NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with `pct_required_classes`) str(out) #>  Ord.factor w/ 4 levels \"Negative\"<\"Multi-drug-resistant (MDR)\"<..: NA NA 1 1 1 1 NA NA 1 1 ... table(out) #> out #>                         Negative       Multi-drug-resistant (MDR)  #>                             1617                              128  #> Extensively drug-resistant (XDR)          Pandrug-resistant (PDR)  #>                                0                                0   out <- mdro(example_isolates, guideline = \"EUCAST 3.3\") table(out) #> out #>              Negative Positive, unconfirmed              Positive  #>                  1994                     0                     6   # \\donttest{ if (require(\"dplyr\")) {   # no need to define `x` when used inside dplyr verbs:   example_isolates %>%     mutate(MDRO = mdro()) %>%     count(MDRO) } #> Warning: There was 1 warning in `mutate()`. #> ℹ In argument: `MDRO = mdro()`. #> Caused by warning: #> ! in `mdro()`: NA introduced for isolates where the available percentage of #> antimicrobial classes was below 50% (set with `pct_required_classes`) #> # A tibble: 3 × 2 #>   MDRO                           n #>   <ord>                      <int> #> 1 Negative                    1617 #> 2 Multi-drug-resistant (MDR)   128 #> 3 NA                           255 # }"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Mean AMR Distance — mean_amr_distance","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Calculates normalised mean antimicrobial resistance multiple observations, help identify similar isolates without comparing antibiograms hand.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"mean_amr_distance(x, ...)  # S3 method for class 'sir' mean_amr_distance(x, ..., combine_SI = TRUE)  # S3 method for class 'data.frame' mean_amr_distance(x, ..., combine_SI = TRUE)  amr_distance_from_row(amr_distance, row)"},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"x vector class sir, mic disk, data.frame containing columns classes. ... Variables select. Supports tidyselect language (.mic), starts_with(...), column1:column4, can thus also antimicrobial selectors. combine_SI logical indicate whether values S, SDD, must merged one, input consists S+vs. R (susceptible vs. resistant) - default TRUE. amr_distance outcome mean_amr_distance(). row index, row number.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"mean AMR distance effectively Z-score; normalised numeric value compare AMR test results can help identify similar isolates, without comparing antibiograms hand. MIC values (see .mic()) transformed log2() first; distance thus calculated (log2(x) - mean(log2(x))) / sd(log2(x)). SIR values (see .sir()) transformed using \"S\" = 1, \"\" = 2, \"R\" = 3. combine_SI TRUE (default), \"\" considered 1. data sets, mean AMR distance calculated per column, mean per row returned, see Examples. Use amr_distance_from_row() subtract distances distance one row, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"interpretation","dir":"Reference","previous_headings":"","what":"Interpretation","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"Isolates distances less 0.01 difference considered similar. Differences lower 0.025 considered suspicious.","code":""},{"path":"https://amr-for-r.org/reference/mean_amr_distance.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Mean AMR Distance — mean_amr_distance","text":"","code":"sir <- random_sir(10) sir #> Class 'sir' #>  [1] R R I R I I S R S I mean_amr_distance(sir) #>  [1]  1.1618950  1.1618950 -0.7745967  1.1618950 -0.7745967 -0.7745967 #>  [7] -0.7745967  1.1618950 -0.7745967 -0.7745967  mic <- random_mic(10) mic #> Class 'mic' #>  [1] 0.032 0.5   1     >=8   4     0.016 >=8   1     0.004 0.008 mean_amr_distance(mic) #>  [1] -0.7311752  0.2104422  0.4478776  1.1601837  0.9227483 -0.9686106 #>  [7]  1.1601837  0.4478776 -1.4434813 -1.2060459 # equal to the Z-score of their log2: (log2(mic) - mean(log2(mic))) / sd(log2(mic)) #>  [1] -0.7311752  0.2104422  0.4478776  1.1601837  0.9227483 -0.9686106 #>  [7]  1.1601837  0.4478776 -1.4434813 -1.2060459  disk <- random_disk(10) disk #> Class 'disk' #>  [1] 50 49 38 33 31 17 42 43 46 37 mean_amr_distance(disk) #>  [1]  1.15131286  1.05032051 -0.06059541 -0.56555720 -0.76754191 -2.18143490 #>  [7]  0.34337401  0.44436637  0.74734344 -0.16158777  y <- data.frame(   id = LETTERS[1:10],   amox = random_sir(10, ab = \"amox\", mo = \"Escherichia coli\"),   cipr = random_disk(10, ab = \"cipr\", mo = \"Escherichia coli\"),   gent = random_mic(10, ab = \"gent\", mo = \"Escherichia coli\"),   tobr = random_mic(10, ab = \"tobr\", mo = \"Escherichia coli\") ) y #>    id amox cipr gent tobr #> 1   A    I   27  >=2    8 #> 2   B    S   28    1    8 #> 3   C    R   33    1    8 #> 4   D    R   32    1   16 #> 5   E    I   25  0.5   16 #> 6   F    I   19  0.5    8 #> 7   G    S   23  0.5   16 #> 8   H    R   27  0.5    8 #> 9   I    S   29    1    8 #> 10  J    R   32  0.5   16 mean_amr_distance(y) #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>  [1]  0.08471751 -0.21572693  0.55391610  0.98093500 -0.26046456 -1.08721162 #>  [7] -0.37467261 -0.14625651 -0.15862291  0.62338653 y$amr_distance <- mean_amr_distance(y, is.mic(y)) #> ℹ Calculating mean AMR distance based on columns \"gent\" and \"tobr\" y[order(y$amr_distance), ] #>    id amox cipr gent tobr amr_distance #> 6   F    I   19  0.5    8   -0.8163565 #> 8   H    R   27  0.5    8   -0.8163565 #> 2   B    S   28    1    8   -0.1012596 #> 3   C    R   33    1    8   -0.1012596 #> 9   I    S   29    1    8   -0.1012596 #> 5   E    I   25  0.5   16    0.1518893 #> 7   G    S   23  0.5   16    0.1518893 #> 10  J    R   32  0.5   16    0.1518893 #> 1   A    I   27  >=2    8    0.6138374 #> 4   D    R   32    1   16    0.8669863  if (require(\"dplyr\")) {   y %>%     mutate(       amr_distance = mean_amr_distance(y),       check_id_C = amr_distance_from_row(amr_distance, id == \"C\")     ) %>%     arrange(check_id_C) } #> ℹ Calculating mean AMR distance based on columns \"amox\", \"cipr\", \"gent\", #>   and \"tobr\" #>    id amox cipr gent tobr amr_distance check_id_C #> 1   C    R   33    1    8   0.55391610 0.00000000 #> 2   J    R   32  0.5   16   0.62338653 0.06947042 #> 3   D    R   32    1   16   0.98093500 0.42701889 #> 4   A    I   27  >=2    8   0.08471751 0.46919859 #> 5   H    R   27  0.5    8  -0.14625651 0.70017262 #> 6   I    S   29    1    8  -0.15862291 0.71253901 #> 7   B    S   28    1    8  -0.21572693 0.76964304 #> 8   E    I   25  0.5   16  -0.26046456 0.81438066 #> 9   G    S   23  0.5   16  -0.37467261 0.92858871 #> 10  F    I   19  0.5    8  -1.08721162 1.64112773 if (require(\"dplyr\")) {   # support for groups   example_isolates %>%     filter(mo_genus() == \"Enterococcus\" & mo_species() != \"\") %>%     select(mo, TCY, carbapenems()) %>%     group_by(mo) %>%     mutate(dist = mean_amr_distance(.)) %>%     arrange(mo, dist) } #> ℹ Using column 'mo' as input for `mo_genus()` #> ℹ Using column 'mo' as input for `mo_species()` #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> ℹ Calculating mean AMR distance based on columns \"TCY\", \"IPM\", and \"MEM\" #> # A tibble: 63 × 5 #> # Groups:   mo [4] #>    mo           TCY   IPM   MEM     dist #>    <mo>         <sir> <sir> <sir>  <dbl> #>  1 B_ENTRC_AVIM   S     S     NA   0     #>  2 B_ENTRC_AVIM   S     S     NA   0     #>  3 B_ENTRC_CSSL   NA    S     NA  NA     #>  4 B_ENTRC_FACM   S     S     NA  -2.66  #>  5 B_ENTRC_FACM   S     R     R   -0.423 #>  6 B_ENTRC_FACM   S     R     R   -0.423 #>  7 B_ENTRC_FACM   NA    R     R    0.224 #>  8 B_ENTRC_FACM   NA    R     R    0.224 #>  9 B_ENTRC_FACM   NA    R     R    0.224 #> 10 B_ENTRC_FACM   NA    R     R    0.224 #> # ℹ 53 more rows"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"data set containing commonly used codes microorganisms, laboratory systems WHONET. Define set_mo_source(). searched using .mo() consequently mo_* functions.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes"},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"tibble 6 036 observations 2 variables: code Commonly used code microorganism. unique identifier. mo ID microorganism microorganisms data set","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.codes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 6 036 Common Microorganism Codes — microorganisms.codes","text":"","code":"microorganisms.codes #> # A tibble: 6,036 × 2 #>    code  mo                #>    <chr> <mo>              #>  1 1011  B_GRAMP           #>  2 1012  B_GRAMP           #>  3 1013  B_GRAMN           #>  4 1014  B_GRAMN           #>  5 1015  F_YEAST           #>  6 103   B_ESCHR_COLI      #>  7 104   B_SLMNL_ENTR_ENTR #>  8 1100  B_STRPT           #>  9 1101  B_STRPT_VIRI      #> 10 1102  B_STRPT_HAEM      #> # ℹ 6,026 more rows  # 'ECO' or 'eco' is the WHONET code for E. coli: microorganisms.codes[microorganisms.codes$code == \"ECO\", ] #> # A tibble: 1 × 2 #>   code  mo           #>   <chr> <mo>         #> 1 ECO   B_ESCHR_COLI  # and therefore, 'eco' will be understood as E. coli in this package: mo_info(\"eco\") #> $mo #> [1] \"B_ESCHR_COLI\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Escherichia\" #>  #> $species #> [1] \"coli\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/escherichia-coli\" #>  #> $ref #> [1] \"Castellani et al., 1919\" #>  #> $snomed #>  [1] \"1095001000112106\" \"715307006\"        \"737528008\"        \"416989002\"        #>  [5] \"116397003\"        \"414097009\"        \"414098004\"        \"414099007\"        #>  [9] \"414100004\"        \"116395006\"        \"735270003\"        \"116396007\"        #> [13] \"83285000\"         \"116394005\"        \"112283007\"        \"710886005\"        #> [17] \"710887001\"        \"710888006\"        \"710889003\"        \"414132004\"        #> [21] \"721892009\"        \"416812001\"        \"416740004\"        \"417216001\"        #> [25] \"457541006\"        \"710253004\"        \"416530004\"        \"417189006\"        #> [29] \"409800005\"        \"713925008\"        \"444771000124108\"  \"838549008\"        #>  #> $lpsn #> [1] \"776057\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"11286021\" #>  #> $group_members #> character(0) #>   # works for all AMR functions: mo_is_intrinsic_resistant(\"eco\", ab = \"vancomycin\") #> [1] TRUE"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"data set containing species groups microbiological complexes, used clinical breakpoints table.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups"},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"tibble 534 observations 4 variables: mo_group ID species group / microbiological complex mo ID microorganism belonging species group / microbiological complex mo_group_name Name species group / microbiological complex, retrieved mo_name() mo_name Name microorganism belonging species group / microbiological complex, retrieved mo_name()","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.groups.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 534 Microorganisms In Species Groups — microorganisms.groups","text":"","code":"microorganisms.groups #> # A tibble: 534 × 4 #>    mo_group       mo           mo_group_name                   mo_name           #>    <mo>           <mo>         <chr>                           <chr>             #>  1 B_ACNTB_BMNN-C B_ACNTB_BMNN Acinetobacter baumannii complex Acinetobacter ba… #>  2 B_ACNTB_BMNN-C B_ACNTB_CLCC Acinetobacter baumannii complex Acinetobacter ca… #>  3 B_ACNTB_BMNN-C B_ACNTB_LCTC Acinetobacter baumannii complex Acinetobacter di… #>  4 B_ACNTB_BMNN-C B_ACNTB_NSCM Acinetobacter baumannii complex Acinetobacter no… #>  5 B_ACNTB_BMNN-C B_ACNTB_PITT Acinetobacter baumannii complex Acinetobacter pi… #>  6 B_ACNTB_BMNN-C B_ACNTB_SFRT Acinetobacter baumannii complex Acinetobacter se… #>  7 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex    Bacteroides frag… #>  8 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex    Bacteroides ovat… #>  9 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex    Bacteroides thet… #> 10 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex    Bacteroides vulg… #> # ℹ 524 more rows  # these are all species in the Bacteroides fragilis group, as per WHONET: microorganisms.groups[microorganisms.groups$mo_group == \"B_BCTRD_FRGL-C\", ] #> # A tibble: 5 × 4 #>   mo_group       mo           mo_group_name                mo_name               #>   <mo>           <mo>         <chr>                        <chr>                 #> 1 B_BCTRD_FRGL-C B_BCTRD_FRGL Bacteroides fragilis complex Bacteroides fragilis  #> 2 B_BCTRD_FRGL-C B_BCTRD_OVTS Bacteroides fragilis complex Bacteroides ovatus    #> 3 B_BCTRD_FRGL-C B_BCTRD_THTT Bacteroides fragilis complex Bacteroides thetaiot… #> 4 B_BCTRD_FRGL-C B_PHCCL_VLGT Bacteroides fragilis complex Bacteroides vulgatus  #> 5 B_BCTRD_FRGL-C B_PRBCT_DSTS Bacteroides fragilis complex Parabacteroides dist…"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"data set containing full microbial taxonomy (last updated: June 24th, 2024) six kingdoms. data set backbone AMR package. MO codes can looked using .mo() microorganism properties can looked using mo_* functions. data set carefully crafted, yet made 100% reproducible public authoritative taxonomic sources (using script), namely: List Prokaryotic names Standing Nomenclature (LPSN) bacteria, MycoBank fungi, Global Biodiversity Information Facility (GBIF) others taxons.","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms"},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"tibble 78 679 observations 26 variables: mo ID microorganism used package. unique identifier. fullname Full name, like \"Escherichia coli\". taxonomic ranks genus, species subspecies, 'pasted' text genus, species, subspecies. taxonomic ranks higher genus, name taxon. unique identifier. status  Status taxon, either \"accepted\", \"validly published\", \"synonym\", \"unknown\" kingdom, phylum, class, order, family, genus, species, subspecies Taxonomic rank microorganism. Note fungi, phylum equal taxonomic division. Also, fungi, subkingdom subdivision left since occur bacterial taxonomy. rank Text taxonomic rank microorganism, \"species\" \"genus\" ref Author(s) year related scientific publication. contains first surname year latest authors, e.g. \"Wallis et al. 2006 emend. Smith Jones 2018\" becomes \"Smith et al., 2018\". field directly retrieved source specified column source. Moreover, accents removed comply CRAN allows ASCII characters. oxygen_tolerance  Oxygen tolerance, either \"aerobe\", \"anaerobe\", \"anaerobe/microaerophile\", \"facultative anaerobe\", \"likely facultative anaerobe\", \"microaerophile\". data retrieved BacDive (see Source). Items contain \"likely\" missing BacDive extrapolated species within genus guess oxygen tolerance. Currently 68.3% ~39 000 bacteria data set contain oxygen tolerance. source Either \"GBIF\", \"LPSN\", \"Manually added\", \"MycoBank\", \"manually added\" (see Source) lpsn Identifier ('Record number') List Prokaryotic names Standing Nomenclature (LPSN). first/highest LPSN identifier keep one identifier per row. example, Acetobacter ascendens LPSN Record number 7864 11011. first available microorganisms data set. unique identifier, though available ~33 000 records. lpsn_parent LPSN identifier parent taxon lpsn_renamed_to LPSN identifier currently valid taxon mycobank Identifier ('MycoBank #') MycoBank. unique identifier, though available ~18 000 records. mycobank_parent MycoBank identifier parent taxon mycobank_renamed_to MycoBank identifier currently valid taxon gbif Identifier ('taxonID') Global Biodiversity Information Facility (GBIF). unique identifier, though available ~49 000 records. gbif_parent GBIF identifier parent taxon gbif_renamed_to GBIF identifier currently valid taxon prevalence Prevalence microorganism based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ), see mo_matching_score() full explanation snomed Systematized Nomenclature Medicine (SNOMED) code microorganism, version July 16th, 2024 (see Source). Use mo_snomed() retrieve quickly, see mo_property().","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Taxonomic entries imported order importance: List Prokaryotic names Standing Nomenclature (LPSN): Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. MycoBank: Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. Global Biodiversity Information Facility (GBIF): GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Furthermore, sources used additional details: BacDive: Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Systematized Nomenclature Medicine - Clinical Terms (SNOMED-CT): Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). Accessed https://www.cdc.gov/phin/php/phinvads/ July 16th, 2024. Grimont et al. (2007). Antigenic Formulae Salmonella Serovars, 9th Edition. Collaborating Centre Reference Research Salmonella (WHOCC-SALM). Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Please note entries based LPSN, MycoBank, GBIF (see ). Since sources incorporate entries based (recent) publications International Journal Systematic Evolutionary Microbiology (IJSEM), can happen year publication sometimes later one might expect. example, Staphylococcus pettenkoferi described first time Diagnostic Microbiology Infectious Disease 2002 (doi:10.1016/s0732-8893(02)00399-1 ), 2007 publication IJSEM followed (doi:10.1099/ijs.0.64381-0 ). Consequently, AMR package returns 2007 mo_year(\"S. pettenkoferi\").","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"included-taxa","dir":"Reference","previous_headings":"","what":"Included Taxa","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"Included taxonomic data LPSN, MycoBank, GBIF : ~39 000 (sub)species kingdoms Archaea Bacteria ~28 000 species kingdom Fungi. kingdom Fungi large taxon almost 300,000 different (sub)species, microbial (rather macroscopic, like mushrooms). , fungi fit scope package. relevant fungi covered (species Aspergillus, Candida, Cryptococcus, Histoplasma, Pneumocystis, Saccharomyces Trichophyton). ~8 100 (sub)species kingdom Protozoa ~1 600 (sub)species 39 relevant genera kingdom Animalia (Strongyloides Taenia) ~22 000 previously accepted names included (sub)species (taxonomically renamed) complete taxonomic tree included (sub)species: kingdom subspecies identifier parent taxons year first author related scientific publication","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"manual-additions","dir":"Reference","previous_headings":"","what":"Manual additions","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"convenience, entries added manually: ~1 500 entries Salmonella, city-like serovars groups H 37 species groups (beta-haemolytic Streptococcus groups K, coagulase-negative Staphylococcus (CoNS), Mycobacterium tuberculosis complex, etc.), group compositions stored microorganisms.groups data set 1 entry Blastocystis (B.  hominis), although officially exist (Noel et al. 2005, PMID 15634993) 1 entry Moraxella (M. catarrhalis), formally named Branhamella catarrhalis (Catlin, 1970) though change never accepted within field clinical microbiology 8 'undefined' entries (unknown, unknown Gram-negatives, unknown Gram-positives, unknown yeast, unknown fungus, unknown anaerobic Gram-pos/Gram-neg bacteria) syntax used transform original data cleansed R format, can found .","code":""},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Data Set with 78 679 Taxonomic Records of Microorganisms — microorganisms","text":"","code":"microorganisms #> # A tibble: 78,679 × 26 #>    mo          fullname   status kingdom phylum class order family genus species #>    <mo>        <chr>      <chr>  <chr>   <chr>  <chr> <chr> <chr>  <chr> <chr>   #>  1 B_GRAMN     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  2 B_GRAMP     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  3 B_ANAER-NEG (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  4 B_ANAER-POS (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  5 B_ANAER     (unknown … unkno… Bacter… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  6 F_FUNGUS    (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  7   UNKNOWN   (unknown … unkno… (unkno… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  8 P_PROTOZOAN (unknown … unkno… Protoz… (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #>  9 F_YEAST     (unknown … unkno… Fungi   (unkn… (unk… (unk… \"(unk… (unk… \"(unkn… #> 10 F_AABRN     Aabaarnia  unkno… Fungi   Ascom… Leca… Ostr… \"\"     Aaba… \"\"      #> # ℹ 78,669 more rows #> # ℹ 16 more variables: subspecies <chr>, rank <chr>, ref <chr>, #> #   oxygen_tolerance <chr>, source <chr>, lpsn <chr>, lpsn_parent <chr>, #> #   lpsn_renamed_to <chr>, mycobank <chr>, mycobank_parent <chr>, #> #   mycobank_renamed_to <chr>, gbif <chr>, gbif_parent <chr>, #> #   gbif_renamed_to <chr>, prevalence <dbl>, snomed <list>"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the Matching Score for Microorganisms — mo_matching_score","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm used .mo() mo_* functions determine probable match taxonomic records based user input.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_matching_score(x, n)"},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"x user input value(s). n full taxonomic name, exists microorganisms$fullname.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"algorithm originally developed 2018 subsequently described : Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 . Later, work Bartlett et al. bacterial pathogens infecting humans (2022, doi:10.1099/mic.0.001269 ) incorporated, optimalisations algorithm made.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"ambiguous user input .mo() mo_* functions, returned results chosen based matching score using mo_matching_score(). matching score \\(m\\), calculated : $$m_{(x, n)} = \\frac{l_{n} - 0.5 \\cdot \\min \\begin{cases}l_{n} \\\\ \\textrm{lev}(x, n)\\end{cases}}{l_{n} \\cdot p_{n} \\cdot k_{n}}$$ : \\(x\\) user input; \\(n\\) taxonomic name (genus, species, subspecies); \\(l_n\\) length \\(n\\); \\(lev\\) Levenshtein distance function (counting insertion 1, deletion substitution 2) needed change \\(x\\) \\(n\\); \\(p_n\\) human pathogenic prevalence group \\(n\\), described ; \\(k_n\\) taxonomic kingdom \\(n\\), set Bacteria = 1, Fungi = 1.25, Protozoa = 1.5, Chromista = 1.75, Archaea = 2, others = 3. grouping human pathogenic prevalence \\(p\\) based recent work Bartlett et al. (2022, doi:10.1099/mic.0.001269 ) extensively studied medical-scientific literature categorise bacterial species groups: Established, taxonomic species infected least three persons three references. records prevalence = 1.15 microorganisms data set; Putative, taxonomic species fewer three known cases. records prevalence = 1.25 microorganisms data set. Furthermore, Genera World Health Organization's () Priority Pathogen List prevalence = 1.0 microorganisms data set; genus present established list also prevalence = 1.15 microorganisms data set; genus present putative list prevalence = 1.25 microorganisms data set; species subspecies genus present two aforementioned groups, prevalence = 1.5 microorganisms data set; non-bacterial genus, species subspecies genus present following list, prevalence = 1.25 microorganisms data set: Absidia, Acanthamoeba, Acremonium, Actinomucor, Aedes, Alternaria, Amoeba, Ancylostoma, Angiostrongylus, Anisakis, Anopheles, Apophysomyces, Arthroderma, Aspergillus, Aureobasidium, Basidiobolus, Beauveria, Bipolaris, Blastobotrys, Blastocystis, Blastomyces, Candida, Capillaria, Chaetomium, Chilomastix, Chrysonilia, Chrysosporium, Cladophialophora, Cladosporium, Clavispora, Coccidioides, Cokeromyces, Conidiobolus, Coniochaeta, Contracaecum, Cordylobia, Cryptococcus, Cryptosporidium, Cunninghamella, Curvularia, Cyberlindnera, Debaryozyma, Demodex, Dermatobia, Dientamoeba, Diphyllobothrium, Dirofilaria, Echinostoma, Entamoeba, Enterobius, Epidermophyton, Exidia, Exophiala, Exserohilum, Fasciola, Fonsecaea, Fusarium, Geotrichum, Giardia, Graphium, Haloarcula, Halobacterium, Halococcus, Hansenula, Hendersonula, Heterophyes, Histomonas, Histoplasma, Hortaea, Hymenolepis, Hypomyces, Hysterothylacium, Kloeckera, Kluyveromyces, Kodamaea, Lacazia, Leishmania, Lichtheimia, Lodderomyces, Lomentospora, Madurella, Malassezia, Malbranchea, Metagonimus, Meyerozyma, Microsporidium, Microsporum, Millerozyma, Mortierella, Mucor, Mycocentrospora, Nannizzia, Necator, Nectria, Ochroconis, Oesophagostomum, Oidiodendron, Opisthorchis, Paecilomyces, Paracoccidioides, Pediculus, Penicillium, Phaeoacremonium, Phaeomoniella, Phialophora, Phlebotomus, Phoma, Pichia, Piedraia, Pithomyces, Pityrosporum, Pneumocystis, Pseudallescheria, Pseudoscopulariopsis, Pseudoterranova, Pulex, Purpureocillium, Quambalaria, Rhinocladiella, Rhizomucor, Rhizopus, Rhodotorula, Saccharomyces, Saksenaea, Saprochaete, Sarcoptes, Scedosporium, Schistosoma, Schizosaccharomyces, Scolecobasidium, Scopulariopsis, Scytalidium, Spirometra, Sporobolomyces, Sporopachydermia, Sporothrix, Sporotrichum, Stachybotrys, Strongyloides, Syncephalastrum, Syngamus, Taenia, Talaromyces, Teleomorph, Toxocara, Trichinella, Trichobilharzia, Trichoderma, Trichomonas, Trichophyton, Trichosporon, Trichostrongylus, Trichuris, Tritirachium, Trombicula, Trypanosoma, Tunga, Ulocladium, Ustilago, Verticillium, Wallemia, Wangiella, Wickerhamomyces, Wuchereria, Yarrowia, Zygosaccharomyces; records prevalence = 2.0 microorganisms data set. calculating matching score, characters \\(x\\) \\(n\\) ignored -Z, -z, 0-9, spaces parentheses. matches sorted descending matching score user input values, top match returned. lead effect e.g., \"E. coli\" return microbial ID Escherichia coli (\\(m = 0.688\\), highly prevalent microorganism found humans) Entamoeba coli (\\(m = 0.381\\), less prevalent microorganism humans), although latter alphabetically come first.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":"https://amr-for-r.org/reference/mo_matching_score.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the Matching Score for Microorganisms — mo_matching_score","text":"","code":"mo_reset_session() #> ℹ Reset 17 previously matched input values.  as.mo(\"E. coli\") #> Class 'mo' #> [1] B_ESCHR_COLI mo_uncertainties() #> Matching scores are based on the resemblance between the input and the full #> taxonomic name, and the pathogenicity in humans. See `?mo_matching_score`. #> Colour keys:  0.000-0.549  0.550-0.649  0.650-0.749  0.750-1.000  #>  #> -------------------------------------------------------------------------------- #> \"E. coli\" -> Escherichia coli (B_ESCHR_COLI, 0.688) #> Also matched: Enterococcus crotali (0.650), Escherichia coli coli #>               (0.643), Escherichia coli expressing (0.611), Enterobacter cowanii #>               (0.600), Enterococcus columbae (0.595), Enterococcus camelliae (0.591), #>               Enterococcus casseliflavus (0.577), Enterobacter cloacae cloacae #>               (0.571), Enterobacter cloacae complex (0.571), and Enterobacter cloacae #>               dissolvens (0.565) #>  #> Only the first 10 other matches of each record are shown. Run #> `print(mo_uncertainties(), n = ...)` to view more entries, or save #> `mo_uncertainties()` to an object.  mo_matching_score(   x = \"E. coli\",   n = c(\"Escherichia coli\", \"Entamoeba coli\") ) #> [1] 0.6875000 0.3809524"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Properties of a Microorganism — mo_property","title":"Get Properties of a Microorganism — mo_property","text":"Use functions return specific property microorganism based latest accepted taxonomy. input values evaluated internally .mo(), makes possible use microbial abbreviations, codes names input. See Examples.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Properties of a Microorganism — mo_property","text":"","code":"mo_name(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_fullname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_shortname(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_subspecies(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_species(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_genus(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_family(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_order(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_class(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_phylum(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_kingdom(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_domain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_type(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_status(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_pathogenicity(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gramstain(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_negative(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_gram_positive(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_yeast(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_intrinsic_resistant(x, ab, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_oxygen_tolerance(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_is_anaerobic(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_snomed(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_ref(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_authors(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_year(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_lpsn(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_mycobank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_gbif(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_rank(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_taxonomy(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_synonyms(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_current(x, language = get_AMR_locale(), ...)  mo_group_members(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_info(x, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_url(x, open = FALSE, language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)  mo_property(x, property = \"fullname\", language = get_AMR_locale(),   keep_synonyms = getOption(\"AMR_keep_synonyms\", FALSE), ...)"},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Properties of a Microorganism — mo_property","text":"x character (vector) can coerced valid microorganism code .mo(). Can left blank auto-guessing column containing microorganism codes used data set, see Examples. language Language translate text like \"growth\", defaults system language (see get_AMR_locale()). keep_synonyms logical indicate old, previously valid taxonomic names must preserved corrected currently accepted names. default FALSE, return note old taxonomic names processed. default can set package option AMR_keep_synonyms, .e. options(AMR_keep_synonyms = TRUE) options(AMR_keep_synonyms = FALSE). ... arguments passed .mo(), 'minimum_matching_score', 'ignore_pattern', 'remove_from_input'. ab (vector ) text can coerced valid antibiotic drug code .ab(). open Browse URL using browseURL(). property One column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\", must \"shortname\".","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Properties of a Microorganism — mo_property","text":"integer case mo_year() ordered factor case mo_pathogenicity() list case mo_taxonomy(), mo_synonyms(), mo_snomed(), mo_info() logical case mo_is_anaerobic(), mo_is_gram_negative(), mo_is_gram_positive(), mo_is_intrinsic_resistant(), mo_is_yeast() named character case mo_synonyms() mo_url() character cases","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get Properties of a Microorganism — mo_property","text":"functions , default, keep old taxonomic properties, synonyms automatically replaced current taxonomy. Take example Enterobacter aerogenes, initially named 1960 renamed Klebsiella aerogenes 2017: mo_genus(\"Enterobacter aerogenes\") return \"Klebsiella\" (note renaming) mo_genus(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Enterobacter\" (-per-session warning name outdated) mo_ref(\"Enterobacter aerogenes\") return \"Tindall et al., 2017\" (note renaming) mo_ref(\"Enterobacter aerogenes\", keep_synonyms = TRUE) return \"Hormaeche et al., 1960\" (-per-session warning name outdated) short name (mo_shortname()) returns first character genus full species, \"E. coli\", species subspecies. Exceptions abbreviations staphylococci (\"CoNS\", Coagulase-Negative Staphylococci) beta-haemolytic streptococci (\"GBS\", Group B Streptococci). Please bear mind e.g. E. coli mean Escherichia coli (kingdom Bacteria) well Entamoeba coli (kingdom Protozoa). Returning full name done using .mo() internally, giving priority bacteria human pathogens, .e. \"E. coli\" considered Escherichia coli. result, mo_fullname(mo_shortname(\"Entamoeba coli\")) returns \"Escherichia coli\". Since top-level taxonomy sometimes referred 'kingdom' sometimes 'domain', functions mo_kingdom() mo_domain() return exact results. Determination human pathogenicity (mo_pathogenicity()) strongly based Bartlett et al. (2022, doi:10.1099/mic.0.001269 ). function returns factor levels Pathogenic, Potentially pathogenic, Non-pathogenic, Unknown. Determination Gram stain (mo_gramstain()) based taxonomic kingdom phylum. Originally, Cavalier-Smith defined -called subkingdoms Negibacteria Posibacteria (2002, PMID 11837318), considered phyla Posibacteria: Actinobacteria, Chloroflexi, Firmicutes, Tenericutes. phyla later renamed Actinomycetota, Chloroflexota, Bacillota, Mycoplasmatota (2021, PMID 34694987). Bacteria phyla considered Gram-positive AMR package, except members class Negativicutes (within phylum Bacillota) Gram-negative. bacteria considered Gram-negative. Species outside kingdom Bacteria return value NA. Functions mo_is_gram_negative() mo_is_gram_positive() always return TRUE FALSE (NA input NA MO code UNKNOWN), thus always return FALSE species outside taxonomic kingdom Bacteria. Determination yeasts (mo_is_yeast()) based taxonomic kingdom class. Budding yeasts yeasts reproduce asexually process called budding, new cell develops small protrusion parent cell. Taxonomically, members phylum Ascomycota, class Saccharomycetes (also called Hemiascomycetes) Pichiomycetes. True yeasts quite specifically refers yeasts underlying order Saccharomycetales (Saccharomyces cerevisiae). Thus, microorganisms member taxonomic class Saccharomycetes Pichiomycetes, function return TRUE. returns FALSE otherwise (NA input NA MO code UNKNOWN). Determination intrinsic resistance (mo_is_intrinsic_resistant()) based intrinsic_resistant data set, based 'EUCAST Expected Resistant Phenotypes' v1.2 (2023). mo_is_intrinsic_resistant() function can vectorised argument x (input microorganisms) ab (input antimicrobials). Determination bacterial oxygen tolerance (mo_oxygen_tolerance()) based BacDive, see Source. function mo_is_anaerobic() returns TRUE oxygen tolerance \"anaerobe\", indicting obligate anaerobic species genus. always returns FALSE species outside taxonomic kingdom Bacteria. function mo_url() return direct URL online database entry, also shows scientific reference concerned species. MycoBank URL used fungi wherever available , LPSN URL bacteria wherever available, GBIF link otherwise. SNOMED codes (mo_snomed()) last updated July 16th, 2024. See Source microorganisms data set info. Old taxonomic names (-called 'synonyms') can retrieved mo_synonyms() (scientific reference name), current taxonomic name can retrieved mo_current(). functions return full names. output translated possible.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"matching-score-for-microorganisms","dir":"Reference","previous_headings":"","what":"Matching Score for Microorganisms","title":"Get Properties of a Microorganism — mo_property","text":"function uses .mo() internally, uses advanced algorithm translate arbitrary user input valid taxonomy using -called matching score. can read public algorithm MO matching score page.","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Get Properties of a Microorganism — mo_property","text":"Berends MS et al. (2022). AMR: R Package Working Antimicrobial Resistance Data. Journal Statistical Software, 104(3), 1-31; doi:10.18637/jss.v104.i03 Parte, AC et al. (2020). List Prokaryotic names Standing Nomenclature (LPSN) moves DSMZ. International Journal Systematic Evolutionary Microbiology, 70, 5607-5612; doi:10.1099/ijsem.0.004332 . Accessed https://lpsn.dsmz.de June 24th, 2024. Vincent, R et al (2013). MycoBank gearing new horizons. IMA Fungus, 4(2), 371-9; doi:10.5598/imafungus.2013.04.02.16 . Accessed https://www.mycobank.org June 24th, 2024. GBIF Secretariat (2023). GBIF Backbone Taxonomy. Checklist dataset doi:10.15468/39omei . Accessed https://www.gbif.org June 24th, 2024. Reimer, LC et al. (2022). BacDive 2022: knowledge base standardized bacterial archaeal data. Nucleic Acids Res., 50(D1):D741-D74; doi:10.1093/nar/gkab961 . Accessed https://bacdive.dsmz.de July 16th, 2024. Public Health Information Network Vocabulary Access Distribution System (PHIN VADS). US Edition SNOMED CT 1 September 2020. Value Set Name 'Microorganism', OID 2.16.840.1.114222.4.11.1009 (v12). URL: https://www.cdc.gov/phin/php/phinvads/ Bartlett et al. (2022). comprehensive list bacterial pathogens infecting humans Microbiology 168:001269; doi:10.1099/mic.0.001269","code":""},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"download-our-reference-data","dir":"Reference","previous_headings":"","what":"Download Our Reference Data","title":"Get Properties of a Microorganism — mo_property","text":"reference data sets AMR package - including information microorganisms, antimicrobials, clinical breakpoints - freely available download multiple formats: R, MS Excel, Apache Feather, Apache Parquet, SPSS, Stata. maximum compatibility, also provide machine-readable, tab-separated plain text files suitable use software, including laboratory information systems. Visit website direct download links, explore actual files GitHub repository.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/mo_property.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Properties of a Microorganism — mo_property","text":"","code":"# taxonomic tree -----------------------------------------------------------  mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_phylum(\"Klebsiella pneumoniae\") #> [1] \"Pseudomonadota\" mo_class(\"Klebsiella pneumoniae\") #> [1] \"Gammaproteobacteria\" mo_order(\"Klebsiella pneumoniae\") #> [1] \"Enterobacterales\" mo_family(\"Klebsiella pneumoniae\") #> [1] \"Enterobacteriaceae\" mo_genus(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella\" mo_species(\"Klebsiella pneumoniae\") #> [1] \"pneumoniae\" mo_subspecies(\"Klebsiella pneumoniae\") #> [1] \"\"   # full names and short names -----------------------------------------------  mo_name(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_fullname(\"Klebsiella pneumoniae\") #> [1] \"Klebsiella pneumoniae\" mo_shortname(\"Klebsiella pneumoniae\") #> [1] \"K. pneumoniae\"   # other properties ---------------------------------------------------------  mo_pathogenicity(\"Klebsiella pneumoniae\") #> [1] Pathogenic #> Levels: Pathogenic < Potentially pathogenic < Non-pathogenic < Unknown mo_gramstain(\"Klebsiella pneumoniae\") #> [1] \"Gram-negative\" mo_snomed(\"Klebsiella pneumoniae\") #> [[1]] #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_rank(\"Klebsiella pneumoniae\") #> [1] \"species\" mo_url(\"Klebsiella pneumoniae\") #>                                Klebsiella pneumoniae  #> \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\"  mo_is_yeast(c(\"Candida\", \"Trichophyton\", \"Klebsiella\")) #> [1]  TRUE FALSE FALSE  mo_group_members(c(   \"Streptococcus group A\",   \"Streptococcus group C\",   \"Streptococcus group G\",   \"Streptococcus group L\" )) #> $`Streptococcus Group A` #> [1] \"Streptococcus pyogenes\" #>  #> $`Streptococcus Group C` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #> [4] \"Streptococcus equi\"                      #> [5] \"Streptococcus equi equi\"                 #> [6] \"Streptococcus equi ruminatorum\"          #> [7] \"Streptococcus equi zooepidemicus\"        #>  #> $`Streptococcus Group G` #> [1] \"Streptococcus canis\"                     #> [2] \"Streptococcus dysgalactiae\"              #> [3] \"Streptococcus dysgalactiae dysgalactiae\" #> [4] \"Streptococcus dysgalactiae equisimilis\"  #>  #> $`Streptococcus Group L` #> [1] \"Streptococcus dysgalactiae\"              #> [2] \"Streptococcus dysgalactiae dysgalactiae\" #> [3] \"Streptococcus dysgalactiae equisimilis\"  #>    # scientific reference -----------------------------------------------------  mo_ref(\"Klebsiella aerogenes\") #> [1] \"Tindall et al., 2017\" mo_authors(\"Klebsiella aerogenes\") #> [1] \"Tindall et al.\" mo_year(\"Klebsiella aerogenes\") #> [1] 2017 mo_synonyms(\"Klebsiella aerogenes\") #>   Hormaeche et al., 1960     Bascomb et al., 1971  #> \"Enterobacter aerogenes\"     \"Klebsiella mobilis\"  mo_lpsn(\"Klebsiella aerogenes\") #> [1] \"777146\" mo_gbif(\"Klebsiella aerogenes\") #> [1] \"9281703\" mo_mycobank(\"Candida albicans\") #> [1] \"256187\" mo_mycobank(\"Candida krusei\") #> [1] \"337013\" mo_mycobank(\"Candida krusei\", keep_synonyms = TRUE) #> Warning: Function `as.mo()` returned one old taxonomic name. Use `as.mo(..., #> keep_synonyms = FALSE)` to clean the input to currently accepted taxonomic #> names, or set the R option `AMR_keep_synonyms` to `FALSE`. This warning #> will be shown once per session. #> [1] \"268707\"   # abbreviations known in the field -----------------------------------------  mo_genus(\"MRSA\") #> [1] \"Staphylococcus\" mo_species(\"MRSA\") #> [1] \"aureus\" mo_shortname(\"VISA\") #> [1] \"S. aureus\" mo_gramstain(\"VISA\") #> [1] \"Gram-positive\"  mo_genus(\"EHEC\") #> [1] \"Escherichia\" mo_species(\"EIEC\") #> [1] \"coli\" mo_name(\"UPEC\") #> [1] \"Escherichia coli\"   # known subspecies ---------------------------------------------------------  mo_fullname(\"K. pneu rh\") #> [1] \"Klebsiella pneumoniae rhinoscleromatis\" mo_shortname(\"K. pneu rh\") #> [1] \"K. pneumoniae\"  # \\donttest{ # Becker classification, see ?as.mo ----------------------------------------  mo_fullname(\"Staph epidermidis\") #> [1] \"Staphylococcus epidermidis\" mo_fullname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"Coagulase-negative Staphylococcus (CoNS)\" mo_shortname(\"Staph epidermidis\") #> [1] \"S. epidermidis\" mo_shortname(\"Staph epidermidis\", Becker = TRUE) #> [1] \"CoNS\"   # Lancefield classification, see ?as.mo ------------------------------------  mo_fullname(\"Strep agalactiae\") #> [1] \"Streptococcus agalactiae\" mo_fullname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"Streptococcus Group B\" mo_shortname(\"Strep agalactiae\") #> [1] \"S. agalactiae\" mo_shortname(\"Strep agalactiae\", Lancefield = TRUE) #> [1] \"GBS\"   # language support  --------------------------------------------------------  mo_gramstain(\"Klebsiella pneumoniae\", language = \"de\") # German #> [1] \"Gramnegativ\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"nl\") # Dutch #> [1] \"Gram-negatief\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"es\") # Spanish #> [1] \"Gram negativo\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"el\") # Greek #> [1] \"Αρνητικό κατά Gram\" mo_gramstain(\"Klebsiella pneumoniae\", language = \"uk\") # Ukrainian #> [1] \"Грамнегативні\"  # mo_type is equal to mo_kingdom, but mo_kingdom will remain untranslated mo_kingdom(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\") #> [1] \"Bacteria\" mo_kingdom(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, no effect #> [1] \"Bacteria\" mo_type(\"Klebsiella pneumoniae\", language = \"zh\") # Chinese, translated #> [1] \"细菌\"  mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"de\") #> [1] \"Streptococcus Gruppe A\" mo_fullname(\"S. pyogenes\", Lancefield = TRUE, language = \"uk\") #> [1] \"Streptococcus Група A\"   # other --------------------------------------------------------------------  # gram stains and intrinsic resistance can be used as a filter in dplyr verbs if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_gram_positive()) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for `mo_is_gram_positive()` #> ℹ Using column 'mo' as input for `mo_genus()` #> # A tibble: 18 × 2 #>    `mo_genus()`        n #>    <chr>           <int> #>  1 Staphylococcus    840 #>  2 Streptococcus     275 #>  3 Enterococcus       83 #>  4 Corynebacterium    17 #>  5 Micrococcus         6 #>  6 Gemella             3 #>  7 Aerococcus          2 #>  8 Cutibacterium       1 #>  9 Dermabacter         1 #> 10 Fusibacter          1 #> 11 Globicatella        1 #> 12 Granulicatella      1 #> 13 Lactobacillus       1 #> 14 Leuconostoc         1 #> 15 Listeria            1 #> 16 Paenibacillus       1 #> 17 Rothia              1 #> 18 Schaalia            1 if (require(\"dplyr\")) {   example_isolates %>%     filter(mo_is_intrinsic_resistant(ab = \"vanco\")) %>%     count(mo_genus(), sort = TRUE) } #> ℹ Using column 'mo' as input for `mo_is_intrinsic_resistant()` #> ℹ Using column 'mo' as input for `mo_genus()` #> # A tibble: 19 × 2 #>    `mo_genus()`         n #>    <chr>            <int> #>  1 Escherichia        467 #>  2 Klebsiella          77 #>  3 Proteus             39 #>  4 Pseudomonas         30 #>  5 Serratia            25 #>  6 Enterobacter        23 #>  7 Citrobacter         11 #>  8 Haemophilus          9 #>  9 Acinetobacter        6 #> 10 Morganella           6 #> 11 Pantoea              4 #> 12 Salmonella           3 #> 13 Neisseria            2 #> 14 Stenotrophomonas     2 #> 15 Campylobacter        1 #> 16 Enterococcus         1 #> 17 Hafnia               1 #> 18 Leuconostoc          1 #> 19 Pseudescherichia     1  # get a list with the complete taxonomy (from kingdom to subspecies) mo_taxonomy(\"Klebsiella pneumoniae\") #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>   # get a list with the taxonomy, the authors, Gram-stain, # SNOMED codes, and URL to the online database mo_info(\"Klebsiella pneumoniae\") #> $mo #> [1] \"B_KLBSL_PNMN\" #>  #> $rank #> [1] \"species\" #>  #> $kingdom #> [1] \"Bacteria\" #>  #> $phylum #> [1] \"Pseudomonadota\" #>  #> $class #> [1] \"Gammaproteobacteria\" #>  #> $order #> [1] \"Enterobacterales\" #>  #> $family #> [1] \"Enterobacteriaceae\" #>  #> $genus #> [1] \"Klebsiella\" #>  #> $species #> [1] \"pneumoniae\" #>  #> $subspecies #> [1] \"\" #>  #> $status #> [1] \"accepted\" #>  #> $synonyms #> NULL #>  #> $gramstain #> [1] \"Gram-negative\" #>  #> $oxygen_tolerance #> [1] \"facultative anaerobe\" #>  #> $url #> [1] \"https://lpsn.dsmz.de/species/klebsiella-pneumoniae\" #>  #> $ref #> [1] \"Trevisan, 1887\" #>  #> $snomed #> [1] \"1098101000112102\" \"446870005\"        \"1098201000112108\" \"409801009\"        #> [5] \"56415008\"         \"714315002\"        \"713926009\"        #>  #> $lpsn #> [1] \"777151\" #>  #> $mycobank #> [1] NA #>  #> $gbif #> [1] \"3221874\" #>  #> $group_members #> character(0) #>  # }"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":null,"dir":"Reference","previous_headings":"","what":"User-Defined Reference Data Set for Microorganisms — mo_source","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"functions can used predefine reference used .mo() consequently mo_* functions (mo_genus() mo_gramstain()). fastest way organisation (analysis) specific codes picked translated package, since bother setting .","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"","code":"set_mo_source(path, destination = getOption(\"AMR_mo_source\",   \"~/mo_source.rds\"))  get_mo_source(destination = getOption(\"AMR_mo_source\", \"~/mo_source.rds\"))"},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"path Location reference file, can text file (comma-, tab- pipe-separated) Excel file (see Details). Can also \"\", NULL FALSE delete reference file. destination Destination compressed data file - default user's home directory.","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"reference file can text file separated commas (CSV) tabs pipes, Excel file (either 'xls' 'xlsx' format) R object file (extension '.rds'). use Excel file, need readxl package installed. set_mo_source() check file validity: must data.frame, must column named \"mo\" contains values microorganisms$mo microorganisms$fullname must reference column defined values. tests pass, set_mo_source() read file R ask export \"~/mo_source.rds\". CRAN policy disallows packages write file system, although 'exceptions may allowed interactive sessions package obtains confirmation user'. reason, function works interactive sessions user can specifically confirm allow file created. destination file can set destination argument defaults user's home directory. can also set package option AMR_mo_source, e.g. options(AMR_mo_source = \"/location/file.rds\"). created compressed data file \"mo_source.rds\" used default MO determination (function .mo() consequently mo_* functions like mo_genus() mo_gramstain()). location timestamp original file saved attribute compressed data file. function get_mo_source() return data set reading \"mo_source.rds\" readRDS(). original file changed (checking location timestamp original file), call set_mo_source() update data file automatically used interactive session. Reading Excel file (.xlsx) one row size 8-9 kB. compressed file created set_mo_source() size 0.1 kB can read get_mo_source() couple microseconds (millionths second).","code":""},{"path":"https://amr-for-r.org/reference/mo_source.html","id":"how-to-setup","dir":"Reference","previous_headings":"","what":"How to Setup","title":"User-Defined Reference Data Set for Microorganisms — mo_source","text":"Imagine data sheet Excel file. first column contains organisation specific codes, second column contains valid taxonomic names:   save \"/Users//Documents/ourcodes.xlsx\". Now set source:   now created file \"~/mo_source.rds\" contents Excel file. first column foreign values 'mo' column kept creating RDS file. now can use functions:   edit Excel file , say, adding row 4 like :   ...new usage MO function package update data file:   delete reference data file, just use \"\", NULL FALSE input set_mo_source():   original file (previous case Excel file) moved deleted, mo_source.rds file removed upon next use .mo() mo_* function.","code":"|         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 |                    |                       | set_mo_source(\"/Users/me/Documents/ourcodes.xlsx\") #> NOTE: Created mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>       \"Organisation XYZ\" and \"mo\" as.mo(\"lab_mo_ecoli\") #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_mo_kpneumoniae\") #> [1] \"Klebsiella\"  # other input values still work too as.mo(c(\"Escherichia coli\", \"E. coli\", \"lab_mo_ecoli\")) #> NOTE: Translation to one microorganism was guessed with uncertainty. #>       Use mo_uncertainties() to review it. #> Class 'mo' #> [1] B_ESCHR_COLI B_ESCHR_COLI B_ESCHR_COLI |         A          |            B          | --|--------------------|-----------------------| 1 | Organisation XYZ   | mo                    | 2 | lab_mo_ecoli       | Escherichia coli      | 3 | lab_mo_kpneumoniae | Klebsiella pneumoniae | 4 | lab_Staph_aureus   | Staphylococcus aureus | 5 |                    |                       | as.mo(\"lab_mo_ecoli\") #> NOTE: Updated mo_source file '/Users/me/mo_source.rds' (0.3 kB) from #>       '/Users/me/Documents/ourcodes.xlsx' (9 kB), columns #>        \"Organisation XYZ\" and \"mo\" #> Class 'mo' #> [1] B_ESCHR_COLI  mo_genus(\"lab_Staph_aureus\") #> [1] \"Staphylococcus\" set_mo_source(NULL) #> Removed mo_source file '/Users/me/mo_source.rds'"},{"path":"https://amr-for-r.org/reference/pca.html","id":null,"dir":"Reference","previous_headings":"","what":"Principal Component Analysis (for AMR) — pca","title":"Principal Component Analysis (for AMR) — pca","text":"Performs principal component analysis (PCA) based data set automatic determination afterwards plotting groups labels, automatic filtering suitable (.e. non-empty numeric) variables.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"pca(x, ..., retx = TRUE, center = TRUE, scale. = TRUE, tol = NULL,   rank. = NULL)"},{"path":"https://amr-for-r.org/reference/pca.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Principal Component Analysis (for AMR) — pca","text":"x data.frame containing numeric columns. ... Columns x selected PCA, can unquoted since supports quasiquotation. retx logical value indicating whether rotated variables     returned. center logical value indicating whether variables     shifted zero centered. Alternately, vector     length equal number columns x can supplied.     value passed scale. scale. logical value indicating whether variables     scaled unit variance analysis takes     place.  default FALSE consistency S,     general scaling advisable.  Alternatively, vector length     equal number columns x can supplied.      value passed scale. tol value indicating magnitude components     omitted. (Components omitted     standard deviations less equal tol times     standard deviation first component.)  default null     setting, components omitted (unless rank. specified     less min(dim(x)).).  settings tol     tol = 0 tol = sqrt(.Machine$double.eps),     omit essentially constant components. rank. optionally, number specifying maximal rank, .e.,     maximal number principal components used.  Can set     alternative addition tol, useful notably     desired rank considerably smaller dimensions matrix.","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Principal Component Analysis (for AMR) — pca","text":"object classes pca prcomp","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Principal Component Analysis (for AMR) — pca","text":"pca() function takes data.frame input performs actual PCA R function prcomp(). result pca() function prcomp object, additional attribute non_numeric_cols vector column names columns contain numeric values. probably groups labels, used ggplot_pca().","code":""},{"path":"https://amr-for-r.org/reference/pca.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Principal Component Analysis (for AMR) — pca","text":"","code":"# `example_isolates` is a data set available in the AMR package. # See ?example_isolates.  # \\donttest{ if (require(\"dplyr\")) {   # calculate the resistance per group first   resistance_data <- example_isolates %>%     group_by(       order = mo_order(mo), # group on anything, like order       genus = mo_genus(mo)     ) %>% #   and genus as we do here;     filter(n() >= 30) %>% # filter on only 30 results per group     summarise_if(is.sir, resistance) # then get resistance of all drugs    # now conduct PCA for certain antimicrobial drugs   pca_result <- resistance_data %>%     pca(AMC, CXM, CTX, CAZ, GEN, TOB, TMP, SXT)    pca_result   summary(pca_result)   # old base R plotting method:   biplot(pca_result) } #> Warning: There were 73 warnings in `summarise()`. #> The first warning was: #> ℹ In argument: `PEN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 5: `order = \"Lactobacillales\"` `genus = \"Enterococcus\"`. #> Caused by warning: #> ! Introducing NA: only 14 results available for PEN in group: order = #> \"Lactobacillales\", genus = \"Enterococcus\" (`minimum` = 30). #> ℹ Run `dplyr::last_dplyr_warnings()` to see the 72 remaining warnings. #> ℹ Columns selected for PCA: \"AMC\", \"CAZ\", \"CTX\", \"CXM\", \"GEN\", \"SXT\", #>   \"TMP\", and \"TOB\". Total observations available: 7. #> Groups (n=4, named as 'order'): #> [1] \"Caryophanales\"    \"Enterobacterales\" \"Lactobacillales\"  \"Pseudomonadales\"  #>    # new ggplot2 plotting method using this package: if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) }  if (require(\"dplyr\") && require(\"ggplot2\")) {     ggplot_pca(pca_result) +       scale_colour_viridis_d() +       labs(title = \"Title here\") }  # }"},{"path":"https://amr-for-r.org/reference/plot.html","id":null,"dir":"Reference","previous_headings":"","what":"Plotting Helpers for AMR Data Analysis — plot","title":"Plotting Helpers for AMR Data Analysis — plot","text":"Functions plot classes sir, mic disk, support base R ggplot2. Especially scale_*_mic() functions relevant wrappers plot MIC values ggplot2. allows custom MIC ranges plot intermediate log2 levels missing MIC values.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"scale_x_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_y_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_colour_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_fill_mic(keep_operators = \"edges\", mic_range = NULL, ...)  scale_x_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_colour_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I =   \"#F6D55C\", R = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  scale_fill_sir(colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\",   R = \"#ED553B\"), language = get_AMR_locale(),   eucast_I = getOption(\"AMR_guideline\", \"EUCAST\") == \"EUCAST\", ...)  # S3 method for class 'mic' plot(x, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   main = deparse(substitute(x)), ylab = translate_AMR(\"Frequency\", language   = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'mic' autoplot(object, mo = NULL, ab = NULL,   guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language),   xlab = translate_AMR(\"Minimum Inhibitory Concentration (mg/L)\", language =   language), colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R   = \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' plot(x, main = deparse(substitute(x)),   ylab = translate_AMR(\"Frequency\", language = language),   xlab = translate_AMR(\"Disk diffusion diameter (mm)\", language = language),   mo = NULL, ab = NULL, guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'disk' autoplot(object, mo = NULL, ab = NULL,   title = deparse(substitute(object)), ylab = translate_AMR(\"Frequency\",   language = language), xlab = translate_AMR(\"Disk diffusion diameter (mm)\",   language = language), guideline = getOption(\"AMR_guideline\", \"EUCAST\"),   colours_SIR = c(S = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R =   \"#ED553B\"), language = get_AMR_locale(), expand = TRUE,   include_PKPD = getOption(\"AMR_include_PKPD\", TRUE),   breakpoint_type = getOption(\"AMR_breakpoint_type\", \"human\"), ...)  # S3 method for class 'sir' plot(x, ylab = translate_AMR(\"Percentage\", language =   language), xlab = translate_AMR(\"Antimicrobial Interpretation\", language =   language), main = deparse(substitute(x)), language = get_AMR_locale(),   ...)  # S3 method for class 'sir' autoplot(object, title = deparse(substitute(object)),   xlab = translate_AMR(\"Antimicrobial Interpretation\", language = language),   ylab = translate_AMR(\"Frequency\", language = language), colours_SIR = c(S   = \"#3CAEA3\", SDD = \"#8FD6C4\", I = \"#F6D55C\", R = \"#ED553B\"),   language = get_AMR_locale(), ...)  facet_sir(facet = c(\"interpretation\", \"antibiotic\"), nrow = NULL)  scale_y_percent(breaks = function(x) seq(0, max(x, na.rm = TRUE), 0.1),   limits = c(0, NA))  scale_sir_colours(..., aesthetics, colours_SIR = c(S = \"#3CAEA3\", SDD =   \"#8FD6C4\", I = \"#F6D55C\", R = \"#ED553B\"))  theme_sir()  labels_sir_count(position = NULL, x = \"antibiotic\",   translate_ab = \"name\", minimum = 30, language = get_AMR_locale(),   combine_SI = TRUE, datalabels.size = 3, datalabels.colour = \"grey15\")"},{"path":"https://amr-for-r.org/reference/plot.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Plotting Helpers for AMR Data Analysis — plot","text":"keep_operators character specifying handle operators (> <=) input. Accepts one three values: \"\" (TRUE) keep operators, \"none\" (FALSE) remove operators, \"edges\" keep operators ends range. mic_range manual range rescale MIC values (using rescale_mic()), e.g., mic_range = c(0.001, 32). Use NA prevent rescaling one side, e.g., mic_range = c(NA, 32). Note: rescales values filter - use ggplot2 limits argument separately exclude values plot. ... Arguments passed methods. colours_SIR Colours use filling bars, must vector three values (order S, R). default colours colour-blind friendly. language Language used translate 'Susceptible', 'Increased exposure'/'Intermediate' 'Resistant' - default system language (see get_AMR_locale()) can overwritten setting package option AMR_locale, e.g. options(AMR_locale = \"de\"), see translate. Use language = NULL prevent translation. eucast_I logical indicate whether '' must interpreted \"Susceptible, increased exposure\". TRUE default AMR interpretation guideline set EUCAST (default). FALSE, interpreted \"Intermediate\". x, object Values created .mic(), .disk() .sir() (random_* variants, random_mic()). mo (vector ) text can coerced valid microorganism code .mo(). ab (vector ) text can coerced valid antimicrobial drug code .ab(). guideline Interpretation guideline use - default latest included EUCAST guideline, see Details. main, title Title plot. xlab, ylab Axis title. expand logical indicate whether range x axis expanded lowest highest value. MIC values, intermediate values factors 2 starting highest MIC value. disk diameters, whole diameter range filled. include_PKPD logical indicate PK/PD clinical breakpoints must applied last resort - default TRUE. Can also set package option AMR_include_PKPD. breakpoint_type type breakpoints use, either \"ECOFF\", \"animal\", \"human\". ECOFF stands Epidemiological Cut-values. default \"human\", can also set package option AMR_breakpoint_type. host set values veterinary species, automatically set \"animal\". facet Variable split plots , either \"interpretation\" (default) \"antibiotic\" grouping variable. nrow (using facet) number rows. breaks numeric vector positions. limits numeric vector length two providing limits scale, use NA refer existing minimum maximum. aesthetics Aesthetics apply colours - default \"fill\" can also (combination ) \"alpha\", \"colour\", \"fill\", \"linetype\", \"shape\" \"size\". position Position adjustment bars, either \"fill\", \"stack\" \"dodge\". translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE. datalabels.size Size datalabels. datalabels.colour Colour datalabels.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Plotting Helpers for AMR Data Analysis — plot","text":"autoplot() functions return ggplot model extendible ggplot2 function.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-mic-functions","dir":"Reference","previous_headings":"","what":"The scale_*_mic() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_mic(), scale_y_mic(), scale_colour_mic(), scale_fill_mic() functions allow plot mic class (MIC values) continuous, logarithmic scale. also allow rescale MIC range 'inside' 'outside' range required, retain operators MIC values (>=) desired. Missing intermediate log2 levels plotted .","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"the-scale-sir-functions","dir":"Reference","previous_headings":"","what":"The scale_*_sir() Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"functions scale_x_sir(), scale_colour_sir(), scale_fill_sir() functions allow plot sir class right order (S < SDD < < R < NI). default, translate S//R values interpretative text (\"Susceptible\", \"Resistant\", etc.) 28 supported languages (use language = NULL keep S//R). Also, except scale_x_sir(), set colour-blind friendly colours colour fill aesthetics.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"additional-ggplot-functions","dir":"Reference","previous_headings":"","what":"Additional ggplot2 Functions","title":"Plotting Helpers for AMR Data Analysis — plot","text":"package contains functions extend ggplot2 package, help visualising AMR data results. functions internally used ggplot_sir() . facet_sir() creates 2d plots (default based S//R) using ggplot2::facet_wrap(). scale_y_percent() transforms y axis 0 100% range using ggplot2::scale_y_continuous(). scale_sir_colours() allows set colours aesthetic, even shape linetype. theme_sir() ggplot2 theme minimal distraction. labels_sir_count() print datalabels bars percentage number isolates, using ggplot2::geom_text(). interpretation \"\" named \"Increased exposure\" EUCAST guidelines since 2019, named \"Intermediate\" cases. interpreting MIC values well disk diffusion diameters, default guideline EUCAST 2025, unless package option AMR_guideline set. See .sir() information.","code":""},{"path":"https://amr-for-r.org/reference/plot.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plotting Helpers for AMR Data Analysis — plot","text":"","code":"some_mic_values <- random_mic(size = 100) some_disk_values <- random_disk(size = 100, mo = \"Escherichia coli\", ab = \"cipro\") some_sir_values <- random_sir(50, prob_SIR = c(0.55, 0.05, 0.30))  # \\donttest{ # Plotting using ggplot2's autoplot() for MIC, disk, and SIR ----------- if (require(\"ggplot2\")) {   autoplot(some_mic_values) }  if (require(\"ggplot2\")) {   # when providing the microorganism and antibiotic, colours will show interpretations:   autoplot(some_mic_values, mo = \"Escherichia coli\", ab = \"cipro\") }  if (require(\"ggplot2\")) {   autoplot(some_mic_values, mo = \"Staph aureus\", ab = \"Ceftaroline\", guideline = \"CLSI\") }   if (require(\"ggplot2\")) {   # support for 27 languages, various guidelines, and many options   autoplot(some_disk_values,     mo = \"Escherichia coli\", ab = \"cipro\",     guideline = \"CLSI 2024\", language = \"no\",     title = \"Disk diffusion from the North\"   ) }    # Plotting using scale_x_mic() ----------------------------------------- if (require(\"ggplot2\")) {   mic_plot <- ggplot(     data.frame(       mics = as.mic(c(0.25, \"<=4\", 4, 8, 32, \">=32\")),       counts = c(1, 1, 2, 2, 3, 3)     ),     aes(mics, counts)   ) +     geom_col()   mic_plot +     labs(title = \"without scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic() +     labs(title = \"with scale_x_mic()\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(keep_operators = \"all\") +     labs(title = \"with scale_x_mic() keeping all operators\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(1, 16)) +     labs(title = \"with scale_x_mic() using a manual 'within' range\") }  if (require(\"ggplot2\")) {   mic_plot +     scale_x_mic(mic_range = c(0.032, 256)) +     labs(title = \"with scale_x_mic() using a manual 'outside' range\") }    # Plotting using scale_y_mic() ----------------------------------------- some_groups <- sample(LETTERS[1:5], 20, replace = TRUE)  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey30\", fill = NA) +     scale_y_mic() }  if (require(\"ggplot2\")) {   ggplot(     data.frame(       mic = some_mic_values,       group = some_groups     ),     aes(group, mic)   ) +     geom_boxplot() +     geom_violin(linetype = 2, colour = \"grey30\", fill = NA) +     scale_y_mic(mic_range = c(NA, 0.25)) }    # Plotting using scale_x_sir() ----------------------------------------- if (require(\"ggplot2\")) {   ggplot(     data.frame(       x = c(\"I\", \"R\", \"S\"),       y = c(45, 323, 573)     ),     aes(x, y)   ) +     geom_col() +     scale_x_sir() }    # Plotting using scale_y_mic() and scale_colour_sir() ------------------ if (require(\"ggplot2\")) {   plain <- ggplot(     data.frame(       mic = some_mic_values,       group = some_groups,       sir = as.sir(some_mic_values,         mo = \"E. coli\",         ab = \"cipro\"       )     ),     aes(x = group, y = mic, colour = sir)   ) +     theme_minimal() +     geom_boxplot(fill = NA, colour = \"grey30\") +     geom_jitter(width = 0.25)    plain }  if (require(\"ggplot2\")) {   # and now with our MIC and SIR scale functions:   plain +     scale_y_mic() +     scale_colour_sir() }  if (require(\"ggplot2\")) {   plain +     scale_y_mic(mic_range = c(0.005, 32), name = \"Our MICs!\") +     scale_colour_sir(       language = \"pt\",       name = \"Support in 27 languages\"     ) }  # }  # Plotting using base R's plot() ---------------------------------------  plot(some_mic_values)  # when providing the microorganism and antibiotic, colours will show interpretations: plot(some_mic_values, mo = \"S. aureus\", ab = \"ampicillin\")   plot(some_disk_values)  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\")  plot(some_disk_values, mo = \"Escherichia coli\", ab = \"cipro\", language = \"nl\")   plot(some_sir_values)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate Antimicrobial Resistance — proportion","title":"Calculate Antimicrobial Resistance — proportion","text":"functions can used calculate (co-)resistance susceptibility microbial isolates (.e. percentage S, SI, , IR R). functions support quasiquotation pipes, can used summarise() dplyr package also support grouped variables, see Examples. resistance() used calculate resistance, susceptibility() used calculate susceptibility.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"resistance(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  susceptibility(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  sir_confidence_interval(..., ab_result = \"R\", minimum = 30,   as_percent = FALSE, only_all_tested = FALSE, confidence_level = 0.95,   side = \"both\", collapse = FALSE)  proportion_R(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_IR(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_I(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_SI(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_S(..., minimum = 30, as_percent = FALSE,   only_all_tested = FALSE)  proportion_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)  sir_df(data, translate_ab = \"name\", language = get_AMR_locale(),   minimum = 30, as_percent = FALSE, combine_SI = TRUE,   confidence_level = 0.95)"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Calculate Antimicrobial Resistance — proportion","text":"M39 Analysis Presentation Cumulative Antimicrobial Susceptibility Test Data, 5th Edition, 2022, Clinical Laboratory Standards Institute (CLSI). https://clsi.org/standards/products/microbiology/documents/m39/.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate Antimicrobial Resistance — proportion","text":"... One vectors (columns) antibiotic interpretations. transformed internally .sir() needed. Use multiple columns calculate (lack ) co-resistance: probability one two drugs resistant susceptible result. See Examples. minimum minimum allowed number available (tested) isolates. isolate count lower minimum return NA warning. default number 30 isolates advised Clinical Laboratory Standards Institute (CLSI) best practice, see Source. as_percent logical indicate whether output must returned hundred fold % sign (character). value 0.123456 returned \"12.3%\". only_all_tested (combination therapies, .e. using one variable ...): logical indicate isolates must tested antimicrobials, see section Combination Therapy . ab_result Antibiotic results test , must one values \"S\", \"SDD\", \"\", \"R\". confidence_level confidence level returned confidence interval. calculation, number S SI isolates, R isolates compared total number available isolates R, S, using binom.test(), .e., Clopper-Pearson method. side side confidence interval return. default \"\" length 2 vector, can also (abbreviated ) \"min\"/\"left\"/\"lower\"/\"less\" \"max\"/\"right\"/\"higher\"/\"greater\". collapse logical indicate whether output values 'collapsed', .e. merged together one value, character value use collapsing. data data.frame containing columns class sir (see .sir()). translate_ab column name antimicrobials data set translate antibiotic abbreviations , using ab_property(). language Language returned text - default current system language (see get_AMR_locale()) can also set package option AMR_locale. Use language = NULL language = \"\" prevent translation. combine_SI logical indicate whether values S, SDD, must merged one, output consists S+SDD+vs. R (susceptible vs. resistant) - default TRUE.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate Antimicrobial Resistance — proportion","text":"double , as_percent = TRUE, character.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate Antimicrobial Resistance — proportion","text":"automated comprehensive analysis, consider using antibiogram() wisca(), streamline many aspects susceptibility reporting , importantly, also support WISCA. functions described offer hands-, manual approach greater customisation. Remember filter data let contain first isolates! needed exclude duplicates reduce selection bias. Use first_isolate() determine data set one four available algorithms. function resistance() equal function proportion_R(). function susceptibility() equal function proportion_SI(). Since AMR v3.0, proportion_SI() proportion_I() include dose-dependent susceptibility ('SDD'). Use sir_confidence_interval() calculate confidence interval, relies binom.test(), .e., Clopper-Pearson method. function returns vector length 2 default antimicrobial resistance. Change side argument \"left\"/\"min\" \"right\"/\"max\" return single value, change ab_result argument e.g. c(\"S\", \"\") test antimicrobial susceptibility, see Examples. functions meant count isolates, calculate proportion resistance/susceptibility. Use count_*() functions count isolates. function susceptibility() essentially equal count_susceptible()/count_all(). Low counts can influence outcome - proportion_*() functions may camouflage , since return proportion (albeit dependent minimum argument). function proportion_df() takes variable data sir class (created .sir()) calculates proportions S, , R. also supports grouped variables. function sir_df() works exactly like proportion_df(), adds number isolates.","code":""},{"path":"https://amr-for-r.org/reference/proportion.html","id":"combination-therapy","dir":"Reference","previous_headings":"","what":"Combination Therapy","title":"Calculate Antimicrobial Resistance — proportion","text":"using one variable ... (= combination therapy), use only_all_tested count isolates tested antimicrobials/variables test . See example two antimicrobials, Drug Drug B, susceptibility() works calculate %SI:   Please note , combination therapies, only_all_tested = TRUE applies :   , combination therapies, only_all_tested = FALSE applies :   Using only_all_tested impact using one antibiotic input.","code":"--------------------------------------------------------------------                     only_all_tested = FALSE  only_all_tested = TRUE                     -----------------------  -----------------------  Drug A    Drug B   considered   considered  considered   considered                     susceptible    tested    susceptible    tested --------  --------  -----------  ----------  -----------  ----------  S or I    S or I        X            X           X            X    R       S or I        X            X           X            X   <NA>     S or I        X            X           -            -  S or I      R           X            X           X            X    R         R           -            X           -            X   <NA>       R           -            -           -            -  S or I     <NA>         X            X           -            -    R        <NA>         -            -           -            -   <NA>      <NA>         -            -           -            - -------------------------------------------------------------------- count_S()    +   count_I()    +   count_R()    = count_all()   proportion_S() + proportion_I() + proportion_R() = 1 count_S()    +   count_I()    +   count_R()    >= count_all()   proportion_S() + proportion_I() + proportion_R() >= 1"},{"path":"https://amr-for-r.org/reference/proportion.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Calculate Antimicrobial Resistance — proportion","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/proportion.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate Antimicrobial Resistance — proportion","text":"","code":"# example_isolates is a data set available in the AMR package. # run ?example_isolates for more info. example_isolates #> # A tibble: 2,000 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,990 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …   # base R ------------------------------------------------------------ # determines %R resistance(example_isolates$AMX) #> [1] 0.5955556 sir_confidence_interval(example_isolates$AMX) #> [1] 0.5688204 0.6218738 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975 ) #> [1] 0.5650148 0.6255670 sir_confidence_interval(example_isolates$AMX,   confidence_level = 0.975,   collapse = \", \" ) #> [1] \"0.565, 0.626\"  # determines %S+I: susceptibility(example_isolates$AMX) #> [1] 0.4044444 sir_confidence_interval(example_isolates$AMX,   ab_result = c(\"S\", \"I\") ) #> [1] 0.3781262 0.4311796  # be more specific proportion_S(example_isolates$AMX) #> [1] 0.4022222 proportion_SI(example_isolates$AMX) #> [1] 0.4044444 proportion_I(example_isolates$AMX) #> [1] 0.002222222 proportion_IR(example_isolates$AMX) #> [1] 0.5977778 proportion_R(example_isolates$AMX) #> [1] 0.5955556  # dplyr ------------------------------------------------------------- # \\donttest{ if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       r = resistance(CIP),       n = n_sir(CIP)     ) # n_sir works like n_distinct in dplyr, see ?n_sir } #> # A tibble: 3 × 3 #>   ward           r     n #>   <chr>      <dbl> <int> #> 1 Clinical   0.147   869 #> 2 ICU        0.190   447 #> 3 Outpatient 0.161    93 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       cipro_R = resistance(CIP),       ci_min = sir_confidence_interval(CIP, side = \"min\"),       ci_max = sir_confidence_interval(CIP, side = \"max\"),     ) } #> # A tibble: 3 × 4 #>   ward       cipro_R ci_min ci_max #>   <chr>        <dbl>  <dbl>  <dbl> #> 1 Clinical     0.147 0.124   0.173 #> 2 ICU          0.190 0.155   0.230 #> 3 Outpatient   0.161 0.0932  0.252 if (require(\"dplyr\")) {   # scoped dplyr verbs with antimicrobial selectors   # (you could also use across() of course)   example_isolates %>%     group_by(ward) %>%     summarise_at(       c(aminoglycosides(), carbapenems()),       resistance     ) } #> ℹ For `aminoglycosides()` using columns 'GEN' (gentamicin), 'TOB' #>   (tobramycin), 'AMK' (amikacin), and 'KAN' (kanamycin) #> ℹ For `carbapenems()` using columns 'IPM' (imipenem) and 'MEM' (meropenem) #> Warning: There was 1 warning in `summarise()`. #> ℹ In argument: `KAN = (function (..., minimum = 30, as_percent = FALSE, #>   only_all_tested = FALSE) ...`. #> ℹ In group 3: `ward = \"Outpatient\"`. #> Caused by warning: #> ! Introducing NA: only 23 results available for KAN in group: ward = #> \"Outpatient\" (`minimum` = 30). #> # A tibble: 3 × 7 #>   ward         GEN   TOB   AMK   KAN    IPM    MEM #>   <chr>      <dbl> <dbl> <dbl> <dbl>  <dbl>  <dbl> #> 1 Clinical   0.229 0.315 0.626     1 0.0498 0.0458 #> 2 ICU        0.290 0.400 0.662     1 0.0862 0.0894 #> 3 Outpatient 0.2   0.368 0.605    NA 0.0541 0.0541 if (require(\"dplyr\")) {   example_isolates %>%     group_by(ward) %>%     summarise(       R = resistance(CIP, as_percent = TRUE),       SI = susceptibility(CIP, as_percent = TRUE),       n1 = count_all(CIP), # the actual total; sum of all three       n2 = n_sir(CIP), # same - analogous to n_distinct       total = n()     ) # NOT the number of tested isolates!    # Calculate co-resistance between amoxicillin/clav acid and gentamicin,   # so we can see that combination therapy does a lot more than mono therapy:   example_isolates %>% susceptibility(AMC) # %SI = 76.3%   example_isolates %>% count_all(AMC) #   n = 1879    example_isolates %>% susceptibility(GEN) # %SI = 75.4%   example_isolates %>% count_all(GEN) #   n = 1855    example_isolates %>% susceptibility(AMC, GEN) # %SI = 94.1%   example_isolates %>% count_all(AMC, GEN) #   n = 1939     # See Details on how `only_all_tested` works. Example:   example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN),       denominator = count_all(AMC, GEN),       proportion = susceptibility(AMC, GEN)     )    example_isolates %>%     summarise(       numerator = count_susceptible(AMC, GEN, only_all_tested = TRUE),       denominator = count_all(AMC, GEN, only_all_tested = TRUE),       proportion = susceptibility(AMC, GEN, only_all_tested = TRUE)     )     example_isolates %>%     group_by(ward) %>%     summarise(       cipro_p = susceptibility(CIP, as_percent = TRUE),       cipro_n = count_all(CIP),       genta_p = susceptibility(GEN, as_percent = TRUE),       genta_n = count_all(GEN),       combination_p = susceptibility(CIP, GEN, as_percent = TRUE),       combination_n = count_all(CIP, GEN)     )    # Get proportions S/I/R immediately of all sir columns   example_isolates %>%     select(AMX, CIP) %>%     proportion_df(translate = FALSE)    # It also supports grouping variables   # (use sir_df to also include the count)   example_isolates %>%     select(ward, AMX, CIP) %>%     group_by(ward) %>%     sir_df(translate = FALSE) } #> # A tibble: 12 × 7 #>    ward       antibiotic interpretation value ci_min ci_max isolates #>    <chr>      <chr>      <ord>          <dbl>  <dbl>  <dbl>    <int> #>  1 Clinical   AMX        SI             0.423 0.389   0.457      357 #>  2 Clinical   AMX        R              0.577 0.543   0.611      487 #>  3 Clinical   CIP        SI             0.853 0.827   0.876      741 #>  4 Clinical   CIP        R              0.147 0.124   0.173      128 #>  5 ICU        AMX        SI             0.369 0.323   0.417      158 #>  6 ICU        AMX        R              0.631 0.583   0.677      270 #>  7 ICU        CIP        SI             0.810 0.770   0.845      362 #>  8 ICU        CIP        R              0.190 0.155   0.230       85 #>  9 Outpatient AMX        SI             0.397 0.288   0.515       31 #> 10 Outpatient AMX        R              0.603 0.485   0.712       47 #> 11 Outpatient CIP        SI             0.839 0.748   0.907       78 #> 12 Outpatient CIP        R              0.161 0.0932  0.252       15 # }"},{"path":"https://amr-for-r.org/reference/random.html","id":null,"dir":"Reference","previous_headings":"","what":"Random MIC Values/Disk Zones/SIR Generation — random","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"functions can used generating random MIC values disk diffusion diameters, AMR data analysis practice. providing microorganism antimicrobial drug, generated results reflect reality much possible.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(size = NULL, mo = NULL, ab = NULL, skew = \"right\",   severity = 1, ...)  random_disk(size = NULL, mo = NULL, ab = NULL, skew = \"left\",   severity = 1, ...)  random_sir(size = NULL, prob_SIR = c(0.33, 0.33, 0.33), ...)"},{"path":"https://amr-for-r.org/reference/random.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"size Desired size returned vector. used data.frame call dplyr verb, get current (group) size left blank. mo character can coerced valid microorganism code .mo(). Can length size. ab character can coerced valid antimicrobial drug code .ab(). skew Direction skew MIC disk values, either \"right\" \"left\". left-skewed distribution majority data right. severity Skew severity; higher values increase skewedness. Default 2; use 0 prevent skewedness. ... Ignored, place allow future extensions. prob_SIR vector length 3: probabilities \"S\" (1st value), \"\" (2nd value) \"R\" (3rd value).","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"class mic random_mic() (see .mic()) class disk random_disk() (see .disk())","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"Internally, MIC disk zone values sampled based clinical breakpoints defined clinical_breakpoints data set. create specific generated values per bug drug, set mo /ab argument. MICs sampled log2 scale disks linearly, using weighted probabilities. weights based skew severity arguments: skew = \"right\" places emphasis lower MIC higher disk values. skew = \"left\" places emphasis higher MIC lower disk values. severity controls exponential bias applied.","code":""},{"path":"https://amr-for-r.org/reference/random.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Random MIC Values/Disk Zones/SIR Generation — random","text":"","code":"random_mic(25) #> Class 'mic' #>  [1] 1      0.064  2      0.016  128    0.001  0.004  0.008  64     0.064  #> [11] 0.002  0.001  0.016  0.004  0.0005 0.0005 0.125  0.032  0.032  8      #> [21] 2      8      0.008  0.0005 8      random_disk(25) #> Class 'disk' #>  [1] 46 38 45 47 24 28 45 43 19 23 44 19 31 22 40 39 39 36 35 14 34 45 21 19 39 random_sir(25) #> Class 'sir' #>  [1] I S R I R I S S S R R R I I R R I S R R S I S R I  # add more skewedness, make more realistic by setting a bug and/or drug: disks <- random_disk(100, severity = 2, mo = \"Escherichia coli\", ab = \"CIP\") plot(disks)  # `plot()` and `ggplot2::autoplot()` allow for coloured bars if `mo` and `ab` are set plot(disks, mo = \"Escherichia coli\", ab = \"CIP\", guideline = \"CLSI 2025\")   # \\donttest{ random_mic(25, \"Klebsiella pneumoniae\") # range 0.0625-64 #> Class 'mic' #>  [1] 2      0.032  32     0.5    0.001  0.008  0.002  4      0.0005 1      #> [11] 0.001  1      8      0.002  0.25   2      0.016  0.004  0.25   0.125  #> [21] 0.002  0.5    0.004  >=256  0.0005 random_mic(25, \"Klebsiella pneumoniae\", \"meropenem\") # range 0.0625-16 #> Class 'mic' #>  [1] 4   >=8 4   >=8 4   >=8 4   4   4   4   4   4   >=8 >=8 4   >=8 4   4   4   #> [20] 4   4   4   4   4   4   random_mic(25, \"Streptococcus pneumoniae\", \"meropenem\") # range 0.0625-4 #> Class 'mic' #>  [1] <=0.25 0.5    <=0.25 <=0.25 <=0.25 0.5    <=0.25 <=0.25 <=0.25 <=0.25 #> [11] <=0.25 <=0.25 0.5    <=0.25 <=0.25 <=0.25 0.5    <=0.25 0.5    <=0.25 #> [21] <=0.25 0.5    <=0.25 0.5    0.5     random_disk(25, \"Klebsiella pneumoniae\") # range 8-50 #> Class 'disk' #>  [1] 33 26 16 27 29 33 24 17 17 15 16 26 26 14 17 29 25 25 24 32 32 34 18 31 10 random_disk(25, \"Klebsiella pneumoniae\", \"ampicillin\") # range 11-17 #> Class 'disk' #>  [1] 19 20 11 14 12 12 17 16 12 10 15 22 19 21 19 17 18 19 21 17 21 15 17 12 19 random_disk(25, \"Streptococcus pneumoniae\", \"ampicillin\") # range 12-27 #> Class 'disk' #>  [1] 27 24 31 22 35 28 26 32 24 18 35 33 24 28 33 25 35 25 32 24 26 20 23 22 33 # }"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":null,"dir":"Reference","previous_headings":"","what":"Predict Antimicrobial Resistance — resistance_predict","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Create prediction model predict antimicrobial resistance next years. Standard errors (SE) returned columns se_min se_max. See Examples real live example. NOTE: functions deprecated removed future version. Use AMR package combined tidymodels framework instead, written basic short introduction website.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"resistance_predict(x, col_ab, col_date = NULL, year_min = NULL,   year_max = NULL, year_every = 1, minimum = 30, model = NULL,   I_as_S = TRUE, preserve_measurements = TRUE, info = interactive(), ...)  sir_predict(x, col_ab, col_date = NULL, year_min = NULL, year_max = NULL,   year_every = 1, minimum = 30, model = NULL, I_as_S = TRUE,   preserve_measurements = TRUE, info = interactive(), ...)  # S3 method for class 'resistance_predict' plot(x, main = paste(\"Resistance Prediction of\",   x_name), ...)  ggplot_sir_predict(x, main = paste(\"Resistance Prediction of\", x_name),   ribbon = TRUE, ...)  # S3 method for class 'resistance_predict' autoplot(object,   main = paste(\"Resistance Prediction of\", x_name), ribbon = TRUE, ...)"},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Predict Antimicrobial Resistance — resistance_predict","text":"x data.frame containing isolates. Can left blank automatic determination, see Examples. col_ab Column name x containing antimicrobial interpretations (\"R\", \"\" \"S\"). col_date Column name date, used calculate years column consist years already - default first column date class. year_min Lowest year use prediction model, dafaults lowest year col_date. year_max Highest year use prediction model - default 10 years today. year_every Unit sequence lowest year found data year_max. minimum Minimal amount available isolates per year include. Years containing less observations estimated model. model statistical model choice. generalised linear regression model binomial distribution (.e. using glm(..., family = binomial), assuming period zero resistance followed period increasing resistance leading slowly resistance. See Details valid options. I_as_S logical indicate whether values \"\" treated \"S\" (otherwise treated \"R\"). default, TRUE, follows redefinition EUCAST interpretation (increased exposure) 2019, see section Interpretation S, R . preserve_measurements logical indicate whether predictions years actually available data overwritten original data. standard errors years NA. info logical indicate whether textual analysis printed name summary() statistical model. ... Arguments passed functions. main Title plot. ribbon logical indicate whether ribbon shown (default) error bars. object Model data plotted.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Predict Antimicrobial Resistance — resistance_predict","text":"data.frame extra class resistance_predict columns: year value, estimated preserve_measurements = FALSE, combination observed estimated otherwise se_min, lower bound standard error minimum 0 (standard error never go 0%) se_max upper bound standard error maximum 1 (standard error never go 100%) observations, total number available observations year, .e. \\(S + + R\\) observed, original observed resistant percentages estimated, estimated resistant percentages, calculated model Furthermore, model available attribute: attributes(x)$model, see Examples.","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Predict Antimicrobial Resistance — resistance_predict","text":"Valid options statistical model (argument model) : \"binomial\" \"binom\" \"logit\": generalised linear regression model binomial distribution \"loglin\" \"poisson\": generalised log-linear regression model poisson distribution \"lin\" \"linear\": linear regression model","code":""},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"interpretation-of-sir","dir":"Reference","previous_headings":"","what":"Interpretation of SIR","title":"Predict Antimicrobial Resistance — resistance_predict","text":"2019, European Committee Antimicrobial Susceptibility Testing (EUCAST) decided change definitions susceptibility testing categories S, , R (https://www.eucast.org/newsiandr). AMR package follows insight; use susceptibility() (equal proportion_SI()) determine antimicrobial susceptibility count_susceptible() (equal count_SI()) count susceptible isolates.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/resistance_predict.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Predict Antimicrobial Resistance — resistance_predict","text":"","code":"x <- resistance_predict(example_isolates,   col_ab = \"AMX\",   year_min = 2010,   model = \"binomial\" ) #> Warning: The `resistance_predict()` function is deprecated and will be removed in a #> future version, see `?AMR-deprecated`. Use the tidymodels framework #> instead, for which we have written a basic and short introduction on our #> website: https://amr-for-r.org/articles/AMR_with_tidymodels.html #> This warning will be shown once per session. plot(x)  # \\donttest{ if (require(\"ggplot2\")) {   ggplot_sir_predict(x) }   # using dplyr: if (require(\"dplyr\")) {   x <- example_isolates %>%     filter_first_isolate() %>%     filter(mo_genus(mo) == \"Staphylococcus\") %>%     resistance_predict(\"PEN\", model = \"binomial\")   print(plot(x))    # get the model from the object   mymodel <- attributes(x)$model   summary(mymodel) }  #> NULL #>  #> Call: #> glm(formula = df_matrix ~ year, family = binomial) #>  #> Coefficients: #>             Estimate Std. Error z value Pr(>|z|) #> (Intercept) 35.76101   72.29172   0.495    0.621 #> year        -0.01720    0.03603  -0.477    0.633 #>  #> (Dispersion parameter for binomial family taken to be 1) #>  #>     Null deviance: 5.3681  on 11  degrees of freedom #> Residual deviance: 5.1408  on 10  degrees of freedom #> AIC: 50.271 #>  #> Number of Fisher Scoring iterations: 4 #>   # create nice plots with ggplot2 yourself if (require(\"dplyr\") && require(\"ggplot2\")) {   data <- example_isolates %>%     filter(mo == as.mo(\"E. coli\")) %>%     resistance_predict(       col_ab = \"AMX\",       col_date = \"date\",       model = \"binomial\",       info = FALSE,       minimum = 15     )   head(data)   autoplot(data) }  # }"},{"path":"https://amr-for-r.org/reference/skewness.html","id":null,"dir":"Reference","previous_headings":"","what":"Skewness of the Sample — skewness","title":"Skewness of the Sample — skewness","text":"Skewness measure asymmetry probability distribution real-valued random variable mean. negative ('left-skewed'): left tail longer; mass distribution concentrated right histogram. positive ('right-skewed'): right tail longer; mass distribution concentrated left histogram. normal distribution skewness 0.","code":""},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Skewness of the Sample — skewness","text":"","code":"skewness(x, na.rm = FALSE)  # Default S3 method skewness(x, na.rm = FALSE)  # S3 method for class 'matrix' skewness(x, na.rm = FALSE)  # S3 method for class 'data.frame' skewness(x, na.rm = FALSE)"},{"path":"https://amr-for-r.org/reference/skewness.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Skewness of the Sample — skewness","text":"x vector values, matrix data.frame. na.rm logical value indicating whether NA values stripped computation proceeds.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/skewness.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Skewness of the Sample — skewness","text":"","code":"skewness(runif(1000)) #> [1] -0.03886098"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":null,"dir":"Reference","previous_headings":"","what":"Filter Top n Microorganisms — top_n_microorganisms","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function filters data set include top n microorganisms based specified property, taxonomic family genus. example, can filter data set top 3 species, species top 5 genera, top 3 species top 5 genera.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"top_n_microorganisms(x, n, property = \"species\", n_for_each = NULL,   col_mo = NULL, ...)"},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"x data frame containing microbial data. n integer specifying maximum number unique values property include output. property character string indicating microorganism property use filtering. Must one column names microorganisms data set: \"mo\", \"fullname\", \"status\", \"kingdom\", \"phylum\", \"class\", \"order\", \"family\", \"genus\", \"species\", \"subspecies\", \"rank\", \"ref\", \"oxygen_tolerance\", \"source\", \"lpsn\", \"lpsn_parent\", \"lpsn_renamed_to\", \"mycobank\", \"mycobank_parent\", \"mycobank_renamed_to\", \"gbif\", \"gbif_parent\", \"gbif_renamed_to\", \"prevalence\", \"snomed\". NULL, raw values col_mo used without transformation. using \"species\" (default) \"subpecies\", genus added make sure (sub)species still belongs right genus. n_for_each optional integer specifying maximum number rows retain value selected property. NULL, rows within top n groups included. col_mo character string indicating column x contains microorganism names codes. Defaults first column class mo. Values coerced using .mo(). ... Additional arguments passed mo_property() property NULL.","code":""},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"function useful preprocessing data creating antibiograms analyses require focused subsets microbial data. example, can filter data set include isolates top 10 species.","code":""},{"path":[]},{"path":"https://amr-for-r.org/reference/top_n_microorganisms.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Filter Top n Microorganisms — top_n_microorganisms","text":"","code":"# filter to the top 3 species: top_n_microorganisms(example_isolates,   n = 3 ) #> # A tibble: 1,015 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  4 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  5 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  6 2002-01-19 738003     71 M      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  7 2002-02-03 481442     76 M      ICU      B_STPHY_CONS   R     NA    S     NA  #>  8 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   R     NA    R     NA  #>  9 2002-02-14 067927     45 F      ICU      B_STPHY_CONS   S     NA    S     NA  #> 10 2002-02-21 A56499     64 M      Clinical B_STPHY_CONS   S     NA    S     NA  #> # ℹ 1,005 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to any species in the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\" ) #> # A tibble: 1,742 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-01-02 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  2 2002-01-03 A77334     65 F      Clinical B_ESCHR_COLI   R     NA    NA    NA  #>  3 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  4 2002-01-07 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  5 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  6 2002-01-13 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #>  7 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  8 2002-01-14 462729     78 M      Clinical B_STPHY_AURS   R     NA    S     R   #>  9 2002-01-16 067927     45 F      ICU      B_STPHY_EPDR   R     NA    R     NA  #> 10 2002-01-17 858515     79 F      ICU      B_STPHY_EPDR   R     NA    S     NA  #> # ℹ 1,732 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …  # filter to the top 3 species in each of the top 5 genera: top_n_microorganisms(example_isolates,   n = 5, property = \"genus\", n_for_each = 3 ) #> # A tibble: 1,497 × 46 #>    date       patient   age gender ward     mo           PEN   OXA   FLC   AMX   #>    <date>     <chr>   <dbl> <chr>  <chr>    <mo>         <sir> <sir> <sir> <sir> #>  1 2002-02-21 4FC193     69 M      Clinical B_ENTRC_FACM   NA    NA    NA    NA  #>  2 2002-04-08 130252     78 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  3 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  4 2002-06-23 798871     82 M      Clinical B_ENTRC_FCLS   NA    NA    NA    NA  #>  5 2003-04-20 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  6 2003-04-21 6BC362     62 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  7 2003-08-13 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #>  8 2003-09-05 F35553     52 M      ICU      B_ENTRC        NA    NA    NA    NA  #>  9 2003-09-05 F35553     52 M      ICU      B_ENTRC_FCLS   NA    NA    NA    NA  #> 10 2003-09-28 1B0933     80 M      Clinical B_ENTRC        NA    NA    NA    NA  #> # ℹ 1,487 more rows #> # ℹ 36 more variables: AMC <sir>, AMP <sir>, TZP <sir>, CZO <sir>, FEP <sir>, #> #   CXM <sir>, FOX <sir>, CTX <sir>, CAZ <sir>, CRO <sir>, GEN <sir>, #> #   TOB <sir>, AMK <sir>, KAN <sir>, TMP <sir>, SXT <sir>, NIT <sir>, #> #   FOS <sir>, LNZ <sir>, CIP <sir>, MFX <sir>, VAN <sir>, TEC <sir>, #> #   TCY <sir>, TGC <sir>, DOX <sir>, ERY <sir>, CLI <sir>, AZM <sir>, #> #   IPM <sir>, MEM <sir>, MTR <sir>, CHL <sir>, COL <sir>, MUP <sir>, …"},{"path":"https://amr-for-r.org/reference/translate.html","id":null,"dir":"Reference","previous_headings":"","what":"Translate Strings from the AMR Package — translate","title":"Translate Strings from the AMR Package — translate","text":"language-dependent output AMR functions, mo_name(), mo_gramstain(), mo_type() ab_name().","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Translate Strings from the AMR Package — translate","text":"","code":"get_AMR_locale()  set_AMR_locale(language)  reset_AMR_locale()  translate_AMR(x, language = get_AMR_locale())"},{"path":"https://amr-for-r.org/reference/translate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Translate Strings from the AMR Package — translate","text":"language Language choose. Use one supported language names ISO 639-1 codes: English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). x Text translate.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Translate Strings from the AMR Package — translate","text":"currently 28 supported languages English (en), Arabic (ar), Bengali (bn), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hindi (hi), Indonesian (id), Italian (), Japanese (ja), Korean (ko), Norwegian (), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swahili (sw), Swedish (sv), Turkish (tr), Ukrainian (uk), Urdu (ur), Vietnamese (vi). languages translations available antimicrobial drugs colloquial microorganism names. permanently silence -per-session language note non-English operating system, can set package option AMR_locale .Rprofile file like :   save file. Please read adding updating language Wiki.","code":"# Open .Rprofile file utils::file.edit(\"~/.Rprofile\")  # Then add e.g. Italian support to that file using: options(AMR_locale = \"Italian\")"},{"path":"https://amr-for-r.org/reference/translate.html","id":"changing-the-default-language","dir":"Reference","previous_headings":"","what":"Changing the Default Language","title":"Translate Strings from the AMR Package — translate","text":"system language used default (returned Sys.getenv(\"LANG\") , LANG set, Sys.getlocale(\"LC_COLLATE\")), language supported. language used can overwritten two ways checked order: Setting package option AMR_locale, either using e.g. set_AMR_locale(\"German\") running e.g. options(AMR_locale = \"German\"). Note setting R option works session. Save command options(AMR_locale = \"(language)\") .Rprofile file apply every session. Run utils::file.edit(\"~/.Rprofile\") edit .Rprofile file. Setting system variable LANGUAGE LANG, e.g. adding LANGUAGE=\"de_DE.utf8\" .Renviron file home directory. Thus, package option AMR_locale set, system variables LANGUAGE LANG ignored.","code":""},{"path":"https://amr-for-r.org/reference/translate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Translate Strings from the AMR Package — translate","text":"","code":"# Current settings (based on system language) ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negative Staphylococcus (CoNS)\"  # setting another language set_AMR_locale(\"Dutch\") #> ℹ Using Dutch (Nederlands) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacine\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Coagulase-negatieve Staphylococcus (CNS)\"  # setting yet another language set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"Ciprofloxacin\") #> [1] \"Ciprofloxacin\" mo_name(\"Coagulase-negative Staphylococcus (CoNS)\") #> [1] \"Koagulase-negative Staphylococcus (KNS)\"  # set_AMR_locale() understands endonyms, English exonyms, and ISO 639-1: set_AMR_locale(\"Deutsch\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"German\") #> ℹ Using German (Deutsch) for the AMR package for this session. set_AMR_locale(\"de\") #> ℹ Using German (Deutsch) for the AMR package for this session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/Clavulansäure\"  # reset to system default reset_AMR_locale() #> ℹ Using the English language (English) for the AMR package for this #>   session. ab_name(\"amox/clav\") #> [1] \"Amoxicillin/clavulanic acid\""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-3009016","dir":"Changelog","previous_headings":"","what":"AMR 3.0.0.9016","title":"AMR 3.0.0.9016","text":"primarily bugfix release, though added one nice feature .","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"new-3-0-0-9016","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 3.0.0.9016","text":"step_mic_log2() transform <mic> columns log2, step_sir_numeric() convert <sir> columns numeric New tidyselect helpers: all_mic(), all_mic_predictors(), all_sir(), all_sir_predictors()","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-3-0-0-9016","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.0.9016","text":"Fixed bug antibiogram() antimicrobials set Fixed bug antibiogram() allow column names containing + character (#222) Fixed bug .ab() antimicrobial codes number preceded space Fixed bug eucast_rules() using specific custom rules Fixed bug .sir() allow tidyselect language (#220) Fixed bug .sir() pick right breakpoint uti = FALSE (#216) Fixed bug ggplot_sir() using combine_SI = FALSE (#213) Fixed plotting contain separate colour SDD (susceptible dose-dependent) (#223) Fixed specific Dutch translations antimicrobials Added names age_groups() custom names can given (#215) Added note .sir() make explicit higher-level taxonomic breakpoints used (#218) Updated random_mic() random_disk() set skewedness distribution allow multiple microorganisms","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"amr-300","dir":"Changelog","previous_headings":"","what":"AMR 3.0.0","title":"AMR 3.0.0","text":"CRAN release: 2025-06-02 package now supports tools AMR data analysis clinical settings, also veterinary environmental microbiology. made possible collaboration University Prince Edward Island’s Atlantic Veterinary College, Canada. celebrate great improvement package, also updated package logo reflect change.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"breaking-3-0-0","dir":"Changelog","previous_headings":"","what":"Breaking","title":"AMR 3.0.0","text":"Dataset antibiotics renamed antimicrobials data set contains just antibiotics. Using antibiotics still work, now returns warning. Removed functions references used deprecated rsi class, replaced sir equivalents two years ago. Functions resistance_predict() sir_predict() now deprecated removed future version. Use tidymodels framework instead, wrote basic introduction.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"new-3-0-0","dir":"Changelog","previous_headings":"","what":"New","title":"AMR 3.0.0","text":"Function .sir() now extensive support veterinary breakpoints CLSI. Use breakpoint_type = \"animal\" set host argument variable contains animal species names. clinical_breakpoints data set contains breakpoints, can downloaded download page. (new) antimicrobials data set contains veterinary antimicrobials, pradofloxacin enrofloxacin. WHOCC codes veterinary use added well. ab_atc() now supports ATC codes veterinary antimicrobials (start “Q”) ab_url() now supports retrieving WHOCC url ATCvet pages antibiogram() function now supports creating true Weighted-Incidence Syndromic Combination Antibiograms (WISCA), powerful Bayesian method estimating regimen coverage probabilities using pathogen incidence antimicrobial susceptibility data. WISCA offers improved precision syndrome-specific treatment, even datasets sparse data. dedicated wisca() function also available easy usage. Added full support 8 new languages: Arabic, Bengali, Hindi, Indonesian, Korean, Swahili, Urdu, Vietnamese. AMR package now available 28 languages. MycoBank now integrated primary taxonomic source fungi. microorganisms data set enriched new columns (mycobank, mycobank_parent, mycobank_renamed_to) provide detailed information fungal species. remarkable addition 20,000 new fungal records New function mo_mycobank() retrieve MycoBank record number, analogous existing functions mo_lpsn() mo_gbif(). .mo() function mo_*() functions now include only_fungi argument, allowing users restrict results solely fungal species. ensures fungi prioritised bacteria microorganism identification. can also set globally new AMR_only_fungi option. Also updated kingdoms, welcoming total 2,149 new records 2023 927 2024. Breakpoint 2024 2025 CLSI EUCAST now supported, adding 10,000 new clinical breakpoints clinical_breakpoints data set usage .sir(). EUCAST 2025 now new default guideline MIC disk diffusion interpretations. Added Expected Resistant Phenotypes EUCAST (v1.2). default rules eucast_rules() now: c(\"breakpoints\", \"expected_phenotypes\"). Updated intrinsic_resistant data set, now based EUCAST Expected Resistant Phenotypes v1.2 .sir() now brings additional factor levels: “NI” non-interpretable “SDD” susceptible dose-dependent. Currently, clinical_breakpoints data set contains 24 breakpoints can return value “SDD” instead “”. EUCAST interpretive rules (using eucast_rules()) now available EUCAST 12 (2022), 13 (2023), 14 (2024), 15 (2025). EUCAST dosage tables (dosage data set) now available EUCAST 13 (2023), 14 (2024), 15 (2025). New function group scale_*_mic(), namely: scale_x_mic(), scale_y_mic(), scale_colour_mic() scale_fill_mic(). allow easy plotting MIC values. allow manual range definition plotting missing intermediate log2 levels. New function group scale_*_sir(), namely: scale_x_sir(), scale_colour_sir() scale_fill_sir(). allow plot sir class, translates system language default. also set colourblind-safe colours plots. New function rescale_mic(), allows users rescale MIC values manually set range. powerhouse behind scale_*_mic() functions, can used independently , instance, compare equality MIC distributions rescaling range first. using R heavy lifting, ‘AMR’ Python Package developed run AMR R package natively Python. Python package always version number R package, built automatically every code change. antimicrobial selectors (aminoglycosides() betalactams()) now supported tidymodels packages recipe parsnip. See info tutorial using AMR functions predictive modelling. New function top_n_microorganisms() filter data set top n taxonomic property, e.g., filter top 3 species, filter species top 5 genera, filter top 3 species top 5 genera New function mo_group_members() retrieve member microorganisms microorganism group. example, mo_group_members(\"Strep group C\") returns vector microorganisms belong group. New functions mic_p50() mic_p90() retrieve 50th 90th percentile MIC values.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"changed-3-0-0","dir":"Changelog","previous_headings":"","what":"Changed","title":"AMR 3.0.0","text":"Support parallel computing greatly improve speed using parallel package (part base R). Use .sir(your_data, parallel = TRUE) run SIR interpretation using multiple cores. now possible use column names arguments guideline, ab, mo, uti: .sir(..., ab = \"column1\", mo = \"column2\", uti = \"column3\"). greatly improves flexibility users. Users can now set criteria (using regular expressions) considered S, , R, SDD, NI. get quantitative values, .double() sir object return 1 S, 2 SDD/, 3 R (NI become NA). functions using sir classes (e.g., summary()) updated reflect change contain NI SDD. Following CLSI interpretation rules, values outside log2-dilution range rounded upwards nearest log2-level interpretation. using CLSI guideline. Combined MIC values (e.g., CLSI) now supported argument conserve_capped_values .sir() replaced capped_mic_handling, allows greater flexibility handling capped MIC values (<, <=, >, >=). four available options (\"standard\", \"strict\", \"relaxed\", \"inverse\") provide full control whether values interpreted conservatively ignored. Using conserve_capped_values now deprecated returns warning. Added argument info silence console messages Argument antibiotics renamed antimicrobials. Using antibiotics still work, now returns warning. Added argument formatting_type set 22 options formatting ‘cells’. defaults 18 non-WISCA 14 WISCA, changing output antibiograms cells info. reason, add_total_n now deprecated FALSE default since denominators added cells dependent formatting_type setting ab_transform argument now defaults \"name\", displaying antibiotic column names instead codes ‘Antibiotic selectors’ now called ‘antimicrobial selectors’ since scope broader just antibiotics. documentation updated, ab_class() ab_selector() replaced amr_class() amr_selector(). old functions now deprecated removed future version. Added selectors isoxazolylpenicillins(), monobactams(), nitrofurans(), phenicols(), rifamycins(), sulfonamides() using antimicrobial selectors exclude non-treatable drugs (gentamicin-high using aminoglycosides()), function now always returns warning can included using only_treatable = FALSE Added new argument return_all selectors, defaults TRUE include match. FALSE, old behaviour, first hit unique antimicrobial returned. selectors can now run separate command retrieve vector possible antimicrobials selector can select selectors lincosamides() macrolides() overlap anymore - antibiotic now classified either Fixed selector fluoroquinolones(), now really selects second-generation quinolones (first-generation quinolones contain fluorine group) Added agents used screening, ID ending -S: benzylpenicillin screening test (PEN-S), beta-lactamase screening test (BLA-S), cefotaxime screening test (CTX-S), clindamycin inducible screening test (CLI-S), nalidixic acid screening test (NAL-S), norfloxacin screening test (-S), oxacillin screening test (OXA-S), pefloxacin screening test (PEF-S), tetracycline screening test (TCY-S). ID cefoxitin screening renamed FOX1 FOX-S, old code remains work. reason, antimicrobial selectors cephalosporins(), cephalosporins_3rd(), lincosamides(), isoxazolylpenicillins(), quinolones(), fluoroquinolones(), tetracyclines() now contain argument only_treatable = TRUE (similar antimicrobial selectors contain non-treatable drugs) Added amorolfine (AMO, D01AE16), antimycotic, now also part antifungals() selector Added cefepime/enmetazobactam (FPE), 4th gen cephalosporin Added tigemonam (TNM), monobactam Added bleomycin (BLM), glycopeptide Added efflux (EFF), allow mapping AMRFinderPlus Updated ATC codes, trade names, DDDs Added valid levels: 4096, 6 powers 0.0625, 5 powers 192 (192, 384, 576, 768, 960) Fixed bug .mic() failed translation scientifically formatted numbers Added new argument keep_operators .mic(). can \"\" (default), \"none\", \"edges\". argument also available new rescale_mic() scale_*_mic() functions. Comparisons MIC values now strict. example, >32 higher (never equal ) 32. Thus, .mic(\">32\") == .mic(32) now returns FALSE, .mic(\">32\") > .mic(32) now returns TRUE. Sorting MIC values (using sort()) fixed manner; <0.001 now gets sorted 0.001, >0.001 gets sorted 0.001. Intermediate log2 levels used MIC plotting now common values instead following strict dilution range .mic() now returns vector TRUE/FALSE input data.frame, just like .sir() eucast_rules() now argument overwrite (default: FALSE) indicate whether non-NA values overwritten Disks 0 5 mm now allowed, newly allowed range disk diffusion (.disk()) now 0 50 mm Updated italicise_taxonomy() support HTML output custom_eucast_rules() now supports multiple antimicrobials antimicrobial groups affected single rule mo_info() now contains extra element rank group_members (contents new mo_group_members() function) Updated ATC codes WHOCC Updated antimicrobial DDDs WHOCC Fix using manual value mo_transform antibiogram() Fixed bug antibiogram() returns empty data set Argument only_sir_columns now defaults TRUE column data set contains class ‘sir’ (functions eucast_rules(), key_antimicrobials(), mdro(), etc.) Added Sensititre codes animals, antimicrobials microorganisms Fix mapping ‘high level’ antimicrobials .ab() (amphotericin B-high, gentamicin-high, kanamycin-high, streptomycin-high, tobramycin-high) Improved overall algorithm .ab() better performance accuracy, including new function as_reset_session() remove earlier coercions. weight given genus species combinations cases subspecies miswritten, result correct genus species Genera World Health Organization’s () Priority Pathogen List now highest prevalence Fixed bug sir_confidence_interval() isolates available Updated prevalence calculation include genera World Health Organization’s () Priority Pathogen List Improved algorithm first_isolate() using phenotype-based method, prioritise records highest availability SIR values scale_y_percent() can now cope ranges outside 0-100% range Verbose Mode (verbose = TRUE) now includes guideline name Implemented new Dutch national MDRO guideline (SRI-richtlijn BRMO, Nov 2024) Added arguments esbl, carbapenemase, mecA, mecC, vanA, vanB denote column names logical values indicating presence genes (production proteins) Added upport antimicrobial selectors use custom rule (custom_mdro_guideline()) Added console colours support sir class Positron","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"other-3-0-0","dir":"Changelog","previous_headings":"","what":"Other","title":"AMR 3.0.0","text":"New website domain: https://amr--r.org! old domain remain work. Added Dr. Larisse Bolton Aislinn Cook contributors fantastic implementation WISCA mathematically solid way Added Matthew Saab, Dr. Jordan Stull, Prof. Javier Sanchez contributors tremendous input veterinary breakpoints interpretations Added Prof. Kathryn Holt, Dr. Jane Hawkey, Dr. Natacha Couto contributors many suggestions, ideas bugfixes Greatly improved vctrs integration, Tidyverse package working background many Tidyverse functions. users, means functions dplyr’s bind_rows(), rowwise() c_across() now supported e.g. columns class mic. Despite , AMR package still zero-dependent package, including dplyr vctrs. Greatly updated expanded documentation Stopped support SAS (.xpt) files, since file structure extremely inefficient requires disk space GitHub allows single commit.","code":""},{"path":"https://amr-for-r.org/news/index.html","id":"older-versions-3-0-0","dir":"Changelog","previous_headings":"","what":"Older Versions","title":"AMR 3.0.0","text":"changelog contains changes AMR v3.0 (June 2025) later. prior v2 versions, please see v2 archive. prior v1 versions, please see v1 archive.","code":""}]