Skip to content

better interval examples #2150

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 26, 2024
+3 −13
Merged

better interval examples #2150

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 3 additions & 13 deletions docs/transforms/interval.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,18 +14,13 @@ There’s also an [**interval** scale option](../features/scales.md#scale-transf

The **interval transform** turns a quantitative or temporal *value* into a continuous extent [*start*, *stop*]. For example, if *value* is an instant in time, the interval transform could return a *start* of UTC midnight and a *stop* of the UTC midnight the following day.

The interval transform is often used for time-series bar charts. For example, consider the chart below of the daily trade volume of Apple stock. Because of the [barY mark](../marks/bar.md), the *x* scale is ordinal (*band*). And because the regularity of the data is not specified (*i.e.*, because Plot has no way of knowing that this is daily data), every distinct value must have its own label, leading to crowding. If a day were missing data, it would be difficult to spot! 👓
The interval transform is often used for time-series bar charts. For example, consider the chart below of the daily trade volume of Apple stock. Because of the [barY mark](../marks/bar.md), the *x* scale is ordinal (*band*). And because the regularity of the data is not specified (*i.e.*, because Plot has no way of knowing that this is daily data), every distinct value must have its own label, leading to crowding. If a day were missing data, it would be difficult to spot! 👓

:::plot https://observablehq.com/@observablehq/plot-band-scale-interval
```js
Plot.plot({
marginBottom: 80,
x: {
type: "band", // ⚠️ not utc
tickRotate: -90,
fontVariant: "tabular-nums",
label: null
},
x: {type: "band"}, // ⚠️ not utc
y: {
transform: (d) => d / 1e6,
label: "Daily trade volume (millions)"
Expand Down Expand Up @@ -66,12 +61,7 @@ The meaning of the **interval** mark option depends on the associated mark, such
```js
Plot.plot({
marginBottom: 80,
x: {
type: "band", // ⚠️ not utc
tickRotate: -90,
label: null,
fontVariant: "tabular-nums"
},
x: {type: "band"}, // ⚠️ not utc
y: {
grid: true,
transform: (d) => d / 1e6,
Expand Down