sun_pixel_position — GEOCAM `sun` op

• Datenarten: image2d → keypoints

• Aufruf: import fullseye as fs; fs.ledger.sun_pixel_position(image, threshold=0.98, min_area=4) (die Implementierung direkt: import geocam; geocam.sun_pixel_position(image, threshold=0.98, min_area=4); aus dem Register: opsgeocam.get("sun_pixel_position"))

Verwendung

Schwerpunkt der Sonne im Bild (einer Scheibe, die den Sensor sättigt) → keypoints (1, 2) = (u, v).

Die Prämisse ist "die Sonne sättigt den Sensor; Wolken und Schnee bleiben knapp unter der Sättigung". Pixel mit einem Wert von mindestens threshold (absolut, Bild 0 bis 1) werden in der 8er-Nachbarschaft verbunden, und der Leuchtdichteschwerpunkt des größten Klumpens wird zurückgegeben. Ist der Klumpen kleiner als min_area oder gibt es keine gesättigten Pixel, gilt "die Sonne ist nicht im Bild" und es folgt ValueError (es wird nicht stillschweigend eine Wolkenreflexion zurückgegeben -- ein Gate, damit in Fotos, in denen die Sonne hinter einem Berg verborgen ist, keine Wolke als Sonne gelesen wird und die Pose verfälscht). Es ist kein Verhältnis zum Bildmaximum (mit einem Verhältnis würde in einem Foto ohne Sonne die hellste Wolke immer zur "Sonne"). Künstliche Lichtquellen in Nachtszenen und Sonnenreflexionen auf Wasser können sättigen, daher ist es in solchen Szenen nicht verwendbar. Der Klumpen muss eine kompakte Scheibe sein (Füllgrad ≥ 0.4, Seitenverhältnis ≤ 2.5) -- ein Foto, in dem ein überbelichtetes Himmelsband gesättigt ist, ergibt einen langgestreckten Klumpen und wird abgewiesen.

Args:

image: (H, W) float, 0 bis 1 (außerhalb ValueError).

threshold: Absolutwert, der als Sättigung gilt (Standard 0.98).

min_area: minimale Pixelanzahl eines Klumpens.

Returns:

keypoints (1, 2) float: (u, v).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie geocam

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_public_camera_heading — py -3.11 examples/poc_public_camera_heading.py

Typkompatible Folge-Operatoren (nehmen `keypoints` als Eingabe)

camera_orientation_from_sun · camera_orientation_from_sun_candidates

Gleiche Kategorie (`sun`)

sun_position · camera_orientation_from_sun · sun_bloom_fit · camera_orientation_from_sun_candidates

*Provenance: geocam.py — GEOCAM Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

sun_pixel_position — GEOCAM sun op