Examples

Every example here is executed on each documentation build against PROJ 9.9.0, so the output shown is what the code produces. The notebooks are the files in the repository’s examples/ directory.

Notebooks

Quickstart

A tour of geodetic_engine.geodesy: a projection, a named datum shift, a geoid height, a dynamic frame with a coordinate epoch, axis inspection, batch and numpy input, provenance, reuse, and bound CRSs including a collapsed chain and an OSDU payload.

geodetic-engine – Quickstart Examples
Worked examples

Longer cases: ED50 to WGS 84, OSDU bound CRS round trips through UTM, chained operations, Norwegian NN54 heights with and without a datum change, an engineering CRS, operation discovery by area of use, coordinate export, and ten OSDU persistableReference scenarios.

geodetic-engine examples

Examples by topic

The user guide pages are executed too. Each is a set of short, self-contained examples:

Topic

Page

Shows

CRSs

Coordinate reference systems

Resolving inputs, declared vs value axis order, units, dimension, dynamic frames

Conversions

Conversions and transformations

Projection, inverse projection, zone change, geocentric, unit change

Datum transformations

Conversions and transformations

Named Helmert, concatenated operations, NADCON grids, geoid heights, compound CRSs, epoch-dependent Helmert, engineering CRS, bound CRS

Choosing operations

Choosing an operation

Listing, filtering, selecting by area of use, unnamed chains, ballpark candidates

Input and output

Input and output formats

Tuples, lists, numpy, per-axis, pandas, carried heights, exports, round trips

Provenance

Results and provenance

Applied operation, route, pipeline replay in plain pyproj, database fingerprints, JSON

Refusals

Errors and refusals

Triggering every GeodesyError subclass, including a simulated missing grid

Helmert algebra

Helmert utilities

Reading, composing and collapsing Helmerts; restating ppb scales

OSDU payloads

Persistable references (OSDU)

All six payload kinds, transforming with payloads, stated operations, units, writing payloads, method support tables