georust / geo

Geospatial primitives and algorithms for Rust
https://crates.io/crates/geo
Other
1.5k stars 195 forks source link

Add visuals to the documentation #601

Open frewsxcv opened 3 years ago

frewsxcv commented 3 years ago

Adding visuals to the documentation could be helpful for people like me who have trouble focusing on big blocks of text. Some examples I'm thinking:

As for the how, here's the code for how Shapely generates their visuals: https://github.com/Toblerity/Shapely/tree/master/docs/code

I was thinking we can create a new repo in the GeoRust org called 'diagrams' (or 'visuals' or reuse the existing 'static' repo) that would include both the code to generate the visuals, and also host them via GitHub pages.

urschrei commented 3 years ago

+100000 to this

Nevsden commented 3 years ago

As for the how, here's the code for how Shapely generates their visuals: https://github.com/Toblerity/Shapely/tree/master/docs/code

As you mention Shapely, do you have in mind a particular programming language to add this functionality or could Rust also be considered? I found the kiss3d quite easy to use and with enough functionality to support line / polygon drawing on a simple birds-eye view.

frewsxcv commented 3 years ago

As for the how, here's the code for how Shapely generates their visuals: https://github.com/Toblerity/Shapely/tree/master/docs/code

As you mention Shapely, do you have in mind a particular programming language to add this functionality or could Rust also be considered? I found the kiss3d quite easy to use and with enough functionality to support line / polygon drawing on a simple birds-eye view.

My thinking is Rust would be preferred for this. But if that's a pain or the tooling isn't mature enough, then another language like Python is acceptable

frewsxcv commented 9 months ago

https://github.com/rust-lang/rust/issues/32104#issuecomment-1040924373