From Alignments to a counts table

This document assumes preproc htstream has been completed.

IF for some reason it didn’t finish, is corrupted or you missed the session, you can copy over a completed copy

cp -r /share/biocore/workshops/2019_March_RNAseq/02-STAR_alignment /share/workshop/$USER/rnaseq_example/.
cp  /share/biocore/workshops/2019_March_RNAseq/summary_alignments.txt /share/workshop/$USER/rnaseq_example/.

In this section, we will collate all of the count data into one file for analysis in R.

1. First lets make sure we are where we are supposed to be.

cd /share/workshop/$USER/rnaseq_example

2. First, go back to your 02-STAR_alignment directory. Let’s use a wildcard to list all of the counts files from all of the STAR alignment directories:

ls -lah 02-STAR_alignment/*/*ReadsPerGene.out.tab

Take a look at the beginning of one of these files:

head 02-STAR_alignment/SampleAC1/SampleAC1_ReadsPerGene.out.tab
msettles@tadpole:/share/workshop/msettles/rnaseq_example$     head 02-STAR_alignment/SampleAC1/SampleAC1_ReadsPerGene.out.tab
N_unmapped	95519	95519	95519
N_multimapping	213548	213548	213548
N_noFeature	641702	2690321	682539
N_ambiguous	211202	4942	94753
ENSG00000223972.5	3	0	3
ENSG00000227232.5	20	0	20
ENSG00000278267.1	1	0	1
ENSG00000243485.5	0	0	0
ENSG00000284332.1	0	0	0
ENSG00000237613.2	0	0	0

The columns are ID, reads map to either strand, reads mapped to forward strand, and reads mapped to the reverse strand and the first four lines are category totals. In this experiment, it looks like the reads are from the reverse strand, due to the much higher mapping numbers in that column and they similar to reads mapped to either strands. So what we want is just that column of numbers (minus the first four lines), for every one of these files.


3. So let’s take one file and figure out how to do that, then we will expand it to all the files. First let’s just get the rows we want, i.e. everything but the first four:

tail -n +5 02-STAR_alignment/SampleAC1/SampleAC1_ReadsPerGene.out.tab | head

When you give the ‘-n’ option for the ‘tail’ command a number preceded by a ‘+’ sign, it gives you the entire file starting at the line indicated by the number. In this case, we want to skip the first 4 lines, so we start at line 5. We’re piping the command to ‘head’ just to check that it looks correct. You shouldn’t see the first four total lines.

Now, we want only the fourth column (the counts), and in order to get that we pipe the output of the tail command to the ‘cut’ command, and then redirect the output to a new file:

tail -n +5 02-STAR_alignment/SampleAC1/SampleAC1_ReadsPerGene.out.tab | cut -f4 | head

Now, C61_ReadsPerGene.out.tab.count contains a single column of data… counts for each of the genes for that sample.


3. Now, we want to do these steps for ALL of the read count files… and to do that we will be using a ‘for loop’ directly on the command line. First, just run a simple ‘for loop’ that will print out the names of all the files we want to use:

for sample in `cat samples.txt`; do echo ${sample}; done

This command takes all the files that we listed in step 1 and loops through them, one by one, and for every iteration, assigns the filename to the ‘${sample}’ variable. Also, for every iteration, it runs whatever commands are between the ‘do’ and ‘done’…. and every iteration the value of ‘${sample}’ changes. The semi-colons separate the parts of the loop. The ‘echo’ command just prints the value of $x to the screen… in this case just the filename. However, instead, we will use our previously created command, but with ${sample} instead of the filename, and adding a few things:

cd /share/workshop/$USER/rnaseq_example
mkdir 03-Counts
mkdir 03-Counts/tmp
for sample in `cat samples.txt`; do \
    echo ${sample}
    cat 02-STAR_alignment/${sample}/${sample}_ReadsPerGene.out.tab | tail -n +5 | cut -f4 > 03-Counts/tmp/${sample}.count
done

After this command, there should be a counts file for every sample, in 03-Counts.


4. Next, we need to get the columns for the final table. Because all of these files are sorted in the exact same order (by gene ID), we can just use the columns from any of the files:

tail -n +5 02-STAR_alignment/SampleAC1/SampleAC1_ReadsPerGene.out.tab | cut -f1 > 03-Counts/tmp/geneids.txt
head 03-Counts/tmp/geneids.txt

Finally, we want to combine all of these columns together using the ‘paste’ command, and put it in a temporary file:

paste 03-Counts/tmp/geneids.txt 03-Counts/tmp/*.count > 03-Counts/tmp/tmp.out

5. The final step is to create a header of sample names and combine it with the temp file. The header is just all of the sample names separated by tabs. And again, since we pasted the columns in sorted order (wildcards automatically sort in order), the columns just need to be in that same order.

We take the samples.txt file and pipe that to the sort (to ensure they are in the same order) and then ‘paste’ command with the ‘-s’ option, which takes a column of values and transposes them into a row, separated by the tab character. And finally, let’s put everything together:

cat <(cat samples.txt | sort | paste -s) 03-Counts/tmp/tmp.out > 03-Counts/rnaseq_workshop_counts.txt
rm -rf 03- Counts/tmp
head 03-Counts/rnaseq_workshop_counts.txt
msettles@tadpole:/share/workshop/msettles/rnaseq_example$ head 03-Counts/rnaseq_workshop_counts.txt
SampleAC1	SampleAC2	SampleAC3	SampleAC4	SampleAD1	SampleAD2	SampleAD3	SampleAD4	SampleBC1	SampleBC2	SampleBC3	SampleBC4	SampleBD1	SampleBD2	SampleBD3	SampleBD4
ENSG00000223972.5	3	1	0	0	0	0	0	0	2	0	0	0	0	5	0	0
ENSG00000227232.5	20	7	15	10	7	9	15	26	6	10	6	6	14	10	4	4
ENSG00000278267.1	1	2	1	1	0	1	2	4	0	0	0	0	0	0	1	0
ENSG00000243485.5	0	0	0	0	0	0	0	0	1	0	0	0	0	0	0	0
ENSG00000284332.1	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
ENSG00000237613.2	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
ENSG00000268020.3	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
ENSG00000240361.2	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
ENSG00000186092.6	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0

And now you have a raw counts file that has a count for every gene, per sample. You will use this file for the next step, which is analysis in R.

6. Transfer rnaseq_workshop_counts.txt and samples.txt to your computer using scp or winSCP, or copy/paste from cat [sometimes doesn’t work],

In a new shell session on your laptop. NOT logged into tadpole.

mkdir ~/rnaseq_workshop
cd ~/rnaseq_workshop
scp msettles@tadpole.genomecenter.ucdavis.edu:/share/workshop/msettles/rnaseq_example/03-Counts/rnaseq_workshop_counts.txt .
scp msettles@tadpole.genomecenter.ucdavis.edu:/share/workshop/msettles/rnaseq_example/samples.txt .

Its ok of the mkdir command fails (“File exists”) because we aleady created the directory earlier.

Open in excel (or excel like application), you may have to move the header column 1 cell to the right, and lets review.

Anything else worth discussing?