-
Notifications
You must be signed in to change notification settings - Fork 2
/
README.Rmd
85 lines (61 loc) · 4.54 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
---
output:
github_document:
toc: false
toc_depth: 3
###
### Bibliography settings
###
bibliography: ./inst/REFERENCES.bib
csl: ./inst/chicago-author-date.csl
suppress-bibliography: false
link-citations: true
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# biblionetwork <img src="man/figures/logo.png" align="right" alt="" width="120" />
<!-- badges: start -->
[](https://cran.r-project.org/package=biblionetwork)
[](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[](https://doi.org/10.5281/zenodo.7677369)
[](https://cran.r-project.org/package=biblionetwork)
[](https://cran.r-project.org/package=biblionetwork)
<!-- badges: end -->
The goal of biblionetwork is to provide functions to create bibliometric networks like bibliographic coupling network, co-citation network and co-authorship network. It identifies edges and calculates the weights according to different methods, depending on the type of networks, the type of nodes, and what you want to analyse. These functions are optimized to be used on very large dataset.
The original function, which uses data.table [@datatable] and allows the user to find edges and calculate weights for large networks, was developed by [François Claveau](https://www.usherbrooke.ca/philosophie/nous-joindre/personnel-enseignant/claveau-francois/). The different functions in this package have been developed, from Claveau's original idea, by [Alexandre Truc](https://sites.google.com/view/alexandre-truc/home-and-contact) and [Aurélien Goutsmedt](https://aurelien-goutsmedt.com/). The package is maintained by Aurélien Goutsmedt.^[Contact: [[email protected]](mailto:[email protected]).]
You can this package from CRAN:
```{r}
# Install release version from CRAN
install.packages("biblionetwork")
```
You can cite this package as:
```{r}
citation("biblionetwork")
```
## Installation
You can install the development version from [GitHub](https://github.com/) with:
``` r
# install.packages("devtools")
devtools::install_github("agoutsmedt/biblionetwork")
```
## Example
The basic function of the package is the `biblio_coupling()` function. This function calculates the number of references that different articles share together, as well as the coupling angle value of edges in a bibliographic coupling network [@sen1983]. What you need is just a file with entities (documents, authors, universities, _etc._) citing references.^[If you want to build a coupling network with entities larger than a document (meaning entities that have published several documents, and thus can cite a reference several times), we rather recommend the use of the `coupling_entity()` function. See the `vignette("Using_biblionetwork")` for examples.] See the `vignette("Using_biblionetwork")` for a more in-depth presentation of the package.
This example use the [data incorporated][Incorporated data] in the package.
```{r coupling angle}
library(biblionetwork)
biblio_coupling(Ref_stagflation,
source = "Citing_ItemID_Ref",
ref = "ItemID_Ref",
normalized_weight_only = FALSE,
weight_threshold = 1)
```
## Incorporated data
The biblionetwork package contains bibliometric data built by @goutsmedt2021a. These data gather the academic articles and books, published between 1975 and 2013, that endeavoured to explain the United States stagflation of the 1970s. They also gather all the references cited by these articles and books on stagflation. The `Nodes_stagflation.rda` file contains information about the academic articles and books on stagflation (the staflation documents), as well as about the references cited at least by two of these stagflation documents. The `Ref_stagflation.rda` is a data frame of direct citations, with the identifiers of citing documents, and the identifiers of cited documents. The `Authors_stagflation.rda` is a data frame with the list of documents explaining the US stagflation, and all the authors of these documents (`Nodes_stagflation.rda` just takes the first author for each document).
## References