{ "anchors": [ { "about": "2-letter state/jurisdiction code (PD-003).", "format": "usps_state", "kind": "geography", "name": "state", "scope": "universal" }, { "about": "5-digit Census county FIPS, zero-padded string.", "format": "fips5", "kind": "geography", "name": "county_fips", "scope": "universal" } ], "capability": "power.interconnection_queue_caiso", "codebooks": { "application_status": { "codes": { "ACTIVE": { "label": "Active \u2014 a live request still in the queue (requested, not built)" }, "COMPLETED": { "label": "Completed \u2014 the project is built and in service (actual_online_date set)" }, "WITHDRAWN": { "label": "Withdrawn \u2014 the request left the queue (the report is withdrawn-dominated)" } }, "coverage": "the distinct application_status values observed in the served CAISO snapshot", "note": "ALWAYS scope by `application_status` \u2014 the report is dominated by WITHDRAWN requests. `ACTIVE` is the live pipeline of REQUESTED (not built) capacity; `COMPLETED` is built and in service (carries an actual_online_date); `WITHDRAWN` left the queue. A queue-MW total is requested capacity, never built \u2014 for built/operating capacity use query_power_capacity_v1.", "semantics": "as_reported_lifecycle_status", "source": "CAISO Public Queue Report \u2014 the lifecycle tab a project sits on (Grid GenerationQueue / Completed / Withdrawn)." }, "deliverability_status": { "codes": { "Energy Only": { "label": "Energy Only (no capacity deliverability)" }, "Full Capacity": { "label": "Full Capacity Deliverability Status" }, "Partial Capacity": { "label": "Partial Capacity Deliverability Status" } }, "coverage": "the distinct deliverability values observed in the served CAISO snapshot", "note": "CAISO's deliverability is three-valued and first-class: `Full Capacity` and `Partial Capacity` count toward resource adequacy (with a TPD allocation), `Energy Only` does not. Filter by CAISO's EXACT value. This is a CAISO concept MISO/PJM do not carry.", "semantics": "as_reported_deliverability", "source": "CAISO Public Queue Report `Full Capacity, Partial or Energy Only (FC/P/EO)` \u2014 the deliverability the project holds." }, "fuel_1": { "codes": { "Battery": { "label": "Battery storage" }, "Natural Gas": { "label": "Natural gas" }, "Solar": { "label": "Solar photovoltaic" }, "Water": { "label": "Hydro / pumped storage" }, "Wind Turbine": { "label": "Wind" } }, "coverage": "the distinct primary-fuel values observed in the served CAISO snapshot", "note": "Filter `fuel_1` by CAISO's EXACT value \u2014 e.g. `Battery`, `Solar`, `Wind Turbine`, `Natural Gas`. Hybrids carry a second/third Type/Fuel/MW triplet (fuel_2 / fuel_3) and are flagged with `is_hybrid`; filter on fuel_1 for the primary fuel. Values are as-reported, so a request with no fuel is null.", "semantics": "as_reported_fuel_taxonomy", "source": "CAISO Public Queue Report `Fuel-1` \u2014 the primary fuel of the (possibly hybrid) project." } }, "data_point": { "does_not_answer": [ "built/operating/nameplate capacity as a queue total (net_mw_to_grid is REQUESTED interconnection, not built; for operating capacity use power.capacity / EIA-860M; a Completed project's net_mw_to_grid with an actual_online_date is the per-project built reading)", "a sum of net MW treated as planned or operating capacity (most queued MW withdraws \u2014 totals are scoped by application_status, never read as built)", "a cross-ISO or national queue total (methodologies, inclusion, deliverability, and withdrawal rates differ per ISO \u2014 never summed or deduped across ISOs; for the MISO queue use query_power_interconnection_queue_v1, for PJM query_power_interconnection_queue_pjm_v1)", "the separate CAISO \"Cluster N Interconnection Requests\" intake file (a distinct CAISO publication with a different schema \u2014 this block serves the Public Queue Report, Cluster 14 and prior plus serial/legacy)", "which projects are data-center- or load-driven (CAISO reports no load/data-center type; that inference is the analyst's, never tagged here)", "the probability that a queued project will actually be built or reach commercial operation", "generation MWh, demand, prices, retail sales, or transmission flows", "lat/lon or plant-level attribution (CAISO supplies none; only state, as-reported county, and derived county_fips)", "queues for other ISOs/RTOs (MISO, PJM, NYISO, ISO-NE, ERCOT, SPP) \u2014 each is a separate block under the same gate" ], "grain": "project_snapshot", "id": "power.interconnection_queue_caiso", "note": "This is CAISO's Public Queue Report \u2014 the California ISO generator interconnection queue. `net_mw_to_grid` is REQUESTED interconnection capacity (a waiting line), NOT built / installed / operating capacity. The report is withdrawn-dominated, so always scope by `application_status`: `ACTIVE` is the live request pipeline, `COMPLETED` is built and in service (and carries an actual_online_date), `WITHDRAWN` left the queue. CAISO publishes no separate built-MW column \u2014 we serve its own `net_mw_to_grid` faithfully and never invent one. For operating capacity use query_power_capacity_v1. CAISO only \u2014 never summed or compared across ISOs; for the MISO queue use query_power_interconnection_queue_v1, for PJM query_power_interconnection_queue_pjm_v1.", "product_spec": "blocks/power_interconnection_queue_caiso/card.md", "represented_fact": "The CAISO generator interconnection queue \u2014 California ISO's public Public Queue Report, the waiting line of every project that has REQUESTED to connect to the CAISO grid, served as-reported, project by project across the three lifecycle tabs CAISO publishes (Active / Completed / Withdrawn). CAISO's full published structure is carried faithfully, in CAISO's own words: the net megawatts to grid (`net_mw_to_grid`) and the per-component Type/Fuel/MW triplets for hybrids, the as-reported `application_status`, the cluster `study_process` (C01..C14, the serial/legacy tracks), the three-valued deliverability status (Full Capacity / Partial Capacity / Energy Only) with TPD allocation and off-peak deliverability, the location (state, county, utility/PTO, point of interconnection), the per-phase study statuses, and the lifecycle dates. This is a REQUEST, not built capacity: historically the large majority of queued MW withdraws before it is built (the report is withdrawn-dominated). CAISO carries the requested-vs-built distinction in its OWN structure \u2014 every project's `application_status` and tab, with Completed projects carrying an `actual_online_date` (the realized in-service date) \u2014 so `net_mw_to_grid` is served under CAISO's own name and never relabeled \"requested\" or summed as operating capacity. This is a forward-looking slice (capacity/generation/demand are backward-looking actuals). CAISO carries no county_fips and no lat/lon; county_fips is derived by name where it resolves and left null otherwise (incl. the out-of-state NV/AZ and Mexico `MX` rows). It is NOT a data-center product \u2014 CAISO reports no load/data-center type and we never infer one.", "source_basis": [ "energy.caiso.queue" ], "source_decisions": [ "docs/verticals/power/interconnection-queues.md" ] }, "input": { "controls": [ "include_records", "include_evidence", "limit", "order_by", "top_n", "order", "rollup_other" ], "date_range_params": [ "queue_date_from", "queue_date_to" ], "date_ranges": [ "queue_date" ], "field_metadata": {}, "filters": [ "as_of", "state", "county_fips", "application_status", "study_process", "deliverability_status", "offpeak_deliverability", "tpd_allocation_group", "fuel_1", "type_1", "utility", "pto_study_region", "suspension_status", "ia_status", "queue_date" ], "group_by": [ "state", "county_fips", "application_status", "study_process", "deliverability_status", "offpeak_deliverability", "tpd_allocation_group", "fuel_1", "type_1", "utility", "pto_study_region", "suspension_status", "ia_status", "is_hybrid" ], "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": [ "net_mw_to_grid", "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", "raw_file_sha256", "as_of" ], "detail_fields": [ "source_id", "sheet_name", "iso", "queue_position", "source_record_key", "project_name", "application_status", "study_process", "state", "state_raw", "county", "county_fips", "county_fips_source", "county_fips_unresolved", "type_1", "type_2", "type_3", "fuel_1", "fuel_2", "fuel_3", "is_hybrid", "net_mw_to_grid", "mw_1", "mw_2", "mw_3", "deliverability_status", "tpd_allocation_percentage", "offpeak_deliverability", "tpd_allocation_group", "utility", "pto_study_region", "station_or_line", "suspension_status", "feasibility_status", "system_impact_status", "facilities_status", "optional_study_status", "ia_status", "withdrawal_reason", "ir_receive_date", "queue_date", "withdrawn_date", "proposed_online_date", "current_online_date", "actual_online_date", "report_period", "source_row_number", "as_of", "raw_file_sha256", "citation" ], "metric_groups": { "net_mw": [ "net_mw_to_grid" ], "records": [ "source_record_count" ] }, "metric_metadata": { "net_mw_to_grid": { "additive_across_groups": true, "aggregation": "sum", "authoritative_total_path": "summary.totals.net_mw_to_grid", "category": "net_mw", "definition": "The project's Net MWs to Grid, as CAISO reports it \u2014 the net export capacity of the request.", "description": "The project's Net MWs to Grid \u2014 CAISO's own headline net-export figure, served under CAISO's name. This is REQUESTED interconnection capacity (a project in the queue), NOT built, installed, or operating capacity: historically the large majority of queued MW withdraws before it is built, so the report is withdrawn-dominated. It is additive across distinct projects (each is its own request) but must be read as REQUESTED \u2014 scope it with `application_status`. CAISO publishes no separate built-MW column; a COMPLETED project (carrying an `actual_online_date`) is the built reading. For operating capacity use query_power_capacity_v1.", "display_name": "Net MW to grid (requested)", "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.", "grain": "queue project", "null_handling": "A project with no reported value contributes null (ignored by the sum); an empty-query summary returns zero.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.net_mw_to_grid", "source_fields": [ "Net MWs to Grid" ], "unit": "MW" }, "source_record_count": { "additive_across_groups": true, "aggregation": "count source records", "authoritative_total_path": "summary.totals.source_record_count", "category": "records", "definition": "Count of CAISO queue projects in the current result scope (one atom = one project, across the Active/Completed/Withdrawn tabs).", "description": "Number of queued projects contributing to the value \u2014 scope with application_status to separate active from completed from withdrawn.", "display_name": "Queued project count", "display_precision": "Integer.", "grain": "queue project", "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": [ "net_mw_to_grid", "source_record_count" ], "summary_fields": [ "group_count", "totals" ] }, "primitive": "query_power_interconnection_queue_caiso_v1", "status": "available" }