Skip to content

Commit 1b9d091

Browse files
committed
Document Windows support
1 parent 49e34da commit 1b9d091

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

README.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
Gene regulatory network reconstruction from pseudotemporal single-cell gene expression data.
77
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.
99

1010
The software was formerly called SCINGE and has been renamed **SINGE**.
1111

@@ -33,13 +33,16 @@ After all GLG tests terminate, the results can be aggregated separately.
3333
The standalone and parallel modes are accessible in three ways: MATLAB, compiled MATLAB executables with a wrapper Bash script, or Docker.
3434

3535
### 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.
3737
Unzip `glmnet_matlab.zip` in either the root directory that contains `SINGE_Example.m` or the `code` subdirectory.
3838
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+
3941
`SINGE.m` usage:
4042
```
4143
SINGE(Data,gene_list,outdir,hyperparameter_file)
4244
```
45+
4346
#### Example
4447
`SINGE_Example.m` demonstrates a simple example with the hyperparameters specified in `default_hyperparameters.txt`.
4548
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
5760
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.
5861
The compiled code has been tested with the R2020a runtime in macOS.
5962

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+
6067
#### Usage
6168
Bash wrapper script usage:
6269
```
@@ -146,10 +153,10 @@ The results can be reproduced by providing the same inputs and date from a previ
146153
## Testing
147154
The `tests` directory contains test scripts and reference output files to test SINGE.
148155

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.
150157
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.
151158

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.
153160
The tests install the MATLAB runtime, run the compiled SINGE code on the example data, and compare the generated output with the reference output.
154161
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.
155162

0 commit comments

Comments
 (0)