Compare commits

..

1 Commits

Author SHA1 Message Date
coolneng 6561aa2caf
Convert org mode README to markdown 2021-05-05 12:19:40 +02:00
1 changed files with 46 additions and 40 deletions

View File

@ -1,69 +1,75 @@
# locigenesis # locigenesis
locigenesis is a tool that generates a human T-cell receptor (TCR), runs locigenesis is a tool that generates a human T-cell receptor (TCR), runs it through a sequence reader simulation tool and extracts CDR3.
it through a sequence reader simulation tool and extracts CDR3.
The goal of this project is to generate both HVR sequences with and The goal of this project is to generate both HVR sequences with and without sequencing errors, in order to create datasets for a Machine Learning algorithm.
without sequencing errors, in order to create datasets for a Machine
Learning algorithm.
<a id="orgb4db211"></a>
## Technologies ## Technologies
- [immuneSIM](https://github.com/GreiffLab/immuneSIM/): in silico - [immuneSIM](https://github.com/GreiffLab/immuneSIM/): in silico generation of human and mouse BCR and TCR repertoires
generation of human and mouse BCR and TCR repertoires - [CuReSim](http://www.pegase-biosciences.com/curesim-a-customized-read-simulator/): read simulator that mimics Ion Torrent sequencing
- [CuReSim](http://www.pegase-biosciences.com/curesim-a-customized-read-simulator/):
read simulator that mimics Ion Torrent sequencing
<a id="orgace1e30"></a>
## Installation ## Installation
This project uses [Nix](https://nixos.org/) to ensure reproducible This project uses [Nix](https://nixos.org/) to ensure reproducible builds.
builds.
1. Install Nix (compatible with MacOS, Linux and 1. Install Nix (compatible with MacOS, Linux and [WSL](https://docs.microsoft.com/en-us/windows/wsl/about)):
[WSL](https://docs.microsoft.com/en-us/windows/wsl/about)):
``` {.shell}
curl -L https://nixos.org/nix/install | sh curl -L https://nixos.org/nix/install | sh
```
1. Clone the repository: 1. Clone the repository:
``` {.shell}
git clone https://git.coolneng.duckdns.org/coolneng/locigenesis git clone https://git.coolneng.duckdns.org/coolneng/locigenesis
```
1. Change the working directory to the project: 1. Change the working directory to the project:
``` {.shell}
cd locigenesis cd locigenesis
```
1. Enter the nix-shell: 1. Enter the nix-shell:
``` {.shell}
nix-shell nix-shell
```
After running these commands, you will find yourself in a shell that After running these commands, you will find yourself in a shell that contains all the needed dependencies.
contains all the needed dependencies.
<a id="org531bad5"></a>
## Usage ## Usage
An execution script that accepts 2 parameters is provided, the following An execution script that accepts 2 parameters is provided, the following command invokes it:
command invokes it:
``` {.shell}
./generation.sh <number of sequences> <number of reads> ./generation.sh <number of sequences> <number of reads>
```
- \<number of sequences\>: an integer that specifies the number of - <number of sequences>: an integer that specifies the number of different sequences to generate
different sequences to generate - <number of reads>: an integer that specifies the number of reads to perform on each sequence
- \<number of reads\>: an integer that specifies the number of reads
to perform on each sequence
The script will generate 2 files under the data directory: The script will generate 2 files under the data directory:
------------------- ----------------------------------------------------------------- <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
HVR.fastq Contains the original CDR3 sequence
CuReSim-HVR.fastq Contains CDR3 after the read simulation, with sequencing errors
------------------- ----------------------------------------------------------------- <colgroup>
<col class="org-left" />
<col class="org-left" />
</colgroup>
<tbody>
<tr>
<td class="org-left">HVR.fastq</td>
<td class="org-left">Contains the original CDR3 sequence</td>
</tr>
<tr>
<td class="org-left">CuReSim-HVR.fastq</td>
<td class="org-left">Contains CDR3 after the read simulation, with sequencing errors</td>
</tr>
</tbody>
</table>