Skip to main content

load-txt

lq.load-txt(data, delimiter: ",", comments: "#", skip-rows: 0, usecols: auto, header: false, converters: float)(source)

Parses a CSV (comma-separated values) string. This function enhances the functionality of the built-in Typst function csv with features like transforming values to numerical (or other) types, ignoring comments and selecting only part of the data.

Unlike the built-in csv function, this function returns the data as a list of columns and not as a list of rows.

Parameters

data : str​

Raw data loaded from a text file via read().

delimiter : str    default: ","​

The delimiter that separates columns in the file.

comments : str    default: "#"​

The characters that indicate the start of a single-line comment.

skip-rows : int    default: 0​

The number of leading rows to be skipped, including comments.

usecols : auto | array    default: auto​

Which columns to extract from the file. Expects an array of indices to columns to extract. If auto, all columns are extracted.

If true, the first line is interpreted as a header naming the individual columns. The result is then returned as a dictionary with the headers.

converters : function | type | dictionary    default: float​

Optional converter functions or types to use to convert the data entries. This can either be a single function or type that is applied to all columns likewise or a dictionary with column indices, or header names if enabled, as keys and functions or types as values. Through the (optional) key rest, a default converter can be specified to be used for all columns that have no explicit converter assigned.