Content from Introducing the Shell
Last updated on 2024-11-19 | Edit this page
Overview
Questions
- What is a command shell and why would I use one?
- How can I move around on my computer?
- How can I see what files and directories I have?
- How can I specify the location of a file or directory on my computer?
Objectives
- Describe key reasons for learning shell.
- Navigate your file system using the command line.
- Access and read help files for
bash
programs and use help files to identify useful command options. - Demonstrate the use of tab completion, and explain its advantages.
Open the collaborative doc for our workshop https://broad.io/cb-unix-20240509
If you haven’t already, please complete your workshop setup https://broad.io/cb-unix-setup
Feel free to browse today’s lesson content
What is a shell and why should I care?
A shell is a computer program that presents a command line interface which allows you to control your computer using commands entered with a keyboard instead of controlling graphical user interfaces (GUIs) with a mouse/keyboard/touchscreen combination.
There are many reasons to learn about the shell:
- Many bioinformatics tools can only be used through a command line interface. Many more have features and parameter options which are not available in the GUI. BLAST is an example. Many of the advanced functions are only accessible to users who know how to use a shell.
- The shell makes your work less boring. In bioinformatics you often need to repeat tasks with a large number of files. With the shell, you can automate those repetitive tasks and leave you free to do more exciting things.
- The shell makes your work less error-prone. When humans do the same thing a hundred different times (or even ten times), they’re likely to make a mistake. Your computer can do the same thing a thousand times with no mistakes.
- The shell makes your work more reproducible. When you carry out your work in the command-line (rather than a GUI), your computer keeps a record of every step that you’ve carried out, which you can use to re-do your work when you need to. It also gives you a way to communicate unambiguously what you’ve done, so that others can inspect or apply your process to new data.
- Many bioinformatic tasks require large amounts of computing power and can’t realistically be run on your own machine. These tasks are best performed using remote computers or cloud computing, which can only be accessed through a shell.
In this lesson you will learn how to use the command line interface to move around in your file system. We will learn the basics of the shell by manipulating some data files on a remote Unix server.
Broad login servers
All Broadies have access to Broad login servers. These are ’remote server’s, a computer that is not the one you are working on right now.
On a Mac or Linux machine, you can reach the login servers using a program called “Terminal”, which is already available on your computer. The Terminal is a window into which we will type commands. If you’re using Windows, you’ll use SecureCRT.
How to access the remote server
- Connect to the Broad-Internal wireless network.
- Launch your preferred SSH client, such as Terminal (Mac or Unix) or SecureCRT (Windows)
- Log in to a Broad login server using the instructions on the Broad Intranet.
The portion of your Broad email address before the @ symbol is your Broad username. Your Unix password is the the same one you use for your Broad-issued computer.
After logging in, you will see a screen showing something like this:
OUTPUT
Last login: Tue Apr 23 08:33:43 2024 from 10.75.224.147
--------------------------------------------------------------
Welcome to the host named login01
RedHat 7.9 x86_64
--------------------------------------------------------------
Puppet: 7.29.1
Facter: 4.6.1
Environment: production
FQDN: login01.broadinstitute.org
VLAN: 32
IP: 69.173.65.17
Born On: 2019-07-28
Uptime: 18 days
Model: VMware Virtual Platform
CPUs: 2
Memory: 7.62 GiB
--------------------------------------------------------------
IMPORTANT: This login host is a SHARED resource. Please limit
your usage to editing, simple scripts, and small data transfer
tasks. To encourage mindful use, limits have been put in place
including memory limitations.
To read more about this service, see https://broad.io/login.
################## Monthly Reboot Schedule ##################
Since there is no convenient time to reboot login hosts we
are establishing a monthly rotation.
login01 - 1st Sunday of each month at 6 PM
login02 - 2nd Sunday of each month at 6 PM
login03 - 3rd Sunday of each month at 6 PM
login04 - 4th Sunday of each month at 6 PM
If starting a long session, choose the host rebooted last
--------------------------------------------------------------
This computer system is the property of the Broad Institute.
It is for authorized use only. By using this system all users
acknowledge notice of, and agree to comply with, Broad's
Acceptable Use (broad.io/AcceptableUse).
Unauthorized or improper use of this system may result in
administrative disciplinary action and/or other sanctions.
By continuing to use this system you indicate
your awareness of and consent to Broad's Acceptable Use Policy.
(broad.io/AcceptableUse).
Log off immediately if you do not agree to the conditions
stated in this warning.
--------------------------------------------------------------
This provides a lot of information about the login servers.
Continuing means you agree to Broad’s acceptable use policy. If you
disagree, please type exit
. Otherwise let’s continue. You
can clear your screen using the clear
command.
Type the word clear
into the terminal and press the
Enter
key.
This will scroll your screen down to give you a fresh screen and will make it easier to read. You haven’t lost any of the information on your screen. If you scroll up, you can see everything that has been output to your screen up until this point.
Tip
Hot-key combinations are shortcuts for performing common commands.
The hot-key combination for clearing the console is Ctrl+L
.
Feel free to try it and see for yourself.
Navigating your file system
The part of the operating system that manages files and directories is called the file system. It organizes our data into files, which hold information, and directories (also called “folders”), which hold files or other directories.
Several commands are frequently used to create, inspect, rename, and delete files and directories.
The dollar sign is a prompt, which shows us that the shell is waiting for input; your shell may use a different character as a prompt and may add information before the prompt. When typing commands, either from these lessons or from other sources, do not type the prompt, only the commands that follow it.
You may have a prompt (the characters to the left of the cursor) that
looks different from the $
sign character used here. If you
would like to change your prompt to match the example prompt, first type
the command: echo $PS1
into your shell, followed by
pressing the Enter key.
This will print the bash special characters that are currently
defining your prompt. To change the prompt to a $
(followed
by a space), enter the command: PS1='$ '
Your window should
look like our example in this lesson.
To change back to your original prompt, type in the output of the
previous command echo $PS1
(this will be different
depending on the original configuration) between the quotes in the
following command: PS1=""
For example, if the output of echo $PS1
was
\u@\h:\w $
, then type those characters between the quotes
in the above command: PS1="\u@\h:\w $ "
. Alternatively, you
can reset your original prompt by exiting the shell and opening a new
session.
This isn’t necessary to follow along (in fact, your prompt may have other helpful information you want to know about). This is up to you!
When you type something in at a bash command-line prompt, it Reads the input, Evaluates it, then Prints the results, then does this over and over in a Loop. This behavior is called a REPL – a Read, Eval, Print Loop.
Many programming language environments have REPLs – Python and R for example. The input to the bash REPL is a command. Here are some examples:
ls # example 1 - no options or arguments
ls -l # example 2 - one "short" (single character) option (-l)
ls --help # example 3 - one "long" (word) option (--help)
ls .profile # example 4 - one argument, a file name (.profile)
ls --width=20 # example 5 - a long option with a value (--width is the option, 20 is the value)
ls -w 20 # example 6 - a short option w/a value, as above, where -w is the same as --width
ls -l -a -h # example 7 - three short options entered separately (-l -a -h)
ls -lah # example 8 - three short options that can be combined after a dash (-lah)
A command consists of:
- The command name – here ls
(list files)
- A command can be any of the built-in Linux/Unix commands, or the name of a user-written script or program
- One or more options, usually noted with a leading
dash (-) or double-dash (–).
- -l in example 2 (long listing)
- –help in example 3
- Options are optional – they do not have to be supplied (e.g. example 1 above)
- One or more command-line arguments, which are often (but
not always) file names; these are often optional
- e.g. .profile in example 4. The shell executes the command line input when it sees a linefeed, which happens when you press Enter after entering the command.
(REPL & command breakdown from UTAustin’s fantastic Intro to Unix wiki)
Let’s find out where we are by running a command called
pwd
(which stands for “print working directory”). At any
moment, our current working directory is our current
default directory, i.e., the directory that the computer assumes we want
to run commands in, unless we explicitly specify something else. Here,
the computer’s response is /home/unix/<username>
,
also known as your home directory. It is a common convention to use
angle brackets as a hint to substitute an appropriate value (without the
brackets).
OUTPUT
/home/unix/<username>
Your screen will show your username where you see
Let’s look at our file system. We can see what files and
subdirectories are in this directory by running ls
, which
stands for “listing”:
OUTPUT
ls
prints the names of the files and directories in the
current directory in alphabetical order, arranged neatly into columns.
Your output may look different if you already have files in your home
directory. Let’s get some example directories and files so we can
practice navigating in a Unix environment.
On most Unix systems, you can grab a file over the internet using a
tool called wget
. We’ll talk about wget
in
more detail later. For now, run this command:
BASH
$ wget https://github.com/jlchang/cb-unix-shell-lesson-template/raw/main/learners/files/cb_unix_shell.tgz
To paste text in Windows PowerShell, right click where you want to
insert (note: left click will discard what is in your clipboard). For
some Windows systems you may need to use ctrl
+
insert
instead.
OUTPUT
--2024-04-26 08:57:28-- https://github.com/jlchang/2024-05-09-Unix_Shell_pilot/raw/jlc_episode1_edits/learners/files/cb_unix_shell.tgz
Resolving github.com (github.com)... 140.82.113.4
Connecting to github.com (github.com)|140.82.113.4|:443... connected.
HTTP request sent, awaiting response... 302 Found
Location: https://raw.githubusercontent.com/jlchang/2024-05-09-Unix_Shell_pilot/jlc_episode1_edits/learners/files/cb_unix_shell.tgz [following]
--2024-04-26 08:57:28-- https://raw.githubusercontent.com/jlchang/2024-05-09-Unix_Shell_pilot/jlc_episode1_edits/learners/files/cb_unix_shell.tgz
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 185.199.109.133, 185.199.110.133, 185.199.111.133, ...
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|185.199.109.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 115379 (113K) [application/octet-stream]
Saving to: ‘cb_unix_shell.tgz’
cb_unix_shell.tgz 100%[===================================================>] 112.67K --.-KB/s in 0.1s
2024-04-26 08:57:29 (892 KB/s) - ‘cb_unix_shell.tgz’ saved [115379/115379]
Now if we ls
OUTPUT
cb_unix_shell.tgz
We downloaded a “tarball”. It’s a compressed file that can be unpacked. Let’s unpack it!
Now if we ls
again
OUTPUT
cb_unix_shell cb_unix_shell.tgz
Let’s explore the cb_unix_shell
subdirectory.
The command to change locations in our file system is
cd
, followed by a directory name to change our working
directory. cd
stands for “change directory”.
Let’s say we want to navigate to the cb_unix_shell
directory we saw above. We can use the following command to get
there:
Let’s look at what is in this directory:
OUTPUT
Dahl Seuss authors.txt data prodinfo454
We can tell ls
to display more information for each item
in the directory by giving it a command line flag. Use
the -l
option for the ls
command, like so:
OUTPUT
total 515
drwxr-sr-x 4 jlchang puppet 94 May 8 01:53 Dahl
drwxr-sr-x 4 jlchang puppet 68 May 8 01:56 Seuss
-rw-r--r-- 1 jlchang puppet 155 Mar 14 2013 authors.txt
-rw-r--r-- 1 jlchang puppet 19085 Mar 14 2013 data
drwxr-sr-x 268 jlchang puppet 19483 May 8 01:55 prodinfo454
Note: your output will show your username where you see
jlchang
above.
The additional information given includes the name of the owner of the file, when the file was last modified, and whether the current user has permission to read and write to the file.
ls
has lots of other options. To find out what they are,
we can type:
man
(short for manual) displays detailed documentation
(also referred as man page or man file) for bash
commands.
It is a powerful resource to explore bash
commands,
understand their usage and flags. Some manual files are very long. You
can scroll through the file using your keyboard’s down arrow or use the
Space key to go forward one page and the b key to
go backwards one page. When you are done reading, hit q to
quit.
We can make the ls
output more comprehensible by using
the flag -F
, which tells ls
to add a trailing /
to the names of directories:
OUTPUT
Dahl/ Seuss/ authors.txt data prodinfo454/
Anything with a “/” after it is a directory. Things with a “*” after
them are programs. If there are no decorations, it’s a file. Broad
servers use ls -CF
by default. Knowing ls -F
can be useful on servers that show plain ls
output. For a
color-coded option, try ls --color=auto
.
No one can possibly learn all of these arguments, that’s what the manual page is for. You can (and should) refer to the manual page or other help files as needed.
Let’s go into the Dahl
directory and see what is in
there.
OUTPUT
Charlie_and_the_Chocolate_Factory/ James_and_the_Giant_Peach/
This directory contains two subdirectories with long names. Unix has a great trick to minimize typing long names!
Shortcut: Tab Completion
Typing out file or directory names can waste a lot of time and it’s easy to make typing mistakes. Instead we can use tab complete as a shortcut. When you start typing out the name of a directory or file, then hit the Tab key, the shell will try to fill in the rest of the directory or file name.
From the Dahl
directory:
The shell will fill in the rest of the directory name for
James_and_the_Giant_Peach
.
Now change directories to James_and_the_Giant_Peach
in
Dahl
Using tab complete can be very helpful. However, it will only autocomplete a file or directory name if you’ve typed enough characters to provide a unique identifier for the file or directory you are trying to access.
For example, if we now try to list the files which names start with
Au
by using tab complete:
The shell auto-completes your command to Aunt_Sp
,
because there are two files in the directory that begin with
Aunt_Sp
. When you hit Tab again, the shell will
list the possible choices.
OUTPUT
Aunt_Spiker Aunt_Sponge
Tab completion can also fill in the names of programs, which can be useful if you remember the beginning of a program name.
OUTPUT
pwck pwconv pwd pwdx pwunconv
Displays the name of every program that starts with
pw
.
Summary
We now know how to move around our file system using the command line. This gives us an advantage over interacting with the file system through a GUI as it allows us to work on a remote server, carry out the same set of operations on a large number of files quickly, and opens up many opportunities for using bioinformatic software that is only available in command line versions.
In the next few episodes, we’ll be expanding on these skills and seeing how using the command line shell enables us to make our workflow more efficient and reproducible.
Key Points
- The shell gives you the ability to work more efficiently by using keyboard commands rather than a GUI.
- Useful commands for navigating your file system include:
ls
,pwd
, andcd
. - Most commands take options (flags) which begin with a
-
. - Tab completion can reduce errors from mistyping and make work more efficient in the shell.
Content from Navigating Files and Directories
Last updated on 2024-11-19 | Edit this page
Overview
Questions
- How can I perform operations on files outside of my working directory?
- What are some navigational shortcuts I can use to make my work more efficient?
Objectives
- Use a single command to navigate multiple steps in your directory structure, including moving backwards (one level up).
- Perform operations on files in directories outside your working directory.
- Work with hidden directories and hidden files.
- Interconvert between absolute and relative paths.
- Employ navigational shortcuts to move around your file system.
Moving around the file system
We’ve learned how to use pwd
to find our current
location within our file system. We’ve also learned how to use
cd
to change locations and ls
to list the
contents of a directory. Now we’re going to learn some additional
commands for moving around within our file system.
Use the commands we’ve learned so far to navigate to the
cb_unix_shell/Dahl
directory, if you’re not already
there.
What if we want to move back up and out of this directory and to our
top level directory? Can we type cd cb_unix_shell
? Try it
and see what happens.
OUTPUT
-bash: cd: cb_unix_shell: No such file or directory
Your computer looked for a directory or file called
cb_unix_shell
within the directory you were already in. It
didn’t know you wanted to look at a directory level above the one you
were located in.
We have a special command to tell the computer to move us back or up one directory level.
Now we can use pwd
to make sure that we are in the
directory we intended to navigate to, and ls
to check that
the contents of the directory are correct.
OUTPUT
/home/unix/jlchang/cb_unix_shell
Note: your output will show your username where you see
jlchang
above.
OUTPUT
Dahl Seuss authors.txt data prodinfo454
From this output, we can see that ..
did indeed take us
back one level in our file system.
You can chain these together like so:
prints the contents of /home/unix
.
First use the man
command to look at the options for
ls
.
The -a
option is short for all
and says
that it causes ls
to “not ignore entries starting with .”
This is the option we want.
OUTPUT
. .. .hidden Dahl Seuss authors.txt data prodinfo454
The name of the hidden directory is .hidden
. We can
navigate to that directory using cd
.
And then list the contents of the directory using
ls
.
OUTPUT
youfoundit.txt
The name of the text file is youfoundit.txt
.
In most commands the flags can be combined together in no particular order to obtain the desired results/output.
ls -Fa
ls -laF
Examining the contents of other directories
By default, the ls
commands lists the contents of the
working directory (i.e. the directory you are in). You can always find
the directory you are in using the pwd
command. However,
you can also give ls
the names of other directories to
view. Navigate to your home directory if you are not already there.
Then enter the command:
OUTPUT
Dahl Seuss authors.txt data prodinfo454
This will list the contents of the cb_unix_shell
directory without you needing to navigate there.
The cd
command works in a similar way.
Try entering:
This will take you to the Seuss
directory without having
to go through the intermediate directory.
Full vs. Relative Paths
The cd
command takes an argument which is a directory
name. Directories can be specified using either a relative path
or a full absolute path. The directories on the computer are
arranged into a hierarchy. The full path tells you where a directory is
in that hierarchy. Navigate to the home directory, then enter the
pwd
command.
You will see:
OUTPUT
/home/unix/jlchang
Note: your output will show your username where you see
jlchang
above.
This is the full name of your home directory. This tells you that you
are in a directory named with your username, which sits inside a
directory called unix
which is found in a directory called
home
which sits inside the very top directory in the
hierarchy. The very top of the hierarchy is a directory called
/
which is usually referred to as the root
directory. So, to summarize: your home directory is a directory in
unix
which is a directory in home
which is a
directory in /
. More on root
and
home
in the next section.
Now enter the following command:
This jumps forward multiple levels to the
Green_Eggs_and_Ham
directory. Now go back to the home
directory.
I can also navigate to the Green_Eggs_and_Ham
directory
using:
You’ll need to substitute <username>
with your
Broad username (without angle brackets).
These two commands have the same effect, they both take us to the
Green_Eggs_and_Ham
directory. The first uses a relative
path, giving only the address from the working directory (in this case,
your home directory). The second uses the absolute path, giving the full
address from the root directory. A full path always starts with a
/
. A relative path does not.
A relative path is like getting directions from someone on the street. They tell you to “go right at the stop sign, and then turn left on Main Street”. That works great if you’re standing there together, but not so well if you’re trying to tell someone how to get there from another country. A full path is like GPS coordinates. It tells you exactly where something is no matter where you are right now.
You can usually use either a full path or a relative path depending on what is most convenient or involves less typing.
Over time, it will become easier for you to keep a mental note of the structure of the directories that you are using and how to quickly navigate amongst them.
Relative path resolution
Using the filesystem diagram below, if pwd
displays
/Users/thing
, what will ls ../backup
display?
../backup: No such file or directory
2012-12-01 2013-01-08 2013-01-27
2012-12-01/ 2013-01-08/ 2013-01-27/
original pnas_final pnas_sub
- No: there is a directory
backup
in/Users
. - No: this is the content of
Users/thing/backup
, but with..
we asked for one level further up. - No: see previous explanation. Also, we did not specify
-F
to display/
at the end of the directory names. - Yes:
../backup
refers to/Users/backup
.
Navigational Shortcuts
The root directory is the highest level directory in your file system
and contains files that are important for your computer to perform its
daily work. While you will be using the root (/
) at the
beginning of your absolute paths, it is important that you avoid working
with data in these higher-level directories, as your commands can
permanently alter files that the operating system needs to function. In
many cases, trying to run commands in root
directories will
require special permissions which are not discussed here, so it’s best
to avoid them and work within your home directory. Dealing with the
home
directory is very common. The tilde character,
~
, is a shortcut for your home directory. In our case, the
root
directory is three levels above our
home
directory, so cd
or cd ~
will take you to /home/unix/<username>
and
cd /
will take you to /
. Navigate to the
cb_unix_shell
directory:
Then enter the command:
OUTPUT
cb_unix_shell cb_unix_shell.tgz
This prints the contents of your home directory, without you needing to type the full path.
The commands cd
, and cd ~
are very useful
for quickly navigating back to your home directory. We will be using the
~
character in later lessons to specify our home
directory.
Key Points
- The
/
,~
, and..
characters represent important navigational shortcuts. - Hidden files and directories start with
.
and can be viewed usingls -a
. - Relative paths specify a location starting from the current location, while absolute paths specify a location from the root of the file system.
Content from Working with Files and Directories
Last updated on 2024-11-19 | Edit this page
Overview
Questions
- How can I view and search file contents?
- How can I create, copy and delete files and directories?
- How can I control who has permission to modify a file?
- How can I repeat recently used commands?
Objectives
- View, search within, copy, move, and rename files. Create new directories.
- Use wildcards (
*
) to perform operations on multiple files. - Make a file read only.
- Use the
history
command to view and repeat recently used commands.
Working with Files
Wildcards
Navigate to our prodinfo454
directory:
We are interested in looking at the sequencing runfolders in this directory.
There are a lot of directories! The directories were created to be programmatically searchable so they follow a specific format: R_<year>_<month>_<date>_<hour>_<min>_<sec>_<machine_name>_<machine_operator>_<run_name>
We can list all runs from 2012 using the command:
OUTPUT
R_2012_03_13_15_18_05_crinkle_DRobbins_DR031312lastRun646704:
aaLog.txt
R_2012_03_15_14_41_54_crinkle_DRobbins_DR031512Run760581:
aaLog.txt
The *
character is a special type of character called a
wildcard, which can be used to represent any number of any type of
character (zero or more). Thus, R_2012_*
matches every
directory that starts with R_2012_
.
Notice that ls
lists each directory and the files in the
directory. To show just the directories that match your search (and not
show the directory contents), add the -d
(aka. directories)
flag.
OUTPUT
R_2012_03_13_15_18_05_crinkle_DRobbins_DR031312lastRun646704 R_2012_03_15_14_41_54_crinkle_DRobbins_DR031512Run760581
You can also use wildcards on either end of your search (or both). Here we search for all runs on the machine “seabiscuit”:
OUTPUT
R_2009_02_09_15_29_04_seabiscuit_levesque_SPG3kbDevRun705303
R_2009_03_16_13_49_01_seabiscuit_pfrere_march16tworegionRUN636092
R_2009_04_03_12_42_34_seabiscuit_levesque_DrocksLastRun647068
R_2009_04_09_14_23_35_seabiscuit_AHolling_krocksfirstRun713432
R_2009_04_15_14_29_08_seabiscuit_AHolling_Kamran041509run712591
R_2009_05_15_13_55_34_seabiscuit_AHolling_BacEscEscEscRun646819
lists only the directories with seabiscuit
in the
directory name.
What do you think this command will do?
OUTPUT
/usr/bin/gettext.sh /usr/bin/lprsetup.sh /usr/bin/setup-nsssysinit.sh
/usr/bin/lesspipe.sh /usr/bin/rescan-scsi-bus.sh /usr/bin/unix-lpr.sh
Lists every file in /usr/bin
that ends in the characters
.sh
. Note that this output displays full
paths to files, since each result starts with /
.
Exercise
Do each of the following tasks from your current directory using a
single ls
command for each:
- List all of the files in
/usr/bin
that start with the letter ‘c’. - List all of the files in
/usr/bin
that contain the letter ‘a’. - List all of the files in
/usr/bin
that end with the letter ‘o’.
Bonus: List all of the files in /usr/bin
that contain
the letter ‘a’ or the letter ‘c’.
Hint: The bonus question requires a Unix wildcard that we haven’t talked about yet. Try searching the internet for information about Unix wildcards to find what you need to solve the bonus problem.
ls /usr/bin/c*
ls /usr/bin/*a*
ls /usr/bin/*o
Bonus: ls /usr/bin/*[ac]*
Our data set: FASTQ files
Now that we know how to navigate around our directory structure,
let’s start working with our sequencing files. We did a sequencing
experiment and have two results files, which are stored in an
untrimmed_fastq
directory.
Using the commands we’ve learned so far, we’re going to navigate to a
different filesystem. Starting from the root directory, we’re going to
‘broad’ instead of ‘home’. This filesystem is called /broad/hptmp (for
high performance temporary). /broad/hptmp
is available for Broadies who need a temporary space to do high
performance computing work. Files in /broad/hptmp are automatically
deleted after 14 days. We’ve created a computing_basics
directory for today’s workshop.
Let’s navigate to the untrimmed_fastq
directory in
/broad/hptmp/computing_basics.
Download untrimmed_fastq.zip
to your home directory and
unpack it.
BASH
$ cd
$ wget https://github.com/jlchang/cb-unix-shell-lesson-template/raw/main/learners/files/untrimmed_fastq.zip
$ unzip untrimmed_fastq.zip
Then, in the following instructions, wherever you see
/broad/hptmp/computing_basics
substitute
~/untrimmed_fastq
.
Exercise
echo
is a built-in shell command that writes its
arguments, like a line of text to standard output. The echo
command can also be used with pattern matching characters, such as
wildcard characters. Here we will use the echo
command to
see how the wildcard character is interpreted by the shell.
OUTPUT
SRR097977.fastq SRR098026.fastq
The *
is expanded to include any file that ends with
.fastq
. We can see that the output of
echo *.fastq
is the same as that of
ls *.fastq
.
What would the output look like if the wildcard could not be
matched? Compare the outputs of echo *.missing
and
ls *.missing
.
Later on, when you learn to string together Unix commands, echo can be useful for injecting desirable text where you need it.
Command History
If you want to repeat a command that you’ve run recently, you can access previous commands using the up arrow on your keyboard to go back to the most recent command. Likewise, the down arrow takes you forward in the command history.
A few more useful shortcuts:
- Ctrl+C will cancel the command you are writing, and give you a fresh prompt.
- Ctrl+R will do a reverse-search through your command history. This is very useful.
-
Ctrl+L or the
clear
command will clear your screen.
There are also keyboard shortcuts to move around on the command line efficiently. To learn more, visit Effective Shell.
You can also review your recent commands with the
history
command, by entering:
to see a numbered list of recent commands. You can reuse one of these commands directly by referring to the number of that command.
For example, if your history looked like this:
OUTPUT
259 ls *
260 ls /usr/bin/*.sh
261 ls *R1*fastq
then you could repeat command #260 by entering:
Type !
(exclamation point) and then the number of the
command from your history. You will be glad you learned this when you
need to re-run very complicated commands. For more information on
advanced usage of history
, read section 9.3 of Bash
manual.
Exercise
Find the line number in your history for the command that listed all
the .sh files in /usr/bin
. Rerun that command.
First type history
. Then use !
followed by
the line number to rerun that command.
Examining Files
We now know how to switch directories, run programs, and look at the contents of directories, but how do we look at the contents of files?
One way to examine a file is to print out all of the contents using
the program cat
.
Enter the following command from within the
untrimmed_fastq
directory:
This will print out all of the contents of the
SRR097977.fastq
to the screen.
Exercise
- Print out the contents of the
/broad/hptmp/computing_basics/untrimmed_fastq/SRR097977.fastq
file. What is the last line of the file? - From your home directory, and without changing directories, use one
short command to print the contents of all of the files in the
/broad/hptmp/computing_basics/untrimmed_fastq
directory.
- The last line of the file is
CCC?CCCCCCC?CCCC?CCC>:CC:C>8C8?97A?'
. cat /broad/hptmp/computing_basics/untrimmed_fastq/*
cat
is a terrific program, but when the file is really
big, it can be annoying to use. The program, less
, is
useful for this case. less
opens the file as read only, and
lets you navigate through it. The navigation commands are identical to
the man
program.
Enter the following command:
Some navigation commands in less
:
key | action |
---|---|
Space | to go forward |
b | to go backward |
g | to go to the beginning |
G | to go to the end |
q | to quit |
less
also gives you a way of searching through files.
Use the “/” key to begin a search. Enter the word you would like to
search for and press enter
. The screen will jump to the
next location where that word is found.
Shortcut: If you hit “/” then “enter”,
less
will repeat the previous search. less
searches from the current location and works its way forward. Scroll up
a couple lines on your terminal to verify you are at the beginning of
the file. Note, if you are at the end of the file and search for the
sequence “CAA”, less
will not find it. You either need to
go to the beginning of the file (by typing g
) and search
again using /
or you can use ?
to search
backwards in the same way you used /
previously.
For instance, let’s search forward for the sequence
TTTTT
in our file. You can see that we go right to that
sequence, what it looks like, and where it is in the file. If you
continue to type /
and hit return, you will move forward to
the next instance of this sequence motif. If you instead type
?
and hit return, you will search backwards and move up the
file to previous examples of this motif.
Exercise
What are the next three nucleotides (characters) after the first
instance of the sequence TTTTT
quoted above?
CAC
Remember, the man
program actually uses
less
internally and therefore uses the same commands, so
you can search documentation using “/” as well!
There’s another way that we can look at files, and in this case, just look at part of them. This can be particularly useful if we just want to see the beginning or end of the file, or see how it’s formatted.
The commands are head
and tail
and they let
you look at the beginning and end of a file, respectively.
OUTPUT
@SRR098026.1 HWUSI-EAS1599_1:2:1:0:968 length=35
NNNNNNNNNNNNNNNNCNNNNNNNNNNNNNNNNNN
+SRR098026.1 HWUSI-EAS1599_1:2:1:0:968 length=35
!!!!!!!!!!!!!!!!#!!!!!!!!!!!!!!!!!!
@SRR098026.2 HWUSI-EAS1599_1:2:1:0:312 length=35
NNNNNNNNNNNNNNNNANNNNNNNNNNNNNNNNNN
+SRR098026.2 HWUSI-EAS1599_1:2:1:0:312 length=35
!!!!!!!!!!!!!!!!#!!!!!!!!!!!!!!!!!!
@SRR098026.3 HWUSI-EAS1599_1:2:1:0:570 length=35
NNNNNNNNNNNNNNNNANNNNNNNNNNNNNNNNNN
OUTPUT
+SRR098026.247 HWUSI-EAS1599_1:2:1:2:1311 length=35
#!##!#################!!!!!!!######
@SRR098026.248 HWUSI-EAS1599_1:2:1:2:118 length=35
GNTGNGGTCATCATACGCGCCCNNNNNNNGGCATG
+SRR098026.248 HWUSI-EAS1599_1:2:1:2:118 length=35
B!;?!A=5922:##########!!!!!!!######
@SRR098026.249 HWUSI-EAS1599_1:2:1:2:1057 length=35
CNCTNTATGCGTACGGCAGTGANNNNNNNGGAGAT
+SRR098026.249 HWUSI-EAS1599_1:2:1:2:1057 length=35
A!@B!BBB@ABAB#########!!!!!!!######
The -n
option to either of these commands can be used to
print the first or last n
lines of a file.
OUTPUT
@SRR098026.1 HWUSI-EAS1599_1:2:1:0:968 length=35
OUTPUT
A!@B!BBB@ABAB#########!!!!!!!######
Details on the FASTQ format
Although it looks complicated (and it is), it’s easy to understand the fastq format with a little decoding. Some rules about the format include…
Line | Description |
---|---|
1 | Always begins with ‘@’ and then information about the read |
2 | The actual DNA sequence |
3 | Always begins with a ‘+’ and sometimes the same info in line 1 |
4 | Has a string of characters which represent the quality scores; must have same number of characters as line 2 |
We can view the first complete read in one of the files in our
dataset by using head
to look at the first four lines.
OUTPUT
@SRR098026.1 HWUSI-EAS1599_1:2:1:0:968 length=35
NNNNNNNNNNNNNNNNCNNNNNNNNNNNNNNNNNN
+SRR098026.1 HWUSI-EAS1599_1:2:1:0:968 length=35
!!!!!!!!!!!!!!!!#!!!!!!!!!!!!!!!!!!
All but one of the nucleotides in this read are unknown
(N
). This is a pretty bad read!
Line 4 shows the quality for each nucleotide in the read. Quality is interpreted as the probability of an incorrect base call (e.g. 1 in 10) or, equivalently, the base call accuracy (e.g. 90%). To make it possible to line up each individual nucleotide with its quality score, the numerical score is converted into a code where each individual character represents the numerical quality score for an individual nucleotide. For example, in the line above, the quality score line is:
OUTPUT
!!!!!!!!!!!!!!!!#!!!!!!!!!!!!!!!!!!
The #
character and each of the !
characters represent the encoded quality for an individual nucleotide.
The numerical value assigned to each of these characters depends on the
sequencing platform that generated the reads. The sequencing machine
used to generate our data uses the standard Sanger quality PHRED score
encoding, Illumina version 1.8 onwards. Each character is assigned a
quality score between 0 and 42 as shown in the chart below.
OUTPUT
Quality encoding: !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJK
| | | | |
Quality score: 0........10........20........30........40..
Each quality score represents the probability that the corresponding nucleotide call is incorrect. This quality score is logarithmically based, so a quality score of 10 reflects a base call accuracy of 90%, but a quality score of 20 reflects a base call accuracy of 99%. These probability values are the results from the base calling algorithm and dependent on how much signal was captured for the base incorporation.
Looking back at our read:
OUTPUT
@SRR098026.1 HWUSI-EAS1599_1:2:1:0:968 length=35
NNNNNNNNNNNNNNNNCNNNNNNNNNNNNNNNNNN
+SRR098026.1 HWUSI-EAS1599_1:2:1:0:968 length=35
!!!!!!!!!!!!!!!!#!!!!!!!!!!!!!!!!!!
we can now see that the quality of each of the N
s is 0
and the quality of the only nucleotide call (C
) is also
very poor (#
= a quality score of 2). This is indeed a very
bad read.
Creating, moving, copying, and removing
Now we can move around in the file structure, look at files, and search files. But what if we want to copy files or move them around or get rid of them? Most of the time, you can do these sorts of file manipulations without the command line, but there will be some cases (like when you’re working with a remote computer like we are for this lesson) where it will be impossible. You’ll also find that you may be working with hundreds of files and want to do similar manipulations to all of those files. In cases like this, it’s much faster to do these operations at the command line.
Copying Files
When working with computational data, it’s important to keep a safe copy of that data that can’t be accidentally overwritten or deleted. For this lesson, our raw data is our FASTQ files. We don’t want to accidentally change the original files, so we’ll make a copy of them and change the file permissions so that we can read from, but not write to, the files.
First, let’s make a copy of one of our FASTQ files using the
cp
command.
Usually, you would do this in the untrimmed_fastq
directory and the command would look like:
cp SRR097977.fastq SRR097977-copy.fastq
but, because there are a lot of us, lets copy the file from the /broad/hptmp filesystem into our home directory.
START FROM YOUR HOME DIRECTORY
OUTPUT
/home/unix/<username>
Confirm pwd
says you’re in your home directory
(/home/unix/
BASH
$ cp /broad/hptmp/computing_basics/untrimmed_fastq/SRR097977.fastq SRR097977-copy.fastq
$ ls -F
OUTPUT
SRR097977-copy.fastq cb_unix_shell cb_unix_shell.tgz
We now have a copy of the SRR097977.fastq
file, named
SRR097977-copy.fastq
. We’ll move this file to a new
directory called backup
where we’ll store our backup data
files.
Creating Directories
The mkdir
command is used to make a directory. Enter
mkdir
followed by a space, then the directory name you want
to create:
Moving / Renaming
We can now move our backup file to this directory. We can move files
around using the command mv
:
OUTPUT
SRR097977-copy.fastq
The mv
command is also how you rename files. Let’s
rename this file to make it clear that this is a backup:
OUTPUT
SRR097977-backup.fastq
File Permissions
We’ve now made a backup copy of our file, but just because we have two copies, it doesn’t make us safe. We can still accidentally delete or overwrite both copies. To make sure we can’t accidentally mess up this backup file, we’re going to change the permissions on the file so that we’re only allowed to read (i.e. view) the file, not write to it (i.e. make new changes).
View the current permissions on a file using the -l
(long) flag for the ls
command:
OUTPUT
-rw-rw-r-- 1 jlchang root 879991940 May 1 00:29 SRR097977-backup.fastq
Note: your output will show your username where you see
jlchang
above.
The first part of the output for the -l
flag gives you
information about the file’s current permissions. There are ten slots in
the permissions list. The first character in this list is related to
file type, not permissions, so we’ll ignore it for now. The next three
characters relate to the permissions that the file owner has, the next
three relate to the permissions for group members, and the final three
characters specify what other users outside of your group can do with
the file. We’re going to concentrate on the three positions that deal
with your permissions (as the file owner).
Here the three positions that relate to the file owner are
rw-
. The r
means that you have permission to
read the file, the w
indicates that you have permission to
write to (i.e. make changes to) the file, and the third position is a
-
, indicating that you don’t have permission to carry out
the ability encoded by that space (this is the space where
x
or executable ability is stored, we’ll talk more about
this in a later lesson).
For more information on Unix file permissions:
https://help.rc.unc.edu/how-to-use-unix-and-linux-file-permissions/
To convert between numeric (eg. 777) and symbolic (eg. rwxrwxrwx) Unix
permissions notation:
https://chmod-calculator.com/
Our goal for now is to change permissions on this file so that you no
longer have w
or write permissions. We can do this using
the chmod
(change mode) command and subtracting
(-
) the write permission -w
.
OUTPUT
-r--r--r-- 1 jlchang root 879991940 May 1 00:29 SRR097977-backup.fastq
Note: your output will show your username where you see
jlchang
above.
Removing
To prove to ourselves that you no longer have the ability to modify
this file, try deleting it with the rm
command:
You’ll be asked if you want to override your file permissions:
OUTPUT
rm: remove write-protected regular file ‘SRR098026-backup.fastq'?
You should enter n
for no. If you enter n
(for no), the file will not be deleted. If you enter y
, you
will delete the file. This gives us an extra measure of security, as
there is one more step between us and deleting our data files.
Important: The rm
command permanently
removes the file. Be careful with this command (especially if you’re
also using wildcards). It doesn’t just nicely put the files in the
Trash. They’re really gone.
By default, rm
will not delete directories. You can tell
rm
to delete a directory using the -r
(recursive) option. Let’s delete the backup directory we just made.
Enter the following command:
This will delete not only the directory, but all files within the directory. If you have write-protected files in the directory, you will be asked whether you want to override your permission settings.
Exercise
Starting in your home directory directory, do the following:
- Make sure that you have deleted your backup directory and all files it contains.
- Create a backup of each of our FASTQ files using
cp
. (Note: You’ll need to do this individually for each of the two FASTQ files. We haven’t learned yet how to do this with a wildcard.) - Use a wildcard to move all of your backup files to a new backup directory.
- Change the permissions on all of your backup files to be write-protected.
rm -r backup
-
cp /broad/hptmp/computing_basics/untrimmed_fastq/SRR098026.fastq SRR098026-backup.fastq
andcp /broad/hptmp/computing_basics/untrimmed_fastq/SRR097977.fastq SRR097977-backup.fastq
-
mkdir backup
andmv *-backup.fastq backup
-
chmod -w backup/*-backup.fastq
It’s always a good idea to check your work withls -l backup
. You should see something like:
OUTPUT
-rw-rw-r-- 1 jlchang puppet 49504900 May 9 08:09 SRR097977-backup.fastq
-rw-rw-r-- 1 jlchang puppet 111148244 May 9 08:09 SRR098026-backup.fastq
Key Points
- You can view file contents using
less
,cat
,head
ortail
. - The commands
cp
,mv
, andmkdir
are useful for manipulating existing files and creating new directories. - You can view file permissions using
ls -l
and change permissions usingchmod
. - The
history
command and the up arrow on your keyboard can be used to repeat recently used commands.
Content from Redirection
Last updated on 2024-11-19 | Edit this page
Overview
Questions
- How can I search within files?
- How can I combine existing commands to do new things?
Objectives
- Employ the
grep
command to search for information within files. - Print the results of a command to a file.
- Construct command pipelines with two or more stages.
- Use
for
loops to run the same command for several input files.
Searching files
We discussed in a previous episode how to search within a file using
less
. We can also search within files without even opening
them, using grep
. grep
is a command-line
utility for searching plain-text files for lines matching a specific set
of characters (sometimes called a string) or a particular pattern (which
can be specified using something called regular expressions). We’re not
going to work with regular expressions in this lesson, and are instead
going to specify the strings we are searching for.
Files are staged for this workshop in /broad/hptmp but data is only allowed to stay on that temporary storage for two weeks. Let’s check that the data we want to use is in the right place.
If you see the following output, the data is where we expected it to be.
OUTPUT
/broad/hptmp/computing_basics/untrimmed_fastq/SRR097977.fastq
/broad/hptmp/computing_basics/untrimmed_fastq/SRR098026.fastq
If instead you see an error that untrimmed_fastq
is
missing, you’ll need to download the data to your home directory before
you can proceed with this episode.
OUTPUT
ls: cannot access /broad/hptmp/computing_basics/untrimmed_fastq/SRR09*: No such file or directory
Usually, it’s best to minimize the number of copies of data so
there’s a single “source of truth” to reference. If the data is
available in /broad/hptmp/computing_basics/untrimmed_fastq, we’re going
to have you make a link to the files in your home directory. Soft links
(using ln -s
) can be thought of as an alias or shortcut to
data at a different physical location.
You should skip the following instructions if you’ve downloaded
untrimmed_fastq.zip
to your home directory and unpacked it
(ie. if you followed the instruction in “What if untrimmed_fastq is
missing in /broad/hptmp/computing_basics?”)
BASH
$ cd
$ mkdir untrimmed_fastq
$ cd untrimmed_fastq
$ ln -s /broad/hptmp/computing_basics/untrimmed_fastq/SRR098026.fastq SRR098026.fastq
$ ln -s /broad/hptmp/computing_basics/untrimmed_fastq/SRR097977.fastq SRR097977.fastq
Nucleotide abbreviations
The four nucleotides that appear in DNA are abbreviated
A
, C
, T
and G
.
Unknown nucleotides are represented with the letter N
. An
N
appearing in a sequencing file represents a position
where the sequencing machine was not able to confidently determine the
nucleotide in that position. You can think of an N
as being
aNy nucleotide at that position in the DNA sequence.
Suppose we want to see how many reads in our file have really bad segments containing 10 consecutive unknown nucleotides (Ns).
Determining quality
In this lesson, we’re going to be manually searching for strings of
N
s within our sequence results to illustrate some
principles of file searching. It can be really useful to do this type of
searching to get a feel for the quality of your sequencing results,
however, in your research you will most likely use a bioinformatics tool
that has a built-in program for filtering out low-quality reads. You can
learn how to use one such tool in this
Data Carpentries lesson.
Let’s search for the string NNNNNNNNNN in the SRR098026 file (that’s 10 N’s):
This command returns a lot of output to the terminal. Every single line in the SRR098026 file that contains at least 10 consecutive Ns is printed to the terminal, regardless of how long or short the file is. We may be interested not only in the actual sequence which contains this string, but in the name (or identifier) of that sequence. We discussed in a previous lesson that the identifier line immediately precedes the nucleotide sequence for each read in a FASTQ file. We may also want to inspect the quality scores associated with each of these reads. To get all of this information, we will return the line immediately before each match and the two lines immediately after each match.
We can use the -B
argument for grep to return a specific
number of lines before each match. The -A
argument returns
a specific number of lines after each matching line. Here we want the
line before and the two lines after each matching
line, so we add -B1 -A2
to our grep command:
One of the sets of lines returned by this command is:
OUTPUT
@SRR098026.177 HWUSI-EAS1599_1:2:1:1:2025 length=35
CNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
+SRR098026.177 HWUSI-EAS1599_1:2:1:1:2025 length=35
#!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Exercise
Search for the sequence
GNATNACCACTTCC
in theSRR098026.fastq
file. Have your search return all matching lines and the name (or identifier) for each sequence that contains a match.Search for the sequence
AAGTT
in both FASTQ files. Have your search return all matching lines and the name (or identifier) for each sequence that contains a match.
grep -B1 GNATNACCACTTCC SRR098026.fastq
@SRR098026.245 HWUSI-EAS1599_1:2:1:2:801 length=35
GNATNACCACTTCCAGTGCTGANNNNNNNGGGATG
grep -B1 AAGTT *.fastq
SRR097977.fastq-@SRR097977.11 209DTAAXX_Lenski2_1_7:8:3:247:351 length=36
SRR097977.fastq:GATTGCTTTAATGAAAAAGTCATATAAGTTGCCATG
--
SRR097977.fastq-@SRR097977.67 209DTAAXX_Lenski2_1_7:8:3:544:566 length=36
SRR097977.fastq:TTGTCCACGCTTTTCTATGTAAAGTTTATTTGCTTT
--
SRR097977.fastq-@SRR097977.68 209DTAAXX_Lenski2_1_7:8:3:724:110 length=36
SRR097977.fastq:TGAAGCCTGCTTTTTTATACTAAGTTTGCATTATAA
--
SRR097977.fastq-@SRR097977.80 209DTAAXX_Lenski2_1_7:8:3:258:281 length=36
SRR097977.fastq:GTGGCGCTGCTGCATAAGTTGGGTTATCAGGTCGTT
--
SRR097977.fastq-@SRR097977.92 209DTAAXX_Lenski2_1_7:8:3:353:318 length=36
SRR097977.fastq:GGCAAAATGGTCCTCCAGCCAGGCCAGAAGCAAGTT
--
SRR097977.fastq-@SRR097977.139 209DTAAXX_Lenski2_1_7:8:3:703:655 length=36
SRR097977.fastq:TTTATTTGTAAAGTTTTGTTGAAATAAGGGTTGTAA
--
SRR097977.fastq-@SRR097977.238 209DTAAXX_Lenski2_1_7:8:3:592:919 length=36
SRR097977.fastq:TTCTTACCATCCTGAAGTTTTTTCATCTTCCCTGAT
--
SRR098026.fastq-@SRR098026.158 HWUSI-EAS1599_1:2:1:1:1505 length=35
SRR098026.fastq:GNNNNNNNNCAAAGTTGATCNNNNNNNNNTGTGCG
Redirecting output
grep
allowed us to identify sequences in our FASTQ files
that match a particular pattern. All of these sequences were printed to
our terminal screen, but in order to work with these sequences and
perform other operations on them, we will need to capture that output in
some way.
We can do this with something called “redirection”. The idea is that we are taking what would ordinarily be printed to the terminal screen and redirecting it to another location. In our case, we want to print this information to a file so that we can look at it later and use other commands to analyze this data.
The command for redirecting output to a file is
>
.
Let’s try out this command and copy all the records (including all
four lines of each record) in our FASTQ files that contain ‘NNNNNNNNNN’
to another file called bad_reads.txt
.
If you see something similar to
OUTPUT
grep: SRR098026.fasta: No such file or directory
grep is telling you it couldn’t find the specified file. Take a close
look at the error message. Grep was asked to look for a
fasta
file instead of fastq
… No wonder grep
was confused!
File extensions
You might be confused about why we’re naming our output file with a
.txt
extension. After all, it will be holding FASTQ
formatted data that we’re extracting from our FASTQ files. Won’t it also
be a FASTQ file? The answer is, yes - it will be a FASTQ file and it
would make sense to name it with a .fastq
extension.
However, using a .fastq
extension will lead us to problems
when we move to using wildcards later in this episode. We’ll point out
where this becomes important. For now, it’s good that you’re thinking
about file extensions!
The prompt should sit there a little bit, and then it should look
like nothing happened. But type ls
. You should see a new
file called bad_reads.txt
.
We can check the number of lines in our new file using a command
called wc
. wc
stands for word
count. This command counts the number of words, lines, and
characters in a file. The FASTQ file may change over time, so given the
potential for updates, make sure your file matches your instructor’s
output.
For our copy of these fastq files, wc gives the following output:
OUTPUT
537 1073 23217 bad_reads.txt
This will tell us the number of lines, words and characters in the
file. If we want only the number of lines, we can use the
-l
flag for lines
.
OUTPUT
537 bad_reads.txt
Exercise
How many sequences are there in SRR098026.fastq
?
Remember that every sequence is formed by four lines.
OUTPUT
996
Now you can divide this number by four to get the number of sequences in your fastq file.
This can be done using shell integer arithmetic
Note, this will do integer division - if you need floating point arithmetic you can use bc - an arbitrary precision calculator
OUTPUT
142.28571428571428571428
Exercise
How many sequences in SRR098026.fastq
contain at least 3
consecutive Ns?
We might want to search multiple FASTQ files for sequences that match
our search pattern. However, we need to be careful, because each time we
use the >
command to redirect output to a file, the new
output will replace the output that was already present in the file.
This is called “overwriting” and, just like you don’t want to overwrite
your video recording of your kid’s first birthday party, you also want
to avoid overwriting your data files.
OUTPUT
537 bad_reads.txt
OUTPUT
0 bad_reads.txt
Here, the output of our second call to wc
shows that we
no longer have any lines in our bad_reads.txt
file. This is
because the second file we searched (SRR097977.fastq
) does
not contain any lines that match our search sequence. So our file was
overwritten and is now empty.
We can avoid overwriting our files by using the command
>>
. >>
is known as the “append
redirect” and will append new output to the end of a file, rather than
overwriting it.
OUTPUT
537 bad_reads.txt
OUTPUT
537 bad_reads.txt
The output of our second call to wc
shows that we have
not overwritten our original data.
We can also do this with a single line of code by using a wildcard:
OUTPUT
537 bad_reads.txt
File extensions - part 2
This is where we would have trouble if we were naming our output file
with a .fastq
extension. If we already had a file called
bad_reads.fastq
(from our previous grep
practice) and then ran the command above using a .fastq
extension instead of a .txt
extension, grep
would give us a warning.
BASH
$ touch bad_reads.fastq # to simulate having an existing bad_reads.fastq file
$ grep -B1 -A2 NNNNNNNNNN *.fastq > bad_reads.fastq
OUTPUT
grep: input file ‘bad_reads.fastq' is also the output
grep
is letting you know that the output file
bad_reads.fastq
is also included in your grep
call because it matches the *.fastq
pattern. Be careful
with this file extension gotcha as it can lead to some unintended
results.
Since we might have multiple different criteria we want to search
for, creating a new output file each time has the potential to clutter
up our workspace. We also thus far haven’t been interested in the actual
contents of those files, only in the number of reads that we’ve found.
We created the files to store the reads and then counted the lines in
the file to see how many reads matched our criteria. There’s a way to do
this, however, that doesn’t require us to create these intermediate
files - the pipe command (|
).
Pipes
This is probably not a key you use very much, so let’s all take a
minute to find that key. In the UK and US keyboard layouts, and several
others, the |
character can be found using the key
combination Shift+\. The backspace key is
typically found near the Return or Enter key. This
may be different for other language-specific layouts.
What |
does is take the output that is scrolling by on
the terminal and uses that output as input to another command. When our
output was scrolling by, we might have wished we could slow it down and
look at it, like we can with less
. Well it turns out that
we can! We can redirect our output from our grep
call
through the less
command.
We can now see the output from our grep
call within the
less
interface. We can use the up and down arrows to scroll
through the output and use q
to exit less
.
If we don’t want to create a file before counting lines of output
from our grep
search, we could directly pipe the output of
the grep search to the command wc -l
. This can be helpful
for investigating your output if you are not sure you would like to save
it to a file.
Because we asked grep
for all four lines of each FASTQ
record, we need to divide the output by four to get the number of
sequences that match our search pattern. Since 802 / 4 = 200.5 and we
are expecting an integer number of records, there is something added or
missing in bad_reads.txt
. If we explore
bad_reads.txt
using less
, we might be able to
notice what is causing the uneven number of lines. Luckily, this issue
happens by the end of the file so we can also spot it with
tail
.
OUTPUT
@SRR098026.133 HWUSI-EAS1599_1:2:1:0:1978 length=35
ANNNNNNNNNTTCAGCGACTNNNNNNNNNNGTNGN
+SRR098026.133 HWUSI-EAS1599_1:2:1:0:1978 length=35
#!!!!!!!!!##########!!!!!!!!!!##!#!
--
@SRR098026.177 HWUSI-EAS1599_1:2:1:1:2025 length=35
CNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
+SRR098026.177 HWUSI-EAS1599_1:2:1:1:2025 length=35
#!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
The fifth and six lines in the output display “–” which is the
default action for grep
to separate groups of lines
matching the pattern, and indicate groups of lines which did not match
the pattern so are not displayed. To fix this issue, we can redirect the
output of grep to a second instance of grep
as follows.
BASH
$ grep -B1 -A2 NNNNNNNNNN SRR098026.fastq | grep -v '^--' > bad_reads.fastq
$ tail bad_reads.fastq
OUTPUT
+SRR098026.132 HWUSI-EAS1599_1:2:1:0:320 length=35
#!!!!!!!!!##########!!!!!!!!!!##!#!
@SRR098026.133 HWUSI-EAS1599_1:2:1:0:1978 length=35
ANNNNNNNNNTTCAGCGACTNNNNNNNNNNGTNGN
+SRR098026.133 HWUSI-EAS1599_1:2:1:0:1978 length=35
#!!!!!!!!!##########!!!!!!!!!!##!#!
@SRR098026.177 HWUSI-EAS1599_1:2:1:1:2025 length=35
CNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
+SRR098026.177 HWUSI-EAS1599_1:2:1:1:2025 length=35
#!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
The -v
option in the second grep
search
stands for --invert-match
meaning grep
will
now only display the lines which do not match the searched pattern, in
this case '^--'
. The caret (^
) is an
anchoring character matching the beginning of the line,
and the pattern has to be enclose by single quotes so grep
does not interpret the pattern as an extended option (starting with
–).
Custom grep
control
Use man grep
to read more about other options to
customize the output of grep
including extended options,
anchoring characters, and much more.
Redirecting output is often not intuitive, and can take some time to get used to. Once you’re comfortable with redirection, however, you’ll be able to combine any number of commands to do all sorts of exciting things with your data!
None of the command line programs we’ve been learning do anything all that impressive on their own, but when you start chaining them together, you can do some really powerful things very efficiently.
File manipulation and more practices with pipes
To practice a bit more with the tools we’ve added to our tool kit so far and learn a few extra ones you can follow this extra lesson which uses the SRA metadata file.
Writing for loops
Loops are key to productivity improvements through automation as they allow us to execute commands repeatedly. Similar to wildcards and tab completion, using loops also reduces the amount of typing (and typing mistakes). Loops are helpful when performing operations on groups of sequencing files, such as unzipping or trimming multiple files. We will use loops for these purposes in subsequent analyses, but will cover the basics of them for now.
When the shell sees the keyword for
, it knows to repeat
a command (or group of commands) once for each item in a list. Each time
the loop runs (called an iteration), an item in the list is assigned in
sequence to the variable, and the commands inside the
loop are executed, before moving on to the next item in the list. Inside
the loop, we call for the variable’s value by putting $
in
front of it. The $
tells the shell interpreter to treat the
variable as a variable name and substitute its value in
its place, rather than treat it as text or an external command. In shell
programming, this is usually called “expanding” the variable.
Sometimes, we want to expand a variable without any whitespace to its
right. Suppose we have a variable named foo
that contains
the text abc
, and would like to expand foo
to
create the text abcEFG
.
The interpreter is trying to expand a variable named
fooEFG
, which (probably) doesn’t exist. We can avoid this
problem by enclosing the variable name in braces ({
and
}
, also called “curly brackets”). bash
treats
the #
character as a comment character. Any text on a line
after a #
is ignored by bash when evaluating the text as
code.
Let’s write a for loop to show us the first two lines of the fastq
files we linked to earlier. You will notice the shell prompt changes
from $
to >
and back again as we were
typing in our loop. The second prompt, >
, is different
to remind us that we haven’t finished typing a complete command yet. A
semicolon, ;
, can be used to separate two commands written
on a single line.
BASH
$ rm bad_reads.fastq # lets get rid of this file extension "gotcha" file
$ for filename in *.fastq
> do
> head -n 2 ${filename}
> done
The for loop begins with the formula
for <variable> in <group to iterate over>
. In
this case, the word filename
is designated as the variable
to be used over each iteration. In our case SRR097977.fastq
and SRR098026.fastq
will be substituted for
filename
because they fit the pattern of ending with .fastq
in the directory we’ve specified.
The next line of the for loop is do
. Followed by a line
with the the code that we want to execute. We are telling the loop to
print the first two lines of each variable we iterate over.
Finally, the word done
ends the loop.
You can also write your for loop all on one line, adding a semicolon
before the key words do
and done
, like so:
After executing the loop, you should see the first two lines of both fastq files printed to the terminal. Let’s create a loop that will save this information to a file.
alternate one-liner:
When writing a loop, you will not be able to return to previous lines once you have pressed Enter. Remember that we can cancel the current command using
- Ctrl+C
If you notice a mistake that is going to prevent your loop for executing correctly.
Note that we are using >>
to append the text to
our seq_info.txt
file. If we used >
, the
seq_info.txt
file would be rewritten every time the loop
iterates, so it would only have text from the last variable used.
Instead, >>
adds to the end of the file.
Using Basename in for loops
Basename is a function in UNIX that is helpful for removing a uniform
part of a name from a list of files. In this case, we will use basename
to remove the .fastq
extension from the files that we’ve
been working with.
We see that this returns just the SRR accession, and no longer has the .fastq file extension on it.
OUTPUT
SRR097977
If we try the same thing but use .fasta
as the file
extension instead, nothing happens. This is because basename only works
when it exactly matches a string in the file.
OUTPUT
SRR097977.fastq
Basename is really powerful when used in a for loop. It allows to access just the file prefix, which you can use to name things. Let’s try this.
Inside our for loop, we create a new name variable. We call the
basename function inside the parenthesis, then give our variable name
from the for loop, in this case ${filename}
, and finally
state that .fastq
should be removed from the file name.
It’s important to note that we’re not changing the actual files, we’re
creating a new variable called name. The line > echo $name will print
to the terminal the variable name each time the for loop runs. Because
we are iterating over two files, we expect to see two lines of
output.
For this alternate one-liner, notice we also separate commands in the
do
clause with semicolons:
Exercise
Print the file prefix of all of the .txt
files in our
current directory.
One way this is really useful is to move files. Let’s rename all of
our .txt files using mv
so that they have the years on
them, which will document when we created them.
BASH
$ for filename in *.txt
> do
> name=$(basename ${filename} .txt)
> mv ${filename} ${name}_2024.txt
> done
alternate one-liner:
BASH
$ for filename in *.txt; do name=$(basename ${filename} .txt); mv ${filename} ${name}_2024.txt; done
Exercise
Remove _2024
from all of the .txt
files.
Key Points
-
grep
is a powerful search tool with many options for customization. -
>
,>>
, and|
are different ways of redirecting output. -
command > file
redirects a command’s output to a file. -
command >> file
redirects a command’s output to a file without overwriting the existing contents of the file. -
command_1 | command_2
redirects the output of the first command as input to the second command. -
for
loops are used for iteration. -
basename
gets rid of repetitive parts of names.
Content from Writing Scripts and Working with Data
Last updated on 2024-11-19 | Edit this page
Overview
Questions
- How can we automate a commonly used set of commands?
Objectives
- Use the
nano
text editor to modify text files. - Write a basic shell script.
- Use the
bash
command to execute a shell script. - Use
chmod
to make a script an executable program.
Writing files
We’ve been able to do a lot of work with files that already exist, but what if we want to write our own files? We’re not going to type in a FASTA file, but we’ll see as we go through other tutorials, there are a lot of reasons we’ll want to write a file, or edit an existing file.
To add text to files, we’re going to use a text editor called Nano.
We’re going to create a file to take notes about what we’ve been doing
with the data files in ~/untrimmed_fastq
.
This is good practice when working in bioinformatics. We can create a
file called README.txt
that describes the data files in the
directory or documents how the files in that directory were generated.
As the name suggests, it’s a file that we or others should read to
understand the information in that directory.
Let’s change our working directory to ~/untrimmed_fastq
using cd
, then run nano
to create a file
called README.txt
:
You should see something like this:
The text at the bottom of the screen shows the keyboard shortcuts for
performing various tasks in nano
. We will talk more about
how to interpret this information soon.
When we say, “nano
is a text editor,” we really do mean
“text”: nano
can only work with plain character data, not
tables, images, or any other human-friendly media. We use
nano
in examples because it is one of the least complex
text editors. However, because of this trait, nano
may not
be powerful enough or flexible enough for the work you need to do after
this workshop. On Unix systems (such as Linux and Mac OS X), many
programmers use Emacs
or Vim (both of which require more
time to learn), or a graphical editor such as Gedit. On Windows, you may
wish to use Notepad++.
Windows also has a built-in editor called notepad
that can
be run from the command line in the same way as nano
for
the purposes of this lesson.
No matter what editor you use, you will need to know the default location where it searches for files and where files are saved. If you start an editor from the shell, it will (probably) use your current working directory as its default location. If you use your computer’s start menu, the editor may want to save files in your desktop or documents directory instead. You can change this by navigating to another directory the first time you “Save As…”
Let’s type in a few lines of text. Describe what the files in this
directory are or what you’ve been doing with them. Once we’re happy with
our text, we can press Ctrl-O (press the
Ctrl or Control key and, while holding it down,
press the O key) to write our data to disk. You’ll be asked
what file we want to save this to: press Return to accept the
suggested default of README.txt
.
Once our file is saved, we can use Ctrl-X to
quit the nano
editor and return to the shell.
Control, Ctrl, or ^ Key
The Control key is also called the “Ctrl” key. There are various ways in which using the Control key may be described. For example, you may see an instruction to press the Ctrl key and, while holding it down, press the X key, described as any of:
Control-X
Control+X
Ctrl-X
Ctrl+X
^X
C-x
In nano
, along the bottom of the screen you’ll see
^G Get Help ^O WriteOut
. This means that you can use
Ctrl-G to get help and
Ctrl-O to save your file.
Now you’ve written a file. You can take a look at it with
less
or cat
, or open it up again and edit it
with nano
.
Exercise
Open README.txt
and add the date to the top of the file
and save the file.
Use nano README.txt
to open the file.
Add today’s date and then use Ctrl-X followed by
y
and Enter to save.
Writing scripts
A really powerful thing about the command line is that you can write scripts. Scripts let you save commands to run them and also lets you put multiple commands together. Though writing scripts may require an additional time investment initially, this can save you time as you run them repeatedly. Scripts can also address the challenge of reproducibility: if you need to repeat an analysis, you retain a record of your command history within the script.
One thing we will commonly want to do with sequencing results is pull out bad reads and write them to a file to see if we can figure out what’s going on with them. We’re going to look for reads with long sequences of N’s like we did before, but now we’re going to write a script, so we can run it each time we get new sequences, rather than type the code in by hand each time.
We’re going to create a new file to put this command in. We’ll call
it bad-reads-script.sh
. The sh
isn’t required,
but using that extension tells us that it’s a shell script.
Bad reads have a lot of N’s, so we’re going to look for
NNNNNNNNNN
with grep
. We want the whole FASTQ
record, so we’re also going to get the one line above the sequence and
the two lines below. We also want to look in all the files that end with
.fastq
, so we’re going to use the *
wildcard.
Custom grep
control
We introduced the -v
option in the previous episode, now we are using
-h
to “Suppress the prefixing of file names on output”
according to the documentation shown by man grep
.
Type your grep
command into the file and save it as
before. Be careful that you did not add the $
at the
beginning of the line.
Now comes the neat part. We can run this script. Type:
It will look like nothing happened, but now if you look at
scripted_bad_reads.txt
, you can see that there are now
reads in the file.
Exercise
We want the script to tell us when it’s done.
- Open
bad-reads-script.sh
and add the lineecho "Script finished!"
after thegrep
command and save the file. - Run the updated script.
$ bash bad-reads-script.sh
Script finished!
Making the script into a program
We had to type bash
because we needed to tell the
computer what program to use to run this script. Instead, we can turn
this script into its own program. We need to tell the computer that this
script is a program by making the script file executable. We can do this
by changing the file permissions. We talked about permissions in an earlier episode.
First, let’s look at the current permissions.
OUTPUT
-rw-rw-r-- 1 jlchang sequence 76 Jun 18 13:33 bad-reads-script.sh
We see that it says -rw-r--r--
. This shows that the file
can be read by any user and written to by the file owner (you) and
anyone in the sequence
group. We want to change these
permissions so that the file can be executed as a program. We use the
command chmod
like we did earlier when we removed write
permissions. Here we are adding (+
) executable permissions
(+x
).
Now let’s look at the permissions again.
OUTPUT
-rwxrwxr-x 1 jlchang sequence 76 Jun 18 13:33 bad-reads-script.sh
Now we see that it says -rwxrwxr-x
. The x
’s
that are there now tell us we can run it as a program. So, let’s try it!
We’ll need to put ./
at the beginning so the computer knows
to look here in this directory for the program.
The script should run the same way as before, but now we’ve created our very own computer program!
You can learn more about writing scripts in this Data Carpentries lesson.
Moving and Downloading Data
Often, analyses begin with moving data onto the machine where you’ll be running the analysis. Below we’ll show you some options for downloading data onto a remote server, or to move data between your computer and the cloud.
Getting data from the cloud
There are two programs that will download data from the internet to
your local machine (or a remote server): wget
and
curl
. They were designed to do slightly different tasks by
default, so you’ll need to give the programs somewhat different options
to get the same behaviour, but they are mostly interchangeable.
wget
is short for “world wide web get”, and it’s basic function is to download web pages or data at a web address.cURL
is a pun, it is supposed to be read as “see URL”, so its basic function is to display webpages or data at a web address.
Which one you need to use mostly depends on your operating system, as most computers will only have one or the other installed by default.
Let’s say you want to download some data from Ensembl. We’re going to
download a very small tab-delimited file that just tells us what data is
available on the Ensembl bacteria server. Before we can start our
download, we need to know whether we’re using curl
or
wget
.
To see which program you have, type:
which
is a BASH program that looks through everything
you have installed, and tells you what folder it is installed to. If it
can’t find the program you asked for, it returns nothing, i.e. gives you
no results.
On Mac OSX, you might see the following output:
OUTPUT
/usr/bin/curl
OUTPUT
$
This output means that you have curl
installed, but not
wget
.
Once you know whether you have curl
or
wget
, use one of the following commands to download the
file:
or
BASH
$ cd
$ curl -O ftp://ftp.ensemblgenomes.org/pub/release-37/bacteria/species_EnsemblBacteria.txt
Since we wanted to download the file rather than just view
it, we used wget
without any modifiers. With
curl
however, we had to use the -O flag, which
simultaneously tells curl
to download the page instead of
showing it to us and specifies that it should save the
file using the same name it had on the server:
species_EnsemblBacteria.txt
It’s important to note that both curl
and
wget
download to the computer that the command line belongs
to. So, if you are logged into a remote server on the command line and
execute the curl
command above in the terminal for the
remote machine, the file will be downloaded to the remote machine, not
your local one.
Moving files between your laptop and your instance
What if the data you need is on your local computer, but you need to get it into the remote server (or a cloud server)? There are also several ways to do this, but it’s always easier to start the transfer locally. This means if you’re typing into a terminal, the terminal should not be logged into your instance, it should be showing your local computer. If you’re using a transfer program, it needs to be installed on your local machine, not your instance.
Transferring Data Between your Local Machine and the Cloud
If you’re using Linux, Mac OS, or Windows with Git Bash on your local
machine, you can use scp
to upload data to your virtual
machine.
scp
stands for ‘secure copy protocol’, and is a widely
used UNIX tool for moving files between computers. The simplest way to
use scp
is to run it in your local terminal, and use it to
copy a single file:
Note that you are always running scp
locally, but that
doesn’t mean that you can only move files from your local
computer. In order to move a file from your local computer to an remote
server, the command would look like this:
To move it back to your local computer, you re-order the
to
and from
fields:
Uploading Data to your Virtual Machine with scp
Open the terminal and use the scp
command to upload a
file (e.g. local_file.txt) to the dcuser home directory:
At Broad, remote servers used for data transfer are xfer1.broadinstitute.org, xfer2.broadinstitute.org and xfer3.broadinstitute.org
Downloading Data from your Virtual Machine with scp
Let’s download a text file from our remote machine. You should have a file that contains bad reads called ~/untrimmed_fastq/scripted_bad_reads.txt.
Tip: If you are looking for another (or any really) text file in your home directory to use instead, try:
Download the bad reads file in
~/untrimmed_fastq/scripted_bad_reads.txt to your home ~/Download
directory using the following command (make sure you substitute
Remember that in both instances, the command is run from your local machine, we’ve just flipped the order of the to and from parts of the command.
If you are using Windows without Git Bash on your local machine, you
can use pscp.exe
to upload data to your virtual
machine.
If you’re using a Windows PC without Git Bash, one option is the PSCP program. This program is from a suite of tools that offers PuTTY, a freeware terminal program.
- If you haven’t done so, download PSCP from http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe
- Make sure the PSCP program is somewhere you know on your computer. In this case, your Downloads folder is appropriate.
- Open the windows PowerShell; go to your start menu/search enter the term ‘cmd’; you will be able to start the shell (the shell should start from C:\Users\your-pc-username>).
- Change to the Downloads directory:
- Locate a file on your computer that you wish to upload (be sure you
know the path). Then upload it to your remote machine (you will
need to know the name of the remote machine. At Broad, remote servers
used for data transfer are xfer1.broadinstitute.org,
xfer2.broadinstitute.org and xfer3.broadinstitute.org, and your login
credentials). You will be prompted to enter a password, and
then your upload will begin. (make sure you substitute
‘your-pc-username’ for your actual pc username and ‘
@remote.server.address’ with your username and a Broad data transfer server address)
BASH
C:\User\your-pc-username\Downloads> pscp.exe local_file.txt <username>@remote.server.address:~/
Downloading Data from your Virtual Machine with PSCP
- Follow the instructions in the Upload section to download (if needed) and access the PSCP program (steps 1-3)
- Download the text file to your current working directory
(represented by a .) using the following command (make sure you
substitute ‘your-pc-username’ for your actual pc username and
‘
@remote.server.address’ with your username and a Broad data transfer server address)
Key Points
- Scripts are a collection of commands executed together.
- Transferring information to and from virtual and local computers.
Content from Bioinformatics examples
Last updated on 2024-11-19 | Edit this page
Overview
Questions
- How can we work with files specific to the biological sciences in Unix?
Objectives
Unix/Linux provides many small tools and utilities that can easily interact with each other using their built-in input and output streams, allowing you to perform complex data manipulations on the command line without writing a formal program or script.
This bonus section provides some examples using Unix command line tools for biology-specific tasks.
Data wrangling using grep, pipes and file redirection
Background: The CHESS gene catalog curates the set of all human genes and their transcripts through analysis of GTEx RNA sequencing data and manual assessment of RefSeq and GENCODE annotations and overlap. This catalog reports a different count of protein-coding genes in the human genome compared to RefSeq and GENCODE. To identify the overlap of genes across all three annotations sets, we need the total list of protein-coding gene names by extracting them from the annotation files.
Task: generate the unique list of protein-coding gene names from the CHESS annotation file (GFF)
Download the CHESS GFF file (chess3.1.3.GRCh38.assembly.gff.gz) to your home directory and unpack it.
BASH
$ cd
$ wget https://github.com/jlchang/cb-unix-shell-lesson-template/raw/refs/heads/main/learners/files/chess3.1.3.GRCh38.assembly.gff.gz
$ gunzip chess3.1.3.GRCh38.assembly.gff.gz
Let’s look at the file, can we figure out how a protein-coding gene is represented?
OUTPUT
##gff-version 3
#!gff-spec-version 1.21
chr1 CHESS gene 11874 14409 . + . ID=CHS.1;gene_name=DDX11L1;gene_type=transcribed_pseudogene
chr1 RefSeq transcript 11874 14409 . + . ID=CHS.1.1;Parent=CHS.1;gene_name=DDX11L1;gene_type=transcribed_pseudogene;db_xref=RefSeq:NR_046018.2,GENCODE:ENST00000456328.2;assembly_id=NA;cds_adjustment_status=0;exon_adjustment_status=0;original_source=BestRefSeq
chr1 RefSeq exon 11874 12227 . + . Parent=CHS.1.1;gene_name=DDX11L1
chr1 RefSeq exon 12613 12721 . + . Parent=CHS.1.1;gene_name=DDX11L1
chr1 RefSeq exon 13221 14409 . + . Parent=CHS.1.1;gene_name=DDX11L1
chr1 CHESS gene 14362 29370 . - . ID=CHS.2;gene_name=WASH7P;gene_type=transcribed_pseudogene
chr1 RefSeq transcript 14362 29370 . - . ID=CHS.2.1;Parent=CHS.2;gene_name=WASH7P;gene_type=transcribed_pseudogene;db_xref=RefSeq:NR_024540.1;assembly_id=NA;cds_adjustment_status=0;exon_adjustment_status=0;original_source=BestRefSeq
chr1 RefSeq exon 14362 14829 . - . Parent=CHS.2.1;gene_name=WASH7P
In the file we see from the 2nd column that there are lines for features identified by CHESS and RefSeq. To get a better sense of all the different possible values, we can use Unix tools to extract and summarize for us.
We don’t want to sift through 2.6 million values so let’s use Unix’ sort command to tell us all the unique values.
OUTPUT
#!gff-spec-version 1.21
##gff-version 3
CHESS
GENCODE
MANE
RefSeq
Exercise
Look up how the sort and uniq tools work. How would you find out how many lines of each type are in the file?
After examining the file a bit more, we realize we’re probably looking for lines that have “gene_type=protein_coding” in the ninth field.
BUT we only want the genes identified by CHESS… so we can use grep to first filter for just the CHESS lines, then look for just the protein_coding lines
It seems protein coding gene names are listed in the file with the following syntax:
OUTPUT
;gene_name=DNASE1;gene_type=protein_coding
… where the gene “DNASE1” could be replaced with any gene name.
Alternative - use regular expressions to extract the gene names
To identify such a string with any gene name inserted, we recognize that a gene name may contain uppercase letters, lowercase letters, numbers, or hyphens. We therefore turn to https://regex101.com/ to see if we can devise an appropriate regular expression to identify the string above containing any gene name
grep
the file for these lines, using the regular
expression so it only reports the exact matching sequence (-o), and save
the results to a text file
BASH
grep -o ';gene_name=[a-zA-Z0-9-]*;gene_type=protein_coding' chess3.1.3.CHM13.assembly.gff | uniq > chess3.1.3_genes.txt
sed 's/^.*gene_name=//' test | sed 's/;gene_type.*$//'
Isolate individual gene names from the matching lines
Removing the parts of the file that you don’t want can be done with sed and wildcards
(This part is still rough, ran out of time. Sorry! Will fix soon.)
BASH
grep -o ';gene_name=[a-zA-Z0-9-]*;gene_type=protein_coding' chess3.1.3.CHM13.assembly.gff | uniq > newfile.txt
sed 's/;gene_name=//' newfile.txt > newnewfile.text
sed 's/;gene_type=protein_coding//' newnewfile.text > justthegenes.txt
Next time, remember that you can also look up how a file format like GFF format is structured.
Introducing h5ls, a Unix tool to peek into AnnData objects
Let’s get an example h5ad file and put it in our home directory
BASH
$ cd
$ wget https://github.com/jlchang/cb-unix-shell-lesson-template/raw/refs/heads/main/learners/files/example.h5ad
If you have an AnnData file locally AND you have the hdf5 library installed locally (which you do if you have the AnnData or ScanPy library installed), you can use the hdf5 command line tool h5ls to quickly peek inside an AnnData file. HDF5 files have two types of objects, Datasets and Groups. Example:
OUTPUT
X Dataset {700, 765}
layers Group
obs Group
obsm Group
obsp Group
raw Group
uns Group
var Group
varm Group
varp Group
Go deeper by appending a Group name to the file:
OUTPUT
G2M_score Dataset {700}
S_score Dataset {700}
bulk_labels Group
index Dataset {700}
louvain Group
n_counts Dataset {700}
n_genes Dataset {700}
percent_mito Dataset {700}
phase Group
Too focused? Get the entire directory tree for the file with h5ls -r
Too much information? Do a more focused recursive h5ls by specifying a deeper path in the object (in this example, the deeper path is ‘/obs’):
OUTPUT
> h5ls -r example.h5ad/obs
/G2M_score Dataset {700}
/S_score Dataset {700}
/bulk_labels Group
/bulk_labels/categories Dataset {10}
/bulk_labels/codes Dataset {700}
/index Dataset {700}
/louvain Group
/louvain/categories Dataset {11}
/louvain/codes Dataset {700}
/n_counts Dataset {700}
/n_genes Dataset {700}
/percent_mito Dataset {700}
/phase Group
/phase/categories Dataset {3}
/phase/codes Dataset {700}
Notice that for AnnData objects, there are some Group objects that have nested datasets named categories and codes these are often Pandas’ categorical data. You can get the unique list of categorical labels with h5dump -d:
OUTPUT
HDF5 "example.h5ad" {
DATASET "obs/phase/categories" {
DATATYPE H5T_STRING {
STRSIZE H5T_VARIABLE;
STRPAD H5T_STR_NULLTERM;
CSET H5T_CSET_UTF8;
CTYPE H5T_C_S1;
}
DATASPACE SIMPLE { ( 3 ) / ( 3 ) }
DATA {
(0): "G1", "G2M", "S"
}
ATTRIBUTE "encoding-type" {
DATATYPE H5T_STRING {
STRSIZE H5T_VARIABLE;
STRPAD H5T_STR_NULLTERM;
CSET H5T_CSET_UTF8;
CTYPE H5T_C_S1;
}
DATASPACE SCALAR
DATA {
(0): "string-array"
}
}
ATTRIBUTE "encoding-version" {
DATATYPE H5T_STRING {
STRSIZE H5T_VARIABLE;
STRPAD H5T_STR_NULLTERM;
CSET H5T_CSET_UTF8;
CTYPE H5T_C_S1;
}
DATASPACE SCALAR
DATA {
(0): "0.2.0"
}
}
}
}
Key Points
- Use common Unix tools to work with specialized file formats for biological data
- Look for less common tools that may be more efficient or more quickly accessible to increase your productivity.