construct RasterSeries from AbstractBasicDimArray

[tiemvanderdeure]

Just a small quality of life improvement that makes it possible to get a RasterSeries from a DimArray using a pipe.

Things works nicely together with @d to make things like this possible

using Rasters, RasterDataSources
function get_climate_data(gcm, ssp)
    Raster(rand(X(1:10)))
end
ssps = [SSP370] |> Dim{:ssp}
gcms = [GFDL_ESM4, MRI_ESM2_0] |> Dim{:gcm}
(@d get_climate_data.(gcms, ssps)) |> RasterSeries |> Rasters.combine

which returns a Raster with dims X, ssp, and gcm

[rafaqz]

So slick.

Especially with RDS climate types as lookups.

[rafaqz]

Suggested change

	RasterSeries(data::DD.AbstractBasicDimArray; kw...) =
	RasterSeries(data, dims(data); kw...)
	RasterSeries(data::DD.AbstractBasicDimArray{<:Union{AbstractRasterStack,AbstractRaster}}; kw...) = RasterSeries(data, dims(data);

Has to hold a Raster or RasterStack

[tiemvanderdeure]

I didn't want to limit it to that, in principle it could hold strings (of filenames) as well. If it holds something that isn't allowed then RasterSeries(data, dims(data) will fail anyway

[rafaqz]

Ahh right because strings will work too. Ok makes sense

[rafaqz]

Maybe a test?

[tiemvanderdeure]

We really should include an example like this in the docs somewhere. It's not a super intuitive way to use dimensions but it is just such as nice way to keep track of your data. It just gets rid of all the for-loops in the rest of your workflow.

[rafaqz]

Did you want to add docs in this PR? Or just merge?

[tiemvanderdeure]

Just merge! I'll make a docs example in a separate PR.

[asinghvi17]

Just to clarify here - is a RasterSeries essentially a lazy concatenation of multiple dimarrays of dimension n, along some dimension n+1 (and maybe also n+2 etc)?

If so, can a RasterSeries be used as a vector of dimvectors as well as a dimmatrix? That would be super interesting for some of the vector data cube stuff.

[rafaqz]

It's basically just a Raster of Rasters or RastersStacks with some helper methods.

It's not a lazy concatenation, but using Rasters.combine will concatenate it to a single Raster/RasterStack, and for DiskArrays that will be lazy