2019-08-25 22:53:22 +02:00
<!-- Generated by pkgdown: do not edit by hand -->
<!DOCTYPE html>
< html lang = "en" >
< head >
< meta charset = "utf-8" >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< title > Determine bug-drug combinations — bug_drug_combinations • AMR (for R)< / title >
<!-- favicons -->
< link rel = "icon" type = "image/png" sizes = "16x16" href = "../favicon-16x16.png" >
< link rel = "icon" type = "image/png" sizes = "32x32" href = "../favicon-32x32.png" >
< link rel = "apple-touch-icon" type = "image/png" sizes = "180x180" href = "../apple-touch-icon.png" / >
< link rel = "apple-touch-icon" type = "image/png" sizes = "120x120" href = "../apple-touch-icon-120x120.png" / >
< link rel = "apple-touch-icon" type = "image/png" sizes = "76x76" href = "../apple-touch-icon-76x76.png" / >
< link rel = "apple-touch-icon" type = "image/png" sizes = "60x60" href = "../apple-touch-icon-60x60.png" / >
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
<!-- jquery -->
< script src = "https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js" integrity = "sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8=" crossorigin = "anonymous" > < / script >
<!-- Bootstrap -->
< link href = "https://cdnjs.cloudflare.com/ajax/libs/bootswatch/3.3.7/flatly/bootstrap.min.css" rel = "stylesheet" crossorigin = "anonymous" / >
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
< script src = "https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" integrity = "sha256-U5ZEeKfGNOja007MMD3YBI0A3OSZOQbeG6z2f2Y0hu8=" crossorigin = "anonymous" > < / script >
<!-- Font Awesome icons -->
2019-09-25 15:43:22 +02:00
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.7.1/css/all.min.css" integrity = "sha256-nAmazAk6vS34Xqo0BSrTb+abbtFlgsFK7NKSi6o7Y78=" crossorigin = "anonymous" / >
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.7.1/css/v4-shims.min.css" integrity = "sha256-6qHlizsOWFskGlwVOKuns+D1nB6ssZrHQrNj1wGplHc=" crossorigin = "anonymous" / >
2019-08-25 22:53:22 +02:00
<!-- clipboard.js -->
< script src = "https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.4/clipboard.min.js" integrity = "sha256-FiZwavyI2V6+EXO1U+xzLG3IKldpiTFf3153ea9zikQ=" crossorigin = "anonymous" > < / script >
2019-09-25 15:43:22 +02:00
<!-- headroom.js -->
< script src = "https://cdnjs.cloudflare.com/ajax/libs/headroom/0.9.4/headroom.min.js" integrity = "sha256-DJFC1kqIhelURkuza0AvYal5RxMtpzLjFhsnVIeuk+U=" crossorigin = "anonymous" > < / script >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/headroom/0.9.4/jQuery.headroom.min.js" integrity = "sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin = "anonymous" > < / script >
2019-08-25 22:53:22 +02:00
<!-- pkgdown -->
< link href = "../pkgdown.css" rel = "stylesheet" >
< script src = "../pkgdown.js" > < / script >
<!-- docsearch -->
< script src = "../docsearch.js" > < / script >
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/docsearch.js/2.6.1/docsearch.min.css" integrity = "sha256-QOSRU/ra9ActyXkIBbiIB144aDBdtvXBcNc3OTNuX/Q=" crossorigin = "anonymous" / >
< link href = "../docsearch.css" rel = "stylesheet" >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/jquery.mark.min.js" integrity = "sha256-4HLtjeVgH0eIB3aZ9mLYF6E8oU5chNdjU6p6rrXpl9U=" crossorigin = "anonymous" > < / script >
< link href = "../extra.css" rel = "stylesheet" >
< script src = "../extra.js" > < / script >
2019-09-25 15:43:22 +02:00
< meta property = "og:title" content = "Determine bug-drug combinations — bug_drug_combinations" / >
< meta property = "og:description" content = "Determine antimicrobial resistance (AMR) of all bug-drug combinations in your data set where at least 30 (default) isolates are available per species. Use format on the result to prettify it to a publicable/printable format, see Examples." / >
2019-08-25 22:53:22 +02:00
< meta property = "og:image" content = "https://msberends.gitlab.io/AMR/logo.png" / >
< meta name = "twitter:card" content = "summary" / >
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
<!-- mathjax -->
< script src = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity = "sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin = "anonymous" > < / script >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity = "sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin = "anonymous" > < / script >
<!-- [if lt IE 9]>
< script src = "https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js" > < / script >
< script src = "https://oss.maxcdn.com/respond/1.4.2/respond.min.js" > < / script >
<![endif]-->
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
< / head >
< body >
< div class = "container template-reference-topic" >
< header >
< div class = "navbar navbar-default navbar-fixed-top" role = "navigation" >
< div class = "container" >
< div class = "navbar-header" >
< button type = "button" class = "navbar-toggle collapsed" data-toggle = "collapse" data-target = "#navbar" aria-expanded = "false" >
< span class = "sr-only" > Toggle navigation< / span >
< span class = "icon-bar" > < / span >
< span class = "icon-bar" > < / span >
< span class = "icon-bar" > < / span >
< / button >
< span class = "navbar-brand" >
< a class = "navbar-link" href = "../index.html" > AMR (for R)< / a >
2019-09-25 15:43:22 +02:00
< span class = "version label label-default" data-toggle = "tooltip" data-placement = "bottom" title = "Latest development version" > 0.7.1.9088< / span >
2019-08-25 22:53:22 +02:00
< / span >
< / div >
< div id = "navbar" class = "navbar-collapse collapse" >
< ul class = "nav navbar-nav" >
< li >
< a href = "../index.html" >
< span class = "fa fa-home" > < / span >
Home
< / a >
< / li >
< li class = "dropdown" >
< a href = "#" class = "dropdown-toggle" data-toggle = "dropdown" role = "button" aria-expanded = "false" >
< span class = "fa fa-question-circle" > < / span >
How to
< span class = "caret" > < / span >
< / a >
< ul class = "dropdown-menu" role = "menu" >
< li >
< a href = "../articles/AMR.html" >
< span class = "fa fa-directions" > < / span >
Conduct AMR analysis
< / a >
< / li >
< li >
< a href = "../articles/resistance_predict.html" >
< span class = "fa fa-dice" > < / span >
Predict antimicrobial resistance
< / a >
< / li >
< li >
< a href = "../articles/MDR.html" >
< span class = "fa fa-skull-crossbones" > < / span >
Determine multi-drug resistance (MDR)
< / a >
< / li >
< li >
< a href = "../articles/WHONET.html" >
< span class = "fa fa-globe-americas" > < / span >
Work with WHONET data
< / a >
< / li >
< li >
< a href = "../articles/SPSS.html" >
< span class = "fa fa-file-upload" > < / span >
Import data from SPSS/SAS/Stata
< / a >
< / li >
< li >
< a href = "../articles/EUCAST.html" >
< span class = "fa fa-exchange-alt" > < / span >
Apply EUCAST rules
< / a >
< / li >
< li >
< a href = "../reference/mo_property.html" >
< span class = "fa fa-bug" > < / span >
Get properties of a microorganism
< / a >
< / li >
< li >
< a href = "../reference/ab_property.html" >
< span class = "fa fa-capsules" > < / span >
Get properties of an antibiotic
< / a >
< / li >
< li >
< a href = "../articles/benchmarks.html" >
< span class = "fa fa-shipping-fast" > < / span >
Other: benchmarks
< / a >
< / li >
< / ul >
< / li >
< li >
< a href = "../reference/" >
< span class = "fa fa-book-open" > < / span >
Manual
< / a >
< / li >
< li >
< a href = "../authors.html" >
< span class = "fa fa-users" > < / span >
Authors
< / a >
< / li >
< li >
< a href = "../news/" >
< span class = "far fa far fa-newspaper" > < / span >
Changelog
< / a >
< / li >
< / ul >
< ul class = "nav navbar-nav navbar-right" >
< li >
< a href = "https://gitlab.com/msberends/AMR" >
< span class = "fab fa fab fa-gitlab" > < / span >
Source Code
< / a >
< / li >
< li >
< a href = "../LICENSE-text.html" >
< span class = "fa fa-book" > < / span >
Licence
< / a >
< / li >
< / ul >
2019-09-25 15:43:22 +02:00
< form class = "navbar-form navbar-right hidden-xs hidden-sm" role = "search" >
2019-08-25 22:53:22 +02:00
< div class = "form-group" >
< input type = "search" class = "form-control" name = "search-input" id = "search-input" placeholder = "Search..." aria-label = "Search for..." autocomplete = "off" >
< / div >
< / form >
< / div > <!-- /.nav - collapse -->
< / div > <!-- /.container -->
< / div > <!-- /.navbar -->
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
< / header >
< div class = "row" >
< div class = "col-md-9 contents" >
< div class = "page-header" >
< h1 > Determine bug-drug combinations< / h1 >
< div class = "hidden name" > < code > bug_drug_combinations.Rd< / code > < / div >
< / div >
< div class = "ref-description" >
2019-09-25 15:43:22 +02:00
< p > Determine antimicrobial resistance (AMR) of all bug-drug combinations in your data set where at least 30 (default) isolates are available per species. Use < code > format< / code > on the result to prettify it to a publicable/printable format, see Examples.< / p >
2019-08-25 22:53:22 +02:00
< / div >
2019-09-23 13:53:50 +02:00
< pre class = "usage" > < span class = 'fu' > bug_drug_combinations< / span > (< span class = 'no' > x< / span > , < span class = 'kw' > col_mo< / span > < span class = 'kw' > =< / span > < span class = 'kw' > NULL< / span > , < span class = 'kw' > minimum< / span > < span class = 'kw' > =< / span > < span class = 'fl' > 30< / span > ,
< span class = 'kw' > FUN< / span > < span class = 'kw' > =< / span > < span class = 'no' > mo_shortname< / span > , < span class = 'no' > ...< / span > )
2019-08-27 22:41:09 +02:00
< span class = 'co' > # S3 method for bug_drug_combinations< / span >
2019-09-25 15:43:22 +02:00
< span class = 'fu' > < a href = 'https://rdrr.io/r/base/format.html' > format< / a > < / span > (< span class = 'no' > x< / span > ,
< span class = 'kw' > translate_ab< / span > < span class = 'kw' > =< / span > < span class = 'st' > "name (ab, atc)"< / span > , < span class = 'kw' > language< / span > < span class = 'kw' > =< / span > < span class = 'fu' > < a href = 'translate.html' > get_locale< / a > < / span > (),
< span class = 'kw' > minimum< / span > < span class = 'kw' > =< / span > < span class = 'fl' > 30< / span > , < span class = 'kw' > combine_SI< / span > < span class = 'kw' > =< / span > < span class = 'fl' > TRUE< / span > , < span class = 'kw' > combine_IR< / span > < span class = 'kw' > =< / span > < span class = 'fl' > FALSE< / span > ,
< span class = 'kw' > add_ab_group< / span > < span class = 'kw' > =< / span > < span class = 'fl' > TRUE< / span > , < span class = 'kw' > remove_intrinsic_resistant< / span > < span class = 'kw' > =< / span > < span class = 'fl' > FALSE< / span > ,
< span class = 'kw' > decimal.mark< / span > < span class = 'kw' > =< / span > < span class = 'fu' > < a href = 'https://rdrr.io/r/base/options.html' > getOption< / a > < / span > (< span class = 'st' > "OutDec"< / span > ), < span class = 'kw' > big.mark< / span > < span class = 'kw' > =< / span > < span class = 'fu' > < a href = 'https://rdrr.io/r/base/ifelse.html' > ifelse< / a > < / span > (< span class = 'no' > decimal.mark< / span > < span class = 'kw' > ==< / span >
< span class = 'st' > ","< / span > , < span class = 'st' > "."< / span > , < span class = 'st' > ","< / span > ), < span class = 'no' > ...< / span > )< / pre >
2019-08-25 22:53:22 +02:00
< h2 class = "hasAnchor" id = "arguments" > < a class = "anchor" href = "#arguments" > < / a > Arguments< / h2 >
< table class = "ref-arguments" >
< colgroup > < col class = "name" / > < col class = "desc" / > < / colgroup >
< tr >
< th > x< / th >
< td > < p > data with antibiotic columns, like e.g. < code > AMX< / code > and < code > AMC< / code > < / p > < / td >
< / tr >
< tr >
< th > col_mo< / th >
2019-08-27 22:41:09 +02:00
< td > < p > column name of the IDs of the microorganisms (see < code > < a href = 'as.mo.html' > as.mo< / a > < / code > ), defaults to the first column of class < code > mo< / code > . Values will be coerced using < code > < a href = 'as.mo.html' > as.mo< / a > < / code > .< / p > < / td >
2019-08-25 22:53:22 +02:00
< / tr >
< tr >
< th > minimum< / th >
< td > < p > the minimum allowed number of available (tested) isolates. Any isolate count lower than < code > minimum< / code > will return < code > NA< / code > with a warning. The default number of < code > 30< / code > isolates is advised by the Clinical and Laboratory Standards Institute (CLSI) as best practice, see Source.< / p > < / td >
< / tr >
2019-09-23 13:53:50 +02:00
< tr >
< th > FUN< / th >
< td > < p > the function to call on the < code > mo< / code > column to transform the microorganism IDs, defaults to < code > < a href = 'mo_property.html' > mo_shortname< / a > < / code > < / p > < / td >
< / tr >
< tr >
< th > ...< / th >
2019-09-25 15:43:22 +02:00
< td > < p > arguments passed on to < code > FUN< / code > < / p > < / td >
< / tr >
< tr >
< th > translate_ab< / th >
< td > < p > a character of length 1 containing column names of the < code > < a href = 'antibiotics.html' > antibiotics< / a > < / code > data set< / p > < / td >
< / tr >
< tr >
< th > language< / th >
< td > < p > language of the returned text, defaults to system language (see < code > < a href = 'translate.html' > get_locale< / a > < / code > ) and can also be set with < code > < a href = 'https://rdrr.io/r/base/options.html' > getOption< / a > ("AMR_locale")< / code > . Use < code > language = NULL< / code > or < code > language = ""< / code > to prevent translation.< / p > < / td >
< / tr >
< tr >
< th > combine_SI< / th >
< td > < p > a logical to indicate whether all values of S and I must be merged into one, so the output only consists of S+I vs. R (susceptible vs. resistant). This used to be the parameter < code > combine_IR< / code > , but this now follows the redefinition by EUCAST about the interpretion of I (increased exposure) in 2019, see section 'Interpretation of S, I and R' below. Default is < code > TRUE< / code > .< / p > < / td >
2019-09-23 13:53:50 +02:00
< / tr >
2019-08-27 16:45:42 +02:00
< tr >
2019-08-27 19:15:04 +02:00
< th > combine_IR< / th >
2019-08-27 16:45:42 +02:00
< td > < p > logical to indicate whether values R and I should be summed< / p > < / td >
< / tr >
2019-08-27 22:41:09 +02:00
< tr >
< th > add_ab_group< / th >
< td > < p > logical to indicate where the group of the antimicrobials must be included as a first column< / p > < / td >
< / tr >
2019-09-25 15:43:22 +02:00
< tr >
< th > remove_intrinsic_resistant< / th >
< td > < p > logical to indicate that rows with 100% resistance for all tested antimicrobials must be removed from the table< / p > < / td >
< / tr >
2019-08-27 23:00:00 +02:00
< tr >
2019-09-23 13:53:50 +02:00
< th > decimal.mark< / th >
< td > < p > the character to be used to indicate the numeric
decimal point.< / p > < / td >
< / tr >
< tr >
< th > big.mark< / th >
< td > < p > character; if not empty used as mark between every
< code > big.interval< / code > decimals < em > before< / em > (hence < code > big< / code > ) the
decimal point.< / p > < / td >
2019-08-27 23:00:00 +02:00
< / tr >
2019-08-25 22:53:22 +02:00
< / table >
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
< h2 class = "hasAnchor" id = "source" > < a class = "anchor" href = "#source" > < / a > Source< / h2 >
< p > < strong > M39 Analysis and Presentation of Cumulative Antimicrobial Susceptibility Test Data, 4th Edition< / strong > , 2014, < em > Clinical and Laboratory Standards Institute (CLSI)< / em > . < a href = 'https://clsi.org/standards/products/microbiology/documents/m39/' > https://clsi.org/standards/products/microbiology/documents/m39/< / a > .< / p >
2019-08-27 16:45:42 +02:00
< h2 class = "hasAnchor" id = "details" > < a class = "anchor" href = "#details" > < / a > Details< / h2 >
2019-08-27 22:41:09 +02:00
< p > The function < code > format< / code > calculates the resistance per bug-drug combination. Use < code > combine_IR = FALSE< / code > (default) to test R vs. S+I and < code > combine_IR = TRUE< / code > to test R+I vs. S.< / p >
2019-09-25 15:43:22 +02:00
< p > The language of the output can be overwritten with < code > < a href = 'https://rdrr.io/r/base/options.html' > options(AMR_locale)< / a > < / code > , please see < a href = 'translate.html' > translate< / a > .< / p >
2019-08-25 22:53:22 +02:00
< h2 class = "hasAnchor" id = "read-more-on-our-website-" > < a class = "anchor" href = "#read-more-on-our-website-" > < / a > Read more on our website!< / h2 >
2019-09-25 15:43:22 +02:00
< p > On our website < a href = 'https://msberends.gitlab.io/AMR' > https://msberends.gitlab.io/AMR< / a > you can find < a href = 'https://msberends.gitlab.io/AMR/articles/AMR.html' > a tutorial< / a > about how to conduct AMR analysis, the < a href = 'https://msberends.gitlab.io/AMR/reference' > complete documentation of all functions< / a > (which reads a lot easier than here in R) and < a href = 'https://msberends.gitlab.io/AMR/articles/WHONET.html' > an example analysis using WHONET data< / a > .< / p >
2019-08-25 22:53:22 +02:00
< h2 class = "hasAnchor" id = "examples" > < a class = "anchor" href = "#examples" > < / a > Examples< / h2 >
2019-09-25 15:43:22 +02:00
< pre class = "examples" > < span class = 'co' > # \donttest{< / span >
2019-08-27 16:45:42 +02:00
< span class = 'no' > x< / span > < span class = 'kw' > < -< / span > < span class = 'fu' > bug_drug_combinations< / span > (< span class = 'no' > example_isolates< / span > )
2019-08-25 22:53:22 +02:00
< span class = 'no' > x< / span >
2019-09-25 15:43:22 +02:00
< span class = 'fu' > < a href = 'https://rdrr.io/r/base/format.html' > format< / a > < / span > (< span class = 'no' > x< / span > )
2019-09-23 13:53:50 +02:00
< span class = 'co' > # Use FUN to change to transformation of microorganism codes< / span >
< span class = 'no' > x< / span > < span class = 'kw' > < -< / span > < span class = 'fu' > bug_drug_combinations< / span > (< span class = 'no' > example_isolates< / span > ,
< span class = 'kw' > FUN< / span > < span class = 'kw' > =< / span > < span class = 'no' > mo_gramstain< / span > )
< span class = 'no' > x< / span > < span class = 'kw' > < -< / span > < span class = 'fu' > bug_drug_combinations< / span > (< span class = 'no' > example_isolates< / span > ,
2019-09-25 15:43:22 +02:00
< span class = 'kw' > FUN< / span > < span class = 'kw' > =< / span > < span class = 'kw' > function< / span > (< span class = 'no' > x< / span > ) < span class = 'fu' > < a href = 'https://rdrr.io/r/base/ifelse.html' > ifelse< / a > < / span > (< span class = 'no' > x< / span > < span class = 'kw' > ==< / span > < span class = 'st' > "B_ESCHR_COLI"< / span > ,
2019-09-23 13:53:50 +02:00
< span class = 'st' > "E. coli"< / span > ,
< span class = 'st' > "Others"< / span > ))
2019-08-25 22:53:22 +02:00
< span class = 'co' > # }< / span > < / pre >
< / div >
< div class = "col-md-3 hidden-xs hidden-sm" id = "sidebar" >
< h2 > Contents< / h2 >
< ul class = "nav nav-pills nav-stacked" >
< li > < a href = "#arguments" > Arguments< / a > < / li >
< li > < a href = "#source" > Source< / a > < / li >
2019-08-27 16:45:42 +02:00
< li > < a href = "#details" > Details< / a > < / li >
2019-08-25 22:53:22 +02:00
< li > < a href = "#read-more-on-our-website-" > Read more on our website!< / a > < / li >
< li > < a href = "#examples" > Examples< / a > < / li >
< / ul >
< / div >
< / div >
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
< footer >
< div class = "copyright" >
< p > Developed by < a href = 'https://www.rug.nl/staff/m.s.berends/' > Matthijs S. Berends< / a > , < a href = 'https://www.rug.nl/staff/c.f.luz/' > Christian F. Luz< / a > , < a href = 'https://www.rug.nl/staff/a.w.friedrich/' > Alex W. Friedrich< / a > , < a href = 'https://www.rug.nl/staff/b.sinha/' > Bhanu N. M. Sinha< / a > , < a href = 'https://www.rug.nl/staff/c.j.albers/' > Casper J. Albers< / a > , < a href = 'https://www.rug.nl/staff/c.glasner/' > Corinna Glasner< / a > .< / p >
< / div >
< div class = "pkgdown" >
2019-09-25 15:43:22 +02:00
< p > Site built with < a href = "https://pkgdown.r-lib.org/" > pkgdown< / a > 1.4.1.< / p >
2019-08-25 22:53:22 +02:00
< / div >
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
< / footer >
< / div >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/docsearch.js/2.6.1/docsearch.min.js" integrity = "sha256-GKvGqXDznoRYHCwKXGnuchvKSwmx9SRMrZOTh2g4Sb0=" crossorigin = "anonymous" > < / script >
< script >
docsearch({
apiKey: 'f737050abfd4d726c63938e18f8c496e',
indexName: 'amr',
inputSelector: 'input#search-input.form-control',
transformData: function(hits) {
return hits.map(function (hit) {
hit.url = updateHitURL(hit);
return hit;
});
}
});
< / script >
2019-09-25 15:43:22 +02:00
2019-08-25 22:53:22 +02:00
< / body >
< / html >
2019-09-25 15:43:22 +02:00
