The "Create Count Table" tool is designed to estimate gene expression from RNA-sequencing experiments. This tool expects files with aligned sequencing reads in SAM/BAM format and a GTF/GFF file with coordinates of genomic features. It counts how many reads map to each feature of interest (e.g. genes, exons...). A Count Table is obtained that can be used to perform a differential expression analysis within OmicsBox.
Only reads mapping unambiguously to a single genomic feature are considered. On the other hand, reads aligned to more than one position or overlapping with more than one feature are discarded. This is convenient because if there are two or more genes that overlap or have some sequence similarity but they have different expression levels, counting common reads for all of them could provide inaccurate results. If paired-end data is provided fragments (read-pairs) instead of single reads are counted.
This module is based on the popular HTSeq package. Please cite HTSeq as:
Anders S, Pyl PT and Huber W (2014). "HTSeq — A Python framework to work with high-throughput sequencing data." Bioinformatics, 31(2), 166-9.
Figure 1: Create Count Table Interface
- Alignment Files: Select files containing the sequencing alignment data. It must be in the "Sequence Alignment/Map" format (SAM) or in its compressed format (BAM).
Annotation File: Select the file containing the list of genomic features in GFF/GTF format. GFF objects from OmicsBox are accepted too.
The GFF/GTF must belong to the same genome as the one used for the alignments.
Figure 2: Input Page
Quantification Level: Choose the feature type (3rd column in GFF/GTF file, "Type" column in GFF object) for which expression will be quantified (e.g. gene, exon...). Features coordinates (range of positions) will be extracted from annotation using the provided value and all features of other types are ignored.
- Name/Group By: Specify the attribute type (9th column in GFF/GTF file, "Attr" columns in GFF object) to be used as feature ID. The feature ID is used to identify counts in the output Count Table. Attribute types tagged with "*" (e.g. *gene_name) are not present in all features of the selected type and only those containing it will be extracted. Several GFF lines with the same feature ID will be considered as parts of the same feature. Figure 4 illustrates how "Quantification Level" and "Name/Group By" parameters work.
- Strand Specificity: Indicate how the strand is taken into account.
- Non-Strand Specific: A read is considered overlapping with a feature regardless of the strand in which the read has been mapped.
- Strand Specific Forward: For single-end reads, the read has to be mapped to the same strand as the feature to be counted. For paired-end reads, the first read on the pair must be mapped to the same strand as the feature and the second read on the opposite strand.
- Strand Specific Reverse: For single-end reads, the read has to be mapped to the opposite strand of the feature to be counted. For paired-end reads, the first read on the pair must be mapped to the opposite strand of the feature and the second read on the same strand.
- Overlap Mode: Modes to handle reads overlapping more than one feature. Consider that for each position in the read, a set of all features overlapping is defined. If the resulting set for a read (or read pair) contains precisely one feature, the read is counted for this feature. If it contains more than one feature, the read is counted as "ambiguous" (and not counted for any features), and if it is empty, the read is counted as "no feature". The three overlap modes join these sets as follows (figure 5 illustrates the effect of these three modes):
- Union: The union of all sets.
- Intersection Strict: The intersection of all sets.
- Intersection Non-Empty: The intersection of all non-empty sets.
- Minimum Mapping Quality: Set a filter to discard all reads with alignment quality (MAPQ) lower than the given minimum value.
Figure 3: Configuration Page
|chrom_1||RefSeq||gene||200||3150||·||+||·||ID=gene1; locus_tag=gene_one; gene=Gene_1|
|chrom_1||RefSeq||mRNA||200||3150||·||+||·||ID=mRNA1, transcript_id=mRNA_1; Parent=Gene1; gene_id=Gene_1|
|chrom_1||RefSeq||exon||200||1520||·||+||·||ID=exon1; exon_id=exon_1; Parent=mRNA1; gene_id=Gene_1|
|1900||3150||·||+||·||ID=exon2; exon_id=exon_2; Parent=mRNA1; gene_id=Gene_1|
FEATURE ID (IN COUNT TABLE)
Figure 4: Example of a simple GFF and usage of "Quantification Level" and "Name/Group By" parameters
|CASE||UNION||INTERSECTION STRICT||INTERSECTION NON EMPTY|
|Gene 1||Gene 1||Gene 1|
|Gene 1||No Feature||Gene 1|
|Gene 1||No Feature||Gene 1|
|Gene 1||Gene 1||Gene 1|
|Ambiguous||Gene 1||Gene 1|
Figure 5: Scheme of overlap modes
Once the analysis has been finished, a new tab containing the resulting Count Table is opened (figure 6). Rows correspond to genomic features and columns to samples (one by analyzed file). Counts represent the total number of reads aligned to each genomic feature. Results can be saved as a Count Table object.
Figure 6: Count Table
Furthermore, a result page will show a summary of the "Create Count Table" results (figure 7). In this page information about the extraction of genomic features from GFF, alignment files and obtained results are provided. The result summary can be generated via Side Panel → Result Summary and it can be exported as pdf.
Figure 7: Result Summary
Charts and Statistics
Different statistical charts of the obtained results can be generated. These provide additional information about the process of quantifying expression, as well as a quality assessment of the resulting counts. All these charts can be found under the Side Panel of the Count Table viewer.
- Library Size per Sample: Bar chart showing the number of read counts aligned to genomic features contained in each sample (figure 8a).
- Distribution of Counts: Box plot that allows seeing how counts are distributed within each sample for all the features (figure 8b). Features with 0 counts in all samples will be discarded for this chart. The binary logarithm of raw counts is represented.
- Counts per Category: Bar chart showing the number of reads of each input file sorted by different categories (figure 8c). This chart and the next one are only available for count tables created by the "Create Count Table" tool within OmicsBox.
- Feature: The sum of all reads that have been assigned to any features.
- No Feature: Reads which could not be assigned to any feature (the resulting set for the read is empty as mentioned above).
- Ambiguous: Reads which have been assigned to more than one feature (the resulting set for the read has more than one feature). These reads are not counted for any feature.
- Alignment Not Unique: Reads with more than one reported alignment. These reads are identified from the NH optional SAM field tag. If the program that was used to obtain alignments does not set this field, multiple aligned reads will be counted multiple time.
- Low Alignment Quality: Reads which were skipped due to the "Minimum Mapping Quality" filter set on the main wizard page.
- Not Aligned: Reads in the SAM/BAM file without alignment.
- Counts per Category (%): The same chart as explained below in percentages (figure 8d).
Last two charts are only available for count tables created by the "Create Count Table" tool within OmicsBox.
Figure 8(a): Library Size per Sample
Figure 8(b). Distribution of Counts
Figure 8(c): Counts per Category
Figure 8(d): Counts per Category (%)