precompute_heterocitation: This function precomputes heterocitation values for each...

Description Usage Arguments Value Note Author(s) See Also Examples

View source: R/Diderot.R

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

1
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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
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)

Diderot documentation built on April 19, 2020, 4:16 p.m.