P281424/AMR
1
0
Fork 0
mirror of https://github.com/msberends/AMR.git synced 2024-12-27 06:46:12 +01:00
Code Releases Activity
1fa3fc6af2
AMR/docs/reference/as.disk.html

256 lines
14 KiB
HTML
Raw Normal View History

new antibiotics
2019-05-10 16:44:59 +02:00
<!DOCTYPE html>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><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>Transform Input to Disk Diffusion Diameters — as.disk • 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"><!-- jquery --><script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script><!-- Bootstrap --><link href="https://cdnjs.cloudflare.com/ajax/libs/bootswatch/3.4.0/flatly/bootstrap.min.css" rel="stylesheet" crossorigin="anonymous"><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><!-- bootstrap-toc --><link rel="stylesheet" href="../bootstrap-toc.css"><script src="../bootstrap-toc.js"></script><!-- Font Awesome icons --><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"><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- headroom.js --><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><!-- pkgdown --><link href="../pkgdown.css" rel="stylesheet"><script src="../pkgdown.js"></script><link href="../extra.css" rel="stylesheet"><script src="../extra.js"></script><meta property="og:title" content="Transform Input to Disk Diffusion Diameters — as.disk"><meta property="og:description" content="This transforms a vector to a new class disk, which is a disk diffusion growth zone size (around an antibiotic disk) in millimetres between 6 and 50."><meta property="og:image" content="https://msberends.github.io/AMR/logo.png"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:creator" content="@msberends"><meta name="twitter:site" content="@univgroningen"><!-- 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]>
new antibiotics
2019-05-10 16:44:59 +02:00
<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>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<![endif]--></head><body data-spy="scroll" data-target="#toc">
new antibiotics
2019-05-10 16:44:59 +02:00
<div class="container template-reference-topic">
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<header><div class="navbar navbar-default navbar-fixed-top" role="navigation">
new antibiotics
2019-05-10 16:44:59 +02:00
<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>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">1.7.1.9058</span>
new antibiotics
2019-05-10 16:44:59 +02:00
</span>
</div>
<div id="navbar" class="navbar-collapse collapse">
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<ul class="nav navbar-nav"><li>
new antibiotics
2019-05-10 16:44:59 +02:00
<a href="../index.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-home"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Home
</a>
</li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-question-circle"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
How to
<span class="caret"></span>
</a>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<ul class="dropdown-menu" role="menu"><li>
new antibiotics
2019-05-10 16:44:59 +02:00
<a href="../articles/AMR.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-directions"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Conduct AMR analysis
</a>
</li>
<li>
<a href="../articles/resistance_predict.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-dice"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Predict antimicrobial resistance
</a>
(v1.3.0.9006) website update
2020-08-21 11:40:13 +02:00
</li>
<li>
<a href="../articles/datasets.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-database"></span>
(v1.3.0.9006) website update
2020-08-21 11:40:13 +02:00
(v1.3.0.9014) as.mo() speed improvement
2020-09-03 12:31:48 +02:00
Data sets for download / own use
(v1.3.0.9006) website update
2020-08-21 11:40:13 +02:00
</a>
new antibiotics
2019-05-10 16:44:59 +02:00
</li>
(v1.0.1.9005) as.mo() improvements
2020-04-13 21:09:56 +02:00
<li>
<a href="../articles/PCA.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-compress"></span>
(v1.0.1.9005) as.mo() improvements
2020-04-13 21:09:56 +02:00
Conduct principal component analysis for AMR
</a>
</li>
fixes for microorganisms.codes
2019-05-28 16:50:40 +02:00
<li>
<a href="../articles/MDR.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-skull-crossbones"></span>
fixes for microorganisms.codes
2019-05-28 16:50:40 +02:00
Determine multi-drug resistance (MDR)
</a>
</li>
new antibiotics
2019-05-10 16:44:59 +02:00
<li>
<a href="../articles/WHONET.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-globe-americas"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Work with WHONET data
</a>
</li>
<li>
<a href="../articles/SPSS.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-file-upload"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Import data from SPSS/SAS/Stata
</a>
</li>
<li>
<a href="../articles/EUCAST.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-exchange-alt"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Apply EUCAST rules
</a>
</li>
<li>
<a href="../reference/mo_property.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-bug"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Get properties of a microorganism
</a>
</li>
<li>
<a href="../reference/ab_property.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-capsules"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Get properties of an antibiotic
</a>
</li>
<li>
<a href="../articles/benchmarks.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-shipping-fast"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Other: benchmarks
</a>
</li>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</ul></li>
new antibiotics
2019-05-10 16:44:59 +02:00
<li>
(v1.2.0.9037) survey on website
2020-07-28 18:39:57 +02:00
<a href="../reference/index.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-book-open"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Manual
</a>
</li>
<li>
<a href="../authors.html">
(v1.7.1.9022) rely on vctrs for ab selectors
2021-07-23 21:42:11 +02:00
<span class="fa fa-users"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Authors
</a>
</li>
<li>
(v1.2.0.9037) survey on website
2020-07-28 18:39:57 +02:00
<a href="../news/index.html">
(v1.6.0.9021) join functions update
2021-05-12 18:15:03 +02:00
<span class="far fa-newspaper"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Changelog
</a>
</li>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</ul><ul class="nav navbar-nav navbar-right"><li>
<a href="https://github.com/msberends/AMR" class="external-link">
(v1.6.0.9021) join functions update
2021-05-12 18:15:03 +02:00
<span class="fab fa-github"></span>
new antibiotics
2019-05-10 16:44:59 +02:00
Source Code
</a>
</li>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</ul></div><!--/.nav-collapse -->
new antibiotics
2019-05-10 16:44:59 +02:00
</div><!--/.container -->
</div><!--/.navbar -->
(v0.7.1.9106) v0.8.0
2019-10-13 09:31:58 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</header><div class="row">
new antibiotics
2019-05-10 16:44:59 +02:00
<div class="col-md-9 contents">
<div class="page-header">
(v1.5.0.9006) major documentation update
2021-01-18 16:57:56 +01:00
<h1>Transform Input to Disk Diffusion Diameters</h1>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<small class="dont-index">Source: <a href="https://github.com/msberends/AMR/blob/HEAD/R/disk.R" class="external-link"><code>R/disk.R</code></a></small>
new antibiotics
2019-05-10 16:44:59 +02:00
<div class="hidden name"><code>as.disk.Rd</code></div>
</div>
<div class="ref-description">
(v1.3.0.9014) as.mo() speed improvement
2020-09-03 12:31:48 +02:00
<p>This transforms a vector to a new class <code>disk</code>, which is a disk diffusion growth zone size (around an antibiotic disk) in millimetres between 6 and 50.</p>
new antibiotics
2019-05-10 16:44:59 +02:00
</div>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<div id="ref-usage">Usage,<div class="sourceCode"><pre class="sourceCode r"><code><span class="fu">as.disk</span><span class="op">(</span><span class="va">x</span>, na.rm <span class="op">=</span> <span class="cn">FALSE</span><span class="op">)</span>
new antibiotics
2019-05-10 16:44:59 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<span class="va">NA_disk_</span>
(v0.7.1.9106) v0.8.0
2019-10-13 09:31:58 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<span class="fu">is.disk</span><span class="op">(</span><span class="va">x</span><span class="op">)</span></code></pre></div></div>
(v1.7.1.9054) mdro() update - fixes #49, first_isolate() speedup
2021-11-28 23:01:26 +01:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<div id="format">
<h2>Format</h2>
(v1.7.1.9054) mdro() update - fixes #49, first_isolate() speedup
2021-11-28 23:01:26 +01:00
<p>An object of class <code>disk</code> (inherits from <code>integer</code>) of length 1.</p>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</div>
<div id="arguments">
<h2>Arguments</h2>
<dl><dt>x</dt>
<dd><p>vector</p></dd>
<dt>na.rm</dt>
<dd><p>a <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> indicating whether missing values should be removed</p></dd>
</dl></div>
<div id="value">
<h2>Value</h2>
<p>An <a href="https://rdrr.io/r/base/integer.html" class="external-link">integer</a> with additional class <code>disk</code></p>
</div>
<div id="details">
<h2>Details</h2>
<p>Interpret disk values as RSI values with <code><a href="as.rsi.html">as.rsi()</a></code>. It supports guidelines from EUCAST and CLSI.</p>
(v1.7.1.9054) mdro() update - fixes #49, first_isolate() speedup
2021-11-28 23:01:26 +01:00
<p><code>NA_disk_</code> is a missing value of the new <code>&lt;disk&gt;</code> class.</p>
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</div>
<div id="stable-lifecycle">
<h2>Stable Lifecycle</h2>
(v0.9.0.9008) Happy new year! Add lifecycles
2020-01-05 17:22:09 +01:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<p><img src="figures/lifecycle_stable.svg" style="margin-bottom:5px"><br>
The <a href="lifecycle.html">lifecycle</a> of this function is <strong>stable</strong>. In a stable function, major changes are unlikely. This means that the unlying code will generally evolve by adding new arguments; removing arguments or changing the meaning of existing arguments will be avoided.</p>
<p>If the unlying code needs breaking changes, they will occur gradually. For example, an argument will be deprecated and first continue to work, but will emit an message informing you of the change. Next, typically after at least one newly released version on CRAN, the message will be transformed to an error.</p>
</div>
<div id="read-more-on-our-website-">
<h2>Read more on Our Website!</h2>
new antibiotics
2019-05-10 16:44:59 +02:00
(v0.7.1.9106) v0.8.0
2019-10-13 09:31:58 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01: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 data analysis, the <a href="https://msberends.github.io/AMR/reference/">complete documentation of all functions</a> and <a href="https://msberends.github.io/AMR/articles/WHONET.html">an example analysis using WHONET data</a>.</p>
</div>
<div id="see-also">
<h2>See also</h2>
<div class="dont-index"><p><code><a href="as.rsi.html">as.rsi()</a></code></p></div>
</div>
(v0.9.0.9026) update documentation
2020-02-17 14:38:01 +01:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<div id="ref-examples">
<h2>Examples</h2>
<div class="sourceCode"><pre class="sourceCode r"><code><span class="co"># \donttest{</span>
<span class="co"># transform existing disk zones to the `disk` class</span>
<span class="va">df</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/data.frame.html" class="external-link">data.frame</a></span><span class="op">(</span>microorganism <span class="op">=</span> <span class="st">"E. coli"</span>,
AMP <span class="op">=</span> <span class="fl">20</span>,
CIP <span class="op">=</span> <span class="fl">14</span>,
GEN <span class="op">=</span> <span class="fl">18</span>,
TOB <span class="op">=</span> <span class="fl">16</span><span class="op">)</span>
<span class="va">df</span><span class="op">[</span>, <span class="fl">2</span><span class="op">:</span><span class="fl">5</span><span class="op">]</span> <span class="op">&lt;-</span> <span class="fu"><a href="https://rdrr.io/r/base/lapply.html" class="external-link">lapply</a></span><span class="op">(</span><span class="va">df</span><span class="op">[</span>, <span class="fl">2</span><span class="op">:</span><span class="fl">5</span><span class="op">]</span>, <span class="va">as.disk</span><span class="op">)</span>
<span class="co"># same with dplyr:</span>
<span class="co"># df %&gt;% mutate(across(AMP:TOB, as.disk))</span>
<span class="co"># interpret disk values, see ?as.rsi</span>
<span class="fu"><a href="as.rsi.html">as.rsi</a></span><span class="op">(</span>x <span class="op">=</span> <span class="fu">as.disk</span><span class="op">(</span><span class="fl">18</span><span class="op">)</span>,
mo <span class="op">=</span> <span class="st">"Strep pneu"</span>, <span class="co"># `mo` will be coerced with as.mo()</span>
ab <span class="op">=</span> <span class="st">"ampicillin"</span>, <span class="co"># and `ab` with as.ab()</span>
guideline <span class="op">=</span> <span class="st">"EUCAST"</span><span class="op">)</span>
(v1.3.0.9001) website update
2020-08-10 12:46:03 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<span class="fu"><a href="as.rsi.html">as.rsi</a></span><span class="op">(</span><span class="va">df</span><span class="op">)</span>
<span class="co"># }</span>
</code></pre></div>
</div>
new antibiotics
2019-05-10 16:44:59 +02:00
</div>
(v1.0.1.9005) as.mo() improvements
2020-04-13 21:09:56 +02:00
<div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<nav id="toc" data-toggle="toc" class="sticky-top"><h2 data-toc-skip>Contents</h2>
</nav></div>
new antibiotics
2019-05-10 16:44:59 +02:00
</div>
(v0.7.1.9106) v0.8.0
2019-10-13 09:31:58 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<footer><div class="copyright">
<p></p><p>Developed by <a href="https://www.rug.nl/staff/m.s.berends/" class="external-link">Matthijs S. Berends</a>, Christian F. Luz, Dennis Souverein, Erwin E. A. Hassing.</p>
new antibiotics
2019-05-10 16:44:59 +02:00
</div>
<div class="pkgdown">
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
<p></p><p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.0.0.</p>
new antibiotics
2019-05-10 16:44:59 +02:00
</div>
(v0.7.1.9106) v0.8.0
2019-10-13 09:31:58 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</footer></div>
new antibiotics
2019-05-10 16:44:59 +02:00
(v0.7.1.9106) v0.8.0
2019-10-13 09:31:58 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
new antibiotics
2019-05-10 16:44:59 +02:00
(v1.7.1.9058) vars selection for set_ab_names()
2021-12-05 22:06:45 +01:00
</body></html>
(v0.7.1.9106) v0.8.0
2019-10-13 09:31:58 +02:00
Copy Permalink