# RasterDataSources.jl

[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://ecojulia.github.io/RasterDataSources.jl/stable)
[![](https://img.shields.io/badge/docs-dev-blue.svg)](https://ecojulia.github.io/RasterDataSources.jl/dev)
[![CI](https://github.com/EcoJulia/RasterDataSources.jl/actions/workflows/CI.yml/badge.svg)](https://github.com/EcoJulia/RasterDataSources.jl/actions/workflows/CI.yml)
[![codecov.io](http://codecov.io/github/ecojulia/RasterDataSources.jl/coverage.svg?branch=master)](http://codecov.io/github/ecojulia/RasterDataSources.jl?branch=master)

RasterDataSources downloads raster data for local use or for integration into other spatial data packages, like
[Rasters.jl](https://github.com/rafaqz/Rasters.jl). The collection is largely focussed on datasets relevant
to ecology, but will have a lot of crossover with other sciences.

Currently sources include:

| Source       | URL                                      | Status                                   |
| ------------ | ---------------------------------------- | ---------------------------------------- |
| CHELSA       | https://chelsa-climate.org               | BioClim, BioClimPlus, and Climate        |
| WorldClim    | https://www.worldclim.org                | Climate, Weather, BioClim, and Elevation |
| EarthEnv     | http://www.earthenv.org                  | LandCover and HabitatHeterogeneity       |
| AWAP         | http://www.bom.gov.au/jsp/awap/index.jsp | Complete                                 |
| ALWB         | http://www.bom.gov.au/water/landscape/   | Complete                                 |
| ERA5         | https://registry.opendata.aws/nsf-ncar-era5/ | Complete                             |
| SRTM         | https://www2.jpl.nasa.gov/srtm/          | Complete                                 |
| CopernicusDEM | https://registry.opendata.aws/copernicus-dem/ | GLO-30 (30m) and GLO-90 (90m)       |
| MODIS        | https://modis.ornl.gov                   | Complete (beta)                          |
| TerraClimate | https://www.climatologylab.org/terraclimate.html | Historical, Plus2C, Plus4C       |
| NCEP         | https://psl.noaa.gov/data/gridded/data.ncep.reanalysis.html | Complete              |
| SLGA         | https://esoil.io/TERNLandscapes/Public/Pages/SLGA/index.html | Soil attributes and CoarseFragments |
| GADS         | https://zenodo.org/records/19246341      | Spectral aerosol optical depths          |
| CRUCL2       | https://zenodo.org/records/20754689      | Monthly mean climate 1961–1990           |
| CPCSoil      | https://psl.noaa.gov/data/gridded/data.cpcsoil.html | LTM climatology and historical monthly means |
| SILO         | https://www.longpaddock.qld.gov.au/silo/about/overview/ | Complete                          |
| BARRA        | https://opus.nci.org.au/pages/viewpage.action?pageId=264241166 | Near-surface variables (BARRA-R2, BARRA-C2) |

Please open an issue if you need more datasets added, or (even better) open a pull request 
following the form of the other datasets where possible.

## Retrieving data

Usage is generally via the `getraster` method - which will download the
raster data source if it isn't available locally, or simply return the path/s
of the raster file/s:

```julia
julia> using RasterDataSources

julia> getraster(WorldClim{Climate}, :wind; month=1:12)
12-element Array{String,1}:
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_01.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_02.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_03.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_04.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_05.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_06.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_07.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_08.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_09.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_10.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_11.tif"
 "/home/user/Data/WorldClim/Climate/wind/wc2.1_10m_wind_12.tif"
```

## Installation and setup

Install as usual with:

```julia
] add RasterDataSources
```

To download data you will need to specify a folder to put it in. You can do this
by assigning the environment variable `RASTERDATASOURCES_PATH`:

```julia
ENV["RASTERDATASOURCES_PATH"] = "/home/user/Data/"
```

This can be put in your `startup.jl` file or the system environment.


RasterDataSources was based on code from the `SimpleSDMDataSoures.jl` package by Timothée Poisot.