{
  "anchors": [],
  "capability": "power.capacity_accreditation_pjm",
  "codebooks": {
    "class_family": {
      "codes": {
        "hydro": {
          "label": "hydro"
        },
        "nuclear": {
          "label": "nuclear"
        },
        "other": {
          "label": "other"
        },
        "solar_fixed": {
          "label": "solar_fixed"
        },
        "solar_tracking": {
          "label": "solar_tracking"
        },
        "storage_10h": {
          "label": "storage_10h"
        },
        "storage_4h": {
          "label": "storage_4h"
        },
        "storage_6h": {
          "label": "storage_6h"
        },
        "storage_8h": {
          "label": "storage_8h"
        },
        "thermal_CC": {
          "label": "thermal_CC"
        },
        "thermal_CT": {
          "label": "thermal_CT"
        },
        "thermal_steam": {
          "label": "thermal_steam"
        },
        "wind_offshore": {
          "label": "wind_offshore"
        },
        "wind_onshore": {
          "label": "wind_onshore"
        }
      },
      "coverage": "all parsed PJM resource classes",
      "source": "block.yml mapping from verbatim PJM resource classes"
    },
    "document_kind": {
      "codes": {
        "final_auction": {
          "label": "Final Base Residual Auction class ratings"
        },
        "incremental_auction": {
          "label": "Incremental Auction class ratings"
        },
        "preliminary_outlook": {
          "label": "Preliminary multi-year outlook guidance"
        }
      },
      "coverage": "all supported linked rating documents",
      "source": "PJM document identity"
    }
  },
  "data_point": {
    "does_not_answer": [
      "physical capacity factor, energy output, availability, or expected generation",
      "a blended, preferred, effective, forecast, or corrected ELCC rating across documents",
      "a resource-specific ELCC value where PJM publishes no class rating",
      "capacity-market clearing prices or cleared UCAP (use power.capacity_market_pjm)",
      "accreditation outside PJM"
    ],
    "grain": "auction_document_delivery_year_resource_class",
    "id": "power.capacity_accreditation_pjm",
    "note": "Marginal ELCC is an auction-specific accreditation fraction, not a physical capacity factor. Preliminary guidance and final auction values remain distinct document_kind values.",
    "product_spec": "blocks/power_capacity_accreditation_pjm/card.md",
    "represented_fact": "PJM-published marginal Effective Load Carrying Capability (ELCC) class ratings, as a fraction of nameplate capacity, for each resource class and delivery year in each linked final Base Residual Auction document, Incremental Auction document, or preliminary multi-year outlook. Document identity is a dimension: preliminary and final ratings for the same delivery year are separate cited atoms and are never merged, preferred, reconciled, or corrected by this block.",
    "source_basis": [
      "energy.pjm.elcc"
    ],
    "source_decisions": []
  },
  "input": {
    "controls": [
      "include_records",
      "include_evidence",
      "limit",
      "order_by",
      "top_n",
      "order",
      "rollup_other"
    ],
    "date_range_params": [],
    "date_ranges": [],
    "field_metadata": {},
    "filters": [
      "as_of",
      "document_kind",
      "auction_label",
      "delivery_year",
      "resource_class",
      "class_family"
    ],
    "group_by": [
      "document_kind",
      "auction_label",
      "delivery_year",
      "resource_class",
      "class_family"
    ],
    "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": [
          "avg_elcc_rating",
          "min_elcc_rating",
          "max_elcc_rating",
          "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",
      "document_kind",
      "auction_label",
      "delivery_year",
      "resource_class",
      "class_family",
      "elcc_rating",
      "report_period",
      "source_record_key",
      "source_row_number",
      "as_of",
      "raw_file_sha256",
      "citation"
    ],
    "metric_groups": {
      "accreditation": [
        "avg_elcc_rating",
        "min_elcc_rating",
        "max_elcc_rating"
      ],
      "records": [
        "source_record_count"
      ]
    },
    "metric_metadata": {
      "avg_elcc_rating": {
        "additive_across_groups": false,
        "aggregation": "average",
        "authoritative_total_path": "summary.totals.avg_elcc_rating",
        "category": "accreditation",
        "definition": "Average marginal ELCC rating over the current result scope.",
        "description": "Average marginal ELCC rating; document and delivery-year identity remain explicit.",
        "display_name": "Average marginal ELCC rating",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x delivery year x resource class",
        "null_handling": "Null when no applicable published value exists; source-record counts are always integers.",
        "rollup_behavior": "non_additive_measure",
        "row_metric_path": "rows[].metrics.avg_elcc_rating",
        "source_fields": [
          "elcc_rating"
        ],
        "unit": "fraction of one"
      },
      "max_elcc_rating": {
        "additive_across_groups": false,
        "aggregation": "maximum",
        "authoritative_total_path": "summary.totals.max_elcc_rating",
        "category": "accreditation",
        "definition": "Maximum marginal ELCC rating over the current result scope.",
        "description": "Maximum marginal ELCC rating; document and delivery-year identity remain explicit.",
        "display_name": "Maximum marginal ELCC rating",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x delivery year x resource class",
        "null_handling": "Null when no applicable published value exists; source-record counts are always integers.",
        "rollup_behavior": "non_additive_measure",
        "row_metric_path": "rows[].metrics.max_elcc_rating",
        "source_fields": [
          "elcc_rating"
        ],
        "unit": "fraction of one"
      },
      "min_elcc_rating": {
        "additive_across_groups": false,
        "aggregation": "minimum",
        "authoritative_total_path": "summary.totals.min_elcc_rating",
        "category": "accreditation",
        "definition": "Minimum marginal ELCC rating over the current result scope.",
        "description": "Minimum marginal ELCC rating; document and delivery-year identity remain explicit.",
        "display_name": "Minimum marginal ELCC rating",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x delivery year x resource class",
        "null_handling": "Null when no applicable published value exists; source-record counts are always integers.",
        "rollup_behavior": "non_additive_measure",
        "row_metric_path": "rows[].metrics.min_elcc_rating",
        "source_fields": [
          "elcc_rating"
        ],
        "unit": "fraction of one"
      },
      "source_record_count": {
        "additive_across_groups": true,
        "aggregation": "count source records",
        "authoritative_total_path": "summary.totals.source_record_count",
        "category": "records",
        "definition": "ELCC class-rating atom count over the current result scope.",
        "description": "ELCC class-rating atom count; document and delivery-year identity remain explicit.",
        "display_name": "ELCC class-rating atom count",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x delivery year x resource class",
        "null_handling": "Null when no applicable published value exists; source-record counts are always integers.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.source_record_count",
        "source_fields": [
          "source_record_key"
        ],
        "unit": "count"
      }
    },
    "metrics": [
      "avg_elcc_rating",
      "min_elcc_rating",
      "max_elcc_rating",
      "source_record_count"
    ],
    "summary_fields": [
      "group_count",
      "totals"
    ]
  },
  "primitive": "query_power_capacity_accreditation_pjm_v1",
  "status": "available"
}