ropensci/rAltmetric

Name: rAltmetric

Owner: rOpenSci

Description: Query and visualize metrics from altmetric.com

Created: 2012-09-28 00:16:41.0

Updated: 2017-09-03 15:55:39.0

Pushed: 2017-06-06 18:50:43.0

Homepage: http://ropensci.github.io/rAltmetric/

Size: 666

Language: R

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Project Status: Active ? The project has reached a stable, usable state and is being actively developed. Build Status


minimal R version CRAN\_Status\_Badge packageversion


Last-changedate

altmetric.com

rAltmetric

Travis-CI Build Status AppVeyor Build Status Coverage Status

This package provides a way to programmatically retrieve altmetrics from various publication types (books, newsletters, articles, peer-reviewed papers and more) from altmetric.com. The package is really simple to use and only has two major functions:

Questions, features requests and issues should go here.

Installing the package ?

A stable version is available from CRAN. To install

all.packages('rAltmetric')
 the ? dev version
ools::install_github("ropensci/rAltmetric")

Quick Tutorial

Obtaining metrics

There was a 2010 paper by Acuna et al that received a lot of attention on Twitter. What was the impact of that paper?

ary(rAltmetric)
a <- altmetrics(doi = "10.1038/465860a")
a
ltmetrics on: "Metrics: Do metrics matter?" with altmetric_id: 385053 published in Nature.
                       stats
ited_by_fbwalls_count      3
ited_by_feeds_count        3
ited_by_gplus_count        2
ited_by_msm_count          1
ited_by_policies_count     1
ited_by_posts_count       31
ited_by_tweeters_count    20
ited_by_accounts_count    30
Data

To obtain the metrics in tabular form for further processing, run any object of class altmetric through altmetric_data() to get a data.frame that can easily be written to disk.

etric_data(acuna)
                       title             doi     pmid
 Metrics: Do metrics matter? 10.1038/465860a 20559361
                                                                       tq1
 Survey of how metrics are used in hiring, promotion and tenure decisions.
                                                                                                 tq2
 Should some professions be excluded from performance metrics? #metrics #kpi #performancemeasurement
                                              tq3
 ?@Nanomedicina: Publications: Do metrics matter?
                                             tq4            altmetric_jid
 Do metrics matter? #oaweek13 (in talk @pgroth ) 4f6fa50a3cf058f610003160
    issns1    issns2 journal cohorts.pub cohorts.sci cohorts.com
 0028-0836 1476-4687  Nature          13           5           2
 context.all.count context.all.mean context.all.rank context.all.pct
           7133716  6.3030007714043           130911              98
 context.all.higher_than context.journal.count context.journal.mean
                 7003174                 44393       68.76030910975
 context.journal.rank context.journal.pct context.journal.higher_than
                10546                  76                       33847
 context.similar_age_3m.count context.similar_age_3m.mean
                        76598              5.330816089403
 context.similar_age_3m.rank context.similar_age_3m.pct
                        1082                         98
 context.similar_age_3m.higher_than context.similar_age_journal_3m.count
                              75516                                  894
 context.similar_age_journal_3m.mean context.similar_age_journal_3m.rank
                     54.580732362822                                 262
 context.similar_age_journal_3m.pct
                                 70
 context.similar_age_journal_3m.higher_than type altmetric_id schema
                                        632 news       385053  1.5.4
 is_oa cited_by_fbwalls_count cited_by_feeds_count cited_by_gplus_count
 FALSE                      3                    3                    2
 cited_by_msm_count cited_by_policies_count cited_by_posts_count
                  1                       1                   31
 cited_by_tweeters_count cited_by_accounts_count last_updated  score
                      20                      30   1454625692 53.388
 history.1y history.6m history.3m history.1m history.1w history.6d
          0          0          0          0          0          0
 history.5d history.4d history.3d history.2d history.1d history.at
          0          0          0          0          0     53.388
                               url   added_on published_on subjects
 http://dx.doi.org/10.1038/465860a 1317207766   1276646400  science
 scopus_subjects readers.citeulike readers.mendeley readers.connotea
         General                 3              303                2
 readers_count
           308
                                                               images.small
 https://altmetric-badges.a.ssl.fastly.net/?size=64&score=54&types=mbtttfdg
                                                               images.medium
 https://altmetric-badges.a.ssl.fastly.net/?size=100&score=54&types=mbtttfdg
                                                                images.large
 https://altmetric-badges.a.ssl.fastly.net/?size=180&score=54&types=mbtttfdg
                                             details_url
 http://www.altmetric.com/details.php?citation_id=385053

You can save these data into a clean spreadsheet format:

a_data <- altmetric_data(acuna)
r::write_csv(acuna_data, path = 'acuna_altmetrics.csv')

Gathering metrics for many DOIs

For a real world use-case, one might want to get metrics on multiple publications. If so, just read them from a spreadsheet and llply through them like the example below.

ary(rAltmetric)
ary(magrittr)

ttaching package: 'magrittr'
he following object is masked from 'package:purrr':

   set_names
he following object is masked from 'package:tidyr':

   extract
ary(purrr)


<- list(c(
0.1038/nature09210",
0.1126/science.1187820",
0.1016/j.tree.2011.01.009",
0.1086/664183"


<- function(x)  altmetrics(doi = x) %>% altmetric_data()

lts <- pmap_df(ids, alm)
is results in a data.frame with one row per identifier.
Further reading

? To cite package rAltmetric in publications use:

rthik Ram (2017). rAltmetric: Retrieves altmerics data for any
blished paper from altmetrics.com. R package version 0.7.
tp://CRAN.R-project.org/package=rAltmetric

bTeX entry for LaTeX users is

anual{,
title = {rAltmetric: Retrieves altmerics data for any published paper from
etrics.com},
author = {Karthik Ram},
year = {2017},
note = {R package version 0.7},
url = {http://CRAN.R-project.org/package=rAltmetric},


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.