Up: Component summary Component

ClusterPlotCombiner

Creates scatter, line or bar plots where Y and X coordinates come from CSV files. Coordinates for the Y axis must always be provided; values for the X axis are optional. If X coordinates are missing, integers 1 to N are used. Multiple plots may be created simulateneously: each plot takes Y and X coordinates from one column in the input files "y" and "x". Columns are selected using parameters "yColumns" and "xColumns".

Each column may be plot to the same image or to different images. Creates also a pairs plot, which is each Y column ploted against all other Y columns. The X columns are discarded when using the pairs plot.

Version 1.0
Bundle flowand
Categories
Authors Kristian Ovaska (kristian.ovaska@helsinki.fi), Marko Laakso (Marko.Laakso@Helsinki.FI), Sirkku Karinen (sirkku.karinen@Helsinki.FI)
Requires R ; bitops (R-package)
Source files component.xml ClusterPlotCombiner.r
Usage Example with default values

Inputs

Name Type Mandatory Description
y CSV Mandatory Coordinates on the Y axis. Columns from this file are selected for plotting using "yColumns".
x CSV Optional Coordinates on the X axis. Columns from this file are selected for plotting using "xColumns". There must as many rows in "x" as there are in "y".
ySummary CSV Optional Coordinates on the Y axis. Columns from this file are selected for plotting using "yColumns".
xSummary CSV Optional Coordinates on the X axis. Columns from this file are selected for plotting using "xColumns". There must as many rows in "x" as there are in "y".
originalData CSV Optional Original data set, used only for the filename of the plot.
labels CSV Optional Labels for the ploted columns. This file needs to have exactly the same number of labels as there are X and Y columns. Same labels will be assigned the same color.
plotAnnotator RSource Optional R source file that is executed after the plot command. This can be used to add further elements to the plot. The current y and x values are available as numeric vectors "y.column" and "x.column". Current column names in y and x are available as strings "y.name" and "x.name". For example, "abline(h=max(y.column, na.rm=TRUE))" draws a horizontal line that intersects with the maximum Y coordinate.

Outputs

Name Type Description
out Latex The plots. The type depends on the plotType parameter.

Parameters

Name Type Default Description
caption string "" LaTeX caption of each figure. The caption may contain one or two %s placeholders, which are replaced with the current column names in "y" and "x" (if defined). Column names are not used when multiple plots are created to the same image (imageType = 'single').
colorFunction string "" Custom function for colors. Example c('red', 'blue', 'green') or rainbow(3) or rainbow(%d), in which %d is replaced with the number of different labels or columns in the plot. Default colors start from black and continue by rainbow()-function until each label or column is assigned with own color.
commonScale boolean true If true, all plots have the same limits for X and Y axes. This makes it easier to compare plots. Only relevant when multiple columns have been selected.
dpCm float 60 Dots per centimeter. Used for png-images.
drawX boolean true If false, do not print X axis ticks and numbers.
height float 11 Height of each plot in cm.
labelColumn string "" Columns in input "label" that is used. If not defined, uses the first column.
legendPosition string "off" Legend position 'bottomleft' or 'topright' etc (Can not be used with the pairs plot)
nInf float -2e100 Substitution value for infinitely small values
pInf float 2e100 Substitution value for infinitely great values
plotType string "p" Plot type p=points, l=lines, h=bars
pngImage boolean true Switch image format between png and pdf
sectionTitle string "Two dimensional plot" Title of the LaTeX section or an empty string to omit the section
sectionType string "subsection" Type of LaTeX section: usually one of section, subsection or subsubsection. No section statement is written if sectionTitle is empty.
sort boolean false If true, sort values before plotting. This creates a cumulative-like distribution plot. (Can not be used with pairs plot)
title string "%s" Image title. The caption may contain one or two %s placeholders, which are replaced with the current column names in "y" and "x" (if defined). Column names are not used when multiple plots are created to the same image (imageType = 'single').
width float 14 Width of each plot in cm.
xColumns string "*" Columns in input "x" that are plotted. The special value * includes all columns except non-numeric ones. There must be as many selected columns in X as there are in Y. Note that the files "y" and "x" may still contain a different number of columns.
xHigh float -0.000001 High bound of the X axis. The special value -0.000001 means that the bound is computed from the data.
xLabel string "x" X axis label. The label may contain one %s placeholder, which is replaced with the current column name in "x", or if not defined, in "y".
xLow float -0.000001 Low bound of the X axis. The special value -0.000001 means that the bound is computed from the data.
xTransformation string "" Numeric R expression that is used to transform X values. The X values are available as a numeric matrix (or vector) under the name "x". This is analogous to "yTransformation".
yColumns string "*" Columns in input "y" that are plotted. The special value * includes all columns except non-numeric ones.
yHigh float -0.000001 High bound of the Y axis. The special value -0.000001 means that the bound is computed from the data.
yLabel string "y" X axis label. The label may contain one %s placeholder, which is replaced with the current column name in "y".
yLow float -0.000001 Low bound of the Y axis. The special value -0.000001 means that the bound is computed from the data.
yTransformation string "" Numeric R expression that is used to transform Y values. The Y values are available as a numeric matrix (or vector) under the name "y". Only those columns are present that are selected using "yColumns". For example, "-log10(y)" transforms Y values using a negative base 10 logarithm (defined only for positive values). The expression may be any legal R expression that takes a numeric matrix (or vector) and produces a matrix (or vector) of the same size.

Generated 2018-12-17 07:42:17 by Anduril 2.0.0