-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathabout.html
150 lines (120 loc) · 8.97 KB
/
about.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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link href="custom.css" rel="stylesheet" type="text/css">
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
<title>About Search Workbench</title>
<style>
img {
padding: 1em;
width: 50%;
float: right;
}
li { display: inline-block; }
</style>
<!-- Global Site Tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-433406-10"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'UA-433406-10');
</script>
</head>
<body>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.2/jquery.min.js"></script>
<div class="container">
<div id="topbanner" class="jumbotron">
<h1>About Search Workbench</h1>
<a id="about" class="label label-default" href="index.html">Home</a>
</div>
<div class="row">
<div class="col-sm-7 col-md-7 col-lg-7 aboutleft">
<div class="panel panel-default">
<div class="panel-body">
<h2>Why Search Workbench?</h2>
<p>An extension of the work in <a href="https://esperr.github.io/visualizingpubmed/">
Visualizing PubMed</a>, Search Workbench allows you to examine, edit and visualize your <a href="https://www.ncbi.nlm.nih.gov/pubmed/">PubMed</a> searches. Perhaps most importantly, you can also directly <em>compare</em> searches to one another —
facilitating the process of fine-tuning a search strategy.</p>
<h2>How it works</h2>
<ul>
<li><a href="#editing">Editing your search</a></li> |
<li><a href="#nicknames">Nicknaming a search</a></li> |
<li><a href="#managing">Comparing searches</a></li> |
<li><a href="#saving">Saving and retrieving</a></li> |
<li><a href="#uniques">Unique records</a></li>
</ul>
<p>When you enter a search, it is run against PubMed using the <a href="https://www.ncbi.nlm.nih.gov/books/NBK25501/">programmatic interface</a> maintained by the <a href="https://www.ncbi.nlm.nih.gov/">National Center for Biotechnology Information</a>. You first see how your search
is translated by <a href="https://www.nlm.nih.gov/bsd/disted/pubmedtutorial/020_040.html">Automated Term Mapping</a>. Then you see how the parts of your search relate to one another (using the logic that drives <a href="https://pubvenn.appspot.com/">PubVenn</a>) and how that search performs over time
(via <a href="https://esperr.github.io/pubmed-by-year/">PubMed-by-year</a>).</p>
<h3 id="editing">Editing a search</h3>
<p>Once your search is complete, you can choose to edit it by hand. You can add or subtract terms, Boolean operators and parentheses as well as apply one of several pre-defined search hedges.
<em>Note:</em> there is no validation of this edited search before you run it, so beware of typos, unmatched parentheses and field tags that don't fit.</p>
<h3 id="nicknames">Search nicknames</h3>
<p>If you directly edit a PubMed <a href="https://www.nlm.nih.gov/bsd/disted/pubmedtutorial/020_040.html">translation</a>, you'll notice that even simple searches, such as "diabetes and heart disease", quickly turn into something a bit more ungainly:</p>
<blockquote style="font-size: 90%;">
("diabetes mellitus"[MeSH Terms] OR ("diabetes"[All Fields] AND "mellitus"[All Fields]) OR "diabetes mellitus"[All Fields] OR "diabetes"[All Fields] OR "diabetes insipidus"[MeSH Terms] OR ("diabetes"[All Fields] AND "insipidus"[All Fields]) OR "diabetes insipidus"[All Fields]) AND ("heart diseases"[MeSH Terms] OR ("heart"[All Fields] AND "diseases"[All Fields]) OR "heart diseases"[All Fields] OR ("heart"[All Fields] AND "disease"[All Fields]) OR "heart disease"[All Fields])
</blockquote>
<img src="nickname.PNG" alt="screenshot snippet" />
<p>Using such long strings as search labels makes it difficult to see slight variations in a search. It also makes comparing them on a chart cumbersome.</p>
<p>In these cases, please take advantage of the ability to <em>nickname</em> a search. Choose a name, click "add", and you'll use that nickname for that search going forward
</p>
<h3 id="managing">Managing and comparing searches</h3>
<img src="comp1.PNG" alt="screenshot snippet" />
<p>Once you have two or more searches, you can easily compare them using the tools found underneath "Searches".</p>
<p>Choose the searches you want to compare from a list of ones already performed and select "Compare searches" — you will then see that comparison diagrammed using the same chart-by-year and Venn diagrams seen at the outset.
<em>Note:</em> you can choose as many searches to compare as are needed, though the diagrams can get more cluttered.</p>
<img src="comp2.PNG" alt="screenshot snippet" />
<p>Importantly, you can easily review (or nickname, or delete) any past search by choosing it from the list. Choosing </p>
<br style="clear: both;"/>
<h3 id="saving">Saving or retrieving a session</h3>
<p>If you want to save a session for later, you have the option of saving it locally or to a text file. Local sessions are more convenient to work with, but they are <em>only</em> accessible on the browser/machine where you created them. Text files can be used on any machine (and by any user) that can read them.</p>
<p>You will note the "Load previous session" buttons when you start a session. Just choose the locally saved session (or text file) you want, and you can resume where you left off.</p>
<h3 id="uniques">Seeing unique records</h3>
<p>When you are comparing two or more searches, you can choose "Show unique records" to show those citations that show up in one search, but not in any of the others you are comparing at that moment.</p>
<p>If you have more questions, check out <a href="questionsandanswers.html">the Q&A</a>.</p>
</div>
</div>
</div>
<div class="col-sm-5 col-md-5 col-lg-5">
<div class="panel panel-default">
<div class="panel-body">
<h3>Contact</h3>
<p>PubMed by Year is a project of <a href="https://esperr.github.io/about/">Ed Sperr, M.L.I.S.</a></p>
<p>Ed can be reached at <a href="mailto:ed_sperr@hotmail.com">ed_sperr@hotmail.com</a> or <a href="mailto:esperr@uga.edu">esperr@uga.edu</a>. Please feel free to reach out with any comments or enhancement requests!</p>
</div>
</div>
<div class="panel panel-default">
<div class="panel-body">
<h3>Technologies</h3>
<p>PubMed by Year is put together with <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript">JavaScript</a> and <a href="http://jquery.com/">jQuery</a>. Search translations and counts are fetched with NCBI's <a href="https://www.ncbi.nlm.nih.gov/books/NBK25501/">
Entrez Programming Utilities</a>. NCBI does not yet have an easy way to grab by-year counts for a search (short of launching 50+ calls to the API), so a <a href="https://github.com/esperr/med-by-year">custom webservice</a>
is used.</p>
<p><a href="https://developers.google.com/chart/interactive/docs/gallery/linechart">Google Charts</a> is used to draw the line charts, and Ben Fredrickson's <a href="https://github.com/benfred/venn.js/tree/master">venn.js</a> overlay of Mike Bostock's <a href="https://d3js.org/">d3.js</a>
performs the set visualization. Responsive layout is made easier with <a href="http://getbootstrap.com/">Bootstrap</a>.</p>
<p>You can find the source code for this application at <a href="https://github.com/esperr/search-workbench">GitHub</a>.</p>
<h3>License</h3>
<p>Copyright 2017, Ed Sperr. This software is provided under the terms of the <a href="https://opensource.org/licenses/MIT">MIT License</a>. Feel free to borrow/adapt <a href="https://github.com/esperr/search-workbench">the source code</a> as you wish, but be aware that things strictly adhere
to the XKCD <a href="https://xkcd.com/1513/">Code</a> <a href="https://xkcd.com/1695/">Quality</a> <a href="https://xkcd.com/1833/">Guidelines</a>.</p>
<p>Please note that the information provided here comes ultimately from the <a href="http://www.ncbi.nlm.nih.gov/">National Center for Biotechnology Information</a> and is subject to the terms listed under their
<a href="https://www.ncbi.nlm.nih.gov/home/about/policies/">Disclaimer and Copyright notice</a>.</p>
<p>Feel free to use this tool as you wish, but if you use Search Workbench for publication, I'd appreciate a citation:
</p><blockquote>
Sperr E. Search Workbench [Internet]. 2017 [cited <em>your_date_here</em>]. Available from https://searchworkbench.info/
</blockquote>
</div>
</div>
<div class="panel panel-default">
<div class="panel-body">
<h2>See also...</h2>
<p>Want to have even more fun with MEDLINE visualizations? Check out the full versions of PubVenn and
PubMed by Year as well as other cool tools at <a href="https://esperr.github.io/visualizingpubmed/">
Visualizing PubMed</a>.</p>
</div>
</div>
</div>
</div>
</div>
</body>