Skip to content

Commit 3f3feab

Browse files
Update README.md
1 parent 994a800 commit 3f3feab

1 file changed

Lines changed: 15 additions & 25 deletions

File tree

README.md

Lines changed: 15 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Wrapper around the .net (C#) ThermoFisher ThermoRawFileReader library for running on Linux with mono (works on Windows too). It takes a thermo RAW file as input and outputs a metadata file and the spectra in 3 possible formats
44
* MGF: only MS2 spectra
5-
* mzML: both MS1 and MS2 spectra
5+
* mzML and indexed mzML: both MS1 and MS2 spectra
66
* Apache Parquet: under development
77

88
RawFileReader reading tool. Copyright © 2016 by Thermo Fisher Scientific, Inc. All rights reserved
@@ -12,44 +12,34 @@ RawFileReader reading tool. Copyright © 2016 by Thermo Fisher Scientific, Inc.
1212

1313
## Usage
1414
```
15-
mono ThermoRawFileParser.exe -i=/home/user/data_input/raw_file.raw -o=/home/user/data_input/output/ -f=0 -g -m=0 -c=PXD00001
15+
mono ThermoRawFileParser.exe -i=/home/user/data_input/raw_file.raw -o=/home/user/data_input/output/ -f=0 -g -m=0
1616
```
17-
For running on Windows, omit `mono`. The optional parameters only work in the -option=value format. The tool can output some RAW file metadata `-m=0|1` (0 for JSON format, 1 for TXT format) and the spectra file `-f` or both. For the MGF format, `-p` flag is used to exclude MS2 profile mode data (the MGF files can get big when the MS2 spectra were acquired in profile mode).
17+
For running on Windows, omit `mono`. The optional parameters only work in the -option=value format. The tool can output some RAW file metadata `-m=0|1` (0 for MGF, 1 for mzMl, 2 for indexed mzML, 3 for Parquet, 4 for MGF with profile data excluded) and the spectra file `-f` or both. The 'MGF with profile data excluded format' is used to exclude MS2 profile mode data (the MGF files can get big when the MS2 spectra were acquired in profile mode).
1818

1919
```
20-
ThermoRawFileParser.exe usage is (use -option=value for the optional arguments):
20+
ThermoRawFileParser.exe usage is (use -option=value for the optional arguments):
2121
-h, --help Prints out the options.
2222
-i, --input=VALUE The raw file input.
2323
-o, --output=VALUE The output directory.
2424
-f, --format=VALUE The output format for the spectra (0 for MGF, 1
25-
for MzMl, 2 for Parquet)
25+
for mzMl, 2 for indexed mzML, 3 for Parquet, 4
26+
for MGF with profile data excluded)
2627
-m, --metadata=VALUE The metadata output format (0 for JSON, 1 for TXT).
2728
-g, --gzip GZip the output file if this flag is specified (
2829
without value).
29-
-p, --profiledata Exclude MS2 profile data if this flag is specified
30-
(without value). Only for MGF format!
31-
-c, --collection[=VALUE] The optional collection identifier (PXD identifier
32-
for example).
33-
-r, --run[=VALUE] The optional mass spectrometry run name used in
34-
the spectrum title. The RAW file name will be
35-
used if not specified.
36-
-s, --subfolder[=VALUE] Optional, to disambiguate instances where the same
37-
collection has 2 or more MS runs with the same
38-
name.
3930
-u, --s3_url[=VALUE] Optional property to write directly the data into
40-
S3 Storage
31+
S3 Storage.
4132
-k, --s3_accesskeyid[=VALUE]
4233
Optional key for the S3 bucket to write the file
43-
output
34+
output.
4435
-t, --s3_secretaccesskey[=VALUE]
4536
Optional key for the S3 bucket to write the file
46-
output
37+
output.
4738
-n, --s3_bucketName[=VALUE]
4839
S3 bucket name
49-
-v, --verbose Verbose the programm and the individual steps
40+
-v, --verbose Enable verbose logging.
5041
-e, --ignoreInstrumentErrors
5142
Ignore missing properties by the instrument.
52-
5343
```
5444

5545
## Download
@@ -74,14 +64,14 @@ docker build --no-cache -t thermorawparser -f Dockerfile_basic .
7464
```
7565
Run example:
7666
```
77-
docker run -v /home/user/raw:/data_input -i -t thermorawparser mono /src/bin/Debug/ThermoRawFileParser.exe -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0 -c=PXD00001
67+
docker run -v /home/user/raw:/data_input -i -t thermorawparser mono /src/bin/Debug/ThermoRawFileParser.exe -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0
7868
```
7969
Create example for reusing the container:
8070
```
8171
docker create -v /home/user/raw:/data_input --name=rawparser -it thermorawparser
8272
docker start rawparser
83-
docker exec rawparser mono /src/bin/x64/Debug/ThermoRawFileParser.exe -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0 -c=PXD00001
84-
docker exec rawparser mono /src/bin/x64/Debug/ThermoRawFileParser.exe -i=/data_input/another_raw_file.raw -o=/data_input/output/ -f=0 -g -m=0 -c=PXD00001
73+
docker exec rawparser mono /src/bin/x64/Debug/ThermoRawFileParser.exe -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0
74+
docker exec rawparser mono /src/bin/x64/Debug/ThermoRawFileParser.exe -i=/data_input/another_raw_file.raw -o=/data_input/output/ -f=0 -g -m=0
8575
docker stop rawparser
8676
```
8777

@@ -93,9 +83,9 @@ docker build --no-cache -t thermorawparser .
9383
```
9484
Run example:
9585
```
96-
docker run -v /home/user/raw:/data_input -i -t --user biodocker thermorawparser mono /home/biodocker/bin/bin/x64/Debug/ThermoRawFileParser.exe -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0 -c=PXD00001
86+
docker run -v /home/user/raw:/data_input -i -t --user biodocker thermorawparser mono /home/biodocker/bin/bin/x64/Debug/ThermoRawFileParser.exe -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0
9787
```
9888
or with the bash script (`ThermoRawFileParser.sh`):
9989
```
100-
docker run -v /home/user/raw:/data_input -i -t --user biodocker thermorawparser /bin/bash /home/biodocker/bin/ThermoRawFileParser.sh -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0 -c=PXD00001
90+
docker run -v /home/user/raw:/data_input -i -t --user biodocker thermorawparser /bin/bash /home/biodocker/bin/ThermoRawFileParser.sh -i=/data_input/raw_file.raw -o=/data_input/output/ -f=0 -g -m=0
10191
```

0 commit comments

Comments
 (0)