|
Calling Sequence
|
|
LiteratureSearch(searchterms, options)
|
|
Parameters
|
|
|
|
|
|
searchterms
|
-
|
string or list of strings; each string contains a term to be included in the literature search
|
options
|
-
|
(optional) equation(s) of the form option = value where option is one of database, filename, pagesize, prettyprint, resetpage, sortby, sortorder, or source (see section Options for details).
|
|
|
|
|
Description
|
|
•
|
The LiteratureSearch command searches the scientific literature, returning results within Maple.
|
•
|
The parameter searchterms is a string or list of strings where each string contains a term to be included in the literature search. For example, searching for "electron transport" returns articles that contain the exact phrase "electron transport" in any of the searchable fields, i.e. title, author, and abstract. By contrast, searching for ["electron","transport"] discovers articles that have "electron" and "transport" separately but not necessarily together in one of the fields.
|
•
|
LiteratureSearch returns text containing the total number of articles found, the page number, and the article data for each of the page's entries. The article data includes: title, author, abstract, journal, first publication date, and URL. The number of entries per page is controlled by the keyword pagesize whose default value is 10. Upon re-executing LiteratureSearch without changing its input parameters, the command will return the next page. To return to the first page, the user can set the optional boolean keyword resetpage to true. The output can also be duplicated in a file by using the keyword filename to set the path and filename.
|
•
|
The command can search two databases: EuropePMC (default) and arXiv. The searched database can be changed by setting the keyword database to "EuropePMC" or "arXiv" respectively. The EuropePMC database contains more than 40 million science articles and preprints including the complete PubMed and PubMed Central collections. The arXiv database includes physics preprints from quantum physics to chemical physics and biophysics.
|
•
|
The keyword source is a string or list of strings that allows the user to specify the search field for each term in searchterms. The allowed sources are: "ti","au","abs","jr","id", and "all". The "ti", "au", "abs", and "jr" represent title, author, abstract, and journal fields. The "id" is the doi (for EuropePMC) or arXiv id (for arXiv). The "all" (default) indicates that all available fields will be searched. The source list must match the length of the list in searchterms.
|
•
|
The keyword sortby is a string indicating whether the articles should be sorted by relevance, date, or number of citations. For EuropePMC the options are: "relevance" (default), "date", and "cited". For arXiv the options are "date" (default), "relevance", "lastUpdatedDate", and "submittedDate" where "date" is equivalent to "lastUpdatedDate".
|
•
|
The keyword sortorder is a string indicating whether the entries are sorted in descending or ascending order with respect to the criterion set by the keyword sortby. The keyword options are: "descending" (default) or "ascending".
|
|
|
Options
|
|
|
|
|
|
•
|
database = string -- a string that selects the database "EuropePMC" (default) or "arXiv".
|
•
|
filename = string -- a string that optionally sets the filename to which the search's output to the screen is duplicated; if relevant, the path should be included as part of the filename. The default is no output to a file.
|
•
|
pagesize = posint -- a positive integer that sets the number of entries returned per page.
Default is 10.
|
•
|
prettyprint = truefalse -- when true (default for Worksheet/Document), the output is prettyprinted with the print command; when false (default for Command Line), the output is line printed in a terminal font.
|
•
|
resetpage = true/false -- setting to true resets the output to the first page. Default is false.
|
•
|
sortby = string -- a string indicating whether the articles should be sorted by relevance, date, or number of citations. For EuropePMC the options are: "relevance" (default), "date", and "cited". For arXiv the options are "date" (default), "relevance", "lastUpdatedDate", and "submittedDate" where "date" is equivalent to "lastUpdatedDate".
|
•
|
sortorder = string -- a string indicating whether the entries are sorted in descending or ascending order with respect to the criterion set by the keyword sortby. The keyword options are: "descending" (default) or "ascending".
|
•
|
source = string or list of strings --a string or list of strings that allows the user to specify the search field for each term in searchterms. The allowed sources are: "ti","au","abs","jr","id", and "all". The "ti", "au", "abs", and "jr" represent title, author, abstract, and journal fields. The "id" is the doi (for EuropePMC) or arXiv id (for arXiv). The "all" (default) indicates that all available fields will be searched. The source list must match the length of the list in searchterms.
|
|
|
References
|
|
Europe PMC: https://europepmc.org/
Thank you to arXiv for use of its open access interoperability. This product was not reviewed or approved by, nor does it necessarily express or reflect the policies or opinions of, arXiv.
|
|
Examples
|
|
>
|
|
Let's find articles on the methylation of RNA
>
|
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| (1) |
By default the pagesize is 10 entries per page. Here we selected 2 entries per page to facilitate the demonstration. Upon executing the command again, QCT automatically gives you the next page of entries. The command can be reset to the first page of entries with the keyword resetpage. Search results can be simultaneously printed to the screen and a file with the filename keyword. We can search by keyword, author, and journal separately or all at once. Next let us search the arXiv for the most recently posted preprints on quantum tunneling in molecules.
>
|
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| (2) |
|
|
|