# Estimate-and-interval series Import `HorizontalIntervalSeries` and `VerticalIntervalSeries` from `@pibbl/core/viz`. Both return ordinary Pibbl content with an interval, endpoint caps, and an estimate circle per record. They render supplied results without calculating uncertainty, weighting, pooling, or selecting a statistical method. ```tsx import { HorizontalIntervalSeries } from "@pibbl/core/viz"; const effects = [ { study: "Trial A", effect: 0.72, ciLower: 0.58, ciUpper: 0.89 }, ]; ; ``` Required props are `data`, `category`, `estimate`, `lower`, `upper`, `categoryScale`, and `valueScale`. `data` is a readonly array or signal. Accessors are field keys or synchronous `(datum, index, data)` callbacks. The categorical scale is a `PointScale` or `BarScale`; band categories use their centers. The value scale is continuous: linear, UTC, log, or symlog. Bounds and estimate map independently, including reversed ranges. The estimate is not required to lie inside the interval. Interval meaning and units belong in application labels. `defined?` excludes rows before other accessors run. Nullish/nonfinite numeric coordinates, missing categories, and categories absent from the declared domain omit the entire row before bounds validation. For included categories, finite reversed bounds throw a row-specific `RangeError`; equal bounds are allowed. Invalid log inputs throw under the scale contract. Mapping does not clamp or clip. Accessor signal reads belong to the series; accessors cannot call hooks or write signals during rendering. `style` accepts a whole-object signal and shallow field signals. Supported fields: `radius` (default 4 pixels), `capSize` (full cap length, default 8 pixels), `fill` (circle fill, default `#087f8c`), `stroke` (interval/cap/circle outline, same default), `strokeWidth` (default 1.5 pixels), `lineInteractionWidth` (defaults to stroke width), `opacity` (default 1), and `cursor`. Geometry sizes are finite and nonnegative; opacity is finite in [0, 1]. Zero radius/cap size hides that part. Per-datum styles and weight-driven marker areas are not supported by these marks. Records preserve source paint order, painting each interval and caps before its circle. The series composes ordinary Line/Circle targets, rather than allocating a hit rectangle over the row. Series event handlers receive bubbled mark events; events do not infer a datum. Use `pointerEvents="none"` for decorative marks. Compose normal application-owned row controls for selection and keyboard focus. Core transforms, explicit Clip, scheduled updates, and teardown apply. No layout, second scheduler, or inference engine is introduced. The [clinical forest plot](/playground/#/examples/composition/viz-clinical-forest) demonstrates synthetic supplied risk ratios and 95% confidence intervals, sorting, row inspection, and an application-owned accessible HTML results table. ## API details from source ### HorizontalIntervalSeries Draw supplied numeric intervals horizontally with an estimate circle per category. Missing/non-finite coordinates omit the entire row; reversed bounds reject it. Mapping does not clamp or clip; compose a Clip when required. Marks use ordinary Line/Circle targets, with series handlers receiving their bubbled events. ```ts HorizontalIntervalSeries: (props: HorizontalIntervalSeriesProps) => PibblNode ``` Related API: [HorizontalIntervalSeries](/reference/components/interval-series/), [HorizontalIntervalSeriesProps](/reference/components/interval-series/), [PibblNode](/reference/types/elements-components/#pibblnode). #### Parameters - **`props`** — Supplied data, categorical/numeric scale IDs, and shared style. #### Returns Ordinary Pibbl content in source order, interval then circle for each row. #### See also [HorizontalIntervalSeriesProps](/reference/components/interval-series/) [View source — packages/core/src/features/viz/lib/interval-series.tsx:245](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L245) ### VerticalIntervalSeries Draw supplied numeric intervals vertically with an estimate circle per category. Shares the missing-data, bounds, paint, targeting, and clipping contract of HorizontalIntervalSeries; orientation is explicit in the operation name. ```ts VerticalIntervalSeries: (props: VerticalIntervalSeriesProps) => PibblNode ``` Related API: [VerticalIntervalSeries](/reference/components/interval-series/), [VerticalIntervalSeriesProps](/reference/components/interval-series/), [PibblNode](/reference/types/elements-components/#pibblnode). #### Parameters - **`props`** — Supplied data, categorical/numeric scale IDs, and shared style. #### Returns Ordinary Pibbl content in source order, interval then circle for each row. #### See also [VerticalIntervalSeriesProps](/reference/components/interval-series/) [View source — packages/core/src/features/viz/lib/interval-series.tsx:260](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L260) ### IntervalSeriesStyle Shared local-pixel geometry and paint for estimate-and-interval marks. ```ts interface IntervalSeriesStyle ``` Related API: [IntervalSeriesStyle](/reference/components/interval-series/). #### See also [IntervalSeriesProps](/reference/components/interval-series/) [View source — packages/core/src/features/viz/lib/interval-series.tsx:22](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L22) #### Properties and methods

radius (optional)

```ts readonly radius?: number | undefined ``` Estimate circle radius in local pixels; defaults to 4. [View source — packages/core/src/features/viz/lib/interval-series.tsx:24](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L24)

capSize (optional)

```ts readonly capSize?: number | undefined ``` Full perpendicular length of each endpoint cap; defaults to 8 pixels. [View source — packages/core/src/features/viz/lib/interval-series.tsx:26](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L26)

fill (optional)

```ts readonly fill?: FillStyle | undefined ``` Related API: [FillStyle](/reference/types/styles/#fillstyle). Estimate circle fill; defaults to #087f8c. [View source — packages/core/src/features/viz/lib/interval-series.tsx:28](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L28)

stroke (optional)

```ts readonly stroke?: StrokeStyle | undefined ``` Related API: [StrokeStyle](/reference/types/styles/#strokestyle). Interval, cap, and circle outline paint; defaults to #087f8c. [View source — packages/core/src/features/viz/lib/interval-series.tsx:30](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L30)

strokeWidth (optional)

```ts readonly strokeWidth?: number | undefined ``` Visible stroke width in local pixels; defaults to 1.5. [View source — packages/core/src/features/viz/lib/interval-series.tsx:32](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L32)

lineInteractionWidth (optional)

```ts readonly lineInteractionWidth?: number | undefined ``` Stroke targeting width, independent of visible width; defaults to strokeWidth. [View source — packages/core/src/features/viz/lib/interval-series.tsx:34](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L34)

opacity (optional)

```ts readonly opacity?: number | undefined ``` Related API: [opacity](/reference/types/filters/#opacity). Shared paint opacity from zero to one; defaults to 1. [View source — packages/core/src/features/viz/lib/interval-series.tsx:36](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L36)

cursor (optional)

```ts readonly cursor?: string | undefined ``` Cursor for painted mark targets. [View source — packages/core/src/features/viz/lib/interval-series.tsx:38](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L38)

### IntervalSeriesProps Explicit supplied estimates and numeric bounds placed at categorical centers. ```ts interface IntervalSeriesProps extends PibblEventHandlers, PibblEventParticipationOptions ``` Related API: [IntervalSeriesProps](/reference/components/interval-series/), [PibblEventHandlers](/reference/types/events/#pibbleventhandlers), [PibblEventParticipationOptions](/reference/types/events/#pibbleventparticipationoptions). #### See also [HorizontalIntervalSeries](/reference/components/interval-series/) [VerticalIntervalSeries](/reference/components/interval-series/) [View source — packages/core/src/features/viz/lib/interval-series.tsx:45](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L45) #### Properties and methods

data

```ts readonly data: SignalValue ``` Related API: [SignalValue](/reference/types/signal-inputs/#signalvalue). Original records, or a signal of records; no estimation is performed. [View source — packages/core/src/features/viz/lib/interval-series.tsx:48](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L48)

category

```ts readonly category: BarCategoryAccessor ``` Related API: [BarCategoryAccessor](/reference/components/bar-series/). Property or callback supplying a category; missing/unknown categories omit rows. [View source — packages/core/src/features/viz/lib/interval-series.tsx:50](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L50)

estimate

```ts readonly estimate: LineAccessor ``` Related API: [LineAccessor](/reference/components/line-series/). Property or callback supplying the numeric point estimate. [View source — packages/core/src/features/viz/lib/interval-series.tsx:52](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L52)

lower

```ts readonly lower: LineAccessor ``` Related API: [LineAccessor](/reference/components/line-series/). Property or callback supplying the numeric lower bound. [View source — packages/core/src/features/viz/lib/interval-series.tsx:54](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L54)

upper

```ts readonly upper: LineAccessor ``` Related API: [LineAccessor](/reference/components/line-series/). Property or callback supplying the numeric upper bound. [View source — packages/core/src/features/viz/lib/interval-series.tsx:56](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L56)

categoryScale

```ts readonly categoryScale: ScaleId ``` Related API: [ScaleId](/reference/components/scale/). Ancestor PointScale or BarScale; band categories use their centers. [View source — packages/core/src/features/viz/lib/interval-series.tsx:58](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L58)

valueScale

```ts readonly valueScale: ScaleId ``` Related API: [ScaleId](/reference/components/scale/). Ancestor continuous numeric scale mapping estimate and both bounds independently. [View source — packages/core/src/features/viz/lib/interval-series.tsx:60](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L60)

defined (optional)

```ts readonly defined?: ((datum: D, index: number, data: readonly D[]) => boolean) | undefined ``` Optional synchronous predicate; excluded rows contribute no marks. ##### Parameters - **`datum`** — Original record being tested. - **`index`** — Source index of the record. - **`data`** — Complete supplied data array. ##### Returns Whether to include this record's estimate and interval. [View source — packages/core/src/features/viz/lib/interval-series.tsx:67](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L67)

style (optional)

```ts readonly style?: SignalValue; readonly capSize?: SignalValue; readonly fill?: SignalValue; readonly stroke?: SignalValue; readonly strokeWidth?: SignalValue; readonly lineInteractionWidth?: SignalValue; readonly opacity?: SignalValue; readonly cursor?: SignalValue; }>> | undefined ``` Related API: [SignalValue](/reference/types/signal-inputs/#signalvalue), [FillStyle](/reference/types/styles/#fillstyle), [StrokeStyle](/reference/types/styles/#strokestyle), [opacity](/reference/types/filters/#opacity). Shared style; whole-object and shallow field signals are observed by the series. [View source — packages/core/src/features/viz/lib/interval-series.tsx:69](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L69)

pointerEvents (optional)

```ts readonly pointerEvents?: PibblPointerEvents | undefined ``` Related API: [PibblPointerEvents](/reference/types/events/#pibblpointerevents). Whether this content participates in pointer targeting. See PibblPointerEvents. [View source — packages/core/src/lib/events/types.ts:126](/source/packages/core/src/lib/events/types-ts/#L126)

### HorizontalIntervalSeriesProps Horizontal estimate-and-interval authoring inputs. See HorizontalIntervalSeries. ```ts type HorizontalIntervalSeriesProps = IntervalSeriesProps ``` Related API: [HorizontalIntervalSeriesProps](/reference/components/interval-series/), [IntervalSeriesProps](/reference/components/interval-series/). [View source — packages/core/src/features/viz/lib/interval-series.tsx:73](/source/packages/core/src/features/viz/lib/interval-series-tsx/#L73) #### Properties and methods

data