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
+11-4Lines changed: 11 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@
5
5
6
6
Gene regulatory network reconstruction from pseudotemporal single-cell gene expression data.
7
7
Standalone MATLAB implementation of the SINGE algorithm.
8
-
This code has been tested on MATLAB R2014b and R2018a on Linux and MATLAB R2020a on macOS.
8
+
This code has been tested on MATLAB R2014b and R2018a on Linux, MATLAB R2020a on macOS, and MATLAB R2018a on Windows.
9
9
10
10
The software was formerly called SCINGE and has been renamed **SINGE**.
11
11
@@ -33,13 +33,16 @@ After all GLG tests terminate, the results can be aggregated separately.
33
33
The standalone and parallel modes are accessible in three ways: MATLAB, compiled MATLAB executables with a wrapper Bash script, or Docker.
34
34
35
35
### MATLAB environment
36
-
Running SINGE through MATALB requires the source code in this repository and the [glmnet_matlab package](http://web.stanford.edu/~hastie/glmnet_matlab/download.html) as a dependency.
36
+
Running SINGE through MATLAB requires the source code in this repository and the [glmnet_matlab package](http://web.stanford.edu/~hastie/glmnet_matlab/download.html) as a dependency.
37
37
Unzip `glmnet_matlab.zip` in either the root directory that contains `SINGE_Example.m` or the `code` subdirectory.
38
38
Then use `SINGE.m` to run SINGE in the standalone mode or `SINGE_GLG_Test.m` and `SINGE_Aggregate.m` to run each stage separately.
39
+
SINGE can be run through MATLAB in Linux, macOS, or Windows but may not work in all Windows environments.
40
+
39
41
`SINGE.m` usage:
40
42
```
41
43
SINGE(Data,gene_list,outdir,hyperparameter_file)
42
44
```
45
+
43
46
#### Example
44
47
`SINGE_Example.m` demonstrates a simple example with the hyperparameters specified in `default_hyperparameters.txt`.
45
48
It runs SINGE on `data1/X_SCODE_data.mat` and writes the results to the `Output` directory.
@@ -57,6 +60,10 @@ Starting with release 0.4.1, the compiled executables for macOS are available fr
57
60
Download these executables, untar them with `tar -xf SINGE_mac.tgz`, and place them in the same directory as the wrapper scripts `SINGE.sh`, `run_SINGE_GLG_Test_mac.sh`, and `run_SINGE_Aggregate.sh_mac` from this repository.
58
61
The compiled code has been tested with the R2020a runtime in macOS.
59
62
63
+
#### Windows
64
+
There are no compiled executables for Windows.
65
+
We recommend running SINGE through Docker in Windows if a compatible MATLAB environment is not available.
66
+
60
67
#### Usage
61
68
Bash wrapper script usage:
62
69
```
@@ -146,10 +153,10 @@ The results can be reproduced by providing the same inputs and date from a previ
146
153
## Testing
147
154
The `tests` directory contains test scripts and reference output files to test SINGE.
148
155
149
-
Travis CI is used to run several types of tests in a Linux environment and to deploy a temporary Docker image to DockerHub every time the repository's `master` branch is updated.
156
+
GitHub Actions is used to run several types of tests in a Linux environment and to deploy a temporary Docker image to DockerHub every time the repository's `master` branch is updated.
150
157
The tests build the SINGE Docker image, run SINGE on the example data in multiple ways using Docker, and compare the generated output with the reference output.
151
158
152
-
GitHub Actions is used to test SINGE in a macOS environment.
159
+
GitHub Actions is also used to test SINGE in a macOS environment.
153
160
The tests install the MATLAB runtime, run the compiled SINGE code on the example data, and compare the generated output with the reference output.
154
161
The macOS tests use a more permissive threshold when comparing the generated and reference adjacency matrices due to minor operating system-specific differences in the output.
0 commit comments