Calculate h-index

Computes the h-index for entities at the specified level. An entity has h-index h if h of its works have at least h citations each.

Usage

sm_metric_h_index(
  corpus,
  level = c("author", "institution", "source", "country"),
  self_corrected = FALSE,
  call = rlang::caller_env()
)

Arguments

corpus

An sm_corpus object.

level

Character; the entity level. One of "author" (default), "institution", "source", or "country".

self_corrected

Logical (default FALSE). When TRUE, self-citations identified by sm_self_citation() are removed before computing the index (each work's citation count is reduced by the entity's internal self-citations to it, floored at 0). Only available for "author" and "institution" levels. The corrected index is always <= the uncorrected one.

call

Caller environment for error reporting.

Value

A tibble with columns for the entity ID/name and h_index.

Details

Self-correction uses the corpus's internal reference network (no API calls): citations counted against a work are reduced by those coming from works that share the entity. Because the network is internal to the corpus, this is a lower-bound correction on the global cited_by_count.

See also

sm_self_citation()

Other metrics: sm_metric_collab_index(), sm_metric_disruption(), sm_metric_fnci(), sm_metric_g_index(), sm_metric_m_index(), sm_metric_novelty(), sm_metric_rcr(), sm_self_citation(), sm_summary_authors(), sm_summary_period(), sm_summary_sources(), sm_summary_works()

Examples

corpus <- sm_example_corpus()
sm_metric_h_index(corpus, level = "author")
#> # A tibble: 80 × 2
#>    author_id  h_index
#>    <chr>        <int>
#>  1 A000000001      14
#>  2 A000000032      11
#>  3 A000000042      11
#>  4 A000000013      10
#>  5 A000000038      10
#>  6 A000000015       9
#>  7 A000000020       9
#>  8 A000000022       9
#>  9 A000000036       9
#> 10 A000000045       9
#> # ℹ 70 more rows