Function concat

Aggregate all the Dataframes/Series in a List of DataFrames/Series to a single DataFrame/Series.

Example

> const df1 = pl.DataFrame({"a": [1], "b": [3]});
> const df2 = pl.DataFrame({"a": [2], "b": [4]});
> pl.concat([df1, df2]);
shape: (2, 2)
┌─────┬─────┐
│ a   ┆ b   │
│ --- ┆ --- │
│ i64 ┆ i64 │
╞═════╪═════╡
│ 1   ┆ 3   │
├╌╌╌╌╌┼╌╌╌╌╌┤
│ 2   ┆ 4   │
└─────┴─────┘

> const a = pl.DataFrame({ a: ["a", "b"], b: [1, 2] });
> const b = pl.DataFrame({ c: [5, 6], d: [7, 8], e: [9, 10]});
> pl.concat([a, b], { how: "horizontal" });

shape: (2, 5)
┌─────┬─────┬─────┬─────┬──────┐
│ a   ┆ b   ┆ c   ┆ d   ┆ e    │
│ --- ┆ --- ┆ --- ┆ --- ┆ ---  │
│ str ┆ f64 ┆ f64 ┆ f64 ┆ f64  │
╞═════╪═════╪═════╪═════╪══════╡
│ a   ┆ 1.0 ┆ 5.0 ┆ 7.0 ┆ 9.0  │
│ b   ┆ 2.0 ┆ 6.0 ┆ 8.0 ┆ 10.0 │
└─────┴─────┴─────┴─────┴──────┘

> const df_d1 = pl.DataFrame({"a": [1], "b": [3]});
> const df_d2 = pl.DataFrame({"a": [2], "c": [4]});
> pl.concat([df_d1, df_d2], { how: "diagonal" });

shape: (2, 3)
┌─────┬──────┬──────┐
│ a   ┆ b    ┆ c    │
│ --- ┆ ---  ┆ ---  │
│ i64 ┆ i64  ┆ i64  │
╞═════╪══════╪══════╡
│ 1   ┆ 3    ┆ null │
│ 2   ┆ null ┆ 4    │
└─────┴──────┴──────┘
Copy