dataFrameFromRows

dataFrameFromRows(fields, rows, meta?): DataFrame

Defined in: packages/model-dataset/src/frame/data-frame.ts:146

Builds a frame from row-major input, which is what hand-written data and most producers naturally have.

O(r × f). Short rows are padded with null. Columns are stored as given, never packed into a typed array — DataFrameBuilder is the path that packs, because it owns its values and knows when they are complete.

Parameters

fields

readonly FieldDescriptor[]

rows

readonly readonly Value[][]

One array per row, in field order.

meta?

FrameMeta

Returns

DataFrame

Example

  const frame = dataFrameFromRows(
    [
      { name: "city", kind: "nominal" },
      { name: "population", kind: "quantitative" },
    ],
    [
      ["Lyon", 522_250],
      ["Nantes", 320_732],
    ],
  );
  frame.rowCount; // 2
  ```;

## Throws

When a row is longer than the field list.