P281424/AMR
1
0
Fork 0
mirror of https://github.com/msberends/AMR.git synced 2025-07-27 15:47:54 +02:00
Code Releases Activity

Built site for AMR: 2.1.1.9008@35963ca

Browse Source
This commit is contained in:
github-actions
2024-02-24 17:58:43 +00:00
parent 1460fadf40
commit 8611815e20
81 changed files with 355 additions and 285 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
reference/AMR-options.html
View File

@ -10,7 +10,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="">2.1.1.9004</small>
<small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">2.1.1.9008</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">
@ -168,17 +168,17 @@
<h2 id="options">Options<a class="anchor" aria-label="anchor" href="#options"></a></h2>
<ul><li><p><code>AMR_custom_ab</code> <br> Allows to use custom antimicrobial drugs with this package. This is explained in <code><a href="add_custom_antimicrobials.html">add_custom_antimicrobials()</a></code>.</p></li>
<li><p><code>AMR_custom_mo</code> <br> Allows to use custom microorganisms with this package. This is explained in <code><a href="add_custom_microorganisms.html">add_custom_microorganisms()</a></code>.</p></li>
<li><p><code>AMR_eucastrules</code> <br> Used for setting the default types of rules for <code><a href="eucast_rules.html">eucast_rules()</a></code> function, must be one or more of: <code>"breakpoints"</code>, <code>"expert"</code>, <code>"other"</code>, <code>"custom"</code>, <code>"all"</code>, and defaults to <code>c("breakpoints", "expert")</code>.</p></li>
<li><p><code>AMR_guideline</code> <br> Used for setting the default guideline for interpreting MIC values and disk diffusion diameters with <code><a href="as.sir.html">as.sir()</a></code>. Can be only the guideline name (e.g., <code>"CLSI"</code>) or the name with a year (e.g. <code>"CLSI 2019"</code>). The default to the latest implemented EUCAST guideline, currently <code>"EUCAST 2023"</code>. Supported guideline are currently EUCAST (2011-2023) and CLSI (2011-2023).</p></li>
<ul><li><p><code>AMR_breakpoint_type</code> <br> A <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a> to use in <code><a href="as.sir.html">as.sir()</a></code>, to indicate which breakpoint type to use. This must be either "ECOFF", "animal", or "human".</p></li>
<li><p><code>AMR_cleaning_regex</code> <br> A <a href="https://rdrr.io/r/base/regex.html" class="external-link">regular expression</a> (case-insensitive) to use in <code><a href="as.mo.html">as.mo()</a></code> and all <code><a href="mo_property.html">mo_*</a></code> functions, to clean the user input. The default is the outcome of <code><a href="as.mo.html">mo_cleaning_regex()</a></code>, which removes texts between brackets and texts such as "species" and "serovar".</p></li>
<li><p><code>AMR_custom_ab</code> <br> A file location to an RDS file, to use custom antimicrobial drugs with this package. This is explained in <code><a href="add_custom_antimicrobials.html">add_custom_antimicrobials()</a></code>.</p></li>
<li><p><code>AMR_custom_mo</code> <br> A file location to an RDS file, to use custom microorganisms with this package. This is explained in <code><a href="add_custom_microorganisms.html">add_custom_microorganisms()</a></code>.</p></li>
<li><p><code>AMR_eucastrules</code> <br> A <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a> to set the default types of rules for <code><a href="eucast_rules.html">eucast_rules()</a></code> function, must be one or more of: <code>"breakpoints"</code>, <code>"expert"</code>, <code>"other"</code>, <code>"custom"</code>, <code>"all"</code>, and defaults to <code>c("breakpoints", "expert")</code>.</p></li>
<li><p><code>AMR_guideline</code> <br> A <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a> to set the default guideline for interpreting MIC values and disk diffusion diameters with <code><a href="as.sir.html">as.sir()</a></code>. Can be only the guideline name (e.g., <code>"CLSI"</code>) or the name with a year (e.g. <code>"CLSI 2019"</code>). The default to the latest implemented EUCAST guideline, currently <code>"EUCAST 2023"</code>. Supported guideline are currently EUCAST (2011-2023) and CLSI (2011-2023).</p></li>
<li><p><code>AMR_ignore_pattern</code> <br> A <a href="https://rdrr.io/r/base/regex.html" class="external-link">regular expression</a> to ignore (i.e., make <code>NA</code>) any match given in <code><a href="as.mo.html">as.mo()</a></code> and all <code><a href="mo_property.html">mo_*</a></code> functions.</p></li>
<li><p><code>AMR_include_PKPD</code> <br> A <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to use in <code><a href="as.sir.html">as.sir()</a></code>, to indicate that PK/PD clinical breakpoints must be applied as a last resort - the default is <code>TRUE</code>.</p></li>
<li><p><code>AMR_ecoff</code> <br> A <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> use in <code><a href="as.sir.html">as.sir()</a></code>, to indicate that ECOFF (Epidemiological Cut-Off) values must be used - the default is <code>FALSE</code>.</p></li>
<li><p><code>AMR_include_screening</code> <br> A <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to use in <code><a href="as.sir.html">as.sir()</a></code>, to indicate that clinical breakpoints for screening are allowed - the default is <code>FALSE</code>.</p></li>
<li><p><code>AMR_keep_synonyms</code> <br> A <a href="https://rdrr.io/r/base/logical.html" class="external-link">logical</a> to use in <code><a href="as.mo.html">as.mo()</a></code> and all <code><a href="mo_property.html">mo_*</a></code> functions, to indicate if old, previously valid taxonomic names must be preserved and not be corrected to currently accepted names. The default is <code>FALSE</code>.</p></li>
<li><p><code>AMR_cleaning_regex</code> <br> A <a href="https://rdrr.io/r/base/regex.html" class="external-link">regular expression</a> (case-insensitive) to use in <code><a href="as.mo.html">as.mo()</a></code> and all <code><a href="mo_property.html">mo_*</a></code> functions, to clean the user input. The default is the outcome of <code><a href="as.mo.html">mo_cleaning_regex()</a></code>, which removes texts between brackets and texts such as "species" and "serovar".</p></li>
<li><p><code>AMR_locale</code> <br> A language to use for the <code>AMR</code> package, can be one of these supported language names or ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (it), Japanese (ja), Norwegian (no), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), or Ukrainian (uk). The default is the current system language (if supported).</p></li>
<li><p><code>AMR_locale</code> <br> A <a href="https://rdrr.io/r/base/character.html" class="external-link">character</a> to set the language for the <code>AMR</code> package, can be one of these supported language names or ISO-639-1 codes: English (en), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Italian (it), Japanese (ja), Norwegian (no), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr), or Ukrainian (uk). The default is the current system language (if supported, English otherwise).</p></li>
<li><p><code>AMR_mo_source</code> <br> A file location for a manual code list to be used in <code><a href="as.mo.html">as.mo()</a></code> and all <code><a href="mo_property.html">mo_*</a></code> functions. This is explained in <code><a href="mo_source.html">set_mo_source()</a></code>.</p></li>
</ul></div>
<div class="section level2">
@ -187,14 +187,14 @@
<p>Settings in <span style="R">R</span> are not saved globally and are thus lost when <span style="R">R</span> is exited. You can save your options to your own <code>.Rprofile</code> file, which is a user-specific file. You can edit it using:</p>
<p></p><div class="sourceCode r"><pre><code><span> <span class="fu">utils</span><span class="fu">::</span><span class="fu"><a href="https://rdrr.io/r/utils/file.edit.html" class="external-link">file.edit</a></span><span class="op">(</span><span class="st">"~/.Rprofile"</span><span class="op">)</span></span></code></pre><p></p></div>
<p>In this file, you can set options such as:</p>
<p>In this file, you can set options such as...</p>
<p></p><div class="sourceCode r"><pre><code><span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">options</a></span><span class="op">(</span>AMR_locale <span class="op">=</span> <span class="st">"pt"</span><span class="op">)</span></span>
<span> <span class="fu"><a href="https://rdrr.io/r/base/options.html" class="external-link">options</a></span><span class="op">(</span>AMR_include_PKPD <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span></span></code></pre><p></p></div>
<p>to add Portuguese language support of antibiotics, and allow PK/PD rules when interpreting MIC values with <code><a href="as.sir.html">as.sir()</a></code>.</p><div class="section">
<p>...to add Portuguese language support of antibiotics, and allow PK/PD rules when interpreting MIC values with <code><a href="as.sir.html">as.sir()</a></code>.</p><div class="section">
<h3 id="share-options-within-team">Share Options Within Team<a class="anchor" aria-label="anchor" href="#share-options-within-team"></a></h3>
<p>For a more global approach, e.g. within a data team, save an options file to a remote file location, such as a shared network drive. This would work in this way:</p><ol><li><p>Save a plain text file to e.g. "X:/team_folder/R_options.R" and fill it with preferred settings.</p></li>
<p>For a more global approach, e.g. within a (data) team, save an options file to a remote file location, such as a shared network drive, and have each user read in this file automatically at start-up. This would work in this way:</p><ol><li><p>Save a plain text file to e.g. "X:/team_folder/R_options.R" and fill it with preferred settings.</p></li>
<li><p>For each user, open the <code>.Rprofile</code> file using <code>utils::file.edit("~/.Rprofile")</code> and put in there:</p>
<p></p><div class="sourceCode r"><pre><code><span> <span class="kw"><a href="https://rdrr.io/r/base/source.html" class="external-link">source</a></span><span class="op">(</span><span class="st">"X:/team_folder/R_options.R"</span><span class="op">)</span></span></code></pre><p></p></div></li>
<li><p>Reload R/RStudio and check the settings with <code><a href="https://rdrr.io/r/base/options.html" class="external-link">getOption()</a></code>, e.g. <code>getOption("AMR_locale")</code> if you have set that value.</p></li>