Category

Plot


Usage

plotProfile [--matrixFile MATRIXFILE] --outFileName OUTFILENAME [--outFileSortedRegions FILE] [--outFileNameData OUTFILENAMEDATA] [--dpi DPI] [--kmeans KMEANS] [--hclust HCLUST] [--silhouette] [--help] [--version] [--averageType {mean,median,min,max,std,sum}] [--plotHeight PLOTHEIGHT] [--plotWidth PLOTWIDTH] [--plotType {lines,fill,se,std,overlapped_lines,heatmap}] [--colors COLORS [COLORS ...]] [--numPlotsPerRow NUMPLOTSPERROW] [--clusterUsingSamples CLUSTERUSINGSAMPLES [CLUSTERUSINGSAMPLES ...]] [--startLabel STARTLABEL] [--endLabel ENDLABEL] [--refPointLabel REFPOINTLABEL] [--labelRotation LABEL_ROTATION] [--regionsLabel REGIONSLABEL [REGIONSLABEL ...]] [--samplesLabel SAMPLESLABEL [SAMPLESLABEL ...]] [--plotTitle PLOTTITLE] [--yAxisLabel YAXISLABEL] [--yMin YMIN [YMIN ...]] [--yMax YMAX [YMAX ...]] [--legendLocation {best,upper-right,upper-left,upper-center,lower-left,lower-right,lower-center,center,center-left,center-right,none}] [--perGroup] [--plotFileFormat] [--verbose]


Manual

plotProfile is a tool from the deepTools suite. The information on this page is based on deepTools version 3.5.1.

–matrixFile, -m    Matrix file from the computeMatrix tool.
–outFileName, -out    File name to save the image to. The file ending will be used to determine the image format. The available options are: “png”, “eps”, “pdf” and “svg”, e.g., MyHeatmap.png.
–outFileSortedRegions    File name into which the regions are saved after skipping zeros or min/max threshold values. The order of the regions in the file follows the sorting order selected. This is useful, for example, to generate other heatmaps while keeping the sorting of the first heatmap. Example: Heatmap1sortedRegions.bed
–outFileNameData    File name to save the data underlying data for the average profile, e.g. myProfile.tab.
–dpi    Set the DPI to save the figure.
–kmeans    Number of clusters to compute. When this option is set, the matrix is split into clusters using the k-means algorithm. Only works for data that is not grouped, otherwise only the first group will be clustered. If more specific clustering methods are required, then save the underlying matrix and run the clustering using other software. The plotting of the clustering may fail with an error if a cluster has very few members compared to the total number or regions.
–hclust    Number of clusters to compute. When this option is set, then the matrix is split into clusters using the hierarchical clustering algorithm, using “ward linkage”. Only works for data that is not grouped, otherwise only the first group will be clustered. –hclust could be very slow if you have >1000 regions. In those cases, you might prefer –kmeans or if more clustering methods are required you can save the underlying matrix and run the clustering using other software. The plotting of the clustering may fail with an error if a cluster has very few members compared to the total number of regions.
–version    show program’s version number and exit
–averageType    Possible choices: mean, median, min, max, std, sum
The type of statistic that should be used for the profile. The options are: “mean”, “median”, “min”, “max”, “sum” and “std”.
–plotHeight    Plot height in cm.
–plotWidth    Plot width in cm. The minimum value is 1 cm.
–plotType    Possible choices: lines, fill, se, std, overlapped_lines, heatmap
“lines” will plot the profile line based on the average type selected. “fill” fills the region between zero and the profile curve. The fill in color is semi transparent to distinguish different profiles. “se” and “std” color the region between the profile and the standard error or standard deviation of the data. As in the case of fill, a semi-transparent color is used. “overlapped_lines” plots each region’s value, one on top of the other. “heatmap” plots a summary heatmap.
–colors    List of colors to use for the plotted lines (N.B., not applicable to ‘–plotType overlapped_lines’). Color names and html hex strings (e.g., #eeff22) are accepted. The color names should be space separated. For example, –colors red blue green
–numPlotsPerRow    Number of plots per row
–startLabel    [only for scale-regions mode] Label shown in the plot for the start of the region. Default is TSS (transcription start site), but could be changed to anything, e.g. “peak start”. Same for the –endLabel option. See below.
–endLabel    [only for scale-regions mode] Label shown in the plot for the region end. Default is TES (transcription end site).
–refPointLabel    [only for reference-point mode] Label shown in the plot for the reference-point. Default is the same as the reference point selected (e.g. TSS), but could be anything, e.g. “peak start”.
–regionsLabel, -z    Labels for the regions plotted in the heatmap. If more than one region is being plotted, a list of labels separated by spaces is required. If a label itself contains a space, then quotes are needed. For example, –regionsLabel label_1, “label 2”.
–samplesLabel    Labels for the samples plotted. The default is to use the file name of the sample. The sample labels should be separated by spaces and quoted if a label itselfcontains a space E.g. –samplesLabel label-1 “label 2”
–plotTitle, -T    Title of the plot, to be printed on top of the generated image. Leave blank for no title.
–yAxisLabel, -y    Y-axis label for the top panel.
–yMin    Minimum value for the Y-axis. Multiple values, separated by spaces can be set for each profile. If the number of yMin values is smaller thanthe number of plots, the values are recycled.
–yMax    Maximum value for the Y-axis. Multiple values, separated by spaces can be set for each profile. If the number of yMin values is smaller thanthe number of plots, the values are recycled.
–legendLocation    Possible choices: best, upper-right, upper-left, upper-center, lower-left, lower-right, lower-center, center, center-left, center-right, none
Location for the legend in the summary plot. Note that “none” does not work for the profiler.
–perGroup    The default is to plot all groups of regions by sample. Using this option instead plots all samples by group of regions. Note that this is only useful if you have multiple groups of regions. by sample rather than group.
–plotFileFormat    Possible choices: png, pdf, svg, eps
Image format type. If given, this option overrides the image format based on the plotFile ending. The available options are: “png”, “eps”, “pdf” and “svg”
–verbose    If set, warning messages and additional information are given.


Share your experience or ask a question