Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleClick here for a hint

The which command is used to give the location of a program or script that is in your $PATH.

Code Block
languagebash
titleHere is an easy one-liner to cat the contents of a script (note ` is a back-tick, not apostrophe)
collapsetrue
cat `which annovar_pipe.sh`  # the command within the `` is evaluated first and the output placed within the `` marks to be evaluated by the outer command

This script simply does a format conversion and then calls summarize_annovar.pl.  Which begs the question what does summarize_annovar.pl do?

 

change name of code block

 

Expand
titleIn the mean time, you might want to have a look at the code to annovar_pipe.sh and Figure out what summarize_annovar.pl . Note that these run Annovar in "gene-based" mode.is doing using the back tick trick you just learned

Again note the ` characters are "backtick", not apostrophes

Code Block
titlePrint out the text of the perl script summarize_annovar.pl
more `which summarize_annovar.pl`  

The more command was used to make it slightly easier to read and to remind you that there are multiple options of how to look a things (less, head, tail, etc), eventually you will develop your own habits but the more you are exposed to the fewer instances of angry eureka moments you will have. When working with unknown files or file types, cat should typically be avoided unless you run a wc -l command.

This script is written in perl (a programing language that while powerful, is not very favored among most computational biologists who typically prefer: Python, R, or Bash shell scripts) as a method of standardizing input to call a series of external commands. Such wrappers (or wrappers within wrappers) make your life much easier. breseq itself has wrappers for using bowtie2 and samtools which you ran separately on other data. As you increase your understanding of scripts and the command line by looking at what others have done you may begin to make your own wrappers and small scripts, but such wrappers are a great example of the BioITeam and other community resources can provide you with. While we have told you no one will ever care as much about your data as you do, quality of life issues regarding repetitive treatment of similar inputs and outputs may be easily solved by someone else.

Now let's run it on the .vcf files from the 3 individuals (NA12878, NA12891, and NA12892) from both the samtools and gatk output in the $BI/ngs_course/human_variation/ directory. (You may recognize these as the same individuals that we worked with on the Trios tutorial. Throughout the class we've been teaching you how to create a commands file using nano, but here we provide a more complex example of how you can generate a commands file. As you become more proficient with the command line, it is likely you will use various piping techniques to generate commands file. The following calls Perl to custom-create the 6 command lines needed and put them straight into a commands file:

Code Block
titleCreate the "commands" file to run annovar on six vcf files - use Perl to extract the sample name and mapper so the log files have meaningful, but shorter, names
ls $BI/ngs_course/human_variation/N*.vcf | \
  perl -n -e 'chomp; $_=~/(NA\d+).*(sam|GATK)/; print "annovar_pipe.sh $_ >$1.$2.log 2>&1\n";' > commands

...

Code Block
languagebash
titleClick here to check your work
collapsetrue
cds
mkdir BDIB_Annovar
cd BDIB_Annovar
 
# Use only 1 of the following copy commands
 
# if you have already done the trios tutorial
cp $SCRATCH/BDIB_Human_tutorial/raw_files/N*.vcf .  
 
# if you have not done the trios tutorial
cp $BI/ngs_course/human_variation/N*.vcf .
ls *.vcf | perl -n -e 'chomp; $_=~/(NA\d+).*(sam|GATK)/; print "annovar_pipe.sh $_ >$1.$2.log 2>&1 &\n";' > commands
Note
titleA helpful note to make your life better.
"commands" files are 1 way to both create a record of what it is that you are doing as well as an easy way to execute multiple commands simultaneously. In a previous tutorial (the advanced breseq tutorial, or the 2nd breseq example from the first day) we showed you how to do this by adding an & as the last character of the line to force the command to execute in the background. Tomorrow we will go over the more common method of submitting "commands" files to the que to run as jobs rather than being spoiled with interacting with everything on idev nodes. In computational biology this instructor has often found that once I learn to do something a particular way, it takes an incredible amount of inertia to change how I do something even when i know it would help to do so. In an effort to learn from me

...

 

make me an expand

investigate the commands file to to determine what the piping command actually did  (click for answer)

make me a code block

cat commands

 

...

making things harder on myself than need be, I urge you to STRONGLY consider not naming every list of commands you want to run "commands" but rather something that is actually descriptive, even "commands_DATE" would be helpful. As you start submitting your own jobs you will quickly be able to build bad habits, try to be aware of and avoid this one if possible.
Expand
titleinvestigate the commands file to to determine what the piping command actually did (click for answer)
Code Block
languagebash
titleThink about the commands that let you look at what the contents of a file are
collapsetrue
cat commands

 

 

Warning
titleMake sure you are on an IDEV node using the showq -u command
Code Block
languagebash
titleHow to request an idev node if needed
collapsetrue
idev  -m 120 -r CCBB_Bio_Summer_School_2016_Day3 -A UT-2015-05-18 -N 2 -n 8
Code Block
titleCreate the submission script and submit
chmod +x commands
./commands

 

The easiest way to check if this is working is to use ls and see an explosion of new files. This will take quite a bit of time to complete running. As such, we have ALREADY pre-computed these outputs so you can begin evaluating the results. 

Code Block
languagebash
titleClick here to check your workcollapsetrueUse this code block to copy the completed results
cds
mkdir BDIB_Annovar
cd BDIB_Annovar
cp $SCRATCH/BDIB_Human_tutorial/raw_files/N*.vcf .
ls *.vcf | perl -n -e 'chomp; $_=~/(NA\d+).*(sam|GATK)/; print "annovar_pipe.sh $_ >$1.$2.log 2>&1 &\n";' > commands

change title of codeblock = MAKE SURE YOU ARE ON IDEV if you want to run 

Code Block
titleCreate the submission script and submit
chmod +x commands

./commands

 

...

mkdir provided_results
cd provided_results
cp $BI/ngs_course/human_variation/*chrom20.samtools* .

Later, when your results have completed running (likely >90 minutes as annovar not configured to use multiple processes, compare your results to these provided results).

For the scavengar hunts below you should also copy over the GATK results.

Code Block
languagebash
titleUse this code block to copy the completed results
cp $BI/ngs_course/human_variation/*chrom20.GATK* .

 

 

ANNOVAR output

Annovar does a ton of work in assessing variants for us (though if you were going for clinical interpretation, you still have a long way to go - compare this to RUNES or CarpeNovo).  It provides all these output files:

...