Skip to content

Commit

Permalink
updates to README
Browse files Browse the repository at this point in the history
  • Loading branch information
jhollist committed Sep 11, 2023
1 parent ff209af commit 4f23750
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 17 deletions.
15 changes: 6 additions & 9 deletions README.Rmd
Expand Up @@ -9,6 +9,11 @@ status](https://github.com/jhollist/elevatr/workflows/R-CMD-check/badge.svg)](ht
coverage](https://codecov.io/gh/jhollist/elevatr/branch/main/graph/badge.svg)](https://app.codecov.io/gh/jhollist/elevatr?branch=main)
[![DOI](https://zenodo.org/badge/65325400.svg)](https://zenodo.org/badge/latestdoi/65325400)

# Key information about version 0.99.0 and upcoming versions of `elevatr`

Several major changes have been made to `elevatr` in response to the retirement of legacy spatial packages (see
<https://r-spatial.org/r/2023/05/15/evolution4.html> for details). Version 0.99.0 has switched to using `sf` and `terra` for all data handling; however, in this version a `raster RasterLayer` is still returned from `get_elev_raster()`. Additional changes are planned for version 1+, most notably the return for `get_elev_raster()` will be a `terra SpatRaster`. Please plan accordingly for your analyses and/or packages account for this change.

# elevatr
An R package for accessing elevation data from various sources

Expand All @@ -21,13 +26,7 @@ Currently this package includes just two primary functions to access elevation w

## Installation

```{r echo = FALSE}
options(repos = "https://cran.rstudio.com")
x <- data.frame(available.packages())
version <- x[x$Package == "elevatr", "Version"]
```

Version `r version` of this package is currently available from CRAN and may be installed by:
Version 0.99.0 of this package is currently available from CRAN and may be installed by:

```{r eval=F}
install.packages("elevatr")
Expand All @@ -40,8 +39,6 @@ library(devtools)
install_github("jhollist/elevatr")
```

NOTE: As of `r lubridate::today()`, the development version on GitHub, `r packageVersion("elevatr")`, is the latest version and supports `sf` and `terra`.

## Contributions and Use Cases

As `elevatr` is getting more widely used, there have been some great contributions, use cases, and additional packages that have come from the user community. If you have one you'd like to share, let me know and I will gladly add it. Here are some of the ones that I have seen. Thank you all!
Expand Down
21 changes: 13 additions & 8 deletions README.md
Expand Up @@ -8,6 +8,18 @@ downloads](https://cranlogs.r-pkg.org/badges/elevatr)](https://www.r-pkg.org/pkg
coverage](https://codecov.io/gh/jhollist/elevatr/branch/main/graph/badge.svg)](https://app.codecov.io/gh/jhollist/elevatr?branch=main)
[![DOI](https://zenodo.org/badge/65325400.svg)](https://zenodo.org/badge/latestdoi/65325400)

# Key information about version 0.99.0 and upcoming versions of `elevatr`

Several major changes have been made to `elevatr` in response to the
retirement of legacy spatial packages (see
<https://r-spatial.org/r/2023/05/15/evolution4.html> for details).
Version 0.99.0 has switched to using `sf` and `terra` for all data
handling; however, in this version a `raster RasterLayer` is still
returned from `get_elev_raster()`. Additional changes are planned for
version 1+, most notably the return for `get_elev_raster()` will be a
`terra SpatRaster`. Please plan accordingly for your analyses and/or
packages account for this change.

# elevatr

An R package for accessing elevation data from various sources
Expand Down Expand Up @@ -42,27 +54,20 @@ elevation web services:

## Installation

Version 0.4.5 of this package is currently available from CRAN and may
Version 0.99.0 of this package is currently available from CRAN and may
be installed by:

``` r
install.packages("elevatr")
```

NOTE: As of 2023-06-16, the CRAN version is the older version that does
not support `terra`.

The development version (this repo) may installed with `devtools`:

``` r
library(devtools)
install_github("jhollist/elevatr")
```

NOTE: As of 2023-06-16, the development version on GitHub, 1.0.0.9999,
is the latest version and supports `sf` and `terra`. Support for `sp`
and `raster` has been deprecated.

## Contributions and Use Cases

As `elevatr` is getting more widely used, there have been some great
Expand Down

0 comments on commit 4f23750

Please sign in to comment.