Diff of /docs/index.html [000000] .. [efa494]

Switch to unified view

a b/docs/index.html
1
<!DOCTYPE html>
2
<!-- Generated by pkgdown: do not edit by hand --><html lang="en">
3
<head>
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<meta charset="utf-8">
6
<meta http-equiv="X-UA-Compatible" content="IE=edge">
7
<meta name="viewport" content="width=device-width, initial-scale=1.0">
8
<title>Targeted Learning with Moderated Statistics for Biomarker Discovery • biotmle</title>
9
<!-- 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/readable/bootstrap.min.css" rel="stylesheet" crossorigin="anonymous">
10
<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">
11
<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">
12
<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">
13
<!-- 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">
14
<script src="pkgdown.js"></script><meta property="og:title" content="Targeted Learning with Moderated Statistics for Biomarker Discovery">
15
<meta property="og:description" content="Tools for differential expression biomarker discovery based on
16
    microarray and next-generation sequencing data that leverage efficient
17
    semiparametric estimators of the average treatment effect for variable
18
    importance analysis. Estimation and inference of the (marginal) average
19
    treatment effects of potential biomarkers are computed by targeted minimum
20
    loss-based estimation, with joint, stable inference constructed across all
21
    biomarkers using a generalization of moderated statistics for use with the
22
    estimated efficient influence function. The procedure accommodates the use
23
    of ensemble machine learning for the estimation of nuisance functions.">
24
<!-- 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]>
25
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
26
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
27
<![endif]-->
28
</head>
29
<body data-spy="scroll" data-target="#toc">
30
    <div class="container template-home">
31
      <header><div class="navbar navbar-default navbar-fixed-top" role="navigation">
32
  <div class="container">
33
    <div class="navbar-header">
34
      <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
35
        <span class="sr-only">Toggle navigation</span>
36
        <span class="icon-bar"></span>
37
        <span class="icon-bar"></span>
38
        <span class="icon-bar"></span>
39
      </button>
40
      <span class="navbar-brand">
41
        <a class="navbar-link" href="index.html">biotmle</a>
42
        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">1.17.0</span>
43
      </span>
44
    </div>
45
46
    <div id="navbar" class="navbar-collapse collapse">
47
      <ul class="nav navbar-nav">
48
<li>
49
  <a href="index.html">
50
    <span class="fas fa-home fa-lg"></span>
51
     
52
  </a>
53
</li>
54
<li>
55
  <a href="reference/index.html">Reference</a>
56
</li>
57
<li class="dropdown">
58
  <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">
59
    Articles
60
     
61
    <span class="caret"></span>
62
  </a>
63
  <ul class="dropdown-menu" role="menu">
64
<li>
65
      <a href="articles/exposureBiomarkers.html">Identifying Biomarkers from an Exposure Variable with `biotmle`</a>
66
    </li>
67
  </ul>
68
</li>
69
      </ul>
70
<ul class="nav navbar-nav navbar-right">
71
<li>
72
  <a href="https://github.com/nhejazi/biotmle/">
73
    <span class="fab fa-github fa-lg"></span>
74
     
75
  </a>
76
</li>
77
      </ul>
78
</div>
79
<!--/.nav-collapse -->
80
  </div>
81
<!--/.container -->
82
</div>
83
<!--/.navbar -->
84
85
      
86
87
      </header><div class="row">
88
  <div class="contents col-md-9">
89
<div id="rbiotmle" class="section level1">
90
<div class="page-header"><h1 class="hasAnchor">
91
<a href="#rbiotmle" class="anchor"></a>R/<code>biotmle</code>
92
</h1></div>
93
94
<blockquote>
95
<p>Targeted Learning with Moderated Statistics for Biomarker Discovery</p>
96
</blockquote>
97
<p><strong>Authors:</strong> <a href="https://nimahejazi.org">Nima Hejazi</a>, <a href="https://vanderlaan-lab.org/about">Mark van der Laan</a>, and <a href="https://hubbard.berkeley.edu">Alan Hubbard</a></p>
98
<hr>
99
<div id="whats-biotmle" class="section level2">
100
<h2 class="hasAnchor">
101
<a href="#whats-biotmle" class="anchor"></a>What’s <code>biotmle</code>?</h2>
102
<p>The <code>biotmle</code> R package facilitates biomarker discovery through a generalization of the moderated t-statistic (Smyth 2004) that extends the procedure to locally efficient estimators of asymptotically linear target parameters (Tsiatis 2007). The set of methods implemented modify targeted maximum likelihood (TML) estimators of statistical (or causal) target parameters (e.g., average treatment effect) to apply variance moderation to the standard variance estimator based on the efficient influence function (EIF) of the target parameter (van der Laan and Rose 2011, 2018). By performing a moderated hypothesis test that pools the individual probe-specific EIF-based variance estimates, a robust variance estimator is constructed, which stabilizes the standard error estimates and improves the performance of such estimators both in smaller samples and in settings where the EIF is poorly estimated. The resultant procedure allows for the construction of conservative hypothesis tests that reduce the false discovery rate and/or the family-wise error rate (Hejazi, van der Laan, and Hubbard 2021). Improvements upon prior TML-based approaches to biomarker discovery (e.g., Bembom et al. (2009)) include both the moderated variance estimator as well as the use of conservative reference distributions for the corresponding moderated test statistics (e.g., logistic distribution), inspired by tail bounds based on concentration inequalities (Rosenblum and van der Laan 2009); the latter prove critical for obtaining robust inference when the finite-sample distribution of the estimator deviates from normality.</p>
103
<hr>
104
</div>
105
<div id="installation" class="section level2">
106
<h2 class="hasAnchor">
107
<a href="#installation" class="anchor"></a>Installation</h2>
108
<p>For standard use, install from <a href="https://bioconductor.org/packages/biotmle">Bioconductor</a> using <a href="https://CRAN.R-project.org/package=BiocManager"><code>BiocManager</code></a>:</p>
109
<div class="sourceCode" id="cb1"><pre class="downlit sourceCode r">
110
<code class="sourceCode R"><span class="kw">if</span> <span class="op">(</span><span class="op">!</span><span class="fu"><a href="https://rdrr.io/r/base/ns-load.html">requireNamespace</a></span><span class="op">(</span><span class="st">"BiocManager"</span>, quietly<span class="op">=</span><span class="cn">TRUE</span><span class="op">)</span><span class="op">)</span> <span class="op">{</span>
111
  <span class="fu"><a href="https://rdrr.io/r/utils/install.packages.html">install.packages</a></span><span class="op">(</span><span class="st">"BiocManager"</span><span class="op">)</span>
112
<span class="op">}</span>
113
<span class="fu">BiocManager</span><span class="fu">::</span><span class="fu"><a href="https://rdrr.io/pkg/BiocManager/man/install.html">install</a></span><span class="op">(</span><span class="st">"biotmle"</span><span class="op">)</span></code></pre></div>
114
<p>To contribute, install the bleeding-edge <em>development version</em> from GitHub via <a href="https://CRAN.R-project.org/package=remotes"><code>remotes</code></a>:</p>
115
<div class="sourceCode" id="cb2"><pre class="downlit sourceCode r">
116
<code class="sourceCode R"><span class="fu">remotes</span><span class="fu">::</span><span class="fu"><a href="https://remotes.r-lib.org/reference/install_github.html">install_github</a></span><span class="op">(</span><span class="st">"nhejazi/biotmle"</span><span class="op">)</span></code></pre></div>
117
<p>Current and prior <a href="https://bioconductor.org">Bioconductor</a> releases are available under branches with numbers prefixed by “RELEASE_”. For example, to install the version of this package available via Bioconductor 3.6, use</p>
118
<div class="sourceCode" id="cb3"><pre class="downlit sourceCode r">
119
<code class="sourceCode R"><span class="fu">remotes</span><span class="fu">::</span><span class="fu"><a href="https://remotes.r-lib.org/reference/install_github.html">install_github</a></span><span class="op">(</span><span class="st">"nhejazi/biotmle"</span>, ref <span class="op">=</span> <span class="st">"RELEASE_3_6"</span><span class="op">)</span></code></pre></div>
120
<hr>
121
</div>
122
<div id="example" class="section level2">
123
<h2 class="hasAnchor">
124
<a href="#example" class="anchor"></a>Example</h2>
125
<p>For details on how to best use the <code>biotmle</code> R package, please consult the most recent <a href="https://bioconductor.org/packages/release/bioc/vignettes/biotmle/inst/doc/exposureBiomarkers.html">package vignette</a> available through the <a href="https://bioconductor.org/packages/biotmle">Bioconductor project</a>.</p>
126
<hr>
127
</div>
128
<div id="issues" class="section level2">
129
<h2 class="hasAnchor">
130
<a href="#issues" class="anchor"></a>Issues</h2>
131
<p>If you encounter any bugs or have any specific feature requests, please <a href="https://github.com/nhejazi/biotmle/issues">file an issue</a>.</p>
132
<hr>
133
</div>
134
<div id="contributions" class="section level2">
135
<h2 class="hasAnchor">
136
<a href="#contributions" class="anchor"></a>Contributions</h2>
137
<p>Contributions are very welcome. Interested contributors should consult our <a href="https://github.com/nhejazi/biotmle/blob/master/CONTRIBUTING.md">contribution guidelines</a> prior to submitting a pull request.</p>
138
<hr>
139
</div>
140
<div id="citation" class="section level2">
141
<h2 class="hasAnchor">
142
<a href="#citation" class="anchor"></a>Citation</h2>
143
<p>After using the <code>biotmle</code> R package, please cite both of the following:</p>
144
<pre><code>    @article{hejazi2017biotmle,
145
      author = {Hejazi, Nima S and Cai, Weixin and Hubbard, Alan E},
146
      title = {biotmle: Targeted Learning for Biomarker Discovery},
147
      journal = {The Journal of Open Source Software},
148
      volume = {2},
149
      number = {15},
150
      month = {July},
151
      year  = {2017},
152
      publisher = {The Open Journal},
153
      doi = {10.21105/joss.00295},
154
      url = {https://doi.org/10.21105/joss.00295}
155
    }
156
157
    @article{hejazi2021generalization,
158
      author = {Hejazi, Nima S and Boileau, Philippe and {van der Laan},
159
        Mark J and Hubbard, Alan E},
160
      title = {A generalization of moderated statistics to data adaptive
161
        semiparametric estimation in high-dimensional biology},
162
      journal={under review},
163
      volume={},
164
      number={},
165
      pages={},
166
      year = {2021+},
167
      publisher={},
168
      doi = {},
169
      url = {https://arxiv.org/abs/1710.05451}
170
    }
171
172
    @manual{hejazi2019biotmlebioc,
173
      author = {Hejazi, Nima S and {van der Laan}, Mark J and Hubbard, Alan
174
        E},
175
      title = {{biotmle}: {Targeted Learning} with moderated statistics for
176
        biomarker discovery},
177
      doi = {10.18129/B9.bioc.biotmle},
178
      url = {https://bioconductor.org/packages/biotmle},
179
      note = {R package version 1.10.0}
180
    }</code></pre>
181
<hr>
182
</div>
183
<div id="related" class="section level2">
184
<h2 class="hasAnchor">
185
<a href="#related" class="anchor"></a>Related</h2>
186
<ul>
187
<li>
188
<a href="https://github.com/nhejazi/biotmleData">R/<code>biotmleData</code></a> - R package with example experimental data for use with this analysis package.</li>
189
</ul>
190
<hr>
191
</div>
192
<div id="funding" class="section level2">
193
<h2 class="hasAnchor">
194
<a href="#funding" class="anchor"></a>Funding</h2>
195
<p>The development of this software was supported in part through grants from the National Institutes of Health: <a href="https://projectreporter.nih.gov/project_info_details.cfm?aid=9260357&amp;map=y">P42 ES004705-29</a> and <a href="https://projectreporter.nih.gov/project_info_description.cfm?aid=9210551&amp;icde=37849782&amp;ddparam=&amp;ddvalue=&amp;ddsub=&amp;cr=1&amp;csb=default&amp;cs=ASC&amp;pball=">R01 ES021369-05</a>.</p>
196
<hr>
197
</div>
198
<div id="license" class="section level2">
199
<h2 class="hasAnchor">
200
<a href="#license" class="anchor"></a>License</h2>
201
<p>© 2016-2021 <a href="https://nimahejazi.org">Nima S. Hejazi</a></p>
202
<p>The contents of this repository are distributed under the MIT license. See file <code>LICENSE</code> for details.</p>
203
<hr>
204
</div>
205
<div id="references" class="section level2">
206
<h2 class="hasAnchor">
207
<a href="#references" class="anchor"></a>References</h2>
208
<div id="refs" class="references">
209
<div id="ref-bembom2009biomarker">
210
<p>Bembom, Oliver, Maya L Petersen, Soo-Yon Rhee, W Jeffrey Fessel, Sandra E Sinisi, Robert W Shafer, and Mark J van der Laan. 2009. “Biomarker Discovery Using Targeted Maximum-Likelihood Estimation: Application to the Treatment of Antiretroviral-Resistant Hiv Infection.” <em>Statistics in Medicine</em> 28 (1): 152–72.</p>
211
</div>
212
<div id="ref-hejazi2021generalization">
213
<p>Hejazi, Nima S, Mark J van der Laan, and Alan E Hubbard. 2021. “A Generalization of Moderated Statistics to Data Adaptive Semiparametric Estimation in High-Dimensional Biology.” <em>Under Review</em>. <a href="https://arxiv.org/abs/1710.05451" class="uri">https://arxiv.org/abs/1710.05451</a>.</p>
214
</div>
215
<div id="ref-rosenblum2009confidence">
216
<p>Rosenblum, Michael A, and Mark J van der Laan. 2009. “Confidence Intervals for the Population Mean Tailored to Small Sample Sizes, with Applications to Survey Sampling.” <em>The International Journal of Biostatistics</em> 5 (1).</p>
217
</div>
218
<div id="ref-smyth2004linear">
219
<p>Smyth, Gordon K. 2004. “Linear Models and Empirical Bayes Methods for Assessing Differential Expression in Microarray Experiments.” <em>Statistical Applications in Genetics and Molecular Biology</em> 3 (1): 1–25. <a href="https://doi.org/10.2202/1544-6115.1027" class="uri">https://doi.org/10.2202/1544-6115.1027</a>.</p>
220
</div>
221
<div id="ref-tsiatis2007semiparametric">
222
<p>Tsiatis, Anastasios. 2007. <em>Semiparametric Theory and Missing Data</em>. Springer Science &amp; Business Media.</p>
223
</div>
224
<div id="ref-vdl2011targeted">
225
<p>van der Laan, Mark J., and Sherri Rose. 2011. <em>Targeted Learning: Causal Inference for Observational and Experimental Data</em>. Springer Science &amp; Business Media.</p>
226
</div>
227
<div id="ref-vdl2018targeted">
228
<p>van der Laan, Mark J, and Sherri Rose. 2018. <em>Targeted Learning in Data Science: Causal Inference for Complex Longitudinal Studies</em>. Springer Science &amp; Business Media.</p>
229
</div>
230
</div>
231
</div>
232
</div>
233
  </div>
234
235
  <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
236
    <div class="links">
237
<h2>Links</h2>
238
<ul class="list-unstyled">
239
<li>Download from BIOC at <br><a href="https://www.bioconductor.org/packages/biotmle">https://​www.bioconductor.org/​packages/​biotmle</a>
240
</li>
241
<li>Browse source code at <br><a href="https://github.com/nhejazi/biotmle/">https://​github.com/​nhejazi/​biotmle/​</a>
242
</li>
243
<li>Report a bug at <br><a href="https://github.com/nhejazi/biotmle/issues">https://​github.com/​nhejazi/​biotmle/​issues</a>
244
</li>
245
</ul>
246
</div>
247
<div class="license">
248
<h2>License</h2>
249
<ul class="list-unstyled">
250
<li><a href="LICENSE.html">Full license</a></li>
251
<li><small><a href="https://opensource.org/licenses/mit-license.php">MIT</a> + file <a href="LICENSE-text.html">LICENSE</a></small></li>
252
</ul>
253
</div>
254
<div class="community">
255
<h2>Community</h2>
256
<ul class="list-unstyled">
257
<li><a href="CONTRIBUTING.html">Contributing guide</a></li>
258
</ul>
259
</div>
260
<div class="citation">
261
<h2>Citation</h2>
262
<ul class="list-unstyled">
263
<li><a href="authors.html">Citing biotmle</a></li>
264
</ul>
265
</div>
266
<div class="developers">
267
<h2>Developers</h2>
268
<ul class="list-unstyled">
269
<li>Nima Hejazi <br><small class="roles"> Author, maintainer, copyright holder </small> <a href="https://orcid.org/0000-0002-7127-2789" target="orcid.widget" aria-label="ORCID"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
270
<li>Alan Hubbard <br><small class="roles"> Author, thesis advisor </small> <a href="https://orcid.org/0000-0002-3769-0127" target="orcid.widget" aria-label="ORCID"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
271
<li>Mark van der Laan <br><small class="roles"> Author, thesis advisor </small> <a href="https://orcid.org/0000-0003-1432-5511" target="orcid.widget" aria-label="ORCID"><span class="fab fa-orcid orcid" aria-hidden="true"></span></a> </li>
272
<li><a href="authors.html">All authors...</a></li>
273
</ul>
274
</div>
275
276
  <div class="dev-status">
277
<h2>Dev status</h2>
278
<ul class="list-unstyled">
279
<li><a href="https://github.com/nhejazi/biotmle/actions"><img src="https://github.com/nhejazi/biotmle/workflows/R-CMD-check/badge.svg" alt="R-CMD-check"></a></li>
280
<li><a href="https://codecov.io/github/nhejazi/biotmle?branch=master"><img src="https://img.shields.io/codecov/c/github/nhejazi/biotmle/master.svg" alt="Coverage Status"></a></li>
281
<li><a href="http://www.repostatus.org/#active"><img src="http://www.repostatus.org/badges/latest/active.svg" alt="Project Status: Active – The project has reached a stable, usable state and is being actively developed."></a></li>
282
<li><a href="https://bioconductor.org/checkResults/release/bioc-LATEST/biotmle"><img src="http://www.bioconductor.org/shields/build/release/bioc/biotmle.svg" alt="BioC status"></a></li>
283
<li><a href="https://bioconductor.org/packages/release/bioc/html/biotmle.html"><img src="http://bioconductor.org/shields/years-in-bioc/biotmle.svg" alt="Bioc Time"></a></li>
284
<li><a href="https://bioconductor.org/packages/release/bioc/html/biotmle.html"><img src="http://bioconductor.org/shields/downloads/biotmle.svg" alt="Bioc Downloads"></a></li>
285
<li><a href="http://opensource.org/licenses/MIT"><img src="http://img.shields.io/badge/license-MIT-brightgreen.svg" alt="MIT license"></a></li>
286
<li><a href="https://zenodo.org/badge/latestdoi/65854775"><img src="https://zenodo.org/badge/65854775.svg" alt="DOI"></a></li>
287
<li><a href="http://joss.theoj.org/papers/02be843d9bab1b598187bfbb08ce3949"><img src="http://joss.theoj.org/papers/02be843d9bab1b598187bfbb08ce3949/status.svg" alt="JOSS Status"></a></li>
288
</ul>
289
</div>
290
</div>
291
</div>
292
293
294
      <footer><div class="copyright">
295
  <p>Developed by Nima Hejazi, Alan Hubbard, Mark van der Laan.</p>
296
</div>
297
298
<div class="pkgdown">
299
  <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.6.1.</p>
300
</div>
301
302
      </footer>
303
</div>
304
305
  
306
307
308
  </body>
309
</html>