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