-
Notifications
You must be signed in to change notification settings - Fork 1
/
faq.html
106 lines (86 loc) · 10.1 KB
/
faq.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<title>DateLife</title>
<meta name="keywords" content="" />
<meta name="description" content="" />
<link rel="stylesheet" type="text/css" href="default.css" />
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-33370470-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<div id="upbg"></div>
<div id="outer">
<div id="headerpic"></div>
<div id="menu">
<!-- HINT: Set the class of any menu link below to "active" to make it appear active -->
<ul>
<li><a href="index.html">Home</a></li>
<li><a href="query">Query</a></li>
<li><a href="https://github.com/phylotastic/datelife">Source code</a></li>
<li><a href="faq.html">FAQ</a></li>
<li><a href="contact.html">Contact</a></li>
<li><a href="http://phylotastic.org">Phylotastic</a></li>
<li><a href="citations.html">Citations</a></li>
<li><a href="api.html">API</a></li>
</ul>
</div>
<div id="menubottom"></div>
<div id="content">
<!-- Normal content: Stuff that's not going to be put in the left or right column. -->
<div id="normalcontent">
<div class="contentarea">
<!-- Normal content area start -->
<h2>FAQ</h2>
<br />
<p><b>What can I do with <a href="http://datelife.org">DateLife</a>?</b></p>
<p>You can interact with it as a website to get estimates for the ages of various groups. You can also run automated queries against it. While still in alpha form, the api may change, but you can see what it is at any point by just looking at the URL. For example, searching for a Newick tree for three particular taxa, using only peer-reviewed studies, sends you to this page:
<br /><code><a href="http://datelife.org/cgi-bin/R/result?input=Rhinoceros_unicornis%2CEquus_caballus%2CMus_musculus&format=html&partial=liberal&useembargoed=no&uncertainty=100&usetnrs=no&tnrssource=NCBI">http://datelife.org/cgi-bin/R/result?input=Rhinoceros_unicornis%2CEquus_caballus%2CMus_musculus&format=html&partial=liberal&useembargoed=no&uncertainty=100&usetnrs=no&tnrssource=NCBI</a></code>
<br />You could have a python, perl, or R script call this same URL to get trees back. By changing <code>format=newickmed</code> to <code>format=bestguess</code> you get a single point estimate of the age of the MRCA of the group of taxa, which can be used by other scripts. It's fine to use automated tools to query the site, we just ask that you try not to hit it so frequently as to degrade performance for others (perhaps give it a few seconds between calls, schedule hard use for the middle of the night, etc.). We haven't yet tested at what usage frequency it stops working well. You can download the source code and run it locally, perhaps hacking it for some other purpose. If you reuse in that way, we'd appreciate being cited (citation being the currency of science). If you have an improvement to make, either send us a patch or sign up as a developer (though forking the code is also possible, of course). The main code is R, which is fairly easy to use. We're planning to turn much of the code into an open source standalone R package as well (while also keeping the rest open).</p>
<p><b>Can I watch a movie about it?</b></p>
<p>Here is a presentation we gave at iEvoBio in July, 2012:
<br /><iframe width="420" height="315" src="http://www.youtube.com/embed/xWmLrbUWtyM?rel=0" frameborder="0" allowfullscreen></iframe>
</p>
<p><b>What is next?</b></p>
<p>We are building up the back end database (please send us your published chronograms). We are also investigating incorporating fossil information.</p>
<p><b>What do I cite?</b></p>
<p>First, the papers for the trees and fossils you are using, if possible. It is like citing papers contributing data to GenBank: if you were to analyze one or two datasets, you would cite the papers that generated them; if you were to analyze all the plant rbcl sequences in GenBank, you might not. We also ask that you cite our website (we hope to have a peer-reviewed publication soon to cite instead). If you use the congruification method, you should also cite:
<br />"Congruification: support for time scaling large phylogenetic trees" Eastman, Jonathan M; Harmon, Luke J; Tank, David C (2013) Methods in Ecology and Evolution, In press</p>
<p><b>Who is "we"?</b></p>
<p>Currently, Brian O'Meara, Jonathan Eastman, Tracy Heath, April Wright, Klaus Schliep, Scott Chamberlain, Peter Midford, Luke Harmon, Joseph Brown, Matt Pennell, Mike Alfaro. Maybe you, too?</p>
<p><b>Who paid for this?</b></p>
<p><a href="http://datelife.org">DateLife</a> was developed as part of the <a href="http://phylotastic.org/">Phylotastic</a> hackathon (parts I and II, at NESCent and iPlant, respectively), sponsored by <a href="http://www.nescent.org">NESCent</a>, <a href="http://www.iplantcollaborative.org/">iPlant</a>, and <a href="http://synthesis.eol.org/">BioSynC</a>. <a href="http://www.nescent.org">NESCent</a> is funded by the National Science Foundation (Grant #EF-0905606) and <a href="https://www.gifts.duke.edu/nescent">your donations</a>. <a href="http://www.iplantcollaborative.org/">iPlant</a> is funded by a grant from the National Science Foundation Plant Cyberinfrastructure Program (#DBI-0735191). <a href="http://synthesis.eol.org/">BioSynC</a> is funded by the MacArthur Foundation as well as the National Science Foundation, The J.B. and M.K. Pritzker Family Foundation, The Harris Family foundation and MaryEllen and Richard Keyser, and many more donors. The computing infrastructure behind <a href="http://datelife.org">DateLife</a> was funded by startup funds from the <a href="http://www.utk.edu">U. of Tennessee, Knoxville</a> for <a href="http://www.brianomeara.info">Brian O'Meara</a>.</p>
<p><b>What are the problems with DateLife?</b></p>
<p>The first comes from its very concept: using chronograms to date other chronograms (or sets of taxa). Eventually this can get you far from the original data used, often fossil calibrations, and so errors can be magnified. Trees in the database may not be independent for the same reasons. We suspect that, even with these issues, using chronograms from DateLife may still be better than making up branch lengths (Grafen or uniform) for later analyses, and this is also useful for trees for teaching, but it will nearly always be better to use actual calibrations and chronogram inference. Waiting to publish an analysis until you create your own well-calibrated tree is justifiably the gold standard, and for many researchers, also the minimal standard. There are myriad other issues, such as poor or missing coverage for some groups. There may also be undiscovered errors, or at least biases, in the algorithms used. If you do find any, please let us know; even better, write a patch to fix the problem.</p>
<p><b>Don't you know about <a href="http://www.timetree.org">TimeTree</a>? Why do a new site?</b></p>
<p><a href="http://www.timetree.org"a>TimeTree</a> (Hedges et al., 2006 [<a href="http://kumarlab.net/pdf_new/HedgesKumar06.pdf">PDF</a>]) is a good resource for date information. It has expert-derived dates as well as dates from published trees. It also has a good web interface (for mobile devices, too) and now free <a href="http://itunes.apple.com/us/app/timetree/id372842500?mt=8">iPhone</a> and <a href="http://itunes.apple.com/us/app/timetree-hd/id468820058?mt=8">iPad</a> apps. You can even get free book chapters and poster images or buy a physical book or poster. These are all remarkable tools for outreach and for answering targeted questions. What you may not do is reuse the data in an automated manner (at least when we started our project in June 2012). For example, <a href="http://www.timetree.org"a>TimeTree</a> displays this note (as of June 8, 2012, checked again Jan. 30, 2013):
<br /><center><img src="images/timetreereuse.png"></center>
<br />and the FAQ states (as of June 8, 2012, checked again Jan. 30, 2013):
<br /><center><img src="images/timetreedownload.png"></center></p>
<p>Requests to allow download of the calibrated tree or other widespread reuse have been consistently but politely declined. Reusing existing work makes a great deal of sense, but since this was not possible, we decided to develop our own. It differs from <a href="http://www.timetree.org"a>TimeTree</a> in other ways that we hope are improvements, such as allowing for information about uncertainty from individual studies, but the prohibition on large-scale reuse was really the key issue driving our development.</p>
<p><b>Who is <a href="http://www.nodethirtythree.com/">NodeThirtyThree Design</a>?</b></p>
<p>We have no idea. They make free web design templates with generous reuse licensing but ask for people to cite them. So we have.</p>
<br /><hr>
<p>Note source code is available at <a href="https://github.com/phylotastic/datelife">https://github.com/phylotastic/datelife</a> (the R package with this functionality), <a href="https://github.com/phylotastic/datelifeweb">https://github.com/phylotastic/datelifeweb</a> (the package that generates the web page), and <a href="https://github.com/phylotastic/datelifedocker">https://github.com/phylotastic/datelifedocker</a> (the docker file to create the image).</p>
<br />
<p>DateLife is part of the Phylotastic project, funded by NSF. It uses resources from the Open Tree of Life project, rOpenSci, and TreeBase. To help, please <a href="https://tree.opentreeoflife.org/curator">add trees</a> to OpenTree's database! [they can be yours or others']</p>
<p><center><a href="http://www.nsf.gov"><img src="https://www.nsf.gov/images/logos/nsf1.jpg" width=50 height=50></a></center></p>
<!-- Normal content area end -->
</div>
</div>
</div>
<div id="footer">
<div class="left">Reuse encouraged</div>
<div class="right">Design by <a href="http://www.nodethirtythree.com/">NodeThirtyThree Design</a></div>
</div>
</div>
</body>
</html>