Skip to content

Commit 9336d9a

Browse files
committed
some about page updates
1 parent 9c799bc commit 9336d9a

File tree

1 file changed

+36
-26
lines changed

1 file changed

+36
-26
lines changed

site/content/about.md

Lines changed: 36 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,40 @@ title = "About"
44

55
# What is LODESMap?
66

7-
8-
[LODESMap](https://lodesmap.com/) is an interactive map for exploring the United States Census Bureau's [Longitudinal Employer-Household Dynamics](https://lehd.ces.census.gov/data/) (LEHD) data. The LEHD Origin-Destination Employment Statistics (LODES) dataset shows where people live and work on the very granular Census block level. The map allows viewing both directions of travel for a given Census block group, tract, or county:
7+
[LODESMap](https://lodesmap.com/) is an interactive map for exploring the United States Census Bureau's [Longitudinal Employer-Household Dynamics](https://lehd.ces.census.gov/data/) (LEHD) data. The LEHD Origin-Destination Employment Statistics (LODES) dataset shows where people live and work on the very granular Census block level. The map allows viewing both directions of travel for a given Census block group, tract, county subdivision, or county:
98

109
- Clicking on a geography with "Home" as the origin will show where people that live there go to work
1110
- Clicking on a geography with "Work" as the origin will show where people that work there live
1211

13-
Everything is open-source and available on [GitHub](https://github.com/mitchellhenke/lodesmap).
14-
See the [README](https://github.com/mitchellhenke/lodesmap?tab=readme-ov-file) for more.
12+
The Job Segment filter can be used to filter workers by age, wage, or industry type, and the Year filter can be used to see changes over time.
1513

16-
A significant portion of this work is based on [OpenTimes](https://github.com/dfsnow/opentimes) by Dan Snow.
14+
We have intentionally made it easy to share maps. Copying the URL to bookmark it or send it to someone should preserve everything you've selected and present the exact same map when it is opened again.
15+
16+
Everything is open-source and available on [GitHub](https://github.com/mitchellhenke/lodes). See the [README](https://github.com/mitchellhenke/lodes?tab=readme-ov-file) for more.
1717

18-
### Goals
18+
A significant portion of this work is based on [OpenTimes](https://github.com/dfsnow/opentimes) by Dan Snow.
1919

2020
---
2121

2222
## FAQs
2323

24+
<details>
25+
<summary>Data and Mapping</summary>
26+
27+
#### Why does it seem like some data is missing?
28+
29+
Not all states have data available each year. For example, in 2022 data is missing for people living in Michigan, Mississippi, and Alaska.
30+
31+
#### What's up with county subdivisions?
32+
33+
In the [Standard Hierarchy of Census Geographic Entities](https://www.census.gov/newsroom/blogs/random-samplings/2014/07/understanding-geographic-relationships-counties-places-tracts-and-more.html), county subdivisions are beneath counties, which means that each county subdivision must fit within a county. Sometimes, this can be an entire municipality. The City of Milwaukee is a good example. It sits entirely within Milwaukee County, so all of the City of Milwaukee can be represented in one county subdivision.
34+
35+
On the other hand, some municipal boundaries cross multiple counties. Wisconsin Dells, Wisconsin is one such case. It is a city in four different counties: Adams, Columbia, Juneau and Sauk. The result of this looks kind of odd in that there are four county subdivisions that represent Wisconsin Dells.
36+
37+
In less populated areas, a county subdivision can include multiple municipalities.
38+
39+
</details>
40+
2441
<details>
2542
<summary>Technology</summary>
2643

@@ -31,37 +48,30 @@ For a more in-depth technical overview of the project, visit the LODESMap [GitHu
3148
LODESMap currently uses two major data inputs:
3249

3350
1. United States Census Bureau's [TIGER/Line](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html)
34-
shapefiles, which are used to construct origin and destination points.
35-
1. United States Census Bureau's [Longitudinal Employer-Household Dynamics](https://lehd.ces.census.gov/data/) (LEHD) data. The LEHD Origin-Destination Employment Statistics (LODES) dataset shows where people live and work on the very granular Census block level.
51+
shapefiles, which are used to construct origin and destination geometries.
52+
1. United States Census Bureau's [Longitudinal Employer-Household Dynamics](https://lehd.ces.census.gov/data/) (LEHD) Origin-Destination Employment Statistics (LODES) data.
3653

37-
Input and intermediate data are built and cached by [DVC](https://dvc.org).
38-
The total size of all input and intermediate data is around 300 GB.
54+
The LODES data program collects information on employee addresses and workplaces from state unemployment insurance programs. It includes all workers who are on a normal payroll, but it does not include self-employed people. Every job is paired with a worksite, even if the employee works remotely. In this way, the LODES data can reveal remote workers in distant city-pairs. See the official LODES documentation for further details.
3955

40-
#### How is the data served?
41-
42-
Data is served via Parquet files sitting in a public Cloudflare R2 bucket. The public site is hosted on GitHub Pages.
56+
Input data is built and cached by [DVC](https://dvc.org). The total size of all input and output data is around 50 GB.
4357

44-
#### How much does this all cost to host?
58+
#### How is the data served?
4559

46-
It's surprisingly cheap. Basically the only cost is
47-
[R2 storage](https://www.cloudflare.com/developer-platform/r2/) from
48-
Cloudflare. Right now, total costs are under $15 per month.
60+
Data is served via Parquet files in a public Cloudflare R2 bucket. The public site is hosted on GitHub Pages.
4961

5062
#### What map stack do you use for the homepage?
5163

52-
The homepage uses [Maplibre GL JS](https://github.com/maplibre/maplibre-gl-js)
53-
to show maps. The basemap is [OpenFreeMap's](https://openfreemap.org) Positron.
54-
The tract-level boundaries are [TIGER/Line](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html) cartographic boundaries converted to [PMTiles](https://github.com/protomaps/PMTiles) using [Tippecanoe](https://github.com/felt/tippecanoe) and hosted on R2.
55-
56-
When you click the map, your browser queries the Parquet files on the public
57-
bucket using [hyparquet](https://github.com/hyparam/hyparquet). It then updates
58-
the map fill using the returned destination IDs and population count.
64+
The map uses [Maplibre GL JS](https://github.com/maplibre/maplibre-gl-js) to show maps. The basemap is [OpenFreeMap's](https://openfreemap.org) Positron. The boundaries are [TIGER/Line](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html) geometries converted to [PMTiles](https://github.com/protomaps/PMTiles) using [Tippecanoe](https://github.com/felt/tippecanoe).
5965

66+
When you click the map, your browser queries the Parquet files on the public bucket using [hyparquet](https://github.com/hyparam/hyparquet).
6067
</details>
61-
---
6268

63-
## Colophon
69+
---
6470

6571
### Who is behind this project?
6672

73+
[John Johnson](https://johndjohnson.info) and [Mitchell Henke](https://www.mitchellhenke.com)
74+
6775
### Why did you build this?
76+
77+
LODES data is an incredible dataset that lacks an accessible interface and it is relatively unique in that past data is available in current Census geometries. We hope LODESMap makes it easier to understand where people live and work and how that has changed over time.

0 commit comments

Comments
 (0)