Package 'RAT'

Title: Research Assessment Tools
Description: Includes algorithms to assess research productivity and patterns, such as the h-index and i-index. Cardoso et al. (2022) Cardoso, P., Fukushima, C.S. & Mammola, S. (2022) Quantifying the internationalization and representativeness in research. Trends in Ecology and Evolution, 37: 725-728.
Authors: Pedro Cardoso [aut, cre], Stefano Mammola [aut]
Maintainer: Pedro Cardoso <[email protected]>
License: GPL-3
Version: 0.3.1
Built: 2024-12-16 06:39:13 UTC
Source: CRAN

Help Index


biblio file for testing.

Description

A dataset from Web of Science, exported as tab delimited text, full record.

Usage

data(biblio)

Format

A data.frame with bibliographical data.


H-index.

Description

Calculates the h-index.

Usage

h.index(biblio, fulldata = FALSE)

Arguments

biblio

A data.frame exported from Web of Science as tab delimited text, full record.

fulldata

if TRUE returns publication and citation counts.

Details

The h-index is a measure of scientific output calculated as the h number of papers with more than h citations (Hirsch, 2005).

Value

The h-index value. If fulldata = TRUE a list with full data.

References

Hirsch, J.E. (2005). An index to quantify an individual's scientific research output. PNAS, 102: 16569–16572. doi:10.1073/pnas.0507655102.

Examples

data(biblio)
h.index(biblio)
h.index(biblio, TRUE)

I-index.

Description

Calculates the i-index (internationalization).

Usage

i.index(
  biblio,
  r = FALSE,
  h = FALSE,
  homeCountry = NULL,
  logbase = 2,
  fulldata = FALSE
)

Arguments

biblio

A data.frame exported from Web of Science as tab delimited text, full record OR a vector with country frequencies where names are the country names.

r

if TRUE the i-index is multiplied by the r-index, i.e., weighted according to the expected distribution of GDP values of collaborating countries.

h

if TRUE the i-index is divided by the h-index to create a measure independent of the latter. In such case 'biblio' must come from WoS.

homeCountry

A character string specifying the country of origin of the researcher to calculate the r-index if r = TRUE. Look at map$country for the complete list. If NULL, the country with most hits in Web of Science is used.

logbase

The log base for building the octaves of the r-index if r = TRUE.

fulldata

if TRUE returns publication and citation counts.

Details

The i-index (internationalization) is a measure of scientific collaborations across countries. Calculated as the i number of co-author countries in more than i papers (Cardoso et al. 2022). The weighted version of the index multiplies its raw value by the square rooted difference between observed and expected distribution of GDP per capita of countries constituting the index (function RAT::represent). The standardized distribution divides the i-index (weighted or not) by the h-index as these two are usually correlated.

Value

The i-index value. If fulldata = TRUE a list with full data.

References

Cardoso, P., Fukushima, C.S. & Mammola, S. (2022) Quantifying the internationalization and representativeness in research. Trends in Ecology and Evolution, 37: 725-728.

Examples

data(biblio)
i.index(biblio)
i.index(biblio, r = TRUE, fulldata = TRUE)
i.index(biblio, r = TRUE, h = TRUE, logbase = 10, fulldata = TRUE)

biblio = c(5, 3, 2, 1)
names(biblio) = c("Finland", "Portugal", "Brazil", "Italy")
i.index(biblio)

Map of international collaboration.

Description

Generates a network of international collaboration.

Usage

i.map(
  biblio,
  homeCountry = NULL,
  ext = c(-180, 180, -55, 90),
  sea.col = "white",
  country.col = "grey",
  country.border.col = "black",
  country.border.tick = 0.3,
  line.curvature = 0.1,
  line.size = 0.8,
  line.alpha = 0.4,
  line.color = "black",
  country.point.color = "white",
  country.point.line = "black",
  country.point.alpha = 0.8,
  country.size.proportional = FALSE,
  country.point.size = 1,
  homeCountry.point.color = "darkgrey",
  homeCountry.point.line = "black",
  homeCountry.point.alpha = 0.8,
  homeCountry.point.size = 5
)

Arguments

biblio

A data.frame exported from Web of Science as tab delimited text, full record OR a vector with country frequencies where names are the country names.

homeCountry

A character string specifying the country of origin of the researcher. Look at map$country for the complete list. If NULL, the country with most hits in Web of Science is used.

ext

extent of the bounding box of the map in decimal degrees (minX, maxX, minY, maxY).

sea.col

A character indicating the color of the sea.

country.col

A character indicating the color of the countries in the world.

country.border.col

A character indicating the color of the border among countries.

country.border.tick

An integer value defining the size of the border line among countries.

line.curvature

An integer value defining the curvature of the line connecting the home country with the countries of collaborators.

line.size

An integer value defining the size of the line connecting the home country with the countries of collaborators.

line.alpha

An integer value defining the transparency of the line connecting the home country with the countries of collaborators.

line.color

A character indicating the color of the line connecting the home country with the countries of collaborators.

country.point.color

A character indicating the color of the vertex representing each country.

country.point.line

A character indicating the color of line of the vertex representing each country.

country.point.alpha

An integer value defining the transparency of the vertex representing each country.

country.size.proportional

Logical. If TRUE, the size of each country is proportional to the number of collaborations.

country.point.size

An integer value defining the size of vertex representing each country. Ignored if country.size.proportional = TRUE.

homeCountry.point.color

A character indicating the color of the vertex representing the home country.

homeCountry.point.line

A character indicating the color of the line of the vertex representing the home country.

homeCountry.point.alpha

An integer value defining the transparency of the vertex representing the home country.

homeCountry.point.size

An integer value defining the size of vertex representing the home country.

Details

The network connects the researcher with all their collaborators.

Value

A map with the network of collaborations.

Examples

data(biblio)
i.map(biblio, country.size.proportional = TRUE)

biblio = c(5, 3, 2, 1)
names(biblio) = c("Finland", "Portugal", "Brazil", "Italy")
i.map(biblio)

Matrix matching country names, coordinates and GDP.

Description

A dataset that links author countries with the map using the coordinates and with GDP per capita. Current GDP values are for 2020 (World Bank data: https://data.worldbank.org/indicator/NY.GDP.PCAP.PP.CD)

Usage

data(map)

Format

A data.frame with countries and corresponding coordinates.


R-index.

Description

Calculates the r-index (representativeness).

Usage

r.index(biblio, homeCountry = NULL, logbase = 2, plot = FALSE)

Arguments

biblio

A data.frame exported from Web of Science as tab delimited text, full record OR a vector with country frequencies where names are the country names.

homeCountry

A character string specifying the country of origin of the researcher. Look at map$country for the complete list. If NULL, the country with most hits in Web of Science is used.

logbase

The log base for building the octaves.

plot

plots the expected and observed distribution of collaborations according to GDP.

Details

The r-index (representativeness) is a measure of the overlap between observed and expected distributions of GDP per capita of collaborating countries (Cardoso et al. 2022). The abundance distribution of log(GDP per capita) of countries in the collaborators list is calculated (using octaves). This is compared with the global distribution of GDPs by using the overlap of both lists.

Value

The r-index value.

References

Cardoso, P., Fukushima, C.S. & Mammola, S. (2022) Quantifying the internationalization and representativeness in research. Trends in Ecology and Evolution, 37: 725-728.

Examples

data(biblio)
r.index(biblio)
r.index(biblio, plot = TRUE)

biblio = c(5, 3, 2, 1)
names(biblio) = c("Finland", "Portugal", "Brazil", "Italy")
r.index(biblio, plot = TRUE)