Custom charts

Vilvik ships a fixed set of charts on every result page. Custom charts let you go further and plot the relationships you care about, then keep those views right on the result.

You build custom charts from the Your custom charts panel near the bottom of a result page. The panel is private to you; it does not appear on a result you share with someone else.

Building a chart¶

Click Add custom chart to open the builder. It has the controls on the left and a live preview on the right that updates as you make changes.

1. Give it a title. Optional, but it makes the saved chart easy to recognize.
2. Pick a chart type. Line, scatter, or bar. As you choose fields, the builder suggests the type that usually fits best. You can override the suggestion at any time.
3. Choose the X-axis. For most runs this is the generation, but you can pick any tracked value.
4. Add one or more series for the Y-axis. Each series is one value to plot, for example best fitness, a single gene, or a problem constant. Use Add series to overlay several on one chart.
5. Adjust display options if you want: axis labels, the legend, smoothing for line charts, and an aggregation per series (see below).

The preview reflects every change immediately, so you can settle on a chart before you save it.

What you can plot¶

The fields available depend on the run. Common ones include:

• Best fitness per generation. For multi-objective runs, each objective is offered as its own series.
• A single gene's value across generations. When the run came from the problem builder, genes carry the variable names you gave them; otherwise they are labelled by position.
• Single values such as the number of generations completed or the generation that found the best solution.
• Problem constants you defined in the problem builder.

Aggregation¶

A series normally plots one point per generation. Aggregation collapses it to a single number instead, the average, sum, minimum, or maximum across the run. This is most useful with a bar chart when you want to compare a handful of values side by side.

Where a chart is pinned¶

When you save a chart you choose where it should appear:

• This result only. Useful for a one-off view tied to a single experiment.
• Every result of this problem. The chart shows up on all results that share the same problem.
• All my results. The chart appears on every one of your results.

Vilvik works out the widest place a chart can be pinned and limits the choice to that. A chart that uses only universal values like the generation and best fitness can go anywhere. A chart that uses a specific gene or a problem constant is offered at the problem level, because those values only exist for that problem. If a pinned chart needs a value a particular result does not have, it is simply skipped on that result rather than shown broken.

Managing your charts¶

Saved charts appear as cards in the panel, separate from Vilvik's built-in charts:

• Reorder by dragging a card with its handle.
• Edit a card to reopen the builder with its settings.
• Delete a card to remove the chart.
• Export any card as an image with its download button.

For the rest of the result page, see Reading a result. To define named variables and constants that show up as chart fields, see Problem Builder.