Merge branch 'develop' of https://github.com/CMSgov/qpp-measures-data …

…into QPPA-9760

benchmarks/2025/benchmarks-exclusion-reasons-schema.yaml

@@ -0,0 +1,34 @@
+$id: https://github.com/CMSgov/qpp-measures-data/versions/0.0.1/benchmarks-exclusion-reasons-schema.yaml
+$schema: http://json-schema.org/schema#
+type: array
+items: { $ref: '#/definitions/benchmark-exclusion-reasons' }
+
+definitions:
+  benchmark:
+    type: object
+    properties:
+      measureId:
+        description: Corresponds to the measures data JSON ID.
+        type: string
+      submissionMethod:
+        description: The method used to submit. measureID and submissionMethod make up the unique identifier for a benchmark.
+        type: string
+      performanceYear:
+        description: When the performance data was submitted for scoring.
+        type: number
+      benchmarkYear:
+        description: When this benchmark was generated. For historical benchmarks, it will be different than performanceYear.
+          For performance year benchmarks, it will be the same.
+        type: number
+      reasonCodes:
+        description: Machine-readable codes for why the benchmark could not be created. Positions in array match reasonDescriptions.
+        type: array
+        items:
+          type: [string]
+        minItems: 1
+      reasonDescriptions:
+        description: Human-readable descriptions for why the benchmark could not be created. Positions in array match reasonCodes.
+        type: array
+        items:
+          type: [string]
+        minItems: 1

benchmarks/2025/benchmarks-schema.yaml

@@ -0,0 +1,81 @@
+$id: https://github.com/CMSgov/qpp-measures-data/versions/0.0.1/benchmarks-schema.yaml
+$schema: http://json-schema.org/schema#
+type: array
+items: { $ref: '#/definitions/benchmark' }
+
+definitions:
+  benchmark:
+    type: object
+    properties:
+      measureId:
+        description: measureId corresponds to a measure object's measureId.
+        type: string
+      performanceYear:
+        description: The performanceYear four digit integer corresponds to the time period of the performance data that was submitted for scoring.
+        type: number
+      isToppedOut:
+        description: isToppedOut is a boolean value that describes whether a benchmark's latter deciles repeat a value of 100 or, in the case of inverse measures, a value of 0.
+        type: boolean
+      isToppedOutByProgram:
+        description: isToppedOutByProgram is a boolean value that describes whether a benchmark isToppedOut is true for both the current year and the previous year. The effect is to cap the score at 7 points for that benchmark.
+        type: boolean
+      isHighPriority:
+        description: whether the measure is a high priority measure (Outcome, Appropriate Use, Patient Experience, Patient Safety, Efficiency Measures, Care Coordination)
+        type: boolean
+      isInverse:
+        type: boolean
+      metricType:
+        type: string
+      benchmarkYear:
+        description: The benchmarkYear four digit integer corresponds to the time period of the performance data that was used to generate this benchmark. The submitted performance data will be compared against the benchmarkYear's results.
+        type: number
+      deciles:
+        description: The deciles list object is a list of 9 numbers representing deciles of measurement values for a given measure, performance year and submission method. The 9 numbers represent the inclusive lower bounds of deciles 2 through 10. The upper and lower bounds of the measurement value range are implied to be 100 and 0 respectively for direct measures and 0 and 100 respectively for inverse measures. The range of any given decile begins at its lower bound and continues up to but does not include the subsequent decile's lower bound. If the subsequent decile's lower bound is equal to the current decile's lower bound, then that decile is undefined or, in other words, empty. In the case of NonProp and Cost measures there will be 10 deciles.
+        type: array
+        items:
+          type: [number]
+        minItems: 9
+        maxItems: 10
+      percentiles:
+        type: object
+        properties:
+          1:
+            type: number
+            description: The 1st percentile.
+          10:
+            type: number
+            description: The 10th percentile.
+          20:
+            type: number
+            description: The 20th percentile.
+          30:
+            type: number
+            description: The 30th percentile.
+          40:
+            type: number
+            description: The 40th percentile.
+          50:
+            type: number
+            description: The 50th percentile.
+          60:
+            type: number
+            description: The 60th percentile.
+          70:
+            type: number
+            description: The 70th percentile.
+          80:
+            type: number
+            description: The 80th percentile.
+          90:
+            type: number
+            description: The 90th percentile.
+          99:
+            type: number
+            description: The 99th percentile.
+      submissionMethod:
+        description: The method for submitting the measure performance data to which this benchmark applies.
+        enum: [claims, registry, cmsWebInterface, administrativeClaims, electronicHealthRecord, certifiedSurveyVendor]
+      averagePerformanceRate:
+        description:  The Average Performance Rate for the Measure and CollectionType.
+        type: [number, 'null']
+    required: [measureId, performanceYear, benchmarkYear, submissionMethod, percentiles]