Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Documentation] Tutorial: Building a raster from scratch #720

Open
asinghvi17 opened this issue Sep 1, 2024 · 2 comments
Open

[Documentation] Tutorial: Building a raster from scratch #720

asinghvi17 opened this issue Sep 1, 2024 · 2 comments
Labels
documentation Improvements or additions to documentation

Comments

@asinghvi17
Copy link
Collaborator

asinghvi17 commented Sep 1, 2024

It would be cool to have a tutorial that shows all the different things you can do (and have to be careful of) when building a raster from scratch.

  • Build using ranges, vectors, matrices of lookup dimensions
    • The conceptual nature of a raster as a gridded surface, as opposed to an unstructured surface (random points or arbitrary mesh) becomes clear here
    • Show that you can plot anything
  • Specify sampling
  • Specify missingval before you reproject - I ran into this issue when trying to reproject a manually constructed raster
  • All the crazy stuff you can do with Rasters.warp
  • Save and specify chunking pattern

I will try to write this tutorial but would appreciate any suggestions!

cc @alex-s-gardner @haakon-e @tiemvanderdeure (just the people I'm aware of who may have built rasters from scratch and can contribute pain points)

@asinghvi17 asinghvi17 changed the title Tutorial: Building a raster from scratch [Documentation] Tutorial: Building a raster from scratch Sep 1, 2024
@rafaqz
Copy link
Owner

rafaqz commented Sep 1, 2024

This is in the process of changing a lot for the better with Rasters.create.

Its been around for a wile for internal use but I've made it a lot better and exported in
#695

The idea is a unified interface for creating a Raster in memory or on disk, and some goodies like a function to apply to it while its open for the first time, initialising fill values, etc.

The main stalling point on me just merging that PR is maskingval is not a great keyword for the user-facing missingval in the case there are two (mostly it will be missing but could be e.g. NaN or 0x00 for performance).

(Its in that PR because fixing all those keywords forced my hand to actually make create general and work everywhere it needs to, and some questions like this came in at the same time so it may as well be exported and/or documented)

@lazarusA lazarusA added the documentation Improvements or additions to documentation label Sep 1, 2024
@asinghvi17
Copy link
Collaborator Author

A basic version of this will go into geocompjl, but I'm not sure where the rest should lie.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

3 participants