{
  "anchors": [],
  "capability": "power.capacity_accreditation_miso",
  "codebooks": {
    "class_family": {
      "codes": {
        "fleetwide": {
          "label": "fleetwide"
        },
        "hydro": {
          "label": "hydro"
        },
        "nuclear": {
          "label": "nuclear"
        },
        "other": {
          "label": "other"
        },
        "solar": {
          "label": "solar"
        },
        "storage_battery": {
          "label": "storage_battery"
        },
        "storage_pumped": {
          "label": "storage_pumped"
        },
        "thermal_CC": {
          "label": "thermal_CC"
        },
        "thermal_CT": {
          "label": "thermal_CT"
        },
        "thermal_ICE": {
          "label": "thermal_ICE"
        },
        "thermal_steam": {
          "label": "thermal_steam"
        },
        "wind": {
          "label": "wind"
        }
      },
      "coverage": "parsed MISO classes",
      "source": "block.yml mapping"
    },
    "document_kind": {
      "codes": {
        "dlol_indicative": {
          "label": "Indicative DLOL UCAP/ICAP"
        },
        "schedule53_class_average": {
          "label": "Schedule 53 class-average ISAC/ICAP"
        }
      },
      "coverage": "supported MISO accreditation PDFs",
      "source": "MISO document identity"
    }
  },
  "data_point": {
    "does_not_answer": [
      "planning years before 2025-2026 (MISO's older Schedule 53 documents use layouts this block does not read; they are archived, not served)",
      "resource-specific (unit-level) SAC, ISAC, GVTC, or interconnection-service values",
      "PRMR, LRR, or reserve-margin requirements (capacity_market block scope)",
      "ICAP or UCAP megawatt totals per class (ratios only in v1)",
      "a reconciled or \"current best\" accreditation across constructs or documents",
      "ELCC constructs from other ISOs, or any forecast beyond MISO's published documents"
    ],
    "grain": "document_planning_year_resource_class_season",
    "id": "power.capacity_accreditation_miso",
    "note": "Schedule 53 class averages and indicative DLOL ratios remain separate document kinds; suppressed classes are explicit suppression atoms, never zero ratios.",
    "product_spec": "blocks/power_capacity_accreditation_miso/card.md",
    "represented_fact": "MISO-published seasonal capacity accreditation ratios per resource class, as a fraction of installed capacity (ICAP), from two coexisting tariff constructs kept apart by document_kind: Schedule 53 class-average ISAC/ICAP ratios (the construct binding until Planning Year 2027-2028) and indicative Direct Loss of Load class-level UCAP/ICAP ratios published under Schedule 53A ahead of its 2028-2029 implementation. Storage classes served under multiple DLOL modeling variants are separate cited atoms carrying the stated variant, never blended. Classes MISO suppresses for data-integrity/confidentiality (<30 contributing units) yield a suppression atom, so absence is provably \"not published\", never \"not parsed\". Ratios from different documents or constructs are never merged, preferred, or reconciled by this block.",
    "source_basis": [
      "energy.miso.accreditation"
    ],
    "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",
      "planning_year",
      "resource_class",
      "class_family",
      "season",
      "storage_variant"
    ],
    "group_by": [
      "document_kind",
      "planning_year",
      "resource_class",
      "class_family",
      "season",
      "storage_variant"
    ],
    "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_accreditation_ratio",
          "min_accreditation_ratio",
          "max_accreditation_ratio",
          "count_of_units",
          "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",
      "planning_year",
      "resource_class",
      "class_family",
      "season",
      "storage_variant",
      "atom_type",
      "accreditation_ratio",
      "count_of_units",
      "suppression_reason",
      "report_period",
      "source_record_key",
      "source_row_number",
      "as_of",
      "raw_file_sha256",
      "citation"
    ],
    "metric_groups": {
      "accreditation": [
        "avg_accreditation_ratio",
        "min_accreditation_ratio",
        "max_accreditation_ratio"
      ],
      "records": [
        "source_record_count"
      ],
      "units": [
        "count_of_units"
      ]
    },
    "metric_metadata": {
      "avg_accreditation_ratio": {
        "additive_across_groups": false,
        "aggregation": "average",
        "authoritative_total_path": "summary.totals.avg_accreditation_ratio",
        "category": "accreditation",
        "definition": "Average MISO accreditation ratio over the current result scope.",
        "description": "Average MISO accreditation ratio; document and delivery-year identity remain explicit.",
        "display_name": "Average MISO accreditation ratio",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x planning year x resource class x season",
        "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_accreditation_ratio",
        "source_fields": [
          "accreditation_ratio"
        ],
        "unit": "fraction of one"
      },
      "count_of_units": {
        "additive_across_groups": false,
        "aggregation": "maximum",
        "authoritative_total_path": "summary.totals.count_of_units",
        "category": "units",
        "definition": "Published MISO contributing-unit count over the current result scope.",
        "description": "Published MISO contributing-unit count; document and delivery-year identity remain explicit.",
        "display_name": "Published MISO contributing-unit count",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x planning year x resource class x season",
        "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.count_of_units",
        "source_fields": [
          "count_of_units"
        ],
        "unit": "count"
      },
      "max_accreditation_ratio": {
        "additive_across_groups": false,
        "aggregation": "maximum",
        "authoritative_total_path": "summary.totals.max_accreditation_ratio",
        "category": "accreditation",
        "definition": "Maximum MISO accreditation ratio over the current result scope.",
        "description": "Maximum MISO accreditation ratio; document and delivery-year identity remain explicit.",
        "display_name": "Maximum MISO accreditation ratio",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x planning year x resource class x season",
        "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_accreditation_ratio",
        "source_fields": [
          "accreditation_ratio"
        ],
        "unit": "fraction of one"
      },
      "min_accreditation_ratio": {
        "additive_across_groups": false,
        "aggregation": "minimum",
        "authoritative_total_path": "summary.totals.min_accreditation_ratio",
        "category": "accreditation",
        "definition": "Minimum MISO accreditation ratio over the current result scope.",
        "description": "Minimum MISO accreditation ratio; document and delivery-year identity remain explicit.",
        "display_name": "Minimum MISO accreditation ratio",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x planning year x resource class x season",
        "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_accreditation_ratio",
        "source_fields": [
          "accreditation_ratio"
        ],
        "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": "Accreditation atom count over the current result scope.",
        "description": "Accreditation atom count; document and delivery-year identity remain explicit.",
        "display_name": "Accreditation atom count",
        "display_precision": "Numeric source precision is preserved; JSON removes binary floating-point noise.",
        "grain": "document x planning year x resource class x season",
        "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_accreditation_ratio",
      "min_accreditation_ratio",
      "max_accreditation_ratio",
      "count_of_units",
      "source_record_count"
    ],
    "summary_fields": [
      "group_count",
      "totals"
    ]
  },
  "primitive": "query_power_capacity_accreditation_miso_v1",
  "status": "available"
}