Calculate complete solar windows with explicit UTC and offsets

Declare the source and every time window

UTC windows include their start and exclude their end. Civil time uses your complete offset intervals; no historical time zone is guessed.

Observer and window IDs may repeat; original array ordinals and the source hash distinguish their identities. Unknown object fields or malformed structure reject the whole document. Identifiable invalid observer/window values remain complete entities with null effective fields and original tokens. Nonzero number underflow and overflow never become valid zero or fabricated JSON null.

{
  "schema": "neatbo.solar-horizon.input.v1",
  "observers": [
    {
      "id": "San Jose",
      "latitude": 37.2580565,
      "longitude": -121.9359228,
      "heightMeters": 0,
      "metersAboveGround": 0
    }
  ],
  "windows": [
    {
      "id": "2022-07-06 21:00 PDT context, explicitly converted UTC",
      "observerOrdinal": 0,
      "start": {
        "utc": "2022-07-07T04:00:00Z"
      },
      "end": {
        "utc": "2022-07-08T04:00:00Z"
      },
      "requests": [
        {
          "kind": "upper-limb",
          "directions": [
            "rise",
            "set"
          ]
        },
        {
          "kind": "civil",
          "directions": [
            "rise",
            "set"
          ]
        },
        {
          "kind": "nautical",
          "directions": [
            "rise",
            "set"
          ]
        },
        {
          "kind": "astronomical",
          "directions": [
            "rise",
            "set"
          ]
        }
      ]
    }
  ]
}

• Choose File to use the selected original; Text uses only the complete paste.
• Keep finite negative-zero tokens and the report’s signed-zero path sidecar.
• Do not fill a missing historical date or offset with a guess.

Use the complete parameter contract

Input parameters are explicit; the fixed model, year range and lookahead are not hidden tuning controls. Civil endpoints must match the supplied offset interval at the actual instant, and full map coverage includes both 370-day lookaheads.

Inspect unknown states and save the full result

A missing event alone does not establish polar day or night. Both 370-day searches and the complete window must support the state; uncertainty stays unknown.

Any input, source, locale or setting change cancels the current run and clears its old result and links immediately. After cancellation, retry the same original and parameters in a fresh worker; reduce a scope that exceeds the joint budgets.

All six physical files together ≤64 MiB; full text and copy each ≤64 MiB, typed ≤128 MiB, aggregate ≤320 MiB and wire ≤1 GiB. All allocations jointly reserve the original 256 MiB memory before allocation.

One 120-second deadline includes capture, read, calculation, encoding, cleanup and first publication. Joint capacity and browser acceptance remain unmeasured.

Mature resolution and consumed intervals

This calculation adopts the fixed mature model’s single-crossing bracket and Nyquist assumptions. After a resolved event, the complete interval from its original returned time to the original positive bracket endpoint is recorded as that same event and consumed before continuing. The original 0.1-second numerical tolerance and sub-second pair exclusion remain; this is not a mathematical certificate or an observation precision guarantee. Crossings near altitude extrema, tangencies and sub-second pairs are outside the completeness guarantee; observed unsupported or touching evidence remains unknown.

Any unexplained sub-second interval, non-progress, inconsistent bracket or overlap with the requested window boundary remains unknown. Every original prune and solver exit stays in the report; the full consumed interval is retained in every search JSON in the CSV, timeline metadata, full copy and report. settings.json also retains the complete model, every original search and consumed interval, with its own signed-zero path sidecar.

• Review the actual negative/positive endpoint values and event/search identities.
• Keep the full original input, settings and all six files together.