Skip to content

Multirate (Matrix Rating)

Configure a rating matrix in Potato where annotators score multiple items on the same scale simultaneously — useful for comparative evaluation and rubric-based tasks.

The multirate type displays multiple items in a matrix format where each item is rated on the same scale. Use it to evaluate several dimensions of a single item.

Multi-criteria rating interfaceMatrix rating interface for multi-dimensional evaluation in Potato

Basic Configuration

yaml
annotation_schemes:
  - name: "aspect_ratings"

Configuration Options

FieldTypeRequiredDescription
namestringYesUnique identifier for the annotation
descriptionstringYesInstructions shown to annotators
annotation_typestringYesMust be "multirate"
labelsarrayYesItems to be rated (rows)
optionsarrayYesRating scale options (columns)
sizenumberNoAlternative to options: number of scale points
min_labelstringNoLabel for lowest rating
max_labelstringNoLabel for highest rating
randomizebooleanNoRandomize item order
compactbooleanNoUse compact layout

Examples

Response Quality Assessment

yaml
- name: "quality_assessment"

Translation Quality

yaml
- name: "translation_quality"

Product Review Dimensions

yaml
- name: "product_dimensions"

Output Format

The multirate annotation outputs a dictionary mapping each item to its rating:

json
{
  "id": "item_1",
  "annotations": {
    "aspect_ratings": {
      "Accuracy": "4",
      "Clarity": "5",
      "Helpfulness": "3"
    }
  }
}

Use Cases

  • LLM Evaluation: Rate responses on multiple quality dimensions
  • Translation Assessment: Evaluate fluency, adequacy, and terminology
  • Product Reviews: Capture ratings across different product aspects
  • Survey Research: Likert-style matrix questions
  • Peer Review: Rate papers on multiple criteria

Best Practices

  1. Limit the number of items - 3-7 items works best; more causes fatigue
  2. Use consistent scales - All items should use the same rating scale
  3. Order items logically - Group related dimensions together
  4. Provide clear definitions - Use tooltips to explain each dimension
  5. Consider randomization - Prevents order bias in responses