+0
Daily
1,001
stars
49
forks
11
watchers
31
prs
107
issues
0
releases
README
Ruby Polars
🔥 Blazingly fast DataFrames for Ruby, powered by Polars
Installation
Add this line to your application’s Gemfile:
ruby
gem "polars-df"
Getting Started
This library follows the Polars Python API.
ruby
Polars.scan_csv("iris.csv")
.filter(Polars.col("sepal_length") 5)
.group_by("species")
.agg(Polars.all.sum)
.collect
You can follow Polars tutorials and convert the code to Ruby in many cases. Feel free to open an issue if you run into problems.
Reference
- Series
- DataFrame
- LazyFrame
Creating DataFrames
From a CSV
ruby
Polars.read_csv("file.csv")
or lazily with
Polars.scan_csv("file.csv")
From Parquet
ruby
Polars.read_parquet("file.parquet")
or lazily with
Polars.scan_parquet("file.parquet")
From Active Record
ruby
Polars.read_database(User.all)
or
Polars.read_database("SELECT FROM users")
From JSON
ruby
Polars.read_json("file.json")
or
Polars.read_ndjson("file.ndjson")
or lazily with
Polars.scan_ndjson("file.ndjson")
From Feather / Arrow IPC
ruby
Polars.read_ipc("file.arrow")
or lazily with
Polars.scan_ipc("file.arrow")
From Avro
ruby
Polars.read_avro("file.avro")
From Iceberg (experimental, requires iceberg)
ruby
Polars.scan_iceberg(table)
From Delta Lake (experimental, requires deltalake-rb)
ruby
Polars.read_delta("./table")
or lazily with
Polars.scan_delta("./table")
From a hash
ruby
Polars::DataFrame.new({
a: [1, 2, 3],
b: ["one", "two", "three"]
})
From an array of hashes
ruby
Polars::DataFrame.new([
{a: 1, b: "one"},
{a: 2, b: "two"},
{a: 3, b: "three"}
])
From an array of series
ruby
Polars::DataFrame.new([
Polars::Series.new("a", [1, 2, 3]),
Polars::Series.new("b", ["one", "two", "three"])
])
Attributes
Get number of rows
ruby
df.height
Get column names
ruby
df.columns
Check if a column exists
ruby
df.include?(name)
Selecting Data
Select a column
ruby
df["a"]
Select multiple columns
ruby
df[["a", "b"]]
Select first rows
ruby
df.head
Select last rows
ruby
df.tail
Filtering
Filter on a condition
ruby
df.filter(Polars.col("a") == 2)
df.filter(Polars.col("a") != 2)
df.filter(Polars.col("a") 2)
df.filter(Polars.col("a") = 2)
df.filter(Polars.col("a") 1) & (Polars.col("b") == "two")) and
df.filter((Polars.col("a") 1) | (Polars.col("b") == "two")) or
df.filter((Polars.col("a") 1) ^ (Polars.col("b") == "two")) xor
Operations
Basic operations
ruby
df["a"] + 5
df["a"] - 5
df["a"] 5
df["a"] / 5
df["a"] % 5
df["a"] 2
df["a"].sqrt
df["a"].abs
Rounding
ruby
df["a"].round(2)
df["a"].ceil
df["a"].floor
Logarithm
ruby
df["a"].log natural log
df["a"].log(10)
Exponentiation
ruby
df["a"].exp
Trigonometric functions
ruby
df["a"].sin
df["a"].cos
df["a"].tan
df["a"].arcsin
df["a"].arccos
df["a"].arctan
Hyperbolic functions
ruby
df["a"].sinh
df["a"].cosh
df["a"].tanh
df["a"].arcsinh
df["a"].arccosh
df["a"].arctanh
Summary statistics
ruby
df["a"].sum
df["a"].mean
df["a"].median
df["a"].quantile(0.90)
df