geometry-proj 0.0.8

Coordinate-reference-system reprojection for the geometry kernel, backed by the pure-Rust proj4rs engine.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

# geometry-proj

Part of the [boost_geometry](https://crates.io/crates/boost_geometry) workspace — a Rust port of [Boost.Geometry](https://www.boost.org/doc/libs/release/libs/geometry/). Most users should depend on the facade crate, which re-exports this one; depend on this crate directly only for a slimmer build.

Coordinate-reference-system reprojection for the geometry kernel.

Boost.Geometry defers projections to its unsupported
`extensions/gis/projections/`; this crate fills the gap with the
pure-Rust [`proj4rs`] engine (no C dependency). Build a [`Crs`] from
a proj4 string, an EPSG code, or a WKT definition, then
[`reproject`](reproject()) a geometry from one CRS to another in
place.

```rust
use geometry_cs::Cartesian;
use geometry_model::Point2D;
use geometry_proj::{reproject, Crs};
use geometry_trait::Point as _;

let wgs84 = Crs::from_epsg(4326).unwrap();      // lon/lat, radians
let mercator = Crs::from_epsg(3857).unwrap();   // metres
let mut p = Point2D::<f64, Cartesian>::new(0.0, 0.0);
reproject(&mut p, &wgs84, &mercator).unwrap();
assert!(p.get::<0>().abs() < 1e-6);
```

## Units

`proj4rs` carries geographic coordinates in **radians**; convert with
[`f64::to_radians`] / [`f64::to_degrees`] at the boundary. See
[`reproject`](reproject()) for detail.

Module layout:

* [`crs`] — the [`Crs`] type and its constructors.
* [`reproject`](mod@reproject) — the [`ReprojectPoints`] hook and the
  [`reproject`](reproject()) function.

## License

BSL-1.0 — see [LICENSE](https://github.com/pentatonick/boost_geometry/blob/main/LICENSE).