Repository navigation
v0.1.2
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(&&,||,!),Seriescomparison operators (<,<=,>,>=,equals(_:),notEquals(_:)),df[mask]andfiltered(by:). - Math and scaling:
UnaryMathFunctionwithapplying(_:)andpower(_:)(MLX-accelerated),standardized,minMaxScaled. - Binning, interpolation and conditional replacement:
binned(pd.cut),quantileBinned(pd.qcut),interpolated,where(_:otherwise:),indexOfMax()/indexOfMin(). - Windows:
exponentiallyWeighted/exponentiallyWeightedMean(ewm) andminPeriodsforrolling. - Reshaping, grouping and joins:
pivoted,crossTabulated,oneHotEncoded,GroupedDataFrame.filter(_:), aggregation aliases (as:),pipe(_:),joinAsOf(merge_asof),resample. - Structured results:
SeriesDescription(describeStructured()) andQuantileTable(quantiles(_:)). - Execution policy:
ExecutionPolicy.gpuFloat32, which runs general finite floating-point workloads inFloat32on the Metal GPU. - Documentation:
///comments on all public declarations, a DocC catalog and.spi.ymlfor Swift Package Index, and a "Project structure" section inCONTRIBUTING.md.
Performance
Float64Column/Int64Columnshare numeric buffers and feed MLX kernels directly, with no[DataValue]round-trips.Seriesis backed by a typed column, and unchanged columns are reused in O(1) bywithColumn,select,dropand similar operations.- Fused
MLX.evalcalls for moments and cumulative operations. - Strided MLX rolling windows for sum, mean, min, max, variance and standard deviation.
- Columnar
querymasks and multi-keygroupByusing denseInt32group IDs. - CSV fields are parsed straight into typed column builders.
Changed
CheckPoints.mdandToDo.mdmoved toDocumentation/Development/;AGENTS.mdstays at the root.- Simplified
.gitignore.Package.resolvedis 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")