{ "anchors": [], "capability": "ai_infrastructure.construction", "codebooks": { "basis": { "codes": { "not_seasonally_adjusted": { "label": "Not seasonally adjusted (monthly level)" }, "seasonally_adjusted": { "label": "Seasonally adjusted (annual rate)" } }, "coverage": "both bases for every served month", "note": "seasonally_adjusted is a seasonally-adjusted ANNUAL RATE (do not sum across months); not_seasonally_adjusted is the NOT-adjusted MONTHLY LEVEL. Never mix the two bases in one total.", "semantics": "census_c30_seasonal_adjustment_basis", "source": "U.S. Census Bureau C30 \u2014 the 'Private SA' and 'Private NSA' sheets." }, "category": { "codes": { "computer_electronic_electrical": { "census_parent": "Manufacturing", "label": "Computer/ electronic/ electrical" }, "data_center": { "census_parent": "Office", "label": "Data center" } }, "coverage": "the two AI-infrastructure-relevant lines of the C30 categories", "note": "Two DISTINCT series, never conflated: data_center is data-center buildings (Census's named subcategory under Office); computer_electronic_electrical is the semiconductor/computer-electronics manufacturing line (under Manufacturing) \u2014 the CHIPS-Act fab build-out.", "semantics": "census_c30_construction_category", "source": "U.S. Census Bureau C30 column headers (verbatim)." } }, "data_point": { "does_not_answer": [ "total data-center INVESTMENT (servers, chips, cooling, equipment) \u2014 this is construction put-in-place only; an investment total would require imputation Census does not publish", "data-center MW capacity, count, square footage, or location (this is $ of construction, not physical capacity)", "public or government data-center construction (the series served is PRIVATE construction only)", "which company, operator, or project is building (Census C30 carries no operator/project breakdown)", "summing the seasonally-adjusted series across months (it is an annual rate, not a monthly level) or summing across bases (refused with a note, never silently computed)", "state, county, plant, or lat/lon attribution (structural \u2014 this is a national aggregate with no geographic anchor)", "construction outside the two AI-infrastructure-relevant categories (the source has ~70 categories; only data center + the fab line are served)" ], "grain": "category_monthly", "id": "ai_infrastructure.construction", "note": "This is the value of PRIVATE construction put in place ($ millions) for data centers and the computer/electronic/electrical (semiconductor-fab) line, served verbatim per (category, basis, month). It is construction SPENDING only \u2014 not total data-center investment (servers/chips/cooling), which Census does not publish. construction_spending_musd is NOT additive across bases, and the seasonally-adjusted annual-rate series is not summable across months.", "product_spec": "blocks/ai_infrastructure_construction/card.md", "represented_fact": "Census C30 / Value of Construction Put in Place \u2014 the monthly value of PRIVATE construction put in place ($ millions) for data centers (a named subcategory under Office) and computer/electronic/ electrical manufacturing (the semiconductor-fab line), served both seasonally-adjusted (an annual rate) and not-seasonally-adjusted (a monthly level) exactly as Census publishes. Construction spending only \u2014 never total investment (servers/chips), which Census does not publish.", "source_basis": [ "construction.census.c30_vip" ], "source_decisions": [ "docs/sources/construction/census_c30/build-plan.md" ] }, "input": { "controls": [ "include_records", "include_evidence", "limit", "order_by", "top_n", "order", "rollup_other" ], "date_range_params": [ "data_month_from", "data_month_to" ], "date_ranges": [ "data_month" ], "field_metadata": {}, "filters": [ "as_of", "category", "basis", "data_month", "data_month_from", "data_month_to", "year", "revision_status" ], "group_by": [ "category", "basis", "data_month", "year", "revision_status" ], "ranking": { "no_ranking": "Omit order_by and top_n to return all groups in group-key order.", "order": { "default": "desc", "valid_values": [ "desc", "asc" ] }, "order_by": { "accepts": "one of output.metrics", "note": "Ranks the groups by a metric (a measure). Not a group_by dimension \u2014 rows already come back grouped by each group_by field.", "requires": [ "group_by" ], "valid_values": [ "construction_spending_musd", "source_record_count" ] }, "top_n": { "note": "Keeps the top N groups by order_by; the rest fold into one (other) remainder (additive metrics sum into it, non-additive ones are nulled) so the result still reconciles to summary.totals.", "requires": [ "group_by", "order_by" ], "type": "positive integer" } } }, "output": { "aggregate_citation_fields": [ "source_id", "publisher", "source_url", "source_file", "raw_file_sha256", "as_of", "source_rows_count", "source_rows_sample", "verify", "lineage_filter" ], "citation_fields": [ "source_id", "source_url", "source_file", "sheet", "source_row", "source_col", "raw_file_sha256", "as_of" ], "detail_fields": [ "source_id", "sheet_name", "source_record_key", "report_period", "category", "basis", "data_month", "year", "revision_status", "source_date_label", "construction_spending_musd", "source_row_number", "source_col_number", "as_of", "raw_file_sha256", "citation" ], "metric_groups": { "construction_spending_musd": [ "construction_spending_musd" ], "records": [ "source_record_count" ] }, "metric_metadata": { "construction_spending_musd": { "additive_across_groups": false, "aggregation": "sum", "authoritative_total_path": "summary.totals.construction_spending_musd", "category": "construction_spending_musd", "definition": "The value of PRIVATE construction put in place ($ millions) for the category in scope (data centers, or the computer/electronic/electrical manufacturing line), exactly as the U.S. Census Bureau publishes it in C30 / Value of Construction Put in Place.", "description": "Census's OWN published value of private construction put in place per (category, basis, month), served verbatim \u2014 construction SPENDING only, never total investment (servers/chips), which Census does not publish. NOT additive across bases (the seasonally-adjusted series is an ANNUAL RATE; the not-seasonally-adjusted series is a MONTHLY LEVEL \u2014 mixing them is meaningless) and the SA annual-rate series is not summable across months. A result mixing bases, or summing the SA series across months, carries a construction_aggregation scope note and ranking remainders omit the metric \u2014 filter to one basis and group_by data_month for a series over time.", "display_name": "Construction spending", "display_precision": "Values are in millions of USD, rounded to 6 decimal places in JSON to remove binary floating-point noise.", "grain": "category basis month", "null_handling": "A (category, basis, month) cell Census did not publish is absent (the data-center series begins 2014-01), never zero; an empty-query summary returns zero.", "rollup_behavior": "non_additive_measure", "row_metric_path": "rows[].metrics.construction_spending_musd", "source_fields": [ "construction_spending_musd" ], "unit": "million USD" }, "source_record_count": { "additive_across_groups": true, "aggregation": "count source records", "authoritative_total_path": "summary.totals.source_record_count", "category": "records", "definition": "Count of normalized source records (category \u00d7 basis \u00d7 month cells) contributing to the current result scope.", "description": "Number of normalized Census C30 source cells (category \u00d7 basis \u00d7 month) contributing to the value.", "display_name": "Source record count", "display_precision": "Integer.", "grain": "source row", "null_handling": "Always an integer count.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.source_record_count", "source_fields": [ "source_record_key" ], "unit": "count" } }, "metrics": [ "construction_spending_musd", "source_record_count" ], "summary_fields": [ "group_count", "totals" ] }, "primitive": "query_ai_infrastructure_construction_v1", "status": "available" }