@d3plus/core 4.9.0 → 4.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/es/index.js +1 -1
- package/es/internal.js +170 -9
- package/es/src/charts/Alluvial/aggregate.js +145 -0
- package/es/src/charts/Alluvial/applyLayout.js +125 -0
- package/es/src/charts/Alluvial/dimensions.js +56 -0
- package/es/src/charts/Alluvial/emit.js +73 -0
- package/es/src/charts/Alluvial/hover.js +101 -0
- package/es/src/charts/Alluvial/index.js +170 -0
- package/es/src/charts/Alluvial/layout.js +137 -0
- package/es/src/charts/Alluvial/meta.js +57 -0
- package/es/src/charts/Alluvial/titles.js +81 -0
- package/es/src/charts/ArcDiagram/applyLayout.js +386 -0
- package/es/src/charts/ArcDiagram/arcGeometry.js +275 -0
- package/es/src/charts/ArcDiagram/arcLabels.js +171 -0
- package/es/src/charts/ArcDiagram/arcLoops.js +78 -0
- package/es/src/charts/ArcDiagram/emit.js +178 -0
- package/es/src/charts/ArcDiagram/events.js +144 -0
- package/es/src/charts/ArcDiagram/index.js +215 -0
- package/es/src/charts/BarChart/index.js +14 -2
- package/es/src/charts/BoxWhisker/index.js +95 -4
- package/es/src/charts/BoxWhisker/outliers.js +68 -0
- package/es/src/charts/BoxWhisker/summary.js +83 -0
- package/es/src/charts/BoxWhisker/tooltip.js +122 -0
- package/es/src/charts/BubbleChart/emit.js +31 -0
- package/es/src/charts/BubbleChart/index.js +54 -0
- package/es/src/charts/Bullet/index.js +2 -1
- package/es/src/charts/BumpChart/index.js +5 -0
- package/es/src/charts/Calendar/emit.js +1 -1
- package/es/src/charts/Calendar/index.js +5 -3
- package/es/src/charts/Candlestick/aggregate.js +11 -1
- package/es/src/charts/Candlestick/buffer.js +6 -4
- package/es/src/charts/Candlestick/index.js +7 -6
- package/es/src/charts/Chord/applyLayout.js +56 -69
- package/es/src/charts/Chord/emit.js +55 -24
- package/es/src/charts/Chord/index.js +17 -12
- package/es/src/charts/Chord/labels.js +105 -0
- package/es/src/charts/Donut/index.js +5 -11
- package/es/src/charts/Dumbbell/index.js +2 -4
- package/es/src/charts/Funnel/index.js +2 -1
- package/es/src/charts/Gantt/applyLayout.js +162 -0
- package/es/src/charts/Gantt/emit.js +142 -0
- package/es/src/charts/Gantt/ganttDecor.js +207 -0
- package/es/src/charts/Gantt/ganttGeometry.js +107 -0
- package/es/src/charts/Gantt/ganttLabels.js +85 -0
- package/es/src/charts/Gantt/ganttRows.js +111 -0
- package/es/src/charts/Gantt/ganttTooltip.js +136 -0
- package/es/src/charts/Gantt/index.js +219 -0
- package/es/src/charts/Gauge/index.js +2 -1
- package/es/src/charts/Geomap/applyLayout.js +90 -49
- package/es/src/charts/Geomap/basemapTheme.js +3 -48
- package/es/src/charts/Geomap/emit.js +19 -2
- package/es/src/charts/Geomap/flowEmit.js +132 -0
- package/es/src/charts/Geomap/flowEvents.js +86 -0
- package/es/src/charts/Geomap/flowFields.js +91 -0
- package/es/src/charts/Geomap/flowGeometry.js +225 -0
- package/es/src/charts/Geomap/flowLinks.js +239 -0
- package/es/src/charts/Geomap/geoCache.js +180 -0
- package/es/src/charts/Geomap/globeKeys.js +131 -0
- package/es/src/charts/Geomap/globeRotate.js +208 -0
- package/es/src/charts/Geomap/index.js +60 -19
- package/es/src/charts/Geomap/pointLabels.js +107 -0
- package/es/src/charts/Hexbin/binning.js +103 -0
- package/es/src/charts/Hexbin/buffer.js +33 -0
- package/es/src/charts/Hexbin/contourLabels.js +234 -0
- package/es/src/charts/Hexbin/contours.js +48 -0
- package/es/src/charts/Hexbin/emit.js +142 -0
- package/es/src/charts/Hexbin/index.js +204 -0
- package/es/src/charts/Hexbin/layers.js +212 -0
- package/es/src/charts/Hexbin/settings.js +86 -0
- package/es/src/charts/Hexbin/tooltip.js +77 -0
- package/es/src/charts/Histogram/binData.js +31 -4
- package/es/src/charts/Histogram/index.js +37 -16
- package/es/src/charts/Histogram/labels.js +18 -0
- package/es/src/charts/Icicle/index.js +3 -3
- package/es/src/charts/LinePlot/index.js +7 -0
- package/es/src/charts/Marimekko/index.js +7 -4
- package/es/src/charts/Matrix/index.js +3 -2
- package/es/src/charts/Network/applyLayout.js +138 -94
- package/es/src/charts/Network/bundle.js +81 -0
- package/es/src/charts/Network/clusterLabels.js +423 -0
- package/es/src/charts/Network/clusters.js +290 -0
- package/es/src/charts/Network/emit.js +253 -70
- package/es/src/charts/Network/graph.js +117 -0
- package/es/src/charts/Network/graphFluent.js +79 -0
- package/es/src/charts/Network/index.js +93 -108
- package/es/src/charts/Network/minNodeDistance.js +64 -0
- package/es/src/charts/Network/polygonRows.js +44 -0
- package/es/src/charts/Pack/index.js +7 -2
- package/es/src/charts/Pie/applyLayout.js +86 -27
- package/es/src/charts/Pie/arcFit.js +152 -0
- package/es/src/charts/Pie/curvedLabels.js +134 -0
- package/es/src/charts/Pie/emit.js +43 -96
- package/es/src/charts/Pie/index.js +66 -32
- package/es/src/charts/Pie/labelRoom.js +154 -0
- package/es/src/charts/Pie/outsideLabels.js +224 -0
- package/es/src/charts/Pie/outsideNodes.js +267 -0
- package/es/src/charts/Pie/pieLabels.js +137 -0
- package/es/src/charts/Pie/sectorBox.js +223 -0
- package/es/src/charts/Pie/straightLabels.js +96 -0
- package/es/src/charts/Pie/straightLayout.js +215 -0
- package/es/src/charts/Plot/alongLegend.js +76 -0
- package/es/src/charts/Plot/areaLabelsAlong.js +333 -0
- package/es/src/charts/Plot/axisHover.js +180 -0
- package/es/src/charts/Plot/axisHoverAnchors.js +174 -0
- package/es/src/charts/Plot/axisHoverScene.js +203 -0
- package/es/src/charts/Plot/axisValues.js +43 -0
- package/es/src/charts/Plot/barHitArea.js +81 -0
- package/es/src/charts/Plot/barLabelFit.js +123 -0
- package/es/src/charts/Plot/barWidth.js +61 -13
- package/es/src/charts/Plot/circleLabels.js +98 -0
- package/es/src/charts/Plot/confidenceConfig.js +2 -2
- package/es/src/charts/Plot/connectGaps.js +237 -0
- package/es/src/charts/Plot/connectGapsScene.js +188 -0
- package/es/src/charts/Plot/draw.js +14 -4
- package/es/src/charts/Plot/fillBetween.js +2 -1
- package/es/src/charts/Plot/forecastScene.js +3 -4
- package/es/src/charts/Plot/index.js +42 -15
- package/es/src/charts/Plot/labelPlacement.js +10 -2
- package/es/src/charts/Plot/lineLabelEmit.js +82 -0
- package/es/src/charts/Plot/lineLabelSides.js +51 -0
- package/es/src/charts/Plot/lineLabelSpread.js +65 -0
- package/es/src/charts/Plot/lineLabelsAlong.js +282 -0
- package/es/src/charts/Plot/openDomainEnds.js +2 -5
- package/es/src/charts/Plot/pipeline.js +71 -22
- package/es/src/charts/Plot/pipelineAxisLayout.js +42 -8
- package/es/src/charts/Plot/pipelineDomains.js +23 -6
- package/es/src/charts/Plot/pipelineLineLabels.js +145 -53
- package/es/src/charts/Plot/pipelineScales.js +40 -8
- package/es/src/charts/Plot/plotFacet.js +12 -1
- package/es/src/charts/Plot/plotInit.js +49 -5
- package/es/src/charts/Plot/plotRangeBreaks.js +85 -0
- package/es/src/charts/Plot/plotZoom.js +15 -6
- package/es/src/charts/Plot/referenceDomains.js +133 -0
- package/es/src/charts/Plot/shapeDefaults.js +14 -9
- package/es/src/charts/Plot/sharedHoverScene.js +50 -31
- package/es/src/charts/Plot/sharedTooltip.js +19 -7
- package/es/src/charts/Plot/stackHelpers.js +13 -1
- package/es/src/charts/Plot/stackLegendOrder.js +176 -0
- package/es/src/charts/Plot/stackShareTooltip.js +9 -4
- package/es/src/charts/Plot/stackThreshold.js +154 -0
- package/es/src/charts/Plot/trendLabels.js +183 -0
- package/es/src/charts/Plot/trendLines.js +1 -0
- package/es/src/charts/Plot/trendScene.js +6 -3
- package/es/src/charts/Plot/trendTooltip.js +5 -1
- package/es/src/charts/PolarArea/index.js +5 -4
- package/es/src/charts/Priestley/applyLayout.js +14 -20
- package/es/src/charts/Priestley/index.js +4 -34
- package/es/src/charts/Priestley/timeAxis.js +100 -0
- package/es/src/charts/Pyramid/index.js +4 -2
- package/es/src/charts/Radar/axisDecorations.js +49 -12
- package/es/src/charts/Radar/curvedLabels.js +187 -0
- package/es/src/charts/Radar/index.js +5 -5
- package/es/src/charts/RadialBar/curvedLabels.js +111 -0
- package/es/src/charts/RadialBar/emit.js +4 -1
- package/es/src/charts/RadialBar/index.js +18 -10
- package/es/src/charts/RadialBar/trackLayout.js +43 -13
- package/es/src/charts/RadialMatrix/index.js +6 -9
- package/es/src/charts/Rings/applyLayout.js +41 -24
- package/es/src/charts/Rings/emit.js +174 -58
- package/es/src/charts/Rings/index.js +65 -30
- package/es/src/charts/Rings/ringsGraph.js +28 -9
- package/es/src/charts/Rings/ringsLoops.js +73 -0
- package/es/src/charts/Rings/ringsParallel.js +166 -0
- package/es/src/charts/Sankey/applyLayout.js +116 -39
- package/es/src/charts/Sankey/circularLayout.js +208 -0
- package/es/src/charts/Sankey/circularLinks.js +301 -0
- package/es/src/charts/Sankey/emit.js +164 -94
- package/es/src/charts/Sankey/index.js +75 -77
- package/es/src/charts/Sankey/labels.js +80 -0
- package/es/src/charts/Sankey/ribbons.js +88 -0
- package/es/src/charts/Sankey/sankeyCycles.js +117 -0
- package/es/src/charts/Sankey/sankeyLayout.js +8 -3
- package/es/src/charts/Sankey/sankeyLinks.js +47 -0
- package/es/src/charts/Scatter/index.js +25 -0
- package/es/src/charts/SlopeChart/index.js +116 -0
- package/es/src/charts/SlopeChart/slope.js +95 -0
- package/es/src/charts/Streamgraph/index.js +51 -0
- package/es/src/charts/Sunburst/curvedLabels.js +74 -0
- package/es/src/charts/Sunburst/emit.js +74 -63
- package/es/src/charts/Sunburst/index.js +3 -3
- package/es/src/charts/Tree/index.js +2 -6
- package/es/src/charts/Treemap/applyLayout.js +14 -1
- package/es/src/charts/Treemap/emit.js +8 -2
- package/es/src/charts/Treemap/emitGroupHeaders.js +104 -0
- package/es/src/charts/Treemap/groupHeaders.js +95 -0
- package/es/src/charts/Treemap/index.js +17 -7
- package/es/src/charts/Treemap/thresholdFunction.js +11 -9
- package/es/src/charts/Violin/inner.js +3 -5
- package/es/src/charts/Waffle/index.js +4 -2
- package/es/src/charts/Waffle/tooltip.js +6 -2
- package/es/src/charts/Waterfall/index.js +4 -2
- package/es/src/charts/definition/makeChart.js +20 -5
- package/es/src/charts/drawSteps/backControl.js +17 -5
- package/es/src/charts/drawSteps/gestureHover.js +79 -0
- package/es/src/charts/drawSteps/minimap.js +6 -5
- package/es/src/charts/drawSteps/minimapMarkup.js +25 -9
- package/es/src/charts/drawSteps/saveChart.js +176 -0
- package/es/src/charts/drawSteps/saveControl.js +148 -0
- package/es/src/charts/drawSteps/saveControlMarkup.js +104 -0
- package/es/src/charts/drawSteps/searchControls.js +2 -1
- package/es/src/charts/drawSteps/searchControlsMarkup.js +11 -2
- package/es/src/charts/drawSteps/tableViewMarkup.js +18 -11
- package/es/src/charts/drawSteps/topLeftControls.js +3 -1
- package/es/src/charts/drawSteps/topLeftControlsMarkup.js +1 -1
- package/es/src/charts/drawSteps/zoomControls.js +21 -5
- package/es/src/charts/events/click.legend.js +7 -2
- package/es/src/charts/events/click.shape.js +38 -2
- package/es/src/charts/events/mouseenter.js +9 -0
- package/es/src/charts/events/mousemove.legend.js +3 -0
- package/es/src/charts/events/mousemove.shape.js +12 -4
- package/es/src/charts/facet/drawFacets.js +14 -5
- package/es/src/charts/facet/facetConfig.js +2 -2
- package/es/src/charts/facet/facetData.js +2 -2
- package/es/src/charts/features/annotationFrame.js +179 -0
- package/es/src/charts/features/annotationText.js +83 -0
- package/es/src/charts/features/annotationTypes.js +10 -0
- package/es/src/charts/features/attributionFeature.js +6 -11
- package/es/src/charts/features/axes.js +9 -7
- package/es/src/charts/features/axesFinal.js +26 -4
- package/es/src/charts/features/axesMeasure.js +61 -6
- package/es/src/charts/features/calloutLayout.js +121 -0
- package/es/src/charts/features/calloutScene.js +155 -0
- package/es/src/charts/features/chartGeometry.js +1 -1
- package/es/src/charts/features/circleLabelPlacement.js +297 -0
- package/es/src/charts/features/circleLabels.js +207 -0
- package/es/src/charts/features/colorScaleBucket.js +19 -1
- package/es/src/charts/features/colorScaleHover.js +70 -0
- package/es/src/charts/features/colorScaleValue.js +97 -0
- package/es/src/charts/features/curvedArrows.js +158 -0
- package/es/src/charts/features/edgeArrows.js +160 -4
- package/es/src/charts/features/edgeBundling.js +442 -0
- package/es/src/charts/features/edgeBundlingSmooth.js +117 -0
- package/es/src/charts/features/ensureZoomDom.js +32 -8
- package/es/src/charts/features/features.js +45 -15
- package/es/src/charts/features/featuresColorScale.js +62 -8
- package/es/src/charts/features/featuresLegend.js +21 -32
- package/es/src/charts/features/legendKeys.js +64 -0
- package/es/src/charts/features/lineLabels.js +55 -46
- package/es/src/charts/features/linkBundle.js +19 -0
- package/es/src/charts/features/linkColor.js +72 -0
- package/es/src/charts/features/linkFields.js +86 -0
- package/es/src/charts/features/linkFocus.js +118 -0
- package/es/src/charts/features/linkInteraction.js +312 -0
- package/es/src/charts/features/linkKeys.js +20 -0
- package/es/src/charts/features/linkLabelGeometry.js +209 -0
- package/es/src/charts/features/linkLabelPath.js +162 -0
- package/es/src/charts/features/linkLabels.js +340 -0
- package/es/src/charts/features/linkWidths.js +32 -0
- package/es/src/charts/features/pathLabelGeometry.js +232 -0
- package/es/src/charts/features/pathLabels.js +50 -0
- package/es/src/charts/features/plotAnnotations.js +68 -17
- package/es/src/charts/features/plotPaint.js +42 -15
- package/es/src/charts/features/polyline.js +129 -0
- package/es/src/charts/features/referenceAnnotations.js +403 -0
- package/es/src/charts/features/referenceLabelPlacement.js +106 -0
- package/es/src/charts/features/ringLabelNodes.js +93 -0
- package/es/src/charts/features/ringLabels.js +222 -0
- package/es/src/charts/features/sceneBounds.js +26 -6
- package/es/src/charts/features/selfLoops.js +306 -0
- package/es/src/charts/features/shapeEmit.js +67 -30
- package/es/src/charts/features/shareKey.js +15 -0
- package/es/src/charts/features/sharedFields.js +15 -2
- package/es/src/charts/features/textHalo.js +29 -0
- package/es/src/charts/features/thresholdMembers.js +71 -0
- package/es/src/charts/helpers/densityChart.js +3 -1
- package/es/src/charts/helpers/valueTitle.js +6 -3
- package/es/src/charts/index.js +8 -0
- package/es/src/charts/partition/chartFields.js +6 -5
- package/es/src/charts/partition/hierarchy.js +2 -0
- package/es/src/charts/partition/interaction.js +9 -5
- package/es/src/charts/partition/zoom.js +7 -6
- package/es/src/charts/pipeline/insetPlacement.js +14 -6
- package/es/src/charts/pipeline/preDrawData.js +77 -13
- package/es/src/charts/pipeline/runVizPipeline.js +5 -0
- package/es/src/charts/pipeline/vizDraw.js +40 -29
- package/es/src/charts/pipeline/vizPreDraw.js +29 -18
- package/es/src/charts/plotBuffers/discreteBuffer.js +7 -4
- package/es/src/charts/polar/config.js +2 -3
- package/es/src/charts/viz/Viz.js +82 -44
- package/es/src/charts/viz/VizBase.js +47 -19
- package/es/src/charts/viz/backgroundInk.js +13 -7
- package/es/src/charts/viz/dataPoller.js +52 -0
- package/es/src/charts/viz/focusRing.js +104 -0
- package/es/src/charts/viz/focusTargets.js +208 -0
- package/es/src/charts/viz/groupRow.js +35 -0
- package/es/src/charts/viz/history.js +74 -0
- package/es/src/charts/viz/interactionOpacity.js +19 -5
- package/es/src/charts/viz/keyboardNav.js +297 -0
- package/es/src/charts/viz/keyboardNavHost.js +95 -0
- package/es/src/charts/viz/loaderFormat.js +114 -0
- package/es/src/charts/viz/missingFields.js +123 -0
- package/es/src/charts/viz/mountTarget.js +9 -0
- package/es/src/charts/viz/nearestHover.js +183 -0
- package/es/src/charts/viz/nearestHoverSurface.js +92 -0
- package/es/src/charts/viz/ordinalColor.js +14 -12
- package/es/src/charts/viz/pageTheme.js +83 -0
- package/es/src/charts/viz/pointTooltipAnchor.js +59 -0
- package/es/src/charts/viz/pointVoronoi.js +124 -0
- package/es/src/charts/viz/reducedMotion.js +27 -0
- package/es/src/charts/viz/reportHandlerError.js +10 -0
- package/es/src/charts/viz/shapeClassTargets.js +18 -2
- package/es/src/charts/viz/simpleHover.js +2 -0
- package/es/src/charts/viz/vizClassName.js +31 -0
- package/es/src/charts/viz/vizDataPolling.js +172 -0
- package/es/src/charts/viz/vizDefaults.js +81 -23
- package/es/src/charts/viz/vizFields.js +53 -2
- package/es/src/charts/viz/vizRender.js +49 -28
- package/es/src/charts/viz/vizTheme.js +96 -0
- package/es/src/charts/viz/vizVisibility.js +14 -0
- package/es/src/components/Axis/Axis.js +34 -0
- package/es/src/components/Axis/AxisBottom.js +1 -0
- package/es/src/components/Axis/AxisLeft.js +1 -0
- package/es/src/components/Axis/AxisRight.js +1 -0
- package/es/src/components/Axis/AxisTop.js +1 -0
- package/es/src/components/Axis/axisBreak.js +4 -1
- package/es/src/components/Axis/axisDefaults.js +8 -10
- package/es/src/components/Axis/axisLabelAngle.js +175 -0
- package/es/src/components/Axis/axisLabelThinning.js +13 -4
- package/es/src/components/Axis/axisLayout.js +86 -19
- package/es/src/components/Axis/axisLayoutLabels.js +66 -13
- package/es/src/components/Axis/axisLayoutScale.js +10 -1
- package/es/src/components/Axis/axisRangeBreaks.js +77 -0
- package/es/src/components/Axis/axisRender.js +38 -9
- package/es/src/components/Axis/axisRounding.js +15 -4
- package/es/src/components/Axis/axisSlantWrap.js +39 -0
- package/es/src/components/Axis/brokenTimeScale.js +196 -0
- package/es/src/components/Axis/powTicks.js +73 -0
- package/es/src/components/Axis/rangeBreaks.js +201 -0
- package/es/src/components/Axis/timeValues.js +19 -4
- package/es/src/components/ColorScale/ColorScale.js +42 -36
- package/es/src/components/ColorScale/bucketBounds.js +64 -0
- package/es/src/components/ColorScale/colorScaleHoverMark.js +327 -0
- package/es/src/components/ColorScale/colorScaleRender.js +25 -1
- package/es/src/components/ColorScale/colorScaleScale.js +43 -24
- package/es/src/components/ColorScale/colorScaleType.js +26 -0
- package/es/src/components/Legend/Legend.js +3 -0
- package/es/src/components/Legend/legendConfig.js +2 -6
- package/es/src/components/SizeLegend/SizeLegend.js +1 -0
- package/es/src/components/TextBox.js +31 -65
- package/es/src/components/Timeline/Timeline.js +54 -54
- package/es/src/components/Timeline/brushSpan.js +78 -0
- package/es/src/components/Timeline/timelineConfig.js +27 -10
- package/es/src/components/Timeline/timelineMode.js +26 -0
- package/es/src/components/Timeline/timelineRender.js +51 -9
- package/es/src/components/Tooltip.js +28 -13
- package/es/src/components/fontStack.js +20 -0
- package/es/src/components/textBoxLayout.js +58 -21
- package/es/src/components/textBoxPath.js +73 -0
- package/es/src/components/textBoxScene.js +223 -0
- package/es/src/components/textBoxWords.js +70 -0
- package/es/src/shapes/Area.js +1 -0
- package/es/src/shapes/Bar.js +1 -0
- package/es/src/shapes/Box.js +67 -79
- package/es/src/shapes/Circle.js +1 -0
- package/es/src/shapes/Line.js +1 -0
- package/es/src/shapes/Path.js +1 -0
- package/es/src/shapes/Rect.js +1 -0
- package/es/src/shapes/Shape.js +1 -0
- package/es/src/shapes/Whisker.js +1 -0
- package/es/src/shapes/boxOutlierShape.js +19 -0
- package/es/src/shapes/boxStats.js +35 -0
- package/es/src/shapes/boxStyle.js +78 -0
- package/es/src/shapes/boxSummary.js +174 -0
- package/es/src/shapes/shapeStandalone.js +2 -0
- package/es/src/utils/BaseClass.js +44 -12
- package/es/src/utils/className.js +78 -0
- package/es/src/utils/configPrep.js +2 -1
- package/es/src/utils/configWarnings.js +25 -0
- package/es/src/utils/constant.js +13 -1
- package/es/src/utils/displayName.js +12 -0
- package/es/src/utils/fieldAccessor.js +31 -0
- package/es/src/utils/paintComponentScene.js +2 -0
- package/es/src/utils/theme.js +190 -0
- package/es/src/utils/themeInk.js +68 -0
- package/package.json +14 -10
- package/types/index.d.ts +8 -2
- package/types/internal.d.ts +253 -9
- package/types/src/charts/Alluvial/aggregate.d.ts +98 -0
- package/types/src/charts/Alluvial/applyLayout.d.ts +67 -0
- package/types/src/charts/Alluvial/dimensions.d.ts +40 -0
- package/types/src/charts/Alluvial/emit.d.ts +9 -0
- package/types/src/charts/Alluvial/hover.d.ts +31 -0
- package/types/src/charts/Alluvial/index.d.ts +27 -0
- package/types/src/charts/Alluvial/layout.d.ts +70 -0
- package/types/src/charts/Alluvial/meta.d.ts +54 -0
- package/types/src/charts/Alluvial/titles.d.ts +33 -0
- package/types/src/charts/ArcDiagram/applyLayout.d.ts +70 -0
- package/types/src/charts/ArcDiagram/arcGeometry.d.ts +150 -0
- package/types/src/charts/ArcDiagram/arcLabels.d.ts +89 -0
- package/types/src/charts/ArcDiagram/arcLoops.d.ts +48 -0
- package/types/src/charts/ArcDiagram/emit.d.ts +23 -0
- package/types/src/charts/ArcDiagram/events.d.ts +28 -0
- package/types/src/charts/ArcDiagram/index.d.ts +28 -0
- package/types/src/charts/BoxWhisker/index.d.ts +3 -1
- package/types/src/charts/BoxWhisker/outliers.d.ts +25 -0
- package/types/src/charts/BoxWhisker/summary.d.ts +39 -0
- package/types/src/charts/BoxWhisker/tooltip.d.ts +36 -0
- package/types/src/charts/BubbleChart/emit.d.ts +20 -0
- package/types/src/charts/BubbleChart/index.d.ts +16 -0
- package/types/src/charts/Candlestick/aggregate.d.ts +6 -0
- package/types/src/charts/Chord/applyLayout.d.ts +3 -0
- package/types/src/charts/Chord/labels.d.ts +66 -0
- package/types/src/charts/Donut/index.d.ts +2 -1
- package/types/src/charts/Gantt/applyLayout.d.ts +64 -0
- package/types/src/charts/Gantt/emit.d.ts +17 -0
- package/types/src/charts/Gantt/ganttDecor.d.ts +41 -0
- package/types/src/charts/Gantt/ganttGeometry.d.ts +57 -0
- package/types/src/charts/Gantt/ganttLabels.d.ts +41 -0
- package/types/src/charts/Gantt/ganttRows.d.ts +84 -0
- package/types/src/charts/Gantt/ganttTooltip.d.ts +57 -0
- package/types/src/charts/Gantt/index.d.ts +36 -0
- package/types/src/charts/Geomap/applyLayout.d.ts +8 -0
- package/types/src/charts/Geomap/basemapTheme.d.ts +2 -19
- package/types/src/charts/Geomap/emit.d.ts +2 -2
- package/types/src/charts/Geomap/flowEmit.d.ts +35 -0
- package/types/src/charts/Geomap/flowEvents.d.ts +20 -0
- package/types/src/charts/Geomap/flowFields.d.ts +7 -0
- package/types/src/charts/Geomap/flowGeometry.d.ts +91 -0
- package/types/src/charts/Geomap/flowLinks.d.ts +97 -0
- package/types/src/charts/Geomap/geoCache.d.ts +47 -0
- package/types/src/charts/Geomap/globeKeys.d.ts +41 -0
- package/types/src/charts/Geomap/globeRotate.d.ts +70 -0
- package/types/src/charts/Geomap/index.d.ts +3 -0
- package/types/src/charts/Geomap/pointLabels.d.ts +24 -0
- package/types/src/charts/Hexbin/binning.d.ts +64 -0
- package/types/src/charts/Hexbin/buffer.d.ts +18 -0
- package/types/src/charts/Hexbin/contourLabels.d.ts +95 -0
- package/types/src/charts/Hexbin/contours.d.ts +48 -0
- package/types/src/charts/Hexbin/emit.d.ts +23 -0
- package/types/src/charts/Hexbin/index.d.ts +25 -0
- package/types/src/charts/Hexbin/layers.d.ts +94 -0
- package/types/src/charts/Hexbin/settings.d.ts +122 -0
- package/types/src/charts/Hexbin/tooltip.d.ts +26 -0
- package/types/src/charts/Histogram/binData.d.ts +20 -1
- package/types/src/charts/Histogram/index.d.ts +3 -2
- package/types/src/charts/Histogram/labels.d.ts +7 -0
- package/types/src/charts/Marimekko/index.d.ts +2 -1
- package/types/src/charts/Network/bundle.d.ts +67 -0
- package/types/src/charts/Network/clusterLabels.d.ts +112 -0
- package/types/src/charts/Network/clusters.d.ts +115 -0
- package/types/src/charts/Network/graph.d.ts +65 -0
- package/types/src/charts/Network/graphFluent.d.ts +20 -0
- package/types/src/charts/Network/minNodeDistance.d.ts +18 -0
- package/types/src/charts/Network/polygonRows.d.ts +29 -0
- package/types/src/charts/Pie/applyLayout.d.ts +31 -3
- package/types/src/charts/Pie/arcFit.d.ts +63 -0
- package/types/src/charts/Pie/curvedLabels.d.ts +57 -0
- package/types/src/charts/Pie/labelRoom.d.ts +83 -0
- package/types/src/charts/Pie/outsideLabels.d.ts +119 -0
- package/types/src/charts/Pie/outsideNodes.d.ts +93 -0
- package/types/src/charts/Pie/pieLabels.d.ts +85 -0
- package/types/src/charts/Pie/sectorBox.d.ts +95 -0
- package/types/src/charts/Pie/straightLabels.d.ts +24 -0
- package/types/src/charts/Pie/straightLayout.d.ts +88 -0
- package/types/src/charts/Plot/alongLegend.d.ts +42 -0
- package/types/src/charts/Plot/areaLabelsAlong.d.ts +119 -0
- package/types/src/charts/Plot/axisHover.d.ts +68 -0
- package/types/src/charts/Plot/axisHoverAnchors.d.ts +88 -0
- package/types/src/charts/Plot/axisHoverScene.d.ts +88 -0
- package/types/src/charts/Plot/axisValues.d.ts +24 -0
- package/types/src/charts/Plot/barHitArea.d.ts +59 -0
- package/types/src/charts/Plot/barLabelFit.d.ts +81 -0
- package/types/src/charts/Plot/barWidth.d.ts +38 -4
- package/types/src/charts/Plot/circleLabels.d.ts +29 -0
- package/types/src/charts/Plot/connectGaps.d.ts +99 -0
- package/types/src/charts/Plot/connectGapsScene.d.ts +55 -0
- package/types/src/charts/Plot/forecastScene.d.ts +5 -0
- package/types/src/charts/Plot/index.d.ts +28 -8
- package/types/src/charts/Plot/labelPlacement.d.ts +5 -0
- package/types/src/charts/Plot/lineLabelEmit.d.ts +48 -0
- package/types/src/charts/Plot/lineLabelSides.d.ts +50 -0
- package/types/src/charts/Plot/lineLabelSpread.d.ts +15 -0
- package/types/src/charts/Plot/lineLabelsAlong.d.ts +116 -0
- package/types/src/charts/Plot/pipeline.d.ts +15 -1
- package/types/src/charts/Plot/pipelineLineLabels.d.ts +68 -0
- package/types/src/charts/Plot/plotFacet.d.ts +5 -0
- package/types/src/charts/Plot/plotInit.d.ts +23 -2
- package/types/src/charts/Plot/plotRangeBreaks.d.ts +35 -0
- package/types/src/charts/Plot/plotZoom.d.ts +2 -0
- package/types/src/charts/Plot/referenceDomains.d.ts +49 -0
- package/types/src/charts/Plot/sharedHoverScene.d.ts +3 -3
- package/types/src/charts/Plot/sharedTooltip.d.ts +11 -4
- package/types/src/charts/Plot/stackHelpers.d.ts +5 -0
- package/types/src/charts/Plot/stackLegendOrder.d.ts +83 -0
- package/types/src/charts/Plot/stackThreshold.d.ts +75 -0
- package/types/src/charts/Plot/trendLabels.d.ts +73 -0
- package/types/src/charts/Plot/trendTooltip.d.ts +6 -0
- package/types/src/charts/Priestley/timeAxis.d.ts +76 -0
- package/types/src/charts/Radar/axisDecorations.d.ts +7 -2
- package/types/src/charts/Radar/curvedLabels.d.ts +94 -0
- package/types/src/charts/RadialBar/curvedLabels.d.ts +31 -0
- package/types/src/charts/RadialBar/trackLayout.d.ts +34 -3
- package/types/src/charts/Rings/emit.d.ts +50 -0
- package/types/src/charts/Rings/ringsGraph.d.ts +10 -2
- package/types/src/charts/Rings/ringsLoops.d.ts +13 -0
- package/types/src/charts/Rings/ringsParallel.d.ts +43 -0
- package/types/src/charts/Sankey/circularLayout.d.ts +103 -0
- package/types/src/charts/Sankey/circularLinks.d.ts +178 -0
- package/types/src/charts/Sankey/emit.d.ts +58 -0
- package/types/src/charts/Sankey/labels.d.ts +19 -0
- package/types/src/charts/Sankey/ribbons.d.ts +36 -0
- package/types/src/charts/Sankey/sankeyCycles.d.ts +24 -0
- package/types/src/charts/Sankey/sankeyLayout.d.ts +6 -0
- package/types/src/charts/Sankey/sankeyLinks.d.ts +36 -0
- package/types/src/charts/Scatter/index.d.ts +15 -0
- package/types/src/charts/SlopeChart/index.d.ts +43 -0
- package/types/src/charts/SlopeChart/slope.d.ts +43 -0
- package/types/src/charts/Streamgraph/index.d.ts +28 -0
- package/types/src/charts/Sunburst/curvedLabels.d.ts +56 -0
- package/types/src/charts/Treemap/emit.d.ts +2 -1
- package/types/src/charts/Treemap/emitGroupHeaders.d.ts +16 -0
- package/types/src/charts/Treemap/groupHeaders.d.ts +91 -0
- package/types/src/charts/Treemap/index.d.ts +2 -0
- package/types/src/charts/Treemap/thresholdFunction.d.ts +5 -2
- package/types/src/charts/definition/ChartDefinition.d.ts +27 -2
- package/types/src/charts/definition/makeChart.d.ts +5 -3
- package/types/src/charts/drawSteps/backControl.d.ts +7 -22
- package/types/src/charts/drawSteps/gestureHover.d.ts +33 -0
- package/types/src/charts/drawSteps/minimapMarkup.d.ts +5 -4
- package/types/src/charts/drawSteps/saveChart.d.ts +47 -0
- package/types/src/charts/drawSteps/saveControl.d.ts +9 -0
- package/types/src/charts/drawSteps/saveControlMarkup.d.ts +44 -0
- package/types/src/charts/drawSteps/tableViewMarkup.d.ts +4 -1
- package/types/src/charts/drawSteps/topLeftControls.d.ts +1 -1
- package/types/src/charts/drawSteps/topLeftControlsMarkup.d.ts +1 -1
- package/types/src/charts/drawSteps/zoomGesture.d.ts +32 -0
- package/types/src/charts/events/click.legend.d.ts +2 -1
- package/types/src/charts/facet/facetConfig.d.ts +4 -2
- package/types/src/charts/facet/facetData.d.ts +1 -1
- package/types/src/charts/features/annotationFrame.d.ts +108 -0
- package/types/src/charts/features/annotationText.d.ts +57 -0
- package/types/src/charts/features/annotationTypes.d.ts +161 -0
- package/types/src/charts/features/axesMeasure.d.ts +13 -1
- package/types/src/charts/features/calloutLayout.d.ts +78 -0
- package/types/src/charts/features/calloutScene.d.ts +40 -0
- package/types/src/charts/features/chartGeometry.d.ts +1 -1
- package/types/src/charts/features/circleLabelPlacement.d.ts +97 -0
- package/types/src/charts/features/circleLabels.d.ts +130 -0
- package/types/src/charts/features/colorScaleBucket.d.ts +9 -0
- package/types/src/charts/features/colorScaleHover.d.ts +32 -0
- package/types/src/charts/features/colorScaleValue.d.ts +35 -0
- package/types/src/charts/features/curvedArrows.d.ts +105 -0
- package/types/src/charts/features/edgeArrows.d.ts +74 -2
- package/types/src/charts/features/edgeBundling.d.ts +86 -0
- package/types/src/charts/features/edgeBundlingSmooth.d.ts +29 -0
- package/types/src/charts/features/ensureZoomDom.d.ts +19 -1
- package/types/src/charts/features/features.d.ts +8 -0
- package/types/src/charts/features/featuresLegend.d.ts +4 -3
- package/types/src/charts/features/legendKeys.d.ts +34 -0
- package/types/src/charts/features/lineLabels.d.ts +15 -12
- package/types/src/charts/features/linkBundle.d.ts +16 -0
- package/types/src/charts/features/linkColor.d.ts +48 -0
- package/types/src/charts/features/linkFields.d.ts +16 -0
- package/types/src/charts/features/linkFocus.d.ts +51 -0
- package/types/src/charts/features/linkInteraction.d.ts +183 -0
- package/types/src/charts/features/linkKeys.d.ts +11 -0
- package/types/src/charts/features/linkLabelGeometry.d.ts +67 -0
- package/types/src/charts/features/linkLabelPath.d.ts +85 -0
- package/types/src/charts/features/linkLabels.d.ts +77 -0
- package/types/src/charts/features/linkWidths.d.ts +19 -0
- package/types/src/charts/features/pathLabelGeometry.d.ts +99 -0
- package/types/src/charts/features/pathLabels.d.ts +41 -0
- package/types/src/charts/features/plotAnnotations.d.ts +23 -8
- package/types/src/charts/features/plotPaint.d.ts +19 -0
- package/types/src/charts/features/polyline.d.ts +32 -0
- package/types/src/charts/features/referenceAnnotations.d.ts +130 -0
- package/types/src/charts/features/referenceLabelPlacement.d.ts +58 -0
- package/types/src/charts/features/ringLabelNodes.d.ts +63 -0
- package/types/src/charts/features/ringLabels.d.ts +164 -0
- package/types/src/charts/features/sceneBounds.d.ts +6 -0
- package/types/src/charts/features/selfLoops.d.ts +165 -0
- package/types/src/charts/features/shapeEmit.d.ts +5 -1
- package/types/src/charts/features/shareKey.d.ts +9 -0
- package/types/src/charts/features/sharedFields.d.ts +11 -2
- package/types/src/charts/features/textHalo.d.ts +14 -0
- package/types/src/charts/features/thresholdMembers.d.ts +38 -0
- package/types/src/charts/helpers/valueTitle.d.ts +4 -2
- package/types/src/charts/index.d.ts +8 -0
- package/types/src/charts/partition/interaction.d.ts +6 -3
- package/types/src/charts/partition/zoom.d.ts +4 -4
- package/types/src/charts/pipeline/preDrawData.d.ts +14 -1
- package/types/src/charts/pipeline/stages.d.ts +9 -0
- package/types/src/charts/pipeline/vizDraw.d.ts +8 -3
- package/types/src/charts/pipeline/vizPreDraw.d.ts +3 -2
- package/types/src/charts/plotBuffers/discreteBuffer.d.ts +0 -5
- package/types/src/charts/viz/Viz.d.ts +44 -6
- package/types/src/charts/viz/VizBase.d.ts +16 -7
- package/types/src/charts/viz/backgroundInk.d.ts +11 -4
- package/types/src/charts/viz/dataPoller.d.ts +28 -0
- package/types/src/charts/viz/focusRing.d.ts +25 -0
- package/types/src/charts/viz/focusTargets.d.ts +56 -0
- package/types/src/charts/viz/groupRow.d.ts +24 -0
- package/types/src/charts/viz/history.d.ts +35 -0
- package/types/src/charts/viz/interactionOpacity.d.ts +3 -1
- package/types/src/charts/viz/keyboardNav.d.ts +55 -0
- package/types/src/charts/viz/keyboardNavHost.d.ts +53 -0
- package/types/src/charts/viz/loaderFormat.d.ts +78 -0
- package/types/src/charts/viz/missingFields.d.ts +57 -0
- package/types/src/charts/viz/mountTarget.d.ts +7 -0
- package/types/src/charts/viz/nearestHover.d.ts +75 -0
- package/types/src/charts/viz/nearestHoverSurface.d.ts +21 -0
- package/types/src/charts/viz/ordinalColor.d.ts +10 -8
- package/types/src/charts/viz/pageTheme.d.ts +34 -0
- package/types/src/charts/viz/pointTooltipAnchor.d.ts +36 -0
- package/types/src/charts/viz/pointVoronoi.d.ts +65 -0
- package/types/src/charts/viz/reducedMotion.d.ts +25 -0
- package/types/src/charts/viz/reportHandlerError.d.ts +7 -0
- package/types/src/charts/viz/shapeClassTargets.d.ts +6 -0
- package/types/src/charts/viz/simpleHover.d.ts +2 -1
- package/types/src/charts/viz/vizClassName.d.ts +23 -0
- package/types/src/charts/viz/vizDataPolling.d.ts +48 -0
- package/types/src/charts/viz/vizDefaults.d.ts +49 -9
- package/types/src/charts/viz/vizFields.d.ts +47 -0
- package/types/src/charts/viz/vizRender.d.ts +2 -1
- package/types/src/charts/viz/vizTheme.d.ts +40 -0
- package/types/src/charts/viz/vizTypes.d.ts +117 -8
- package/types/src/charts/viz/vizVisibility.d.ts +6 -0
- package/types/src/components/Axis/Axis.d.ts +37 -8
- package/types/src/components/Axis/AxisBottom.d.ts +1 -0
- package/types/src/components/Axis/AxisLeft.d.ts +1 -0
- package/types/src/components/Axis/AxisRight.d.ts +1 -0
- package/types/src/components/Axis/AxisTop.d.ts +1 -0
- package/types/src/components/Axis/axisBreak.d.ts +2 -0
- package/types/src/components/Axis/axisLabelAngle.d.ts +110 -0
- package/types/src/components/Axis/axisLabelThinning.d.ts +3 -7
- package/types/src/components/Axis/axisLayout.d.ts +5 -0
- package/types/src/components/Axis/axisLayoutLabels.d.ts +13 -0
- package/types/src/components/Axis/axisRangeBreaks.d.ts +25 -0
- package/types/src/components/Axis/axisRounding.d.ts +6 -3
- package/types/src/components/Axis/axisSlantWrap.d.ts +22 -0
- package/types/src/components/Axis/brokenTimeScale.d.ts +51 -0
- package/types/src/components/Axis/powTicks.d.ts +29 -0
- package/types/src/components/Axis/rangeBreaks.d.ts +82 -0
- package/types/src/components/Axis/timeValues.d.ts +1 -1
- package/types/src/components/ColorScale/ColorScale.d.ts +14 -0
- package/types/src/components/ColorScale/bucketBounds.d.ts +28 -0
- package/types/src/components/ColorScale/colorScaleHoverMark.d.ts +86 -0
- package/types/src/components/ColorScale/colorScaleScale.d.ts +3 -0
- package/types/src/components/ColorScale/colorScaleType.d.ts +17 -0
- package/types/src/components/Legend/Legend.d.ts +1 -0
- package/types/src/components/SizeLegend/SizeLegend.d.ts +1 -0
- package/types/src/components/TextBox.d.ts +1 -0
- package/types/src/components/Timeline/Timeline.d.ts +1 -0
- package/types/src/components/Timeline/brushSpan.d.ts +41 -0
- package/types/src/components/Timeline/timelineConfig.d.ts +11 -0
- package/types/src/components/Timeline/timelineMode.d.ts +17 -0
- package/types/src/components/Timeline/timelineRender.d.ts +8 -0
- package/types/src/components/Tooltip.d.ts +12 -3
- package/types/src/components/fontStack.d.ts +10 -0
- package/types/src/components/textBoxLayout.d.ts +18 -9
- package/types/src/components/textBoxPath.d.ts +59 -0
- package/types/src/components/textBoxScene.d.ts +51 -0
- package/types/src/components/textBoxWords.d.ts +33 -0
- package/types/src/shapes/Area.d.ts +1 -0
- package/types/src/shapes/Bar.d.ts +1 -0
- package/types/src/shapes/Box.d.ts +2 -8
- package/types/src/shapes/Circle.d.ts +1 -0
- package/types/src/shapes/Line.d.ts +1 -0
- package/types/src/shapes/Path.d.ts +1 -0
- package/types/src/shapes/Rect.d.ts +1 -0
- package/types/src/shapes/Shape.d.ts +1 -0
- package/types/src/shapes/Whisker.d.ts +1 -0
- package/types/src/shapes/boxOutlierShape.d.ts +9 -0
- package/types/src/shapes/boxStats.d.ts +19 -0
- package/types/src/shapes/boxStyle.d.ts +25 -0
- package/types/src/shapes/boxSummary.d.ts +66 -0
- package/types/src/shapes/emitLabels.d.ts +1 -1
- package/types/src/shapes/shapeConfig.d.ts +42 -4
- package/types/src/utils/BaseClass.d.ts +32 -0
- package/types/src/utils/D3Scale.d.ts +3 -0
- package/types/src/utils/D3plusConfig.d.ts +1240 -33
- package/types/src/utils/className.d.ts +64 -0
- package/types/src/utils/configPrep.d.ts +2 -0
- package/types/src/utils/configWarnings.d.ts +21 -2
- package/types/src/utils/constant.d.ts +8 -0
- package/types/src/utils/displayName.d.ts +10 -0
- package/types/src/utils/fieldAccessor.d.ts +24 -0
- package/types/src/utils/index.d.ts +1 -1
- package/types/src/utils/paintComponentScene.d.ts +3 -1
- package/types/src/utils/theme.d.ts +170 -0
- package/types/src/utils/themeInk.d.ts +56 -0
- package/umd/d3plus-core.full.js +87388 -56271
- package/umd/d3plus-core.full.min.js +2 -2
- package/umd/d3plus-core.js +37988 -11768
- package/umd/d3plus-core.min.js +2 -2
- package/es/src/components/Axis/gridStroke.js +0 -10
- package/types/src/components/Axis/gridStroke.d.ts +0 -8
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin — a Plot of 2D binned density: raw observations on two continuous
|
|
3
|
+
axes, grouped into hexagons (or squares) of a fixed pixel size and
|
|
4
|
+
colored by how many each holds, with optional density contours.
|
|
5
|
+
*/ import constant from "../../utils/constant.js";
|
|
6
|
+
import { makeChart } from "../definition/makeChart.js";
|
|
7
|
+
import Plot from "../Plot/index.js";
|
|
8
|
+
import { chartBackground } from "../viz/backgroundInk.js";
|
|
9
|
+
import { optionalAccessor } from "../viz/vizFields.js";
|
|
10
|
+
import { hexbinBuffer } from "./buffer.js";
|
|
11
|
+
import { hexbinEmit } from "./emit.js";
|
|
12
|
+
import { colorScaleRows, hexbinState, isNumeric, noteDrawRows } from "./layers.js";
|
|
13
|
+
import { BIN_SIZE, CONTOUR_DEFAULTS, HEXBIN_SHAPE, POINT_DEFAULTS, hexbinMeta, hexbinValue, unwrapHexbinRow } from "./settings.js";
|
|
14
|
+
import { hexbinTooltipRows, hexbinTooltipTitle } from "./tooltip.js";
|
|
15
|
+
/**
|
|
16
|
+
Keeps the rows with numeric x and y as the chart's data; the rest are
|
|
17
|
+
skipped. The user's rows stay the chart's source data.
|
|
18
|
+
*/ export function keepNumericRows(viz) {
|
|
19
|
+
const state = hexbinState(viz);
|
|
20
|
+
if (viz._data !== state.rows) state.raw = viz._data;
|
|
21
|
+
viz._sourceData = state.raw;
|
|
22
|
+
const valid = state.raw.filter((d, i)=>isNumeric(viz._x(d, i)) && isNumeric(viz._y(d, i)));
|
|
23
|
+
state.rows = viz._data = valid.length === state.raw.length ? state.raw : valid;
|
|
24
|
+
}
|
|
25
|
+
/** Hovering a bin or contour highlights just that mark. */ function installHover(viz) {
|
|
26
|
+
const base = viz.schema.on.mouseenter;
|
|
27
|
+
viz.schema.on.mouseenter = (d, i, ...rest)=>{
|
|
28
|
+
if (!hexbinMeta(d) || viz.schema.shapeConfig.hoverOpacity === 1) return base(d, i, ...rest);
|
|
29
|
+
const target = unwrapHexbinRow(d);
|
|
30
|
+
viz._hoverBucket = false;
|
|
31
|
+
viz.hover((h)=>unwrapHexbinRow(h) === target);
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
export const hexbinDef = {
|
|
35
|
+
name: "Hexbin",
|
|
36
|
+
paintDriven: true,
|
|
37
|
+
setup: (viz)=>{
|
|
38
|
+
viz.ctx.hexbin = {
|
|
39
|
+
raw: [],
|
|
40
|
+
rows: []
|
|
41
|
+
};
|
|
42
|
+
viz._buffer = {
|
|
43
|
+
...viz._buffer,
|
|
44
|
+
[HEXBIN_SHAPE]: hexbinBuffer
|
|
45
|
+
};
|
|
46
|
+
viz._plotShapeEmitters = {
|
|
47
|
+
[HEXBIN_SHAPE]: hexbinEmit
|
|
48
|
+
};
|
|
49
|
+
// Every observation is binned on its own, whatever its groupBy id.
|
|
50
|
+
viz._unmergedShapes = [
|
|
51
|
+
HEXBIN_SHAPE
|
|
52
|
+
];
|
|
53
|
+
// The colorScale reads the bins, which are measured in the plot area.
|
|
54
|
+
viz._colorScaleRows = ()=>colorScaleRows(viz);
|
|
55
|
+
// The tooltip's own rows give a bin's ranges.
|
|
56
|
+
viz._tooltipAxisRows = false;
|
|
57
|
+
// A bin has no single point to snap a tooltip to.
|
|
58
|
+
viz._sharedHover = ()=>undefined;
|
|
59
|
+
installHover(viz);
|
|
60
|
+
const preDraw = viz._preDraw.bind(viz);
|
|
61
|
+
viz._preDraw = ()=>{
|
|
62
|
+
keepNumericRows(viz);
|
|
63
|
+
preDraw();
|
|
64
|
+
};
|
|
65
|
+
const draw = viz._draw.bind(viz);
|
|
66
|
+
viz._draw = (callback)=>{
|
|
67
|
+
// Small-multiples panels share the grid anchor and colorScale noted
|
|
68
|
+
// from every panel's rows.
|
|
69
|
+
if (viz._facetStep !== "panel") noteDrawRows(viz);
|
|
70
|
+
return draw(callback);
|
|
71
|
+
};
|
|
72
|
+
},
|
|
73
|
+
ctx: {},
|
|
74
|
+
fields: [
|
|
75
|
+
/**
|
|
76
|
+
The bin shape: `"hex"` (default) for hexagons, `"square"` for
|
|
77
|
+
squares, or `false` to draw no bins (for contours alone).
|
|
78
|
+
@type {"hex" | "square" | false}
|
|
79
|
+
*/ {
|
|
80
|
+
key: "binShape",
|
|
81
|
+
default: "hex"
|
|
82
|
+
},
|
|
83
|
+
/**
|
|
84
|
+
The bin size in pixels: a hexagon's radius, or a square's side.
|
|
85
|
+
Bins keep this size at any zoom: the observations are binned again
|
|
86
|
+
for each view, and the colorScale refits to the bins in view.
|
|
87
|
+
Defaults to 12.
|
|
88
|
+
*/ {
|
|
89
|
+
key: "binSize",
|
|
90
|
+
default: BIN_SIZE
|
|
91
|
+
},
|
|
92
|
+
/**
|
|
93
|
+
What each bin measures, which its color shows: `"count"` (default),
|
|
94
|
+
the number of observations in the bin; or `{value, agg, label}`,
|
|
95
|
+
the `"sum"` (default) or `"mean"` of `value` (a data key or
|
|
96
|
+
accessor) over the bin's observations, named `label` in the
|
|
97
|
+
tooltip.
|
|
98
|
+
@type {"count" | {value: string | function, agg?: "sum" | "mean", label?: string}}
|
|
99
|
+
*/ {
|
|
100
|
+
key: "binValue",
|
|
101
|
+
default: "count"
|
|
102
|
+
},
|
|
103
|
+
/**
|
|
104
|
+
Draws density contours: `"lines"` (or `true`) outlines each density
|
|
105
|
+
level in its color, and `"filled"` fills each level with an opacity
|
|
106
|
+
ramp. Levels are in observations per bin (the count a bin would hold
|
|
107
|
+
there), so contours share the bins' colorScale. Contours over bins
|
|
108
|
+
are drawn in the chart's text color and don't take hover. Defaults to
|
|
109
|
+
`false`.
|
|
110
|
+
@type {boolean | "lines" | "filled"}
|
|
111
|
+
*/ {
|
|
112
|
+
key: "contours",
|
|
113
|
+
default: false
|
|
114
|
+
},
|
|
115
|
+
/**
|
|
116
|
+
Contour options: `bandwidth`, the density kernel's standard deviation
|
|
117
|
+
in pixels (default 20); `thresholds`, about how many levels to draw
|
|
118
|
+
(default 8, rounded to nice values) or the levels themselves;
|
|
119
|
+
`strokeWidth`, the outline width of `"lines"` (default 1.5);
|
|
120
|
+
`fillOpacity`, the opacity of the highest `"filled"` level (default
|
|
121
|
+
0.8); `labels`, which writes each level's value along its contour
|
|
122
|
+
(default `true`); `labelConfig`, TextBox config for those labels
|
|
123
|
+
(`fontSize` defaults to 10); `labelSpacing`, the least distance
|
|
124
|
+
between two labels along a line, in pixels (default `"auto"`); and
|
|
125
|
+
`labelStep`, which labels every n-th level (default `"auto"`: all of
|
|
126
|
+
up to five levels, else every other one).
|
|
127
|
+
@type {{bandwidth?: number, thresholds?: number | number[], strokeWidth?: number, fillOpacity?: number, labels?: boolean, labelConfig?: object, labelSpacing?: number | "auto", labelStep?: number | "auto"}}
|
|
128
|
+
*/ {
|
|
129
|
+
key: "contourConfig",
|
|
130
|
+
merge: true,
|
|
131
|
+
default: CONTOUR_DEFAULTS
|
|
132
|
+
},
|
|
133
|
+
/** Formats the contour labels' and tooltips' level values. Defaults to the abbreviated number format (`1.5k`). */ {
|
|
134
|
+
key: "levelFormat"
|
|
135
|
+
},
|
|
136
|
+
/** Draws the raw observations as small dots beneath the bins and contours. Defaults to `false`. */ {
|
|
137
|
+
key: "points",
|
|
138
|
+
default: false
|
|
139
|
+
},
|
|
140
|
+
/**
|
|
141
|
+
The raw observations' style: `r`, the dot radius in pixels (default
|
|
142
|
+
1.5); `fill` (defaults to the chart's text color); and `fillOpacity`
|
|
143
|
+
(default 0.35).
|
|
144
|
+
@type {{r?: number, fill?: string, fillOpacity?: number}}
|
|
145
|
+
*/ {
|
|
146
|
+
key: "pointConfig",
|
|
147
|
+
merge: true,
|
|
148
|
+
default: POINT_DEFAULTS
|
|
149
|
+
},
|
|
150
|
+
{
|
|
151
|
+
key: "colorScale",
|
|
152
|
+
coerce: optionalAccessor,
|
|
153
|
+
default: hexbinValue
|
|
154
|
+
},
|
|
155
|
+
/** A continuous color scale: bins and contours shade smoothly by value. */ {
|
|
156
|
+
key: "colorScaleConfig",
|
|
157
|
+
merge: true,
|
|
158
|
+
default: {
|
|
159
|
+
scale: "linear"
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
key: "legend",
|
|
164
|
+
default: false,
|
|
165
|
+
coerce: "const"
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
key: "shape",
|
|
169
|
+
default: constant(HEXBIN_SHAPE),
|
|
170
|
+
coerce: "const"
|
|
171
|
+
},
|
|
172
|
+
/**
|
|
173
|
+
Bins are outlined in the chart's background color, so neighbors stay
|
|
174
|
+
distinct.
|
|
175
|
+
*/ {
|
|
176
|
+
key: "shapeConfig",
|
|
177
|
+
merge: true,
|
|
178
|
+
factory: (viz)=>({
|
|
179
|
+
[HEXBIN_SHAPE]: {
|
|
180
|
+
stroke: ()=>chartBackground(viz),
|
|
181
|
+
strokeWidth: constant(0.5)
|
|
182
|
+
}
|
|
183
|
+
})
|
|
184
|
+
},
|
|
185
|
+
{
|
|
186
|
+
key: "tooltipConfig",
|
|
187
|
+
merge: true,
|
|
188
|
+
factory: (viz)=>({
|
|
189
|
+
title: (d)=>hexbinTooltipTitle(viz, d),
|
|
190
|
+
tbody: (d)=>hexbinTooltipRows(viz, d)
|
|
191
|
+
})
|
|
192
|
+
}
|
|
193
|
+
]
|
|
194
|
+
};
|
|
195
|
+
/**
|
|
196
|
+
Creates a 2D binned density chart from raw observations: each row is a
|
|
197
|
+
point at its `x` and `y` values (rows without numeric values are
|
|
198
|
+
skipped), and the points are grouped into hexagons (`binShape`) of
|
|
199
|
+
`binSize` pixels, colored on the colorScale by how many each holds (or by
|
|
200
|
+
`binValue`). Empty bins aren't drawn. `contours` adds density contours,
|
|
201
|
+
and `points` draws the observations beneath. `groupBy` names the
|
|
202
|
+
observations for `filter` and the legend (off by default), and `facet`
|
|
203
|
+
bins each panel on its own, on one shared colorScale.
|
|
204
|
+
*/ export default makeChart(hexbinDef, Plot);
|
|
@@ -0,0 +1,212 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's per-draw state and the rows its emitter draws: bins and contour
|
|
3
|
+
levels measured from points in pixel space, and the rows the colorScale
|
|
4
|
+
is laid out from (estimated before the plot area is known, then measured
|
|
5
|
+
against it).
|
|
6
|
+
|
|
7
|
+
@module
|
|
8
|
+
*/ import { extent, groups } from "d3-array";
|
|
9
|
+
import { scaleLinear } from "d3-scale";
|
|
10
|
+
import { facetActive } from "../facet/facetConfig.js";
|
|
11
|
+
import { facetKey, toFacetValue } from "../facet/facetData.js";
|
|
12
|
+
import { binArea, binBounds, binMeasure, binPath, binPoints } from "./binning.js";
|
|
13
|
+
import { densityContours } from "./contours.js";
|
|
14
|
+
import { hexbinRow, hexbinSettings } from "./settings.js";
|
|
15
|
+
/** A Hexbin's state. */ export function hexbinState(viz) {
|
|
16
|
+
return viz.ctx.hexbin;
|
|
17
|
+
}
|
|
18
|
+
/** Whether a value is a finite number. */ export const isNumeric = (v)=>typeof v === "number" && Number.isFinite(v);
|
|
19
|
+
/** The plot area an emitter draws in. */ export function plotFrame(ctx) {
|
|
20
|
+
const { xRange, yRange } = ctx;
|
|
21
|
+
return {
|
|
22
|
+
left: xRange[0],
|
|
23
|
+
top: yRange[0] - (ctx.x2Height ?? 0),
|
|
24
|
+
width: xRange[xRange.length - 1] - xRange[0],
|
|
25
|
+
height: yRange[yRange.length - 1] - yRange[0]
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
One row per bin, measured: its count and value, its bounds in data units
|
|
30
|
+
(through `invert`), and its outline. Bins whose value isn't a number (a
|
|
31
|
+
`mean` with nothing to average) are left out.
|
|
32
|
+
*/ export function binRows(bins, settings, invert) {
|
|
33
|
+
const shape = settings.shape || "hex";
|
|
34
|
+
const rows = [];
|
|
35
|
+
for (const bin of bins){
|
|
36
|
+
const value = binMeasure(bin.points, settings.agg);
|
|
37
|
+
if (!Number.isFinite(value)) continue;
|
|
38
|
+
const b = binBounds(bin, shape, settings.size);
|
|
39
|
+
const [x0, x1] = [
|
|
40
|
+
invert.x(b.x0),
|
|
41
|
+
invert.x(b.x1)
|
|
42
|
+
].sort((a, c)=>a - c);
|
|
43
|
+
const [y0, y1] = [
|
|
44
|
+
invert.y(b.y0),
|
|
45
|
+
invert.y(b.y1)
|
|
46
|
+
].sort((a, c)=>a - c);
|
|
47
|
+
rows.push(hexbinRow(`bin-${bin.key}`, {
|
|
48
|
+
kind: "bin",
|
|
49
|
+
count: bin.points.length,
|
|
50
|
+
value,
|
|
51
|
+
x0,
|
|
52
|
+
x1,
|
|
53
|
+
y0,
|
|
54
|
+
y1,
|
|
55
|
+
path: binPath(bin, shape, settings.size),
|
|
56
|
+
rows: bin.points.map((p)=>p.row)
|
|
57
|
+
}));
|
|
58
|
+
}
|
|
59
|
+
return rows;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
One row per contour level, lowest first. Levels are in points per bin, so
|
|
63
|
+
they share the bins' color scale; a `mean` measure contours the points'
|
|
64
|
+
density, unweighted.
|
|
65
|
+
*/ export function contourRows(points, frame, settings) {
|
|
66
|
+
const { bandwidth, thresholds } = settings.contourConfig;
|
|
67
|
+
const weighted = settings.agg === "sum" ? points : points.map((p)=>({
|
|
68
|
+
...p,
|
|
69
|
+
weight: 1
|
|
70
|
+
}));
|
|
71
|
+
const levels = densityContours(weighted, {
|
|
72
|
+
...frame,
|
|
73
|
+
bandwidth,
|
|
74
|
+
thresholds,
|
|
75
|
+
unit: binArea(settings.shape || "hex", settings.size)
|
|
76
|
+
});
|
|
77
|
+
return levels.map((c, index)=>hexbinRow(`contour-${index}`, {
|
|
78
|
+
kind: "contour",
|
|
79
|
+
level: c.level,
|
|
80
|
+
next: levels[index + 1]?.level,
|
|
81
|
+
index,
|
|
82
|
+
levels: levels.length,
|
|
83
|
+
path: c.path
|
|
84
|
+
}));
|
|
85
|
+
}
|
|
86
|
+
/** The bins that reach into the plot area: the ones a zoomed view shows. */ export function binsInView(bins, frame, settings) {
|
|
87
|
+
const shape = settings.shape || "hex";
|
|
88
|
+
return bins.filter((bin)=>{
|
|
89
|
+
const b = binBounds(bin, shape, settings.size);
|
|
90
|
+
return b.x1 > frame.left && b.x0 < frame.left + frame.width && b.y1 > frame.top && b.y0 < frame.top + frame.height;
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
/** The points as one path of `r`-pixel dots. */ export function pointPath(points, r) {
|
|
94
|
+
const round = (n)=>Math.round(n * 10) / 10;
|
|
95
|
+
let d = "";
|
|
96
|
+
for (const p of points){
|
|
97
|
+
if (!isNumeric(p.x) || !isNumeric(p.y)) continue;
|
|
98
|
+
d += `M${round(p.x - r)},${round(p.y)}a${r},${r} 0 1,0 ${2 * r},0a${r},${r} 0 1,0 ${-2 * r},0`;
|
|
99
|
+
}
|
|
100
|
+
return d;
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
The rows the colorScale reads for some points: their bins in view, or
|
|
104
|
+
with no bins drawn, their contour levels.
|
|
105
|
+
*/ export function colorRows(points, frame, origin, settings) {
|
|
106
|
+
const none = {
|
|
107
|
+
x: ()=>NaN,
|
|
108
|
+
y: ()=>NaN
|
|
109
|
+
};
|
|
110
|
+
if (settings.shape) return binRows(binsInView(binPoints(points, {
|
|
111
|
+
shape: settings.shape,
|
|
112
|
+
size: settings.size,
|
|
113
|
+
origin
|
|
114
|
+
}), frame, settings), settings, none);
|
|
115
|
+
return settings.contours ? contourRows(points, frame, settings) : [];
|
|
116
|
+
}
|
|
117
|
+
/** The user's rows placed through `toX`/`toY` (data value to pixel). */ function placeRows(viz, rows, toX, toY, settings) {
|
|
118
|
+
const { weight } = settings;
|
|
119
|
+
return rows.map((row, i)=>({
|
|
120
|
+
x: toX(Number(viz._x(row, i))),
|
|
121
|
+
y: toY(Number(viz._y(row, i))),
|
|
122
|
+
row,
|
|
123
|
+
weight: weight ? Number(weight(row, i)) : undefined
|
|
124
|
+
}));
|
|
125
|
+
}
|
|
126
|
+
/** The user's rows split into small-multiples panels (one group without facets). */ function panelRows(viz, rows) {
|
|
127
|
+
if (!facetActive(viz)) return [
|
|
128
|
+
rows
|
|
129
|
+
];
|
|
130
|
+
const facet = viz.schema.facet;
|
|
131
|
+
return groups(rows, (d, i)=>facetKey(toFacetValue(facet(d, i)))).map(([, g])=>g);
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
Notes what the emitter needs from the whole chart before a draw: where
|
|
135
|
+
the bin grid is anchored, and with small multiples, every panel's rows.
|
|
136
|
+
The colorScale rows measured by the last draw are dropped.
|
|
137
|
+
*/ export function noteDrawRows(viz) {
|
|
138
|
+
const state = hexbinState(viz);
|
|
139
|
+
state.colorRows = undefined;
|
|
140
|
+
const rows = viz._filteredData ?? [];
|
|
141
|
+
const xs = rows.map((d, i)=>Number(viz._x(d, i))).filter(isNumeric);
|
|
142
|
+
const ys = rows.map((d, i)=>Number(viz._y(d, i))).filter(isNumeric);
|
|
143
|
+
const [x] = extent(xs);
|
|
144
|
+
const [y] = extent(ys);
|
|
145
|
+
state.anchor = x !== undefined && y !== undefined ? [
|
|
146
|
+
x,
|
|
147
|
+
y
|
|
148
|
+
] : undefined;
|
|
149
|
+
state.panels = facetActive(viz) ? panelRows(viz, rows) : undefined;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
The colorScale's rows for a panel's paint: the rows it measured, or with
|
|
153
|
+
small multiples, every panel's, binned at this panel's scale so all of
|
|
154
|
+
them share one colorScale.
|
|
155
|
+
*/ export function sharedColorRows(ctx, own, frame, origin, settings) {
|
|
156
|
+
const { viz } = ctx;
|
|
157
|
+
const panels = hexbinState(viz).panels;
|
|
158
|
+
if (viz._facetStep !== "panel" || !panels) return own;
|
|
159
|
+
return panels.flatMap((rows)=>colorRows(placeRows(viz, rows, (v)=>ctx.x(v), (v)=>ctx.y(v), settings), frame, origin, settings));
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
The rows the colorScale lays out from: those this draw's paint measured,
|
|
163
|
+
or before the paint, an estimate (see `estimatedColorRows`).
|
|
164
|
+
*/ export function colorScaleRows(viz) {
|
|
165
|
+
return hexbinState(viz).colorRows ?? estimatedColorRows(viz, hexbinSettings(viz));
|
|
166
|
+
}
|
|
167
|
+
/** The share of the chart's size the plot area is estimated to take. */ const ESTIMATED_PLOT = {
|
|
168
|
+
width: 0.8,
|
|
169
|
+
height: 0.7
|
|
170
|
+
};
|
|
171
|
+
/**
|
|
172
|
+
The colorScale's rows before the plot area is known (only its margin
|
|
173
|
+
depends on them): the observations measured in a plot area estimated
|
|
174
|
+
from the chart's size. The emitter refreshes the colorScale with the
|
|
175
|
+
rows it measures.
|
|
176
|
+
*/ export function estimatedColorRows(viz, settings) {
|
|
177
|
+
const rows = viz._filteredData ?? [];
|
|
178
|
+
const xs = rows.map((d, i)=>Number(viz._x(d, i))).filter(isNumeric);
|
|
179
|
+
const ys = rows.map((d, i)=>Number(viz._y(d, i))).filter(isNumeric);
|
|
180
|
+
if (!xs.length || !ys.length) return [];
|
|
181
|
+
const panels = panelRows(viz, rows);
|
|
182
|
+
const frame = {
|
|
183
|
+
left: 0,
|
|
184
|
+
top: 0,
|
|
185
|
+
width: viz.schema.width * ESTIMATED_PLOT.width / Math.sqrt(panels.length),
|
|
186
|
+
height: viz.schema.height * ESTIMATED_PLOT.height / Math.sqrt(panels.length)
|
|
187
|
+
};
|
|
188
|
+
const toX = scaleLinear().domain(extent(xs)).range([
|
|
189
|
+
frame.left,
|
|
190
|
+
frame.left + frame.width
|
|
191
|
+
]);
|
|
192
|
+
const toY = scaleLinear().domain(extent(ys)).range([
|
|
193
|
+
frame.top + frame.height,
|
|
194
|
+
frame.top
|
|
195
|
+
]);
|
|
196
|
+
const origin = [
|
|
197
|
+
frame.left,
|
|
198
|
+
frame.top + frame.height
|
|
199
|
+
];
|
|
200
|
+
return panels.flatMap((group)=>colorRows(placeRows(viz, group, toX, toY, settings), frame, origin, settings));
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
Lays the colorScale out again with `rows`, in the frame it already
|
|
204
|
+
claimed, so its scale (which the bins' fills read) spans what's drawn.
|
|
205
|
+
The rows are kept for any later layout of the colorScale in this draw
|
|
206
|
+
(see `colorScaleRows`).
|
|
207
|
+
*/ export function refreshColorScale(viz, rows) {
|
|
208
|
+
hexbinState(viz).colorRows = rows;
|
|
209
|
+
const cs = viz._colorScaleClass;
|
|
210
|
+
if (!cs || !viz.schema.colorScale) return;
|
|
211
|
+
cs.data(rows).render();
|
|
212
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's resolved options and the rows it draws: one row per bin or
|
|
3
|
+
contour level, each carrying what it measures under `HEXBIN_META`.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/ import { fieldAccessor, fieldNameOf } from "../../utils/fieldAccessor.js";
|
|
7
|
+
/** The shape key Hexbin's observations, bins and contours draw under. */ export const HEXBIN_SHAPE = "Hexbin";
|
|
8
|
+
/** The key a bin or contour row keeps its measure under. */ export const HEXBIN_META = "__d3plusHexbin";
|
|
9
|
+
/** `contourConfig`'s defaults. */ export const CONTOUR_DEFAULTS = {
|
|
10
|
+
bandwidth: 20,
|
|
11
|
+
thresholds: 8,
|
|
12
|
+
strokeWidth: 1.5,
|
|
13
|
+
fillOpacity: 0.8,
|
|
14
|
+
labels: true,
|
|
15
|
+
labelConfig: {},
|
|
16
|
+
labelSpacing: "auto",
|
|
17
|
+
labelStep: "auto"
|
|
18
|
+
};
|
|
19
|
+
/** `pointConfig`'s defaults (the fill follows the chart's text color). */ export const POINT_DEFAULTS = {
|
|
20
|
+
r: 1.5,
|
|
21
|
+
fillOpacity: 0.35
|
|
22
|
+
};
|
|
23
|
+
/** The default `binSize`, in pixels. */ export const BIN_SIZE = 12;
|
|
24
|
+
/** Walks Plot's `__d3plus__` wrappers down to the row. */ export function unwrapHexbinRow(d) {
|
|
25
|
+
while(d && d.__d3plus__ && d.data)d = d.data;
|
|
26
|
+
return d;
|
|
27
|
+
}
|
|
28
|
+
/** The measure a (possibly wrapped) bin or contour row carries, if any. */ export function hexbinMeta(d) {
|
|
29
|
+
const row = d ? unwrapHexbinRow(d) : undefined;
|
|
30
|
+
return row ? row[HEXBIN_META] : undefined;
|
|
31
|
+
}
|
|
32
|
+
/** A bin's measure or a contour's level: what Hexbin's colorScale reads. */ export function hexbinValue(d) {
|
|
33
|
+
const meta = hexbinMeta(d);
|
|
34
|
+
return meta ? meta.kind === "bin" ? meta.value : meta.level : undefined;
|
|
35
|
+
}
|
|
36
|
+
/** A row holding a bin's or contour's measure. */ export function hexbinRow(id, meta) {
|
|
37
|
+
return {
|
|
38
|
+
id,
|
|
39
|
+
[HEXBIN_META]: meta
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
Resolves `binValue` to an aggregation, the accessor it aggregates, and
|
|
44
|
+
the name of what each bin measures.
|
|
45
|
+
*/ export function resolveBinValue(option, translate) {
|
|
46
|
+
if (!option || option === "count" || typeof option !== "object") return {
|
|
47
|
+
agg: "count",
|
|
48
|
+
measure: translate("Count")
|
|
49
|
+
};
|
|
50
|
+
const { value, agg, label } = option;
|
|
51
|
+
const weight = typeof value === "function" ? value : typeof value === "string" ? fieldAccessor(value) : undefined;
|
|
52
|
+
if (!weight) return {
|
|
53
|
+
agg: "count",
|
|
54
|
+
measure: translate("Count")
|
|
55
|
+
};
|
|
56
|
+
const mode = agg === "mean" ? "mean" : "sum";
|
|
57
|
+
const key = typeof value === "string" ? value : fieldNameOf(weight) ?? undefined;
|
|
58
|
+
const name = translate(mode === "mean" ? "Mean" : "Total");
|
|
59
|
+
return {
|
|
60
|
+
agg: mode,
|
|
61
|
+
weight,
|
|
62
|
+
measure: label ?? (key ? `${name} ${key}` : name)
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
/** Hexbin's options, resolved from its config for one draw. */ export function hexbinSettings(viz) {
|
|
66
|
+
const s = viz.schema;
|
|
67
|
+
const translate = (k)=>s.translate(k);
|
|
68
|
+
const shape = s.binShape === "square" ? "square" : s.binShape === false ? false : "hex";
|
|
69
|
+
const size = Number(s.binSize);
|
|
70
|
+
const contours = s.contours === "filled" ? "filled" : s.contours === true || s.contours === "lines" ? "lines" : false;
|
|
71
|
+
return {
|
|
72
|
+
shape,
|
|
73
|
+
size: size > 0 ? size : BIN_SIZE,
|
|
74
|
+
...resolveBinValue(s.binValue, translate),
|
|
75
|
+
contours,
|
|
76
|
+
contourConfig: {
|
|
77
|
+
...CONTOUR_DEFAULTS,
|
|
78
|
+
...s.contourConfig
|
|
79
|
+
},
|
|
80
|
+
points: Boolean(s.points),
|
|
81
|
+
pointConfig: {
|
|
82
|
+
...POINT_DEFAULTS,
|
|
83
|
+
...s.pointConfig
|
|
84
|
+
}
|
|
85
|
+
};
|
|
86
|
+
}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
Hexbin's tooltip and aria text: a bin's measure and its x and y ranges,
|
|
3
|
+
or a contour's density range.
|
|
4
|
+
|
|
5
|
+
@module
|
|
6
|
+
*/ import { formatAbbreviate } from "@d3plus/format";
|
|
7
|
+
import { hexbinMeta, hexbinSettings } from "./settings.js";
|
|
8
|
+
const fmt = (viz, n)=>Number.isFinite(n) ? formatAbbreviate(n, viz.schema.locale) : "";
|
|
9
|
+
const range = (viz, lo, hi)=>`${fmt(viz, lo)} – ${fmt(viz, hi)}`;
|
|
10
|
+
/** The name an axis goes by: its data key, or the axis letter. */ function axisName(viz, axis) {
|
|
11
|
+
const key = viz[`_${axis}Key`];
|
|
12
|
+
return typeof key === "string" ? key : axis;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
A contour level's value as text: through `levelFormat` when set, or
|
|
16
|
+
abbreviated (`1.5k`).
|
|
17
|
+
@param viz The chart.
|
|
18
|
+
@param level The level.
|
|
19
|
+
*/ export function contourLevelText(viz, level) {
|
|
20
|
+
const format = viz.schema.levelFormat;
|
|
21
|
+
return typeof format === "function" ? `${format(level)}` : fmt(viz, level);
|
|
22
|
+
}
|
|
23
|
+
/** A contour level's density range: up to the next level, or the level and up. */ function levelRange(viz, level, next) {
|
|
24
|
+
const text = (n)=>contourLevelText(viz, n);
|
|
25
|
+
return next === undefined ? `≥ ${text(level)}` : `${text(level)} – ${text(next)}`;
|
|
26
|
+
}
|
|
27
|
+
/** A bin's tooltip title: its measure, such as "Count: 42". */ export function hexbinTooltipTitle(viz, d) {
|
|
28
|
+
const meta = hexbinMeta(d);
|
|
29
|
+
if (!meta) return "";
|
|
30
|
+
const t = (s)=>viz.schema.translate(s);
|
|
31
|
+
if (meta.kind === "contour") return t("Density");
|
|
32
|
+
return `${hexbinSettings(viz).measure}: ${fmt(viz, meta.value)}`;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
A bin's tooltip rows: its x and y ranges, and its count when it measures
|
|
36
|
+
something else. A contour's: its density range, in points per bin.
|
|
37
|
+
*/ export function hexbinTooltipRows(viz, d) {
|
|
38
|
+
const meta = hexbinMeta(d);
|
|
39
|
+
if (!meta) return [];
|
|
40
|
+
const t = (s)=>viz.schema.translate(s);
|
|
41
|
+
if (meta.kind === "contour") return [
|
|
42
|
+
[
|
|
43
|
+
t("Range"),
|
|
44
|
+
levelRange(viz, meta.level, meta.next)
|
|
45
|
+
]
|
|
46
|
+
];
|
|
47
|
+
const rows = [
|
|
48
|
+
[
|
|
49
|
+
axisName(viz, "x"),
|
|
50
|
+
range(viz, meta.x0, meta.x1)
|
|
51
|
+
],
|
|
52
|
+
[
|
|
53
|
+
axisName(viz, "y"),
|
|
54
|
+
range(viz, meta.y0, meta.y1)
|
|
55
|
+
]
|
|
56
|
+
];
|
|
57
|
+
if (hexbinSettings(viz).agg !== "count") rows.push([
|
|
58
|
+
t("Count"),
|
|
59
|
+
fmt(viz, meta.count)
|
|
60
|
+
]);
|
|
61
|
+
return rows;
|
|
62
|
+
}
|
|
63
|
+
/** A bin's accessible name: its measure, then its x and y ranges. */ export function binAriaLabel(viz, d) {
|
|
64
|
+
const meta = hexbinMeta(d);
|
|
65
|
+
if (!meta) return "";
|
|
66
|
+
return [
|
|
67
|
+
hexbinTooltipTitle(viz, d),
|
|
68
|
+
`${axisName(viz, "x")} ${range(viz, meta.x0, meta.x1)}`,
|
|
69
|
+
`${axisName(viz, "y")} ${range(viz, meta.y0, meta.y1)}`
|
|
70
|
+
].join(", ");
|
|
71
|
+
}
|
|
72
|
+
/** A contour's accessible name: "Density" and its range. */ export function contourAriaLabel(viz, d) {
|
|
73
|
+
const meta = hexbinMeta(d);
|
|
74
|
+
if (!meta || meta.kind !== "contour") return "";
|
|
75
|
+
const t = (s)=>viz.schema.translate(s);
|
|
76
|
+
return `${t("Density")}: ${levelRange(viz, meta.level, meta.next)}`;
|
|
77
|
+
}
|
|
@@ -2,6 +2,24 @@
|
|
|
2
2
|
Pure binning for Histogram: raw observation rows → one row per group per
|
|
3
3
|
bin. Every group in a panel shares one set of bin edges.
|
|
4
4
|
*/ import { bin, extent, groups, range, thresholdSturges } from "d3-array";
|
|
5
|
+
/**
|
|
6
|
+
The normalization a cumulative histogram draws: the running sum of a
|
|
7
|
+
density is the share of observations so far, so `"density"` reads as
|
|
8
|
+
`"relative"` (an empirical CDF).
|
|
9
|
+
*/ export function cumulativeNormalize(normalize = "count", cumulative = false) {
|
|
10
|
+
return cumulative && normalize === "density" ? "relative" : normalize;
|
|
11
|
+
}
|
|
12
|
+
/** Running sums of `counts`, from the first bin or, with `"reverse"`, the last. */ export function accumulate(counts, cumulative) {
|
|
13
|
+
if (!cumulative) return counts.slice();
|
|
14
|
+
const reverse = cumulative === "reverse";
|
|
15
|
+
const out = new Array(counts.length);
|
|
16
|
+
let total = 0;
|
|
17
|
+
for(let k = 0; k < counts.length; k++){
|
|
18
|
+
const i = reverse ? counts.length - 1 - k : k;
|
|
19
|
+
out[i] = total += counts[i];
|
|
20
|
+
}
|
|
21
|
+
return out;
|
|
22
|
+
}
|
|
5
23
|
/** Evenly spaced edges of `width` covering `[lo, hi]`, anchored at multiples of `width`. */ function widthEdges(lo, hi, width) {
|
|
6
24
|
const start = Math.floor(lo / width) * width;
|
|
7
25
|
const end = Math.max(Math.ceil(hi / width) * width, start + width);
|
|
@@ -32,8 +50,12 @@
|
|
|
32
50
|
...bins.map((b)=>b.x1)
|
|
33
51
|
];
|
|
34
52
|
}
|
|
35
|
-
/**
|
|
36
|
-
|
|
53
|
+
/**
|
|
54
|
+
One row per group per bin for one panel's observations, normalized against
|
|
55
|
+
the panel's total. With `cumulative`, each group accumulates its own counts.
|
|
56
|
+
*/ function binPanel(observations, edges, options) {
|
|
57
|
+
const { group = ()=>"", cumulative = false } = options;
|
|
58
|
+
const normalize = cumulativeNormalize(options.normalize, cumulative);
|
|
37
59
|
const perGroup = bin().domain([
|
|
38
60
|
edges[0],
|
|
39
61
|
edges[edges.length - 1]
|
|
@@ -43,16 +65,21 @@
|
|
|
43
65
|
for (const [, members] of groups(observations, (o)=>group(o.d, o.i))){
|
|
44
66
|
const binned = perGroup(members.map((o)=>o.v));
|
|
45
67
|
const first = members[0].d;
|
|
46
|
-
binned.
|
|
68
|
+
const running = accumulate(binned.map((b)=>b.length), cumulative);
|
|
69
|
+
binned.forEach((b, i)=>{
|
|
47
70
|
const x0 = b.x0, x1 = b.x1;
|
|
48
71
|
const count = b.length;
|
|
49
|
-
const
|
|
72
|
+
const height = running[i];
|
|
73
|
+
const y = normalize === "density" ? height / (total * (x1 - x0)) : normalize === "relative" ? height / total : height;
|
|
50
74
|
out.push({
|
|
51
75
|
...first,
|
|
52
76
|
x0,
|
|
53
77
|
x1,
|
|
54
78
|
x: (x0 + x1) / 2,
|
|
55
79
|
count,
|
|
80
|
+
...cumulative ? {
|
|
81
|
+
cumulativeCount: height
|
|
82
|
+
} : {},
|
|
56
83
|
y
|
|
57
84
|
});
|
|
58
85
|
});
|