Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elipousson/feltr
A R package to read Felt maps to simple feature data 🗺️
https://github.com/elipousson/feltr
felt r-package rspatial rstats
Last synced: about 1 month ago
JSON representation
A R package to read Felt maps to simple feature data 🗺️
- Host: GitHub
- URL: https://github.com/elipousson/feltr
- Owner: elipousson
- License: other
- Created: 2023-04-24T14:19:01.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-03T16:52:10.000Z (3 months ago)
- Last Synced: 2024-12-03T17:48:56.652Z (3 months ago)
- Topics: felt, r-package, rspatial, rstats
- Language: R
- Homepage: https://elipousson.github.io/feltr/
- Size: 1.65 MB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# feltr 
[](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[](https://opensource.org/licenses/MIT)
[](https://app.codecov.io/gh/elipousson/feltr?branch=main)
The goal of feltr is to read maps from Felt as simple feature or `SpatRaster` objects.
:::{.callout-note collapse=false appearance='default' icon=true}
## Package does not support the Felt API v2
This package does not support the Felt API and, as of December 2024, I have no specific timeline for when the package will be updated to restore functionality. Please use [the feltr package](https://christophertkenny.com/feltr/index.html) (identical name but a different developer) for API access or follow [this GitHub issue for updates](https://github.com/elipousson/feltr/issues/2).
:::
## Installation
You can install the development version of feltr like so:
``` r
pak::pkg_install("elipousson/feltr")
```
## Example
```{r example}
library(feltr)
```
You can use `read_felt_map()` to create an sf object with features from a map URL.
```{r read, eval=FALSE}
url <- "https://felt.com/map/Site-Plan-Example-PGTipS2mT8CYBIVlyAm9BkD"
site_plan <- read_felt_map(url)
plot(site_plan)
```
`get_felt_map()` returns a list with basic information about a map (set `read = TRUE` to read map elements and layers at the same time):
```{r, eval=FALSE}
get_felt_map(url)
```
You can also use `read_felt_raster()` (a wrapper for `rasterpic::rasterpic_img()`) to create a `SpatRaster` object from a "Image" type feature in Felt.
```{r, eval=FALSE}
image_map <- read_felt_raster(
"https://felt.com/map/feltr-sample-map-read-felt-raster-oiinodTbT79BEueYdGp1aND",
"https://tile.loc.gov/image-services/iiif/service:gmd:gmd370:g3700:g3700:ct003955/full/pct:12.5/0/default.jpg"
)
image_map
```
For more information on the Felt Public API check out the guide to [Getting Started with the Felt API](https://developers.felt.com/rest-api/getting-started) or the [Felt API reference](https://developers.felt.com/rest-api/api-reference).
Note, in July 2024, Felt [announced the pricing for subscription plans](https://felt.com/blog/introducing-pricing) that are expected to limit API access to paid accounts starting in January 2024. Educators can also apply for free accounts to retain API access after January 2024.
## Related Projects
- [{feltr}](https://christophertkenny.com/feltr/): A R package with the same name that provide very similar functionality to this package.
- [felt-upload](https://pypi.org/project/felt-upload/): A Python package to upload data to Felt.
- [Add to Felt QGIS Plugin](https://plugins.qgis.org/plugins/felt/): A QGIS plugin for uploading data to Felt.
- [feltpy](https://github.com/moss-xyz/feltpy): A lightweight Python package to interact with the public API of Felt.com.