precompute_heterocitation function

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

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).

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)

Returns

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

Author(s)

Christian Vincenot (christian@vincenot.biz)

Note

Corpus-wide heterocitation values can be computed using heterocitation.

See Also

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)