precompute_heterocitation {Diderot} R Documentation

## This function precomputes heterocitation values for each node/publication of a graph.

### Description

This function computes heterocitation values for each publication and stores them as node attributes in the graph. The heterocitation share of a publication belonging to corpus A is defined as the percentage of citations to publications belonging to corpus B (or A|B) in its reference list (e.g. a value of 0.2 for a publication in corpus A indicates that the publication cites only 20% of papers from corpus B). The heterocitation balance metric, on the other hand, takes into consideration the respective sizes of corpus A and B to discern how much the heterocitation share deviates from values expected in the case of well-mixedness (i.e. if A and B originated from a unique community; e.g. a value of -30% for a publication in corpus A indicates that it cites papers from corpus B 30% less frequently than expected).

### Usage

precompute_heterocitation(gr, labels, infLimitYear, supLimitYear)


### Arguments

 gr Citation graph labels Labels (i.e. names) of the two corpora featured in the graph. infLimitYear Start year of the time window considered (included) supLimitYear End year of the time window considered (*excluded*)

### Value

Returns the graph gr with added node attributes Sx and Dx representing the heterocitation share and heterocitation balance respectively.

### Note

Corpus-wide heterocitation values can be computed using heterocitation.

### Author(s)

Christian Vincenot (christian@vincenot.biz)

heterocitation, plot_heterocitation_timeseries, compute_Ji_ranking

### Examples



labels<-c("Corpus1","Corpus2")

# Build a bibliographical dataset from Scopus exports
db<-create_bibliography(corpora_files=c(tempfi1,tempfi2),
labels=labels, keywords=NA)

# Build graph
gr<-build_graph(db=db,small.year.mismatch=TRUE, attrs=c("Corpus","Year","Authors"), nb.cores=1)

gr<-precompute_heterocitation(gr,labels, 1990, 2018)



[Package Diderot version 0.13 Index]