Package: ezqc
EZQC: Easy Quality Control for FastQ FilesTable of ContentsEZQC: Easy Quality Control for FastQ FilesTable of ContentsIntroductionWhy Choose EZQC VS FastQC?Quick Start GuideInstallationUsageAnalysis MethodsContributingIntroductionEZQC is a streamlined, terminal-based alternative to FastQC. Instead of generating individual report files per analysis, EZQC displays the analysis results, reasons, and suggestions directly in the terminal, making it easier to quickly assess the quality of multiple files. Additionally, EZQC generates figures for each analysis, providing a visual aid to spot potential issues for further examination.EZQC is capable of performing the following analyses:Per base sequence qualityPer sequence quality scoresPer base sequence contentPer sequence GC contentPer base N contentSequence Length DistributionOverrepresented sequencesAdapter ContentWhy Choose EZQC VS FastQC?Fast Result Readout When Batch Processing: With EZQC, there's no need to click into each HTML report like you would with FastQC.Automatic Interpretation of Analysis Results: The results are color-coded and provided in plain English, complete with suggestions. This makes it easier for users to interpret the results quickly.Generate Detailed Figures for Advanced Users: For those who want a more in-depth analysis, EZQC is capable of generating detailed figures that aid in understanding the quality of your FastQ files.Quick Start GuideInstall EZQC followingInstallation guide.Run the tool on a toy example using the commandezqc tests/SRR020192.fastq(fastq file fromIGSR).The results will be displayed in the terminal, and figures as well as csv tables will be saved to a directory namedezqc_outputin your current working directory. Note that this file is choosen intentionally to fail multiple QC tests.InstallationYou can install EZQC using pip:pip install ezqcAlternatively, you can compile the latest version of EZQC from source using the providedsetup.pyscript. Following steps:Clone the repository:git clone https://github.com/skysky2333/ezqcNavigate to the EZQC directory:cd ezqcInstall the package:pip install .Orpython setup.py installEZQC requires Python 3.x and depends on the following packages, which will be installed automatically during setup:numpymatplotlibpandasscipyBioUsageAfter installation, you can use EZQC from the command line as follows:ezqc <fastq file(s)>Replace<fastq file(s)>with the path(s) to your FastQ files. If you want to analyze multiple files, separate the file paths with spaces:ezqc file1.fastq file2.fastq file3.fastqUse-oor--outputto set the output directory.
Use-hor--helpto see help messages.Analysis MethodsHere's a brief description of the analyses performed by EZQC:Per Base Sequence Quality: Checks the quality of each base call in a sequence read.Per Sequence Quality Scores: Provides a histogram of quality scores over all sequences.Per Base Sequence Content: Analyzes the proportion of each base (A, T, G, C) at each position across all sequences.Per Sequence GC Content: Calculates the GC content in each sequence.Per Base N Content: Identifies sequences with a high proportion of unknown (N) bases.Sequence Length Distribution: Provides a histogram showing the distribution of sequence lengths.Overrepresented sequences: Identifies any sequences that occur more often than expected.Adapter Content: Detects the presence of adapter sequences in the reads.ContributingWe welcome contributions! Please seeCONTRIBUTING.mdfor details on how to contribute.