Documentation#

This section provides the conceptual and mathematical background for weitsicht: coordinate systems, camera models, image types, transformations, and mapper (ground model) assumptions.

Basics#

What is Geo-Referencing

Basics about geo-referenced images.

Geo-referenced Images
Monoplotting

Single-image pixel → 3D mapping by ray–surface intersection.

Monoplotting

Definitions#

Important

This section is critical on how input data need to be defined.

Pixel CRS

XY definition for pixels

Pixel Coordinate System
Camera CRS

Camera CRS definition used

Camera Coordinate System
Pose / Rotation Angles

Rotation matrix basics and common OPK / AZK (APK) notations.

Image Pose, Attitude, and Rotation Angles

Perspective Image#

Basics

Basics on perspective images

Perspective Image
Camera Models

Pinhole Model and Distortion

Camera Model

Ortho Imagery#

Ortho photos

Rectified image in orthographic view.

Ortho Photo

Mapper#

The main purpose of the mapper classes is to get the intersection of a ray.
As well it can also be used to get the height of a coordinate.
Horizontal plane

Constant-height plane (fast, flat approximation).

Horizontal Plane Mapper
Raster (DEM/DSM)

Raster-based ground model (rasterio), terrain-aware intersections.

Raster Mapper
GeorefArray (in-memory)

In-memory raster window backend with bilinear patch intersections.

GeorefArray Mapper
Mesh

Triangle mesh intersections (trimesh), complex surfaces.

Mesh Mapper
Surface normals

How mappers estimate normals (and what they mean).

Surface Normals