Skip to content

Commit 6f0c684

Browse files
committed
Merge branch 'main' of github.com:observablehq/plot into main
2 parents ed70723 + cf68c35 commit 6f0c684

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

README.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -356,11 +356,16 @@ The *facet* option enables [faceting](https://observablehq.com/@data-workflows/p
356356
* **fx** - horizontal position
357357
* **fy** - vertical position
358358

359-
The following *facet* options are supported:
359+
Similar to [marks](#marks), faceting requires specifying data and at least one of two optional channels:
360+
361+
* facet.**data** - the data to be faceted
362+
* facet.**x** - the horizontal position; bound to the *fx* scale, which must be a *band* scale
363+
* facet.**y** - the vertical position; bound to the *fy* scale, which must be a *band* scale
364+
365+
The facet.**x** and facet.**y** channels are strictly ordinal or categorical (*i.e.*, discrete); each distinct channel value defines a facet. Quantitative data must be manually discretized for faceting, say by rounding or binning. Automatic binning for quantitative data may be added in the future. [#14](https://github.com/observablehq/plot/issues/14)
366+
367+
The following *facet* constant options are also supported:
360368

361-
* facet.**data** - the data to be split into multiple facets
362-
* facet.**x** - horizontal facet channel
363-
* facet.**y** - vertical facet channel
364369
* facet.**marginTop** - the top margin
365370
* facet.**marginRight** - the right margin
366371
* facet.**marginBottom** - the bottom margin

0 commit comments

Comments
 (0)