Exterior Orientation from Metadata

Main API Function

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

Extract exterior orientation (position + rotation + CRS) from metadata tags.

Helper

_deg(val)

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

Extract exterior orientation (position + rotation + CRS) from metadata tags.

If to_utm is True the returned position is expressed in a local projected coordinate system derived from the input CRS (typically WGS84) by converting to WGS84-UTM with EGM2008 heights. The orientation is returned in the corresponding UTM grid ENU frame (i.e. true ENU rotated by meridian convergence).

If to_utm is False the pose is returned in WGS84 ECEF (EPSG:4978).

If XMP tags HorizCS/VertCS are missing, defaults to WGS84 (EPSG:4979) with ellipsoidal heights.

Parameters:

• tags (MetaTagAll) – Grouped metadata values (e.g. from MetaTagsBase.get_all()).

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

• vertical_ref (str) – Vertical reference mode: ellipsoidal, orthometric, or relative. relative uses RelativeAltitude + height_rel.

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

• to_utm (bool) – Whether to output the position in WGS84-UTM (EGM2008) instead of ECEF, defaults to False.

Returns:

Successful EOR result or a failure result.

Return type:

EORFromMetaResult

weitsicht.metadata.eor_from_meta._deg(val)