Skip to content

v0.1.2

Choose a tag to compare

@nedpark nedpark released this 06 Nov 03:03
· 9 commits to main since this release
1c44ac3

Highlights

0.1.2 removes [DataValue] boxing between columnar storage and MLX, and adds a large set of pandas-style APIs. Every public declaration is now documented, and Bandal ships a DocC catalog.

Added

  • Vectorized boolean indexing: BooleanMask (&&, ||, !), Series comparison operators (<, <=, >, >=, equals(_:), notEquals(_:)), df[mask] and filtered(by:).
  • Math and scaling: UnaryMathFunction with applying(_:) and power(_:) (MLX-accelerated), standardized, minMaxScaled.
  • Binning, interpolation and conditional replacement: binned (pd.cut), quantileBinned (pd.qcut), interpolated, where(_:otherwise:), indexOfMax() / indexOfMin().
  • Windows: exponentiallyWeighted / exponentiallyWeightedMean (ewm) and minPeriods for rolling.
  • Reshaping, grouping and joins: pivoted, crossTabulated, oneHotEncoded, GroupedDataFrame.filter(_:), aggregation aliases (as:), pipe(_:), joinAsOf (merge_asof), resample.
  • Structured results: SeriesDescription (describeStructured()) and QuantileTable (quantiles(_:)).
  • Execution policy: ExecutionPolicy.gpuFloat32, which runs general finite floating-point workloads in Float32 on the Metal GPU.
  • Documentation: /// comments on all public declarations, a DocC catalog and .spi.yml for Swift Package Index, and a "Project structure" section in CONTRIBUTING.md.

Performance

  • Float64Column / Int64Column share numeric buffers and feed MLX kernels directly, with no [DataValue] round-trips.
  • Series is backed by a typed column, and unchanged columns are reused in O(1) by withColumn, select, drop and similar operations.
  • Fused MLX.eval calls for moments and cumulative operations.
  • Strided MLX rolling windows for sum, mean, min, max, variance and standard deviation.
  • Columnar query masks and multi-key groupBy using dense Int32 group IDs.
  • CSV fields are parsed straight into typed column builders.

Changed

  • CheckPoints.md and ToDo.md moved to Documentation/Development/; AGENTS.md stays at the root.
  • Simplified .gitignore. Package.resolved is no longer tracked.
  • English and Korean docs (API, README) updated.

Compatibility

  • No breaking changes to the public API. Requires macOS 14+ and Swift 6.4+.
  • All 66 tests pass.

Installation

.package(url: "https://github.com/NeuroAssociates/Bandal.git", from: "0.1.2")