{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-solar-eclipse-local-response-schema.json",
  "title": "SolarEclipseLocalResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/openephemeris-com-eclipse-api-openapi.yml#/components/schemas/SolarEclipseLocalResponse",
  "properties": {
    "besselian_elements": {
      "$ref": "#/$defs/BesselianElements"
    },
    "eclipse_classification": {
      "$ref": "#/$defs/EclipseClassification"
    },
    "local_circumstances": {
      "$ref": "#/$defs/LocalCircumstances"
    },
    "meta": {
      "$ref": "#/$defs/CalculationMeta"
    },
    "safety": {
      "$ref": "#/$defs/SafetyWarnings"
    },
    "uncertainty": {
      "$ref": "#/$defs/UncertaintyInfo"
    }
  },
  "required": [
    "meta",
    "eclipse_classification",
    "besselian_elements",
    "local_circumstances"
  ],
  "type": "object",
  "$defs": {
    "BesselianElements": {
      "properties": {
        "X": {
          "description": "Shadow axis x in fundamental plane",
          "title": "X",
          "type": "number"
        },
        "Xdot": {
          "default": 0,
          "title": "Xdot",
          "type": "number"
        },
        "Y": {
          "description": "Shadow axis y in fundamental plane",
          "title": "Y",
          "type": "number"
        },
        "Ydot": {
          "default": 0,
          "title": "Ydot",
          "type": "number"
        },
        "d": {
          "description": "Declination of shadow axis (degrees)",
          "title": "D",
          "type": "number"
        },
        "ddot": {
          "default": 0,
          "title": "Ddot",
          "type": "number"
        },
        "f1": {
          "description": "Penumbral cone half-angle (radians)",
          "title": "F1",
          "type": "number"
        },
        "f2": {
          "description": "Umbral cone half-angle (radians)",
          "title": "F2",
          "type": "number"
        },
        "l1": {
          "description": "Penumbral shadow radius",
          "title": "L1",
          "type": "number"
        },
        "l2": {
          "description": "Umbral shadow radius",
          "title": "L2",
          "type": "number"
        },
        "mu": {
          "description": "Hour angle of shadow axis (degrees)",
          "title": "Mu",
          "type": "number"
        },
        "mudot": {
          "default": 0,
          "title": "Mudot",
          "type": "number"
        },
        "reference_jd": {
          "format": "double",
          "title": "Reference Jd",
          "type": "number"
        },
        "reference_time_utc": {
          "title": "Reference Time Utc",
          "type": "string"
        }
      },
      "required": [
        "reference_time_utc",
        "reference_jd",
        "X",
        "Y",
        "d",
        "mu",
        "l1",
        "l2",
        "f1",
        "f2"
      ],
      "title": "BesselianElements",
      "type": "object"
    },
    "CalculationMeta": {
      "properties": {
        "calculation_precision": {
          "default": "sub_kilometer",
          "title": "Calculation Precision",
          "type": "string"
        },
        "delta_t_model": {
          "title": "Delta T Model",
          "type": "string"
        },
        "delta_t_seconds": {
          "title": "Delta T Seconds",
          "type": "number"
        },
        "delta_t_uncertainty": {
          "title": "Delta T Uncertainty",
          "type": "number"
        },
        "ephemeris": {
          "title": "Ephemeris",
          "type": "string"
        },
        "julian_day": {
          "format": "double",
          "title": "Julian Day",
          "type": "number"
        }
      },
      "required": [
        "ephemeris",
        "julian_day",
        "delta_t_seconds",
        "delta_t_model",
        "delta_t_uncertainty"
      ],
      "title": "CalculationMeta",
      "type": "object"
    },
    "ConfidenceLevel": {
      "enum": [
        "high",
        "medium",
        "low",
        "historical"
      ],
      "title": "ConfidenceLevel",
      "type": "string"
    },
    "EclipseClassification": {
      "properties": {
        "central_duration_seconds": {
          "anyOf": [
            {
              "type": "number"
            }
          ],
          "title": "Central Duration Seconds"
        },
        "gamma": {
          "title": "Gamma",
          "type": "number"
        },
        "greatest_magnitude": {
          "default": 0,
          "title": "Greatest Magnitude",
          "type": "number"
        },
        "inex_series": {
          "anyOf": [
            {
              "type": "integer"
            }
          ],
          "title": "Inex Series"
        },
        "kind": {
          "$ref": "#/$defs/EclipseKind"
        },
        "saros_member": {
          "default": 0,
          "title": "Saros Member",
          "type": "integer"
        },
        "saros_series": {
          "default": 0,
          "title": "Saros Series",
          "type": "integer"
        },
        "type": {
          "$ref": "#/$defs/EclipseType"
        }
      },
      "required": [
        "type",
        "kind",
        "gamma"
      ],
      "title": "EclipseClassification",
      "type": "object"
    },
    "EclipseKind": {
      "enum": [
        "solar",
        "lunar"
      ],
      "title": "EclipseKind",
      "type": "string"
    },
    "EclipseType": {
      "enum": [
        "total",
        "annular",
        "hybrid",
        "partial",
        "penumbral"
      ],
      "title": "EclipseType",
      "type": "string"
    },
    "LocalCircumstances": {
      "properties": {
        "duration_seconds": {
          "anyOf": [
            {
              "type": "number"
            }
          ],
          "title": "Duration Seconds"
        },
        "first_contact": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "First Contact"
        },
        "fourth_contact": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "Fourth Contact"
        },
        "magnitude": {
          "title": "Magnitude",
          "type": "number"
        },
        "max_eclipse": {
          "title": "Max Eclipse",
          "type": "string"
        },
        "obscuration": {
          "default": 0,
          "title": "Obscuration",
          "type": "number"
        },
        "second_contact": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "Second Contact"
        },
        "sun_altitude": {
          "default": 0,
          "title": "Sun Altitude",
          "type": "number"
        },
        "sun_azimuth": {
          "default": 0,
          "title": "Sun Azimuth",
          "type": "number"
        },
        "third_contact": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "Third Contact"
        },
        "type": {
          "$ref": "#/$defs/EclipseType"
        }
      },
      "required": [
        "type",
        "magnitude",
        "max_eclipse"
      ],
      "title": "LocalCircumstances",
      "type": "object"
    },
    "SafetyWarnings": {
      "properties": {
        "baileys_beads_visible": {
          "default": false,
          "title": "Baileys Beads Visible",
          "type": "boolean"
        },
        "corona_visible_duration": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "Corona Visible Duration"
        },
        "eye_protection_required": {
          "title": "Eye Protection Required",
          "type": "boolean"
        },
        "partial_phase_duration": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "Partial Phase Duration"
        },
        "path_uncertainty_note": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "Path Uncertainty Note"
        }
      },
      "required": [
        "eye_protection_required"
      ],
      "title": "SafetyWarnings",
      "type": "object"
    },
    "UncertaintyInfo": {
      "properties": {
        "confidence": {
          "$ref": "#/$defs/ConfidenceLevel"
        },
        "delta_t_uncertainty_seconds": {
          "title": "Delta T Uncertainty Seconds",
          "type": "number"
        },
        "path_uncertainty_km": {
          "anyOf": [
            {
              "type": "number"
            }
          ],
          "title": "Path Uncertainty Km"
        },
        "timing_uncertainty": {
          "anyOf": [
            {
              "type": "string"
            }
          ],
          "title": "Timing Uncertainty"
        }
      },
      "required": [
        "confidence",
        "delta_t_uncertainty_seconds"
      ],
      "title": "UncertaintyInfo",
      "type": "object"
    }
  }
}