This repository has been archived by the owner on Jan 10, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 2
/
index.Rmd
74 lines (51 loc) · 3.32 KB
/
index.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
---
output: github_document
editor_options:
chunk_output_type: console
---
```{r setup, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE, warning = FALSE, message = FALSE,
comment = "#>",
fig.path = "man/figures/",
out.width = "90%", fig.align = 'center'
)
```
[![Coverage status](https://codecov.io/gh/obrl-soil/slga/branch/master/graph/badge.svg)](https://codecov.io/github/obrl-soil/slga?branch=master)
[![CRAN](https://www.r-pkg.org/badges/version/slga)](https://cran.r-project.org/package=slga)
[![Downloads](https://cranlogs.r-pkg.org/badges/grand-total/slga)](https://www.r-pkg.org/pkg/slga)
[![cover_image](man/figures/slga_img.png)](https://obrl-soil.github.io/slga)
# slga
`slga` offers the ability to download geographic subsets of raster data from the [Soil and Landscape Grid of Australia](https://www.clw.csiro.au/aclep/soilandlandscapegrid/index.html). The Grid was generated in 2014 from a compilation of Australian soil and landscape data and contains a set of modelled soil attributes that meet the globalsoilmap.net specification.
Also available for download are a set of terrain and climate covariates considered useful in soils modelling. These are primarily derived from [GeoScience Australia's](https://www.ga.gov.au) [SRTM DEM products](https://www.ga.gov.au/scientific-topics/national-location-information/digital-elevation-data).
All products are returned in GDA94 long/lat (EPSG:4283) and have a cell resolution of 3" (roughly 90m).
## Installation
Install from CRAN with
```{r 'installation', eval = FALSE}
install.packages('slga')
```
Install from github with
```{r 'installation_dev', eval = FALSE}
devtools::install_github("obrl-soil/slga")
```
## How it works
`slga` uses the WCS endpoints provided by the SLGA to access data. The package endeavours to return requested products as simple subsets of the parent dataset, with no hidden server-side resampling.
## Example
```{r pkgs}
library(raster)
library(slga)
library(ggplot2)
```
```{r demo, eval = FALSE}
# get surface clay content for King Island
aoi <- c(152.95, -27.55, 153.07, -27.45)
bne_surface_clay <- get_slga_data(product = 'NAT', attribute = 'CLY',
component = 'all', depth = 1,
aoi = aoi, write_out = FALSE)
```
[![clay-plot-bne cen](man/figures/README-dplot-1.png)](https://obrl-soil.github.io/slga)
See the package vignette for further detail.
### Warning!
While it is possible to download data for large extents using this package, please be aware that the data volume can get large, and it will not be very quick or efficient. If you want to obtain SLGA data for a significant proportion of Australia, you may prefer to access the full datasets via the [CSIRO Data Access Portal](https://data.csiro.au/dap). Note that 1" (30m) versions of the slga terrain attributes are also available on that portal.
### Asking for help
If you get stuck using this package or the data it provides, please post a question on [Stack Overflow](https://stackoverflow.com/) (for internet connectivity problems) or the [GIS StackExchange](https://gis.stackexchange.com/) (for raster/geospatial issues). This means that others can benefit from the discussion, and more people are available to help you. You're welcome to ping me in a comment on those websites or on twitter (@obrl_soil) to get my attention.