diff --git a/previews/PR800/404.html b/previews/PR800/404.html index a9c0ee60..d99f6a07 100644 --- a/previews/PR800/404.html +++ b/previews/PR800/404.html @@ -8,7 +8,7 @@ - + @@ -16,7 +16,7 @@
- + \ No newline at end of file diff --git a/previews/PR800/api.html b/previews/PR800/api.html index 195cb40e..f5d6d34e 100644 --- a/previews/PR800/api.html +++ b/previews/PR800/api.html @@ -8,33 +8,33 @@ - + - + - + -
Skip to content

Index

Reference - Exported functions

Rasters.Rasters Module

source

Rasters.AbstractRaster Type
julia
AbstractRaster <: DimensionalData.AbstractDimArray

Abstract supertype for objects that wrap an array (or location of an array) and metadata about its contents. It may be memory or hold a FileArray, which holds the filename, and is only opened when required.

AbstractRasters inherit from AbstractDimArray from DimensionalData.jl. They can be indexed as regular Julia arrays or with DimensionalData.jl Dimensions. They will plot as a heatmap in Plots.jl with correct coordinates and labels, even after slicing with getindex or view. getindex on a AbstractRaster will always return a memory-backed Raster.

source

Rasters.AbstractRasterSeries Type
julia
AbstractRasterSeries <: DimensionalData.AbstractDimensionalArray

Abstract supertype for high-level DimensionalArray that hold RasterStacks, Rasters, or the paths they can be loaded from. RasterSeries are indexed with dimensions as with a AbstractRaster. This is useful when you have multiple files containing rasters or stacks of rasters spread over dimensions like time and elevation.

As much as possible, implementations should facilitate loading entire directories and detecting the dimensions from metadata.

This allows syntax like below for a series of stacks of arrays:

julia
RasterSeries[Time(Near(DateTime(2001, 1))][:temp][Y(Between(70, 150)), X(Between(-20,20))] |> plot`

RasterSeries is the concrete implementation.

source

Rasters.AbstractRasterStack Type
julia
AbstractRasterStack

Abstract supertype for objects that hold multiple AbstractRasters that share spatial dimensions.

They are NamedTuple-like structures that may either contain NamedTuple of AbstractRasters, string paths that will load AbstractRasters, or a single path that points to a file containing multiple layers, like NetCDF or HDF5. Use and syntax is similar or identical for all cases.

AbstractRasterStack can hold layers that share some or all of their dimensions. They cannot have the same dimension with different length or spatial extent as another layer.

getindex on an AbstractRasterStack generally returns a memory backed standard Raster. raster[:somelayer] |> plot plots the layers array, while raster[:somelayer, X(1:100), Band(2)] |> plot will plot the subset without loading the whole array.

getindex on an AbstractRasterStack with a key returns another stack with getindex applied to all the arrays in the stack.

source

Rasters.Band Type
julia
Band <: Dimension
+    
Skip to content

Index

Reference - Exported functions

Rasters.Rasters Module

source

Rasters.AbstractRaster Type
julia
AbstractRaster <: DimensionalData.AbstractDimArray

Abstract supertype for objects that wrap an array (or location of an array) and metadata about its contents. It may be memory or hold a FileArray, which holds the filename, and is only opened when required.

AbstractRasters inherit from AbstractDimArray from DimensionalData.jl. They can be indexed as regular Julia arrays or with DimensionalData.jl Dimensions. They will plot as a heatmap in Plots.jl with correct coordinates and labels, even after slicing with getindex or view. getindex on a AbstractRaster will always return a memory-backed Raster.

source

Rasters.AbstractRasterSeries Type
julia
AbstractRasterSeries <: DimensionalData.AbstractDimensionalArray

Abstract supertype for high-level DimensionalArray that hold RasterStacks, Rasters, or the paths they can be loaded from. RasterSeries are indexed with dimensions as with a AbstractRaster. This is useful when you have multiple files containing rasters or stacks of rasters spread over dimensions like time and elevation.

As much as possible, implementations should facilitate loading entire directories and detecting the dimensions from metadata.

This allows syntax like below for a series of stacks of arrays:

julia
RasterSeries[Time(Near(DateTime(2001, 1))][:temp][Y(Between(70, 150)), X(Between(-20,20))] |> plot`

RasterSeries is the concrete implementation.

source

Rasters.AbstractRasterStack Type
julia
AbstractRasterStack

Abstract supertype for objects that hold multiple AbstractRasters that share spatial dimensions.

They are NamedTuple-like structures that may either contain NamedTuple of AbstractRasters, string paths that will load AbstractRasters, or a single path that points to a file containing multiple layers, like NetCDF or HDF5. Use and syntax is similar or identical for all cases.

AbstractRasterStack can hold layers that share some or all of their dimensions. They cannot have the same dimension with different length or spatial extent as another layer.

getindex on an AbstractRasterStack generally returns a memory backed standard Raster. raster[:somelayer] |> plot plots the layers array, while raster[:somelayer, X(1:100), Band(2)] |> plot will plot the subset without loading the whole array.

getindex on an AbstractRasterStack with a key returns another stack with getindex applied to all the arrays in the stack.

source

Rasters.Band Type
julia
Band <: Dimension
 
 Band(val=:)

Band Dimension for multi-band rasters.

Example:

julia
banddim = Band(10:10:100)
 # Or
 val = A[Band(1)]
 # Or
-mean(A; dims=Band)

source

Rasters.Mapped Type
julia
Mapped <: AbstractProjected
+mean(A; dims=Band)

source

Rasters.Mapped Type
julia
Mapped <: AbstractProjected
 
 Mapped(order, span, sampling, crs, mappedcrs)
-Mapped(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs=nothing, mappedcrs)

An AbstractSampled Lookup, where the dimension index has been mapped to another projection, usually lat/lon or EPSG(4326). Mapped matches the dimension format commonly used in netcdf files.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

The mapped dimension index will be used as for Sampled, but to save in another format the underlying crs may be used to convert it.

source

Rasters.Projected Type
julia
Projected <: AbstractProjected
+Mapped(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs=nothing, mappedcrs)

An AbstractSampled Lookup, where the dimension index has been mapped to another projection, usually lat/lon or EPSG(4326). Mapped matches the dimension format commonly used in netcdf files.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

The mapped dimension index will be used as for Sampled, but to save in another format the underlying crs may be used to convert it.

source

Rasters.Projected Type
julia
Projected <: AbstractProjected
 
 Projected(order, span, sampling, crs, mappedcrs)
-Projected(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs, mappedcrs=nothing)

An AbstractSampled Lookup with projections attached.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

If both crs and mappedcrs fields contain CRS data (in a GeoFormat wrapper from GeoFormatTypes.jl) the selector inputs and plot axes will be converted from and to the specified mappedcrs projection automatically. A common use case would be to pass mappedcrs=EPSG(4326) to the constructor when loading eg. a GDALarray:

julia
GDALarray(filename; mappedcrs=EPSG(4326))

The underlying crs will be detected by GDAL.

If mappedcrs is not supplied (ie. mappedcrs=nothing), the base index will be shown on plots, and selectors will need to use whatever format it is in.

source

Rasters.Raster Type
julia
Raster <: AbstractRaster
+Projected(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs, mappedcrs=nothing)

An AbstractSampled Lookup with projections attached.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

If both crs and mappedcrs fields contain CRS data (in a GeoFormat wrapper from GeoFormatTypes.jl) the selector inputs and plot axes will be converted from and to the specified mappedcrs projection automatically. A common use case would be to pass mappedcrs=EPSG(4326) to the constructor when loading eg. a GDALarray:

julia
GDALarray(filename; mappedcrs=EPSG(4326))

The underlying crs will be detected by GDAL.

If mappedcrs is not supplied (ie. mappedcrs=nothing), the base index will be shown on plots, and selectors will need to use whatever format it is in.

source

Rasters.Raster Type
julia
Raster <: AbstractRaster
 
 Raster(filepath::String; kw...)
 Raster(A::AbstractDimArray; kw...)
-Raster(A::AbstractArray, dims; kw...)

A generic AbstractRaster for spatial/raster array data. It can hold either memory-backed arrays or, if lazy=true, a FileArray, which stores the String path to an unopened file.

If lazy=true, the file will only be opened lazily when it is indexed with getindex or when read(A) is called. Broadcasting, taking a view, reversing, and most other methods will not load data from disk; they will be applied later, lazily.

Arguments

  • dims: Tuple of Dimensions needed when an AbstractArray is used.

Keywords

  • name: a Symbol name for the array, which will also retrieve the, alphabetically first, named layer if Raster is used on a multi-layered file like a NetCDF. If instead RasterStack is used to read the multi-layered file, by default, all variables will be added to the stack.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • missingval: value reprsenting missing data, normally detected from the file. Set manually when you know the value is not specified or is incorrect. This will not change any values in the raster, it simply assigns which value is treated as missing. To replace all of the missing values in the raster, use replace_missing.

  • metadata: Dict or Metadata object for the array, or NoMetadata().

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of position Dimensions the array was sliced from, defaulting to (). Usually not needed.

When a filepath String is used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • write: defines the default write keyword value when calling open on the Raster. false by default. Only makes sense to use when lazy=true.

When A is an AbstractDimArray:

  • data: can replace the data in an existing AbstractRaster

source

Rasters.RasterSeries Type
julia
RasterSeries <: AbstractRasterSeries
+Raster(A::AbstractArray, dims; kw...)

A generic AbstractRaster for spatial/raster array data. It can hold either memory-backed arrays or, if lazy=true, a FileArray, which stores the String path to an unopened file.

If lazy=true, the file will only be opened lazily when it is indexed with getindex or when read(A) is called. Broadcasting, taking a view, reversing, and most other methods will not load data from disk; they will be applied later, lazily.

Arguments

  • dims: Tuple of Dimensions needed when an AbstractArray is used.

Keywords

  • name: a Symbol name for the array, which will also retrieve the, alphabetically first, named layer if Raster is used on a multi-layered file like a NetCDF. If instead RasterStack is used to read the multi-layered file, by default, all variables will be added to the stack.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • missingval: value reprsenting missing data, normally detected from the file. Set manually when you know the value is not specified or is incorrect. This will not change any values in the raster, it simply assigns which value is treated as missing. To replace all of the missing values in the raster, use replace_missing.

  • metadata: Dict or Metadata object for the array, or NoMetadata().

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of position Dimensions the array was sliced from, defaulting to (). Usually not needed.

When a filepath String is used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • write: defines the default write keyword value when calling open on the Raster. false by default. Only makes sense to use when lazy=true.

When A is an AbstractDimArray:

  • data: can replace the data in an existing AbstractRaster

source

Rasters.RasterSeries Type
julia
RasterSeries <: AbstractRasterSeries
 
 RasterSeries(rasters::AbstractArray{<:AbstractRaster}, dims; [refdims])
 RasterSeries(stacks::AbstractArray{<:AbstractRasterStack}, dims; [refdims]) 
@@ -45,7 +45,7 @@
 2-element RasterSeries{Raster,1} with dimensions: 
   Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

The DateTime suffix is parsed from the filenames. Using Ti(Int) would try to parse integers instead.

Just using the directory will also work, unless there are other files mixed in it:

julia
julia> ser = RasterSeries("series_dir", Ti(DateTime))
 2-element RasterSeries{Raster,1} with dimensions: 
-  Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

Arguments

  • dims: series dimension/s.

Keywords

When loading a series from a Vector of String paths or a single String path:

  • child: constructor of child objects for use when filenames are passed in, can be Raster or RasterStack. Defaults to Raster.

  • duplicate_first::Bool: wether to duplicate the dimensions and metadata of the first file with all other files. This can save load time with a large series where dimensions are identical. false by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • kw: keywords passed to the child constructor Raster or RasterStack.

When loading a series from a single String path:

  • separator: separator used to split lookup elements from the rest of a filename. '_' by default.

Others:

  • refdims: existing reference dimension/s, normally not required.

source

Rasters.RasterStack Type
julia
RasterStack <: AbstrackRasterStack
+  Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

Arguments

  • dims: series dimension/s.

Keywords

When loading a series from a Vector of String paths or a single String path:

  • child: constructor of child objects for use when filenames are passed in, can be Raster or RasterStack. Defaults to Raster.

  • duplicate_first::Bool: wether to duplicate the dimensions and metadata of the first file with all other files. This can save load time with a large series where dimensions are identical. false by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • kw: keywords passed to the child constructor Raster or RasterStack.

When loading a series from a single String path:

  • separator: separator used to split lookup elements from the rest of a filename. '_' by default.

Others:

  • refdims: existing reference dimension/s, normally not required.

source

Rasters.RasterStack Type
julia
RasterStack <: AbstrackRasterStack
 
 RasterStack(data...; name, kw...)
 RasterStack(data::Union{Vector,Tuple}; name, kw...)
@@ -54,14 +54,14 @@
 RasterStack(data::Raster; layersfrom=Band, kw...)
 RasterStack(filepath::AbstractString; kw...)

Load a file path or a NamedTuple of paths as a RasterStack, or convert arguments, a Vector or NamedTuple of Rasters to RasterStack.

Arguments

  • data: A NamedTuple of Rasters or String, or a Vector, Tuple or splatted arguments of Raster. The latter options must pass a name keyword argument.

  • filepath: A file (such as netcdf or tif) to be loaded as a stack, or a directory path containing multiple files.

Keywords

  • name: Used as stack layer names when a Tuple, Vector or splat of Raster is passed in. Has no effect when NameTuple is used - the NamedTuple keys are the layer names.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • metadata: A Dict or DimensionalData.Metadata object.

  • missingval: a single value for all layers or a NamedTuple of missingval for each layer. nothing specifies no missing value.

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of Dimension that the stack was sliced from.

For when one or multiple filepaths are used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

For when a single Raster is used:

  • layersfrom: Dimension to source stack layers from if the file is not already multi-layered. nothing is default, so that a single RasterStack(raster) is a single layered stack. RasterStack(raster; layersfrom=Band) will use the bands as layers.
julia
files = (temp="temp.tif", pressure="pressure.tif", relhum="relhum.tif")
 stack = RasterStack(files; mappedcrs=EPSG(4326))
-stack[:relhum][Lat(Contains(-37), Lon(Contains(144))

source

DimensionalData.modify Method
julia
modify(f, series::AbstractRasterSeries)

Apply function f to the data of the child object. If the child is an AbstractRasterStack the function will be passed on to its child AbstractRasters.

f must return an identically sized array.

This method triggers a complete rebuild of all objects, and disk based objects will be transferred to memory.

An example of the usefulnesss of this is for swapping out array backend for an entire series to CuArray from CUDA.jl to copy data to a GPU.

source

GeoInterface.crs Method
julia
crs(x::Raster)

Get the projected coordinate reference system of a Y or X Dimension, or of the Y/X dims of an AbstractRaster.

For Mapped lookup this may be nothing as there may be no projected coordinate reference system at all. See setcrs to set it manually.

source

Rasters.aggregate Function
julia
aggregate(method, object, scale; filename, progress, skipmissing)

Aggregate a Raster, or all arrays in a RasterStack or RasterSeries, by scale using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that specifies where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • progress: show a progress bar, true by default, false to hide.

Example

julia
using Rasters, RasterDataSources, Statistics, Plots
+stack[:relhum][Lat(Contains(-37), Lon(Contains(144))

source

DimensionalData.modify Method
julia
modify(f, series::AbstractRasterSeries)

Apply function f to the data of the child object. If the child is an AbstractRasterStack the function will be passed on to its child AbstractRasters.

f must return an identically sized array.

This method triggers a complete rebuild of all objects, and disk based objects will be transferred to memory.

An example of the usefulnesss of this is for swapping out array backend for an entire series to CuArray from CUDA.jl to copy data to a GPU.

source

GeoInterface.crs Method
julia
crs(x::Raster)

Get the projected coordinate reference system of a Y or X Dimension, or of the Y/X dims of an AbstractRaster.

For Mapped lookup this may be nothing as there may be no projected coordinate reference system at all. See setcrs to set it manually.

source

Rasters.aggregate Function
julia
aggregate(method, object, scale; filename, progress, skipmissing)

Aggregate a Raster, or all arrays in a RasterStack or RasterSeries, by scale using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that specifies where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • progress: show a progress bar, true by default, false to hide.

Example

julia
using Rasters, RasterDataSources, Statistics, Plots
 import ArchGDAL
 using Rasters: Center
 st = read(RasterStack(WorldClim{Climate}; month=1))
 ag = aggregate(Center(), st, (Y(20), X(20)); skipmissingval=true, progress=false)
 plot(ag)
 savefig("build/aggregate_example.png"); nothing
-# output

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.aggregate! Method
julia
aggregate!(method, dst::AbstractRaster, src::AbstractRaster, scale; skipmissingval=false)

Aggregate array src to array dst by scale, using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • progress: show a progress bar.

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

Note: currently it is much faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.boolmask Function
julia
boolmask(obj::Raster; [missingval])
+# output

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.aggregate! Method
julia
aggregate!(method, dst::AbstractRaster, src::AbstractRaster, scale; skipmissingval=false)

Aggregate array src to array dst by scale, using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • progress: show a progress bar.

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

Note: currently it is much faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.boolmask Function
julia
boolmask(obj::Raster; [missingval])
 boolmask(obj; [to, res, size])
 boolmask(obj::RasterStack; alllayers=true, kw...)

Create a mask array of Bool values, from another Raster. AbstractRasterStack or AbstractRasterSeries are also accepted.

The array returned from calling boolmask on a AbstractRaster is a Raster with the same dimensions as the original array and a missingval of false.

Arguments

  • a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Raster / RasterStack Keywords

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: The missing value of the source array, with default missingval(raster).

Keywords

  • alllayers: if true a mask is taken for all layers, otherwise only the first layer is used. Defaults to true

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

And specifically for shape=:polygon:

  • boundary: include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

For tabular data, feature collections and other iterables

  • collapse: if true, collapse all geometry masks into a single mask. Otherwise return a Raster with an additional geometry dimension, so that each slice along this axis is the mask of the geometry opbject of each row of the table, feature in the feature collection, or just each geometry in the iterable.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 wc = Raster(WorldClim{Climate}, :prec; month=1)
@@ -69,7 +69,7 @@
 
 savefig("build/boolmask_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.cellarea Method
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.cellarea Method
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
 xdim = X(Projected(90.0:10.0:120; sampling=Intervals(Start()), crs=EPSG(4326)))
 ydim = Y(Projected(0.0:10.0:50; sampling=Intervals(Start()), crs=EPSG(4326)))
 myraster = rand(xdim, ydim)
@@ -90,7 +90,7 @@
   90.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  100.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  110.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
- 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.classify Function
julia
classify(x, pairs; lower=(>=), upper=(<), others=nothing)
+ 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.classify Function
julia
classify(x, pairs; lower=(>=), upper=(<), others=nothing)
 classify(x, pairs...; lower, upper, others)

Create a new array with values in x classified by the values in pairs.

pairs can hold tuples fo values (2, 3), a Fix2 function e.g. <=(1), a Tuple of Fix2 e.g. (>=(4), <(7)), or an IntervalSets.jl interval, e.g. 3..9 or OpenInterval(10, 12). pairs can also be a n * 3 matrix where each row is lower bounds, upper bounds, replacement.

If tuples or a Matrix are used, the lower and upper keywords define how the lower and upper boundaries are chosen.

If others is set other values not covered in pairs will be set to that values.

Arguments

  • x: a Raster or RasterStack

  • pairs: each pair contains a value and a replacement, a tuple of lower and upper range and a replacement, or a Tuple of Fix2 like (>(x), <(y).

Keywords

  • lower: Which comparison (< or <=) to use for lower values, if Fix2 are not used.

  • upper: Which comparison (> or >=) to use for upper values, if Fix2 are not used.

  • others: A value to assign to all values not included in pairs. Passing nothing (the default) will leave them unchanged.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{Climate}, :tavg; month=1)
 classes = <=(15) => 10,
@@ -102,7 +102,7 @@
 
 savefig("build/classify_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.classify! Method
julia
classify!(x, pairs...; lower, upper, others)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.classify! Method
julia
classify!(x, pairs...; lower, upper, others)
 classify!(x, pairs; lower, upper, others)

Classify the values of x in-place, by the values in pairs.

If Fix2 is not used, the lower and upper keywords

If others is set other values not covered in pairs will be set to that values.

Arguments

  • x: a Raster or RasterStack

  • pairs: each pair contains a value and a replacement, a tuple of lower and upper range and a replacement, or a Tuple of Fix2 like (>(x), <(y).

Keywords

  • lower: Which comparison (< or <=) to use for lower values, if Fix2 are not used.

  • upper: Which comparison (> or >=) to use for upper values, if Fix2 are not used.

  • others: A value to assign to all values not included in pairs. Passing nothing (the default) will leave them unchanged.

Example

classify! to disk, with key steps:

  • copying a tempory file so we don't write over the RasterDataSources.jl version.

  • use open with write=true to open the file with disk-write permissions.

  • use Float32 like 10.0f0 for all our replacement values and other, because the file is stored as Float32. Attempting to write some other type will fail.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 # Download and copy the file
 filename = getraster(WorldClim{Climate}, :tavg; month=6)
@@ -122,8 +122,8 @@
 
 savefig("build/classify_bang_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.combine Method
julia
combine(A::AbstracRasterSeries; [dims], [lazy]) => Raster

Combine a RasterSeries along some dimension/s, creating a new Raster or RasterStack, depending on the contents of the series.

If dims are passed, only the specified dimensions will be combined with a RasterSeries returned, unless dims is all the dims in the series.

If lazy, concatenate lazily. The default is to concatenate lazily for lazy Rasters and eagerly otherwise.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.convertlookup Method
julia
convertlookup(dstlookup::Type{<:Lookup}, x)

Convert the dimension lookup between Projected and Mapped. Other dimension lookups pass through unchanged.

This is used to e.g. save a netcdf file to GeoTiff.

source

Rasters.coverage! Method
julia
coverage!(A, geom; [mode, scale])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

source

Rasters.coverage Method
julia
coverage(mode, geom; [to, res, size, scale, verbose, progress])
-coverage(geom; [to, mode, res, size, scale, verbose, progress])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

source

Rasters.crop Function
julia
crop(x; to, touches=false, [geometrycolumn])
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.combine Method
julia
combine(A::AbstracRasterSeries; [dims], [lazy]) => Raster

Combine a RasterSeries along some dimension/s, creating a new Raster or RasterStack, depending on the contents of the series.

If dims are passed, only the specified dimensions will be combined with a RasterSeries returned, unless dims is all the dims in the series.

If lazy, concatenate lazily. The default is to concatenate lazily for lazy Rasters and eagerly otherwise.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.convertlookup Method
julia
convertlookup(dstlookup::Type{<:Lookup}, x)

Convert the dimension lookup between Projected and Mapped. Other dimension lookups pass through unchanged.

This is used to e.g. save a netcdf file to GeoTiff.

source

Rasters.coverage! Method
julia
coverage!(A, geom; [mode, scale])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

source

Rasters.coverage Method
julia
coverage(mode, geom; [to, res, size, scale, verbose, progress])
+coverage(geom; [to, mode, res, size, scale, verbose, progress])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

source

Rasters.crop Function
julia
crop(x; to, touches=false, [geometrycolumn])
 crop(xs...; to)

Crop one or multiple AbstractRaster or AbstractRasterStack x to match the size of the object to, or smallest of any dimensions that are shared.

crop is lazy, using a view into the object rather than allocating new memory.

Keywords

  • to: the object to crop to. This can be a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified. If no to keyword is passed, the smallest shared area of all xs is used.

  • touches: true or false. Whether to use Touches wraper on the object extent. When lines need to be included in e.g. zonal statistics, true should be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

As crop is lazy, filename and suffix keywords are not used.

Example

Crop to another raster:

julia
using Rasters, RasterDataSources, Plots
 evenness = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
 rnge = Raster(EarthEnv{HabitatHeterogeneity}, :range)
@@ -153,7 +153,7 @@
 
 savefig("build/argentina_crop_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.disaggregate Function
julia
disaggregate(method, object, scale; filename, progress, keys)

Disaggregate array, or all arrays in a stack or series, by some scale.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or a Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

Keywords

  • progress: show a progress bar.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.disaggregate! Method
julia
disaggregate!(method, dst::AbstractRaster, src::AbstractRaster, filename, scale)

Disaggregate array src to array dst by some scale, using method.

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.extend Function
julia
extend(xs...; [to])
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.disaggregate Function
julia
disaggregate(method, object, scale; filename, progress, keys)

Disaggregate array, or all arrays in a stack or series, by some scale.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or a Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

Keywords

  • progress: show a progress bar.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.disaggregate! Method
julia
disaggregate!(method, dst::AbstractRaster, src::AbstractRaster, filename, scale)

Disaggregate array src to array dst by some scale, using method.

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

Rasters.extend Function
julia
extend(xs...; [to])
 extend(xs; [to])
 extend(x::Union{AbstractRaster,AbstractRasterStack}; to, kw...)

Extend one or multiple AbstractRaster to match the area covered by all xs, or by the keyword argument to.

Keywords

  • to: the Raster or dims to extend to. If no to keyword is passed, the largest shared area of all xs is used.

  • touches: true or false. Whether to use Touches wrapper on the object extent. When lines need to be included in e.g. zonal statistics, true shoudle be used.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

julia
using Rasters, RasterDataSources, Plots
 evenness = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
@@ -169,7 +169,7 @@
 
 savefig("build/extend_example.png")
 nothing
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.extract Function
julia
extract(x, data; kw...)

Extracts the value of Raster or RasterStack at given points, returning an iterable of NamedTuple with properties for :geometry and raster or stack layer values.

Note that if objects have more dimensions than the length of the point tuples, sliced arrays or stacks will be returned instead of single values.

Arguments

  • x: a Raster or RasterStack to extract values from.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometry: include :geometry in returned NamedTuple, true by default.

  • index: include :index of the CartesianIndex in returned NamedTuple, false by default.

  • name: a Symbol or Tuple of Symbol corresponding to layer/s of a RasterStack to extract. All layers by default.

  • skipmissing: skip missing points automatically.

  • atol: a tolerance for floating point lookup values for when the Lookup contains Points. atol is ignored for Intervals.

geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Here we extract points matching the occurrence of the Mountain Pygmy Possum, Burramis parvus. This could be used to fit a species distribution model.

julia
using Rasters, RasterDataSources, ArchGDAL, GBIF2, CSV
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.extract Function
julia
extract(x, data; kw...)

Extracts the value of Raster or RasterStack at given points, returning an iterable of NamedTuple with properties for :geometry and raster or stack layer values.

Note that if objects have more dimensions than the length of the point tuples, sliced arrays or stacks will be returned instead of single values.

Arguments

  • x: a Raster or RasterStack to extract values from.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometry: include :geometry in returned NamedTuple, true by default.

  • index: include :index of the CartesianIndex in returned NamedTuple, false by default.

  • name: a Symbol or Tuple of Symbol corresponding to layer/s of a RasterStack to extract. All layers by default.

  • skipmissing: skip missing points automatically.

  • atol: a tolerance for floating point lookup values for when the Lookup contains Points. atol is ignored for Intervals.

geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Here we extract points matching the occurrence of the Mountain Pygmy Possum, Burramis parvus. This could be used to fit a species distribution model.

julia
using Rasters, RasterDataSources, ArchGDAL, GBIF2, CSV
 
 # Get a stack of BioClim layers, and replace missing values with `missing`
 st = RasterStack(WorldClim{BioClim}, (1, 3, 5, 7, 12)) |> replace_missing
@@ -187,7 +187,7 @@
  (geometry = (0.03, 39.97), bio1 = 17.076923f0, bio3 = 39.7983f0, bio5 = 29.638462f0, bio7 = 24.153847f0, bio12 = 441.0f0)
  (geometry = (0.03, 39.97), bio1 = 17.076923f0, bio3 = 39.7983f0, bio5 = 29.638462f0, bio7 = 24.153847f0, bio12 = 441.0f0)
  (geometry = (0.52, 40.37), bio1 = missing, bio3 = missing, bio5 = missing, bio7 = missing, bio12 = missing)
- (geometry = (0.32, 40.24), bio1 = 16.321388f0, bio3 = 41.659454f0, bio5 = 30.029825f0, bio7 = 25.544561f0, bio12 = 480.0f0)

Note: passing in arrays, geometry collections or feature collections containing a mix of points and other geometries has undefined results.

source

Rasters.mappedbounds Function
julia
mappedbounds(x)

Get the bounds converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular bounds.

source

Rasters.mappedcrs Function
julia
mappedcrs(x)

Get the mapped coordinate reference system for the Y/X dims of an array.

In Projected lookup this is used to convert Selector values form the mappedcrs defined projection to the underlying projection, and to show plot axes in the mapped projection.

In Mapped lookup this is the coordinate reference system of the index values. See setmappedcrs to set it manually.

source

Rasters.mappedindex Function
julia
mappedindex(x)

Get the index value of a dimension converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular dim value.

source

Rasters.mask! Function
julia
mask!(x; with, missingval=missingval(A))

Mask A by the missing values of with, or by all values outside with if it is a polygon.

If with is a polygon, creates a new array where points falling outside the polygon have been replaced by missingval(A).

Return a new array with values of A masked by the missing values of with, or by a polygon.

Arguments

  • x: a Raster or RasterStack.

Keywords

  • with: another AbstractRaster, a AbstractVector of Tuple points, or any GeoInterface.jl AbstractGeometry. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to write to A in masked areas, by default missingval(A).

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask to match the size and projection.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
+ (geometry = (0.32, 40.24), bio1 = 16.321388f0, bio3 = 41.659454f0, bio5 = 30.029825f0, bio7 = 25.544561f0, bio12 = 480.0f0)

Note: passing in arrays, geometry collections or feature collections containing a mix of points and other geometries has undefined results.

source

Rasters.mappedbounds Function
julia
mappedbounds(x)

Get the bounds converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular bounds.

source

Rasters.mappedcrs Function
julia
mappedcrs(x)

Get the mapped coordinate reference system for the Y/X dims of an array.

In Projected lookup this is used to convert Selector values form the mappedcrs defined projection to the underlying projection, and to show plot axes in the mapped projection.

In Mapped lookup this is the coordinate reference system of the index values. See setmappedcrs to set it manually.

source

Rasters.mappedindex Function
julia
mappedindex(x)

Get the index value of a dimension converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular dim value.

source

Rasters.mask! Function
julia
mask!(x; with, missingval=missingval(A))

Mask A by the missing values of with, or by all values outside with if it is a polygon.

If with is a polygon, creates a new array where points falling outside the polygon have been replaced by missingval(A).

Return a new array with values of A masked by the missing values of with, or by a polygon.

Arguments

  • x: a Raster or RasterStack.

Keywords

  • with: another AbstractRaster, a AbstractVector of Tuple points, or any GeoInterface.jl AbstractGeometry. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to write to A in masked areas, by default missingval(A).

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask to match the size and projection.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 
 # Load and plot the file
 awap = read(RasterStack(AWAP, (:tmin, :tmax); date=DateTime(2001, 1, 1)))
@@ -204,7 +204,7 @@
 savefig(a, "build/mask_bang_example_before.png");
 savefig(b, "build/mask_bang_example_after.png"); nothing
 
-# output

Before mask!:

After mask!:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.mask Method
julia
mask(A:AbstractRaster; with, missingval=missingval(A))
+# output

Before mask!:

After mask!:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.mask Method
julia
mask(A:AbstractRaster; with, missingval=missingval(A))
 mask(x; with)

Return a new array with values of A masked by the missing values of with, or by the shape of with, if with is a geometric object.

Arguments

  • x: a Raster or RasterStack

Keywords

  • with: an AbstractRaster, or any GeoInterface.jl compatible objects or table. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to use in the returned file.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Geometry keywords

These can be used when with is a GeoInterface.jl compatible object:

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 
 # Load and plot the file
@@ -221,7 +221,7 @@
 
 savefig(a, "build/mask_example_before.png");
 savefig(b, "build/mask_example_after.png"); nothing
-# output

Before mask:

After mask:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.missingmask Method
julia
missingmask(obj::Raster; kw...)
+# output

Before mask:

After mask:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.missingmask Method
julia
missingmask(obj::Raster; kw...)
 missingmask(obj; [to, res, size, collapse])
 missingmask(obj::RasterStack; alllayers = true, kw...)

Create a mask array of missing and true values, from another Raster. AbstractRasterStack or AbstractRasterSeries are also accepted-

For AbstractRaster the default missingval is missingval(A), but others can be chosen manually.

The array returned from calling missingmask on a AbstractRaster is a Raster with the same size and fields as the original array.

Arguments

  • obj: a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • alllayers: if true a mask is taken for all layers, otherwise only the first layer is used. Defaults to true

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 wc = Raster(WorldClim{Climate}, :prec; month=1)
@@ -229,7 +229,7 @@
 
 savefig("build/missingmask_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.missingval Function
julia
missingval(x)

Returns the value representing missing data in the dataset

source

Rasters.mosaic! Method
julia
mosaic!(f, x, regions...; missingval, atol)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.missingval Function
julia
missingval(x)

Returns the value representing missing data in the dataset

source

Rasters.mosaic! Method
julia
mosaic!(f, x, regions...; missingval, atol)
 mosaic!(f, x, regions::Tuple; missingval, atol)

Combine regions in x using the function f.

Arguments

  • f a function (e.g. mean, sum, first or last) that is applied to values where regions overlap.

  • x: A Raster or RasterStack. May be a an opened disk-based Raster, the result will be written to disk. With the current algorithm, the read speed is slow.

  • regions: source objects to be joined. These should be memory-backed (use read first), or may experience poor performance. If all objects have the same extent, mosaic is simply a merge.

Keywords

  • missingval: Fills empty areas, and defualts to the `missingval/ of the first layer.

  • atol: Absolute tolerance for comparison between index values. This is often required due to minor differences in range values due to floating point error. It is not applied to non-float dimensions. A tuple of tolerances may be passed, matching the dimension order.

Example

Cut out Australia and Africa stacks, then combined them into a single stack.

julia
using Rasters, RasterDataSources, ArchGDAL, Statistics, Plots
 st = read(RasterStack(WorldClim{Climate}; month=1))
 aus = st[X=100.0 .. 160.0, Y=-50.0 .. -10.0]
@@ -238,7 +238,7 @@
 plot(st)
 savefig("build/mosaic_bang_example.png")
 nothing
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.mosaic Method
julia
mosaic(f, regions...; missingval, atol)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.mosaic Method
julia
mosaic(f, regions...; missingval, atol)
 mosaic(f, regions; missingval, atol)

Combine regions into a single raster.

Arguments

  • f: A reducing function (mean, sum, first, last etc.) for values where regions overlap.

  • regions: Iterable or splatted Raster or RasterStack.

Keywords

  • missingval: Fills empty areas, and defualts to the missingval of the first region.

  • atol: Absolute tolerance for comparison between index values. This is often required due to minor differences in range values due to floating point error. It is not applied to non-float dimensions. A tuple of tolerances may be passed, matching the dimension order.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

If your mosaic has has apparent line errors, increase the atol value.

Example

Here we cut out Australia and Africa from a stack, and join them with mosaic.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 st = RasterStack(WorldClim{Climate}; month=1);
 
@@ -256,7 +256,7 @@
 savefig(b, "build/mosaic_example_aus.png")
 savefig(c, "build/mosaic_example_combined.png")
 nothing
-# output

Individual continents

Mosaic of continents

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.points Method
julia
points(A::AbstractRaster; dims=(YDim, XDim), ignore_missing) => Array{Tuple}

Returns a generator of the points in A for dimensions in dims, where points are a tuple of the values in each specified dimension index.

Keywords

  • dims the dimensions to return points from. The first slice of other layers will be used.

  • ignore_missing: wether to ignore missing values in the array when considering points. If true, all points in the dimensions will be returned, if false only the points that are not === missingval(A) will be returned.

The order of dims determines the order of the points.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.rasterize Function
julia
rasterize([reducer], data; geometrycolumn, kw...)

Rasterize a GeoInterface.jl compatable geometry or feature, or a Tables.jl table with a :geometry column of GeoInterface.jl objects, or points columns specified by geometrycolumn

Arguments

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from data where possible.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note on threading. Performance may be much better with threaded=false if reducer/op are not threadsafe. sum, prod, maximum, minimum count and mean (by combining sum and count) are threadsafe. If you know your algorithm is threadsafe, use threadsafe=true to allow all optimisations. Functions passed to fill are always threadsafe, and ignore the threadsafe argument.

Example

Rasterize a shapefile for China and plot, with a border.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, Downloads
+# output

Individual continents

Mosaic of continents

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.points Method
julia
points(A::AbstractRaster; dims=(YDim, XDim), ignore_missing) => Array{Tuple}

Returns a generator of the points in A for dimensions in dims, where points are a tuple of the values in each specified dimension index.

Keywords

  • dims the dimensions to return points from. The first slice of other layers will be used.

  • ignore_missing: wether to ignore missing values in the array when considering points. If true, all points in the dimensions will be returned, if false only the points that are not === missingval(A) will be returned.

The order of dims determines the order of the points.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.rasterize Function
julia
rasterize([reducer], data; geometrycolumn, kw...)

Rasterize a GeoInterface.jl compatable geometry or feature, or a Tables.jl table with a :geometry column of GeoInterface.jl objects, or points columns specified by geometrycolumn

Arguments

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from data where possible.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note on threading. Performance may be much better with threaded=false if reducer/op are not threadsafe. sum, prod, maximum, minimum count and mean (by combining sum and count) are threadsafe. If you know your algorithm is threadsafe, use threadsafe=true to allow all optimisations. Functions passed to fill are always threadsafe, and ignore the threadsafe argument.

Example

Rasterize a shapefile for China and plot, with a border.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, Downloads
 using Rasters.Lookups
 
 # Download a borders shapefile
@@ -276,7 +276,7 @@
 
 savefig("build/china_rasterized.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.rasterize! Function
julia
rasterize!([reducer], dest, data; kw...)

Rasterize the geometries in data into the Raster or RasterStack dest, using the values specified by fill.

Arguments

  • dest: a Raster or RasterStack to rasterize into.

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from A and data where possible.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, GeoInterface, Downloads
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.rasterize! Function
julia
rasterize!([reducer], dest, data; kw...)

Rasterize the geometries in data into the Raster or RasterStack dest, using the values specified by fill.

Arguments

  • dest: a Raster or RasterStack to rasterize into.

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from A and data where possible.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, GeoInterface, Downloads
 using Rasters.Lookups
 
 # Download a borders shapefile
@@ -304,12 +304,12 @@
 
 savefig("build/indonesia_rasterized.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.replace_missing Method
julia
replace_missing(a::AbstractRaster, newmissingval)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.replace_missing Method
julia
replace_missing(a::AbstractRaster, newmissingval)
 replace_missing(a::AbstractRasterStack, newmissingval)

Replace missing values in the array or stack with a new missing value, also updating the missingval field/s.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Example

julia
using Rasters, RasterDataSources, ArchGDAL
 A = Raster(WorldClim{Climate}, :prec; month=1) |> replace_missing
 missingval(A)
 # output
-missing

source

Rasters.reproject Method
julia
reproject(source::GeoFormat, target::GeoFormat, dim::Dimension, val)

reproject uses Proj.jl's Transformation interface, but implemented for reprojecting a lookup / axis array, a single dimension at a time.

source

Rasters.reproject Method
julia
reproject(obj; crs)

Reproject the lookups (axes) of obj to a different crs.

This is a lossless operation for the raster data, as only the lookup values change. This is only possible when the axes of source and destination projections are aligned: the change is usually from a Regular and an Irregular lookup spans.

For converting between projections that are rotated, skewed or warped in any way, or if you want to re-sample the data, use resample.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are silently returned without modification.

Arguments

  • obj: a Lookup, Dimension, Tuple of Dimension, Raster or RasterStack.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

source

Rasters.resample Method
julia
resample(x; kw...)
+missing

source

Rasters.reproject Method
julia
reproject(source::GeoFormat, target::GeoFormat, dim::Dimension, val)

reproject uses Proj.jl's Transformation interface, but implemented for reprojecting a lookup / axis array, a single dimension at a time.

source

Rasters.reproject Method
julia
reproject(obj; crs)

Reproject the lookups (axes) of obj to a different crs.

This is a lossless operation for the raster data, as only the lookup values change. This is only possible when the axes of source and destination projections are aligned: the change is usually from a Regular and an Irregular lookup spans.

For converting between projections that are rotated, skewed or warped in any way, or if you want to re-sample the data, use resample.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are silently returned without modification.

Arguments

  • obj: a Lookup, Dimension, Tuple of Dimension, Raster or RasterStack.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

source

Rasters.resample Method
julia
resample(x; kw...)
 resample(xs...; to=first(xs), kw...)

resample uses warp (which uses GDALs gdalwarp) to resample a Raster or RasterStack to a new resolution and optionally new crs, or to snap to the bounds, resolution and crs of the object to.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are iteratively resampled with GDAL and joined back into a single array.

If projections can be converted for each axis independently, it may be faster and more accurate to use reproject.

Run using ArchGDAL to make this method available.

Arguments

  • x: the object/s to resample.

Keywords

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from x,

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • method: A Symbol or String specifying the method to use for resampling. From the docs for gdalwarp:

    • :near: nearest neighbour resampling (default, fastest algorithm, worst interpolation quality).

    • :bilinear: bilinear resampling.

    • :cubic: cubic resampling.

    • :cubicspline: cubic spline resampling.

    • :lanczos: Lanczos windowed sinc resampling.

    • :average: average resampling, computes the weighted average of all non-NODATA contributing pixels. rms root mean square / quadratic mean of all non-NODATA contributing pixels (GDAL >= 3.3)

    • :mode: mode resampling, selects the value which appears most often of all the sampled points.

    • :max: maximum resampling, selects the maximum value from all non-NODATA contributing pixels.

    • :min: minimum resampling, selects the minimum value from all non-NODATA contributing pixels.

    • :med: median resampling, selects the median value of all non-NODATA contributing pixels.

    • :q1: first quartile resampling, selects the first quartile value of all non-NODATA contributing pixels.

    • :q3: third quartile resampling, selects the third quartile value of all non-NODATA contributing pixels.

    • :sum: compute the weighted sum of all non-NODATA contributing pixels (since GDAL 3.1)

    Where NODATA values are set to missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note:

  • GDAL may cause some unexpected changes in the raster, such as changing the crs type from EPSG to WellKnownText (it will represent the same CRS).

Example

Resample a WorldClim layer to match an EarthEnv layer:

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{Climate}, :prec; month=1)
 B = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
@@ -320,7 +320,7 @@
 savefig(a, "build/resample_example_before.png");
 savefig(b, "build/resample_example_after.png"); nothing
 
-# output

Before resample:

After resample:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.setcrs Method
julia
setcrs(x, crs)

Set the crs of a Raster, RasterStack, Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

Rasters.setmappedcrs Method
julia
setmappedcrs(x, crs)

Set the mapped crs of a Raster, a RasterStack, a Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

Rasters.slice Method
julia
slice(A::Union{AbstractRaster,AbstractRasterStack,AbstracRasterSeries}, dims) => RasterSeries

Slice views along some dimension/s to obtain a RasterSeries of the slices.

For a Raster or RasterStack this will return a RasterSeries of Raster or RasterStack that are slices along the specified dimensions.

For a RasterSeries, the output is another series where the child objects are sliced and the series dimensions index is now of the child dimensions combined. slice on a RasterSeries with no dimensions will slice along the dimensions shared by both the series and child object.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.trim Method
julia
trim(x; dims::Tuple, pad::Int)

Trim missingval(x) from x for axes in dims, returning a view of x.

Arguments

  • x: A Raster or RasterStack. For stacks, all layers must having missing values for a pixel for it to be trimmed.

Keywords

  • dims: By default dims=(XDim, YDim), so that trimming keeps the area of X and Y that contains non-missing values along all other dimensions.

  • pad: The trimmed size will be padded by pad on all sides, although padding will not be added beyond the original extent of the array.

As trim is lazy, filename and suffix keywords are not used.

Example

Create trimmed layers of Australian habitat heterogeneity.

julia
using Rasters, RasterDataSources, Plots
+# output

Before resample:

After resample:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.setcrs Method
julia
setcrs(x, crs)

Set the crs of a Raster, RasterStack, Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

Rasters.setmappedcrs Method
julia
setmappedcrs(x, crs)

Set the mapped crs of a Raster, a RasterStack, a Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

Rasters.slice Method
julia
slice(A::Union{AbstractRaster,AbstractRasterStack,AbstracRasterSeries}, dims) => RasterSeries

Slice views along some dimension/s to obtain a RasterSeries of the slices.

For a Raster or RasterStack this will return a RasterSeries of Raster or RasterStack that are slices along the specified dimensions.

For a RasterSeries, the output is another series where the child objects are sliced and the series dimensions index is now of the child dimensions combined. slice on a RasterSeries with no dimensions will slice along the dimensions shared by both the series and child object.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.trim Method
julia
trim(x; dims::Tuple, pad::Int)

Trim missingval(x) from x for axes in dims, returning a view of x.

Arguments

  • x: A Raster or RasterStack. For stacks, all layers must having missing values for a pixel for it to be trimmed.

Keywords

  • dims: By default dims=(XDim, YDim), so that trimming keeps the area of X and Y that contains non-missing values along all other dimensions.

  • pad: The trimmed size will be padded by pad on all sides, although padding will not be added beyond the original extent of the array.

As trim is lazy, filename and suffix keywords are not used.

Example

Create trimmed layers of Australian habitat heterogeneity.

julia
using Rasters, RasterDataSources, Plots
 layers = (:evenness, :range, :contrast, :correlation)
 st = RasterStack(EarthEnv{HabitatHeterogeneity}, layers)
 
@@ -335,7 +335,7 @@
 savefig(a, "build/trim_example_before.png");
 savefig(b, "build/trim_example_after.png"); nothing
 
-# output

Before trim:

After trim:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.warp Method
julia
warp(A::AbstractRaster, flags::Dict; kw...)

Gives access to the GDALs gdalwarp method given a Dict of flag => value arguments that can be converted to strings, or vectors where multiple space-separated arguments are required.

Arrays with additional dimensions not handled by GDAL (other than X, Y, Band) are sliced, warped, and then combined to match the original array dimensions. These slices will not be written to disk and loaded lazily at this stage - you will need to do that manually if required.

See the gdalwarp docs for a list of arguments.

Run using ArchGDAL to make this method available.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Any additional keywords are passed to ArchGDAL.Dataset.

Example

This simply resamples the array with the :tr (output file resolution) and :r flags, giving us a pixelated version:

julia
using Rasters, RasterDataSources, Plots
+# output

Before trim:

After trim:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.warp Method
julia
warp(A::AbstractRaster, flags::Dict; kw...)

Gives access to the GDALs gdalwarp method given a Dict of flag => value arguments that can be converted to strings, or vectors where multiple space-separated arguments are required.

Arrays with additional dimensions not handled by GDAL (other than X, Y, Band) are sliced, warped, and then combined to match the original array dimensions. These slices will not be written to disk and loaded lazily at this stage - you will need to do that manually if required.

See the gdalwarp docs for a list of arguments.

Run using ArchGDAL to make this method available.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Any additional keywords are passed to ArchGDAL.Dataset.

Example

This simply resamples the array with the :tr (output file resolution) and :r flags, giving us a pixelated version:

julia
using Rasters, RasterDataSources, Plots
 A = Raster(WorldClim{Climate}, :prec; month=1)
 a = plot(A)
 
@@ -348,7 +348,7 @@
 savefig(a, "build/warp_example_before.png");
 savefig(b, "build/warp_example_after.png"); nothing
 
-# output

Before warp:

After warp:

In practise, prefer resample for this. But warp may be more flexible.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.zonal Method
julia
zonal(f, x::Union{Raster,RasterStack}; of, kw...)

Calculate zonal statistics for the the zone of a Raster or RasterStack covered by the of object/s.

Arguments

  • f: any function that reduces an iterable to a single value, such as sum or Statistics.mean

  • x: A Raster or RasterStack

  • of: A DimTuple, Extent, a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

These can be used when of is or contains (a) GeoInterface.jl compatible object(s):

  • shape: Force data to be treated as :polygon, :line or :point, where possible.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

  • progress: show a progress bar, true by default, false to hide..

  • skipmissing: wether to apply f to the result of skipmissing(A) or not. If true f will be passed an iterator over the values, which loses all spatial information. if false f will be passes a masked Raster or RasterStack, and will be responsible for handling missing values itself. The default value is true.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Shapefile, DataFrames, Downloads, Statistics, Dates
+# output

Before warp:

After warp:

In practise, prefer resample for this. But warp may be more flexible.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

Rasters.zonal Method
julia
zonal(f, x::Union{Raster,RasterStack}; of, kw...)

Calculate zonal statistics for the the zone of a Raster or RasterStack covered by the of object/s.

Arguments

  • f: any function that reduces an iterable to a single value, such as sum or Statistics.mean

  • x: A Raster or RasterStack

  • of: A DimTuple, Extent, a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

These can be used when of is or contains (a) GeoInterface.jl compatible object(s):

  • shape: Force data to be treated as :polygon, :line or :point, where possible.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

  • progress: show a progress bar, true by default, false to hide..

  • skipmissing: wether to apply f to the result of skipmissing(A) or not. If true f will be passed an iterator over the values, which loses all spatial information. if false f will be passes a masked Raster or RasterStack, and will be responsible for handling missing values itself. The default value is true.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Shapefile, DataFrames, Downloads, Statistics, Dates
 
 # Download a borders shapefile
 ne_url = "https://github.com/nvkelso/natural-earth-vector/raw/master/10m_cultural/ne_10m_admin_0_countries"
@@ -390,21 +390,21 @@
  256 │ Bajo Nuevo Bank               NaN        NaN        NaN        NaN
  257 │ Serranilla Bank               NaN        NaN        NaN        NaN
  258 │ Scarborough Reef              NaN        NaN        NaN        NaN
-                                                  3 columns and 243 rows omitted

source

Reference - Internal functions

Rasters.AbstractProjected Type
julia
AbstractProjected <: AbstractSampled

Abstract supertype for projected index lookups.

source

Rasters.FileArray Type
julia
FileArray{S} <: DiskArrays.AbstractDiskArray

Filearray is a DiskArrays.jl AbstractDiskArray. Instead of holding an open object, it just holds a filename string that is opened lazily when it needs to be read.

source

Rasters.FileStack Type
julia
FileStack{S,Na}
+                                                  3 columns and 243 rows omitted

source

Reference - Internal functions

Rasters.AbstractProjected Type
julia
AbstractProjected <: AbstractSampled

Abstract supertype for projected index lookups.

source

Rasters.FileArray Type
julia
FileArray{S} <: DiskArrays.AbstractDiskArray

Filearray is a DiskArrays.jl AbstractDiskArray. Instead of holding an open object, it just holds a filename string that is opened lazily when it needs to be read.

source

Rasters.FileStack Type
julia
FileStack{S,Na}
 
-FileStack{S,Na}(filename, types, sizes, eachchunk, haschunks, write)

A wrapper object that holds file pointer and size/chunking metadata for a multi-layered stack stored in a single file, typically netcdf or hdf5.

S is a backend type like NCDsource, and Na is a tuple of Symbol keys.

source

Rasters.OpenStack Type
julia
OpenStack{X,K}
+FileStack{S,Na}(filename, types, sizes, eachchunk, haschunks, write)

A wrapper object that holds file pointer and size/chunking metadata for a multi-layered stack stored in a single file, typically netcdf or hdf5.

S is a backend type like NCDsource, and Na is a tuple of Symbol keys.

source

Rasters.OpenStack Type
julia
OpenStack{X,K}
 
-OpenStack{X,K}(dataset)

A wrapper for any stack-like opened dataset that can be indexed with Symbol keys to retrieve AbstractArray layers.

OpenStack is usually hidden from users, wrapped in a regular RasterStack passed as the function argument in open(stack) when the stack is contained in a single file.

X is a backend type like NCDsource, and K is a tuple of Symbol keys.

source

Rasters.RasterDiskArray Type
julia
RasterDiskArray <: DiskArrays.AbstractDiskArray

A basic DiskArrays.jl wrapper for objects that don't have one defined yet. When we open a FileArray it is replaced with a RasterDiskArray.

source

Base.open Method
julia
open(f, A::AbstractRaster; write=false)

open is used to open any lazy=true AbstractRaster and do multiple operations on it in a safe way. The write keyword opens the file in write lookup so that it can be altered on disk using e.g. a broadcast.

f is a method that accepts a single argument - an Raster object which is just an AbstractRaster that holds an open disk-based object. Often it will be a do block:

lazy=false (in-memory) rasters will ignore open and pass themselves to f.

julia
# A is an `Raster` wrapping the opened disk-based object.
+OpenStack{X,K}(dataset)

A wrapper for any stack-like opened dataset that can be indexed with Symbol keys to retrieve AbstractArray layers.

OpenStack is usually hidden from users, wrapped in a regular RasterStack passed as the function argument in open(stack) when the stack is contained in a single file.

X is a backend type like NCDsource, and K is a tuple of Symbol keys.

source

Rasters.RasterDiskArray Type
julia
RasterDiskArray <: DiskArrays.AbstractDiskArray

A basic DiskArrays.jl wrapper for objects that don't have one defined yet. When we open a FileArray it is replaced with a RasterDiskArray.

source

Base.open Method
julia
open(f, A::AbstractRaster; write=false)

open is used to open any lazy=true AbstractRaster and do multiple operations on it in a safe way. The write keyword opens the file in write lookup so that it can be altered on disk using e.g. a broadcast.

f is a method that accepts a single argument - an Raster object which is just an AbstractRaster that holds an open disk-based object. Often it will be a do block:

lazy=false (in-memory) rasters will ignore open and pass themselves to f.

julia
# A is an `Raster` wrapping the opened disk-based object.
 open(Raster(filepath); write=true) do A
     mask!(A; with=maskfile)
     A[I...] .*= 2
     # ...  other things you need to do with the open file
-end

By using a do block to open files we ensure they are always closed again after we finish working with them.

source

Base.read! Method
julia
read!(src::Union{AbstractString,AbstractRaster}, dst::AbstractRaster)
+end

By using a do block to open files we ensure they are always closed again after we finish working with them.

source

Base.read! Method
julia
read!(src::Union{AbstractString,AbstractRaster}, dst::AbstractRaster)
 read!(src::Union{AbstractString,AbstractRasterStack}, dst::AbstractRasterStack)
-read!(scr::AbstractRasterSeries, dst::AbstractRasterSeries)

read! will copy the data from src to the object dst.

src can be an object or a file-path String.

source

Base.read Method
julia
read(A::AbstractRaster)
+read!(scr::AbstractRasterSeries, dst::AbstractRasterSeries)

read! will copy the data from src to the object dst.

src can be an object or a file-path String.

source

Base.read Method
julia
read(A::AbstractRaster)
 read(A::AbstractRasterStack)
-read(A::AbstractRasterSeries)

read will move a Rasters.jl object completely to memory.

Keywords

  • checkmemory: If true (the default), check if there is enough memory for the operation. false will ignore memory needs.

source

Base.skipmissing Method
julia
skipmissing(itr::Raster)

Returns an iterable over the elements in a Raster object, skipping any values equal to either the missingval or missing.

source

Base.write Method
julia
Base.write(filepath::AbstractString, s::AbstractRasterSeries; kw...)

Write any AbstractRasterSeries to multiple files, guessing the backend from the file extension.

The lookup values of the series will be appended to the filepath (before the extension), separated by underscores.

All keywords are passed through to these Raster and RasterStack methods.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For series with RasterStack child objects, this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • vebose: whether to print messages about potential problems. true by default.

source

Base.write Method
julia
Base.write(filename::AbstractString, s::AbstractRasterStack; kw...)

Write any AbstractRasterStack to one or multiple files, depending on the backend. Backend is guessed from the filename extension or forced with the source keyword.

If the source can't be saved as a stack-like object, individual array layers will be saved.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For RasterStack this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • vebose: whether to print messages about potential problems. true by default.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

source

Base.write Method
julia
Base.write(filename::AbstractString, A::AbstractRaster; [source], kw...)

Write an AbstractRaster to file, guessing the backend from the file extension or using the source keyword.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

Returns filename.

source

Base.write Method
julia
Base.write(filename::AbstractString, ::Type{GRDsource}, s::AbstractRaster; kw...)

Write a Raster to a .grd file with a .gri header file.

This method is called automatically if you write a Raster with a .grd or .gri extension.

Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

If this method is called directly the extension of filename will be ignored.

Returns the base of filename with a .grd extension.

source

Rasters.checkmem! Method
julia
checkmem!(x::Bool)

Set checkmem to true or false.

In some architectures memory reporting may be wrong and you may wish to disable memory checks.

This setting can be overridden with the checkmem keyword, where applicable.

source

Rasters.rplot Method
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

- +read(A::AbstractRasterSeries)

read will move a Rasters.jl object completely to memory.

Keywords

  • checkmemory: If true (the default), check if there is enough memory for the operation. false will ignore memory needs.

source

Base.skipmissing Method
julia
skipmissing(itr::Raster)

Returns an iterable over the elements in a Raster object, skipping any values equal to either the missingval or missing.

source

Base.write Method
julia
Base.write(filepath::AbstractString, s::AbstractRasterSeries; kw...)

Write any AbstractRasterSeries to multiple files, guessing the backend from the file extension.

The lookup values of the series will be appended to the filepath (before the extension), separated by underscores.

All keywords are passed through to these Raster and RasterStack methods.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For series with RasterStack child objects, this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • vebose: whether to print messages about potential problems. true by default.

source

Base.write Method
julia
Base.write(filename::AbstractString, s::AbstractRasterStack; kw...)

Write any AbstractRasterStack to one or multiple files, depending on the backend. Backend is guessed from the filename extension or forced with the source keyword.

If the source can't be saved as a stack-like object, individual array layers will be saved.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For RasterStack this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • vebose: whether to print messages about potential problems. true by default.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

source

Base.write Method
julia
Base.write(filename::AbstractString, A::AbstractRaster; [source], kw...)

Write an AbstractRaster to file, guessing the backend from the file extension or using the source keyword.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

Returns filename.

source

Base.write Method
julia
Base.write(filename::AbstractString, ::Type{GRDsource}, s::AbstractRaster; kw...)

Write a Raster to a .grd file with a .gri header file.

This method is called automatically if you write a Raster with a .grd or .gri extension.

Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

If this method is called directly the extension of filename will be ignored.

Returns the base of filename with a .grd extension.

source

Rasters.checkmem! Method
julia
checkmem!(x::Bool)

Set checkmem to true or false.

In some architectures memory reporting may be wrong and you may wish to disable memory checks.

This setting can be overridden with the checkmem keyword, where applicable.

source

Rasters.rplot Method
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

+ \ No newline at end of file diff --git a/previews/PR800/array_operations.html b/previews/PR800/array_operations.html index 14a8a9f1..1ef4fdc4 100644 --- a/previews/PR800/array_operations.html +++ b/previews/PR800/array_operations.html @@ -8,9 +8,9 @@ - + - + @@ -159,7 +159,7 @@ -180.0 -3.4f38 -3.4f38 -3.4f38 -3.4f38 -15.399 -13.805 -14.046 ⋮ ⋱ ⋮ 179.833 -3.4f38 -3.4f38 -3.4f38 -3.4f38 … -17.1478 -15.4243 -15.701

setcrs(A, crs) and setmappedcrs(A, crs) will set the crs value/s of an object to any GeoFormat from GeoFormatTypes.jl.

- + \ No newline at end of file diff --git a/previews/PR800/assets/tzgtvbi.CVxd1wxn.png b/previews/PR800/assets/aaheudt.CVxd1wxn.png similarity index 100% rename from previews/PR800/assets/tzgtvbi.CVxd1wxn.png rename to previews/PR800/assets/aaheudt.CVxd1wxn.png diff --git a/previews/PR800/assets/api.md.CT61Ntce.js b/previews/PR800/assets/api.md.B3FoRFRA.js similarity index 97% rename from previews/PR800/assets/api.md.CT61Ntce.js rename to previews/PR800/assets/api.md.B3FoRFRA.js index dbeca3f3..bcd76fa5 100644 --- a/previews/PR800/assets/api.md.CT61Ntce.js +++ b/previews/PR800/assets/api.md.B3FoRFRA.js @@ -1,20 +1,20 @@ -import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/framework.Gz-llJN4.js";const h="/Rasters.jl/previews/PR800/assets/aggregate_example.vPDkaGne.png",d="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",k="/Rasters.jl/previews/PR800/assets/classify_example.CA_6ItEA.png",c="/Rasters.jl/previews/PR800/assets/classify_bang_example.Ch0DZvbI.png",g="/Rasters.jl/previews/PR800/assets/nz_crop_example.CeBIxUDy.png",y="/Rasters.jl/previews/PR800/assets/argentina_crop_example.DlKBBk5m.png",E="/Rasters.jl/previews/PR800/assets/extend_example.DNJ4wwKN.png",u="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",m="/Rasters.jl/previews/PR800/assets/mosaic_bang_example.ptHNiUCT.png",b="/Rasters.jl/previews/PR800/assets/mosaic_example_africa.Dpr9JnNl.png",F="/Rasters.jl/previews/PR800/assets/mosaic_example_aus.3EfcKnQU.png",f="/Rasters.jl/previews/PR800/assets/mosaic_example_combined.XY5Q_nfP.png",C="/Rasters.jl/previews/PR800/assets/china_rasterized.kM95Jnlf.png",A="/Rasters.jl/previews/PR800/assets/indonesia_rasterized.CAASrLmh.png",R="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",v="/Rasters.jl/previews/PR800/assets/resample_example_after.C_gavhhT.png",D="/Rasters.jl/previews/PR800/assets/trim_example_before.B583SoP8.png",j="/Rasters.jl/previews/PR800/assets/trim_example_after.CsDpPakV.png",B="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",w="/Rasters.jl/previews/PR800/assets/warp_example_after.rgHHAHxc.png",Ys=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"api.md","filePath":"api.md","lastUpdated":null}'),x={name:"api.md"},T={class:"jldocstring custom-block",open:""},S={class:"jldocstring custom-block",open:""},q={class:"jldocstring custom-block",open:""},L={class:"jldocstring custom-block",open:""},I={class:"jldocstring custom-block",open:""},z={class:"jldocstring custom-block",open:""},P={class:"jldocstring custom-block",open:""},G={class:"jldocstring custom-block",open:""},N={class:"jldocstring custom-block",open:""},O={class:"jldocstring custom-block",open:""},M={class:"jldocstring custom-block",open:""},_={class:"jldocstring custom-block",open:""},U={class:"jldocstring custom-block",open:""},W={class:"jldocstring custom-block",open:""},K={class:"jldocstring custom-block",open:""},V={class:"jldocstring custom-block",open:""},X={class:"jldocstring custom-block",open:""},Y={class:"jldocstring custom-block",open:""},H={class:"jldocstring custom-block",open:""},J={class:"jldocstring custom-block",open:""},Z={class:"jldocstring custom-block",open:""},$={class:"jldocstring custom-block",open:""},Q={class:"jldocstring custom-block",open:""},ss={class:"jldocstring custom-block",open:""},is={class:"jldocstring custom-block",open:""},es={class:"jldocstring custom-block",open:""},as={class:"jldocstring custom-block",open:""},ts={class:"jldocstring custom-block",open:""},ns={class:"jldocstring custom-block",open:""},ls={class:"jldocstring custom-block",open:""},ps={class:"jldocstring custom-block",open:""},os={class:"jldocstring custom-block",open:""},rs={class:"jldocstring custom-block",open:""},hs={class:"jldocstring custom-block",open:""},ds={class:"jldocstring custom-block",open:""},ks={class:"jldocstring custom-block",open:""},cs={class:"jldocstring custom-block",open:""},gs={class:"jldocstring custom-block",open:""},ys={class:"jldocstring custom-block",open:""},Es={class:"jldocstring custom-block",open:""},us={class:"jldocstring custom-block",open:""},ms={class:"jldocstring custom-block",open:""},bs={class:"jldocstring custom-block",open:""},Fs={class:"jldocstring custom-block",open:""},fs={class:"jldocstring custom-block",open:""},Cs={class:"jldocstring custom-block",open:""},As={class:"jldocstring custom-block",open:""},Rs={class:"jldocstring custom-block",open:""},vs={class:"jldocstring custom-block",open:""},Ds={class:"jldocstring custom-block",open:""},js={class:"jldocstring custom-block",open:""},Bs={class:"jldocstring custom-block",open:""},ws={class:"jldocstring custom-block",open:""},xs={class:"jldocstring custom-block",open:""},Ts={class:"jldocstring custom-block",open:""},Ss={class:"jldocstring custom-block",open:""},qs={class:"jldocstring custom-block",open:""},Ls={class:"jldocstring custom-block",open:""},Is={class:"jldocstring custom-block",open:""},zs={class:"jldocstring custom-block",open:""},Ps={class:"jldocstring custom-block",open:""},Gs={class:"jldocstring custom-block",open:""},Ns={class:"jldocstring custom-block",open:""},Os={class:"jldocstring custom-block",open:""};function Ms(_s,s,Us,Ws,Ks,Vs){const a=o("Badge");return r(),p("div",null,[s[192]||(s[192]=t('

Index

Reference - Exported functions

',3)),i("details",T,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.Rasters",href:"#Rasters.Rasters"},[i("span",{class:"jlbinding"},"Rasters.Rasters")],-1)),s[1]||(s[1]=e()),n(a,{type:"info",class:"jlObjectType jlModule",text:"Module"})]),s[2]||(s[2]=i("p",null,[i("a",{href:"https://github.com/rafaqz/Rasters.jl/blob/672d88bb8d5b789f6979754e2208f7a272b46e56/src/Rasters.jl#L4",target:"_blank",rel:"noreferrer"},"source")],-1))]),i("details",S,[i("summary",null,[s[3]||(s[3]=i("a",{id:"Rasters.AbstractRaster",href:"#Rasters.AbstractRaster"},[i("span",{class:"jlbinding"},"Rasters.AbstractRaster")],-1)),s[4]||(s[4]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[5]||(s[5]=t('
julia
AbstractRaster <: DimensionalData.AbstractDimArray

Abstract supertype for objects that wrap an array (or location of an array) and metadata about its contents. It may be memory or hold a FileArray, which holds the filename, and is only opened when required.

AbstractRasters inherit from AbstractDimArray from DimensionalData.jl. They can be indexed as regular Julia arrays or with DimensionalData.jl Dimensions. They will plot as a heatmap in Plots.jl with correct coordinates and labels, even after slicing with getindex or view. getindex on a AbstractRaster will always return a memory-backed Raster.

source

',4))]),i("details",q,[i("summary",null,[s[6]||(s[6]=i("a",{id:"Rasters.AbstractRasterSeries",href:"#Rasters.AbstractRasterSeries"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterSeries")],-1)),s[7]||(s[7]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[8]||(s[8]=t('
julia
AbstractRasterSeries <: DimensionalData.AbstractDimensionalArray

Abstract supertype for high-level DimensionalArray that hold RasterStacks, Rasters, or the paths they can be loaded from. RasterSeries are indexed with dimensions as with a AbstractRaster. This is useful when you have multiple files containing rasters or stacks of rasters spread over dimensions like time and elevation.

As much as possible, implementations should facilitate loading entire directories and detecting the dimensions from metadata.

This allows syntax like below for a series of stacks of arrays:

julia
RasterSeries[Time(Near(DateTime(2001, 1))][:temp][Y(Between(70, 150)), X(Between(-20,20))] |> plot`

RasterSeries is the concrete implementation.

source

',7))]),i("details",L,[i("summary",null,[s[9]||(s[9]=i("a",{id:"Rasters.AbstractRasterStack",href:"#Rasters.AbstractRasterStack"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterStack")],-1)),s[10]||(s[10]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[11]||(s[11]=t('
julia
AbstractRasterStack

Abstract supertype for objects that hold multiple AbstractRasters that share spatial dimensions.

They are NamedTuple-like structures that may either contain NamedTuple of AbstractRasters, string paths that will load AbstractRasters, or a single path that points to a file containing multiple layers, like NetCDF or HDF5. Use and syntax is similar or identical for all cases.

AbstractRasterStack can hold layers that share some or all of their dimensions. They cannot have the same dimension with different length or spatial extent as another layer.

getindex on an AbstractRasterStack generally returns a memory backed standard Raster. raster[:somelayer] |> plot plots the layers array, while raster[:somelayer, X(1:100), Band(2)] |> plot will plot the subset without loading the whole array.

getindex on an AbstractRasterStack with a key returns another stack with getindex applied to all the arrays in the stack.

source

',7))]),i("details",I,[i("summary",null,[s[12]||(s[12]=i("a",{id:"Rasters.Band",href:"#Rasters.Band"},[i("span",{class:"jlbinding"},"Rasters.Band")],-1)),s[13]||(s[13]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[14]||(s[14]=t(`
julia
Band <: Dimension
+import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/framework.Gz-llJN4.js";const h="/Rasters.jl/previews/PR800/assets/aggregate_example.vPDkaGne.png",d="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",k="/Rasters.jl/previews/PR800/assets/classify_example.CA_6ItEA.png",c="/Rasters.jl/previews/PR800/assets/classify_bang_example.Ch0DZvbI.png",g="/Rasters.jl/previews/PR800/assets/nz_crop_example.CeBIxUDy.png",y="/Rasters.jl/previews/PR800/assets/argentina_crop_example.DlKBBk5m.png",E="/Rasters.jl/previews/PR800/assets/extend_example.DNJ4wwKN.png",u="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",m="/Rasters.jl/previews/PR800/assets/mosaic_bang_example.ptHNiUCT.png",b="/Rasters.jl/previews/PR800/assets/mosaic_example_africa.Dpr9JnNl.png",F="/Rasters.jl/previews/PR800/assets/mosaic_example_aus.3EfcKnQU.png",f="/Rasters.jl/previews/PR800/assets/mosaic_example_combined.XY5Q_nfP.png",C="/Rasters.jl/previews/PR800/assets/china_rasterized.kM95Jnlf.png",A="/Rasters.jl/previews/PR800/assets/indonesia_rasterized.CAASrLmh.png",R="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",v="/Rasters.jl/previews/PR800/assets/resample_example_after.C_gavhhT.png",D="/Rasters.jl/previews/PR800/assets/trim_example_before.B583SoP8.png",j="/Rasters.jl/previews/PR800/assets/trim_example_after.CsDpPakV.png",B="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",w="/Rasters.jl/previews/PR800/assets/warp_example_after.rgHHAHxc.png",Ys=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"api.md","filePath":"api.md","lastUpdated":null}'),x={name:"api.md"},T={class:"jldocstring custom-block",open:""},S={class:"jldocstring custom-block",open:""},q={class:"jldocstring custom-block",open:""},L={class:"jldocstring custom-block",open:""},I={class:"jldocstring custom-block",open:""},z={class:"jldocstring custom-block",open:""},P={class:"jldocstring custom-block",open:""},G={class:"jldocstring custom-block",open:""},N={class:"jldocstring custom-block",open:""},O={class:"jldocstring custom-block",open:""},M={class:"jldocstring custom-block",open:""},_={class:"jldocstring custom-block",open:""},U={class:"jldocstring custom-block",open:""},W={class:"jldocstring custom-block",open:""},K={class:"jldocstring custom-block",open:""},V={class:"jldocstring custom-block",open:""},X={class:"jldocstring custom-block",open:""},Y={class:"jldocstring custom-block",open:""},H={class:"jldocstring custom-block",open:""},J={class:"jldocstring custom-block",open:""},Z={class:"jldocstring custom-block",open:""},$={class:"jldocstring custom-block",open:""},Q={class:"jldocstring custom-block",open:""},ss={class:"jldocstring custom-block",open:""},is={class:"jldocstring custom-block",open:""},es={class:"jldocstring custom-block",open:""},as={class:"jldocstring custom-block",open:""},ts={class:"jldocstring custom-block",open:""},ns={class:"jldocstring custom-block",open:""},ls={class:"jldocstring custom-block",open:""},ps={class:"jldocstring custom-block",open:""},os={class:"jldocstring custom-block",open:""},rs={class:"jldocstring custom-block",open:""},hs={class:"jldocstring custom-block",open:""},ds={class:"jldocstring custom-block",open:""},ks={class:"jldocstring custom-block",open:""},cs={class:"jldocstring custom-block",open:""},gs={class:"jldocstring custom-block",open:""},ys={class:"jldocstring custom-block",open:""},Es={class:"jldocstring custom-block",open:""},us={class:"jldocstring custom-block",open:""},ms={class:"jldocstring custom-block",open:""},bs={class:"jldocstring custom-block",open:""},Fs={class:"jldocstring custom-block",open:""},fs={class:"jldocstring custom-block",open:""},Cs={class:"jldocstring custom-block",open:""},As={class:"jldocstring custom-block",open:""},Rs={class:"jldocstring custom-block",open:""},vs={class:"jldocstring custom-block",open:""},Ds={class:"jldocstring custom-block",open:""},js={class:"jldocstring custom-block",open:""},Bs={class:"jldocstring custom-block",open:""},ws={class:"jldocstring custom-block",open:""},xs={class:"jldocstring custom-block",open:""},Ts={class:"jldocstring custom-block",open:""},Ss={class:"jldocstring custom-block",open:""},qs={class:"jldocstring custom-block",open:""},Ls={class:"jldocstring custom-block",open:""},Is={class:"jldocstring custom-block",open:""},zs={class:"jldocstring custom-block",open:""},Ps={class:"jldocstring custom-block",open:""},Gs={class:"jldocstring custom-block",open:""},Ns={class:"jldocstring custom-block",open:""},Os={class:"jldocstring custom-block",open:""};function Ms(_s,s,Us,Ws,Ks,Vs){const a=o("Badge");return r(),p("div",null,[s[192]||(s[192]=t('

Index

Reference - Exported functions

',3)),i("details",T,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.Rasters",href:"#Rasters.Rasters"},[i("span",{class:"jlbinding"},"Rasters.Rasters")],-1)),s[1]||(s[1]=e()),n(a,{type:"info",class:"jlObjectType jlModule",text:"Module"})]),s[2]||(s[2]=i("p",null,[i("a",{href:"https://github.com/rafaqz/Rasters.jl/blob/b3c3587fcb848f8d88fae337a6c7e0804c081eb3/src/Rasters.jl#L4",target:"_blank",rel:"noreferrer"},"source")],-1))]),i("details",S,[i("summary",null,[s[3]||(s[3]=i("a",{id:"Rasters.AbstractRaster",href:"#Rasters.AbstractRaster"},[i("span",{class:"jlbinding"},"Rasters.AbstractRaster")],-1)),s[4]||(s[4]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[5]||(s[5]=t('
julia
AbstractRaster <: DimensionalData.AbstractDimArray

Abstract supertype for objects that wrap an array (or location of an array) and metadata about its contents. It may be memory or hold a FileArray, which holds the filename, and is only opened when required.

AbstractRasters inherit from AbstractDimArray from DimensionalData.jl. They can be indexed as regular Julia arrays or with DimensionalData.jl Dimensions. They will plot as a heatmap in Plots.jl with correct coordinates and labels, even after slicing with getindex or view. getindex on a AbstractRaster will always return a memory-backed Raster.

source

',4))]),i("details",q,[i("summary",null,[s[6]||(s[6]=i("a",{id:"Rasters.AbstractRasterSeries",href:"#Rasters.AbstractRasterSeries"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterSeries")],-1)),s[7]||(s[7]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[8]||(s[8]=t('
julia
AbstractRasterSeries <: DimensionalData.AbstractDimensionalArray

Abstract supertype for high-level DimensionalArray that hold RasterStacks, Rasters, or the paths they can be loaded from. RasterSeries are indexed with dimensions as with a AbstractRaster. This is useful when you have multiple files containing rasters or stacks of rasters spread over dimensions like time and elevation.

As much as possible, implementations should facilitate loading entire directories and detecting the dimensions from metadata.

This allows syntax like below for a series of stacks of arrays:

julia
RasterSeries[Time(Near(DateTime(2001, 1))][:temp][Y(Between(70, 150)), X(Between(-20,20))] |> plot`

RasterSeries is the concrete implementation.

source

',7))]),i("details",L,[i("summary",null,[s[9]||(s[9]=i("a",{id:"Rasters.AbstractRasterStack",href:"#Rasters.AbstractRasterStack"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterStack")],-1)),s[10]||(s[10]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[11]||(s[11]=t('
julia
AbstractRasterStack

Abstract supertype for objects that hold multiple AbstractRasters that share spatial dimensions.

They are NamedTuple-like structures that may either contain NamedTuple of AbstractRasters, string paths that will load AbstractRasters, or a single path that points to a file containing multiple layers, like NetCDF or HDF5. Use and syntax is similar or identical for all cases.

AbstractRasterStack can hold layers that share some or all of their dimensions. They cannot have the same dimension with different length or spatial extent as another layer.

getindex on an AbstractRasterStack generally returns a memory backed standard Raster. raster[:somelayer] |> plot plots the layers array, while raster[:somelayer, X(1:100), Band(2)] |> plot will plot the subset without loading the whole array.

getindex on an AbstractRasterStack with a key returns another stack with getindex applied to all the arrays in the stack.

source

',7))]),i("details",I,[i("summary",null,[s[12]||(s[12]=i("a",{id:"Rasters.Band",href:"#Rasters.Band"},[i("span",{class:"jlbinding"},"Rasters.Band")],-1)),s[13]||(s[13]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[14]||(s[14]=t(`
julia
Band <: Dimension
 
 Band(val=:)

Band Dimension for multi-band rasters.

Example:

julia
banddim = Band(10:10:100)
 # Or
 val = A[Band(1)]
 # Or
-mean(A; dims=Band)

source

`,5))]),i("details",z,[i("summary",null,[s[15]||(s[15]=i("a",{id:"Rasters.Mapped",href:"#Rasters.Mapped"},[i("span",{class:"jlbinding"},"Rasters.Mapped")],-1)),s[16]||(s[16]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[17]||(s[17]=t(`
julia
Mapped <: AbstractProjected
+mean(A; dims=Band)

source

`,5))]),i("details",z,[i("summary",null,[s[15]||(s[15]=i("a",{id:"Rasters.Mapped",href:"#Rasters.Mapped"},[i("span",{class:"jlbinding"},"Rasters.Mapped")],-1)),s[16]||(s[16]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[17]||(s[17]=t(`
julia
Mapped <: AbstractProjected
 
 Mapped(order, span, sampling, crs, mappedcrs)
-Mapped(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs=nothing, mappedcrs)

An AbstractSampled Lookup, where the dimension index has been mapped to another projection, usually lat/lon or EPSG(4326). Mapped matches the dimension format commonly used in netcdf files.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

The mapped dimension index will be used as for Sampled, but to save in another format the underlying crs may be used to convert it.

source

`,5))]),i("details",P,[i("summary",null,[s[18]||(s[18]=i("a",{id:"Rasters.Projected",href:"#Rasters.Projected"},[i("span",{class:"jlbinding"},"Rasters.Projected")],-1)),s[19]||(s[19]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[20]||(s[20]=t(`
julia
Projected <: AbstractProjected
+Mapped(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs=nothing, mappedcrs)

An AbstractSampled Lookup, where the dimension index has been mapped to another projection, usually lat/lon or EPSG(4326). Mapped matches the dimension format commonly used in netcdf files.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

The mapped dimension index will be used as for Sampled, but to save in another format the underlying crs may be used to convert it.

source

`,5))]),i("details",P,[i("summary",null,[s[18]||(s[18]=i("a",{id:"Rasters.Projected",href:"#Rasters.Projected"},[i("span",{class:"jlbinding"},"Rasters.Projected")],-1)),s[19]||(s[19]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[20]||(s[20]=t(`
julia
Projected <: AbstractProjected
 
 Projected(order, span, sampling, crs, mappedcrs)
-Projected(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs, mappedcrs=nothing)

An AbstractSampled Lookup with projections attached.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

If both crs and mappedcrs fields contain CRS data (in a GeoFormat wrapper from GeoFormatTypes.jl) the selector inputs and plot axes will be converted from and to the specified mappedcrs projection automatically. A common use case would be to pass mappedcrs=EPSG(4326) to the constructor when loading eg. a GDALarray:

julia
GDALarray(filename; mappedcrs=EPSG(4326))

The underlying crs will be detected by GDAL.

If mappedcrs is not supplied (ie. mappedcrs=nothing), the base index will be shown on plots, and selectors will need to use whatever format it is in.

source

`,8))]),i("details",G,[i("summary",null,[s[21]||(s[21]=i("a",{id:"Rasters.Raster",href:"#Rasters.Raster"},[i("span",{class:"jlbinding"},"Rasters.Raster")],-1)),s[22]||(s[22]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[23]||(s[23]=t(`
julia
Raster <: AbstractRaster
+Projected(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs, mappedcrs=nothing)

An AbstractSampled Lookup with projections attached.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

If both crs and mappedcrs fields contain CRS data (in a GeoFormat wrapper from GeoFormatTypes.jl) the selector inputs and plot axes will be converted from and to the specified mappedcrs projection automatically. A common use case would be to pass mappedcrs=EPSG(4326) to the constructor when loading eg. a GDALarray:

julia
GDALarray(filename; mappedcrs=EPSG(4326))

The underlying crs will be detected by GDAL.

If mappedcrs is not supplied (ie. mappedcrs=nothing), the base index will be shown on plots, and selectors will need to use whatever format it is in.

source

`,8))]),i("details",G,[i("summary",null,[s[21]||(s[21]=i("a",{id:"Rasters.Raster",href:"#Rasters.Raster"},[i("span",{class:"jlbinding"},"Rasters.Raster")],-1)),s[22]||(s[22]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[23]||(s[23]=t(`
julia
Raster <: AbstractRaster
 
 Raster(filepath::String; kw...)
 Raster(A::AbstractDimArray; kw...)
-Raster(A::AbstractArray, dims; kw...)

A generic AbstractRaster for spatial/raster array data. It can hold either memory-backed arrays or, if lazy=true, a FileArray, which stores the String path to an unopened file.

If lazy=true, the file will only be opened lazily when it is indexed with getindex or when read(A) is called. Broadcasting, taking a view, reversing, and most other methods will not load data from disk; they will be applied later, lazily.

Arguments

  • dims: Tuple of Dimensions needed when an AbstractArray is used.

Keywords

  • name: a Symbol name for the array, which will also retrieve the, alphabetically first, named layer if Raster is used on a multi-layered file like a NetCDF. If instead RasterStack is used to read the multi-layered file, by default, all variables will be added to the stack.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • missingval: value reprsenting missing data, normally detected from the file. Set manually when you know the value is not specified or is incorrect. This will not change any values in the raster, it simply assigns which value is treated as missing. To replace all of the missing values in the raster, use replace_missing.

  • metadata: Dict or Metadata object for the array, or NoMetadata().

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of position Dimensions the array was sliced from, defaulting to (). Usually not needed.

When a filepath String is used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • write: defines the default write keyword value when calling open on the Raster. false by default. Only makes sense to use when lazy=true.

When A is an AbstractDimArray:

  • data: can replace the data in an existing AbstractRaster

source

`,12))]),i("details",N,[i("summary",null,[s[24]||(s[24]=i("a",{id:"Rasters.RasterSeries",href:"#Rasters.RasterSeries"},[i("span",{class:"jlbinding"},"Rasters.RasterSeries")],-1)),s[25]||(s[25]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[26]||(s[26]=t(`
julia
RasterSeries <: AbstractRasterSeries
+Raster(A::AbstractArray, dims; kw...)

A generic AbstractRaster for spatial/raster array data. It can hold either memory-backed arrays or, if lazy=true, a FileArray, which stores the String path to an unopened file.

If lazy=true, the file will only be opened lazily when it is indexed with getindex or when read(A) is called. Broadcasting, taking a view, reversing, and most other methods will not load data from disk; they will be applied later, lazily.

Arguments

  • dims: Tuple of Dimensions needed when an AbstractArray is used.

Keywords

  • name: a Symbol name for the array, which will also retrieve the, alphabetically first, named layer if Raster is used on a multi-layered file like a NetCDF. If instead RasterStack is used to read the multi-layered file, by default, all variables will be added to the stack.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • missingval: value reprsenting missing data, normally detected from the file. Set manually when you know the value is not specified or is incorrect. This will not change any values in the raster, it simply assigns which value is treated as missing. To replace all of the missing values in the raster, use replace_missing.

  • metadata: Dict or Metadata object for the array, or NoMetadata().

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of position Dimensions the array was sliced from, defaulting to (). Usually not needed.

When a filepath String is used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • write: defines the default write keyword value when calling open on the Raster. false by default. Only makes sense to use when lazy=true.

When A is an AbstractDimArray:

  • data: can replace the data in an existing AbstractRaster

source

`,12))]),i("details",N,[i("summary",null,[s[24]||(s[24]=i("a",{id:"Rasters.RasterSeries",href:"#Rasters.RasterSeries"},[i("span",{class:"jlbinding"},"Rasters.RasterSeries")],-1)),s[25]||(s[25]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[26]||(s[26]=t(`
julia
RasterSeries <: AbstractRasterSeries
 
 RasterSeries(rasters::AbstractArray{<:AbstractRaster}, dims; [refdims])
 RasterSeries(stacks::AbstractArray{<:AbstractRasterStack}, dims; [refdims]) 
@@ -25,7 +25,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 2-element RasterSeries{Raster,1} with dimensions: 
   Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

The DateTime suffix is parsed from the filenames. Using Ti(Int) would try to parse integers instead.

Just using the directory will also work, unless there are other files mixed in it:

julia
julia> ser = RasterSeries("series_dir", Ti(DateTime))
 2-element RasterSeries{Raster,1} with dimensions: 
-  Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

Arguments

  • dims: series dimension/s.

Keywords

When loading a series from a Vector of String paths or a single String path:

  • child: constructor of child objects for use when filenames are passed in, can be Raster or RasterStack. Defaults to Raster.

  • duplicate_first::Bool: wether to duplicate the dimensions and metadata of the first file with all other files. This can save load time with a large series where dimensions are identical. false by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • kw: keywords passed to the child constructor Raster or RasterStack.

When loading a series from a single String path:

  • separator: separator used to split lookup elements from the rest of a filename. '_' by default.

Others:

  • refdims: existing reference dimension/s, normally not required.

source

`,22))]),i("details",O,[i("summary",null,[s[27]||(s[27]=i("a",{id:"Rasters.RasterStack",href:"#Rasters.RasterStack"},[i("span",{class:"jlbinding"},"Rasters.RasterStack")],-1)),s[28]||(s[28]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[29]||(s[29]=t(`
julia
RasterStack <: AbstrackRasterStack
+  Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

Arguments

  • dims: series dimension/s.

Keywords

When loading a series from a Vector of String paths or a single String path:

  • child: constructor of child objects for use when filenames are passed in, can be Raster or RasterStack. Defaults to Raster.

  • duplicate_first::Bool: wether to duplicate the dimensions and metadata of the first file with all other files. This can save load time with a large series where dimensions are identical. false by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • kw: keywords passed to the child constructor Raster or RasterStack.

When loading a series from a single String path:

  • separator: separator used to split lookup elements from the rest of a filename. '_' by default.

Others:

  • refdims: existing reference dimension/s, normally not required.

source

`,22))]),i("details",O,[i("summary",null,[s[27]||(s[27]=i("a",{id:"Rasters.RasterStack",href:"#Rasters.RasterStack"},[i("span",{class:"jlbinding"},"Rasters.RasterStack")],-1)),s[28]||(s[28]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[29]||(s[29]=t(`
julia
RasterStack <: AbstrackRasterStack
 
 RasterStack(data...; name, kw...)
 RasterStack(data::Union{Vector,Tuple}; name, kw...)
@@ -34,14 +34,14 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 RasterStack(data::Raster; layersfrom=Band, kw...)
 RasterStack(filepath::AbstractString; kw...)

Load a file path or a NamedTuple of paths as a RasterStack, or convert arguments, a Vector or NamedTuple of Rasters to RasterStack.

Arguments

  • data: A NamedTuple of Rasters or String, or a Vector, Tuple or splatted arguments of Raster. The latter options must pass a name keyword argument.

  • filepath: A file (such as netcdf or tif) to be loaded as a stack, or a directory path containing multiple files.

Keywords

  • name: Used as stack layer names when a Tuple, Vector or splat of Raster is passed in. Has no effect when NameTuple is used - the NamedTuple keys are the layer names.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • metadata: A Dict or DimensionalData.Metadata object.

  • missingval: a single value for all layers or a NamedTuple of missingval for each layer. nothing specifies no missing value.

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of Dimension that the stack was sliced from.

For when one or multiple filepaths are used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

For when a single Raster is used:

  • layersfrom: Dimension to source stack layers from if the file is not already multi-layered. nothing is default, so that a single RasterStack(raster) is a single layered stack. RasterStack(raster; layersfrom=Band) will use the bands as layers.
julia
files = (temp="temp.tif", pressure="pressure.tif", relhum="relhum.tif")
 stack = RasterStack(files; mappedcrs=EPSG(4326))
-stack[:relhum][Lat(Contains(-37), Lon(Contains(144))

source

`,12))]),i("details",M,[i("summary",null,[s[30]||(s[30]=i("a",{id:"DimensionalData.modify-Tuple{Any, AbstractRasterSeries}",href:"#DimensionalData.modify-Tuple{Any, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"DimensionalData.modify")],-1)),s[31]||(s[31]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[32]||(s[32]=t('
julia
modify(f, series::AbstractRasterSeries)

Apply function f to the data of the child object. If the child is an AbstractRasterStack the function will be passed on to its child AbstractRasters.

f must return an identically sized array.

This method triggers a complete rebuild of all objects, and disk based objects will be transferred to memory.

An example of the usefulnesss of this is for swapping out array backend for an entire series to CuArray from CUDA.jl to copy data to a GPU.

source

',6))]),i("details",_,[i("summary",null,[s[33]||(s[33]=i("a",{id:"GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"GeoInterface.crs")],-1)),s[34]||(s[34]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[35]||(s[35]=t('
julia
crs(x::Raster)

Get the projected coordinate reference system of a Y or X Dimension, or of the Y/X dims of an AbstractRaster.

For Mapped lookup this may be nothing as there may be no projected coordinate reference system at all. See setcrs to set it manually.

source

',4))]),i("details",U,[i("summary",null,[s[36]||(s[36]=i("a",{id:"Rasters.aggregate",href:"#Rasters.aggregate"},[i("span",{class:"jlbinding"},"Rasters.aggregate")],-1)),s[37]||(s[37]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[38]||(s[38]=t(`
julia
aggregate(method, object, scale; filename, progress, skipmissing)

Aggregate a Raster, or all arrays in a RasterStack or RasterSeries, by scale using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that specifies where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • progress: show a progress bar, true by default, false to hide.

Example

julia
using Rasters, RasterDataSources, Statistics, Plots
+stack[:relhum][Lat(Contains(-37), Lon(Contains(144))

source

`,12))]),i("details",M,[i("summary",null,[s[30]||(s[30]=i("a",{id:"DimensionalData.modify-Tuple{Any, AbstractRasterSeries}",href:"#DimensionalData.modify-Tuple{Any, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"DimensionalData.modify")],-1)),s[31]||(s[31]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[32]||(s[32]=t('
julia
modify(f, series::AbstractRasterSeries)

Apply function f to the data of the child object. If the child is an AbstractRasterStack the function will be passed on to its child AbstractRasters.

f must return an identically sized array.

This method triggers a complete rebuild of all objects, and disk based objects will be transferred to memory.

An example of the usefulnesss of this is for swapping out array backend for an entire series to CuArray from CUDA.jl to copy data to a GPU.

source

',6))]),i("details",_,[i("summary",null,[s[33]||(s[33]=i("a",{id:"GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"GeoInterface.crs")],-1)),s[34]||(s[34]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[35]||(s[35]=t('
julia
crs(x::Raster)

Get the projected coordinate reference system of a Y or X Dimension, or of the Y/X dims of an AbstractRaster.

For Mapped lookup this may be nothing as there may be no projected coordinate reference system at all. See setcrs to set it manually.

source

',4))]),i("details",U,[i("summary",null,[s[36]||(s[36]=i("a",{id:"Rasters.aggregate",href:"#Rasters.aggregate"},[i("span",{class:"jlbinding"},"Rasters.aggregate")],-1)),s[37]||(s[37]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[38]||(s[38]=t(`
julia
aggregate(method, object, scale; filename, progress, skipmissing)

Aggregate a Raster, or all arrays in a RasterStack or RasterSeries, by scale using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that specifies where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • progress: show a progress bar, true by default, false to hide.

Example

julia
using Rasters, RasterDataSources, Statistics, Plots
 import ArchGDAL
 using Rasters: Center
 st = read(RasterStack(WorldClim{Climate}; month=1))
 ag = aggregate(Center(), st, (Y(20), X(20)); skipmissingval=true, progress=false)
 plot(ag)
 savefig("build/aggregate_example.png"); nothing
-# output

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',12))]),i("details",W,[i("summary",null,[s[39]||(s[39]=i("a",{id:"Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.aggregate!")],-1)),s[40]||(s[40]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[41]||(s[41]=t('
julia
aggregate!(method, dst::AbstractRaster, src::AbstractRaster, scale; skipmissingval=false)

Aggregate array src to array dst by scale, using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • progress: show a progress bar.

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

Note: currently it is much faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',9))]),i("details",K,[i("summary",null,[s[42]||(s[42]=i("a",{id:"Rasters.boolmask",href:"#Rasters.boolmask"},[i("span",{class:"jlbinding"},"Rasters.boolmask")],-1)),s[43]||(s[43]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[44]||(s[44]=t(`
julia
boolmask(obj::Raster; [missingval])
+# output

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',12))]),i("details",W,[i("summary",null,[s[39]||(s[39]=i("a",{id:"Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.aggregate!")],-1)),s[40]||(s[40]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[41]||(s[41]=t('
julia
aggregate!(method, dst::AbstractRaster, src::AbstractRaster, scale; skipmissingval=false)

Aggregate array src to array dst by scale, using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • progress: show a progress bar.

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

Note: currently it is much faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',9))]),i("details",K,[i("summary",null,[s[42]||(s[42]=i("a",{id:"Rasters.boolmask",href:"#Rasters.boolmask"},[i("span",{class:"jlbinding"},"Rasters.boolmask")],-1)),s[43]||(s[43]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[44]||(s[44]=t(`
julia
boolmask(obj::Raster; [missingval])
 boolmask(obj; [to, res, size])
 boolmask(obj::RasterStack; alllayers=true, kw...)

Create a mask array of Bool values, from another Raster. AbstractRasterStack or AbstractRasterSeries are also accepted.

The array returned from calling boolmask on a AbstractRaster is a Raster with the same dimensions as the original array and a missingval of false.

Arguments

  • a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Raster / RasterStack Keywords

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: The missing value of the source array, with default missingval(raster).

Keywords

  • alllayers: if true a mask is taken for all layers, otherwise only the first layer is used. Defaults to true

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

And specifically for shape=:polygon:

  • boundary: include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

For tabular data, feature collections and other iterables

  • collapse: if true, collapse all geometry masks into a single mask. Otherwise return a Raster with an additional geometry dimension, so that each slice along this axis is the mask of the geometry opbject of each row of the table, feature in the feature collection, or just each geometry in the iterable.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 wc = Raster(WorldClim{Climate}, :prec; month=1)
@@ -49,7 +49,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/boolmask_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",V,[i("summary",null,[s[45]||(s[45]=i("a",{id:"Rasters.cellarea-Tuple{Any}",href:"#Rasters.cellarea-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[46]||(s[46]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[47]||(s[47]=t(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",V,[i("summary",null,[s[45]||(s[45]=i("a",{id:"Rasters.cellarea-Tuple{Any}",href:"#Rasters.cellarea-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[46]||(s[46]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[47]||(s[47]=t(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
 xdim = X(Projected(90.0:10.0:120; sampling=Intervals(Start()), crs=EPSG(4326)))
 ydim = Y(Projected(0.0:10.0:50; sampling=Intervals(Start()), crs=EPSG(4326)))
 myraster = rand(xdim, ydim)
@@ -70,7 +70,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
   90.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  100.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  110.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
- 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),i("details",X,[i("summary",null,[s[48]||(s[48]=i("a",{id:"Rasters.classify",href:"#Rasters.classify"},[i("span",{class:"jlbinding"},"Rasters.classify")],-1)),s[49]||(s[49]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[50]||(s[50]=t(`
julia
classify(x, pairs; lower=(>=), upper=(<), others=nothing)
+ 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),i("details",X,[i("summary",null,[s[48]||(s[48]=i("a",{id:"Rasters.classify",href:"#Rasters.classify"},[i("span",{class:"jlbinding"},"Rasters.classify")],-1)),s[49]||(s[49]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[50]||(s[50]=t(`
julia
classify(x, pairs; lower=(>=), upper=(<), others=nothing)
 classify(x, pairs...; lower, upper, others)

Create a new array with values in x classified by the values in pairs.

pairs can hold tuples fo values (2, 3), a Fix2 function e.g. <=(1), a Tuple of Fix2 e.g. (>=(4), <(7)), or an IntervalSets.jl interval, e.g. 3..9 or OpenInterval(10, 12). pairs can also be a n * 3 matrix where each row is lower bounds, upper bounds, replacement.

If tuples or a Matrix are used, the lower and upper keywords define how the lower and upper boundaries are chosen.

If others is set other values not covered in pairs will be set to that values.

Arguments

  • x: a Raster or RasterStack

  • pairs: each pair contains a value and a replacement, a tuple of lower and upper range and a replacement, or a Tuple of Fix2 like (>(x), <(y).

Keywords

  • lower: Which comparison (< or <=) to use for lower values, if Fix2 are not used.

  • upper: Which comparison (> or >=) to use for upper values, if Fix2 are not used.

  • others: A value to assign to all values not included in pairs. Passing nothing (the default) will leave them unchanged.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{Climate}, :tavg; month=1)
 classes = <=(15) => 10,
@@ -82,7 +82,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/classify_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",Y,[i("summary",null,[s[51]||(s[51]=i("a",{id:"Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}",href:"#Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}"},[i("span",{class:"jlbinding"},"Rasters.classify!")],-1)),s[52]||(s[52]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[53]||(s[53]=t(`
julia
classify!(x, pairs...; lower, upper, others)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",Y,[i("summary",null,[s[51]||(s[51]=i("a",{id:"Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}",href:"#Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}"},[i("span",{class:"jlbinding"},"Rasters.classify!")],-1)),s[52]||(s[52]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[53]||(s[53]=t(`
julia
classify!(x, pairs...; lower, upper, others)
 classify!(x, pairs; lower, upper, others)

Classify the values of x in-place, by the values in pairs.

If Fix2 is not used, the lower and upper keywords

If others is set other values not covered in pairs will be set to that values.

Arguments

  • x: a Raster or RasterStack

  • pairs: each pair contains a value and a replacement, a tuple of lower and upper range and a replacement, or a Tuple of Fix2 like (>(x), <(y).

Keywords

  • lower: Which comparison (< or <=) to use for lower values, if Fix2 are not used.

  • upper: Which comparison (> or >=) to use for upper values, if Fix2 are not used.

  • others: A value to assign to all values not included in pairs. Passing nothing (the default) will leave them unchanged.

Example

classify! to disk, with key steps:

  • copying a tempory file so we don't write over the RasterDataSources.jl version.

  • use open with write=true to open the file with disk-write permissions.

  • use Float32 like 10.0f0 for all our replacement values and other, because the file is stored as Float32. Attempting to write some other type will fail.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 # Download and copy the file
 filename = getraster(WorldClim{Climate}, :tavg; month=6)
@@ -102,8 +102,8 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/classify_bang_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",H,[i("summary",null,[s[54]||(s[54]=i("a",{id:"Rasters.combine-Tuple{AbstractRasterSeries}",href:"#Rasters.combine-Tuple{AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Rasters.combine")],-1)),s[55]||(s[55]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[56]||(s[56]=t('
julia
combine(A::AbstracRasterSeries; [dims], [lazy]) => Raster

Combine a RasterSeries along some dimension/s, creating a new Raster or RasterStack, depending on the contents of the series.

If dims are passed, only the specified dimensions will be combined with a RasterSeries returned, unless dims is all the dims in the series.

If lazy, concatenate lazily. The default is to concatenate lazily for lazy Rasters and eagerly otherwise.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",J,[i("summary",null,[s[57]||(s[57]=i("a",{id:"Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}",href:"#Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}"},[i("span",{class:"jlbinding"},"Rasters.convertlookup")],-1)),s[58]||(s[58]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[59]||(s[59]=t('
julia
convertlookup(dstlookup::Type{<:Lookup}, x)

Convert the dimension lookup between Projected and Mapped. Other dimension lookups pass through unchanged.

This is used to e.g. save a netcdf file to GeoTiff.

source

',4))]),i("details",Z,[i("summary",null,[s[60]||(s[60]=i("a",{id:"Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}",href:"#Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage!")],-1)),s[61]||(s[61]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[62]||(s[62]=t('
julia
coverage!(A, geom; [mode, scale])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

source

',8))]),i("details",$,[i("summary",null,[s[63]||(s[63]=i("a",{id:"Rasters.coverage-Tuple{Any}",href:"#Rasters.coverage-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage")],-1)),s[64]||(s[64]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[65]||(s[65]=t(`
julia
coverage(mode, geom; [to, res, size, scale, verbose, progress])
-coverage(geom; [to, mode, res, size, scale, verbose, progress])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

source

`,8))]),i("details",Q,[i("summary",null,[s[66]||(s[66]=i("a",{id:"Rasters.crop",href:"#Rasters.crop"},[i("span",{class:"jlbinding"},"Rasters.crop")],-1)),s[67]||(s[67]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[68]||(s[68]=t(`
julia
crop(x; to, touches=false, [geometrycolumn])
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",H,[i("summary",null,[s[54]||(s[54]=i("a",{id:"Rasters.combine-Tuple{AbstractRasterSeries}",href:"#Rasters.combine-Tuple{AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Rasters.combine")],-1)),s[55]||(s[55]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[56]||(s[56]=t('
julia
combine(A::AbstracRasterSeries; [dims], [lazy]) => Raster

Combine a RasterSeries along some dimension/s, creating a new Raster or RasterStack, depending on the contents of the series.

If dims are passed, only the specified dimensions will be combined with a RasterSeries returned, unless dims is all the dims in the series.

If lazy, concatenate lazily. The default is to concatenate lazily for lazy Rasters and eagerly otherwise.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",J,[i("summary",null,[s[57]||(s[57]=i("a",{id:"Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}",href:"#Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}"},[i("span",{class:"jlbinding"},"Rasters.convertlookup")],-1)),s[58]||(s[58]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[59]||(s[59]=t('
julia
convertlookup(dstlookup::Type{<:Lookup}, x)

Convert the dimension lookup between Projected and Mapped. Other dimension lookups pass through unchanged.

This is used to e.g. save a netcdf file to GeoTiff.

source

',4))]),i("details",Z,[i("summary",null,[s[60]||(s[60]=i("a",{id:"Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}",href:"#Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage!")],-1)),s[61]||(s[61]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[62]||(s[62]=t('
julia
coverage!(A, geom; [mode, scale])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

source

',8))]),i("details",$,[i("summary",null,[s[63]||(s[63]=i("a",{id:"Rasters.coverage-Tuple{Any}",href:"#Rasters.coverage-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage")],-1)),s[64]||(s[64]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[65]||(s[65]=t(`
julia
coverage(mode, geom; [to, res, size, scale, verbose, progress])
+coverage(geom; [to, mode, res, size, scale, verbose, progress])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

source

`,8))]),i("details",Q,[i("summary",null,[s[66]||(s[66]=i("a",{id:"Rasters.crop",href:"#Rasters.crop"},[i("span",{class:"jlbinding"},"Rasters.crop")],-1)),s[67]||(s[67]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[68]||(s[68]=t(`
julia
crop(x; to, touches=false, [geometrycolumn])
 crop(xs...; to)

Crop one or multiple AbstractRaster or AbstractRasterStack x to match the size of the object to, or smallest of any dimensions that are shared.

crop is lazy, using a view into the object rather than allocating new memory.

Keywords

  • to: the object to crop to. This can be a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified. If no to keyword is passed, the smallest shared area of all xs is used.

  • touches: true or false. Whether to use Touches wraper on the object extent. When lines need to be included in e.g. zonal statistics, true should be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

As crop is lazy, filename and suffix keywords are not used.

Example

Crop to another raster:

julia
using Rasters, RasterDataSources, Plots
 evenness = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
 rnge = Raster(EarthEnv{HabitatHeterogeneity}, :range)
@@ -133,7 +133,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/argentina_crop_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",ss,[i("summary",null,[s[69]||(s[69]=i("a",{id:"Rasters.disaggregate",href:"#Rasters.disaggregate"},[i("span",{class:"jlbinding"},"Rasters.disaggregate")],-1)),s[70]||(s[70]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[71]||(s[71]=t('
julia
disaggregate(method, object, scale; filename, progress, keys)

Disaggregate array, or all arrays in a stack or series, by some scale.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or a Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

Keywords

  • progress: show a progress bar.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',8))]),i("details",is,[i("summary",null,[s[72]||(s[72]=i("a",{id:"Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.disaggregate!")],-1)),s[73]||(s[73]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[74]||(s[74]=t('
julia
disaggregate!(method, dst::AbstractRaster, src::AbstractRaster, filename, scale)

Disaggregate array src to array dst by some scale, using method.

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',5))]),i("details",es,[i("summary",null,[s[75]||(s[75]=i("a",{id:"Rasters.extend",href:"#Rasters.extend"},[i("span",{class:"jlbinding"},"Rasters.extend")],-1)),s[76]||(s[76]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[77]||(s[77]=t(`
julia
extend(xs...; [to])
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",ss,[i("summary",null,[s[69]||(s[69]=i("a",{id:"Rasters.disaggregate",href:"#Rasters.disaggregate"},[i("span",{class:"jlbinding"},"Rasters.disaggregate")],-1)),s[70]||(s[70]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[71]||(s[71]=t('
julia
disaggregate(method, object, scale; filename, progress, keys)

Disaggregate array, or all arrays in a stack or series, by some scale.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or a Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

Keywords

  • progress: show a progress bar.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',8))]),i("details",is,[i("summary",null,[s[72]||(s[72]=i("a",{id:"Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.disaggregate!")],-1)),s[73]||(s[73]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[74]||(s[74]=t('
julia
disaggregate!(method, dst::AbstractRaster, src::AbstractRaster, filename, scale)

Disaggregate array src to array dst by some scale, using method.

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',5))]),i("details",es,[i("summary",null,[s[75]||(s[75]=i("a",{id:"Rasters.extend",href:"#Rasters.extend"},[i("span",{class:"jlbinding"},"Rasters.extend")],-1)),s[76]||(s[76]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[77]||(s[77]=t(`
julia
extend(xs...; [to])
 extend(xs; [to])
 extend(x::Union{AbstractRaster,AbstractRasterStack}; to, kw...)

Extend one or multiple AbstractRaster to match the area covered by all xs, or by the keyword argument to.

Keywords

  • to: the Raster or dims to extend to. If no to keyword is passed, the largest shared area of all xs is used.

  • touches: true or false. Whether to use Touches wrapper on the object extent. When lines need to be included in e.g. zonal statistics, true shoudle be used.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

julia
using Rasters, RasterDataSources, Plots
 evenness = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
@@ -149,7 +149,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/extend_example.png")
 nothing
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',8))]),i("details",as,[i("summary",null,[s[78]||(s[78]=i("a",{id:"Rasters.extract",href:"#Rasters.extract"},[i("span",{class:"jlbinding"},"Rasters.extract")],-1)),s[79]||(s[79]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[80]||(s[80]=t(`
julia
extract(x, data; kw...)

Extracts the value of Raster or RasterStack at given points, returning an iterable of NamedTuple with properties for :geometry and raster or stack layer values.

Note that if objects have more dimensions than the length of the point tuples, sliced arrays or stacks will be returned instead of single values.

Arguments

  • x: a Raster or RasterStack to extract values from.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometry: include :geometry in returned NamedTuple, true by default.

  • index: include :index of the CartesianIndex in returned NamedTuple, false by default.

  • name: a Symbol or Tuple of Symbol corresponding to layer/s of a RasterStack to extract. All layers by default.

  • skipmissing: skip missing points automatically.

  • atol: a tolerance for floating point lookup values for when the Lookup contains Points. atol is ignored for Intervals.

geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Here we extract points matching the occurrence of the Mountain Pygmy Possum, Burramis parvus. This could be used to fit a species distribution model.

julia
using Rasters, RasterDataSources, ArchGDAL, GBIF2, CSV
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',8))]),i("details",as,[i("summary",null,[s[78]||(s[78]=i("a",{id:"Rasters.extract",href:"#Rasters.extract"},[i("span",{class:"jlbinding"},"Rasters.extract")],-1)),s[79]||(s[79]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[80]||(s[80]=t(`
julia
extract(x, data; kw...)

Extracts the value of Raster or RasterStack at given points, returning an iterable of NamedTuple with properties for :geometry and raster or stack layer values.

Note that if objects have more dimensions than the length of the point tuples, sliced arrays or stacks will be returned instead of single values.

Arguments

  • x: a Raster or RasterStack to extract values from.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometry: include :geometry in returned NamedTuple, true by default.

  • index: include :index of the CartesianIndex in returned NamedTuple, false by default.

  • name: a Symbol or Tuple of Symbol corresponding to layer/s of a RasterStack to extract. All layers by default.

  • skipmissing: skip missing points automatically.

  • atol: a tolerance for floating point lookup values for when the Lookup contains Points. atol is ignored for Intervals.

geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Here we extract points matching the occurrence of the Mountain Pygmy Possum, Burramis parvus. This could be used to fit a species distribution model.

julia
using Rasters, RasterDataSources, ArchGDAL, GBIF2, CSV
 
 # Get a stack of BioClim layers, and replace missing values with \`missing\`
 st = RasterStack(WorldClim{BioClim}, (1, 3, 5, 7, 12)) |> replace_missing
@@ -167,7 +167,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
  (geometry = (0.03, 39.97), bio1 = 17.076923f0, bio3 = 39.7983f0, bio5 = 29.638462f0, bio7 = 24.153847f0, bio12 = 441.0f0)
  (geometry = (0.03, 39.97), bio1 = 17.076923f0, bio3 = 39.7983f0, bio5 = 29.638462f0, bio7 = 24.153847f0, bio12 = 441.0f0)
  (geometry = (0.52, 40.37), bio1 = missing, bio3 = missing, bio5 = missing, bio7 = missing, bio12 = missing)
- (geometry = (0.32, 40.24), bio1 = 16.321388f0, bio3 = 41.659454f0, bio5 = 30.029825f0, bio7 = 25.544561f0, bio12 = 480.0f0)

Note: passing in arrays, geometry collections or feature collections containing a mix of points and other geometries has undefined results.

source

`,13))]),i("details",ts,[i("summary",null,[s[81]||(s[81]=i("a",{id:"Rasters.mappedbounds",href:"#Rasters.mappedbounds"},[i("span",{class:"jlbinding"},"Rasters.mappedbounds")],-1)),s[82]||(s[82]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[83]||(s[83]=t('
julia
mappedbounds(x)

Get the bounds converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular bounds.

source

',4))]),i("details",ns,[i("summary",null,[s[84]||(s[84]=i("a",{id:"Rasters.mappedcrs",href:"#Rasters.mappedcrs"},[i("span",{class:"jlbinding"},"Rasters.mappedcrs")],-1)),s[85]||(s[85]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[86]||(s[86]=t('
julia
mappedcrs(x)

Get the mapped coordinate reference system for the Y/X dims of an array.

In Projected lookup this is used to convert Selector values form the mappedcrs defined projection to the underlying projection, and to show plot axes in the mapped projection.

In Mapped lookup this is the coordinate reference system of the index values. See setmappedcrs to set it manually.

source

',5))]),i("details",ls,[i("summary",null,[s[87]||(s[87]=i("a",{id:"Rasters.mappedindex",href:"#Rasters.mappedindex"},[i("span",{class:"jlbinding"},"Rasters.mappedindex")],-1)),s[88]||(s[88]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[89]||(s[89]=t('
julia
mappedindex(x)

Get the index value of a dimension converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular dim value.

source

',4))]),i("details",ps,[i("summary",null,[s[90]||(s[90]=i("a",{id:"Rasters.mask!",href:"#Rasters.mask!"},[i("span",{class:"jlbinding"},"Rasters.mask!")],-1)),s[91]||(s[91]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[92]||(s[92]=t(`
julia
mask!(x; with, missingval=missingval(A))

Mask A by the missing values of with, or by all values outside with if it is a polygon.

If with is a polygon, creates a new array where points falling outside the polygon have been replaced by missingval(A).

Return a new array with values of A masked by the missing values of with, or by a polygon.

Arguments

  • x: a Raster or RasterStack.

Keywords

  • with: another AbstractRaster, a AbstractVector of Tuple points, or any GeoInterface.jl AbstractGeometry. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to write to A in masked areas, by default missingval(A).

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask to match the size and projection.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
+ (geometry = (0.32, 40.24), bio1 = 16.321388f0, bio3 = 41.659454f0, bio5 = 30.029825f0, bio7 = 25.544561f0, bio12 = 480.0f0)

Note: passing in arrays, geometry collections or feature collections containing a mix of points and other geometries has undefined results.

source

`,13))]),i("details",ts,[i("summary",null,[s[81]||(s[81]=i("a",{id:"Rasters.mappedbounds",href:"#Rasters.mappedbounds"},[i("span",{class:"jlbinding"},"Rasters.mappedbounds")],-1)),s[82]||(s[82]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[83]||(s[83]=t('
julia
mappedbounds(x)

Get the bounds converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular bounds.

source

',4))]),i("details",ns,[i("summary",null,[s[84]||(s[84]=i("a",{id:"Rasters.mappedcrs",href:"#Rasters.mappedcrs"},[i("span",{class:"jlbinding"},"Rasters.mappedcrs")],-1)),s[85]||(s[85]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[86]||(s[86]=t('
julia
mappedcrs(x)

Get the mapped coordinate reference system for the Y/X dims of an array.

In Projected lookup this is used to convert Selector values form the mappedcrs defined projection to the underlying projection, and to show plot axes in the mapped projection.

In Mapped lookup this is the coordinate reference system of the index values. See setmappedcrs to set it manually.

source

',5))]),i("details",ls,[i("summary",null,[s[87]||(s[87]=i("a",{id:"Rasters.mappedindex",href:"#Rasters.mappedindex"},[i("span",{class:"jlbinding"},"Rasters.mappedindex")],-1)),s[88]||(s[88]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[89]||(s[89]=t('
julia
mappedindex(x)

Get the index value of a dimension converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular dim value.

source

',4))]),i("details",ps,[i("summary",null,[s[90]||(s[90]=i("a",{id:"Rasters.mask!",href:"#Rasters.mask!"},[i("span",{class:"jlbinding"},"Rasters.mask!")],-1)),s[91]||(s[91]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[92]||(s[92]=t(`
julia
mask!(x; with, missingval=missingval(A))

Mask A by the missing values of with, or by all values outside with if it is a polygon.

If with is a polygon, creates a new array where points falling outside the polygon have been replaced by missingval(A).

Return a new array with values of A masked by the missing values of with, or by a polygon.

Arguments

  • x: a Raster or RasterStack.

Keywords

  • with: another AbstractRaster, a AbstractVector of Tuple points, or any GeoInterface.jl AbstractGeometry. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to write to A in masked areas, by default missingval(A).

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask to match the size and projection.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 
 # Load and plot the file
 awap = read(RasterStack(AWAP, (:tmin, :tmax); date=DateTime(2001, 1, 1)))
@@ -184,7 +184,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/mask_bang_example_before.png");
 savefig(b, "build/mask_bang_example_after.png"); nothing
 
-# output

Before mask!:

After mask!:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,15))]),i("details",os,[i("summary",null,[s[93]||(s[93]=i("a",{id:"Rasters.mask-Tuple{Any}",href:"#Rasters.mask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.mask")],-1)),s[94]||(s[94]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[95]||(s[95]=t(`
julia
mask(A:AbstractRaster; with, missingval=missingval(A))
+# output

Before mask!:

After mask!:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,15))]),i("details",os,[i("summary",null,[s[93]||(s[93]=i("a",{id:"Rasters.mask-Tuple{Any}",href:"#Rasters.mask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.mask")],-1)),s[94]||(s[94]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[95]||(s[95]=t(`
julia
mask(A:AbstractRaster; with, missingval=missingval(A))
 mask(x; with)

Return a new array with values of A masked by the missing values of with, or by the shape of with, if with is a geometric object.

Arguments

  • x: a Raster or RasterStack

Keywords

  • with: an AbstractRaster, or any GeoInterface.jl compatible objects or table. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to use in the returned file.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Geometry keywords

These can be used when with is a GeoInterface.jl compatible object:

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 
 # Load and plot the file
@@ -201,7 +201,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig(a, "build/mask_example_before.png");
 savefig(b, "build/mask_example_after.png"); nothing
-# output

Before mask:

After mask:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,16))]),i("details",rs,[i("summary",null,[s[96]||(s[96]=i("a",{id:"Rasters.missingmask-Tuple{Any}",href:"#Rasters.missingmask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.missingmask")],-1)),s[97]||(s[97]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[98]||(s[98]=t(`
julia
missingmask(obj::Raster; kw...)
+# output

Before mask:

After mask:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,16))]),i("details",rs,[i("summary",null,[s[96]||(s[96]=i("a",{id:"Rasters.missingmask-Tuple{Any}",href:"#Rasters.missingmask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.missingmask")],-1)),s[97]||(s[97]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[98]||(s[98]=t(`
julia
missingmask(obj::Raster; kw...)
 missingmask(obj; [to, res, size, collapse])
 missingmask(obj::RasterStack; alllayers = true, kw...)

Create a mask array of missing and true values, from another Raster. AbstractRasterStack or AbstractRasterSeries are also accepted-

For AbstractRaster the default missingval is missingval(A), but others can be chosen manually.

The array returned from calling missingmask on a AbstractRaster is a Raster with the same size and fields as the original array.

Arguments

  • obj: a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • alllayers: if true a mask is taken for all layers, otherwise only the first layer is used. Defaults to true

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 wc = Raster(WorldClim{Climate}, :prec; month=1)
@@ -209,7 +209,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/missingmask_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',13))]),i("details",hs,[i("summary",null,[s[99]||(s[99]=i("a",{id:"Rasters.missingval",href:"#Rasters.missingval"},[i("span",{class:"jlbinding"},"Rasters.missingval")],-1)),s[100]||(s[100]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[101]||(s[101]=t('
julia
missingval(x)

Returns the value representing missing data in the dataset

source

',3))]),i("details",ds,[i("summary",null,[s[102]||(s[102]=i("a",{id:"Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic!")],-1)),s[103]||(s[103]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[104]||(s[104]=t(`
julia
mosaic!(f, x, regions...; missingval, atol)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',13))]),i("details",hs,[i("summary",null,[s[99]||(s[99]=i("a",{id:"Rasters.missingval",href:"#Rasters.missingval"},[i("span",{class:"jlbinding"},"Rasters.missingval")],-1)),s[100]||(s[100]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[101]||(s[101]=t('
julia
missingval(x)

Returns the value representing missing data in the dataset

source

',3))]),i("details",ds,[i("summary",null,[s[102]||(s[102]=i("a",{id:"Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic!")],-1)),s[103]||(s[103]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[104]||(s[104]=t(`
julia
mosaic!(f, x, regions...; missingval, atol)
 mosaic!(f, x, regions::Tuple; missingval, atol)

Combine regions in x using the function f.

Arguments

  • f a function (e.g. mean, sum, first or last) that is applied to values where regions overlap.

  • x: A Raster or RasterStack. May be a an opened disk-based Raster, the result will be written to disk. With the current algorithm, the read speed is slow.

  • regions: source objects to be joined. These should be memory-backed (use read first), or may experience poor performance. If all objects have the same extent, mosaic is simply a merge.

Keywords

  • missingval: Fills empty areas, and defualts to the \`missingval/ of the first layer.

  • atol: Absolute tolerance for comparison between index values. This is often required due to minor differences in range values due to floating point error. It is not applied to non-float dimensions. A tuple of tolerances may be passed, matching the dimension order.

Example

Cut out Australia and Africa stacks, then combined them into a single stack.

julia
using Rasters, RasterDataSources, ArchGDAL, Statistics, Plots
 st = read(RasterStack(WorldClim{Climate}; month=1))
 aus = st[X=100.0 .. 160.0, Y=-50.0 .. -10.0]
@@ -218,7 +218,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 plot(st)
 savefig("build/mosaic_bang_example.png")
 nothing
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",ks,[i("summary",null,[s[105]||(s[105]=i("a",{id:"Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic")],-1)),s[106]||(s[106]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[107]||(s[107]=t(`
julia
mosaic(f, regions...; missingval, atol)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",ks,[i("summary",null,[s[105]||(s[105]=i("a",{id:"Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic")],-1)),s[106]||(s[106]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[107]||(s[107]=t(`
julia
mosaic(f, regions...; missingval, atol)
 mosaic(f, regions; missingval, atol)

Combine regions into a single raster.

Arguments

  • f: A reducing function (mean, sum, first, last etc.) for values where regions overlap.

  • regions: Iterable or splatted Raster or RasterStack.

Keywords

  • missingval: Fills empty areas, and defualts to the missingval of the first region.

  • atol: Absolute tolerance for comparison between index values. This is often required due to minor differences in range values due to floating point error. It is not applied to non-float dimensions. A tuple of tolerances may be passed, matching the dimension order.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

If your mosaic has has apparent line errors, increase the atol value.

Example

Here we cut out Australia and Africa from a stack, and join them with mosaic.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 st = RasterStack(WorldClim{Climate}; month=1);
 
@@ -236,7 +236,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(b, "build/mosaic_example_aus.png")
 savefig(c, "build/mosaic_example_combined.png")
 nothing
-# output

Individual continents

Mosaic of continents

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',17))]),i("details",cs,[i("summary",null,[s[108]||(s[108]=i("a",{id:"Rasters.points-Tuple{AbstractRaster}",href:"#Rasters.points-Tuple{AbstractRaster}"},[i("span",{class:"jlbinding"},"Rasters.points")],-1)),s[109]||(s[109]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[110]||(s[110]=t('
julia
points(A::AbstractRaster; dims=(YDim, XDim), ignore_missing) => Array{Tuple}

Returns a generator of the points in A for dimensions in dims, where points are a tuple of the values in each specified dimension index.

Keywords

  • dims the dimensions to return points from. The first slice of other layers will be used.

  • ignore_missing: wether to ignore missing values in the array when considering points. If true, all points in the dimensions will be returned, if false only the points that are not === missingval(A) will be returned.

The order of dims determines the order of the points.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',7))]),i("details",gs,[i("summary",null,[s[111]||(s[111]=i("a",{id:"Rasters.rasterize",href:"#Rasters.rasterize"},[i("span",{class:"jlbinding"},"Rasters.rasterize")],-1)),s[112]||(s[112]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[113]||(s[113]=t(`
julia
rasterize([reducer], data; geometrycolumn, kw...)

Rasterize a GeoInterface.jl compatable geometry or feature, or a Tables.jl table with a :geometry column of GeoInterface.jl objects, or points columns specified by geometrycolumn

Arguments

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from data where possible.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note on threading. Performance may be much better with threaded=false if reducer/op are not threadsafe. sum, prod, maximum, minimum count and mean (by combining sum and count) are threadsafe. If you know your algorithm is threadsafe, use threadsafe=true to allow all optimisations. Functions passed to fill are always threadsafe, and ignore the threadsafe argument.

Example

Rasterize a shapefile for China and plot, with a border.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, Downloads
+# output

Individual continents

Mosaic of continents

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',17))]),i("details",cs,[i("summary",null,[s[108]||(s[108]=i("a",{id:"Rasters.points-Tuple{AbstractRaster}",href:"#Rasters.points-Tuple{AbstractRaster}"},[i("span",{class:"jlbinding"},"Rasters.points")],-1)),s[109]||(s[109]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[110]||(s[110]=t('
julia
points(A::AbstractRaster; dims=(YDim, XDim), ignore_missing) => Array{Tuple}

Returns a generator of the points in A for dimensions in dims, where points are a tuple of the values in each specified dimension index.

Keywords

  • dims the dimensions to return points from. The first slice of other layers will be used.

  • ignore_missing: wether to ignore missing values in the array when considering points. If true, all points in the dimensions will be returned, if false only the points that are not === missingval(A) will be returned.

The order of dims determines the order of the points.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',7))]),i("details",gs,[i("summary",null,[s[111]||(s[111]=i("a",{id:"Rasters.rasterize",href:"#Rasters.rasterize"},[i("span",{class:"jlbinding"},"Rasters.rasterize")],-1)),s[112]||(s[112]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[113]||(s[113]=t(`
julia
rasterize([reducer], data; geometrycolumn, kw...)

Rasterize a GeoInterface.jl compatable geometry or feature, or a Tables.jl table with a :geometry column of GeoInterface.jl objects, or points columns specified by geometrycolumn

Arguments

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from data where possible.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note on threading. Performance may be much better with threaded=false if reducer/op are not threadsafe. sum, prod, maximum, minimum count and mean (by combining sum and count) are threadsafe. If you know your algorithm is threadsafe, use threadsafe=true to allow all optimisations. Functions passed to fill are always threadsafe, and ignore the threadsafe argument.

Example

Rasterize a shapefile for China and plot, with a border.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, Downloads
 using Rasters.Lookups
 
 # Download a borders shapefile
@@ -256,7 +256,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/china_rasterized.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",ys,[i("summary",null,[s[114]||(s[114]=i("a",{id:"Rasters.rasterize!",href:"#Rasters.rasterize!"},[i("span",{class:"jlbinding"},"Rasters.rasterize!")],-1)),s[115]||(s[115]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[116]||(s[116]=t(`
julia
rasterize!([reducer], dest, data; kw...)

Rasterize the geometries in data into the Raster or RasterStack dest, using the values specified by fill.

Arguments

  • dest: a Raster or RasterStack to rasterize into.

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from A and data where possible.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, GeoInterface, Downloads
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",ys,[i("summary",null,[s[114]||(s[114]=i("a",{id:"Rasters.rasterize!",href:"#Rasters.rasterize!"},[i("span",{class:"jlbinding"},"Rasters.rasterize!")],-1)),s[115]||(s[115]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[116]||(s[116]=t(`
julia
rasterize!([reducer], dest, data; kw...)

Rasterize the geometries in data into the Raster or RasterStack dest, using the values specified by fill.

Arguments

  • dest: a Raster or RasterStack to rasterize into.

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from A and data where possible.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, GeoInterface, Downloads
 using Rasters.Lookups
 
 # Download a borders shapefile
@@ -284,12 +284,12 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/indonesia_rasterized.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",Es,[i("summary",null,[s[117]||(s[117]=i("a",{id:"Rasters.replace_missing-Tuple{Any}",href:"#Rasters.replace_missing-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.replace_missing")],-1)),s[118]||(s[118]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[119]||(s[119]=t(`
julia
replace_missing(a::AbstractRaster, newmissingval)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",Es,[i("summary",null,[s[117]||(s[117]=i("a",{id:"Rasters.replace_missing-Tuple{Any}",href:"#Rasters.replace_missing-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.replace_missing")],-1)),s[118]||(s[118]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[119]||(s[119]=t(`
julia
replace_missing(a::AbstractRaster, newmissingval)
 replace_missing(a::AbstractRasterStack, newmissingval)

Replace missing values in the array or stack with a new missing value, also updating the missingval field/s.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Example

julia
using Rasters, RasterDataSources, ArchGDAL
 A = Raster(WorldClim{Climate}, :prec; month=1) |> replace_missing
 missingval(A)
 # output
-missing

source

`,7))]),i("details",us,[i("summary",null,[s[120]||(s[120]=i("a",{id:"Rasters.reproject-NTuple{4, Any}",href:"#Rasters.reproject-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[121]||(s[121]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[122]||(s[122]=t('
julia
reproject(source::GeoFormat, target::GeoFormat, dim::Dimension, val)

reproject uses Proj.jl's Transformation interface, but implemented for reprojecting a lookup / axis array, a single dimension at a time.

source

',3))]),i("details",ms,[i("summary",null,[s[123]||(s[123]=i("a",{id:"Rasters.reproject-Tuple{Any}",href:"#Rasters.reproject-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[124]||(s[124]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[125]||(s[125]=t('
julia
reproject(obj; crs)

Reproject the lookups (axes) of obj to a different crs.

This is a lossless operation for the raster data, as only the lookup values change. This is only possible when the axes of source and destination projections are aligned: the change is usually from a Regular and an Irregular lookup spans.

For converting between projections that are rotated, skewed or warped in any way, or if you want to re-sample the data, use resample.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are silently returned without modification.

Arguments

  • obj: a Lookup, Dimension, Tuple of Dimension, Raster or RasterStack.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

source

',8))]),i("details",bs,[i("summary",null,[s[126]||(s[126]=i("a",{id:"Rasters.resample-Tuple",href:"#Rasters.resample-Tuple"},[i("span",{class:"jlbinding"},"Rasters.resample")],-1)),s[127]||(s[127]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[128]||(s[128]=t(`
julia
resample(x; kw...)
+missing

source

`,7))]),i("details",us,[i("summary",null,[s[120]||(s[120]=i("a",{id:"Rasters.reproject-NTuple{4, Any}",href:"#Rasters.reproject-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[121]||(s[121]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[122]||(s[122]=t('
julia
reproject(source::GeoFormat, target::GeoFormat, dim::Dimension, val)

reproject uses Proj.jl's Transformation interface, but implemented for reprojecting a lookup / axis array, a single dimension at a time.

source

',3))]),i("details",ms,[i("summary",null,[s[123]||(s[123]=i("a",{id:"Rasters.reproject-Tuple{Any}",href:"#Rasters.reproject-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[124]||(s[124]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[125]||(s[125]=t('
julia
reproject(obj; crs)

Reproject the lookups (axes) of obj to a different crs.

This is a lossless operation for the raster data, as only the lookup values change. This is only possible when the axes of source and destination projections are aligned: the change is usually from a Regular and an Irregular lookup spans.

For converting between projections that are rotated, skewed or warped in any way, or if you want to re-sample the data, use resample.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are silently returned without modification.

Arguments

  • obj: a Lookup, Dimension, Tuple of Dimension, Raster or RasterStack.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

source

',8))]),i("details",bs,[i("summary",null,[s[126]||(s[126]=i("a",{id:"Rasters.resample-Tuple",href:"#Rasters.resample-Tuple"},[i("span",{class:"jlbinding"},"Rasters.resample")],-1)),s[127]||(s[127]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[128]||(s[128]=t(`
julia
resample(x; kw...)
 resample(xs...; to=first(xs), kw...)

resample uses warp (which uses GDALs gdalwarp) to resample a Raster or RasterStack to a new resolution and optionally new crs, or to snap to the bounds, resolution and crs of the object to.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are iteratively resampled with GDAL and joined back into a single array.

If projections can be converted for each axis independently, it may be faster and more accurate to use reproject.

Run using ArchGDAL to make this method available.

Arguments

  • x: the object/s to resample.

Keywords

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from x,

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • method: A Symbol or String specifying the method to use for resampling. From the docs for gdalwarp:

    • :near: nearest neighbour resampling (default, fastest algorithm, worst interpolation quality).

    • :bilinear: bilinear resampling.

    • :cubic: cubic resampling.

    • :cubicspline: cubic spline resampling.

    • :lanczos: Lanczos windowed sinc resampling.

    • :average: average resampling, computes the weighted average of all non-NODATA contributing pixels. rms root mean square / quadratic mean of all non-NODATA contributing pixels (GDAL >= 3.3)

    • :mode: mode resampling, selects the value which appears most often of all the sampled points.

    • :max: maximum resampling, selects the maximum value from all non-NODATA contributing pixels.

    • :min: minimum resampling, selects the minimum value from all non-NODATA contributing pixels.

    • :med: median resampling, selects the median value of all non-NODATA contributing pixels.

    • :q1: first quartile resampling, selects the first quartile value of all non-NODATA contributing pixels.

    • :q3: third quartile resampling, selects the third quartile value of all non-NODATA contributing pixels.

    • :sum: compute the weighted sum of all non-NODATA contributing pixels (since GDAL 3.1)

    Where NODATA values are set to missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note:

  • GDAL may cause some unexpected changes in the raster, such as changing the crs type from EPSG to WellKnownText (it will represent the same CRS).

Example

Resample a WorldClim layer to match an EarthEnv layer:

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{Climate}, :prec; month=1)
 B = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
@@ -300,7 +300,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/resample_example_before.png");
 savefig(b, "build/resample_example_after.png"); nothing
 
-# output

Before resample:

After resample:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',20))]),i("details",Fs,[i("summary",null,[s[129]||(s[129]=i("a",{id:"Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setcrs")],-1)),s[130]||(s[130]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[131]||(s[131]=t('
julia
setcrs(x, crs)

Set the crs of a Raster, RasterStack, Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",fs,[i("summary",null,[s[132]||(s[132]=i("a",{id:"Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setmappedcrs")],-1)),s[133]||(s[133]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[134]||(s[134]=t('
julia
setmappedcrs(x, crs)

Set the mapped crs of a Raster, a RasterStack, a Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",Cs,[i("summary",null,[s[135]||(s[135]=i("a",{id:"Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.slice")],-1)),s[136]||(s[136]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[137]||(s[137]=t('
julia
slice(A::Union{AbstractRaster,AbstractRasterStack,AbstracRasterSeries}, dims) => RasterSeries

Slice views along some dimension/s to obtain a RasterSeries of the slices.

For a Raster or RasterStack this will return a RasterSeries of Raster or RasterStack that are slices along the specified dimensions.

For a RasterSeries, the output is another series where the child objects are sliced and the series dimensions index is now of the child dimensions combined. slice on a RasterSeries with no dimensions will slice along the dimensions shared by both the series and child object.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",As,[i("summary",null,[s[138]||(s[138]=i("a",{id:"Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.trim")],-1)),s[139]||(s[139]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[140]||(s[140]=t(`
julia
trim(x; dims::Tuple, pad::Int)

Trim missingval(x) from x for axes in dims, returning a view of x.

Arguments

  • x: A Raster or RasterStack. For stacks, all layers must having missing values for a pixel for it to be trimmed.

Keywords

  • dims: By default dims=(XDim, YDim), so that trimming keeps the area of X and Y that contains non-missing values along all other dimensions.

  • pad: The trimmed size will be padded by pad on all sides, although padding will not be added beyond the original extent of the array.

As trim is lazy, filename and suffix keywords are not used.

Example

Create trimmed layers of Australian habitat heterogeneity.

julia
using Rasters, RasterDataSources, Plots
+# output

Before resample:

After resample:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',20))]),i("details",Fs,[i("summary",null,[s[129]||(s[129]=i("a",{id:"Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setcrs")],-1)),s[130]||(s[130]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[131]||(s[131]=t('
julia
setcrs(x, crs)

Set the crs of a Raster, RasterStack, Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",fs,[i("summary",null,[s[132]||(s[132]=i("a",{id:"Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setmappedcrs")],-1)),s[133]||(s[133]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[134]||(s[134]=t('
julia
setmappedcrs(x, crs)

Set the mapped crs of a Raster, a RasterStack, a Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",Cs,[i("summary",null,[s[135]||(s[135]=i("a",{id:"Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.slice")],-1)),s[136]||(s[136]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[137]||(s[137]=t('
julia
slice(A::Union{AbstractRaster,AbstractRasterStack,AbstracRasterSeries}, dims) => RasterSeries

Slice views along some dimension/s to obtain a RasterSeries of the slices.

For a Raster or RasterStack this will return a RasterSeries of Raster or RasterStack that are slices along the specified dimensions.

For a RasterSeries, the output is another series where the child objects are sliced and the series dimensions index is now of the child dimensions combined. slice on a RasterSeries with no dimensions will slice along the dimensions shared by both the series and child object.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",As,[i("summary",null,[s[138]||(s[138]=i("a",{id:"Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.trim")],-1)),s[139]||(s[139]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[140]||(s[140]=t(`
julia
trim(x; dims::Tuple, pad::Int)

Trim missingval(x) from x for axes in dims, returning a view of x.

Arguments

  • x: A Raster or RasterStack. For stacks, all layers must having missing values for a pixel for it to be trimmed.

Keywords

  • dims: By default dims=(XDim, YDim), so that trimming keeps the area of X and Y that contains non-missing values along all other dimensions.

  • pad: The trimmed size will be padded by pad on all sides, although padding will not be added beyond the original extent of the array.

As trim is lazy, filename and suffix keywords are not used.

Example

Create trimmed layers of Australian habitat heterogeneity.

julia
using Rasters, RasterDataSources, Plots
 layers = (:evenness, :range, :contrast, :correlation)
 st = RasterStack(EarthEnv{HabitatHeterogeneity}, layers)
 
@@ -315,7 +315,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/trim_example_before.png");
 savefig(b, "build/trim_example_after.png"); nothing
 
-# output

Before trim:

After trim:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',16))]),i("details",Rs,[i("summary",null,[s[141]||(s[141]=i("a",{id:"Rasters.warp-Tuple",href:"#Rasters.warp-Tuple"},[i("span",{class:"jlbinding"},"Rasters.warp")],-1)),s[142]||(s[142]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[143]||(s[143]=t(`
julia
warp(A::AbstractRaster, flags::Dict; kw...)

Gives access to the GDALs gdalwarp method given a Dict of flag => value arguments that can be converted to strings, or vectors where multiple space-separated arguments are required.

Arrays with additional dimensions not handled by GDAL (other than X, Y, Band) are sliced, warped, and then combined to match the original array dimensions. These slices will not be written to disk and loaded lazily at this stage - you will need to do that manually if required.

See the gdalwarp docs for a list of arguments.

Run using ArchGDAL to make this method available.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Any additional keywords are passed to ArchGDAL.Dataset.

Example

This simply resamples the array with the :tr (output file resolution) and :r flags, giving us a pixelated version:

julia
using Rasters, RasterDataSources, Plots
+# output

Before trim:

After trim:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',16))]),i("details",Rs,[i("summary",null,[s[141]||(s[141]=i("a",{id:"Rasters.warp-Tuple",href:"#Rasters.warp-Tuple"},[i("span",{class:"jlbinding"},"Rasters.warp")],-1)),s[142]||(s[142]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[143]||(s[143]=t(`
julia
warp(A::AbstractRaster, flags::Dict; kw...)

Gives access to the GDALs gdalwarp method given a Dict of flag => value arguments that can be converted to strings, or vectors where multiple space-separated arguments are required.

Arrays with additional dimensions not handled by GDAL (other than X, Y, Band) are sliced, warped, and then combined to match the original array dimensions. These slices will not be written to disk and loaded lazily at this stage - you will need to do that manually if required.

See the gdalwarp docs for a list of arguments.

Run using ArchGDAL to make this method available.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Any additional keywords are passed to ArchGDAL.Dataset.

Example

This simply resamples the array with the :tr (output file resolution) and :r flags, giving us a pixelated version:

julia
using Rasters, RasterDataSources, Plots
 A = Raster(WorldClim{Climate}, :prec; month=1)
 a = plot(A)
 
@@ -328,7 +328,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/warp_example_before.png");
 savefig(b, "build/warp_example_after.png"); nothing
 
-# output

Before warp:

After warp:

In practise, prefer resample for this. But warp may be more flexible.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",vs,[i("summary",null,[s[144]||(s[144]=i("a",{id:"Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.zonal")],-1)),s[145]||(s[145]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[146]||(s[146]=t(`
julia
zonal(f, x::Union{Raster,RasterStack}; of, kw...)

Calculate zonal statistics for the the zone of a Raster or RasterStack covered by the of object/s.

Arguments

  • f: any function that reduces an iterable to a single value, such as sum or Statistics.mean

  • x: A Raster or RasterStack

  • of: A DimTuple, Extent, a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

These can be used when of is or contains (a) GeoInterface.jl compatible object(s):

  • shape: Force data to be treated as :polygon, :line or :point, where possible.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

  • progress: show a progress bar, true by default, false to hide..

  • skipmissing: wether to apply f to the result of skipmissing(A) or not. If true f will be passed an iterator over the values, which loses all spatial information. if false f will be passes a masked Raster or RasterStack, and will be responsible for handling missing values itself. The default value is true.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Shapefile, DataFrames, Downloads, Statistics, Dates
+# output

Before warp:

After warp:

In practise, prefer resample for this. But warp may be more flexible.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",vs,[i("summary",null,[s[144]||(s[144]=i("a",{id:"Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.zonal")],-1)),s[145]||(s[145]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[146]||(s[146]=t(`
julia
zonal(f, x::Union{Raster,RasterStack}; of, kw...)

Calculate zonal statistics for the the zone of a Raster or RasterStack covered by the of object/s.

Arguments

  • f: any function that reduces an iterable to a single value, such as sum or Statistics.mean

  • x: A Raster or RasterStack

  • of: A DimTuple, Extent, a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

These can be used when of is or contains (a) GeoInterface.jl compatible object(s):

  • shape: Force data to be treated as :polygon, :line or :point, where possible.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

  • progress: show a progress bar, true by default, false to hide..

  • skipmissing: wether to apply f to the result of skipmissing(A) or not. If true f will be passed an iterator over the values, which loses all spatial information. if false f will be passes a masked Raster or RasterStack, and will be responsible for handling missing values itself. The default value is true.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Shapefile, DataFrames, Downloads, Statistics, Dates
 
 # Download a borders shapefile
 ne_url = "https://github.com/nvkelso/natural-earth-vector/raw/master/10m_cultural/ne_10m_admin_0_countries"
@@ -370,17 +370,17 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
  256 │ Bajo Nuevo Bank               NaN        NaN        NaN        NaN
  257 │ Serranilla Bank               NaN        NaN        NaN        NaN
  258 │ Scarborough Reef              NaN        NaN        NaN        NaN
-                                                  3 columns and 243 rows omitted

source

`,11))]),s[193]||(s[193]=i("h2",{id:"Reference-Internal-functions",tabindex:"-1"},[e("Reference - Internal functions "),i("a",{class:"header-anchor",href:"#Reference-Internal-functions","aria-label":'Permalink to "Reference - Internal functions {#Reference-Internal-functions}"'},"​")],-1)),i("details",Ds,[i("summary",null,[s[147]||(s[147]=i("a",{id:"Rasters.AbstractProjected",href:"#Rasters.AbstractProjected"},[i("span",{class:"jlbinding"},"Rasters.AbstractProjected")],-1)),s[148]||(s[148]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[149]||(s[149]=t('
julia
AbstractProjected <: AbstractSampled

Abstract supertype for projected index lookups.

source

',3))]),i("details",js,[i("summary",null,[s[150]||(s[150]=i("a",{id:"Rasters.FileArray",href:"#Rasters.FileArray"},[i("span",{class:"jlbinding"},"Rasters.FileArray")],-1)),s[151]||(s[151]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[152]||(s[152]=t('
julia
FileArray{S} <: DiskArrays.AbstractDiskArray

Filearray is a DiskArrays.jl AbstractDiskArray. Instead of holding an open object, it just holds a filename string that is opened lazily when it needs to be read.

source

',3))]),i("details",Bs,[i("summary",null,[s[153]||(s[153]=i("a",{id:"Rasters.FileStack",href:"#Rasters.FileStack"},[i("span",{class:"jlbinding"},"Rasters.FileStack")],-1)),s[154]||(s[154]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[155]||(s[155]=t(`
julia
FileStack{S,Na}
+                                                  3 columns and 243 rows omitted

source

`,11))]),s[193]||(s[193]=i("h2",{id:"Reference-Internal-functions",tabindex:"-1"},[e("Reference - Internal functions "),i("a",{class:"header-anchor",href:"#Reference-Internal-functions","aria-label":'Permalink to "Reference - Internal functions {#Reference-Internal-functions}"'},"​")],-1)),i("details",Ds,[i("summary",null,[s[147]||(s[147]=i("a",{id:"Rasters.AbstractProjected",href:"#Rasters.AbstractProjected"},[i("span",{class:"jlbinding"},"Rasters.AbstractProjected")],-1)),s[148]||(s[148]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[149]||(s[149]=t('
julia
AbstractProjected <: AbstractSampled

Abstract supertype for projected index lookups.

source

',3))]),i("details",js,[i("summary",null,[s[150]||(s[150]=i("a",{id:"Rasters.FileArray",href:"#Rasters.FileArray"},[i("span",{class:"jlbinding"},"Rasters.FileArray")],-1)),s[151]||(s[151]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[152]||(s[152]=t('
julia
FileArray{S} <: DiskArrays.AbstractDiskArray

Filearray is a DiskArrays.jl AbstractDiskArray. Instead of holding an open object, it just holds a filename string that is opened lazily when it needs to be read.

source

',3))]),i("details",Bs,[i("summary",null,[s[153]||(s[153]=i("a",{id:"Rasters.FileStack",href:"#Rasters.FileStack"},[i("span",{class:"jlbinding"},"Rasters.FileStack")],-1)),s[154]||(s[154]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[155]||(s[155]=t(`
julia
FileStack{S,Na}
 
-FileStack{S,Na}(filename, types, sizes, eachchunk, haschunks, write)

A wrapper object that holds file pointer and size/chunking metadata for a multi-layered stack stored in a single file, typically netcdf or hdf5.

S is a backend type like NCDsource, and Na is a tuple of Symbol keys.

source

`,4))]),i("details",ws,[i("summary",null,[s[156]||(s[156]=i("a",{id:"Rasters.OpenStack",href:"#Rasters.OpenStack"},[i("span",{class:"jlbinding"},"Rasters.OpenStack")],-1)),s[157]||(s[157]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[158]||(s[158]=t(`
julia
OpenStack{X,K}
+FileStack{S,Na}(filename, types, sizes, eachchunk, haschunks, write)

A wrapper object that holds file pointer and size/chunking metadata for a multi-layered stack stored in a single file, typically netcdf or hdf5.

S is a backend type like NCDsource, and Na is a tuple of Symbol keys.

source

`,4))]),i("details",ws,[i("summary",null,[s[156]||(s[156]=i("a",{id:"Rasters.OpenStack",href:"#Rasters.OpenStack"},[i("span",{class:"jlbinding"},"Rasters.OpenStack")],-1)),s[157]||(s[157]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[158]||(s[158]=t(`
julia
OpenStack{X,K}
 
-OpenStack{X,K}(dataset)

A wrapper for any stack-like opened dataset that can be indexed with Symbol keys to retrieve AbstractArray layers.

OpenStack is usually hidden from users, wrapped in a regular RasterStack passed as the function argument in open(stack) when the stack is contained in a single file.

X is a backend type like NCDsource, and K is a tuple of Symbol keys.

source

`,5))]),i("details",xs,[i("summary",null,[s[159]||(s[159]=i("a",{id:"Rasters.RasterDiskArray",href:"#Rasters.RasterDiskArray"},[i("span",{class:"jlbinding"},"Rasters.RasterDiskArray")],-1)),s[160]||(s[160]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[161]||(s[161]=t('
julia
RasterDiskArray <: DiskArrays.AbstractDiskArray

A basic DiskArrays.jl wrapper for objects that don't have one defined yet. When we open a FileArray it is replaced with a RasterDiskArray.

source

',3))]),i("details",Ts,[i("summary",null,[s[162]||(s[162]=i("a",{id:"Base.open-Tuple{Function, AbstractRaster}",href:"#Base.open-Tuple{Function, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.open")],-1)),s[163]||(s[163]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[164]||(s[164]=t(`
julia
open(f, A::AbstractRaster; write=false)

open is used to open any lazy=true AbstractRaster and do multiple operations on it in a safe way. The write keyword opens the file in write lookup so that it can be altered on disk using e.g. a broadcast.

f is a method that accepts a single argument - an Raster object which is just an AbstractRaster that holds an open disk-based object. Often it will be a do block:

lazy=false (in-memory) rasters will ignore open and pass themselves to f.

julia
# A is an \`Raster\` wrapping the opened disk-based object.
+OpenStack{X,K}(dataset)

A wrapper for any stack-like opened dataset that can be indexed with Symbol keys to retrieve AbstractArray layers.

OpenStack is usually hidden from users, wrapped in a regular RasterStack passed as the function argument in open(stack) when the stack is contained in a single file.

X is a backend type like NCDsource, and K is a tuple of Symbol keys.

source

`,5))]),i("details",xs,[i("summary",null,[s[159]||(s[159]=i("a",{id:"Rasters.RasterDiskArray",href:"#Rasters.RasterDiskArray"},[i("span",{class:"jlbinding"},"Rasters.RasterDiskArray")],-1)),s[160]||(s[160]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[161]||(s[161]=t('
julia
RasterDiskArray <: DiskArrays.AbstractDiskArray

A basic DiskArrays.jl wrapper for objects that don't have one defined yet. When we open a FileArray it is replaced with a RasterDiskArray.

source

',3))]),i("details",Ts,[i("summary",null,[s[162]||(s[162]=i("a",{id:"Base.open-Tuple{Function, AbstractRaster}",href:"#Base.open-Tuple{Function, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.open")],-1)),s[163]||(s[163]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[164]||(s[164]=t(`
julia
open(f, A::AbstractRaster; write=false)

open is used to open any lazy=true AbstractRaster and do multiple operations on it in a safe way. The write keyword opens the file in write lookup so that it can be altered on disk using e.g. a broadcast.

f is a method that accepts a single argument - an Raster object which is just an AbstractRaster that holds an open disk-based object. Often it will be a do block:

lazy=false (in-memory) rasters will ignore open and pass themselves to f.

julia
# A is an \`Raster\` wrapping the opened disk-based object.
 open(Raster(filepath); write=true) do A
     mask!(A; with=maskfile)
     A[I...] .*= 2
     # ...  other things you need to do with the open file
-end

By using a do block to open files we ensure they are always closed again after we finish working with them.

source

`,7))]),i("details",Ss,[i("summary",null,[s[165]||(s[165]=i("a",{id:"Base.read!-Tuple{AbstractRaster, AbstractArray}",href:"#Base.read!-Tuple{AbstractRaster, AbstractArray}"},[i("span",{class:"jlbinding"},"Base.read!")],-1)),s[166]||(s[166]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[167]||(s[167]=t(`
julia
read!(src::Union{AbstractString,AbstractRaster}, dst::AbstractRaster)
+end

By using a do block to open files we ensure they are always closed again after we finish working with them.

source

`,7))]),i("details",Ss,[i("summary",null,[s[165]||(s[165]=i("a",{id:"Base.read!-Tuple{AbstractRaster, AbstractArray}",href:"#Base.read!-Tuple{AbstractRaster, AbstractArray}"},[i("span",{class:"jlbinding"},"Base.read!")],-1)),s[166]||(s[166]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[167]||(s[167]=t(`
julia
read!(src::Union{AbstractString,AbstractRaster}, dst::AbstractRaster)
 read!(src::Union{AbstractString,AbstractRasterStack}, dst::AbstractRasterStack)
-read!(scr::AbstractRasterSeries, dst::AbstractRasterSeries)

read! will copy the data from src to the object dst.

src can be an object or a file-path String.

source

`,4))]),i("details",qs,[i("summary",null,[s[168]||(s[168]=i("a",{id:"Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Base.read")],-1)),s[169]||(s[169]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[170]||(s[170]=t(`
julia
read(A::AbstractRaster)
+read!(scr::AbstractRasterSeries, dst::AbstractRasterSeries)

read! will copy the data from src to the object dst.

src can be an object or a file-path String.

source

`,4))]),i("details",qs,[i("summary",null,[s[168]||(s[168]=i("a",{id:"Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Base.read")],-1)),s[169]||(s[169]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[170]||(s[170]=t(`
julia
read(A::AbstractRaster)
 read(A::AbstractRasterStack)
-read(A::AbstractRasterSeries)

read will move a Rasters.jl object completely to memory.

Keywords

  • checkmemory: If true (the default), check if there is enough memory for the operation. false will ignore memory needs.

source

`,5))]),i("details",Ls,[i("summary",null,[s[171]||(s[171]=i("a",{id:"Base.skipmissing-Tuple{Raster}",href:"#Base.skipmissing-Tuple{Raster}"},[i("span",{class:"jlbinding"},"Base.skipmissing")],-1)),s[172]||(s[172]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[173]||(s[173]=t('
julia
skipmissing(itr::Raster)

Returns an iterable over the elements in a Raster object, skipping any values equal to either the missingval or missing.

source

',3))]),i("details",Is,[i("summary",null,[s[174]||(s[174]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterSeries}",href:"#Base.write-Tuple{AbstractString, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[175]||(s[175]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[176]||(s[176]=t('
julia
Base.write(filepath::AbstractString, s::AbstractRasterSeries; kw...)

Write any AbstractRasterSeries to multiple files, guessing the backend from the file extension.

The lookup values of the series will be appended to the filepath (before the extension), separated by underscores.

All keywords are passed through to these Raster and RasterStack methods.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For series with RasterStack child objects, this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • vebose: whether to print messages about potential problems. true by default.

source

',7))]),i("details",zs,[i("summary",null,[s[177]||(s[177]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterStack}",href:"#Base.write-Tuple{AbstractString, AbstractRasterStack}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[178]||(s[178]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[179]||(s[179]=t('
julia
Base.write(filename::AbstractString, s::AbstractRasterStack; kw...)

Write any AbstractRasterStack to one or multiple files, depending on the backend. Backend is guessed from the filename extension or forced with the source keyword.

If the source can't be saved as a stack-like object, individual array layers will be saved.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For RasterStack this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • vebose: whether to print messages about potential problems. true by default.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

source

',17))]),i("details",Ps,[i("summary",null,[s[180]||(s[180]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRaster}",href:"#Base.write-Tuple{AbstractString, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[181]||(s[181]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[182]||(s[182]=t('
julia
Base.write(filename::AbstractString, A::AbstractRaster; [source], kw...)

Write an AbstractRaster to file, guessing the backend from the file extension or using the source keyword.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

Returns filename.

source

',17))]),i("details",Gs,[i("summary",null,[s[183]||(s[183]=i("a",{id:"Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}",href:"#Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[184]||(s[184]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[185]||(s[185]=t('
julia
Base.write(filename::AbstractString, ::Type{GRDsource}, s::AbstractRaster; kw...)

Write a Raster to a .grd file with a .gri header file.

This method is called automatically if you write a Raster with a .grd or .gri extension.

Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

If this method is called directly the extension of filename will be ignored.

Returns the base of filename with a .grd extension.

source

',8))]),i("details",Ns,[i("summary",null,[s[186]||(s[186]=i("a",{id:"Rasters.checkmem!-Tuple{Bool}",href:"#Rasters.checkmem!-Tuple{Bool}"},[i("span",{class:"jlbinding"},"Rasters.checkmem!")],-1)),s[187]||(s[187]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[188]||(s[188]=t('
julia
checkmem!(x::Bool)

Set checkmem to true or false.

In some architectures memory reporting may be wrong and you may wish to disable memory checks.

This setting can be overridden with the checkmem keyword, where applicable.

source

',5))]),i("details",Os,[i("summary",null,[s[189]||(s[189]=i("a",{id:"Rasters.rplot-Tuple",href:"#Rasters.rplot-Tuple"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[190]||(s[190]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[191]||(s[191]=t('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

',5))])])}const Hs=l(x,[["render",Ms]]);export{Ys as __pageData,Hs as default}; +read(A::AbstractRasterSeries)

read will move a Rasters.jl object completely to memory.

Keywords

source

`,5))]),i("details",Ls,[i("summary",null,[s[171]||(s[171]=i("a",{id:"Base.skipmissing-Tuple{Raster}",href:"#Base.skipmissing-Tuple{Raster}"},[i("span",{class:"jlbinding"},"Base.skipmissing")],-1)),s[172]||(s[172]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[173]||(s[173]=t('
julia
skipmissing(itr::Raster)

Returns an iterable over the elements in a Raster object, skipping any values equal to either the missingval or missing.

source

',3))]),i("details",Is,[i("summary",null,[s[174]||(s[174]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterSeries}",href:"#Base.write-Tuple{AbstractString, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[175]||(s[175]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[176]||(s[176]=t('
julia
Base.write(filepath::AbstractString, s::AbstractRasterSeries; kw...)

Write any AbstractRasterSeries to multiple files, guessing the backend from the file extension.

The lookup values of the series will be appended to the filepath (before the extension), separated by underscores.

All keywords are passed through to these Raster and RasterStack methods.

Keywords

source

',7))]),i("details",zs,[i("summary",null,[s[177]||(s[177]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterStack}",href:"#Base.write-Tuple{AbstractString, AbstractRasterStack}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[178]||(s[178]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[179]||(s[179]=t('
julia
Base.write(filename::AbstractString, s::AbstractRasterStack; kw...)

Write any AbstractRasterStack to one or multiple files, depending on the backend. Backend is guessed from the filename extension or forced with the source keyword.

If the source can't be saved as a stack-like object, individual array layers will be saved.

Keywords

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

source

',17))]),i("details",Ps,[i("summary",null,[s[180]||(s[180]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRaster}",href:"#Base.write-Tuple{AbstractString, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[181]||(s[181]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[182]||(s[182]=t('
julia
Base.write(filename::AbstractString, A::AbstractRaster; [source], kw...)

Write an AbstractRaster to file, guessing the backend from the file extension or using the source keyword.

Keywords

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

Returns filename.

source

',17))]),i("details",Gs,[i("summary",null,[s[183]||(s[183]=i("a",{id:"Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}",href:"#Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[184]||(s[184]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[185]||(s[185]=t('
julia
Base.write(filename::AbstractString, ::Type{GRDsource}, s::AbstractRaster; kw...)

Write a Raster to a .grd file with a .gri header file.

This method is called automatically if you write a Raster with a .grd or .gri extension.

Keywords

If this method is called directly the extension of filename will be ignored.

Returns the base of filename with a .grd extension.

source

',8))]),i("details",Ns,[i("summary",null,[s[186]||(s[186]=i("a",{id:"Rasters.checkmem!-Tuple{Bool}",href:"#Rasters.checkmem!-Tuple{Bool}"},[i("span",{class:"jlbinding"},"Rasters.checkmem!")],-1)),s[187]||(s[187]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[188]||(s[188]=t('
julia
checkmem!(x::Bool)

Set checkmem to true or false.

In some architectures memory reporting may be wrong and you may wish to disable memory checks.

This setting can be overridden with the checkmem keyword, where applicable.

source

',5))]),i("details",Os,[i("summary",null,[s[189]||(s[189]=i("a",{id:"Rasters.rplot-Tuple",href:"#Rasters.rplot-Tuple"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[190]||(s[190]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[191]||(s[191]=t('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

source

',5))])])}const Hs=l(x,[["render",Ms]]);export{Ys as __pageData,Hs as default}; diff --git a/previews/PR800/assets/api.md.CT61Ntce.lean.js b/previews/PR800/assets/api.md.B3FoRFRA.lean.js similarity index 97% rename from previews/PR800/assets/api.md.CT61Ntce.lean.js rename to previews/PR800/assets/api.md.B3FoRFRA.lean.js index dbeca3f3..bcd76fa5 100644 --- a/previews/PR800/assets/api.md.CT61Ntce.lean.js +++ b/previews/PR800/assets/api.md.B3FoRFRA.lean.js @@ -1,20 +1,20 @@ -import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/framework.Gz-llJN4.js";const h="/Rasters.jl/previews/PR800/assets/aggregate_example.vPDkaGne.png",d="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",k="/Rasters.jl/previews/PR800/assets/classify_example.CA_6ItEA.png",c="/Rasters.jl/previews/PR800/assets/classify_bang_example.Ch0DZvbI.png",g="/Rasters.jl/previews/PR800/assets/nz_crop_example.CeBIxUDy.png",y="/Rasters.jl/previews/PR800/assets/argentina_crop_example.DlKBBk5m.png",E="/Rasters.jl/previews/PR800/assets/extend_example.DNJ4wwKN.png",u="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",m="/Rasters.jl/previews/PR800/assets/mosaic_bang_example.ptHNiUCT.png",b="/Rasters.jl/previews/PR800/assets/mosaic_example_africa.Dpr9JnNl.png",F="/Rasters.jl/previews/PR800/assets/mosaic_example_aus.3EfcKnQU.png",f="/Rasters.jl/previews/PR800/assets/mosaic_example_combined.XY5Q_nfP.png",C="/Rasters.jl/previews/PR800/assets/china_rasterized.kM95Jnlf.png",A="/Rasters.jl/previews/PR800/assets/indonesia_rasterized.CAASrLmh.png",R="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",v="/Rasters.jl/previews/PR800/assets/resample_example_after.C_gavhhT.png",D="/Rasters.jl/previews/PR800/assets/trim_example_before.B583SoP8.png",j="/Rasters.jl/previews/PR800/assets/trim_example_after.CsDpPakV.png",B="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",w="/Rasters.jl/previews/PR800/assets/warp_example_after.rgHHAHxc.png",Ys=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"api.md","filePath":"api.md","lastUpdated":null}'),x={name:"api.md"},T={class:"jldocstring custom-block",open:""},S={class:"jldocstring custom-block",open:""},q={class:"jldocstring custom-block",open:""},L={class:"jldocstring custom-block",open:""},I={class:"jldocstring custom-block",open:""},z={class:"jldocstring custom-block",open:""},P={class:"jldocstring custom-block",open:""},G={class:"jldocstring custom-block",open:""},N={class:"jldocstring custom-block",open:""},O={class:"jldocstring custom-block",open:""},M={class:"jldocstring custom-block",open:""},_={class:"jldocstring custom-block",open:""},U={class:"jldocstring custom-block",open:""},W={class:"jldocstring custom-block",open:""},K={class:"jldocstring custom-block",open:""},V={class:"jldocstring custom-block",open:""},X={class:"jldocstring custom-block",open:""},Y={class:"jldocstring custom-block",open:""},H={class:"jldocstring custom-block",open:""},J={class:"jldocstring custom-block",open:""},Z={class:"jldocstring custom-block",open:""},$={class:"jldocstring custom-block",open:""},Q={class:"jldocstring custom-block",open:""},ss={class:"jldocstring custom-block",open:""},is={class:"jldocstring custom-block",open:""},es={class:"jldocstring custom-block",open:""},as={class:"jldocstring custom-block",open:""},ts={class:"jldocstring custom-block",open:""},ns={class:"jldocstring custom-block",open:""},ls={class:"jldocstring custom-block",open:""},ps={class:"jldocstring custom-block",open:""},os={class:"jldocstring custom-block",open:""},rs={class:"jldocstring custom-block",open:""},hs={class:"jldocstring custom-block",open:""},ds={class:"jldocstring custom-block",open:""},ks={class:"jldocstring custom-block",open:""},cs={class:"jldocstring custom-block",open:""},gs={class:"jldocstring custom-block",open:""},ys={class:"jldocstring custom-block",open:""},Es={class:"jldocstring custom-block",open:""},us={class:"jldocstring custom-block",open:""},ms={class:"jldocstring custom-block",open:""},bs={class:"jldocstring custom-block",open:""},Fs={class:"jldocstring custom-block",open:""},fs={class:"jldocstring custom-block",open:""},Cs={class:"jldocstring custom-block",open:""},As={class:"jldocstring custom-block",open:""},Rs={class:"jldocstring custom-block",open:""},vs={class:"jldocstring custom-block",open:""},Ds={class:"jldocstring custom-block",open:""},js={class:"jldocstring custom-block",open:""},Bs={class:"jldocstring custom-block",open:""},ws={class:"jldocstring custom-block",open:""},xs={class:"jldocstring custom-block",open:""},Ts={class:"jldocstring custom-block",open:""},Ss={class:"jldocstring custom-block",open:""},qs={class:"jldocstring custom-block",open:""},Ls={class:"jldocstring custom-block",open:""},Is={class:"jldocstring custom-block",open:""},zs={class:"jldocstring custom-block",open:""},Ps={class:"jldocstring custom-block",open:""},Gs={class:"jldocstring custom-block",open:""},Ns={class:"jldocstring custom-block",open:""},Os={class:"jldocstring custom-block",open:""};function Ms(_s,s,Us,Ws,Ks,Vs){const a=o("Badge");return r(),p("div",null,[s[192]||(s[192]=t('

Index

Reference - Exported functions

',3)),i("details",T,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.Rasters",href:"#Rasters.Rasters"},[i("span",{class:"jlbinding"},"Rasters.Rasters")],-1)),s[1]||(s[1]=e()),n(a,{type:"info",class:"jlObjectType jlModule",text:"Module"})]),s[2]||(s[2]=i("p",null,[i("a",{href:"https://github.com/rafaqz/Rasters.jl/blob/672d88bb8d5b789f6979754e2208f7a272b46e56/src/Rasters.jl#L4",target:"_blank",rel:"noreferrer"},"source")],-1))]),i("details",S,[i("summary",null,[s[3]||(s[3]=i("a",{id:"Rasters.AbstractRaster",href:"#Rasters.AbstractRaster"},[i("span",{class:"jlbinding"},"Rasters.AbstractRaster")],-1)),s[4]||(s[4]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[5]||(s[5]=t('
julia
AbstractRaster <: DimensionalData.AbstractDimArray

Abstract supertype for objects that wrap an array (or location of an array) and metadata about its contents. It may be memory or hold a FileArray, which holds the filename, and is only opened when required.

AbstractRasters inherit from AbstractDimArray from DimensionalData.jl. They can be indexed as regular Julia arrays or with DimensionalData.jl Dimensions. They will plot as a heatmap in Plots.jl with correct coordinates and labels, even after slicing with getindex or view. getindex on a AbstractRaster will always return a memory-backed Raster.

source

',4))]),i("details",q,[i("summary",null,[s[6]||(s[6]=i("a",{id:"Rasters.AbstractRasterSeries",href:"#Rasters.AbstractRasterSeries"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterSeries")],-1)),s[7]||(s[7]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[8]||(s[8]=t('
julia
AbstractRasterSeries <: DimensionalData.AbstractDimensionalArray

Abstract supertype for high-level DimensionalArray that hold RasterStacks, Rasters, or the paths they can be loaded from. RasterSeries are indexed with dimensions as with a AbstractRaster. This is useful when you have multiple files containing rasters or stacks of rasters spread over dimensions like time and elevation.

As much as possible, implementations should facilitate loading entire directories and detecting the dimensions from metadata.

This allows syntax like below for a series of stacks of arrays:

julia
RasterSeries[Time(Near(DateTime(2001, 1))][:temp][Y(Between(70, 150)), X(Between(-20,20))] |> plot`

RasterSeries is the concrete implementation.

source

',7))]),i("details",L,[i("summary",null,[s[9]||(s[9]=i("a",{id:"Rasters.AbstractRasterStack",href:"#Rasters.AbstractRasterStack"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterStack")],-1)),s[10]||(s[10]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[11]||(s[11]=t('
julia
AbstractRasterStack

Abstract supertype for objects that hold multiple AbstractRasters that share spatial dimensions.

They are NamedTuple-like structures that may either contain NamedTuple of AbstractRasters, string paths that will load AbstractRasters, or a single path that points to a file containing multiple layers, like NetCDF or HDF5. Use and syntax is similar or identical for all cases.

AbstractRasterStack can hold layers that share some or all of their dimensions. They cannot have the same dimension with different length or spatial extent as another layer.

getindex on an AbstractRasterStack generally returns a memory backed standard Raster. raster[:somelayer] |> plot plots the layers array, while raster[:somelayer, X(1:100), Band(2)] |> plot will plot the subset without loading the whole array.

getindex on an AbstractRasterStack with a key returns another stack with getindex applied to all the arrays in the stack.

source

',7))]),i("details",I,[i("summary",null,[s[12]||(s[12]=i("a",{id:"Rasters.Band",href:"#Rasters.Band"},[i("span",{class:"jlbinding"},"Rasters.Band")],-1)),s[13]||(s[13]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[14]||(s[14]=t(`
julia
Band <: Dimension
+import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/framework.Gz-llJN4.js";const h="/Rasters.jl/previews/PR800/assets/aggregate_example.vPDkaGne.png",d="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",k="/Rasters.jl/previews/PR800/assets/classify_example.CA_6ItEA.png",c="/Rasters.jl/previews/PR800/assets/classify_bang_example.Ch0DZvbI.png",g="/Rasters.jl/previews/PR800/assets/nz_crop_example.CeBIxUDy.png",y="/Rasters.jl/previews/PR800/assets/argentina_crop_example.DlKBBk5m.png",E="/Rasters.jl/previews/PR800/assets/extend_example.DNJ4wwKN.png",u="/Rasters.jl/previews/PR800/assets/boolmask_example.B6nOyO_A.png",m="/Rasters.jl/previews/PR800/assets/mosaic_bang_example.ptHNiUCT.png",b="/Rasters.jl/previews/PR800/assets/mosaic_example_africa.Dpr9JnNl.png",F="/Rasters.jl/previews/PR800/assets/mosaic_example_aus.3EfcKnQU.png",f="/Rasters.jl/previews/PR800/assets/mosaic_example_combined.XY5Q_nfP.png",C="/Rasters.jl/previews/PR800/assets/china_rasterized.kM95Jnlf.png",A="/Rasters.jl/previews/PR800/assets/indonesia_rasterized.CAASrLmh.png",R="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",v="/Rasters.jl/previews/PR800/assets/resample_example_after.C_gavhhT.png",D="/Rasters.jl/previews/PR800/assets/trim_example_before.B583SoP8.png",j="/Rasters.jl/previews/PR800/assets/trim_example_after.CsDpPakV.png",B="/Rasters.jl/previews/PR800/assets/warp_example_before.DrW8As6m.png",w="/Rasters.jl/previews/PR800/assets/warp_example_after.rgHHAHxc.png",Ys=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"api.md","filePath":"api.md","lastUpdated":null}'),x={name:"api.md"},T={class:"jldocstring custom-block",open:""},S={class:"jldocstring custom-block",open:""},q={class:"jldocstring custom-block",open:""},L={class:"jldocstring custom-block",open:""},I={class:"jldocstring custom-block",open:""},z={class:"jldocstring custom-block",open:""},P={class:"jldocstring custom-block",open:""},G={class:"jldocstring custom-block",open:""},N={class:"jldocstring custom-block",open:""},O={class:"jldocstring custom-block",open:""},M={class:"jldocstring custom-block",open:""},_={class:"jldocstring custom-block",open:""},U={class:"jldocstring custom-block",open:""},W={class:"jldocstring custom-block",open:""},K={class:"jldocstring custom-block",open:""},V={class:"jldocstring custom-block",open:""},X={class:"jldocstring custom-block",open:""},Y={class:"jldocstring custom-block",open:""},H={class:"jldocstring custom-block",open:""},J={class:"jldocstring custom-block",open:""},Z={class:"jldocstring custom-block",open:""},$={class:"jldocstring custom-block",open:""},Q={class:"jldocstring custom-block",open:""},ss={class:"jldocstring custom-block",open:""},is={class:"jldocstring custom-block",open:""},es={class:"jldocstring custom-block",open:""},as={class:"jldocstring custom-block",open:""},ts={class:"jldocstring custom-block",open:""},ns={class:"jldocstring custom-block",open:""},ls={class:"jldocstring custom-block",open:""},ps={class:"jldocstring custom-block",open:""},os={class:"jldocstring custom-block",open:""},rs={class:"jldocstring custom-block",open:""},hs={class:"jldocstring custom-block",open:""},ds={class:"jldocstring custom-block",open:""},ks={class:"jldocstring custom-block",open:""},cs={class:"jldocstring custom-block",open:""},gs={class:"jldocstring custom-block",open:""},ys={class:"jldocstring custom-block",open:""},Es={class:"jldocstring custom-block",open:""},us={class:"jldocstring custom-block",open:""},ms={class:"jldocstring custom-block",open:""},bs={class:"jldocstring custom-block",open:""},Fs={class:"jldocstring custom-block",open:""},fs={class:"jldocstring custom-block",open:""},Cs={class:"jldocstring custom-block",open:""},As={class:"jldocstring custom-block",open:""},Rs={class:"jldocstring custom-block",open:""},vs={class:"jldocstring custom-block",open:""},Ds={class:"jldocstring custom-block",open:""},js={class:"jldocstring custom-block",open:""},Bs={class:"jldocstring custom-block",open:""},ws={class:"jldocstring custom-block",open:""},xs={class:"jldocstring custom-block",open:""},Ts={class:"jldocstring custom-block",open:""},Ss={class:"jldocstring custom-block",open:""},qs={class:"jldocstring custom-block",open:""},Ls={class:"jldocstring custom-block",open:""},Is={class:"jldocstring custom-block",open:""},zs={class:"jldocstring custom-block",open:""},Ps={class:"jldocstring custom-block",open:""},Gs={class:"jldocstring custom-block",open:""},Ns={class:"jldocstring custom-block",open:""},Os={class:"jldocstring custom-block",open:""};function Ms(_s,s,Us,Ws,Ks,Vs){const a=o("Badge");return r(),p("div",null,[s[192]||(s[192]=t('

Index

Reference - Exported functions

',3)),i("details",T,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.Rasters",href:"#Rasters.Rasters"},[i("span",{class:"jlbinding"},"Rasters.Rasters")],-1)),s[1]||(s[1]=e()),n(a,{type:"info",class:"jlObjectType jlModule",text:"Module"})]),s[2]||(s[2]=i("p",null,[i("a",{href:"https://github.com/rafaqz/Rasters.jl/blob/b3c3587fcb848f8d88fae337a6c7e0804c081eb3/src/Rasters.jl#L4",target:"_blank",rel:"noreferrer"},"source")],-1))]),i("details",S,[i("summary",null,[s[3]||(s[3]=i("a",{id:"Rasters.AbstractRaster",href:"#Rasters.AbstractRaster"},[i("span",{class:"jlbinding"},"Rasters.AbstractRaster")],-1)),s[4]||(s[4]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[5]||(s[5]=t('
julia
AbstractRaster <: DimensionalData.AbstractDimArray

Abstract supertype for objects that wrap an array (or location of an array) and metadata about its contents. It may be memory or hold a FileArray, which holds the filename, and is only opened when required.

AbstractRasters inherit from AbstractDimArray from DimensionalData.jl. They can be indexed as regular Julia arrays or with DimensionalData.jl Dimensions. They will plot as a heatmap in Plots.jl with correct coordinates and labels, even after slicing with getindex or view. getindex on a AbstractRaster will always return a memory-backed Raster.

source

',4))]),i("details",q,[i("summary",null,[s[6]||(s[6]=i("a",{id:"Rasters.AbstractRasterSeries",href:"#Rasters.AbstractRasterSeries"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterSeries")],-1)),s[7]||(s[7]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[8]||(s[8]=t('
julia
AbstractRasterSeries <: DimensionalData.AbstractDimensionalArray

Abstract supertype for high-level DimensionalArray that hold RasterStacks, Rasters, or the paths they can be loaded from. RasterSeries are indexed with dimensions as with a AbstractRaster. This is useful when you have multiple files containing rasters or stacks of rasters spread over dimensions like time and elevation.

As much as possible, implementations should facilitate loading entire directories and detecting the dimensions from metadata.

This allows syntax like below for a series of stacks of arrays:

julia
RasterSeries[Time(Near(DateTime(2001, 1))][:temp][Y(Between(70, 150)), X(Between(-20,20))] |> plot`

RasterSeries is the concrete implementation.

source

',7))]),i("details",L,[i("summary",null,[s[9]||(s[9]=i("a",{id:"Rasters.AbstractRasterStack",href:"#Rasters.AbstractRasterStack"},[i("span",{class:"jlbinding"},"Rasters.AbstractRasterStack")],-1)),s[10]||(s[10]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[11]||(s[11]=t('
julia
AbstractRasterStack

Abstract supertype for objects that hold multiple AbstractRasters that share spatial dimensions.

They are NamedTuple-like structures that may either contain NamedTuple of AbstractRasters, string paths that will load AbstractRasters, or a single path that points to a file containing multiple layers, like NetCDF or HDF5. Use and syntax is similar or identical for all cases.

AbstractRasterStack can hold layers that share some or all of their dimensions. They cannot have the same dimension with different length or spatial extent as another layer.

getindex on an AbstractRasterStack generally returns a memory backed standard Raster. raster[:somelayer] |> plot plots the layers array, while raster[:somelayer, X(1:100), Band(2)] |> plot will plot the subset without loading the whole array.

getindex on an AbstractRasterStack with a key returns another stack with getindex applied to all the arrays in the stack.

source

',7))]),i("details",I,[i("summary",null,[s[12]||(s[12]=i("a",{id:"Rasters.Band",href:"#Rasters.Band"},[i("span",{class:"jlbinding"},"Rasters.Band")],-1)),s[13]||(s[13]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[14]||(s[14]=t(`
julia
Band <: Dimension
 
 Band(val=:)

Band Dimension for multi-band rasters.

Example:

julia
banddim = Band(10:10:100)
 # Or
 val = A[Band(1)]
 # Or
-mean(A; dims=Band)

source

`,5))]),i("details",z,[i("summary",null,[s[15]||(s[15]=i("a",{id:"Rasters.Mapped",href:"#Rasters.Mapped"},[i("span",{class:"jlbinding"},"Rasters.Mapped")],-1)),s[16]||(s[16]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[17]||(s[17]=t(`
julia
Mapped <: AbstractProjected
+mean(A; dims=Band)

source

`,5))]),i("details",z,[i("summary",null,[s[15]||(s[15]=i("a",{id:"Rasters.Mapped",href:"#Rasters.Mapped"},[i("span",{class:"jlbinding"},"Rasters.Mapped")],-1)),s[16]||(s[16]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[17]||(s[17]=t(`
julia
Mapped <: AbstractProjected
 
 Mapped(order, span, sampling, crs, mappedcrs)
-Mapped(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs=nothing, mappedcrs)

An AbstractSampled Lookup, where the dimension index has been mapped to another projection, usually lat/lon or EPSG(4326). Mapped matches the dimension format commonly used in netcdf files.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

The mapped dimension index will be used as for Sampled, but to save in another format the underlying crs may be used to convert it.

source

`,5))]),i("details",P,[i("summary",null,[s[18]||(s[18]=i("a",{id:"Rasters.Projected",href:"#Rasters.Projected"},[i("span",{class:"jlbinding"},"Rasters.Projected")],-1)),s[19]||(s[19]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[20]||(s[20]=t(`
julia
Projected <: AbstractProjected
+Mapped(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs=nothing, mappedcrs)

An AbstractSampled Lookup, where the dimension index has been mapped to another projection, usually lat/lon or EPSG(4326). Mapped matches the dimension format commonly used in netcdf files.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

The mapped dimension index will be used as for Sampled, but to save in another format the underlying crs may be used to convert it.

source

`,5))]),i("details",P,[i("summary",null,[s[18]||(s[18]=i("a",{id:"Rasters.Projected",href:"#Rasters.Projected"},[i("span",{class:"jlbinding"},"Rasters.Projected")],-1)),s[19]||(s[19]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[20]||(s[20]=t(`
julia
Projected <: AbstractProjected
 
 Projected(order, span, sampling, crs, mappedcrs)
-Projected(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs, mappedcrs=nothing)

An AbstractSampled Lookup with projections attached.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

If both crs and mappedcrs fields contain CRS data (in a GeoFormat wrapper from GeoFormatTypes.jl) the selector inputs and plot axes will be converted from and to the specified mappedcrs projection automatically. A common use case would be to pass mappedcrs=EPSG(4326) to the constructor when loading eg. a GDALarray:

julia
GDALarray(filename; mappedcrs=EPSG(4326))

The underlying crs will be detected by GDAL.

If mappedcrs is not supplied (ie. mappedcrs=nothing), the base index will be shown on plots, and selectors will need to use whatever format it is in.

source

`,8))]),i("details",G,[i("summary",null,[s[21]||(s[21]=i("a",{id:"Rasters.Raster",href:"#Rasters.Raster"},[i("span",{class:"jlbinding"},"Rasters.Raster")],-1)),s[22]||(s[22]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[23]||(s[23]=t(`
julia
Raster <: AbstractRaster
+Projected(; order=AutoOrder(), span=AutoSpan(), sampling=AutoSampling(), crs, mappedcrs=nothing)

An AbstractSampled Lookup with projections attached.

Fields and behaviours are identical to Sampled with the addition of crs and mappedcrs fields.

If both crs and mappedcrs fields contain CRS data (in a GeoFormat wrapper from GeoFormatTypes.jl) the selector inputs and plot axes will be converted from and to the specified mappedcrs projection automatically. A common use case would be to pass mappedcrs=EPSG(4326) to the constructor when loading eg. a GDALarray:

julia
GDALarray(filename; mappedcrs=EPSG(4326))

The underlying crs will be detected by GDAL.

If mappedcrs is not supplied (ie. mappedcrs=nothing), the base index will be shown on plots, and selectors will need to use whatever format it is in.

source

`,8))]),i("details",G,[i("summary",null,[s[21]||(s[21]=i("a",{id:"Rasters.Raster",href:"#Rasters.Raster"},[i("span",{class:"jlbinding"},"Rasters.Raster")],-1)),s[22]||(s[22]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[23]||(s[23]=t(`
julia
Raster <: AbstractRaster
 
 Raster(filepath::String; kw...)
 Raster(A::AbstractDimArray; kw...)
-Raster(A::AbstractArray, dims; kw...)

A generic AbstractRaster for spatial/raster array data. It can hold either memory-backed arrays or, if lazy=true, a FileArray, which stores the String path to an unopened file.

If lazy=true, the file will only be opened lazily when it is indexed with getindex or when read(A) is called. Broadcasting, taking a view, reversing, and most other methods will not load data from disk; they will be applied later, lazily.

Arguments

  • dims: Tuple of Dimensions needed when an AbstractArray is used.

Keywords

  • name: a Symbol name for the array, which will also retrieve the, alphabetically first, named layer if Raster is used on a multi-layered file like a NetCDF. If instead RasterStack is used to read the multi-layered file, by default, all variables will be added to the stack.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • missingval: value reprsenting missing data, normally detected from the file. Set manually when you know the value is not specified or is incorrect. This will not change any values in the raster, it simply assigns which value is treated as missing. To replace all of the missing values in the raster, use replace_missing.

  • metadata: Dict or Metadata object for the array, or NoMetadata().

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of position Dimensions the array was sliced from, defaulting to (). Usually not needed.

When a filepath String is used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • write: defines the default write keyword value when calling open on the Raster. false by default. Only makes sense to use when lazy=true.

When A is an AbstractDimArray:

  • data: can replace the data in an existing AbstractRaster

source

`,12))]),i("details",N,[i("summary",null,[s[24]||(s[24]=i("a",{id:"Rasters.RasterSeries",href:"#Rasters.RasterSeries"},[i("span",{class:"jlbinding"},"Rasters.RasterSeries")],-1)),s[25]||(s[25]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[26]||(s[26]=t(`
julia
RasterSeries <: AbstractRasterSeries
+Raster(A::AbstractArray, dims; kw...)

A generic AbstractRaster for spatial/raster array data. It can hold either memory-backed arrays or, if lazy=true, a FileArray, which stores the String path to an unopened file.

If lazy=true, the file will only be opened lazily when it is indexed with getindex or when read(A) is called. Broadcasting, taking a view, reversing, and most other methods will not load data from disk; they will be applied later, lazily.

Arguments

  • dims: Tuple of Dimensions needed when an AbstractArray is used.

Keywords

  • name: a Symbol name for the array, which will also retrieve the, alphabetically first, named layer if Raster is used on a multi-layered file like a NetCDF. If instead RasterStack is used to read the multi-layered file, by default, all variables will be added to the stack.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • missingval: value reprsenting missing data, normally detected from the file. Set manually when you know the value is not specified or is incorrect. This will not change any values in the raster, it simply assigns which value is treated as missing. To replace all of the missing values in the raster, use replace_missing.

  • metadata: Dict or Metadata object for the array, or NoMetadata().

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of position Dimensions the array was sliced from, defaulting to (). Usually not needed.

When a filepath String is used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • write: defines the default write keyword value when calling open on the Raster. false by default. Only makes sense to use when lazy=true.

When A is an AbstractDimArray:

  • data: can replace the data in an existing AbstractRaster

source

`,12))]),i("details",N,[i("summary",null,[s[24]||(s[24]=i("a",{id:"Rasters.RasterSeries",href:"#Rasters.RasterSeries"},[i("span",{class:"jlbinding"},"Rasters.RasterSeries")],-1)),s[25]||(s[25]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[26]||(s[26]=t(`
julia
RasterSeries <: AbstractRasterSeries
 
 RasterSeries(rasters::AbstractArray{<:AbstractRaster}, dims; [refdims])
 RasterSeries(stacks::AbstractArray{<:AbstractRasterStack}, dims; [refdims]) 
@@ -25,7 +25,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 2-element RasterSeries{Raster,1} with dimensions: 
   Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

The DateTime suffix is parsed from the filenames. Using Ti(Int) would try to parse integers instead.

Just using the directory will also work, unless there are other files mixed in it:

julia
julia> ser = RasterSeries("series_dir", Ti(DateTime))
 2-element RasterSeries{Raster,1} with dimensions: 
-  Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

Arguments

  • dims: series dimension/s.

Keywords

When loading a series from a Vector of String paths or a single String path:

  • child: constructor of child objects for use when filenames are passed in, can be Raster or RasterStack. Defaults to Raster.

  • duplicate_first::Bool: wether to duplicate the dimensions and metadata of the first file with all other files. This can save load time with a large series where dimensions are identical. false by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • kw: keywords passed to the child constructor Raster or RasterStack.

When loading a series from a single String path:

  • separator: separator used to split lookup elements from the rest of a filename. '_' by default.

Others:

  • refdims: existing reference dimension/s, normally not required.

source

`,22))]),i("details",O,[i("summary",null,[s[27]||(s[27]=i("a",{id:"Rasters.RasterStack",href:"#Rasters.RasterStack"},[i("span",{class:"jlbinding"},"Rasters.RasterStack")],-1)),s[28]||(s[28]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[29]||(s[29]=t(`
julia
RasterStack <: AbstrackRasterStack
+  Ti Sampled{DateTime} DateTime[DateTime("2001-01-01T00:00:00"), DateTime("2002-01-01T00:00:00")] ForwardOrdered Irregular Points

Arguments

  • dims: series dimension/s.

Keywords

When loading a series from a Vector of String paths or a single String path:

  • child: constructor of child objects for use when filenames are passed in, can be Raster or RasterStack. Defaults to Raster.

  • duplicate_first::Bool: wether to duplicate the dimensions and metadata of the first file with all other files. This can save load time with a large series where dimensions are identical. false by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • kw: keywords passed to the child constructor Raster or RasterStack.

When loading a series from a single String path:

  • separator: separator used to split lookup elements from the rest of a filename. '_' by default.

Others:

  • refdims: existing reference dimension/s, normally not required.

source

`,22))]),i("details",O,[i("summary",null,[s[27]||(s[27]=i("a",{id:"Rasters.RasterStack",href:"#Rasters.RasterStack"},[i("span",{class:"jlbinding"},"Rasters.RasterStack")],-1)),s[28]||(s[28]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[29]||(s[29]=t(`
julia
RasterStack <: AbstrackRasterStack
 
 RasterStack(data...; name, kw...)
 RasterStack(data::Union{Vector,Tuple}; name, kw...)
@@ -34,14 +34,14 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 RasterStack(data::Raster; layersfrom=Band, kw...)
 RasterStack(filepath::AbstractString; kw...)

Load a file path or a NamedTuple of paths as a RasterStack, or convert arguments, a Vector or NamedTuple of Rasters to RasterStack.

Arguments

  • data: A NamedTuple of Rasters or String, or a Vector, Tuple or splatted arguments of Raster. The latter options must pass a name keyword argument.

  • filepath: A file (such as netcdf or tif) to be loaded as a stack, or a directory path containing multiple files.

Keywords

  • name: Used as stack layer names when a Tuple, Vector or splat of Raster is passed in. Has no effect when NameTuple is used - the NamedTuple keys are the layer names.

  • group: the group in the dataset where name can be found. Only needed for nested datasets. A String or Symbol will select a single group. Pairs can also used to access groups at any nested depth, i.e group=:group1 => :group2 => :group3.

  • metadata: A Dict or DimensionalData.Metadata object.

  • missingval: a single value for all layers or a NamedTuple of missingval for each layer. nothing specifies no missing value.

  • crs: the coordinate reference system of the objects XDim/YDim dimensions. Only set this if you know the detected crs is incorrect, or it is not present in the file. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat object, like EPSG(4326).

  • mappedcrs: the mapped coordinate reference system of the objects XDim/YDim dimensions. for Mapped lookups these are the actual values of the index. For Projected lookups this can be used to index in eg. EPSG(4326) lat/lon values, having it converted automatically. Only set this if the detected mappedcrs in incorrect, or the file does not have a mappedcrs, e.g. a tiff. The mappedcrs is expected to be a GeoFormatTypes.jl CRS or Mixed mode GeoFormat type.

  • refdims: Tuple of Dimension that the stack was sliced from.

For when one or multiple filepaths are used:

  • dropband: drop single band dimensions when creating stacks from filenames. true by default.

  • lazy: A Bool specifying if to load data lazily from disk. false by default.

  • replace_missing: replace missingval with missing. This is done lazily if lazy=true. Note that currently for NetCDF and GRIB files replace_missing is always true. In future replace_missing=false will also work for these data sources.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

For when a single Raster is used:

  • layersfrom: Dimension to source stack layers from if the file is not already multi-layered. nothing is default, so that a single RasterStack(raster) is a single layered stack. RasterStack(raster; layersfrom=Band) will use the bands as layers.
julia
files = (temp="temp.tif", pressure="pressure.tif", relhum="relhum.tif")
 stack = RasterStack(files; mappedcrs=EPSG(4326))
-stack[:relhum][Lat(Contains(-37), Lon(Contains(144))

source

`,12))]),i("details",M,[i("summary",null,[s[30]||(s[30]=i("a",{id:"DimensionalData.modify-Tuple{Any, AbstractRasterSeries}",href:"#DimensionalData.modify-Tuple{Any, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"DimensionalData.modify")],-1)),s[31]||(s[31]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[32]||(s[32]=t('
julia
modify(f, series::AbstractRasterSeries)

Apply function f to the data of the child object. If the child is an AbstractRasterStack the function will be passed on to its child AbstractRasters.

f must return an identically sized array.

This method triggers a complete rebuild of all objects, and disk based objects will be transferred to memory.

An example of the usefulnesss of this is for swapping out array backend for an entire series to CuArray from CUDA.jl to copy data to a GPU.

source

',6))]),i("details",_,[i("summary",null,[s[33]||(s[33]=i("a",{id:"GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"GeoInterface.crs")],-1)),s[34]||(s[34]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[35]||(s[35]=t('
julia
crs(x::Raster)

Get the projected coordinate reference system of a Y or X Dimension, or of the Y/X dims of an AbstractRaster.

For Mapped lookup this may be nothing as there may be no projected coordinate reference system at all. See setcrs to set it manually.

source

',4))]),i("details",U,[i("summary",null,[s[36]||(s[36]=i("a",{id:"Rasters.aggregate",href:"#Rasters.aggregate"},[i("span",{class:"jlbinding"},"Rasters.aggregate")],-1)),s[37]||(s[37]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[38]||(s[38]=t(`
julia
aggregate(method, object, scale; filename, progress, skipmissing)

Aggregate a Raster, or all arrays in a RasterStack or RasterSeries, by scale using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that specifies where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • progress: show a progress bar, true by default, false to hide.

Example

julia
using Rasters, RasterDataSources, Statistics, Plots
+stack[:relhum][Lat(Contains(-37), Lon(Contains(144))

source

`,12))]),i("details",M,[i("summary",null,[s[30]||(s[30]=i("a",{id:"DimensionalData.modify-Tuple{Any, AbstractRasterSeries}",href:"#DimensionalData.modify-Tuple{Any, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"DimensionalData.modify")],-1)),s[31]||(s[31]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[32]||(s[32]=t('
julia
modify(f, series::AbstractRasterSeries)

Apply function f to the data of the child object. If the child is an AbstractRasterStack the function will be passed on to its child AbstractRasters.

f must return an identically sized array.

This method triggers a complete rebuild of all objects, and disk based objects will be transferred to memory.

An example of the usefulnesss of this is for swapping out array backend for an entire series to CuArray from CUDA.jl to copy data to a GPU.

source

',6))]),i("details",_,[i("summary",null,[s[33]||(s[33]=i("a",{id:"GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#GeoInterface.crs-Tuple{Union{Tuple{Dimension, Vararg{Dimension}}, AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"GeoInterface.crs")],-1)),s[34]||(s[34]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[35]||(s[35]=t('
julia
crs(x::Raster)

Get the projected coordinate reference system of a Y or X Dimension, or of the Y/X dims of an AbstractRaster.

For Mapped lookup this may be nothing as there may be no projected coordinate reference system at all. See setcrs to set it manually.

source

',4))]),i("details",U,[i("summary",null,[s[36]||(s[36]=i("a",{id:"Rasters.aggregate",href:"#Rasters.aggregate"},[i("span",{class:"jlbinding"},"Rasters.aggregate")],-1)),s[37]||(s[37]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[38]||(s[38]=t(`
julia
aggregate(method, object, scale; filename, progress, skipmissing)

Aggregate a Raster, or all arrays in a RasterStack or RasterSeries, by scale using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that specifies where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • progress: show a progress bar, true by default, false to hide.

Example

julia
using Rasters, RasterDataSources, Statistics, Plots
 import ArchGDAL
 using Rasters: Center
 st = read(RasterStack(WorldClim{Climate}; month=1))
 ag = aggregate(Center(), st, (Y(20), X(20)); skipmissingval=true, progress=false)
 plot(ag)
 savefig("build/aggregate_example.png"); nothing
-# output

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',12))]),i("details",W,[i("summary",null,[s[39]||(s[39]=i("a",{id:"Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.aggregate!")],-1)),s[40]||(s[40]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[41]||(s[41]=t('
julia
aggregate!(method, dst::AbstractRaster, src::AbstractRaster, scale; skipmissingval=false)

Aggregate array src to array dst by scale, using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • progress: show a progress bar.

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

Note: currently it is much faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',9))]),i("details",K,[i("summary",null,[s[42]||(s[42]=i("a",{id:"Rasters.boolmask",href:"#Rasters.boolmask"},[i("span",{class:"jlbinding"},"Rasters.boolmask")],-1)),s[43]||(s[43]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[44]||(s[44]=t(`
julia
boolmask(obj::Raster; [missingval])
+# output

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',12))]),i("details",W,[i("summary",null,[s[39]||(s[39]=i("a",{id:"Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.aggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.aggregate!")],-1)),s[40]||(s[40]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[41]||(s[41]=t('
julia
aggregate!(method, dst::AbstractRaster, src::AbstractRaster, scale; skipmissingval=false)

Aggregate array src to array dst by scale, using method.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

When the aggregation scale of is larger than the array axis, the length of the axis is used.

Keywords

  • progress: show a progress bar.

  • skipmissingval: if true, any missingval will be skipped during aggregation, so that only areas of all missing values will be aggregated to missingval. If false, any aggregated area containing a missingval will be assigned missingval.

Note: currently it is much faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',9))]),i("details",K,[i("summary",null,[s[42]||(s[42]=i("a",{id:"Rasters.boolmask",href:"#Rasters.boolmask"},[i("span",{class:"jlbinding"},"Rasters.boolmask")],-1)),s[43]||(s[43]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[44]||(s[44]=t(`
julia
boolmask(obj::Raster; [missingval])
 boolmask(obj; [to, res, size])
 boolmask(obj::RasterStack; alllayers=true, kw...)

Create a mask array of Bool values, from another Raster. AbstractRasterStack or AbstractRasterSeries are also accepted.

The array returned from calling boolmask on a AbstractRaster is a Raster with the same dimensions as the original array and a missingval of false.

Arguments

  • a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Raster / RasterStack Keywords

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: The missing value of the source array, with default missingval(raster).

Keywords

  • alllayers: if true a mask is taken for all layers, otherwise only the first layer is used. Defaults to true

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

And specifically for shape=:polygon:

  • boundary: include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

For tabular data, feature collections and other iterables

  • collapse: if true, collapse all geometry masks into a single mask. Otherwise return a Raster with an additional geometry dimension, so that each slice along this axis is the mask of the geometry opbject of each row of the table, feature in the feature collection, or just each geometry in the iterable.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 wc = Raster(WorldClim{Climate}, :prec; month=1)
@@ -49,7 +49,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/boolmask_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",V,[i("summary",null,[s[45]||(s[45]=i("a",{id:"Rasters.cellarea-Tuple{Any}",href:"#Rasters.cellarea-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[46]||(s[46]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[47]||(s[47]=t(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",V,[i("summary",null,[s[45]||(s[45]=i("a",{id:"Rasters.cellarea-Tuple{Any}",href:"#Rasters.cellarea-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[46]||(s[46]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[47]||(s[47]=t(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
 xdim = X(Projected(90.0:10.0:120; sampling=Intervals(Start()), crs=EPSG(4326)))
 ydim = Y(Projected(0.0:10.0:50; sampling=Intervals(Start()), crs=EPSG(4326)))
 myraster = rand(xdim, ydim)
@@ -70,7 +70,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
   90.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  100.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  110.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
- 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),i("details",X,[i("summary",null,[s[48]||(s[48]=i("a",{id:"Rasters.classify",href:"#Rasters.classify"},[i("span",{class:"jlbinding"},"Rasters.classify")],-1)),s[49]||(s[49]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[50]||(s[50]=t(`
julia
classify(x, pairs; lower=(>=), upper=(<), others=nothing)
+ 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),i("details",X,[i("summary",null,[s[48]||(s[48]=i("a",{id:"Rasters.classify",href:"#Rasters.classify"},[i("span",{class:"jlbinding"},"Rasters.classify")],-1)),s[49]||(s[49]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[50]||(s[50]=t(`
julia
classify(x, pairs; lower=(>=), upper=(<), others=nothing)
 classify(x, pairs...; lower, upper, others)

Create a new array with values in x classified by the values in pairs.

pairs can hold tuples fo values (2, 3), a Fix2 function e.g. <=(1), a Tuple of Fix2 e.g. (>=(4), <(7)), or an IntervalSets.jl interval, e.g. 3..9 or OpenInterval(10, 12). pairs can also be a n * 3 matrix where each row is lower bounds, upper bounds, replacement.

If tuples or a Matrix are used, the lower and upper keywords define how the lower and upper boundaries are chosen.

If others is set other values not covered in pairs will be set to that values.

Arguments

  • x: a Raster or RasterStack

  • pairs: each pair contains a value and a replacement, a tuple of lower and upper range and a replacement, or a Tuple of Fix2 like (>(x), <(y).

Keywords

  • lower: Which comparison (< or <=) to use for lower values, if Fix2 are not used.

  • upper: Which comparison (> or >=) to use for upper values, if Fix2 are not used.

  • others: A value to assign to all values not included in pairs. Passing nothing (the default) will leave them unchanged.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{Climate}, :tavg; month=1)
 classes = <=(15) => 10,
@@ -82,7 +82,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/classify_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",Y,[i("summary",null,[s[51]||(s[51]=i("a",{id:"Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}",href:"#Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}"},[i("span",{class:"jlbinding"},"Rasters.classify!")],-1)),s[52]||(s[52]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[53]||(s[53]=t(`
julia
classify!(x, pairs...; lower, upper, others)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",Y,[i("summary",null,[s[51]||(s[51]=i("a",{id:"Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}",href:"#Rasters.classify!-Tuple{AbstractRaster, Pair, Vararg{Pair}}"},[i("span",{class:"jlbinding"},"Rasters.classify!")],-1)),s[52]||(s[52]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[53]||(s[53]=t(`
julia
classify!(x, pairs...; lower, upper, others)
 classify!(x, pairs; lower, upper, others)

Classify the values of x in-place, by the values in pairs.

If Fix2 is not used, the lower and upper keywords

If others is set other values not covered in pairs will be set to that values.

Arguments

  • x: a Raster or RasterStack

  • pairs: each pair contains a value and a replacement, a tuple of lower and upper range and a replacement, or a Tuple of Fix2 like (>(x), <(y).

Keywords

  • lower: Which comparison (< or <=) to use for lower values, if Fix2 are not used.

  • upper: Which comparison (> or >=) to use for upper values, if Fix2 are not used.

  • others: A value to assign to all values not included in pairs. Passing nothing (the default) will leave them unchanged.

Example

classify! to disk, with key steps:

  • copying a tempory file so we don't write over the RasterDataSources.jl version.

  • use open with write=true to open the file with disk-write permissions.

  • use Float32 like 10.0f0 for all our replacement values and other, because the file is stored as Float32. Attempting to write some other type will fail.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 # Download and copy the file
 filename = getraster(WorldClim{Climate}, :tavg; month=6)
@@ -102,8 +102,8 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/classify_bang_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",H,[i("summary",null,[s[54]||(s[54]=i("a",{id:"Rasters.combine-Tuple{AbstractRasterSeries}",href:"#Rasters.combine-Tuple{AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Rasters.combine")],-1)),s[55]||(s[55]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[56]||(s[56]=t('
julia
combine(A::AbstracRasterSeries; [dims], [lazy]) => Raster

Combine a RasterSeries along some dimension/s, creating a new Raster or RasterStack, depending on the contents of the series.

If dims are passed, only the specified dimensions will be combined with a RasterSeries returned, unless dims is all the dims in the series.

If lazy, concatenate lazily. The default is to concatenate lazily for lazy Rasters and eagerly otherwise.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",J,[i("summary",null,[s[57]||(s[57]=i("a",{id:"Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}",href:"#Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}"},[i("span",{class:"jlbinding"},"Rasters.convertlookup")],-1)),s[58]||(s[58]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[59]||(s[59]=t('
julia
convertlookup(dstlookup::Type{<:Lookup}, x)

Convert the dimension lookup between Projected and Mapped. Other dimension lookups pass through unchanged.

This is used to e.g. save a netcdf file to GeoTiff.

source

',4))]),i("details",Z,[i("summary",null,[s[60]||(s[60]=i("a",{id:"Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}",href:"#Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage!")],-1)),s[61]||(s[61]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[62]||(s[62]=t('
julia
coverage!(A, geom; [mode, scale])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

source

',8))]),i("details",$,[i("summary",null,[s[63]||(s[63]=i("a",{id:"Rasters.coverage-Tuple{Any}",href:"#Rasters.coverage-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage")],-1)),s[64]||(s[64]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[65]||(s[65]=t(`
julia
coverage(mode, geom; [to, res, size, scale, verbose, progress])
-coverage(geom; [to, mode, res, size, scale, verbose, progress])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

source

`,8))]),i("details",Q,[i("summary",null,[s[66]||(s[66]=i("a",{id:"Rasters.crop",href:"#Rasters.crop"},[i("span",{class:"jlbinding"},"Rasters.crop")],-1)),s[67]||(s[67]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[68]||(s[68]=t(`
julia
crop(x; to, touches=false, [geometrycolumn])
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",H,[i("summary",null,[s[54]||(s[54]=i("a",{id:"Rasters.combine-Tuple{AbstractRasterSeries}",href:"#Rasters.combine-Tuple{AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Rasters.combine")],-1)),s[55]||(s[55]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[56]||(s[56]=t('
julia
combine(A::AbstracRasterSeries; [dims], [lazy]) => Raster

Combine a RasterSeries along some dimension/s, creating a new Raster or RasterStack, depending on the contents of the series.

If dims are passed, only the specified dimensions will be combined with a RasterSeries returned, unless dims is all the dims in the series.

If lazy, concatenate lazily. The default is to concatenate lazily for lazy Rasters and eagerly otherwise.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",J,[i("summary",null,[s[57]||(s[57]=i("a",{id:"Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}",href:"#Rasters.convertlookup-Tuple{Type{<:Lookup}, AbstractDimArray}"},[i("span",{class:"jlbinding"},"Rasters.convertlookup")],-1)),s[58]||(s[58]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[59]||(s[59]=t('
julia
convertlookup(dstlookup::Type{<:Lookup}, x)

Convert the dimension lookup between Projected and Mapped. Other dimension lookups pass through unchanged.

This is used to e.g. save a netcdf file to GeoTiff.

source

',4))]),i("details",Z,[i("summary",null,[s[60]||(s[60]=i("a",{id:"Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}",href:"#Rasters.coverage!-Tuple{Union{typeof(sum), typeof(union)}, AbstractRaster, Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage!")],-1)),s[61]||(s[61]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[62]||(s[62]=t('
julia
coverage!(A, geom; [mode, scale])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

source

',8))]),i("details",$,[i("summary",null,[s[63]||(s[63]=i("a",{id:"Rasters.coverage-Tuple{Any}",href:"#Rasters.coverage-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.coverage")],-1)),s[64]||(s[64]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[65]||(s[65]=t(`
julia
coverage(mode, geom; [to, res, size, scale, verbose, progress])
+coverage(geom; [to, mode, res, size, scale, verbose, progress])

Calculate the area of a raster covered by GeoInterface.jl compatible geometry geom, as a fraction.

Each pixel is assigned a grid of points (by default 10 x 10) that are each checked to be inside the geometry. The sum divided by the number of points to give coverage.

In practice, most pixel coverage is not calculated this way - shortcuts that produce the same result are taken wherever possible.

If geom is an AbstractVector or table, the mode keyword will determine how coverage is combined.

Keywords

  • mode: method for combining multiple geometries - union or sum.

    • union (the default) gives the areas covered by all geometries. Usefull in spatial coverage where overlapping regions should not be counted twice. The returned raster will contain Float64 values between 0.0 and 1.0.

    • sum gives the summed total of the areas covered by all geometries, as in taking the sum of running coverage separately on all geometries. The returned values are positive Float64.

    For a single geometry, the mode keyword has no effect - the result is the same.

  • scale: Integer scale of pixel subdivision. The default of 10 means each pixel has 10 x 10 or 100 points that contribute to coverage. Using 100 means 10,000 points contribute. Performance will decline as scale increases. Memory use will grow by scale^2 when mode=:union.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • progress: show a progress bar, true by default, false to hide.

  • vebose: whether to print messages about potential problems. true by default.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

source

`,8))]),i("details",Q,[i("summary",null,[s[66]||(s[66]=i("a",{id:"Rasters.crop",href:"#Rasters.crop"},[i("span",{class:"jlbinding"},"Rasters.crop")],-1)),s[67]||(s[67]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[68]||(s[68]=t(`
julia
crop(x; to, touches=false, [geometrycolumn])
 crop(xs...; to)

Crop one or multiple AbstractRaster or AbstractRasterStack x to match the size of the object to, or smallest of any dimensions that are shared.

crop is lazy, using a view into the object rather than allocating new memory.

Keywords

  • to: the object to crop to. This can be a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified. If no to keyword is passed, the smallest shared area of all xs is used.

  • touches: true or false. Whether to use Touches wraper on the object extent. When lines need to be included in e.g. zonal statistics, true should be used.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

As crop is lazy, filename and suffix keywords are not used.

Example

Crop to another raster:

julia
using Rasters, RasterDataSources, Plots
 evenness = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
 rnge = Raster(EarthEnv{HabitatHeterogeneity}, :range)
@@ -133,7 +133,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/argentina_crop_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",ss,[i("summary",null,[s[69]||(s[69]=i("a",{id:"Rasters.disaggregate",href:"#Rasters.disaggregate"},[i("span",{class:"jlbinding"},"Rasters.disaggregate")],-1)),s[70]||(s[70]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[71]||(s[71]=t('
julia
disaggregate(method, object, scale; filename, progress, keys)

Disaggregate array, or all arrays in a stack or series, by some scale.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or a Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

Keywords

  • progress: show a progress bar.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',8))]),i("details",is,[i("summary",null,[s[72]||(s[72]=i("a",{id:"Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.disaggregate!")],-1)),s[73]||(s[73]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[74]||(s[74]=t('
julia
disaggregate!(method, dst::AbstractRaster, src::AbstractRaster, filename, scale)

Disaggregate array src to array dst by some scale, using method.

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',5))]),i("details",es,[i("summary",null,[s[75]||(s[75]=i("a",{id:"Rasters.extend",href:"#Rasters.extend"},[i("span",{class:"jlbinding"},"Rasters.extend")],-1)),s[76]||(s[76]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[77]||(s[77]=t(`
julia
extend(xs...; [to])
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',15))]),i("details",ss,[i("summary",null,[s[69]||(s[69]=i("a",{id:"Rasters.disaggregate",href:"#Rasters.disaggregate"},[i("span",{class:"jlbinding"},"Rasters.disaggregate")],-1)),s[70]||(s[70]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[71]||(s[71]=t('
julia
disaggregate(method, object, scale; filename, progress, keys)

Disaggregate array, or all arrays in a stack or series, by some scale.

Arguments

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • object: Object to aggregate, like AbstractRasterSeries, AbstractStack, AbstractRaster or a Dimension.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index.

Keywords

  • progress: show a progress bar.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',8))]),i("details",is,[i("summary",null,[s[72]||(s[72]=i("a",{id:"Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}",href:"#Rasters.disaggregate!-Tuple{Locus, AbstractRaster, Any, Any}"},[i("span",{class:"jlbinding"},"Rasters.disaggregate!")],-1)),s[73]||(s[73]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[74]||(s[74]=t('
julia
disaggregate!(method, dst::AbstractRaster, src::AbstractRaster, filename, scale)

Disaggregate array src to array dst by some scale, using method.

  • method: a function such as mean or sum that can combine the value of multiple cells to generate the aggregated cell, or a Locus like Start() or Center() that species where to sample from in the interval.

  • scale: the aggregation factor, which can be an integer, a tuple of integers for each dimension, or any Dimension, Selector or Int combination you can usually use in getindex. Using a Selector will determine the scale by the distance from the start of the index in the src array.

Note: currently it is faster to aggregate over memory-backed arrays. Use read on src before use where required.

source

',5))]),i("details",es,[i("summary",null,[s[75]||(s[75]=i("a",{id:"Rasters.extend",href:"#Rasters.extend"},[i("span",{class:"jlbinding"},"Rasters.extend")],-1)),s[76]||(s[76]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[77]||(s[77]=t(`
julia
extend(xs...; [to])
 extend(xs; [to])
 extend(x::Union{AbstractRaster,AbstractRasterStack}; to, kw...)

Extend one or multiple AbstractRaster to match the area covered by all xs, or by the keyword argument to.

Keywords

  • to: the Raster or dims to extend to. If no to keyword is passed, the largest shared area of all xs is used.

  • touches: true or false. Whether to use Touches wrapper on the object extent. When lines need to be included in e.g. zonal statistics, true shoudle be used.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

julia
using Rasters, RasterDataSources, Plots
 evenness = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
@@ -149,7 +149,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/extend_example.png")
 nothing
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',8))]),i("details",as,[i("summary",null,[s[78]||(s[78]=i("a",{id:"Rasters.extract",href:"#Rasters.extract"},[i("span",{class:"jlbinding"},"Rasters.extract")],-1)),s[79]||(s[79]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[80]||(s[80]=t(`
julia
extract(x, data; kw...)

Extracts the value of Raster or RasterStack at given points, returning an iterable of NamedTuple with properties for :geometry and raster or stack layer values.

Note that if objects have more dimensions than the length of the point tuples, sliced arrays or stacks will be returned instead of single values.

Arguments

  • x: a Raster or RasterStack to extract values from.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometry: include :geometry in returned NamedTuple, true by default.

  • index: include :index of the CartesianIndex in returned NamedTuple, false by default.

  • name: a Symbol or Tuple of Symbol corresponding to layer/s of a RasterStack to extract. All layers by default.

  • skipmissing: skip missing points automatically.

  • atol: a tolerance for floating point lookup values for when the Lookup contains Points. atol is ignored for Intervals.

geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Here we extract points matching the occurrence of the Mountain Pygmy Possum, Burramis parvus. This could be used to fit a species distribution model.

julia
using Rasters, RasterDataSources, ArchGDAL, GBIF2, CSV
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',8))]),i("details",as,[i("summary",null,[s[78]||(s[78]=i("a",{id:"Rasters.extract",href:"#Rasters.extract"},[i("span",{class:"jlbinding"},"Rasters.extract")],-1)),s[79]||(s[79]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[80]||(s[80]=t(`
julia
extract(x, data; kw...)

Extracts the value of Raster or RasterStack at given points, returning an iterable of NamedTuple with properties for :geometry and raster or stack layer values.

Note that if objects have more dimensions than the length of the point tuples, sliced arrays or stacks will be returned instead of single values.

Arguments

  • x: a Raster or RasterStack to extract values from.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometry: include :geometry in returned NamedTuple, true by default.

  • index: include :index of the CartesianIndex in returned NamedTuple, false by default.

  • name: a Symbol or Tuple of Symbol corresponding to layer/s of a RasterStack to extract. All layers by default.

  • skipmissing: skip missing points automatically.

  • atol: a tolerance for floating point lookup values for when the Lookup contains Points. atol is ignored for Intervals.

geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Here we extract points matching the occurrence of the Mountain Pygmy Possum, Burramis parvus. This could be used to fit a species distribution model.

julia
using Rasters, RasterDataSources, ArchGDAL, GBIF2, CSV
 
 # Get a stack of BioClim layers, and replace missing values with \`missing\`
 st = RasterStack(WorldClim{BioClim}, (1, 3, 5, 7, 12)) |> replace_missing
@@ -167,7 +167,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
  (geometry = (0.03, 39.97), bio1 = 17.076923f0, bio3 = 39.7983f0, bio5 = 29.638462f0, bio7 = 24.153847f0, bio12 = 441.0f0)
  (geometry = (0.03, 39.97), bio1 = 17.076923f0, bio3 = 39.7983f0, bio5 = 29.638462f0, bio7 = 24.153847f0, bio12 = 441.0f0)
  (geometry = (0.52, 40.37), bio1 = missing, bio3 = missing, bio5 = missing, bio7 = missing, bio12 = missing)
- (geometry = (0.32, 40.24), bio1 = 16.321388f0, bio3 = 41.659454f0, bio5 = 30.029825f0, bio7 = 25.544561f0, bio12 = 480.0f0)

Note: passing in arrays, geometry collections or feature collections containing a mix of points and other geometries has undefined results.

source

`,13))]),i("details",ts,[i("summary",null,[s[81]||(s[81]=i("a",{id:"Rasters.mappedbounds",href:"#Rasters.mappedbounds"},[i("span",{class:"jlbinding"},"Rasters.mappedbounds")],-1)),s[82]||(s[82]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[83]||(s[83]=t('
julia
mappedbounds(x)

Get the bounds converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular bounds.

source

',4))]),i("details",ns,[i("summary",null,[s[84]||(s[84]=i("a",{id:"Rasters.mappedcrs",href:"#Rasters.mappedcrs"},[i("span",{class:"jlbinding"},"Rasters.mappedcrs")],-1)),s[85]||(s[85]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[86]||(s[86]=t('
julia
mappedcrs(x)

Get the mapped coordinate reference system for the Y/X dims of an array.

In Projected lookup this is used to convert Selector values form the mappedcrs defined projection to the underlying projection, and to show plot axes in the mapped projection.

In Mapped lookup this is the coordinate reference system of the index values. See setmappedcrs to set it manually.

source

',5))]),i("details",ls,[i("summary",null,[s[87]||(s[87]=i("a",{id:"Rasters.mappedindex",href:"#Rasters.mappedindex"},[i("span",{class:"jlbinding"},"Rasters.mappedindex")],-1)),s[88]||(s[88]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[89]||(s[89]=t('
julia
mappedindex(x)

Get the index value of a dimension converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular dim value.

source

',4))]),i("details",ps,[i("summary",null,[s[90]||(s[90]=i("a",{id:"Rasters.mask!",href:"#Rasters.mask!"},[i("span",{class:"jlbinding"},"Rasters.mask!")],-1)),s[91]||(s[91]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[92]||(s[92]=t(`
julia
mask!(x; with, missingval=missingval(A))

Mask A by the missing values of with, or by all values outside with if it is a polygon.

If with is a polygon, creates a new array where points falling outside the polygon have been replaced by missingval(A).

Return a new array with values of A masked by the missing values of with, or by a polygon.

Arguments

  • x: a Raster or RasterStack.

Keywords

  • with: another AbstractRaster, a AbstractVector of Tuple points, or any GeoInterface.jl AbstractGeometry. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to write to A in masked areas, by default missingval(A).

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask to match the size and projection.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
+ (geometry = (0.32, 40.24), bio1 = 16.321388f0, bio3 = 41.659454f0, bio5 = 30.029825f0, bio7 = 25.544561f0, bio12 = 480.0f0)

Note: passing in arrays, geometry collections or feature collections containing a mix of points and other geometries has undefined results.

source

`,13))]),i("details",ts,[i("summary",null,[s[81]||(s[81]=i("a",{id:"Rasters.mappedbounds",href:"#Rasters.mappedbounds"},[i("span",{class:"jlbinding"},"Rasters.mappedbounds")],-1)),s[82]||(s[82]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[83]||(s[83]=t('
julia
mappedbounds(x)

Get the bounds converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular bounds.

source

',4))]),i("details",ns,[i("summary",null,[s[84]||(s[84]=i("a",{id:"Rasters.mappedcrs",href:"#Rasters.mappedcrs"},[i("span",{class:"jlbinding"},"Rasters.mappedcrs")],-1)),s[85]||(s[85]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[86]||(s[86]=t('
julia
mappedcrs(x)

Get the mapped coordinate reference system for the Y/X dims of an array.

In Projected lookup this is used to convert Selector values form the mappedcrs defined projection to the underlying projection, and to show plot axes in the mapped projection.

In Mapped lookup this is the coordinate reference system of the index values. See setmappedcrs to set it manually.

source

',5))]),i("details",ls,[i("summary",null,[s[87]||(s[87]=i("a",{id:"Rasters.mappedindex",href:"#Rasters.mappedindex"},[i("span",{class:"jlbinding"},"Rasters.mappedindex")],-1)),s[88]||(s[88]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[89]||(s[89]=t('
julia
mappedindex(x)

Get the index value of a dimension converted to the mappedcrs value.

Without ArchGDAL loaded, this is just the regular dim value.

source

',4))]),i("details",ps,[i("summary",null,[s[90]||(s[90]=i("a",{id:"Rasters.mask!",href:"#Rasters.mask!"},[i("span",{class:"jlbinding"},"Rasters.mask!")],-1)),s[91]||(s[91]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[92]||(s[92]=t(`
julia
mask!(x; with, missingval=missingval(A))

Mask A by the missing values of with, or by all values outside with if it is a polygon.

If with is a polygon, creates a new array where points falling outside the polygon have been replaced by missingval(A).

Return a new array with values of A masked by the missing values of with, or by a polygon.

Arguments

  • x: a Raster or RasterStack.

Keywords

  • with: another AbstractRaster, a AbstractVector of Tuple points, or any GeoInterface.jl AbstractGeometry. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to write to A in masked areas, by default missingval(A).

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask to match the size and projection.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 
 # Load and plot the file
 awap = read(RasterStack(AWAP, (:tmin, :tmax); date=DateTime(2001, 1, 1)))
@@ -184,7 +184,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/mask_bang_example_before.png");
 savefig(b, "build/mask_bang_example_after.png"); nothing
 
-# output

Before mask!:

After mask!:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,15))]),i("details",os,[i("summary",null,[s[93]||(s[93]=i("a",{id:"Rasters.mask-Tuple{Any}",href:"#Rasters.mask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.mask")],-1)),s[94]||(s[94]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[95]||(s[95]=t(`
julia
mask(A:AbstractRaster; with, missingval=missingval(A))
+# output

Before mask!:

After mask!:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,15))]),i("details",os,[i("summary",null,[s[93]||(s[93]=i("a",{id:"Rasters.mask-Tuple{Any}",href:"#Rasters.mask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.mask")],-1)),s[94]||(s[94]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[95]||(s[95]=t(`
julia
mask(A:AbstractRaster; with, missingval=missingval(A))
 mask(x; with)

Return a new array with values of A masked by the missing values of with, or by the shape of with, if with is a geometric object.

Arguments

  • x: a Raster or RasterStack

Keywords

  • with: an AbstractRaster, or any GeoInterface.jl compatible objects or table. The coordinate reference system of the point must match crs(A).

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • missingval: the missing value to use in the returned file.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Geometry keywords

These can be used when with is a GeoInterface.jl compatible object:

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

Mask an unmasked AWAP layer with a masked WorldClim layer, by first resampling the mask.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 
 # Load and plot the file
@@ -201,7 +201,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig(a, "build/mask_example_before.png");
 savefig(b, "build/mask_example_after.png"); nothing
-# output

Before mask:

After mask:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,16))]),i("details",rs,[i("summary",null,[s[96]||(s[96]=i("a",{id:"Rasters.missingmask-Tuple{Any}",href:"#Rasters.missingmask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.missingmask")],-1)),s[97]||(s[97]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[98]||(s[98]=t(`
julia
missingmask(obj::Raster; kw...)
+# output

Before mask:

After mask:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,16))]),i("details",rs,[i("summary",null,[s[96]||(s[96]=i("a",{id:"Rasters.missingmask-Tuple{Any}",href:"#Rasters.missingmask-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.missingmask")],-1)),s[97]||(s[97]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[98]||(s[98]=t(`
julia
missingmask(obj::Raster; kw...)
 missingmask(obj; [to, res, size, collapse])
 missingmask(obj::RasterStack; alllayers = true, kw...)

Create a mask array of missing and true values, from another Raster. AbstractRasterStack or AbstractRasterSeries are also accepted-

For AbstractRaster the default missingval is missingval(A), but others can be chosen manually.

The array returned from calling missingmask on a AbstractRaster is a Raster with the same size and fields as the original array.

Arguments

  • obj: a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • alllayers: if true a mask is taken for all layers, otherwise only the first layer is used. Defaults to true

  • invert: invert the mask, so that areas no missing in with are masked, and areas missing in with are masked.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates
 wc = Raster(WorldClim{Climate}, :prec; month=1)
@@ -209,7 +209,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/missingmask_example.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',13))]),i("details",hs,[i("summary",null,[s[99]||(s[99]=i("a",{id:"Rasters.missingval",href:"#Rasters.missingval"},[i("span",{class:"jlbinding"},"Rasters.missingval")],-1)),s[100]||(s[100]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[101]||(s[101]=t('
julia
missingval(x)

Returns the value representing missing data in the dataset

source

',3))]),i("details",ds,[i("summary",null,[s[102]||(s[102]=i("a",{id:"Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic!")],-1)),s[103]||(s[103]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[104]||(s[104]=t(`
julia
mosaic!(f, x, regions...; missingval, atol)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',13))]),i("details",hs,[i("summary",null,[s[99]||(s[99]=i("a",{id:"Rasters.missingval",href:"#Rasters.missingval"},[i("span",{class:"jlbinding"},"Rasters.missingval")],-1)),s[100]||(s[100]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[101]||(s[101]=t('
julia
missingval(x)

Returns the value representing missing data in the dataset

source

',3))]),i("details",ds,[i("summary",null,[s[102]||(s[102]=i("a",{id:"Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic!-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic!")],-1)),s[103]||(s[103]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[104]||(s[104]=t(`
julia
mosaic!(f, x, regions...; missingval, atol)
 mosaic!(f, x, regions::Tuple; missingval, atol)

Combine regions in x using the function f.

Arguments

  • f a function (e.g. mean, sum, first or last) that is applied to values where regions overlap.

  • x: A Raster or RasterStack. May be a an opened disk-based Raster, the result will be written to disk. With the current algorithm, the read speed is slow.

  • regions: source objects to be joined. These should be memory-backed (use read first), or may experience poor performance. If all objects have the same extent, mosaic is simply a merge.

Keywords

  • missingval: Fills empty areas, and defualts to the \`missingval/ of the first layer.

  • atol: Absolute tolerance for comparison between index values. This is often required due to minor differences in range values due to floating point error. It is not applied to non-float dimensions. A tuple of tolerances may be passed, matching the dimension order.

Example

Cut out Australia and Africa stacks, then combined them into a single stack.

julia
using Rasters, RasterDataSources, ArchGDAL, Statistics, Plots
 st = read(RasterStack(WorldClim{Climate}; month=1))
 aus = st[X=100.0 .. 160.0, Y=-50.0 .. -10.0]
@@ -218,7 +218,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 plot(st)
 savefig("build/mosaic_bang_example.png")
 nothing
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",ks,[i("summary",null,[s[105]||(s[105]=i("a",{id:"Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic")],-1)),s[106]||(s[106]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[107]||(s[107]=t(`
julia
mosaic(f, regions...; missingval, atol)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",ks,[i("summary",null,[s[105]||(s[105]=i("a",{id:"Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}",href:"#Rasters.mosaic-Tuple{Function, Union{AbstractRaster, AbstractRasterStack}, Vararg{Union{AbstractRaster, AbstractRasterStack}}}"},[i("span",{class:"jlbinding"},"Rasters.mosaic")],-1)),s[106]||(s[106]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[107]||(s[107]=t(`
julia
mosaic(f, regions...; missingval, atol)
 mosaic(f, regions; missingval, atol)

Combine regions into a single raster.

Arguments

  • f: A reducing function (mean, sum, first, last etc.) for values where regions overlap.

  • regions: Iterable or splatted Raster or RasterStack.

Keywords

  • missingval: Fills empty areas, and defualts to the missingval of the first region.

  • atol: Absolute tolerance for comparison between index values. This is often required due to minor differences in range values due to floating point error. It is not applied to non-float dimensions. A tuple of tolerances may be passed, matching the dimension order.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

If your mosaic has has apparent line errors, increase the atol value.

Example

Here we cut out Australia and Africa from a stack, and join them with mosaic.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 st = RasterStack(WorldClim{Climate}; month=1);
 
@@ -236,7 +236,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(b, "build/mosaic_example_aus.png")
 savefig(c, "build/mosaic_example_combined.png")
 nothing
-# output

Individual continents

Mosaic of continents

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',17))]),i("details",cs,[i("summary",null,[s[108]||(s[108]=i("a",{id:"Rasters.points-Tuple{AbstractRaster}",href:"#Rasters.points-Tuple{AbstractRaster}"},[i("span",{class:"jlbinding"},"Rasters.points")],-1)),s[109]||(s[109]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[110]||(s[110]=t('
julia
points(A::AbstractRaster; dims=(YDim, XDim), ignore_missing) => Array{Tuple}

Returns a generator of the points in A for dimensions in dims, where points are a tuple of the values in each specified dimension index.

Keywords

  • dims the dimensions to return points from. The first slice of other layers will be used.

  • ignore_missing: wether to ignore missing values in the array when considering points. If true, all points in the dimensions will be returned, if false only the points that are not === missingval(A) will be returned.

The order of dims determines the order of the points.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',7))]),i("details",gs,[i("summary",null,[s[111]||(s[111]=i("a",{id:"Rasters.rasterize",href:"#Rasters.rasterize"},[i("span",{class:"jlbinding"},"Rasters.rasterize")],-1)),s[112]||(s[112]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[113]||(s[113]=t(`
julia
rasterize([reducer], data; geometrycolumn, kw...)

Rasterize a GeoInterface.jl compatable geometry or feature, or a Tables.jl table with a :geometry column of GeoInterface.jl objects, or points columns specified by geometrycolumn

Arguments

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from data where possible.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note on threading. Performance may be much better with threaded=false if reducer/op are not threadsafe. sum, prod, maximum, minimum count and mean (by combining sum and count) are threadsafe. If you know your algorithm is threadsafe, use threadsafe=true to allow all optimisations. Functions passed to fill are always threadsafe, and ignore the threadsafe argument.

Example

Rasterize a shapefile for China and plot, with a border.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, Downloads
+# output

Individual continents

Mosaic of continents

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',17))]),i("details",cs,[i("summary",null,[s[108]||(s[108]=i("a",{id:"Rasters.points-Tuple{AbstractRaster}",href:"#Rasters.points-Tuple{AbstractRaster}"},[i("span",{class:"jlbinding"},"Rasters.points")],-1)),s[109]||(s[109]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[110]||(s[110]=t('
julia
points(A::AbstractRaster; dims=(YDim, XDim), ignore_missing) => Array{Tuple}

Returns a generator of the points in A for dimensions in dims, where points are a tuple of the values in each specified dimension index.

Keywords

  • dims the dimensions to return points from. The first slice of other layers will be used.

  • ignore_missing: wether to ignore missing values in the array when considering points. If true, all points in the dimensions will be returned, if false only the points that are not === missingval(A) will be returned.

The order of dims determines the order of the points.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',7))]),i("details",gs,[i("summary",null,[s[111]||(s[111]=i("a",{id:"Rasters.rasterize",href:"#Rasters.rasterize"},[i("span",{class:"jlbinding"},"Rasters.rasterize")],-1)),s[112]||(s[112]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[113]||(s[113]=t(`
julia
rasterize([reducer], data; geometrycolumn, kw...)

Rasterize a GeoInterface.jl compatable geometry or feature, or a Tables.jl table with a :geometry column of GeoInterface.jl objects, or points columns specified by geometrycolumn

Arguments

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from data where possible.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note on threading. Performance may be much better with threaded=false if reducer/op are not threadsafe. sum, prod, maximum, minimum count and mean (by combining sum and count) are threadsafe. If you know your algorithm is threadsafe, use threadsafe=true to allow all optimisations. Functions passed to fill are always threadsafe, and ignore the threadsafe argument.

Example

Rasterize a shapefile for China and plot, with a border.

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, Downloads
 using Rasters.Lookups
 
 # Download a borders shapefile
@@ -256,7 +256,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/china_rasterized.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",ys,[i("summary",null,[s[114]||(s[114]=i("a",{id:"Rasters.rasterize!",href:"#Rasters.rasterize!"},[i("span",{class:"jlbinding"},"Rasters.rasterize!")],-1)),s[115]||(s[115]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[116]||(s[116]=t(`
julia
rasterize!([reducer], dest, data; kw...)

Rasterize the geometries in data into the Raster or RasterStack dest, using the values specified by fill.

Arguments

  • dest: a Raster or RasterStack to rasterize into.

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from A and data where possible.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, GeoInterface, Downloads
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',14))]),i("details",ys,[i("summary",null,[s[114]||(s[114]=i("a",{id:"Rasters.rasterize!",href:"#Rasters.rasterize!"},[i("span",{class:"jlbinding"},"Rasters.rasterize!")],-1)),s[115]||(s[115]=e()),n(a,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[116]||(s[116]=t(`
julia
rasterize!([reducer], dest, data; kw...)

Rasterize the geometries in data into the Raster or RasterStack dest, using the values specified by fill.

Arguments

  • dest: a Raster or RasterStack to rasterize into.

  • reducer: a reducing function to reduce the fill value for all geometries that cover or touch a pixel down to a single value. The default is last. Any that takes an iterable and returns a single value will work, including custom functions. However, there are optimisations for built-in methods including sum, first, last, minimum, maximum, extrema and Statistics.mean. These may be an order of magnitude or more faster than count is a special-cased as it does not need a fill value.

  • data: a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

These are detected automatically from A and data where possible.

  • fill: the value or values to fill a polygon with. A Symbol or tuple of Symbol will be used to retrieve properties from features or column values from table rows. An array or other iterable will be used for each geometry, in order. fill can also be a function of the current value, e.g. x -> x + 1.

  • op: A reducing function that accepts two values and returns one, like min to minimum. For common methods this will be assigned for you, or is not required. But you can use it instead of a reducer as it will usually be faster.

  • shape: force data to be treated as :polygon, :line or :point, where possible Points can't be treated as lines or polygons, and lines may not work as polygons, but an attempt will be made.

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

  • progress: show a progress bar, true by default, false to hide..

  • verbose: print information and warnings when there are problems with the rasterisation. true by default.

  • threaded: run operations in parallel, false by default. In some circumstances threaded can give large speedups over single-threaded operation. This can be true for complicated geometries written into low-resolution rasters, but may not be for simple geometries with high-resolution rasters. With very large rasters threading may be counter productive due to excessive memory use. Caution should also be used: threaded should not be used in in-place functions writing to BitArray or other arrays where race conditions can occur.

  • threadsafe: specify that custom reducer and/or op functions are thread-safe, in that the order of operation or blocking does not matter. For example, sum and maximum are thread-safe, because the answer is approximately (besides floating point error) the same after running on nested blocks, or on all the data. In contrast, median or last are not, because the blocking (median) or order (last) matters.

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from the geometries, Additionally, when no to object or an Extent is passed for to, the size or res keyword must also be used.

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • shape: Force data to be treated as :polygon, :line or :point geometries. using points or lines as polygons may have unexpected results.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the polygon :touches the pixel, or that are completely :inside the polygon. The default is :center.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Plots, Dates, Shapefile, GeoInterface, Downloads
 using Rasters.Lookups
 
 # Download a borders shapefile
@@ -284,12 +284,12 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 
 savefig("build/indonesia_rasterized.png"); nothing
 
-# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",Es,[i("summary",null,[s[117]||(s[117]=i("a",{id:"Rasters.replace_missing-Tuple{Any}",href:"#Rasters.replace_missing-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.replace_missing")],-1)),s[118]||(s[118]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[119]||(s[119]=t(`
julia
replace_missing(a::AbstractRaster, newmissingval)
+# output

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',12))]),i("details",Es,[i("summary",null,[s[117]||(s[117]=i("a",{id:"Rasters.replace_missing-Tuple{Any}",href:"#Rasters.replace_missing-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.replace_missing")],-1)),s[118]||(s[118]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[119]||(s[119]=t(`
julia
replace_missing(a::AbstractRaster, newmissingval)
 replace_missing(a::AbstractRasterStack, newmissingval)

Replace missing values in the array or stack with a new missing value, also updating the missingval field/s.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Example

julia
using Rasters, RasterDataSources, ArchGDAL
 A = Raster(WorldClim{Climate}, :prec; month=1) |> replace_missing
 missingval(A)
 # output
-missing

source

`,7))]),i("details",us,[i("summary",null,[s[120]||(s[120]=i("a",{id:"Rasters.reproject-NTuple{4, Any}",href:"#Rasters.reproject-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[121]||(s[121]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[122]||(s[122]=t('
julia
reproject(source::GeoFormat, target::GeoFormat, dim::Dimension, val)

reproject uses Proj.jl's Transformation interface, but implemented for reprojecting a lookup / axis array, a single dimension at a time.

source

',3))]),i("details",ms,[i("summary",null,[s[123]||(s[123]=i("a",{id:"Rasters.reproject-Tuple{Any}",href:"#Rasters.reproject-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[124]||(s[124]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[125]||(s[125]=t('
julia
reproject(obj; crs)

Reproject the lookups (axes) of obj to a different crs.

This is a lossless operation for the raster data, as only the lookup values change. This is only possible when the axes of source and destination projections are aligned: the change is usually from a Regular and an Irregular lookup spans.

For converting between projections that are rotated, skewed or warped in any way, or if you want to re-sample the data, use resample.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are silently returned without modification.

Arguments

  • obj: a Lookup, Dimension, Tuple of Dimension, Raster or RasterStack.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

source

',8))]),i("details",bs,[i("summary",null,[s[126]||(s[126]=i("a",{id:"Rasters.resample-Tuple",href:"#Rasters.resample-Tuple"},[i("span",{class:"jlbinding"},"Rasters.resample")],-1)),s[127]||(s[127]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[128]||(s[128]=t(`
julia
resample(x; kw...)
+missing

source

`,7))]),i("details",us,[i("summary",null,[s[120]||(s[120]=i("a",{id:"Rasters.reproject-NTuple{4, Any}",href:"#Rasters.reproject-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[121]||(s[121]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[122]||(s[122]=t('
julia
reproject(source::GeoFormat, target::GeoFormat, dim::Dimension, val)

reproject uses Proj.jl's Transformation interface, but implemented for reprojecting a lookup / axis array, a single dimension at a time.

source

',3))]),i("details",ms,[i("summary",null,[s[123]||(s[123]=i("a",{id:"Rasters.reproject-Tuple{Any}",href:"#Rasters.reproject-Tuple{Any}"},[i("span",{class:"jlbinding"},"Rasters.reproject")],-1)),s[124]||(s[124]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[125]||(s[125]=t('
julia
reproject(obj; crs)

Reproject the lookups (axes) of obj to a different crs.

This is a lossless operation for the raster data, as only the lookup values change. This is only possible when the axes of source and destination projections are aligned: the change is usually from a Regular and an Irregular lookup spans.

For converting between projections that are rotated, skewed or warped in any way, or if you want to re-sample the data, use resample.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are silently returned without modification.

Arguments

  • obj: a Lookup, Dimension, Tuple of Dimension, Raster or RasterStack.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

source

',8))]),i("details",bs,[i("summary",null,[s[126]||(s[126]=i("a",{id:"Rasters.resample-Tuple",href:"#Rasters.resample-Tuple"},[i("span",{class:"jlbinding"},"Rasters.resample")],-1)),s[127]||(s[127]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[128]||(s[128]=t(`
julia
resample(x; kw...)
 resample(xs...; to=first(xs), kw...)

resample uses warp (which uses GDALs gdalwarp) to resample a Raster or RasterStack to a new resolution and optionally new crs, or to snap to the bounds, resolution and crs of the object to.

Dimensions without an AbstractProjected lookup (such as a Ti dimension) are iteratively resampled with GDAL and joined back into a single array.

If projections can be converted for each axis independently, it may be faster and more accurate to use reproject.

Run using ArchGDAL to make this method available.

Arguments

  • x: the object/s to resample.

Keywords

  • to: a Raster, RasterStack, Tuple of Dimension or Extents.Extent. If no to object is provided the extent will be calculated from x,

  • res: the resolution of the dimensions (often in meters or degrees), a Real or Tuple{<:Real,<:Real}. Only required when to is not used or is an Extents.Extent, and size is not used.

  • size: the size of the output array, as a Tuple{Int,Int} or single Int for a square. Only required when to is not used or is an Extents.Extent, and res is not used.

  • crs: a crs which will be attached to the resulting raster when to not passed or is an Extent. Otherwise the crs from to is used.

  • method: A Symbol or String specifying the method to use for resampling. From the docs for gdalwarp:

    • :near: nearest neighbour resampling (default, fastest algorithm, worst interpolation quality).

    • :bilinear: bilinear resampling.

    • :cubic: cubic resampling.

    • :cubicspline: cubic spline resampling.

    • :lanczos: Lanczos windowed sinc resampling.

    • :average: average resampling, computes the weighted average of all non-NODATA contributing pixels. rms root mean square / quadratic mean of all non-NODATA contributing pixels (GDAL >= 3.3)

    • :mode: mode resampling, selects the value which appears most often of all the sampled points.

    • :max: maximum resampling, selects the maximum value from all non-NODATA contributing pixels.

    • :min: minimum resampling, selects the minimum value from all non-NODATA contributing pixels.

    • :med: median resampling, selects the median value of all non-NODATA contributing pixels.

    • :q1: first quartile resampling, selects the first quartile value of all non-NODATA contributing pixels.

    • :q3: third quartile resampling, selects the third quartile value of all non-NODATA contributing pixels.

    • :sum: compute the weighted sum of all non-NODATA contributing pixels (since GDAL 3.1)

    Where NODATA values are set to missingval.

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Note:

  • GDAL may cause some unexpected changes in the raster, such as changing the crs type from EPSG to WellKnownText (it will represent the same CRS).

Example

Resample a WorldClim layer to match an EarthEnv layer:

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{Climate}, :prec; month=1)
 B = Raster(EarthEnv{HabitatHeterogeneity}, :evenness)
@@ -300,7 +300,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/resample_example_before.png");
 savefig(b, "build/resample_example_after.png"); nothing
 
-# output

Before resample:

After resample:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',20))]),i("details",Fs,[i("summary",null,[s[129]||(s[129]=i("a",{id:"Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setcrs")],-1)),s[130]||(s[130]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[131]||(s[131]=t('
julia
setcrs(x, crs)

Set the crs of a Raster, RasterStack, Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",fs,[i("summary",null,[s[132]||(s[132]=i("a",{id:"Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setmappedcrs")],-1)),s[133]||(s[133]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[134]||(s[134]=t('
julia
setmappedcrs(x, crs)

Set the mapped crs of a Raster, a RasterStack, a Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",Cs,[i("summary",null,[s[135]||(s[135]=i("a",{id:"Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.slice")],-1)),s[136]||(s[136]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[137]||(s[137]=t('
julia
slice(A::Union{AbstractRaster,AbstractRasterStack,AbstracRasterSeries}, dims) => RasterSeries

Slice views along some dimension/s to obtain a RasterSeries of the slices.

For a Raster or RasterStack this will return a RasterSeries of Raster or RasterStack that are slices along the specified dimensions.

For a RasterSeries, the output is another series where the child objects are sliced and the series dimensions index is now of the child dimensions combined. slice on a RasterSeries with no dimensions will slice along the dimensions shared by both the series and child object.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",As,[i("summary",null,[s[138]||(s[138]=i("a",{id:"Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.trim")],-1)),s[139]||(s[139]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[140]||(s[140]=t(`
julia
trim(x; dims::Tuple, pad::Int)

Trim missingval(x) from x for axes in dims, returning a view of x.

Arguments

  • x: A Raster or RasterStack. For stacks, all layers must having missing values for a pixel for it to be trimmed.

Keywords

  • dims: By default dims=(XDim, YDim), so that trimming keeps the area of X and Y that contains non-missing values along all other dimensions.

  • pad: The trimmed size will be padded by pad on all sides, although padding will not be added beyond the original extent of the array.

As trim is lazy, filename and suffix keywords are not used.

Example

Create trimmed layers of Australian habitat heterogeneity.

julia
using Rasters, RasterDataSources, Plots
+# output

Before resample:

After resample:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',20))]),i("details",Fs,[i("summary",null,[s[129]||(s[129]=i("a",{id:"Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setcrs")],-1)),s[130]||(s[130]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[131]||(s[131]=t('
julia
setcrs(x, crs)

Set the crs of a Raster, RasterStack, Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",fs,[i("summary",null,[s[132]||(s[132]=i("a",{id:"Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.setmappedcrs-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.setmappedcrs")],-1)),s[133]||(s[133]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[134]||(s[134]=t('
julia
setmappedcrs(x, crs)

Set the mapped crs of a Raster, a RasterStack, a Tuple of Dimension, or a Dimension. The crs is expected to be a GeoFormatTypes.jl CRS or Mixed GeoFormat type

source

',3))]),i("details",Cs,[i("summary",null,[s[135]||(s[135]=i("a",{id:"Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}",href:"#Rasters.slice-Tuple{Union{AbstractRaster, AbstractRasterStack}, Any}"},[i("span",{class:"jlbinding"},"Rasters.slice")],-1)),s[136]||(s[136]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[137]||(s[137]=t('
julia
slice(A::Union{AbstractRaster,AbstractRasterStack,AbstracRasterSeries}, dims) => RasterSeries

Slice views along some dimension/s to obtain a RasterSeries of the slices.

For a Raster or RasterStack this will return a RasterSeries of Raster or RasterStack that are slices along the specified dimensions.

For a RasterSeries, the output is another series where the child objects are sliced and the series dimensions index is now of the child dimensions combined. slice on a RasterSeries with no dimensions will slice along the dimensions shared by both the series and child object.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',6))]),i("details",As,[i("summary",null,[s[138]||(s[138]=i("a",{id:"Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.trim-Tuple{Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.trim")],-1)),s[139]||(s[139]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[140]||(s[140]=t(`
julia
trim(x; dims::Tuple, pad::Int)

Trim missingval(x) from x for axes in dims, returning a view of x.

Arguments

  • x: A Raster or RasterStack. For stacks, all layers must having missing values for a pixel for it to be trimmed.

Keywords

  • dims: By default dims=(XDim, YDim), so that trimming keeps the area of X and Y that contains non-missing values along all other dimensions.

  • pad: The trimmed size will be padded by pad on all sides, although padding will not be added beyond the original extent of the array.

As trim is lazy, filename and suffix keywords are not used.

Example

Create trimmed layers of Australian habitat heterogeneity.

julia
using Rasters, RasterDataSources, Plots
 layers = (:evenness, :range, :contrast, :correlation)
 st = RasterStack(EarthEnv{HabitatHeterogeneity}, layers)
 
@@ -315,7 +315,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/trim_example_before.png");
 savefig(b, "build/trim_example_after.png"); nothing
 
-# output

Before trim:

After trim:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',16))]),i("details",Rs,[i("summary",null,[s[141]||(s[141]=i("a",{id:"Rasters.warp-Tuple",href:"#Rasters.warp-Tuple"},[i("span",{class:"jlbinding"},"Rasters.warp")],-1)),s[142]||(s[142]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[143]||(s[143]=t(`
julia
warp(A::AbstractRaster, flags::Dict; kw...)

Gives access to the GDALs gdalwarp method given a Dict of flag => value arguments that can be converted to strings, or vectors where multiple space-separated arguments are required.

Arrays with additional dimensions not handled by GDAL (other than X, Y, Band) are sliced, warped, and then combined to match the original array dimensions. These slices will not be written to disk and loaded lazily at this stage - you will need to do that manually if required.

See the gdalwarp docs for a list of arguments.

Run using ArchGDAL to make this method available.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Any additional keywords are passed to ArchGDAL.Dataset.

Example

This simply resamples the array with the :tr (output file resolution) and :r flags, giving us a pixelated version:

julia
using Rasters, RasterDataSources, Plots
+# output

Before trim:

After trim:

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',16))]),i("details",Rs,[i("summary",null,[s[141]||(s[141]=i("a",{id:"Rasters.warp-Tuple",href:"#Rasters.warp-Tuple"},[i("span",{class:"jlbinding"},"Rasters.warp")],-1)),s[142]||(s[142]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[143]||(s[143]=t(`
julia
warp(A::AbstractRaster, flags::Dict; kw...)

Gives access to the GDALs gdalwarp method given a Dict of flag => value arguments that can be converted to strings, or vectors where multiple space-separated arguments are required.

Arrays with additional dimensions not handled by GDAL (other than X, Y, Band) are sliced, warped, and then combined to match the original array dimensions. These slices will not be written to disk and loaded lazily at this stage - you will need to do that manually if required.

See the gdalwarp docs for a list of arguments.

Run using ArchGDAL to make this method available.

Keywords

  • filename: a filename to write to directly, useful for large files.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

Any additional keywords are passed to ArchGDAL.Dataset.

Example

This simply resamples the array with the :tr (output file resolution) and :r flags, giving us a pixelated version:

julia
using Rasters, RasterDataSources, Plots
 A = Raster(WorldClim{Climate}, :prec; month=1)
 a = plot(A)
 
@@ -328,7 +328,7 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
 savefig(a, "build/warp_example_before.png");
 savefig(b, "build/warp_example_after.png"); nothing
 
-# output

Before warp:

After warp:

In practise, prefer resample for this. But warp may be more flexible.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",vs,[i("summary",null,[s[144]||(s[144]=i("a",{id:"Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.zonal")],-1)),s[145]||(s[145]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[146]||(s[146]=t(`
julia
zonal(f, x::Union{Raster,RasterStack}; of, kw...)

Calculate zonal statistics for the the zone of a Raster or RasterStack covered by the of object/s.

Arguments

  • f: any function that reduces an iterable to a single value, such as sum or Statistics.mean

  • x: A Raster or RasterStack

  • of: A DimTuple, Extent, a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

These can be used when of is or contains (a) GeoInterface.jl compatible object(s):

  • shape: Force data to be treated as :polygon, :line or :point, where possible.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

  • progress: show a progress bar, true by default, false to hide..

  • skipmissing: wether to apply f to the result of skipmissing(A) or not. If true f will be passed an iterator over the values, which loses all spatial information. if false f will be passes a masked Raster or RasterStack, and will be responsible for handling missing values itself. The default value is true.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Shapefile, DataFrames, Downloads, Statistics, Dates
+# output

Before warp:

After warp:

In practise, prefer resample for this. But warp may be more flexible.

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

',18))]),i("details",vs,[i("summary",null,[s[144]||(s[144]=i("a",{id:"Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}",href:"#Rasters.zonal-Tuple{Any, Union{AbstractRaster, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Rasters.zonal")],-1)),s[145]||(s[145]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[146]||(s[146]=t(`
julia
zonal(f, x::Union{Raster,RasterStack}; of, kw...)

Calculate zonal statistics for the the zone of a Raster or RasterStack covered by the of object/s.

Arguments

  • f: any function that reduces an iterable to a single value, such as sum or Statistics.mean

  • x: A Raster or RasterStack

  • of: A DimTuple, Extent, a Raster or one or multiple geometries. Geometries can be a GeoInterface.jl AbstractGeometry, a nested Vector of AbstractGeometry, or a Tables.jl compatible object containing a :geometry column or points and values columns, in which case geometrycolumn must be specified.

Keywords

  • geometrycolumn: Symbol to manually select the column the geometries are in when data is a Tables.jl compatible table, or a tuple of Symbol for columns of point coordinates.

These can be used when of is or contains (a) GeoInterface.jl compatible object(s):

  • shape: Force data to be treated as :polygon, :line or :point, where possible.

  • boundary: for polygons, include pixels where the :center is inside the polygon, where the line :touches the pixel, or that are completely :inside inside the polygon. The default is :center.

  • progress: show a progress bar, true by default, false to hide..

  • skipmissing: wether to apply f to the result of skipmissing(A) or not. If true f will be passed an iterator over the values, which loses all spatial information. if false f will be passes a masked Raster or RasterStack, and will be responsible for handling missing values itself. The default value is true.

Example

julia
using Rasters, RasterDataSources, ArchGDAL, Shapefile, DataFrames, Downloads, Statistics, Dates
 
 # Download a borders shapefile
 ne_url = "https://github.com/nvkelso/natural-earth-vector/raw/master/10m_cultural/ne_10m_admin_0_countries"
@@ -370,17 +370,17 @@ import{_ as l,c as p,a5 as t,j as i,a as e,G as n,B as o,o as r}from"./chunks/fr
  256 │ Bajo Nuevo Bank               NaN        NaN        NaN        NaN
  257 │ Serranilla Bank               NaN        NaN        NaN        NaN
  258 │ Scarborough Reef              NaN        NaN        NaN        NaN
-                                                  3 columns and 243 rows omitted

source

`,11))]),s[193]||(s[193]=i("h2",{id:"Reference-Internal-functions",tabindex:"-1"},[e("Reference - Internal functions "),i("a",{class:"header-anchor",href:"#Reference-Internal-functions","aria-label":'Permalink to "Reference - Internal functions {#Reference-Internal-functions}"'},"​")],-1)),i("details",Ds,[i("summary",null,[s[147]||(s[147]=i("a",{id:"Rasters.AbstractProjected",href:"#Rasters.AbstractProjected"},[i("span",{class:"jlbinding"},"Rasters.AbstractProjected")],-1)),s[148]||(s[148]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[149]||(s[149]=t('
julia
AbstractProjected <: AbstractSampled

Abstract supertype for projected index lookups.

source

',3))]),i("details",js,[i("summary",null,[s[150]||(s[150]=i("a",{id:"Rasters.FileArray",href:"#Rasters.FileArray"},[i("span",{class:"jlbinding"},"Rasters.FileArray")],-1)),s[151]||(s[151]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[152]||(s[152]=t('
julia
FileArray{S} <: DiskArrays.AbstractDiskArray

Filearray is a DiskArrays.jl AbstractDiskArray. Instead of holding an open object, it just holds a filename string that is opened lazily when it needs to be read.

source

',3))]),i("details",Bs,[i("summary",null,[s[153]||(s[153]=i("a",{id:"Rasters.FileStack",href:"#Rasters.FileStack"},[i("span",{class:"jlbinding"},"Rasters.FileStack")],-1)),s[154]||(s[154]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[155]||(s[155]=t(`
julia
FileStack{S,Na}
+                                                  3 columns and 243 rows omitted

source

`,11))]),s[193]||(s[193]=i("h2",{id:"Reference-Internal-functions",tabindex:"-1"},[e("Reference - Internal functions "),i("a",{class:"header-anchor",href:"#Reference-Internal-functions","aria-label":'Permalink to "Reference - Internal functions {#Reference-Internal-functions}"'},"​")],-1)),i("details",Ds,[i("summary",null,[s[147]||(s[147]=i("a",{id:"Rasters.AbstractProjected",href:"#Rasters.AbstractProjected"},[i("span",{class:"jlbinding"},"Rasters.AbstractProjected")],-1)),s[148]||(s[148]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[149]||(s[149]=t('
julia
AbstractProjected <: AbstractSampled

Abstract supertype for projected index lookups.

source

',3))]),i("details",js,[i("summary",null,[s[150]||(s[150]=i("a",{id:"Rasters.FileArray",href:"#Rasters.FileArray"},[i("span",{class:"jlbinding"},"Rasters.FileArray")],-1)),s[151]||(s[151]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[152]||(s[152]=t('
julia
FileArray{S} <: DiskArrays.AbstractDiskArray

Filearray is a DiskArrays.jl AbstractDiskArray. Instead of holding an open object, it just holds a filename string that is opened lazily when it needs to be read.

source

',3))]),i("details",Bs,[i("summary",null,[s[153]||(s[153]=i("a",{id:"Rasters.FileStack",href:"#Rasters.FileStack"},[i("span",{class:"jlbinding"},"Rasters.FileStack")],-1)),s[154]||(s[154]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[155]||(s[155]=t(`
julia
FileStack{S,Na}
 
-FileStack{S,Na}(filename, types, sizes, eachchunk, haschunks, write)

A wrapper object that holds file pointer and size/chunking metadata for a multi-layered stack stored in a single file, typically netcdf or hdf5.

S is a backend type like NCDsource, and Na is a tuple of Symbol keys.

source

`,4))]),i("details",ws,[i("summary",null,[s[156]||(s[156]=i("a",{id:"Rasters.OpenStack",href:"#Rasters.OpenStack"},[i("span",{class:"jlbinding"},"Rasters.OpenStack")],-1)),s[157]||(s[157]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[158]||(s[158]=t(`
julia
OpenStack{X,K}
+FileStack{S,Na}(filename, types, sizes, eachchunk, haschunks, write)

A wrapper object that holds file pointer and size/chunking metadata for a multi-layered stack stored in a single file, typically netcdf or hdf5.

S is a backend type like NCDsource, and Na is a tuple of Symbol keys.

source

`,4))]),i("details",ws,[i("summary",null,[s[156]||(s[156]=i("a",{id:"Rasters.OpenStack",href:"#Rasters.OpenStack"},[i("span",{class:"jlbinding"},"Rasters.OpenStack")],-1)),s[157]||(s[157]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[158]||(s[158]=t(`
julia
OpenStack{X,K}
 
-OpenStack{X,K}(dataset)

A wrapper for any stack-like opened dataset that can be indexed with Symbol keys to retrieve AbstractArray layers.

OpenStack is usually hidden from users, wrapped in a regular RasterStack passed as the function argument in open(stack) when the stack is contained in a single file.

X is a backend type like NCDsource, and K is a tuple of Symbol keys.

source

`,5))]),i("details",xs,[i("summary",null,[s[159]||(s[159]=i("a",{id:"Rasters.RasterDiskArray",href:"#Rasters.RasterDiskArray"},[i("span",{class:"jlbinding"},"Rasters.RasterDiskArray")],-1)),s[160]||(s[160]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[161]||(s[161]=t('
julia
RasterDiskArray <: DiskArrays.AbstractDiskArray

A basic DiskArrays.jl wrapper for objects that don't have one defined yet. When we open a FileArray it is replaced with a RasterDiskArray.

source

',3))]),i("details",Ts,[i("summary",null,[s[162]||(s[162]=i("a",{id:"Base.open-Tuple{Function, AbstractRaster}",href:"#Base.open-Tuple{Function, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.open")],-1)),s[163]||(s[163]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[164]||(s[164]=t(`
julia
open(f, A::AbstractRaster; write=false)

open is used to open any lazy=true AbstractRaster and do multiple operations on it in a safe way. The write keyword opens the file in write lookup so that it can be altered on disk using e.g. a broadcast.

f is a method that accepts a single argument - an Raster object which is just an AbstractRaster that holds an open disk-based object. Often it will be a do block:

lazy=false (in-memory) rasters will ignore open and pass themselves to f.

julia
# A is an \`Raster\` wrapping the opened disk-based object.
+OpenStack{X,K}(dataset)

A wrapper for any stack-like opened dataset that can be indexed with Symbol keys to retrieve AbstractArray layers.

OpenStack is usually hidden from users, wrapped in a regular RasterStack passed as the function argument in open(stack) when the stack is contained in a single file.

X is a backend type like NCDsource, and K is a tuple of Symbol keys.

source

`,5))]),i("details",xs,[i("summary",null,[s[159]||(s[159]=i("a",{id:"Rasters.RasterDiskArray",href:"#Rasters.RasterDiskArray"},[i("span",{class:"jlbinding"},"Rasters.RasterDiskArray")],-1)),s[160]||(s[160]=e()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[161]||(s[161]=t('
julia
RasterDiskArray <: DiskArrays.AbstractDiskArray

A basic DiskArrays.jl wrapper for objects that don't have one defined yet. When we open a FileArray it is replaced with a RasterDiskArray.

source

',3))]),i("details",Ts,[i("summary",null,[s[162]||(s[162]=i("a",{id:"Base.open-Tuple{Function, AbstractRaster}",href:"#Base.open-Tuple{Function, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.open")],-1)),s[163]||(s[163]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[164]||(s[164]=t(`
julia
open(f, A::AbstractRaster; write=false)

open is used to open any lazy=true AbstractRaster and do multiple operations on it in a safe way. The write keyword opens the file in write lookup so that it can be altered on disk using e.g. a broadcast.

f is a method that accepts a single argument - an Raster object which is just an AbstractRaster that holds an open disk-based object. Often it will be a do block:

lazy=false (in-memory) rasters will ignore open and pass themselves to f.

julia
# A is an \`Raster\` wrapping the opened disk-based object.
 open(Raster(filepath); write=true) do A
     mask!(A; with=maskfile)
     A[I...] .*= 2
     # ...  other things you need to do with the open file
-end

By using a do block to open files we ensure they are always closed again after we finish working with them.

source

`,7))]),i("details",Ss,[i("summary",null,[s[165]||(s[165]=i("a",{id:"Base.read!-Tuple{AbstractRaster, AbstractArray}",href:"#Base.read!-Tuple{AbstractRaster, AbstractArray}"},[i("span",{class:"jlbinding"},"Base.read!")],-1)),s[166]||(s[166]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[167]||(s[167]=t(`
julia
read!(src::Union{AbstractString,AbstractRaster}, dst::AbstractRaster)
+end

By using a do block to open files we ensure they are always closed again after we finish working with them.

source

`,7))]),i("details",Ss,[i("summary",null,[s[165]||(s[165]=i("a",{id:"Base.read!-Tuple{AbstractRaster, AbstractArray}",href:"#Base.read!-Tuple{AbstractRaster, AbstractArray}"},[i("span",{class:"jlbinding"},"Base.read!")],-1)),s[166]||(s[166]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[167]||(s[167]=t(`
julia
read!(src::Union{AbstractString,AbstractRaster}, dst::AbstractRaster)
 read!(src::Union{AbstractString,AbstractRasterStack}, dst::AbstractRasterStack)
-read!(scr::AbstractRasterSeries, dst::AbstractRasterSeries)

read! will copy the data from src to the object dst.

src can be an object or a file-path String.

source

`,4))]),i("details",qs,[i("summary",null,[s[168]||(s[168]=i("a",{id:"Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Base.read")],-1)),s[169]||(s[169]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[170]||(s[170]=t(`
julia
read(A::AbstractRaster)
+read!(scr::AbstractRasterSeries, dst::AbstractRasterSeries)

read! will copy the data from src to the object dst.

src can be an object or a file-path String.

source

`,4))]),i("details",qs,[i("summary",null,[s[168]||(s[168]=i("a",{id:"Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}",href:"#Base.read-Tuple{Union{AbstractRaster, AbstractRasterSeries, AbstractRasterStack}}"},[i("span",{class:"jlbinding"},"Base.read")],-1)),s[169]||(s[169]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[170]||(s[170]=t(`
julia
read(A::AbstractRaster)
 read(A::AbstractRasterStack)
-read(A::AbstractRasterSeries)

read will move a Rasters.jl object completely to memory.

Keywords

  • checkmemory: If true (the default), check if there is enough memory for the operation. false will ignore memory needs.

source

`,5))]),i("details",Ls,[i("summary",null,[s[171]||(s[171]=i("a",{id:"Base.skipmissing-Tuple{Raster}",href:"#Base.skipmissing-Tuple{Raster}"},[i("span",{class:"jlbinding"},"Base.skipmissing")],-1)),s[172]||(s[172]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[173]||(s[173]=t('
julia
skipmissing(itr::Raster)

Returns an iterable over the elements in a Raster object, skipping any values equal to either the missingval or missing.

source

',3))]),i("details",Is,[i("summary",null,[s[174]||(s[174]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterSeries}",href:"#Base.write-Tuple{AbstractString, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[175]||(s[175]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[176]||(s[176]=t('
julia
Base.write(filepath::AbstractString, s::AbstractRasterSeries; kw...)

Write any AbstractRasterSeries to multiple files, guessing the backend from the file extension.

The lookup values of the series will be appended to the filepath (before the extension), separated by underscores.

All keywords are passed through to these Raster and RasterStack methods.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For series with RasterStack child objects, this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • vebose: whether to print messages about potential problems. true by default.

source

',7))]),i("details",zs,[i("summary",null,[s[177]||(s[177]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterStack}",href:"#Base.write-Tuple{AbstractString, AbstractRasterStack}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[178]||(s[178]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[179]||(s[179]=t('
julia
Base.write(filename::AbstractString, s::AbstractRasterStack; kw...)

Write any AbstractRasterStack to one or multiple files, depending on the backend. Backend is guessed from the filename extension or forced with the source keyword.

If the source can't be saved as a stack-like object, individual array layers will be saved.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • ext: filename extension such as ".tiff" or ".nc". Used to specify specific files if only a directory path is used.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen. For RasterStack this may be a NamedTuple, one for each layer.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

  • suffix: a string or value to append to the filename. A tuple of suffix will be applied to stack layers. keys(stack) are the default.

  • vebose: whether to print messages about potential problems. true by default.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

source

',17))]),i("details",Ps,[i("summary",null,[s[180]||(s[180]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRaster}",href:"#Base.write-Tuple{AbstractString, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[181]||(s[181]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[182]||(s[182]=t('
julia
Base.write(filename::AbstractString, A::AbstractRaster; [source], kw...)

Write an AbstractRaster to file, guessing the backend from the file extension or using the source keyword.

Keywords

  • chunks: a NTuple{N,Int} specifying the chunk size for each dimension. To specify only specific dimensions, a Tuple of Dimension wrapping Int or a NamedTuple of Int can be used. Other dimensions will have a chunk size of 1. true can be used to mean: use the original chunk size of the lazy Raster being written or X and Y of 256 by 256. false means don't use chunks at all.

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • missingval: set the missing value (i.e. FillValue / nodataval) of the written raster, as Julias missing cannot be stored. If not passed in, missingval will be detected from metadata or a default will be chosen.

  • source: Usually automatically detected from filepath extension. To manually force, a Symbol can be passed :gdal, :netcdf, :grd, :grib. The internal Rasters.Source objects, such as Rasters.GDALsource(), Rasters.GRIBsource() or Rasters.NCDsource() can also be used.

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

  • driver: A GDAL driver name String or a GDAL driver retrieved via ArchGDAL.getdriver(drivername). By default driver is guessed from the filename extension.

  • options::Dict{String,String}: A dictionary containing the dataset creation options passed to the driver. For example: Dict("COMPRESS" => "DEFLATE").

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

Returns filename.

source

',17))]),i("details",Gs,[i("summary",null,[s[183]||(s[183]=i("a",{id:"Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}",href:"#Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[184]||(s[184]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[185]||(s[185]=t('
julia
Base.write(filename::AbstractString, ::Type{GRDsource}, s::AbstractRaster; kw...)

Write a Raster to a .grd file with a .gri header file.

This method is called automatically if you write a Raster with a .grd or .gri extension.

Keywords

  • force: false by default. If true it force writing to a file destructively, even if it already exists.

If this method is called directly the extension of filename will be ignored.

Returns the base of filename with a .grd extension.

source

',8))]),i("details",Ns,[i("summary",null,[s[186]||(s[186]=i("a",{id:"Rasters.checkmem!-Tuple{Bool}",href:"#Rasters.checkmem!-Tuple{Bool}"},[i("span",{class:"jlbinding"},"Rasters.checkmem!")],-1)),s[187]||(s[187]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[188]||(s[188]=t('
julia
checkmem!(x::Bool)

Set checkmem to true or false.

In some architectures memory reporting may be wrong and you may wish to disable memory checks.

This setting can be overridden with the checkmem keyword, where applicable.

source

',5))]),i("details",Os,[i("summary",null,[s[189]||(s[189]=i("a",{id:"Rasters.rplot-Tuple",href:"#Rasters.rplot-Tuple"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[190]||(s[190]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[191]||(s[191]=t('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

',5))])])}const Hs=l(x,[["render",Ms]]);export{Ys as __pageData,Hs as default}; +read(A::AbstractRasterSeries)

read will move a Rasters.jl object completely to memory.

Keywords

source

`,5))]),i("details",Ls,[i("summary",null,[s[171]||(s[171]=i("a",{id:"Base.skipmissing-Tuple{Raster}",href:"#Base.skipmissing-Tuple{Raster}"},[i("span",{class:"jlbinding"},"Base.skipmissing")],-1)),s[172]||(s[172]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[173]||(s[173]=t('
julia
skipmissing(itr::Raster)

Returns an iterable over the elements in a Raster object, skipping any values equal to either the missingval or missing.

source

',3))]),i("details",Is,[i("summary",null,[s[174]||(s[174]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterSeries}",href:"#Base.write-Tuple{AbstractString, AbstractRasterSeries}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[175]||(s[175]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[176]||(s[176]=t('
julia
Base.write(filepath::AbstractString, s::AbstractRasterSeries; kw...)

Write any AbstractRasterSeries to multiple files, guessing the backend from the file extension.

The lookup values of the series will be appended to the filepath (before the extension), separated by underscores.

All keywords are passed through to these Raster and RasterStack methods.

Keywords

source

',7))]),i("details",zs,[i("summary",null,[s[177]||(s[177]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRasterStack}",href:"#Base.write-Tuple{AbstractString, AbstractRasterStack}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[178]||(s[178]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[179]||(s[179]=t('
julia
Base.write(filename::AbstractString, s::AbstractRasterStack; kw...)

Write any AbstractRasterStack to one or multiple files, depending on the backend. Backend is guessed from the filename extension or forced with the source keyword.

If the source can't be saved as a stack-like object, individual array layers will be saved.

Keywords

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

source

',17))]),i("details",Ps,[i("summary",null,[s[180]||(s[180]=i("a",{id:"Base.write-Tuple{AbstractString, AbstractRaster}",href:"#Base.write-Tuple{AbstractString, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[181]||(s[181]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[182]||(s[182]=t('
julia
Base.write(filename::AbstractString, A::AbstractRaster; [source], kw...)

Write an AbstractRaster to file, guessing the backend from the file extension or using the source keyword.

Keywords

Other keyword arguments are passed to the write method for the backend.

NetCDF keywords

GDAL Keywords

Valid options for each specific driver can be found at: https://gdal.org/drivers/raster/index.html

Source comments

R grd/grid files

Write a Raster to a .grd file with a .gri header file. Returns the base of filename with a .grd extension.

GDAL (tiff, and everything else)

Used if you write a Raster with a filename extension that no other backend can write. GDAL is the fallback, and writes a lot of file types, but is not guaranteed to work.

Returns filename.

source

',17))]),i("details",Gs,[i("summary",null,[s[183]||(s[183]=i("a",{id:"Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}",href:"#Base.write-Tuple{String, Rasters.GRDsource, AbstractRaster}"},[i("span",{class:"jlbinding"},"Base.write")],-1)),s[184]||(s[184]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[185]||(s[185]=t('
julia
Base.write(filename::AbstractString, ::Type{GRDsource}, s::AbstractRaster; kw...)

Write a Raster to a .grd file with a .gri header file.

This method is called automatically if you write a Raster with a .grd or .gri extension.

Keywords

If this method is called directly the extension of filename will be ignored.

Returns the base of filename with a .grd extension.

source

',8))]),i("details",Ns,[i("summary",null,[s[186]||(s[186]=i("a",{id:"Rasters.checkmem!-Tuple{Bool}",href:"#Rasters.checkmem!-Tuple{Bool}"},[i("span",{class:"jlbinding"},"Rasters.checkmem!")],-1)),s[187]||(s[187]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[188]||(s[188]=t('
julia
checkmem!(x::Bool)

Set checkmem to true or false.

In some architectures memory reporting may be wrong and you may wish to disable memory checks.

This setting can be overridden with the checkmem keyword, where applicable.

source

',5))]),i("details",Os,[i("summary",null,[s[189]||(s[189]=i("a",{id:"Rasters.rplot-Tuple",href:"#Rasters.rplot-Tuple"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[190]||(s[190]=e()),n(a,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[191]||(s[191]=t('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

source

',5))])])}const Hs=l(x,[["render",Ms]]);export{Ys as __pageData,Hs as default}; diff --git a/previews/PR800/assets/app.Cl7j2Oce.js b/previews/PR800/assets/app.53u_OBb6.js similarity index 95% rename from previews/PR800/assets/app.Cl7j2Oce.js rename to previews/PR800/assets/app.53u_OBb6.js index 72b0dd92..8684be68 100644 --- a/previews/PR800/assets/app.Cl7j2Oce.js +++ b/previews/PR800/assets/app.53u_OBb6.js @@ -1 +1 @@ -import{R as p}from"./chunks/theme.Crhm6d51.js";import{R as o,a6 as u,a7 as c,a8 as l,a9 as f,aa as d,ab as m,ac as h,ad as g,ae as A,af as v,d as P,u as R,v as w,s as y,ag as C,ah as b,ai as E,a4 as S}from"./chunks/framework.Gz-llJN4.js";function i(e){if(e.extends){const a=i(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const s=i(p),T=P({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=R();return w(()=>{y(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&C(),b(),E(),s.setup&&s.setup(),()=>S(s.Layout)}});async function D(){globalThis.__VITEPRESS__=!0;const e=j(),a=_();a.provide(c,e);const t=l(e.route);return a.provide(f,t),a.component("Content",d),a.component("ClientOnly",m),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),s.enhanceApp&&await s.enhanceApp({app:a,router:e,siteData:h}),{app:a,router:e,data:t}}function _(){return g(T)}function j(){let e=o,a;return A(t=>{let n=v(t),r=null;return n&&(e&&(a=n),(e||a===n)&&(n=n.replace(/\.js$/,".lean.js")),r=import(n)),o&&(e=!1),r},s.NotFound)}o&&D().then(({app:e,router:a,data:t})=>{a.go().then(()=>{u(a.route,t.site),e.mount("#app")})});export{D as createApp}; +import{R as p}from"./chunks/theme.y-k-N8DM.js";import{R as o,a6 as u,a7 as c,a8 as l,a9 as f,aa as d,ab as m,ac as h,ad as g,ae as A,af as v,d as P,u as R,v as w,s as y,ag as C,ah as b,ai as E,a4 as S}from"./chunks/framework.Gz-llJN4.js";function i(e){if(e.extends){const a=i(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const s=i(p),T=P({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=R();return w(()=>{y(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&C(),b(),E(),s.setup&&s.setup(),()=>S(s.Layout)}});async function D(){globalThis.__VITEPRESS__=!0;const e=j(),a=_();a.provide(c,e);const t=l(e.route);return a.provide(f,t),a.component("Content",d),a.component("ClientOnly",m),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),s.enhanceApp&&await s.enhanceApp({app:a,router:e,siteData:h}),{app:a,router:e,data:t}}function _(){return g(T)}function j(){let e=o,a;return A(t=>{let n=v(t),r=null;return n&&(e&&(a=n),(e||a===n)&&(n=n.replace(/\.js$/,".lean.js")),r=import(n)),o&&(e=!1),r},s.NotFound)}o&&D().then(({app:e,router:a,data:t})=>{a.go().then(()=>{u(a.route,t.site),e.mount("#app")})});export{D as createApp}; diff --git a/previews/PR800/assets/kwihdup.BPZOvOxi.png b/previews/PR800/assets/bgdqfag.BPZOvOxi.png similarity index 100% rename from previews/PR800/assets/kwihdup.BPZOvOxi.png rename to previews/PR800/assets/bgdqfag.BPZOvOxi.png diff --git a/previews/PR800/assets/chunks/@localSearchIndexroot.BI6cvcAk.js b/previews/PR800/assets/chunks/@localSearchIndexroot.BI6cvcAk.js new file mode 100644 index 00000000..87f06cd0 --- /dev/null +++ b/previews/PR800/assets/chunks/@localSearchIndexroot.BI6cvcAk.js @@ -0,0 +1 @@ +const e='{"documentCount":51,"nextId":51,"documentIds":{"0":"/Rasters.jl/previews/PR800/api#index","1":"/Rasters.jl/previews/PR800/api#Reference-Exported-functions","2":"/Rasters.jl/previews/PR800/api#Reference-Internal-functions","3":"/Rasters.jl/previews/PR800/array_operations#Array-operations","4":"/Rasters.jl/previews/PR800/array_operations#Mean-over-the-time-dimension:","5":"/Rasters.jl/previews/PR800/array_operations#broadcasting","6":"/Rasters.jl/previews/PR800/array_operations#Modifying-object-properties","7":"/Rasters.jl/previews/PR800/array_operations#rebuild","8":"/Rasters.jl/previews/PR800/array_operations#replace-missing","9":"/Rasters.jl/previews/PR800/array_operations#set","10":"/Rasters.jl/previews/PR800/data_sources#Data-sources","11":"/Rasters.jl/previews/PR800/data_sources#grd","12":"/Rasters.jl/previews/PR800/data_sources#netcdf","13":"/Rasters.jl/previews/PR800/data_sources#gdal","14":"/Rasters.jl/previews/PR800/data_sources#smap","15":"/Rasters.jl/previews/PR800/data_sources#Writing-file-formats-to-disk","16":"/Rasters.jl/previews/PR800/data_sources#RasterDataSources.jl-integration","17":"/Rasters.jl/previews/PR800/gbif_wflow#GBIF-workflow","18":"/Rasters.jl/previews/PR800/gbif_wflow#Load-GBIF-species-data","19":"/Rasters.jl/previews/PR800/gbif_wflow#Extract-coordinates","20":"/Rasters.jl/previews/PR800/gbif_wflow#Get-layer-/-Band","21":"/Rasters.jl/previews/PR800/get_started#Quick-start","22":"/Rasters.jl/previews/PR800/get_started#Install-the-package-by-typing:","23":"/Rasters.jl/previews/PR800/get_started#Getting-the-lookup-array-from-dimensions","24":"/Rasters.jl/previews/PR800/get_started#Select-by-index","25":"/Rasters.jl/previews/PR800/get_started#Select-by-value","26":"/Rasters.jl/previews/PR800/get_started#Subsetting-an-object","27":"/Rasters.jl/previews/PR800/#installation","28":"/Rasters.jl/previews/PR800/#Packages-extensions","29":"/Rasters.jl/previews/PR800/#Bugs-and-errors","30":"/Rasters.jl/previews/PR800/methods#Methods-that-change-the-resolution-or-extent-of-an-object","31":"/Rasters.jl/previews/PR800/methods#Methods-that-change-an-objects-values","32":"/Rasters.jl/previews/PR800/methods#Point,-polygon-and-table-operation","33":"/Rasters.jl/previews/PR800/methods#Methods-to-load,-write-and-modify-data-sources","34":"/Rasters.jl/previews/PR800/plot_makie#Plotting-in-Makie","35":"/Rasters.jl/previews/PR800/plot_makie#2-D-rasters-in-Makie","36":"/Rasters.jl/previews/PR800/plot_makie#3-D-rasters-in-Makie","37":"/Rasters.jl/previews/PR800/plot_makie#reset-theme","38":"/Rasters.jl/previews/PR800/plot_makie#Plotting-with-Observables,-animations","39":"/Rasters.jl/previews/PR800/plot_makie#Using-vanilla-Makie","40":"/Rasters.jl/previews/PR800/plotting#Plots,-simple","41":"/Rasters.jl/previews/PR800/plotting#Makie,-simple","42":"/Rasters.jl/previews/PR800/plotting#Loading-data","43":"/Rasters.jl/previews/PR800/plotting#Plot-a-contour-plot","44":"/Rasters.jl/previews/PR800/plotting#write-to-disk","45":"/Rasters.jl/previews/PR800/plotting#Polygon-masking,-mosaic-and-plot","46":"/Rasters.jl/previews/PR800/plotting#Download-the-shapefile","47":"/Rasters.jl/previews/PR800/plotting#Load-using-Shapefile.jl","48":"/Rasters.jl/previews/PR800/plotting#Plotting-with-Plots.jl","49":"/Rasters.jl/previews/PR800/tutorials/methods/cellarea#cellarea-tutorial","50":"/Rasters.jl/previews/PR800/tutorials/methods/cellarea#Usage-example"},"fieldIds":{"title":0,"titles":1,"text":2},"fieldLength":{"0":[1,1,48],"1":[3,1,1514],"2":[3,1,499],"3":[2,1,32],"4":[6,2,169],"5":[1,2,157],"6":[3,2,33],"7":[1,5,139],"8":[2,5,114],"9":[1,5,184],"10":[2,1,24],"11":[1,2,30],"12":[1,2,69],"13":[1,2,37],"14":[1,2,67],"15":[5,2,53],"16":[3,2,60],"17":[2,1,33],"18":[4,2,92],"19":[2,2,73],"20":[3,2,236],"21":[2,1,1],"22":[6,2,135],"23":[6,2,21],"24":[3,2,107],"25":[3,2,158],"26":[3,2,118],"27":[1,1,4],"28":[2,1,100],"29":[3,1,163],"30":[10,1,70],"31":[6,1,47],"32":[5,1,19],"33":[8,1,34],"34":[3,1,37],"35":[5,1,137],"36":[5,1,84],"37":[2,1,4],"38":[4,2,174],"39":[3,2,165],"40":[2,1,125],"41":[2,1,20],"42":[2,1,235],"43":[4,2,10],"44":[3,2,59],"45":[5,1,38],"46":[3,1,28],"47":[4,3,144],"48":[4,3,208],"49":[2,1,334],"50":[2,2,239]},"averageFieldLength":[3.156862745098039,1.7450980392156865,130.99999999999997],"storedFields":{"0":{"title":"Index","titles":[]},"1":{"title":"Reference - Exported functions","titles":[]},"2":{"title":"Reference - Internal functions","titles":[]},"3":{"title":"Array operations","titles":[]},"4":{"title":"Mean over the time dimension:","titles":["Array operations"]},"5":{"title":"Broadcasting","titles":["Array operations"]},"6":{"title":"Modifying object properties","titles":["Array operations"]},"7":{"title":"rebuild","titles":["Array operations","Modifying object properties"]},"8":{"title":"replace_missing","titles":["Array operations","Modifying object properties"]},"9":{"title":"set","titles":["Array operations","Modifying object properties"]},"10":{"title":"Data sources","titles":[]},"11":{"title":"GRD","titles":["Data sources"]},"12":{"title":"NetCDF","titles":["Data sources"]},"13":{"title":"GDAL","titles":["Data sources"]},"14":{"title":"SMAP","titles":["Data sources"]},"15":{"title":"Writing file formats to disk","titles":["Data sources"]},"16":{"title":"RasterDataSources.jl integration","titles":["Data sources"]},"17":{"title":"GBIF workflow","titles":[]},"18":{"title":"Load GBIF species data","titles":["GBIF workflow"]},"19":{"title":"Extract coordinates","titles":["GBIF workflow"]},"20":{"title":"Get layer / Band","titles":["GBIF workflow"]},"21":{"title":"Quick start","titles":[]},"22":{"title":"Install the package by typing:","titles":["Quick start"]},"23":{"title":"Getting the lookup array from dimensions","titles":["Quick start"]},"24":{"title":"Select by index","titles":["Quick start"]},"25":{"title":"Select by value","titles":["Quick start"]},"26":{"title":"Subsetting an object","titles":["Quick start"]},"27":{"title":"Installation","titles":[]},"28":{"title":"Packages extensions","titles":[]},"29":{"title":"Bugs and errors","titles":[]},"30":{"title":"Methods that change the resolution or extent of an object","titles":[]},"31":{"title":"Methods that change an objects values","titles":[]},"32":{"title":"Point, polygon and table operation","titles":[]},"33":{"title":"Methods to load, write and modify data sources","titles":[]},"34":{"title":"Plotting in Makie","titles":[]},"35":{"title":"2-D rasters in Makie","titles":[]},"36":{"title":"3-D rasters in Makie","titles":[]},"37":{"title":"reset theme","titles":[]},"38":{"title":"Plotting with Observables, animations","titles":["reset theme"]},"39":{"title":"Using vanilla Makie","titles":["reset theme"]},"40":{"title":"Plots, simple","titles":[]},"41":{"title":"Makie, simple","titles":[]},"42":{"title":"Loading data","titles":[]},"43":{"title":"Plot a contour plot","titles":["Loading data"]},"44":{"title":"write to disk","titles":["Loading data"]},"45":{"title":"Polygon masking, mosaic and plot","titles":[]},"46":{"title":"Download the shapefile","titles":[]},"47":{"title":"Load using Shapefile.jl","titles":["Download the shapefile"]},"48":{"title":"Plotting with Plots.jl","titles":["Download the shapefile"]},"49":{"title":"cellarea tutorial","titles":[]},"50":{"title":"Usage example","titles":["cellarea tutorial"]}},"dirtCount":0,"index":[["↗",{"2":{"22":1,"24":1,"42":2}}],["├─────────────────────┴──────────────────────────────────────────",{"2":{"49":1}}],["├─────────────────────┴──────────────────────────────────────────────────",{"2":{"39":1,"48":1}}],["├───────────────────────┴────────────────────────────────────────",{"2":{"49":2}}],["├───────────────────────┴────────────────────────────────────────────────",{"2":{"47":1}}],["├───────────────────────┴───────────────────────────────────────────────────",{"2":{"1":1,"49":1}}],["├───────────────────────┴─────────────────────────────",{"2":{"24":2,"25":1}}],["├──────────────────────────┴─────────────────────────────────────────────",{"2":{"22":1,"24":1}}],["├──────────────────────────┼─────────┼─────────┼─────────┼──────────┼───────────",{"2":{"18":1}}],["├───────────────────────────────┴────────────────────────────────────────",{"2":{"4":1}}],["├─────────────────────────────────────────────────┴──────────────────────",{"2":{"42":1}}],["├──────────────────────────────────────────────────┴─────────────────────",{"2":{"42":1}}],["├──────────────────────────────────────────────────────────────",{"2":{"49":3}}],["├──────────────────────────────────────────────────────────────────────",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":2,"22":1,"24":1,"35":1,"39":2,"42":2,"47":4,"48":2}}],["├─────────────────────────────────────────────────────────────────────────",{"2":{"1":1,"49":1}}],["├────────────────────────────────────────────────────────────────────",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":2}}],["├───────────────────────────────────────────────────",{"2":{"24":2,"25":1}}],["├──────────────────────────────────┴─────────────────────────────────────",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1}}],["├────────────────────┴───────────────────────────────────────────────────",{"2":{"20":1,"47":1}}],["╭─────────────────────╮",{"2":{"39":1,"48":1,"49":1}}],["╭──────────────────────────╮",{"2":{"22":1,"24":1}}],["╭─────────────────────────────────────────────────╮",{"2":{"42":1}}],["╭──────────────────────────────────────────────────╮",{"2":{"42":1}}],["╭──────────────────────────────────╮",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1}}],["╭───────────────────────────────╮",{"2":{"4":1}}],["╭───────────────────────╮",{"2":{"1":1,"24":2,"25":1,"47":1,"49":3}}],["╭────────────────────╮",{"2":{"20":1,"47":1}}],["└──────────────────────────────────────────────────────────────────────┘",{"2":{"49":3}}],["└──────────────────────────────────────────────────────────────────────────────┘",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"22":1,"24":1,"35":1,"39":1,"42":2,"47":2,"48":1}}],["└─────────────────────────────────────────────────────────────────────────────────┘",{"2":{"1":1,"49":1}}],["└───────────────────────────────────────────────────────────┘",{"2":{"24":2,"25":1}}],["└──────────────────────────┴─────────┴─────────┴─────────┴──────────┴───────────",{"2":{"18":1}}],["┌──────────────────────────┬─────────┬─────────┬─────────┬──────────┬───────────",{"2":{"18":1}}],["⋱",{"2":{"1":1,"4":1,"5":1,"7":1,"8":1,"9":2,"18":1,"35":1,"42":2}}],["⋮",{"2":{"1":6,"4":2,"5":2,"7":2,"8":2,"9":4,"18":6,"19":1,"20":1,"35":2,"42":2}}],["─────┼──────────────────────────────────────────────────────────────────────────",{"2":{"1":1}}],["⋯",{"2":{"1":6,"18":17}}],["^a",{"2":{"1":1}}],["quickly",{"2":{"29":1,"40":1}}],["quick",{"0":{"21":1},"1":{"22":1,"23":1,"24":1,"25":1,"26":1}}],["quot",{"2":{"2":18,"12":4,"13":4,"14":4,"15":2,"38":2,"49":4}}],["quadrant",{"2":{"50":1}}],["quadratic",{"2":{"1":1}}],["quartile",{"2":{"1":4}}],["quality",{"2":{"1":1,"40":1}}],["q3",{"2":{"1":1}}],["q1",{"2":{"1":1}}],["+",{"2":{"1":2}}],["`cellarea`",{"2":{"49":1}}],["`collect`",{"2":{"1":1}}],["`stack`",{"2":{"38":1}}],["`raster`",{"2":{"2":1}}],["`gi",{"2":{"1":1}}],["`missingval",{"2":{"1":1}}],["`missing`",{"2":{"1":1}}],["`vector`",{"2":{"1":1}}],["`extract`",{"2":{"1":1}}],["zscale",{"2":{"50":1}}],["z",{"2":{"1":1,"2":1,"9":4,"12":1,"25":1,"38":1,"42":1,"44":1}}],["za",{"2":{"1":1}}],["zone",{"2":{"1":1}}],["zonal",{"2":{"0":1,"1":5,"32":2,"50":3}}],["zeros",{"2":{"1":1}}],["zealand",{"2":{"1":1}}],["55",{"2":{"48":1,"49":3}}],["5504",{"2":{"1":1}}],["53",{"2":{"47":3}}],["539214",{"2":{"22":1,"24":3,"25":1}}],["564505",{"2":{"22":1,"24":3,"25":1}}],["597527f0",{"2":{"20":6}}],["54",{"2":{"47":1}}],["54166666666667",{"2":{"39":2}}],["54166666666666",{"2":{"39":1}}],["542496f0",{"2":{"20":1}}],["542",{"2":{"1":1}}],["5447",{"2":{"1":1}}],["544561f0",{"2":{"1":1}}],["5858",{"2":{"1":1}}],["524924",{"2":{"19":1,"20":1}}],["5249",{"2":{"18":1}}],["52",{"2":{"1":1,"48":2}}],["57",{"2":{"1":1}}],["5",{"2":{"1":8,"4":5,"5":2,"7":3,"8":2,"9":4,"20":2,"26":1,"35":3,"39":2,"40":1,"41":1,"42":8,"47":1,"49":8,"50":1}}],["509966",{"2":{"22":1,"24":3,"25":1}}],["50275f0",{"2":{"20":6}}],["504673",{"2":{"19":1,"20":1}}],["5047",{"2":{"18":1}}],["50",{"2":{"1":7,"26":1,"39":1,"49":13}}],[">",{"2":{"1":1,"20":1}}],[">=",{"2":{"1":2}}],["98",{"2":{"47":1}}],["98×102",{"2":{"47":5}}],["981556",{"2":{"22":1,"24":3,"25":1}}],["951755",{"2":{"22":1,"24":3,"25":1}}],["953643",{"2":{"22":1,"24":3,"25":1}}],["928556",{"2":{"22":1,"24":3,"25":1}}],["9263",{"2":{"1":1}}],["990331",{"2":{"22":1,"24":3,"25":1}}],["99858",{"2":{"22":1,"24":3,"25":1}}],["99999999999999",{"2":{"48":2}}],["99999999999997",{"2":{"4":1,"5":1,"7":1,"8":1,"9":1,"20":1,"35":1,"47":1}}],["9999",{"2":{"7":2,"8":8}}],["935687",{"2":{"19":1,"20":1}}],["9357",{"2":{"18":1}}],["9373",{"2":{"4":1}}],["9122",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["972705",{"2":{"22":1,"24":3,"25":1}}],["97",{"2":{"1":3}}],["9",{"2":{"1":2,"2":2,"20":2,"28":1,"42":2,"47":2}}],["908018",{"2":{"22":1,"24":3,"25":1}}],["907328",{"2":{"22":1,"24":3,"25":1}}],["90",{"2":{"1":5,"4":8,"5":4,"7":4,"8":4,"9":8,"35":4,"42":3,"47":3,"49":4}}],["72",{"2":{"48":2}}],["7288",{"2":{"1":1}}],["73",{"2":{"48":1}}],["71",{"2":{"47":1}}],["715572",{"2":{"22":1,"24":3,"25":1}}],["75",{"2":{"38":1,"39":1,"49":3}}],["79",{"2":{"42":2}}],["790546f0",{"2":{"20":2}}],["798",{"2":{"5":1}}],["7983f0",{"2":{"1":2}}],["76",{"2":{"1":1}}],["7454",{"2":{"1":1}}],["78",{"2":{"1":1,"18":1,"42":2}}],["775f0",{"2":{"1":1}}],["7",{"2":{"1":5,"20":7}}],["701",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["7030",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["708290",{"2":{"1":4,"49":4}}],["70",{"2":{"1":2,"47":2,"49":2}}],["68821e10",{"2":{"49":6}}],["65",{"2":{"49":2}}],["65921",{"2":{"1":1}}],["659454f0",{"2":{"1":1}}],["6×7",{"2":{"49":3}}],["6×6×10",{"2":{"24":1}}],["6×6×13",{"2":{"22":1}}],["6×6",{"2":{"24":2,"25":1}}],["61",{"2":{"5":1,"26":1}}],["6988",{"2":{"1":1}}],["66031e11",{"2":{"49":6}}],["66666666666664",{"2":{"48":1}}],["666666666666643",{"2":{"47":1}}],["66666666666666",{"2":{"48":1}}],["66666666666667",{"2":{"47":3}}],["6667",{"2":{"4":4,"5":2,"7":2,"8":2,"9":4,"35":2}}],["6665",{"2":{"1":1}}],["6694",{"2":{"1":1}}],["67",{"2":{"1":1}}],["6732",{"2":{"1":1}}],["6715",{"2":{"1":1}}],["6751",{"2":{"1":1}}],["639251",{"2":{"22":1,"24":3,"25":1}}],["634271",{"2":{"22":1,"24":3,"25":1}}],["6326",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["6378137",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["6371008",{"2":{"1":1,"49":1}}],["638462f0",{"2":{"1":2}}],["6",{"2":{"1":4,"18":1,"20":9,"48":1,"49":9,"50":1}}],["600",{"2":{"39":2}}],["60",{"2":{"1":3,"42":1,"49":4}}],["┤",{"2":{"1":1,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"22":1,"24":3,"25":1,"35":2,"39":2,"42":4,"47":4,"48":2,"49":4}}],["→",{"2":{"1":2,"4":4,"5":2,"7":2,"8":2,"9":4,"20":1,"22":2,"24":6,"25":2,"35":2,"39":1,"42":2,"47":2,"48":1,"49":8}}],["↓",{"2":{"1":2,"4":4,"5":2,"7":2,"8":2,"9":4,"20":1,"22":2,"24":6,"25":2,"35":2,"39":1,"42":2,"47":2,"48":1,"49":8}}],["┐",{"2":{"1":1,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"22":1,"24":3,"25":1,"35":1,"39":1,"42":2,"47":2,"48":1,"49":4}}],["48",{"2":{"26":1}}],["480",{"2":{"1":1}}],["49999999999998",{"2":{"48":1}}],["499999999999972",{"2":{"47":2}}],["495627",{"2":{"22":1,"24":3,"25":1}}],["490719",{"2":{"19":1,"20":1}}],["4645f0",{"2":{"20":2}}],["43",{"2":{"20":1,"26":1,"39":2}}],["437709",{"2":{"19":1,"20":1}}],["432552",{"2":{"19":2,"20":2}}],["4326",{"2":{"1":14,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"25":1,"35":1,"39":1,"42":4,"47":2,"48":1,"49":9}}],["430986",{"2":{"19":1,"20":1}}],["431684",{"2":{"19":1,"20":1}}],["431",{"2":{"18":1}}],["4317",{"2":{"18":1}}],["433349",{"2":{"19":1,"20":1}}],["4333",{"2":{"18":1}}],["42685e11",{"2":{"49":6}}],["420698f0",{"2":{"20":1}}],["42",{"2":{"20":7}}],["4243",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["4291",{"2":{"1":1}}],["4f38",{"2":{"4":10,"5":1,"7":8,"9":18,"20":1,"35":9,"47":6,"48":3}}],["4759",{"2":{"1":1}}],["45",{"2":{"1":4,"42":1}}],["44336",{"2":{"22":1,"24":3,"25":1}}],["448374",{"2":{"19":1,"20":1}}],["4474",{"2":{"1":1}}],["441",{"2":{"1":2}}],["446",{"2":{"1":1}}],["418261",{"2":{"19":1,"20":1}}],["41",{"2":{"1":2,"20":9}}],["4",{"2":{"1":3,"2":2,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":2,"49":6}}],["408354f0",{"2":{"20":2}}],["400",{"2":{"43":1}}],["400058",{"2":{"19":1,"20":1}}],["4001",{"2":{"18":1}}],["402",{"2":{"5":1}}],["40",{"2":{"1":8,"20":3,"48":1,"49":1}}],["4×6",{"2":{"1":1,"49":1}}],["│",{"2":{"1":20,"4":4,"5":2,"7":2,"8":2,"9":4,"18":108,"20":2,"22":2,"24":6,"25":2,"35":2,"39":2,"42":4,"47":4,"48":2,"49":8}}],["85",{"2":{"49":3}}],["85225f0",{"2":{"20":1}}],["800",{"2":{"43":1}}],["80",{"2":{"42":2,"49":7}}],["805",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["867585",{"2":{"22":1,"24":3,"25":1}}],["8688",{"2":{"1":1}}],["824473",{"2":{"22":1,"24":3,"25":1}}],["8357186f0",{"2":{"20":6}}],["833",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1}}],["8333",{"2":{"4":4,"5":2,"7":2,"8":2,"9":4,"35":2}}],["83333333333333",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":2,"35":1,"47":1,"48":1}}],["83333333333331",{"2":{"4":1,"5":1,"7":1,"8":1,"9":3,"20":1,"35":1,"47":2}}],["847912",{"2":{"22":1,"24":3,"25":1}}],["846535f0",{"2":{"20":1}}],["8485",{"2":{"5":1}}],["84",{"2":{"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"35":2,"39":2,"47":4,"48":2}}],["896916",{"2":{"22":1,"24":3,"25":1}}],["893264",{"2":{"22":1,"24":3,"25":1}}],["894969",{"2":{"22":1,"24":3,"25":1}}],["8901",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["89",{"2":{"4":14,"5":6,"7":7,"8":6,"9":14,"20":1,"35":7,"42":2,"47":1}}],["8991",{"2":{"1":1}}],["87126",{"2":{"1":1}}],["873182",{"2":{"1":4,"49":4}}],["88114e11",{"2":{"49":6}}],["881583f0",{"2":{"20":7}}],["8868",{"2":{"1":1}}],["88",{"2":{"1":1,"42":2}}],["8",{"2":{"1":2,"20":2,"28":1,"49":1}}],["382602",{"2":{"19":1,"20":1}}],["381847",{"2":{"19":1,"20":1}}],["3818",{"2":{"18":1}}],["381",{"2":{"1":1}}],["310064",{"2":{"19":1,"20":1}}],["31",{"2":{"5":1,"49":3}}],["347186",{"2":{"19":1,"20":1}}],["347",{"2":{"18":1}}],["34",{"2":{"5":1}}],["36",{"2":{"18":9,"19":18,"20":18}}],["360",{"2":{"4":1,"42":2}}],["3656",{"2":{"1":1}}],["3d",{"2":{"2":2,"34":1,"35":2,"36":2,"38":2,"40":1}}],["338776",{"2":{"19":1,"20":1}}],["332969",{"2":{"19":1,"20":1}}],["339",{"2":{"18":1}}],["333783",{"2":{"19":2,"20":2}}],["333",{"2":{"18":1}}],["33333333333336",{"2":{"39":2}}],["3333",{"2":{"4":2,"7":1,"9":2,"35":1}}],["33",{"2":{"1":1}}],["32768",{"2":{"47":2,"48":1}}],["325121",{"2":{"22":1,"24":3,"25":1}}],["328025",{"2":{"19":1,"20":1}}],["328896",{"2":{"19":1,"20":1}}],["329",{"2":{"18":1}}],["321388f0",{"2":{"1":1}}],["32",{"2":{"1":3,"48":2}}],["359",{"2":{"42":2}}],["357",{"2":{"42":2}}],["353274",{"2":{"22":1,"24":3,"25":1}}],["355984",{"2":{"22":1,"24":3,"25":1}}],["35",{"2":{"1":6}}],["3",{"0":{"36":1},"2":{"1":9,"2":2,"4":10,"5":1,"7":8,"9":18,"11":1,"18":1,"20":2,"22":1,"24":1,"35":9,"38":3,"39":3,"42":5,"47":6,"48":5,"50":1}}],["30362",{"2":{"19":1,"20":1}}],["3036",{"2":{"18":1}}],["300",{"2":{"18":1}}],["3087",{"2":{"1":1}}],["30",{"2":{"1":5,"5":2,"22":8,"23":1,"24":18,"25":6,"42":2,"49":2}}],["377673",{"2":{"19":1,"20":1}}],["373215",{"2":{"19":1,"20":1}}],["37",{"2":{"1":2,"19":1,"20":1,"42":2}}],["398438",{"2":{"19":1,"20":1}}],["394749",{"2":{"19":1,"20":1}}],["396453",{"2":{"19":1,"20":1}}],["396",{"2":{"18":1}}],["391682",{"2":{"19":1,"20":1}}],["391097",{"2":{"19":1,"20":1}}],["391",{"2":{"18":1}}],["399",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["39",{"2":{"1":10,"2":5,"9":1,"14":1,"17":1,"20":2,"29":2,"40":1,"44":1,"49":8,"50":14}}],["0f20",{"2":{"42":4}}],["0f0",{"2":{"1":5,"7":1,"8":1,"20":19}}],["0xffffffff",{"2":{"39":1}}],["0xffff",{"2":{"39":3}}],["04",{"2":{"26":1}}],["0408142",{"2":{"22":1,"24":3,"25":1}}],["046",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["0895f0",{"2":{"20":2}}],["096394",{"2":{"19":1,"20":1}}],["096",{"2":{"18":1}}],["092",{"2":{"5":1}}],["05",{"2":{"1":1}}],["0273",{"2":{"1":1}}],["029825f0",{"2":{"1":1}}],["063",{"2":{"1":1}}],["0334e10",{"2":{"49":6}}],["03",{"2":{"1":2}}],["0768",{"2":{"4":1}}],["076923f0",{"2":{"1":2}}],["077084f0",{"2":{"1":1}}],["07",{"2":{"1":1}}],["0",{"2":{"1":78,"2":2,"4":27,"5":12,"7":12,"8":18,"9":24,"19":1,"20":5,"22":36,"24":108,"25":36,"28":1,"35":12,"38":1,"39":5,"42":22,"44":1,"46":1,"47":9,"48":5,"49":79,"50":3}}],["001604f0",{"2":{"20":1}}],["0094",{"2":{"4":1}}],["005fvlen",{"2":{"2":2}}],["005fdef",{"2":{"2":2}}],["007",{"2":{"1":1}}],["000000000000005",{"2":{"39":1}}],["000000000000004",{"2":{"20":1}}],["000",{"2":{"1":2}}],["00",{"2":{"1":12,"22":8,"24":8,"42":16}}],["0174532925199433",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["01154e6",{"2":{"1":4,"49":4}}],["01t00",{"2":{"1":6,"22":4,"24":4,"42":4}}],["01",{"2":{"1":6,"22":4,"24":2,"42":10}}],["kingdom",{"2":{"18":1}}],["k",{"2":{"2":3,"42":2}}],["keep",{"2":{"49":1}}],["keeps",{"2":{"1":1}}],["keys",{"2":{"1":10,"2":4}}],["keyword",{"2":{"1":15,"2":6,"49":1,"50":1}}],["keywords",{"2":{"1":35,"2":11,"16":1,"36":1,"38":1}}],["key",{"2":{"1":2,"29":1}}],["known",{"2":{"12":1}}],["know",{"2":{"1":4,"6":1,"29":1}}],["kw",{"2":{"1":23,"2":5,"20":2,"38":1,"40":1}}],["uint16",{"2":{"39":3}}],["uint64",{"2":{"18":2}}],["uint8",{"2":{"18":1}}],["uint32",{"2":{"1":1,"39":1}}],["ucar",{"2":{"2":2,"42":1}}],["update",{"2":{"9":1,"31":1}}],["updating",{"2":{"1":1}}],["upper",{"2":{"1":13}}],["upper=",{"2":{"1":1}}],["url",{"2":{"1":14,"29":1,"42":2,"46":2}}],["unexported",{"2":{"36":1,"40":1}}],["unexpected",{"2":{"1":6}}],["until",{"2":{"26":1}}],["unitrange",{"2":{"18":1}}],["unit",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"41":1,"47":2,"48":1}}],["units",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":4}}],["unidata",{"2":{"2":2,"42":1}}],["union",{"2":{"1":10,"2":2,"20":80,"42":2}}],["unmasked",{"2":{"1":2}}],["under",{"2":{"28":1,"50":1}}],["underscores",{"2":{"2":1}}],["underlying",{"2":{"1":3,"2":1,"33":1,"38":1,"40":1}}],["undefined",{"2":{"1":1}}],["unchanged",{"2":{"1":3}}],["unless",{"2":{"1":2}}],["unopened",{"2":{"1":1}}],["usage",{"0":{"50":1}}],["us",{"2":{"1":1}}],["using",{"0":{"39":1,"47":1},"2":{"1":25,"2":3,"11":1,"12":2,"13":1,"15":1,"16":1,"17":2,"18":1,"20":1,"22":2,"24":1,"26":1,"28":8,"35":1,"41":1,"42":2,"45":2,"46":1,"47":3,"48":3,"49":4,"50":1}}],["usually",{"2":{"1":11,"2":5,"38":1}}],["users",{"2":{"2":1}}],["uses",{"2":{"1":3,"10":1,"25":1,"42":1}}],["used",{"2":{"1":90,"2":16,"6":1,"9":1,"12":2,"14":1,"16":2,"25":1,"26":1,"40":1,"44":1,"50":1}}],["use",{"2":{"1":44,"2":6,"3":1,"4":1,"5":1,"7":1,"10":1,"12":1,"26":2,"28":1,"29":1,"30":1,"36":1,"40":1,"42":1,"49":1,"50":3}}],["usefull",{"2":{"1":2}}],["usefulnesss",{"2":{"1":1}}],["useful",{"2":{"1":9,"33":1,"49":2}}],["==",{"2":{"50":1}}],["===",{"2":{"1":1}}],["=a",{"2":{"24":1}}],["=>",{"2":{"1":14,"4":8,"5":4,"7":4,"8":4,"9":10,"35":4,"42":18}}],["=",{"2":{"1":137,"2":18,"4":5,"5":5,"7":4,"8":2,"9":4,"16":1,"18":2,"19":1,"20":8,"22":6,"23":2,"24":7,"25":2,"26":3,"35":6,"36":4,"38":20,"39":20,"40":1,"41":2,"42":10,"46":2,"47":21,"48":18,"49":23,"50":27}}],["visualize",{"2":{"36":1}}],["via",{"2":{"2":2,"24":1,"47":1,"50":1}}],["views",{"2":{"1":1}}],["view",{"2":{"1":4,"26":4,"50":1}}],["vlen",{"2":{"2":2}}],["ve",{"2":{"50":1}}],["vebose",{"2":{"1":2,"2":2}}],["vertical",{"2":{"25":1}}],["verbose",{"2":{"1":4}}],["version",{"2":{"1":2}}],["versions",{"2":{"1":19,"49":1}}],["very",{"2":{"1":5,"11":1,"40":1,"49":1}}],["vectors",{"2":{"1":1}}],["vector",{"2":{"1":17,"2":2,"18":2,"19":2,"20":1,"38":2,"46":1}}],["vanilla",{"0":{"39":1}}],["variations",{"2":{"29":1}}],["variable",{"2":{"2":2,"49":1}}],["variables",{"2":{"1":2,"12":1,"17":1,"20":1,"49":1}}],["various",{"2":{"16":1}}],["valid",{"2":{"2":2}}],["values",{"0":{"31":1},"2":{"1":74,"2":3,"7":1,"26":3,"30":1,"31":2,"32":1,"38":1,"40":3,"44":1,"47":1,"50":1}}],["value",{"0":{"25":1},"2":{"1":54,"2":4,"6":1,"9":1,"19":1,"26":4,"42":2,"48":1,"49":2}}],["val",{"2":{"1":2}}],["val=",{"2":{"1":1}}],["2d",{"2":{"36":1,"40":1}}],["26",{"2":{"22":2,"24":6,"25":2,"49":6}}],["268078f0",{"2":{"20":7}}],["235863",{"2":{"22":1,"24":3,"25":1}}],["235596",{"2":{"19":1,"20":1}}],["236",{"2":{"18":1}}],["23",{"2":{"4":1,"18":1,"20":18,"42":2}}],["23017e6",{"2":{"1":4,"49":4}}],["22",{"2":{"1":1,"4":2,"18":1,"20":1}}],["2727",{"2":{"1":1}}],["27",{"2":{"1":4,"5":1,"22":2,"24":6,"25":2}}],["273",{"2":{"1":1}}],["271",{"2":{"1":1}}],["284565",{"2":{"19":1,"20":1}}],["285",{"2":{"18":1}}],["2888",{"2":{"1":1}}],["28",{"2":{"1":2,"5":1,"22":2,"24":6,"25":2}}],["2955",{"2":{"5":1}}],["298",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["29",{"2":{"1":4,"22":2,"24":6,"25":2}}],["240881",{"2":{"19":1,"20":1}}],["241",{"2":{"18":1}}],["243",{"2":{"1":1}}],["24534",{"2":{"1":1}}],["24",{"2":{"1":5}}],["2160",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1,"47":1}}],["2160×1080",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1,"47":5}}],["21",{"2":{"1":4,"18":1,"49":3}}],["2592000000",{"2":{"42":1}}],["259489",{"2":{"19":1,"20":1}}],["258",{"2":{"1":1}}],["258×8",{"2":{"1":1}}],["257223563",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["257",{"2":{"1":1}}],["256",{"2":{"1":1,"2":6,"19":1,"20":1}}],["255",{"2":{"1":1}}],["254",{"2":{"1":1}}],["253",{"2":{"1":1}}],["252",{"2":{"1":1}}],["25",{"2":{"1":9,"20":3,"22":8,"23":1,"24":18,"25":6,"26":2,"47":2,"49":42}}],["2",{"0":{"35":1},"2":{"1":9,"2":3,"4":2,"5":4,"7":1,"8":1,"9":2,"14":1,"18":2,"24":2,"25":1,"34":1,"35":5,"38":2,"39":7,"41":1,"44":1,"49":4}}],["20833333333334",{"2":{"39":1}}],["2020",{"2":{"18":1}}],["2021",{"2":{"18":1}}],["2012",{"2":{"18":2}}],["2016",{"2":{"18":3}}],["2011",{"2":{"18":2}}],["2015",{"2":{"18":1}}],["2065",{"2":{"1":1}}],["20417f0",{"2":{"1":1}}],["2003",{"2":{"42":2}}],["2005",{"2":{"42":2}}],["2009",{"2":{"1":1}}],["2002",{"2":{"1":3,"22":3,"42":5}}],["2001",{"2":{"1":6,"22":3,"24":4,"25":1,"42":7}}],["20",{"2":{"1":11,"44":2,"49":1}}],["globe",{"2":{"50":1}}],["global",{"2":{"14":1,"17":1,"47":1}}],["gadm",{"2":{"45":1}}],["go",{"2":{"49":1}}],["going",{"2":{"40":1}}],["good",{"2":{"29":1}}],["google",{"2":{"29":1}}],["gbif",{"0":{"17":1,"18":1},"1":{"18":1,"19":1,"20":1}}],["gbif2",{"2":{"1":2,"17":1,"18":4}}],["guaranteed",{"2":{"2":2}}],["guessed",{"2":{"2":3}}],["guessing",{"2":{"2":2}}],["gis",{"2":{"31":1}}],["giving",{"2":{"1":1}}],["given",{"2":{"1":2,"22":1}}],["gives",{"2":{"1":6,"49":1}}],["give",{"2":{"1":7}}],["github",{"2":{"1":23,"46":1,"49":1}}],["gpu",{"2":{"1":1,"33":1}}],["great",{"2":{"29":1}}],["greenwich",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["grow",{"2":{"1":2}}],["group3",{"2":{"1":2}}],["group2",{"2":{"1":2}}],["group1",{"2":{"1":2}}],["group=",{"2":{"1":2}}],["groups",{"2":{"1":2}}],["group",{"2":{"1":6}}],["gri",{"2":{"2":4}}],["grid=false",{"2":{"39":2}}],["gridposition",{"2":{"2":1,"38":1,"40":1}}],["grid",{"2":{"1":2,"2":2,"49":2,"50":1}}],["gridcell",{"2":{"1":1,"49":1}}],["gribsource",{"2":{"1":2,"2":3}}],["grib",{"2":{"1":4,"2":3,"28":1}}],["grdsource",{"2":{"2":1}}],["grd",{"0":{"11":1},"2":{"1":2,"2":12,"11":1,"28":1}}],["g",{"2":{"1":11,"2":1,"22":1,"25":1,"26":2,"29":1,"30":1,"33":1,"40":1}}],["gdalwarp",{"2":{"1":4,"30":1}}],["gdals",{"2":{"1":2}}],["gdalsource",{"2":{"1":2,"2":3,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["gdal",{"0":{"13":1},"2":{"1":8,"2":15,"13":1,"28":3}}],["gdalarray",{"2":{"1":1}}],["gt",{"2":{"1":17,"2":2,"49":2}}],["gets",{"2":{"50":1}}],["getting",{"0":{"23":1}}],["getdriver",{"2":{"2":2}}],["getring",{"2":{"1":1}}],["getring`",{"2":{"1":1}}],["getraster",{"2":{"1":1,"16":1}}],["get",{"0":{"20":1},"2":{"1":8,"20":1,"26":4,"29":1,"42":1,"45":1,"50":8}}],["getindex",{"2":{"1":10,"26":2}}],["geographic",{"2":{"49":1,"50":1}}],["geogcs",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["geodetic",{"2":{"49":2}}],["geoaxis",{"2":{"2":1,"38":1}}],["geomakie",{"2":{"2":1,"38":1}}],["geom",{"2":{"1":7}}],["geometric",{"2":{"1":1}}],["geometries",{"2":{"1":50,"32":3,"50":1}}],["geometrycolumn",{"2":{"1":20}}],["geometry",{"2":{"1":32,"18":1,"20":20,"50":7}}],["geotiff",{"2":{"1":1,"22":1}}],["geointerface",{"2":{"1":18,"19":1}}],["geoformattypes",{"2":{"1":7,"9":1}}],["geoformat",{"2":{"1":9,"9":1}}],["general",{"2":{"50":1}}],["generally",{"2":{"1":1,"9":1,"13":1}}],["generating",{"2":{"6":1}}],["generator",{"2":{"1":1}}],["generated",{"2":{"50":1}}],["generates",{"2":{"22":1,"50":1}}],["generate",{"2":{"1":4}}],["generically",{"2":{"25":1}}],["generic",{"2":{"1":1,"42":1,"48":1}}],["||",{"2":{"1":5}}],["|",{"2":{"1":2}}],["|>",{"2":{"1":7,"39":1,"42":2,"44":1}}],["np",{"2":{"48":3}}],["ncstack",{"2":{"12":1}}],["ncdatasets",{"2":{"12":1,"28":1,"42":1,"45":1}}],["ncdsource",{"2":{"1":2,"2":5,"42":2}}],["nc",{"2":{"2":4,"12":3,"42":2,"44":2,"48":1}}],["ntuple",{"2":{"2":3}}],["nuevo",{"2":{"1":1}}],["numbers",{"2":{"22":1}}],["number",{"2":{"1":3,"10":1,"49":1}}],["natively",{"2":{"11":1}}],["naturalearth",{"2":{"50":3}}],["natural",{"2":{"1":5,"46":1}}],["na",{"2":{"2":3}}],["nan",{"2":{"1":16,"2":2,"38":2,"50":1}}],["name=",{"2":{"7":1,"12":1,"14":1}}],["nametuple",{"2":{"1":1}}],["names",{"2":{"1":2,"12":1,"25":1,"38":1}}],["named",{"2":{"1":1,"22":1}}],["namedtuple",{"2":{"1":12,"2":5,"20":20}}],["name",{"2":{"1":29,"2":7,"3":1,"7":2,"12":1,"14":1,"38":3,"42":6,"46":2,"47":1,"50":1}}],["nvkelso",{"2":{"1":4,"46":1}}],["nz",{"2":{"1":6}}],["n",{"2":{"1":1,"2":3}}],["norway",{"2":{"47":4,"48":11}}],["north",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["normally",{"2":{"1":2}}],["nochecksum",{"2":{"2":2}}],["now",{"2":{"1":1,"28":1,"42":2,"48":2,"49":1,"50":3}}],["nodataval",{"2":{"2":3}}],["nodata",{"2":{"1":9}}],["none",{"2":{"20":1}}],["non",{"2":{"1":12,"44":1,"49":1}}],["no",{"2":{"1":23,"2":4}}],["nometadata",{"2":{"1":1}}],["notice",{"2":{"42":1}}],["nothing",{"2":{"1":22,"2":2,"38":2}}],["note",{"2":{"1":10,"26":1,"31":1,"49":2,"50":2}}],["not",{"2":{"1":103,"2":6,"11":1,"12":1,"15":1,"28":1,"29":2,"35":1,"38":1,"40":1,"49":1}}],["neighbour",{"2":{"1":1}}],["ne",{"2":{"1":7,"46":1}}],["newdocs",{"2":{"2":2}}],["newmissingval",{"2":{"1":2}}],["new",{"2":{"1":11,"6":1}}],["nested",{"2":{"1":13,"9":1}}],["needs",{"2":{"2":2}}],["needed",{"2":{"1":4,"28":1}}],["need",{"2":{"1":6,"2":2,"5":1,"7":1,"28":2,"29":4,"38":1,"42":1,"49":1,"50":1}}],["netcdf",{"0":{"12":1},"2":{"1":9,"2":14,"12":4,"22":1,"25":1,"28":1,"30":1,"42":2,"48":1}}],["nearly",{"2":{"29":1}}],["nearest",{"2":{"1":1}}],["near",{"2":{"1":3,"25":1,"26":1,"42":2,"44":1}}],["xlabel",{"2":{"2":1,"38":1,"39":1}}],["x=",{"2":{"1":1}}],["x=100",{"2":{"1":1}}],["xs",{"2":{"1":8}}],["xdim",{"2":{"1":8,"2":1,"38":1,"49":2}}],["x",{"2":{"1":68,"2":11,"4":5,"5":2,"7":2,"8":2,"9":6,"11":1,"12":1,"14":1,"19":1,"20":7,"22":4,"23":2,"24":6,"25":4,"26":6,"31":1,"35":2,"38":4,"39":7,"42":7,"44":1,"47":12,"48":7,"49":17}}],["x3c",{"2":{"1":14,"2":3}}],["ylabel",{"2":{"2":1,"38":1,"39":1}}],["year",{"2":{"18":1,"42":1}}],["year=",{"2":{"1":1}}],["yet",{"2":{"2":1,"28":1}}],["y=",{"2":{"1":2}}],["ydim",{"2":{"1":8,"2":2,"38":2,"49":2}}],["y",{"2":{"1":18,"2":8,"4":4,"5":2,"7":2,"8":2,"9":4,"11":1,"12":1,"14":1,"19":1,"20":7,"22":4,"23":2,"24":6,"25":4,"26":2,"31":1,"35":2,"38":5,"39":7,"42":7,"44":2,"47":12,"48":7,"49":18}}],["your",{"2":{"1":2,"29":2,"49":1}}],["you",{"2":{"1":17,"2":6,"6":2,"7":1,"9":1,"10":1,"28":4,"29":3,"34":1,"36":2,"38":1,"40":1,"49":8,"50":2}}],["1×1080",{"2":{"4":1}}],["190",{"2":{"42":1}}],["194",{"2":{"39":1}}],["194×161",{"2":{"39":5}}],["1984",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["192",{"2":{"1":1}}],["19279e6",{"2":{"1":4,"49":4}}],["18",{"2":{"18":1}}],["1837",{"2":{"1":1}}],["1864",{"2":{"1":1}}],["180×170×1",{"2":{"42":1}}],["180×170×24",{"2":{"42":1}}],["180",{"2":{"1":2,"4":8,"5":3,"7":3,"8":3,"9":6,"35":3,"47":2}}],["142f0",{"2":{"20":1}}],["147",{"2":{"18":1,"19":2,"20":2}}],["1478",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["148827",{"2":{"22":1,"24":3,"25":1}}],["148",{"2":{"18":8,"19":17,"20":17}}],["14",{"2":{"1":2,"4":1,"7":1,"8":1,"9":2,"35":1}}],["145",{"2":{"1":1}}],["144",{"2":{"1":1}}],["16666666666666666",{"2":{"48":2}}],["1666666666666443",{"2":{"48":2}}],["16666666666667",{"2":{"20":1}}],["16t00",{"2":{"42":4}}],["161",{"2":{"39":1}}],["162339",{"2":{"22":1,"24":3,"25":1}}],["1622",{"2":{"1":1}}],["1692",{"2":{"20":2}}],["160",{"2":{"1":3,"39":1}}],["16",{"2":{"1":1,"42":2,"49":3}}],["165",{"2":{"1":1}}],["1f0",{"2":{"1":1}}],["177×119",{"2":{"48":5}}],["173672",{"2":{"22":1,"24":3,"25":1}}],["1706977f0",{"2":{"20":2}}],["179",{"2":{"4":3,"5":3,"7":3,"8":3,"9":6,"35":3,"47":2}}],["17",{"2":{"1":6,"4":1,"7":1,"8":1,"9":2,"35":1,"42":1}}],["1368",{"2":{"20":1}}],["133f0",{"2":{"20":7}}],["138",{"2":{"20":3}}],["13",{"2":{"1":2,"4":1,"7":1,"8":1,"9":2,"35":1,"39":2}}],["130584",{"2":{"22":1,"24":3,"25":1}}],["130",{"2":{"1":1,"49":1}}],["153",{"2":{"39":2}}],["153847f0",{"2":{"1":2}}],["1544",{"2":{"20":7}}],["154",{"2":{"20":2}}],["155",{"2":{"20":1}}],["15",{"2":{"1":7,"4":3,"7":3,"8":3,"9":6,"18":2,"35":3}}],["1500",{"2":{"20":6}}],["150",{"2":{"1":1}}],["127338",{"2":{"22":1,"24":3,"25":1}}],["1292",{"2":{"20":2}}],["1223",{"2":{"20":1}}],["1287",{"2":{"1":1}}],["12",{"2":{"1":3,"20":1,"26":2,"38":1,"42":2}}],["120",{"2":{"1":3,"49":3}}],["113",{"2":{"39":2}}],["114259",{"2":{"22":1,"24":3,"25":1}}],["119827f0",{"2":{"20":2}}],["11917e6",{"2":{"1":4,"49":4}}],["11",{"2":{"1":1,"18":6,"42":2,"49":3}}],["110339",{"2":{"22":1,"24":3,"25":1}}],["110",{"2":{"1":1,"49":1}}],["10944",{"2":{"22":1,"24":3,"25":1}}],["102",{"2":{"20":1,"47":1}}],["102×89",{"2":{"20":5}}],["1080",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"47":1}}],["10m",{"2":{"1":8,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"46":2}}],["10",{"2":{"1":34,"18":1,"24":3,"39":3,"47":1,"49":5,"50":1}}],["100mm",{"2":{"50":1}}],["100",{"2":{"1":28,"26":1,"39":1,"49":2}}],["1",{"2":{"1":39,"2":4,"4":4,"5":2,"7":2,"8":2,"9":4,"18":4,"19":1,"20":5,"22":7,"23":1,"24":10,"25":2,"26":1,"28":1,"35":4,"36":1,"38":2,"39":6,"42":8,"44":1,"48":2,"49":87}}],["dp",{"2":{"48":1}}],["dpi=300",{"2":{"43":1}}],["d",{"0":{"35":1,"36":1},"2":{"34":1}}],["df",{"2":{"20":2}}],["dark",{"2":{"39":1}}],["day",{"2":{"18":1}}],["datsets",{"2":{"16":1}}],["datum",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["date",{"2":{"42":1}}],["date=datetime",{"2":{"1":2}}],["dates",{"2":{"1":8,"16":1,"22":1,"45":1,"47":1}}],["datetime360day",{"2":{"42":12}}],["datetime",{"2":{"1":13,"22":7,"24":5,"25":1}}],["dataaspect",{"2":{"35":1,"36":1,"49":1,"50":1}}],["dataframe",{"2":{"1":3,"20":2}}],["dataframes",{"2":{"1":1,"20":1}}],["datasets",{"2":{"1":2,"16":1}}],["dataset",{"2":{"1":4,"2":4,"14":1,"47":1,"49":1}}],["data",{"0":{"10":1,"18":1,"33":1,"42":1},"1":{"11":1,"12":1,"13":1,"14":1,"15":1,"16":1,"43":1,"44":1},"2":{"1":53,"2":1,"4":1,"10":1,"14":1,"15":1,"16":3,"17":1,"22":1,"25":1,"28":1,"29":1,"30":3,"33":4,"38":1,"39":1,"40":1,"42":2,"47":1,"49":1,"50":7}}],["drive",{"2":{"29":1}}],["drivers",{"2":{"2":2}}],["drivername",{"2":{"2":2}}],["driver",{"2":{"2":12}}],["draw",{"2":{"2":2,"38":2}}],["drop",{"2":{"1":2,"29":1}}],["dropband",{"2":{"1":2}}],["dhekelia",{"2":{"1":1}}],["dbf",{"2":{"1":7}}],["dstlookup",{"2":{"1":1}}],["dst",{"2":{"1":4,"2":4}}],["due",{"2":{"1":9}}],["during",{"2":{"1":2}}],["duplicate",{"2":{"1":4}}],["doing",{"2":{"50":1}}],["documentation",{"2":{"30":1}}],["documenter",{"2":{"14":1}}],["docstring",{"2":{"14":2}}],["docs",{"2":{"1":2,"15":1,"16":2}}],["dot",{"2":{"4":1}}],["down",{"2":{"1":2}}],["downloading",{"2":{"29":1}}],["downloads",{"2":{"1":9,"28":1,"29":1,"42":1,"45":1,"46":2}}],["download",{"0":{"46":1},"1":{"47":1,"48":1},"2":{"1":12,"16":2,"28":1,"42":2,"46":1}}],["do",{"2":{"1":2,"2":5,"4":1,"5":2,"6":1,"22":1,"28":1,"29":1,"38":1,"39":1}}],["don",{"2":{"1":1,"2":4,"9":1,"50":1}}],["done",{"2":{"1":2,"24":1,"29":1}}],["doesn",{"2":{"44":1}}],["does",{"2":{"1":6}}],["denmark",{"2":{"47":4,"48":4}}],["degc",{"2":{"42":2}}],["degree",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"44":1,"47":2,"48":1}}],["degrees",{"2":{"1":6}}],["descriptions",{"2":{"30":1}}],["description",{"2":{"26":1,"30":1,"31":1,"32":1,"33":1}}],["designed",{"2":{"25":1}}],["destructively",{"2":{"2":6}}],["destination",{"2":{"1":1}}],["dest",{"2":{"1":3}}],["decimallatitude",{"2":{"19":2}}],["decimallongitude",{"2":{"19":1}}],["decline",{"2":{"1":2}}],["details",{"2":{"14":1,"25":1}}],["determines",{"2":{"1":1}}],["determine",{"2":{"1":6}}],["detect",{"2":{"10":1}}],["detected",{"2":{"1":10,"2":6}}],["detecting",{"2":{"1":1}}],["depending",{"2":{"1":2,"2":1,"49":1}}],["depth",{"2":{"1":2,"30":1}}],["deferred",{"2":{"26":1}}],["deflate",{"2":{"2":2}}],["deflatelevel",{"2":{"2":2}}],["defualts",{"2":{"1":2}}],["defined",{"2":{"1":1,"2":1,"49":1}}],["define",{"2":{"1":2,"48":1}}],["defines",{"2":{"1":1,"25":1}}],["defaults",{"2":{"1":3}}],["defaulting",{"2":{"1":1}}],["default",{"2":{"1":64,"2":20,"13":1,"38":1,"49":3,"50":1}}],["dividing",{"2":{"50":1}}],["divided",{"2":{"1":2}}],["difficult",{"2":{"9":1}}],["difference",{"2":{"49":2}}],["differences",{"2":{"1":2}}],["differently",{"2":{"34":1}}],["different",{"2":{"1":3,"12":1,"15":1,"30":3,"34":1,"49":2}}],["differnce",{"2":{"1":1}}],["directions",{"2":{"25":1}}],["directly",{"2":{"1":8,"2":1,"4":1,"5":1,"12":1,"16":1}}],["directory",{"2":{"1":4,"2":2}}],["directories",{"2":{"1":1}}],["dir",{"2":{"1":4}}],["dictionary",{"2":{"2":2}}],["dict",{"2":{"1":5,"2":4,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":2}}],["disable",{"2":{"2":1}}],["disaggregate",{"2":{"0":2,"1":4,"30":2}}],["distribution",{"2":{"1":1}}],["distance",{"2":{"1":4}}],["diskarrays",{"2":{"2":4}}],["disk",{"0":{"15":1,"44":1},"2":{"1":10,"2":3,"4":1,"5":2,"12":1,"15":1,"26":1,"33":1,"42":2,"44":1,"48":1}}],["dimtuple",{"2":{"1":1}}],["dimz",{"2":{"1":2}}],["dim",{"2":{"1":2,"12":1}}],["dims=ti",{"2":{"42":1}}],["dims=x",{"2":{"4":1}}],["dims=",{"2":{"1":2}}],["dims=band",{"2":{"1":1}}],["dims",{"2":{"1":22,"3":1,"4":2,"5":1,"7":1,"8":1,"9":2,"20":5,"22":1,"24":3,"25":1,"35":1,"39":5,"42":2,"47":10,"48":5,"49":4}}],["dimension",{"0":{"4":1},"2":{"1":47,"2":14,"3":1,"4":1,"9":1,"12":1,"13":1,"25":2,"26":1,"30":2,"38":8,"40":1,"42":2}}],["dimensional",{"2":{"2":2,"11":1,"14":1,"38":2,"40":1}}],["dimensionalarray",{"2":{"1":1}}],["dimensionaldata",{"2":{"1":6,"22":1,"25":2,"26":1,"42":1,"44":1}}],["dimensions",{"0":{"23":1},"2":{"1":43,"2":7,"9":2,"11":1,"12":3,"14":1,"22":2,"25":5,"26":1,"31":1,"38":2,"42":1,"44":1,"49":2}}],["equator",{"2":{"49":1}}],["equal",{"2":{"1":1,"2":1,"49":1}}],["efficient",{"2":{"36":1}}],["effort",{"2":{"29":1}}],["effect",{"2":{"1":3}}],["especially",{"2":{"25":1}}],["ecology",{"2":{"16":1}}],["ellipsoid",{"2":{"49":1}}],["eltype",{"2":{"20":4,"39":4,"47":8,"48":4}}],["else",{"2":{"2":2}}],["elements",{"2":{"1":1,"2":1}}],["element",{"2":{"1":3,"18":1,"19":1,"20":1,"38":1}}],["elevation",{"2":{"1":1,"49":1}}],["every",{"2":{"42":1}}],["everything",{"2":{"2":2}}],["evenness",{"2":{"1":19,"39":3}}],["even",{"2":{"1":1,"2":7,"34":1,"35":1,"38":1}}],["edu",{"2":{"2":2,"42":1}}],["etc",{"2":{"1":1}}],["errors",{"0":{"29":1},"2":{"1":2,"29":1}}],["error",{"2":{"1":4,"29":1}}],["empty",{"2":{"1":3}}],["encompasses",{"2":{"50":1}}],["encodes",{"2":{"49":1}}],["enumerate",{"2":{"39":2}}],["environmental",{"2":{"16":1,"17":1}}],["entries",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":2}}],["entire",{"2":{"1":2,"48":1}}],["enough",{"2":{"2":1}}],["ensure",{"2":{"2":1}}],["end",{"2":{"1":1,"2":1,"5":2,"38":1,"39":2,"48":2}}],["ease",{"2":{"34":1}}],["easy",{"2":{"29":1}}],["easter",{"2":{"50":1}}],["east",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":2,"35":1,"39":1,"47":2,"48":1}}],["eagerly",{"2":{"1":1}}],["earthenv",{"2":{"1":8,"39":2}}],["earth",{"2":{"1":7,"46":1,"49":3}}],["eachchunk",{"2":{"2":1}}],["each",{"2":{"1":24,"2":10,"28":1,"30":1,"38":1,"48":1,"49":6,"50":1}}],["e",{"2":{"1":13,"2":4,"22":1,"25":1,"26":2,"29":1,"30":1,"33":1,"38":1,"40":1,"49":1}}],["eg",{"2":{"1":3}}],["epsg",{"2":{"1":8,"4":10,"5":5,"7":5,"8":5,"9":10,"20":5,"25":1,"35":5,"39":5,"42":4,"47":10,"48":5,"49":7}}],["either",{"2":{"1":2,"2":1}}],["excluding",{"2":{"26":1}}],["excessive",{"2":{"1":5}}],["exact",{"2":{"29":1}}],["exactly",{"2":{"26":1}}],["examplebad",{"2":{"50":1}}],["exampletotal",{"2":{"50":2}}],["exampleprecip",{"2":{"50":1}}],["exampleavg",{"2":{"50":1}}],["exampleareas",{"2":{"50":1}}],["exampleall",{"2":{"50":1}}],["examplemasked",{"2":{"50":1}}],["examplecropped",{"2":{"50":1}}],["examplef",{"2":{"50":1}}],["exampleusing",{"2":{"50":1}}],["examples",{"2":{"22":1,"30":1,"42":1}}],["example",{"0":{"50":1},"2":{"1":46,"2":2,"17":1,"28":1,"29":1,"36":1,"42":1,"44":1,"45":1,"49":1}}],["exists",{"2":{"2":8}}],["existing",{"2":{"1":3}}],["explicitly",{"2":{"49":1}}],["explicit",{"2":{"25":1,"42":2}}],["experience",{"2":{"1":1}}],["experimental",{"2":{"1":19,"36":1,"49":1}}],["expected",{"2":{"1":6}}],["exported",{"0":{"1":1}}],["extra",{"2":{"29":1}}],["extracts",{"2":{"1":1}}],["extract",{"0":{"19":1},"2":{"0":1,"1":5,"17":1,"19":1,"20":2,"32":2}}],["extrema",{"2":{"1":2}}],["ext",{"2":{"1":1,"2":2,"15":1}}],["extensive",{"2":{"49":1}}],["extensions",{"0":{"28":1},"2":{"28":3}}],["extension",{"2":{"1":2,"2":18}}],["extents",{"2":{"1":18,"30":1}}],["extent",{"0":{"30":1},"2":{"1":43,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"22":2,"24":6,"25":2,"30":2,"35":2,"39":2,"42":4,"47":4,"48":2,"49":8}}],["extends",{"2":{"22":1}}],["extend",{"2":{"0":1,"1":8,"30":2}}],["l",{"2":{"39":4}}],["ll",{"2":{"17":1,"49":4,"50":2}}],["lscene",{"2":{"2":1,"38":1}}],["literate",{"2":{"50":1}}],["little",{"2":{"15":1,"29":1,"36":2}}],["limited",{"2":{"40":1}}],["limit=300",{"2":{"18":1}}],["limit=5",{"2":{"1":1}}],["linrange",{"2":{"4":3,"5":2,"7":2,"8":2,"9":4,"20":2,"35":2,"39":2,"47":4}}],["linear",{"2":{"3":1}}],["linewidth=0",{"2":{"1":2,"48":1}}],["lines",{"2":{"1":11,"46":1}}],["line",{"2":{"1":11}}],["listed",{"2":{"26":1}}],["list",{"2":{"1":1}}],["likely",{"2":{"1":1,"49":1}}],["like",{"2":{"1":18,"2":4,"3":2,"4":1,"22":1,"25":3,"28":2,"34":1,"40":1,"49":3}}],["lt",{"2":{"1":20,"49":2}}],["least",{"2":{"50":1}}],["leave",{"2":{"1":2}}],["let",{"2":{"49":1,"50":5}}],["lets",{"2":{"48":1}}],["legend=",{"2":{"20":1}}],["legend=false",{"2":{"1":1}}],["left",{"2":{"2":1,"38":1,"50":1}}],["length",{"2":{"1":5,"2":1,"38":1,"48":1,"49":2,"50":1}}],["level",{"2":{"1":1,"2":2}}],["layout",{"2":{"39":2}}],["layername",{"2":{"12":2,"14":1}}],["layered",{"2":{"1":4,"2":1,"14":1,"48":1}}],["layer",{"0":{"20":1},"2":{"1":16,"2":2,"7":1,"12":1,"14":1,"42":1,"48":1}}],["layersfrom",{"2":{"1":1}}],["layersfrom=band",{"2":{"1":2,"13":1}}],["layers",{"2":{"1":24,"2":3,"5":1,"12":4,"13":1,"14":3,"20":2,"30":1,"39":5,"47":3,"48":1}}],["label",{"2":{"2":3,"38":3,"39":1,"42":1}}],["labels",{"2":{"1":1}}],["lanczos",{"2":{"1":2}}],["last",{"2":{"1":12}}],["largely",{"2":{"25":1}}],["largest",{"2":{"1":1}}],["larger",{"2":{"1":2}}],["large",{"2":{"1":19,"40":2}}],["lazy=false",{"2":{"1":1,"2":1}}],["lazy=true",{"2":{"1":5,"2":1,"4":1}}],["lazy",{"2":{"1":10,"2":3,"26":1}}],["lazily",{"2":{"1":10,"2":1,"4":1,"48":1}}],["latitude",{"2":{"1":1,"4":2,"5":1,"7":1,"8":1,"9":2,"19":1,"20":1,"23":1,"25":1,"35":1,"39":1,"44":1,"47":2,"48":1,"49":1}}],["latter",{"2":{"1":1}}],["later",{"2":{"1":1}}],["lat",{"2":{"1":5,"22":2,"23":1,"39":1,"42":1,"49":1}}],["looks",{"2":{"49":1}}],["lookups",{"2":{"1":9,"2":1,"49":4}}],["lookup",{"0":{"23":1},"2":{"1":18,"2":2,"23":2,"25":2}}],["log",{"2":{"14":1}}],["lot",{"2":{"2":2,"48":1,"49":1,"50":1}}],["lost",{"2":{"15":1}}],["loses",{"2":{"1":1}}],["lossless",{"2":{"1":1}}],["lower",{"2":{"1":13}}],["lower=",{"2":{"1":1}}],["low",{"2":{"1":5,"2":1,"38":1}}],["locus",{"2":{"1":4}}],["location",{"2":{"1":1}}],["longest",{"2":{"40":1}}],["longitude",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"19":1,"20":1,"23":1,"25":1,"35":1,"39":1,"47":2,"48":1}}],["long",{"2":{"1":1,"42":2,"49":1}}],["lon",{"2":{"1":4,"22":2,"39":1,"42":1}}],["loads",{"2":{"28":1,"42":1}}],["load",{"0":{"18":1,"33":1,"47":1},"2":{"1":13,"10":1,"16":1,"17":1,"28":2,"42":1,"47":2}}],["loading",{"0":{"42":1},"1":{"43":1,"44":1},"2":{"1":5,"12":1,"40":1,"49":1}}],["loaded",{"2":{"1":6,"11":1,"12":2,"13":3,"14":2,"15":1,"49":1}}],["h5",{"2":{"14":2}}],["html",{"2":{"2":4}}],["https",{"2":{"1":4,"2":6,"42":1,"46":1}}],["hood",{"2":{"50":1}}],["hosting",{"2":{"29":1}}],["however",{"2":{"1":2}}],["how",{"2":{"1":3,"25":1,"29":2,"40":1}}],["holding",{"2":{"2":1,"6":1}}],["holds",{"2":{"1":1,"2":3}}],["hold",{"2":{"1":6}}],["height=relative",{"2":{"38":1}}],["help",{"2":{"12":1}}],["header",{"2":{"2":3}}],["heatmap",{"2":{"1":1,"2":4,"34":1,"38":4,"39":1,"40":2,"49":1,"50":3}}],["heterogeneity",{"2":{"1":1}}],["here",{"2":{"1":3,"2":1,"9":1,"26":1,"36":1,"38":1,"42":1,"49":4,"50":1}}],["history",{"2":{"42":2}}],["hidden",{"2":{"2":1}}],["hideydecorations",{"2":{"39":1}}],["hidexdecorations",{"2":{"39":1}}],["hide",{"2":{"1":7}}],["highlighted",{"2":{"50":1}}],["highlight",{"2":{"50":1}}],["high",{"2":{"1":6,"2":1,"26":1,"38":1,"40":1}}],["happens",{"2":{"50":1}}],["had",{"2":{"6":1}}],["handling",{"2":{"1":1}}],["handled",{"2":{"1":1}}],["handle",{"2":{"1":3,"25":2,"47":1}}],["habitat",{"2":{"1":1}}],["habitatheterogeneity",{"2":{"1":7,"39":2}}],["having",{"2":{"1":3}}],["have",{"2":{"1":13,"2":4,"9":1,"11":1,"12":3,"25":1,"28":1,"29":1,"42":1,"44":1,"49":4,"50":2}}],["haschunks",{"2":{"2":1}}],["has",{"2":{"1":10,"15":1,"36":1,"42":2,"49":1,"50":2}}],["hdf5",{"2":{"1":1,"2":1,"14":1,"15":1,"28":1}}],["j",{"2":{"39":2}}],["json3",{"2":{"18":2}}],["january",{"2":{"1":3,"38":1}}],["join",{"2":{"1":1,"30":1}}],["joined",{"2":{"1":2}}],["june",{"2":{"50":3}}],["just",{"2":{"1":4,"2":2,"4":1,"26":1,"28":1,"29":2,"36":1,"49":1,"50":2}}],["juliax",{"2":{"49":1}}],["julianorway",{"2":{"48":2}}],["julianp",{"2":{"48":1}}],["julianewstack",{"2":{"5":1}}],["juliadp",{"2":{"48":1}}],["juliadisaggregate",{"2":{"1":2}}],["juliafunction",{"2":{"48":1}}],["juliafig",{"2":{"35":1}}],["juliafilearray",{"2":{"2":1}}],["juliafilestack",{"2":{"2":1}}],["juliafiles",{"2":{"1":1}}],["juliawrite",{"2":{"44":1,"48":1}}],["juliawarp",{"2":{"1":1}}],["julialayers",{"2":{"39":1}}],["julialon",{"2":{"23":1}}],["juliaopen",{"2":{"2":1,"5":1}}],["juliaopenstack",{"2":{"2":1}}],["juliazonal",{"2":{"1":1}}],["juliatrim",{"2":{"1":1}}],["juliascandinavia",{"2":{"48":1}}],["juliasp",{"2":{"48":1}}],["juliashapes",{"2":{"47":1}}],["juliastack",{"2":{"36":1}}],["julias",{"2":{"2":3,"11":1}}],["juliaskipmissing",{"2":{"2":1}}],["juliaslice",{"2":{"1":1}}],["juliaset",{"2":{"9":1}}],["juliasetmappedcrs",{"2":{"1":1}}],["juliasetcrs",{"2":{"1":1}}],["juliaras",{"2":{"24":3,"25":1,"49":1}}],["juliarasterdiskarray",{"2":{"2":1}}],["juliarasterize",{"2":{"1":2}}],["juliarasters",{"2":{"2":1,"38":1}}],["juliarasterstack",{"2":{"1":1}}],["juliarasterseries",{"2":{"1":2}}],["juliaraster",{"2":{"1":1}}],["juliarecords",{"2":{"18":1}}],["juliaread",{"2":{"2":2}}],["juliaresample",{"2":{"1":1}}],["juliareproject",{"2":{"1":2}}],["juliareplace",{"2":{"1":1,"8":1}}],["juliap",{"2":{"48":1}}],["juliapredictors",{"2":{"20":1}}],["juliaprojected",{"2":{"1":1}}],["juliapoints",{"2":{"1":1}}],["juliaextract",{"2":{"1":1}}],["juliaextend",{"2":{"1":1}}],["juliacheckmem",{"2":{"2":1}}],["juliacrop",{"2":{"1":1}}],["juliacrs",{"2":{"1":1}}],["juliacoords",{"2":{"19":1}}],["juliacoverage",{"2":{"1":2}}],["juliaconvertlookup",{"2":{"1":1}}],["juliacombine",{"2":{"1":1}}],["juliaclassify",{"2":{"1":2}}],["juliacellarea",{"2":{"1":1,"49":3}}],["juliab",{"2":{"7":1}}],["juliabase",{"2":{"2":4}}],["juliabanddim",{"2":{"1":1}}],["juliaband",{"2":{"1":1}}],["juliaboolmask",{"2":{"1":1}}],["juliausing",{"2":{"1":21,"4":1,"9":1,"14":1,"16":1,"18":1,"20":3,"22":2,"26":1,"28":1,"35":1,"39":1,"40":1,"41":1,"42":3,"43":1,"46":1,"47":1,"49":4}}],["juliaa",{"2":{"5":1,"7":1,"20":1,"42":1,"44":1}}],["juliaabstractprojected",{"2":{"2":1}}],["juliaabstractrasterstack",{"2":{"1":1}}],["juliaabstractrasterseries",{"2":{"1":1}}],["juliaabstractraster",{"2":{"1":1}}],["juliaaggregate",{"2":{"1":2}}],["juliamean",{"2":{"4":1}}],["juliamosaic",{"2":{"1":2}}],["juliamodify",{"2":{"1":1}}],["juliamissingval",{"2":{"1":1}}],["juliamissingmask",{"2":{"1":1}}],["juliamakie",{"2":{"36":1,"37":1,"38":2}}],["juliamask",{"2":{"1":2,"47":1}}],["juliamappedindex",{"2":{"1":1}}],["juliamappedcrs",{"2":{"1":1}}],["juliamappedbounds",{"2":{"1":1}}],["juliamapped",{"2":{"1":1}}],["juliajulia>",{"2":{"1":2}}],["juliagdalarray",{"2":{"1":1}}],["julia",{"2":{"1":1,"2":1,"3":1,"20":1,"22":1,"27":1,"28":1,"31":1,"39":1}}],["jl",{"0":{"16":1,"47":1,"48":1},"2":{"1":47,"2":4,"9":1,"10":1,"12":1,"13":1,"16":3,"17":2,"19":1,"20":1,"22":2,"25":1,"26":1,"28":1,"29":3,"38":1,"40":3,"42":2,"44":2,"45":1,"47":1,"48":1,"49":2,"50":3}}],["ignore",{"2":{"1":4,"2":2}}],["ignored",{"2":{"1":1,"2":1}}],["image",{"2":{"39":1}}],["imola",{"2":{"1":1}}],["improve",{"2":{"2":2}}],["implemented",{"2":{"1":1,"15":1}}],["implementation",{"2":{"1":2}}],["implementations",{"2":{"1":1}}],["important",{"2":{"50":1}}],["import",{"2":{"1":1,"49":2}}],["irregular",{"2":{"1":3}}],["i",{"2":{"1":2,"2":4,"20":1,"38":3,"39":6,"48":1,"49":2}}],["ie",{"2":{"1":1}}],["if",{"2":{"1":78,"2":37,"4":1,"6":1,"7":1,"19":1,"23":2,"29":1,"33":1,"38":7,"40":1,"42":1,"48":1,"49":4,"50":2}}],["identically",{"2":{"1":1}}],["identical",{"2":{"1":4}}],["inaccurate",{"2":{"49":1}}],["input",{"2":{"38":2,"49":1}}],["inputs",{"2":{"1":1}}],["invoke",{"2":{"40":1}}],["involves",{"2":{"29":1}}],["invert",{"2":{"1":8}}],["info",{"2":{"26":1,"31":1}}],["information",{"2":{"1":3,"17":1}}],["inf",{"2":{"4":4,"5":6}}],["indices",{"2":{"24":1,"26":2,"42":1}}],["indicates",{"2":{"2":1,"38":1}}],["individually",{"2":{"2":2}}],["individual",{"2":{"1":1,"2":1,"14":1,"48":1}}],["independently",{"2":{"1":1}}],["indexing",{"2":{"5":1}}],["indexed",{"2":{"1":3,"2":1,"4":1,"22":1}}],["index",{"0":{"0":1,"24":1},"2":{"1":19,"2":3,"24":1,"25":1,"26":4,"42":1,"49":2}}],["indonesian",{"2":{"1":1}}],["indonesia",{"2":{"1":7}}],["installation",{"0":{"27":1}}],["install",{"0":{"22":1}}],["instead",{"2":{"1":5,"2":1,"9":1,"40":1,"42":2}}],["insertcols",{"2":{"1":1}}],["inside",{"2":{"1":18}}],["including",{"2":{"1":4}}],["includes",{"2":{"48":1}}],["included",{"2":{"1":4,"48":1}}],["include",{"2":{"1":9,"29":1}}],["increase",{"2":{"1":1}}],["increases",{"2":{"1":2}}],["incorrectly",{"2":{"6":1}}],["incorrect",{"2":{"1":6,"49":1}}],["int16",{"2":{"47":2,"48":1}}],["int64",{"2":{"18":4,"22":2,"23":1,"24":6,"25":2,"49":7}}],["into",{"2":{"1":12,"16":1,"29":1,"30":1,"31":1,"48":1,"50":1}}],["intended",{"2":{"28":1}}],["integrated",{"2":{"16":1}}],["integration",{"0":{"16":1}}],["integer",{"2":{"1":6}}],["integers",{"2":{"1":5}}],["interesting",{"2":{"50":1}}],["internet",{"2":{"50":1}}],["internal",{"0":{"2":1},"2":{"1":2,"2":3}}],["interpreted",{"2":{"36":1}}],["interpolation",{"2":{"1":1}}],["interface",{"2":{"1":1,"17":1,"36":1}}],["intervalsets",{"2":{"1":1}}],["intervals",{"2":{"1":3,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"35":2,"39":2,"42":6,"47":4,"48":3,"49":11}}],["interval",{"2":{"1":5,"24":1,"26":1,"42":2,"49":1}}],["int",{"2":{"1":24,"2":9}}],["in",{"0":{"34":1,"35":1,"36":1},"2":{"1":176,"2":13,"5":1,"9":1,"12":2,"14":1,"15":3,"16":1,"17":1,"19":2,"20":1,"26":2,"28":3,"29":2,"30":1,"31":2,"33":1,"34":1,"36":3,"38":1,"39":4,"40":1,"42":5,"44":1,"45":1,"48":1,"49":14,"50":9}}],["inherit",{"2":{"1":1}}],["issue",{"2":{"29":3}}],["issues",{"2":{"1":19,"12":1,"29":3,"49":1}}],["isn",{"2":{"29":1}}],["ismissing",{"2":{"19":1}}],["islands",{"2":{"1":6,"48":1,"50":1}}],["island",{"2":{"1":2}}],["isfile",{"2":{"1":5}}],["is",{"2":{"1":217,"2":28,"4":2,"9":1,"12":2,"13":1,"14":1,"16":1,"22":1,"23":2,"24":1,"25":3,"26":2,"29":1,"33":1,"34":1,"35":2,"36":2,"38":2,"40":3,"44":1,"48":1,"49":8,"50":9}}],["itr",{"2":{"2":1}}],["iteratively",{"2":{"1":1}}],["iterator",{"2":{"1":2}}],["iterable",{"2":{"1":8,"2":1}}],["iterables",{"2":{"1":1}}],["it",{"2":{"1":51,"2":21,"9":1,"28":2,"29":7,"33":1,"36":1,"38":1,"40":1,"42":5,"48":1,"49":5,"50":5}}],["itself",{"2":{"1":1}}],["its",{"2":{"1":2,"2":1,"28":1,"29":1,"38":1}}],["wgs",{"2":{"4":6,"5":3,"7":3,"8":3,"9":6,"20":3,"35":3,"39":3,"47":6,"48":3}}],["www",{"2":{"2":2,"42":1}}],["wc2",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["wc",{"2":{"1":10}}],["well",{"2":{"28":1,"50":1}}],["wellknowntext",{"2":{"1":1}}],["were",{"2":{"4":1,"15":1}}],["web",{"2":{"2":2,"29":1}}],["weighted",{"2":{"1":2}}],["wether",{"2":{"1":3}}],["we",{"2":{"1":6,"2":3,"4":1,"5":2,"9":2,"17":1,"20":1,"28":1,"29":9,"36":1,"40":1,"42":4,"44":1,"45":1,"47":2,"48":2,"49":10,"50":17}}],["wrong",{"2":{"2":1}}],["writing",{"0":{"15":1},"2":{"1":5,"2":6,"33":1}}],["written",{"2":{"1":7,"2":6,"15":2}}],["writes",{"2":{"2":2}}],["write=false",{"2":{"2":1}}],["write=true",{"2":{"1":2,"2":1,"5":1}}],["write",{"0":{"33":1,"44":1},"2":{"1":15,"2":24,"5":1,"15":2,"20":2,"33":2,"44":1,"48":3}}],["wrapping",{"2":{"2":4,"23":1}}],["wrapped",{"2":{"1":1,"2":1}}],["wrapper",{"2":{"1":2,"2":3}}],["wraper",{"2":{"1":1}}],["wrap",{"2":{"1":1}}],["worst",{"2":{"1":1}}],["world",{"2":{"1":2,"50":1}}],["worldclim",{"2":{"1":20,"4":3,"5":1,"7":2,"8":1,"9":2,"16":1,"20":1,"26":1,"28":1,"35":2,"36":1,"38":2,"40":1,"41":1,"47":2,"50":2}}],["workflow",{"0":{"17":1},"1":{"18":1,"19":1,"20":1},"2":{"50":1}}],["works",{"2":{"4":1,"9":1,"34":1}}],["working",{"2":{"2":1,"29":1,"49":1,"50":1}}],["work",{"2":{"1":7,"2":2,"3":1,"25":1,"26":1,"28":1,"29":1,"31":1,"35":1,"48":1}}],["would",{"2":{"1":2,"4":1}}],["want",{"2":{"1":1,"49":2}}],["way",{"2":{"1":3,"2":1,"26":1,"36":1,"40":1}}],["warned",{"2":{"1":1,"49":1}}],["warnings",{"2":{"1":2}}],["warning",{"2":{"1":19,"36":1,"49":1}}],["warped",{"2":{"1":2}}],["warp",{"2":{"0":1,"1":8,"30":1}}],["was",{"2":{"1":2,"28":2,"50":1}}],["wildly",{"2":{"49":1}}],["will",{"2":{"1":97,"2":22,"4":1,"5":1,"7":1,"9":3,"10":1,"12":1,"22":1,"25":1,"40":5,"42":2,"45":1,"48":2,"49":3}}],["wind",{"2":{"47":5,"48":4}}],["windowed",{"2":{"1":1}}],["width=5",{"2":{"38":1}}],["width",{"2":{"2":1,"38":1,"39":5}}],["wish",{"2":{"2":1}}],["within",{"2":{"26":1}}],["with=poly",{"2":{"47":1}}],["with=maskfile",{"2":{"2":1}}],["with=wc",{"2":{"1":2}}],["without",{"2":{"1":6,"12":1,"14":1,"29":2}}],["with",{"0":{"38":1,"48":1},"2":{"1":83,"2":17,"4":2,"5":1,"7":1,"8":1,"9":3,"14":1,"15":1,"16":1,"22":1,"25":4,"26":1,"29":2,"34":1,"35":1,"38":1,"39":1,"40":2,"42":4,"45":1,"47":1,"48":3,"49":1,"50":3}}],["why",{"2":{"50":1}}],["what",{"2":{"49":2,"50":1}}],["whatever",{"2":{"1":1,"29":1}}],["whose",{"2":{"2":1,"38":1}}],["whole",{"2":{"1":3}}],["whether",{"2":{"1":4,"2":3,"38":1,"49":1}}],["wherever",{"2":{"1":2}}],["where",{"2":{"1":46,"2":1,"15":1,"25":2,"26":2,"28":1,"48":1,"49":2}}],["when",{"2":{"1":66,"2":3,"4":2,"5":2,"28":1,"29":1,"44":1,"48":1,"50":1}}],["while",{"2":{"1":1}}],["which",{"2":{"1":28,"2":6,"5":1,"9":1,"10":1,"11":1,"13":1,"36":3,"38":3,"40":1,"42":1,"48":1,"49":3,"50":1}}],["tutorial",{"0":{"49":1},"1":{"50":1}}],["tuples",{"2":{"1":3}}],["tuple",{"2":{"1":64,"2":6,"18":2,"19":2,"20":20}}],["text",{"2":{"36":1}}],["template",{"2":{"29":2}}],["temperatures",{"2":{"42":1}}],["temperature",{"2":{"7":2,"14":1,"42":4,"44":1}}],["tempname",{"2":{"1":1}}],["tempfile",{"2":{"1":4}}],["tempory",{"2":{"1":1}}],["temp=",{"2":{"1":1}}],["temp",{"2":{"1":2}}],["typing",{"0":{"22":1}}],["typically",{"2":{"2":1}}],["typename",{"2":{"2":2}}],["types",{"2":{"2":3,"29":1,"48":1}}],["type",{"2":{"1":7,"2":8,"15":1,"38":3}}],["two",{"2":{"1":2,"26":1,"40":1}}],["twice",{"2":{"1":2}}],["tmax",{"2":{"1":3,"47":5,"48":4}}],["tmin",{"2":{"1":2,"47":5,"48":4}}],["t",{"2":{"1":3,"2":5,"9":1,"29":1,"42":2,"44":1,"50":1}}],["target",{"2":{"1":1}}],["tavg",{"2":{"1":3,"16":1}}],["tabular",{"2":{"1":1}}],["table",{"0":{"32":1},"2":{"1":18,"18":1,"20":1}}],["tables",{"2":{"1":18}}],["take",{"2":{"2":1,"3":1,"26":1,"29":1,"38":1,"42":1,"48":1}}],["takes",{"2":{"1":2}}],["taken",{"2":{"1":4}}],["taking",{"2":{"1":3,"13":1}}],["tickalign",{"2":{"39":4}}],["tickalign=1",{"2":{"39":1}}],["ticks=false",{"2":{"39":2}}],["ticksize",{"2":{"39":5}}],["tiled",{"2":{"36":1,"40":1}}],["ti=at",{"2":{"25":1}}],["ti=1",{"2":{"24":1,"42":1}}],["tightly",{"2":{"16":1}}],["titles",{"2":{"2":1,"38":1}}],["title",{"2":{"2":1,"38":1,"39":1,"50":1}}],["ti",{"2":{"1":7,"4":1,"12":1,"22":6,"24":4,"25":1,"42":5,"44":1}}],["tif",{"2":{"1":8,"4":2,"5":1,"7":1,"8":1,"9":2,"13":2,"35":1,"48":6}}],["tifs",{"2":{"1":1}}],["tiff",{"2":{"1":2,"2":4,"13":1}}],["timespan",{"2":{"42":1}}],["time",{"0":{"4":1},"2":{"1":4,"4":1,"22":1,"24":1,"25":1,"28":1,"29":2,"36":1,"42":4,"48":1}}],["trace",{"2":{"29":1}}],["transect",{"2":{"44":1}}],["transparent",{"2":{"2":2,"38":2,"39":2}}],["transformations",{"2":{"28":1}}],["transformation",{"2":{"1":1,"49":1}}],["transforming",{"2":{"1":1,"49":1}}],["transferred",{"2":{"1":1}}],["tr",{"2":{"1":2}}],["trigger",{"2":{"29":1}}],["triggers",{"2":{"1":1,"29":1}}],["trims",{"2":{"30":1}}],["trimming",{"2":{"1":1}}],["trimmed",{"2":{"1":3,"39":1}}],["trim",{"2":{"0":1,"1":10,"30":1,"39":2,"47":7,"48":1}}],["try",{"2":{"1":1,"9":1,"49":1}}],["true",{"2":{"1":38,"2":18,"18":1,"38":1,"49":1}}],["treated",{"2":{"1":11,"25":1,"36":1}}],["together",{"2":{"45":1}}],["tos",{"2":{"42":5,"43":1,"44":3}}],["toy",{"2":{"22":1}}],["top",{"2":{"2":1,"38":1}}],["touch",{"2":{"1":2}}],["touches=false",{"2":{"1":1}}],["touches",{"2":{"1":13}}],["tolerances",{"2":{"1":2}}],["tolerance",{"2":{"1":3}}],["to=b",{"2":{"1":1}}],["to=first",{"2":{"1":1}}],["to=awap",{"2":{"1":2}}],["to=rnge",{"2":{"1":1}}],["to=shp",{"2":{"1":1}}],["to=nz",{"2":{"1":1}}],["total",{"2":{"1":2,"50":8}}],["to",{"0":{"15":1,"33":1,"44":1},"2":{"1":321,"2":57,"4":1,"5":5,"6":1,"7":1,"9":6,"10":2,"12":1,"15":2,"16":2,"17":1,"19":1,"20":3,"22":2,"25":4,"26":4,"28":5,"29":9,"30":5,"33":5,"34":1,"36":1,"38":8,"39":1,"40":4,"42":4,"44":1,"45":1,"48":5,"49":12,"50":13}}],["things",{"2":{"2":1}}],["third",{"2":{"1":2,"2":1,"38":1,"42":1}}],["this",{"2":{"1":64,"2":9,"5":1,"9":1,"17":1,"22":2,"28":2,"29":1,"35":1,"36":2,"38":4,"40":1,"42":1,"45":1,"49":11,"50":9}}],["three",{"2":{"29":1}}],["thread",{"2":{"1":4}}],["threadsafe=true",{"2":{"1":1}}],["threadsafe",{"2":{"1":7}}],["threading",{"2":{"1":6}}],["threaded=false",{"2":{"1":1}}],["threaded",{"2":{"1":20}}],["through",{"2":{"1":1,"2":1,"30":1}}],["than",{"2":{"1":7,"15":2,"34":1,"42":1}}],["that",{"0":{"30":1,"31":1},"2":{"1":64,"2":9,"3":1,"6":1,"9":2,"12":1,"15":1,"16":1,"22":1,"29":7,"31":1,"36":1,"38":1,"42":1,"48":1,"49":7,"50":9}}],["then",{"2":{"1":2,"2":1,"4":1,"7":1,"20":1,"22":1,"29":2,"38":1,"42":1,"45":1,"47":2,"50":2}}],["theme",{"0":{"37":1},"1":{"38":1,"39":1},"2":{"36":3,"37":1,"38":4,"39":2}}],["theming",{"2":{"36":1}}],["themselves",{"2":{"2":1}}],["them",{"2":{"1":5,"2":1,"20":2,"25":1,"29":2,"48":1}}],["there",{"2":{"1":6,"2":1,"29":3,"48":1}}],["these",{"2":{"1":13,"2":2,"13":1,"14":1,"20":1,"25":1,"31":1,"38":1,"48":2,"49":1}}],["their",{"2":{"1":1,"47":1}}],["they",{"2":{"1":6,"2":1,"11":2,"15":2,"25":1,"29":2}}],["the",{"0":{"4":1,"22":1,"23":1,"30":1,"46":1},"1":{"47":1,"48":1},"2":{"1":509,"2":114,"3":1,"4":2,"5":4,"6":2,"7":3,"9":4,"12":3,"13":2,"14":2,"15":1,"16":4,"17":2,"19":1,"22":2,"24":1,"25":4,"26":13,"28":2,"29":14,"30":4,"33":2,"34":1,"36":1,"38":42,"39":2,"40":7,"42":10,"44":3,"45":2,"47":2,"48":6,"49":42,"50":39}}],["ocean",{"2":{"42":1,"44":1}}],["occurs",{"2":{"5":1}}],["occurrences",{"2":{"17":1}}],["occurrence",{"2":{"1":3,"18":2,"20":1}}],["occur",{"2":{"1":24,"29":1,"49":1}}],["o1",{"2":{"42":2}}],["o",{"2":{"5":2}}],["omitted",{"2":{"1":1,"18":1}}],["obtain",{"2":{"1":1,"40":1}}],["observable",{"2":{"38":2}}],["observables",{"0":{"38":1}}],["observation",{"2":{"1":1}}],["obs",{"2":{"1":2,"38":3}}],["obj",{"2":{"1":10}}],["object",{"0":{"6":1,"26":1,"30":1},"1":{"7":1,"8":1,"9":1},"2":{"1":41,"2":10,"6":2,"9":1,"18":1,"26":1,"30":4,"31":2,"32":1,"44":1}}],["objects",{"0":{"31":1},"2":{"1":17,"2":5,"9":1,"26":2,"30":2,"33":3,"42":2}}],["our",{"2":{"1":1,"29":1,"42":1,"50":1}}],["outside",{"2":{"1":2,"50":1}}],["output",{"2":{"1":29,"22":1,"49":1}}],["out",{"2":{"1":6,"38":1,"39":1,"48":1}}],["opacity=0",{"2":{"20":1}}],["op",{"2":{"1":5}}],["optionally",{"2":{"1":1}}],["options",{"2":{"1":1,"2":6,"25":1}}],["optimisations",{"2":{"1":3}}],["opbject",{"2":{"1":1}}],["operation",{"0":{"32":1},"2":{"1":8,"2":1}}],["operations",{"0":{"3":1},"1":{"4":1,"5":1,"6":1,"7":1,"8":1,"9":1},"2":{"1":5,"2":1,"12":1}}],["opens",{"2":{"2":1}}],["openstack",{"2":{"0":1,"2":3}}],["openinterval",{"2":{"1":1}}],["open",{"2":{"1":6,"2":11,"5":1,"33":2}}],["opened",{"2":{"1":3,"2":3}}],["otherwise",{"2":{"1":10,"12":1}}],["others=0",{"2":{"1":2}}],["others=nothing",{"2":{"1":1}}],["others",{"2":{"1":9}}],["other",{"2":{"1":20,"2":8,"14":1,"15":1,"25":1,"26":1,"28":1,"29":1,"31":1,"36":1,"42":2,"48":1}}],["overridden",{"2":{"2":1}}],["overlap",{"2":{"1":2,"48":1}}],["overlapping",{"2":{"1":2}}],["over",{"0":{"4":1},"2":{"1":12,"2":1,"4":2,"5":1,"29":1,"42":1,"48":1,"50":2}}],["onwards",{"2":{"28":1}}],["ones",{"2":{"49":1}}],["one",{"2":{"1":9,"2":4,"9":2,"42":3,"49":1}}],["on",{"2":{"1":27,"2":5,"9":1,"16":1,"20":1,"25":1,"26":1,"28":1,"29":3,"30":1,"33":1,"38":2,"40":3,"42":2,"49":7,"50":1}}],["only",{"2":{"1":29,"2":5,"4":1,"5":1,"9":1,"28":1,"40":1,"42":2,"50":2}}],["offset",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["of=countries",{"2":{"1":1}}],["often",{"2":{"1":9,"2":1,"29":1}}],["of",{"0":{"30":1},"2":{"1":224,"2":50,"4":2,"5":2,"6":1,"7":2,"8":1,"9":5,"10":1,"14":1,"16":1,"19":1,"24":1,"25":1,"26":3,"29":4,"30":3,"35":1,"36":1,"38":20,"39":1,"40":2,"42":4,"44":1,"48":3,"49":12,"50":8}}],["org",{"2":{"2":4}}],["original",{"2":{"1":4,"2":3,"42":4}}],["order=autoorder",{"2":{"1":2}}],["order",{"2":{"1":14}}],["or",{"0":{"30":1},"2":{"1":296,"2":35,"5":1,"6":1,"7":1,"15":1,"16":1,"20":1,"22":1,"24":2,"28":1,"29":4,"30":5,"31":2,"32":1,"33":1,"34":1,"36":1,"38":8,"40":2,"44":1,"49":4}}],["flipaxis",{"2":{"39":3}}],["fletcher32",{"2":{"2":2}}],["flexible",{"2":{"1":1}}],["flag",{"2":{"1":1}}],["flags",{"2":{"1":4}}],["float",{"2":{"1":2}}],["floating",{"2":{"1":5}}],["float32",{"2":{"1":5,"4":2,"5":1,"7":1,"8":1,"9":2,"20":84,"35":1,"42":2,"47":6,"48":3}}],["float64",{"2":{"1":8,"4":7,"5":4,"7":4,"8":4,"9":8,"18":2,"19":2,"20":44,"22":1,"24":3,"25":1,"35":4,"39":4,"42":4,"47":8,"48":2,"49":5}}],["framerate",{"2":{"38":1}}],["fraction",{"2":{"1":2}}],["from",{"0":{"23":1},"2":{"1":67,"2":14,"4":1,"9":1,"12":2,"13":1,"17":1,"25":1,"26":1,"28":1,"32":1,"33":1,"38":1,"42":1,"47":1,"48":1,"49":1,"50":2}}],["features",{"2":{"1":2}}],["feature",{"2":{"1":24,"49":1}}],["f",{"2":{"1":15,"2":3,"26":1,"50":1}}],["fundamentally",{"2":{"50":1}}],["functionality",{"2":{"28":2}}],["function",{"2":{"1":17,"2":1,"4":1,"5":1,"26":2,"29":1,"30":1,"34":1,"40":3,"48":2,"50":2}}],["functions",{"0":{"1":1,"2":1},"2":{"1":10,"40":1,"42":1}}],["fully",{"2":{"1":1,"40":1,"49":1}}],["future",{"2":{"1":21,"49":1}}],["far",{"2":{"50":1}}],["fast",{"2":{"11":1}}],["fastest",{"2":{"1":1}}],["faster",{"2":{"1":9,"49":1}}],["fall",{"2":{"42":1}}],["falls",{"2":{"26":1}}],["fallback",{"2":{"2":2,"44":1}}],["falling",{"2":{"1":1}}],["false",{"2":{"1":25,"2":11,"39":1}}],["fail",{"2":{"1":1}}],["fact",{"2":{"49":1}}],["factor",{"2":{"1":4}}],["facility",{"2":{"17":1}}],["facilitate",{"2":{"1":1}}],["following",{"2":{"22":1}}],["focus",{"2":{"16":1}}],["fo",{"2":{"1":1}}],["found",{"2":{"1":2,"2":2}}],["forward",{"2":{"40":1}}],["forwardordered",{"2":{"1":4,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"22":3,"23":1,"24":7,"25":2,"35":1,"39":1,"42":6,"47":2,"48":1,"49":8}}],["foreach",{"2":{"20":1}}],["form",{"2":{"1":1}}],["formats",{"0":{"15":1},"2":{"15":3}}],["format",{"2":{"1":3,"14":1,"20":1}}],["forced",{"2":{"2":1}}],["force",{"2":{"1":10,"2":15}}],["for",{"2":{"1":138,"2":25,"3":1,"5":1,"10":1,"12":1,"14":2,"15":2,"16":3,"17":1,"19":1,"25":2,"28":3,"29":3,"30":3,"31":1,"32":1,"33":1,"34":1,"36":1,"38":6,"39":4,"40":4,"44":1,"48":3,"49":5,"50":4}}],["five",{"2":{"49":1}}],["figure",{"2":{"39":3}}],["fig",{"2":{"35":4,"38":2,"39":10}}],["fixing",{"2":{"29":1}}],["fixed",{"2":{"29":1}}],["fix",{"2":{"29":3}}],["fix2",{"2":{"1":9}}],["finally",{"2":{"28":1}}],["findfirst",{"2":{"50":1}}],["find",{"2":{"26":1,"29":1}}],["finished",{"2":{"28":1}}],["finish",{"2":{"2":1}}],["field",{"2":{"1":1,"9":1}}],["fields",{"2":{"1":6,"6":1}}],["filter",{"2":{"2":2,"26":1}}],["filled",{"2":{"40":1,"42":1}}],["fillvalue",{"2":{"2":3,"42":2}}],["fillalpha=0",{"2":{"1":2,"48":1}}],["fill=1",{"2":{"1":2}}],["fill",{"2":{"1":12}}],["fills",{"2":{"1":2}}],["filepaths",{"2":{"1":1}}],["filepath",{"2":{"1":6,"2":6,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["file",{"0":{"15":1},"2":{"1":45,"2":23,"5":1,"6":1,"12":2,"15":1,"20":1,"29":7,"30":1,"33":1,"42":2,"48":3,"49":1}}],["files",{"2":{"1":18,"2":7,"6":1,"11":1,"12":3,"13":2,"15":1,"22":1,"28":1,"29":1,"40":1,"45":1}}],["filestack",{"2":{"0":1,"2":2}}],["filenames",{"2":{"1":5}}],["filename",{"2":{"1":34,"2":20,"5":1,"12":2,"13":2,"14":2,"15":1,"42":2}}],["filearray",{"2":{"0":1,"1":2,"2":3}}],["fit",{"2":{"1":1}}],["first",{"2":{"1":22,"12":1,"14":1,"29":1,"42":3,"45":1,"48":4,"49":1,"50":3}}],["sweden",{"2":{"47":4,"48":5}}],["swapping",{"2":{"1":1}}],["squished",{"2":{"36":1}}],["squared",{"2":{"50":1}}],["square",{"2":{"1":7,"50":6}}],["smaller",{"2":{"36":1}}],["smallest",{"2":{"1":2}}],["smapseries",{"2":{"14":1}}],["smap",{"0":{"14":1},"2":{"15":1,"28":1}}],["sciences",{"2":{"16":1}}],["screen",{"2":{"39":1}}],["scr",{"2":{"2":1}}],["scandinavia",{"2":{"48":10}}],["scandinavian",{"2":{"45":1}}],["scatter",{"2":{"20":2}}],["scarborough",{"2":{"1":1}}],["scale^2",{"2":{"1":2}}],["scale",{"2":{"1":27,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["snap",{"2":{"1":1,"30":1}}],["skewed",{"2":{"1":1}}],["skipping",{"2":{"2":1}}],["skipped",{"2":{"1":2}}],["skip",{"2":{"1":1}}],["skipmissing=true",{"2":{"1":1}}],["skipmissingval=false",{"2":{"1":1}}],["skipmissingval=true",{"2":{"1":1}}],["skipmissingval",{"2":{"1":2}}],["skipmissing",{"2":{"1":4,"2":1,"50":4}}],["slow",{"2":{"1":1}}],["slicing",{"2":{"1":1}}],["slices",{"2":{"1":3}}],["sliced",{"2":{"1":5,"42":1}}],["slice",{"2":{"0":1,"1":6,"24":1}}],["src",{"2":{"1":10,"2":4}}],["s",{"2":{"1":12,"2":7,"9":1,"14":1,"26":2,"29":1,"49":2,"50":9}}],["system",{"2":{"1":10,"34":1,"49":1,"50":1}}],["symbols",{"2":{"2":1,"38":1}}],["symbol",{"2":{"1":32,"2":6}}],["syntax",{"2":{"1":2,"16":1,"24":1,"48":1}}],["safe",{"2":{"1":4,"2":1}}],["sa",{"2":{"1":6}}],["saved",{"2":{"2":2}}],["savefig",{"2":{"1":24}}],["save",{"2":{"1":3,"2":2,"39":1,"42":1,"48":1}}],["sample",{"2":{"1":5}}],["sampled",{"2":{"1":6,"22":3,"23":1,"24":7,"25":2,"42":2}}],["sampling=intervals",{"2":{"1":4,"49":2}}],["sampling=autosampling",{"2":{"1":2}}],["sampling",{"2":{"1":2,"49":5}}],["same",{"2":{"1":11,"6":1,"12":1,"29":1,"30":1,"38":2,"48":1,"49":1}}],["sure",{"2":{"29":2,"40":1,"50":1}}],["surface",{"2":{"2":1,"34":2,"35":1,"38":1,"40":2,"42":4,"44":1}}],["subtle",{"2":{"29":2}}],["subplot=i",{"2":{"20":1,"48":1}}],["subplots",{"2":{"20":1,"48":1}}],["subarray",{"2":{"18":1}}],["substrin",{"2":{"1":1}}],["subsetting",{"0":{"26":1}}],["subset",{"2":{"1":1,"20":1,"25":1,"26":1}}],["subdivision",{"2":{"1":2}}],["summed",{"2":{"1":2}}],["sum",{"2":{"1":23,"50":5}}],["suffix",{"2":{"1":19,"2":2}}],["such",{"2":{"1":11,"2":5,"3":1,"13":1,"31":1,"50":1}}],["supports",{"2":{"40":1}}],["supported",{"2":{"40":1}}],["support",{"2":{"38":1}}],["supplied",{"2":{"1":1}}],["supertype",{"2":{"1":3,"2":1}}],["sosstsst",{"2":{"42":2}}],["soil",{"2":{"14":2}}],["software",{"2":{"2":2,"42":1}}],["sovereign",{"2":{"1":1}}],["south",{"2":{"1":1,"20":1}}],["sources",{"0":{"10":1,"33":1},"1":{"11":1,"12":1,"13":1,"14":1,"15":1,"16":1},"2":{"1":2,"16":2,"28":1}}],["source",{"2":{"1":58,"2":27,"38":1,"49":1}}],["so",{"2":{"1":11,"2":1,"9":1,"16":1,"20":1,"22":1,"28":1,"29":4,"35":1,"42":1,"44":1,"49":2,"50":2}}],["somewhat",{"2":{"34":1}}],["something",{"2":{"22":1}}],["somelayer",{"2":{"1":2}}],["some",{"2":{"1":16,"2":1,"12":1,"15":2,"29":2,"36":1,"47":1,"49":1}}],["side",{"2":{"2":1,"38":1,"49":2}}],["sides",{"2":{"1":1}}],["since",{"2":{"1":1,"34":1,"40":1,"50":1}}],["sinc",{"2":{"1":1}}],["singleton",{"2":{"2":1,"38":1}}],["single",{"2":{"1":37,"2":3,"30":1,"45":1,"48":2}}],["silently",{"2":{"1":1}}],["size=",{"2":{"39":1,"43":1}}],["sizes",{"2":{"2":1,"30":2}}],["size",{"2":{"1":32,"2":10,"20":4,"30":1,"39":4,"47":8,"48":4,"49":1}}],["sized",{"2":{"1":1}}],["simple",{"0":{"40":1,"41":1},"2":{"1":5}}],["simply",{"2":{"1":3,"42":1,"49":1}}],["similarly",{"2":{"30":1,"40":1}}],["similar",{"2":{"1":1,"22":1,"40":1}}],["still",{"2":{"12":1,"42":1}}],["store",{"2":{"15":1}}],["stored",{"2":{"1":1,"2":4}}],["stores",{"2":{"1":1}}],["stereographic",{"2":{"49":1}}],["step",{"2":{"49":1}}],["steps",{"2":{"1":1,"29":1}}],["stem",{"2":{"1":1}}],["st",{"2":{"1":16,"39":2}}],["statistic",{"2":{"50":2}}],["statistics",{"2":{"1":9,"3":1,"4":1,"32":1,"42":1}}],["stats",{"2":{"1":2}}],["stage",{"2":{"1":1}}],["starting",{"2":{"49":1}}],["start",{"0":{"21":1},"1":{"22":1,"23":1,"24":1,"25":1,"26":1},"2":{"1":12,"4":4,"5":2,"7":2,"8":2,"9":3,"20":2,"35":2,"39":2,"47":4,"48":2,"49":15}}],["stack",{"2":{"1":33,"2":7,"5":2,"29":1,"30":2,"36":2,"38":4,"48":1}}],["stacks",{"2":{"1":8}}],["standardises",{"2":{"16":1}}],["standard",{"2":{"1":1,"31":1,"42":2}}],["strokewidth",{"2":{"50":1}}],["strokecolor",{"2":{"50":1}}],["strings",{"2":{"1":1,"2":1,"38":1}}],["string",{"2":{"1":23,"2":9,"4":2,"5":1,"7":1,"8":1,"9":2,"18":2,"35":1,"39":1,"42":2}}],["structures",{"2":{"1":1}}],["sp",{"2":{"48":1}}],["spratly",{"2":{"1":1}}],["spring",{"2":{"1":2}}],["spread",{"2":{"1":1}}],["spheroid",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["spherical",{"2":{"1":2,"49":6,"50":1}}],["sphere",{"2":{"1":2,"49":4}}],["speed",{"2":{"1":1}}],["speedups",{"2":{"1":5}}],["special",{"2":{"1":2}}],["species",{"0":{"18":1},"2":{"1":4,"17":1}}],["specify",{"2":{"1":3,"2":5,"9":2,"16":1,"25":1,"49":3}}],["specifying",{"2":{"1":4,"2":3,"49":1}}],["specific",{"2":{"2":7,"9":1,"28":1,"30":2}}],["specifically",{"2":{"1":1,"49":1}}],["specifies",{"2":{"1":2,"40":1}}],["specified",{"2":{"1":14,"6":1}}],["spline",{"2":{"1":1}}],["split",{"2":{"1":2}}],["splat",{"2":{"1":1}}],["splatted",{"2":{"1":2}}],["space",{"2":{"1":1,"26":1,"36":1}}],["spans",{"2":{"1":1,"25":1}}],["span=autospan",{"2":{"1":2}}],["span",{"2":{"1":2}}],["spatially",{"2":{"49":1}}],["spatial",{"2":{"1":6,"15":1,"22":2,"25":1,"44":1}}],["shrink",{"2":{"30":1}}],["shuffle",{"2":{"2":4}}],["shp",{"2":{"1":15,"46":2}}],["shapes",{"2":{"1":6,"47":6}}],["shapefile",{"0":{"46":1,"47":1},"1":{"47":1,"48":1},"2":{"1":31,"45":1,"46":5,"47":2}}],["shape=",{"2":{"1":1}}],["shape",{"2":{"1":9,"45":1,"48":1}}],["sharing",{"2":{"1":1}}],["shared",{"2":{"1":4}}],["share",{"2":{"1":2,"29":1}}],["shoudle",{"2":{"1":1}}],["should",{"2":{"1":15,"2":2,"38":3}}],["shortcuts",{"2":{"1":2}}],["show",{"2":{"1":10,"40":1,"49":1}}],["shown",{"2":{"1":1,"40":1}}],["sea",{"2":{"42":4}}],["search",{"2":{"1":1,"18":1}}],["second",{"2":{"28":1}}],["seconds",{"2":{"28":1}}],["se",{"2":{"20":3}}],["separated",{"2":{"1":1,"2":1}}],["separately",{"2":{"1":3}}],["separator",{"2":{"1":3}}],["seem",{"2":{"36":1}}],["seems",{"2":{"1":1,"50":1}}],["see",{"2":{"1":3,"15":1,"16":1,"25":1,"49":2,"50":2}}],["serranilla",{"2":{"1":1}}],["ser",{"2":{"1":2}}],["series",{"2":{"1":19,"2":2,"36":1}}],["sense",{"2":{"1":1}}],["selecting",{"2":{"24":1}}],["selects",{"2":{"1":6}}],["select",{"0":{"24":1,"25":1},"2":{"1":12}}],["selectors",{"2":{"1":1,"26":3}}],["selector",{"2":{"1":10,"26":1}}],["sets",{"2":{"2":1,"38":1}}],["setting",{"2":{"2":1}}],["set",{"0":{"9":1},"2":{"1":14,"2":10,"9":6,"36":1,"37":1,"38":8,"40":1,"50":1}}],["setmappedcrs",{"2":{"0":1,"1":2,"9":1}}],["setcrs",{"2":{"0":1,"1":2,"9":1}}],["rs",{"2":{"18":1,"20":1,"26":1}}],["right",{"2":{"2":2,"29":1,"38":2}}],["rings",{"2":{"1":1}}],["r",{"2":{"1":3,"2":2,"11":1,"19":4}}],["rms",{"2":{"1":1}}],["rotl90",{"2":{"3":1}}],["rotations",{"2":{"3":1}}],["rotated",{"2":{"1":1}}],["root",{"2":{"1":1}}],["roughly",{"2":{"1":3,"39":1}}],["rowgap",{"2":{"39":1}}],["rows",{"2":{"1":3,"18":1}}],["row",{"2":{"1":3}}],["rnge",{"2":{"1":3}}],["rain",{"2":{"50":1}}],["rainfall",{"2":{"50":2}}],["ras",{"2":{"22":1,"23":2,"49":3}}],["rasterisation",{"2":{"1":2}}],["rasterized",{"2":{"1":2}}],["rasterize",{"2":{"0":2,"1":10,"32":2}}],["rasterdatasources",{"0":{"16":1},"2":{"1":21,"4":1,"16":4,"17":1,"18":1,"26":1,"28":2,"35":1,"39":1,"40":1,"41":1,"45":1,"47":2,"50":2}}],["rasterdiskarray",{"2":{"0":1,"2":2}}],["raster",{"2":{"0":1,"1":109,"2":32,"4":6,"5":6,"7":3,"8":2,"9":4,"10":2,"12":1,"13":1,"14":1,"16":4,"20":1,"22":3,"24":6,"25":2,"26":1,"28":1,"29":2,"31":1,"34":1,"35":4,"38":11,"39":1,"40":4,"41":1,"42":5,"47":3,"48":3,"49":16,"50":5}}],["rasterstacks",{"2":{"1":2,"36":1,"40":1,"48":1}}],["rasterstack",{"2":{"0":1,"1":57,"2":7,"5":1,"10":1,"12":1,"13":1,"14":1,"16":2,"20":2,"36":1,"38":5,"39":3,"40":1,"42":1,"47":3,"48":1}}],["rasterseries",{"2":{"0":1,"1":22,"10":1,"16":2,"48":1}}],["rasters",{"0":{"35":1,"36":1},"2":{"0":56,"1":106,"2":22,"4":3,"5":1,"7":1,"8":1,"9":3,"10":1,"14":1,"16":2,"18":3,"22":5,"25":2,"26":2,"27":1,"28":5,"29":3,"30":1,"35":2,"36":8,"38":6,"39":2,"40":5,"41":1,"42":3,"44":1,"45":1,"47":2,"48":1,"49":6,"50":1}}],["ratio",{"2":{"2":2}}],["rather",{"2":{"1":1}}],["raw",{"2":{"1":4,"46":1}}],["range",{"2":{"1":13,"39":3,"48":1,"49":1}}],["random",{"2":{"22":1,"44":1}}],["rand",{"2":{"1":1,"22":1,"49":1}}],["radius=",{"2":{"49":1}}],["radius",{"2":{"1":4,"49":5}}],["race",{"2":{"1":5}}],["runs",{"2":{"29":1}}],["running",{"2":{"1":4,"29":1}}],["run",{"2":{"1":8,"49":1}}],["rplot",{"2":{"0":2,"2":2,"36":3,"38":6,"40":1}}],["red",{"2":{"50":3}}],["reduced",{"2":{"28":1}}],["reduces",{"2":{"1":1}}],["reduce",{"2":{"1":2,"29":1}}],["reducer",{"2":{"1":9}}],["reducing",{"2":{"1":5}}],["remain",{"2":{"38":2}}],["rectangle",{"2":{"49":1}}],["recipes",{"2":{"40":1,"44":1}}],["recipe",{"2":{"34":1}}],["record",{"2":{"38":1}}],["records",{"2":{"19":1}}],["recognized",{"2":{"20":1}}],["reverseordered",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["reverse",{"2":{"3":1}}],["reversing",{"2":{"1":1}}],["reef",{"2":{"1":1}}],["re",{"2":{"1":1,"40":1,"49":2,"50":1}}],["region",{"2":{"1":1,"48":3}}],["regions",{"2":{"1":12}}],["regular",{"2":{"1":6,"2":1,"3":1,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"22":3,"23":1,"24":7,"25":2,"26":1,"31":1,"35":2,"39":2,"42":5,"47":4,"48":2,"49":8}}],["relies",{"2":{"49":1}}],["reliable",{"2":{"1":19,"49":1}}],["related",{"2":{"14":1}}],["relhum",{"2":{"1":2}}],["relhum=",{"2":{"1":1}}],["reasons",{"2":{"49":1}}],["reason",{"2":{"36":1}}],["reassign",{"2":{"9":1}}],["really",{"2":{"29":1,"50":1}}],["real",{"2":{"1":18}}],["reading",{"2":{"33":1}}],["reads",{"2":{"26":1}}],["read",{"2":{"1":13,"2":9,"5":1,"12":1,"22":1,"33":4,"48":1}}],["rebuild",{"0":{"7":1},"2":{"1":1,"6":1,"7":3,"9":1}}],["res=3000",{"2":{"40":1}}],["res=0",{"2":{"1":1}}],["reset",{"0":{"37":1},"1":{"38":1,"39":1},"2":{"38":1}}],["responsible",{"2":{"1":1}}],["resampling",{"2":{"1":17}}],["resamples",{"2":{"1":1}}],["resampled",{"2":{"1":1}}],["resample",{"2":{"0":1,"1":15,"30":2}}],["result",{"2":{"1":6}}],["results",{"2":{"1":6}}],["resulting",{"2":{"1":6}}],["resolution",{"0":{"30":1},"2":{"1":19,"40":3}}],["res",{"2":{"1":21,"40":1}}],["rest",{"2":{"1":1}}],["refer",{"2":{"1":1}}],["reference",{"0":{"1":1,"2":1},"2":{"1":11}}],["refdims",{"2":{"1":5}}],["retrieved",{"2":{"2":2}}],["retrieve",{"2":{"1":3,"2":1}}],["returning",{"2":{"1":2}}],["returned",{"2":{"1":14}}],["returns",{"2":{"1":8,"2":5,"49":2}}],["return",{"2":{"1":7,"48":1}}],["required",{"2":{"1":24,"2":2,"31":1}}],["replicated",{"2":{"50":1}}],["replaced",{"2":{"1":1,"2":1}}],["replacement",{"2":{"1":6}}],["replace",{"0":{"8":1},"2":{"0":1,"1":17,"7":2,"31":3,"33":1,"50":1}}],["reports",{"2":{"29":1}}],["reporting",{"2":{"2":1}}],["reproduced",{"2":{"29":1}}],["reproduce",{"2":{"29":1}}],["reprojecting",{"2":{"1":1}}],["reproject",{"2":{"0":2,"1":5}}],["represents",{"2":{"49":2}}],["represent",{"2":{"1":1,"25":2}}],["representing",{"2":{"1":1}}],["reprsenting",{"2":{"1":1}}],["p2",{"2":{"50":1}}],["purely",{"2":{"49":1}}],["put",{"2":{"28":1,"29":1}}],["px",{"2":{"41":1}}],["phylum",{"2":{"18":1}}],["p",{"2":{"1":4,"20":3,"48":8,"50":1}}],["pygmy",{"2":{"1":1,"17":1}}],["perform",{"2":{"49":1}}],["performance",{"2":{"1":4}}],["per",{"2":{"41":1,"49":1,"50":8}}],["peru",{"2":{"1":1}}],["permission",{"2":{"1":1}}],["permissions",{"2":{"1":1}}],["plt",{"2":{"39":5}}],["platform",{"2":{"29":1}}],["plane",{"2":{"1":1,"49":2}}],["planar",{"2":{"1":2,"49":6}}],["places",{"2":{"29":1}}],["placed",{"2":{"2":1,"38":1}}],["place",{"2":{"1":6,"29":1}}],["please",{"2":{"1":19,"49":1}}],["plotted",{"2":{"36":1}}],["plotting",{"0":{"34":1,"38":1,"48":1},"2":{"2":2,"34":1,"38":2,"40":2,"42":1,"44":1}}],["plottype",{"2":{"2":1,"38":1}}],["plot`",{"2":{"1":1}}],["plots",{"0":{"40":1,"48":1},"2":{"1":20,"20":1,"28":1,"34":1,"36":2,"40":4,"42":3,"43":2,"45":1,"48":1}}],["plot",{"0":{"43":2,"45":1},"2":{"1":39,"2":3,"16":1,"20":2,"26":1,"34":1,"35":2,"38":3,"39":1,"40":7,"41":1,"42":8,"44":3,"45":1,"48":9,"49":1,"50":1}}],["pixelated",{"2":{"1":1}}],["pixel",{"2":{"1":18,"40":2,"47":1}}],["pixels",{"2":{"1":15}}],["png",{"2":{"1":24,"39":1}}],["principle",{"2":{"9":1}}],["print",{"2":{"1":4,"2":2}}],["primem",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["practically",{"2":{"29":1}}],["practice",{"2":{"1":2,"2":1,"38":1}}],["practise",{"2":{"1":1}}],["pretty",{"2":{"50":1}}],["predefined",{"2":{"33":1}}],["predictor",{"2":{"20":1}}],["predictors",{"2":{"20":5}}],["previously",{"2":{"28":1}}],["prefer",{"2":{"1":1}}],["precip",{"2":{"50":19}}],["precipitation",{"2":{"50":6}}],["prec",{"2":{"1":8,"47":5,"48":4,"50":1}}],["pressure",{"2":{"1":1}}],["pressure=",{"2":{"1":1}}],["present",{"2":{"1":2}}],["problem",{"2":{"29":2}}],["problems",{"2":{"1":23,"2":2,"49":1}}],["providing",{"2":{"15":1}}],["provide",{"2":{"36":1}}],["provides",{"2":{"14":1,"48":1}}],["provided",{"2":{"1":6,"40":1}}],["proj",{"2":{"1":1,"49":2}}],["projections",{"2":{"1":5,"25":1,"49":1}}],["projection",{"2":{"1":6,"25":2,"30":1,"49":1}}],["projected",{"2":{"0":1,"1":16,"2":1,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"25":1,"35":2,"39":2,"47":4,"48":2,"49":11}}],["prod",{"2":{"1":1}}],["produces",{"2":{"29":1}}],["produce",{"2":{"1":2,"42":1}}],["productive",{"2":{"1":5}}],["properties",{"0":{"6":1},"1":{"7":1,"8":1,"9":1},"2":{"1":3,"9":2,"25":1}}],["progress=false",{"2":{"1":4}}],["progress",{"2":{"1":22}}],["page",{"2":{"50":1}}],["pacific",{"2":{"50":1}}],["packages",{"0":{"28":1},"2":{"28":4}}],["package",{"0":{"22":1},"2":{"28":2,"49":1}}],["pane",{"2":{"42":1}}],["paste",{"2":{"29":1}}],["passive",{"2":{"14":1}}],["passing",{"2":{"1":3}}],["passes",{"2":{"1":1}}],["passed",{"2":{"1":25,"2":12,"26":2}}],["pass",{"2":{"1":3,"2":1,"34":1,"36":1}}],["pad=10",{"2":{"47":1}}],["padding",{"2":{"1":1,"2":2,"38":2}}],["padded",{"2":{"1":1}}],["pad",{"2":{"1":3,"47":1}}],["pair",{"2":{"1":2}}],["pairs",{"2":{"1":16}}],["part",{"2":{"29":1}}],["parvus",{"2":{"1":2,"18":1,"20":2}}],["parallel",{"2":{"1":5}}],["parse",{"2":{"1":1}}],["parsed",{"2":{"1":1}}],["path",{"2":{"1":7,"2":3}}],["paths",{"2":{"1":6}}],["polar",{"2":{"49":1}}],["poles",{"2":{"49":1}}],["poly",{"2":{"47":1,"48":2,"50":1}}],["polygons",{"2":{"1":15,"45":1}}],["polygon",{"0":{"32":1,"45":1},"2":{"1":37,"31":1,"47":1}}],["population",{"2":{"49":1}}],["poor",{"2":{"1":1}}],["potential",{"2":{"1":2,"2":2}}],["pointer",{"2":{"2":1}}],["point",{"0":{"32":1},"2":{"1":27,"19":1,"49":2}}],["points",{"2":{"0":1,"1":43,"9":4,"19":1,"20":1,"22":3,"23":1,"24":7,"25":2,"32":2,"49":2}}],["possibly",{"2":{"6":1}}],["possible",{"2":{"1":9,"4":1,"22":1,"28":1,"29":2}}],["possum",{"2":{"1":1,"17":1}}],["positive",{"2":{"1":2}}],["position",{"2":{"1":1,"2":2,"38":2}}],["mp4",{"2":{"38":2}}],["mmap",{"2":{"11":1}}],["my",{"2":{"1":2}}],["myraster",{"2":{"1":2,"49":2}}],["myseries",{"2":{"1":3}}],["month",{"2":{"18":1,"22":2,"24":1,"36":1,"38":1,"42":2,"50":3}}],["month=july",{"2":{"47":1}}],["month=june",{"2":{"16":1}}],["month=jan",{"2":{"1":1}}],["month=6",{"2":{"1":1}}],["month=1",{"2":{"1":11}}],["moisture",{"2":{"14":2}}],["move",{"2":{"2":1,"33":1}}],["mountain",{"2":{"1":1,"17":1}}],["more",{"2":{"1":5,"9":1,"25":2,"30":1,"42":1,"50":1}}],["modification",{"2":{"1":1}}],["modifying",{"0":{"6":1},"1":{"7":1,"8":1,"9":1}}],["modify",{"0":{"33":1},"2":{"1":1,"6":1,"9":1,"33":1}}],["model",{"2":{"1":1}}],["mode=",{"2":{"1":2}}],["mode",{"2":{"1":15,"5":1}}],["mos",{"2":{"1":2}}],["most",{"2":{"1":4,"3":1,"29":1,"31":1}}],["mosaic",{"0":{"45":1},"2":{"0":2,"1":15,"30":1,"45":1,"48":2}}],["misestimated",{"2":{"50":1}}],["missing=false",{"2":{"1":2}}],["missing",{"0":{"8":1},"2":{"0":1,"1":51,"2":7,"6":1,"7":1,"8":1,"14":2,"18":21,"20":80,"30":1,"31":2,"42":6,"47":1,"50":3}}],["missingval=",{"2":{"7":1,"8":1}}],["missingval=uint32",{"2":{"1":1}}],["missingval=missingval",{"2":{"1":2}}],["missingval=0",{"2":{"1":2}}],["missingval",{"2":{"0":1,"1":36,"2":7,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"31":1,"35":1,"39":1,"42":2,"47":2,"48":1}}],["missingmask",{"2":{"0":1,"1":6}}],["middle",{"2":{"50":1}}],["millisecond",{"2":{"42":1}}],["minutes",{"2":{"42":2}}],["min",{"2":{"1":3}}],["minimum",{"2":{"1":7,"29":1}}],["minor",{"2":{"1":2}}],["mix",{"2":{"1":1}}],["mixed",{"2":{"1":7}}],["must",{"2":{"1":17,"38":2}}],["multithreading",{"2":{"50":1}}],["multidimensional",{"2":{"30":1}}],["multi",{"2":{"1":5,"2":1,"14":1,"42":1,"48":1}}],["multiple",{"2":{"1":18,"2":3}}],["much",{"2":{"1":3}}],["mercator",{"2":{"49":1}}],["merge",{"2":{"1":1}}],["med",{"2":{"1":1}}],["median",{"2":{"1":6}}],["messages",{"2":{"1":2,"2":2}}],["meter",{"2":{"50":5}}],["meters",{"2":{"1":6,"49":2,"50":2}}],["method",{"2":{"1":22,"2":7,"48":1,"49":6,"50":1}}],["methods",{"0":{"30":1,"31":1,"33":1},"2":{"1":5,"2":1,"3":2,"30":1,"31":3,"32":1,"33":1,"42":2,"48":3}}],["metadata",{"2":{"1":7,"2":4,"4":4,"5":2,"7":2,"8":2,"9":4,"15":3,"35":2,"42":4}}],["meaning",{"2":{"49":1}}],["means",{"2":{"1":4,"2":7,"11":1,"28":1}}],["mean",{"0":{"4":1},"2":{"1":16,"2":3,"3":1,"4":1,"42":6,"43":1,"44":4,"49":2}}],["memory",{"2":{"1":18,"2":6,"33":2,"49":1}}],["mainly",{"2":{"50":1}}],["margin",{"2":{"47":1}}],["markercolor=",{"2":{"20":1}}],["markershape=",{"2":{"20":1}}],["many",{"2":{"28":1,"29":2}}],["manually",{"2":{"1":17,"2":3,"28":1,"33":1,"40":1}}],["madagascar",{"2":{"26":3}}],["made",{"2":{"1":2,"50":1}}],["map",{"2":{"5":2,"50":1}}],["mappedindex",{"2":{"0":1,"1":1}}],["mappedcrs=epsg",{"2":{"1":3}}],["mappedcrs=nothing",{"2":{"1":2}}],["mappedcrs",{"2":{"0":1,"1":20,"40":1,"42":2}}],["mappedbounds",{"2":{"0":1,"1":1}}],["mapped",{"2":{"0":1,"1":16,"25":3,"42":4}}],["making",{"2":{"26":1,"29":1}}],["makie",{"0":{"34":1,"35":1,"36":1,"39":1,"41":1},"2":{"2":13,"16":1,"26":1,"28":2,"34":1,"35":1,"36":2,"38":13,"39":1,"40":3,"41":1,"49":1,"50":1}}],["make",{"2":{"1":4,"9":1,"29":1,"45":1,"49":1,"50":1}}],["makes",{"2":{"1":1,"36":1}}],["macao",{"2":{"1":1}}],["malaysia",{"2":{"1":1}}],["max",{"2":{"1":1,"40":2}}],["maximum",{"2":{"1":7,"2":2,"40":1}}],["magnitude",{"2":{"1":2}}],["magma",{"2":{"1":2}}],["master",{"2":{"1":4,"46":1}}],["masking",{"0":{"45":1},"2":{"50":1}}],["masks",{"2":{"1":1}}],["masked",{"2":{"1":16,"32":1,"50":9}}],["mask",{"2":{"0":2,"1":36,"2":1,"31":2,"45":1,"47":5,"48":2,"50":5}}],["matters",{"2":{"1":2}}],["matter",{"2":{"1":2}}],["matching",{"2":{"1":3,"26":1,"40":1}}],["match",{"2":{"1":9}}],["matches",{"2":{"1":1}}],["matrix",{"2":{"1":2}}],["may",{"2":{"1":70,"2":5,"12":2,"15":1,"36":1,"38":1,"49":2}}],["cftime",{"2":{"42":2}}],["cmor",{"2":{"42":2}}],["cgrads",{"2":{"2":1,"38":1}}],["cyprus",{"2":{"1":1}}],["c",{"2":{"1":2,"2":2}}],["cp",{"2":{"1":1}}],["c=",{"2":{"1":3}}],["csv",{"2":{"1":1,"20":5}}],["cs",{"2":{"1":1,"49":1}}],["circumstances",{"2":{"1":5}}],["close",{"2":{"50":1}}],["closest",{"2":{"26":1}}],["closed",{"2":{"2":1}}],["click",{"2":{"30":1}}],["clipperton",{"2":{"1":1}}],["clims=",{"2":{"1":4}}],["climate",{"2":{"1":14,"16":1,"28":1,"36":1,"38":2,"47":7,"48":1,"50":1}}],["classes",{"2":{"1":5}}],["classified",{"2":{"1":3}}],["classify",{"2":{"0":2,"1":10,"31":2}}],["certain",{"2":{"26":1}}],["center",{"2":{"1":20,"42":6}}],["cell",{"2":{"1":6,"42":2,"49":8,"50":5}}],["cells",{"2":{"1":4,"49":1}}],["cellarea",{"0":{"49":1},"1":{"50":1},"2":{"0":1,"1":2,"49":7,"50":1}}],["cubicspline",{"2":{"1":1}}],["cubic",{"2":{"1":3}}],["custom",{"2":{"1":4,"14":1}}],["current",{"2":{"1":3,"2":2,"7":1,"39":1}}],["currently",{"2":{"1":6}}],["cultural",{"2":{"1":4,"46":1}}],["cut",{"2":{"1":5,"39":1}}],["cuda",{"2":{"1":1}}],["cuarray",{"2":{"1":1}}],["chordata",{"2":{"18":15}}],["chosen",{"2":{"1":3,"2":3,"49":2}}],["chunk",{"2":{"2":11}}],["chunks",{"2":{"2":6}}],["chunking",{"2":{"2":1}}],["changing",{"2":{"1":1}}],["changes",{"2":{"1":2}}],["change",{"0":{"30":1,"31":1},"2":{"1":22,"7":1,"9":2,"40":2,"49":1}}],["chile",{"2":{"1":1,"50":17}}],["child",{"2":{"1":11,"2":1}}],["china",{"2":{"1":8}}],["checks",{"2":{"2":1}}],["checksum",{"2":{"2":4}}],["check",{"2":{"2":1,"14":1}}],["checked",{"2":{"1":2}}],["checkmemory",{"2":{"2":1}}],["checkmem",{"2":{"0":1,"2":3}}],["creep",{"2":{"29":1}}],["creation",{"2":{"2":2}}],["creating",{"2":{"1":3}}],["creates",{"2":{"1":1}}],["create",{"2":{"1":6}}],["cross",{"2":{"20":1}}],["cropping",{"2":{"50":1}}],["cropped",{"2":{"50":1}}],["crop",{"2":{"0":1,"1":13,"30":1,"48":1,"50":3}}],["crs=epsg",{"2":{"1":4,"49":2}}],["crs=nothing",{"2":{"1":1}}],["crs",{"2":{"1":56,"4":2,"5":1,"7":1,"8":1,"9":5,"20":1,"35":1,"39":1,"40":1,"42":2,"47":2,"48":1,"49":8}}],["care",{"2":{"50":1}}],["cartier",{"2":{"1":1}}],["cartesianindex",{"2":{"1":1}}],["categories",{"2":{"31":1}}],["cairomakie",{"2":{"16":1,"26":2,"35":1,"39":1,"41":3,"49":1}}],["caveats",{"2":{"15":1}}],["caused",{"2":{"29":1}}],["cause",{"2":{"1":1}}],["caution",{"2":{"1":5}}],["calculate",{"2":{"1":4,"32":1}}],["calculated",{"2":{"1":8}}],["call",{"2":{"49":1}}],["calling",{"2":{"1":3}}],["called",{"2":{"1":1,"2":2,"49":1}}],["cased",{"2":{"1":2}}],["case",{"2":{"1":8}}],["cases",{"2":{"1":20,"49":1}}],["cannot",{"2":{"1":1,"2":3}}],["can",{"2":{"1":69,"2":30,"3":1,"6":2,"9":3,"11":1,"12":2,"13":3,"14":2,"15":2,"16":1,"20":1,"22":1,"25":1,"28":1,"29":5,"34":1,"36":2,"38":5,"40":2,"48":2,"49":9,"50":8}}],["code",{"2":{"28":1,"29":1}}],["coords",{"2":{"20":2}}],["coordinatetransformations",{"2":{"28":1}}],["coordinate",{"2":{"1":10,"28":1,"49":3,"50":1}}],["coordinates",{"0":{"19":1},"2":{"1":11,"22":1,"26":1,"42":1,"49":2}}],["course",{"2":{"49":1}}],["could",{"2":{"1":1,"42":1,"44":1}}],["counts",{"2":{"19":1}}],["country",{"2":{"1":7,"45":1,"50":1}}],["countries",{"2":{"1":8,"45":1,"46":1,"48":2,"50":4}}],["count",{"2":{"1":4}}],["counted",{"2":{"1":2}}],["counter",{"2":{"1":5}}],["correlation",{"2":{"1":1,"39":3}}],["corresponding",{"2":{"1":1}}],["correctly",{"2":{"42":1}}],["correct",{"2":{"1":1}}],["covering",{"2":{"30":1}}],["cover",{"2":{"1":2}}],["covered",{"2":{"1":10}}],["coverage",{"2":{"0":2,"1":15}}],["colgap",{"2":{"39":1}}],["color",{"2":{"2":2,"38":2,"50":1}}],["colorrange",{"2":{"2":1,"38":1,"50":1}}],["colormaps",{"2":{"2":1,"38":1}}],["colormap",{"2":{"2":3,"38":3,"39":2}}],["colorbar=",{"2":{"38":1}}],["colorbarlabel",{"2":{"2":1,"38":1}}],["colorbar",{"2":{"2":8,"38":8,"39":5}}],["color=",{"2":{"1":2}}],["collect",{"2":{"1":1,"20":1,"50":1}}],["collection",{"2":{"1":1}}],["collections",{"2":{"1":3}}],["collapse",{"2":{"1":3}}],["columns",{"2":{"1":19,"18":1}}],["column",{"2":{"1":21}}],["copying",{"2":{"1":1}}],["copy",{"2":{"1":2,"2":1}}],["command",{"2":{"44":1}}],["comments",{"2":{"2":2}}],["common",{"2":{"1":4,"12":1,"16":1,"48":1}}],["commonly",{"2":{"1":1,"31":1}}],["com",{"2":{"1":4,"46":1}}],["computing",{"2":{"50":2}}],["computes",{"2":{"1":1,"49":2}}],["compute",{"2":{"1":3,"49":3,"50":5}}],["compress",{"2":{"2":2}}],["compressed",{"2":{"2":2,"11":1}}],["compression",{"2":{"2":8}}],["compatable",{"2":{"1":1}}],["compatible",{"2":{"1":22}}],["comparison",{"2":{"1":6}}],["complicated",{"2":{"1":5,"29":1}}],["completely",{"2":{"1":7,"2":1,"15":1}}],["complete",{"2":{"1":1,"29":1}}],["combining",{"2":{"1":3}}],["combination",{"2":{"1":4}}],["combined",{"2":{"1":7}}],["combine",{"2":{"0":1,"1":9,"48":1}}],["congratulations",{"2":{"50":1}}],["conversion",{"2":{"15":2}}],["converting",{"2":{"1":1}}],["converted",{"2":{"1":7,"12":1,"40":1}}],["convert",{"2":{"1":4,"20":1,"50":1}}],["convertlookup",{"2":{"0":1,"1":1}}],["construct",{"2":{"49":3}}],["constructor",{"2":{"1":3}}],["const",{"2":{"18":1,"26":1}}],["considering",{"2":{"1":1}}],["concatenate",{"2":{"1":2}}],["concrete",{"2":{"1":2}}],["conditions",{"2":{"1":5}}],["contourf",{"2":{"2":1,"34":1,"35":1,"38":1,"40":2,"43":1}}],["contour",{"0":{"43":1},"2":{"2":1,"34":1,"35":1,"38":1,"40":2,"42":1}}],["contributing",{"2":{"1":8}}],["contribute",{"2":{"1":4}}],["contrast",{"2":{"1":3,"39":3,"49":1}}],["continents",{"2":{"1":2}}],["contained",{"2":{"2":1}}],["contains",{"2":{"1":7,"25":1,"26":1}}],["contain",{"2":{"1":4}}],["containing",{"2":{"1":13,"2":2}}],["contents",{"2":{"1":2}}],["break",{"2":{"36":1}}],["breaks",{"2":{"29":1}}],["broadcast",{"2":{"2":1,"4":2,"5":2}}],["broadcasting",{"0":{"5":1},"2":{"1":1}}],["black",{"2":{"20":1}}],["block",{"2":{"2":2}}],["blocks",{"2":{"1":2}}],["blocking",{"2":{"1":4}}],["b",{"2":{"1":13,"7":1,"24":2,"26":2}}],["bilinear",{"2":{"1":2}}],["biodiversity",{"2":{"17":1}}],["bio",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["bio7",{"2":{"1":6,"20":21}}],["bio5",{"2":{"1":6,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["bio3",{"2":{"1":6,"20":21}}],["bio12",{"2":{"1":6,"20":21}}],["bio1",{"2":{"1":6,"20":21}}],["bioclim",{"2":{"1":2,"4":3,"5":1,"7":2,"8":1,"9":2,"17":1,"20":3,"26":1,"35":2,"40":1,"41":1}}],["bitarray",{"2":{"1":5}}],["bug",{"2":{"29":5}}],["bugs",{"0":{"29":1},"2":{"29":2}}],["built",{"2":{"1":2,"28":1,"50":1}}],["build",{"2":{"1":24,"14":1}}],["burramys",{"2":{"1":1,"18":1,"20":2}}],["burramis",{"2":{"1":1}}],["but",{"2":{"1":13,"2":3,"6":1,"11":1,"13":1,"25":1,"28":1,"29":3,"38":2,"49":1,"50":2}}],["by",{"0":{"22":1,"24":1,"25":1},"2":{"1":75,"2":15,"9":1,"24":1,"26":1,"30":1,"31":1,"32":1,"36":1,"40":1,"49":7,"50":4}}],["box",{"2":{"29":1,"38":1,"50":1}}],["bottom",{"2":{"2":1,"29":1,"38":1,"50":1}}],["both",{"2":{"1":2}}],["bolivia",{"2":{"1":1}}],["border",{"2":{"1":8,"45":1,"47":7,"48":9}}],["borders",{"2":{"1":8,"48":11}}],["bounding",{"2":{"50":1}}],["bounded",{"2":{"50":1}}],["boundaries",{"2":{"1":1}}],["boundary=",{"2":{"1":2}}],["boundary",{"2":{"1":8,"45":1,"46":1}}],["bounds",{"2":{"1":9}}],["bool",{"2":{"1":5,"2":1}}],["boolmask",{"2":{"0":1,"1":6}}],["bad",{"2":{"50":2}}],["batlow",{"2":{"39":1}}],["basic",{"2":{"2":1}}],["based",{"2":{"1":2,"2":2,"5":1,"48":1}}],["base",{"2":{"1":2,"2":11,"3":2}}],["bajo",{"2":{"1":1}}],["bank",{"2":{"1":2}}],["bang",{"2":{"1":4}}],["bands",{"2":{"1":1,"25":1}}],["band",{"0":{"20":1},"2":{"0":1,"1":10,"2":1,"11":1,"13":1,"20":1,"25":1,"38":1}}],["backgroundcolor=",{"2":{"39":2}}],["back",{"2":{"1":2,"42":1,"49":1}}],["backends",{"2":{"10":1}}],["backend",{"2":{"1":1,"2":10,"10":1,"28":2}}],["backed",{"2":{"1":8}}],["bar",{"2":{"1":9}}],["becomes",{"2":{"9":1}}],["because",{"2":{"1":5,"22":1,"29":2,"50":1}}],["best",{"2":{"2":1,"13":1,"38":1}}],["besides",{"2":{"1":2}}],["being",{"2":{"2":3,"48":1,"49":1}}],["beyond",{"2":{"1":1}}],["bets",{"2":{"2":1,"38":1}}],["better",{"2":{"1":1}}],["between",{"2":{"1":9,"2":1,"26":3,"38":1,"49":1}}],["before",{"2":{"1":14,"2":1}}],["behaviours",{"2":{"1":2}}],["been",{"2":{"1":2,"15":1}}],["below",{"2":{"1":1,"36":1}}],["be",{"2":{"1":191,"2":50,"4":1,"5":1,"6":1,"9":2,"11":1,"12":1,"13":2,"14":2,"15":3,"16":1,"22":1,"25":1,"29":2,"38":7,"40":2,"49":6,"50":1}}],["api",{"2":{"40":1}}],["appropriately",{"2":{"36":1}}],["approximately",{"2":{"1":2}}],["approximates",{"2":{"1":1,"49":1}}],["approximate",{"2":{"1":1,"49":1}}],["appreciated",{"2":{"29":1}}],["appears",{"2":{"1":1}}],["appended",{"2":{"2":3}}],["append",{"2":{"1":8,"2":3}}],["apparent",{"2":{"1":1}}],["applications",{"2":{"31":1}}],["applicable",{"2":{"2":1,"48":1}}],["applies",{"2":{"5":1}}],["applied",{"2":{"1":13,"2":1,"4":1,"5":1}}],["apply",{"2":{"1":2}}],["amounts",{"2":{"30":1}}],["amount",{"2":{"2":1,"38":1}}],["americas",{"2":{"42":1}}],["america",{"2":{"1":1}}],["avg",{"2":{"50":1}}],["averages",{"2":{"50":1}}],["average",{"2":{"1":3,"50":4}}],["available",{"2":{"1":3,"4":1,"25":1,"26":1,"49":1}}],["affected",{"2":{"9":1}}],["africa",{"2":{"1":8}}],["after",{"2":{"1":13,"2":1}}],["authentication",{"2":{"29":1}}],["authority",{"2":{"4":10,"5":5,"7":5,"8":5,"9":10,"20":5,"35":5,"39":5,"47":10,"48":5}}],["automatic",{"2":{"2":9,"38":9}}],["automatically",{"2":{"1":8,"2":4,"10":1}}],["ausbounds",{"2":{"1":2,"39":2}}],["aus",{"2":{"1":9,"20":3,"39":3}}],["australian",{"2":{"1":1}}],["australia",{"2":{"1":3,"20":1,"39":2}}],["awap",{"2":{"1":13}}],["admin",{"2":{"1":5,"46":1,"50":1}}],["adding",{"2":{"4":1}}],["additional",{"2":{"1":3,"25":1,"28":2,"31":1}}],["additionally",{"2":{"1":5}}],["addition",{"2":{"1":2}}],["add",{"2":{"1":1,"22":1,"27":1,"29":1,"48":1}}],["added",{"2":{"1":2,"48":1}}],["again",{"2":{"1":1,"2":1,"48":1}}],["ag",{"2":{"1":2}}],["aggregation",{"2":{"1":8}}],["aggregated",{"2":{"1":8}}],["aggregate",{"2":{"0":2,"1":12,"30":2}}],["axs",{"2":{"39":5}}],["ax",{"2":{"35":3}}],["axis3",{"2":{"2":1,"38":1}}],["axistype",{"2":{"2":1,"38":1}}],["axis",{"2":{"1":7,"2":8,"4":4,"5":2,"7":2,"8":2,"9":5,"20":2,"26":1,"30":1,"35":3,"36":1,"38":8,"39":3,"40":1,"47":4,"48":2,"49":1,"50":2}}],["axes",{"2":{"1":5,"40":2,"42":1}}],["across",{"2":{"30":1,"50":4}}],["activate",{"2":{"26":1,"41":1,"49":1}}],["activated",{"2":{"2":2}}],["active",{"2":{"14":1}}],["actually",{"2":{"2":2,"7":1,"29":1,"49":1}}],["actual",{"2":{"1":2}}],["according",{"2":{"50":1}}],["account",{"2":{"49":1,"50":2}}],["accurate",{"2":{"1":1}}],["accept",{"2":{"40":1}}],["accepts",{"2":{"1":2,"2":2,"38":1}}],["accepted",{"2":{"1":2,"35":1}}],["accessible",{"2":{"29":1}}],["access",{"2":{"1":3,"13":1}}],["atol",{"2":{"1":9}}],["attributes",{"2":{"36":1,"39":1}}],["attempt",{"2":{"1":2}}],["attempting",{"2":{"1":1}}],["attached",{"2":{"1":7}}],["at",{"2":{"1":8,"2":5,"26":2,"29":1,"36":1,"42":2,"44":1,"49":3,"50":1}}],["algebra",{"2":{"3":1}}],["algorithm",{"2":{"1":3}}],["altered",{"2":{"2":1,"42":2}}],["although",{"2":{"1":1}}],["aligned",{"2":{"1":1}}],["already",{"2":{"1":1,"2":6}}],["along",{"2":{"1":7,"31":1}}],["alphabetically",{"2":{"1":1}}],["also",{"2":{"1":24,"2":3,"3":1,"4":1,"9":2,"12":1,"13":1,"24":1,"29":1,"48":1,"49":1,"50":1}}],["allow",{"2":{"1":1,"40":1}}],["allows",{"2":{"1":1}}],["allocating",{"2":{"1":1}}],["alllayers",{"2":{"1":3}}],["alllayers=true",{"2":{"1":1}}],["all",{"2":{"1":75,"2":4,"12":1,"13":1,"15":1,"20":1,"26":2,"29":1,"31":1,"48":2,"49":2,"50":3}}],["always",{"2":{"1":4,"2":1,"11":1,"14":1,"26":1,"28":1,"29":2}}],["around",{"2":{"42":1}}],["arbitrary",{"2":{"12":1,"25":1}}],["architectures",{"2":{"2":1}}],["archive",{"2":{"2":2}}],["archgdal",{"2":{"1":22,"2":2,"13":1,"28":2,"35":1,"40":1,"41":1,"45":1,"49":3}}],["args",{"2":{"40":1}}],["argentina",{"2":{"1":4}}],["argument",{"2":{"1":4,"2":2,"3":1,"49":2,"50":1}}],["arguments",{"2":{"1":26,"2":2}}],["area",{"2":{"1":14,"49":10,"50":8}}],["areas",{"2":{"1":17,"30":1,"49":2,"50":8}}],["are",{"2":{"1":90,"2":8,"9":1,"11":3,"12":3,"13":1,"14":1,"20":1,"25":1,"26":3,"29":6,"31":1,"36":3,"38":3,"40":1,"42":1,"44":1,"48":1,"49":2}}],["arrays",{"2":{"1":18,"2":2,"3":1,"6":1,"25":2,"30":1,"48":1}}],["array",{"0":{"3":1,"23":1},"1":{"4":1,"5":1,"6":1,"7":1,"8":1,"9":1},"2":{"1":49,"2":1,"4":1,"5":2,"18":1,"26":2,"30":1,"31":1,"40":1}}],["aspect",{"2":{"35":1,"36":1,"49":1,"50":1}}],["asc",{"2":{"13":1}}],["ashmore",{"2":{"1":1}}],["associated",{"2":{"25":1}}],["assuming",{"2":{"1":1,"49":2}}],["assign",{"2":{"1":2}}],["assigned",{"2":{"1":6}}],["assigns",{"2":{"1":1}}],["as",{"2":{"1":64,"2":10,"3":2,"7":1,"12":2,"13":3,"14":2,"15":1,"16":1,"19":1,"20":1,"26":1,"31":2,"36":2,"42":1,"44":1,"49":2,"50":1}}],["a",{"0":{"43":1},"2":{"1":426,"2":100,"3":1,"4":4,"5":4,"6":2,"7":2,"8":1,"9":5,"10":1,"14":1,"15":1,"16":4,"19":3,"20":3,"24":2,"26":7,"28":2,"29":5,"30":3,"31":2,"33":1,"34":2,"35":7,"36":4,"38":11,"40":6,"41":2,"42":5,"44":3,"45":1,"47":1,"48":6,"49":15,"50":6}}],["absolute",{"2":{"1":2}}],["abstracrasterseries",{"2":{"1":2}}],["abstrackrasterstack",{"2":{"1":1}}],["abstractdiskarray",{"2":{"2":3}}],["abstractdimensionalarray",{"2":{"1":1}}],["abstractdimarray",{"2":{"1":4}}],["abstractvector",{"2":{"1":3}}],["abstractgeometry",{"2":{"1":15}}],["abstractstack",{"2":{"1":2}}],["abstractstring",{"2":{"1":3,"2":6}}],["abstractsampled",{"2":{"1":2,"2":1}}],["abstractarray",{"2":{"1":5,"2":1}}],["abstract",{"2":{"1":3,"2":1}}],["abstractrasters",{"2":{"1":5}}],["abstractrasterstack",{"2":{"0":1,"1":12,"2":5}}],["abstractrasterseries",{"2":{"0":1,"1":8,"2":5}}],["abstractraster",{"2":{"0":1,"1":27,"2":9}}],["abstractprojected",{"2":{"0":1,"1":4,"2":1}}],["about",{"2":{"1":4,"2":2,"49":1,"50":2}}],["animations",{"0":{"38":1}}],["animalia",{"2":{"18":15}}],["answer",{"2":{"1":2}}],["anything",{"2":{"9":1}}],["any",{"2":{"1":19,"2":6,"4":3,"5":1,"7":1,"8":1,"9":3,"29":1,"30":1,"34":1,"35":1,"36":2,"38":1,"40":1,"42":2,"50":2}}],["another",{"2":{"1":9,"25":1,"30":3}}],["and",{"0":{"29":1,"32":1,"33":1,"45":1},"2":{"1":133,"2":18,"3":2,"4":1,"9":1,"10":1,"11":2,"12":1,"13":1,"14":2,"16":5,"17":1,"18":1,"20":2,"22":2,"24":1,"25":7,"26":3,"28":5,"29":7,"30":3,"31":1,"32":1,"36":3,"38":2,"40":3,"42":5,"47":1,"48":9,"49":9,"50":10}}],["an",{"0":{"26":1,"30":1,"31":1},"2":{"1":69,"2":9,"4":1,"6":2,"9":2,"17":1,"26":3,"29":2,"31":2,"32":1,"36":1,"38":1,"40":1,"48":1,"49":1,"50":1}}]],"serializationVersion":2}';export{e as default}; diff --git a/previews/PR800/assets/chunks/@localSearchIndexroot.BOXIqzN5.js b/previews/PR800/assets/chunks/@localSearchIndexroot.BOXIqzN5.js deleted file mode 100644 index 90e4cfce..00000000 --- a/previews/PR800/assets/chunks/@localSearchIndexroot.BOXIqzN5.js +++ /dev/null @@ -1 +0,0 @@ -const e='{"documentCount":51,"nextId":51,"documentIds":{"0":"/Rasters.jl/previews/PR800/api#index","1":"/Rasters.jl/previews/PR800/api#Reference-Exported-functions","2":"/Rasters.jl/previews/PR800/api#Reference-Internal-functions","3":"/Rasters.jl/previews/PR800/array_operations#Array-operations","4":"/Rasters.jl/previews/PR800/array_operations#Mean-over-the-time-dimension:","5":"/Rasters.jl/previews/PR800/array_operations#broadcasting","6":"/Rasters.jl/previews/PR800/array_operations#Modifying-object-properties","7":"/Rasters.jl/previews/PR800/array_operations#rebuild","8":"/Rasters.jl/previews/PR800/array_operations#replace-missing","9":"/Rasters.jl/previews/PR800/array_operations#set","10":"/Rasters.jl/previews/PR800/data_sources#Data-sources","11":"/Rasters.jl/previews/PR800/data_sources#grd","12":"/Rasters.jl/previews/PR800/data_sources#netcdf","13":"/Rasters.jl/previews/PR800/data_sources#gdal","14":"/Rasters.jl/previews/PR800/data_sources#smap","15":"/Rasters.jl/previews/PR800/data_sources#Writing-file-formats-to-disk","16":"/Rasters.jl/previews/PR800/data_sources#RasterDataSources.jl-integration","17":"/Rasters.jl/previews/PR800/gbif_wflow#GBIF-workflow","18":"/Rasters.jl/previews/PR800/gbif_wflow#Load-GBIF-species-data","19":"/Rasters.jl/previews/PR800/gbif_wflow#Extract-coordinates","20":"/Rasters.jl/previews/PR800/gbif_wflow#Get-layer-/-Band","21":"/Rasters.jl/previews/PR800/get_started#Quick-start","22":"/Rasters.jl/previews/PR800/get_started#Install-the-package-by-typing:","23":"/Rasters.jl/previews/PR800/get_started#Getting-the-lookup-array-from-dimensions","24":"/Rasters.jl/previews/PR800/get_started#Select-by-index","25":"/Rasters.jl/previews/PR800/get_started#Select-by-value","26":"/Rasters.jl/previews/PR800/get_started#Subsetting-an-object","27":"/Rasters.jl/previews/PR800/#installation","28":"/Rasters.jl/previews/PR800/#Packages-extensions","29":"/Rasters.jl/previews/PR800/#Bugs-and-errors","30":"/Rasters.jl/previews/PR800/methods#Methods-that-change-the-resolution-or-extent-of-an-object","31":"/Rasters.jl/previews/PR800/methods#Methods-that-change-an-objects-values","32":"/Rasters.jl/previews/PR800/methods#Point,-polygon-and-table-operation","33":"/Rasters.jl/previews/PR800/methods#Methods-to-load,-write-and-modify-data-sources","34":"/Rasters.jl/previews/PR800/plot_makie#Plotting-in-Makie","35":"/Rasters.jl/previews/PR800/plot_makie#2-D-rasters-in-Makie","36":"/Rasters.jl/previews/PR800/plot_makie#3-D-rasters-in-Makie","37":"/Rasters.jl/previews/PR800/plot_makie#reset-theme","38":"/Rasters.jl/previews/PR800/plot_makie#Plotting-with-Observables,-animations","39":"/Rasters.jl/previews/PR800/plot_makie#Using-vanilla-Makie","40":"/Rasters.jl/previews/PR800/plotting#Plots,-simple","41":"/Rasters.jl/previews/PR800/plotting#Makie,-simple","42":"/Rasters.jl/previews/PR800/plotting#Loading-data","43":"/Rasters.jl/previews/PR800/plotting#Plot-a-contour-plot","44":"/Rasters.jl/previews/PR800/plotting#write-to-disk","45":"/Rasters.jl/previews/PR800/plotting#Polygon-masking,-mosaic-and-plot","46":"/Rasters.jl/previews/PR800/plotting#Download-the-shapefile","47":"/Rasters.jl/previews/PR800/plotting#Load-using-Shapefile.jl","48":"/Rasters.jl/previews/PR800/plotting#Plotting-with-Plots.jl","49":"/Rasters.jl/previews/PR800/tutorials/methods/cellarea#cellarea-tutorial","50":"/Rasters.jl/previews/PR800/tutorials/methods/cellarea#Usage-example"},"fieldIds":{"title":0,"titles":1,"text":2},"fieldLength":{"0":[1,1,48],"1":[3,1,1514],"2":[3,1,499],"3":[2,1,32],"4":[6,2,169],"5":[1,2,157],"6":[3,2,33],"7":[1,5,139],"8":[2,5,114],"9":[1,5,184],"10":[2,1,24],"11":[1,2,30],"12":[1,2,69],"13":[1,2,37],"14":[1,2,67],"15":[5,2,53],"16":[3,2,60],"17":[2,1,33],"18":[4,2,92],"19":[2,2,73],"20":[3,2,236],"21":[2,1,1],"22":[6,2,135],"23":[6,2,21],"24":[3,2,107],"25":[3,2,158],"26":[3,2,118],"27":[1,1,4],"28":[2,1,100],"29":[3,1,163],"30":[10,1,70],"31":[6,1,47],"32":[5,1,19],"33":[8,1,34],"34":[3,1,37],"35":[5,1,137],"36":[5,1,84],"37":[2,1,4],"38":[4,2,174],"39":[3,2,165],"40":[2,1,125],"41":[2,1,20],"42":[2,1,235],"43":[4,2,10],"44":[3,2,59],"45":[5,1,38],"46":[3,1,28],"47":[4,3,144],"48":[4,3,208],"49":[2,1,327],"50":[2,2,231]},"averageFieldLength":[3.156862745098039,1.7450980392156865,130.70588235294116],"storedFields":{"0":{"title":"Index","titles":[]},"1":{"title":"Reference - Exported functions","titles":[]},"2":{"title":"Reference - Internal functions","titles":[]},"3":{"title":"Array operations","titles":[]},"4":{"title":"Mean over the time dimension:","titles":["Array operations"]},"5":{"title":"Broadcasting","titles":["Array operations"]},"6":{"title":"Modifying object properties","titles":["Array operations"]},"7":{"title":"rebuild","titles":["Array operations","Modifying object properties"]},"8":{"title":"replace_missing","titles":["Array operations","Modifying object properties"]},"9":{"title":"set","titles":["Array operations","Modifying object properties"]},"10":{"title":"Data sources","titles":[]},"11":{"title":"GRD","titles":["Data sources"]},"12":{"title":"NetCDF","titles":["Data sources"]},"13":{"title":"GDAL","titles":["Data sources"]},"14":{"title":"SMAP","titles":["Data sources"]},"15":{"title":"Writing file formats to disk","titles":["Data sources"]},"16":{"title":"RasterDataSources.jl integration","titles":["Data sources"]},"17":{"title":"GBIF workflow","titles":[]},"18":{"title":"Load GBIF species data","titles":["GBIF workflow"]},"19":{"title":"Extract coordinates","titles":["GBIF workflow"]},"20":{"title":"Get layer / Band","titles":["GBIF workflow"]},"21":{"title":"Quick start","titles":[]},"22":{"title":"Install the package by typing:","titles":["Quick start"]},"23":{"title":"Getting the lookup array from dimensions","titles":["Quick start"]},"24":{"title":"Select by index","titles":["Quick start"]},"25":{"title":"Select by value","titles":["Quick start"]},"26":{"title":"Subsetting an object","titles":["Quick start"]},"27":{"title":"Installation","titles":[]},"28":{"title":"Packages extensions","titles":[]},"29":{"title":"Bugs and errors","titles":[]},"30":{"title":"Methods that change the resolution or extent of an object","titles":[]},"31":{"title":"Methods that change an objects values","titles":[]},"32":{"title":"Point, polygon and table operation","titles":[]},"33":{"title":"Methods to load, write and modify data sources","titles":[]},"34":{"title":"Plotting in Makie","titles":[]},"35":{"title":"2-D rasters in Makie","titles":[]},"36":{"title":"3-D rasters in Makie","titles":[]},"37":{"title":"reset theme","titles":[]},"38":{"title":"Plotting with Observables, animations","titles":["reset theme"]},"39":{"title":"Using vanilla Makie","titles":["reset theme"]},"40":{"title":"Plots, simple","titles":[]},"41":{"title":"Makie, simple","titles":[]},"42":{"title":"Loading data","titles":[]},"43":{"title":"Plot a contour plot","titles":["Loading data"]},"44":{"title":"write to disk","titles":["Loading data"]},"45":{"title":"Polygon masking, mosaic and plot","titles":[]},"46":{"title":"Download the shapefile","titles":[]},"47":{"title":"Load using Shapefile.jl","titles":["Download the shapefile"]},"48":{"title":"Plotting with Plots.jl","titles":["Download the shapefile"]},"49":{"title":"cellarea tutorial","titles":[]},"50":{"title":"Usage example","titles":["cellarea tutorial"]}},"dirtCount":0,"index":[["↗",{"2":{"22":1,"24":1,"42":2}}],["├─────────────────────┴──────────────────────────────────────────────────",{"2":{"39":1,"48":1}}],["├───────────────────────┴────────────────────────────────────────",{"2":{"49":2}}],["├───────────────────────┴────────────────────────────────────────────────",{"2":{"47":1}}],["├───────────────────────┴───────────────────────────────────────────────────",{"2":{"1":1,"49":1}}],["├───────────────────────┴─────────────────────────────",{"2":{"24":2,"25":1}}],["├──────────────────────────┴─────────────────────────────────────────────",{"2":{"22":1,"24":1}}],["├──────────────────────────┼─────────┼─────────┼─────────┼──────────┼───────────",{"2":{"18":1}}],["├───────────────────────────────┴────────────────────────────────────────",{"2":{"4":1}}],["├─────────────────────────────────────────────────┴──────────────────────",{"2":{"42":1}}],["├──────────────────────────────────────────────────┴─────────────────────",{"2":{"42":1}}],["├──────────────────────────────────────────────────────────────",{"2":{"49":2}}],["├──────────────────────────────────────────────────────────────────────",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":2,"22":1,"24":1,"35":1,"39":2,"42":2,"47":4,"48":2}}],["├─────────────────────────────────────────────────────────────────────────",{"2":{"1":1,"49":1}}],["├────────────────────────────────────────────────────────────────────",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":2}}],["├───────────────────────────────────────────────────",{"2":{"24":2,"25":1}}],["├──────────────────────────────────┴─────────────────────────────────────",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1}}],["├────────────────────┴───────────────────────────────────────────────────",{"2":{"20":1,"47":1}}],["╭─────────────────────╮",{"2":{"39":1,"48":1}}],["╭──────────────────────────╮",{"2":{"22":1,"24":1}}],["╭─────────────────────────────────────────────────╮",{"2":{"42":1}}],["╭──────────────────────────────────────────────────╮",{"2":{"42":1}}],["╭──────────────────────────────────╮",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1}}],["╭───────────────────────────────╮",{"2":{"4":1}}],["╭───────────────────────╮",{"2":{"1":1,"24":2,"25":1,"47":1,"49":3}}],["╭────────────────────╮",{"2":{"20":1,"47":1}}],["└──────────────────────────────────────────────────────────────────────┘",{"2":{"49":2}}],["└──────────────────────────────────────────────────────────────────────────────┘",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"22":1,"24":1,"35":1,"39":1,"42":2,"47":2,"48":1}}],["└─────────────────────────────────────────────────────────────────────────────────┘",{"2":{"1":1,"49":1}}],["└───────────────────────────────────────────────────────────┘",{"2":{"24":2,"25":1}}],["└──────────────────────────┴─────────┴─────────┴─────────┴──────────┴───────────",{"2":{"18":1}}],["┌──────────────────────────┬─────────┬─────────┬─────────┬──────────┬───────────",{"2":{"18":1}}],["⋱",{"2":{"1":1,"4":1,"5":1,"7":1,"8":1,"9":2,"18":1,"35":1,"42":2}}],["⋮",{"2":{"1":6,"4":2,"5":2,"7":2,"8":2,"9":4,"18":6,"19":1,"20":1,"35":2,"42":2}}],["─────┼──────────────────────────────────────────────────────────────────────────",{"2":{"1":1}}],["⋯",{"2":{"1":6,"18":17}}],["^a",{"2":{"1":1}}],["quickly",{"2":{"29":1,"40":1}}],["quick",{"0":{"21":1},"1":{"22":1,"23":1,"24":1,"25":1,"26":1}}],["quot",{"2":{"2":18,"12":4,"13":4,"14":4,"15":2,"38":2,"49":4}}],["quadrant",{"2":{"50":1}}],["quadratic",{"2":{"1":1}}],["quartile",{"2":{"1":4}}],["quality",{"2":{"1":1,"40":1}}],["q3",{"2":{"1":1}}],["q1",{"2":{"1":1}}],["+",{"2":{"1":2}}],["`stack`",{"2":{"38":1}}],["`raster`",{"2":{"2":1}}],["`gi",{"2":{"1":1}}],["`missingval",{"2":{"1":1}}],["`missing`",{"2":{"1":1}}],["`vector`",{"2":{"1":1}}],["`collect`",{"2":{"1":1}}],["`extract`",{"2":{"1":1}}],["zscale",{"2":{"50":1}}],["z",{"2":{"1":1,"2":1,"9":4,"12":1,"25":1,"38":1,"42":1,"44":1}}],["za",{"2":{"1":1}}],["zone",{"2":{"1":1}}],["zonal",{"2":{"0":1,"1":5,"32":2,"50":3}}],["zeros",{"2":{"1":1}}],["zealand",{"2":{"1":1}}],["55",{"2":{"48":1,"49":2}}],["5504",{"2":{"1":1}}],["53",{"2":{"47":3}}],["597527f0",{"2":{"20":6}}],["54",{"2":{"47":1}}],["54166666666667",{"2":{"39":2}}],["54166666666666",{"2":{"39":1}}],["542496f0",{"2":{"20":1}}],["542",{"2":{"1":1}}],["5447",{"2":{"1":1}}],["544561f0",{"2":{"1":1}}],["5858",{"2":{"1":1}}],["524924",{"2":{"19":1,"20":1}}],["5249",{"2":{"18":1}}],["52",{"2":{"1":1,"48":2}}],["57",{"2":{"1":1}}],["5",{"2":{"1":8,"4":5,"5":2,"7":3,"8":2,"9":4,"20":2,"26":1,"35":3,"39":2,"40":1,"41":1,"42":8,"47":1,"49":6,"50":1}}],["50275f0",{"2":{"20":6}}],["504673",{"2":{"19":1,"20":1}}],["5047",{"2":{"18":1}}],["50",{"2":{"1":7,"26":1,"39":1,"49":10}}],[">",{"2":{"1":1,"20":1}}],[">=",{"2":{"1":2}}],["98",{"2":{"47":1}}],["98×102",{"2":{"47":5}}],["985022",{"2":{"22":1,"24":3,"25":1}}],["991889",{"2":{"22":1,"24":3,"25":1}}],["99999999999999",{"2":{"48":2}}],["99999999999997",{"2":{"4":1,"5":1,"7":1,"8":1,"9":1,"20":1,"35":1,"47":1}}],["9999",{"2":{"7":2,"8":8}}],["925327",{"2":{"22":1,"24":3,"25":1}}],["929525",{"2":{"22":1,"24":3,"25":1}}],["9263",{"2":{"1":1}}],["935687",{"2":{"19":1,"20":1}}],["9357",{"2":{"18":1}}],["9373",{"2":{"4":1}}],["9122",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["97",{"2":{"1":3}}],["9",{"2":{"1":2,"2":2,"20":2,"28":1,"42":2,"47":2}}],["90",{"2":{"1":5,"4":8,"5":4,"7":4,"8":4,"9":8,"35":4,"42":3,"47":3,"49":4}}],["72",{"2":{"48":2}}],["7288",{"2":{"1":1}}],["73",{"2":{"48":1}}],["738871",{"2":{"22":1,"24":3,"25":1}}],["71",{"2":{"47":1}}],["715192",{"2":{"22":1,"24":3,"25":1}}],["75",{"2":{"38":1,"39":1,"49":2}}],["79",{"2":{"42":2}}],["790546f0",{"2":{"20":2}}],["798",{"2":{"5":1}}],["7983f0",{"2":{"1":2}}],["766683",{"2":{"22":1,"24":3,"25":1}}],["763696",{"2":{"22":1,"24":3,"25":1}}],["76",{"2":{"1":1}}],["7454",{"2":{"1":1}}],["785021",{"2":{"22":1,"24":3,"25":1}}],["78",{"2":{"1":1,"18":1,"42":2}}],["775f0",{"2":{"1":1}}],["7",{"2":{"1":5,"20":7}}],["701",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["7030",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["708290",{"2":{"1":4,"49":4}}],["70",{"2":{"1":2,"47":2,"49":1}}],["68821e10",{"2":{"49":6}}],["6×7",{"2":{"49":2}}],["6×6×10",{"2":{"24":1}}],["6×6×13",{"2":{"22":1}}],["6×6",{"2":{"24":2,"25":1}}],["65",{"2":{"49":1}}],["656881",{"2":{"22":1,"24":3,"25":1}}],["659419",{"2":{"22":1,"24":3,"25":1}}],["659454f0",{"2":{"1":1}}],["65921",{"2":{"1":1}}],["64136",{"2":{"22":1,"24":3,"25":1}}],["693461",{"2":{"22":1,"24":3,"25":1}}],["6988",{"2":{"1":1}}],["61",{"2":{"5":1,"26":1}}],["66031e11",{"2":{"49":6}}],["66666666666664",{"2":{"48":1}}],["666666666666643",{"2":{"47":1}}],["66666666666666",{"2":{"48":1}}],["66666666666667",{"2":{"47":3}}],["6667",{"2":{"4":4,"5":2,"7":2,"8":2,"9":4,"35":2}}],["6665",{"2":{"1":1}}],["6694",{"2":{"1":1}}],["67",{"2":{"1":1}}],["6732",{"2":{"1":1}}],["6715",{"2":{"1":1}}],["6751",{"2":{"1":1}}],["6326",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["6378137",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["6371008",{"2":{"1":1,"49":1}}],["638462f0",{"2":{"1":2}}],["6",{"2":{"1":4,"18":1,"20":9,"48":1,"49":8,"50":1}}],["600",{"2":{"39":2}}],["60",{"2":{"1":3,"42":1,"49":3}}],["┤",{"2":{"1":1,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"22":1,"24":3,"25":1,"35":2,"39":2,"42":4,"47":4,"48":2,"49":3}}],["→",{"2":{"1":2,"4":4,"5":2,"7":2,"8":2,"9":4,"20":1,"22":2,"24":6,"25":2,"35":2,"39":1,"42":2,"47":2,"48":1,"49":6}}],["↓",{"2":{"1":2,"4":4,"5":2,"7":2,"8":2,"9":4,"20":1,"22":2,"24":6,"25":2,"35":2,"39":1,"42":2,"47":2,"48":1,"49":6}}],["┐",{"2":{"1":1,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"22":1,"24":3,"25":1,"35":1,"39":1,"42":2,"47":2,"48":1,"49":3}}],["48",{"2":{"26":1}}],["480",{"2":{"1":1}}],["49999999999998",{"2":{"48":1}}],["499999999999972",{"2":{"47":2}}],["498898",{"2":{"22":1,"24":3,"25":1}}],["490719",{"2":{"19":1,"20":1}}],["475879",{"2":{"22":1,"24":3,"25":1}}],["4759",{"2":{"1":1}}],["47019",{"2":{"22":1,"24":3,"25":1}}],["476077",{"2":{"22":1,"24":3,"25":1}}],["4645f0",{"2":{"20":2}}],["43",{"2":{"20":1,"26":1,"39":2}}],["437709",{"2":{"19":1,"20":1}}],["432552",{"2":{"19":2,"20":2}}],["4326",{"2":{"1":14,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"25":1,"35":1,"39":1,"42":4,"47":2,"48":1,"49":8}}],["430986",{"2":{"19":1,"20":1}}],["431684",{"2":{"19":1,"20":1}}],["431",{"2":{"18":1}}],["4317",{"2":{"18":1}}],["433349",{"2":{"19":1,"20":1}}],["4333",{"2":{"18":1}}],["42685e11",{"2":{"49":6}}],["420698f0",{"2":{"20":1}}],["42",{"2":{"20":7}}],["4243",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["4291",{"2":{"1":1}}],["4f38",{"2":{"4":10,"5":1,"7":8,"9":18,"20":1,"35":9,"47":6,"48":3}}],["45",{"2":{"1":4,"42":1}}],["448374",{"2":{"19":1,"20":1}}],["4474",{"2":{"1":1}}],["441",{"2":{"1":2}}],["446",{"2":{"1":1}}],["418261",{"2":{"19":1,"20":1}}],["41",{"2":{"1":2,"20":9}}],["4",{"2":{"1":3,"2":2,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":2,"49":6}}],["408354f0",{"2":{"20":2}}],["400",{"2":{"43":1}}],["400058",{"2":{"19":1,"20":1}}],["4001",{"2":{"18":1}}],["402",{"2":{"5":1}}],["40",{"2":{"1":8,"20":3,"48":1,"49":1}}],["4×6",{"2":{"1":1,"49":1}}],["│",{"2":{"1":20,"4":4,"5":2,"7":2,"8":2,"9":4,"18":108,"20":2,"22":2,"24":6,"25":2,"35":2,"39":2,"42":4,"47":4,"48":2,"49":6}}],["85",{"2":{"49":2}}],["85225f0",{"2":{"20":1}}],["800",{"2":{"43":1}}],["80",{"2":{"42":2,"49":5}}],["80923",{"2":{"22":1,"24":3,"25":1}}],["805",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["813814",{"2":{"22":1,"24":3,"25":1}}],["824661",{"2":{"22":1,"24":3,"25":1}}],["830128",{"2":{"22":1,"24":3,"25":1}}],["839173",{"2":{"22":1,"24":3,"25":1}}],["8357186f0",{"2":{"20":6}}],["833",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1}}],["8333",{"2":{"4":4,"5":2,"7":2,"8":2,"9":4,"35":2}}],["83333333333333",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":2,"35":1,"47":1,"48":1}}],["83333333333331",{"2":{"4":1,"5":1,"7":1,"8":1,"9":3,"20":1,"35":1,"47":2}}],["846535f0",{"2":{"20":1}}],["8485",{"2":{"5":1}}],["84",{"2":{"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"35":2,"39":2,"47":4,"48":2}}],["8901",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["89",{"2":{"4":14,"5":6,"7":7,"8":6,"9":14,"20":1,"35":7,"42":2,"47":1}}],["8991",{"2":{"1":1}}],["87126",{"2":{"1":1}}],["873182",{"2":{"1":4,"49":4}}],["8688",{"2":{"1":1}}],["88114e11",{"2":{"49":6}}],["881583f0",{"2":{"20":7}}],["8868",{"2":{"1":1}}],["88",{"2":{"1":1,"42":2}}],["8",{"2":{"1":2,"20":2,"28":1,"49":1}}],["382602",{"2":{"19":1,"20":1}}],["381847",{"2":{"19":1,"20":1}}],["3818",{"2":{"18":1}}],["381",{"2":{"1":1}}],["310064",{"2":{"19":1,"20":1}}],["31",{"2":{"5":1,"49":2}}],["347186",{"2":{"19":1,"20":1}}],["347",{"2":{"18":1}}],["34",{"2":{"5":1}}],["36",{"2":{"18":9,"19":18,"20":18}}],["360964",{"2":{"22":1,"24":3,"25":1}}],["360",{"2":{"4":1,"42":2}}],["3656",{"2":{"1":1}}],["3d",{"2":{"2":2,"34":1,"35":2,"36":2,"38":2,"40":1}}],["338776",{"2":{"19":1,"20":1}}],["332969",{"2":{"19":1,"20":1}}],["339",{"2":{"18":1}}],["333783",{"2":{"19":2,"20":2}}],["333",{"2":{"18":1}}],["33333333333336",{"2":{"39":2}}],["3333",{"2":{"4":2,"7":1,"9":2,"35":1}}],["33",{"2":{"1":1}}],["32768",{"2":{"47":2,"48":1}}],["328025",{"2":{"19":1,"20":1}}],["328896",{"2":{"19":1,"20":1}}],["329",{"2":{"18":1}}],["321388f0",{"2":{"1":1}}],["32",{"2":{"1":3,"48":2}}],["359",{"2":{"42":2}}],["357",{"2":{"42":2}}],["35",{"2":{"1":6}}],["3",{"0":{"36":1},"2":{"1":9,"2":2,"4":10,"5":1,"7":8,"9":18,"11":1,"18":1,"20":2,"22":1,"24":1,"35":9,"38":3,"39":3,"42":5,"47":6,"48":5}}],["30362",{"2":{"19":1,"20":1}}],["3036",{"2":{"18":1}}],["300",{"2":{"18":1}}],["3087",{"2":{"1":1}}],["30",{"2":{"1":5,"5":2,"22":8,"23":1,"24":18,"25":6,"42":2,"49":2}}],["377673",{"2":{"19":1,"20":1}}],["373215",{"2":{"19":1,"20":1}}],["37",{"2":{"1":2,"19":1,"20":1,"42":2}}],["398438",{"2":{"19":1,"20":1}}],["394749",{"2":{"19":1,"20":1}}],["396453",{"2":{"19":1,"20":1}}],["396",{"2":{"18":1}}],["391682",{"2":{"19":1,"20":1}}],["391097",{"2":{"19":1,"20":1}}],["391",{"2":{"18":1}}],["399",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["39",{"2":{"1":10,"2":5,"9":1,"14":1,"17":1,"20":2,"29":2,"40":1,"44":1,"49":8,"50":14}}],["0f20",{"2":{"42":4}}],["0f0",{"2":{"1":5,"7":1,"8":1,"20":19}}],["0xffffffff",{"2":{"39":1}}],["0xffff",{"2":{"39":3}}],["04",{"2":{"26":1}}],["046",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["0895f0",{"2":{"20":2}}],["096394",{"2":{"19":1,"20":1}}],["096",{"2":{"18":1}}],["092",{"2":{"5":1}}],["05",{"2":{"1":1}}],["0273",{"2":{"1":1}}],["029825f0",{"2":{"1":1}}],["063",{"2":{"1":1}}],["0334e10",{"2":{"49":6}}],["03",{"2":{"1":2}}],["0779533",{"2":{"22":1,"24":3,"25":1}}],["077084f0",{"2":{"1":1}}],["0768",{"2":{"4":1}}],["076923f0",{"2":{"1":2}}],["07",{"2":{"1":1}}],["0",{"2":{"1":78,"2":2,"4":27,"5":12,"7":12,"8":18,"9":24,"19":1,"20":5,"22":36,"24":108,"25":36,"28":1,"35":12,"38":1,"39":5,"42":22,"44":1,"46":1,"47":9,"48":5,"49":79,"50":2}}],["00299756",{"2":{"22":1,"24":3,"25":1}}],["00451968",{"2":{"22":1,"24":3,"25":1}}],["001604f0",{"2":{"20":1}}],["0094",{"2":{"4":1}}],["005fvlen",{"2":{"2":2}}],["005fdef",{"2":{"2":2}}],["007",{"2":{"1":1}}],["000000000000005",{"2":{"39":1}}],["000000000000004",{"2":{"20":1}}],["000",{"2":{"1":2}}],["00",{"2":{"1":12,"22":8,"24":8,"42":16}}],["0174532925199433",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["01154e6",{"2":{"1":4,"49":4}}],["01t00",{"2":{"1":6,"22":4,"24":4,"42":4}}],["01",{"2":{"1":6,"22":4,"24":2,"42":10}}],["kingdom",{"2":{"18":1}}],["k",{"2":{"2":3,"42":2}}],["keep",{"2":{"49":1}}],["keeps",{"2":{"1":1}}],["keys",{"2":{"1":10,"2":4}}],["keyword",{"2":{"1":15,"2":6,"49":1,"50":1}}],["keywords",{"2":{"1":35,"2":11,"16":1,"36":1,"38":1}}],["key",{"2":{"1":2,"29":1}}],["known",{"2":{"12":1}}],["know",{"2":{"1":4,"6":1,"29":1}}],["kw",{"2":{"1":23,"2":5,"20":2,"38":1,"40":1}}],["uint16",{"2":{"39":3}}],["uint64",{"2":{"18":2}}],["uint8",{"2":{"18":1}}],["uint32",{"2":{"1":1,"39":1}}],["ucar",{"2":{"2":2,"42":1}}],["update",{"2":{"9":1,"31":1}}],["updating",{"2":{"1":1}}],["upper",{"2":{"1":13}}],["upper=",{"2":{"1":1}}],["url",{"2":{"1":14,"29":1,"42":2,"46":2}}],["unexported",{"2":{"36":1,"40":1}}],["unexpected",{"2":{"1":6}}],["until",{"2":{"26":1}}],["unitrange",{"2":{"18":1}}],["unit",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"41":1,"47":2,"48":1}}],["units",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":4}}],["unidata",{"2":{"2":2,"42":1}}],["union",{"2":{"1":10,"2":2,"20":80,"42":2}}],["unmasked",{"2":{"1":2}}],["under",{"2":{"28":1,"50":1}}],["underscores",{"2":{"2":1}}],["underlying",{"2":{"1":3,"2":1,"33":1,"38":1,"40":1}}],["undefined",{"2":{"1":1}}],["unchanged",{"2":{"1":3}}],["unless",{"2":{"1":2}}],["unopened",{"2":{"1":1}}],["usage",{"0":{"50":1}}],["us",{"2":{"1":1}}],["using",{"0":{"39":1,"47":1},"2":{"1":25,"2":3,"11":1,"12":2,"13":1,"15":1,"16":1,"17":2,"18":1,"20":1,"22":2,"24":1,"26":1,"28":8,"35":1,"41":1,"42":2,"45":2,"46":1,"47":3,"48":3,"49":4,"50":1}}],["usually",{"2":{"1":11,"2":5,"38":1}}],["users",{"2":{"2":1}}],["uses",{"2":{"1":3,"10":1,"25":1,"42":1}}],["used",{"2":{"1":90,"2":16,"6":1,"9":1,"12":2,"14":1,"16":2,"25":1,"26":1,"40":1,"44":1,"50":1}}],["use",{"2":{"1":44,"2":6,"3":1,"4":1,"5":1,"7":1,"10":1,"12":1,"26":2,"28":1,"29":1,"30":1,"36":1,"40":1,"42":1,"49":1,"50":3}}],["usefull",{"2":{"1":2}}],["usefulnesss",{"2":{"1":1}}],["useful",{"2":{"1":9,"33":1,"49":2}}],["==",{"2":{"50":1}}],["===",{"2":{"1":1}}],["=a",{"2":{"24":1}}],["=>",{"2":{"1":14,"4":8,"5":4,"7":4,"8":4,"9":10,"35":4,"42":18}}],["=",{"2":{"1":137,"2":18,"4":5,"5":5,"7":4,"8":2,"9":4,"16":1,"18":2,"19":1,"20":8,"22":6,"23":2,"24":7,"25":2,"26":3,"35":6,"36":4,"38":20,"39":20,"40":1,"41":2,"42":10,"46":2,"47":21,"48":18,"49":21,"50":25}}],["visualize",{"2":{"36":1}}],["via",{"2":{"2":2,"24":1,"47":1,"50":1}}],["views",{"2":{"1":1}}],["view",{"2":{"1":4,"26":4,"50":1}}],["vlen",{"2":{"2":2}}],["ve",{"2":{"50":1}}],["vebose",{"2":{"1":2,"2":2}}],["vertical",{"2":{"25":1}}],["verbose",{"2":{"1":4}}],["version",{"2":{"1":2}}],["versions",{"2":{"1":19,"49":1}}],["very",{"2":{"1":5,"11":1,"40":1,"49":1}}],["vectors",{"2":{"1":1}}],["vector",{"2":{"1":17,"2":2,"18":2,"19":2,"20":1,"38":2,"46":1}}],["vanilla",{"0":{"39":1}}],["variations",{"2":{"29":1}}],["variable",{"2":{"2":2,"49":1}}],["variables",{"2":{"1":2,"12":1,"17":1,"20":1,"49":1}}],["various",{"2":{"16":1}}],["valid",{"2":{"2":2}}],["values",{"0":{"31":1},"2":{"1":74,"2":3,"7":1,"26":3,"30":1,"31":2,"32":1,"38":1,"40":3,"44":1,"47":1,"50":1}}],["value",{"0":{"25":1},"2":{"1":54,"2":4,"6":1,"9":1,"19":1,"26":4,"42":2,"48":1,"49":2}}],["val",{"2":{"1":2}}],["val=",{"2":{"1":1}}],["2d",{"2":{"36":1,"40":1}}],["261726",{"2":{"22":1,"24":3,"25":1}}],["26",{"2":{"22":2,"24":6,"25":2,"49":4}}],["268078f0",{"2":{"20":7}}],["235596",{"2":{"19":1,"20":1}}],["236",{"2":{"18":1}}],["23",{"2":{"4":1,"18":1,"20":18,"42":2}}],["23017e6",{"2":{"1":4,"49":4}}],["22",{"2":{"1":1,"4":2,"18":1,"20":1}}],["276805",{"2":{"22":1,"24":3,"25":1}}],["2727",{"2":{"1":1}}],["27",{"2":{"1":4,"5":1,"22":2,"24":6,"25":2}}],["273",{"2":{"1":1}}],["271",{"2":{"1":1}}],["284565",{"2":{"19":1,"20":1}}],["285",{"2":{"18":1}}],["2888",{"2":{"1":1}}],["28",{"2":{"1":2,"5":1,"22":2,"24":6,"25":2}}],["296856",{"2":{"22":1,"24":3,"25":1}}],["2955",{"2":{"5":1}}],["298",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["29",{"2":{"1":4,"22":2,"24":6,"25":2}}],["247929",{"2":{"22":1,"24":3,"25":1}}],["242291",{"2":{"22":1,"24":3,"25":1}}],["240881",{"2":{"19":1,"20":1}}],["241",{"2":{"18":1}}],["243",{"2":{"1":1}}],["24534",{"2":{"1":1}}],["24",{"2":{"1":5}}],["218817",{"2":{"22":1,"24":3,"25":1}}],["2160",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1,"47":1}}],["2160×1080",{"2":{"4":1,"5":1,"7":1,"8":1,"9":2,"35":1,"47":5}}],["21",{"2":{"1":4,"18":1,"49":2}}],["2592000000",{"2":{"42":1}}],["259489",{"2":{"19":1,"20":1}}],["258",{"2":{"1":1}}],["258×8",{"2":{"1":1}}],["257223563",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["257",{"2":{"1":1}}],["256",{"2":{"1":1,"2":6,"19":1,"20":1}}],["255",{"2":{"1":1}}],["254",{"2":{"1":1}}],["253",{"2":{"1":1}}],["252",{"2":{"1":1}}],["25",{"2":{"1":9,"20":3,"22":8,"23":1,"24":18,"25":6,"26":2,"47":2}}],["2",{"0":{"35":1},"2":{"1":9,"2":3,"4":2,"5":4,"7":1,"8":1,"9":2,"14":1,"18":2,"24":2,"25":1,"34":1,"35":5,"38":2,"39":7,"41":1,"44":1,"49":3}}],["20833333333334",{"2":{"39":1}}],["2020",{"2":{"18":1}}],["2021",{"2":{"18":1}}],["2012",{"2":{"18":2}}],["2016",{"2":{"18":3}}],["2011",{"2":{"18":2}}],["2015",{"2":{"18":1}}],["2065",{"2":{"1":1}}],["20417f0",{"2":{"1":1}}],["2003",{"2":{"42":2}}],["2005",{"2":{"42":2}}],["2009",{"2":{"1":1}}],["2002",{"2":{"1":3,"22":3,"42":5}}],["2001",{"2":{"1":6,"22":3,"24":4,"25":1,"42":7}}],["20",{"2":{"1":11,"44":2,"49":1}}],["globe",{"2":{"50":1}}],["global",{"2":{"14":1,"17":1,"47":1}}],["gadm",{"2":{"45":1}}],["go",{"2":{"49":1}}],["going",{"2":{"40":1}}],["good",{"2":{"29":1}}],["google",{"2":{"29":1}}],["gbif",{"0":{"17":1,"18":1},"1":{"18":1,"19":1,"20":1}}],["gbif2",{"2":{"1":2,"17":1,"18":4}}],["guaranteed",{"2":{"2":2}}],["guessed",{"2":{"2":3}}],["guessing",{"2":{"2":2}}],["gis",{"2":{"31":1}}],["giving",{"2":{"1":1}}],["given",{"2":{"1":2,"22":1}}],["gives",{"2":{"1":6,"49":1}}],["give",{"2":{"1":7}}],["github",{"2":{"1":23,"46":1,"49":1}}],["gpu",{"2":{"1":1,"33":1}}],["great",{"2":{"29":1}}],["greenwich",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["grow",{"2":{"1":2}}],["group3",{"2":{"1":2}}],["group2",{"2":{"1":2}}],["group1",{"2":{"1":2}}],["group=",{"2":{"1":2}}],["groups",{"2":{"1":2}}],["group",{"2":{"1":6}}],["gri",{"2":{"2":4}}],["grid=false",{"2":{"39":2}}],["gridposition",{"2":{"2":1,"38":1,"40":1}}],["grid",{"2":{"1":2,"2":2,"49":2,"50":1}}],["gridcell",{"2":{"1":1,"49":1}}],["gribsource",{"2":{"1":2,"2":3}}],["grib",{"2":{"1":4,"2":3,"28":1}}],["grdsource",{"2":{"2":1}}],["grd",{"0":{"11":1},"2":{"1":2,"2":12,"11":1,"28":1}}],["g",{"2":{"1":11,"2":1,"22":1,"25":1,"26":2,"29":1,"30":1,"33":1,"40":1}}],["gdalwarp",{"2":{"1":4,"30":1}}],["gdals",{"2":{"1":2}}],["gdalsource",{"2":{"1":2,"2":3,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["gdal",{"0":{"13":1},"2":{"1":8,"2":15,"13":1,"28":3}}],["gdalarray",{"2":{"1":1}}],["gt",{"2":{"1":17,"2":2,"49":2}}],["gets",{"2":{"50":1}}],["getting",{"0":{"23":1}}],["getdriver",{"2":{"2":2}}],["getring",{"2":{"1":1}}],["getring`",{"2":{"1":1}}],["getraster",{"2":{"1":1,"16":1}}],["get",{"0":{"20":1},"2":{"1":8,"20":1,"26":4,"29":1,"42":1,"45":1,"50":8}}],["getindex",{"2":{"1":10,"26":2}}],["geographic",{"2":{"49":1,"50":1}}],["geogcs",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["geodetic",{"2":{"49":2}}],["geoaxis",{"2":{"2":1,"38":1}}],["geomakie",{"2":{"2":1,"38":1,"49":1}}],["geom",{"2":{"1":7}}],["geometric",{"2":{"1":1}}],["geometries",{"2":{"1":50,"32":3,"50":1}}],["geometrycolumn",{"2":{"1":20}}],["geometry",{"2":{"1":32,"18":1,"20":20,"50":7}}],["geotiff",{"2":{"1":1,"22":1}}],["geointerface",{"2":{"1":18,"19":1}}],["geoformattypes",{"2":{"1":7,"9":1}}],["geoformat",{"2":{"1":9,"9":1}}],["general",{"2":{"50":1}}],["generally",{"2":{"1":1,"9":1,"13":1}}],["generating",{"2":{"6":1}}],["generator",{"2":{"1":1}}],["generated",{"2":{"50":1}}],["generates",{"2":{"22":1,"50":1}}],["generate",{"2":{"1":4}}],["generically",{"2":{"25":1}}],["generic",{"2":{"1":1,"42":1,"48":1}}],["||",{"2":{"1":5}}],["|",{"2":{"1":2}}],["|>",{"2":{"1":7,"39":1,"42":2,"44":1}}],["np",{"2":{"48":3}}],["ncstack",{"2":{"12":1}}],["ncdatasets",{"2":{"12":1,"28":1,"42":1,"45":1}}],["ncdsource",{"2":{"1":2,"2":5,"42":2}}],["nc",{"2":{"2":4,"12":3,"42":2,"44":2,"48":1}}],["ntuple",{"2":{"2":3}}],["nuevo",{"2":{"1":1}}],["numbers",{"2":{"22":1}}],["number",{"2":{"1":3,"10":1,"49":1}}],["natively",{"2":{"11":1}}],["naturalearth",{"2":{"50":3}}],["natural",{"2":{"1":5,"46":1}}],["na",{"2":{"2":3}}],["nan",{"2":{"1":16,"2":2,"38":2,"50":1}}],["name=",{"2":{"7":1,"12":1,"14":1}}],["nametuple",{"2":{"1":1}}],["names",{"2":{"1":2,"12":1,"25":1,"38":1}}],["named",{"2":{"1":1,"22":1}}],["namedtuple",{"2":{"1":12,"2":5,"20":20}}],["name",{"2":{"1":29,"2":7,"3":1,"7":2,"12":1,"14":1,"38":3,"42":6,"46":2,"47":1,"50":1}}],["nvkelso",{"2":{"1":4,"46":1}}],["nz",{"2":{"1":6}}],["n",{"2":{"1":1,"2":3}}],["norway",{"2":{"47":4,"48":11}}],["north",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["normally",{"2":{"1":2}}],["nochecksum",{"2":{"2":2}}],["now",{"2":{"1":1,"28":1,"42":2,"48":2,"49":1,"50":3}}],["nodataval",{"2":{"2":3}}],["nodata",{"2":{"1":9}}],["none",{"2":{"20":1}}],["non",{"2":{"1":12,"44":1,"49":1}}],["no",{"2":{"1":23,"2":4}}],["nometadata",{"2":{"1":1}}],["notice",{"2":{"42":1}}],["nothing",{"2":{"1":22,"2":2,"38":2}}],["note",{"2":{"1":10,"26":1,"31":1,"49":2,"50":2}}],["not",{"2":{"1":103,"2":6,"11":1,"12":1,"15":1,"28":1,"29":2,"35":1,"38":1,"40":1,"49":1}}],["neighbour",{"2":{"1":1}}],["ne",{"2":{"1":7,"46":1}}],["newdocs",{"2":{"2":2}}],["newmissingval",{"2":{"1":2}}],["new",{"2":{"1":11,"6":1}}],["nested",{"2":{"1":13,"9":1}}],["needs",{"2":{"2":2}}],["needed",{"2":{"1":4,"28":1}}],["need",{"2":{"1":6,"2":2,"5":1,"7":1,"28":2,"29":4,"38":1,"42":1,"49":1,"50":1}}],["netcdf",{"0":{"12":1},"2":{"1":9,"2":14,"12":4,"22":1,"25":1,"28":1,"30":1,"42":2,"48":1}}],["nearly",{"2":{"29":1}}],["nearest",{"2":{"1":1}}],["near",{"2":{"1":3,"25":1,"26":1,"42":2,"44":1}}],["xlabel",{"2":{"2":1,"38":1,"39":1}}],["x=",{"2":{"1":1}}],["x=100",{"2":{"1":1}}],["xs",{"2":{"1":8}}],["xdim",{"2":{"1":8,"2":1,"38":1,"49":2}}],["x",{"2":{"1":68,"2":11,"4":5,"5":2,"7":2,"8":2,"9":6,"11":1,"12":1,"14":1,"19":1,"20":7,"22":4,"23":2,"24":6,"25":4,"26":6,"31":1,"35":2,"38":4,"39":7,"42":7,"44":1,"47":12,"48":7,"49":15}}],["x3c",{"2":{"1":14,"2":3}}],["ylabel",{"2":{"2":1,"38":1,"39":1}}],["year",{"2":{"18":1,"42":1}}],["year=",{"2":{"1":1}}],["yet",{"2":{"2":1,"28":1}}],["y=",{"2":{"1":2}}],["ydim",{"2":{"1":8,"2":2,"38":2,"49":2}}],["y",{"2":{"1":18,"2":8,"4":4,"5":2,"7":2,"8":2,"9":4,"11":1,"12":1,"14":1,"19":1,"20":7,"22":4,"23":2,"24":6,"25":4,"26":2,"31":1,"35":2,"38":5,"39":7,"42":7,"44":2,"47":12,"48":7,"49":16}}],["your",{"2":{"1":2,"29":2,"49":1}}],["you",{"2":{"1":17,"2":6,"6":2,"7":1,"9":1,"10":1,"28":4,"29":3,"34":1,"36":2,"38":1,"40":1,"49":8,"50":2}}],["1×1080",{"2":{"4":1}}],["190",{"2":{"42":1}}],["194",{"2":{"39":1}}],["194×161",{"2":{"39":5}}],["198393",{"2":{"22":1,"24":3,"25":1}}],["1984",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["192",{"2":{"1":1}}],["19279e6",{"2":{"1":4,"49":4}}],["18368",{"2":{"22":1,"24":3,"25":1}}],["1837",{"2":{"1":1}}],["18",{"2":{"18":1}}],["1864",{"2":{"1":1}}],["180×170×1",{"2":{"42":1}}],["180×170×24",{"2":{"42":1}}],["180",{"2":{"1":2,"4":8,"5":3,"7":3,"8":3,"9":6,"35":3,"47":2}}],["142f0",{"2":{"20":1}}],["147",{"2":{"18":1,"19":2,"20":2}}],["1478",{"2":{"4":1,"7":1,"8":1,"9":2,"35":1}}],["148373",{"2":{"22":1,"24":3,"25":1}}],["148",{"2":{"18":8,"19":17,"20":17}}],["14",{"2":{"1":2,"4":1,"7":1,"8":1,"9":2,"35":1}}],["145",{"2":{"1":1}}],["144",{"2":{"1":1}}],["16666666666666666",{"2":{"48":2}}],["1666666666666443",{"2":{"48":2}}],["16666666666667",{"2":{"20":1}}],["16t00",{"2":{"42":4}}],["161",{"2":{"39":1}}],["1692",{"2":{"20":2}}],["1622",{"2":{"1":1}}],["160",{"2":{"1":3,"39":1}}],["16",{"2":{"1":1,"42":2,"49":2}}],["165",{"2":{"1":1}}],["1f0",{"2":{"1":1}}],["177×119",{"2":{"48":5}}],["175207",{"2":{"22":1,"24":3,"25":1}}],["1706977f0",{"2":{"20":2}}],["179",{"2":{"4":3,"5":3,"7":3,"8":3,"9":6,"35":3,"47":2}}],["17",{"2":{"1":6,"4":1,"7":1,"8":1,"9":2,"35":1,"42":1}}],["1368",{"2":{"20":1}}],["133f0",{"2":{"20":7}}],["138",{"2":{"20":3}}],["13",{"2":{"1":2,"4":1,"7":1,"8":1,"9":2,"35":1,"39":2}}],["130",{"2":{"1":1,"49":1}}],["153",{"2":{"39":2}}],["153847f0",{"2":{"1":2}}],["1544",{"2":{"20":7}}],["154",{"2":{"20":2}}],["155",{"2":{"20":1}}],["15",{"2":{"1":7,"4":3,"7":3,"8":3,"9":6,"18":2,"35":3}}],["1500",{"2":{"20":6}}],["150",{"2":{"1":1}}],["1292",{"2":{"20":2}}],["1223",{"2":{"20":1}}],["1287",{"2":{"1":1}}],["12",{"2":{"1":3,"20":1,"26":2,"38":1,"42":2}}],["120",{"2":{"1":3,"49":3}}],["113",{"2":{"39":2}}],["119827f0",{"2":{"20":2}}],["11917e6",{"2":{"1":4,"49":4}}],["11",{"2":{"1":1,"18":6,"42":2,"49":2}}],["110",{"2":{"1":1,"49":1}}],["102",{"2":{"20":1,"47":1}}],["102×89",{"2":{"20":5}}],["1080",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"47":1}}],["10m",{"2":{"1":8,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"46":2}}],["10",{"2":{"1":34,"18":1,"24":3,"39":3,"47":1,"49":5,"50":1}}],["100mm",{"2":{"50":1}}],["100",{"2":{"1":28,"26":1,"39":1,"49":2}}],["1",{"2":{"1":39,"2":4,"4":4,"5":2,"7":2,"8":2,"9":4,"18":4,"19":1,"20":5,"22":7,"23":1,"24":10,"25":2,"26":1,"28":1,"35":4,"36":1,"38":2,"39":6,"42":8,"44":1,"48":2,"49":84}}],["dp",{"2":{"48":1}}],["dpi=300",{"2":{"43":1}}],["d",{"0":{"35":1,"36":1},"2":{"34":1}}],["df",{"2":{"20":2}}],["dark",{"2":{"39":1}}],["day",{"2":{"18":1}}],["datsets",{"2":{"16":1}}],["datum",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["date",{"2":{"42":1}}],["date=datetime",{"2":{"1":2}}],["dates",{"2":{"1":8,"16":1,"22":1,"45":1,"47":1}}],["datetime360day",{"2":{"42":12}}],["datetime",{"2":{"1":13,"22":7,"24":5,"25":1}}],["dataaspect",{"2":{"35":1,"36":1,"49":1,"50":1}}],["dataframe",{"2":{"1":3,"20":2}}],["dataframes",{"2":{"1":1,"20":1}}],["datasets",{"2":{"1":2,"16":1}}],["dataset",{"2":{"1":4,"2":4,"14":1,"47":1,"49":1}}],["data",{"0":{"10":1,"18":1,"33":1,"42":1},"1":{"11":1,"12":1,"13":1,"14":1,"15":1,"16":1,"43":1,"44":1},"2":{"1":53,"2":1,"4":1,"10":1,"14":1,"15":1,"16":3,"17":1,"22":1,"25":1,"28":1,"29":1,"30":3,"33":4,"38":1,"39":1,"40":1,"42":2,"47":1,"50":7}}],["drive",{"2":{"29":1}}],["drivers",{"2":{"2":2}}],["drivername",{"2":{"2":2}}],["driver",{"2":{"2":12}}],["draw",{"2":{"2":2,"38":2}}],["drop",{"2":{"1":2,"29":1}}],["dropband",{"2":{"1":2}}],["dhekelia",{"2":{"1":1}}],["dbf",{"2":{"1":7}}],["dstlookup",{"2":{"1":1}}],["dst",{"2":{"1":4,"2":4}}],["due",{"2":{"1":9}}],["during",{"2":{"1":2}}],["duplicate",{"2":{"1":4}}],["doing",{"2":{"50":1}}],["documentation",{"2":{"30":1}}],["documenter",{"2":{"14":1}}],["docstring",{"2":{"14":2}}],["docs",{"2":{"1":2,"15":1,"16":2}}],["dot",{"2":{"4":1}}],["down",{"2":{"1":2}}],["downloading",{"2":{"29":1}}],["downloads",{"2":{"1":9,"28":1,"29":1,"42":1,"45":1,"46":2}}],["download",{"0":{"46":1},"1":{"47":1,"48":1},"2":{"1":12,"16":2,"28":1,"42":2,"46":1}}],["do",{"2":{"1":2,"2":5,"4":1,"5":2,"6":1,"22":1,"28":1,"29":1,"38":1,"39":1}}],["don",{"2":{"1":1,"2":4,"9":1,"50":1}}],["done",{"2":{"1":2,"24":1,"29":1}}],["doesn",{"2":{"44":1}}],["does",{"2":{"1":6}}],["denmark",{"2":{"47":4,"48":4}}],["degc",{"2":{"42":2}}],["degree",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"44":1,"47":2,"48":1}}],["degrees",{"2":{"1":6}}],["descriptions",{"2":{"30":1}}],["description",{"2":{"26":1,"30":1,"31":1,"32":1,"33":1}}],["designed",{"2":{"25":1}}],["destructively",{"2":{"2":6}}],["destination",{"2":{"1":1}}],["dest",{"2":{"1":3}}],["decimallatitude",{"2":{"19":2}}],["decimallongitude",{"2":{"19":1}}],["decline",{"2":{"1":2}}],["details",{"2":{"14":1,"25":1}}],["determines",{"2":{"1":1}}],["determine",{"2":{"1":6}}],["detect",{"2":{"10":1}}],["detected",{"2":{"1":10,"2":6}}],["detecting",{"2":{"1":1}}],["depending",{"2":{"1":2,"2":1,"49":1}}],["depth",{"2":{"1":2,"30":1}}],["deferred",{"2":{"26":1}}],["deflate",{"2":{"2":2}}],["deflatelevel",{"2":{"2":2}}],["defualts",{"2":{"1":2}}],["defined",{"2":{"1":1,"2":1,"49":1}}],["define",{"2":{"1":2,"48":1}}],["defines",{"2":{"1":1,"25":1}}],["defaults",{"2":{"1":3}}],["defaulting",{"2":{"1":1}}],["default",{"2":{"1":64,"2":20,"13":1,"38":1,"49":3,"50":1}}],["dividing",{"2":{"50":1}}],["divided",{"2":{"1":2}}],["difficult",{"2":{"9":1}}],["difference",{"2":{"49":2}}],["differences",{"2":{"1":2}}],["differently",{"2":{"34":1}}],["different",{"2":{"1":3,"12":1,"15":1,"30":3,"34":1,"49":2}}],["differnce",{"2":{"1":1}}],["directions",{"2":{"25":1}}],["directly",{"2":{"1":8,"2":1,"4":1,"5":1,"12":1,"16":1}}],["directory",{"2":{"1":4,"2":2}}],["directories",{"2":{"1":1}}],["dir",{"2":{"1":4}}],["dictionary",{"2":{"2":2}}],["dict",{"2":{"1":5,"2":4,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":2}}],["disable",{"2":{"2":1}}],["disaggregate",{"2":{"0":2,"1":4,"30":2}}],["distribution",{"2":{"1":1}}],["distance",{"2":{"1":4}}],["diskarrays",{"2":{"2":4}}],["disk",{"0":{"15":1,"44":1},"2":{"1":10,"2":3,"4":1,"5":2,"12":1,"15":1,"26":1,"33":1,"42":2,"44":1,"48":1}}],["dimtuple",{"2":{"1":1}}],["dimz",{"2":{"1":2}}],["dim",{"2":{"1":2,"12":1}}],["dims=ti",{"2":{"42":1}}],["dims=x",{"2":{"4":1}}],["dims=",{"2":{"1":2}}],["dims=band",{"2":{"1":1}}],["dims",{"2":{"1":22,"3":1,"4":2,"5":1,"7":1,"8":1,"9":2,"20":5,"22":1,"24":3,"25":1,"35":1,"39":5,"42":2,"47":10,"48":5,"49":3}}],["dimension",{"0":{"4":1},"2":{"1":47,"2":14,"3":1,"4":1,"9":1,"12":1,"13":1,"25":2,"26":1,"30":2,"38":8,"40":1,"42":2}}],["dimensional",{"2":{"2":2,"11":1,"14":1,"38":2,"40":1}}],["dimensionalarray",{"2":{"1":1}}],["dimensionaldata",{"2":{"1":6,"22":1,"25":2,"26":1,"42":1,"44":1}}],["dimensions",{"0":{"23":1},"2":{"1":43,"2":7,"9":2,"11":1,"12":3,"14":1,"22":2,"25":5,"26":1,"31":1,"38":2,"42":1,"44":1,"49":2}}],["equator",{"2":{"49":1}}],["equal",{"2":{"1":1,"2":1,"49":1}}],["efficient",{"2":{"36":1}}],["effort",{"2":{"29":1}}],["effect",{"2":{"1":3}}],["especially",{"2":{"25":1}}],["ecology",{"2":{"16":1}}],["ellipsoid",{"2":{"49":1}}],["eltype",{"2":{"20":4,"39":4,"47":8,"48":4}}],["else",{"2":{"2":2}}],["elements",{"2":{"1":1,"2":1}}],["element",{"2":{"1":3,"18":1,"19":1,"20":1,"38":1}}],["elevation",{"2":{"1":1,"49":1}}],["every",{"2":{"42":1}}],["everything",{"2":{"2":2}}],["evenness",{"2":{"1":19,"39":3}}],["even",{"2":{"1":1,"2":7,"34":1,"35":1,"38":1}}],["edu",{"2":{"2":2,"42":1}}],["etc",{"2":{"1":1}}],["errors",{"0":{"29":1},"2":{"1":2,"29":1}}],["error",{"2":{"1":4,"29":1}}],["empty",{"2":{"1":3}}],["encompasses",{"2":{"50":1}}],["encodes",{"2":{"49":1}}],["enumerate",{"2":{"39":2}}],["environmental",{"2":{"16":1,"17":1}}],["entries",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1,"42":2}}],["entire",{"2":{"1":2,"48":1}}],["enough",{"2":{"2":1}}],["ensure",{"2":{"2":1}}],["end",{"2":{"1":1,"2":1,"5":2,"38":1,"39":2,"48":2}}],["ease",{"2":{"34":1}}],["easy",{"2":{"29":1}}],["easter",{"2":{"50":1}}],["east",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":2,"35":1,"39":1,"47":2,"48":1}}],["eagerly",{"2":{"1":1}}],["earthenv",{"2":{"1":8,"39":2}}],["earth",{"2":{"1":7,"46":1,"49":3}}],["eachchunk",{"2":{"2":1}}],["each",{"2":{"1":24,"2":10,"28":1,"30":1,"38":1,"48":1,"49":6,"50":1}}],["e",{"2":{"1":13,"2":4,"22":1,"25":1,"26":2,"29":1,"30":1,"33":1,"38":1,"40":1,"49":1}}],["eg",{"2":{"1":3}}],["epsg",{"2":{"1":8,"4":10,"5":5,"7":5,"8":5,"9":10,"20":5,"25":1,"35":5,"39":5,"42":4,"47":10,"48":5,"49":6}}],["either",{"2":{"1":2,"2":1}}],["excluding",{"2":{"26":1}}],["excessive",{"2":{"1":5}}],["exact",{"2":{"29":1}}],["exactly",{"2":{"26":1}}],["examplebad",{"2":{"50":1}}],["exampletotal",{"2":{"50":2}}],["exampleprecip",{"2":{"50":1}}],["exampleavg",{"2":{"50":1}}],["exampleareas",{"2":{"50":1}}],["exampleall",{"2":{"50":1}}],["examplemasked",{"2":{"50":1}}],["examplecropped",{"2":{"50":1}}],["examplecellarea",{"2":{"49":1}}],["examplef",{"2":{"50":1}}],["exampleusing",{"2":{"50":1}}],["examples",{"2":{"22":1,"30":1,"42":1}}],["example",{"0":{"50":1},"2":{"1":46,"2":2,"17":1,"28":1,"29":1,"36":1,"42":1,"44":1,"45":1,"49":1}}],["exists",{"2":{"2":8}}],["existing",{"2":{"1":3}}],["explicitly",{"2":{"49":1}}],["explicit",{"2":{"25":1,"42":2}}],["experience",{"2":{"1":1}}],["experimental",{"2":{"1":19,"36":1,"49":1}}],["expected",{"2":{"1":6}}],["exported",{"0":{"1":1}}],["extra",{"2":{"29":1}}],["extracts",{"2":{"1":1}}],["extract",{"0":{"19":1},"2":{"0":1,"1":5,"17":1,"19":1,"20":2,"32":2}}],["extrema",{"2":{"1":2}}],["ext",{"2":{"1":1,"2":2,"15":1}}],["extensive",{"2":{"49":1}}],["extensions",{"0":{"28":1},"2":{"28":3}}],["extension",{"2":{"1":2,"2":18}}],["extents",{"2":{"1":18,"30":1}}],["extent",{"0":{"30":1},"2":{"1":43,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"22":2,"24":6,"25":2,"30":2,"35":2,"39":2,"42":4,"47":4,"48":2,"49":6}}],["extends",{"2":{"22":1}}],["extend",{"2":{"0":1,"1":8,"30":2}}],["l",{"2":{"39":4}}],["ll",{"2":{"17":1,"49":4,"50":2}}],["lscene",{"2":{"2":1,"38":1}}],["literate",{"2":{"50":1}}],["little",{"2":{"15":1,"29":1,"36":2}}],["limited",{"2":{"40":1}}],["limit=300",{"2":{"18":1}}],["limit=5",{"2":{"1":1}}],["linrange",{"2":{"4":3,"5":2,"7":2,"8":2,"9":4,"20":2,"35":2,"39":2,"47":4}}],["linear",{"2":{"3":1}}],["linewidth=0",{"2":{"1":2,"48":1}}],["lines",{"2":{"1":11,"46":1}}],["line",{"2":{"1":11}}],["listed",{"2":{"26":1}}],["list",{"2":{"1":1}}],["likely",{"2":{"1":1,"49":1}}],["like",{"2":{"1":18,"2":4,"3":2,"4":1,"22":1,"25":3,"28":2,"34":1,"40":1,"49":3}}],["lt",{"2":{"1":20,"49":2}}],["least",{"2":{"50":1}}],["leave",{"2":{"1":2}}],["let",{"2":{"49":1,"50":5}}],["lets",{"2":{"48":1}}],["legend=",{"2":{"20":1}}],["legend=false",{"2":{"1":1}}],["left",{"2":{"2":1,"38":1,"50":1}}],["length",{"2":{"1":5,"2":1,"38":1,"48":1,"49":2,"50":1}}],["level",{"2":{"1":1,"2":2}}],["layout",{"2":{"39":2}}],["layername",{"2":{"12":2,"14":1}}],["layered",{"2":{"1":4,"2":1,"14":1,"48":1}}],["layer",{"0":{"20":1},"2":{"1":16,"2":2,"7":1,"12":1,"14":1,"42":1,"48":1}}],["layersfrom",{"2":{"1":1}}],["layersfrom=band",{"2":{"1":2,"13":1}}],["layers",{"2":{"1":24,"2":3,"5":1,"12":4,"13":1,"14":3,"20":2,"30":1,"39":5,"47":3,"48":1}}],["label",{"2":{"2":3,"38":3,"39":1,"42":1}}],["labels",{"2":{"1":1}}],["lanczos",{"2":{"1":2}}],["last",{"2":{"1":12}}],["largely",{"2":{"25":1}}],["largest",{"2":{"1":1}}],["larger",{"2":{"1":2}}],["large",{"2":{"1":19,"40":2}}],["lazy=false",{"2":{"1":1,"2":1}}],["lazy=true",{"2":{"1":5,"2":1,"4":1}}],["lazy",{"2":{"1":10,"2":3,"26":1}}],["lazily",{"2":{"1":10,"2":1,"4":1,"48":1}}],["latitude",{"2":{"1":1,"4":2,"5":1,"7":1,"8":1,"9":2,"19":1,"20":1,"23":1,"25":1,"35":1,"39":1,"44":1,"47":2,"48":1,"49":1}}],["latter",{"2":{"1":1}}],["later",{"2":{"1":1}}],["lat",{"2":{"1":5,"22":2,"23":1,"39":1,"42":1,"49":1}}],["looks",{"2":{"49":1}}],["lookups",{"2":{"1":9,"2":1,"49":4}}],["lookup",{"0":{"23":1},"2":{"1":18,"2":2,"23":2,"25":2}}],["log",{"2":{"14":1}}],["lot",{"2":{"2":2,"48":1,"49":1,"50":1}}],["lost",{"2":{"15":1}}],["loses",{"2":{"1":1}}],["lossless",{"2":{"1":1}}],["lower",{"2":{"1":13}}],["lower=",{"2":{"1":1}}],["low",{"2":{"1":5,"2":1,"38":1}}],["locus",{"2":{"1":4}}],["location",{"2":{"1":1}}],["longest",{"2":{"40":1}}],["longitude",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"19":1,"20":1,"23":1,"25":1,"35":1,"39":1,"47":2,"48":1}}],["long",{"2":{"1":1,"42":2,"49":1}}],["lon",{"2":{"1":4,"22":2,"39":1,"42":1}}],["loads",{"2":{"28":1,"42":1}}],["load",{"0":{"18":1,"33":1,"47":1},"2":{"1":13,"10":1,"16":1,"17":1,"28":2,"42":1,"47":2}}],["loading",{"0":{"42":1},"1":{"43":1,"44":1},"2":{"1":5,"12":1,"40":1}}],["loaded",{"2":{"1":6,"11":1,"12":2,"13":3,"14":2,"15":1,"49":1}}],["h5",{"2":{"14":2}}],["html",{"2":{"2":4}}],["https",{"2":{"1":4,"2":6,"42":1,"46":1}}],["hood",{"2":{"50":1}}],["hosting",{"2":{"29":1}}],["however",{"2":{"1":2}}],["how",{"2":{"1":3,"25":1,"29":2,"40":1}}],["holding",{"2":{"2":1,"6":1}}],["holds",{"2":{"1":1,"2":3}}],["hold",{"2":{"1":6}}],["height=relative",{"2":{"38":1}}],["help",{"2":{"12":1}}],["header",{"2":{"2":3}}],["heatmap",{"2":{"1":1,"2":4,"34":1,"38":4,"39":1,"40":2,"49":1,"50":3}}],["heterogeneity",{"2":{"1":1}}],["here",{"2":{"1":3,"2":1,"9":1,"26":1,"36":1,"38":1,"42":1,"49":4,"50":1}}],["history",{"2":{"42":2}}],["hidden",{"2":{"2":1}}],["hideydecorations",{"2":{"39":1}}],["hidexdecorations",{"2":{"39":1}}],["hide",{"2":{"1":7}}],["highlighted",{"2":{"50":1}}],["highlight",{"2":{"50":1}}],["high",{"2":{"1":6,"2":1,"26":1,"38":1,"40":1}}],["happens",{"2":{"50":1}}],["had",{"2":{"6":1}}],["handling",{"2":{"1":1}}],["handled",{"2":{"1":1}}],["handle",{"2":{"1":3,"25":2,"47":1}}],["habitat",{"2":{"1":1}}],["habitatheterogeneity",{"2":{"1":7,"39":2}}],["having",{"2":{"1":3}}],["have",{"2":{"1":13,"2":4,"9":1,"11":1,"12":3,"25":1,"28":1,"29":1,"42":1,"44":1,"49":4,"50":2}}],["haschunks",{"2":{"2":1}}],["has",{"2":{"1":10,"15":1,"36":1,"42":2,"49":1,"50":2}}],["hdf5",{"2":{"1":1,"2":1,"14":1,"15":1,"28":1}}],["j",{"2":{"39":2}}],["json3",{"2":{"18":2}}],["january",{"2":{"1":3,"38":1}}],["join",{"2":{"1":1,"30":1}}],["joined",{"2":{"1":2}}],["june",{"2":{"50":3}}],["just",{"2":{"1":4,"2":2,"4":1,"26":1,"28":1,"29":2,"36":1,"49":1,"50":2}}],["juliax",{"2":{"49":1}}],["julianorway",{"2":{"48":2}}],["julianp",{"2":{"48":1}}],["julianewstack",{"2":{"5":1}}],["juliadp",{"2":{"48":1}}],["juliadisaggregate",{"2":{"1":2}}],["juliafunction",{"2":{"48":1}}],["juliafig",{"2":{"35":1}}],["juliafilearray",{"2":{"2":1}}],["juliafilestack",{"2":{"2":1}}],["juliafiles",{"2":{"1":1}}],["juliawrite",{"2":{"44":1,"48":1}}],["juliawarp",{"2":{"1":1}}],["julialayers",{"2":{"39":1}}],["julialon",{"2":{"23":1}}],["juliaopen",{"2":{"2":1,"5":1}}],["juliaopenstack",{"2":{"2":1}}],["juliazonal",{"2":{"1":1}}],["juliatrim",{"2":{"1":1}}],["juliascandinavia",{"2":{"48":1}}],["juliasp",{"2":{"48":1}}],["juliashapes",{"2":{"47":1}}],["juliastack",{"2":{"36":1}}],["julias",{"2":{"2":3,"11":1}}],["juliaskipmissing",{"2":{"2":1}}],["juliaslice",{"2":{"1":1}}],["juliaset",{"2":{"9":1}}],["juliasetmappedcrs",{"2":{"1":1}}],["juliasetcrs",{"2":{"1":1}}],["juliaras",{"2":{"24":3,"25":1,"49":1}}],["juliarasterdiskarray",{"2":{"2":1}}],["juliarasterize",{"2":{"1":2}}],["juliarasters",{"2":{"2":1,"38":1}}],["juliarasterstack",{"2":{"1":1}}],["juliarasterseries",{"2":{"1":2}}],["juliaraster",{"2":{"1":1}}],["juliarecords",{"2":{"18":1}}],["juliaread",{"2":{"2":2}}],["juliaresample",{"2":{"1":1}}],["juliareproject",{"2":{"1":2}}],["juliareplace",{"2":{"1":1,"8":1}}],["juliap",{"2":{"48":1}}],["juliapredictors",{"2":{"20":1}}],["juliaprojected",{"2":{"1":1}}],["juliapoints",{"2":{"1":1}}],["juliaextract",{"2":{"1":1}}],["juliaextend",{"2":{"1":1}}],["juliacheckmem",{"2":{"2":1}}],["juliacrop",{"2":{"1":1}}],["juliacrs",{"2":{"1":1}}],["juliacoords",{"2":{"19":1}}],["juliacoverage",{"2":{"1":2}}],["juliaconvertlookup",{"2":{"1":1}}],["juliacombine",{"2":{"1":1}}],["juliaclassify",{"2":{"1":2}}],["juliacellarea",{"2":{"1":1,"49":2}}],["juliab",{"2":{"7":1}}],["juliabase",{"2":{"2":4}}],["juliabanddim",{"2":{"1":1}}],["juliaband",{"2":{"1":1}}],["juliaboolmask",{"2":{"1":1}}],["juliausing",{"2":{"1":21,"4":1,"9":1,"14":1,"16":1,"18":1,"20":3,"22":2,"26":1,"28":1,"35":1,"39":1,"40":1,"41":1,"42":3,"43":1,"46":1,"47":1,"49":4}}],["juliaa",{"2":{"5":1,"7":1,"20":1,"42":1,"44":1}}],["juliaabstractprojected",{"2":{"2":1}}],["juliaabstractrasterstack",{"2":{"1":1}}],["juliaabstractrasterseries",{"2":{"1":1}}],["juliaabstractraster",{"2":{"1":1}}],["juliaaggregate",{"2":{"1":2}}],["juliamean",{"2":{"4":1}}],["juliamosaic",{"2":{"1":2}}],["juliamodify",{"2":{"1":1}}],["juliamissingval",{"2":{"1":1}}],["juliamissingmask",{"2":{"1":1}}],["juliamakie",{"2":{"36":1,"37":1,"38":2}}],["juliamask",{"2":{"1":2,"47":1}}],["juliamappedindex",{"2":{"1":1}}],["juliamappedcrs",{"2":{"1":1}}],["juliamappedbounds",{"2":{"1":1}}],["juliamapped",{"2":{"1":1}}],["juliajulia>",{"2":{"1":2}}],["juliagdalarray",{"2":{"1":1}}],["julia",{"2":{"1":1,"2":1,"3":1,"20":1,"22":1,"27":1,"28":1,"31":1,"39":1}}],["jl",{"0":{"16":1,"47":1,"48":1},"2":{"1":47,"2":4,"9":1,"10":1,"12":1,"13":1,"16":3,"17":2,"19":1,"20":1,"22":2,"25":1,"26":1,"28":1,"29":3,"38":1,"40":3,"42":2,"44":2,"45":1,"47":1,"48":1,"49":2,"50":3}}],["ignore",{"2":{"1":4,"2":2}}],["ignored",{"2":{"1":1,"2":1}}],["image",{"2":{"39":1}}],["imola",{"2":{"1":1}}],["improve",{"2":{"2":2}}],["implemented",{"2":{"1":1,"15":1}}],["implementation",{"2":{"1":2}}],["implementations",{"2":{"1":1}}],["important",{"2":{"50":1}}],["import",{"2":{"1":1}}],["irregular",{"2":{"1":3}}],["i",{"2":{"1":2,"2":4,"20":1,"38":3,"39":6,"48":1,"49":2}}],["ie",{"2":{"1":1}}],["if",{"2":{"1":78,"2":37,"4":1,"6":1,"7":1,"19":1,"23":2,"29":1,"33":1,"38":7,"40":1,"42":1,"48":1,"49":4,"50":2}}],["identically",{"2":{"1":1}}],["identical",{"2":{"1":4}}],["inaccurate",{"2":{"49":1}}],["input",{"2":{"38":2,"49":1}}],["inputs",{"2":{"1":1}}],["invoke",{"2":{"40":1}}],["involves",{"2":{"29":1}}],["invert",{"2":{"1":8}}],["info",{"2":{"26":1,"31":1}}],["information",{"2":{"1":3,"17":1}}],["inf",{"2":{"4":4,"5":6}}],["indices",{"2":{"24":1,"26":2,"42":1}}],["indicates",{"2":{"2":1,"38":1}}],["individually",{"2":{"2":2}}],["individual",{"2":{"1":1,"2":1,"14":1,"48":1}}],["independently",{"2":{"1":1}}],["indexing",{"2":{"5":1}}],["indexed",{"2":{"1":3,"2":1,"4":1,"22":1}}],["index",{"0":{"0":1,"24":1},"2":{"1":19,"2":3,"24":1,"25":1,"26":4,"42":1,"49":2}}],["indonesian",{"2":{"1":1}}],["indonesia",{"2":{"1":7}}],["installation",{"0":{"27":1}}],["install",{"0":{"22":1}}],["instead",{"2":{"1":5,"2":1,"9":1,"40":1,"42":2}}],["insertcols",{"2":{"1":1}}],["inside",{"2":{"1":18}}],["including",{"2":{"1":4}}],["includes",{"2":{"48":1}}],["included",{"2":{"1":4,"48":1}}],["include",{"2":{"1":9,"29":1}}],["increase",{"2":{"1":1}}],["increases",{"2":{"1":2}}],["incorrectly",{"2":{"6":1}}],["incorrect",{"2":{"1":6,"49":1}}],["int16",{"2":{"47":2,"48":1}}],["int64",{"2":{"18":4,"22":2,"23":1,"24":6,"25":2,"49":4}}],["into",{"2":{"1":12,"16":1,"29":1,"30":1,"31":1,"48":1,"50":1}}],["intended",{"2":{"28":1}}],["integrated",{"2":{"16":1}}],["integration",{"0":{"16":1}}],["integer",{"2":{"1":6}}],["integers",{"2":{"1":5}}],["interesting",{"2":{"50":1}}],["interpreted",{"2":{"36":1}}],["interpolation",{"2":{"1":1}}],["interface",{"2":{"1":1,"17":1,"36":1}}],["intervalsets",{"2":{"1":1}}],["intervals",{"2":{"1":3,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"35":2,"39":2,"42":6,"47":4,"48":3,"49":9}}],["interval",{"2":{"1":5,"24":1,"26":1,"42":2,"49":1}}],["internal",{"0":{"2":1},"2":{"1":2,"2":3}}],["int",{"2":{"1":24,"2":9}}],["in",{"0":{"34":1,"35":1,"36":1},"2":{"1":176,"2":13,"5":1,"9":1,"12":2,"14":1,"15":3,"16":1,"17":1,"19":2,"20":1,"26":2,"28":3,"29":2,"30":1,"31":2,"33":1,"34":1,"36":3,"38":1,"39":4,"40":1,"42":5,"44":1,"45":1,"48":1,"49":14,"50":9}}],["inherit",{"2":{"1":1}}],["issue",{"2":{"29":3}}],["issues",{"2":{"1":19,"12":1,"29":3,"49":1}}],["isn",{"2":{"29":1}}],["ismissing",{"2":{"19":1}}],["islands",{"2":{"1":6,"48":1,"50":1}}],["island",{"2":{"1":2}}],["isfile",{"2":{"1":5}}],["is",{"2":{"1":217,"2":28,"4":2,"9":1,"12":2,"13":1,"14":1,"16":1,"22":1,"23":2,"24":1,"25":3,"26":2,"29":1,"33":1,"34":1,"35":2,"36":2,"38":2,"40":3,"44":1,"48":1,"49":8,"50":9}}],["itr",{"2":{"2":1}}],["iteratively",{"2":{"1":1}}],["iterator",{"2":{"1":2}}],["iterable",{"2":{"1":8,"2":1}}],["iterables",{"2":{"1":1}}],["it",{"2":{"1":51,"2":21,"9":1,"28":2,"29":7,"33":1,"36":1,"38":1,"40":1,"42":5,"48":1,"49":5,"50":5}}],["itself",{"2":{"1":1}}],["its",{"2":{"1":2,"2":1,"28":1,"29":1,"38":1}}],["wgs",{"2":{"4":6,"5":3,"7":3,"8":3,"9":6,"20":3,"35":3,"39":3,"47":6,"48":3}}],["www",{"2":{"2":2,"42":1}}],["wc2",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["wc",{"2":{"1":10}}],["well",{"2":{"28":1,"50":1}}],["wellknowntext",{"2":{"1":1}}],["were",{"2":{"4":1,"15":1}}],["web",{"2":{"2":2,"29":1}}],["weighted",{"2":{"1":2}}],["wether",{"2":{"1":3}}],["we",{"2":{"1":6,"2":3,"4":1,"5":2,"9":2,"17":1,"20":1,"28":1,"29":9,"36":1,"40":1,"42":4,"44":1,"45":1,"47":2,"48":2,"49":10,"50":17}}],["wrong",{"2":{"2":1}}],["writing",{"0":{"15":1},"2":{"1":5,"2":6,"33":1}}],["written",{"2":{"1":7,"2":6,"15":2}}],["writes",{"2":{"2":2}}],["write=false",{"2":{"2":1}}],["write=true",{"2":{"1":2,"2":1,"5":1}}],["write",{"0":{"33":1,"44":1},"2":{"1":15,"2":24,"5":1,"15":2,"20":2,"33":2,"44":1,"48":3}}],["wrapping",{"2":{"2":4,"23":1}}],["wrapped",{"2":{"1":1,"2":1}}],["wrapper",{"2":{"1":2,"2":3}}],["wraper",{"2":{"1":1}}],["wrap",{"2":{"1":1}}],["worst",{"2":{"1":1}}],["world",{"2":{"1":2,"50":1}}],["worldclim",{"2":{"1":20,"4":3,"5":1,"7":2,"8":1,"9":2,"16":1,"20":1,"26":1,"28":1,"35":2,"36":1,"38":2,"40":1,"41":1,"47":2,"50":2}}],["workflow",{"0":{"17":1},"1":{"18":1,"19":1,"20":1},"2":{"50":1}}],["works",{"2":{"4":1,"9":1,"34":1}}],["working",{"2":{"2":1,"29":1,"49":1,"50":1}}],["work",{"2":{"1":7,"2":2,"3":1,"25":1,"26":1,"28":1,"29":1,"31":1,"35":1,"48":1}}],["would",{"2":{"1":2,"4":1}}],["want",{"2":{"1":1,"49":2}}],["way",{"2":{"1":3,"2":1,"26":1,"36":1,"40":1}}],["warned",{"2":{"1":1,"49":1}}],["warnings",{"2":{"1":2}}],["warning",{"2":{"1":19,"36":1,"49":1}}],["warped",{"2":{"1":2}}],["warp",{"2":{"0":1,"1":8,"30":1}}],["was",{"2":{"1":2,"28":2,"50":1}}],["wildly",{"2":{"49":1}}],["will",{"2":{"1":97,"2":22,"4":1,"5":1,"7":1,"9":3,"10":1,"12":1,"22":1,"25":1,"40":5,"42":2,"45":1,"48":2,"49":3}}],["wind",{"2":{"47":5,"48":4}}],["windowed",{"2":{"1":1}}],["width=5",{"2":{"38":1}}],["width",{"2":{"2":1,"38":1,"39":5}}],["wish",{"2":{"2":1}}],["within",{"2":{"26":1}}],["with=poly",{"2":{"47":1}}],["with=maskfile",{"2":{"2":1}}],["with=wc",{"2":{"1":2}}],["without",{"2":{"1":6,"12":1,"14":1,"29":2}}],["with",{"0":{"38":1,"48":1},"2":{"1":83,"2":17,"4":2,"5":1,"7":1,"8":1,"9":3,"14":1,"15":1,"16":1,"22":1,"25":4,"26":1,"29":2,"34":1,"35":1,"38":1,"39":1,"40":2,"42":4,"45":1,"47":1,"48":3,"49":1,"50":3}}],["why",{"2":{"50":1}}],["what",{"2":{"49":2,"50":1}}],["whatever",{"2":{"1":1,"29":1}}],["whose",{"2":{"2":1,"38":1}}],["whole",{"2":{"1":3}}],["whether",{"2":{"1":4,"2":3,"38":1,"49":1}}],["wherever",{"2":{"1":2}}],["where",{"2":{"1":46,"2":1,"15":1,"25":2,"26":2,"28":1,"48":1,"49":2}}],["when",{"2":{"1":66,"2":3,"4":2,"5":2,"28":1,"29":1,"44":1,"48":1,"50":1}}],["while",{"2":{"1":1}}],["which",{"2":{"1":28,"2":6,"5":1,"9":1,"10":1,"11":1,"13":1,"36":3,"38":3,"40":1,"42":1,"48":1,"49":3,"50":1}}],["tutorial",{"0":{"49":1},"1":{"50":1}}],["tuples",{"2":{"1":3}}],["tuple",{"2":{"1":64,"2":6,"18":2,"19":2,"20":20}}],["text",{"2":{"36":1}}],["template",{"2":{"29":2}}],["temperatures",{"2":{"42":1}}],["temperature",{"2":{"7":2,"14":1,"42":4,"44":1}}],["tempname",{"2":{"1":1}}],["tempfile",{"2":{"1":4}}],["tempory",{"2":{"1":1}}],["temp=",{"2":{"1":1}}],["temp",{"2":{"1":2}}],["typing",{"0":{"22":1}}],["typically",{"2":{"2":1}}],["typename",{"2":{"2":2}}],["types",{"2":{"2":3,"29":1,"48":1}}],["type",{"2":{"1":7,"2":8,"15":1,"38":3}}],["two",{"2":{"1":2,"26":1,"40":1}}],["twice",{"2":{"1":2}}],["tmax",{"2":{"1":3,"47":5,"48":4}}],["tmin",{"2":{"1":2,"47":5,"48":4}}],["t",{"2":{"1":3,"2":5,"9":1,"29":1,"42":2,"44":1,"50":1}}],["target",{"2":{"1":1}}],["tavg",{"2":{"1":3,"16":1}}],["tabular",{"2":{"1":1}}],["table",{"0":{"32":1},"2":{"1":18,"18":1,"20":1}}],["tables",{"2":{"1":18}}],["take",{"2":{"2":1,"3":1,"26":1,"29":1,"38":1,"42":1,"48":1}}],["takes",{"2":{"1":2}}],["taken",{"2":{"1":4}}],["taking",{"2":{"1":3,"13":1}}],["tickalign",{"2":{"39":4}}],["tickalign=1",{"2":{"39":1}}],["ticks=false",{"2":{"39":2}}],["ticksize",{"2":{"39":5}}],["tiled",{"2":{"36":1,"40":1}}],["ti=at",{"2":{"25":1}}],["ti=1",{"2":{"24":1,"42":1}}],["tightly",{"2":{"16":1}}],["titles",{"2":{"2":1,"38":1}}],["title",{"2":{"2":1,"38":1,"39":1,"50":1}}],["ti",{"2":{"1":7,"4":1,"12":1,"22":6,"24":4,"25":1,"42":5,"44":1}}],["tif",{"2":{"1":8,"4":2,"5":1,"7":1,"8":1,"9":2,"13":2,"35":1,"48":6}}],["tifs",{"2":{"1":1}}],["tiff",{"2":{"1":2,"2":4,"13":1}}],["timespan",{"2":{"42":1}}],["time",{"0":{"4":1},"2":{"1":4,"4":1,"22":1,"24":1,"25":1,"28":1,"29":2,"36":1,"42":4,"48":1}}],["trace",{"2":{"29":1}}],["transect",{"2":{"44":1}}],["transparent",{"2":{"2":2,"38":2,"39":2}}],["transformations",{"2":{"28":1}}],["transformation",{"2":{"1":1,"49":1}}],["transforming",{"2":{"1":1,"49":1}}],["transferred",{"2":{"1":1}}],["tr",{"2":{"1":2}}],["trigger",{"2":{"29":1}}],["triggers",{"2":{"1":1,"29":1}}],["trims",{"2":{"30":1}}],["trimming",{"2":{"1":1}}],["trimmed",{"2":{"1":3,"39":1}}],["trim",{"2":{"0":1,"1":10,"30":1,"39":2,"47":7,"48":1}}],["try",{"2":{"1":1,"9":1,"49":1}}],["true",{"2":{"1":38,"2":18,"18":1,"38":1,"49":1}}],["treated",{"2":{"1":11,"25":1,"36":1}}],["together",{"2":{"45":1}}],["tos",{"2":{"42":5,"43":1,"44":3}}],["toy",{"2":{"22":1}}],["top",{"2":{"2":1,"38":1}}],["touch",{"2":{"1":2}}],["touches=false",{"2":{"1":1}}],["touches",{"2":{"1":13}}],["tolerances",{"2":{"1":2}}],["tolerance",{"2":{"1":3}}],["to=b",{"2":{"1":1}}],["to=first",{"2":{"1":1}}],["to=awap",{"2":{"1":2}}],["to=rnge",{"2":{"1":1}}],["to=shp",{"2":{"1":1}}],["to=nz",{"2":{"1":1}}],["total",{"2":{"1":2,"50":8}}],["to",{"0":{"15":1,"33":1,"44":1},"2":{"1":321,"2":57,"4":1,"5":5,"6":1,"7":1,"9":6,"10":2,"12":1,"15":2,"16":2,"17":1,"19":1,"20":3,"22":2,"25":4,"26":4,"28":5,"29":9,"30":5,"33":5,"34":1,"36":1,"38":8,"39":1,"40":4,"42":4,"44":1,"45":1,"48":5,"49":11,"50":12}}],["things",{"2":{"2":1}}],["third",{"2":{"1":2,"2":1,"38":1,"42":1}}],["this",{"2":{"1":64,"2":9,"5":1,"9":1,"17":1,"22":2,"28":2,"29":1,"35":1,"36":2,"38":4,"40":1,"42":1,"45":1,"49":11,"50":9}}],["three",{"2":{"29":1}}],["thread",{"2":{"1":4}}],["threadsafe=true",{"2":{"1":1}}],["threadsafe",{"2":{"1":7}}],["threading",{"2":{"1":6}}],["threaded=false",{"2":{"1":1}}],["threaded",{"2":{"1":20}}],["through",{"2":{"1":1,"2":1,"30":1}}],["than",{"2":{"1":7,"15":2,"34":1,"42":1}}],["that",{"0":{"30":1,"31":1},"2":{"1":64,"2":9,"3":1,"6":1,"9":2,"12":1,"15":1,"16":1,"22":1,"29":7,"31":1,"36":1,"38":1,"42":1,"48":1,"49":7,"50":9}}],["then",{"2":{"1":2,"2":1,"4":1,"7":1,"20":1,"22":1,"29":2,"38":1,"42":1,"45":1,"47":2,"50":2}}],["theme",{"0":{"37":1},"1":{"38":1,"39":1},"2":{"36":3,"37":1,"38":4,"39":2}}],["theming",{"2":{"36":1}}],["themselves",{"2":{"2":1}}],["them",{"2":{"1":5,"2":1,"20":2,"25":1,"29":2,"48":1}}],["there",{"2":{"1":6,"2":1,"29":3,"48":1}}],["these",{"2":{"1":13,"2":2,"13":1,"14":1,"20":1,"25":1,"31":1,"38":1,"48":2,"49":1}}],["their",{"2":{"1":1,"47":1}}],["they",{"2":{"1":6,"2":1,"11":2,"15":2,"25":1,"29":2}}],["the",{"0":{"4":1,"22":1,"23":1,"30":1,"46":1},"1":{"47":1,"48":1},"2":{"1":509,"2":114,"3":1,"4":2,"5":4,"6":2,"7":3,"9":4,"12":3,"13":2,"14":2,"15":1,"16":4,"17":2,"19":1,"22":2,"24":1,"25":4,"26":13,"28":2,"29":14,"30":4,"33":2,"34":1,"36":1,"38":42,"39":2,"40":7,"42":10,"44":3,"45":2,"47":2,"48":6,"49":41,"50":38}}],["ocean",{"2":{"42":1,"44":1}}],["occurs",{"2":{"5":1}}],["occurrences",{"2":{"17":1}}],["occurrence",{"2":{"1":3,"18":2,"20":1}}],["occur",{"2":{"1":24,"29":1,"49":1}}],["o1",{"2":{"42":2}}],["o",{"2":{"5":2}}],["omitted",{"2":{"1":1,"18":1}}],["obtain",{"2":{"1":1,"40":1}}],["observable",{"2":{"38":2}}],["observables",{"0":{"38":1}}],["observation",{"2":{"1":1}}],["obs",{"2":{"1":2,"38":3}}],["obj",{"2":{"1":10}}],["object",{"0":{"6":1,"26":1,"30":1},"1":{"7":1,"8":1,"9":1},"2":{"1":41,"2":10,"6":2,"9":1,"18":1,"26":1,"30":4,"31":2,"32":1,"44":1}}],["objects",{"0":{"31":1},"2":{"1":17,"2":5,"9":1,"26":2,"30":2,"33":3,"42":2}}],["our",{"2":{"1":1,"29":1,"42":1}}],["outside",{"2":{"1":2,"50":1}}],["output",{"2":{"1":29,"22":1,"49":1}}],["out",{"2":{"1":6,"38":1,"39":1,"48":1}}],["opacity=0",{"2":{"20":1}}],["op",{"2":{"1":5}}],["optionally",{"2":{"1":1}}],["options",{"2":{"1":1,"2":6,"25":1}}],["optimisations",{"2":{"1":3}}],["opbject",{"2":{"1":1}}],["operation",{"0":{"32":1},"2":{"1":8,"2":1}}],["operations",{"0":{"3":1},"1":{"4":1,"5":1,"6":1,"7":1,"8":1,"9":1},"2":{"1":5,"2":1,"12":1}}],["opens",{"2":{"2":1}}],["openstack",{"2":{"0":1,"2":3}}],["openinterval",{"2":{"1":1}}],["open",{"2":{"1":6,"2":11,"5":1,"33":2}}],["opened",{"2":{"1":3,"2":3}}],["otherwise",{"2":{"1":10,"12":1}}],["others=0",{"2":{"1":2}}],["others=nothing",{"2":{"1":1}}],["others",{"2":{"1":9}}],["other",{"2":{"1":20,"2":8,"14":1,"15":1,"25":1,"26":1,"28":1,"29":1,"31":1,"36":1,"42":2,"48":1}}],["overridden",{"2":{"2":1}}],["overlap",{"2":{"1":2,"48":1}}],["overlapping",{"2":{"1":2}}],["over",{"0":{"4":1},"2":{"1":12,"2":1,"4":2,"5":1,"29":1,"42":1,"48":1,"50":2}}],["onwards",{"2":{"28":1}}],["ones",{"2":{"49":1}}],["one",{"2":{"1":9,"2":4,"9":2,"42":3,"49":1}}],["on",{"2":{"1":27,"2":5,"9":1,"16":1,"20":1,"25":1,"26":1,"28":1,"29":3,"30":1,"33":1,"38":2,"40":3,"42":2,"49":7,"50":2}}],["only",{"2":{"1":29,"2":5,"4":1,"5":1,"9":1,"28":1,"40":1,"42":2,"50":2}}],["offset",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["of=countries",{"2":{"1":1}}],["often",{"2":{"1":9,"2":1,"29":1}}],["of",{"0":{"30":1},"2":{"1":224,"2":50,"4":2,"5":2,"6":1,"7":2,"8":1,"9":5,"10":1,"14":1,"16":1,"19":1,"24":1,"25":1,"26":3,"29":4,"30":3,"35":1,"36":1,"38":20,"39":1,"40":2,"42":4,"44":1,"48":3,"49":12,"50":8}}],["org",{"2":{"2":4}}],["original",{"2":{"1":4,"2":3,"42":4}}],["order=autoorder",{"2":{"1":2}}],["order",{"2":{"1":14}}],["or",{"0":{"30":1},"2":{"1":296,"2":35,"5":1,"6":1,"7":1,"15":1,"16":1,"20":1,"22":1,"24":2,"28":1,"29":4,"30":5,"31":2,"32":1,"33":1,"34":1,"36":1,"38":8,"40":2,"44":1,"49":4}}],["flipaxis",{"2":{"39":3}}],["fletcher32",{"2":{"2":2}}],["flexible",{"2":{"1":1}}],["flag",{"2":{"1":1}}],["flags",{"2":{"1":4}}],["float",{"2":{"1":2}}],["floating",{"2":{"1":5}}],["float32",{"2":{"1":5,"4":2,"5":1,"7":1,"8":1,"9":2,"20":84,"35":1,"42":2,"47":6,"48":3}}],["float64",{"2":{"1":8,"4":7,"5":4,"7":4,"8":4,"9":8,"18":2,"19":2,"20":44,"22":1,"24":3,"25":1,"35":4,"39":4,"42":4,"47":8,"48":2,"49":5}}],["framerate",{"2":{"38":1}}],["fraction",{"2":{"1":2}}],["from",{"0":{"23":1},"2":{"1":67,"2":14,"4":1,"9":1,"12":2,"13":1,"17":1,"25":1,"26":1,"28":1,"32":1,"33":1,"38":1,"42":1,"47":1,"48":1,"49":1,"50":2}}],["features",{"2":{"1":2}}],["feature",{"2":{"1":24,"49":1}}],["f",{"2":{"1":15,"2":3,"26":1,"50":1}}],["fundamentally",{"2":{"50":1}}],["functionality",{"2":{"28":2}}],["function",{"2":{"1":17,"2":1,"4":1,"5":1,"26":2,"29":1,"30":1,"34":1,"40":3,"48":2,"50":2}}],["functions",{"0":{"1":1,"2":1},"2":{"1":10,"40":1,"42":1}}],["fully",{"2":{"1":1,"40":1,"49":1}}],["future",{"2":{"1":21,"49":1}}],["far",{"2":{"50":1}}],["fast",{"2":{"11":1}}],["fastest",{"2":{"1":1}}],["faster",{"2":{"1":9,"49":1}}],["fall",{"2":{"42":1}}],["falls",{"2":{"26":1}}],["fallback",{"2":{"2":2,"44":1}}],["falling",{"2":{"1":1}}],["false",{"2":{"1":25,"2":11,"39":1}}],["fail",{"2":{"1":1}}],["fact",{"2":{"49":1}}],["factor",{"2":{"1":4}}],["facility",{"2":{"17":1}}],["facilitate",{"2":{"1":1}}],["following",{"2":{"22":1}}],["focus",{"2":{"16":1}}],["fo",{"2":{"1":1}}],["found",{"2":{"1":2,"2":2}}],["forward",{"2":{"40":1}}],["forwardordered",{"2":{"1":4,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"22":3,"23":1,"24":7,"25":2,"35":1,"39":1,"42":6,"47":2,"48":1,"49":6}}],["foreach",{"2":{"20":1}}],["form",{"2":{"1":1}}],["formats",{"0":{"15":1},"2":{"15":3}}],["format",{"2":{"1":3,"14":1,"20":1}}],["forced",{"2":{"2":1}}],["force",{"2":{"1":10,"2":15}}],["for",{"2":{"1":138,"2":25,"3":1,"5":1,"10":1,"12":1,"14":2,"15":2,"16":3,"17":1,"19":1,"25":2,"28":3,"29":3,"30":3,"31":1,"32":1,"33":1,"34":1,"36":1,"38":6,"39":4,"40":4,"44":1,"48":3,"49":4,"50":4}}],["five",{"2":{"49":1}}],["figure",{"2":{"39":3}}],["fig",{"2":{"35":4,"38":2,"39":10}}],["fixing",{"2":{"29":1}}],["fixed",{"2":{"29":1}}],["fix",{"2":{"29":3}}],["fix2",{"2":{"1":9}}],["finally",{"2":{"28":1}}],["findfirst",{"2":{"50":1}}],["find",{"2":{"26":1,"29":1}}],["finished",{"2":{"28":1}}],["finish",{"2":{"2":1}}],["field",{"2":{"1":1,"9":1}}],["fields",{"2":{"1":6,"6":1}}],["filter",{"2":{"2":2,"26":1}}],["filled",{"2":{"40":1,"42":1}}],["fillvalue",{"2":{"2":3,"42":2}}],["fillalpha=0",{"2":{"1":2,"48":1}}],["fill=1",{"2":{"1":2}}],["fill",{"2":{"1":12}}],["fills",{"2":{"1":2}}],["filepaths",{"2":{"1":1}}],["filepath",{"2":{"1":6,"2":6,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["file",{"0":{"15":1},"2":{"1":45,"2":23,"5":1,"6":1,"12":2,"15":1,"20":1,"29":7,"30":1,"33":1,"42":2,"48":3,"49":1}}],["files",{"2":{"1":18,"2":7,"6":1,"11":1,"12":3,"13":2,"15":1,"22":1,"28":1,"29":1,"40":1,"45":1}}],["filestack",{"2":{"0":1,"2":2}}],["filenames",{"2":{"1":5}}],["filename",{"2":{"1":34,"2":20,"5":1,"12":2,"13":2,"14":2,"15":1,"42":2}}],["filearray",{"2":{"0":1,"1":2,"2":3}}],["fit",{"2":{"1":1}}],["first",{"2":{"1":22,"12":1,"14":1,"29":1,"42":3,"45":1,"48":4,"49":1,"50":3}}],["sweden",{"2":{"47":4,"48":5}}],["swapping",{"2":{"1":1}}],["squished",{"2":{"36":1}}],["squared",{"2":{"50":1}}],["square",{"2":{"1":7,"50":6}}],["smaller",{"2":{"36":1}}],["smallest",{"2":{"1":2}}],["smapseries",{"2":{"14":1}}],["smap",{"0":{"14":1},"2":{"15":1,"28":1}}],["sciences",{"2":{"16":1}}],["screen",{"2":{"39":1}}],["scr",{"2":{"2":1}}],["scandinavia",{"2":{"48":10}}],["scandinavian",{"2":{"45":1}}],["scatter",{"2":{"20":2}}],["scarborough",{"2":{"1":1}}],["scale^2",{"2":{"1":2}}],["scale",{"2":{"1":27,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["snap",{"2":{"1":1,"30":1}}],["skewed",{"2":{"1":1}}],["skipping",{"2":{"2":1}}],["skipped",{"2":{"1":2}}],["skip",{"2":{"1":1}}],["skipmissing=true",{"2":{"1":1}}],["skipmissingval=false",{"2":{"1":1}}],["skipmissingval=true",{"2":{"1":1}}],["skipmissingval",{"2":{"1":2}}],["skipmissing",{"2":{"1":4,"2":1,"50":4}}],["slow",{"2":{"1":1}}],["slicing",{"2":{"1":1}}],["slices",{"2":{"1":3}}],["sliced",{"2":{"1":5,"42":1}}],["slice",{"2":{"0":1,"1":6,"24":1}}],["src",{"2":{"1":10,"2":4}}],["s",{"2":{"1":12,"2":7,"9":1,"14":1,"26":2,"29":1,"49":2,"50":9}}],["system",{"2":{"1":10,"34":1,"49":1,"50":1}}],["symbols",{"2":{"2":1,"38":1}}],["symbol",{"2":{"1":32,"2":6}}],["syntax",{"2":{"1":2,"16":1,"24":1,"48":1}}],["safe",{"2":{"1":4,"2":1}}],["sa",{"2":{"1":6}}],["saved",{"2":{"2":2}}],["savefig",{"2":{"1":24}}],["save",{"2":{"1":3,"2":2,"39":1,"42":1,"48":1}}],["sample",{"2":{"1":5}}],["sampled",{"2":{"1":6,"22":3,"23":1,"24":7,"25":2,"42":2}}],["sampling=intervals",{"2":{"1":4,"49":2}}],["sampling=autosampling",{"2":{"1":2}}],["sampling",{"2":{"1":2,"49":5}}],["same",{"2":{"1":11,"6":1,"12":1,"29":1,"30":1,"38":2,"48":1,"49":1}}],["sure",{"2":{"29":2,"40":1,"50":1}}],["surface",{"2":{"2":1,"34":2,"35":1,"38":1,"40":2,"42":4,"44":1}}],["subtle",{"2":{"29":2}}],["subplot=i",{"2":{"20":1,"48":1}}],["subplots",{"2":{"20":1,"48":1}}],["subarray",{"2":{"18":1}}],["substrin",{"2":{"1":1}}],["subsetting",{"0":{"26":1}}],["subset",{"2":{"1":1,"20":1,"25":1,"26":1}}],["subdivision",{"2":{"1":2}}],["summed",{"2":{"1":2}}],["sum",{"2":{"1":23,"50":5}}],["suffix",{"2":{"1":19,"2":2}}],["such",{"2":{"1":11,"2":5,"3":1,"13":1,"31":1,"50":1}}],["supports",{"2":{"40":1}}],["supported",{"2":{"40":1}}],["support",{"2":{"38":1}}],["supplied",{"2":{"1":1}}],["supertype",{"2":{"1":3,"2":1}}],["sosstsst",{"2":{"42":2}}],["soil",{"2":{"14":2}}],["software",{"2":{"2":2,"42":1}}],["sovereign",{"2":{"1":1}}],["south",{"2":{"1":1,"20":1}}],["sources",{"0":{"10":1,"33":1},"1":{"11":1,"12":1,"13":1,"14":1,"15":1,"16":1},"2":{"1":2,"16":2,"28":1}}],["source",{"2":{"1":58,"2":27,"38":1,"49":1}}],["so",{"2":{"1":11,"2":1,"9":1,"16":1,"20":1,"22":1,"28":1,"29":4,"35":1,"42":1,"44":1,"49":2,"50":2}}],["somewhat",{"2":{"34":1}}],["something",{"2":{"22":1}}],["somelayer",{"2":{"1":2}}],["some",{"2":{"1":16,"2":1,"12":1,"15":2,"29":2,"36":1,"47":1,"49":1}}],["side",{"2":{"2":1,"38":1,"49":2}}],["sides",{"2":{"1":1}}],["since",{"2":{"1":1,"34":1,"40":1,"50":1}}],["sinc",{"2":{"1":1}}],["singleton",{"2":{"2":1,"38":1}}],["single",{"2":{"1":37,"2":3,"30":1,"45":1,"48":2}}],["silently",{"2":{"1":1}}],["size=",{"2":{"39":1,"43":1}}],["sizes",{"2":{"2":1,"30":2}}],["size",{"2":{"1":32,"2":10,"20":4,"30":1,"39":4,"47":8,"48":4,"49":1}}],["sized",{"2":{"1":1}}],["simple",{"0":{"40":1,"41":1},"2":{"1":5}}],["simply",{"2":{"1":3,"42":1,"49":1}}],["similarly",{"2":{"30":1,"40":1}}],["similar",{"2":{"1":1,"22":1,"40":1}}],["still",{"2":{"12":1,"42":1}}],["store",{"2":{"15":1}}],["stored",{"2":{"1":1,"2":4}}],["stores",{"2":{"1":1}}],["stereographic",{"2":{"49":1}}],["step",{"2":{"49":1}}],["steps",{"2":{"1":1,"29":1}}],["stem",{"2":{"1":1}}],["st",{"2":{"1":16,"39":2}}],["statistic",{"2":{"50":1}}],["statistics",{"2":{"1":9,"3":1,"4":1,"32":1,"42":1}}],["stats",{"2":{"1":2}}],["stage",{"2":{"1":1}}],["starting",{"2":{"49":1}}],["start",{"0":{"21":1},"1":{"22":1,"23":1,"24":1,"25":1,"26":1},"2":{"1":12,"4":4,"5":2,"7":2,"8":2,"9":3,"20":2,"35":2,"39":2,"47":4,"48":2,"49":13}}],["stack",{"2":{"1":33,"2":7,"5":2,"29":1,"30":2,"36":2,"38":4,"48":1}}],["stacks",{"2":{"1":8}}],["standardises",{"2":{"16":1}}],["standard",{"2":{"1":1,"31":1,"42":2}}],["strings",{"2":{"1":1,"2":1,"38":1}}],["string",{"2":{"1":23,"2":9,"4":2,"5":1,"7":1,"8":1,"9":2,"18":2,"35":1,"39":1,"42":2}}],["structures",{"2":{"1":1}}],["sp",{"2":{"48":1}}],["spratly",{"2":{"1":1}}],["spring",{"2":{"1":2}}],["spread",{"2":{"1":1}}],["spheroid",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["spherical",{"2":{"1":2,"49":5,"50":1}}],["sphere",{"2":{"1":2,"49":4}}],["speed",{"2":{"1":1}}],["speedups",{"2":{"1":5}}],["special",{"2":{"1":2}}],["species",{"0":{"18":1},"2":{"1":4,"17":1}}],["specify",{"2":{"1":3,"2":5,"9":2,"16":1,"25":1,"49":3}}],["specifying",{"2":{"1":4,"2":3,"49":1}}],["specific",{"2":{"2":7,"9":1,"28":1,"30":2}}],["specifically",{"2":{"1":1,"49":1}}],["specifies",{"2":{"1":2,"40":1}}],["specified",{"2":{"1":14,"6":1}}],["spline",{"2":{"1":1}}],["split",{"2":{"1":2}}],["splat",{"2":{"1":1}}],["splatted",{"2":{"1":2}}],["space",{"2":{"1":1,"26":1,"36":1}}],["spans",{"2":{"1":1,"25":1}}],["span=autospan",{"2":{"1":2}}],["span",{"2":{"1":2}}],["spatially",{"2":{"49":1}}],["spatial",{"2":{"1":6,"15":1,"22":2,"25":1,"44":1}}],["shrink",{"2":{"30":1}}],["shuffle",{"2":{"2":4}}],["shp",{"2":{"1":15,"46":2}}],["shapes",{"2":{"1":6,"47":6}}],["shapefile",{"0":{"46":1,"47":1},"1":{"47":1,"48":1},"2":{"1":31,"45":1,"46":5,"47":2}}],["shape=",{"2":{"1":1}}],["shape",{"2":{"1":9,"45":1,"48":1}}],["sharing",{"2":{"1":1}}],["shared",{"2":{"1":4}}],["share",{"2":{"1":2,"29":1}}],["shoudle",{"2":{"1":1}}],["should",{"2":{"1":15,"2":2,"38":3}}],["shortcuts",{"2":{"1":2}}],["show",{"2":{"1":10,"40":1,"49":1}}],["shown",{"2":{"1":1,"40":1}}],["sea",{"2":{"42":4}}],["search",{"2":{"1":1,"18":1}}],["second",{"2":{"28":1}}],["seconds",{"2":{"28":1}}],["se",{"2":{"20":3}}],["separated",{"2":{"1":1,"2":1}}],["separately",{"2":{"1":3}}],["separator",{"2":{"1":3}}],["seem",{"2":{"36":1}}],["seems",{"2":{"1":1}}],["see",{"2":{"1":3,"15":1,"16":1,"25":1,"49":2,"50":2}}],["serranilla",{"2":{"1":1}}],["ser",{"2":{"1":2}}],["series",{"2":{"1":19,"2":2,"36":1}}],["sense",{"2":{"1":1}}],["selecting",{"2":{"24":1}}],["selects",{"2":{"1":6}}],["select",{"0":{"24":1,"25":1},"2":{"1":12}}],["selectors",{"2":{"1":1,"26":3}}],["selector",{"2":{"1":10,"26":1}}],["sets",{"2":{"2":1,"38":1}}],["setting",{"2":{"2":1}}],["set",{"0":{"9":1},"2":{"1":14,"2":10,"9":6,"36":1,"37":1,"38":8,"40":1,"50":1}}],["setmappedcrs",{"2":{"0":1,"1":2,"9":1}}],["setcrs",{"2":{"0":1,"1":2,"9":1}}],["rs",{"2":{"18":1,"20":1,"26":1}}],["right",{"2":{"2":2,"29":1,"38":2}}],["rings",{"2":{"1":1}}],["r",{"2":{"1":3,"2":2,"11":1,"19":4}}],["rms",{"2":{"1":1}}],["rotl90",{"2":{"3":1}}],["rotations",{"2":{"3":1}}],["rotated",{"2":{"1":1}}],["root",{"2":{"1":1}}],["roughly",{"2":{"1":3,"39":1}}],["rowgap",{"2":{"39":1}}],["rows",{"2":{"1":3,"18":1}}],["row",{"2":{"1":3}}],["rnge",{"2":{"1":3}}],["rain",{"2":{"50":1}}],["rainfall",{"2":{"50":2}}],["ras",{"2":{"22":1,"23":2,"49":3}}],["rasterisation",{"2":{"1":2}}],["rasterized",{"2":{"1":2}}],["rasterize",{"2":{"0":2,"1":10,"32":2}}],["rasterdatasources",{"0":{"16":1},"2":{"1":21,"4":1,"16":4,"17":1,"18":1,"26":1,"28":2,"35":1,"39":1,"40":1,"41":1,"45":1,"47":2,"50":2}}],["rasterdiskarray",{"2":{"0":1,"2":2}}],["raster",{"2":{"0":1,"1":109,"2":32,"4":6,"5":6,"7":3,"8":2,"9":4,"10":2,"12":1,"13":1,"14":1,"16":4,"20":1,"22":3,"24":6,"25":2,"26":1,"28":1,"29":2,"31":1,"34":1,"35":4,"38":11,"39":1,"40":4,"41":1,"42":5,"47":3,"48":3,"49":14,"50":5}}],["rasterstacks",{"2":{"1":2,"36":1,"40":1,"48":1}}],["rasterstack",{"2":{"0":1,"1":57,"2":7,"5":1,"10":1,"12":1,"13":1,"14":1,"16":2,"20":2,"36":1,"38":5,"39":3,"40":1,"42":1,"47":3,"48":1}}],["rasterseries",{"2":{"0":1,"1":22,"10":1,"16":2,"48":1}}],["rasters",{"0":{"35":1,"36":1},"2":{"0":56,"1":106,"2":22,"4":3,"5":1,"7":1,"8":1,"9":3,"10":1,"14":1,"16":2,"18":3,"22":5,"25":2,"26":2,"27":1,"28":5,"29":3,"30":1,"35":2,"36":8,"38":6,"39":2,"40":5,"41":1,"42":3,"44":1,"45":1,"47":2,"48":1,"49":6,"50":1}}],["ratio",{"2":{"2":2}}],["rather",{"2":{"1":1}}],["raw",{"2":{"1":4,"46":1}}],["range",{"2":{"1":13,"39":3,"48":1,"49":1}}],["random",{"2":{"22":1,"44":1}}],["rand",{"2":{"1":1,"22":1,"49":1}}],["radius=",{"2":{"49":1}}],["radius",{"2":{"1":4,"49":5}}],["race",{"2":{"1":5}}],["runs",{"2":{"29":1}}],["running",{"2":{"1":4,"29":1}}],["run",{"2":{"1":8,"49":1}}],["rplot",{"2":{"0":2,"2":2,"36":3,"38":6,"40":1}}],["red",{"2":{"50":2}}],["reduced",{"2":{"28":1}}],["reduces",{"2":{"1":1}}],["reduce",{"2":{"1":2,"29":1}}],["reducer",{"2":{"1":9}}],["reducing",{"2":{"1":5}}],["remain",{"2":{"38":2}}],["rectangle",{"2":{"49":1}}],["recipes",{"2":{"40":1,"44":1}}],["recipe",{"2":{"34":1}}],["record",{"2":{"38":1}}],["records",{"2":{"19":1}}],["recognized",{"2":{"20":1}}],["reverseordered",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["reverse",{"2":{"3":1}}],["reversing",{"2":{"1":1}}],["reef",{"2":{"1":1}}],["re",{"2":{"1":1,"40":1,"49":2,"50":1}}],["region",{"2":{"1":1,"48":3}}],["regions",{"2":{"1":12}}],["regular",{"2":{"1":6,"2":1,"3":1,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"22":3,"23":1,"24":7,"25":2,"26":1,"31":1,"35":2,"39":2,"42":5,"47":4,"48":2,"49":6}}],["relies",{"2":{"49":1}}],["reliable",{"2":{"1":19,"49":1}}],["related",{"2":{"14":1}}],["relhum",{"2":{"1":2}}],["relhum=",{"2":{"1":1}}],["reasons",{"2":{"49":1}}],["reason",{"2":{"36":1}}],["reassign",{"2":{"9":1}}],["really",{"2":{"29":1,"50":1}}],["real",{"2":{"1":18}}],["reading",{"2":{"33":1}}],["reads",{"2":{"26":1}}],["read",{"2":{"1":13,"2":9,"5":1,"12":1,"22":1,"33":4,"48":1}}],["rebuild",{"0":{"7":1},"2":{"1":1,"6":1,"7":3,"9":1}}],["res=3000",{"2":{"40":1}}],["res=0",{"2":{"1":1}}],["reset",{"0":{"37":1},"1":{"38":1,"39":1},"2":{"38":1}}],["responsible",{"2":{"1":1}}],["resampling",{"2":{"1":17}}],["resamples",{"2":{"1":1}}],["resampled",{"2":{"1":1}}],["resample",{"2":{"0":1,"1":15,"30":2}}],["result",{"2":{"1":6}}],["results",{"2":{"1":6}}],["resulting",{"2":{"1":6}}],["resolution",{"0":{"30":1},"2":{"1":19,"40":3}}],["res",{"2":{"1":21,"40":1}}],["rest",{"2":{"1":1}}],["refer",{"2":{"1":1}}],["reference",{"0":{"1":1,"2":1},"2":{"1":11}}],["refdims",{"2":{"1":5}}],["retrieved",{"2":{"2":2}}],["retrieve",{"2":{"1":3,"2":1}}],["returning",{"2":{"1":2}}],["returned",{"2":{"1":14}}],["returns",{"2":{"1":8,"2":5,"49":2}}],["return",{"2":{"1":7,"48":1}}],["required",{"2":{"1":24,"2":2,"31":1}}],["replicated",{"2":{"50":1}}],["replaced",{"2":{"1":1,"2":1}}],["replacement",{"2":{"1":6}}],["replace",{"0":{"8":1},"2":{"0":1,"1":17,"7":2,"31":3,"33":1,"50":1}}],["reports",{"2":{"29":1}}],["reporting",{"2":{"2":1}}],["reproduced",{"2":{"29":1}}],["reproduce",{"2":{"29":1}}],["reprojecting",{"2":{"1":1}}],["reproject",{"2":{"0":2,"1":5}}],["represents",{"2":{"49":2}}],["represent",{"2":{"1":1,"25":2}}],["representing",{"2":{"1":1}}],["reprsenting",{"2":{"1":1}}],["p2",{"2":{"50":1}}],["px",{"2":{"41":1}}],["put",{"2":{"28":1,"29":1}}],["phylum",{"2":{"18":1}}],["p",{"2":{"1":4,"20":3,"48":8,"50":1}}],["pygmy",{"2":{"1":1,"17":1}}],["perform",{"2":{"49":1}}],["performance",{"2":{"1":4}}],["per",{"2":{"41":1,"49":1,"50":8}}],["peru",{"2":{"1":1}}],["permission",{"2":{"1":1}}],["permissions",{"2":{"1":1}}],["plt",{"2":{"39":5}}],["platform",{"2":{"29":1}}],["plane",{"2":{"1":1,"49":2}}],["planar",{"2":{"1":2,"49":6}}],["places",{"2":{"29":1}}],["placed",{"2":{"2":1,"38":1}}],["place",{"2":{"1":6,"29":1}}],["please",{"2":{"1":19,"49":1}}],["plotted",{"2":{"36":1}}],["plotting",{"0":{"34":1,"38":1,"48":1},"2":{"2":2,"34":1,"38":2,"40":2,"42":1,"44":1}}],["plottype",{"2":{"2":1,"38":1}}],["plot`",{"2":{"1":1}}],["plots",{"0":{"40":1,"48":1},"2":{"1":20,"20":1,"28":1,"34":1,"36":2,"40":4,"42":3,"43":2,"45":1,"48":1}}],["plot",{"0":{"43":2,"45":1},"2":{"1":39,"2":3,"16":1,"20":2,"26":1,"34":1,"35":2,"38":3,"39":1,"40":7,"41":1,"42":8,"44":3,"45":1,"48":9,"49":1,"50":1}}],["pixelated",{"2":{"1":1}}],["pixel",{"2":{"1":18,"40":2,"47":1}}],["pixels",{"2":{"1":15}}],["png",{"2":{"1":24,"39":1}}],["principle",{"2":{"9":1}}],["print",{"2":{"1":4,"2":2}}],["primem",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"35":1,"39":1,"47":2,"48":1}}],["practically",{"2":{"29":1}}],["practice",{"2":{"1":2,"2":1,"38":1}}],["practise",{"2":{"1":1}}],["predefined",{"2":{"33":1}}],["predictor",{"2":{"20":1}}],["predictors",{"2":{"20":5}}],["previously",{"2":{"28":1}}],["prefer",{"2":{"1":1}}],["precip",{"2":{"50":19}}],["precipitation",{"2":{"50":6}}],["prec",{"2":{"1":8,"47":5,"48":4,"50":1}}],["pressure",{"2":{"1":1}}],["pressure=",{"2":{"1":1}}],["present",{"2":{"1":2}}],["problem",{"2":{"29":2}}],["problems",{"2":{"1":23,"2":2,"49":1}}],["providing",{"2":{"15":1}}],["provide",{"2":{"36":1}}],["provides",{"2":{"14":1,"48":1}}],["provided",{"2":{"1":6,"40":1}}],["proj",{"2":{"1":1,"49":2}}],["projections",{"2":{"1":5,"25":1,"49":1}}],["projection",{"2":{"1":6,"25":2,"30":1,"49":1}}],["projected",{"2":{"0":1,"1":16,"2":1,"4":4,"5":2,"7":2,"8":2,"9":4,"20":2,"25":1,"35":2,"39":2,"47":4,"48":2,"49":9}}],["prod",{"2":{"1":1}}],["produces",{"2":{"29":1}}],["produce",{"2":{"1":2,"42":1}}],["productive",{"2":{"1":5}}],["properties",{"0":{"6":1},"1":{"7":1,"8":1,"9":1},"2":{"1":3,"9":2,"25":1}}],["progress=false",{"2":{"1":4}}],["progress",{"2":{"1":22}}],["page",{"2":{"50":1}}],["pacific",{"2":{"50":1}}],["packages",{"0":{"28":1},"2":{"28":4}}],["package",{"0":{"22":1},"2":{"28":2,"49":1}}],["pane",{"2":{"42":1}}],["paste",{"2":{"29":1}}],["passive",{"2":{"14":1}}],["passing",{"2":{"1":3}}],["passes",{"2":{"1":1}}],["passed",{"2":{"1":25,"2":12,"26":2}}],["pass",{"2":{"1":3,"2":1,"34":1,"36":1}}],["pad=10",{"2":{"47":1}}],["padding",{"2":{"1":1,"2":2,"38":2}}],["padded",{"2":{"1":1}}],["pad",{"2":{"1":3,"47":1}}],["pair",{"2":{"1":2}}],["pairs",{"2":{"1":16}}],["part",{"2":{"29":1}}],["parvus",{"2":{"1":2,"18":1,"20":2}}],["parallel",{"2":{"1":5}}],["parse",{"2":{"1":1}}],["parsed",{"2":{"1":1}}],["path",{"2":{"1":7,"2":3}}],["paths",{"2":{"1":6}}],["polar",{"2":{"49":1}}],["poles",{"2":{"49":1}}],["poly",{"2":{"47":1,"48":2,"50":1}}],["polygons",{"2":{"1":15,"45":1}}],["polygon",{"0":{"32":1,"45":1},"2":{"1":37,"31":1,"47":1}}],["population",{"2":{"49":1}}],["poor",{"2":{"1":1}}],["potential",{"2":{"1":2,"2":2}}],["pointer",{"2":{"2":1}}],["point",{"0":{"32":1},"2":{"1":27,"19":1,"49":2}}],["points",{"2":{"0":1,"1":43,"9":4,"19":1,"20":1,"22":3,"23":1,"24":7,"25":2,"32":2,"49":2}}],["possibly",{"2":{"6":1}}],["possible",{"2":{"1":9,"4":1,"22":1,"28":1,"29":2}}],["possum",{"2":{"1":1,"17":1}}],["positive",{"2":{"1":2}}],["position",{"2":{"1":1,"2":2,"38":2}}],["mp4",{"2":{"38":2}}],["mmap",{"2":{"11":1}}],["my",{"2":{"1":2}}],["myraster",{"2":{"1":2,"49":2}}],["myseries",{"2":{"1":3}}],["month",{"2":{"18":1,"22":2,"24":1,"36":1,"38":1,"42":2,"50":3}}],["month=july",{"2":{"47":1}}],["month=june",{"2":{"16":1}}],["month=jan",{"2":{"1":1}}],["month=6",{"2":{"1":1}}],["month=1",{"2":{"1":11}}],["moisture",{"2":{"14":2}}],["move",{"2":{"2":1,"33":1}}],["mountain",{"2":{"1":1,"17":1}}],["more",{"2":{"1":5,"9":1,"25":2,"30":1,"42":1,"50":1}}],["modification",{"2":{"1":1}}],["modifying",{"0":{"6":1},"1":{"7":1,"8":1,"9":1}}],["modify",{"0":{"33":1},"2":{"1":1,"6":1,"9":1,"33":1}}],["model",{"2":{"1":1}}],["mode=",{"2":{"1":2}}],["mode",{"2":{"1":15,"5":1}}],["mos",{"2":{"1":2}}],["most",{"2":{"1":4,"3":1,"29":1,"31":1}}],["mosaic",{"0":{"45":1},"2":{"0":2,"1":15,"30":1,"45":1,"48":2}}],["misestimated",{"2":{"50":1}}],["missing=false",{"2":{"1":2}}],["missing",{"0":{"8":1},"2":{"0":1,"1":51,"2":7,"6":1,"7":1,"8":1,"14":2,"18":21,"20":80,"30":1,"31":2,"42":6,"47":1,"50":3}}],["missingval=",{"2":{"7":1,"8":1}}],["missingval=uint32",{"2":{"1":1}}],["missingval=missingval",{"2":{"1":2}}],["missingval=0",{"2":{"1":2}}],["missingval",{"2":{"0":1,"1":36,"2":7,"4":2,"5":1,"7":1,"8":1,"9":2,"20":1,"31":1,"35":1,"39":1,"42":2,"47":2,"48":1}}],["missingmask",{"2":{"0":1,"1":6}}],["middle",{"2":{"50":1}}],["millisecond",{"2":{"42":1}}],["minutes",{"2":{"42":2}}],["min",{"2":{"1":3}}],["minimum",{"2":{"1":7,"29":1}}],["minor",{"2":{"1":2}}],["mix",{"2":{"1":1}}],["mixed",{"2":{"1":7}}],["must",{"2":{"1":17,"38":2}}],["multithreading",{"2":{"50":1}}],["multidimensional",{"2":{"30":1}}],["multi",{"2":{"1":5,"2":1,"14":1,"42":1,"48":1}}],["multiple",{"2":{"1":18,"2":3}}],["much",{"2":{"1":3}}],["mercator",{"2":{"49":1}}],["merge",{"2":{"1":1}}],["med",{"2":{"1":1}}],["median",{"2":{"1":6}}],["messages",{"2":{"1":2,"2":2}}],["meter",{"2":{"50":5}}],["meters",{"2":{"1":6,"49":2,"50":2}}],["method",{"2":{"1":22,"2":7,"48":1,"49":5,"50":1}}],["methods",{"0":{"30":1,"31":1,"33":1},"2":{"1":5,"2":1,"3":2,"30":1,"31":3,"32":1,"33":1,"42":2,"48":3}}],["metadata",{"2":{"1":7,"2":4,"4":4,"5":2,"7":2,"8":2,"9":4,"15":3,"35":2,"42":4}}],["meaning",{"2":{"49":1}}],["means",{"2":{"1":4,"2":7,"11":1,"28":1}}],["mean",{"0":{"4":1},"2":{"1":16,"2":3,"3":1,"4":1,"42":6,"43":1,"44":4,"49":2}}],["memory",{"2":{"1":18,"2":6,"33":2,"49":1}}],["mainly",{"2":{"50":1}}],["margin",{"2":{"47":1}}],["markercolor=",{"2":{"20":1}}],["markershape=",{"2":{"20":1}}],["many",{"2":{"28":1,"29":2}}],["manually",{"2":{"1":17,"2":3,"28":1,"33":1,"40":1}}],["madagascar",{"2":{"26":3}}],["made",{"2":{"1":2,"50":1}}],["map",{"2":{"5":2,"50":1}}],["mappedindex",{"2":{"0":1,"1":1}}],["mappedcrs=epsg",{"2":{"1":3}}],["mappedcrs=nothing",{"2":{"1":2}}],["mappedcrs",{"2":{"0":1,"1":20,"40":1,"42":2}}],["mappedbounds",{"2":{"0":1,"1":1}}],["mapped",{"2":{"0":1,"1":16,"25":3,"42":4}}],["making",{"2":{"26":1,"29":1}}],["makie",{"0":{"34":1,"35":1,"36":1,"39":1,"41":1},"2":{"2":13,"16":1,"26":1,"28":2,"34":1,"35":1,"36":2,"38":13,"39":1,"40":3,"41":1,"49":1,"50":1}}],["make",{"2":{"1":4,"9":1,"29":1,"45":1,"49":1,"50":1}}],["makes",{"2":{"1":1,"36":1}}],["macao",{"2":{"1":1}}],["malaysia",{"2":{"1":1}}],["max",{"2":{"1":1,"40":2}}],["maximum",{"2":{"1":7,"2":2,"40":1}}],["magnitude",{"2":{"1":2}}],["magma",{"2":{"1":2}}],["master",{"2":{"1":4,"46":1}}],["masking",{"0":{"45":1},"2":{"50":1}}],["masks",{"2":{"1":1}}],["masked",{"2":{"1":16,"32":1,"50":9}}],["mask",{"2":{"0":2,"1":36,"2":1,"31":2,"45":1,"47":5,"48":2,"50":5}}],["matters",{"2":{"1":2}}],["matter",{"2":{"1":2}}],["matching",{"2":{"1":3,"26":1,"40":1}}],["match",{"2":{"1":9}}],["matches",{"2":{"1":1}}],["matrix",{"2":{"1":2}}],["may",{"2":{"1":70,"2":5,"12":2,"15":1,"36":1,"38":1,"49":2}}],["cftime",{"2":{"42":2}}],["cmor",{"2":{"42":2}}],["cgrads",{"2":{"2":1,"38":1}}],["cyprus",{"2":{"1":1}}],["c",{"2":{"1":2,"2":2}}],["cp",{"2":{"1":1}}],["c=",{"2":{"1":3}}],["csv",{"2":{"1":1,"20":5}}],["cs",{"2":{"1":1,"49":1}}],["circumstances",{"2":{"1":5}}],["closest",{"2":{"26":1}}],["closed",{"2":{"2":1}}],["click",{"2":{"30":1}}],["clipperton",{"2":{"1":1}}],["clims=",{"2":{"1":4}}],["climate",{"2":{"1":14,"16":1,"28":1,"36":1,"38":2,"47":7,"48":1,"50":1}}],["classes",{"2":{"1":5}}],["classified",{"2":{"1":3}}],["classify",{"2":{"0":2,"1":10,"31":2}}],["certain",{"2":{"26":1}}],["center",{"2":{"1":20,"42":6}}],["cell",{"2":{"1":6,"42":2,"49":8,"50":5}}],["cells",{"2":{"1":4,"49":1}}],["cellarea",{"0":{"49":1},"1":{"50":1},"2":{"0":1,"1":2,"49":6,"50":1}}],["cubicspline",{"2":{"1":1}}],["cubic",{"2":{"1":3}}],["custom",{"2":{"1":4,"14":1}}],["current",{"2":{"1":3,"2":2,"7":1,"39":1}}],["currently",{"2":{"1":6}}],["cultural",{"2":{"1":4,"46":1}}],["cut",{"2":{"1":5,"39":1}}],["cuda",{"2":{"1":1}}],["cuarray",{"2":{"1":1}}],["chordata",{"2":{"18":15}}],["chosen",{"2":{"1":3,"2":3,"49":2}}],["chunk",{"2":{"2":11}}],["chunks",{"2":{"2":6}}],["chunking",{"2":{"2":1}}],["changing",{"2":{"1":1}}],["changes",{"2":{"1":2}}],["change",{"0":{"30":1,"31":1},"2":{"1":22,"7":1,"9":2,"40":2,"49":1}}],["chile",{"2":{"1":1,"50":17}}],["child",{"2":{"1":11,"2":1}}],["china",{"2":{"1":8}}],["checks",{"2":{"2":1}}],["checksum",{"2":{"2":4}}],["check",{"2":{"2":1,"14":1}}],["checked",{"2":{"1":2}}],["checkmemory",{"2":{"2":1}}],["checkmem",{"2":{"0":1,"2":3}}],["creep",{"2":{"29":1}}],["creation",{"2":{"2":2}}],["creating",{"2":{"1":3}}],["creates",{"2":{"1":1}}],["create",{"2":{"1":6}}],["cross",{"2":{"20":1}}],["cropping",{"2":{"50":1}}],["cropped",{"2":{"50":1}}],["crop",{"2":{"0":1,"1":13,"30":1,"48":1,"50":3}}],["crs=epsg",{"2":{"1":4,"49":2}}],["crs=nothing",{"2":{"1":1}}],["crs",{"2":{"1":56,"4":2,"5":1,"7":1,"8":1,"9":5,"20":1,"35":1,"39":1,"40":1,"42":2,"47":2,"48":1,"49":7}}],["care",{"2":{"50":1}}],["cartier",{"2":{"1":1}}],["cartesianindex",{"2":{"1":1}}],["categories",{"2":{"31":1}}],["cairomakie",{"2":{"16":1,"26":2,"35":1,"39":1,"41":3,"49":1}}],["caveats",{"2":{"15":1}}],["caused",{"2":{"29":1}}],["cause",{"2":{"1":1}}],["caution",{"2":{"1":5}}],["calculate",{"2":{"1":4,"32":1}}],["calculated",{"2":{"1":8}}],["call",{"2":{"49":1}}],["calling",{"2":{"1":3}}],["called",{"2":{"1":1,"2":2,"49":1}}],["cased",{"2":{"1":2}}],["case",{"2":{"1":8}}],["cases",{"2":{"1":20,"49":1}}],["cannot",{"2":{"1":1,"2":3}}],["can",{"2":{"1":69,"2":30,"3":1,"6":2,"9":3,"11":1,"12":2,"13":3,"14":2,"15":2,"16":1,"20":1,"22":1,"25":1,"28":1,"29":5,"34":1,"36":2,"38":5,"40":2,"48":2,"49":9,"50":8}}],["code",{"2":{"28":1,"29":1}}],["coords",{"2":{"20":2}}],["coordinatetransformations",{"2":{"28":1}}],["coordinate",{"2":{"1":10,"28":1,"49":3,"50":1}}],["coordinates",{"0":{"19":1},"2":{"1":11,"22":1,"26":1,"42":1,"49":2}}],["course",{"2":{"49":1}}],["could",{"2":{"1":1,"42":1,"44":1}}],["counts",{"2":{"19":1}}],["country",{"2":{"1":7,"45":1,"50":1}}],["countries",{"2":{"1":8,"45":1,"46":1,"48":2,"50":4}}],["count",{"2":{"1":4}}],["counted",{"2":{"1":2}}],["counter",{"2":{"1":5}}],["correlation",{"2":{"1":1,"39":3}}],["corresponding",{"2":{"1":1}}],["correctly",{"2":{"42":1}}],["correct",{"2":{"1":1}}],["covering",{"2":{"30":1}}],["cover",{"2":{"1":2}}],["covered",{"2":{"1":10}}],["coverage",{"2":{"0":2,"1":15}}],["colgap",{"2":{"39":1}}],["color",{"2":{"2":2,"38":2,"50":1}}],["colorrange",{"2":{"2":1,"38":1,"50":1}}],["colormaps",{"2":{"2":1,"38":1}}],["colormap",{"2":{"2":3,"38":3,"39":2}}],["colorbar=",{"2":{"38":1}}],["colorbarlabel",{"2":{"2":1,"38":1}}],["colorbar",{"2":{"2":8,"38":8,"39":5}}],["color=",{"2":{"1":2}}],["collect",{"2":{"1":1,"20":1,"50":1}}],["collection",{"2":{"1":1}}],["collections",{"2":{"1":3}}],["collapse",{"2":{"1":3}}],["columns",{"2":{"1":19,"18":1}}],["column",{"2":{"1":21}}],["copying",{"2":{"1":1}}],["copy",{"2":{"1":2,"2":1}}],["command",{"2":{"44":1}}],["comments",{"2":{"2":2}}],["common",{"2":{"1":4,"12":1,"16":1,"48":1}}],["commonly",{"2":{"1":1,"31":1}}],["com",{"2":{"1":4,"46":1}}],["computing",{"2":{"50":2}}],["computes",{"2":{"1":1,"49":2}}],["compute",{"2":{"1":3,"49":3,"50":5}}],["compress",{"2":{"2":2}}],["compressed",{"2":{"2":2,"11":1}}],["compression",{"2":{"2":8}}],["compatable",{"2":{"1":1}}],["compatible",{"2":{"1":22}}],["comparison",{"2":{"1":6}}],["complicated",{"2":{"1":5,"29":1}}],["completely",{"2":{"1":7,"2":1,"15":1}}],["complete",{"2":{"1":1,"29":1}}],["combining",{"2":{"1":3}}],["combination",{"2":{"1":4}}],["combined",{"2":{"1":7}}],["combine",{"2":{"0":1,"1":9,"48":1}}],["congratulations",{"2":{"50":1}}],["conversion",{"2":{"15":2}}],["converting",{"2":{"1":1}}],["converted",{"2":{"1":7,"12":1,"40":1}}],["convert",{"2":{"1":4,"20":1,"50":1}}],["convertlookup",{"2":{"0":1,"1":1}}],["construct",{"2":{"49":3}}],["constructor",{"2":{"1":3}}],["const",{"2":{"18":1,"26":1}}],["considering",{"2":{"1":1}}],["concatenate",{"2":{"1":2}}],["concrete",{"2":{"1":2}}],["conditions",{"2":{"1":5}}],["contourf",{"2":{"2":1,"34":1,"35":1,"38":1,"40":2,"43":1}}],["contour",{"0":{"43":1},"2":{"2":1,"34":1,"35":1,"38":1,"40":2,"42":1}}],["contributing",{"2":{"1":8}}],["contribute",{"2":{"1":4}}],["contrast",{"2":{"1":3,"39":3,"49":1}}],["continents",{"2":{"1":2}}],["contained",{"2":{"2":1}}],["contains",{"2":{"1":7,"25":1,"26":1}}],["contain",{"2":{"1":4}}],["containing",{"2":{"1":13,"2":2}}],["contents",{"2":{"1":2}}],["break",{"2":{"36":1}}],["breaks",{"2":{"29":1}}],["broadcast",{"2":{"2":1,"4":2,"5":2}}],["broadcasting",{"0":{"5":1},"2":{"1":1}}],["black",{"2":{"20":1}}],["block",{"2":{"2":2}}],["blocks",{"2":{"1":2}}],["blocking",{"2":{"1":4}}],["b",{"2":{"1":13,"7":1,"24":2,"26":2}}],["bilinear",{"2":{"1":2}}],["biodiversity",{"2":{"17":1}}],["bio",{"2":{"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["bio7",{"2":{"1":6,"20":21}}],["bio5",{"2":{"1":6,"4":2,"5":1,"7":1,"8":1,"9":2,"35":1}}],["bio3",{"2":{"1":6,"20":21}}],["bio12",{"2":{"1":6,"20":21}}],["bio1",{"2":{"1":6,"20":21}}],["bioclim",{"2":{"1":2,"4":3,"5":1,"7":2,"8":1,"9":2,"17":1,"20":3,"26":1,"35":2,"40":1,"41":1}}],["bitarray",{"2":{"1":5}}],["bug",{"2":{"29":5}}],["bugs",{"0":{"29":1},"2":{"29":2}}],["built",{"2":{"1":2,"28":1,"50":1}}],["build",{"2":{"1":24,"14":1}}],["burramys",{"2":{"1":1,"18":1,"20":2}}],["burramis",{"2":{"1":1}}],["but",{"2":{"1":13,"2":3,"6":1,"11":1,"13":1,"25":1,"28":1,"29":3,"38":2,"49":1,"50":2}}],["by",{"0":{"22":1,"24":1,"25":1},"2":{"1":75,"2":15,"9":1,"24":1,"26":1,"30":1,"31":1,"32":1,"36":1,"40":1,"49":7,"50":4}}],["box",{"2":{"29":1,"38":1,"50":1}}],["bottom",{"2":{"2":1,"29":1,"38":1,"50":1}}],["both",{"2":{"1":2}}],["bolivia",{"2":{"1":1}}],["border",{"2":{"1":8,"45":1,"47":7,"48":9}}],["borders",{"2":{"1":8,"48":11}}],["bounding",{"2":{"50":1}}],["bounded",{"2":{"50":1}}],["boundaries",{"2":{"1":1}}],["boundary=",{"2":{"1":2}}],["boundary",{"2":{"1":8,"45":1,"46":1}}],["bounds",{"2":{"1":9}}],["bool",{"2":{"1":5,"2":1}}],["boolmask",{"2":{"0":1,"1":6}}],["bad",{"2":{"50":2}}],["batlow",{"2":{"39":1}}],["basic",{"2":{"2":1}}],["based",{"2":{"1":2,"2":2,"5":1,"48":1}}],["base",{"2":{"1":2,"2":11,"3":2}}],["bajo",{"2":{"1":1}}],["bank",{"2":{"1":2}}],["bang",{"2":{"1":4}}],["bands",{"2":{"1":1,"25":1}}],["band",{"0":{"20":1},"2":{"0":1,"1":10,"2":1,"11":1,"13":1,"20":1,"25":1,"38":1}}],["backgroundcolor=",{"2":{"39":2}}],["back",{"2":{"1":2,"42":1,"49":1}}],["backends",{"2":{"10":1}}],["backend",{"2":{"1":1,"2":10,"10":1,"28":2}}],["backed",{"2":{"1":8}}],["bar",{"2":{"1":9}}],["becomes",{"2":{"9":1}}],["because",{"2":{"1":5,"22":1,"29":2,"50":1}}],["best",{"2":{"2":1,"13":1,"38":1}}],["besides",{"2":{"1":2}}],["being",{"2":{"2":3,"48":1,"49":1}}],["beyond",{"2":{"1":1}}],["bets",{"2":{"2":1,"38":1}}],["better",{"2":{"1":1}}],["between",{"2":{"1":9,"2":1,"26":3,"38":1,"49":1}}],["before",{"2":{"1":14,"2":1}}],["behaviours",{"2":{"1":2}}],["been",{"2":{"1":2,"15":1}}],["below",{"2":{"1":1,"36":1}}],["be",{"2":{"1":191,"2":50,"4":1,"5":1,"6":1,"9":2,"11":1,"12":1,"13":2,"14":2,"15":3,"16":1,"22":1,"25":1,"29":2,"38":7,"40":2,"49":6,"50":1}}],["api",{"2":{"40":1}}],["appropriately",{"2":{"36":1}}],["approximately",{"2":{"1":2}}],["approximates",{"2":{"1":1,"49":1}}],["approximate",{"2":{"1":1,"49":1}}],["appreciated",{"2":{"29":1}}],["appears",{"2":{"1":1}}],["appended",{"2":{"2":3}}],["append",{"2":{"1":8,"2":3}}],["apparent",{"2":{"1":1}}],["applications",{"2":{"31":1}}],["applicable",{"2":{"2":1,"48":1}}],["applies",{"2":{"5":1}}],["applied",{"2":{"1":13,"2":1,"4":1,"5":1}}],["apply",{"2":{"1":2}}],["amounts",{"2":{"30":1}}],["amount",{"2":{"2":1,"38":1}}],["americas",{"2":{"42":1}}],["america",{"2":{"1":1}}],["avg",{"2":{"50":1}}],["averages",{"2":{"50":1}}],["average",{"2":{"1":3,"50":5}}],["available",{"2":{"1":3,"4":1,"25":1,"26":1,"49":1}}],["affected",{"2":{"9":1}}],["africa",{"2":{"1":8}}],["after",{"2":{"1":13,"2":1}}],["authentication",{"2":{"29":1}}],["authority",{"2":{"4":10,"5":5,"7":5,"8":5,"9":10,"20":5,"35":5,"39":5,"47":10,"48":5}}],["automatic",{"2":{"2":9,"38":9}}],["automatically",{"2":{"1":8,"2":4,"10":1}}],["ausbounds",{"2":{"1":2,"39":2}}],["aus",{"2":{"1":9,"20":3,"39":3}}],["australian",{"2":{"1":1}}],["australia",{"2":{"1":3,"20":1,"39":2}}],["awap",{"2":{"1":13}}],["admin",{"2":{"1":5,"46":1,"50":1}}],["adding",{"2":{"4":1}}],["additional",{"2":{"1":3,"25":1,"28":2,"31":1}}],["additionally",{"2":{"1":5}}],["addition",{"2":{"1":2}}],["add",{"2":{"1":1,"22":1,"27":1,"29":1,"48":1}}],["added",{"2":{"1":2,"48":1}}],["again",{"2":{"1":1,"2":1,"48":1}}],["ag",{"2":{"1":2}}],["aggregation",{"2":{"1":8}}],["aggregated",{"2":{"1":8}}],["aggregate",{"2":{"0":2,"1":12,"30":2}}],["axs",{"2":{"39":5}}],["ax",{"2":{"35":3}}],["axis3",{"2":{"2":1,"38":1}}],["axistype",{"2":{"2":1,"38":1}}],["axis",{"2":{"1":7,"2":8,"4":4,"5":2,"7":2,"8":2,"9":5,"20":2,"26":1,"30":1,"35":3,"36":1,"38":8,"39":3,"40":1,"47":4,"48":2,"49":1,"50":2}}],["axes",{"2":{"1":5,"40":2,"42":1}}],["across",{"2":{"30":1,"50":4}}],["activate",{"2":{"26":1,"41":1}}],["activated",{"2":{"2":2}}],["active",{"2":{"14":1}}],["actually",{"2":{"2":2,"7":1,"29":1,"49":1}}],["actual",{"2":{"1":2}}],["account",{"2":{"49":1,"50":2}}],["accurate",{"2":{"1":1}}],["accept",{"2":{"40":1}}],["accepts",{"2":{"1":2,"2":2,"38":1}}],["accepted",{"2":{"1":2,"35":1}}],["accessible",{"2":{"29":1}}],["access",{"2":{"1":3,"13":1}}],["atol",{"2":{"1":9}}],["attributes",{"2":{"36":1,"39":1}}],["attempt",{"2":{"1":2}}],["attempting",{"2":{"1":1}}],["attached",{"2":{"1":7}}],["at",{"2":{"1":8,"2":5,"26":2,"29":1,"36":1,"42":2,"44":1,"49":3,"50":1}}],["algebra",{"2":{"3":1}}],["algorithm",{"2":{"1":3}}],["altered",{"2":{"2":1,"42":2}}],["although",{"2":{"1":1}}],["aligned",{"2":{"1":1}}],["already",{"2":{"1":1,"2":6}}],["along",{"2":{"1":7,"31":1}}],["alphabetically",{"2":{"1":1}}],["also",{"2":{"1":24,"2":3,"3":1,"4":1,"9":2,"12":1,"13":1,"24":1,"29":1,"48":1,"49":1,"50":1}}],["allow",{"2":{"1":1,"40":1}}],["allows",{"2":{"1":1}}],["allocating",{"2":{"1":1}}],["alllayers",{"2":{"1":3}}],["alllayers=true",{"2":{"1":1}}],["all",{"2":{"1":75,"2":4,"12":1,"13":1,"15":1,"20":1,"26":2,"29":1,"31":1,"48":2,"49":2,"50":3}}],["always",{"2":{"1":4,"2":1,"11":1,"14":1,"26":1,"28":1,"29":2}}],["around",{"2":{"42":1}}],["arbitrary",{"2":{"12":1,"25":1}}],["architectures",{"2":{"2":1}}],["archive",{"2":{"2":2}}],["archgdal",{"2":{"1":22,"2":2,"13":1,"28":2,"35":1,"40":1,"41":1,"45":1,"49":2}}],["args",{"2":{"40":1}}],["argentina",{"2":{"1":4}}],["argument",{"2":{"1":4,"2":2,"3":1,"49":2,"50":1}}],["arguments",{"2":{"1":26,"2":2}}],["area",{"2":{"1":14,"49":10,"50":8}}],["areas",{"2":{"1":17,"30":1,"49":2,"50":8}}],["are",{"2":{"1":90,"2":8,"9":1,"11":3,"12":3,"13":1,"14":1,"20":1,"25":1,"26":3,"29":6,"31":1,"36":3,"38":3,"40":1,"42":1,"44":1,"48":1,"49":2}}],["arrays",{"2":{"1":18,"2":2,"3":1,"6":1,"25":2,"30":1,"48":1}}],["array",{"0":{"3":1,"23":1},"1":{"4":1,"5":1,"6":1,"7":1,"8":1,"9":1},"2":{"1":49,"2":1,"4":1,"5":2,"18":1,"26":2,"30":1,"31":1,"40":1}}],["aspect",{"2":{"35":1,"36":1,"49":1,"50":1}}],["asc",{"2":{"13":1}}],["ashmore",{"2":{"1":1}}],["associated",{"2":{"25":1}}],["assuming",{"2":{"1":1,"49":2}}],["assign",{"2":{"1":2}}],["assigned",{"2":{"1":6}}],["assigns",{"2":{"1":1}}],["as",{"2":{"1":64,"2":10,"3":2,"7":1,"12":2,"13":3,"14":2,"15":1,"16":1,"19":1,"20":1,"26":1,"31":2,"36":2,"42":1,"44":1,"49":2,"50":1}}],["a",{"0":{"43":1},"2":{"1":426,"2":100,"3":1,"4":4,"5":4,"6":2,"7":2,"8":1,"9":5,"10":1,"14":1,"15":1,"16":4,"19":3,"20":3,"24":2,"26":7,"28":2,"29":5,"30":3,"31":2,"33":1,"34":2,"35":7,"36":4,"38":11,"40":6,"41":2,"42":5,"44":3,"45":1,"47":1,"48":6,"49":15,"50":6}}],["absolute",{"2":{"1":2}}],["abstracrasterseries",{"2":{"1":2}}],["abstrackrasterstack",{"2":{"1":1}}],["abstractdiskarray",{"2":{"2":3}}],["abstractdimensionalarray",{"2":{"1":1}}],["abstractdimarray",{"2":{"1":4}}],["abstractvector",{"2":{"1":3}}],["abstractgeometry",{"2":{"1":15}}],["abstractstack",{"2":{"1":2}}],["abstractstring",{"2":{"1":3,"2":6}}],["abstractsampled",{"2":{"1":2,"2":1}}],["abstractarray",{"2":{"1":5,"2":1}}],["abstract",{"2":{"1":3,"2":1}}],["abstractrasters",{"2":{"1":5}}],["abstractrasterstack",{"2":{"0":1,"1":12,"2":5}}],["abstractrasterseries",{"2":{"0":1,"1":8,"2":5}}],["abstractraster",{"2":{"0":1,"1":27,"2":9}}],["abstractprojected",{"2":{"0":1,"1":4,"2":1}}],["about",{"2":{"1":4,"2":2,"49":1,"50":2}}],["animations",{"0":{"38":1}}],["animalia",{"2":{"18":15}}],["answer",{"2":{"1":2}}],["anything",{"2":{"9":1}}],["any",{"2":{"1":19,"2":6,"4":3,"5":1,"7":1,"8":1,"9":3,"29":1,"30":1,"34":1,"35":1,"36":2,"38":1,"40":1,"42":2,"50":2}}],["another",{"2":{"1":9,"25":1,"30":3}}],["and",{"0":{"29":1,"32":1,"33":1,"45":1},"2":{"1":133,"2":18,"3":2,"4":1,"9":1,"10":1,"11":2,"12":1,"13":1,"14":2,"16":5,"17":1,"18":1,"20":2,"22":2,"24":1,"25":7,"26":3,"28":5,"29":7,"30":3,"31":1,"32":1,"36":3,"38":2,"40":3,"42":5,"47":1,"48":9,"49":9,"50":10}}],["an",{"0":{"26":1,"30":1,"31":1},"2":{"1":69,"2":9,"4":1,"6":2,"9":2,"17":1,"26":3,"29":2,"31":2,"32":1,"36":1,"38":1,"40":1,"48":1,"49":1,"50":1}}]],"serializationVersion":2}';export{e as default}; diff --git a/previews/PR800/assets/chunks/VPLocalSearchBox.BCyrKH8f.js b/previews/PR800/assets/chunks/VPLocalSearchBox.IfQDnsCV.js similarity index 99% rename from previews/PR800/assets/chunks/VPLocalSearchBox.BCyrKH8f.js rename to previews/PR800/assets/chunks/VPLocalSearchBox.IfQDnsCV.js index 99e50435..32881d0d 100644 --- a/previews/PR800/assets/chunks/VPLocalSearchBox.BCyrKH8f.js +++ b/previews/PR800/assets/chunks/VPLocalSearchBox.IfQDnsCV.js @@ -1,4 +1,4 @@ -var Nt=Object.defineProperty;var Ft=(a,e,t)=>e in a?Nt(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var Ce=(a,e,t)=>Ft(a,typeof e!="symbol"?e+"":e,t);import{V as Ot,p as ne,h as ve,aj as Xe,ak as Rt,al as Ct,q as Ve,am as Mt,d as At,D as we,an as et,ao as Lt,ap as Dt,s as zt,aq as Pt,v as Me,P as de,O as xe,ar as jt,as as Vt,W as $t,R as Bt,$ as Wt,o as q,b as Kt,j as S,a0 as Jt,k as D,at as Ut,au as qt,av as Gt,c as Y,n as tt,e as Se,C as st,F as nt,a as he,t as fe,aw as Ht,ax as it,ay as Qt,a9 as Yt,af as Zt,az as Xt,_ as es}from"./framework.Gz-llJN4.js";import{u as ts,c as ss}from"./theme.Crhm6d51.js";const ns={root:()=>Ot(()=>import("./@localSearchIndexroot.BOXIqzN5.js"),[])};/*! +var Nt=Object.defineProperty;var Ft=(a,e,t)=>e in a?Nt(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var Ce=(a,e,t)=>Ft(a,typeof e!="symbol"?e+"":e,t);import{V as Ot,p as ne,h as ve,aj as Xe,ak as Rt,al as Ct,q as Ve,am as Mt,d as At,D as we,an as et,ao as Lt,ap as Dt,s as zt,aq as Pt,v as Me,P as de,O as xe,ar as jt,as as Vt,W as $t,R as Bt,$ as Wt,o as q,b as Kt,j as S,a0 as Jt,k as D,at as Ut,au as qt,av as Gt,c as Y,n as tt,e as Se,C as st,F as nt,a as he,t as fe,aw as Ht,ax as it,ay as Qt,a9 as Yt,af as Zt,az as Xt,_ as es}from"./framework.Gz-llJN4.js";import{u as ts,c as ss}from"./theme.y-k-N8DM.js";const ns={root:()=>Ot(()=>import("./@localSearchIndexroot.BI6cvcAk.js"),[])};/*! * tabbable 6.2.0 * @license MIT, https://github.com/focus-trap/tabbable/blob/master/LICENSE */var vt=["input:not([inert])","select:not([inert])","textarea:not([inert])","a[href]:not([inert])","button:not([inert])","[tabindex]:not(slot):not([inert])","audio[controls]:not([inert])","video[controls]:not([inert])",'[contenteditable]:not([contenteditable="false"]):not([inert])',"details>summary:first-of-type:not([inert])","details:not([inert])"],ke=vt.join(","),mt=typeof Element>"u",re=mt?function(){}:Element.prototype.matches||Element.prototype.msMatchesSelector||Element.prototype.webkitMatchesSelector,Ne=!mt&&Element.prototype.getRootNode?function(a){var e;return a==null||(e=a.getRootNode)===null||e===void 0?void 0:e.call(a)}:function(a){return a==null?void 0:a.ownerDocument},Fe=function a(e,t){var s;t===void 0&&(t=!0);var n=e==null||(s=e.getAttribute)===null||s===void 0?void 0:s.call(e,"inert"),r=n===""||n==="true",i=r||t&&e&&a(e.parentNode);return i},is=function(e){var t,s=e==null||(t=e.getAttribute)===null||t===void 0?void 0:t.call(e,"contenteditable");return s===""||s==="true"},gt=function(e,t,s){if(Fe(e))return[];var n=Array.prototype.slice.apply(e.querySelectorAll(ke));return t&&re.call(e,ke)&&n.unshift(e),n=n.filter(s),n},bt=function a(e,t,s){for(var n=[],r=Array.from(e);r.length;){var i=r.shift();if(!Fe(i,!1))if(i.tagName==="SLOT"){var o=i.assignedElements(),l=o.length?o:i.children,c=a(l,!0,s);s.flatten?n.push.apply(n,c):n.push({scopeParent:i,candidates:c})}else{var h=re.call(i,ke);h&&s.filter(i)&&(t||!e.includes(i))&&n.push(i);var v=i.shadowRoot||typeof s.getShadowRoot=="function"&&s.getShadowRoot(i),p=!Fe(v,!1)&&(!s.shadowRootFilter||s.shadowRootFilter(i));if(v&&p){var b=a(v===!0?i.children:v.children,!0,s);s.flatten?n.push.apply(n,b):n.push({scopeParent:i,candidates:b})}else r.unshift.apply(r,i.children)}}return n},yt=function(e){return!isNaN(parseInt(e.getAttribute("tabindex"),10))},ie=function(e){if(!e)throw new Error("No node provided");return e.tabIndex<0&&(/^(AUDIO|VIDEO|DETAILS)$/.test(e.tagName)||is(e))&&!yt(e)?0:e.tabIndex},rs=function(e,t){var s=ie(e);return s<0&&t&&!yt(e)?0:s},as=function(e,t){return e.tabIndex===t.tabIndex?e.documentOrder-t.documentOrder:e.tabIndex-t.tabIndex},wt=function(e){return e.tagName==="INPUT"},os=function(e){return wt(e)&&e.type==="hidden"},ls=function(e){var t=e.tagName==="DETAILS"&&Array.prototype.slice.apply(e.children).some(function(s){return s.tagName==="SUMMARY"});return t},cs=function(e,t){for(var s=0;ssummary:first-of-type"),i=r?e.parentElement:e;if(re.call(i,"details:not([open]) *"))return!0;if(!s||s==="full"||s==="legacy-full"){if(typeof n=="function"){for(var o=e;e;){var l=e.parentElement,c=Ne(e);if(l&&!l.shadowRoot&&n(l)===!0)return rt(e);e.assignedSlot?e=e.assignedSlot:!l&&c!==e.ownerDocument?e=c.host:e=l}e=o}if(fs(e))return!e.getClientRects().length;if(s!=="legacy-full")return!0}else if(s==="non-zero-area")return rt(e);return!1},vs=function(e){if(/^(INPUT|BUTTON|SELECT|TEXTAREA)$/.test(e.tagName))for(var t=e.parentElement;t;){if(t.tagName==="FIELDSET"&&t.disabled){for(var s=0;s=0)},gs=function a(e){var t=[],s=[];return e.forEach(function(n,r){var i=!!n.scopeParent,o=i?n.scopeParent:n,l=rs(o,i),c=i?a(n.candidates):o;l===0?i?t.push.apply(t,c):t.push(o):s.push({documentOrder:r,tabIndex:l,item:n,isScope:i,content:c})}),s.sort(as).reduce(function(n,r){return r.isScope?n.push.apply(n,r.content):n.push(r.content),n},[]).concat(t)},bs=function(e,t){t=t||{};var s;return t.getShadowRoot?s=bt([e],t.includeContainer,{filter:$e.bind(null,t),flatten:!1,getShadowRoot:t.getShadowRoot,shadowRootFilter:ms}):s=gt(e,t.includeContainer,$e.bind(null,t)),gs(s)},ys=function(e,t){t=t||{};var s;return t.getShadowRoot?s=bt([e],t.includeContainer,{filter:Oe.bind(null,t),flatten:!0,getShadowRoot:t.getShadowRoot}):s=gt(e,t.includeContainer,Oe.bind(null,t)),s},ae=function(e,t){if(t=t||{},!e)throw new Error("No node provided");return re.call(e,ke)===!1?!1:$e(t,e)},ws=vt.concat("iframe").join(","),Ae=function(e,t){if(t=t||{},!e)throw new Error("No node provided");return re.call(e,ws)===!1?!1:Oe(t,e)};/*! diff --git a/previews/PR800/assets/chunks/theme.Crhm6d51.js b/previews/PR800/assets/chunks/theme.y-k-N8DM.js similarity index 99% rename from previews/PR800/assets/chunks/theme.Crhm6d51.js rename to previews/PR800/assets/chunks/theme.y-k-N8DM.js index 69989bbb..315bcadf 100644 --- a/previews/PR800/assets/chunks/theme.Crhm6d51.js +++ b/previews/PR800/assets/chunks/theme.y-k-N8DM.js @@ -1,2 +1,2 @@ -const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/VPLocalSearchBox.BCyrKH8f.js","assets/chunks/framework.Gz-llJN4.js"])))=>i.map(i=>d[i]); -import{d as m,o as a,c as u,r as c,n as I,a as z,t as w,b as g,w as f,e as h,T as de,_ as $,u as Ge,i as je,f as ze,g as ve,h as y,j as p,k as r,l as K,m as re,p as T,q as F,s as Z,v as j,x as pe,y as fe,z as Ke,A as Re,B as R,F as M,C as B,D as Le,E as x,G as k,H as E,I as Ve,J as ee,K as G,L as W,M as qe,N as Te,O as ie,P as Ne,Q as we,R as te,S as We,U as Je,V as Ye,W as Ie,X as he,Y as Xe,Z as Qe,$ as Ze,a0 as xe,a1 as Me,a2 as et,a3 as tt,a4 as nt}from"./framework.Gz-llJN4.js";const st=m({__name:"VPBadge",props:{text:{},type:{default:"tip"}},setup(o){return(e,t)=>(a(),u("span",{class:I(["VPBadge",e.type])},[c(e.$slots,"default",{},()=>[z(w(e.text),1)])],2))}}),ot={key:0,class:"VPBackdrop"},at=m({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(o){return(e,t)=>(a(),g(de,{name:"fade"},{default:f(()=>[e.show?(a(),u("div",ot)):h("",!0)]),_:1}))}}),rt=$(at,[["__scopeId","data-v-b06cdb19"]]),V=Ge;function it(o,e){let t,s=!1;return()=>{t&&clearTimeout(t),s?t=setTimeout(o,e):(o(),(s=!0)&&setTimeout(()=>s=!1,e))}}function le(o){return/^\//.test(o)?o:`/${o}`}function me(o){const{pathname:e,search:t,hash:s,protocol:n}=new URL(o,"http://a.com");if(je(o)||o.startsWith("#")||!n.startsWith("http")||!ze(e))return o;const{site:i}=V(),l=e.endsWith("/")||e.endsWith(".html")?o:o.replace(/(?:(^\.+)\/)?.*$/,`$1${e.replace(/(\.md)?$/,i.value.cleanUrls?"":".html")}${t}${s}`);return ve(l)}function Y({correspondingLink:o=!1}={}){const{site:e,localeIndex:t,page:s,theme:n,hash:i}=V(),l=y(()=>{var v,b;return{label:(v=e.value.locales[t.value])==null?void 0:v.label,link:((b=e.value.locales[t.value])==null?void 0:b.link)||(t.value==="root"?"/":`/${t.value}/`)}});return{localeLinks:y(()=>Object.entries(e.value.locales).flatMap(([v,b])=>l.value.label===b.label?[]:{text:b.label,link:lt(b.link||(v==="root"?"/":`/${v}/`),n.value.i18nRouting!==!1&&o,s.value.relativePath.slice(l.value.link.length-1),!e.value.cleanUrls)+i.value})),currentLang:l}}function lt(o,e,t,s){return e?o.replace(/\/$/,"")+le(t.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,s?".html":"")):o}const ct={class:"NotFound"},ut={class:"code"},dt={class:"title"},vt={class:"quote"},pt={class:"action"},ft=["href","aria-label"],ht=m({__name:"NotFound",setup(o){const{theme:e}=V(),{currentLang:t}=Y();return(s,n)=>{var i,l,d,v,b;return a(),u("div",ct,[p("p",ut,w(((i=r(e).notFound)==null?void 0:i.code)??"404"),1),p("h1",dt,w(((l=r(e).notFound)==null?void 0:l.title)??"PAGE NOT FOUND"),1),n[0]||(n[0]=p("div",{class:"divider"},null,-1)),p("blockquote",vt,w(((d=r(e).notFound)==null?void 0:d.quote)??"But if you don't change your direction, and if you keep looking, you may end up where you are heading."),1),p("div",pt,[p("a",{class:"link",href:r(ve)(r(t).link),"aria-label":((v=r(e).notFound)==null?void 0:v.linkLabel)??"go to home"},w(((b=r(e).notFound)==null?void 0:b.linkText)??"Take me home"),9,ft)])])}}}),mt=$(ht,[["__scopeId","data-v-951cab6c"]]);function Ae(o,e){if(Array.isArray(o))return X(o);if(o==null)return[];e=le(e);const t=Object.keys(o).sort((n,i)=>i.split("/").length-n.split("/").length).find(n=>e.startsWith(le(n))),s=t?o[t]:[];return Array.isArray(s)?X(s):X(s.items,s.base)}function _t(o){const e=[];let t=0;for(const s in o){const n=o[s];if(n.items){t=e.push(n);continue}e[t]||e.push({items:[]}),e[t].items.push(n)}return e}function bt(o){const e=[];function t(s){for(const n of s)n.text&&n.link&&e.push({text:n.text,link:n.link,docFooterText:n.docFooterText}),n.items&&t(n.items)}return t(o),e}function ce(o,e){return Array.isArray(e)?e.some(t=>ce(o,t)):K(o,e.link)?!0:e.items?ce(o,e.items):!1}function X(o,e){return[...o].map(t=>{const s={...t},n=s.base||e;return n&&s.link&&(s.link=n+s.link),s.items&&(s.items=X(s.items,n)),s})}function O(){const{frontmatter:o,page:e,theme:t}=V(),s=re("(min-width: 960px)"),n=T(!1),i=y(()=>{const C=t.value.sidebar,N=e.value.relativePath;return C?Ae(C,N):[]}),l=T(i.value);F(i,(C,N)=>{JSON.stringify(C)!==JSON.stringify(N)&&(l.value=i.value)});const d=y(()=>o.value.sidebar!==!1&&l.value.length>0&&o.value.layout!=="home"),v=y(()=>b?o.value.aside==null?t.value.aside==="left":o.value.aside==="left":!1),b=y(()=>o.value.layout==="home"?!1:o.value.aside!=null?!!o.value.aside:t.value.aside!==!1),L=y(()=>d.value&&s.value),_=y(()=>d.value?_t(l.value):[]);function P(){n.value=!0}function S(){n.value=!1}function A(){n.value?S():P()}return{isOpen:n,sidebar:l,sidebarGroups:_,hasSidebar:d,hasAside:b,leftAside:v,isSidebarEnabled:L,open:P,close:S,toggle:A}}function kt(o,e){let t;Z(()=>{t=o.value?document.activeElement:void 0}),j(()=>{window.addEventListener("keyup",s)}),pe(()=>{window.removeEventListener("keyup",s)});function s(n){n.key==="Escape"&&o.value&&(e(),t==null||t.focus())}}function gt(o){const{page:e,hash:t}=V(),s=T(!1),n=y(()=>o.value.collapsed!=null),i=y(()=>!!o.value.link),l=T(!1),d=()=>{l.value=K(e.value.relativePath,o.value.link)};F([e,o,t],d),j(d);const v=y(()=>l.value?!0:o.value.items?ce(e.value.relativePath,o.value.items):!1),b=y(()=>!!(o.value.items&&o.value.items.length));Z(()=>{s.value=!!(n.value&&o.value.collapsed)}),fe(()=>{(l.value||v.value)&&(s.value=!1)});function L(){n.value&&(s.value=!s.value)}return{collapsed:s,collapsible:n,isLink:i,isActiveLink:l,hasActiveLink:v,hasChildren:b,toggle:L}}function $t(){const{hasSidebar:o}=O(),e=re("(min-width: 960px)"),t=re("(min-width: 1280px)");return{isAsideEnabled:y(()=>!t.value&&!e.value?!1:o.value?t.value:e.value)}}const ue=[];function Ce(o){return typeof o.outline=="object"&&!Array.isArray(o.outline)&&o.outline.label||o.outlineTitle||"On this page"}function _e(o){const e=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(t=>t.id&&t.hasChildNodes()).map(t=>{const s=Number(t.tagName[1]);return{element:t,title:yt(t),link:"#"+t.id,level:s}});return Pt(e,o)}function yt(o){let e="";for(const t of o.childNodes)if(t.nodeType===1){if(t.classList.contains("VPBadge")||t.classList.contains("header-anchor")||t.classList.contains("ignore-header"))continue;e+=t.textContent}else t.nodeType===3&&(e+=t.textContent);return e.trim()}function Pt(o,e){if(e===!1)return[];const t=(typeof e=="object"&&!Array.isArray(e)?e.level:e)||2,[s,n]=typeof t=="number"?[t,t]:t==="deep"?[2,6]:t;return Vt(o,s,n)}function St(o,e){const{isAsideEnabled:t}=$t(),s=it(i,100);let n=null;j(()=>{requestAnimationFrame(i),window.addEventListener("scroll",s)}),Ke(()=>{l(location.hash)}),pe(()=>{window.removeEventListener("scroll",s)});function i(){if(!t.value)return;const d=window.scrollY,v=window.innerHeight,b=document.body.offsetHeight,L=Math.abs(d+v-b)<1,_=ue.map(({element:S,link:A})=>({link:A,top:Lt(S)})).filter(({top:S})=>!Number.isNaN(S)).sort((S,A)=>S.top-A.top);if(!_.length){l(null);return}if(d<1){l(null);return}if(L){l(_[_.length-1].link);return}let P=null;for(const{link:S,top:A}of _){if(A>d+Re()+4)break;P=S}l(P)}function l(d){n&&n.classList.remove("active"),d==null?n=null:n=o.value.querySelector(`a[href="${decodeURIComponent(d)}"]`);const v=n;v?(v.classList.add("active"),e.value.style.top=v.offsetTop+39+"px",e.value.style.opacity="1"):(e.value.style.top="33px",e.value.style.opacity="0")}}function Lt(o){let e=0;for(;o!==document.body;){if(o===null)return NaN;e+=o.offsetTop,o=o.offsetParent}return e}function Vt(o,e,t){ue.length=0;const s=[],n=[];return o.forEach(i=>{const l={...i,children:[]};let d=n[n.length-1];for(;d&&d.level>=l.level;)n.pop(),d=n[n.length-1];if(l.element.classList.contains("ignore-header")||d&&"shouldIgnore"in d){n.push({level:l.level,shouldIgnore:!0});return}l.level>t||l.level{const n=R("VPDocOutlineItem",!0);return a(),u("ul",{class:I(["VPDocOutlineItem",t.root?"root":"nested"])},[(a(!0),u(M,null,B(t.headers,({children:i,link:l,title:d})=>(a(),u("li",null,[p("a",{class:"outline-link",href:l,onClick:e,title:d},w(d),9,Tt),i!=null&&i.length?(a(),g(n,{key:0,headers:i},null,8,["headers"])):h("",!0)]))),256))],2)}}}),Be=$(Nt,[["__scopeId","data-v-3f927ebe"]]),wt={class:"content"},It={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},Mt=m({__name:"VPDocAsideOutline",setup(o){const{frontmatter:e,theme:t}=V(),s=Le([]);x(()=>{s.value=_e(e.value.outline??t.value.outline)});const n=T(),i=T();return St(n,i),(l,d)=>(a(),u("nav",{"aria-labelledby":"doc-outline-aria-label",class:I(["VPDocAsideOutline",{"has-outline":s.value.length>0}]),ref_key:"container",ref:n},[p("div",wt,[p("div",{class:"outline-marker",ref_key:"marker",ref:i},null,512),p("div",It,w(r(Ce)(r(t))),1),k(Be,{headers:s.value,root:!0},null,8,["headers"])])],2))}}),At=$(Mt,[["__scopeId","data-v-b38bf2ff"]]),Ct={class:"VPDocAsideCarbonAds"},Bt=m({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(o){const e=()=>null;return(t,s)=>(a(),u("div",Ct,[k(r(e),{"carbon-ads":t.carbonAds},null,8,["carbon-ads"])]))}}),Ht={class:"VPDocAside"},Et=m({__name:"VPDocAside",setup(o){const{theme:e}=V();return(t,s)=>(a(),u("div",Ht,[c(t.$slots,"aside-top",{},void 0,!0),c(t.$slots,"aside-outline-before",{},void 0,!0),k(At),c(t.$slots,"aside-outline-after",{},void 0,!0),s[0]||(s[0]=p("div",{class:"spacer"},null,-1)),c(t.$slots,"aside-ads-before",{},void 0,!0),r(e).carbonAds?(a(),g(Bt,{key:0,"carbon-ads":r(e).carbonAds},null,8,["carbon-ads"])):h("",!0),c(t.$slots,"aside-ads-after",{},void 0,!0),c(t.$slots,"aside-bottom",{},void 0,!0)]))}}),Dt=$(Et,[["__scopeId","data-v-6d7b3c46"]]);function Ft(){const{theme:o,page:e}=V();return y(()=>{const{text:t="Edit this page",pattern:s=""}=o.value.editLink||{};let n;return typeof s=="function"?n=s(e.value):n=s.replace(/:path/g,e.value.filePath),{url:n,text:t}})}function Ot(){const{page:o,theme:e,frontmatter:t}=V();return y(()=>{var b,L,_,P,S,A,C,N;const s=Ae(e.value.sidebar,o.value.relativePath),n=bt(s),i=Ut(n,H=>H.link.replace(/[?#].*$/,"")),l=i.findIndex(H=>K(o.value.relativePath,H.link)),d=((b=e.value.docFooter)==null?void 0:b.prev)===!1&&!t.value.prev||t.value.prev===!1,v=((L=e.value.docFooter)==null?void 0:L.next)===!1&&!t.value.next||t.value.next===!1;return{prev:d?void 0:{text:(typeof t.value.prev=="string"?t.value.prev:typeof t.value.prev=="object"?t.value.prev.text:void 0)??((_=i[l-1])==null?void 0:_.docFooterText)??((P=i[l-1])==null?void 0:P.text),link:(typeof t.value.prev=="object"?t.value.prev.link:void 0)??((S=i[l-1])==null?void 0:S.link)},next:v?void 0:{text:(typeof t.value.next=="string"?t.value.next:typeof t.value.next=="object"?t.value.next.text:void 0)??((A=i[l+1])==null?void 0:A.docFooterText)??((C=i[l+1])==null?void 0:C.text),link:(typeof t.value.next=="object"?t.value.next.link:void 0)??((N=i[l+1])==null?void 0:N.link)}}})}function Ut(o,e){const t=new Set;return o.filter(s=>{const n=e(s);return t.has(n)?!1:t.add(n)})}const D=m({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(o){const e=o,t=y(()=>e.tag??(e.href?"a":"span")),s=y(()=>e.href&&Ve.test(e.href)||e.target==="_blank");return(n,i)=>(a(),g(E(t.value),{class:I(["VPLink",{link:n.href,"vp-external-link-icon":s.value,"no-icon":n.noIcon}]),href:n.href?r(me)(n.href):void 0,target:n.target??(s.value?"_blank":void 0),rel:n.rel??(s.value?"noreferrer":void 0)},{default:f(()=>[c(n.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),Gt={class:"VPLastUpdated"},jt=["datetime"],zt=m({__name:"VPDocFooterLastUpdated",setup(o){const{theme:e,page:t,lang:s}=V(),n=y(()=>new Date(t.value.lastUpdated)),i=y(()=>n.value.toISOString()),l=T("");return j(()=>{Z(()=>{var d,v,b;l.value=new Intl.DateTimeFormat((v=(d=e.value.lastUpdated)==null?void 0:d.formatOptions)!=null&&v.forceLocale?s.value:void 0,((b=e.value.lastUpdated)==null?void 0:b.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(n.value)})}),(d,v)=>{var b;return a(),u("p",Gt,[z(w(((b=r(e).lastUpdated)==null?void 0:b.text)||r(e).lastUpdatedText||"Last updated")+": ",1),p("time",{datetime:i.value},w(l.value),9,jt)])}}}),Kt=$(zt,[["__scopeId","data-v-475f71b8"]]),Rt={key:0,class:"VPDocFooter"},qt={key:0,class:"edit-info"},Wt={key:0,class:"edit-link"},Jt={key:1,class:"last-updated"},Yt={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Xt={class:"pager"},Qt=["innerHTML"],Zt=["innerHTML"],xt={class:"pager"},en=["innerHTML"],tn=["innerHTML"],nn=m({__name:"VPDocFooter",setup(o){const{theme:e,page:t,frontmatter:s}=V(),n=Ft(),i=Ot(),l=y(()=>e.value.editLink&&s.value.editLink!==!1),d=y(()=>t.value.lastUpdated),v=y(()=>l.value||d.value||i.value.prev||i.value.next);return(b,L)=>{var _,P,S,A;return v.value?(a(),u("footer",Rt,[c(b.$slots,"doc-footer-before",{},void 0,!0),l.value||d.value?(a(),u("div",qt,[l.value?(a(),u("div",Wt,[k(D,{class:"edit-link-button",href:r(n).url,"no-icon":!0},{default:f(()=>[L[0]||(L[0]=p("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),z(" "+w(r(n).text),1)]),_:1},8,["href"])])):h("",!0),d.value?(a(),u("div",Jt,[k(Kt)])):h("",!0)])):h("",!0),(_=r(i).prev)!=null&&_.link||(P=r(i).next)!=null&&P.link?(a(),u("nav",Yt,[L[1]||(L[1]=p("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),p("div",Xt,[(S=r(i).prev)!=null&&S.link?(a(),g(D,{key:0,class:"pager-link prev",href:r(i).prev.link},{default:f(()=>{var C;return[p("span",{class:"desc",innerHTML:((C=r(e).docFooter)==null?void 0:C.prev)||"Previous page"},null,8,Qt),p("span",{class:"title",innerHTML:r(i).prev.text},null,8,Zt)]}),_:1},8,["href"])):h("",!0)]),p("div",xt,[(A=r(i).next)!=null&&A.link?(a(),g(D,{key:0,class:"pager-link next",href:r(i).next.link},{default:f(()=>{var C;return[p("span",{class:"desc",innerHTML:((C=r(e).docFooter)==null?void 0:C.next)||"Next page"},null,8,en),p("span",{class:"title",innerHTML:r(i).next.text},null,8,tn)]}),_:1},8,["href"])):h("",!0)])])):h("",!0)])):h("",!0)}}}),sn=$(nn,[["__scopeId","data-v-4f9813fa"]]),on={class:"container"},an={class:"aside-container"},rn={class:"aside-content"},ln={class:"content"},cn={class:"content-container"},un={class:"main"},dn=m({__name:"VPDoc",setup(o){const{theme:e}=V(),t=ee(),{hasSidebar:s,hasAside:n,leftAside:i}=O(),l=y(()=>t.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(d,v)=>{const b=R("Content");return a(),u("div",{class:I(["VPDoc",{"has-sidebar":r(s),"has-aside":r(n)}])},[c(d.$slots,"doc-top",{},void 0,!0),p("div",on,[r(n)?(a(),u("div",{key:0,class:I(["aside",{"left-aside":r(i)}])},[v[0]||(v[0]=p("div",{class:"aside-curtain"},null,-1)),p("div",an,[p("div",rn,[k(Dt,null,{"aside-top":f(()=>[c(d.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":f(()=>[c(d.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":f(()=>[c(d.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(d.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(d.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(d.$slots,"aside-ads-after",{},void 0,!0)]),_:3})])])],2)):h("",!0),p("div",ln,[p("div",cn,[c(d.$slots,"doc-before",{},void 0,!0),p("main",un,[k(b,{class:I(["vp-doc",[l.value,r(e).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),k(sn,null,{"doc-footer-before":f(()=>[c(d.$slots,"doc-footer-before",{},void 0,!0)]),_:3}),c(d.$slots,"doc-after",{},void 0,!0)])])]),c(d.$slots,"doc-bottom",{},void 0,!0)],2)}}}),vn=$(dn,[["__scopeId","data-v-83890dd9"]]),pn=m({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(o){const e=o,t=y(()=>e.href&&Ve.test(e.href)),s=y(()=>e.tag||(e.href?"a":"button"));return(n,i)=>(a(),g(E(s.value),{class:I(["VPButton",[n.size,n.theme]]),href:n.href?r(me)(n.href):void 0,target:e.target??(t.value?"_blank":void 0),rel:e.rel??(t.value?"noreferrer":void 0)},{default:f(()=>[z(w(n.text),1)]),_:1},8,["class","href","target","rel"]))}}),fn=$(pn,[["__scopeId","data-v-906d7fb4"]]),hn=["src","alt"],mn=m({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(o){return(e,t)=>{const s=R("VPImage",!0);return e.image?(a(),u(M,{key:0},[typeof e.image=="string"||"src"in e.image?(a(),u("img",G({key:0,class:"VPImage"},typeof e.image=="string"?e.$attrs:{...e.image,...e.$attrs},{src:r(ve)(typeof e.image=="string"?e.image:e.image.src),alt:e.alt??(typeof e.image=="string"?"":e.image.alt||"")}),null,16,hn)):(a(),u(M,{key:1},[k(s,G({class:"dark",image:e.image.dark,alt:e.image.alt},e.$attrs),null,16,["image","alt"]),k(s,G({class:"light",image:e.image.light,alt:e.image.alt},e.$attrs),null,16,["image","alt"])],64))],64)):h("",!0)}}}),Q=$(mn,[["__scopeId","data-v-35a7d0b8"]]),_n={class:"container"},bn={class:"main"},kn={key:0,class:"name"},gn=["innerHTML"],$n=["innerHTML"],yn=["innerHTML"],Pn={key:0,class:"actions"},Sn={key:0,class:"image"},Ln={class:"image-container"},Vn=m({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(o){const e=W("hero-image-slot-exists");return(t,s)=>(a(),u("div",{class:I(["VPHero",{"has-image":t.image||r(e)}])},[p("div",_n,[p("div",bn,[c(t.$slots,"home-hero-info-before",{},void 0,!0),c(t.$slots,"home-hero-info",{},()=>[t.name?(a(),u("h1",kn,[p("span",{innerHTML:t.name,class:"clip"},null,8,gn)])):h("",!0),t.text?(a(),u("p",{key:1,innerHTML:t.text,class:"text"},null,8,$n)):h("",!0),t.tagline?(a(),u("p",{key:2,innerHTML:t.tagline,class:"tagline"},null,8,yn)):h("",!0)],!0),c(t.$slots,"home-hero-info-after",{},void 0,!0),t.actions?(a(),u("div",Pn,[(a(!0),u(M,null,B(t.actions,n=>(a(),u("div",{key:n.link,class:"action"},[k(fn,{tag:"a",size:"medium",theme:n.theme,text:n.text,href:n.link,target:n.target,rel:n.rel},null,8,["theme","text","href","target","rel"])]))),128))])):h("",!0),c(t.$slots,"home-hero-actions-after",{},void 0,!0)]),t.image||r(e)?(a(),u("div",Sn,[p("div",Ln,[s[0]||(s[0]=p("div",{class:"image-bg"},null,-1)),c(t.$slots,"home-hero-image",{},()=>[t.image?(a(),g(Q,{key:0,class:"image-src",image:t.image},null,8,["image"])):h("",!0)],!0)])])):h("",!0)])],2))}}),Tn=$(Vn,[["__scopeId","data-v-955009fc"]]),Nn=m({__name:"VPHomeHero",setup(o){const{frontmatter:e}=V();return(t,s)=>r(e).hero?(a(),g(Tn,{key:0,class:"VPHomeHero",name:r(e).hero.name,text:r(e).hero.text,tagline:r(e).hero.tagline,image:r(e).hero.image,actions:r(e).hero.actions},{"home-hero-info-before":f(()=>[c(t.$slots,"home-hero-info-before")]),"home-hero-info":f(()=>[c(t.$slots,"home-hero-info")]),"home-hero-info-after":f(()=>[c(t.$slots,"home-hero-info-after")]),"home-hero-actions-after":f(()=>[c(t.$slots,"home-hero-actions-after")]),"home-hero-image":f(()=>[c(t.$slots,"home-hero-image")]),_:3},8,["name","text","tagline","image","actions"])):h("",!0)}}),wn={class:"box"},In={key:0,class:"icon"},Mn=["innerHTML"],An=["innerHTML"],Cn=["innerHTML"],Bn={key:4,class:"link-text"},Hn={class:"link-text-value"},En=m({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(o){return(e,t)=>(a(),g(D,{class:"VPFeature",href:e.link,rel:e.rel,target:e.target,"no-icon":!0,tag:e.link?"a":"div"},{default:f(()=>[p("article",wn,[typeof e.icon=="object"&&e.icon.wrap?(a(),u("div",In,[k(Q,{image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])])):typeof e.icon=="object"?(a(),g(Q,{key:1,image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])):e.icon?(a(),u("div",{key:2,class:"icon",innerHTML:e.icon},null,8,Mn)):h("",!0),p("h2",{class:"title",innerHTML:e.title},null,8,An),e.details?(a(),u("p",{key:3,class:"details",innerHTML:e.details},null,8,Cn)):h("",!0),e.linkText?(a(),u("div",Bn,[p("p",Hn,[z(w(e.linkText)+" ",1),t[0]||(t[0]=p("span",{class:"vpi-arrow-right link-text-icon"},null,-1))])])):h("",!0)])]),_:1},8,["href","rel","target","tag"]))}}),Dn=$(En,[["__scopeId","data-v-f5e9645b"]]),Fn={key:0,class:"VPFeatures"},On={class:"container"},Un={class:"items"},Gn=m({__name:"VPFeatures",props:{features:{}},setup(o){const e=o,t=y(()=>{const s=e.features.length;if(s){if(s===2)return"grid-2";if(s===3)return"grid-3";if(s%3===0)return"grid-6";if(s>3)return"grid-4"}else return});return(s,n)=>s.features?(a(),u("div",Fn,[p("div",On,[p("div",Un,[(a(!0),u(M,null,B(s.features,i=>(a(),u("div",{key:i.title,class:I(["item",[t.value]])},[k(Dn,{icon:i.icon,title:i.title,details:i.details,link:i.link,"link-text":i.linkText,rel:i.rel,target:i.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):h("",!0)}}),jn=$(Gn,[["__scopeId","data-v-d0a190d7"]]),zn=m({__name:"VPHomeFeatures",setup(o){const{frontmatter:e}=V();return(t,s)=>r(e).features?(a(),g(jn,{key:0,class:"VPHomeFeatures",features:r(e).features},null,8,["features"])):h("",!0)}}),Kn=m({__name:"VPHomeContent",setup(o){const{width:e}=qe({initialWidth:0,includeScrollbar:!1});return(t,s)=>(a(),u("div",{class:"vp-doc container",style:Te(r(e)?{"--vp-offset":`calc(50% - ${r(e)/2}px)`}:{})},[c(t.$slots,"default",{},void 0,!0)],4))}}),Rn=$(Kn,[["__scopeId","data-v-7a48a447"]]),qn={class:"VPHome"},Wn=m({__name:"VPHome",setup(o){const{frontmatter:e}=V();return(t,s)=>{const n=R("Content");return a(),u("div",qn,[c(t.$slots,"home-hero-before",{},void 0,!0),k(Nn,null,{"home-hero-info-before":f(()=>[c(t.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(t.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(t.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(t.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(t.$slots,"home-hero-image",{},void 0,!0)]),_:3}),c(t.$slots,"home-hero-after",{},void 0,!0),c(t.$slots,"home-features-before",{},void 0,!0),k(zn),c(t.$slots,"home-features-after",{},void 0,!0),r(e).markdownStyles!==!1?(a(),g(Rn,{key:0},{default:f(()=>[k(n)]),_:1})):(a(),g(n,{key:1}))])}}}),Jn=$(Wn,[["__scopeId","data-v-cbb6ec48"]]),Yn={},Xn={class:"VPPage"};function Qn(o,e){const t=R("Content");return a(),u("div",Xn,[c(o.$slots,"page-top"),k(t),c(o.$slots,"page-bottom")])}const Zn=$(Yn,[["render",Qn]]),xn=m({__name:"VPContent",setup(o){const{page:e,frontmatter:t}=V(),{hasSidebar:s}=O();return(n,i)=>(a(),u("div",{class:I(["VPContent",{"has-sidebar":r(s),"is-home":r(t).layout==="home"}]),id:"VPContent"},[r(e).isNotFound?c(n.$slots,"not-found",{key:0},()=>[k(mt)],!0):r(t).layout==="page"?(a(),g(Zn,{key:1},{"page-top":f(()=>[c(n.$slots,"page-top",{},void 0,!0)]),"page-bottom":f(()=>[c(n.$slots,"page-bottom",{},void 0,!0)]),_:3})):r(t).layout==="home"?(a(),g(Jn,{key:2},{"home-hero-before":f(()=>[c(n.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":f(()=>[c(n.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(n.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(n.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(n.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(n.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":f(()=>[c(n.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":f(()=>[c(n.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":f(()=>[c(n.$slots,"home-features-after",{},void 0,!0)]),_:3})):r(t).layout&&r(t).layout!=="doc"?(a(),g(E(r(t).layout),{key:3})):(a(),g(vn,{key:4},{"doc-top":f(()=>[c(n.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":f(()=>[c(n.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":f(()=>[c(n.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":f(()=>[c(n.$slots,"doc-before",{},void 0,!0)]),"doc-after":f(()=>[c(n.$slots,"doc-after",{},void 0,!0)]),"aside-top":f(()=>[c(n.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":f(()=>[c(n.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(n.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(n.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(n.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":f(()=>[c(n.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),es=$(xn,[["__scopeId","data-v-91765379"]]),ts={class:"container"},ns=["innerHTML"],ss=["innerHTML"],os=m({__name:"VPFooter",setup(o){const{theme:e,frontmatter:t}=V(),{hasSidebar:s}=O();return(n,i)=>r(e).footer&&r(t).footer!==!1?(a(),u("footer",{key:0,class:I(["VPFooter",{"has-sidebar":r(s)}])},[p("div",ts,[r(e).footer.message?(a(),u("p",{key:0,class:"message",innerHTML:r(e).footer.message},null,8,ns)):h("",!0),r(e).footer.copyright?(a(),u("p",{key:1,class:"copyright",innerHTML:r(e).footer.copyright},null,8,ss)):h("",!0)])],2)):h("",!0)}}),as=$(os,[["__scopeId","data-v-c970a860"]]);function rs(){const{theme:o,frontmatter:e}=V(),t=Le([]),s=y(()=>t.value.length>0);return x(()=>{t.value=_e(e.value.outline??o.value.outline)}),{headers:t,hasLocalNav:s}}const is={class:"menu-text"},ls={class:"header"},cs={class:"outline"},us=m({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(o){const e=o,{theme:t}=V(),s=T(!1),n=T(0),i=T(),l=T();function d(_){var P;(P=i.value)!=null&&P.contains(_.target)||(s.value=!1)}F(s,_=>{if(_){document.addEventListener("click",d);return}document.removeEventListener("click",d)}),ie("Escape",()=>{s.value=!1}),x(()=>{s.value=!1});function v(){s.value=!s.value,n.value=window.innerHeight+Math.min(window.scrollY-e.navHeight,0)}function b(_){_.target.classList.contains("outline-link")&&(l.value&&(l.value.style.transition="none"),Ne(()=>{s.value=!1}))}function L(){s.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(_,P)=>(a(),u("div",{class:"VPLocalNavOutlineDropdown",style:Te({"--vp-vh":n.value+"px"}),ref_key:"main",ref:i},[_.headers.length>0?(a(),u("button",{key:0,onClick:v,class:I({open:s.value})},[p("span",is,w(r(Ce)(r(t))),1),P[0]||(P[0]=p("span",{class:"vpi-chevron-right icon"},null,-1))],2)):(a(),u("button",{key:1,onClick:L},w(r(t).returnToTopLabel||"Return to top"),1)),k(de,{name:"flyout"},{default:f(()=>[s.value?(a(),u("div",{key:0,ref_key:"items",ref:l,class:"items",onClick:b},[p("div",ls,[p("a",{class:"top-link",href:"#",onClick:L},w(r(t).returnToTopLabel||"Return to top"),1)]),p("div",cs,[k(Be,{headers:_.headers},null,8,["headers"])])],512)):h("",!0)]),_:1})],4))}}),ds=$(us,[["__scopeId","data-v-bc9dc845"]]),vs={class:"container"},ps=["aria-expanded"],fs={class:"menu-text"},hs=m({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(o){const{theme:e,frontmatter:t}=V(),{hasSidebar:s}=O(),{headers:n}=rs(),{y:i}=we(),l=T(0);j(()=>{l.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),x(()=>{n.value=_e(t.value.outline??e.value.outline)});const d=y(()=>n.value.length===0),v=y(()=>d.value&&!s.value),b=y(()=>({VPLocalNav:!0,"has-sidebar":s.value,empty:d.value,fixed:v.value}));return(L,_)=>r(t).layout!=="home"&&(!v.value||r(i)>=l.value)?(a(),u("div",{key:0,class:I(b.value)},[p("div",vs,[r(s)?(a(),u("button",{key:0,class:"menu","aria-expanded":L.open,"aria-controls":"VPSidebarNav",onClick:_[0]||(_[0]=P=>L.$emit("open-menu"))},[_[1]||(_[1]=p("span",{class:"vpi-align-left menu-icon"},null,-1)),p("span",fs,w(r(e).sidebarMenuLabel||"Menu"),1)],8,ps)):h("",!0),k(ds,{headers:r(n),navHeight:l.value},null,8,["headers","navHeight"])])],2)):h("",!0)}}),ms=$(hs,[["__scopeId","data-v-070ab83d"]]);function _s(){const o=T(!1);function e(){o.value=!0,window.addEventListener("resize",n)}function t(){o.value=!1,window.removeEventListener("resize",n)}function s(){o.value?t():e()}function n(){window.outerWidth>=768&&t()}const i=ee();return F(()=>i.path,t),{isScreenOpen:o,openScreen:e,closeScreen:t,toggleScreen:s}}const bs={},ks={class:"VPSwitch",type:"button",role:"switch"},gs={class:"check"},$s={key:0,class:"icon"};function ys(o,e){return a(),u("button",ks,[p("span",gs,[o.$slots.default?(a(),u("span",$s,[c(o.$slots,"default",{},void 0,!0)])):h("",!0)])])}const Ps=$(bs,[["render",ys],["__scopeId","data-v-4a1c76db"]]),Ss=m({__name:"VPSwitchAppearance",setup(o){const{isDark:e,theme:t}=V(),s=W("toggle-appearance",()=>{e.value=!e.value}),n=T("");return fe(()=>{n.value=e.value?t.value.lightModeSwitchTitle||"Switch to light theme":t.value.darkModeSwitchTitle||"Switch to dark theme"}),(i,l)=>(a(),g(Ps,{title:n.value,class:"VPSwitchAppearance","aria-checked":r(e),onClick:r(s)},{default:f(()=>l[0]||(l[0]=[p("span",{class:"vpi-sun sun"},null,-1),p("span",{class:"vpi-moon moon"},null,-1)])),_:1},8,["title","aria-checked","onClick"]))}}),be=$(Ss,[["__scopeId","data-v-e40a8bb6"]]),Ls={key:0,class:"VPNavBarAppearance"},Vs=m({__name:"VPNavBarAppearance",setup(o){const{site:e}=V();return(t,s)=>r(e).appearance&&r(e).appearance!=="force-dark"&&r(e).appearance!=="force-auto"?(a(),u("div",Ls,[k(be)])):h("",!0)}}),Ts=$(Vs,[["__scopeId","data-v-af096f4a"]]),ke=T();let He=!1,ae=0;function Ns(o){const e=T(!1);if(te){!He&&ws(),ae++;const t=F(ke,s=>{var n,i,l;s===o.el.value||(n=o.el.value)!=null&&n.contains(s)?(e.value=!0,(i=o.onFocus)==null||i.call(o)):(e.value=!1,(l=o.onBlur)==null||l.call(o))});pe(()=>{t(),ae--,ae||Is()})}return We(e)}function ws(){document.addEventListener("focusin",Ee),He=!0,ke.value=document.activeElement}function Is(){document.removeEventListener("focusin",Ee)}function Ee(){ke.value=document.activeElement}const Ms={class:"VPMenuLink"},As=["innerHTML"],Cs=m({__name:"VPMenuLink",props:{item:{}},setup(o){const{page:e}=V();return(t,s)=>(a(),u("div",Ms,[k(D,{class:I({active:r(K)(r(e).relativePath,t.item.activeMatch||t.item.link,!!t.item.activeMatch)}),href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,As)]),_:1},8,["class","href","target","rel","no-icon"])]))}}),ne=$(Cs,[["__scopeId","data-v-acbfed09"]]),Bs={class:"VPMenuGroup"},Hs={key:0,class:"title"},Es=m({__name:"VPMenuGroup",props:{text:{},items:{}},setup(o){return(e,t)=>(a(),u("div",Bs,[e.text?(a(),u("p",Hs,w(e.text),1)):h("",!0),(a(!0),u(M,null,B(e.items,s=>(a(),u(M,null,["link"in s?(a(),g(ne,{key:0,item:s},null,8,["item"])):h("",!0)],64))),256))]))}}),Ds=$(Es,[["__scopeId","data-v-48c802d0"]]),Fs={class:"VPMenu"},Os={key:0,class:"items"},Us=m({__name:"VPMenu",props:{items:{}},setup(o){return(e,t)=>(a(),u("div",Fs,[e.items?(a(),u("div",Os,[(a(!0),u(M,null,B(e.items,s=>(a(),u(M,{key:JSON.stringify(s)},["link"in s?(a(),g(ne,{key:0,item:s},null,8,["item"])):"component"in s?(a(),g(E(s.component),G({key:1,ref_for:!0},s.props),null,16)):(a(),g(Ds,{key:2,text:s.text,items:s.items},null,8,["text","items"]))],64))),128))])):h("",!0),c(e.$slots,"default",{},void 0,!0)]))}}),Gs=$(Us,[["__scopeId","data-v-7dd3104a"]]),js=["aria-expanded","aria-label"],zs={key:0,class:"text"},Ks=["innerHTML"],Rs={key:1,class:"vpi-more-horizontal icon"},qs={class:"menu"},Ws=m({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(o){const e=T(!1),t=T();Ns({el:t,onBlur:s});function s(){e.value=!1}return(n,i)=>(a(),u("div",{class:"VPFlyout",ref_key:"el",ref:t,onMouseenter:i[1]||(i[1]=l=>e.value=!0),onMouseleave:i[2]||(i[2]=l=>e.value=!1)},[p("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":e.value,"aria-label":n.label,onClick:i[0]||(i[0]=l=>e.value=!e.value)},[n.button||n.icon?(a(),u("span",zs,[n.icon?(a(),u("span",{key:0,class:I([n.icon,"option-icon"])},null,2)):h("",!0),n.button?(a(),u("span",{key:1,innerHTML:n.button},null,8,Ks)):h("",!0),i[3]||(i[3]=p("span",{class:"vpi-chevron-down text-icon"},null,-1))])):(a(),u("span",Rs))],8,js),p("div",qs,[k(Gs,{items:n.items},{default:f(()=>[c(n.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),ge=$(Ws,[["__scopeId","data-v-04f5c5e9"]]),Js=["href","aria-label","innerHTML"],Ys=m({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(o){const e=o,t=y(()=>typeof e.icon=="object"?e.icon.svg:``);return(s,n)=>(a(),u("a",{class:"VPSocialLink no-icon",href:s.link,"aria-label":s.ariaLabel??(typeof s.icon=="string"?s.icon:""),target:"_blank",rel:"noopener",innerHTML:t.value},null,8,Js))}}),Xs=$(Ys,[["__scopeId","data-v-717b8b75"]]),Qs={class:"VPSocialLinks"},Zs=m({__name:"VPSocialLinks",props:{links:{}},setup(o){return(e,t)=>(a(),u("div",Qs,[(a(!0),u(M,null,B(e.links,({link:s,icon:n,ariaLabel:i})=>(a(),g(Xs,{key:s,icon:n,link:s,ariaLabel:i},null,8,["icon","link","ariaLabel"]))),128))]))}}),$e=$(Zs,[["__scopeId","data-v-ee7a9424"]]),xs={key:0,class:"group translations"},eo={class:"trans-title"},to={key:1,class:"group"},no={class:"item appearance"},so={class:"label"},oo={class:"appearance-action"},ao={key:2,class:"group"},ro={class:"item social-links"},io=m({__name:"VPNavBarExtra",setup(o){const{site:e,theme:t}=V(),{localeLinks:s,currentLang:n}=Y({correspondingLink:!0}),i=y(()=>s.value.length&&n.value.label||e.value.appearance||t.value.socialLinks);return(l,d)=>i.value?(a(),g(ge,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:f(()=>[r(s).length&&r(n).label?(a(),u("div",xs,[p("p",eo,w(r(n).label),1),(a(!0),u(M,null,B(r(s),v=>(a(),g(ne,{key:v.link,item:v},null,8,["item"]))),128))])):h("",!0),r(e).appearance&&r(e).appearance!=="force-dark"&&r(e).appearance!=="force-auto"?(a(),u("div",to,[p("div",no,[p("p",so,w(r(t).darkModeSwitchLabel||"Appearance"),1),p("div",oo,[k(be)])])])):h("",!0),r(t).socialLinks?(a(),u("div",ao,[p("div",ro,[k($e,{class:"social-links-list",links:r(t).socialLinks},null,8,["links"])])])):h("",!0)]),_:1})):h("",!0)}}),lo=$(io,[["__scopeId","data-v-925effce"]]),co=["aria-expanded"],uo=m({__name:"VPNavBarHamburger",props:{active:{type:Boolean}},emits:["click"],setup(o){return(e,t)=>(a(),u("button",{type:"button",class:I(["VPNavBarHamburger",{active:e.active}]),"aria-label":"mobile navigation","aria-expanded":e.active,"aria-controls":"VPNavScreen",onClick:t[0]||(t[0]=s=>e.$emit("click"))},t[1]||(t[1]=[p("span",{class:"container"},[p("span",{class:"top"}),p("span",{class:"middle"}),p("span",{class:"bottom"})],-1)]),10,co))}}),vo=$(uo,[["__scopeId","data-v-5dea55bf"]]),po=["innerHTML"],fo=m({__name:"VPNavBarMenuLink",props:{item:{}},setup(o){const{page:e}=V();return(t,s)=>(a(),g(D,{class:I({VPNavBarMenuLink:!0,active:r(K)(r(e).relativePath,t.item.activeMatch||t.item.link,!!t.item.activeMatch)}),href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,tabindex:"0"},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,po)]),_:1},8,["class","href","target","rel","no-icon"]))}}),ho=$(fo,[["__scopeId","data-v-956ec74c"]]),mo=m({__name:"VPNavBarMenuGroup",props:{item:{}},setup(o){const e=o,{page:t}=V(),s=i=>"component"in i?!1:"link"in i?K(t.value.relativePath,i.link,!!e.item.activeMatch):i.items.some(s),n=y(()=>s(e.item));return(i,l)=>(a(),g(ge,{class:I({VPNavBarMenuGroup:!0,active:r(K)(r(t).relativePath,i.item.activeMatch,!!i.item.activeMatch)||n.value}),button:i.item.text,items:i.item.items},null,8,["class","button","items"]))}}),_o={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},bo=m({__name:"VPNavBarMenu",setup(o){const{theme:e}=V();return(t,s)=>r(e).nav?(a(),u("nav",_o,[s[0]||(s[0]=p("span",{id:"main-nav-aria-label",class:"visually-hidden"}," Main Navigation ",-1)),(a(!0),u(M,null,B(r(e).nav,n=>(a(),u(M,{key:JSON.stringify(n)},["link"in n?(a(),g(ho,{key:0,item:n},null,8,["item"])):"component"in n?(a(),g(E(n.component),G({key:1,ref_for:!0},n.props),null,16)):(a(),g(mo,{key:2,item:n},null,8,["item"]))],64))),128))])):h("",!0)}}),ko=$(bo,[["__scopeId","data-v-e6d46098"]]);function go(o){const{localeIndex:e,theme:t}=V();function s(n){var A,C,N;const i=n.split("."),l=(A=t.value.search)==null?void 0:A.options,d=l&&typeof l=="object",v=d&&((N=(C=l.locales)==null?void 0:C[e.value])==null?void 0:N.translations)||null,b=d&&l.translations||null;let L=v,_=b,P=o;const S=i.pop();for(const H of i){let U=null;const q=P==null?void 0:P[H];q&&(U=P=q);const se=_==null?void 0:_[H];se&&(U=_=se);const oe=L==null?void 0:L[H];oe&&(U=L=oe),q||(P=U),se||(_=U),oe||(L=U)}return(L==null?void 0:L[S])??(_==null?void 0:_[S])??(P==null?void 0:P[S])??""}return s}const $o=["aria-label"],yo={class:"DocSearch-Button-Container"},Po={class:"DocSearch-Button-Placeholder"},ye=m({__name:"VPNavBarSearchButton",setup(o){const t=go({button:{buttonText:"Search",buttonAriaLabel:"Search"}});return(s,n)=>(a(),u("button",{type:"button",class:"DocSearch DocSearch-Button","aria-label":r(t)("button.buttonAriaLabel")},[p("span",yo,[n[0]||(n[0]=p("span",{class:"vp-icon DocSearch-Search-Icon"},null,-1)),p("span",Po,w(r(t)("button.buttonText")),1)]),n[1]||(n[1]=p("span",{class:"DocSearch-Button-Keys"},[p("kbd",{class:"DocSearch-Button-Key"}),p("kbd",{class:"DocSearch-Button-Key"},"K")],-1))],8,$o))}}),So={class:"VPNavBarSearch"},Lo={id:"local-search"},Vo={key:1,id:"docsearch"},To=m({__name:"VPNavBarSearch",setup(o){const e=Je(()=>Ye(()=>import("./VPLocalSearchBox.BCyrKH8f.js"),__vite__mapDeps([0,1]))),t=()=>null,{theme:s}=V(),n=T(!1),i=T(!1);j(()=>{});function l(){n.value||(n.value=!0,setTimeout(d,16))}function d(){const _=new Event("keydown");_.key="k",_.metaKey=!0,window.dispatchEvent(_),setTimeout(()=>{document.querySelector(".DocSearch-Modal")||d()},16)}function v(_){const P=_.target,S=P.tagName;return P.isContentEditable||S==="INPUT"||S==="SELECT"||S==="TEXTAREA"}const b=T(!1);ie("k",_=>{(_.ctrlKey||_.metaKey)&&(_.preventDefault(),b.value=!0)}),ie("/",_=>{v(_)||(_.preventDefault(),b.value=!0)});const L="local";return(_,P)=>{var S;return a(),u("div",So,[r(L)==="local"?(a(),u(M,{key:0},[b.value?(a(),g(r(e),{key:0,onClose:P[0]||(P[0]=A=>b.value=!1)})):h("",!0),p("div",Lo,[k(ye,{onClick:P[1]||(P[1]=A=>b.value=!0)})])],64)):r(L)==="algolia"?(a(),u(M,{key:1},[n.value?(a(),g(r(t),{key:0,algolia:((S=r(s).search)==null?void 0:S.options)??r(s).algolia,onVnodeBeforeMount:P[2]||(P[2]=A=>i.value=!0)},null,8,["algolia"])):h("",!0),i.value?h("",!0):(a(),u("div",Vo,[k(ye,{onClick:l})]))],64)):h("",!0)])}}}),No=m({__name:"VPNavBarSocialLinks",setup(o){const{theme:e}=V();return(t,s)=>r(e).socialLinks?(a(),g($e,{key:0,class:"VPNavBarSocialLinks",links:r(e).socialLinks},null,8,["links"])):h("",!0)}}),wo=$(No,[["__scopeId","data-v-164c457f"]]),Io=["href","rel","target"],Mo={key:1},Ao={key:2},Co=m({__name:"VPNavBarTitle",setup(o){const{site:e,theme:t}=V(),{hasSidebar:s}=O(),{currentLang:n}=Y(),i=y(()=>{var v;return typeof t.value.logoLink=="string"?t.value.logoLink:(v=t.value.logoLink)==null?void 0:v.link}),l=y(()=>{var v;return typeof t.value.logoLink=="string"||(v=t.value.logoLink)==null?void 0:v.rel}),d=y(()=>{var v;return typeof t.value.logoLink=="string"||(v=t.value.logoLink)==null?void 0:v.target});return(v,b)=>(a(),u("div",{class:I(["VPNavBarTitle",{"has-sidebar":r(s)}])},[p("a",{class:"title",href:i.value??r(me)(r(n).link),rel:l.value,target:d.value},[c(v.$slots,"nav-bar-title-before",{},void 0,!0),r(t).logo?(a(),g(Q,{key:0,class:"logo",image:r(t).logo},null,8,["image"])):h("",!0),r(t).siteTitle?(a(),u("span",Mo,w(r(t).siteTitle),1)):r(t).siteTitle===void 0?(a(),u("span",Ao,w(r(e).title),1)):h("",!0),c(v.$slots,"nav-bar-title-after",{},void 0,!0)],8,Io)],2))}}),Bo=$(Co,[["__scopeId","data-v-28a961f9"]]),Ho={class:"items"},Eo={class:"title"},Do=m({__name:"VPNavBarTranslations",setup(o){const{theme:e}=V(),{localeLinks:t,currentLang:s}=Y({correspondingLink:!0});return(n,i)=>r(t).length&&r(s).label?(a(),g(ge,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:r(e).langMenuLabel||"Change language"},{default:f(()=>[p("div",Ho,[p("p",Eo,w(r(s).label),1),(a(!0),u(M,null,B(r(t),l=>(a(),g(ne,{key:l.link,item:l},null,8,["item"]))),128))])]),_:1},8,["label"])):h("",!0)}}),Fo=$(Do,[["__scopeId","data-v-c80d9ad0"]]),Oo={class:"wrapper"},Uo={class:"container"},Go={class:"title"},jo={class:"content"},zo={class:"content-body"},Ko=m({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(o){const e=o,{y:t}=we(),{hasSidebar:s}=O(),{frontmatter:n}=V(),i=T({});return fe(()=>{i.value={"has-sidebar":s.value,home:n.value.layout==="home",top:t.value===0,"screen-open":e.isScreenOpen}}),(l,d)=>(a(),u("div",{class:I(["VPNavBar",i.value])},[p("div",Oo,[p("div",Uo,[p("div",Go,[k(Bo,null,{"nav-bar-title-before":f(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),_:3})]),p("div",jo,[p("div",zo,[c(l.$slots,"nav-bar-content-before",{},void 0,!0),k(To,{class:"search"}),k(ko,{class:"menu"}),k(Fo,{class:"translations"}),k(Ts,{class:"appearance"}),k(wo,{class:"social-links"}),k(lo,{class:"extra"}),c(l.$slots,"nav-bar-content-after",{},void 0,!0),k(vo,{class:"hamburger",active:l.isScreenOpen,onClick:d[0]||(d[0]=v=>l.$emit("toggle-screen"))},null,8,["active"])])])])]),d[1]||(d[1]=p("div",{class:"divider"},[p("div",{class:"divider-line"})],-1))],2))}}),Ro=$(Ko,[["__scopeId","data-v-822684d1"]]),qo={key:0,class:"VPNavScreenAppearance"},Wo={class:"text"},Jo=m({__name:"VPNavScreenAppearance",setup(o){const{site:e,theme:t}=V();return(s,n)=>r(e).appearance&&r(e).appearance!=="force-dark"&&r(e).appearance!=="force-auto"?(a(),u("div",qo,[p("p",Wo,w(r(t).darkModeSwitchLabel||"Appearance"),1),k(be)])):h("",!0)}}),Yo=$(Jo,[["__scopeId","data-v-ffb44008"]]),Xo=["innerHTML"],Qo=m({__name:"VPNavScreenMenuLink",props:{item:{}},setup(o){const e=W("close-screen");return(t,s)=>(a(),g(D,{class:"VPNavScreenMenuLink",href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,onClick:r(e)},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,Xo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Zo=$(Qo,[["__scopeId","data-v-735512b8"]]),xo=["innerHTML"],ea=m({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(o){const e=W("close-screen");return(t,s)=>(a(),g(D,{class:"VPNavScreenMenuGroupLink",href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,onClick:r(e)},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,xo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),De=$(ea,[["__scopeId","data-v-372ae7c0"]]),ta={class:"VPNavScreenMenuGroupSection"},na={key:0,class:"title"},sa=m({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(o){return(e,t)=>(a(),u("div",ta,[e.text?(a(),u("p",na,w(e.text),1)):h("",!0),(a(!0),u(M,null,B(e.items,s=>(a(),g(De,{key:s.text,item:s},null,8,["item"]))),128))]))}}),oa=$(sa,[["__scopeId","data-v-4b8941ac"]]),aa=["aria-controls","aria-expanded"],ra=["innerHTML"],ia=["id"],la={key:0,class:"item"},ca={key:1,class:"item"},ua={key:2,class:"group"},da=m({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(o){const e=o,t=T(!1),s=y(()=>`NavScreenGroup-${e.text.replace(" ","-").toLowerCase()}`);function n(){t.value=!t.value}return(i,l)=>(a(),u("div",{class:I(["VPNavScreenMenuGroup",{open:t.value}])},[p("button",{class:"button","aria-controls":s.value,"aria-expanded":t.value,onClick:n},[p("span",{class:"button-text",innerHTML:i.text},null,8,ra),l[0]||(l[0]=p("span",{class:"vpi-plus button-icon"},null,-1))],8,aa),p("div",{id:s.value,class:"items"},[(a(!0),u(M,null,B(i.items,d=>(a(),u(M,{key:JSON.stringify(d)},["link"in d?(a(),u("div",la,[k(De,{item:d},null,8,["item"])])):"component"in d?(a(),u("div",ca,[(a(),g(E(d.component),G({ref_for:!0},d.props,{"screen-menu":""}),null,16))])):(a(),u("div",ua,[k(oa,{text:d.text,items:d.items},null,8,["text","items"])]))],64))),128))],8,ia)],2))}}),va=$(da,[["__scopeId","data-v-875057a5"]]),pa={key:0,class:"VPNavScreenMenu"},fa=m({__name:"VPNavScreenMenu",setup(o){const{theme:e}=V();return(t,s)=>r(e).nav?(a(),u("nav",pa,[(a(!0),u(M,null,B(r(e).nav,n=>(a(),u(M,{key:JSON.stringify(n)},["link"in n?(a(),g(Zo,{key:0,item:n},null,8,["item"])):"component"in n?(a(),g(E(n.component),G({key:1,ref_for:!0},n.props,{"screen-menu":""}),null,16)):(a(),g(va,{key:2,text:n.text||"",items:n.items},null,8,["text","items"]))],64))),128))])):h("",!0)}}),ha=m({__name:"VPNavScreenSocialLinks",setup(o){const{theme:e}=V();return(t,s)=>r(e).socialLinks?(a(),g($e,{key:0,class:"VPNavScreenSocialLinks",links:r(e).socialLinks},null,8,["links"])):h("",!0)}}),ma={class:"list"},_a=m({__name:"VPNavScreenTranslations",setup(o){const{localeLinks:e,currentLang:t}=Y({correspondingLink:!0}),s=T(!1);function n(){s.value=!s.value}return(i,l)=>r(e).length&&r(t).label?(a(),u("div",{key:0,class:I(["VPNavScreenTranslations",{open:s.value}])},[p("button",{class:"title",onClick:n},[l[0]||(l[0]=p("span",{class:"vpi-languages icon lang"},null,-1)),z(" "+w(r(t).label)+" ",1),l[1]||(l[1]=p("span",{class:"vpi-chevron-down icon chevron"},null,-1))]),p("ul",ma,[(a(!0),u(M,null,B(r(e),d=>(a(),u("li",{key:d.link,class:"item"},[k(D,{class:"link",href:d.link},{default:f(()=>[z(w(d.text),1)]),_:2},1032,["href"])]))),128))])],2)):h("",!0)}}),ba=$(_a,[["__scopeId","data-v-362991c2"]]),ka={class:"container"},ga=m({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(o){const e=T(null),t=Ie(te?document.body:null);return(s,n)=>(a(),g(de,{name:"fade",onEnter:n[0]||(n[0]=i=>t.value=!0),onAfterLeave:n[1]||(n[1]=i=>t.value=!1)},{default:f(()=>[s.open?(a(),u("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:e,id:"VPNavScreen"},[p("div",ka,[c(s.$slots,"nav-screen-content-before",{},void 0,!0),k(fa,{class:"menu"}),k(ba,{class:"translations"}),k(Yo,{class:"appearance"}),k(ha,{class:"social-links"}),c(s.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):h("",!0)]),_:3}))}}),$a=$(ga,[["__scopeId","data-v-833aabba"]]),ya={key:0,class:"VPNav"},Pa=m({__name:"VPNav",setup(o){const{isScreenOpen:e,closeScreen:t,toggleScreen:s}=_s(),{frontmatter:n}=V(),i=y(()=>n.value.navbar!==!1);return he("close-screen",t),Z(()=>{te&&document.documentElement.classList.toggle("hide-nav",!i.value)}),(l,d)=>i.value?(a(),u("header",ya,[k(Ro,{"is-screen-open":r(e),onToggleScreen:r(s)},{"nav-bar-title-before":f(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":f(()=>[c(l.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":f(()=>[c(l.$slots,"nav-bar-content-after",{},void 0,!0)]),_:3},8,["is-screen-open","onToggleScreen"]),k($a,{open:r(e)},{"nav-screen-content-before":f(()=>[c(l.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":f(()=>[c(l.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3},8,["open"])])):h("",!0)}}),Sa=$(Pa,[["__scopeId","data-v-f1e365da"]]),La=["role","tabindex"],Va={key:1,class:"items"},Ta=m({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(o){const e=o,{collapsed:t,collapsible:s,isLink:n,isActiveLink:i,hasActiveLink:l,hasChildren:d,toggle:v}=gt(y(()=>e.item)),b=y(()=>d.value?"section":"div"),L=y(()=>n.value?"a":"div"),_=y(()=>d.value?e.depth+2===7?"p":`h${e.depth+2}`:"p"),P=y(()=>n.value?void 0:"button"),S=y(()=>[[`level-${e.depth}`],{collapsible:s.value},{collapsed:t.value},{"is-link":n.value},{"is-active":i.value},{"has-active":l.value}]);function A(N){"key"in N&&N.key!=="Enter"||!e.item.link&&v()}function C(){e.item.link&&v()}return(N,H)=>{const U=R("VPSidebarItem",!0);return a(),g(E(b.value),{class:I(["VPSidebarItem",S.value])},{default:f(()=>[N.item.text?(a(),u("div",G({key:0,class:"item",role:P.value},Qe(N.item.items?{click:A,keydown:A}:{},!0),{tabindex:N.item.items&&0}),[H[1]||(H[1]=p("div",{class:"indicator"},null,-1)),N.item.link?(a(),g(D,{key:0,tag:L.value,class:"link",href:N.item.link,rel:N.item.rel,target:N.item.target},{default:f(()=>[(a(),g(E(_.value),{class:"text",innerHTML:N.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(a(),g(E(_.value),{key:1,class:"text",innerHTML:N.item.text},null,8,["innerHTML"])),N.item.collapsed!=null&&N.item.items&&N.item.items.length?(a(),u("div",{key:2,class:"caret",role:"button","aria-label":"toggle section",onClick:C,onKeydown:Xe(C,["enter"]),tabindex:"0"},H[0]||(H[0]=[p("span",{class:"vpi-chevron-right caret-icon"},null,-1)]),32)):h("",!0)],16,La)):h("",!0),N.item.items&&N.item.items.length?(a(),u("div",Va,[N.depth<5?(a(!0),u(M,{key:0},B(N.item.items,q=>(a(),g(U,{key:q.text,item:q,depth:N.depth+1},null,8,["item","depth"]))),128)):h("",!0)])):h("",!0)]),_:1},8,["class"])}}}),Na=$(Ta,[["__scopeId","data-v-196b2e5f"]]),wa=m({__name:"VPSidebarGroup",props:{items:{}},setup(o){const e=T(!0);let t=null;return j(()=>{t=setTimeout(()=>{t=null,e.value=!1},300)}),Ze(()=>{t!=null&&(clearTimeout(t),t=null)}),(s,n)=>(a(!0),u(M,null,B(s.items,i=>(a(),u("div",{key:i.text,class:I(["group",{"no-transition":e.value}])},[k(Na,{item:i,depth:0},null,8,["item"])],2))),128))}}),Ia=$(wa,[["__scopeId","data-v-9e426adc"]]),Ma={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},Aa=m({__name:"VPSidebar",props:{open:{type:Boolean}},setup(o){const{sidebarGroups:e,hasSidebar:t}=O(),s=o,n=T(null),i=Ie(te?document.body:null);F([s,n],()=>{var d;s.open?(i.value=!0,(d=n.value)==null||d.focus()):i.value=!1},{immediate:!0,flush:"post"});const l=T(0);return F(e,()=>{l.value+=1},{deep:!0}),(d,v)=>r(t)?(a(),u("aside",{key:0,class:I(["VPSidebar",{open:d.open}]),ref_key:"navEl",ref:n,onClick:v[0]||(v[0]=xe(()=>{},["stop"]))},[v[2]||(v[2]=p("div",{class:"curtain"},null,-1)),p("nav",Ma,[v[1]||(v[1]=p("span",{class:"visually-hidden",id:"sidebar-aria-label"}," Sidebar Navigation ",-1)),c(d.$slots,"sidebar-nav-before",{},void 0,!0),(a(),g(Ia,{items:r(e),key:l.value},null,8,["items"])),c(d.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):h("",!0)}}),Ca=$(Aa,[["__scopeId","data-v-18756405"]]),Ba=m({__name:"VPSkipLink",setup(o){const e=ee(),t=T();F(()=>e.path,()=>t.value.focus());function s({target:n}){const i=document.getElementById(decodeURIComponent(n.hash).slice(1));if(i){const l=()=>{i.removeAttribute("tabindex"),i.removeEventListener("blur",l)};i.setAttribute("tabindex","-1"),i.addEventListener("blur",l),i.focus(),window.scrollTo(0,0)}}return(n,i)=>(a(),u(M,null,[p("span",{ref_key:"backToTop",ref:t,tabindex:"-1"},null,512),p("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:s}," Skip to content ")],64))}}),Ha=$(Ba,[["__scopeId","data-v-c3508ec8"]]),Ea=m({__name:"Layout",setup(o){const{isOpen:e,open:t,close:s}=O(),n=ee();F(()=>n.path,s),kt(e,s);const{frontmatter:i}=V(),l=Me(),d=y(()=>!!l["home-hero-image"]);return he("hero-image-slot-exists",d),(v,b)=>{const L=R("Content");return r(i).layout!==!1?(a(),u("div",{key:0,class:I(["Layout",r(i).pageClass])},[c(v.$slots,"layout-top",{},void 0,!0),k(Ha),k(rt,{class:"backdrop",show:r(e),onClick:r(s)},null,8,["show","onClick"]),k(Sa,null,{"nav-bar-title-before":f(()=>[c(v.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(v.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":f(()=>[c(v.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":f(()=>[c(v.$slots,"nav-bar-content-after",{},void 0,!0)]),"nav-screen-content-before":f(()=>[c(v.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":f(()=>[c(v.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3}),k(ms,{open:r(e),onOpenMenu:r(t)},null,8,["open","onOpenMenu"]),k(Ca,{open:r(e)},{"sidebar-nav-before":f(()=>[c(v.$slots,"sidebar-nav-before",{},void 0,!0)]),"sidebar-nav-after":f(()=>[c(v.$slots,"sidebar-nav-after",{},void 0,!0)]),_:3},8,["open"]),k(es,null,{"page-top":f(()=>[c(v.$slots,"page-top",{},void 0,!0)]),"page-bottom":f(()=>[c(v.$slots,"page-bottom",{},void 0,!0)]),"not-found":f(()=>[c(v.$slots,"not-found",{},void 0,!0)]),"home-hero-before":f(()=>[c(v.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":f(()=>[c(v.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(v.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(v.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(v.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(v.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":f(()=>[c(v.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":f(()=>[c(v.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":f(()=>[c(v.$slots,"home-features-after",{},void 0,!0)]),"doc-footer-before":f(()=>[c(v.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":f(()=>[c(v.$slots,"doc-before",{},void 0,!0)]),"doc-after":f(()=>[c(v.$slots,"doc-after",{},void 0,!0)]),"doc-top":f(()=>[c(v.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":f(()=>[c(v.$slots,"doc-bottom",{},void 0,!0)]),"aside-top":f(()=>[c(v.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":f(()=>[c(v.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":f(()=>[c(v.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(v.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(v.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(v.$slots,"aside-ads-after",{},void 0,!0)]),_:3}),k(as),c(v.$slots,"layout-bottom",{},void 0,!0)],2)):(a(),g(L,{key:1}))}}}),Da=$(Ea,[["__scopeId","data-v-a9a9e638"]]),Pe={Layout:Da,enhanceApp:({app:o})=>{o.component("Badge",st)}},Fa=o=>{if(typeof document>"u")return{stabilizeScrollPosition:n=>async(...i)=>n(...i)};const e=document.documentElement;return{stabilizeScrollPosition:s=>async(...n)=>{const i=s(...n),l=o.value;if(!l)return i;const d=l.offsetTop-e.scrollTop;return await Ne(),e.scrollTop=l.offsetTop-d,i}}},Fe="vitepress:tabSharedState",J=typeof localStorage<"u"?localStorage:null,Oe="vitepress:tabsSharedState",Oa=()=>{const o=J==null?void 0:J.getItem(Oe);if(o)try{return JSON.parse(o)}catch{}return{}},Ua=o=>{J&&J.setItem(Oe,JSON.stringify(o))},Ga=o=>{const e=et({});F(()=>e.content,(t,s)=>{t&&s&&Ua(t)},{deep:!0}),o.provide(Fe,e)},ja=(o,e)=>{const t=W(Fe);if(!t)throw new Error("[vitepress-plugin-tabs] TabsSharedState should be injected");j(()=>{t.content||(t.content=Oa())});const s=T(),n=y({get(){var v;const l=e.value,d=o.value;if(l){const b=(v=t.content)==null?void 0:v[l];if(b&&d.includes(b))return b}else{const b=s.value;if(b)return b}return d[0]},set(l){const d=e.value;d?t.content&&(t.content[d]=l):s.value=l}});return{selected:n,select:l=>{n.value=l}}};let Se=0;const za=()=>(Se++,""+Se);function Ka(){const o=Me();return y(()=>{var s;const t=(s=o.default)==null?void 0:s.call(o);return t?t.filter(n=>typeof n.type=="object"&&"__name"in n.type&&n.type.__name==="PluginTabsTab"&&n.props).map(n=>{var i;return(i=n.props)==null?void 0:i.label}):[]})}const Ue="vitepress:tabSingleState",Ra=o=>{he(Ue,o)},qa=()=>{const o=W(Ue);if(!o)throw new Error("[vitepress-plugin-tabs] TabsSingleState should be injected");return o},Wa={class:"plugin-tabs"},Ja=["id","aria-selected","aria-controls","tabindex","onClick"],Ya=m({__name:"PluginTabs",props:{sharedStateKey:{}},setup(o){const e=o,t=Ka(),{selected:s,select:n}=ja(t,tt(e,"sharedStateKey")),i=T(),{stabilizeScrollPosition:l}=Fa(i),d=l(n),v=T([]),b=_=>{var A;const P=t.value.indexOf(s.value);let S;_.key==="ArrowLeft"?S=P>=1?P-1:t.value.length-1:_.key==="ArrowRight"&&(S=P(a(),u("div",Wa,[p("div",{ref_key:"tablist",ref:i,class:"plugin-tabs--tab-list",role:"tablist",onKeydown:b},[(a(!0),u(M,null,B(r(t),S=>(a(),u("button",{id:`tab-${S}-${r(L)}`,ref_for:!0,ref_key:"buttonRefs",ref:v,key:S,role:"tab",class:"plugin-tabs--tab","aria-selected":S===r(s),"aria-controls":`panel-${S}-${r(L)}`,tabindex:S===r(s)?0:-1,onClick:()=>r(d)(S)},w(S),9,Ja))),128))],544),c(_.$slots,"default")]))}}),Xa=["id","aria-labelledby"],Qa=m({__name:"PluginTabsTab",props:{label:{}},setup(o){const{uid:e,selected:t}=qa();return(s,n)=>r(t)===s.label?(a(),u("div",{key:0,id:`panel-${s.label}-${r(e)}`,class:"plugin-tabs--content",role:"tabpanel",tabindex:"0","aria-labelledby":`tab-${s.label}-${r(e)}`},[c(s.$slots,"default",{},void 0,!0)],8,Xa)):h("",!0)}}),Za=$(Qa,[["__scopeId","data-v-9b0d03d2"]]),xa=o=>{Ga(o),o.component("PluginTabs",Ya),o.component("PluginTabsTab",Za)},tr={extends:Pe,Layout(){return nt(Pe.Layout,null,{})},enhanceApp({app:o,router:e,siteData:t}){xa(o)}};export{tr as R,go as c,V as u}; +const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/VPLocalSearchBox.IfQDnsCV.js","assets/chunks/framework.Gz-llJN4.js"])))=>i.map(i=>d[i]); +import{d as m,o as a,c as u,r as c,n as I,a as z,t as w,b as g,w as f,e as h,T as de,_ as $,u as Ge,i as je,f as ze,g as ve,h as y,j as p,k as r,l as K,m as re,p as T,q as F,s as Z,v as j,x as pe,y as fe,z as Ke,A as Re,B as R,F as M,C as B,D as Le,E as x,G as k,H as E,I as Ve,J as ee,K as G,L as W,M as qe,N as Te,O as ie,P as Ne,Q as we,R as te,S as We,U as Je,V as Ye,W as Ie,X as he,Y as Xe,Z as Qe,$ as Ze,a0 as xe,a1 as Me,a2 as et,a3 as tt,a4 as nt}from"./framework.Gz-llJN4.js";const st=m({__name:"VPBadge",props:{text:{},type:{default:"tip"}},setup(o){return(e,t)=>(a(),u("span",{class:I(["VPBadge",e.type])},[c(e.$slots,"default",{},()=>[z(w(e.text),1)])],2))}}),ot={key:0,class:"VPBackdrop"},at=m({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(o){return(e,t)=>(a(),g(de,{name:"fade"},{default:f(()=>[e.show?(a(),u("div",ot)):h("",!0)]),_:1}))}}),rt=$(at,[["__scopeId","data-v-b06cdb19"]]),V=Ge;function it(o,e){let t,s=!1;return()=>{t&&clearTimeout(t),s?t=setTimeout(o,e):(o(),(s=!0)&&setTimeout(()=>s=!1,e))}}function le(o){return/^\//.test(o)?o:`/${o}`}function me(o){const{pathname:e,search:t,hash:s,protocol:n}=new URL(o,"http://a.com");if(je(o)||o.startsWith("#")||!n.startsWith("http")||!ze(e))return o;const{site:i}=V(),l=e.endsWith("/")||e.endsWith(".html")?o:o.replace(/(?:(^\.+)\/)?.*$/,`$1${e.replace(/(\.md)?$/,i.value.cleanUrls?"":".html")}${t}${s}`);return ve(l)}function Y({correspondingLink:o=!1}={}){const{site:e,localeIndex:t,page:s,theme:n,hash:i}=V(),l=y(()=>{var v,b;return{label:(v=e.value.locales[t.value])==null?void 0:v.label,link:((b=e.value.locales[t.value])==null?void 0:b.link)||(t.value==="root"?"/":`/${t.value}/`)}});return{localeLinks:y(()=>Object.entries(e.value.locales).flatMap(([v,b])=>l.value.label===b.label?[]:{text:b.label,link:lt(b.link||(v==="root"?"/":`/${v}/`),n.value.i18nRouting!==!1&&o,s.value.relativePath.slice(l.value.link.length-1),!e.value.cleanUrls)+i.value})),currentLang:l}}function lt(o,e,t,s){return e?o.replace(/\/$/,"")+le(t.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,s?".html":"")):o}const ct={class:"NotFound"},ut={class:"code"},dt={class:"title"},vt={class:"quote"},pt={class:"action"},ft=["href","aria-label"],ht=m({__name:"NotFound",setup(o){const{theme:e}=V(),{currentLang:t}=Y();return(s,n)=>{var i,l,d,v,b;return a(),u("div",ct,[p("p",ut,w(((i=r(e).notFound)==null?void 0:i.code)??"404"),1),p("h1",dt,w(((l=r(e).notFound)==null?void 0:l.title)??"PAGE NOT FOUND"),1),n[0]||(n[0]=p("div",{class:"divider"},null,-1)),p("blockquote",vt,w(((d=r(e).notFound)==null?void 0:d.quote)??"But if you don't change your direction, and if you keep looking, you may end up where you are heading."),1),p("div",pt,[p("a",{class:"link",href:r(ve)(r(t).link),"aria-label":((v=r(e).notFound)==null?void 0:v.linkLabel)??"go to home"},w(((b=r(e).notFound)==null?void 0:b.linkText)??"Take me home"),9,ft)])])}}}),mt=$(ht,[["__scopeId","data-v-951cab6c"]]);function Ae(o,e){if(Array.isArray(o))return X(o);if(o==null)return[];e=le(e);const t=Object.keys(o).sort((n,i)=>i.split("/").length-n.split("/").length).find(n=>e.startsWith(le(n))),s=t?o[t]:[];return Array.isArray(s)?X(s):X(s.items,s.base)}function _t(o){const e=[];let t=0;for(const s in o){const n=o[s];if(n.items){t=e.push(n);continue}e[t]||e.push({items:[]}),e[t].items.push(n)}return e}function bt(o){const e=[];function t(s){for(const n of s)n.text&&n.link&&e.push({text:n.text,link:n.link,docFooterText:n.docFooterText}),n.items&&t(n.items)}return t(o),e}function ce(o,e){return Array.isArray(e)?e.some(t=>ce(o,t)):K(o,e.link)?!0:e.items?ce(o,e.items):!1}function X(o,e){return[...o].map(t=>{const s={...t},n=s.base||e;return n&&s.link&&(s.link=n+s.link),s.items&&(s.items=X(s.items,n)),s})}function O(){const{frontmatter:o,page:e,theme:t}=V(),s=re("(min-width: 960px)"),n=T(!1),i=y(()=>{const C=t.value.sidebar,N=e.value.relativePath;return C?Ae(C,N):[]}),l=T(i.value);F(i,(C,N)=>{JSON.stringify(C)!==JSON.stringify(N)&&(l.value=i.value)});const d=y(()=>o.value.sidebar!==!1&&l.value.length>0&&o.value.layout!=="home"),v=y(()=>b?o.value.aside==null?t.value.aside==="left":o.value.aside==="left":!1),b=y(()=>o.value.layout==="home"?!1:o.value.aside!=null?!!o.value.aside:t.value.aside!==!1),L=y(()=>d.value&&s.value),_=y(()=>d.value?_t(l.value):[]);function P(){n.value=!0}function S(){n.value=!1}function A(){n.value?S():P()}return{isOpen:n,sidebar:l,sidebarGroups:_,hasSidebar:d,hasAside:b,leftAside:v,isSidebarEnabled:L,open:P,close:S,toggle:A}}function kt(o,e){let t;Z(()=>{t=o.value?document.activeElement:void 0}),j(()=>{window.addEventListener("keyup",s)}),pe(()=>{window.removeEventListener("keyup",s)});function s(n){n.key==="Escape"&&o.value&&(e(),t==null||t.focus())}}function gt(o){const{page:e,hash:t}=V(),s=T(!1),n=y(()=>o.value.collapsed!=null),i=y(()=>!!o.value.link),l=T(!1),d=()=>{l.value=K(e.value.relativePath,o.value.link)};F([e,o,t],d),j(d);const v=y(()=>l.value?!0:o.value.items?ce(e.value.relativePath,o.value.items):!1),b=y(()=>!!(o.value.items&&o.value.items.length));Z(()=>{s.value=!!(n.value&&o.value.collapsed)}),fe(()=>{(l.value||v.value)&&(s.value=!1)});function L(){n.value&&(s.value=!s.value)}return{collapsed:s,collapsible:n,isLink:i,isActiveLink:l,hasActiveLink:v,hasChildren:b,toggle:L}}function $t(){const{hasSidebar:o}=O(),e=re("(min-width: 960px)"),t=re("(min-width: 1280px)");return{isAsideEnabled:y(()=>!t.value&&!e.value?!1:o.value?t.value:e.value)}}const ue=[];function Ce(o){return typeof o.outline=="object"&&!Array.isArray(o.outline)&&o.outline.label||o.outlineTitle||"On this page"}function _e(o){const e=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(t=>t.id&&t.hasChildNodes()).map(t=>{const s=Number(t.tagName[1]);return{element:t,title:yt(t),link:"#"+t.id,level:s}});return Pt(e,o)}function yt(o){let e="";for(const t of o.childNodes)if(t.nodeType===1){if(t.classList.contains("VPBadge")||t.classList.contains("header-anchor")||t.classList.contains("ignore-header"))continue;e+=t.textContent}else t.nodeType===3&&(e+=t.textContent);return e.trim()}function Pt(o,e){if(e===!1)return[];const t=(typeof e=="object"&&!Array.isArray(e)?e.level:e)||2,[s,n]=typeof t=="number"?[t,t]:t==="deep"?[2,6]:t;return Vt(o,s,n)}function St(o,e){const{isAsideEnabled:t}=$t(),s=it(i,100);let n=null;j(()=>{requestAnimationFrame(i),window.addEventListener("scroll",s)}),Ke(()=>{l(location.hash)}),pe(()=>{window.removeEventListener("scroll",s)});function i(){if(!t.value)return;const d=window.scrollY,v=window.innerHeight,b=document.body.offsetHeight,L=Math.abs(d+v-b)<1,_=ue.map(({element:S,link:A})=>({link:A,top:Lt(S)})).filter(({top:S})=>!Number.isNaN(S)).sort((S,A)=>S.top-A.top);if(!_.length){l(null);return}if(d<1){l(null);return}if(L){l(_[_.length-1].link);return}let P=null;for(const{link:S,top:A}of _){if(A>d+Re()+4)break;P=S}l(P)}function l(d){n&&n.classList.remove("active"),d==null?n=null:n=o.value.querySelector(`a[href="${decodeURIComponent(d)}"]`);const v=n;v?(v.classList.add("active"),e.value.style.top=v.offsetTop+39+"px",e.value.style.opacity="1"):(e.value.style.top="33px",e.value.style.opacity="0")}}function Lt(o){let e=0;for(;o!==document.body;){if(o===null)return NaN;e+=o.offsetTop,o=o.offsetParent}return e}function Vt(o,e,t){ue.length=0;const s=[],n=[];return o.forEach(i=>{const l={...i,children:[]};let d=n[n.length-1];for(;d&&d.level>=l.level;)n.pop(),d=n[n.length-1];if(l.element.classList.contains("ignore-header")||d&&"shouldIgnore"in d){n.push({level:l.level,shouldIgnore:!0});return}l.level>t||l.level{const n=R("VPDocOutlineItem",!0);return a(),u("ul",{class:I(["VPDocOutlineItem",t.root?"root":"nested"])},[(a(!0),u(M,null,B(t.headers,({children:i,link:l,title:d})=>(a(),u("li",null,[p("a",{class:"outline-link",href:l,onClick:e,title:d},w(d),9,Tt),i!=null&&i.length?(a(),g(n,{key:0,headers:i},null,8,["headers"])):h("",!0)]))),256))],2)}}}),Be=$(Nt,[["__scopeId","data-v-3f927ebe"]]),wt={class:"content"},It={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},Mt=m({__name:"VPDocAsideOutline",setup(o){const{frontmatter:e,theme:t}=V(),s=Le([]);x(()=>{s.value=_e(e.value.outline??t.value.outline)});const n=T(),i=T();return St(n,i),(l,d)=>(a(),u("nav",{"aria-labelledby":"doc-outline-aria-label",class:I(["VPDocAsideOutline",{"has-outline":s.value.length>0}]),ref_key:"container",ref:n},[p("div",wt,[p("div",{class:"outline-marker",ref_key:"marker",ref:i},null,512),p("div",It,w(r(Ce)(r(t))),1),k(Be,{headers:s.value,root:!0},null,8,["headers"])])],2))}}),At=$(Mt,[["__scopeId","data-v-b38bf2ff"]]),Ct={class:"VPDocAsideCarbonAds"},Bt=m({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(o){const e=()=>null;return(t,s)=>(a(),u("div",Ct,[k(r(e),{"carbon-ads":t.carbonAds},null,8,["carbon-ads"])]))}}),Ht={class:"VPDocAside"},Et=m({__name:"VPDocAside",setup(o){const{theme:e}=V();return(t,s)=>(a(),u("div",Ht,[c(t.$slots,"aside-top",{},void 0,!0),c(t.$slots,"aside-outline-before",{},void 0,!0),k(At),c(t.$slots,"aside-outline-after",{},void 0,!0),s[0]||(s[0]=p("div",{class:"spacer"},null,-1)),c(t.$slots,"aside-ads-before",{},void 0,!0),r(e).carbonAds?(a(),g(Bt,{key:0,"carbon-ads":r(e).carbonAds},null,8,["carbon-ads"])):h("",!0),c(t.$slots,"aside-ads-after",{},void 0,!0),c(t.$slots,"aside-bottom",{},void 0,!0)]))}}),Dt=$(Et,[["__scopeId","data-v-6d7b3c46"]]);function Ft(){const{theme:o,page:e}=V();return y(()=>{const{text:t="Edit this page",pattern:s=""}=o.value.editLink||{};let n;return typeof s=="function"?n=s(e.value):n=s.replace(/:path/g,e.value.filePath),{url:n,text:t}})}function Ot(){const{page:o,theme:e,frontmatter:t}=V();return y(()=>{var b,L,_,P,S,A,C,N;const s=Ae(e.value.sidebar,o.value.relativePath),n=bt(s),i=Ut(n,H=>H.link.replace(/[?#].*$/,"")),l=i.findIndex(H=>K(o.value.relativePath,H.link)),d=((b=e.value.docFooter)==null?void 0:b.prev)===!1&&!t.value.prev||t.value.prev===!1,v=((L=e.value.docFooter)==null?void 0:L.next)===!1&&!t.value.next||t.value.next===!1;return{prev:d?void 0:{text:(typeof t.value.prev=="string"?t.value.prev:typeof t.value.prev=="object"?t.value.prev.text:void 0)??((_=i[l-1])==null?void 0:_.docFooterText)??((P=i[l-1])==null?void 0:P.text),link:(typeof t.value.prev=="object"?t.value.prev.link:void 0)??((S=i[l-1])==null?void 0:S.link)},next:v?void 0:{text:(typeof t.value.next=="string"?t.value.next:typeof t.value.next=="object"?t.value.next.text:void 0)??((A=i[l+1])==null?void 0:A.docFooterText)??((C=i[l+1])==null?void 0:C.text),link:(typeof t.value.next=="object"?t.value.next.link:void 0)??((N=i[l+1])==null?void 0:N.link)}}})}function Ut(o,e){const t=new Set;return o.filter(s=>{const n=e(s);return t.has(n)?!1:t.add(n)})}const D=m({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(o){const e=o,t=y(()=>e.tag??(e.href?"a":"span")),s=y(()=>e.href&&Ve.test(e.href)||e.target==="_blank");return(n,i)=>(a(),g(E(t.value),{class:I(["VPLink",{link:n.href,"vp-external-link-icon":s.value,"no-icon":n.noIcon}]),href:n.href?r(me)(n.href):void 0,target:n.target??(s.value?"_blank":void 0),rel:n.rel??(s.value?"noreferrer":void 0)},{default:f(()=>[c(n.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),Gt={class:"VPLastUpdated"},jt=["datetime"],zt=m({__name:"VPDocFooterLastUpdated",setup(o){const{theme:e,page:t,lang:s}=V(),n=y(()=>new Date(t.value.lastUpdated)),i=y(()=>n.value.toISOString()),l=T("");return j(()=>{Z(()=>{var d,v,b;l.value=new Intl.DateTimeFormat((v=(d=e.value.lastUpdated)==null?void 0:d.formatOptions)!=null&&v.forceLocale?s.value:void 0,((b=e.value.lastUpdated)==null?void 0:b.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(n.value)})}),(d,v)=>{var b;return a(),u("p",Gt,[z(w(((b=r(e).lastUpdated)==null?void 0:b.text)||r(e).lastUpdatedText||"Last updated")+": ",1),p("time",{datetime:i.value},w(l.value),9,jt)])}}}),Kt=$(zt,[["__scopeId","data-v-475f71b8"]]),Rt={key:0,class:"VPDocFooter"},qt={key:0,class:"edit-info"},Wt={key:0,class:"edit-link"},Jt={key:1,class:"last-updated"},Yt={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Xt={class:"pager"},Qt=["innerHTML"],Zt=["innerHTML"],xt={class:"pager"},en=["innerHTML"],tn=["innerHTML"],nn=m({__name:"VPDocFooter",setup(o){const{theme:e,page:t,frontmatter:s}=V(),n=Ft(),i=Ot(),l=y(()=>e.value.editLink&&s.value.editLink!==!1),d=y(()=>t.value.lastUpdated),v=y(()=>l.value||d.value||i.value.prev||i.value.next);return(b,L)=>{var _,P,S,A;return v.value?(a(),u("footer",Rt,[c(b.$slots,"doc-footer-before",{},void 0,!0),l.value||d.value?(a(),u("div",qt,[l.value?(a(),u("div",Wt,[k(D,{class:"edit-link-button",href:r(n).url,"no-icon":!0},{default:f(()=>[L[0]||(L[0]=p("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),z(" "+w(r(n).text),1)]),_:1},8,["href"])])):h("",!0),d.value?(a(),u("div",Jt,[k(Kt)])):h("",!0)])):h("",!0),(_=r(i).prev)!=null&&_.link||(P=r(i).next)!=null&&P.link?(a(),u("nav",Yt,[L[1]||(L[1]=p("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),p("div",Xt,[(S=r(i).prev)!=null&&S.link?(a(),g(D,{key:0,class:"pager-link prev",href:r(i).prev.link},{default:f(()=>{var C;return[p("span",{class:"desc",innerHTML:((C=r(e).docFooter)==null?void 0:C.prev)||"Previous page"},null,8,Qt),p("span",{class:"title",innerHTML:r(i).prev.text},null,8,Zt)]}),_:1},8,["href"])):h("",!0)]),p("div",xt,[(A=r(i).next)!=null&&A.link?(a(),g(D,{key:0,class:"pager-link next",href:r(i).next.link},{default:f(()=>{var C;return[p("span",{class:"desc",innerHTML:((C=r(e).docFooter)==null?void 0:C.next)||"Next page"},null,8,en),p("span",{class:"title",innerHTML:r(i).next.text},null,8,tn)]}),_:1},8,["href"])):h("",!0)])])):h("",!0)])):h("",!0)}}}),sn=$(nn,[["__scopeId","data-v-4f9813fa"]]),on={class:"container"},an={class:"aside-container"},rn={class:"aside-content"},ln={class:"content"},cn={class:"content-container"},un={class:"main"},dn=m({__name:"VPDoc",setup(o){const{theme:e}=V(),t=ee(),{hasSidebar:s,hasAside:n,leftAside:i}=O(),l=y(()=>t.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(d,v)=>{const b=R("Content");return a(),u("div",{class:I(["VPDoc",{"has-sidebar":r(s),"has-aside":r(n)}])},[c(d.$slots,"doc-top",{},void 0,!0),p("div",on,[r(n)?(a(),u("div",{key:0,class:I(["aside",{"left-aside":r(i)}])},[v[0]||(v[0]=p("div",{class:"aside-curtain"},null,-1)),p("div",an,[p("div",rn,[k(Dt,null,{"aside-top":f(()=>[c(d.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":f(()=>[c(d.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":f(()=>[c(d.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(d.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(d.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(d.$slots,"aside-ads-after",{},void 0,!0)]),_:3})])])],2)):h("",!0),p("div",ln,[p("div",cn,[c(d.$slots,"doc-before",{},void 0,!0),p("main",un,[k(b,{class:I(["vp-doc",[l.value,r(e).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),k(sn,null,{"doc-footer-before":f(()=>[c(d.$slots,"doc-footer-before",{},void 0,!0)]),_:3}),c(d.$slots,"doc-after",{},void 0,!0)])])]),c(d.$slots,"doc-bottom",{},void 0,!0)],2)}}}),vn=$(dn,[["__scopeId","data-v-83890dd9"]]),pn=m({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(o){const e=o,t=y(()=>e.href&&Ve.test(e.href)),s=y(()=>e.tag||(e.href?"a":"button"));return(n,i)=>(a(),g(E(s.value),{class:I(["VPButton",[n.size,n.theme]]),href:n.href?r(me)(n.href):void 0,target:e.target??(t.value?"_blank":void 0),rel:e.rel??(t.value?"noreferrer":void 0)},{default:f(()=>[z(w(n.text),1)]),_:1},8,["class","href","target","rel"]))}}),fn=$(pn,[["__scopeId","data-v-906d7fb4"]]),hn=["src","alt"],mn=m({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(o){return(e,t)=>{const s=R("VPImage",!0);return e.image?(a(),u(M,{key:0},[typeof e.image=="string"||"src"in e.image?(a(),u("img",G({key:0,class:"VPImage"},typeof e.image=="string"?e.$attrs:{...e.image,...e.$attrs},{src:r(ve)(typeof e.image=="string"?e.image:e.image.src),alt:e.alt??(typeof e.image=="string"?"":e.image.alt||"")}),null,16,hn)):(a(),u(M,{key:1},[k(s,G({class:"dark",image:e.image.dark,alt:e.image.alt},e.$attrs),null,16,["image","alt"]),k(s,G({class:"light",image:e.image.light,alt:e.image.alt},e.$attrs),null,16,["image","alt"])],64))],64)):h("",!0)}}}),Q=$(mn,[["__scopeId","data-v-35a7d0b8"]]),_n={class:"container"},bn={class:"main"},kn={key:0,class:"name"},gn=["innerHTML"],$n=["innerHTML"],yn=["innerHTML"],Pn={key:0,class:"actions"},Sn={key:0,class:"image"},Ln={class:"image-container"},Vn=m({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(o){const e=W("hero-image-slot-exists");return(t,s)=>(a(),u("div",{class:I(["VPHero",{"has-image":t.image||r(e)}])},[p("div",_n,[p("div",bn,[c(t.$slots,"home-hero-info-before",{},void 0,!0),c(t.$slots,"home-hero-info",{},()=>[t.name?(a(),u("h1",kn,[p("span",{innerHTML:t.name,class:"clip"},null,8,gn)])):h("",!0),t.text?(a(),u("p",{key:1,innerHTML:t.text,class:"text"},null,8,$n)):h("",!0),t.tagline?(a(),u("p",{key:2,innerHTML:t.tagline,class:"tagline"},null,8,yn)):h("",!0)],!0),c(t.$slots,"home-hero-info-after",{},void 0,!0),t.actions?(a(),u("div",Pn,[(a(!0),u(M,null,B(t.actions,n=>(a(),u("div",{key:n.link,class:"action"},[k(fn,{tag:"a",size:"medium",theme:n.theme,text:n.text,href:n.link,target:n.target,rel:n.rel},null,8,["theme","text","href","target","rel"])]))),128))])):h("",!0),c(t.$slots,"home-hero-actions-after",{},void 0,!0)]),t.image||r(e)?(a(),u("div",Sn,[p("div",Ln,[s[0]||(s[0]=p("div",{class:"image-bg"},null,-1)),c(t.$slots,"home-hero-image",{},()=>[t.image?(a(),g(Q,{key:0,class:"image-src",image:t.image},null,8,["image"])):h("",!0)],!0)])])):h("",!0)])],2))}}),Tn=$(Vn,[["__scopeId","data-v-955009fc"]]),Nn=m({__name:"VPHomeHero",setup(o){const{frontmatter:e}=V();return(t,s)=>r(e).hero?(a(),g(Tn,{key:0,class:"VPHomeHero",name:r(e).hero.name,text:r(e).hero.text,tagline:r(e).hero.tagline,image:r(e).hero.image,actions:r(e).hero.actions},{"home-hero-info-before":f(()=>[c(t.$slots,"home-hero-info-before")]),"home-hero-info":f(()=>[c(t.$slots,"home-hero-info")]),"home-hero-info-after":f(()=>[c(t.$slots,"home-hero-info-after")]),"home-hero-actions-after":f(()=>[c(t.$slots,"home-hero-actions-after")]),"home-hero-image":f(()=>[c(t.$slots,"home-hero-image")]),_:3},8,["name","text","tagline","image","actions"])):h("",!0)}}),wn={class:"box"},In={key:0,class:"icon"},Mn=["innerHTML"],An=["innerHTML"],Cn=["innerHTML"],Bn={key:4,class:"link-text"},Hn={class:"link-text-value"},En=m({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(o){return(e,t)=>(a(),g(D,{class:"VPFeature",href:e.link,rel:e.rel,target:e.target,"no-icon":!0,tag:e.link?"a":"div"},{default:f(()=>[p("article",wn,[typeof e.icon=="object"&&e.icon.wrap?(a(),u("div",In,[k(Q,{image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])])):typeof e.icon=="object"?(a(),g(Q,{key:1,image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])):e.icon?(a(),u("div",{key:2,class:"icon",innerHTML:e.icon},null,8,Mn)):h("",!0),p("h2",{class:"title",innerHTML:e.title},null,8,An),e.details?(a(),u("p",{key:3,class:"details",innerHTML:e.details},null,8,Cn)):h("",!0),e.linkText?(a(),u("div",Bn,[p("p",Hn,[z(w(e.linkText)+" ",1),t[0]||(t[0]=p("span",{class:"vpi-arrow-right link-text-icon"},null,-1))])])):h("",!0)])]),_:1},8,["href","rel","target","tag"]))}}),Dn=$(En,[["__scopeId","data-v-f5e9645b"]]),Fn={key:0,class:"VPFeatures"},On={class:"container"},Un={class:"items"},Gn=m({__name:"VPFeatures",props:{features:{}},setup(o){const e=o,t=y(()=>{const s=e.features.length;if(s){if(s===2)return"grid-2";if(s===3)return"grid-3";if(s%3===0)return"grid-6";if(s>3)return"grid-4"}else return});return(s,n)=>s.features?(a(),u("div",Fn,[p("div",On,[p("div",Un,[(a(!0),u(M,null,B(s.features,i=>(a(),u("div",{key:i.title,class:I(["item",[t.value]])},[k(Dn,{icon:i.icon,title:i.title,details:i.details,link:i.link,"link-text":i.linkText,rel:i.rel,target:i.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):h("",!0)}}),jn=$(Gn,[["__scopeId","data-v-d0a190d7"]]),zn=m({__name:"VPHomeFeatures",setup(o){const{frontmatter:e}=V();return(t,s)=>r(e).features?(a(),g(jn,{key:0,class:"VPHomeFeatures",features:r(e).features},null,8,["features"])):h("",!0)}}),Kn=m({__name:"VPHomeContent",setup(o){const{width:e}=qe({initialWidth:0,includeScrollbar:!1});return(t,s)=>(a(),u("div",{class:"vp-doc container",style:Te(r(e)?{"--vp-offset":`calc(50% - ${r(e)/2}px)`}:{})},[c(t.$slots,"default",{},void 0,!0)],4))}}),Rn=$(Kn,[["__scopeId","data-v-7a48a447"]]),qn={class:"VPHome"},Wn=m({__name:"VPHome",setup(o){const{frontmatter:e}=V();return(t,s)=>{const n=R("Content");return a(),u("div",qn,[c(t.$slots,"home-hero-before",{},void 0,!0),k(Nn,null,{"home-hero-info-before":f(()=>[c(t.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(t.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(t.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(t.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(t.$slots,"home-hero-image",{},void 0,!0)]),_:3}),c(t.$slots,"home-hero-after",{},void 0,!0),c(t.$slots,"home-features-before",{},void 0,!0),k(zn),c(t.$slots,"home-features-after",{},void 0,!0),r(e).markdownStyles!==!1?(a(),g(Rn,{key:0},{default:f(()=>[k(n)]),_:1})):(a(),g(n,{key:1}))])}}}),Jn=$(Wn,[["__scopeId","data-v-cbb6ec48"]]),Yn={},Xn={class:"VPPage"};function Qn(o,e){const t=R("Content");return a(),u("div",Xn,[c(o.$slots,"page-top"),k(t),c(o.$slots,"page-bottom")])}const Zn=$(Yn,[["render",Qn]]),xn=m({__name:"VPContent",setup(o){const{page:e,frontmatter:t}=V(),{hasSidebar:s}=O();return(n,i)=>(a(),u("div",{class:I(["VPContent",{"has-sidebar":r(s),"is-home":r(t).layout==="home"}]),id:"VPContent"},[r(e).isNotFound?c(n.$slots,"not-found",{key:0},()=>[k(mt)],!0):r(t).layout==="page"?(a(),g(Zn,{key:1},{"page-top":f(()=>[c(n.$slots,"page-top",{},void 0,!0)]),"page-bottom":f(()=>[c(n.$slots,"page-bottom",{},void 0,!0)]),_:3})):r(t).layout==="home"?(a(),g(Jn,{key:2},{"home-hero-before":f(()=>[c(n.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":f(()=>[c(n.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(n.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(n.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(n.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(n.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":f(()=>[c(n.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":f(()=>[c(n.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":f(()=>[c(n.$slots,"home-features-after",{},void 0,!0)]),_:3})):r(t).layout&&r(t).layout!=="doc"?(a(),g(E(r(t).layout),{key:3})):(a(),g(vn,{key:4},{"doc-top":f(()=>[c(n.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":f(()=>[c(n.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":f(()=>[c(n.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":f(()=>[c(n.$slots,"doc-before",{},void 0,!0)]),"doc-after":f(()=>[c(n.$slots,"doc-after",{},void 0,!0)]),"aside-top":f(()=>[c(n.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":f(()=>[c(n.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(n.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(n.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(n.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":f(()=>[c(n.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),es=$(xn,[["__scopeId","data-v-91765379"]]),ts={class:"container"},ns=["innerHTML"],ss=["innerHTML"],os=m({__name:"VPFooter",setup(o){const{theme:e,frontmatter:t}=V(),{hasSidebar:s}=O();return(n,i)=>r(e).footer&&r(t).footer!==!1?(a(),u("footer",{key:0,class:I(["VPFooter",{"has-sidebar":r(s)}])},[p("div",ts,[r(e).footer.message?(a(),u("p",{key:0,class:"message",innerHTML:r(e).footer.message},null,8,ns)):h("",!0),r(e).footer.copyright?(a(),u("p",{key:1,class:"copyright",innerHTML:r(e).footer.copyright},null,8,ss)):h("",!0)])],2)):h("",!0)}}),as=$(os,[["__scopeId","data-v-c970a860"]]);function rs(){const{theme:o,frontmatter:e}=V(),t=Le([]),s=y(()=>t.value.length>0);return x(()=>{t.value=_e(e.value.outline??o.value.outline)}),{headers:t,hasLocalNav:s}}const is={class:"menu-text"},ls={class:"header"},cs={class:"outline"},us=m({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(o){const e=o,{theme:t}=V(),s=T(!1),n=T(0),i=T(),l=T();function d(_){var P;(P=i.value)!=null&&P.contains(_.target)||(s.value=!1)}F(s,_=>{if(_){document.addEventListener("click",d);return}document.removeEventListener("click",d)}),ie("Escape",()=>{s.value=!1}),x(()=>{s.value=!1});function v(){s.value=!s.value,n.value=window.innerHeight+Math.min(window.scrollY-e.navHeight,0)}function b(_){_.target.classList.contains("outline-link")&&(l.value&&(l.value.style.transition="none"),Ne(()=>{s.value=!1}))}function L(){s.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(_,P)=>(a(),u("div",{class:"VPLocalNavOutlineDropdown",style:Te({"--vp-vh":n.value+"px"}),ref_key:"main",ref:i},[_.headers.length>0?(a(),u("button",{key:0,onClick:v,class:I({open:s.value})},[p("span",is,w(r(Ce)(r(t))),1),P[0]||(P[0]=p("span",{class:"vpi-chevron-right icon"},null,-1))],2)):(a(),u("button",{key:1,onClick:L},w(r(t).returnToTopLabel||"Return to top"),1)),k(de,{name:"flyout"},{default:f(()=>[s.value?(a(),u("div",{key:0,ref_key:"items",ref:l,class:"items",onClick:b},[p("div",ls,[p("a",{class:"top-link",href:"#",onClick:L},w(r(t).returnToTopLabel||"Return to top"),1)]),p("div",cs,[k(Be,{headers:_.headers},null,8,["headers"])])],512)):h("",!0)]),_:1})],4))}}),ds=$(us,[["__scopeId","data-v-bc9dc845"]]),vs={class:"container"},ps=["aria-expanded"],fs={class:"menu-text"},hs=m({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(o){const{theme:e,frontmatter:t}=V(),{hasSidebar:s}=O(),{headers:n}=rs(),{y:i}=we(),l=T(0);j(()=>{l.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),x(()=>{n.value=_e(t.value.outline??e.value.outline)});const d=y(()=>n.value.length===0),v=y(()=>d.value&&!s.value),b=y(()=>({VPLocalNav:!0,"has-sidebar":s.value,empty:d.value,fixed:v.value}));return(L,_)=>r(t).layout!=="home"&&(!v.value||r(i)>=l.value)?(a(),u("div",{key:0,class:I(b.value)},[p("div",vs,[r(s)?(a(),u("button",{key:0,class:"menu","aria-expanded":L.open,"aria-controls":"VPSidebarNav",onClick:_[0]||(_[0]=P=>L.$emit("open-menu"))},[_[1]||(_[1]=p("span",{class:"vpi-align-left menu-icon"},null,-1)),p("span",fs,w(r(e).sidebarMenuLabel||"Menu"),1)],8,ps)):h("",!0),k(ds,{headers:r(n),navHeight:l.value},null,8,["headers","navHeight"])])],2)):h("",!0)}}),ms=$(hs,[["__scopeId","data-v-070ab83d"]]);function _s(){const o=T(!1);function e(){o.value=!0,window.addEventListener("resize",n)}function t(){o.value=!1,window.removeEventListener("resize",n)}function s(){o.value?t():e()}function n(){window.outerWidth>=768&&t()}const i=ee();return F(()=>i.path,t),{isScreenOpen:o,openScreen:e,closeScreen:t,toggleScreen:s}}const bs={},ks={class:"VPSwitch",type:"button",role:"switch"},gs={class:"check"},$s={key:0,class:"icon"};function ys(o,e){return a(),u("button",ks,[p("span",gs,[o.$slots.default?(a(),u("span",$s,[c(o.$slots,"default",{},void 0,!0)])):h("",!0)])])}const Ps=$(bs,[["render",ys],["__scopeId","data-v-4a1c76db"]]),Ss=m({__name:"VPSwitchAppearance",setup(o){const{isDark:e,theme:t}=V(),s=W("toggle-appearance",()=>{e.value=!e.value}),n=T("");return fe(()=>{n.value=e.value?t.value.lightModeSwitchTitle||"Switch to light theme":t.value.darkModeSwitchTitle||"Switch to dark theme"}),(i,l)=>(a(),g(Ps,{title:n.value,class:"VPSwitchAppearance","aria-checked":r(e),onClick:r(s)},{default:f(()=>l[0]||(l[0]=[p("span",{class:"vpi-sun sun"},null,-1),p("span",{class:"vpi-moon moon"},null,-1)])),_:1},8,["title","aria-checked","onClick"]))}}),be=$(Ss,[["__scopeId","data-v-e40a8bb6"]]),Ls={key:0,class:"VPNavBarAppearance"},Vs=m({__name:"VPNavBarAppearance",setup(o){const{site:e}=V();return(t,s)=>r(e).appearance&&r(e).appearance!=="force-dark"&&r(e).appearance!=="force-auto"?(a(),u("div",Ls,[k(be)])):h("",!0)}}),Ts=$(Vs,[["__scopeId","data-v-af096f4a"]]),ke=T();let He=!1,ae=0;function Ns(o){const e=T(!1);if(te){!He&&ws(),ae++;const t=F(ke,s=>{var n,i,l;s===o.el.value||(n=o.el.value)!=null&&n.contains(s)?(e.value=!0,(i=o.onFocus)==null||i.call(o)):(e.value=!1,(l=o.onBlur)==null||l.call(o))});pe(()=>{t(),ae--,ae||Is()})}return We(e)}function ws(){document.addEventListener("focusin",Ee),He=!0,ke.value=document.activeElement}function Is(){document.removeEventListener("focusin",Ee)}function Ee(){ke.value=document.activeElement}const Ms={class:"VPMenuLink"},As=["innerHTML"],Cs=m({__name:"VPMenuLink",props:{item:{}},setup(o){const{page:e}=V();return(t,s)=>(a(),u("div",Ms,[k(D,{class:I({active:r(K)(r(e).relativePath,t.item.activeMatch||t.item.link,!!t.item.activeMatch)}),href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,As)]),_:1},8,["class","href","target","rel","no-icon"])]))}}),ne=$(Cs,[["__scopeId","data-v-acbfed09"]]),Bs={class:"VPMenuGroup"},Hs={key:0,class:"title"},Es=m({__name:"VPMenuGroup",props:{text:{},items:{}},setup(o){return(e,t)=>(a(),u("div",Bs,[e.text?(a(),u("p",Hs,w(e.text),1)):h("",!0),(a(!0),u(M,null,B(e.items,s=>(a(),u(M,null,["link"in s?(a(),g(ne,{key:0,item:s},null,8,["item"])):h("",!0)],64))),256))]))}}),Ds=$(Es,[["__scopeId","data-v-48c802d0"]]),Fs={class:"VPMenu"},Os={key:0,class:"items"},Us=m({__name:"VPMenu",props:{items:{}},setup(o){return(e,t)=>(a(),u("div",Fs,[e.items?(a(),u("div",Os,[(a(!0),u(M,null,B(e.items,s=>(a(),u(M,{key:JSON.stringify(s)},["link"in s?(a(),g(ne,{key:0,item:s},null,8,["item"])):"component"in s?(a(),g(E(s.component),G({key:1,ref_for:!0},s.props),null,16)):(a(),g(Ds,{key:2,text:s.text,items:s.items},null,8,["text","items"]))],64))),128))])):h("",!0),c(e.$slots,"default",{},void 0,!0)]))}}),Gs=$(Us,[["__scopeId","data-v-7dd3104a"]]),js=["aria-expanded","aria-label"],zs={key:0,class:"text"},Ks=["innerHTML"],Rs={key:1,class:"vpi-more-horizontal icon"},qs={class:"menu"},Ws=m({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(o){const e=T(!1),t=T();Ns({el:t,onBlur:s});function s(){e.value=!1}return(n,i)=>(a(),u("div",{class:"VPFlyout",ref_key:"el",ref:t,onMouseenter:i[1]||(i[1]=l=>e.value=!0),onMouseleave:i[2]||(i[2]=l=>e.value=!1)},[p("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":e.value,"aria-label":n.label,onClick:i[0]||(i[0]=l=>e.value=!e.value)},[n.button||n.icon?(a(),u("span",zs,[n.icon?(a(),u("span",{key:0,class:I([n.icon,"option-icon"])},null,2)):h("",!0),n.button?(a(),u("span",{key:1,innerHTML:n.button},null,8,Ks)):h("",!0),i[3]||(i[3]=p("span",{class:"vpi-chevron-down text-icon"},null,-1))])):(a(),u("span",Rs))],8,js),p("div",qs,[k(Gs,{items:n.items},{default:f(()=>[c(n.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),ge=$(Ws,[["__scopeId","data-v-04f5c5e9"]]),Js=["href","aria-label","innerHTML"],Ys=m({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(o){const e=o,t=y(()=>typeof e.icon=="object"?e.icon.svg:``);return(s,n)=>(a(),u("a",{class:"VPSocialLink no-icon",href:s.link,"aria-label":s.ariaLabel??(typeof s.icon=="string"?s.icon:""),target:"_blank",rel:"noopener",innerHTML:t.value},null,8,Js))}}),Xs=$(Ys,[["__scopeId","data-v-717b8b75"]]),Qs={class:"VPSocialLinks"},Zs=m({__name:"VPSocialLinks",props:{links:{}},setup(o){return(e,t)=>(a(),u("div",Qs,[(a(!0),u(M,null,B(e.links,({link:s,icon:n,ariaLabel:i})=>(a(),g(Xs,{key:s,icon:n,link:s,ariaLabel:i},null,8,["icon","link","ariaLabel"]))),128))]))}}),$e=$(Zs,[["__scopeId","data-v-ee7a9424"]]),xs={key:0,class:"group translations"},eo={class:"trans-title"},to={key:1,class:"group"},no={class:"item appearance"},so={class:"label"},oo={class:"appearance-action"},ao={key:2,class:"group"},ro={class:"item social-links"},io=m({__name:"VPNavBarExtra",setup(o){const{site:e,theme:t}=V(),{localeLinks:s,currentLang:n}=Y({correspondingLink:!0}),i=y(()=>s.value.length&&n.value.label||e.value.appearance||t.value.socialLinks);return(l,d)=>i.value?(a(),g(ge,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:f(()=>[r(s).length&&r(n).label?(a(),u("div",xs,[p("p",eo,w(r(n).label),1),(a(!0),u(M,null,B(r(s),v=>(a(),g(ne,{key:v.link,item:v},null,8,["item"]))),128))])):h("",!0),r(e).appearance&&r(e).appearance!=="force-dark"&&r(e).appearance!=="force-auto"?(a(),u("div",to,[p("div",no,[p("p",so,w(r(t).darkModeSwitchLabel||"Appearance"),1),p("div",oo,[k(be)])])])):h("",!0),r(t).socialLinks?(a(),u("div",ao,[p("div",ro,[k($e,{class:"social-links-list",links:r(t).socialLinks},null,8,["links"])])])):h("",!0)]),_:1})):h("",!0)}}),lo=$(io,[["__scopeId","data-v-925effce"]]),co=["aria-expanded"],uo=m({__name:"VPNavBarHamburger",props:{active:{type:Boolean}},emits:["click"],setup(o){return(e,t)=>(a(),u("button",{type:"button",class:I(["VPNavBarHamburger",{active:e.active}]),"aria-label":"mobile navigation","aria-expanded":e.active,"aria-controls":"VPNavScreen",onClick:t[0]||(t[0]=s=>e.$emit("click"))},t[1]||(t[1]=[p("span",{class:"container"},[p("span",{class:"top"}),p("span",{class:"middle"}),p("span",{class:"bottom"})],-1)]),10,co))}}),vo=$(uo,[["__scopeId","data-v-5dea55bf"]]),po=["innerHTML"],fo=m({__name:"VPNavBarMenuLink",props:{item:{}},setup(o){const{page:e}=V();return(t,s)=>(a(),g(D,{class:I({VPNavBarMenuLink:!0,active:r(K)(r(e).relativePath,t.item.activeMatch||t.item.link,!!t.item.activeMatch)}),href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,tabindex:"0"},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,po)]),_:1},8,["class","href","target","rel","no-icon"]))}}),ho=$(fo,[["__scopeId","data-v-956ec74c"]]),mo=m({__name:"VPNavBarMenuGroup",props:{item:{}},setup(o){const e=o,{page:t}=V(),s=i=>"component"in i?!1:"link"in i?K(t.value.relativePath,i.link,!!e.item.activeMatch):i.items.some(s),n=y(()=>s(e.item));return(i,l)=>(a(),g(ge,{class:I({VPNavBarMenuGroup:!0,active:r(K)(r(t).relativePath,i.item.activeMatch,!!i.item.activeMatch)||n.value}),button:i.item.text,items:i.item.items},null,8,["class","button","items"]))}}),_o={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},bo=m({__name:"VPNavBarMenu",setup(o){const{theme:e}=V();return(t,s)=>r(e).nav?(a(),u("nav",_o,[s[0]||(s[0]=p("span",{id:"main-nav-aria-label",class:"visually-hidden"}," Main Navigation ",-1)),(a(!0),u(M,null,B(r(e).nav,n=>(a(),u(M,{key:JSON.stringify(n)},["link"in n?(a(),g(ho,{key:0,item:n},null,8,["item"])):"component"in n?(a(),g(E(n.component),G({key:1,ref_for:!0},n.props),null,16)):(a(),g(mo,{key:2,item:n},null,8,["item"]))],64))),128))])):h("",!0)}}),ko=$(bo,[["__scopeId","data-v-e6d46098"]]);function go(o){const{localeIndex:e,theme:t}=V();function s(n){var A,C,N;const i=n.split("."),l=(A=t.value.search)==null?void 0:A.options,d=l&&typeof l=="object",v=d&&((N=(C=l.locales)==null?void 0:C[e.value])==null?void 0:N.translations)||null,b=d&&l.translations||null;let L=v,_=b,P=o;const S=i.pop();for(const H of i){let U=null;const q=P==null?void 0:P[H];q&&(U=P=q);const se=_==null?void 0:_[H];se&&(U=_=se);const oe=L==null?void 0:L[H];oe&&(U=L=oe),q||(P=U),se||(_=U),oe||(L=U)}return(L==null?void 0:L[S])??(_==null?void 0:_[S])??(P==null?void 0:P[S])??""}return s}const $o=["aria-label"],yo={class:"DocSearch-Button-Container"},Po={class:"DocSearch-Button-Placeholder"},ye=m({__name:"VPNavBarSearchButton",setup(o){const t=go({button:{buttonText:"Search",buttonAriaLabel:"Search"}});return(s,n)=>(a(),u("button",{type:"button",class:"DocSearch DocSearch-Button","aria-label":r(t)("button.buttonAriaLabel")},[p("span",yo,[n[0]||(n[0]=p("span",{class:"vp-icon DocSearch-Search-Icon"},null,-1)),p("span",Po,w(r(t)("button.buttonText")),1)]),n[1]||(n[1]=p("span",{class:"DocSearch-Button-Keys"},[p("kbd",{class:"DocSearch-Button-Key"}),p("kbd",{class:"DocSearch-Button-Key"},"K")],-1))],8,$o))}}),So={class:"VPNavBarSearch"},Lo={id:"local-search"},Vo={key:1,id:"docsearch"},To=m({__name:"VPNavBarSearch",setup(o){const e=Je(()=>Ye(()=>import("./VPLocalSearchBox.IfQDnsCV.js"),__vite__mapDeps([0,1]))),t=()=>null,{theme:s}=V(),n=T(!1),i=T(!1);j(()=>{});function l(){n.value||(n.value=!0,setTimeout(d,16))}function d(){const _=new Event("keydown");_.key="k",_.metaKey=!0,window.dispatchEvent(_),setTimeout(()=>{document.querySelector(".DocSearch-Modal")||d()},16)}function v(_){const P=_.target,S=P.tagName;return P.isContentEditable||S==="INPUT"||S==="SELECT"||S==="TEXTAREA"}const b=T(!1);ie("k",_=>{(_.ctrlKey||_.metaKey)&&(_.preventDefault(),b.value=!0)}),ie("/",_=>{v(_)||(_.preventDefault(),b.value=!0)});const L="local";return(_,P)=>{var S;return a(),u("div",So,[r(L)==="local"?(a(),u(M,{key:0},[b.value?(a(),g(r(e),{key:0,onClose:P[0]||(P[0]=A=>b.value=!1)})):h("",!0),p("div",Lo,[k(ye,{onClick:P[1]||(P[1]=A=>b.value=!0)})])],64)):r(L)==="algolia"?(a(),u(M,{key:1},[n.value?(a(),g(r(t),{key:0,algolia:((S=r(s).search)==null?void 0:S.options)??r(s).algolia,onVnodeBeforeMount:P[2]||(P[2]=A=>i.value=!0)},null,8,["algolia"])):h("",!0),i.value?h("",!0):(a(),u("div",Vo,[k(ye,{onClick:l})]))],64)):h("",!0)])}}}),No=m({__name:"VPNavBarSocialLinks",setup(o){const{theme:e}=V();return(t,s)=>r(e).socialLinks?(a(),g($e,{key:0,class:"VPNavBarSocialLinks",links:r(e).socialLinks},null,8,["links"])):h("",!0)}}),wo=$(No,[["__scopeId","data-v-164c457f"]]),Io=["href","rel","target"],Mo={key:1},Ao={key:2},Co=m({__name:"VPNavBarTitle",setup(o){const{site:e,theme:t}=V(),{hasSidebar:s}=O(),{currentLang:n}=Y(),i=y(()=>{var v;return typeof t.value.logoLink=="string"?t.value.logoLink:(v=t.value.logoLink)==null?void 0:v.link}),l=y(()=>{var v;return typeof t.value.logoLink=="string"||(v=t.value.logoLink)==null?void 0:v.rel}),d=y(()=>{var v;return typeof t.value.logoLink=="string"||(v=t.value.logoLink)==null?void 0:v.target});return(v,b)=>(a(),u("div",{class:I(["VPNavBarTitle",{"has-sidebar":r(s)}])},[p("a",{class:"title",href:i.value??r(me)(r(n).link),rel:l.value,target:d.value},[c(v.$slots,"nav-bar-title-before",{},void 0,!0),r(t).logo?(a(),g(Q,{key:0,class:"logo",image:r(t).logo},null,8,["image"])):h("",!0),r(t).siteTitle?(a(),u("span",Mo,w(r(t).siteTitle),1)):r(t).siteTitle===void 0?(a(),u("span",Ao,w(r(e).title),1)):h("",!0),c(v.$slots,"nav-bar-title-after",{},void 0,!0)],8,Io)],2))}}),Bo=$(Co,[["__scopeId","data-v-28a961f9"]]),Ho={class:"items"},Eo={class:"title"},Do=m({__name:"VPNavBarTranslations",setup(o){const{theme:e}=V(),{localeLinks:t,currentLang:s}=Y({correspondingLink:!0});return(n,i)=>r(t).length&&r(s).label?(a(),g(ge,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:r(e).langMenuLabel||"Change language"},{default:f(()=>[p("div",Ho,[p("p",Eo,w(r(s).label),1),(a(!0),u(M,null,B(r(t),l=>(a(),g(ne,{key:l.link,item:l},null,8,["item"]))),128))])]),_:1},8,["label"])):h("",!0)}}),Fo=$(Do,[["__scopeId","data-v-c80d9ad0"]]),Oo={class:"wrapper"},Uo={class:"container"},Go={class:"title"},jo={class:"content"},zo={class:"content-body"},Ko=m({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(o){const e=o,{y:t}=we(),{hasSidebar:s}=O(),{frontmatter:n}=V(),i=T({});return fe(()=>{i.value={"has-sidebar":s.value,home:n.value.layout==="home",top:t.value===0,"screen-open":e.isScreenOpen}}),(l,d)=>(a(),u("div",{class:I(["VPNavBar",i.value])},[p("div",Oo,[p("div",Uo,[p("div",Go,[k(Bo,null,{"nav-bar-title-before":f(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),_:3})]),p("div",jo,[p("div",zo,[c(l.$slots,"nav-bar-content-before",{},void 0,!0),k(To,{class:"search"}),k(ko,{class:"menu"}),k(Fo,{class:"translations"}),k(Ts,{class:"appearance"}),k(wo,{class:"social-links"}),k(lo,{class:"extra"}),c(l.$slots,"nav-bar-content-after",{},void 0,!0),k(vo,{class:"hamburger",active:l.isScreenOpen,onClick:d[0]||(d[0]=v=>l.$emit("toggle-screen"))},null,8,["active"])])])])]),d[1]||(d[1]=p("div",{class:"divider"},[p("div",{class:"divider-line"})],-1))],2))}}),Ro=$(Ko,[["__scopeId","data-v-822684d1"]]),qo={key:0,class:"VPNavScreenAppearance"},Wo={class:"text"},Jo=m({__name:"VPNavScreenAppearance",setup(o){const{site:e,theme:t}=V();return(s,n)=>r(e).appearance&&r(e).appearance!=="force-dark"&&r(e).appearance!=="force-auto"?(a(),u("div",qo,[p("p",Wo,w(r(t).darkModeSwitchLabel||"Appearance"),1),k(be)])):h("",!0)}}),Yo=$(Jo,[["__scopeId","data-v-ffb44008"]]),Xo=["innerHTML"],Qo=m({__name:"VPNavScreenMenuLink",props:{item:{}},setup(o){const e=W("close-screen");return(t,s)=>(a(),g(D,{class:"VPNavScreenMenuLink",href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,onClick:r(e)},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,Xo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Zo=$(Qo,[["__scopeId","data-v-735512b8"]]),xo=["innerHTML"],ea=m({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(o){const e=W("close-screen");return(t,s)=>(a(),g(D,{class:"VPNavScreenMenuGroupLink",href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,onClick:r(e)},{default:f(()=>[p("span",{innerHTML:t.item.text},null,8,xo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),De=$(ea,[["__scopeId","data-v-372ae7c0"]]),ta={class:"VPNavScreenMenuGroupSection"},na={key:0,class:"title"},sa=m({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(o){return(e,t)=>(a(),u("div",ta,[e.text?(a(),u("p",na,w(e.text),1)):h("",!0),(a(!0),u(M,null,B(e.items,s=>(a(),g(De,{key:s.text,item:s},null,8,["item"]))),128))]))}}),oa=$(sa,[["__scopeId","data-v-4b8941ac"]]),aa=["aria-controls","aria-expanded"],ra=["innerHTML"],ia=["id"],la={key:0,class:"item"},ca={key:1,class:"item"},ua={key:2,class:"group"},da=m({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(o){const e=o,t=T(!1),s=y(()=>`NavScreenGroup-${e.text.replace(" ","-").toLowerCase()}`);function n(){t.value=!t.value}return(i,l)=>(a(),u("div",{class:I(["VPNavScreenMenuGroup",{open:t.value}])},[p("button",{class:"button","aria-controls":s.value,"aria-expanded":t.value,onClick:n},[p("span",{class:"button-text",innerHTML:i.text},null,8,ra),l[0]||(l[0]=p("span",{class:"vpi-plus button-icon"},null,-1))],8,aa),p("div",{id:s.value,class:"items"},[(a(!0),u(M,null,B(i.items,d=>(a(),u(M,{key:JSON.stringify(d)},["link"in d?(a(),u("div",la,[k(De,{item:d},null,8,["item"])])):"component"in d?(a(),u("div",ca,[(a(),g(E(d.component),G({ref_for:!0},d.props,{"screen-menu":""}),null,16))])):(a(),u("div",ua,[k(oa,{text:d.text,items:d.items},null,8,["text","items"])]))],64))),128))],8,ia)],2))}}),va=$(da,[["__scopeId","data-v-875057a5"]]),pa={key:0,class:"VPNavScreenMenu"},fa=m({__name:"VPNavScreenMenu",setup(o){const{theme:e}=V();return(t,s)=>r(e).nav?(a(),u("nav",pa,[(a(!0),u(M,null,B(r(e).nav,n=>(a(),u(M,{key:JSON.stringify(n)},["link"in n?(a(),g(Zo,{key:0,item:n},null,8,["item"])):"component"in n?(a(),g(E(n.component),G({key:1,ref_for:!0},n.props,{"screen-menu":""}),null,16)):(a(),g(va,{key:2,text:n.text||"",items:n.items},null,8,["text","items"]))],64))),128))])):h("",!0)}}),ha=m({__name:"VPNavScreenSocialLinks",setup(o){const{theme:e}=V();return(t,s)=>r(e).socialLinks?(a(),g($e,{key:0,class:"VPNavScreenSocialLinks",links:r(e).socialLinks},null,8,["links"])):h("",!0)}}),ma={class:"list"},_a=m({__name:"VPNavScreenTranslations",setup(o){const{localeLinks:e,currentLang:t}=Y({correspondingLink:!0}),s=T(!1);function n(){s.value=!s.value}return(i,l)=>r(e).length&&r(t).label?(a(),u("div",{key:0,class:I(["VPNavScreenTranslations",{open:s.value}])},[p("button",{class:"title",onClick:n},[l[0]||(l[0]=p("span",{class:"vpi-languages icon lang"},null,-1)),z(" "+w(r(t).label)+" ",1),l[1]||(l[1]=p("span",{class:"vpi-chevron-down icon chevron"},null,-1))]),p("ul",ma,[(a(!0),u(M,null,B(r(e),d=>(a(),u("li",{key:d.link,class:"item"},[k(D,{class:"link",href:d.link},{default:f(()=>[z(w(d.text),1)]),_:2},1032,["href"])]))),128))])],2)):h("",!0)}}),ba=$(_a,[["__scopeId","data-v-362991c2"]]),ka={class:"container"},ga=m({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(o){const e=T(null),t=Ie(te?document.body:null);return(s,n)=>(a(),g(de,{name:"fade",onEnter:n[0]||(n[0]=i=>t.value=!0),onAfterLeave:n[1]||(n[1]=i=>t.value=!1)},{default:f(()=>[s.open?(a(),u("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:e,id:"VPNavScreen"},[p("div",ka,[c(s.$slots,"nav-screen-content-before",{},void 0,!0),k(fa,{class:"menu"}),k(ba,{class:"translations"}),k(Yo,{class:"appearance"}),k(ha,{class:"social-links"}),c(s.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):h("",!0)]),_:3}))}}),$a=$(ga,[["__scopeId","data-v-833aabba"]]),ya={key:0,class:"VPNav"},Pa=m({__name:"VPNav",setup(o){const{isScreenOpen:e,closeScreen:t,toggleScreen:s}=_s(),{frontmatter:n}=V(),i=y(()=>n.value.navbar!==!1);return he("close-screen",t),Z(()=>{te&&document.documentElement.classList.toggle("hide-nav",!i.value)}),(l,d)=>i.value?(a(),u("header",ya,[k(Ro,{"is-screen-open":r(e),onToggleScreen:r(s)},{"nav-bar-title-before":f(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":f(()=>[c(l.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":f(()=>[c(l.$slots,"nav-bar-content-after",{},void 0,!0)]),_:3},8,["is-screen-open","onToggleScreen"]),k($a,{open:r(e)},{"nav-screen-content-before":f(()=>[c(l.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":f(()=>[c(l.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3},8,["open"])])):h("",!0)}}),Sa=$(Pa,[["__scopeId","data-v-f1e365da"]]),La=["role","tabindex"],Va={key:1,class:"items"},Ta=m({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(o){const e=o,{collapsed:t,collapsible:s,isLink:n,isActiveLink:i,hasActiveLink:l,hasChildren:d,toggle:v}=gt(y(()=>e.item)),b=y(()=>d.value?"section":"div"),L=y(()=>n.value?"a":"div"),_=y(()=>d.value?e.depth+2===7?"p":`h${e.depth+2}`:"p"),P=y(()=>n.value?void 0:"button"),S=y(()=>[[`level-${e.depth}`],{collapsible:s.value},{collapsed:t.value},{"is-link":n.value},{"is-active":i.value},{"has-active":l.value}]);function A(N){"key"in N&&N.key!=="Enter"||!e.item.link&&v()}function C(){e.item.link&&v()}return(N,H)=>{const U=R("VPSidebarItem",!0);return a(),g(E(b.value),{class:I(["VPSidebarItem",S.value])},{default:f(()=>[N.item.text?(a(),u("div",G({key:0,class:"item",role:P.value},Qe(N.item.items?{click:A,keydown:A}:{},!0),{tabindex:N.item.items&&0}),[H[1]||(H[1]=p("div",{class:"indicator"},null,-1)),N.item.link?(a(),g(D,{key:0,tag:L.value,class:"link",href:N.item.link,rel:N.item.rel,target:N.item.target},{default:f(()=>[(a(),g(E(_.value),{class:"text",innerHTML:N.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(a(),g(E(_.value),{key:1,class:"text",innerHTML:N.item.text},null,8,["innerHTML"])),N.item.collapsed!=null&&N.item.items&&N.item.items.length?(a(),u("div",{key:2,class:"caret",role:"button","aria-label":"toggle section",onClick:C,onKeydown:Xe(C,["enter"]),tabindex:"0"},H[0]||(H[0]=[p("span",{class:"vpi-chevron-right caret-icon"},null,-1)]),32)):h("",!0)],16,La)):h("",!0),N.item.items&&N.item.items.length?(a(),u("div",Va,[N.depth<5?(a(!0),u(M,{key:0},B(N.item.items,q=>(a(),g(U,{key:q.text,item:q,depth:N.depth+1},null,8,["item","depth"]))),128)):h("",!0)])):h("",!0)]),_:1},8,["class"])}}}),Na=$(Ta,[["__scopeId","data-v-196b2e5f"]]),wa=m({__name:"VPSidebarGroup",props:{items:{}},setup(o){const e=T(!0);let t=null;return j(()=>{t=setTimeout(()=>{t=null,e.value=!1},300)}),Ze(()=>{t!=null&&(clearTimeout(t),t=null)}),(s,n)=>(a(!0),u(M,null,B(s.items,i=>(a(),u("div",{key:i.text,class:I(["group",{"no-transition":e.value}])},[k(Na,{item:i,depth:0},null,8,["item"])],2))),128))}}),Ia=$(wa,[["__scopeId","data-v-9e426adc"]]),Ma={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},Aa=m({__name:"VPSidebar",props:{open:{type:Boolean}},setup(o){const{sidebarGroups:e,hasSidebar:t}=O(),s=o,n=T(null),i=Ie(te?document.body:null);F([s,n],()=>{var d;s.open?(i.value=!0,(d=n.value)==null||d.focus()):i.value=!1},{immediate:!0,flush:"post"});const l=T(0);return F(e,()=>{l.value+=1},{deep:!0}),(d,v)=>r(t)?(a(),u("aside",{key:0,class:I(["VPSidebar",{open:d.open}]),ref_key:"navEl",ref:n,onClick:v[0]||(v[0]=xe(()=>{},["stop"]))},[v[2]||(v[2]=p("div",{class:"curtain"},null,-1)),p("nav",Ma,[v[1]||(v[1]=p("span",{class:"visually-hidden",id:"sidebar-aria-label"}," Sidebar Navigation ",-1)),c(d.$slots,"sidebar-nav-before",{},void 0,!0),(a(),g(Ia,{items:r(e),key:l.value},null,8,["items"])),c(d.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):h("",!0)}}),Ca=$(Aa,[["__scopeId","data-v-18756405"]]),Ba=m({__name:"VPSkipLink",setup(o){const e=ee(),t=T();F(()=>e.path,()=>t.value.focus());function s({target:n}){const i=document.getElementById(decodeURIComponent(n.hash).slice(1));if(i){const l=()=>{i.removeAttribute("tabindex"),i.removeEventListener("blur",l)};i.setAttribute("tabindex","-1"),i.addEventListener("blur",l),i.focus(),window.scrollTo(0,0)}}return(n,i)=>(a(),u(M,null,[p("span",{ref_key:"backToTop",ref:t,tabindex:"-1"},null,512),p("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:s}," Skip to content ")],64))}}),Ha=$(Ba,[["__scopeId","data-v-c3508ec8"]]),Ea=m({__name:"Layout",setup(o){const{isOpen:e,open:t,close:s}=O(),n=ee();F(()=>n.path,s),kt(e,s);const{frontmatter:i}=V(),l=Me(),d=y(()=>!!l["home-hero-image"]);return he("hero-image-slot-exists",d),(v,b)=>{const L=R("Content");return r(i).layout!==!1?(a(),u("div",{key:0,class:I(["Layout",r(i).pageClass])},[c(v.$slots,"layout-top",{},void 0,!0),k(Ha),k(rt,{class:"backdrop",show:r(e),onClick:r(s)},null,8,["show","onClick"]),k(Sa,null,{"nav-bar-title-before":f(()=>[c(v.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(v.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":f(()=>[c(v.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":f(()=>[c(v.$slots,"nav-bar-content-after",{},void 0,!0)]),"nav-screen-content-before":f(()=>[c(v.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":f(()=>[c(v.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3}),k(ms,{open:r(e),onOpenMenu:r(t)},null,8,["open","onOpenMenu"]),k(Ca,{open:r(e)},{"sidebar-nav-before":f(()=>[c(v.$slots,"sidebar-nav-before",{},void 0,!0)]),"sidebar-nav-after":f(()=>[c(v.$slots,"sidebar-nav-after",{},void 0,!0)]),_:3},8,["open"]),k(es,null,{"page-top":f(()=>[c(v.$slots,"page-top",{},void 0,!0)]),"page-bottom":f(()=>[c(v.$slots,"page-bottom",{},void 0,!0)]),"not-found":f(()=>[c(v.$slots,"not-found",{},void 0,!0)]),"home-hero-before":f(()=>[c(v.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":f(()=>[c(v.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(v.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(v.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(v.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(v.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":f(()=>[c(v.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":f(()=>[c(v.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":f(()=>[c(v.$slots,"home-features-after",{},void 0,!0)]),"doc-footer-before":f(()=>[c(v.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":f(()=>[c(v.$slots,"doc-before",{},void 0,!0)]),"doc-after":f(()=>[c(v.$slots,"doc-after",{},void 0,!0)]),"doc-top":f(()=>[c(v.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":f(()=>[c(v.$slots,"doc-bottom",{},void 0,!0)]),"aside-top":f(()=>[c(v.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":f(()=>[c(v.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":f(()=>[c(v.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(v.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(v.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(v.$slots,"aside-ads-after",{},void 0,!0)]),_:3}),k(as),c(v.$slots,"layout-bottom",{},void 0,!0)],2)):(a(),g(L,{key:1}))}}}),Da=$(Ea,[["__scopeId","data-v-a9a9e638"]]),Pe={Layout:Da,enhanceApp:({app:o})=>{o.component("Badge",st)}},Fa=o=>{if(typeof document>"u")return{stabilizeScrollPosition:n=>async(...i)=>n(...i)};const e=document.documentElement;return{stabilizeScrollPosition:s=>async(...n)=>{const i=s(...n),l=o.value;if(!l)return i;const d=l.offsetTop-e.scrollTop;return await Ne(),e.scrollTop=l.offsetTop-d,i}}},Fe="vitepress:tabSharedState",J=typeof localStorage<"u"?localStorage:null,Oe="vitepress:tabsSharedState",Oa=()=>{const o=J==null?void 0:J.getItem(Oe);if(o)try{return JSON.parse(o)}catch{}return{}},Ua=o=>{J&&J.setItem(Oe,JSON.stringify(o))},Ga=o=>{const e=et({});F(()=>e.content,(t,s)=>{t&&s&&Ua(t)},{deep:!0}),o.provide(Fe,e)},ja=(o,e)=>{const t=W(Fe);if(!t)throw new Error("[vitepress-plugin-tabs] TabsSharedState should be injected");j(()=>{t.content||(t.content=Oa())});const s=T(),n=y({get(){var v;const l=e.value,d=o.value;if(l){const b=(v=t.content)==null?void 0:v[l];if(b&&d.includes(b))return b}else{const b=s.value;if(b)return b}return d[0]},set(l){const d=e.value;d?t.content&&(t.content[d]=l):s.value=l}});return{selected:n,select:l=>{n.value=l}}};let Se=0;const za=()=>(Se++,""+Se);function Ka(){const o=Me();return y(()=>{var s;const t=(s=o.default)==null?void 0:s.call(o);return t?t.filter(n=>typeof n.type=="object"&&"__name"in n.type&&n.type.__name==="PluginTabsTab"&&n.props).map(n=>{var i;return(i=n.props)==null?void 0:i.label}):[]})}const Ue="vitepress:tabSingleState",Ra=o=>{he(Ue,o)},qa=()=>{const o=W(Ue);if(!o)throw new Error("[vitepress-plugin-tabs] TabsSingleState should be injected");return o},Wa={class:"plugin-tabs"},Ja=["id","aria-selected","aria-controls","tabindex","onClick"],Ya=m({__name:"PluginTabs",props:{sharedStateKey:{}},setup(o){const e=o,t=Ka(),{selected:s,select:n}=ja(t,tt(e,"sharedStateKey")),i=T(),{stabilizeScrollPosition:l}=Fa(i),d=l(n),v=T([]),b=_=>{var A;const P=t.value.indexOf(s.value);let S;_.key==="ArrowLeft"?S=P>=1?P-1:t.value.length-1:_.key==="ArrowRight"&&(S=P(a(),u("div",Wa,[p("div",{ref_key:"tablist",ref:i,class:"plugin-tabs--tab-list",role:"tablist",onKeydown:b},[(a(!0),u(M,null,B(r(t),S=>(a(),u("button",{id:`tab-${S}-${r(L)}`,ref_for:!0,ref_key:"buttonRefs",ref:v,key:S,role:"tab",class:"plugin-tabs--tab","aria-selected":S===r(s),"aria-controls":`panel-${S}-${r(L)}`,tabindex:S===r(s)?0:-1,onClick:()=>r(d)(S)},w(S),9,Ja))),128))],544),c(_.$slots,"default")]))}}),Xa=["id","aria-labelledby"],Qa=m({__name:"PluginTabsTab",props:{label:{}},setup(o){const{uid:e,selected:t}=qa();return(s,n)=>r(t)===s.label?(a(),u("div",{key:0,id:`panel-${s.label}-${r(e)}`,class:"plugin-tabs--content",role:"tabpanel",tabindex:"0","aria-labelledby":`tab-${s.label}-${r(e)}`},[c(s.$slots,"default",{},void 0,!0)],8,Xa)):h("",!0)}}),Za=$(Qa,[["__scopeId","data-v-9b0d03d2"]]),xa=o=>{Ga(o),o.component("PluginTabs",Ya),o.component("PluginTabsTab",Za)},tr={extends:Pe,Layout(){return nt(Pe.Layout,null,{})},enhanceApp({app:o,router:e,siteData:t}){xa(o)}};export{tr as R,go as c,V as u}; diff --git a/previews/PR800/assets/data_sources.md.Rgk0yRjv.js b/previews/PR800/assets/data_sources.md.DiNgOJfA.js similarity index 99% rename from previews/PR800/assets/data_sources.md.Rgk0yRjv.js rename to previews/PR800/assets/data_sources.md.DiNgOJfA.js index 9e79aa7b..2ff0c35b 100644 --- a/previews/PR800/assets/data_sources.md.Rgk0yRjv.js +++ b/previews/PR800/assets/data_sources.md.DiNgOJfA.js @@ -1,4 +1,4 @@ -import{_ as a,c as s,a5 as t,o as i}from"./chunks/framework.Gz-llJN4.js";const o="/Rasters.jl/previews/PR800/assets/vaeggon.CBMwZ7qg.png",m=JSON.parse('{"title":"Data sources","description":"","frontmatter":{},"headers":[],"relativePath":"data_sources.md","filePath":"data_sources.md","lastUpdated":null}'),r={name:"data_sources.md"};function n(d,e,l,c,h,p){return i(),s("div",null,e[0]||(e[0]=[t(`

Data sources

Rasters.jl uses a number of backends to load raster data. Raster, RasterStack and RasterSeries will detect which backend to use for you, automatically.

GRD

R GRD files can be loaded natively, using Julias MMap - which means they are very fast, but are not compressed. They are always 3 dimensional, and have Y, X and Band dimensions.

NetCDF

NetCDF .nc files are loaded using NCDatasets.jl. Layers from files can be loaded as Raster("filename.nc"; name=:layername). Without name the first layer is used. RasterStack("filename.nc") will use all netcdf variables in the file that are not dimensions as layers.

NetCDF layers can have arbitrary dimensions. Known, common dimension names are converted to X, Y Z, and Ti, otherwise Dim{:layername} is used. Layers in the same file may also have different dimensions.

NetCDF files still have issues loading directly from disk for some operations. Using read(ncstack) may help.

GDAL

All files GDAL can access, such as .tiff and .asc files, can be loaded, using ArchGDAL.jl. These are generally best loaded as Raster("filename.tif"), but can be loaded as RasterStack("filename.tif"; layersfrom=Band), taking layers from the Band dimension, which is also the default.

SMAP

The Soil Moisture Active-Passive dataset provides global layers of soil moisture, temperature and other related data, in a custom HDF5 format. Layers are always 2 dimensional, with Y and X dimensions.

These can be loaded as multi-layered RasterStack("filename.h5"). Individual layers can be loaded as Raster("filename.h5"; name=:layername), without name the first layer is used.

julia
using Rasters

Missing docstring.

Missing docstring for smapseries. Check Documenter's build log for details.

Writing file formats to disk

Files can be written to disk in all formats other than SMAP HDF5 using write("filename.ext", A). See the docs for write. They can (with some caveats) be written to different formats than they were loaded in as, providing file-type conversion for spatial data.

Some metadata may be lost in formats that store little metadata, or where metadata conversion has not been completely implemented.

RasterDataSources.jl integration

RasterDataSources.jl standardises the download of common raster data sources, with a focus on datasets used in ecology and the environmental sciences. RasterDataSources.jl is tightly integrated into Rasters.jl, so that datsets and keywords can be used directly to download and load data as a Raster, RasterStack, or RasterSeries.

julia
using Rasters, CairoMakie, Dates
+import{_ as a,c as s,a5 as t,o as i}from"./chunks/framework.Gz-llJN4.js";const o="/Rasters.jl/previews/PR800/assets/zxvufnv.CBMwZ7qg.png",m=JSON.parse('{"title":"Data sources","description":"","frontmatter":{},"headers":[],"relativePath":"data_sources.md","filePath":"data_sources.md","lastUpdated":null}'),r={name:"data_sources.md"};function n(d,e,l,c,h,p){return i(),s("div",null,e[0]||(e[0]=[t(`

Data sources

Rasters.jl uses a number of backends to load raster data. Raster, RasterStack and RasterSeries will detect which backend to use for you, automatically.

GRD

R GRD files can be loaded natively, using Julias MMap - which means they are very fast, but are not compressed. They are always 3 dimensional, and have Y, X and Band dimensions.

NetCDF

NetCDF .nc files are loaded using NCDatasets.jl. Layers from files can be loaded as Raster("filename.nc"; name=:layername). Without name the first layer is used. RasterStack("filename.nc") will use all netcdf variables in the file that are not dimensions as layers.

NetCDF layers can have arbitrary dimensions. Known, common dimension names are converted to X, Y Z, and Ti, otherwise Dim{:layername} is used. Layers in the same file may also have different dimensions.

NetCDF files still have issues loading directly from disk for some operations. Using read(ncstack) may help.

GDAL

All files GDAL can access, such as .tiff and .asc files, can be loaded, using ArchGDAL.jl. These are generally best loaded as Raster("filename.tif"), but can be loaded as RasterStack("filename.tif"; layersfrom=Band), taking layers from the Band dimension, which is also the default.

SMAP

The Soil Moisture Active-Passive dataset provides global layers of soil moisture, temperature and other related data, in a custom HDF5 format. Layers are always 2 dimensional, with Y and X dimensions.

These can be loaded as multi-layered RasterStack("filename.h5"). Individual layers can be loaded as Raster("filename.h5"; name=:layername), without name the first layer is used.

julia
using Rasters

Missing docstring.

Missing docstring for smapseries. Check Documenter's build log for details.

Writing file formats to disk

Files can be written to disk in all formats other than SMAP HDF5 using write("filename.ext", A). See the docs for write. They can (with some caveats) be written to different formats than they were loaded in as, providing file-type conversion for spatial data.

Some metadata may be lost in formats that store little metadata, or where metadata conversion has not been completely implemented.

RasterDataSources.jl integration

RasterDataSources.jl standardises the download of common raster data sources, with a focus on datasets used in ecology and the environmental sciences. RasterDataSources.jl is tightly integrated into Rasters.jl, so that datsets and keywords can be used directly to download and load data as a Raster, RasterStack, or RasterSeries.

julia
using Rasters, CairoMakie, Dates
 using RasterDataSources
 A = Raster(WorldClim{Climate}, :tavg; month=June)
 Makie.plot(A)

See the docs for Raster, RasterStack and RasterSeries, and the docs for RasterDataSources.getraster for syntax to specify various data sources.

',23)]))}const k=a(r,[["render",n]]);export{m as __pageData,k as default}; diff --git a/previews/PR800/assets/data_sources.md.Rgk0yRjv.lean.js b/previews/PR800/assets/data_sources.md.DiNgOJfA.lean.js similarity index 99% rename from previews/PR800/assets/data_sources.md.Rgk0yRjv.lean.js rename to previews/PR800/assets/data_sources.md.DiNgOJfA.lean.js index 9e79aa7b..2ff0c35b 100644 --- a/previews/PR800/assets/data_sources.md.Rgk0yRjv.lean.js +++ b/previews/PR800/assets/data_sources.md.DiNgOJfA.lean.js @@ -1,4 +1,4 @@ -import{_ as a,c as s,a5 as t,o as i}from"./chunks/framework.Gz-llJN4.js";const o="/Rasters.jl/previews/PR800/assets/vaeggon.CBMwZ7qg.png",m=JSON.parse('{"title":"Data sources","description":"","frontmatter":{},"headers":[],"relativePath":"data_sources.md","filePath":"data_sources.md","lastUpdated":null}'),r={name:"data_sources.md"};function n(d,e,l,c,h,p){return i(),s("div",null,e[0]||(e[0]=[t(`

Data sources

Rasters.jl uses a number of backends to load raster data. Raster, RasterStack and RasterSeries will detect which backend to use for you, automatically.

GRD

R GRD files can be loaded natively, using Julias MMap - which means they are very fast, but are not compressed. They are always 3 dimensional, and have Y, X and Band dimensions.

NetCDF

NetCDF .nc files are loaded using NCDatasets.jl. Layers from files can be loaded as Raster("filename.nc"; name=:layername). Without name the first layer is used. RasterStack("filename.nc") will use all netcdf variables in the file that are not dimensions as layers.

NetCDF layers can have arbitrary dimensions. Known, common dimension names are converted to X, Y Z, and Ti, otherwise Dim{:layername} is used. Layers in the same file may also have different dimensions.

NetCDF files still have issues loading directly from disk for some operations. Using read(ncstack) may help.

GDAL

All files GDAL can access, such as .tiff and .asc files, can be loaded, using ArchGDAL.jl. These are generally best loaded as Raster("filename.tif"), but can be loaded as RasterStack("filename.tif"; layersfrom=Band), taking layers from the Band dimension, which is also the default.

SMAP

The Soil Moisture Active-Passive dataset provides global layers of soil moisture, temperature and other related data, in a custom HDF5 format. Layers are always 2 dimensional, with Y and X dimensions.

These can be loaded as multi-layered RasterStack("filename.h5"). Individual layers can be loaded as Raster("filename.h5"; name=:layername), without name the first layer is used.

julia
using Rasters

Missing docstring.

Missing docstring for smapseries. Check Documenter's build log for details.

Writing file formats to disk

Files can be written to disk in all formats other than SMAP HDF5 using write("filename.ext", A). See the docs for write. They can (with some caveats) be written to different formats than they were loaded in as, providing file-type conversion for spatial data.

Some metadata may be lost in formats that store little metadata, or where metadata conversion has not been completely implemented.

RasterDataSources.jl integration

RasterDataSources.jl standardises the download of common raster data sources, with a focus on datasets used in ecology and the environmental sciences. RasterDataSources.jl is tightly integrated into Rasters.jl, so that datsets and keywords can be used directly to download and load data as a Raster, RasterStack, or RasterSeries.

julia
using Rasters, CairoMakie, Dates
+import{_ as a,c as s,a5 as t,o as i}from"./chunks/framework.Gz-llJN4.js";const o="/Rasters.jl/previews/PR800/assets/zxvufnv.CBMwZ7qg.png",m=JSON.parse('{"title":"Data sources","description":"","frontmatter":{},"headers":[],"relativePath":"data_sources.md","filePath":"data_sources.md","lastUpdated":null}'),r={name:"data_sources.md"};function n(d,e,l,c,h,p){return i(),s("div",null,e[0]||(e[0]=[t(`

Data sources

Rasters.jl uses a number of backends to load raster data. Raster, RasterStack and RasterSeries will detect which backend to use for you, automatically.

GRD

R GRD files can be loaded natively, using Julias MMap - which means they are very fast, but are not compressed. They are always 3 dimensional, and have Y, X and Band dimensions.

NetCDF

NetCDF .nc files are loaded using NCDatasets.jl. Layers from files can be loaded as Raster("filename.nc"; name=:layername). Without name the first layer is used. RasterStack("filename.nc") will use all netcdf variables in the file that are not dimensions as layers.

NetCDF layers can have arbitrary dimensions. Known, common dimension names are converted to X, Y Z, and Ti, otherwise Dim{:layername} is used. Layers in the same file may also have different dimensions.

NetCDF files still have issues loading directly from disk for some operations. Using read(ncstack) may help.

GDAL

All files GDAL can access, such as .tiff and .asc files, can be loaded, using ArchGDAL.jl. These are generally best loaded as Raster("filename.tif"), but can be loaded as RasterStack("filename.tif"; layersfrom=Band), taking layers from the Band dimension, which is also the default.

SMAP

The Soil Moisture Active-Passive dataset provides global layers of soil moisture, temperature and other related data, in a custom HDF5 format. Layers are always 2 dimensional, with Y and X dimensions.

These can be loaded as multi-layered RasterStack("filename.h5"). Individual layers can be loaded as Raster("filename.h5"; name=:layername), without name the first layer is used.

julia
using Rasters

Missing docstring.

Missing docstring for smapseries. Check Documenter's build log for details.

Writing file formats to disk

Files can be written to disk in all formats other than SMAP HDF5 using write("filename.ext", A). See the docs for write. They can (with some caveats) be written to different formats than they were loaded in as, providing file-type conversion for spatial data.

Some metadata may be lost in formats that store little metadata, or where metadata conversion has not been completely implemented.

RasterDataSources.jl integration

RasterDataSources.jl standardises the download of common raster data sources, with a focus on datasets used in ecology and the environmental sciences. RasterDataSources.jl is tightly integrated into Rasters.jl, so that datsets and keywords can be used directly to download and load data as a Raster, RasterStack, or RasterSeries.

julia
using Rasters, CairoMakie, Dates
 using RasterDataSources
 A = Raster(WorldClim{Climate}, :tavg; month=June)
 Makie.plot(A)

See the docs for Raster, RasterStack and RasterSeries, and the docs for RasterDataSources.getraster for syntax to specify various data sources.

',23)]))}const k=a(r,[["render",n]]);export{m as __pageData,k as default}; diff --git a/previews/PR800/assets/dciuddq.DdtYyM8O.png b/previews/PR800/assets/dciuddq.DdtYyM8O.png new file mode 100644 index 00000000..7c5f7274 Binary files /dev/null and b/previews/PR800/assets/dciuddq.DdtYyM8O.png differ diff --git a/previews/PR800/assets/vgpyavh.8o5RdXOt.png b/previews/PR800/assets/eympwzi.8o5RdXOt.png similarity index 100% rename from previews/PR800/assets/vgpyavh.8o5RdXOt.png rename to previews/PR800/assets/eympwzi.8o5RdXOt.png diff --git a/previews/PR800/assets/gbif_wflow.md.CkT2Rbvf.js b/previews/PR800/assets/gbif_wflow.md.CAXtS9zz.js similarity index 99% rename from previews/PR800/assets/gbif_wflow.md.CkT2Rbvf.js rename to previews/PR800/assets/gbif_wflow.md.CAXtS9zz.js index fff9311c..7e279704 100644 --- a/previews/PR800/assets/gbif_wflow.md.CkT2Rbvf.js +++ b/previews/PR800/assets/gbif_wflow.md.CAXtS9zz.js @@ -1,4 +1,4 @@ -import{_ as a,c as i,a5 as n,o as l}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/kolpjjy.CVwZE_Z9.png",c=JSON.parse('{"title":"GBIF workflow","description":"","frontmatter":{},"headers":[],"relativePath":"gbif_wflow.md","filePath":"gbif_wflow.md","lastUpdated":null}'),p={name:"gbif_wflow.md"};function e(o,s,h,k,r,d){return l(),i("div",null,s[0]||(s[0]=[n(`

GBIF workflow

In this example, we'll load occurrences for the Mountain Pygmy Possum species using GBIF2.jl, an interface to the Global Biodiversity Information Facility, and extract environmental variables using BioClim data from RasterDataSources.jl.

Load GBIF species data

julia
using Rasters, GBIF2
+import{_ as a,c as i,a5 as n,o as l}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/rkvbhbj.C5EV6zqa.png",c=JSON.parse('{"title":"GBIF workflow","description":"","frontmatter":{},"headers":[],"relativePath":"gbif_wflow.md","filePath":"gbif_wflow.md","lastUpdated":null}'),p={name:"gbif_wflow.md"};function e(o,s,h,k,r,d){return l(),i("div",null,s[0]||(s[0]=[n(`

GBIF workflow

In this example, we'll load occurrences for the Mountain Pygmy Possum species using GBIF2.jl, an interface to the Global Biodiversity Information Facility, and extract environmental variables using BioClim data from RasterDataSources.jl.

Load GBIF species data

julia
using Rasters, GBIF2
 using RasterDataSources
 const RS = Rasters
Rasters
julia
records = GBIF2.occurrence_search("Burramys parvus"; limit=300)
300-element GBIF2.Table{GBIF2.Occurrence, JSON3.Array{JSON3.Object, Vector{UInt8}, SubArray{UInt64, 1, Vector{UInt64}, Tuple{UnitRange{Int64}}, true}}}┌──────────────────────────┬─────────┬─────────┬─────────┬──────────┬───────────
 │                 geometry │    year │   month │     day │  kingdom │   phylum ⋯
diff --git a/previews/PR800/assets/gbif_wflow.md.CkT2Rbvf.lean.js b/previews/PR800/assets/gbif_wflow.md.CAXtS9zz.lean.js
similarity index 99%
rename from previews/PR800/assets/gbif_wflow.md.CkT2Rbvf.lean.js
rename to previews/PR800/assets/gbif_wflow.md.CAXtS9zz.lean.js
index fff9311c..7e279704 100644
--- a/previews/PR800/assets/gbif_wflow.md.CkT2Rbvf.lean.js
+++ b/previews/PR800/assets/gbif_wflow.md.CAXtS9zz.lean.js
@@ -1,4 +1,4 @@
-import{_ as a,c as i,a5 as n,o as l}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/kolpjjy.CVwZE_Z9.png",c=JSON.parse('{"title":"GBIF workflow","description":"","frontmatter":{},"headers":[],"relativePath":"gbif_wflow.md","filePath":"gbif_wflow.md","lastUpdated":null}'),p={name:"gbif_wflow.md"};function e(o,s,h,k,r,d){return l(),i("div",null,s[0]||(s[0]=[n(`

GBIF workflow

In this example, we'll load occurrences for the Mountain Pygmy Possum species using GBIF2.jl, an interface to the Global Biodiversity Information Facility, and extract environmental variables using BioClim data from RasterDataSources.jl.

Load GBIF species data

julia
using Rasters, GBIF2
+import{_ as a,c as i,a5 as n,o as l}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/rkvbhbj.C5EV6zqa.png",c=JSON.parse('{"title":"GBIF workflow","description":"","frontmatter":{},"headers":[],"relativePath":"gbif_wflow.md","filePath":"gbif_wflow.md","lastUpdated":null}'),p={name:"gbif_wflow.md"};function e(o,s,h,k,r,d){return l(),i("div",null,s[0]||(s[0]=[n(`

GBIF workflow

In this example, we'll load occurrences for the Mountain Pygmy Possum species using GBIF2.jl, an interface to the Global Biodiversity Information Facility, and extract environmental variables using BioClim data from RasterDataSources.jl.

Load GBIF species data

julia
using Rasters, GBIF2
 using RasterDataSources
 const RS = Rasters
Rasters
julia
records = GBIF2.occurrence_search("Burramys parvus"; limit=300)
300-element GBIF2.Table{GBIF2.Occurrence, JSON3.Array{JSON3.Object, Vector{UInt8}, SubArray{UInt64, 1, Vector{UInt64}, Tuple{UnitRange{Int64}}, true}}}┌──────────────────────────┬─────────┬─────────┬─────────┬──────────┬───────────
 │                 geometry │    year │   month │     day │  kingdom │   phylum ⋯
diff --git a/previews/PR800/assets/get_started.md.DDRbUhQA.lean.js b/previews/PR800/assets/get_started.md.B_tjWWbY.js
similarity index 60%
rename from previews/PR800/assets/get_started.md.DDRbUhQA.lean.js
rename to previews/PR800/assets/get_started.md.B_tjWWbY.js
index 38ff5f95..a5c72308 100644
--- a/previews/PR800/assets/get_started.md.DDRbUhQA.lean.js
+++ b/previews/PR800/assets/get_started.md.B_tjWWbY.js
@@ -1,4 +1,4 @@
-import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/pugeeeb.DojgcnZi.png",g=JSON.parse('{"title":"Quick start","description":"","frontmatter":{},"headers":[],"relativePath":"get_started.md","filePath":"get_started.md","lastUpdated":null}'),p={name:"get_started.md"};function l(h,s,d,k,r,o){return e(),i("div",null,s[0]||(s[0]=[n(`

Quick start

Install the package by typing:

julia
] 
+import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/ikrrbuk.DojgcnZi.png",g=JSON.parse('{"title":"Quick start","description":"","frontmatter":{},"headers":[],"relativePath":"get_started.md","filePath":"get_started.md","lastUpdated":null}'),p={name:"get_started.md"};function l(h,s,d,k,r,o){return e(),i("div",null,s[0]||(s[0]=[n(`

Quick start

Install the package by typing:

julia
] 
 add Rasters

then do

julia
using Rasters

Using Rasters to read GeoTiff or NetCDF files will output something similar to the following toy examples. This is possible because Rasters.jl extends DimensionalData.jl so that spatial data can be indexed using named dimensions like X, Y and Ti (time) and e.g. spatial coordinates.

julia
using Rasters, Dates
 
 lon, lat = X(25:1:30), Y(25:1:30)
@@ -14,13 +14,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
 
 └──────────────────────────────────────────────────────────────────────────────┘
 [:, :, 1]
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

Getting the lookup array from dimensions

julia
lon = lookup(ras, X) # if X is longitude
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

Getting the lookup array from dimensions

julia
lon = lookup(ras, X) # if X is longitude
 lat = lookup(ras, Y) # if Y is latitude
Sampled{Int64} ForwardOrdered Regular Points
 wrapping: 25:1:30

Select by index

Selecting a time slice by index is done via

julia
ras[Ti(1)]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
@@ -31,13 +31,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

also

julia
ras[Ti=1]
╭───────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

also

julia
ras[Ti=1]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
 ├───────────────────────┴───────────────────────────── dims ┐
   ↓ X Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -46,13 +46,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

or and interval of indices using the syntax =a:b or (a:b)

julia
ras[Ti(1:10)]
╭──────────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

or and interval of indices using the syntax =a:b or (a:b)

julia
ras[Ti(1:10)]
╭──────────────────────────╮
 │ 6×6×10 Raster{Float64,3} │
 ├──────────────────────────┴───────────────────────────────────────────── dims ┐
   ↓ X  Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -63,13 +63,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
 
 └──────────────────────────────────────────────────────────────────────────────┘
 [:, :, 1]
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

Select by value

julia
ras[Ti=At(DateTime(2001))]
╭───────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

Select by value

julia
ras[Ti=At(DateTime(2001))]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
 ├───────────────────────┴───────────────────────────── dims ┐
   ↓ X Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -78,13 +78,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

More options are available, like Near, Contains and Where.

Dimensions

Rasters uses X, Y, and Z dimensions from DimensionalData to represent spatial directions like longitude, latitude and the vertical dimension, and subset data with them. Ti is used for time, and Band represent bands. Other dimensions can have arbitrary names, but will be treated generically. See DimensionalData for more details on how they work.

Lookup Arrays

These specify properties of the index associated with e.g. the X and Y dimension. Rasters.jl defines additional lookup arrays: Projected to handle dimensions with projections, and Mapped where the projection is mapped to another projection like EPSG(4326). Mapped is largely designed to handle NetCDF dimensions, especially with Explicit spans.

Subsetting an object

Regular getindex (e.g. A[1:100, :]) and view work on all objects just as with an Array. view is always lazy, and reads from disk are deferred until getindex is used. DimensionalData.jl Dimensions and Selectors are the other way to subset an object, making use of the objects index to find values at e.g. certain X/Y coordinates. The available selectors are listed here:

SelectorsDescription
At(x)get the index exactly matching the passed in value(s).
Near(x)get the closest index to the passed in value(s).
Where(f::Function)filter the array axis by a function of the dimension index values.
a..b/Between(a, b)get all indices between two values, excluding the high value.
Contains(x)get indices where the value x falls within an interval.

Info

  • Use the .. selector to take a view of madagascar:
julia
using Rasters, RasterDataSources
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

More options are available, like Near, Contains and Where.

Dimensions

Rasters uses X, Y, and Z dimensions from DimensionalData to represent spatial directions like longitude, latitude and the vertical dimension, and subset data with them. Ti is used for time, and Band represent bands. Other dimensions can have arbitrary names, but will be treated generically. See DimensionalData for more details on how they work.

Lookup Arrays

These specify properties of the index associated with e.g. the X and Y dimension. Rasters.jl defines additional lookup arrays: Projected to handle dimensions with projections, and Mapped where the projection is mapped to another projection like EPSG(4326). Mapped is largely designed to handle NetCDF dimensions, especially with Explicit spans.

Subsetting an object

Regular getindex (e.g. A[1:100, :]) and view work on all objects just as with an Array. view is always lazy, and reads from disk are deferred until getindex is used. DimensionalData.jl Dimensions and Selectors are the other way to subset an object, making use of the objects index to find values at e.g. certain X/Y coordinates. The available selectors are listed here:

SelectorsDescription
At(x)get the index exactly matching the passed in value(s).
Near(x)get the closest index to the passed in value(s).
Where(f::Function)filter the array axis by a function of the dimension index values.
a..b/Between(a, b)get all indices between two values, excluding the high value.
Contains(x)get indices where the value x falls within an interval.

Info

  • Use the .. selector to take a view of madagascar:
julia
using Rasters, RasterDataSources
 const RS = Rasters
 using CairoMakie
 CairoMakie.activate!()
diff --git a/previews/PR800/assets/get_started.md.DDRbUhQA.js b/previews/PR800/assets/get_started.md.B_tjWWbY.lean.js
similarity index 60%
rename from previews/PR800/assets/get_started.md.DDRbUhQA.js
rename to previews/PR800/assets/get_started.md.B_tjWWbY.lean.js
index 38ff5f95..a5c72308 100644
--- a/previews/PR800/assets/get_started.md.DDRbUhQA.js
+++ b/previews/PR800/assets/get_started.md.B_tjWWbY.lean.js
@@ -1,4 +1,4 @@
-import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/pugeeeb.DojgcnZi.png",g=JSON.parse('{"title":"Quick start","description":"","frontmatter":{},"headers":[],"relativePath":"get_started.md","filePath":"get_started.md","lastUpdated":null}'),p={name:"get_started.md"};function l(h,s,d,k,r,o){return e(),i("div",null,s[0]||(s[0]=[n(`

Quick start

Install the package by typing:

julia
] 
+import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t="/Rasters.jl/previews/PR800/assets/ikrrbuk.DojgcnZi.png",g=JSON.parse('{"title":"Quick start","description":"","frontmatter":{},"headers":[],"relativePath":"get_started.md","filePath":"get_started.md","lastUpdated":null}'),p={name:"get_started.md"};function l(h,s,d,k,r,o){return e(),i("div",null,s[0]||(s[0]=[n(`

Quick start

Install the package by typing:

julia
] 
 add Rasters

then do

julia
using Rasters

Using Rasters to read GeoTiff or NetCDF files will output something similar to the following toy examples. This is possible because Rasters.jl extends DimensionalData.jl so that spatial data can be indexed using named dimensions like X, Y and Ti (time) and e.g. spatial coordinates.

julia
using Rasters, Dates
 
 lon, lat = X(25:1:30), Y(25:1:30)
@@ -14,13 +14,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
 
 └──────────────────────────────────────────────────────────────────────────────┘
 [:, :, 1]
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

Getting the lookup array from dimensions

julia
lon = lookup(ras, X) # if X is longitude
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

Getting the lookup array from dimensions

julia
lon = lookup(ras, X) # if X is longitude
 lat = lookup(ras, Y) # if Y is latitude
Sampled{Int64} ForwardOrdered Regular Points
 wrapping: 25:1:30

Select by index

Selecting a time slice by index is done via

julia
ras[Ti(1)]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
@@ -31,13 +31,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

also

julia
ras[Ti=1]
╭───────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

also

julia
ras[Ti=1]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
 ├───────────────────────┴───────────────────────────── dims ┐
   ↓ X Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -46,13 +46,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

or and interval of indices using the syntax =a:b or (a:b)

julia
ras[Ti(1:10)]
╭──────────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

or and interval of indices using the syntax =a:b or (a:b)

julia
ras[Ti(1:10)]
╭──────────────────────────╮
 │ 6×6×10 Raster{Float64,3} │
 ├──────────────────────────┴───────────────────────────────────────────── dims ┐
   ↓ X  Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -63,13 +63,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
 
 └──────────────────────────────────────────────────────────────────────────────┘
 [:, :, 1]
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

Select by value

julia
ras[Ti=At(DateTime(2001))]
╭───────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

Select by value

julia
ras[Ti=At(DateTime(2001))]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
 ├───────────────────────┴───────────────────────────── dims ┐
   ↓ X Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -78,13 +78,13 @@ import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Gz-llJN4.js";const t
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

More options are available, like Near, Contains and Where.

Dimensions

Rasters uses X, Y, and Z dimensions from DimensionalData to represent spatial directions like longitude, latitude and the vertical dimension, and subset data with them. Ti is used for time, and Band represent bands. Other dimensions can have arbitrary names, but will be treated generically. See DimensionalData for more details on how they work.

Lookup Arrays

These specify properties of the index associated with e.g. the X and Y dimension. Rasters.jl defines additional lookup arrays: Projected to handle dimensions with projections, and Mapped where the projection is mapped to another projection like EPSG(4326). Mapped is largely designed to handle NetCDF dimensions, especially with Explicit spans.

Subsetting an object

Regular getindex (e.g. A[1:100, :]) and view work on all objects just as with an Array. view is always lazy, and reads from disk are deferred until getindex is used. DimensionalData.jl Dimensions and Selectors are the other way to subset an object, making use of the objects index to find values at e.g. certain X/Y coordinates. The available selectors are listed here:

SelectorsDescription
At(x)get the index exactly matching the passed in value(s).
Near(x)get the closest index to the passed in value(s).
Where(f::Function)filter the array axis by a function of the dimension index values.
a..b/Between(a, b)get all indices between two values, excluding the high value.
Contains(x)get indices where the value x falls within an interval.

Info

  • Use the .. selector to take a view of madagascar:
julia
using Rasters, RasterDataSources
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

More options are available, like Near, Contains and Where.

Dimensions

Rasters uses X, Y, and Z dimensions from DimensionalData to represent spatial directions like longitude, latitude and the vertical dimension, and subset data with them. Ti is used for time, and Band represent bands. Other dimensions can have arbitrary names, but will be treated generically. See DimensionalData for more details on how they work.

Lookup Arrays

These specify properties of the index associated with e.g. the X and Y dimension. Rasters.jl defines additional lookup arrays: Projected to handle dimensions with projections, and Mapped where the projection is mapped to another projection like EPSG(4326). Mapped is largely designed to handle NetCDF dimensions, especially with Explicit spans.

Subsetting an object

Regular getindex (e.g. A[1:100, :]) and view work on all objects just as with an Array. view is always lazy, and reads from disk are deferred until getindex is used. DimensionalData.jl Dimensions and Selectors are the other way to subset an object, making use of the objects index to find values at e.g. certain X/Y coordinates. The available selectors are listed here:

SelectorsDescription
At(x)get the index exactly matching the passed in value(s).
Near(x)get the closest index to the passed in value(s).
Where(f::Function)filter the array axis by a function of the dimension index values.
a..b/Between(a, b)get all indices between two values, excluding the high value.
Contains(x)get indices where the value x falls within an interval.

Info

  • Use the .. selector to take a view of madagascar:
julia
using Rasters, RasterDataSources
 const RS = Rasters
 using CairoMakie
 CairoMakie.activate!()
diff --git a/previews/PR800/assets/xocqfuw.B2QjG_n4.png b/previews/PR800/assets/igtwdmj.B2QjG_n4.png
similarity index 100%
rename from previews/PR800/assets/xocqfuw.B2QjG_n4.png
rename to previews/PR800/assets/igtwdmj.B2QjG_n4.png
diff --git a/previews/PR800/assets/pugeeeb.DojgcnZi.png b/previews/PR800/assets/ikrrbuk.DojgcnZi.png
similarity index 100%
rename from previews/PR800/assets/pugeeeb.DojgcnZi.png
rename to previews/PR800/assets/ikrrbuk.DojgcnZi.png
diff --git a/previews/PR800/assets/lydhopk.D9tQTCLW.png b/previews/PR800/assets/jgjuovf.D9tQTCLW.png
similarity index 100%
rename from previews/PR800/assets/lydhopk.D9tQTCLW.png
rename to previews/PR800/assets/jgjuovf.D9tQTCLW.png
diff --git a/previews/PR800/assets/rphqroy.Dw_eTAB7.png b/previews/PR800/assets/jvbnatg.Dw_eTAB7.png
similarity index 100%
rename from previews/PR800/assets/rphqroy.Dw_eTAB7.png
rename to previews/PR800/assets/jvbnatg.Dw_eTAB7.png
diff --git a/previews/PR800/assets/zcafhcs.BsE3Kr89.png b/previews/PR800/assets/jzchtuf.BsE3Kr89.png
similarity index 100%
rename from previews/PR800/assets/zcafhcs.BsE3Kr89.png
rename to previews/PR800/assets/jzchtuf.BsE3Kr89.png
diff --git a/previews/PR800/assets/wrizdcy.oyWWmvC1.png b/previews/PR800/assets/khhivpk.oyWWmvC1.png
similarity index 100%
rename from previews/PR800/assets/wrizdcy.oyWWmvC1.png
rename to previews/PR800/assets/khhivpk.oyWWmvC1.png
diff --git a/previews/PR800/assets/ybqastg.Djo3H46f.png b/previews/PR800/assets/kiunmni.Djo3H46f.png
similarity index 100%
rename from previews/PR800/assets/ybqastg.Djo3H46f.png
rename to previews/PR800/assets/kiunmni.Djo3H46f.png
diff --git a/previews/PR800/assets/kolpjjy.CVwZE_Z9.png b/previews/PR800/assets/kolpjjy.CVwZE_Z9.png
deleted file mode 100644
index 0f46062e..00000000
Binary files a/previews/PR800/assets/kolpjjy.CVwZE_Z9.png and /dev/null differ
diff --git a/previews/PR800/assets/plot_makie.md.67kD4dPf.js b/previews/PR800/assets/plot_makie.md.D1FlA7d6.js
similarity index 99%
rename from previews/PR800/assets/plot_makie.md.67kD4dPf.js
rename to previews/PR800/assets/plot_makie.md.D1FlA7d6.js
index 08ccc303..86ca229c 100644
--- a/previews/PR800/assets/plot_makie.md.67kD4dPf.js
+++ b/previews/PR800/assets/plot_makie.md.D1FlA7d6.js
@@ -1,4 +1,4 @@
-import{_ as n,c as e,a5 as a,j as i,a as l,G as h,B as p,o as k}from"./chunks/framework.Gz-llJN4.js";const r="/Rasters.jl/previews/PR800/assets/mtvepoh.ALj2aDbZ.png",d="/Rasters.jl/previews/PR800/assets/rphqroy.Dw_eTAB7.png",o="/Rasters.jl/previews/PR800/assets/xocqfuw.B2QjG_n4.png",E="/Rasters.jl/previews/PR800/assets/rplot.CwrU8Sen.mp4",g="/Rasters.jl/previews/PR800/assets/aus_trim.B4Z7jnS4.png",D=JSON.parse('{"title":"reset theme","description":"","frontmatter":{},"headers":[],"relativePath":"plot_makie.md","filePath":"plot_makie.md","lastUpdated":null}'),c={name:"plot_makie.md"},y={class:"jldocstring custom-block",open:""};function F(u,s,C,m,b,f){const t=p("Badge");return k(),e("div",null,[s[3]||(s[3]=a(`

Plotting in Makie

Plotting in Makie works somewhat differently than Plots, since the recipe system is different. You can pass a 2-D raster to any surface-like function (heatmap, contour, contourf, or even surface for a 3D plot) with ease.

2-D rasters in Makie

julia
using CairoMakie, Makie
+import{_ as n,c as e,a5 as a,j as i,a as l,G as h,B as p,o as k}from"./chunks/framework.Gz-llJN4.js";const r="/Rasters.jl/previews/PR800/assets/szgtxlr.ALj2aDbZ.png",d="/Rasters.jl/previews/PR800/assets/jvbnatg.Dw_eTAB7.png",o="/Rasters.jl/previews/PR800/assets/igtwdmj.B2QjG_n4.png",E="/Rasters.jl/previews/PR800/assets/rplot.CwrU8Sen.mp4",g="/Rasters.jl/previews/PR800/assets/aus_trim.B4Z7jnS4.png",D=JSON.parse('{"title":"reset theme","description":"","frontmatter":{},"headers":[],"relativePath":"plot_makie.md","filePath":"plot_makie.md","lastUpdated":null}'),c={name:"plot_makie.md"},y={class:"jldocstring custom-block",open:""};function F(u,s,C,m,b,f){const t=p("Badge");return k(),e("div",null,[s[3]||(s[3]=a(`

Plotting in Makie

Plotting in Makie works somewhat differently than Plots, since the recipe system is different. You can pass a 2-D raster to any surface-like function (heatmap, contour, contourf, or even surface for a 3D plot) with ease.

2-D rasters in Makie

julia
using CairoMakie, Makie
 using Rasters, RasterDataSources, ArchGDAL
 A = Raster(WorldClim{BioClim}, 5) # this is a 3D raster, so is not accepted.
╭──────────────────────────────────╮
 │ 2160×1080 Raster{Float32,2} bio5 │
@@ -34,7 +34,7 @@ import{_ as n,c as e,a5 as a,j as i,a as l,G as h,B as p,o as k}from"./chunks/fr
 )
 record(fig, "rplot.mp4", 1:12; framerate = 3) do i
     stack_obs[] = RasterStack(WorldClim{Climate}; month = i)
-end
"rplot.mp4"

julia
Makie.set_theme!() # reset theme
',25)),i("details",y,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.rplot",href:"#Rasters.rplot"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[1]||(s[1]=l()),h(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

',5))]),s[4]||(s[4]=a(`

Using vanilla Makie

julia
using Rasters, RasterDataSources

The data

julia
layers = (:evenness, :range, :contrast, :correlation)
+end
"rplot.mp4"

julia
Makie.set_theme!() # reset theme
',25)),i("details",y,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.rplot",href:"#Rasters.rplot"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[1]||(s[1]=l()),h(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

',5))]),s[4]||(s[4]=a(`

Using vanilla Makie

julia
using Rasters, RasterDataSources

The data

julia
layers = (:evenness, :range, :contrast, :correlation)
 st = RasterStack(EarthEnv{HabitatHeterogeneity}, layers)
 ausbounds = X(100 .. 160), Y(-50 .. -10) # Roughly cut out australia
 aus = st[ausbounds...] |> Rasters.trim
╭─────────────────────╮
diff --git a/previews/PR800/assets/plot_makie.md.67kD4dPf.lean.js b/previews/PR800/assets/plot_makie.md.D1FlA7d6.lean.js
similarity index 99%
rename from previews/PR800/assets/plot_makie.md.67kD4dPf.lean.js
rename to previews/PR800/assets/plot_makie.md.D1FlA7d6.lean.js
index 08ccc303..86ca229c 100644
--- a/previews/PR800/assets/plot_makie.md.67kD4dPf.lean.js
+++ b/previews/PR800/assets/plot_makie.md.D1FlA7d6.lean.js
@@ -1,4 +1,4 @@
-import{_ as n,c as e,a5 as a,j as i,a as l,G as h,B as p,o as k}from"./chunks/framework.Gz-llJN4.js";const r="/Rasters.jl/previews/PR800/assets/mtvepoh.ALj2aDbZ.png",d="/Rasters.jl/previews/PR800/assets/rphqroy.Dw_eTAB7.png",o="/Rasters.jl/previews/PR800/assets/xocqfuw.B2QjG_n4.png",E="/Rasters.jl/previews/PR800/assets/rplot.CwrU8Sen.mp4",g="/Rasters.jl/previews/PR800/assets/aus_trim.B4Z7jnS4.png",D=JSON.parse('{"title":"reset theme","description":"","frontmatter":{},"headers":[],"relativePath":"plot_makie.md","filePath":"plot_makie.md","lastUpdated":null}'),c={name:"plot_makie.md"},y={class:"jldocstring custom-block",open:""};function F(u,s,C,m,b,f){const t=p("Badge");return k(),e("div",null,[s[3]||(s[3]=a(`

Plotting in Makie

Plotting in Makie works somewhat differently than Plots, since the recipe system is different. You can pass a 2-D raster to any surface-like function (heatmap, contour, contourf, or even surface for a 3D plot) with ease.

2-D rasters in Makie

julia
using CairoMakie, Makie
+import{_ as n,c as e,a5 as a,j as i,a as l,G as h,B as p,o as k}from"./chunks/framework.Gz-llJN4.js";const r="/Rasters.jl/previews/PR800/assets/szgtxlr.ALj2aDbZ.png",d="/Rasters.jl/previews/PR800/assets/jvbnatg.Dw_eTAB7.png",o="/Rasters.jl/previews/PR800/assets/igtwdmj.B2QjG_n4.png",E="/Rasters.jl/previews/PR800/assets/rplot.CwrU8Sen.mp4",g="/Rasters.jl/previews/PR800/assets/aus_trim.B4Z7jnS4.png",D=JSON.parse('{"title":"reset theme","description":"","frontmatter":{},"headers":[],"relativePath":"plot_makie.md","filePath":"plot_makie.md","lastUpdated":null}'),c={name:"plot_makie.md"},y={class:"jldocstring custom-block",open:""};function F(u,s,C,m,b,f){const t=p("Badge");return k(),e("div",null,[s[3]||(s[3]=a(`

Plotting in Makie

Plotting in Makie works somewhat differently than Plots, since the recipe system is different. You can pass a 2-D raster to any surface-like function (heatmap, contour, contourf, or even surface for a 3D plot) with ease.

2-D rasters in Makie

julia
using CairoMakie, Makie
 using Rasters, RasterDataSources, ArchGDAL
 A = Raster(WorldClim{BioClim}, 5) # this is a 3D raster, so is not accepted.
╭──────────────────────────────────╮
 │ 2160×1080 Raster{Float32,2} bio5 │
@@ -34,7 +34,7 @@ import{_ as n,c as e,a5 as a,j as i,a as l,G as h,B as p,o as k}from"./chunks/fr
 )
 record(fig, "rplot.mp4", 1:12; framerate = 3) do i
     stack_obs[] = RasterStack(WorldClim{Climate}; month = i)
-end
"rplot.mp4"

julia
Makie.set_theme!() # reset theme
',25)),i("details",y,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.rplot",href:"#Rasters.rplot"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[1]||(s[1]=l()),h(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

',5))]),s[4]||(s[4]=a(`

Using vanilla Makie

julia
using Rasters, RasterDataSources

The data

julia
layers = (:evenness, :range, :contrast, :correlation)
+end
"rplot.mp4"

julia
Makie.set_theme!() # reset theme
',25)),i("details",y,[i("summary",null,[s[0]||(s[0]=i("a",{id:"Rasters.rplot",href:"#Rasters.rplot"},[i("span",{class:"jlbinding"},"Rasters.rplot")],-1)),s[1]||(s[1]=l()),h(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a('
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

',5))]),s[4]||(s[4]=a(`

Using vanilla Makie

julia
using Rasters, RasterDataSources

The data

julia
layers = (:evenness, :range, :contrast, :correlation)
 st = RasterStack(EarthEnv{HabitatHeterogeneity}, layers)
 ausbounds = X(100 .. 160), Y(-50 .. -10) # Roughly cut out australia
 aus = st[ausbounds...] |> Rasters.trim
╭─────────────────────╮
diff --git a/previews/PR800/assets/plotting.md.BR5BBklN.js b/previews/PR800/assets/plotting.md.Cp8KBLhp.js
similarity index 98%
rename from previews/PR800/assets/plotting.md.BR5BBklN.js
rename to previews/PR800/assets/plotting.md.Cp8KBLhp.js
index a1c30910..093bf4cd 100644
--- a/previews/PR800/assets/plotting.md.BR5BBklN.js
+++ b/previews/PR800/assets/plotting.md.Cp8KBLhp.js
@@ -1,4 +1,4 @@
-import{_ as a,c as i,a5 as n,o as t}from"./chunks/framework.Gz-llJN4.js";const e="/Rasters.jl/previews/PR800/assets/wrizdcy.oyWWmvC1.png",p="/Rasters.jl/previews/PR800/assets/grjxpva.BRgQ_uqM.png",l="/Rasters.jl/previews/PR800/assets/pzpmiye.2YhfOv1i.png",h="/Rasters.jl/previews/PR800/assets/snpuzzk.CO0mgiME.png",k="/Rasters.jl/previews/PR800/assets/zcafhcs.BsE3Kr89.png",o="/Rasters.jl/previews/PR800/assets/tzgtvbi.CVxd1wxn.png",d="/Rasters.jl/previews/PR800/assets/kwihdup.BPZOvOxi.png",r="/Rasters.jl/previews/PR800/assets/ybqastg.Djo3H46f.png",c="/Rasters.jl/previews/PR800/assets/wuznzvi.CUldC_pQ.png",g="/Rasters.jl/previews/PR800/assets/vgpyavh.8o5RdXOt.png",E="/Rasters.jl/previews/PR800/assets/lydhopk.D9tQTCLW.png",u="/Rasters.jl/previews/PR800/assets/rtguujd.H6rBHY04.png",D=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"plotting.md","filePath":"plotting.md","lastUpdated":null}'),y={name:"plotting.md"};function m(F,s,C,v,b,q){return t(),i("div",null,s[0]||(s[0]=[n(`

Plots, simple

Plots.jl and Makie.jl are fully supported by Rasters.jl, with recipes for plotting Raster and RasterStack provided. plot will plot a heatmap with axes matching dimension values. If mappedcrs is used, converted values will be shown on axes instead of the underlying crs values. contourf will similarly plot a filled contour plot.

Pixel resolution is limited to allow loading very large files quickly. max_res specifies the maximum pixel resolution to show on the longest axis of the array. It can be set manually to change the resolution (e.g. for large or high-quality plots):

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
+import{_ as a,c as i,a5 as n,o as t}from"./chunks/framework.Gz-llJN4.js";const e="/Rasters.jl/previews/PR800/assets/khhivpk.oyWWmvC1.png",p="/Rasters.jl/previews/PR800/assets/vkxddvq.BRgQ_uqM.png",l="/Rasters.jl/previews/PR800/assets/xhkeuwz.2YhfOv1i.png",h="/Rasters.jl/previews/PR800/assets/tqdscwa.CO0mgiME.png",k="/Rasters.jl/previews/PR800/assets/jzchtuf.BsE3Kr89.png",o="/Rasters.jl/previews/PR800/assets/aaheudt.CVxd1wxn.png",d="/Rasters.jl/previews/PR800/assets/bgdqfag.BPZOvOxi.png",r="/Rasters.jl/previews/PR800/assets/kiunmni.Djo3H46f.png",c="/Rasters.jl/previews/PR800/assets/wnsbdrj.CUldC_pQ.png",g="/Rasters.jl/previews/PR800/assets/eympwzi.8o5RdXOt.png",E="/Rasters.jl/previews/PR800/assets/jgjuovf.D9tQTCLW.png",u="/Rasters.jl/previews/PR800/assets/xtsuerf.H6rBHY04.png",D=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"plotting.md","filePath":"plotting.md","lastUpdated":null}'),y={name:"plotting.md"};function m(F,s,C,v,b,q){return t(),i("div",null,s[0]||(s[0]=[n(`

Plots, simple

Plots.jl and Makie.jl are fully supported by Rasters.jl, with recipes for plotting Raster and RasterStack provided. plot will plot a heatmap with axes matching dimension values. If mappedcrs is used, converted values will be shown on axes instead of the underlying crs values. contourf will similarly plot a filled contour plot.

Pixel resolution is limited to allow loading very large files quickly. max_res specifies the maximum pixel resolution to show on the longest axis of the array. It can be set manually to change the resolution (e.g. for large or high-quality plots):

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{BioClim}, 5)
 plot(A; max_res=3000)

For Makie, plot functions in a similar way. plot will only accept two-dimensional rasters. You can invoke contour, contourf, heatmap, surface or any Makie plotting function which supports surface-like data on a 2D raster.

To obtain tiled plots for 3D rasters and RasterStacks, use the function Rasters.rplot([gridposition], raster; kw_args...). This is an unexported function, since we're not sure how the API will change going forward.

Makie, simple

julia
using CairoMakie
 CairoMakie.activate!(px_per_unit = 2)
diff --git a/previews/PR800/assets/plotting.md.BR5BBklN.lean.js b/previews/PR800/assets/plotting.md.Cp8KBLhp.lean.js
similarity index 98%
rename from previews/PR800/assets/plotting.md.BR5BBklN.lean.js
rename to previews/PR800/assets/plotting.md.Cp8KBLhp.lean.js
index a1c30910..093bf4cd 100644
--- a/previews/PR800/assets/plotting.md.BR5BBklN.lean.js
+++ b/previews/PR800/assets/plotting.md.Cp8KBLhp.lean.js
@@ -1,4 +1,4 @@
-import{_ as a,c as i,a5 as n,o as t}from"./chunks/framework.Gz-llJN4.js";const e="/Rasters.jl/previews/PR800/assets/wrizdcy.oyWWmvC1.png",p="/Rasters.jl/previews/PR800/assets/grjxpva.BRgQ_uqM.png",l="/Rasters.jl/previews/PR800/assets/pzpmiye.2YhfOv1i.png",h="/Rasters.jl/previews/PR800/assets/snpuzzk.CO0mgiME.png",k="/Rasters.jl/previews/PR800/assets/zcafhcs.BsE3Kr89.png",o="/Rasters.jl/previews/PR800/assets/tzgtvbi.CVxd1wxn.png",d="/Rasters.jl/previews/PR800/assets/kwihdup.BPZOvOxi.png",r="/Rasters.jl/previews/PR800/assets/ybqastg.Djo3H46f.png",c="/Rasters.jl/previews/PR800/assets/wuznzvi.CUldC_pQ.png",g="/Rasters.jl/previews/PR800/assets/vgpyavh.8o5RdXOt.png",E="/Rasters.jl/previews/PR800/assets/lydhopk.D9tQTCLW.png",u="/Rasters.jl/previews/PR800/assets/rtguujd.H6rBHY04.png",D=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"plotting.md","filePath":"plotting.md","lastUpdated":null}'),y={name:"plotting.md"};function m(F,s,C,v,b,q){return t(),i("div",null,s[0]||(s[0]=[n(`

Plots, simple

Plots.jl and Makie.jl are fully supported by Rasters.jl, with recipes for plotting Raster and RasterStack provided. plot will plot a heatmap with axes matching dimension values. If mappedcrs is used, converted values will be shown on axes instead of the underlying crs values. contourf will similarly plot a filled contour plot.

Pixel resolution is limited to allow loading very large files quickly. max_res specifies the maximum pixel resolution to show on the longest axis of the array. It can be set manually to change the resolution (e.g. for large or high-quality plots):

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
+import{_ as a,c as i,a5 as n,o as t}from"./chunks/framework.Gz-llJN4.js";const e="/Rasters.jl/previews/PR800/assets/khhivpk.oyWWmvC1.png",p="/Rasters.jl/previews/PR800/assets/vkxddvq.BRgQ_uqM.png",l="/Rasters.jl/previews/PR800/assets/xhkeuwz.2YhfOv1i.png",h="/Rasters.jl/previews/PR800/assets/tqdscwa.CO0mgiME.png",k="/Rasters.jl/previews/PR800/assets/jzchtuf.BsE3Kr89.png",o="/Rasters.jl/previews/PR800/assets/aaheudt.CVxd1wxn.png",d="/Rasters.jl/previews/PR800/assets/bgdqfag.BPZOvOxi.png",r="/Rasters.jl/previews/PR800/assets/kiunmni.Djo3H46f.png",c="/Rasters.jl/previews/PR800/assets/wnsbdrj.CUldC_pQ.png",g="/Rasters.jl/previews/PR800/assets/eympwzi.8o5RdXOt.png",E="/Rasters.jl/previews/PR800/assets/jgjuovf.D9tQTCLW.png",u="/Rasters.jl/previews/PR800/assets/xtsuerf.H6rBHY04.png",D=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"plotting.md","filePath":"plotting.md","lastUpdated":null}'),y={name:"plotting.md"};function m(F,s,C,v,b,q){return t(),i("div",null,s[0]||(s[0]=[n(`

Plots, simple

Plots.jl and Makie.jl are fully supported by Rasters.jl, with recipes for plotting Raster and RasterStack provided. plot will plot a heatmap with axes matching dimension values. If mappedcrs is used, converted values will be shown on axes instead of the underlying crs values. contourf will similarly plot a filled contour plot.

Pixel resolution is limited to allow loading very large files quickly. max_res specifies the maximum pixel resolution to show on the longest axis of the array. It can be set manually to change the resolution (e.g. for large or high-quality plots):

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{BioClim}, 5)
 plot(A; max_res=3000)

For Makie, plot functions in a similar way. plot will only accept two-dimensional rasters. You can invoke contour, contourf, heatmap, surface or any Makie plotting function which supports surface-like data on a 2D raster.

To obtain tiled plots for 3D rasters and RasterStacks, use the function Rasters.rplot([gridposition], raster; kw_args...). This is an unexported function, since we're not sure how the API will change going forward.

Makie, simple

julia
using CairoMakie
 CairoMakie.activate!(px_per_unit = 2)
diff --git a/previews/PR800/assets/rkvbhbj.C5EV6zqa.png b/previews/PR800/assets/rkvbhbj.C5EV6zqa.png
new file mode 100644
index 00000000..61c3653e
Binary files /dev/null and b/previews/PR800/assets/rkvbhbj.C5EV6zqa.png differ
diff --git a/previews/PR800/assets/mtvepoh.ALj2aDbZ.png b/previews/PR800/assets/szgtxlr.ALj2aDbZ.png
similarity index 100%
rename from previews/PR800/assets/mtvepoh.ALj2aDbZ.png
rename to previews/PR800/assets/szgtxlr.ALj2aDbZ.png
diff --git a/previews/PR800/assets/snpuzzk.CO0mgiME.png b/previews/PR800/assets/tqdscwa.CO0mgiME.png
similarity index 100%
rename from previews/PR800/assets/snpuzzk.CO0mgiME.png
rename to previews/PR800/assets/tqdscwa.CO0mgiME.png
diff --git a/previews/PR800/assets/tutorials_methods_cellarea.md.C_W3YIyf.js b/previews/PR800/assets/tutorials_methods_cellarea.md.Cr47Fy1Q.js
similarity index 76%
rename from previews/PR800/assets/tutorials_methods_cellarea.md.C_W3YIyf.js
rename to previews/PR800/assets/tutorials_methods_cellarea.md.Cr47Fy1Q.js
index 1cb9015f..b6bf2952 100644
--- a/previews/PR800/assets/tutorials_methods_cellarea.md.C_W3YIyf.js
+++ b/previews/PR800/assets/tutorials_methods_cellarea.md.Cr47Fy1Q.js
@@ -1,4 +1,4 @@
-import{_ as n,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/framework.Gz-llJN4.js";const k="/Rasters.jl/previews/PR800/assets/wjpjnzq.DmJuxPXF.png",F=JSON.parse('{"title":"cellarea tutorial","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/methods/cellarea.md","filePath":"tutorials/methods/cellarea.md","lastUpdated":null}'),d={name:"tutorials/methods/cellarea.md"},o={class:"jldocstring custom-block"};function c(g,s,u,y,E,C){const t=h("Badge");return r(),p("div",null,[s[3]||(s[3]=a("h1",{id:"cellarea-tutorial",tabindex:"-1"},[a("code",null,"cellarea"),i(" tutorial "),a("a",{class:"header-anchor",href:"#cellarea-tutorial","aria-label":'Permalink to "`cellarea` tutorial {#cellarea-tutorial}"'},"​")],-1)),a("details",o,[a("summary",null,[s[0]||(s[0]=a("a",{id:"Rasters.cellarea-tutorials-methods-cellarea",href:"#Rasters.cellarea-tutorials-methods-cellarea"},[a("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[1]||(s[1]=i()),l(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=e(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
+import{_ as t,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/framework.Gz-llJN4.js";const k="/Rasters.jl/previews/PR800/assets/dciuddq.DdtYyM8O.png",m=JSON.parse('{"title":"cellarea tutorial","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/methods/cellarea.md","filePath":"tutorials/methods/cellarea.md","lastUpdated":null}'),d={name:"tutorials/methods/cellarea.md"},o={class:"jldocstring custom-block"};function c(g,s,y,u,E,C){const n=h("Badge");return r(),p("div",null,[s[3]||(s[3]=a("h1",{id:"cellarea-tutorial",tabindex:"-1"},[a("code",null,"cellarea"),i(" tutorial "),a("a",{class:"header-anchor",href:"#cellarea-tutorial","aria-label":'Permalink to "`cellarea` tutorial {#cellarea-tutorial}"'},"​")],-1)),a("details",o,[a("summary",null,[s[0]||(s[0]=a("a",{id:"Rasters.cellarea-tutorials-methods-cellarea",href:"#Rasters.cellarea-tutorials-methods-cellarea"},[a("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[1]||(s[1]=i()),l(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=e(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
 xdim = X(Projected(90.0:10.0:120; sampling=Intervals(Start()), crs=EPSG(4326)))
 ydim = Y(Projected(0.0:10.0:50; sampling=Intervals(Start()), crs=EPSG(4326)))
 myraster = rand(xdim, ydim)
@@ -19,7 +19,9 @@ import{_ as n,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/fr
   90.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  100.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  110.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
- 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),s[4]||(s[4]=e(`

cellarea computes the area of each cell in a raster. This is useful for a number of reasons - if you have a variable like population per cell, or elevation (spatially extensive variables), you'll want to account for the fact that different cells have different areas.

cellarea returns a Raster with the same x and y dimensions as the input, where each value in the raster encodes the area of the cell (in meters by default).

You can specify whether you want to compute the area in the plane of your projection (Planar()), on a sphere of some radius (Spherical(; radius=...)). <!– or on an ellipsoid (Geodetic()), using the first argument.–>

Let's construct a raster and see what this looks like! We'll keep it in memory.

The spherical <!– and geodetic –> method relies on the Proj.jl package to perform coordinate transformation, so that has to be loaded explicitly.

julia
using Rasters, Proj

To construct a raster, we'll need to specify the x and y dimensions. These are called "lookups" in Rasters.jl.

julia
using Rasters.Lookups

We can now construct the x and y lookups. Here we'll use a start-at-one, step-by-five grid. Note that we're specifying that the "sampling", i.e., what the coordinates actually mean, is Intervals(Start()), meaning that the coordinates are the starting point of each interval.

This is in contrast to Points() sampling, where each index in the raster represents the value at a sampling point; here, each index represents a grid cell, which is defined by the coordinate being at the start.

julia
x = X(1:5:30; sampling = Intervals(Start()), crs = EPSG(4326))
+ 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),s[4]||(s[4]=e(`

cellarea computes the area of each cell in a raster. This is useful for a number of reasons - if you have a variable like population per cell, or elevation (spatially extensive variables), you'll want to account for the fact that different cells have different areas.

cellarea returns a Raster with the same x and y dimensions as the input, where each value in the raster encodes the area of the cell (in meters by default).

You can specify whether you want to compute the area in the plane of your projection (Planar()), on a sphere of some radius (Spherical(; radius=...)). <!– or on an ellipsoid (Geodetic()), using the first argument.–>

Let's construct a raster and see what this looks like! We'll keep it in memory.

The spherical <!– and geodetic –> method relies on the Proj.jl package to perform coordinate transformation, so that has to be loaded explicitly.

julia
using Rasters
+import Proj # to activate the spherical \`cellarea\` method
+import ArchGDAL # purely for data loading

To construct a raster, we'll need to specify the x and y dimensions. These are called "lookups" in Rasters.jl.

julia
using Rasters.Lookups

We can now construct the x and y lookups. Here we'll use a start-at-one, step-by-five grid. Note that we're specifying that the "sampling", i.e., what the coordinates actually mean, is Intervals(Start()), meaning that the coordinates are the starting point of each interval.

This is in contrast to Points() sampling, where each index in the raster represents the value at a sampling point; here, each index represents a grid cell, which is defined by the coordinate being at the start.

julia
x = X(1:5:30; sampling = Intervals(Start()), crs = EPSG(4326))
 y = Y(50:5:80; sampling = Intervals(Start()), crs = EPSG(4326))
Y

I have chosen the y-range here specifically so we can show the difference between spherical and planar cellarea.

julia
ras = Raster(ones(x, y); crs = EPSG(4326))
╭───────────────────────╮
 │ 6×7 Raster{Float64,2} │
 ├───────────────────────┴──────────────────────────────────────── dims ┐
@@ -52,14 +54,30 @@ import{_ as n,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/fr
  11     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10
  16     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10
  21     1.88114e11   1.66031e11   1.42685e11  …   6.68821e10   4.0334e10
- 26     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10

and if we plot it, you can see the difference in cell area as we go from the equator to the poles:

julia
using Makie, CairoMakie# , GeoMakie
-heatmap(ras; axis = (; aspect = DataAspect()))

We can also try this using the planar method, which simply computes the area of the rectangle using area = x_side_length * y_side_length:

@example
cellarea(ras, Planar())

Note that this is of course wildly inaccurate for a geographic dataset - but if you're working in a projected coordinate system, like polar stereographic or Mercator, this can be very useful (and a lot faster)!

Usage example

Let's get the rainfall over Chile, and compute the average rainfall per meter squared across the country for the month of June.

We'll get the precipitation data across the globe from WorldClim, via RasterDataSources.jl, and use the month keyword argument to get the June data.

Then, we can get the geometry of Chile from NaturalEarth.jl, and use Rasters.mask to get the data just for Chile.

@example
using RasterDataSources, NaturalEarth
+ 26     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10

and if we plot it, you can see the difference in cell area as we go from the equator to the poles:

julia
using Makie, CairoMakie
+heatmap(cellarea(ras); axis = (; aspect = DataAspect()))

We can also try this using the planar method, which simply computes the area of the rectangle using area = x_side_length * y_side_length:

julia
cellarea(Planar(), ras)
╭─────────────────────╮
+│ 6×7 Raster{Int64,2} │
+├─────────────────────┴────────────────────────────────────────── dims ┐
+  ↓ X Projected{Int64} 1:5:26 ForwardOrdered Regular Intervals{Start},
+  → Y Projected{Int64} 50:5:80 ForwardOrdered Regular Intervals{Start}
+├────────────────────────────────────────────────────────────── raster ┤
+  extent: Extent(X = (1, 31), Y = (50, 85))
+
+  crs: EPSG:4326
+└──────────────────────────────────────────────────────────────────────┘
+  ↓ →  50  55  60  65  70  75  80
+  1    25  25  25  25  25  25  25
+  6    25  25  25  25  25  25  25
+ 11    25  25  25  25  25  25  25
+ 16    25  25  25  25  25  25  25
+ 21    25  25  25  25  25  25  25
+ 26    25  25  25  25  25  25  25

Note that this is of course wildly inaccurate for a geographic dataset - but if you're working in a projected coordinate system, like polar stereographic or Mercator, this can be very useful (and a lot faster)!

Usage example

Let's get the rainfall over Chile, and compute the average rainfall per meter squared across the country for the month of June.

We'll get the precipitation data across the globe from WorldClim, via RasterDataSources.jl, and use the month keyword argument to get the June data.

Then, we can get the geometry of Chile from NaturalEarth.jl, and use Rasters.mask to get the data just for Chile.

@example
using RasterDataSources, NaturalEarth
 
 precip = Raster(WorldClim{Climate}, :prec; month = 6)
@example
all_countries = naturalearth("admin_0_countries", 10)
 chile = all_countries.geometry[findfirst(==("Chile"), all_countries.NAME)]

Let's plot the precipitation on the world map, and highlight Chile:

@example
f, a, p = heatmap(precip; colorrange = Makie.zscale(replace_missing(precip, NaN)), axis = (; aspect = DataAspect()))
-p2 = poly!(a, chile; color = (:red, 0.5))
+p2 = poly!(a, chile; color = (:red, 0.3), strokecolor = :red, strokewidth = 0.5)
 f

You can see Chile highlighted in red, in the bottom left quadrant.

First, let's make sure that we only have the data that we care about, and crop and mask the raster so it only has values in Chile. We can crop by the geometry, which really just generates a view into the raster that is bounded by the geometry's bounding box.

@example
cropped_precip = crop(precip; to = chile)

Now, we mask the data such that any data outside the geometry is set to missing.

@example
masked_precip = mask(cropped_precip; with = chile)
 heatmap(masked_precip)

This is a lot of missing data, but that's mainly because the Chile geometry we have encompasses the Easter Islands as well, in the middle of the Pacific.

Now, let's compute the average precipitation per square meter across Chile. First, we need to get the area of each cell in square meters. We'll use the spherical method, since we're working with a geographic coordinate system. This is the default.

@example
areas = cellarea(masked_precip)
 masked_areas = mask(areas; with = chile)
-heatmap(masked_areas; axis = (; title = "Cell area in square meters"))

Now we can compute the average precipitation per square meter. First, we compute total precipitation per grid cell:

@example
precip_per_area = masked_precip .* masked_areas

We can sum this to get the total precipitation per square meter across Chile:

@example
total_precip = sum(skipmissing(precip_per_area))

We can also sum the areas to get the total area of Chile (in this raster, at least).

@example
total_area = sum(skipmissing(masked_areas))

And we can convert that to an average by dividing by the total area:

@example
avg_precip = total_precip / total_area

So on average, Chile gets about 100mm of rain per square meter in June. Let's see what happens if we don't account for cell areas:

@example
bad_total_precip = sum(skipmissing(masked_precip))
-bad_avg_precip = bad_total_precip / length(collect(skipmissing(masked_precip)))

This is misestimated! This is why it's important to account for cell areas when computing averages.

Note

If you made it this far, congratulations!

It's interesting to note that we've replicated the workflow of zonal here. zonal is a more general function that can be used to compute any function over geometries, and it has multithreading built in.

But fundamentally, this is all that zonal is doing under the hood - masking and cropping the raster to the geometry, and then computing the statistic.


This page was generated using Literate.jl.

`,54))])}const b=n(d,[["render",c]]);export{F as __pageData,b as default}; +heatmap(masked_areas; axis = (; title = "Cell area in square meters"))

Now we can compute the average precipitation per square meter. First, we compute total precipitation per grid cell:

@example
precip_per_area = masked_precip .* masked_areas

We can sum this to get the total precipitation per square meter across Chile:

@example
total_precip = sum(skipmissing(precip_per_area))

We can also sum the areas to get the total area of Chile (in this raster, at least).

@example
total_area = sum(skipmissing(masked_areas))

And we can convert that to an average by dividing by the total area:

@example
avg_precip = total_precip / total_area

According to the internet, Chile gets about 100mm of rain per square meter in June, so our statistic seems pretty close.

Let's see what happens if we don't account for cell areas:

@example
bad_total_precip = sum(skipmissing(masked_precip))
+bad_avg_precip = bad_total_precip / length(collect(skipmissing(masked_precip)))

This is misestimated! This is why it's important to account for cell areas when computing averages.

Note

If you made it this far, congratulations!

It's interesting to note that we've replicated the workflow of zonal here. zonal is a more general function that can be used to compute any function over geometries, and it has multithreading built in.

But fundamentally, this is all that zonal is doing under the hood - masking and cropping the raster to the geometry, and then computing the statistic.


This page was generated using Literate.jl.

`,56))])}const b=t(d,[["render",c]]);export{m as __pageData,b as default}; diff --git a/previews/PR800/assets/tutorials_methods_cellarea.md.C_W3YIyf.lean.js b/previews/PR800/assets/tutorials_methods_cellarea.md.Cr47Fy1Q.lean.js similarity index 76% rename from previews/PR800/assets/tutorials_methods_cellarea.md.C_W3YIyf.lean.js rename to previews/PR800/assets/tutorials_methods_cellarea.md.Cr47Fy1Q.lean.js index 1cb9015f..b6bf2952 100644 --- a/previews/PR800/assets/tutorials_methods_cellarea.md.C_W3YIyf.lean.js +++ b/previews/PR800/assets/tutorials_methods_cellarea.md.Cr47Fy1Q.lean.js @@ -1,4 +1,4 @@ -import{_ as n,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/framework.Gz-llJN4.js";const k="/Rasters.jl/previews/PR800/assets/wjpjnzq.DmJuxPXF.png",F=JSON.parse('{"title":"cellarea tutorial","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/methods/cellarea.md","filePath":"tutorials/methods/cellarea.md","lastUpdated":null}'),d={name:"tutorials/methods/cellarea.md"},o={class:"jldocstring custom-block"};function c(g,s,u,y,E,C){const t=h("Badge");return r(),p("div",null,[s[3]||(s[3]=a("h1",{id:"cellarea-tutorial",tabindex:"-1"},[a("code",null,"cellarea"),i(" tutorial "),a("a",{class:"header-anchor",href:"#cellarea-tutorial","aria-label":'Permalink to "`cellarea` tutorial {#cellarea-tutorial}"'},"​")],-1)),a("details",o,[a("summary",null,[s[0]||(s[0]=a("a",{id:"Rasters.cellarea-tutorials-methods-cellarea",href:"#Rasters.cellarea-tutorials-methods-cellarea"},[a("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[1]||(s[1]=i()),l(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=e(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
+import{_ as t,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/framework.Gz-llJN4.js";const k="/Rasters.jl/previews/PR800/assets/dciuddq.DdtYyM8O.png",m=JSON.parse('{"title":"cellarea tutorial","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/methods/cellarea.md","filePath":"tutorials/methods/cellarea.md","lastUpdated":null}'),d={name:"tutorials/methods/cellarea.md"},o={class:"jldocstring custom-block"};function c(g,s,y,u,E,C){const n=h("Badge");return r(),p("div",null,[s[3]||(s[3]=a("h1",{id:"cellarea-tutorial",tabindex:"-1"},[a("code",null,"cellarea"),i(" tutorial "),a("a",{class:"header-anchor",href:"#cellarea-tutorial","aria-label":'Permalink to "`cellarea` tutorial {#cellarea-tutorial}"'},"​")],-1)),a("details",o,[a("summary",null,[s[0]||(s[0]=a("a",{id:"Rasters.cellarea-tutorials-methods-cellarea",href:"#Rasters.cellarea-tutorials-methods-cellarea"},[a("span",{class:"jlbinding"},"Rasters.cellarea")],-1)),s[1]||(s[1]=i()),l(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=e(`
julia
cellarea([method], x)

Gives the approximate area of each gridcell of x. By assuming the earth is a sphere, it approximates the true size to about 0.1%, depending on latitude.

Run using ArchGDAL to make this method fully available.

method can be Spherical(; radius) (the default) or Planar().

  • Spherical will compute cell area on the sphere, by transforming all points back to long-lat. You can specify the radius by the radius keyword argument here. By default, this is 6371008.8, the mean radius of the Earth.

  • Planar will compute cell area in the plane of the CRS you have chosen. Be warned that this will likely be incorrect for non-equal-area projections.

Example

julia
using Rasters, ArchGDAL, Rasters.Lookups
 xdim = X(Projected(90.0:10.0:120; sampling=Intervals(Start()), crs=EPSG(4326)))
 ydim = Y(Projected(0.0:10.0:50; sampling=Intervals(Start()), crs=EPSG(4326)))
 myraster = rand(xdim, ydim)
@@ -19,7 +19,9 @@ import{_ as n,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/fr
   90.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  100.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
  110.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0
- 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),s[4]||(s[4]=e(`

cellarea computes the area of each cell in a raster. This is useful for a number of reasons - if you have a variable like population per cell, or elevation (spatially extensive variables), you'll want to account for the fact that different cells have different areas.

cellarea returns a Raster with the same x and y dimensions as the input, where each value in the raster encodes the area of the cell (in meters by default).

You can specify whether you want to compute the area in the plane of your projection (Planar()), on a sphere of some radius (Spherical(; radius=...)). <!– or on an ellipsoid (Geodetic()), using the first argument.–>

Let's construct a raster and see what this looks like! We'll keep it in memory.

The spherical <!– and geodetic –> method relies on the Proj.jl package to perform coordinate transformation, so that has to be loaded explicitly.

julia
using Rasters, Proj

To construct a raster, we'll need to specify the x and y dimensions. These are called "lookups" in Rasters.jl.

julia
using Rasters.Lookups

We can now construct the x and y lookups. Here we'll use a start-at-one, step-by-five grid. Note that we're specifying that the "sampling", i.e., what the coordinates actually mean, is Intervals(Start()), meaning that the coordinates are the starting point of each interval.

This is in contrast to Points() sampling, where each index in the raster represents the value at a sampling point; here, each index represents a grid cell, which is defined by the coordinate being at the start.

julia
x = X(1:5:30; sampling = Intervals(Start()), crs = EPSG(4326))
+ 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

`,9))]),s[4]||(s[4]=e(`

cellarea computes the area of each cell in a raster. This is useful for a number of reasons - if you have a variable like population per cell, or elevation (spatially extensive variables), you'll want to account for the fact that different cells have different areas.

cellarea returns a Raster with the same x and y dimensions as the input, where each value in the raster encodes the area of the cell (in meters by default).

You can specify whether you want to compute the area in the plane of your projection (Planar()), on a sphere of some radius (Spherical(; radius=...)). <!– or on an ellipsoid (Geodetic()), using the first argument.–>

Let's construct a raster and see what this looks like! We'll keep it in memory.

The spherical <!– and geodetic –> method relies on the Proj.jl package to perform coordinate transformation, so that has to be loaded explicitly.

julia
using Rasters
+import Proj # to activate the spherical \`cellarea\` method
+import ArchGDAL # purely for data loading

To construct a raster, we'll need to specify the x and y dimensions. These are called "lookups" in Rasters.jl.

julia
using Rasters.Lookups

We can now construct the x and y lookups. Here we'll use a start-at-one, step-by-five grid. Note that we're specifying that the "sampling", i.e., what the coordinates actually mean, is Intervals(Start()), meaning that the coordinates are the starting point of each interval.

This is in contrast to Points() sampling, where each index in the raster represents the value at a sampling point; here, each index represents a grid cell, which is defined by the coordinate being at the start.

julia
x = X(1:5:30; sampling = Intervals(Start()), crs = EPSG(4326))
 y = Y(50:5:80; sampling = Intervals(Start()), crs = EPSG(4326))
Y

I have chosen the y-range here specifically so we can show the difference between spherical and planar cellarea.

julia
ras = Raster(ones(x, y); crs = EPSG(4326))
╭───────────────────────╮
 │ 6×7 Raster{Float64,2} │
 ├───────────────────────┴──────────────────────────────────────── dims ┐
@@ -52,14 +54,30 @@ import{_ as n,c as p,j as a,a as i,G as l,a5 as e,B as h,o as r}from"./chunks/fr
  11     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10
  16     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10
  21     1.88114e11   1.66031e11   1.42685e11  …   6.68821e10   4.0334e10
- 26     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10

and if we plot it, you can see the difference in cell area as we go from the equator to the poles:

julia
using Makie, CairoMakie# , GeoMakie
-heatmap(ras; axis = (; aspect = DataAspect()))

We can also try this using the planar method, which simply computes the area of the rectangle using area = x_side_length * y_side_length:

@example
cellarea(ras, Planar())

Note that this is of course wildly inaccurate for a geographic dataset - but if you're working in a projected coordinate system, like polar stereographic or Mercator, this can be very useful (and a lot faster)!

Usage example

Let's get the rainfall over Chile, and compute the average rainfall per meter squared across the country for the month of June.

We'll get the precipitation data across the globe from WorldClim, via RasterDataSources.jl, and use the month keyword argument to get the June data.

Then, we can get the geometry of Chile from NaturalEarth.jl, and use Rasters.mask to get the data just for Chile.

@example
using RasterDataSources, NaturalEarth
+ 26     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10

and if we plot it, you can see the difference in cell area as we go from the equator to the poles:

julia
using Makie, CairoMakie
+heatmap(cellarea(ras); axis = (; aspect = DataAspect()))

We can also try this using the planar method, which simply computes the area of the rectangle using area = x_side_length * y_side_length:

julia
cellarea(Planar(), ras)
╭─────────────────────╮
+│ 6×7 Raster{Int64,2} │
+├─────────────────────┴────────────────────────────────────────── dims ┐
+  ↓ X Projected{Int64} 1:5:26 ForwardOrdered Regular Intervals{Start},
+  → Y Projected{Int64} 50:5:80 ForwardOrdered Regular Intervals{Start}
+├────────────────────────────────────────────────────────────── raster ┤
+  extent: Extent(X = (1, 31), Y = (50, 85))
+
+  crs: EPSG:4326
+└──────────────────────────────────────────────────────────────────────┘
+  ↓ →  50  55  60  65  70  75  80
+  1    25  25  25  25  25  25  25
+  6    25  25  25  25  25  25  25
+ 11    25  25  25  25  25  25  25
+ 16    25  25  25  25  25  25  25
+ 21    25  25  25  25  25  25  25
+ 26    25  25  25  25  25  25  25

Note that this is of course wildly inaccurate for a geographic dataset - but if you're working in a projected coordinate system, like polar stereographic or Mercator, this can be very useful (and a lot faster)!

Usage example

Let's get the rainfall over Chile, and compute the average rainfall per meter squared across the country for the month of June.

We'll get the precipitation data across the globe from WorldClim, via RasterDataSources.jl, and use the month keyword argument to get the June data.

Then, we can get the geometry of Chile from NaturalEarth.jl, and use Rasters.mask to get the data just for Chile.

@example
using RasterDataSources, NaturalEarth
 
 precip = Raster(WorldClim{Climate}, :prec; month = 6)
@example
all_countries = naturalearth("admin_0_countries", 10)
 chile = all_countries.geometry[findfirst(==("Chile"), all_countries.NAME)]

Let's plot the precipitation on the world map, and highlight Chile:

@example
f, a, p = heatmap(precip; colorrange = Makie.zscale(replace_missing(precip, NaN)), axis = (; aspect = DataAspect()))
-p2 = poly!(a, chile; color = (:red, 0.5))
+p2 = poly!(a, chile; color = (:red, 0.3), strokecolor = :red, strokewidth = 0.5)
 f

You can see Chile highlighted in red, in the bottom left quadrant.

First, let's make sure that we only have the data that we care about, and crop and mask the raster so it only has values in Chile. We can crop by the geometry, which really just generates a view into the raster that is bounded by the geometry's bounding box.

@example
cropped_precip = crop(precip; to = chile)

Now, we mask the data such that any data outside the geometry is set to missing.

@example
masked_precip = mask(cropped_precip; with = chile)
 heatmap(masked_precip)

This is a lot of missing data, but that's mainly because the Chile geometry we have encompasses the Easter Islands as well, in the middle of the Pacific.

Now, let's compute the average precipitation per square meter across Chile. First, we need to get the area of each cell in square meters. We'll use the spherical method, since we're working with a geographic coordinate system. This is the default.

@example
areas = cellarea(masked_precip)
 masked_areas = mask(areas; with = chile)
-heatmap(masked_areas; axis = (; title = "Cell area in square meters"))

Now we can compute the average precipitation per square meter. First, we compute total precipitation per grid cell:

@example
precip_per_area = masked_precip .* masked_areas

We can sum this to get the total precipitation per square meter across Chile:

@example
total_precip = sum(skipmissing(precip_per_area))

We can also sum the areas to get the total area of Chile (in this raster, at least).

@example
total_area = sum(skipmissing(masked_areas))

And we can convert that to an average by dividing by the total area:

@example
avg_precip = total_precip / total_area

So on average, Chile gets about 100mm of rain per square meter in June. Let's see what happens if we don't account for cell areas:

@example
bad_total_precip = sum(skipmissing(masked_precip))
-bad_avg_precip = bad_total_precip / length(collect(skipmissing(masked_precip)))

This is misestimated! This is why it's important to account for cell areas when computing averages.

Note

If you made it this far, congratulations!

It's interesting to note that we've replicated the workflow of zonal here. zonal is a more general function that can be used to compute any function over geometries, and it has multithreading built in.

But fundamentally, this is all that zonal is doing under the hood - masking and cropping the raster to the geometry, and then computing the statistic.


This page was generated using Literate.jl.

`,54))])}const b=n(d,[["render",c]]);export{F as __pageData,b as default}; +heatmap(masked_areas; axis = (; title = "Cell area in square meters"))

Now we can compute the average precipitation per square meter. First, we compute total precipitation per grid cell:

@example
precip_per_area = masked_precip .* masked_areas

We can sum this to get the total precipitation per square meter across Chile:

@example
total_precip = sum(skipmissing(precip_per_area))

We can also sum the areas to get the total area of Chile (in this raster, at least).

@example
total_area = sum(skipmissing(masked_areas))

And we can convert that to an average by dividing by the total area:

@example
avg_precip = total_precip / total_area

According to the internet, Chile gets about 100mm of rain per square meter in June, so our statistic seems pretty close.

Let's see what happens if we don't account for cell areas:

@example
bad_total_precip = sum(skipmissing(masked_precip))
+bad_avg_precip = bad_total_precip / length(collect(skipmissing(masked_precip)))

This is misestimated! This is why it's important to account for cell areas when computing averages.

Note

If you made it this far, congratulations!

It's interesting to note that we've replicated the workflow of zonal here. zonal is a more general function that can be used to compute any function over geometries, and it has multithreading built in.

But fundamentally, this is all that zonal is doing under the hood - masking and cropping the raster to the geometry, and then computing the statistic.


This page was generated using Literate.jl.

`,56))])}const b=t(d,[["render",c]]);export{m as __pageData,b as default}; diff --git a/previews/PR800/assets/grjxpva.BRgQ_uqM.png b/previews/PR800/assets/vkxddvq.BRgQ_uqM.png similarity index 100% rename from previews/PR800/assets/grjxpva.BRgQ_uqM.png rename to previews/PR800/assets/vkxddvq.BRgQ_uqM.png diff --git a/previews/PR800/assets/wjpjnzq.DmJuxPXF.png b/previews/PR800/assets/wjpjnzq.DmJuxPXF.png deleted file mode 100644 index 852a3013..00000000 Binary files a/previews/PR800/assets/wjpjnzq.DmJuxPXF.png and /dev/null differ diff --git a/previews/PR800/assets/wuznzvi.CUldC_pQ.png b/previews/PR800/assets/wnsbdrj.CUldC_pQ.png similarity index 100% rename from previews/PR800/assets/wuznzvi.CUldC_pQ.png rename to previews/PR800/assets/wnsbdrj.CUldC_pQ.png diff --git a/previews/PR800/assets/pzpmiye.2YhfOv1i.png b/previews/PR800/assets/xhkeuwz.2YhfOv1i.png similarity index 100% rename from previews/PR800/assets/pzpmiye.2YhfOv1i.png rename to previews/PR800/assets/xhkeuwz.2YhfOv1i.png diff --git a/previews/PR800/assets/rtguujd.H6rBHY04.png b/previews/PR800/assets/xtsuerf.H6rBHY04.png similarity index 100% rename from previews/PR800/assets/rtguujd.H6rBHY04.png rename to previews/PR800/assets/xtsuerf.H6rBHY04.png diff --git a/previews/PR800/assets/vaeggon.CBMwZ7qg.png b/previews/PR800/assets/zxvufnv.CBMwZ7qg.png similarity index 100% rename from previews/PR800/assets/vaeggon.CBMwZ7qg.png rename to previews/PR800/assets/zxvufnv.CBMwZ7qg.png diff --git a/previews/PR800/data_sources.html b/previews/PR800/data_sources.html index 036cdc47..bb5ac501 100644 --- a/previews/PR800/data_sources.html +++ b/previews/PR800/data_sources.html @@ -8,11 +8,11 @@ - + - + - + @@ -21,8 +21,8 @@
Skip to content

Data sources

Rasters.jl uses a number of backends to load raster data. Raster, RasterStack and RasterSeries will detect which backend to use for you, automatically.

GRD

R GRD files can be loaded natively, using Julias MMap - which means they are very fast, but are not compressed. They are always 3 dimensional, and have Y, X and Band dimensions.

NetCDF

NetCDF .nc files are loaded using NCDatasets.jl. Layers from files can be loaded as Raster("filename.nc"; name=:layername). Without name the first layer is used. RasterStack("filename.nc") will use all netcdf variables in the file that are not dimensions as layers.

NetCDF layers can have arbitrary dimensions. Known, common dimension names are converted to X, Y Z, and Ti, otherwise Dim{:layername} is used. Layers in the same file may also have different dimensions.

NetCDF files still have issues loading directly from disk for some operations. Using read(ncstack) may help.

GDAL

All files GDAL can access, such as .tiff and .asc files, can be loaded, using ArchGDAL.jl. These are generally best loaded as Raster("filename.tif"), but can be loaded as RasterStack("filename.tif"; layersfrom=Band), taking layers from the Band dimension, which is also the default.

SMAP

The Soil Moisture Active-Passive dataset provides global layers of soil moisture, temperature and other related data, in a custom HDF5 format. Layers are always 2 dimensional, with Y and X dimensions.

These can be loaded as multi-layered RasterStack("filename.h5"). Individual layers can be loaded as Raster("filename.h5"; name=:layername), without name the first layer is used.

julia
using Rasters

Missing docstring.

Missing docstring for smapseries. Check Documenter's build log for details.

Writing file formats to disk

Files can be written to disk in all formats other than SMAP HDF5 using write("filename.ext", A). See the docs for write. They can (with some caveats) be written to different formats than they were loaded in as, providing file-type conversion for spatial data.

Some metadata may be lost in formats that store little metadata, or where metadata conversion has not been completely implemented.

RasterDataSources.jl integration

RasterDataSources.jl standardises the download of common raster data sources, with a focus on datasets used in ecology and the environmental sciences. RasterDataSources.jl is tightly integrated into Rasters.jl, so that datsets and keywords can be used directly to download and load data as a Raster, RasterStack, or RasterSeries.

julia
using Rasters, CairoMakie, Dates
 using RasterDataSources
 A = Raster(WorldClim{Climate}, :tavg; month=June)
-Makie.plot(A)

See the docs for Raster, RasterStack and RasterSeries, and the docs for RasterDataSources.getraster for syntax to specify various data sources.

- +Makie.plot(A)

See the docs for Raster, RasterStack and RasterSeries, and the docs for RasterDataSources.getraster for syntax to specify various data sources.

+ \ No newline at end of file diff --git a/previews/PR800/gbif_wflow.html b/previews/PR800/gbif_wflow.html index 1545284a..0624bef6 100644 --- a/previews/PR800/gbif_wflow.html +++ b/previews/PR800/gbif_wflow.html @@ -8,11 +8,11 @@ - + - + - + @@ -80,7 +80,7 @@ p = plot(se_aus); kw = (legend=:none, opacity=0.5, markershape=:cross, markercolor=:black) foreach(i -> scatter!(p, coords; subplot=i, kw...), 1:4) -p

Then extract predictor variables.

julia
predictors = collect(extract(se_aus, coords))
256-element Vector{@NamedTuple{geometry::Tuple{Float64, Float64}, bio1::Union{Missing, Float32}, bio3::Union{Missing, Float32}, bio7::Union{Missing, Float32}, bio12::Union{Missing, Float32}}}:
+p

Then extract predictor variables.

julia
predictors = collect(extract(se_aus, coords))
256-element Vector{@NamedTuple{geometry::Tuple{Float64, Float64}, bio1::Union{Missing, Float32}, bio3::Union{Missing, Float32}, bio7::Union{Missing, Float32}, bio12::Union{Missing, Float32}}}:
  @NamedTuple{geometry::Tuple{Float64, Float64}, bio1::Union{Missing, Float32}, bio3::Union{Missing, Float32}, bio7::Union{Missing, Float32}, bio12::Union{Missing, Float32}}(((148.391097, -36.30362), 6.1706977f0, 41.119827f0, 23.4645f0, 1692.0f0))
  @NamedTuple{geometry::Tuple{Float64, Float64}, bio1::Union{Missing, Float32}, bio3::Union{Missing, Float32}, bio7::Union{Missing, Float32}, bio12::Union{Missing, Float32}}(((148.332969, -36.433349), 7.8357186f0, 41.597527f0, 23.50275f0, 1500.0f0))
  @NamedTuple{geometry::Tuple{Float64, Float64}, bio1::Union{Missing, Float32}, bio3::Union{Missing, Float32}, bio7::Union{Missing, Float32}, bio12::Union{Missing, Float32}}(((148.396453, -36.381847), 6.881583f0, 42.268078f0, 23.133f0, 1544.0f0))
@@ -104,7 +104,7 @@
 CSV.write("burramys_parvus_predictors.csv", predictors)
"burramys_parvus_predictors.csv"

Or convert them to a DataFrame:

julia
using DataFrames
 df = DataFrame(predictors)
 df[1:5,:]
- + \ No newline at end of file diff --git a/previews/PR800/get_started.html b/previews/PR800/get_started.html index 4213ccb2..065ea428 100644 --- a/previews/PR800/get_started.html +++ b/previews/PR800/get_started.html @@ -8,11 +8,11 @@ - + - + - + @@ -34,13 +34,13 @@ └──────────────────────────────────────────────────────────────────────────────┘ [:, :, 1] - ↓ → 25 26 27 28 29 30 - 25 0.693461 0.839173 0.242291 0.218817 0.929525 0.198393 - 26 0.824661 0.476077 0.715192 0.498898 0.175207 0.813814 - 27 0.985022 0.360964 0.47019 0.00451968 0.148373 0.64136 - 28 0.656881 0.261726 0.738871 0.925327 0.763696 0.785021 - 29 0.18368 0.247929 0.830128 0.659419 0.80923 0.276805 - 30 0.766683 0.296856 0.00299756 0.475879 0.991889 0.0779533

Getting the lookup array from dimensions

julia
lon = lookup(ras, X) # if X is longitude
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

Getting the lookup array from dimensions

julia
lon = lookup(ras, X) # if X is longitude
 lat = lookup(ras, Y) # if Y is latitude
Sampled{Int64} ForwardOrdered Regular Points
 wrapping: 25:1:30

Select by index

Selecting a time slice by index is done via

julia
ras[Ti(1)]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
@@ -51,13 +51,13 @@
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

also

julia
ras[Ti=1]
╭───────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

also

julia
ras[Ti=1]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
 ├───────────────────────┴───────────────────────────── dims ┐
   ↓ X Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -66,13 +66,13 @@
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

or and interval of indices using the syntax =a:b or (a:b)

julia
ras[Ti(1:10)]
╭──────────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

or and interval of indices using the syntax =a:b or (a:b)

julia
ras[Ti(1:10)]
╭──────────────────────────╮
 │ 6×6×10 Raster{Float64,3} │
 ├──────────────────────────┴───────────────────────────────────────────── dims ┐
   ↓ X  Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -83,13 +83,13 @@
 
 └──────────────────────────────────────────────────────────────────────────────┘
 [:, :, 1]
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

Select by value

julia
ras[Ti=At(DateTime(2001))]
╭───────────────────────╮
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

Select by value

julia
ras[Ti=At(DateTime(2001))]
╭───────────────────────╮
 │ 6×6 Raster{Float64,2} │
 ├───────────────────────┴───────────────────────────── dims ┐
   ↓ X Sampled{Int64} 25:1:30 ForwardOrdered Regular Points,
@@ -98,13 +98,13 @@
   extent: Extent(X = (25, 30), Y = (25, 30))
 
 └───────────────────────────────────────────────────────────┘
-  ↓ →  25         26         27           28           29         30
- 25     0.693461   0.839173   0.242291     0.218817     0.929525   0.198393
- 26     0.824661   0.476077   0.715192     0.498898     0.175207   0.813814
- 27     0.985022   0.360964   0.47019      0.00451968   0.148373   0.64136
- 28     0.656881   0.261726   0.738871     0.925327     0.763696   0.785021
- 29     0.18368    0.247929   0.830128     0.659419     0.80923    0.276805
- 30     0.766683   0.296856   0.00299756   0.475879     0.991889   0.0779533

More options are available, like Near, Contains and Where.

Dimensions

Rasters uses X, Y, and Z dimensions from DimensionalData to represent spatial directions like longitude, latitude and the vertical dimension, and subset data with them. Ti is used for time, and Band represent bands. Other dimensions can have arbitrary names, but will be treated generically. See DimensionalData for more details on how they work.

Lookup Arrays

These specify properties of the index associated with e.g. the X and Y dimension. Rasters.jl defines additional lookup arrays: Projected to handle dimensions with projections, and Mapped where the projection is mapped to another projection like EPSG(4326). Mapped is largely designed to handle NetCDF dimensions, especially with Explicit spans.

Subsetting an object

Regular getindex (e.g. A[1:100, :]) and view work on all objects just as with an Array. view is always lazy, and reads from disk are deferred until getindex is used. DimensionalData.jl Dimensions and Selectors are the other way to subset an object, making use of the objects index to find values at e.g. certain X/Y coordinates. The available selectors are listed here:

SelectorsDescription
At(x)get the index exactly matching the passed in value(s).
Near(x)get the closest index to the passed in value(s).
Where(f::Function)filter the array axis by a function of the dimension index values.
a..b/Between(a, b)get all indices between two values, excluding the high value.
Contains(x)get indices where the value x falls within an interval.

Info

  • Use the .. selector to take a view of madagascar:
julia
using Rasters, RasterDataSources
+  ↓ →  25         26          27         28         29         30
+ 25     0.114259   0.235863    0.824473   0.99858    0.981556   0.953643
+ 26     0.148827   0.894969    0.495627   0.325121   0.634271   0.867585
+ 27     0.893264   0.355984    0.639251   0.127338   0.928556   0.951755
+ 28     0.715572   0.0408142   0.130584   0.907328   0.564505   0.539214
+ 29     0.908018   0.990331    0.173672   0.509966   0.44336    0.896916
+ 30     0.10944    0.972705    0.162339   0.110339   0.847912   0.353274

More options are available, like Near, Contains and Where.

Dimensions

Rasters uses X, Y, and Z dimensions from DimensionalData to represent spatial directions like longitude, latitude and the vertical dimension, and subset data with them. Ti is used for time, and Band represent bands. Other dimensions can have arbitrary names, but will be treated generically. See DimensionalData for more details on how they work.

Lookup Arrays

These specify properties of the index associated with e.g. the X and Y dimension. Rasters.jl defines additional lookup arrays: Projected to handle dimensions with projections, and Mapped where the projection is mapped to another projection like EPSG(4326). Mapped is largely designed to handle NetCDF dimensions, especially with Explicit spans.

Subsetting an object

Regular getindex (e.g. A[1:100, :]) and view work on all objects just as with an Array. view is always lazy, and reads from disk are deferred until getindex is used. DimensionalData.jl Dimensions and Selectors are the other way to subset an object, making use of the objects index to find values at e.g. certain X/Y coordinates. The available selectors are listed here:

SelectorsDescription
At(x)get the index exactly matching the passed in value(s).
Near(x)get the closest index to the passed in value(s).
Where(f::Function)filter the array axis by a function of the dimension index values.
a..b/Between(a, b)get all indices between two values, excluding the high value.
Contains(x)get indices where the value x falls within an interval.

Info

  • Use the .. selector to take a view of madagascar:
julia
using Rasters, RasterDataSources
 const RS = Rasters
 using CairoMakie
 CairoMakie.activate!()
@@ -112,8 +112,8 @@
 A = Raster(WorldClim{BioClim}, 5)
 madagascar = view(A, X(43.25 .. 50.48), Y(-25.61 .. -12.04))
 # Note the space between .. -12
-Makie.plot(madagascar)

- +Makie.plot(madagascar)

+ \ No newline at end of file diff --git a/previews/PR800/hashmap.json b/previews/PR800/hashmap.json index de7be7ca..d6283635 100644 --- a/previews/PR800/hashmap.json +++ b/previews/PR800/hashmap.json @@ -1 +1 @@ -{"api.md":"CT61Ntce","array_operations.md":"B1UT5eHS","data_sources.md":"Rgk0yRjv","gbif_wflow.md":"CkT2Rbvf","get_started.md":"DDRbUhQA","index.md":"CgxmSlcc","methods.md":"CHZCoEx9","plot_makie.md":"67kD4dPf","plotting.md":"BR5BBklN","tutorials_methods_cellarea.md":"C_W3YIyf"} +{"api.md":"B3FoRFRA","array_operations.md":"B1UT5eHS","data_sources.md":"DiNgOJfA","gbif_wflow.md":"CAXtS9zz","get_started.md":"B_tjWWbY","index.md":"CgxmSlcc","methods.md":"CHZCoEx9","plot_makie.md":"D1FlA7d6","plotting.md":"Cp8KBLhp","tutorials_methods_cellarea.md":"Cr47Fy1Q"} diff --git a/previews/PR800/index.html b/previews/PR800/index.html index 45c9f2d7..5c16b795 100644 --- a/previews/PR800/index.html +++ b/previews/PR800/index.html @@ -8,9 +8,9 @@ - + - + @@ -19,7 +19,7 @@
Skip to content

Rasters.jl

Manipulating rasterized spatial data

Rasters

Data-source abstraction

Rasters provides a standardised interface that allows many source data types to be used with identical syntax.

  • Scripts and packages building on Rasters.jl can treat Raster, RasterStack, and RasterSeries as black boxes.

  • The data could hold GeoTiff or NetCDF files, Arrays in memory or CuArrays on the GPU - they will all behave in the same way.

  • RasterStack can be backed by a Netcdf or HDF5 file, or a NamedTuple of Raster holding .tif files, or all Raster in memory.

  • Users do not have to deal with the specifics of spatial file types.

  • Projected lookups with Cylindrical projections can by indexed using other Cylindrical projections by setting the mappedcrs keyword on construction. You don't need to know the underlying projection, the conversion is handled automatically. This means lat/lon EPSG(4326) can be used seamlessly if you need that.

Installation

julia
] add Rasters

Packages extensions

Packages extensions and Rasters 0.8 and onwards

On Julia 1.9 we can put additional packages in extensions, so the code only loads when you load a specific package. Rasters.jl was always intended to work like this, and its finally possible. This reduced package using time from many seconds to well under a second.

But, it means you have to manually load packages you need for each backend or additional functionality.

For example, to use the GDAL backend, and download files, you now need to do:

julia
using Rasters, ArchGDAL, RasterDataSources

where previously it was just using Rasters.

Sources and packages needed:

  • :gdal: using ArchGDAL

  • :netcdf: using NCDatasets

  • :grd: built-in.

  • :smap: using HDF5

  • :grib: not yet finished.

Other functionality in extensions:

  • Raster data downloads, like Worldclim{Climate}: using RasterDataSources

  • Makie plots: using Makie

  • Coordinate transformations for gdal rasters: using CoordinateTransformations

Bugs and errors

Bugs, errors and making issues for Rasters.jl

Raster data is complicated and there are many places for subtle or not-so-subtle bugs to creep in.

We need bug reports to reduce how often they occur over time. But also, we need issues that are easy to reproduce or it isn't practically possible to fix them.

Because there are so many raster file types and variations of them, most of the time we need the exact file that caused your problem to know how to fix it, and be sure that we have actually fixed it when we are done. So fixing a Rasters.jl bug nearly always involves downloading some file and running some code that breaks with it (if you can trigger the bug without a file, that's great! but its not always possible).

To make an issue we can fix quickly (or at all) there are three key steps:

  1. Include the file in an accessible place on web without authentication or any other work on our part, so we can just get it and find your bug. You can put it on a file hosting platform (e.g. google drive, drop box, whatever you use) and share the url.

  2. Add a minimum working example to the issue template that first downloads the file, then runs the function that triggers the bug.

  3. Paste the complete stack trace of the error it produces, right to the bottom, into the issue template. Then we can be sure we reproduced the same problem.

Good issues are really appreciated, but they do take just a little extra effort with Rasters.jl because of this need for files.

- + \ No newline at end of file diff --git a/previews/PR800/methods.html b/previews/PR800/methods.html index 9a00f694..b703818c 100644 --- a/previews/PR800/methods.html +++ b/previews/PR800/methods.html @@ -8,9 +8,9 @@ - + - + @@ -19,7 +19,7 @@
Skip to content

Methods that change the resolution or extent of an object

Click through to the function documentation for more in-depth descriptions and examples.

MethodsDescription
aggregateaggregate data by the same or different amounts for each axis.
disaggregatesimilarly disaggregate data.
mosaicjoin rasters covering different extents into a single array or file.
cropshrink objects to specific dimension sizes or the extent of another object.
extendextend objects to specific dimension sizes or the extent of another object.
trimtrims areas of missing values for arrays and across stack layers.
resampleresample data to a different size and projection, or snap to another object.
warpuse gdalwarp on any object, e.g. a multidimensional NetCDF stack.

Methods that change an objects values

Info

Note that most regular Julia methods, such as replace, work as for a standard Array. These additional methods are commonly required in GIS applications.

MethodsDescription
classifyclassify values into categories.
maskmask an object by a polygon or Raster along X/Y, or other dimensions.
replace_missingreplace all missing values in an object and update missingval.

Point, polygon and table operation

MethodsDescription
rasterizerasterize points and geometries.
extractextract values from points or geometries.
zonalcalculate zonal statistics for an object masked by geometries.

Methods to load, write and modify data sources

MethodsDescription
modifyreplace the data in objects. Useful to e.g. move objects to/from a GPU.
readread data to memory if it is on disk.
read!read data to predefined memory.
openopen the underlying data for manually reading or writing.
writewrite objects to file.
- + \ No newline at end of file diff --git a/previews/PR800/plot_makie.html b/previews/PR800/plot_makie.html index 0e58f343..423dcf33 100644 --- a/previews/PR800/plot_makie.html +++ b/previews/PR800/plot_makie.html @@ -8,11 +8,11 @@ - + - + - + @@ -44,9 +44,9 @@ ax = Axis(fig[2, 1]; aspect = DataAspect()) contourf!(ax, A) surface(fig[2, 2], A) # even a 3D plot work! -fig

3-D rasters in Makie

Warning

This interface is experimental, and unexported for that reason. It may break at any time!

Just as in Plots, 3D rasters are treated as a series of 2D rasters, which are tiled and plotted.

You can use Rasters.rplot to visualize 3D rasters or RasterStacks in this way. An example is below:

julia
stack = RasterStack(WorldClim{Climate}; month = 1)
-Rasters.rplot(stack; Axis = (aspect = DataAspect(),),)

You can pass any theming keywords in, which are interpreted by Makie appropriately.

The plots seem a little squished here. We provide a Makie theme which makes text a little smaller and has some other space-efficient attributes:

julia
Makie.set_theme!(Rasters.theme_rasters())
-Rasters.rplot(stack)

reset theme

julia
Makie.set_theme!()

Plotting with Observables, animations

Rasters.rplot should support Observable input out of the box, but the dimensions of that input must remain the same - i.e., the element names of a RasterStack must remain the same.

julia
Makie.set_theme!(Rasters.theme_rasters())
+fig

3-D rasters in Makie

Warning

This interface is experimental, and unexported for that reason. It may break at any time!

Just as in Plots, 3D rasters are treated as a series of 2D rasters, which are tiled and plotted.

You can use Rasters.rplot to visualize 3D rasters or RasterStacks in this way. An example is below:

julia
stack = RasterStack(WorldClim{Climate}; month = 1)
+Rasters.rplot(stack; Axis = (aspect = DataAspect(),),)

You can pass any theming keywords in, which are interpreted by Makie appropriately.

The plots seem a little squished here. We provide a Makie theme which makes text a little smaller and has some other space-efficient attributes:

julia
Makie.set_theme!(Rasters.theme_rasters())
+Rasters.rplot(stack)

reset theme

julia
Makie.set_theme!()

Plotting with Observables, animations

Rasters.rplot should support Observable input out of the box, but the dimensions of that input must remain the same - i.e., the element names of a RasterStack must remain the same.

julia
Makie.set_theme!(Rasters.theme_rasters())
 # `stack` is the WorldClim climate data for January
 stack_obs = Observable(stack)
 fig = Rasters.rplot(stack_obs;
@@ -54,7 +54,7 @@
 )
 record(fig, "rplot.mp4", 1:12; framerate = 3) do i
     stack_obs[] = RasterStack(WorldClim{Climate}; month = i)
-end
"rplot.mp4"

julia
Makie.set_theme!() # reset theme
Rasters.rplot Function
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

Using vanilla Makie

julia
using Rasters, RasterDataSources

The data

julia
layers = (:evenness, :range, :contrast, :correlation)
+end
"rplot.mp4"

julia
Makie.set_theme!() # reset theme
Rasters.rplot Function
julia
Rasters.rplot([position::GridPosition], raster; kw...)

raster may be a Raster (of 2 or 3 dimensions) or a RasterStack whose underlying rasters are 2 dimensional, or 3-dimensional with a singleton (length-1) third dimension.

Keywords

  • plottype = Makie.Heatmap: The type of plot. Can be any Makie plot type which accepts a Raster; in practice, Heatmap, Contour, Contourf and Surface are the best bets.

  • axistype = Makie.Axis: The type of axis. This can be an Axis, Axis3, LScene, or even a GeoAxis from GeoMakie.jl.

  • X = XDim: The X dimension of the raster.

  • Y = YDim: The Y dimension of the raster.

  • Z = YDim: The Y dimension of the raster.

  • draw_colorbar = true: Whether to draw a colorbar for the axis or not.

  • colorbar_position = Makie.Right(): Indicates which side of the axis the colorbar should be placed on. Can be Makie.Top(), Makie.Bottom(), Makie.Left(), or Makie.Right().

  • colorbar_padding = Makie.automatic: The amount of padding between the colorbar and its axis. If automatic, then this is set to the width of the colorbar.

  • title = Makie.automatic: The titles of each plot. If automatic, these are set to the name of the band.

  • xlabel = Makie.automatic: The x-label for the axis. If automatic, set to the dimension name of the X-dimension of the raster.

  • ylabel = Makie.automatic: The y-label for the axis. If automatic, set to the dimension name of the Y-dimension of the raster.

  • colorbarlabel = "": Usually nothing, but here if you need it. Sets the label on the colorbar.

  • colormap = nothing: The colormap for the heatmap. This can be set to a vector of colormaps (symbols, strings, cgrads) if plotting a 3D raster or RasterStack.

  • colorrange = Makie.automatic: The colormap for the heatmap. This can be set to a vector of (low, high) if plotting a 3D raster or RasterStack.

  • nan_color = :transparent: The color which NaN values should take. Default to transparent.

source

Using vanilla Makie

julia
using Rasters, RasterDataSources

The data

julia
layers = (:evenness, :range, :contrast, :correlation)
 st = RasterStack(EarthEnv{HabitatHeterogeneity}, layers)
 ausbounds = X(100 .. 160), Y(-50 .. -10) # Roughly cut out australia
 aus = st[ausbounds...] |> Rasters.trim
╭─────────────────────╮
@@ -96,7 +96,7 @@
     fig
 end
 save("aus_trim.png", current_figure());
CairoMakie.Screen{IMAGE}

- + \ No newline at end of file diff --git a/previews/PR800/plotting.html b/previews/PR800/plotting.html index 527d349a..f2564fd4 100644 --- a/previews/PR800/plotting.html +++ b/previews/PR800/plotting.html @@ -8,11 +8,11 @@ - + - + - + @@ -20,11 +20,11 @@
Skip to content

Plots, simple

Plots.jl and Makie.jl are fully supported by Rasters.jl, with recipes for plotting Raster and RasterStack provided. plot will plot a heatmap with axes matching dimension values. If mappedcrs is used, converted values will be shown on axes instead of the underlying crs values. contourf will similarly plot a filled contour plot.

Pixel resolution is limited to allow loading very large files quickly. max_res specifies the maximum pixel resolution to show on the longest axis of the array. It can be set manually to change the resolution (e.g. for large or high-quality plots):

julia
using Rasters, RasterDataSources, ArchGDAL, Plots
 A = Raster(WorldClim{BioClim}, 5)
-plot(A; max_res=3000)

For Makie, plot functions in a similar way. plot will only accept two-dimensional rasters. You can invoke contour, contourf, heatmap, surface or any Makie plotting function which supports surface-like data on a 2D raster.

To obtain tiled plots for 3D rasters and RasterStacks, use the function Rasters.rplot([gridposition], raster; kw_args...). This is an unexported function, since we're not sure how the API will change going forward.

Makie, simple

julia
using CairoMakie
+plot(A; max_res=3000)

For Makie, plot functions in a similar way. plot will only accept two-dimensional rasters. You can invoke contour, contourf, heatmap, surface or any Makie plotting function which supports surface-like data on a 2D raster.

To obtain tiled plots for 3D rasters and RasterStacks, use the function Rasters.rplot([gridposition], raster; kw_args...). This is an unexported function, since we're not sure how the API will change going forward.

Makie, simple

julia
using CairoMakie
 CairoMakie.activate!(px_per_unit = 2)
 using Rasters, CairoMakie, RasterDataSources, ArchGDAL
 A = Raster(WorldClim{BioClim}, 5)
-Makie.plot(A)

Loading data

Our first example simply loads a file from disk and plots it.

This netcdf file only has one layer, if it has more we could use RasterStack instead.

julia
using Rasters, NCDatasets, Plots
+Makie.plot(A)

Loading data

Our first example simply loads a file from disk and plots it.

This netcdf file only has one layer, if it has more we could use RasterStack instead.

julia
using Rasters, NCDatasets, Plots
 using Downloads: download
 
 url = "https://www.unidata.ucar.edu/software/netcdf/examples/tos_O1_2001-2002.nc";
@@ -53,8 +53,8 @@
   mappedcrs: EPSG:4326
 └──────────────────────────────────────────────────────────────────────────────┘
 [:, :, 1]
- ⋮      ⋱

Objects with Dimensions other than X and Y will produce multi-pane plots. Here we plot every third month in the first year in one plot:

julia
A[Ti=1:3:12] |> plot

Now plot the ocean temperatures around the Americas in the first month of 2001. Notice we are using lat/lon coordinates and date/time instead of regular indices. The time dimension uses DateTime360Day, so we need to load CFTime.jl to index it with Near.

julia
using CFTime
-A[Ti(Near(DateTime360Day(2001, 01, 17))), Y(-60.0 .. 90.0), X(45.0 .. 190.0)] |> plot

Now get the mean over the timespan, then save it to disk, and plot it as a filled contour.

Other plot functions and sliced objects that have only one X/Y/Z dimension fall back to generic DimensionalData.jl plotting, which will still correctly label plot axes.

julia
using Statistics
+ ⋮      ⋱

Objects with Dimensions other than X and Y will produce multi-pane plots. Here we plot every third month in the first year in one plot:

julia
A[Ti=1:3:12] |> plot

Now plot the ocean temperatures around the Americas in the first month of 2001. Notice we are using lat/lon coordinates and date/time instead of regular indices. The time dimension uses DateTime360Day, so we need to load CFTime.jl to index it with Near.

julia
using CFTime
+A[Ti(Near(DateTime360Day(2001, 01, 17))), Y(-60.0 .. 90.0), X(45.0 .. 190.0)] |> plot

Now get the mean over the timespan, then save it to disk, and plot it as a filled contour.

Other plot functions and sliced objects that have only one X/Y/Z dimension fall back to generic DimensionalData.jl plotting, which will still correctly label plot axes.

julia
using Statistics
 # Take the mean
 mean_tos = mean(A; dims=Ti)
╭─────────────────────────────────────────────────╮
 │ 180×170×1 Raster{Union{Missing, Float32},3} tos │
@@ -81,7 +81,7 @@
 └──────────────────────────────────────────────────────────────────────────────┘
 [:, :, 1]
  ⋮      ⋱

Plot a contour plot

julia
using Plots
-Plots.contourf(mean_tos; dpi=300, size=(800, 400))

write to disk

Write the mean values to disk

julia
write("mean_tos.nc", mean_tos)
"mean_tos.nc"

Plotting recipes in DimensionalData.jl are the fallback for Rasters.jl when the object doesn't have 2 X/Y/Z dimensions, or a non-spatial plot command is used. So (as a random example) we could plot a transect of ocean surface temperature at 20 degree latitude :

julia
A[Y(Near(20.0)), Ti(1)] |> plot

Polygon masking, mosaic and plot

In this example we will mask the Scandinavian countries with border polygons, then mosaic together to make a single plot.

First, get the country boundary shape files using GADM.jl.

using Rasters, RasterDataSources, ArchGDAL, Shapefile, Plots, Dates, Downloads, NCDatasets

Download the shapefile

julia
using Downloads
+Plots.contourf(mean_tos; dpi=300, size=(800, 400))

write to disk

Write the mean values to disk

julia
write("mean_tos.nc", mean_tos)
"mean_tos.nc"

Plotting recipes in DimensionalData.jl are the fallback for Rasters.jl when the object doesn't have 2 X/Y/Z dimensions, or a non-spatial plot command is used. So (as a random example) we could plot a transect of ocean surface temperature at 20 degree latitude :

julia
A[Y(Near(20.0)), Ti(1)] |> plot

Polygon masking, mosaic and plot

In this example we will mask the Scandinavian countries with border polygons, then mosaic together to make a single plot.

First, get the country boundary shape files using GADM.jl.

using Rasters, RasterDataSources, ArchGDAL, Shapefile, Plots, Dates, Downloads, NCDatasets

Download the shapefile

julia
using Downloads
 using Shapefile
 shapefile_url = "https://github.com/nvkelso/natural-earth-vector/raw/master/10m_cultural/ne_10m_admin_0_countries.shp"
 shapefile_name = "boundary_lines.shp"
@@ -128,12 +128,12 @@
     end
     return p
 end
borders! (generic function with 1 method)

Now we can plot the individual countries.

julia
dp = plot(denmark)
-borders!(dp, denmark_border)

and sweden

julia
sp = plot(sweden)
-borders!(sp, sweden_border)

and norway

julia
np = plot(norway)
-borders!(np, norway_border)

The Norway shape includes a lot of islands. Lets crop them out using .. intervals:

julia
norway_region = climate[X(0..40), Y(55..73)]
-plot(norway_region)

And mask it with the border again:

julia
norway = mask_trim(norway_region, norway_border)
+borders!(dp, denmark_border)

and sweden

julia
sp = plot(sweden)
+borders!(sp, sweden_border)

and norway

julia
np = plot(norway)
+borders!(np, norway_border)

The Norway shape includes a lot of islands. Lets crop them out using .. intervals:

julia
norway_region = climate[X(0..40), Y(55..73)]
+plot(norway_region)

And mask it with the border again:

julia
norway = mask_trim(norway_region, norway_border)
 np = plot(norway)
-borders!(np, norway_border)

Now we can combine the countries into a single raster using mosaic. first will take the first value if/when there is an overlap.

julia
scandinavia = mosaic(first, denmark, norway, sweden)
╭─────────────────────╮
+borders!(np, norway_border)

Now we can combine the countries into a single raster using mosaic. first will take the first value if/when there is an overlap.

julia
scandinavia = mosaic(first, denmark, norway, sweden)
╭─────────────────────╮
 │ 177×119 RasterStack │
 ├─────────────────────┴────────────────────────────────────────────────── dims ┐
   ↓ X Projected{Float64} 3.1666666666666443:0.16666666666666666:32.49999999999998 ForwardOrdered Regular Intervals{Start},
@@ -151,9 +151,9 @@
 borders!(p, denmark_border)
 borders!(p, norway_border)
 borders!(p, sweden_border)
-p

And save to netcdf - a single multi-layered file, and tif, which will write a file for each stack layer.

julia
write("scandinavia.nc", scandinavia)
+p

And save to netcdf - a single multi-layered file, and tif, which will write a file for each stack layer.

julia
write("scandinavia.nc", scandinavia)
 write("scandinavia.tif", scandinavia)
(tmin = "scandinavia_tmin.tif", tmax = "scandinavia_tmax.tif", prec = "scandinavia_prec.tif", wind = "scandinavia_wind.tif")

Rasters.jl provides a range of other methods that are being added to over time. Where applicable these methods read and write lazily to and from disk-based arrays of common raster file types. These methods also work for entire RasterStacks and RasterSeries using the same syntax.

- + \ No newline at end of file diff --git a/previews/PR800/tutorials/methods/cellarea.html b/previews/PR800/tutorials/methods/cellarea.html index f38c1652..e9ef16fb 100644 --- a/previews/PR800/tutorials/methods/cellarea.html +++ b/previews/PR800/tutorials/methods/cellarea.html @@ -8,11 +8,11 @@ - + - + - + @@ -39,7 +39,9 @@ 90.0 1.23017e6 1.19279e6 1.11917e6 1.01154e6 873182.0 708290.0 100.0 1.23017e6 1.19279e6 1.11917e6 1.01154e6 873182.0 708290.0 110.0 1.23017e6 1.19279e6 1.11917e6 1.01154e6 873182.0 708290.0 - 120.0 1.23017e6 1.19279e6 1.11917e6 1.01154e6 873182.0 708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

cellarea computes the area of each cell in a raster. This is useful for a number of reasons - if you have a variable like population per cell, or elevation (spatially extensive variables), you'll want to account for the fact that different cells have different areas.

cellarea returns a Raster with the same x and y dimensions as the input, where each value in the raster encodes the area of the cell (in meters by default).

You can specify whether you want to compute the area in the plane of your projection (Planar()), on a sphere of some radius (Spherical(; radius=...)). <!– or on an ellipsoid (Geodetic()), using the first argument.–>

Let's construct a raster and see what this looks like! We'll keep it in memory.

The spherical <!– and geodetic –> method relies on the Proj.jl package to perform coordinate transformation, so that has to be loaded explicitly.

julia
using Rasters, Proj

To construct a raster, we'll need to specify the x and y dimensions. These are called "lookups" in Rasters.jl.

julia
using Rasters.Lookups

We can now construct the x and y lookups. Here we'll use a start-at-one, step-by-five grid. Note that we're specifying that the "sampling", i.e., what the coordinates actually mean, is Intervals(Start()), meaning that the coordinates are the starting point of each interval.

This is in contrast to Points() sampling, where each index in the raster represents the value at a sampling point; here, each index represents a grid cell, which is defined by the coordinate being at the start.

julia
x = X(1:5:30; sampling = Intervals(Start()), crs = EPSG(4326))
+ 120.0  1.23017e6   1.19279e6   1.11917e6   1.01154e6  873182.0  708290.0

WARNING: This feature is experimental. It may change in future versions, and may not be 100% reliable in all cases. Please file github issues if problems occur.

source

cellarea computes the area of each cell in a raster. This is useful for a number of reasons - if you have a variable like population per cell, or elevation (spatially extensive variables), you'll want to account for the fact that different cells have different areas.

cellarea returns a Raster with the same x and y dimensions as the input, where each value in the raster encodes the area of the cell (in meters by default).

You can specify whether you want to compute the area in the plane of your projection (Planar()), on a sphere of some radius (Spherical(; radius=...)). <!– or on an ellipsoid (Geodetic()), using the first argument.–>

Let's construct a raster and see what this looks like! We'll keep it in memory.

The spherical <!– and geodetic –> method relies on the Proj.jl package to perform coordinate transformation, so that has to be loaded explicitly.

julia
using Rasters
+import Proj # to activate the spherical `cellarea` method
+import ArchGDAL # purely for data loading

To construct a raster, we'll need to specify the x and y dimensions. These are called "lookups" in Rasters.jl.

julia
using Rasters.Lookups

We can now construct the x and y lookups. Here we'll use a start-at-one, step-by-five grid. Note that we're specifying that the "sampling", i.e., what the coordinates actually mean, is Intervals(Start()), meaning that the coordinates are the starting point of each interval.

This is in contrast to Points() sampling, where each index in the raster represents the value at a sampling point; here, each index represents a grid cell, which is defined by the coordinate being at the start.

julia
x = X(1:5:30; sampling = Intervals(Start()), crs = EPSG(4326))
 y = Y(50:5:80; sampling = Intervals(Start()), crs = EPSG(4326))
Y

I have chosen the y-range here specifically so we can show the difference between spherical and planar cellarea.

julia
ras = Raster(ones(x, y); crs = EPSG(4326))
╭───────────────────────╮
 │ 6×7 Raster{Float64,2} │
 ├───────────────────────┴──────────────────────────────────────── dims ┐
@@ -72,18 +74,34 @@
  11     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10
  16     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10
  21     1.88114e11   1.66031e11   1.42685e11  …   6.68821e10   4.0334e10
- 26     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10

and if we plot it, you can see the difference in cell area as we go from the equator to the poles:

julia
using Makie, CairoMakie# , GeoMakie
-heatmap(ras; axis = (; aspect = DataAspect()))

We can also try this using the planar method, which simply computes the area of the rectangle using area = x_side_length * y_side_length:

@example
cellarea(ras, Planar())

Note that this is of course wildly inaccurate for a geographic dataset - but if you're working in a projected coordinate system, like polar stereographic or Mercator, this can be very useful (and a lot faster)!

Usage example

Let's get the rainfall over Chile, and compute the average rainfall per meter squared across the country for the month of June.

We'll get the precipitation data across the globe from WorldClim, via RasterDataSources.jl, and use the month keyword argument to get the June data.

Then, we can get the geometry of Chile from NaturalEarth.jl, and use Rasters.mask to get the data just for Chile.

@example
using RasterDataSources, NaturalEarth
+ 26     1.88114e11   1.66031e11   1.42685e11      6.68821e10   4.0334e10

and if we plot it, you can see the difference in cell area as we go from the equator to the poles:

julia
using Makie, CairoMakie
+heatmap(cellarea(ras); axis = (; aspect = DataAspect()))

We can also try this using the planar method, which simply computes the area of the rectangle using area = x_side_length * y_side_length:

julia
cellarea(Planar(), ras)
╭─────────────────────╮
+│ 6×7 Raster{Int64,2} │
+├─────────────────────┴────────────────────────────────────────── dims ┐
+  ↓ X Projected{Int64} 1:5:26 ForwardOrdered Regular Intervals{Start},
+  → Y Projected{Int64} 50:5:80 ForwardOrdered Regular Intervals{Start}
+├────────────────────────────────────────────────────────────── raster ┤
+  extent: Extent(X = (1, 31), Y = (50, 85))
+
+  crs: EPSG:4326
+└──────────────────────────────────────────────────────────────────────┘
+  ↓ →  50  55  60  65  70  75  80
+  1    25  25  25  25  25  25  25
+  6    25  25  25  25  25  25  25
+ 11    25  25  25  25  25  25  25
+ 16    25  25  25  25  25  25  25
+ 21    25  25  25  25  25  25  25
+ 26    25  25  25  25  25  25  25

Note that this is of course wildly inaccurate for a geographic dataset - but if you're working in a projected coordinate system, like polar stereographic or Mercator, this can be very useful (and a lot faster)!

Usage example

Let's get the rainfall over Chile, and compute the average rainfall per meter squared across the country for the month of June.

We'll get the precipitation data across the globe from WorldClim, via RasterDataSources.jl, and use the month keyword argument to get the June data.

Then, we can get the geometry of Chile from NaturalEarth.jl, and use Rasters.mask to get the data just for Chile.

@example
using RasterDataSources, NaturalEarth
 
 precip = Raster(WorldClim{Climate}, :prec; month = 6)
@example
all_countries = naturalearth("admin_0_countries", 10)
 chile = all_countries.geometry[findfirst(==("Chile"), all_countries.NAME)]

Let's plot the precipitation on the world map, and highlight Chile:

@example
f, a, p = heatmap(precip; colorrange = Makie.zscale(replace_missing(precip, NaN)), axis = (; aspect = DataAspect()))
-p2 = poly!(a, chile; color = (:red, 0.5))
+p2 = poly!(a, chile; color = (:red, 0.3), strokecolor = :red, strokewidth = 0.5)
 f

You can see Chile highlighted in red, in the bottom left quadrant.

First, let's make sure that we only have the data that we care about, and crop and mask the raster so it only has values in Chile. We can crop by the geometry, which really just generates a view into the raster that is bounded by the geometry's bounding box.

@example
cropped_precip = crop(precip; to = chile)

Now, we mask the data such that any data outside the geometry is set to missing.

@example
masked_precip = mask(cropped_precip; with = chile)
 heatmap(masked_precip)

This is a lot of missing data, but that's mainly because the Chile geometry we have encompasses the Easter Islands as well, in the middle of the Pacific.

Now, let's compute the average precipitation per square meter across Chile. First, we need to get the area of each cell in square meters. We'll use the spherical method, since we're working with a geographic coordinate system. This is the default.

@example
areas = cellarea(masked_precip)
 masked_areas = mask(areas; with = chile)
-heatmap(masked_areas; axis = (; title = "Cell area in square meters"))

Now we can compute the average precipitation per square meter. First, we compute total precipitation per grid cell:

@example
precip_per_area = masked_precip .* masked_areas

We can sum this to get the total precipitation per square meter across Chile:

@example
total_precip = sum(skipmissing(precip_per_area))

We can also sum the areas to get the total area of Chile (in this raster, at least).

@example
total_area = sum(skipmissing(masked_areas))

And we can convert that to an average by dividing by the total area:

@example
avg_precip = total_precip / total_area

So on average, Chile gets about 100mm of rain per square meter in June. Let's see what happens if we don't account for cell areas:

@example
bad_total_precip = sum(skipmissing(masked_precip))
+heatmap(masked_areas; axis = (; title = "Cell area in square meters"))

Now we can compute the average precipitation per square meter. First, we compute total precipitation per grid cell:

@example
precip_per_area = masked_precip .* masked_areas

We can sum this to get the total precipitation per square meter across Chile:

@example
total_precip = sum(skipmissing(precip_per_area))

We can also sum the areas to get the total area of Chile (in this raster, at least).

@example
total_area = sum(skipmissing(masked_areas))

And we can convert that to an average by dividing by the total area:

@example
avg_precip = total_precip / total_area

According to the internet, Chile gets about 100mm of rain per square meter in June, so our statistic seems pretty close.

Let's see what happens if we don't account for cell areas:

@example
bad_total_precip = sum(skipmissing(masked_precip))
 bad_avg_precip = bad_total_precip / length(collect(skipmissing(masked_precip)))

This is misestimated! This is why it's important to account for cell areas when computing averages.

Note

If you made it this far, congratulations!

It's interesting to note that we've replicated the workflow of zonal here. zonal is a more general function that can be used to compute any function over geometries, and it has multithreading built in.

But fundamentally, this is all that zonal is doing under the hood - masking and cropping the raster to the geometry, and then computing the statistic.


This page was generated using Literate.jl.

- + \ No newline at end of file