library(sangeranalyseR)sangeranalyseR is an R package for analysing Sanger sequencing reads, especially those from ABIF platform, in pure R environment. There are three levels in sangeranalyseR which are ‘SangerRead’, ‘SangerContig’ and ‘SangerAlignment’. Users can choose which level to start the analysis. In this documentation, we intoduce analysis workflow step by step in these three levels with examples.
‘SangerRead’ extends from ‘sangerseq’ class and stores ‘abif’ class in sangerseqR as well as essential information including quality trimming and chromatogram parameters. It corresponds to a single ABIF file in Sanger sequencing.
First step is to create a ‘SangerRead’ instance. Here, we find the the abosulte file path and assign it to A_chloroticaFdReadFN.
inputFilesPath <- system.file("extdata/", package = "sangeranalyseR")
A_chloroticaFdReadFN <- file.path(inputFilesPath,
"Allolobophora_chlorotica",
"RBNII",
"Achl_RBNII396-13_1_F.ab1")Now we can create a ‘SangerRead’ instance by running SangerRead constructor function.
singleRead <- SangerRead(readFeature = "Forward Read",
readFileName = A_chloroticaFdReadFN)## INFO [2020-27-10 23:07:54] Forward Read: Creating abif & sangerseq ...
## INFO [2020-27-10 23:07:54] * Creating Forward Read raw abif ...
## INFO [2020-27-10 23:07:54] * Creating Forward Read raw sangerseq ...
## INFO [2020-27-10 23:07:54] * Making basecall !!
## INFO [2020-27-10 23:07:55] * Updating slots in 'SangerRead' instance !!
## SUCCESS [2020-27-10 23:07:55] >> 'SangerRead' S4 instance is created !!Second step is to visualize the trimmed read. qualityBasePlot triggers a plot_ly interactive plot for users to check the result of the trimmed read.
qualityBasePlot(singleRead)Third step is to change trimming parameters. SangerRead constructor function uses default trimming parameters. If users are not satisfied with the trimming result, they can run updateQualityParam function to change the trimming parameters inside the ‘SangerRead’ instance.
updateQualityParam(singleRead,
TrimmingMethod = "M1",
M1TrimmingCutoff = 0.0003,
M2CutoffQualityScore = NULL,
M2SlidingWindowSize = NULL)Fourth step is to export DNA sequence to FATA file. writeFastaSR let users to write read in ‘SangerRead’ instance to file in FASTA format.
writeFastaSR(singleRead)## INFO [2020-27-10 23:07:56] >>> outputDir : /tmp/RtmpWSoxnC
## INFO [2020-27-10 23:07:56] Start writing '/tmp/RtmpqfKuwy/Rinst6e71efffade/sangeranalyseR/extdata//Allolobophora_chlorotica/RBNII/Achl_RBNII396-13_1_F.ab1' to FASTA format ...
## INFO [2020-27-10 23:07:56] >> '/tmp/RtmpWSoxnC/Achl_RBNII396-13_1_F.fa' is written## [1] "/tmp/RtmpWSoxnC/Achl_RBNII396-13_1_F.fa"Fifth step is to create a static html report for ‘SangerRead’ instance by running generateReportSR function
generateReportSR(singleRead)‘SangerContig’ contains two lists of ‘SangerRead’ which are forward and reverse read list. It also contains alignment results and consensus read. It corresponds to a contig in Sanger sequencing.
First step is to prepare all reads in the same directory and define the project parameters.
inputFilesParentDir is the directory storing all raw ABIF files.contigName is the name of contigs. All targets share the same contig name.suffixForwardRegExp is the regular expression for forward read suffix.suffixReverseRegExp is the regular expression for reverse read suffix.rawDataDir <- system.file("extdata", package = "sangeranalyseR")
inputFilesParentDir <- file.path(rawDataDir, "Allolobophora_chlorotica", "ACHLO")
contigName <- "Achl_ACHLO006-09"
suffixForwardRegExp <- "_[0-9]*_[F].ab1"
suffixReverseRegExp <- "_[0-9]*_[R].ab1"After defining parameters, users can create ‘SangerContig’ instance by running SangerContig constructor function.
sangerContig <- SangerContig(parentDirectory = inputFilesParentDir,
contigName = contigName,
suffixForwardRegExp = suffixForwardRegExp,
suffixReverseRegExp = suffixReverseRegExp)## INFO [2020-27-10 23:07:56] ******** Contig Name: Achl_ACHLO006-09
## INFO [2020-27-10 23:07:57] **** You are using Regular Expression Method to group AB1 files!
## INFO [2020-27-10 23:07:57] Forward Read: Creating abif & sangerseq ...
## INFO [2020-27-10 23:07:57] * Creating Forward Read raw abif ...
## INFO [2020-27-10 23:07:57] * Creating Forward Read raw sangerseq ...
## INFO [2020-27-10 23:07:57] * Making basecall !!
## INFO [2020-27-10 23:07:57] * Updating slots in 'SangerRead' instance !!
## SUCCESS [2020-27-10 23:07:57] >> 'SangerRead' S4 instance is created !!
## INFO [2020-27-10 23:07:57] Reverse Read: Creating abif & sangerseq ...
## INFO [2020-27-10 23:07:57] * Creating Reverse Read raw abif ...
## INFO [2020-27-10 23:07:57] * Creating Reverse Read raw sangerseq ...
## INFO [2020-27-10 23:07:57] * Making basecall !!
## INFO [2020-27-10 23:07:57] * Updating slots in 'SangerRead' instance !!
## SUCCESS [2020-27-10 23:07:58] >> 'SangerRead' S4 instance is created !!
## SUCCESS [2020-27-10 23:08:01] >> 'SangerContig' S4 instance is created !!Second step is to trigger ‘SangerContig’ Shiny app. In SangerContig constructor function, all forward and reverse reads in this contig share the same trimming parameter by default. It is inconvenient for users to check reads one by one through R command; therefore, we provide a local Shiny app to let users easily browse and change parameters in each read in the ‘SangerContig’ instance.
launchAppSC(sangerContig)Third step is to export DNA sequence to FATA file. After changing trimming parameters in each read, users can run writeFastaSC function to write results into text file in FASTA format.
writeFastaSC(sangerContig)Fourth step is to create a report. Users can create a static html report for the ‘SangerContig’ instance by running generateReportSC function.
generateReportSC(sangerContig)‘SangerAlignment’ contains a list of ‘SangerContig’ and the alignment results for all contigs. It corresponds to a rebuild DNA sequence fragment in Sanger sequencing.
First step is to prepare all reads in the same directory and define the project parameters.
inputFilesParentDir is the directory storing all raw ABIF files.suffixForwardRegExp is the regular expression for forward read suffix.suffixReverseRegExp is the regular expression for reverse read suffix.rawDir <- system.file("extdata", package="sangeranalyseR")
parentDir <- file.path(rawDir, "Allolobophora_chlorotica", "RBNII")
suffixForwardRegExp <- "_[F]_[0-9]*.ab1"
suffixReverseRegExp <- "_[R]_[0-9]*.ab1"Users can create ‘SangerAlignment’ instance by running SangerAlignment constructor function.
sangerAlignment <-
SangerAlignment(parentDirectory = parentDir,
suffixForwardRegExp = suffixForwardRegExp,
suffixReverseRegExp = suffixReverseRegExp,)Second step is to run launchAppSA to trigger the local ‘SangerAlignment’ Shiny app. Users can easily browse all ‘SangerContig’ instance in ‘SangerAlignment’ and change ‘SangerRead’ trimming parameters in each ‘SangerContig’ instance.
launchAppSA(sangerAlignment)Third step is to run writeFastaSC function to write results into text file in FASTA format.
writeFastaSA(sangerAlignment)Fourth step is to create a report. Users can create a static html report for the ‘SangerAlignment’ instance by running generateReportSA function.
generateReportSA(sangerAlignment)