Image From Metadata#

Builder

ImageFromMetaBuilder(tags)

Build an ImagePerspective from metadata.

Functions

image_from_meta(tags[, crs, vertical_ref, ...])

Build an image (camera + EOR) from metadata.
class weitsicht.metadata.image_from_meta.ImageFromMetaBuilder(tags: MetaTagsBase | MetaTagAll)[source]#

Build an ImagePerspective from metadata.

The builder caches intermediate results (IOR/EOR) and provides a single place to add tracing/debug information in the future.

Parameters:

tags (MetaTagsBase | MetaTagAll)

__init__(tags: MetaTagsBase | MetaTagAll)[source]#
Parameters:

tags (MetaTagsBase | MetaTagAll)

ior() → IORFromMetaResultSuccess | ResultFailure[MetadataIssue][source]#
Return type:

IORFromMetaResultSuccess | ResultFailure[MetadataIssue]

eor(crs: CRS | None = None, vertical_ref: str = 'ellipsoidal', height_rel: float = 0.0, to_utm: bool = False) → EORFromMetaResultSuccess | ResultFailure[MetadataIssue][source]#
Parameters:

  • crs (CRS | None)

  • vertical_ref (str)

  • height_rel (float)

  • to_utm (bool)

Return type:

EORFromMetaResultSuccess | ResultFailure[MetadataIssue]

image(crs: CRS | None = None, vertical_ref: str = 'ellipsoidal', height_rel: float = 0.0, to_utm: bool = False) → ImageFromMetaResultSuccess | ResultFailure[MetadataIssue][source]#
Parameters:

  • crs (CRS | None)

  • vertical_ref (str)

  • height_rel (float)

  • to_utm (bool)

Return type:

ImageFromMetaResultSuccess | ResultFailure[MetadataIssue]

weitsicht.metadata.image_from_meta.image_from_meta(tags: MetaTagsBase | MetaTagAll, crs: CRS | None = None, vertical_ref: str = 'ellipsoidal', height_rel: float = 0.0, to_utm: bool = False) → ImageFromMetaResultSuccess | ResultFailure[MetadataIssue][source]#

Build an image (camera + EOR) from metadata.

Parameters:

  • tags (MetaTagsBase | MetaTagAll) – Tag resolver instance or already-resolved tag container.

  • crs (CRS | None) – Optional override CRS for interpreting GPS tags, defaults to None.

  • vertical_ref (str) – Vertical reference mode passed to eor_from_meta(), defaults to ellipsoidal. Supported values are: - ellipsoidal: Interpret heights as ellipsoidal (WGS84 ellipsoid). - orthometric: Interpret heights as orthometric (EGM2008 geoid heights, EPSG:3855). - relative: Use tag:RelativeAltitude (if present) plus height_rel (start height) as height.

  • height_rel (float) – Reference height (meters) for vertical_ref='relative', defaults to 0.0.

  • to_utm (bool) – Whether to output the image pose in WGS84-UTM (EGM2008) instead of ECEF, defaults to False. If True, the orientation is aligned to UTM grid north (meridian convergence applied).

Returns:

Successful image build result or a failure result.

Return type:

ImageFromMetaResult