Partek Flow Documentation

Page tree

Versions Compared

Key

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

The Peak calling task is used to detect enriched genomic regions on reads generated from nucleic acid enrichment experiments such as ChIP-seq, DNase-seq, and MeDIP-seq etc. experiments. Partek® Flow®  Partek Flow provides a the widely used method of MACS2--model-based analysis1 (http://liulab.dfci.harvard.edu/MACS/) to find peaks , it . It can be used performed with or without control sample.

MACS2 is used to demonstrate the task setup in this manual. However, Flow also provides the MACS3 task which has the same interface. If you would like to make the switch, please talk to the Flow Admin or tech support team.

MACS2 dialog

Selecting MACS2 from the context sensitive menu will bring up the MACS2 task dialog, interface will be different depends . The interface will appear differently depending on the input aligned data node and whether there are sample attributes available in the data Data tab. If there are only two sample for instance, ChIP and mock as sample name, there is no attribute assigned to the two samples, the dialog will look like

If the selected aligned data node was imported, the reference assembly used during data alignment needs to be specified. Choose the Assembly from the drop-down list within the MACS2 dialogue (Figure 1). If the selected aligned data node was generated by Partek Flow, this option will not appear.
 

Numbered figure captions
SubtitleTextMACS2 dialog: manually add ChIP vs control pairs for peak detection
AnchorNameMACS2 dialog: no attributes

 

...

Image Added



The Effective genome size must be configured prior to running the peak caller. It refers to the size of the genomic regions that are actually mappable. This size is smaller than the actual size of an organism's whole genome because of the presence of repetitive features. They are typically about 70%-90% of the whole genome. The MACS2 authors1  have recommended presets available for four different species. Select from the drop-down list; if the alignment was performed in Partek Flow, this option will not appear.In the menu the preset that best describes the genome you are working with. They are as follows:

  • Human (Homo sapiens) – 2.7 x 109
  • Mouse (Mus musculus) – 1.87 x 109
  • C. elegans – 9 x107
  • Fruitfly (Drosophila melongaster) – 1.2 x 108

If none of these presets match your genome of interest, select Other... Then enter the effective genome size (Figure 2). The values are in base pairs (bps). Consult the MACS documentation for guidance on selecting the best effective genome size for your experiment.


Numbered figure captions
SubtitleTextSpecify other species effective genome size by manually type in the value
AnchorNameg size other

Image Added



For data where no sample attributes are specified, the peak detection pairs need to be manually defined. In the example in Figure 1, there only two samples. Under the Define pairs section, the left panel list lists all the sample names , add uploaded to the project (H3K27 and Mock).  Add one pair at a time , select ChIP sample to put in  IP by dragging the corresponding samples to either the IP panel on the top-right , choose control sample to put in or the Control panel  panel on the bottom-right. If there is no control sample samples are present in the experiment, the Control panel can be blankleave the Control panel blank. If more than one ChIP or Control samples are added, the samples will be combined (or pooled) in during the analysis. If  After defining a pair, click the Add pair button.


For data where the sample attributes are defined (Figure 3), you will have an additional option to add pairs pairing or grouping based on the attributesample attributes. For instance Figure 2 is show Figure 3 shows an example data dataset with 4 samples, 2 time pointpoints, and there in is one ChIP IP sample and one input Input sample in each time point.


Numbered figure captions
SubtitleTextExperiment example data illustrate sample with two attributes: IP and Time
AnchorNamechip

...

data table

Image Modified



When select running the MACS2 task, the default option is to use sample attribute to add multiple pairs at one button click (Figure 3)

Numbered figure captions
SubtitleTextSpecify IP vs control pairs based on sample attributes
AnchorNamechip_attribute

Image Removed

There are IP-Input pair in sample attributes will be used to define the multiple pairs (Figure 4). There is an IP-Input pair for each time point, so the pair attribute is Time; Control attribute is the attribute contains IP and input group, which is ChIP, the control term is the Pair attribute is the Time attribute. The Control attribute is the attribute that differentiates between the Input and IP groups, and in this example, it is the ChIP attribute.  Finally, the Control term is labeled as Input in the example, when click Generate pairs,


Numbered figure captions
SubtitleTextSpecify IP vs control pairs based on sample attributes
AnchorNamechip_attribute

Image Added


 Click Generate pairs and the two pairs will be automatically added to the Pairs table at once (Figure 45).



Numbered figure captions
SubtitleTextTwo IP vs input sample pairs are added in the Pairs table
AnchorNamechip_pair_table

Image Modified

If multiple pairs are added in the Pairs table, the peak detection is performed on each pair independently.


Peaks report

In the task report, each pair will generate a list of peaks displayed in a table (Figure 6). Use the drop down menu next to Peaks detected for... to select the pair.


Numbered figure captions
SubtitleTextPeaks report on each IP vs control pair
AnchorNamechip_report

Image Added

In the report table, each row is a region of a peak and includes the following information:


  • Absolute summit: base pair location of peak summit
  • Pileup: pileup height at peak summit
  • -log10(pvalue): negative log10 pvalue for the peak summit
  • Fold enrichment: fold enrichment for the peak summit against random Poisson distribution with local lambda
  • -log10(qvalue): negative log10 qvalue at peak summit
  • a peak name generated by the MACS2 algorithm

Click the browse to peak button (Image Added) to invoke chromosome view and zoom into that location.

Click the Download button at the lower-right corner to download the peaks in a text file.

References

  1. Zhang Y, Liu T, et al. Model-based Analysis of ChIP-Seq (MACS). Genome Biol.   20082008;9(9):R137.


Additional assistance


 

Rate Macro
allowUsersfalse

...