, Matthew Grainger
[ctb], Charles Gray [ctb]| Title: | Perform Forward and Backwards Chasing in Evidence Syntheses |
|---|---|
| Description: | In searching for research articles, we often want to obtain lists of references from across studies, and also obtain lists of articles that cite a particular study. In systematic reviews, this supplementary search technique is known as 'citation chasing': forward citation chasing looks for all records citing one or more articles of known relevance; backward citation chasing looks for all records referenced in one or more articles. Traditionally, this process would be done manually, and the resulting records would need to be checked one-by-one against included studies in a review to identify potentially relevant records that should be included in a review. This package contains functions to automate this process by making use of the Lens.org API. An input article list can be used to return a list of all referenced records, and/or all citing records in the Lens.org database (consisting of PubMed, PubMed Central, CrossRef, Microsoft Academic Graph and CORE; <https://www.lens.org>). |
| Authors: | Neal Haddaway [aut, cre]
, Matthew Grainger
[ctb], Charles Gray [ctb] |
| Maintainer: | Neal Haddaway <[email protected]> |
| License: | GPL (>= 3) |
| Version: | 0.0.4 |
| Built: | 2024-12-07 06:55:46 UTC |
| Source: | CRAN |
This function takes a list of articles in the form of established identifiers (e.g. digital object identifiers) and sends a request to the lens.org API to obtain full citation information from the Lens database for all sought articles.
get_citation( article_list, type = "doi", token = "WCFlpCtuJXYI1sDhZcZ8y7hHpri0SEmTnLNkeU4OEM5JTQRNXB9w" )get_citation( article_list, type = "doi", token = "WCFlpCtuJXYI1sDhZcZ8y7hHpri0SEmTnLNkeU4OEM5JTQRNXB9w" )
article_list |
List of article identifiers for which the reference lists will be returned. Must be a list/vector of identifiers, e.g. '"10.1186/s13750-018-0126-2" "10.1002/jrsm.1378"'. |
type |
Specification of the type of input provided. The default is 'doi' (digital object identifier), but any of the following are accepted: "pmid" (PubMed ID), "pmcid" (PubMed Central ID), "magid" (Microsoft Academic ID), "coreid" (CORE identifier), lens_id" (The Lens.org ID), "title" (article title; much lower specificity). |
token |
An access key for the lens.org API. Tokens can be obtained by applying for scholarly API access and creating a token once approved. See 'https://www.lens.org/lens/user/subscriptions#scholar' for further details. |
A dataframe containing the matching citation from Lens.org.
## Not run: article_list <- c("10.1007/978-3-642-37048-9_13", "10.1111/sum.12030", "10.5194/bg-13-3619-2016", "10.1016/j.agee.2012.09.006") results <- get_citation(article_list) articles <- results$display ## End(Not run)## Not run: article_list <- c("10.1007/978-3-642-37048-9_13", "10.1111/sum.12030", "10.5194/bg-13-3619-2016", "10.1016/j.agee.2012.09.006") results <- get_citation(article_list) articles <- results$display ## End(Not run)
This function takes a list of articles in the form of established identifiers (e.g. digital object identifiers) and sends a request to the lens.org API to firstly identify all cited references in all articles (in the form of lists of lens IDs), and then query these lens IDs to bring back full citation information for all listed records. Deduplicates references to the same records across articles, resulting in an RIS file and a summary report in the console.
get_refs(article_list, type = "doi", get_records, save_object = FALSE, token)get_refs(article_list, type = "doi", get_records, save_object = FALSE, token)
article_list |
List of article identifiers for which the reference lists will be returned. Must be a list/vector of identifiers, e.g. '"10.1186/s13750-018-0126-2" "10.1002/jrsm.1378"'. |
type |
Specification of the type of input provided. The default is 'doi' (digital object identifier), but any of the following are accepted: "pmid" (PubMed ID), "pmcid" (PubMed Central ID), "magid" (Microsoft Academic ID), "coreid" (CORE identifier), lens_id" (The Lens.org ID), "title" (article title; much lower specificity). |
get_records |
Specification of whether to look for records referenced within the input articles ('references'), records citing the input articles ('citations'), or both ('both'). |
save_object |
Option to save the resultant ris file as an object in the Global Environment. The default is FALSE. |
token |
An access key for the lens.org API. Tokens can be obtained by applying for scholarly API access and creating a token once approved. See 'https://www.lens.org/lens/user/subscriptions#scholar' for further details. |
An RIS file is saved to the working directory. A report is printed to the console. If 'save_object=TRUE', the RIS file is returned as an object
## Not run: article_list <- c("10.1007/978-3-642-37048-9_13", "10.1111/sum.12030", "10.5194/bg-13-3619-2016", "10.1016/j.agee.2012.09.006") token <- 'token' refs <- get_refs(article_list, get_records = 'references', token = token) refs ## End(Not run)## Not run: article_list <- c("10.1007/978-3-642-37048-9_13", "10.1111/sum.12030", "10.5194/bg-13-3619-2016", "10.1016/j.agee.2012.09.006") token <- 'token' refs <- get_refs(article_list, get_records = 'references', token = token) refs ## End(Not run)
Function written by lens.org for use of their API.
getLENSData(token, query)getLENSData(token, query)
token |
An access key for the lens.org API. Tokens can be obtained by applying for scholarly API access and creating a token once approved. See 'https://www.lens.org/lens/user/subscriptions#scholar' for further details. |
query |
A search string formulated according to the Lens.org API documentation: 'https://docs.api.lens.org/request-scholar.html'. |
A summary response. The results are viewable using 'content(data, "text")'. Other details regarding the request (e.g. repsonse times) can be accessed through the main output.