Visualization

Click component name to see manual page

Component	Bundle	Description
BoxPlot	tools	Box plot
CircosPlot	tools	Plot genomic data using Circos
CSV2Excel	tools	Export a CSV file to Excel using formatting
GNUPlot	tools	Plot using Gnuplot
HeatMapReport	tools	Heat maps
HTMLReport	tools	Generate HTML pages from tabular data
LatexCombiner	tools	Combine LaTeX fragments into a document
LatexPDF	tools	Compile LaTeX document into PDF
LatexTemplate	tools	LaTeX header and footer
Plot2D	tools	Scatter, line and bar plots using R
PlotHTML	tools	Visualize data using HTML
VennDiagram	tools	Venn diagrams

Overview

Anduril can generate visualizations in PDF, HTML and Microsoft Excel formats. Note that visualizations components in the tools bundle have various external dependencies that need to be installed using anduril install-dep. If you are using Docker, use anduril/anduril or anduril/full because anduril/core does not have external dependencies.

In addition to the ready-made facilities, you can use external scripts to plot in your favorite plotting library, such as ggplot2 (REvaluate), Matlab (MatlabEvaluate) or matplotlib (PythonEvaluate).

Excel

CSV2Excel exports CSV files into multi-sheet Excel files and supports formatting. Is is useful for export numeric and tabular results. In the following script, we create an Excel file containing two sheets, format header row as bold and use conditional formatting on the column named QualityOK. Result: Excel file.

#!/usr/bin/env anduril

import anduril.builtin._
import anduril.tools._
import org.anduril.runtime._

object Excel {
    val data1 = INPUT("data1.csv")
    val data2 = INPUT("data2.csv")
    val style = INPUT("style.csv")
    val report = CSV2Excel(data1, data2, style = style, sheetNames = "Data 1,Data 2")
}

Style sheet (style.csv):

Sheet   Row     Column      Bold    Condition   BGColor
*       1       *           true    NA          NA
*       -1      QualityOK   NA      "== 1"      #aaffaa

PDF reports using LaTeX

Many PDF visualizers use the LaTeX document system to compile reports that can have multiple pages, embedded text, and table of contents. It is, however, possible to use individual PDF/PNG images generated by the visualization components without compiling LaTeX PDF documents. FolderExtractor can be used for extracting individual files from LaTeX folders.

In the example below, we generate a normally distributed random matrix and visualize it using box and bar plots. Result: PDF file.

#!/usr/bin/env anduril

import anduril.builtin._
import anduril.tools._
import org.anduril.runtime._

object PDF {
    val data = Randomizer(distribution = "normal", rows = 20, columns = 5)
    val boxPlot = BoxPlot(data)
    val barPlot = Plot2D(data, plotType = "bar")

    val template = LatexTemplate(title = "Anduril report", printTOC = true)
    val document = LatexCombiner(boxPlot.out, barPlot.out, sectionTitle = "Plots")
    val pdf = LatexPDF(document, header = template.header, footer = template.footer)
}