iCiteR-usage

The iCiteR package is a minimal R package designed to help users retrieve data from the NIH’s iCite API. There is just one function that will be of interest to most users: get_metrics. This function takes as input a a vector of pubmed IDs and returns all the information yielded by the iCite API.

Likely, most users will already have the PMIDs that correspond to the articles for which they wish to obtain data. For a given article in pubmed, the ID is also printed on the page

The PMID for the Relative Citation Rate paper on Pubmed

The PMID for the Relative Citation Rate paper on Pubmed

For a given PMID(s), one can get the relative citation rate and all other data returned by the iCite API as follows

library(iCiteR)

get_metrics('27599104')
#> No encoding supplied: defaulting to UTF-8.
#>       pmid                          doi
#> 1 27599104 10.1371/journal.pbio.1002541
#>                                                           authors
#> 1 B Ian Hutchins, Xin Yuan, James M Anderson, George M Santangelo
#>   citation_count citations_per_year expected_citations_per_year
#> 1             47           15.66667                    2.930151
#>   field_citation_rate is_research_article    journal nih_percentile
#> 1            6.943039                TRUE PLoS Biol.           94.3
#>   relative_citation_ratio
#> 1                 5.34671
#>                                                                                                             title
#> 1 Relative Citation Ratio (RCR): A New Metric That Uses Citation Rates to Measure Influence at the Article Level.
#>   year
#> 1 2016

The function also takes a vector of PMIDS:

get_metrics(c('27599104', '27830815', '28968388', '28968381'))
#> No encoding supplied: defaulting to UTF-8.
#> No encoding supplied: defaulting to UTF-8.
#> No encoding supplied: defaulting to UTF-8.
#> No encoding supplied: defaulting to UTF-8.
#>       pmid                          doi
#> 1 27599104 10.1371/journal.pbio.1002541
#> 2 27830815              10.1038/539150a
#> 3 28968388 10.1371/journal.pbio.2002536
#> 4 28968381 10.1371/journal.pbio.2003552
#>                                                                                     authors
#> 1                           B Ian Hutchins, Xin Yuan, James M Anderson, George M Santangelo
#> 2                                                                               Gautam Naik
#> 3                    A Cecile J W Janssens, Michael Goodman, Kimberly R Powell, Marta Gwinn
#> 4 B Ian Hutchins, Travis A Hoppe, Rebecca A Meseroll, James M Anderson, George M Santangelo
#>   citation_count citations_per_year expected_citations_per_year
#> 1             47          15.666667                    2.930151
#> 2              5           1.666667                    3.807898
#> 3              4           2.000000                    3.126775
#> 4              1           0.500000                    2.298696
#>   field_citation_rate is_research_article    journal nih_percentile
#> 1            6.943039                TRUE PLoS Biol.           94.3
#> 2            9.204976               FALSE     Nature           23.4
#> 3            8.482253               FALSE PLoS Biol.           34.2
#> 4            6.235857               FALSE PLoS Biol.           10.9
#>   relative_citation_ratio
#> 1                5.346710
#> 2                0.437687
#> 3                0.639637
#> 4                0.217515
#>                                                                                                             title
#> 1 Relative Citation Ratio (RCR): A New Metric That Uses Citation Rates to Measure Influence at the Article Level.
#> 2                                                                     The quiet rise of the NIH's hot new metric.
#> 3                                A critical evaluation of the algorithm behind the Relative Citation Ratio (RCR).
#> 4                          Additional support for RCR: A validated article-level measure of scientific influence.
#>   year
#> 1 2016
#> 2 2016
#> 3 2017
#> 4 2017

If you would rather not have the results in a dataframe, it is possible to obtain an S3 object for the data by using the icite_api function

dat <- icite_api('27599104')
#> No encoding supplied: defaulting to UTF-8.

print(dat)
#> <iCite api/pubs/27599104>
#> List of 13
#>  $ pmid                       : int 27599104
#>  $ doi                        : chr "10.1371/journal.pbio.1002541"
#>  $ authors                    : chr "B Ian Hutchins, Xin Yuan, James M Anderson, George M Santangelo"
#>  $ citation_count             : int 47
#>  $ citations_per_year         : num 15.7
#>  $ expected_citations_per_year: num 2.93
#>  $ field_citation_rate        : num 6.94
#>  $ is_research_article        : logi TRUE
#>  $ journal                    : chr "PLoS Biol."
#>  $ nih_percentile             : num 94.3
#>  $ relative_citation_ratio    : num 5.35
#>  $ title                      : chr "Relative Citation Ratio (RCR): A New Metric That Uses Citation Rates to Measure Influence at the Article Level."
#>  $ year                       : int 2016