The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.

Intro to the qqman package

Stephen D. Turner

2023-08-23

Intro to the qqman package

The qqman package includes functions for creating manhattan plots and q-q plots from GWAS results. The gwasResults data.frame included with the package has simulated results for 16,470 SNPs on 22 chromosomes. Take a look at the data:

str(gwasResults)
'data.frame':	16470 obs. of  4 variables:
 $ SNP: chr  "rs1" "rs2" "rs3" "rs4" ...
 $ CHR: int  1 1 1 1 1 1 1 1 1 1 ...
 $ BP : int  1 2 3 4 5 6 7 8 9 10 ...
 $ P  : num  0.915 0.937 0.286 0.83 0.642 ...
head(gwasResults)
  SNP CHR BP         P
1 rs1   1  1 0.9148060
2 rs2   1  2 0.9370754
3 rs3   1  3 0.2861395
4 rs4   1  4 0.8304476
5 rs5   1  5 0.6417455
6 rs6   1  6 0.5190959
tail(gwasResults)
          SNP CHR  BP         P
16465 rs16465  22 530 0.5643702
16466 rs16466  22 531 0.1382863
16467 rs16467  22 532 0.3936999
16468 rs16468  22 533 0.1778749
16469 rs16469  22 534 0.2393020
16470 rs16470  22 535 0.2630441

How many SNPs on each chromosome?

as.data.frame(table(gwasResults$CHR))
   Var1 Freq
1     1 1500
2     2 1191
3     3 1040
4     4  945
5     5  877
6     6  825
7     7  784
8     8  750
9     9  721
10   10  696
11   11  674
12   12  655
13   13  638
14   14  622
15   15  608
16   16  595
17   17  583
18   18  572
19   19  562
20   20  553
21   21  544
22   22  535

Creating manhattan plots

Now, let’s make a basic manhattan plot.

manhattan(gwasResults)

plot of chunk unnamed-chunk-4

We can also pass in other graphical parameters. Let’s add a title (main=), increase the y-axis limit (ylim=), reduce the point size to 60% (cex=), and reduce the font size of the axis labels to 90% (cex.axis=). While we’re at it, let’s change the colors (col=), remove the suggestive and genome-wide significance lines, and supply our own labels for the chromosomes:

manhattan(gwasResults, main = "Manhattan Plot", ylim = c(0, 10), cex = 0.6, cex.axis = 0.9,
    col = c("blue4", "orange3"), suggestiveline = F, genomewideline = F, chrlabs = c(1:20,
        "P", "Q"))

plot of chunk unnamed-chunk-5

Now, let’s look at a single chromosome:

manhattan(subset(gwasResults, CHR == 1))

plot of chunk unnamed-chunk-6

Let’s highlight some SNPs of interest on chromosome 3. The 100 SNPs we’re highlighting here are in a character vector called snpsOfInterest. You’ll get a warning if you try to highlight SNPs that don’t exist.

str(snpsOfInterest)
 chr [1:100] "rs3001" "rs3002" "rs3003" "rs3004" "rs3005" "rs3006" "rs3007" ...
manhattan(gwasResults, highlight = snpsOfInterest)

plot of chunk unnamed-chunk-7

We can combine highlighting and limiting to a single chromosome, and use the xlim graphical parameter to zoom in on a region of interest (between position 200-500):

manhattan(subset(gwasResults, CHR == 3), highlight = snpsOfInterest, xlim = c(200,
    500), main = "Chr 3")

plot of chunk unnamed-chunk-8

We can also annotate SNPs based on their p-value. By default, this only annotates the top SNP per chromosome that exceeds the annotatePval threshold.

manhattan(gwasResults, annotatePval = 0.01)

plot of chunk unnamed-chunk-9

We can also annotate all SNPs that meet a threshold:

manhattan(gwasResults, annotatePval = 0.005, annotateTop = FALSE)

plot of chunk unnamed-chunk-10

Finally, the manhattan function can be used to plot any value, not just p-values. Here, we’ll simply call the function passing to the p= argument the name of the column we want to plot instead of the default “P” column. In this example, let’s create a test statistic (“zscore”), plot that instead of p-values, change the y-axis label, and remove the default log transformation. We’ll also remove the genomewide and suggestive lines because these are only meaningful if you’re plotting -log10(p-values).

# Add test statistics
gwasResults <- transform(gwasResults, zscore = qnorm(P/2, lower.tail = FALSE))
head(gwasResults)
  SNP CHR BP         P    zscore
1 rs1   1  1 0.9148060 0.1069785
2 rs2   1  2 0.9370754 0.0789462
3 rs3   1  3 0.2861395 1.0666287
4 rs4   1  4 0.8304476 0.2141275
5 rs5   1  5 0.6417455 0.4652597
6 rs6   1  6 0.5190959 0.6447396
# Make the new plot
manhattan(gwasResults, p = "zscore", logp = FALSE, ylab = "Z-score", genomewideline = FALSE,
    suggestiveline = FALSE, main = "Manhattan plot of Z-scores")

plot of chunk unnamed-chunk-11

A few notes on creating manhattan plots:

Creating Q-Q plots

Creating Q-Q plots is straightforward - simply supply a vector of p-values to the qq() function.

qq(gwasResults$P)

plot of chunk unnamed-chunk-12

We can optionally supply many other graphical parameters.

qq(gwasResults$P, main = "Q-Q plot of GWAS p-values", xlim = c(0, 7), ylim = c(0,
    12), pch = 18, col = "blue4", cex = 1.5, las = 1)

plot of chunk unnamed-chunk-13

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.