Charts — Physics Pile Chart — Semiotic

Home · Getting Started · Charts · Features · Playground

This page requires JavaScript for interactive chart demos.

AI / Machine-readable docs: llms.txt · llms-full.txt · CLAUDE.md · schema.json · API Reference · Examples

View on GitHub · npx semiotic-ai for CLI access

Machine-readable page content

Canonical: https://semiotic.nteract.io/charts/physics-pile-chart

PhysicsPileChart

charts

import { PhysicsPileChart } from "semiotic/physics"

Wraps: StreamPhysicsFrame

Example

Mode

Mechanical mode generates seeded category totals without requiring input data. Use it for capacity sketches, design reviews, or empty-state demos; switch back to sample mode when real rows should determine each pile.

The faint projection overlay is the truth layer: it preserves exact category totals while the physics layer shows the units settling. Set showProjection={false}when you need an unadorned simulation.

Props

Prop	Type	Required	Default	Description
`data`	array	—	—	Rows to unitize into category piles. Optional when mode is mechanical.
`categoryAccessor`	string \| function	—	`"category"`	Categorical field that chooses the pile.
`valueAccessor`	string \| function	—	`"value"`	Numeric field converted into unit bodies.
`mode`	"sample" \| "mechanical"	—	`"sample"`	Use data values or generate a deterministic no-data unit pile.
`mechanicalCount`	number	—	`max(48, categories * 12)`	Number of generated unit bodies in mechanical mode.
`mechanicalCategories`	array	—	`["Intake", "Review", "Build", "Ship"]`	Category labels generated by mechanical mode.
`unitValue`	number	—	`1`	Value represented by one body.
`ballRadius`	number	—	`5`	Radius for each simulated unit body.
`colorBy`	string \| function	—	—	Categorical field used to color bodies.
`seed`	number	—	`1`	Deterministic simulation seed.
`showProjection`	boolean	—	`true`	Draw an exact settled-projection overlay so totals remain readable while units settle.
`sediment`	boolean	—	—	Reserved future sediment mode.
`size`	array	—	`[700, 380]`	[width, height] in pixels.
`width`	number	—	`700`	Width alias used when size is omitted.
`height`	number	—	`380`	Height alias used when size is omitted.
`hoverRadius`	number	—	`16`	Pixel hit radius for unit-body hover tooltips.
`paused`	boolean	—	`false`	Pause the simulation.
`tooltip`	boolean \| function \| object	—	`true`	Enable the default unit-body tooltip, pass a custom tooltip renderer/config, or set false to disable hover tooltips.
`frameProps`	object	—	—	Advanced StreamPhysicsFrame props.