Data visualization software enginner: working to make visualization more accessible, equitable, and impactful.
// Compute the color scale and tooltips for really basic mapping
drawStateMap = (data) => {
data.forEach((d) => (d.id = getStateId(d.state_name))); // add ids
const colorScale = d3
.scaleLinear()
.domain(d3.extent(data, (d) => +d.value))
.range(["lightgray", "blue"]);
const tooltipContents = (datum) => {
const { id, value } = datum;
return `${getStateName(id)}: ${d3.format(".2f")(value)}`;
};
const adminLevel = "states";
return drawChoroplethMap({
data,
colorScale,
tooltipContents,
adminLevel: "states"
});
}
viewof testWithCountiesData = drawChoroplethMap({
data: countiesData,
colorScale,
tooltipContents,
zoomEnabled: zoomToggle === "zoomEnabled"
})
getStateId = (stateName) => {
return state_id_map.get(stateName);
}
getStateName = (stateId) => {
return id_state_map.get(stateId);
}
getStateId("Michigan")
testWithStatesData = drawChoroplethMap({
data: statesData,
colorScale,
tooltipContents,
adminLevel: "states",
zoomEnabled: zoomToggle === "zoomEnabled"
})
statesData
testMoreOptions = drawChoroplethMap({
width: 450,
// height: 300,
zoomEnabled: false,
borderEnabled: false,
adminLevel: "states",
backgroundColor: "#333"
})
colorScale = d3
.scaleQuantize()
.domain([0, 0.8])
.range(d3.schemeRdPu[7])
tooltipContents = datum => {
const { id, value } = datum;
return `${id}: ${d3.format(".2f")(value)}`;
}
drawChoroplethMap = (options = {}) => {
const adminLevel = allowedAdminLevels.has(options.adminLevel)
? options.adminLevel
: "counties";
const data = options.data || [];
const accessor =
options.accessor ||
function (d) {
return d.value;
};
const colorScale = options.colorScale || defaultColorScale;
const colorNoData = options.colorNoData || "#e2e2e2";
const name = options.name
? options.name.replace(/,/gi, "").replace(/ /gi, "")
: DOM.uid().id;
const cssScoped = `map-${name}-${adminLevel}-container`;
const tooltipContents = options.tooltipContents;
const width = options.width || mapConfig.width;
const height = options.height || Math.floor((width * 3) / 5);
const zoomEnabled = options.zoomEnabled !== false ? true : false;
const borderEnabled = options.borderEnabled !== false ? true : false;
const borderColorStates = options.borderColorStates || "#fff";
const borderColorCounties = options.borderColorCounties || "#e2e2e2";
const backgroundColor = options.backgroundColor || "#fff";
// for making the map a "viewof" cell
const initialState = {
selected: {},
hovered: {}
};
const geoData =
adminLevel === "counties" ? countiesGeoByFips : statesGeoByFips;
const zoom = d3.zoom().scaleExtent([1, 8]).on("zoom", zoomed);
const container = html`<div class="${cssScoped}">
<style>
.${cssScoped} {
position: relative;
width: ${width}px;
height: ${height}px;
background-color: ${backgroundColor};
}
.${cssScoped} .tooltip {
display: none;
position: fixed;
font-size: 14px;
font-family: sans-serif, Arial;
padding: 6px;
background-color: #fff;
border: 1px solid #333;
pointer-events: none;
}
.${cssScoped} .zoom-btns {
position: absolute;
bottom: 24px;
right: 24px;
}
.${cssScoped} .zoom-btns button {
display: ${zoomEnabled ? "block;" : "none;"}
width: 25px;
height: 25px;
background-color: #fff;
border: 1px solid #222;
padding: 6px;
margin: 0;
font-weight: bold;
font-family: serif;
font-size: 18px;
line-height: 1px;
cursor: pointer;
}
.${cssScoped} .zoom-btns button:first-of-type {
border-bottom: none;
}
.${cssScoped} .zoom-btns button:hover {
background-color: #e2e2e2;
}
</style>
<div class="zoom-btns">
<button aria-label="zoom in" class="zoom-in">+</button>
<button aria-label="zoom out" class="zoom-out">–</button>
</div>
</div>`;
const svg = d3
.select(container)
.append("svg")
.attr("viewBox", `0 0 ${mapConfig.width} ${mapConfig.height}`);
const g = svg.append("g");
const divTooltip = d3
.select(container)
.append("div")
.classed("tooltip", true);
const tooltip = new Tooltip(divTooltip);
const btnZoomIn = d3
.select(container)
.select("button.zoom-in")
.on("click", handleZoomIn);
const btnZoomOut = d3
.select(container)
.select("button.zoom-out")
.on("click", handleZoomOut);
g.append("g")
.attr("id", "nation-boundary")
.attr("stroke-width", 0.8)
.append("path")
.attr("vector-effect", "non-scaling-stroke")
.attr("d", path(topojson.mesh(us, us.objects.nation)))
.attr("fill", "#eee")
.attr("stroke", "#888");
g.append("g")
.attr("id", `${adminLevel}-data`)
.selectAll("path")
.data(data, (d) => d.id)
.join("path")
.attr("vector-effect", "non-scaling-stroke")
.attr("d", (d) => path(geoData.get(d.id)))
.attr("fill", (d) => {
const value = accessor(d);
if (value === null || value === undefined) {
return colorNoData;
}
return colorScale(value);
})
.on("mouseover", ({ currentTarget }, d) => {
d3.select(currentTarget)
.attr("stroke", "yellow")
.attr("stroke-width", 2)
.raise();
if (tooltipContents) tooltip.display(d, tooltipContents);
dispatch("hovered", d);
})
.on("mouseout", ({ currentTarget }) => {
d3.select(currentTarget).attr("stroke", "none").attr("stroke-width", 0);
if (tooltipContents) tooltip.hide();
})
.on("mousemove", (event) => {
if (tooltipContents) tooltip.move(event);
})
.on("click", (event, d) => {
dispatch("selected", d);
});
if (adminLevel === "counties") {
g.append("g")
.attr("id", "county-boundaries")
.attr("stroke-width", 0.5)
.append("path")
.attr(
"d",
path(
topojson.mesh(
us,
us.objects.counties,
(a, b) => a !== b && ((a.id / 1000) | 0) === ((b.id / 1000) | 0)
)
)
)
.attr("fill", "none")
.attr("stroke", borderColorCounties);
}
g.append("g")
.attr("id", "state-boundaries")
.attr("stroke-width", 0.7)
.append("path")
.attr("vector-effect", "non-scaling-stroke")
.attr("d", path(topojson.mesh(us, us.objects.states)))
.attr("fill", "none")
.attr("stroke", borderColorStates);
if (borderEnabled) {
svg
.append("rect")
.attr("width", mapConfig.width)
.attr("height", mapConfig.height)
.attr("fill", "none")
.attr("stroke", "#222")
.attr("stroke-width", 2);
}
// Helper functions that need access to local variables in this cell
function zoomed({ transform }) {
g.attr("transform", transform);
g.selectAll("g").attr("stroke-width", 1 / transform.k);
}
function handleZoomIn(event) {
svg.transition().duration(500).call(zoom.scaleBy, 1.74);
}
function handleZoomOut(event) {
svg.transition().duration(500).call(zoom.scaleBy, 0.5);
}
// for when the map is a "viewof" cell
function dispatch(key, value) {
container.value = { ...container.value, ...{ [key]: value } };
container.dispatchEvent(new CustomEvent("input"));
}
if (zoomEnabled) svg.call(zoom);
container.value = { ...initialState };
return container;
}
mapConfig = ({
padding: 24,
height: Math.floor((width * 3) / 5),
width
})
defaultColorScale = d3.scaleQuantize().domain([0, 1]).range(d3.schemeRdPu[5])
allowedAdminLevels = new Set(["counties", "states"])
path = d3.geoPath(projection)
projection = d3
.geoAlbersUsa()
.fitExtent(
[
[mapConfig.padding, mapConfig.padding],
[
mapConfig.width - mapConfig.padding,
mapConfig.height - mapConfig.padding
]
],
countiesGeo
)
format = d3.format(".2f")
countiesData = Array.from(testData.entries()).map(([id, values]) => ({
id,
value: values.HD01_VD13 / values.HD01_VD01
}))
countiesGeoByFips = new Map(countiesGeo.features.map(d => [d.id, d]))
countiesGeo = topojson.feature(us, "counties")
Array.from(statesGeoByFips.values()).map((id) => {
return id;
})
Array.from(statesGeoByFips.values())
state_id_map = new Map(
Array.from(statesGeoByFips.values()).map((d) => [d.properties.name, d.id])
)
id_state_map = new Map(
Array.from(statesGeoByFips.values()).map((d) => [d.id, d.properties.name])
)
statesData = {
const data = Array.from(statesGeoByFips.keys()).map(id => ({
id,
value: +format(Math.random())
}));
data.find(d => d.id === "48").value = null; // test no data color
return data;
}
statesGeoByFips = new Map(statesGeo.features.map(d => [d.id, d]))
statesGeo = topojson.feature(us, "states")
us = d3.json("https://cdn.jsdelivr.net/npm/us-atlas@3/counties-10m.json")
topojson = require("topojson-client@3")
import { checkbox } from "@jashkenas/inputs"
import { acs as testData } from "@clhenrick/u-s-broadband-internet-access"
import {
countyFipsToName,
countyNameToFips,
stateNameToFips,
stateFipsToName
} from "@clhenrick/us-census-constants"
import { Tooltip } from "@clhenrick/tooltip-component"
d3 = require("d3@6")
One platform to build and deploy the best data apps
Experiment and prototype by building visualizations in live JavaScript notebooks. Collaborate with your team and decide which concepts to build out.
Use Observable Framework to build data apps locally. Use data loaders to build in any language or library, including Python, SQL, and R.
Seamlessly deploy to Observable. Test before you ship, use automatic deploy-on-commit, and ensure your projects are always up-to-date.