ankane /ruby-polars

Blazingly fast DataFrames for Ruby

★ 1,001⑂ 49👁 11⑃ 31● 107▤ 0
RubyMITCreated 2022-11-22
TA的项目
+0
日增长
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

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON