Logging and Warnings#

Vega and Vega-Lite report warnings while compiling or evaluating a chart. A conversion can succeed even though Vega dropped an invalid property or recovered from a data problem, so check these messages when a chart does not look as expected.

This examples use a logarithmic scale whose inferred domain includes zero. Save this Vega-Lite specification:

chart.vl.json
{
  "$schema": "https://vega.github.io/schema/vega-lite/v6.json",
  "data": {
    "values": [
      {"category": "A", "value": 100},
      {"category": "B", "value": 200}
    ]
  },
  "mark": "bar",
  "encoding": {
    "x": {"field": "category", "type": "nominal"},
    "y": {
      "field": "value",
      "type": "quantitative",
      "scale": {"type": "log"}
    }
  }
}

VlConvert forwards its messages to the vl_convert logger in Python’s logging module. Configure a handler before converting if the application does not already configure logging:

import logging
from pathlib import Path

import vl_convert as vlc

logging.basicConfig(
    level=logging.WARNING,
    format="%(levelname)s:%(name)s:%(message)s",
)
logging.getLogger("vl_convert").setLevel(logging.WARNING)

spec = Path("chart.vl.json").read_text(encoding="utf-8")
svg = vlc.vegalite_to_svg(spec)
Path("chart.svg").write_text(svg, encoding="utf-8")

The conversion succeeds and emits this warning:

WARNING:vl_convert:Log scale domain includes zero: [0,200]

Use INFO or DEBUG temporarily while diagnosing a problem.