vega-lite-api

vl.dsv(…values)

Define a data source for dsv format data.

The behavior of this method depends on the argument type:

• If the argument is an Array, sets the values property.
• If the argument is an Iterable, sets the values property.
• If the argument is an Object, sets the values property.
• If the argument is a String, sets the url property.
• Otherwise, sets the properties defined on the input argument(s), if provided.

dsv Method Overview

• delimiter
• name
• parse
• type
• url
• values

dsv API Reference

# dsv.delimiter(value)

The delimiter between records. The delimiter must be a single character (i.e., a single 16-bit code unit); so, ASCII delimiters are fine, but emoji delimiters are not.

# dsv.name(name)

A name for this data source. Use this name to update the data via the runtime API.

# dsv.parse(value)

If set to null, disable type inference based on the spec and only use type inference based on the data. Alternatively, a parsing directive object can be provided for explicit data types. Each property of the object corresponds to a field name, and the value to the desired data type (one of "number", "boolean", "date", or null (do not parse the field)). For example, "parse": {"modified_on": "date"} parses the modified_on field in each input record a Date value.

For "date", we parse data based using JavaScript’s Date.parse(). For Specific date formats can be provided (e.g., {foo: "date:'%m%d%Y'"}), using the d3-time-format syntax. UTC date format parsing is supported similarly (e.g., {foo: "utc:'%m%d%Y'"}). See more about UTC time

# dsv.type(value)

Type of input data: "json", "csv", "tsv", "dsv".

Default value: The default format type is determined by the extension of the file URL. If no extension is detected, "json" will be used by default.

# dsv.url(url)

A URL from which to load the data.

# dsv.values(values)

Provide loaded data values directly.

The behavior of this method depends on the argument type:

• Otherwise, sets the values property.

This site is open source. Improve this page.