PFMS
 
 

   A Peak-Finder MetaServer for ChIP-seq analysis


Overview Installation User Guide Results Download About

Command Line Options

The following is a list of the available features and options (Hence: The parameters enclosed between square brackets are optional).


-i input_file Input data file path (The standard 6-column BED, BAM and SMA file formats are accepted).

-o output_label Used to label the output directory and file names.

[-control control_file.bed] Background data file path (The standard 6-column BED, BAM and SMA file formats are accepted).

[-chr chromosome] Forces PFMS to only process the specified chromosome instead of handling all the chromosomes of the input file.

[-store_results] Keeps the original files generated by the peak-finders (plus results of the spitted chromosomes when -all chr is used)

[-min_rank number] A peak is significant if it’s detected by given ¡number¿ peak-finders (the default is number of selected peak finders/2) (it should be in range of the quantity of the selected peak finders).

[-bed | -sam | -bam] Specifies the input file format (bed is the default value). The read and control files have to have the same format as specified here.

[-wig] Gives the detected peaks in WIG format while the default is BED. (please note this feature can only be used with MACS, CisGenome, FindPeaks and HPeak). For this option only -average and -quantile normalization types can be used.

[-output percentage number] The percentage of the identified peaks to be obtained (default is 100), to be used only with -wig option.

[ -voting | -minFN | -minFP] Uses the specified peak selection mechanism (the default value is voting), not to be used with -wig.

[ -quantile number | -normal [-normal_shift number]| -rank | -average | -top_rank] Specifies a normalization method for normalizing the peak-scores (the default method is quantile with value of 75).

[-parallel] Forces PFMS to execute the peak-finders in parallel (it is the default if more than two processors are available).

[-sequential] Forces PFMS to execute the peak-finders Sequentially (it is the default mode when fewer than two processors are available or the Python 2.6 or higher is not available)

[-max_cpu_use number] Sets the maximum number of processors to be used by PFMS (default is 6)

[-min_cpu number] PFMS is running in parallel mode if minimum number of processors (CPU) was available on the system (default is 2)

-min_size number] Minimum file size (in KB) of a peak-finder result in order to be included in the comparison (default is 1KB)

[-all_chr] Executes PFMS for each chromosome in a given dataset and combines the results (this is the default value)

[-cisgenome] Detects the binding sites using CisGenome

[-macs] Detects the binding sites using MACS

[-findpeaks] Detects the binding sites using Findpeaks

[-hpeak] Detects the binding sites using HPeak [18] (can be used with no presence of control data)

[-erange] Detects the binding sites using Erange [19] (can be used only with BED comparison approach)

[-sissr] Detects the binding sites using SISSRs [17] (can be used with BED comparison approach)

[-seqsite] Detects the binding sites using SeqSite [20] (can be used only with BED comparison approach)

[-help] Prints a usage message with a list of the available options.



Recommended options

In order to get the most accurate results from PFMS:
the command with this options would be: PFMetaserver -i Treat.bed -control Input.bed -o name_peaks -macs -sissr -cisgenome -store_results

Customizing the Peak Finder's Parameters

Initially, PFMS uses the default parameters of each of the selected peak-finders. Meanwhile, All the selected peak-finders can be customized through altering PFMS's configuration file.

The configuration file should be located under one of the following paths:

- PFMS-1.3/PeakFinders/pfms.conf

- /usr/local/PFMS-1.3/PeakFinders/pfms.conf

- /usr/PFMS-1.3/PeakFinders/pfms.conf


A usage example:

Assume, a ChIP-seq data file is named 'Treat.bed' and a control data is named 'Input.bed', both are located under the current working directory. The experiment goal is to find all the TFBSs in chromosome four that are identified by, at least, four peak finders out of six with using BED comparison approach and label the results with 'FoxA1 peaks'. In addition, keep results of all the peak finders.

PFMetaserver -i Treat.bed -control Input.bed -o FoxA1_peaks -macs -sissr -seqsite -cisgenome -erange -hpeak -min_rank 4 -store_results