, output_type='Figure', skip_invalid=False, engine=None)

Construct a figure from the JSON contents of a local file or readable Python object

  • file (str or readable) – A string containing the path to a local file or a read-able Python object (e.g. a pathlib.Path object or an open file descriptor)

  • output_type (type or str (default 'Figure')) – The output figure type or type name. One of: graph_objects.Figure, ‘Figure’, graph_objects.FigureWidget, ‘FigureWidget’

  • skip_invalid (bool (default False)) – False if invalid figure properties should result in an exception. True if invalid figure properties should be silently ignored.

  • engine (str (default None)) –

    The JSON decoding engine to use. One of:
    • if “json”, parse JSON using built in json module

    • if “orjson”, parse using the faster orjson module, requires the orjson package

    • if “auto” use orjson module if available, otherwise use the json module

    If not specified, the default engine is set to the current value of


Return type

Figure or FigureWidget