{"pack_id":"usa_lodes","pack_name":"USA LODES Workplace Employment","pack_version":"1.1.0","title":"USA Lodes","description":"Annual tract-level workplace job counts by industry and worker characteristics from the Census LEHD LODES program.","catalog_short_description":"Annual tract-level workplace employment across the USA from Census LEHD LODES8, with total jobs plus industry, age, earnings, race, education, sex, firm-age, and firm-size breakdowns. Best source for locating where manufacturing, wholesale, and warehousing jobs are physically concentrated.","license":"Public Domain (U.S. Government)","material_policy":{"schema_version":"1.2.0","object_kind":"pack","object_id":"usa_lodes","policy_source":"build/catalog/license_permission_crosswalk.csv","permission":"paid","licenses":["Public Domain (U.S. Government)"],"resolution_status":"resolved","hosted_access":{"maximum_lane":"paid","publication_ready":true,"free_allowed":true,"paid_allowed":true,"reason_codes":["allowed"]},"redistribution":{"status":"allowed","allowed":true,"share_alike":"no"},"reuse_obligations":[],"surface_access":{"hosted_results":true,"server_rendered_display":true,"client_geometry":true,"download":true,"blocked_by_source_review":[],"restrictions":[]},"attribution":{"required":false,"status":"resolved","text":"Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain).","lines":["Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain)."]},"citation":{"style":"daedalmap-1","entries":[{"text":"U.S. Census Bureau, LEHD Program. USA LODES Workplace Employment. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/.","role":"primary","parts":{"role":"primary","agency":"U.S. Census Bureau, LEHD Program","title":"USA LODES Workplace Employment","vintage":"","url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)"}}],"text":"U.S. Census Bureau, LEHD Program. USA LODES Workplace Employment. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/."},"license_evidence":[{"license":"Public Domain (U.S. Government)","source_url":"https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html","reviewed_on":"2026-09-10"}],"facts_fingerprint":"aa12d26251293ed34c94ac2f95430ccc4241f4eb06a099e688e43b92e1784cc5","policy_fingerprint":"b1c1a1febb1aaababa251ddeb846df7130aab38ed9933d914602ca7862ae1d23"},"upstream_sources":[{"source_id":"census_lehd_lodes8_wac","role":"primary","agency":"U.S. Census Bureau, LEHD Program","agency_short":"Census LEHD","source_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","download_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)","notes":"One gzipped state-year CSV per file. Source rows are native census blocks; this runtime artifact aggregates them to census tracts."}],"quick_start":{"why_it_exists":"Use this pack for annual U.S. census-tract workplace job counts by industry and worker characteristics from LEHD LODES.","start_here":["Use source_id = 'lodes'.","Start with CNS05 for manufacturing jobs or C000 for all jobs.","Use U.S. state/tract loc_ids and numeric years."],"first_query_template":{"source_id":"lodes","metrics":["CNS05"],"filters":{"region_ids":["USA-GA"],"time":{"value":2022}},"sort":{"field":"CNS05","direction":"desc"},"limit":25},"important_rules":["use the exact metric ids shown in pack detail; casing matters","LODES is workplace-based tract data","metric ids encode industry and worker-characteristic groups","U.S. LEHD LODES is currently a free lane"],"starter_metrics":["CNS05","C000"],"starter_sources":["lodes"]},"discovery_model":{"role":"pack_detail","purpose":"rich_free_discovery","pack_catalog_includes_source_execution_summaries":true,"separate_source_catalog_required":false},"source_count":1,"source_ids":["lodes"],"data_types":["metrics"],"category":"economic","location":{"scopes":["USA"],"geographic_levels":[3],"empty_geographic_levels_meaning":null,"coverage_contract":{"assertions":["explicit_countries"],"worldwide":false,"countries":["USA"],"excluded_countries":[],"unknown_country_coverage":false},"coverage_description":"Single country","geographic_coverage":{"type":"country","countries":null,"admin_levels":[3],"common_count":null,"common_missing":[],"uncommonly_included":[],"region_coverage":{}}},"coverage_windows":[{"source_id":"lodes","coverage_contract":{"assertion":"explicit_countries","scopes":["USA"],"countries":["USA"],"worldwide":false,"excluded_countries":[],"geographic_levels":[3],"empty_geographic_levels_meaning":null},"temporal_start":2002,"temporal_end":2023}],"topic_tags":["employment","industry","logistics","manufacturing","opportunity zones","workplace jobs"],"temporal_coverage":{"start":"2002","end":"2023"},"coverage_description":"Single country","metric_count":51,"metrics":{"C000":"Total primary jobs physically located in the tract.","CA01":"Workplace jobs held by workers age 29 or younger.","CA02":"Workplace jobs held by workers age 30 to 54.","CA03":"Workplace jobs held by workers age 55 or older.","CE01":"Workplace jobs in the lowest LODES monthly earnings band.","CE02":"Workplace jobs in the middle LODES monthly earnings band.","CE03":"Workplace jobs in the highest LODES monthly earnings band.","CNS01":"Agriculture, forestry, fishing, and hunting jobs.","CNS02":"Mining, quarrying, and oil and gas extraction jobs.","CNS03":"Utilities jobs.","CNS04":"Construction jobs.","CNS05":"Manufacturing jobs. Core industrial screening column for OZ analysis.","CNS06":"Wholesale trade jobs. Useful with manufacturing and warehousing for light-industrial screening.","CNS07":"Retail trade jobs.","CNS08":"Transportation and warehousing jobs. Core logistics signal for industrial siting questions.","CNS09":"Information jobs.","CNS10":"Finance and insurance jobs.","CNS11":"Real estate and rental and leasing jobs.","CNS12":"Professional, scientific, and technical services jobs.","CNS13":"Management of companies and enterprises jobs.","CNS14":"Administrative, support, waste management, and remediation jobs.","CNS15":"Educational services jobs.","CNS16":"Health care and social assistance jobs.","CNS17":"Arts, entertainment, and recreation jobs.","CNS18":"Accommodation and food services jobs.","CNS19":"Other services jobs, excluding public administration.","CNS20":"Public administration jobs.","CR01":"LODES race category 1 job count.","CR02":"LODES race category 2 job count.","CR03":"LODES race category 3 job count.","CR04":"LODES race category 4 job count.","CR05":"LODES race category 5 job count.","CR07":"LODES race/ethnicity category 7 job count.","CT01":"LODES ethnicity category 1 job count.","CT02":"LODES ethnicity category 2 job count.","CD01":"LODES education category 1 job count.","CD02":"LODES education category 2 job count.","CD03":"LODES education category 3 job count.","CD04":"LODES education category 4 job count.","CS01":"LODES sex category 1 job count.","CS02":"LODES sex category 2 job count.","CFA01":"LODES firm age category 1 job count.","CFA02":"LODES firm age category 2 job count.","CFA03":"LODES firm age category 3 job count.","CFA04":"LODES firm age category 4 job count.","CFA05":"LODES firm age category 5 job count.","CFS01":"LODES firm size category 1 job count.","CFS02":"LODES firm size category 2 job count.","CFS03":"LODES firm size category 3 job count.","CFS04":"LODES firm size category 4 job count.","CFS05":"LODES firm size category 5 job count."},"supported_query_shapes":["multi_year_multi_location","multi_year_single_location","single_year_multi_location"],"sample_questions":["Show USA Lodes values for one or more regions over time"],"query_dimensions":{"data":"single_or_variable_within_pack","location":"single_or_variable","time":"single_or_variable"},"query_rule":"easy_if_one_query_one_dataset","free_detail":true,"paid_data_calls":false,"live_updates_enabled":false,"canonical_available_through":"2023","preferred_tool":"get_data","sources":[{"source_id":"lodes","source_name":"LEHD LODES Workplace Area Characteristics","description":"Annual tract-level workplace employment across the USA from Census LEHD LODES8, with total jobs plus industry, age, earnings, race, education, sex,...","path":"countries/USA/lodes","data_type":"metrics","scope":"USA","geometry_family":"admin_spine","geographic_levels":[3],"coverage_contract":{"assertion":"explicit_countries","scopes":["USA"],"countries":["USA"],"worldwide":false,"excluded_countries":[],"geographic_levels":[3],"empty_geographic_levels_meaning":null},"temporal_coverage":{"start":2002,"end":2023,"frequency":"annual","granularity":"yearly","field":"timestamp"},"time_field":"timestamp","location_field":"loc_id","supported_query_shapes":["single_year_multi_location","multi_year_single_location","multi_year_multi_location"],"metrics":{"C000":{"name":"Total Workplace Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Total primary jobs physically located in the tract."},"CA01":{"name":"Jobs Age 29 or Younger","unit":"jobs","years":null,"countries":null,"density":null,"description":"Workplace jobs held by workers age 29 or younger."},"CA02":{"name":"Jobs Age 30 to 54","unit":"jobs","years":null,"countries":null,"density":null,"description":"Workplace jobs held by workers age 30 to 54."},"CA03":{"name":"Jobs Age 55 or Older","unit":"jobs","years":null,"countries":null,"density":null,"description":"Workplace jobs held by workers age 55 or older."},"CE01":{"name":"Low-Earnings Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Workplace jobs in the lowest LODES monthly earnings band."},"CE02":{"name":"Medium-Earnings Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Workplace jobs in the middle LODES monthly earnings band."},"CE03":{"name":"High-Earnings Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Workplace jobs in the highest LODES monthly earnings band."},"CNS01":{"name":"Agriculture Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Agriculture, forestry, fishing, and hunting jobs."},"CNS02":{"name":"Mining Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Mining, quarrying, and oil and gas extraction jobs."},"CNS03":{"name":"Utilities Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Utilities jobs."},"CNS04":{"name":"Construction Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Construction jobs."},"CNS05":{"name":"Manufacturing Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Manufacturing jobs. Core industrial screening column for OZ analysis."},"CNS06":{"name":"Wholesale Trade Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Wholesale trade jobs. Useful with manufacturing and warehousing for light-industrial screening."},"CNS07":{"name":"Retail Trade Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Retail trade jobs."},"CNS08":{"name":"Transportation and Warehousing Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Transportation and warehousing jobs. Core logistics signal for industrial siting questions."},"CNS09":{"name":"Information Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Information jobs."},"CNS10":{"name":"Finance and Insurance Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Finance and insurance jobs."},"CNS11":{"name":"Real Estate Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Real estate and rental and leasing jobs."},"CNS12":{"name":"Professional Services Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Professional, scientific, and technical services jobs."},"CNS13":{"name":"Management Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Management of companies and enterprises jobs."},"CNS14":{"name":"Administrative and Support Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Administrative, support, waste management, and remediation jobs."},"CNS15":{"name":"Educational Services Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Educational services jobs."},"CNS16":{"name":"Health Care and Social Assistance Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Health care and social assistance jobs."},"CNS17":{"name":"Arts and Recreation Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Arts, entertainment, and recreation jobs."},"CNS18":{"name":"Accommodation and Food Services Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Accommodation and food services jobs."},"CNS19":{"name":"Other Services Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Other services jobs, excluding public administration."},"CNS20":{"name":"Public Administration Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"Public administration jobs."},"CR01":{"name":"Race Category 1 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES race category 1 job count."},"CR02":{"name":"Race Category 2 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES race category 2 job count."},"CR03":{"name":"Race Category 3 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES race category 3 job count."},"CR04":{"name":"Race Category 4 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES race category 4 job count."},"CR05":{"name":"Race Category 5 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES race category 5 job count."},"CR07":{"name":"Race or Ethnicity Category 7 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES race/ethnicity category 7 job count."},"CT01":{"name":"Ethnicity Category 1 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES ethnicity category 1 job count."},"CT02":{"name":"Ethnicity Category 2 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES ethnicity category 2 job count."},"CD01":{"name":"Education Category 1 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES education category 1 job count."},"CD02":{"name":"Education Category 2 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES education category 2 job count."},"CD03":{"name":"Education Category 3 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES education category 3 job count."},"CD04":{"name":"Education Category 4 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES education category 4 job count."},"CS01":{"name":"Sex Category 1 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES sex category 1 job count."},"CS02":{"name":"Sex Category 2 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES sex category 2 job count."},"CFA01":{"name":"Firm Age Category 1 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm age category 1 job count."},"CFA02":{"name":"Firm Age Category 2 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm age category 2 job count."},"CFA03":{"name":"Firm Age Category 3 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm age category 3 job count."},"CFA04":{"name":"Firm Age Category 4 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm age category 4 job count."},"CFA05":{"name":"Firm Age Category 5 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm age category 5 job count."},"CFS01":{"name":"Firm Size Category 1 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm size category 1 job count."},"CFS02":{"name":"Firm Size Category 2 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm size category 2 job count."},"CFS03":{"name":"Firm Size Category 3 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm size category 3 job count."},"CFS04":{"name":"Firm Size Category 4 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm size category 4 job count."},"CFS05":{"name":"Firm Size Category 5 Jobs","unit":"jobs","years":null,"countries":null,"density":null,"description":"LODES firm size category 5 job count."}},"metric_ids":["C000","CA01","CA02","CA03","CD01","CD02","CD03","CD04","CE01","CE02","CE03","CFA01","CFA02","CFA03","CFA04","CFA05","CFS01","CFS02","CFS03","CFS04","CFS05","CNS01","CNS02","CNS03","CNS04","CNS05","CNS06","CNS07","CNS08","CNS09","CNS10","CNS11","CNS12","CNS13","CNS14","CNS15","CNS16","CNS17","CNS18","CNS19","CNS20","CR01","CR02","CR03","CR04","CR05","CR07","CS01","CS02","CT01","CT02"],"filterable_fields":["loc_id","year","timestamp"],"sortable_fields":["loc_id","year","timestamp","C000","CNS05","CNS06","CNS08"],"routing_hints":{"family_role":"industrial_member_of_usa_industrial_activity_pack","use_for":"Use this source for workplace job concentration, especially manufacturing, wholesale trade, and transportation/warehousing inside or near Opportunity Zone tracts.","supported_geography_summary":"USA census tracts, with county/state rollups available by hierarchical loc_id prefix.","pack_shape_note":"This source is the employment-location layer inside the usa_industrial_activity pack and pairs naturally with cbp and susb."},"reference_guidance":{"notes":{"runtime_shape":"Research/runtime uses USA_tract.parquet, a tract-level annual rollup built from the block-level state-year parquets. This keeps the source map-usable while preserving the raw yearly block files on disk.","oz_use_case":"For Opportunity Zone analysis, the most important sector columns are CNS05 (manufacturing), CNS06 (wholesale trade), and CNS08 (transportation and warehousing).","detail_archive":"The folder also retains 22 yearly block-level parquets (USA_2002.parquet through USA_2023.parquet) for deeper offline analysis."},"query_contract":{"location_field":"loc_id","time_required":false,"time_field":"timestamp","location_filter_mode":"hierarchical_loc_id","default_limit":500,"max_limit":200000,"notes":["Use tract-level loc_id filters by default. County and state requests work by hierarchical prefix aggregation from tract rows.","Prefer C000 for total workplace jobs and CNS05/CNS06/CNS08 for light-industrial screening.","Useful synonyms include factory jobs, warehouse jobs, distribution employment, industrial employment, and workplace jobs.","This is workplace geography, not residence geography."]},"keywords":["LODES","LEHD","WAC","jobs","manufacturing jobs","workplace employment","tract employment","warehouse jobs","distribution jobs","industrial employment","factory jobs"]},"upstream_sources":[{"source_id":"census_lehd_lodes8_wac","role":"primary","agency":"U.S. Census Bureau, LEHD Program","agency_short":"Census LEHD","source_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","download_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)","notes":"One gzipped state-year CSV per file. Source rows are native census blocks; this runtime artifact aggregates them to census tracts."}],"license_policy":{"schema_version":"1.2.0","license":"Public Domain (U.S. Government)","permission":"paid","resolution_status":"resolved","policy_source":"build/catalog/license_permission_crosswalk.csv","reason":"U.S. government public-domain posture supports paid hosted use.","redistribution":"allowed","share_alike":"no","attribution_required":false,"attribution_template":"Source: {agency} (U.S. Government work, public domain).","source_url":"https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html","reviewed_on":"2026-09-10","notes":"Legacy spelling canonicalized to the source-aware U.S. federal label.","reuse_obligations":{"copyleft_scope":null,"required_public_license":null,"source_offer_required":null}},"material_policy":{"schema_version":"1.2.0","object_kind":"source","object_id":"lodes","policy_source":"build/catalog/license_permission_crosswalk.csv","permission":"paid","licenses":["Public Domain (U.S. Government)"],"resolution_status":"resolved","hosted_access":{"maximum_lane":"paid","publication_ready":true,"free_allowed":true,"paid_allowed":true,"reason_codes":["allowed"]},"redistribution":{"status":"allowed","allowed":true,"share_alike":"no"},"reuse_obligations":[],"surface_access":{"hosted_results":true,"server_rendered_display":true,"client_geometry":true,"download":true,"blocked_by_source_review":[],"restrictions":[]},"attribution":{"required":false,"status":"resolved","text":"Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain).","lines":["Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain)."]},"citation":{"style":"daedalmap-1","entries":[{"text":"U.S. Census Bureau, LEHD Program. LEHD LODES Workplace Area Characteristics. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/.","role":"primary","parts":{"role":"primary","agency":"U.S. Census Bureau, LEHD Program","title":"LEHD LODES Workplace Area Characteristics","vintage":"","url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)"}}],"text":"U.S. Census Bureau, LEHD Program. LEHD LODES Workplace Area Characteristics. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/."},"license_evidence":[{"license":"Public Domain (U.S. Government)","source_url":"https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html","reviewed_on":"2026-09-10"}],"facts_fingerprint":"8ad5a201285fa22cc111c33b062f6e85d6b602adf334f5ff39d44b7f0aea93a9","policy_fingerprint":"b1c1a1febb1aaababa251ddeb846df7130aab38ed9933d914602ca7862ae1d23"},"size":{"contract_version":1,"transfer_mb":142.71,"browser_storage_estimate_mb":142.71,"working_set_estimate_mb":1136.52},"browser_artifact":{"contract_version":1,"artifact_version":"1c514734dfb7902faf10ed7e9741d9bac0249b35f64b11910a01a643168cc1a8","format":"application/gzip","storage_key":"published/browser_artifacts/sources/lodes/runtime_snapshot_v1_1c514734dfb7902f.json.gz","sha256":"1c514734dfb7902faf10ed7e9741d9bac0249b35f64b11910a01a643168cc1a8","transfer_bytes":149643429,"transfer_mb":142.71,"stored_bytes":149643429,"stored_mb":142.71,"expanded_bytes":1191724926,"expanded_mb":1136.52,"generated_at":"2026-08-03T07:15:36.330441Z","source_snapshot_version":1},"live_updates_enabled":false,"canonical_available_through":2023,"source_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)","source_license":null,"category":"economic","geojson_shape":"geometry_shape","geometry_families":null,"supports_admin_spine_crosswalk":null,"display_contract":{"family":"admin_choropleth","geometry_family":"admin_spine","popup_family":"metric_popup","timeline":{"clock":"utc","playhead_unit":"epoch_ms","mode":"discrete_frames","time_field":"timestamp","source_time_unit":"datetime","native_granularity":"yearly","timestamp_semantics":"period_start","frame_policy":"hold_previous","animation_style":"replace_frame"}},"pack_id":"usa_lodes","pack_representative":true,"pack_maintainer_name":"","pack_maintainer_url":"","pack_version":"1.1.0","release_state":"published","access_scope":null,"wip_note":"","catalog_surfaces":["api","research","explore","mcp"],"live_watermark_utc":null,"processing_state":null,"topic_tags":["employment","industry","manufacturing","logistics","workplace jobs","opportunity zones"],"keywords":["LODES","LEHD","WAC","jobs","manufacturing jobs","workplace employment","tract employment","warehouse jobs","distribution jobs","industrial employment","factory jobs"],"geographic_level":"admin_3","geographic_coverage":{"type":"country","countries":null,"admin_levels":[3],"common_count":null,"common_missing":[],"uncommonly_included":[],"region_coverage":{}},"coverage_description":"Single country","row_count":1815420,"file_size_mb":142.71,"browser_storage_estimate_mb":142.71,"working_set_estimate_mb":1136.52,"browser_artifact_available":true,"browser_artifact_policy":null,"llm_summary":"Annual tract-level workplace employment across the USA from Census LEHD LODES8, with total jobs plus industry, age, earnings, race, education, sex, firm-age, and firm-size breakdowns. Best source for locating where manufacturing, wholesale, and warehousing jobs are physically concentrated.","time_granularity":"yearly","runtime_primary_file":"USA_tract.parquet","default_load":{"kind":"confirmed_order","summary":"Showing US census tracts by manufacturing workplace jobs from LODES. Ask to swap to logistics, wholesale, health care, education, or professional services to compare different job-center patterns.","items":[{"source_id":"lodes","pack_id":"usa_lodes","metric":"CNS05","geo_level":"admin_3"}]},"default_question":"Show me the US tracts with the highest manufacturing workplace employment.","default_response":"Showing US census tracts by manufacturing workplace jobs from LODES. Ask to swap to logistics, wholesale, health care, education, or professional services to compare different job-center patterns.","reference":{"source":{"source_id":"lodes","source_name":"LEHD LODES Workplace Area Characteristics","source_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (US government work)","category":"economic","description":"Annual workplace job counts by industry and worker/firm attributes from Census LEHD LODES8. Runtime artifact is tract-level so Research mode can map and compare industrial employment concentration, while yearly block-level detail remains on disk.","topic_tags":["employment","industry","manufacturing","logistics","workplace jobs","opportunity zones"],"keywords":["LODES","LEHD","WAC","jobs","manufacturing jobs","workplace employment","tract employment","warehouse jobs","distribution jobs","industrial employment","factory jobs"],"data_type":"metrics","geojson_shape":"geometry_shape","pack_id":"usa_industrial_activity"},"upstream_sources":[{"source_id":"census_lehd_lodes8_wac","role":"primary","agency":"U.S. Census Bureau, LEHD Program","agency_short":"Census LEHD","source_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","download_url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)","notes":"One gzipped state-year CSV per file. Source rows are native census blocks; this runtime artifact aggregates them to census tracts."}],"metrics":{"C000":"Total primary jobs located in the tract.","CA01":"Jobs for workers age 29 or younger.","CA02":"Jobs for workers age 30 to 54.","CA03":"Jobs for workers age 55 or older.","CE01":"Jobs with low monthly earnings.","CE02":"Jobs with medium monthly earnings.","CE03":"Jobs with high monthly earnings.","CNS01":"Agriculture, forestry, fishing, and hunting jobs.","CNS02":"Mining, quarrying, and oil and gas extraction jobs.","CNS03":"Utilities jobs.","CNS04":"Construction jobs.","CNS05":"Manufacturing jobs.","CNS06":"Wholesale trade jobs.","CNS07":"Retail trade jobs.","CNS08":"Transportation and warehousing jobs.","CNS09":"Information jobs.","CNS10":"Finance and insurance jobs.","CNS11":"Real estate and rental and leasing jobs.","CNS12":"Professional, scientific, and technical services jobs.","CNS13":"Management of companies and enterprises jobs.","CNS14":"Administrative, support, waste management, and remediation jobs.","CNS15":"Educational services jobs.","CNS16":"Health care and social assistance jobs.","CNS17":"Arts, entertainment, and recreation jobs.","CNS18":"Accommodation and food services jobs.","CNS19":"Other services jobs, excluding public administration.","CNS20":"Public administration jobs.","CR01":"Race category 1 job count from LODES WAC.","CR02":"Race category 2 job count from LODES WAC.","CR03":"Race category 3 job count from LODES WAC.","CR04":"Race category 4 job count from LODES WAC.","CR05":"Race category 5 job count from LODES WAC.","CR07":"Race/ethnicity category 7 job count from LODES WAC.","CT01":"Ethnicity category 1 job count from LODES WAC.","CT02":"Ethnicity category 2 job count from LODES WAC.","CD01":"Education category 1 job count from LODES WAC.","CD02":"Education category 2 job count from LODES WAC.","CD03":"Education category 3 job count from LODES WAC.","CD04":"Education category 4 job count from LODES WAC.","CS01":"Sex category 1 job count from LODES WAC.","CS02":"Sex category 2 job count from LODES WAC.","CFA01":"Firm age category 1 job count from LODES WAC.","CFA02":"Firm age category 2 job count from LODES WAC.","CFA03":"Firm age category 3 job count from LODES WAC.","CFA04":"Firm age category 4 job count from LODES WAC.","CFA05":"Firm age category 5 job count from LODES WAC.","CFS01":"Firm size category 1 job count from LODES WAC.","CFS02":"Firm size category 2 job count from LODES WAC.","CFS03":"Firm size category 3 job count from LODES WAC.","CFS04":"Firm size category 4 job count from LODES WAC.","CFS05":"Firm size category 5 job count from LODES WAC."},"source_context":"Census LEHD LODES8 Workplace Area Characteristics (WAC). Job counts are workplace-based, not residence-based.","manual_guidance":{"notes":{"runtime_shape":"Research/runtime uses USA_tract.parquet, a tract-level annual rollup built from the block-level state-year parquets. This keeps the source map-usable while preserving the raw yearly block files on disk.","oz_use_case":"For Opportunity Zone analysis, the most important sector columns are CNS05 (manufacturing), CNS06 (wholesale trade), and CNS08 (transportation and warehousing).","detail_archive":"The folder also retains 22 yearly block-level parquets (USA_2002.parquet through USA_2023.parquet) for deeper offline analysis."},"query_contract":{"location_field":"loc_id","time_required":false,"time_field":"timestamp","location_filter_mode":"hierarchical_loc_id","default_limit":500,"max_limit":200000,"notes":["Use tract-level loc_id filters by default. County and state requests work by hierarchical prefix aggregation from tract rows.","Prefer C000 for total workplace jobs and CNS05/CNS06/CNS08 for light-industrial screening.","Useful synonyms include factory jobs, warehouse jobs, distribution employment, industrial employment, and workplace jobs.","This is workplace geography, not residence geography."]}}},"permission":"paid","provenance_fingerprint":"8ad5a201285fa22cc111c33b062f6e85d6b602adf334f5ff39d44b7f0aea93a9","license_conditions":{"permission":"paid","redistribution":"allowed","share_alike":"no"},"attribution_text":"Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain).","attribution_lines":["Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain)."],"citation":{"style":"daedalmap-1","entries":[{"text":"U.S. Census Bureau, LEHD Program. LEHD LODES Workplace Area Characteristics. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/.","role":"primary","parts":{"role":"primary","agency":"U.S. Census Bureau, LEHD Program","title":"LEHD LODES Workplace Area Characteristics","vintage":"","url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)"}}],"text":"U.S. Census Bureau, LEHD Program. LEHD LODES Workplace Area Characteristics. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/."},"download":{"available":true,"channel":"stable","version":"1.1.0","published_at":"2026-10-10T01:45:29.603137Z","current_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/usa_lodes/usa_lodes-lite/stable/current.json","version_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/usa_lodes/usa_lodes-lite/stable/1.1.0/version.json","artifact_url":"https://downloads.daedalmap.com/downloadable/packs/usa_lodes/usa_lodes-lite/stable/1.1.0/pack.zip","filename":"pack.zip","sha256":"ad24e35ad72e1de68c88ca871fa054ec85cebeb049230915c97b1092e8cb4ad6","size_bytes":86523216,"file_count":6,"validation_status":"passed"},"last_updated":"2026-05-09"}],"release_state":"published","access_scope":null,"wip_note":"","catalog_surfaces":["api","explore","mcp","research"],"pack_maintainer_name":"","pack_maintainer_url":"","scopes":["USA"],"categories":["economic"],"geographic_levels":["3"],"row_count_total":1815420,"file_size_mb_total":142.71,"browser_storage_estimate_mb_total":142.71,"working_set_estimate_mb_total":1136.52,"browser_artifact_available":true,"browser_artifact_transfer_mb_total":142.71,"browser_artifact_stored_mb_total":142.71,"browser_artifact_expanded_mb_total":1136.52,"size":{"contract_version":1,"transfer_mb":142.71,"browser_storage_estimate_mb":142.71,"working_set_estimate_mb":1136.52},"load_policy":{"can_load_all_sources":true,"size_bucket":"medium","reason":"Safe to load the full pack at once.","max_sources":8,"max_file_size_mb":200,"max_row_count":2000000},"download":{"available":true,"channel":"stable","version":"1.1.0","published_at":"2026-10-10T01:45:29.603137Z","current_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/usa_lodes/usa_lodes-lite/stable/current.json","version_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/usa_lodes/usa_lodes-lite/stable/1.1.0/version.json","artifact_url":"https://downloads.daedalmap.com/downloadable/packs/usa_lodes/usa_lodes-lite/stable/1.1.0/pack.zip","filename":"pack.zip","sha256":"ad24e35ad72e1de68c88ca871fa054ec85cebeb049230915c97b1092e8cb4ad6","size_bytes":86523216,"file_count":6,"validation_status":"passed"},"default_load":{"kind":"confirmed_order","summary":"Showing tract-level workplace employment from LODES. Ask to change the year, industry, worker age, earnings group, or state.","items":[{"source_id":"lodes","pack_id":"usa_lodes","metric":"C000","geo_level":"admin_3"}]},"default_question":"Show manufacturing employment by census tract in the United States.","default_response":"Showing tract-level workplace employment from LODES. Ask to change the year, industry, worker age, earnings group, or state.","example_questions":["Show manufacturing jobs by tract in Georgia.","Where are transportation and warehousing jobs concentrated around Chicago?"],"permission":"paid","license_policy":{"schema_version":"1.2.0","license":"Public Domain (U.S. Government)","permission":"paid","resolution_status":"resolved","policy_source":"build/catalog/license_permission_crosswalk.csv","reason":"U.S. government public-domain posture supports paid hosted use.","redistribution":"allowed","share_alike":"no","attribution_required":false,"attribution_template":"Source: {agency} (U.S. Government work, public domain).","source_url":"https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html","reviewed_on":"2026-09-10","notes":"Legacy spelling canonicalized to the source-aware U.S. federal label.","reuse_obligations":{"copyleft_scope":null,"required_public_license":null,"source_offer_required":null}},"provenance_fingerprint":"aa12d26251293ed34c94ac2f95430ccc4241f4eb06a099e688e43b92e1784cc5","license_conditions":{"permission":"paid","redistribution":"allowed","share_alike":"no"},"attribution_text":"Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain).","attribution_lines":["Source: U.S. Census Bureau, LEHD Program (U.S. Government work, public domain)."],"citation":{"style":"daedalmap-1","entries":[{"text":"U.S. Census Bureau, LEHD Program. USA LODES Workplace Employment. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/.","role":"primary","parts":{"role":"primary","agency":"U.S. Census Bureau, LEHD Program","title":"USA LODES Workplace Employment","vintage":"","url":"https://lehd.ces.census.gov/data/lodes/LODES8/","license":"Public Domain (U.S. Government)"}}],"text":"U.S. Census Bureau, LEHD Program. USA LODES Workplace Employment. Public Domain (U.S. Government). https://lehd.ces.census.gov/data/lodes/LODES8/."},"last_updated":"2026-05-09"}