# opensensmapr
[](https://cran.r-project.org/package=opensensmapr) [](https://travis-ci.org/noerw/opensensmapR) [](https://ci.appveyor.com/project/noerw/opensensmapR) [](https://codecov.io/github/noerw/opensensmapR?branch=master)
This R package ingests data (environmental measurements, sensor stations) from the API of opensensemap.org for analysis in R.
The package aims to be compatible with sf and the tidyverse.
## Installation
Right now, the package is not on CRAN. To install it from GitHub, run:
```r
install.packages('devtools')
devtools::install_github('noerw/opensensmapr')
```
## Usage
A verbose usage example is shown in the vignette [`osem-intro` ](https://noerw.github.com/opensensmapR/inst/doc/osem-intro.html ).
Each functions documentation can be viewed with `?<function-name>` .
An overview is given in `?opensensmapr` .
In short, the following pseudocode shows the main functions for data retrieval:
```r
# retrieve a single box by id, or many boxes by some property-filters
b = osem_box('boxId')
b = osem_boxes(filter1, filter2, ...)
# get the counts of observed phenomena for a list of boxes
p = osem_phenomena(b)
# get measurements for a phenomenon
m = osem_measurements(phenomenon, filter1, ...)
# get measurements for a phenomenon from selected boxes
m = osem_measurements(b, phenomenon, filter1, ...)
# get measurements for a phenomenon from a geographic bounding box
m = osem_measurements(bbox, phenomenon, filter1, ...)
# get general count statistics of the openSenseMap database
osem_counts()
```
Additionally there are some helpers: `summary.sensebox(), plot.sensebox(), st_as_sf.sensebox(), osem_as_sensebox(), [.sensebox(), filter.sensebox(), mutate.sensebox(), ...` .
## Changelog
This project adheres to semantic versioning, for changes in recent versions please consult [CHANGES.md ](CHANGES.md ).
## FAQ
- *Whats up with that package name?* idk, the R people seem to [enjoy][1] [dropping][2] [vovels][3] so..
Unfortunately I couldn't fit the naming convention to drop an `y` in there.
[1]: https://github.com/tidyverse/readr
[2]: https://github.com/tidyverse/dplyr
[3]: https://github.com/tidyverse/tidyr
## Development
Please note that this project is released with a [Contributor Code of Conduct ](CONDUCT.md ).
By participating in this project you agree to abide by its terms.
## License
GPL-2.0 - Norwin Roosen
