You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+20-31Lines changed: 20 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,29 +13,36 @@ This repository provides tools and code to perform social network analysis, gene
13
13
### 1. Data format
14
14
The input data should be in `.csv` format, with one column containing author names. This CSV file can be exported from databases such as PubMed, Scopus, Web of Science, or university research databases.
15
15
16
-
### 2. Clone the repository
17
-
Clone the entire repository to your computer using the `git clone` command or the `GitHub Desktop` application.
16
+
### 2. Install the package
17
+
Installing this package requires an R version >= 4.4.
18
18
19
-
### 3. Ruuning the repository
19
+
Run the following commands in R to install the package:
20
+
```R
21
+
install.packages("pak")
22
+
pak::pkg_install("BioRDM/Network-Analysis")
23
+
```
24
+
25
+
#### For Linux users
26
+
Additional dependencies might be needed. On Debian-based systems, they can be installed with this command:
Ensure that the following libraries are installed on your computer:
23
-
(the list of required packages here.)
31
+
Download the [generate_report.R](https://github.com/BioRDM/Network-Analysis/blob/main/Generate_report.r) script.
24
32
25
-
#### 3.2 Report generating:
26
-
The primary file you will need is `Generate_report.R` . You can run this R script in RStudio or Visual Studio Code. Each function and line of code is well-documented, with instructions and explanations on how to modify it to suit your analysis needs.
33
+
You can run this R script in RStudio or Visual Studio Code. Each function and line of code is well-documented, with instructions and explanations on how to modify it to suit your analysis needs.
27
34
The code includes various filter functions that you may adjust depending on your research questions, such as:
28
35
29
36
- The maximum number of authors per paper in your dataset.
30
37
- The minimum number of papers per author to be included in the analysis.
31
38
- The timeframe (years) you wish to study.
32
39
- Whether to split the analysis into smaller time intervals.
33
40
34
-
#### 3.3 output folder:
41
+
#### 3.3 Output folder:
35
42
After running the code, the output (including figures, PDFs, and additional CSV files) will be saved in a folder named `output`. This folder will be created automatically if it does not already exist.
36
43
If you analyse multiple CSV files, a separate subfolder (under the same name of the csv file) will be created within the output folder for each dataset, containing the relevant results.
37
44
38
-
##### the generated outcomes:
45
+
##### Generated outcomes:
39
46
1. `Report_YYYY_YYYY.pdf`
40
47
This is the main output of the automated code: a PDF report containing the analysis results. It includes a table of contents, detailed interpretations of the findings, and visualisations with captions.
41
48
The corresponding markdown file, `Report_YYYY_YYYY.md`, is also generated.
@@ -59,19 +66,19 @@ If you analyse multiple CSV files, a separate subfolder (under the same name of
59
66
## Repository Contents
60
67
61
68
|---------------- .github
62
-
(Automatically generated folder used for GitHub workflows, such as building PDF files.)
69
+
(Folder for GitHub workflows, for code testing purposes.)
63
70
|---------------- Pure Data
64
71
(Contains datasets extracted from the University of Edinburgh's Research Explorer (Pure))
65
72
|---------------- R
66
73
(Includes all R functions used to generate the analysis outcomes and build the PDF report.)
67
74
|---------------- Trial Analysis
68
75
(Contains datasets from the UOE Explorer (Pure) and RMarkdown files used to develop the code.)
69
76
|---------------- assets
70
-
(Stores additional resources, such as the .tiff file for the font type used in the PDF report.)
77
+
(Stores additional resources, such as the .ttf file for the font type used in the PDF report.)
71
78
|---------------- data
72
79
(Contains datasets from the Centre for Engineering Biology at the University of Edinburgh.)
73
80
|---------------- tests
74
-
(Includes trial datasets and code used during the development and testing of the repository.)
81
+
(Contains unit-tests for the package.)
75
82
|------- .Rbuildignore
76
83
(Specifies files and folders to ignore when building the R package.)
77
84
|-------.gitignore
@@ -94,21 +101,3 @@ If you analyse multiple CSV files, a separate subfolder (under the same name of
94
101
(This file, providing an overview of the repository and instructions for use.)
95
102
96
103
---
97
-
98
-
99
-
### Adding new metrics
100
-
To compute new metrics, edit `src/Interactions_class.r` to add a new method (both functions need to be added):
0 commit comments