About Search Workbench

Home

Why Search Workbench?

An extension of the work in Visualizing PubMed, Search Workbench allows you to examine, edit and visualize your PubMed searches. Perhaps most importantly, you can also directly compare searches to one another — facilitating the process of fine-tuning a search strategy.

How it works

When you enter a search, it is run against PubMed using the programmatic interface maintained by the National Center for Biotechnology Information. You first see how your search is translated by Automated Term Mapping. Then you see how the parts of your search relate to one another (using the logic that drives PubVenn) and how that search performs over time (via PubMed-by-year).

Editing a search

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. Note: 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.

Search nicknames

If you directly edit a PubMed translation, you'll notice that even simple searches, such as "diabetes and heart disease", quickly turn into something a bit more ungainly:

("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])
screenshot snippet

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.

In these cases, please take advantage of the ability to nickname a search. Choose a name, click "add", and you'll use that nickname for that search going forward

Managing and comparing searches

screenshot snippet

Once you have two or more searches, you can easily compare them using the tools found underneath "Searches".

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. Note: you can choose as many searches to compare as are needed, though the diagrams can get more cluttered.

screenshot snippet

Importantly, you can easily review (or nickname, or delete) any past search by choosing it from the list. Choosing


Saving or retrieving a session

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 only 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.

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.

Seeing unique records

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.

If you have more questions, check out the Q&A.

Contact

PubMed by Year is a project of Ed Sperr, M.L.I.S.

Ed can be reached at [email protected] or [email protected]. Please feel free to reach out with any comments or enhancement requests!

Technologies

PubMed by Year is put together with JavaScript and jQuery. Search translations and counts are fetched with NCBI's Entrez Programming Utilities. 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 custom webservice is used.

Google Charts is used to draw the line charts, and Ben Fredrickson's venn.js overlay of Mike Bostock's d3.js performs the set visualization. Responsive layout is made easier with Bootstrap.

You can find the source code for this application at GitHub.

License

Copyright 2017, Ed Sperr. This software is provided under the terms of the MIT License. Feel free to borrow/adapt the source code as you wish, but be aware that things strictly adhere to the XKCD Code Quality Guidelines.

Please note that the information provided here comes ultimately from the National Center for Biotechnology Information and is subject to the terms listed under their Disclaimer and Copyright notice.

Feel free to use this tool as you wish, but if you use Search Workbench for publication, I'd appreciate a citation:

Sperr E. Search Workbench [Internet]. 2017 [cited your_date_here]. Available from https://searchworkbench.info/

See also...

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 Visualizing PubMed.