{
  "anchors": [],
  "capability": "power.plant_costs",
  "codebooks": {},
  "data_point": {
    "does_not_answer": [
      "complete US or ERCOT fleet coverage; ERCOT-only merchant entities largely do not file Form 1",
      "plant-name-to-EIA-plant-id matching or any normalized entity identity",
      "heat rate, efficiency, dollars per MWh, inflation-adjusted dollars, allocations, or probabilities",
      "hydro, pumped-storage, migrated historical XBRL, or Visual FoxPro-era filings in v0",
      "plant state; the large-steam schedule does not file a plant-state field"
    ],
    "grain": "respondent_year_plant_fact",
    "id": "power.plant_costs",
    "product_spec": "blocks/power_plant_costs/card.md",
    "represented_fact": "Accepted native-XBRL FERC Form 1 filings report as-filed large steam-electric plant statistics by respondent, year, and raw plant name: installed capacity, net generation, plant-cost balance facts, and separate production-expense line items. Dollar values are nominal and are never inflation-adjusted, allocated, or summed into a derived O&M total.",
    "source_basis": [
      "energy.ferc.form1_plant_costs"
    ],
    "source_decisions": [
      "docs/sources/energy/ferc/form1_plant_costs/source-decision.md"
    ]
  },
  "input": {
    "controls": [
      "include_records",
      "include_evidence",
      "limit",
      "order_by",
      "top_n",
      "order"
    ],
    "date_range_params": [],
    "date_ranges": [],
    "filters": [
      "as_of",
      "report_year",
      "respondent_id",
      "respondent_name",
      "plant_name",
      "plant_name_contains",
      "measure",
      "measure_category",
      "unit",
      "ercot_relevance"
    ],
    "group_by": [
      "report_year",
      "respondent_id",
      "respondent_name",
      "plant_name",
      "measure",
      "measure_category",
      "unit"
    ],
    "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": [
          "value",
          "source_record_count",
          "distinct_respondent_count",
          "distinct_plant_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",
      "source_member",
      "raw_file_sha256",
      "as_of",
      "source_rows_count",
      "source_rows_sample",
      "verify",
      "lineage_filter"
    ],
    "citation_fields": [
      "source_id",
      "source_url",
      "source_file",
      "source_member",
      "sheet",
      "source_row",
      "source_col",
      "xbrl_fact_id",
      "xbrl_context_ref",
      "raw_file_sha256",
      "as_of"
    ],
    "coverage": {
      "absence_semantics": "not_present_in_served_form1_filings",
      "ercot_merchant_fleet": "partial",
      "filing_system": "accepted_native_xbrl",
      "report_year_start": 2021,
      "schedules": [
        "large_steam_electric_including_nuclear"
      ],
      "state_filter": "unavailable_in_large_steam_schedule"
    },
    "detail_fields": [
      "source_id",
      "schedule",
      "sheet_name",
      "source_member",
      "source_record_key",
      "source_row_number",
      "report_year",
      "respondent_id",
      "respondent_name",
      "states_served_raw",
      "ercot_relevance",
      "plant_name",
      "measure",
      "measure_category",
      "xbrl_concept",
      "xbrl_fact_id",
      "xbrl_context_ref",
      "xbrl_unit_ref",
      "xbrl_unit_measure",
      "decimals_as_filed",
      "value_raw",
      "value",
      "unit",
      "nominal_dollars",
      "as_of",
      "raw_file_sha256",
      "citation"
    ],
    "metric_groups": {
      "as_filed_value": [
        "value"
      ],
      "entities": [
        "distinct_respondent_count",
        "distinct_plant_count"
      ],
      "records": [
        "source_record_count"
      ]
    },
    "metric_metadata": {
      "distinct_plant_count": {
        "additive_across_groups": false,
        "aggregation": "count_distinct",
        "authoritative_total_path": "summary.totals.distinct_plant_count",
        "category": "entities",
        "definition": "Count of distinct respondent CID plus raw plant-name pairs in scope.",
        "display_name": "Distinct raw plant count",
        "display_precision": "Integer.",
        "grain": "result scope",
        "null_handling": "Always an integer count.",
        "rollup_behavior": "distinct_entity_count_not_additive",
        "row_metric_path": "rows[].metrics.distinct_plant_count",
        "source_fields": [
          "respondent_id",
          "plant_name"
        ],
        "unit": "count"
      },
      "distinct_respondent_count": {
        "additive_across_groups": false,
        "aggregation": "count_distinct",
        "authoritative_total_path": "summary.totals.distinct_respondent_count",
        "category": "entities",
        "definition": "Count of distinct FERC respondent CIDs with facts in scope.",
        "display_name": "Distinct respondent count",
        "display_precision": "Integer.",
        "grain": "result scope",
        "null_handling": "Always an integer count.",
        "rollup_behavior": "distinct_entity_count_not_additive",
        "row_metric_path": "rows[].metrics.distinct_respondent_count",
        "source_fields": [
          "respondent_id"
        ],
        "unit": "count"
      },
      "source_record_count": {
        "additive_across_groups": true,
        "aggregation": "count source records",
        "authoritative_total_path": "summary.totals.source_record_count",
        "category": "records",
        "definition": "Count of separately cited XBRL facts in scope.",
        "display_name": "Source record count",
        "display_precision": "Integer.",
        "grain": "result scope",
        "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"
      },
      "value": {
        "additive_across_groups": false,
        "aggregation": "single fact only",
        "authoritative_total_path": "summary.totals.value",
        "category": "as_filed_value",
        "definition": "One as-filed Form 1 XBRL fact; inspect unit and measure before use.",
        "display_name": "As-filed value",
        "display_precision": "The numeric fact is returned as filed; value_raw and decimals_as_filed are retained.",
        "grain": "respondent \u00d7 report year \u00d7 raw plant name \u00d7 XBRL concept",
        "null_handling": "Only numeric as-filed facts are atoms; source absence remains absence.",
        "rollup_behavior": "non_additive_measure",
        "row_metric_path": "rows[].metrics.value",
        "source_fields": [
          "value"
        ],
        "unit": "source physical unit"
      }
    },
    "metrics": [
      "value",
      "source_record_count",
      "distinct_respondent_count",
      "distinct_plant_count"
    ],
    "summary_fields": [
      "group_count",
      "totals"
    ]
  },
  "primitive": "query_power_plant_costs_v1",
  "status": "available"
}