Skip to content

Commit 04da202

Browse files
committed
made explicit the need to edit the options file in the README
1 parent f85251d commit 04da202

File tree

1 file changed

+15
-10
lines changed

1 file changed

+15
-10
lines changed

README.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,32 @@
11

2+
23
# LipoCLEAN: A machine learning based quality filter for lipid identifications from MS-DIAL
34
There are three ways to install and run LipoCLEAN: as an executable, as a docker container, and as a python package.
45

56
## The executable version
67
This method requires no installation but it is somewhat slower than the other options.
78
1. Download the executable for your operating system, the trained model, and the example options file from the [releases page](https://github.com/stavis1/lipoCLEAN/releases).
89
2. Extract `example_analysis.zip` and `QE_Pro_model.zip` into the same folder. There should be no folders nested under `QE_Pro_model/` and all files from `example_analysis.zip` should be in the top level folder.
9-
3. Run `lipoCLEAN.exe --options example_analysis_options.txt`
10+
3. Run `lipoCLEAN.exe --options example_analysis_options.txt`.
1011
4. The results will be in a folder named `example_output/` the `example_output/QC/` folder contains several plots to assess the quality of the results.
11-
5. If you want a default version of the options file run `lipoCLEAN.exe --print options.txt`
12+
5. If you want a default version of the options file run `lipoCLEAN.exe --print options.txt`.
13+
6. To use the tool on other data edit the `options.txt` file.
1214

1315
On some systems the warning `No module named 'brainpy._c.composition'` will be displayed. This is not an error and does not impact the running of the tool.
1416

15-
## The conda version
16-
To set up the conda environment for the tool:
17+
## The Conda version
18+
To set up the Conda environment for the tool:
1719
1. Download the LipoCLEAN repository and navigate to the `environments` directory.
1820
2. Run `conda env create -p lipo_env --file lipoCLEAN.yml`
1921
3. Run `conda activate ./lipo_env`
2022
4. Navigate to the repository root.
2123
5. Run `pip install .`
22-
7. Download the trained model, and the example options file from the [releases page](https://github.com/stavis1/lipoCLEAN/releases).
23-
8. Extract `example_analysis.zip` and `QE_Pro_model.zip` into the same folder. There should be no folders nested under `QE_Pro_model/` and all files from `example_analysis.zip` should be in the top level folder.
24-
9. Run `python -m lipoCLEAN --options example_analysis_options.txt`
25-
10. The results will be in a folder named `example_output/` the `example_output/QC/` folder contains several plots to assess the quality of the results.
26-
11. If you want a default version of the options file run `python -m lipoCLEAN --print options.txt`
24+
6. Download the trained model, and the example options file from the [releases page](https://github.com/stavis1/lipoCLEAN/releases).
25+
7. Extract `example_analysis.zip` and `QE_Pro_model.zip` into the same folder. There should be no folders nested under `QE_Pro_model/` and all files from `example_analysis.zip` should be in the top level folder.
26+
8. Run `python -m lipoCLEAN --options example_analysis_options.txt`
27+
9. The results will be in a folder named `example_output/` the `example_output/QC/` folder contains several plots to assess the quality of the results.
28+
10. If you want a default version of the options file run `python -m lipoCLEAN --print options.txt`
29+
11. To use the tool on other data edit the `options.txt` file.
2730

2831
On some systems the warning `No module named 'brainpy._c.composition'` will be displayed. This is not an error and does not impact the running of the tool.
2932

@@ -34,6 +37,7 @@ The docker container has trained models provided under /models/. To use these ge
3437
3. Extract `QE_Pro_model.zip`.
3538
4. Run `docker run --rm -v /path/to/your/data/:/data/ stavisvols/lipoclean python -m lipoCLEAN --options /data/docker_example_analysis_options.txt`
3639
5. If you want the default docker options file run `docker run --rm -v /path/to/your/data/:/data/ stavisvols/lipoclean python -m lipoCLEAN --print /data/options.txt`
40+
6. To use the tool on other data edit the `options.txt` file.
3741

3842
## MS-Dial export settings for inference
3943
1. Click "Export" along the top bar
@@ -45,7 +49,7 @@ The docker container has trained models provided under /models/. To use these ge
4549
7. "Export format" should be "msp"
4650
8. Click Export
4751

48-
A .txt will now be generated in the chosen directory with the information required for MSDpostprocess. The file name will start with "Mz"
52+
A .txt will now be generated in the chosen directory with the information required for LipoCLEAN. The file name will start with "Mz"
4953

5054
## Prepare training data
5155
1. Start with MS-DIAL exports using the same settings as described above for inference.
@@ -65,3 +69,4 @@ The tool is capable of being trained on multiple input files. The retention time
6569
Our tests have shown that a model will likely generalize to a family of instruments but that this has limits. We expect that the QE_Pro_model will work for all orbitrap systems. We do not have the data necessary to know how well the TOF model will generalize to all TOF instruments so if you are working with e.g. TimsTOF data it would be a good idea to do an initial validation of the output. The publicly available datasets used were reprocessed from raw files and annotated in-house.
6670

6771
Disclaimer: We are not in any way associated with the developers of MS-DIAL, we are merely enthusiastic users of their software.
72+

0 commit comments

Comments
 (0)