concat

function

def concat(items: TableFramesSpec, *, how: ConcatMethod = 'vertical') -> TableFrameSpec

Categories: union

Stack several TableFrames into one by appending their rows.

Parameters

parameter

itemsTableFramesSpec (list[TableFrame | None] | None)

The TableFrames to concatenate. None entries are skipped; None, an empty iterable, or one that is empty after skipping yields None.

parameter

howConcatMethod (Literal['vertical', 'vertical_relaxed', 'diagonal', 'diagonal_relaxed', 'horizontal', 'align', 'align_full', 'align_inner', 'align_left', 'align_right'])

How to line up columns -- "vertical" (default; every input must share the same columns and types), "vertical_relaxed" (same, but cast to a common supertype), "diagonal" (union of columns, missing ones filled with null), or "diagonal_relaxed" (diagonal plus supertype casting).

Returns

The combined TableFrame, or None when there is nothing to

Examples

concat([tf, other])

diagonal unions the columns of frames whose schemas differ, filling the gaps with null:

concat([tf, other], how="diagonal")