Skip to content

facet_wrap 

facet_wrap(
    facets: str | Sequence[str],
    ncol: int | None = None,
    nrow: int | None = None,
    *,
    scales: Literal[fixed, free, free_x, free_y]
    | None = None,
    order: int = 1,
    format: str | None = None,
    drop: bool | None = None,
    dir: Literal[h, v] = "h",
    labwidth: int | Sequence[int] | None = None,
) -> FeatureSpec

Wrap one panel per level of facets into rows.

Parameters:

  • facets (str or list of str) –

    Faceting columns.

  • ncol (int, default: None ) –

    Number of columns and rows.

  • nrow (int, default: None ) –

    Number of columns and rows.

  • scales ((fixed, free, free_x, free_y), default: "fixed" ) –

    Whether panels share scales.

  • order (int or list, default: 1 ) –

    Level order per column: ascending (1), descending (-1), or data order (0).

  • format (str or list, default: None ) –

    Strip label formats.

  • drop (bool, default: None ) –

    Whether to drop empty level combinations.

  • dir ((h, v), default: "h" ) –

    Fill direction.

  • labwidth (int or list, default: None ) –

    Strip label wrap width in characters.

Returns:

  • FeatureSpec –

    The facet specification.