# opensensmapr
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
## License
GPL-2.0 - Norwin Roosen
