Skip to contents

The canonical values of the vocabulary column of corpus$concepts. Readers write these names (for example "author-keywords" for author keywords and "wos-category" for the Web of Science categories), and the functions that select concepts by vocabulary, such as sm_to_bibliometrix() (DE) and sm_network_coword() (field = "keywords"), read them.

Each vocabulary belongs to a family:

  • author_keyword: author-keywords, manual-tags;

  • indexer_keyword: keywords-plus, index-keywords, automatic-tags, mesh;

  • category: wos-category (WC, the Web of Science categories), wos-subject-category (SC, the research areas);

  • concept: openalex, arxiv, biorxiv, medrxiv;

  • custom: custom, for vocabularies of your own.

sm_corpus() and sm_corpus_from_tables() rename legacy and common spellings to these names, with a message: case, white space and the separators -, _, . and / do not matter, "keywords-author", "keyword" and "keywords" become "author-keywords", "medline" becomes "mesh", and the Web of Science field tags "DE", "ID", "WC" and "SC" name their vocabularies. Other values are kept and named in the message. The functions that select concepts by vocabulary read these spellings too, so saved corpora and tables assigned to corpus$concepts work as well. The column stays character.

Usage

sm_concept_vocabularies(describe = FALSE)

Arguments

describe

Logical; if TRUE, return a tibble with the factor columns level and family and a description. If FALSE (default), return the character vector of vocabularies.

Value

A character vector (grouped by family) or a tibble of level/family/description.

Examples

sm_concept_vocabularies()
#>  [1] "author-keywords"      "manual-tags"          "keywords-plus"       
#>  [4] "index-keywords"       "automatic-tags"       "mesh"                
#>  [7] "wos-category"         "wos-subject-category" "openalex"            
#> [10] "arxiv"                "biorxiv"              "medrxiv"             
#> [13] "custom"              
sm_concept_vocabularies(describe = TRUE)
#> # A tibble: 13 × 3
#>    level                family          description                             
#>    <fct>                <fct>           <chr>                                   
#>  1 author-keywords      author_keyword  Keywords chosen by the authors (Web of …
#>  2 manual-tags          author_keyword  Tags added by hand in Zotero.           
#>  3 keywords-plus        indexer_keyword Web of Science Keywords Plus (ID), deri…
#>  4 index-keywords       indexer_keyword Scopus index keywords, assigned by inde…
#>  5 automatic-tags       indexer_keyword Tags Zotero added automatically on impo…
#>  6 mesh                 indexer_keyword Medical Subject Headings from PubMed, D…
#>  7 wos-category         category        Web of Science categories (WC) of the j…
#>  8 wos-subject-category category        Web of Science research areas (SC), bro…
#>  9 openalex             concept         OpenAlex concepts.                      
#> 10 arxiv                concept         arXiv subject categories.               
#> 11 biorxiv              concept         bioRxiv subject categories.             
#> 12 medrxiv              concept         medRxiv subject categories.             
#> 13 custom               custom          A vocabulary defined by the user.       

corpus <- sm_example_corpus(n_works = 5, with_embeddings = FALSE)
table(corpus$concepts$vocabulary)
#> 
#> openalex 
#>       15