PF2-pasteur-fr / checkMyIndex

Search for a set of compatible indexes for your sequencing experiment
GNU General Public License v3.0
10 stars 6 forks source link

checkMyIndex

Search for a set of compatible indexes for your sequencing experiment according to:

Input indexes file

The list of the available indexes must be stored in a text file containing two tab-separated columns (without header): index ids are in the first column and the corresponding sequences in the second. inputIndexesExample.txt is an example of such a file and can be used to test checkMyIndex. For dual-indexing sequencing experiments the user needs to provide two files: the first one for the indexes 1 (i7) and the second for the indexes 2 (i5). index24-i7.txt and index24-i5.txt are available to test the research of compatible dual-indexes. Moreover, two files index96_UDI-i5.txt and index96_UDI-i7.txt are available to test the application in a Unique Dual-Indexing (UDI) context.

Shiny application

Public website

Click here to use the shiny interface of checkMyIndex.

Locally

If both shiny and shinyjs R packages are already installed, one can use the application locally running the two following lines in R:

library(shiny)

runGitHub("PF2-pasteur-fr/checkMyIndex", launch.browser=TRUE)

Rscript command line

checkMyIndex can be executed calling checkMyIndex.r with Rscript. As checkMyIndex.r sources global.r, both files must be placed in the same directory. Here are 4 examples using either inputIndexesExample.txt or index24-i7.txt and index24-i5.txt:

Rscript checkMyIndex.r --inputFile7=inputIndexesExample.txt -C 4 -n 9 -m 3

Rscript checkMyIndex.r --inputFile7=inputIndexesExample.txt -C 4 -n 12 -m 3 -u lane

Rscript checkMyIndex.r --inputFile7=inputIndexesExample.txt -C 2 -n 12 -m 3 -u index

Rscript checkMyIndex.r --inputFile7=index24-i7.txt --inputFile5=index24-i5.txt -C 2 -n 24 -m 12

The help page of the script can be displayed running the following command:

Rscript checkMyIndex.r --help

Requirements

Here is the list of the R packages needed to run checkMyIndex:

One can install each of these packages running install.packages(packageName) in R.

Illumina chemistry

Illumina has developed three types of chemistry: the four-channels for the HiSeq and MiSeq sequencing devices, the two-channels for the NovaSeq, NextSeq and MiniSeq devices and the one-channel for the iSeq 100 device. With the four-channel chemistry, a red laser detects A/C bases and a green laser detects G/T bases and the indexes are compatible if there is at least one red light and one green light at each position. With the two-channel chemistry, G bases have no color, A bases are orange, C bases are red and T bases are green and indexes are compatible if there is at least one color at each position. Note that indexes starting with GG are not compatible with the two-channel chemistry. With the one-channel chemistry, compatibility cannot be defined with colors and indexes are compatible if there is at least one A or C or T base at each position. Please refer to the Illumina documentation for more detailed information on the different chemistries.

News

About checkMyIndex

This tool has been developed at the Biomics pole of the Institut Pasteur by Hugo Varet (hugo.varet@pasteur.fr) and an Application Note describing it has been published in 2018 in Bioinformatics. Please note that checkMyIndex is provided without any guarantees as to its accuracy.