False Negative Rate

Available

image_classification.fnr

The average one-vs-rest false-negative rate across classes - how often true members of a class are missed.

Contract

Field	Value
version	1.0.0
metric_type	pointwise
scorer_contract	full_dataset
direction	lower_is_better
entrypoint	aip_scorers_image_classification.answered.fnr
target_kind	None

Required columns

• image_id
• label
• predictions

Accepted schemas

[
  {
    "name": "gdi_image_v1",
    "task_types": [
      "classification"
    ]
  }
]

Methodology

1. Deterministic - no LLM. Derived from the confusion matrix (numpy counts).
2. For each class, read one-vs-rest counts: true positives and false negatives.
3. Compute per-class FNR = FN / (FN + TP).
4. Macro-average across classes, skipping classes whose FNR is undefined.

Score semantics

Scores range 0-1, the macro-average of per-class false-negative rate (1 - recall). A low score means few true members are missed; a high score means many are missed. Lower is better.

Worked example

Confusion matrix [[1, 1], [0, 2]] gives FNR(cat) = 1/2 and FNR(dog) = 0/2 -> macro-average 0.25 (= 1 - 0.75 recall).

Configuration schema

{
  "description": "Shared image-classification metric configuration.",
  "properties": {
    "inverted": {
      "default": false,
      "title": "Inverted",
      "type": "boolean",
      "x-aip-param-role": "scoring_metadata"
    },
    "max": {
      "default": 1.0,
      "title": "Max",
      "type": "number",
      "x-aip-param-role": "scoring_metadata"
    },
    "metric_name": {
      "default": "image_classification_metric",
      "title": "Metric Name",
      "type": "string",
      "x-aip-param-role": "scoring_metadata"
    },
    "min": {
      "default": 0.0,
      "title": "Min",
      "type": "number",
      "x-aip-param-role": "scoring_metadata"
    },
    "weight": {
      "default": 1.0,
      "title": "Weight",
      "type": "number",
      "x-aip-param-role": "scoring_metadata"
    }
  },
  "title": "InitializationConfig",
  "type": "object"
}

Execution

{
  "emits_metric_family": false,
  "function_name": "image_classification.confusion_matrix",
  "max_concurrency": null,
  "processing_kind": "cpu",
  "stream_batch_size": null,
  "timeout_seconds": 600
}

Complete manifest

accepts:
- name: gdi_image_v1
  task_types:
  - classification
config_schema:
  description: Shared image-classification metric configuration.
  properties:
    inverted:
      default: false
      title: Inverted
      type: boolean
      x-aip-param-role: scoring_metadata
    max:
      default: 1.0
      title: Max
      type: number
      x-aip-param-role: scoring_metadata
    metric_name:
      default: image_classification_metric
      title: Metric Name
      type: string
      x-aip-param-role: scoring_metadata
    min:
      default: 0.0
      title: Min
      type: number
      x-aip-param-role: scoring_metadata
    weight:
      default: 1.0
      title: Weight
      type: number
      x-aip-param-role: scoring_metadata
  title: InitializationConfig
  type: object
dependencies: []
description: Mean one-vs-rest false-negative rate across observed classes.
direction: lower_is_better
display_name: False Negative Rate
entrypoint: aip_scorers_image_classification.answered.fnr
execution:
  emits_metric_family: false
  function_name: image_classification.confusion_matrix
  max_concurrency: null
  processing_kind: cpu
  stream_batch_size: null
  timeout_seconds: 600
kind: metric
manifest_version: '1'
max_prompt_slots: 0
metric_metadata:
  methodology:
  - Deterministic - no LLM. Derived from the confusion matrix (numpy counts).
  - 'For each class, read one-vs-rest counts: true positives and false negatives.'
  - Compute per-class FNR = FN / (FN + TP).
  - Macro-average across classes, skipping classes whose FNR is undefined.
  score_semantics: Scores range 0-1, the macro-average of per-class false-negative
    rate (1 - recall). A low score means few true members are missed; a high score
    means many are missed. Lower is better.
  summary: The average one-vs-rest false-negative rate across classes - how often
    true members of a class are missed.
  worked_example: Confusion matrix [[1, 1], [0, 2]] gives FNR(cat) = 1/2 and FNR(dog)
    = 0/2 -> macro-average 0.25 (= 1 - 0.75 recall).
metric_type: pointwise
name: image_classification.fnr
partition_types: []
required_columns:
- image_id
- label
- predictions
required_kinds: []
scorer_contract: full_dataset
target_kind: null
unsupported_trace_shapes: []
version: 1.0.0