Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pola-rs/r-polars
Bring polars to R
https://github.com/pola-rs/r-polars
arrow polars r rust
Last synced: 3 months ago
JSON representation
Bring polars to R
- Host: GitHub
- URL: https://github.com/pola-rs/r-polars
- Owner: pola-rs
- License: other
- Created: 2022-12-26T17:02:43.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T17:04:46.000Z (6 months ago)
- Last Synced: 2024-05-23T00:10:44.792Z (6 months ago)
- Topics: arrow, polars, r, rust
- Language: R
- Homepage: https://pola-rs.github.io/r-polars/
- Size: 5.12 MB
- Stars: 400
- Watchers: 10
- Forks: 35
- Open Issues: 63
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
Awesome Lists containing this project
- awesome-polars - rpolars for R - [R](https://www.r-project.org/) `rpolars` package to use polars DataFrame from R. (Libraries/Packages/Scripts / R)
README
---
output:
github_document:
html_preview: false
# used by altdoc
default-image-extension: ''
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# polars
[](https://community.r-multiverse.org/polars)
[](https://rpolars.r-universe.dev)
[](https://CRAN.R-project.org/package=polars)
[](https://github.com/pola-rs/r-polars/actions/workflows/check.yaml)
[](https://pola-rs.github.io/r-polars)
The **polars** package for R gives users access to [a lightning
fast](https://duckdblabs.github.io/db-benchmark/) Data Frame library written in
Rust. [Polars](https://www.pola.rs/)' embarrassingly parallel execution, cache
efficient algorithms and expressive API makes it perfect for efficient data
wrangling, data pipelines, snappy APIs, and much more besides. Polars also supports
"streaming mode" for out-of-memory operations. This allows users to analyze
datasets many times larger than RAM.
Examples of common operations:
- read CSV, JSON, Parquet, and other file formats;
- filter rows and select columns;
- modify and create new columns;
- group by and aggregate;
- reshape data;
- join and concatenate different datasets;
- sort data;
- work with dates and times;
- handle missing values;
- use the lazy execution engine for maximum performance and
memory-efficient operations
Note that this package is rapidly evolving and there are a number of breaking
changes at each version. Be sure to check the [changelog](https://pola-rs.github.io/r-polars/NEWS.html)
when updating `polars`.
## Install
The recommended way to install this package is via R-multiverse:
```r
Sys.setenv(NOT_CRAN = "true")
install.packages("polars", repos = "https://community.r-multiverse.org")
```
[The "Install" vignette](https://pola-rs.github.io/r-polars/vignettes/install.html) (`vignette("install", "polars")`)
gives more details on how to install this package and other ways to install it.
## Quickstart example
To avoid conflicts with other packages and base R function names, **polars**'s
top level functions are hosted in the `pl` namespace, and accessible via the
`pl$` prefix.
This means that `polars` queries written in Python and in R are very similar.
For example, rewriting the Python example from in R:
```{r}
library(polars)
df = pl$DataFrame(
A = 1:5,
fruits = c("banana", "banana", "apple", "apple", "banana"),
B = 5:1,
cars = c("beetle", "audi", "beetle", "beetle", "beetle")
)
# embarrassingly parallel execution & very expressive query language
df$sort("fruits")$select(
"fruits",
"cars",
pl$lit("fruits")$alias("literal_string_fruits"),
pl$col("B")$filter(pl$col("cars") == "beetle")$sum(),
pl$col("A")$filter(pl$col("B") > 2)$sum()$over("cars")$alias("sum_A_by_cars"),
pl$col("A")$sum()$over("fruits")$alias("sum_A_by_fruits"),
pl$col("A")$reverse()$over("fruits")$alias("rev_A_by_fruits"),
pl$col("A")$sort_by("B")$over("fruits")$alias("sort_A_by_B_by_fruits")
)
```
The [Get Started vignette](https://pola-rs.github.io/r-polars/vignettes/polars.html) (`vignette("polars")`) provides
a more detailed introduction to **polars**.
## Extensions
While one can use **polars** as-is, other packages build on it to
provide different syntaxes:
- [polarssql](https://rpolars.github.io/r-polarssql/) provides a **polars**
backend for [DBI](https://dbi.r-dbi.org/) and [dbplyr](https://dbplyr.tidyverse.org/).
- [tidypolars](https://tidypolars.etiennebacher.com/) allows one to
use the [tidyverse](https://www.tidyverse.org/) syntax while using the power of **polars**.
## Getting help
The online documentation can be found at .
If you encounter a bug, please file an issue with a minimal reproducible example on
[GitHub](https://github.com/pola-rs/r-polars/issues).
Consider joining our [Discord](https://discord.com/invite/4UfP5cfBE7) subchannel for
additional help and discussion.