Breakers.jl#

A Julia package for data classification and binning with R's classInt compatibility

Overview#

Breakers.jl provides functions for creating class intervals for mapping or visualization purposes. The package implements several data binning methods commonly used in spatial data analysis and visualization, with a focus on exact compatibility with R's classInt package.

Features#

• Multiple binning methods including Fisher-Jenks natural breaks, k-means clustering, quantile-based, and equal interval binning

• Exact compatibility with R's classInt package for consistent results across languages

• Support for both numeric binning (indices) and categorical binning (strings)

• Proper handling of missing values

• Support for SubArrays and various input types

Installation#

You can install Breakers.jl using Julia's package manager:

using Pkg
Pkg.add("Breakers")

Example Usage#

using Breakers

# Sample data
values = [1, 5, 7, 9, 10, 15, 20, 30, 50, 100]

# Get binned data with category labels
binned_data = get_bins(values, 5)
fisher_bins = binned_data["fisher"]
kmeans_bins = binned_data["kmeans"]

# Get bin indices (1 to n)
bin_indices = get_bin_indices(values, 5)
fisher_indices = bin_indices["fisher"]

Comparison with R's classInt#

Breakers.jl has been extensively tested for compatibility with R's classInt package and produces identical results for all binning methods. This makes it perfect for workflows that need to maintain consistency between R and Julia.