---
title: Template:Infobox/black_hole
canonical_url: https://paxabyssi.com/wiki/Template:Infobox/black_hole
markdown_url: https://paxabyssi.com/wiki/Template:Infobox/black_hole.md
type: wiki-page
namespace: Template
revision_id: 2
revision_view: stable
last_updated: 2026-09-27
license: CC BY-SA 4.0
license_url: https://creativecommons.org/licenses/by-sa/4.0/
summary: "Infobox schema for black hole pages: the class page and individual objects (Sagittarius A*, Cygnus X-1): the fields, their groups, labels and units, as a JSON Schema."
categories:
  - Infobox schemas
---

# Template:Infobox/black_hole

> Source: https://paxabyssi.com/wiki/Template:Infobox/black_hole
>
> Licence: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). Text by Pax Abyssi Wiki contributors; history at https://paxabyssi.com/wiki/Template:Infobox/black_hole/history
>
> Revision 2, 27 September 2026

This page holds the JSON Schema for `infobox: type: black_hole`, used by black hole pages: the class page and individual objects (Sagittarius A\*, Cygnus X-1) (the field list follows SCIENCE_CORPUS 3.4 H). Every page whose frontmatter names this type is validated against it on save: a schema error blocks a save by a new account or an API client and warns a trusted editor.

Values are flexible so that writers can record what the sources allow. A field may be plain text or a number, a quantity object `{value, unit, min, max, error, source, note}`, or a by-status mapping `{observed, model, sim}` when the measured, inferred and generated values differ. Fields not listed here are allowed and shown under "Other" in the infobox. The `x-pax` block carries display metadata: the groups in order, each group's default provenance tag, and the label and unit for every field.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://paxabyssi.com/wiki/Template:Infobox/black_hole",
  "title": "Black hole",
  "description": "Infobox for black hole pages: the class page and individual objects (Sagittarius A*, Cygnus X-1). Fields follow SCIENCE_CORPUS 3.4 H.",
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "const": "black_hole"
    },
    "image": {
      "$ref": "#/$defs/fileTitle",
      "description": "Lead image, a File: title."
    },
    "caption": {
      "type": "string"
    },
    "image_caption": {
      "type": "string"
    },
    "class": {
      "type": "string"
    },
    "classes": {
      "$ref": "#/$defs/field"
    },
    "constellation": {
      "$ref": "#/$defs/field"
    },
    "position_j2000": {
      "$ref": "#/$defs/field"
    },
    "distance_pc": {
      "$ref": "#/$defs/field"
    },
    "distance_ly": {
      "$ref": "#/$defs/field"
    },
    "discovery_year": {
      "$ref": "#/$defs/field"
    },
    "first_identified": {
      "$ref": "#/$defs/field"
    },
    "evidence": {
      "$ref": "#/$defs/field"
    },
    "nearest_known": {
      "$ref": "#/$defs/field"
    },
    "nearest_well_studied_star": {
      "$ref": "#/$defs/field"
    },
    "galaxy_population_estimate": {
      "$ref": "#/$defs/field"
    },
    "mass_msun": {
      "$ref": "#/$defs/field"
    },
    "spin_a_star": {
      "$ref": "#/$defs/field"
    },
    "schwarzschild_radius_formula": {
      "$ref": "#/$defs/field"
    },
    "schwarzschild_radius_km_per_msun": {
      "$ref": "#/$defs/field"
    },
    "schwarzschild_radius_km": {
      "$ref": "#/$defs/field"
    },
    "schwarzschild_radius_au": {
      "$ref": "#/$defs/field"
    },
    "horizon_rs": {
      "$ref": "#/$defs/field"
    },
    "photon_sphere_rs": {
      "$ref": "#/$defs/field"
    },
    "photon_sphere_km": {
      "$ref": "#/$defs/field"
    },
    "shadow_radius_rs": {
      "$ref": "#/$defs/field"
    },
    "shadow_angular_diameter_uas": {
      "$ref": "#/$defs/field"
    },
    "isco_prograde_rs": {
      "$ref": "#/$defs/field"
    },
    "isco_retrograde_rs": {
      "$ref": "#/$defs/field"
    },
    "isco_km": {
      "$ref": "#/$defs/field"
    },
    "tidal_disruption_radius_sun_like_star_au": {
      "$ref": "#/$defs/field"
    },
    "hawking_temperature_k": {
      "$ref": "#/$defs/field"
    },
    "accretion_state": {
      "$ref": "#/$defs/field"
    },
    "accretion_rate_msun_per_yr": {
      "$ref": "#/$defs/field"
    },
    "bolometric_luminosity_erg_s": {
      "$ref": "#/$defs/field"
    },
    "radiative_efficiency_thin_disk": {
      "$ref": "#/$defs/field"
    },
    "jet": {
      "$ref": "#/$defs/field"
    },
    "known_in_sim_catalogue": {
      "$ref": "#/$defs/field"
    },
    "sim_stops": {
      "$ref": "#/$defs/field"
    },
    "sim_stop": {
      "$ref": "#/$defs/field"
    },
    "sim_source": {
      "$ref": "#/$defs/field"
    },
    "physics_engine": {
      "$ref": "#/$defs/field"
    },
    "science_doc": {
      "$ref": "#/$defs/field"
    },
    "rendered_example": {
      "$ref": "#/$defs/field"
    },
    "last_verified": {
      "$ref": "#/$defs/field"
    }
  },
  "additionalProperties": true,
  "$defs": {
    "quantity": {
      "type": "object",
      "description": "A number or range with its unit and provenance.",
      "properties": {
        "value": {
          "type": [
            "number",
            "string",
            "null"
          ]
        },
        "unit": {
          "type": "string"
        },
        "min": {
          "type": [
            "number",
            "string"
          ]
        },
        "max": {
          "type": [
            "number",
            "string"
          ]
        },
        "error": {
          "type": [
            "number",
            "string"
          ]
        },
        "uncertainty": {
          "type": [
            "number",
            "string"
          ]
        },
        "source": {
          "type": "string",
          "description": "observed | model | sim | catalogue | fiction, or a citation."
        },
        "note": {
          "type": "string"
        },
        "as_of": {
          "type": [
            "string",
            "number"
          ]
        }
      },
      "additionalProperties": true
    },
    "byStatus": {
      "type": "object",
      "description": "The same quantity as measured (observed), inferred (model) and generated (sim).",
      "properties": {
        "observed": {
          "$ref": "#/$defs/cell"
        },
        "model": {
          "$ref": "#/$defs/cell"
        },
        "sim": {
          "$ref": "#/$defs/cell"
        },
        "note": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "cell": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array"
        },
        {
          "$ref": "#/$defs/quantity"
        }
      ]
    },
    "field": {
      "anyOf": [
        {
          "$ref": "#/$defs/cell"
        },
        {
          "$ref": "#/$defs/byStatus"
        },
        {
          "type": "object"
        }
      ]
    },
    "fileTitle": {
      "type": "string",
      "pattern": "^File:"
    },
    "status": {
      "description": "One or more of observed, model, sim, speculative, fiction; or a sentence saying which parts carry which label.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    }
  },
  "x-pax": {
    "label": "Black hole",
    "image_field": "image",
    "caption_field": "caption",
    "groups": [
      {
        "index": "01",
        "title": "Identity",
        "fields": [
          "class",
          "classes",
          "constellation",
          "position_j2000",
          "distance_pc",
          "distance_ly",
          "discovery_year",
          "first_identified",
          "evidence",
          "nearest_known",
          "nearest_well_studied_star",
          "galaxy_population_estimate"
        ],
        "provenance": "catalogue"
      },
      {
        "index": "02",
        "title": "Geometry",
        "fields": [
          "mass_msun",
          "spin_a_star",
          "schwarzschild_radius_formula",
          "schwarzschild_radius_km_per_msun",
          "schwarzschild_radius_km",
          "schwarzschild_radius_au",
          "horizon_rs",
          "photon_sphere_rs",
          "photon_sphere_km",
          "shadow_radius_rs",
          "shadow_angular_diameter_uas",
          "isco_prograde_rs",
          "isco_retrograde_rs",
          "isco_km",
          "tidal_disruption_radius_sun_like_star_au",
          "hawking_temperature_k"
        ]
      },
      {
        "index": "03",
        "title": "Accretion",
        "fields": [
          "accretion_state",
          "accretion_rate_msun_per_yr",
          "bolometric_luminosity_erg_s",
          "radiative_efficiency_thin_disk",
          "jet"
        ]
      },
      {
        "index": "04",
        "title": "Sim",
        "fields": [
          "known_in_sim_catalogue",
          "sim_stops",
          "sim_stop",
          "sim_source",
          "physics_engine",
          "science_doc",
          "rendered_example",
          "last_verified"
        ],
        "provenance": "sim"
      }
    ],
    "fields": {
      "class": {
        "label": "Class"
      },
      "classes": {
        "label": "Classes"
      },
      "constellation": {
        "label": "Constellation"
      },
      "position_j2000": {
        "label": "Position (J2000)"
      },
      "distance_pc": {
        "label": "Distance",
        "unit": "pc"
      },
      "distance_ly": {
        "label": "Distance",
        "unit": "ly"
      },
      "discovery_year": {
        "label": "Discovered"
      },
      "first_identified": {
        "label": "First identified"
      },
      "evidence": {
        "label": "Evidence"
      },
      "nearest_known": {
        "label": "Nearest known"
      },
      "nearest_well_studied_star": {
        "label": "Nearest well-studied star"
      },
      "galaxy_population_estimate": {
        "label": "Galactic population"
      },
      "mass_msun": {
        "label": "Mass",
        "unit": "M☉"
      },
      "spin_a_star": {
        "label": "Spin a*"
      },
      "schwarzschild_radius_formula": {
        "label": "Schwarzschild radius"
      },
      "schwarzschild_radius_km_per_msun": {
        "label": "Schwarzschild radius per solar mass",
        "unit": "km/M☉"
      },
      "schwarzschild_radius_km": {
        "label": "Schwarzschild radius",
        "unit": "km"
      },
      "schwarzschild_radius_au": {
        "label": "Schwarzschild radius",
        "unit": "AU"
      },
      "horizon_rs": {
        "label": "Event horizon",
        "unit": "r_s"
      },
      "photon_sphere_rs": {
        "label": "Photon sphere",
        "unit": "r_s"
      },
      "photon_sphere_km": {
        "label": "Photon sphere",
        "unit": "km"
      },
      "shadow_radius_rs": {
        "label": "Shadow radius",
        "unit": "r_s"
      },
      "shadow_angular_diameter_uas": {
        "label": "Shadow angular diameter",
        "unit": "μas"
      },
      "isco_prograde_rs": {
        "label": "ISCO (prograde)",
        "unit": "r_s"
      },
      "isco_retrograde_rs": {
        "label": "ISCO (retrograde)",
        "unit": "r_s"
      },
      "isco_km": {
        "label": "ISCO",
        "unit": "km"
      },
      "tidal_disruption_radius_sun_like_star_au": {
        "label": "Tidal disruption radius (Sun-like star)",
        "unit": "AU"
      },
      "hawking_temperature_k": {
        "label": "Hawking temperature",
        "unit": "K"
      },
      "accretion_state": {
        "label": "Accretion state"
      },
      "accretion_rate_msun_per_yr": {
        "label": "Accretion rate",
        "unit": "M☉/yr"
      },
      "bolometric_luminosity_erg_s": {
        "label": "Bolometric luminosity",
        "unit": "erg/s"
      },
      "radiative_efficiency_thin_disk": {
        "label": "Thin-disk radiative efficiency",
        "unit": "%"
      },
      "jet": {
        "label": "Jet"
      },
      "known_in_sim_catalogue": {
        "label": "In the sim catalogue"
      },
      "sim_stops": {
        "label": "Sim stops"
      },
      "sim_stop": {
        "label": "Sim stop"
      },
      "sim_source": {
        "label": "Sim source"
      },
      "physics_engine": {
        "label": "Physics engine"
      },
      "science_doc": {
        "label": "Science document"
      },
      "rendered_example": {
        "label": "Rendered example"
      },
      "last_verified": {
        "label": "Last verified"
      }
    }
  }
}
```

Categories: [Infobox schemas](https://paxabyssi.com/wiki/Category:Infobox_schemas.md)