2018-12-23 21:26:21 +01: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" >
2020-08-10 12:46:03 +02:00
< title > AMR plots with ggplot2 — ggplot_rsi • AMR (for R)< / title >
2018-12-29 22:24:19 +01:00
<!-- 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-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01:00
<!-- jquery -->
2020-04-13 21:09:56 +02:00
< script src = "https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity = "sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin = "anonymous" > < / script >
2018-12-23 21:26:21 +01:00
<!-- Bootstrap -->
2020-04-13 21:09:56 +02:00
< link href = "https://cdnjs.cloudflare.com/ajax/libs/bootswatch/3.4.0/flatly/bootstrap.min.css" rel = "stylesheet" crossorigin = "anonymous" / >
2018-12-23 21:26:21 +01:00
2019-10-13 09:31:58 +02:00
2020-04-13 21:09:56 +02:00
< script src = "https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity = "sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin = "anonymous" > < / script >
2018-12-23 21:26:21 +01:00
2020-04-17 19:16:30 +02:00
<!-- bootstrap - toc -->
< link rel = "stylesheet" href = "../bootstrap-toc.css" >
< script src = "../bootstrap-toc.js" > < / script >
2018-12-23 21:26:21 +01:00
<!-- Font Awesome icons -->
2020-04-17 19:16:30 +02:00
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity = "sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin = "anonymous" / >
< link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity = "sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin = "anonymous" / >
2018-12-23 21:26:21 +01:00
<!-- clipboard.js -->
2020-04-17 19:16:30 +02:00
< script src = "https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity = "sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin = "anonymous" > < / script >
2018-12-23 21:26:21 +01:00
2019-10-13 09:31:58 +02:00
<!-- headroom.js -->
2020-04-17 19:16:30 +02:00
< script src = "https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity = "sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin = "anonymous" > < / script >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity = "sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin = "anonymous" > < / script >
2018-12-23 21:26:21 +01:00
<!-- pkgdown -->
< link href = "../pkgdown.css" rel = "stylesheet" >
< script src = "../pkgdown.js" > < / script >
2018-12-29 22:24:19 +01:00
< link href = "../extra.css" rel = "stylesheet" >
< script src = "../extra.js" > < / script >
2018-12-23 21:26:21 +01:00
2020-08-10 12:46:03 +02:00
< meta property = "og:title" content = "AMR plots with ggplot2 — ggplot_rsi" / >
2020-07-08 14:48:06 +02:00
< meta property = "og:description" content = "Use these functions to create bar plots for antimicrobial resistance analysis. All functions rely on ggplot2 functions." / >
2020-09-18 16:05:53 +02:00
< meta property = "og:image" content = "https://msberends.github.io/AMR/logo.png" / >
2018-12-23 21:26:21 +01:00
2019-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01: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-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01:00
< / head >
2020-04-17 19:16:30 +02:00
< body data-spy = "scroll" data-target = "#toc" >
2018-12-23 21:26:21 +01:00
< 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" >
2018-12-29 22:24:19 +01:00
< a class = "navbar-link" href = "../index.html" > AMR (for R)< / a >
2020-10-04 19:26:43 +02:00
< span class = "version label label-default" data-toggle = "tooltip" data-placement = "bottom" title = "Latest development version" > 1.4.0< / span >
2018-12-23 21:26:21 +01:00
< / span >
< / div >
< div id = "navbar" class = "navbar-collapse collapse" >
< ul class = "nav navbar-nav" >
< li >
< a href = "../index.html" >
2018-12-29 22:24:19 +01:00
< span class = "fa fa-home" > < / span >
2018-12-23 21:26:21 +01:00
2018-12-29 22:24:19 +01:00
Home
2018-12-23 21:26:21 +01:00
< / a >
< / li >
2019-01-02 23:24:07 +01:00
< 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
2018-12-29 22:24:19 +01:00
2019-01-02 23:24:07 +01:00
< span class = "caret" > < / span >
2018-12-29 22:24:19 +01:00
< / a >
2019-01-02 23:24:07 +01:00
< ul class = "dropdown-menu" role = "menu" >
< li >
< a href = "../articles/AMR.html" >
< span class = "fa fa-directions" > < / span >
Conduct AMR analysis
< / a >
< / li >
< li >
2019-02-14 10:23:51 +01:00
< a href = "../articles/resistance_predict.html" >
2019-01-02 23:24:07 +01:00
< span class = "fa fa-dice" > < / span >
Predict antimicrobial resistance
< / a >
< / li >
2020-08-21 11:40:13 +02:00
< li >
< a href = "../articles/datasets.html" >
< span class = "fa fa-database" > < / span >
2020-09-03 20:59:21 +02:00
Data sets for download / own use
2020-08-21 11:40:13 +02:00
< / a >
< / li >
2020-04-13 21:09:56 +02:00
< li >
< a href = "../articles/PCA.html" >
< span class = "fa fa-compress" > < / span >
Conduct principal component analysis for AMR
< / a >
< / li >
2019-05-23 16:58:59 +02:00
< li >
< a href = "../articles/MDR.html" >
< span class = "fa fa-skull-crossbones" > < / span >
Determine multi-drug resistance (MDR)
< / a >
< / li >
2019-01-29 00:06:50 +01:00
< li >
< a href = "../articles/WHONET.html" >
< span class = "fa fa-globe-americas" > < / span >
Work with WHONET data
< / a >
< / li >
2019-02-14 15:18:17 +01:00
< li >
< a href = "../articles/SPSS.html" >
< span class = "fa fa-file-upload" > < / span >
Import data from SPSS/SAS/Stata
< / a >
< / li >
2019-01-02 23:24:07 +01:00
< li >
< a href = "../articles/EUCAST.html" >
< span class = "fa fa-exchange-alt" > < / span >
Apply EUCAST rules
< / a >
< / li >
< li >
2019-02-14 10:23:51 +01:00
< a href = "../reference/mo_property.html" >
2019-01-02 23:24:07 +01:00
< span class = "fa fa-bug" > < / span >
Get properties of a microorganism
< / a >
< / li >
< li >
2019-05-10 16:44:59 +02:00
< a href = "../reference/ab_property.html" >
2019-01-02 23:24:07 +01:00
< span class = "fa fa-capsules" > < / span >
Get properties of an antibiotic
< / a >
< / li >
2019-01-11 20:37:23 +01:00
< li >
< a href = "../articles/benchmarks.html" >
< span class = "fa fa-shipping-fast" > < / span >
Other: benchmarks
< / a >
< / li >
2019-01-02 23:24:07 +01:00
< / ul >
2018-12-23 21:26:21 +01:00
< / li >
< li >
2020-07-28 18:39:57 +02:00
< a href = "../reference/index.html" >
2018-12-29 22:24:19 +01:00
< span class = "fa fa-book-open" > < / span >
Manual
< / a >
2018-12-23 21:26:21 +01:00
< / li >
2018-12-29 22:24:19 +01:00
< li >
< a href = "../authors.html" >
< span class = "fa fa-users" > < / span >
2018-12-23 21:26:21 +01:00
2018-12-29 22:24:19 +01:00
Authors
2018-12-23 21:26:21 +01:00
< / a >
< / li >
< li >
2020-07-28 18:39:57 +02:00
< a href = "../news/index.html" >
2018-12-29 22:24:19 +01:00
< span class = "far fa far fa-newspaper" > < / span >
Changelog
< / a >
< / li >
2019-01-02 23:24:07 +01:00
< / ul >
< ul class = "nav navbar-nav navbar-right" >
< li >
2020-07-08 14:48:06 +02:00
< a href = "https://github.com/msberends/AMR" >
< span class = "fab fa fab fa-github" > < / span >
2018-12-29 22:24:19 +01:00
Source Code
< / a >
2018-12-23 21:26:21 +01:00
< / li >
2019-01-02 23:24:07 +01:00
< li >
2020-07-28 18:39:57 +02:00
< a href = "../survey.html" >
< span class = "fa fa-clipboard-list" > < / span >
2018-12-29 22:24:19 +01:00
2020-07-28 18:39:57 +02:00
Survey
2018-12-29 22:24:19 +01:00
< / a >
< / li >
2018-12-23 21:26:21 +01:00
< / ul >
< / div > <!-- /.nav - collapse -->
< / div > <!-- /.container -->
< / div > <!-- /.navbar -->
2019-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01:00
< / header >
< div class = "row" >
< div class = "col-md-9 contents" >
< div class = "page-header" >
2019-01-27 19:30:40 +01:00
< h1 > AMR plots with < code > ggplot2< / code > < / h1 >
2020-07-08 14:48:06 +02:00
< small class = "dont-index" > Source: < a href = 'https://github.com/msberends/AMR/blob/master/R/ggplot_rsi.R' > < code > R/ggplot_rsi.R< / code > < / a > < / small >
2018-12-23 21:26:21 +01:00
< div class = "hidden name" > < code > ggplot_rsi.Rd< / code > < / div >
< / div >
< div class = "ref-description" >
2020-07-08 14:48:06 +02:00
< p > Use these functions to create bar plots for antimicrobial resistance analysis. All functions rely on < a href = 'https://ggplot2.tidyverse.org/reference/ggplot.html' > ggplot2< / a > functions.< / p >
2018-12-23 21:26:21 +01:00
< / div >
2019-11-28 22:32:17 +01:00
< pre class = "usage" > < span class = 'fu' > ggplot_rsi< / span > (
2020-08-10 12:46:03 +02:00
< span class = 'kw' > data< / span > ,
position = < span class = 'kw' > NULL< / span > ,
x = < span class = 'st' > "antibiotic"< / span > ,
fill = < span class = 'st' > "interpretation"< / span > ,
facet = < span class = 'kw' > NULL< / span > ,
breaks = < span class = 'fu' > < a href = 'https://rdrr.io/r/base/seq.html' > seq< / a > < / span > (< span class = 'fl' > 0< / span > , < span class = 'fl' > 1< / span > , < span class = 'fl' > 0.1< / span > ),
limits = < span class = 'kw' > NULL< / span > ,
translate_ab = < span class = 'st' > "name"< / span > ,
combine_SI = < span class = 'fl' > TRUE< / span > ,
combine_IR = < span class = 'fl' > FALSE< / span > ,
2020-09-18 16:05:53 +02:00
minimum = < span class = 'fl' > 30< / span > ,
2020-08-10 12:46:03 +02:00
language = < span class = 'fu' > < a href = 'translate.html' > get_locale< / a > < / span > (),
nrow = < span class = 'kw' > NULL< / span > ,
colours = < span class = 'fu' > < a href = 'https://rdrr.io/r/base/c.html' > c< / a > < / span > (S = < span class = 'st' > "#61a8ff"< / span > , SI = < span class = 'st' > "#61a8ff"< / span > , I = < span class = 'st' > "#61f7ff"< / span > , IR = < span class = 'st' > "#ff6961"< / span > , R =
2019-11-28 22:32:17 +01:00
< span class = 'st' > "#ff6961"< / span > ),
2020-08-10 12:46:03 +02:00
datalabels = < span class = 'fl' > TRUE< / span > ,
datalabels.size = < span class = 'fl' > 2.5< / span > ,
datalabels.colour = < span class = 'st' > "gray15"< / span > ,
title = < span class = 'kw' > NULL< / span > ,
subtitle = < span class = 'kw' > NULL< / span > ,
caption = < span class = 'kw' > NULL< / span > ,
x.title = < span class = 'st' > "Antimicrobial"< / span > ,
y.title = < span class = 'st' > "Proportion"< / span > ,
< span class = 'kw' > ...< / span >
2019-11-28 22:32:17 +01:00
)
< span class = 'fu' > geom_rsi< / span > (
2020-08-10 12:46:03 +02:00
position = < span class = 'kw' > NULL< / span > ,
x = < span class = 'fu' > < a href = 'https://rdrr.io/r/base/c.html' > c< / a > < / span > (< span class = 'st' > "antibiotic"< / span > , < span class = 'st' > "interpretation"< / span > ),
fill = < span class = 'st' > "interpretation"< / span > ,
translate_ab = < span class = 'st' > "name"< / span > ,
2020-09-18 16:05:53 +02:00
minimum = < span class = 'fl' > 30< / span > ,
2020-08-10 12:46:03 +02:00
language = < span class = 'fu' > < a href = 'translate.html' > get_locale< / a > < / span > (),
combine_SI = < span class = 'fl' > TRUE< / span > ,
combine_IR = < span class = 'fl' > FALSE< / span > ,
< span class = 'kw' > ...< / span >
2019-11-28 22:32:17 +01:00
)
2018-12-23 21:26:21 +01:00
2020-08-10 12:46:03 +02:00
< span class = 'fu' > facet_rsi< / span > (facet = < span class = 'fu' > < a href = 'https://rdrr.io/r/base/c.html' > c< / a > < / span > (< span class = 'st' > "interpretation"< / span > , < span class = 'st' > "antibiotic"< / span > ), nrow = < span class = 'kw' > NULL< / span > )
2018-12-23 21:26:21 +01:00
2020-08-10 12:46:03 +02:00
< span class = 'fu' > scale_y_percent< / span > (breaks = < span class = 'fu' > < a href = 'https://rdrr.io/r/base/seq.html' > seq< / a > < / span > (< span class = 'fl' > 0< / span > , < span class = 'fl' > 1< / span > , < span class = 'fl' > 0.1< / span > ), limits = < span class = 'kw' > NULL< / span > )
2018-12-23 21:26:21 +01:00
2019-11-28 22:32:17 +01:00
< span class = 'fu' > scale_rsi_colours< / span > (
2020-08-10 12:46:03 +02:00
colours = < span class = 'fu' > < a href = 'https://rdrr.io/r/base/c.html' > c< / a > < / span > (S = < span class = 'st' > "#61a8ff"< / span > , SI = < span class = 'st' > "#61a8ff"< / span > , I = < span class = 'st' > "#61f7ff"< / span > , IR = < span class = 'st' > "#ff6961"< / span > , R =
2019-11-28 22:32:17 +01:00
< span class = 'st' > "#ff6961"< / span > )
)
2018-12-23 21:26:21 +01:00
< span class = 'fu' > theme_rsi< / span > ()
2019-11-28 22:32:17 +01:00
< span class = 'fu' > labels_rsi_count< / span > (
2020-08-10 12:46:03 +02:00
position = < span class = 'kw' > NULL< / span > ,
x = < span class = 'st' > "antibiotic"< / span > ,
translate_ab = < span class = 'st' > "name"< / span > ,
2020-09-18 16:05:53 +02:00
minimum = < span class = 'fl' > 30< / span > ,
language = < span class = 'fu' > < a href = 'translate.html' > get_locale< / a > < / span > (),
2020-08-10 12:46:03 +02:00
combine_SI = < span class = 'fl' > TRUE< / span > ,
combine_IR = < span class = 'fl' > FALSE< / span > ,
datalabels.size = < span class = 'fl' > 3< / span > ,
datalabels.colour = < span class = 'st' > "gray15"< / span >
2019-11-28 22:32:17 +01:00
)< / pre >
2019-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01: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 > data< / th >
2020-09-18 16:05:53 +02:00
< td > < p > a < a href = 'https://rdrr.io/r/base/data.frame.html' > data.frame< / a > with column(s) of class < code > < a href = 'as.rsi.html' > rsi< / a > < / code > (see < code > < a href = 'as.rsi.html' > as.rsi()< / a > < / code > )< / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< tr >
< th > position< / th >
2019-11-10 12:16:56 +01:00
< td > < p > position adjustment of bars, either < code > "fill"< / code > , < code > "stack"< / code > or < code > "dodge"< / code > < / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< tr >
< th > x< / th >
2019-06-13 14:28:46 +02:00
< td > < p > variable to show on x axis, either < code > "antibiotic"< / code > (default) or < code > "interpretation"< / code > or a grouping variable< / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< tr >
< th > fill< / th >
2019-06-13 14:28:46 +02:00
< td > < p > variable to categorise using the plots legend, either < code > "antibiotic"< / code > (default) or < code > "interpretation"< / code > or a grouping variable< / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< tr >
< th > facet< / th >
2019-06-13 14:28:46 +02:00
< td > < p > variable to split plots by, either < code > "interpretation"< / code > (default) or < code > "antibiotic"< / code > or a grouping variable< / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< tr >
< th > breaks< / th >
< td > < p > numeric vector of positions< / p > < / td >
< / tr >
< tr >
< th > limits< / th >
< td > < p > numeric vector of length two providing limits of the scale, use < code > NA< / code > to refer to the existing minimum or maximum< / p > < / td >
< / tr >
< tr >
< th > translate_ab< / th >
2020-06-25 17:34:50 +02:00
< td > < p > a column name of the < a href = 'antibiotics.html' > antibiotics< / a > data set to translate the antibiotic abbreviations to, using < code > < a href = 'ab_property.html' > ab_property()< / a > < / code > . Use a value< / p > < / td >
2019-05-13 10:10:16 +02:00
< / tr >
< tr >
< th > combine_SI< / th >
2019-05-23 16:58:59 +02:00
< 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-05-13 12:21:57 +02:00
< / tr >
< tr >
< th > combine_IR< / th >
< td > < p > a logical to indicate whether all values of I and R must be merged into one, so the output only consists of S vs. I+R (susceptible vs. non-susceptible). This is outdated, see parameter < code > combine_SI< / code > .< / p > < / td >
2019-05-10 16:44:59 +02:00
< / tr >
2020-09-18 16:05:53 +02:00
< 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-05-10 16:44:59 +02:00
< tr >
< th > language< / th >
2019-11-28 22:32:17 +01:00
< 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("AMR_locale")< / a > < / code > . Use < code > language = NULL< / code > or < code > language = ""< / code > to prevent translation.< / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< tr >
< th > nrow< / th >
< td > < p > (when using < code > facet< / code > ) number of rows< / p > < / td >
< / tr >
2019-05-31 20:25:57 +02:00
< tr >
< th > colours< / th >
2019-11-28 22:32:17 +01:00
< td > < p > a named vector with colours for the bars. The names must be one or more of: S, SI, I, IR, R or be < code > FALSE< / code > to use default [ggplot2][< code > < a href = 'https://ggplot2.tidyverse.org/reference/ggplot.html' > ggplot2::ggplot()< / a > < / code > colours.< / p > < / td >
2019-05-31 20:25:57 +02:00
< / tr >
2018-12-23 21:26:21 +01:00
< tr >
< th > datalabels< / th >
2019-11-28 22:32:17 +01:00
< td > < p > show datalabels using < code > labels_rsi_count()< / code > < / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< tr >
< th > datalabels.size< / th >
< td > < p > size of the datalabels< / p > < / td >
< / tr >
< tr >
< th > datalabels.colour< / th >
< td > < p > colour of the datalabels< / p > < / td >
< / tr >
2019-05-31 20:25:57 +02:00
< tr >
< th > title< / th >
< td > < p > text to show as title of the plot< / p > < / td >
< / tr >
< tr >
< th > subtitle< / th >
< td > < p > text to show as subtitle of the plot< / p > < / td >
< / tr >
< tr >
< th > caption< / th >
< td > < p > text to show as caption of the plot< / p > < / td >
< / tr >
< tr >
< th > x.title< / th >
< td > < p > text to show as x axis description< / p > < / td >
< / tr >
< tr >
< th > y.title< / th >
< td > < p > text to show as y axis description< / p > < / td >
< / tr >
2018-12-23 21:26:21 +01:00
< tr >
< th > ...< / th >
2019-11-28 22:32:17 +01:00
< td > < p > other parameters passed on to < code > geom_rsi()< / code > < / p > < / td >
2018-12-23 21:26:21 +01:00
< / tr >
< / table >
2019-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01:00
< h2 class = "hasAnchor" id = "details" > < a class = "anchor" href = "#details" > < / a > Details< / h2 >
2019-11-28 22:32:17 +01:00
< p > At default, the names of antibiotics will be shown on the plots using < code > < a href = 'ab_property.html' > ab_name()< / a > < / code > . This can be set with the < code > translate_ab< / code > parameter. See < code > < a href = 'count.html' > count_df()< / a > < / code > .< / p > < h3 > The functions< / h3 >
2019-11-29 19:43:23 +01:00
< p > < code > geom_rsi()< / code > will take any variable from the data that has an < code > < a href = 'as.rsi.html' > rsi< / a > < / code > class (created with < code > < a href = 'as.rsi.html' > as.rsi()< / a > < / code > ) using < code > < a href = 'proportion.html' > rsi_df()< / a > < / code > and will plot bars with the percentage R, I and S. The default behaviour is to have the bars stacked and to have the different antibiotics on the x axis.< / p >
2019-11-28 22:32:17 +01:00
< p > < code > facet_rsi()< / code > creates 2d plots (at default based on S/I/R) using < code > < a href = 'https://ggplot2.tidyverse.org/reference/facet_wrap.html' > ggplot2::facet_wrap()< / a > < / code > .< / p >
2020-07-08 14:48:06 +02:00
< p > < code > scale_y_percent()< / code > transforms the y axis to a 0 to 100% range using < code > < a href = 'https://ggplot2.tidyverse.org/reference/scale_continuous.html' > ggplot2::scale_y_continuous()< / a > < / code > .< / p >
< p > < code > scale_rsi_colours()< / code > sets colours to the bars: pastel blue for S, pastel turquoise for I and pastel red for R, using < code > < a href = 'https://ggplot2.tidyverse.org/reference/scale_manual.html' > ggplot2::scale_fill_manual()< / a > < / code > .< / p >
2019-11-28 22:32:17 +01:00
< p > < code > theme_rsi()< / code > is a [ggplot2 theme][< code > < a href = 'https://ggplot2.tidyverse.org/reference/theme.html' > ggplot2::theme()< / a > < / code > with minimal distraction.< / p >
2020-07-08 14:48:06 +02:00
< p > < code > labels_rsi_count()< / code > print datalabels on the bars with percentage and amount of isolates using < code > < a href = 'https://ggplot2.tidyverse.org/reference/geom_text.html' > ggplot2::geom_text()< / a > < / code > .< / p >
2019-11-28 22:32:17 +01:00
< p > < code > ggplot_rsi()< / code > is a wrapper around all above functions that uses data as first input. This makes it possible to use this function after a pipe (< code > %> %< / code > ). See Examples.< / p >
2020-01-05 17:22:09 +01:00
< h2 class = "hasAnchor" id = "maturing-lifecycle" > < a class = "anchor" href = "#maturing-lifecycle" > < / a > Maturing lifecycle< / h2 >
< p > < img src = 'figures/lifecycle_maturing.svg' style = margin-bottom:5px / > < br / >
2020-07-08 14:48:06 +02:00
The < a href = 'lifecycle.html' > lifecycle< / a > of this function is < strong > maturing< / strong > . The unlying code of a maturing function has been roughed out, but finer details might still change. Since this function needs wider usage and more extensive testing, you are very welcome < a href = 'https://github.com/msberends/AMR/issues' > to suggest changes at our repository< / a > or < a href = 'AMR.html' > write us an email (see section 'Contact Us')< / a > .< / p >
2019-01-02 23:24:07 +01: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-10-13 09:31:58 +02:00
2020-07-28 18:39:57 +02:00
< p > On our website < a href = 'https://msberends.github.io/AMR' > https://msberends.github.io/AMR< / a > you can find < a href = 'https://msberends.github.io/AMR/articles/AMR.html' > a comprehensive tutorial< / a > about how to conduct AMR analysis, the < a href = 'https://msberends.github.io/AMR/reference' > complete documentation of all functions< / a > (which reads a lot easier than here in R) and < a href = 'https://msberends.github.io/AMR/articles/WHONET.html' > an example analysis using WHONET data< / a > . As we would like to better understand the backgrounds and needs of our users, please < a href = 'https://msberends.github.io/AMR/survey.html' > participate in our survey< / a > !< / p >
2018-12-23 21:26:21 +01:00
< h2 class = "hasAnchor" id = "examples" > < a class = "anchor" href = "#examples" > < / a > Examples< / h2 >
2020-08-10 12:46:03 +02:00
< pre class = "examples" > < span class = 'co' > if< / span > (< span class = 'fu' > < a href = 'https://rdrr.io/r/base/library.html' > require< / a > < / span > (< span class = 'st' > < a href = 'http://ggplot2.tidyverse.org' > "ggplot2"< / a > < / span > ) < span class = 'op' > & < / span > < span class = 'fu' > < a href = 'https://rdrr.io/r/base/library.html' > require< / a > < / span > (< span class = 'st' > < a href = 'https://dplyr.tidyverse.org' > "dplyr"< / a > < / span > )) {
2020-05-16 21:40:50 +02:00
< span class = 'co' > # get antimicrobial results for drugs against a UTI:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'fu' > < a href = 'https://ggplot2.tidyverse.org/reference/ggplot.html' > ggplot< / a > < / span > (< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span > < span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > )) < span class = 'op' > +< / span >
2020-05-16 21:40:50 +02:00
< span class = 'fu' > geom_rsi< / span > ()
2020-08-10 12:46:03 +02:00
2020-05-16 21:40:50 +02:00
< span class = 'co' > # prettify the plot using some additional functions:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > df< / span > < span class = 'op' > < -< / span > < span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span > < span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > )
< span class = 'fu' > < a href = 'https://ggplot2.tidyverse.org/reference/ggplot.html' > ggplot< / a > < / span > (< span class = 'kw' > df< / span > ) < span class = 'op' > +< / span >
< span class = 'fu' > geom_rsi< / span > () < span class = 'op' > +< / span >
< span class = 'fu' > scale_y_percent< / span > () < span class = 'op' > +< / span >
< span class = 'fu' > scale_rsi_colours< / span > () < span class = 'op' > +< / span >
< span class = 'fu' > labels_rsi_count< / span > () < span class = 'op' > +< / span >
2020-05-16 21:40:50 +02:00
< span class = 'fu' > theme_rsi< / span > ()
2020-08-10 12:46:03 +02:00
2020-05-16 21:40:50 +02:00
< span class = 'co' > # or better yet, simplify this using the wrapper function - a single command:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > ) < span class = 'op' > %> %< / span >
2020-05-16 21:40:50 +02:00
< span class = 'fu' > ggplot_rsi< / span > ()
2020-08-10 12:46:03 +02:00
2020-05-16 21:40:50 +02:00
< span class = 'co' > # get only proportions and no counts:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > ) < span class = 'op' > %> %< / span >
< span class = 'fu' > ggplot_rsi< / span > (datalabels = < span class = 'fl' > FALSE< / span > )
2020-05-16 21:40:50 +02:00
< span class = 'co' > # add other ggplot2 parameters as you like:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > ) < span class = 'op' > %> %< / span >
< span class = 'fu' > ggplot_rsi< / span > (width = < span class = 'fl' > 0.5< / span > ,
colour = < span class = 'st' > "black"< / span > ,
size = < span class = 'fl' > 1< / span > ,
linetype = < span class = 'fl' > 2< / span > ,
alpha = < span class = 'fl' > 0.25< / span > )
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > ) < span class = 'op' > %> %< / span >
< span class = 'fu' > ggplot_rsi< / span > (colours = < span class = 'fu' > < a href = 'https://rdrr.io/r/base/c.html' > c< / a > < / span > (SI = < span class = 'st' > "yellow"< / span > ))
2020-05-16 21:40:50 +02:00
}
2020-08-10 12:46:03 +02:00
2020-09-29 23:35:46 +02:00
< span class = 'co' > # \donttest{< / span >
2019-11-03 22:41:29 +01:00
2018-12-23 21:26:21 +01:00
< span class = 'co' > # resistance of ciprofloxacine per age group< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/mutate.html' > mutate< / a > < / span > (first_isolate = < span class = 'fu' > < a href = 'first_isolate.html' > first_isolate< / a > < / span > (< span class = 'kw' > .< / span > )) < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/filter.html' > filter< / a > < / span > (< span class = 'kw' > first_isolate< / span > < span class = 'op' > ==< / span > < span class = 'fl' > TRUE< / span > ,
< span class = 'kw' > mo< / span > < span class = 'op' > ==< / span > < span class = 'fu' > < a href = 'as.mo.html' > as.mo< / a > < / span > (< span class = 'st' > "E. coli"< / span > )) < span class = 'op' > %> %< / span >
2020-09-29 23:35:46 +02:00
< span class = 'co' > # `age_groups` is also a function of this AMR package:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/group_by.html' > group_by< / a > < / span > (age_group = < span class = 'fu' > < a href = 'age_groups.html' > age_groups< / a > < / span > (< span class = 'kw' > age< / span > )) < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > age_group< / span > ,
< span class = 'kw' > CIP< / span > ) < span class = 'op' > %> %< / span >
< span class = 'fu' > ggplot_rsi< / span > (x = < span class = 'st' > "age_group"< / span > )
2018-12-23 21:26:21 +01:00
< span class = 'co' > # for colourblind mode, use divergent colours from the viridis package:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > ) < span class = 'op' > %> %< / span >
2020-09-29 23:35:46 +02:00
< span class = 'fu' > ggplot_rsi< / span > () < span class = 'op' > +< / span >
< span class = 'fu' > < a href = 'https://ggplot2.tidyverse.org/reference/scale_viridis.html' > scale_fill_viridis_d< / a > < / span > ()
2019-05-31 20:25:57 +02:00
< span class = 'co' > # a shorter version which also adjusts data label colours:< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > ) < span class = 'op' > %> %< / span >
< span class = 'fu' > ggplot_rsi< / span > (colours = < span class = 'fl' > FALSE< / span > )
2019-01-02 23:24:07 +01:00
2018-12-23 21:26:21 +01:00
< span class = 'co' > # it also supports groups (don't forget to use the group var on `x` or `facet`):< / span >
2020-08-10 12:46:03 +02:00
< span class = 'kw' > example_isolates< / span > < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/select.html' > select< / a > < / span > (< span class = 'kw' > hospital_id< / span > , < span class = 'kw' > AMX< / span > , < span class = 'kw' > NIT< / span > , < span class = 'kw' > FOS< / span > , < span class = 'kw' > TMP< / span > , < span class = 'kw' > CIP< / span > ) < span class = 'op' > %> %< / span >
< span class = 'fu' > < a href = 'https://dplyr.tidyverse.org/reference/group_by.html' > group_by< / a > < / span > (< span class = 'kw' > hospital_id< / span > ) < span class = 'op' > %> %< / span >
< span class = 'fu' > ggplot_rsi< / span > (x = < span class = 'st' > "hospital_id"< / span > ,
facet = < span class = 'st' > "antibiotic"< / span > ,
nrow = < span class = 'fl' > 1< / span > ,
title = < span class = 'st' > "AMR of Anti-UTI Drugs Per Hospital"< / span > ,
x.title = < span class = 'st' > "Hospital"< / span > ,
datalabels = < span class = 'fl' > FALSE< / span > )
2020-09-29 23:35:46 +02:00
< span class = 'co' > # }< / span >
2020-09-18 16:05:53 +02:00
< / pre >
2018-12-23 21:26:21 +01:00
< / div >
2020-04-13 21:09:56 +02:00
< div class = "col-md-3 hidden-xs hidden-sm" id = "pkgdown-sidebar" >
2020-04-17 19:16:30 +02:00
< nav id = "toc" data-toggle = "toc" class = "sticky-top" >
< h2 data-toc-skip > Contents< / h2 >
< / nav >
2018-12-23 21:26:21 +01:00
< / div >
< / div >
2019-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01:00
< footer >
< div class = "copyright" >
2020-01-26 20:38:54 +01:00
< 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/' > Alexander 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 >
2018-12-23 21:26:21 +01:00
< / div >
< div class = "pkgdown" >
2020-08-10 12:46:03 +02:00
< p > Site built with < a href = "https://pkgdown.r-lib.org/" > pkgdown< / a > 1.5.1.9000.< / p >
2018-12-23 21:26:21 +01:00
< / div >
2019-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01:00
< / footer >
< / div >
2019-10-13 09:31:58 +02:00
2018-12-23 21:26:21 +01:00
< / body >
< / html >
2019-10-13 09:31:58 +02:00
