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.