Skip to content

Plots

A novem plots represents a visual presentation of useful information. The plot covers a wide range of visuals, from simple charts to video feeds and terminal windows.

AI-assisted, human-approvednovem uses AI to review and keep our documentation up to date.

A plot displays data as a chart or table. Its data file holds the values; files under config/ control the chart type, labels, colours, and layout.

  • Charts include bars, lines, scatter plots, and maps.
  • Tables display data in rows and columns, with types for documents and e-mails.

Structure

The following paths control a plot. Start with data and config/type, then set the title, caption, and other options as needed.

plot_name                       => Name
├── config                      => Configuration options
│   ├── axis                    => Axis options
│   │   ├── location            =>
│   │   ├── anchor              =>
│   │   ├── ticks               =>
│   │   ├── domains             =>
│   │   ├── scale               =>
│   │   ├── margin              =>
│   │   ├── overlap             =>
│   │   ├── labels              =>
│   │   ├── multi               =>
│   │   ├── padding             =>
│   │   ├── offset              =>
│   │   └── range               =>
│   ├── bg                      => Plot Background related controls
│   │   ├── type                => The type of background (grid, lines)
│   │   ├── align               => Control background axis alignment
│   │   ├── stroke              => Control background stroke styles
│   │   ├── color               => Control background box and line colors
│   │   ├── index               => Which background boxes/lines to draw
│   │   ├── size                => Background sizing
│   │   └── labels              => Control background label positioning
│   ├── colors                  =>
│   │   ├── type                =>
│   │   └── colors              =>
│   ├── table                   => table specific settings
│   │   └── cell                => Format table cells
│   │       ├── align           => number alignment
│   │       ├── border          => control table borders
│   │       ├── text            => font information (weight, style, color)
│   │       ├── format          => number and text format
│   │       ├── chart           => in-cell charts
│   │       ├── overflow        => overflow behavior
│   │       ├── priority        => column priority on small screens
│   │       ├── padding         => cell padding
│   │       ├── width           => cell width
│   │       └── merge           => merge cells across cols and rows
│   ├── legend                  =>
│   │   ├── type                => The kind of legend
│   │   ├── position            => Position of the legend
│   │   ├── layout              =>
│   │   └── format              => Format of the individual legend item
│   ├── labels                  =>
│   │   └── anchor              =>
│   ├── interactive             =>
│   │   ├── format              =>
│   │   └── highlight           =>
│   ├── render                  =>
│   │   ├── template            => Template to render against
│   │   ├── scale               =>
│   │   └── overlap             => Read-only overlap report
│   ├── custom                  => Custom css/js for custom plots
│   ├── projection              => Map projection
│   ├── zoom                    => Named geographic extent
│   ├── position                => Map focus, anchor, bearing, and relative scale
│   ├── caption                 => Caption below chart
│   ├── comments                => Enable/disable comment threads
│   ├── theme                   =>
│   ├── title                   => Title of chart
│   └── type                    => bar, sbar, gbar etc...
├── complications               =>
│   ├── bands                   =>
│   │   ├── config              =>
│   │   │   └── label_position  =>
│   │   └── data                =>
│   ├── lines                   =>
│   │   ├── config              =>
│   │   │   ├── color           =>
│   │   │   ├── stroke          =>
│   │   │   └── label_position  =>
│   │   └── data                =>
│   └── marks                   =>
│       ├── config              =>
│       │   └── label_position  =>
│       └── data                =>
├── data                        => data to chart
├── description                 => Description (meta)
├── name                        => Name (meta)
├── summary                     => One-line summary (meta)
├── vars                        => Attached key metrics
├── files                       => Pre-rendered outputs (png, pdf, csv ...)
├── assets                      => Uploaded images and fonts
└── shared                      => Sharing information
    ├── +org~group              => Shared with an org group
    ├── @username~group         => Shared with a user group
    └── public                  => Shared with everyone

Note: See Size limits for the plot data limit and the response when it is exceeded. If necessary, aggregate rows, reduce the sampling frequency, or remove unused columns before uploading.

Reference

  • Config — every plot configuration path.
  • Charts — the chart types and their options.
  • Tables — table and e-mail table types.
  • Vars — plot variables for live values.