golumn

golumn is a fast, type-safe, and easy-to-use in-memory dataframe library in Go. Built for data manipulation, transformation, and analysis, it provides a simple API for creating and manipulating columnar data structures.

golumn: sturdy columns for in-memory data.

---

Features

• Purely in-memory dataframe and series structures
• Type-safe column operations
• Immutable-style transformations
• Fast, portable, and Go-native

---

Installation

golumn is available on GitHub and can be installed using Go modules:

go get github.com/chriso345/golumn

---

Usage

Here's a quick example of how to use golumn:

package main

import (
  "fmt"
  "github.com/chriso345/golumn"
)

func main() {
  // Create a new DataFrame
  df := golumn.New(
    series.New([]string{"Alice", "Bob", "Charlie"}, series.String, "Name"),
    series.New([]int{25, 30, 35}, series.Int, "Age"),
  )

  // Print the DataFrame
  fmt.Println(df)

  // Add a new column
  df.Append(series.New([]string{"New York", "Los Angeles", "Chicago"}, series.String, "City"))

  // Print the updated DataFrame
  fmt.Println(df)

  // Filter where Age is greater than 28
  filtered := df.Filter(func(row golumn.Row) bool {
    return row.Get("Age").(int) > 28
  })

  // Print the filtered DataFrame
  fmt.Println(filtered)
}

---

Submodules

• golumn/series Core implementation of the Series type — a one-dimensional, type-safe, columnar data structure.

• golumn/dfio I/O utilities for loading and saving DataFrames and Series in formats like CSV and JSON.

• golumn/math (planned) Statistical functions and numerical operations for both Series and DataFrame types.

• golumn/plot (planned) Minimal plotting tools for visual exploration of tabular data (e.g. line charts, histograms).

---

License

This project is licensed under the MIT License. See the LICENSE file for details.