heterocitation_authors {Diderot}

This function computes heterocitation metrics for authors

Description

This function computes heterocitation metrics for authors. The heterocitation share (Sx) and heterocitation balance (Dx) of an author are calculated as the average of these metrics for papers published by this author within the given time window. See the man page of heterocitation for definitions of heterocitation metrics.

Usage

heterocitation_authors(gr, infLimitYear, supLimitYear, pub_threshold = 0, 
                       remove_orphans = F, remove_citations_to_joint_papers = F)

Arguments

gr

Citation graph priorly preprocessed with precompute_heterocitation

infLimitYear

Start year of the time window considered (included)

supLimitYear

End year of the time window considered (*excluded*)

pub_threshold

Minimum number of publications for authors to be considered.

remove_orphans

Do not consider publications that do not cite any other paper in the dataset (i.e. orphan nodes in the citation network)

remove_citations_to_joint_papers

Do not consider publications belonging to both corpora in the authors' average corpus calculation.

Value

Returns a data frame containing author name ("Authors"), number of publications ("NbPubs"), list of publication years ("Years"), list of publications corpora ("Corpus"), list of publication heterocitation share ("Sx"), list of publication heterocitation balance ("Dx"), average heterocitation share ("avgSx"), average heterocitation balance ("avgDx"), average corpus value of publications ("avgCorpus"), regression coefficient of the heterocitation share evolution ("coeffSx"), regression coefficient of the heterocitation balance evolution ("coeffDx"), regression coefficient of the evolution of the corpus value of publications ("coeffCorpus").

Note

precompute_heterocitation should be called before running this function.

Author(s)

Christian Vincenot ([e-mail])

See Also

precompute_heterocitation, heterocitation

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)

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

# Author heterocitation
heterocitation_authors(gr, 1990, 2018)