golars

golars / polars API surface

Map between polars' Python API and golars' Go surface.

This file is generated. Do not edit it by hand. Regenerate with:

cd bench/polars-compare && uv run python api_coverage.py

The script lists the public API of polars 1.39.3 with dir(), parses the golars Go source for exported methods and functions, and maps the names. A polars name counts as done when a golars name matches it case-insensitively with underscores removed (n_unique and NUnique), or when the rename table in the script points at a name that exists in the Go source. partial means golars covers a narrower form; the note says how. todo means no match was found. Names that have no meaning in Go (pandas, numpy, Python UDFs, plotting) are listed under Not applicable and left out of the totals. Deprecated polars names are skipped.

A done row means the name exists with the same intent. It does not promise identical arguments; Go signatures use typed options instead of keyword arguments.

Coverage summary

SurfaceCoveredDonePartialTodoNot applicableCoverage
Expr201 of 20620015398%
Expr.str45 of 474502096%
Expr.dt43 of 454302096%
Expr.list42 of 434201098%
Expr.arr29 of 312902094%
Expr.struct5 of 55000100%
Expr.name10 of 1010000100%
Expr.bin11 of 1111000100%
Expr.cat6 of 66000100%
DataFrame109 of 118106391092%
LazyFrame64 of 706316691%
GroupBy15 of 161501094%
LazyGroupBy15 of 161501094%
Series201 of 212201011895%
Series.str45 of 474502096%
Series.dt43 of 474304091%
Series.list41 of 434102095%
Series.arr29 of 312902094%
Series.struct5 of 6501083%
Series.bin11 of 1111000100%
Series.cat6 of 66001100%
Data types24 of 282404486%
Top-level functions81 of 105738242177%
Total1081 of 1160106813795393%

Series namespaces (s.str, s.dt, ...) are counted against the eager series.*Ops types.

Expr

pl.Expr against expr.Expr.

polarsgolarsStatusNotes
absAbsdone
addAdddone
aliasAliasdone
allAlldone
and_Anddone
anyAnydone
appendtodo
approx_n_uniqueApproxNUniquedone
arccosArccosdone
arccoshArccoshdone
arcsinArcsindone
arcsinhArcsinhdone
arctanArctandone
arctanhArctanhdone
arg_maxArgMaxdone
arg_minArgMindone
arg_sortArgSortdone
arg_trueArgTruedone
arg_uniqueArgUniquedone
arrArrdone
backward_fillBackwardFilldone
binBindone
bitwise_andBitwiseAnddone
bitwise_count_onesBitwiseCountOnesdone
bitwise_count_zerosBitwiseCountZerosdone
bitwise_leading_onesBitwiseLeadingOnesdone
bitwise_leading_zerosBitwiseLeadingZerosdone
bitwise_orBitwiseOrdone
bitwise_trailing_onesBitwiseTrailingOnesdone
bitwise_trailing_zerosBitwiseTrailingZerosdone
bitwise_xorBitwiseXordone
bottom_kBottomKdone
bottom_k_byBottomKBydone
castCastdone
catCatdone
cbrtCbrtdone
ceilCeildone
clipClipdone
cosCosdone
coshCoshdone
cotCotdone
countCountdone
cum_countCumCountdone
cum_maxCumMaxdone
cum_minCumMindone
cum_prodCumProddone
cum_sumCumSumdone
cumulative_evalCumulativeEvaldone
cutCutdone
degreesDegreesdone
diffDiffdone
dotDotdone
drop_nansDropNansdone
drop_nullsDropNullsdone
dtDtdone
entropyEntropydone
eqEqdone
eq_missingEqMissingdone
ewm_meanEWMMeandone
ewm_mean_bytodo
ewm_stdEWMStddone
ewm_varEWMVardone
excludeExcludedone
expExpdone
explodeExplodedone
extend_constantExtendConstantdone
fill_nanFillNandone
fill_nullFillNulldone
filterFilterdone
firstFirstdone
floorFloordone
floordivFloorDivdone
forward_fillForwardFilldone
gatherGatherdone
gather_everyGatherEverydone
geGedone
getGetdone
gtGtdone
has_nullsHasNullsdone
hashHashdone
headHeaddone
histHistdone
implodeImplodedone
index_ofIndexOfdone
interpolateInterpolatedone
interpolate_byInterpolateBydone
is_betweenIsBetweendone
is_closeIsClosedone
is_duplicatedIsDuplicateddone
is_finiteIsFinitedone
is_first_distinctIsFirstDistinctdone
is_inIsIndone
is_infiniteIsInfinitedone
is_last_distinctIsLastDistinctdone
is_nanIsNaNdone
is_not_nanIsNotNaNdone
is_not_nullIsNotNulldone
is_nullIsNulldone
is_uniqueIsUniquedone
itemItemdone
kurtosisKurtosisdone
lastLastdone
leLedone
lenLendone
limitLimitdone
listListdone
logLogdone
log10Log10done
log1pLog1pdone
lower_boundLowerBounddone
ltLtdone
maxMaxdone
max_byMaxBydone
meanMeandone
medianMediandone
metaexpr.OutputNamepartialpackage functions, not a namespace: OutputName, ReferencedColumns, IsMultiColumn, Equal
minMindone
min_byMinBydone
modModdone
modeModedone
mulMuldone
n_uniqueNUniquedone
nameNamedone
nan_maxNanMaxdone
nan_minNanMindone
neNedone
ne_missingNeMissingdone
negNegdone
not_Notdone
null_countNullCountdone
or_Ordone
overOverdone
pct_changePctChangedone
peak_maxPeakMaxdone
peak_minPeakMindone
pipePipedone
powPowdone
productProductdone
qcutQCutdone
quantileQuantiledone
radiansRadiansdone
rankRankdone
rechunkRechunkdone
reinterpretReinterpretdone
repeat_byRepeatBydone
replace_strictReplaceStrictdone
reshapeReshapedone
reverseReversedone
rleRledone
rle_idRleIDdone
rollingtodo
rolling_kurtosisRollingKurtosisdone
rolling_mapRollingMapdone
rolling_maxRollingMaxdone
rolling_max_byRollingMaxBydone
rolling_meanRollingMeandone
rolling_mean_byRollingMeanBydone
rolling_medianRollingMediandone
rolling_median_byRollingMedianBydone
rolling_minRollingMindone
rolling_min_byRollingMinBydone
rolling_quantileRollingQuantiledone
rolling_quantile_byRollingQuantileBydone
rolling_rankRollingRankdone
rolling_rank_bytodo
rolling_skewRollingSkewdone
rolling_stdRollingStddone
rolling_std_byRollingStdBydone
rolling_sumRollingSumdone
rolling_sum_byRollingSumBydone
rolling_varRollingVardone
rolling_var_byRollingVarBydone
roundRounddone
round_sig_figsRoundSigFigsdone
sampleSampledone
search_sortedSearchSorteddone
set_sortedSetSorteddone
shiftShiftdone
shuffleShuffledone
signSigndone
sinSindone
sinhSinhdone
skewSkewdone
sliceSlicedone
sortSortdone
sort_bySortBydone
sqrtSqrtdone
stdStddone
strStrdone
structStructdone
subSubdone
sumSumdone
tailTaildone
tanTandone
tanhTanhdone
to_physicalToPhysicaldone
top_kTopKdone
top_k_byTopKBydone
truedivTrueDivdone
truncatetodo
uniqueUniquedone
unique_countsUniqueCountsdone
upper_boundUpperBounddone
value_countsValueCountsdone
varVardone
xorXordone

Expr.str

pl.Expr.str against expr.StrOps, reached with .Str().

polarsgolarsStatusNotes
str.containsStr().Containsdone
str.contains_anyStr().ContainsAnydone
str.count_matchesStr().CountMatchesdone
str.decodeStr().Decodedone
str.encodeStr().Encodedone
str.ends_withStr().EndsWithdone
str.escape_regexStr().EscapeRegexdone
str.extractStr().Extractdone
str.extract_allStr().ExtractAlldone
str.extract_groupsStr().ExtractGroupsdone
str.extract_manyStr().ExtractManydone
str.findStr().Finddone
str.find_manyStr().FindManydone
str.headStr().Headdone
str.joinStr().Joindone
str.json_decodeStr().JSONDecodedone
str.json_path_matchStr().JSONPathMatchdone
str.len_bytesStr().LenBytesdone
str.len_charsStr().LenCharsdone
str.normalizetodo
str.pad_endStr().PadEnddone
str.pad_startStr().PadStartdone
str.replaceStr().Replacedone
str.replace_allStr().ReplaceAlldone
str.replace_manyStr().ReplaceManydone
str.reverseStr().Reversedone
str.sliceStr().Slicedone
str.splitStr().Splitdone
str.split_exactStr().SplitExactdone
str.splitnStr().SplitNdone
str.starts_withStr().StartsWithdone
str.strip_charsStr().StripCharsdone
str.strip_chars_endStr().StripCharsEnddone
str.strip_chars_startStr().StripCharsStartdone
str.strip_prefixStr().StripPrefixdone
str.strip_suffixStr().StripSuffixdone
str.strptimeStr().Strptimedone
str.tailStr().Taildone
str.to_dateStr().ToDatedone
str.to_datetimeStr().ToDatetimedone
str.to_decimaltodo
str.to_integerStr().ToIntegerdone
str.to_lowercaseStr().ToLowerdone
str.to_timeStr().ToTimedone
str.to_titlecaseStr().ToTitlecasedone
str.to_uppercaseStr().ToUpperdone
str.zfillStr().ZFilldone

Expr.dt

pl.Expr.dt against expr.DtOps, reached with .Dt().

polarsgolarsStatusNotes
dt.add_business_daysDt().AddBusinessDaysdone
dt.base_utc_offsettodo
dt.cast_time_unitDt().CastTimeUnitdone
dt.centuryDt().Centurydone
dt.combineDt().Combinedone
dt.convert_time_zoneDt().ConvertTimeZonedone
dt.dateDt().Datedone
dt.dayDt().Daydone
dt.days_in_monthDt().DaysInMonthdone
dt.dst_offsettodo
dt.epochDt().Epochdone
dt.hourDt().Hourdone
dt.is_business_dayDt().IsBusinessDaydone
dt.is_leap_yearDt().IsLeapYeardone
dt.iso_yearDt().IsoYeardone
dt.microsecondDt().Microseconddone
dt.millenniumDt().Millenniumdone
dt.millisecondDt().Milliseconddone
dt.minuteDt().Minutedone
dt.monthDt().Monthdone
dt.month_endDt().MonthEnddone
dt.month_startDt().MonthStartdone
dt.nanosecondDt().Nanoseconddone
dt.offset_byDt().OffsetBydone
dt.ordinal_dayDt().OrdinalDaydone
dt.quarterDt().Quarterdone
dt.replaceDt().Replacedone
dt.replace_time_zoneDt().ReplaceTimeZonedone
dt.roundDt().Rounddone
dt.secondDt().Seconddone
dt.strftimeDt().Strftimedone
dt.timeDt().Timedone
dt.timestampDt().Timestampdone
dt.to_stringDt().ToStringdone
dt.total_daysDt().TotalDaysdone
dt.total_hoursDt().TotalHoursdone
dt.total_microsecondsDt().TotalMicrosecondsdone
dt.total_millisecondsDt().TotalMillisecondsdone
dt.total_minutesDt().TotalMinutesdone
dt.total_nanosecondsDt().TotalNanosecondsdone
dt.total_secondsDt().TotalSecondsdone
dt.truncateDt().Truncatedone
dt.weekDt().Weekdone
dt.weekdayDt().Weekdaydone
dt.yearDt().Yeardone

Expr.list

pl.Expr.list against expr.ListOps, reached with .List().

polarsgolarsStatusNotes
list.aggtodo
list.allList().Alldone
list.anyList().Anydone
list.arg_maxList().ArgMaxdone
list.arg_minList().ArgMindone
list.concatList().Concatdone
list.containsList().Containsdone
list.count_matchesList().CountMatchesdone
list.diffList().Diffdone
list.drop_nullsList().DropNullsdone
list.evalList().Evaldone
list.explodeList().Explodedone
list.filterList().Filterdone
list.firstList().Firstdone
list.gatherList().Gatherdone
list.gather_everyList().GatherEverydone
list.getList().Getdone
list.headList().Headdone
list.itemList().Itemdone
list.joinList().Joindone
list.lastList().Lastdone
list.lenList().Lendone
list.maxList().Maxdone
list.meanList().Meandone
list.medianList().Mediandone
list.minList().Mindone
list.n_uniqueList().NUniquedone
list.reverseList().Reversedone
list.sampleList().Sampledone
list.set_differenceList().SetDifferencedone
list.set_intersectionList().SetIntersectiondone
list.set_symmetric_differenceList().SetSymmetricDifferencedone
list.set_unionList().SetUniondone
list.shiftList().Shiftdone
list.sliceList().Slicedone
list.sortList().Sortdone
list.stdList().Stddone
list.sumList().Sumdone
list.tailList().Taildone
list.to_arrayList().ToArraydone
list.to_structList().ToStructdone
list.uniqueList().Uniquedone
list.varList().Vardone

Expr.arr

pl.Expr.arr against expr.ArrOps, reached with .Arr().

polarsgolarsStatusNotes
arr.aggtodo
arr.allArr().Alldone
arr.anyArr().Anydone
arr.arg_maxArr().ArgMaxdone
arr.arg_minArr().ArgMindone
arr.containsArr().Containsdone
arr.count_matchesArr().CountMatchesdone
arr.evaltodo
arr.explodeArr().Explodedone
arr.firstArr().Firstdone
arr.getArr().Getdone
arr.headArr().Headdone
arr.joinArr().Joindone
arr.lastArr().Lastdone
arr.lenArr().Lendone
arr.maxArr().Maxdone
arr.meanArr().Meandone
arr.medianArr().Mediandone
arr.minArr().Mindone
arr.n_uniqueArr().NUniquedone
arr.reverseArr().Reversedone
arr.shiftArr().Shiftdone
arr.sliceArr().Slicedone
arr.sortArr().Sortdone
arr.stdArr().Stddone
arr.sumArr().Sumdone
arr.tailArr().Taildone
arr.to_listArr().ToListdone
arr.to_structArr().ToStructdone
arr.uniqueArr().Uniquedone
arr.varArr().Vardone

Expr.struct

pl.Expr.struct against expr.StructOps, reached with .Struct().

polarsgolarsStatusNotes
struct.fieldStruct().Fielddone
struct.json_encodeStruct().JSONEncodedone
struct.rename_fieldsStruct().RenameFieldsdone
struct.unnestStruct().Unnestdone
struct.with_fieldsStruct().WithFieldsdone

Expr.name

pl.Expr.name against expr.NameOps, reached with .Name().

polarsgolarsStatusNotes
name.keepName().Keepdone
name.mapName().Mapdone
name.map_fieldsName().MapFieldsdone
name.prefixName().Prefixdone
name.prefix_fieldsName().PrefixFieldsdone
name.replaceName().Replacedone
name.suffixName().Suffixdone
name.suffix_fieldsName().SuffixFieldsdone
name.to_lowercaseName().ToLowercasedone
name.to_uppercaseName().ToUppercasedone

Expr.bin

pl.Expr.bin against expr.BinOps, reached with .Bin().

polarsgolarsStatusNotes
bin.containsBin().Containsdone
bin.decodeBin().Decodedone
bin.encodeBin().Encodedone
bin.ends_withBin().EndsWithdone
bin.getBin().Getdone
bin.headBin().Headdone
bin.reinterpretBin().Reinterpretdone
bin.sizeBin().Sizedone
bin.sliceBin().Slicedone
bin.starts_withBin().StartsWithdone
bin.tailBin().Taildone

Expr.cat

pl.Expr.cat against expr.CatOps, reached with .Cat().

polarsgolarsStatusNotes
cat.ends_withCat().EndsWithdone
cat.get_categoriesCat().GetCategoriesdone
cat.len_bytesCat().LenBytesdone
cat.len_charsCat().LenCharsdone
cat.sliceCat().Slicedone
cat.starts_withCat().StartsWithdone

DataFrame

pl.DataFrame against *dataframe.DataFrame. Some rows point at root package helpers (golars.*) or I/O packages.

polarsgolarsStatusNotes
df.bottom_kdf.BottomKdone
df.castdf.Castdone
df.cleardf.Cleardone
df.clonedf.Clonedone
df.collect_schemadf.CollectSchemadone
df.columnsdf.Columnsdone
df.corrdf.Corrdone
df.countdf.CountAlldone
df.describedf.Describedone
df.dropdf.Dropdone
df.drop_in_placetodo
df.drop_nansdf.DropNansdone
df.drop_nullsdf.DropNullsdone
df.dtypesdf.DTypesdone
df.equalsdf.Equalsdone
df.estimated_sizedf.EstimatedSizedone
df.explodedf.Explodedone
df.extenddf.Extenddone
df.fill_nandf.FillNandone
df.fill_nulldf.FillNulldone
df.filterdf.Filterdone
df.flagstodo
df.folddf.Folddone
df.gather_everydf.GatherEverydone
df.get_columndf.GetColumndone
df.get_column_indexdf.GetColumnIndexdone
df.get_columnsdf.GetColumnsdone
df.glimpsedf.Glimpsedone
df.group_bydf.GroupBydone
df.group_by_dynamicdf.GroupByDynamicdone
df.hash_rowsdf.HashRowsdone
df.headdf.Headdone
df.heightdf.Heightdone
df.hstackdf.HStackdone
df.insert_columndf.InsertColumndone
df.interpolatetodo
df.is_duplicateddf.IsDuplicateddone
df.is_emptydf.IsEmptydone
df.is_uniquedf.IsUniquedone
df.itemdf.Itemdone
df.iter_columnsdf.IterColumnsdone
df.iter_rowsdf.IterRowsdone
df.iter_slicesdf.IterSlicesdone
df.joindf.Joinpartialkeys are column names (WithJoinKeys for left_on/right_on), not expressions
df.join_asofdf.JoinAsofdone
df.join_wheredf.JoinWheredone
df.lazygolars.Lazydone
df.limitdf.Limitdone
df.map_rowsdf.MapRowsdone
df.match_to_schemadf.MatchToSchemadone
df.maxdf.MaxAlldone
df.max_horizontaldf.MaxHorizontaldone
df.meandf.MeanAlldone
df.mean_horizontaldf.MeanHorizontaldone
df.mediandf.MedianAlldone
df.merge_sorteddf.MergeSorteddone
df.mindf.MinAlldone
df.min_horizontaldf.MinHorizontaldone
df.n_chunksdf.NChunksdone
df.n_uniquedf.NUniquedone
df.null_countdf.NullCountdone
df.partition_bydf.PartitionBydone
df.pipedf.Pipedone
df.pivotdf.Pivotdone
df.productdf.ProductAlldone
df.quantiledf.QuantileAlldone
df.rechunkdf.Rechunkdone
df.removetodo
df.renamedf.Renamedone
df.replace_columndf.ReplaceColumndone
df.reversedf.Reversedone
df.rollingdf.Rollingdone
df.rowdf.Rowdone
df.rowsdf.Rowsdone
df.rows_by_keydf.RowsByKeydone
df.sampledf.Sampledone
df.schemadf.Schemadone
df.selectdf.Selectpartialtakes column names; use golars.SelectExpr for expressions
df.select_seqgolars.SelectSeqdone
df.set_sortedtodo
df.shapedf.Shapedone
df.shiftdf.Shiftdone
df.showdf.StringdoneString() renders the polars-style table
df.slicedf.Slicedone
df.sortdf.Sortdone
df.sqlgolars.SQLdone
df.stddf.StdAlldone
df.sumdf.SumAlldone
df.sum_horizontaldf.SumHorizontaldone
df.taildf.Taildone
df.to_arrowdf.ToArrowdone
df.to_dictdf.ToMapdone
df.to_dictsdf.ToDictsdone
df.to_dummiesdf.ToDummiesdone
df.to_seriesdf.ToSeriesdone
df.to_structdf.ToStructdone
df.top_kdf.TopKdone
df.transposedf.Transposedone
df.uniquedf.Uniquedone
df.unnestdf.Unnestdone
df.unpivotdf.Unpivotdone
df.unstackdf.Unstackdone
df.updatedf.Updatedone
df.upsampledf.Upsampledone
df.vardf.VarAlldone
df.vstackdf.VStackdone
df.widthdf.Widthdone
df.with_columnsdf.WithColumnspartialtakes Series; use golars.WithColumnsExpr for expressions
df.with_columns_seqgolars.WithColumnsSeqdone
df.with_row_indexdf.WithRowIndexdone
df.write_avrotodo
df.write_clipboardclipboard.Writedone
df.write_databasetodo
df.write_exceltodo
df.write_icebergtodo
df.write_ipc_streamgolars.WriteIPCStreamdone
df.write_jsongolars.WriteJSONdone
df.write_ndjsongolars.WriteNDJSONdone

LazyFrame

pl.LazyFrame against lazy.LazyFrame.

polarsgolarsStatusNotes
lf.bottom_klf.BottomKdone
lf.cachelf.Cachedone
lf.castlf.Castdone
lf.clearlf.Cleardone
lf.clonelf.Clonedone
lf.collect_asynclf.CollectAsyncdone
lf.collect_batcheslf.CollectBatchesdone
lf.collect_schemalf.CollectSchemadone
lf.columnslf.Columnsdone
lf.countlf.Countdone
lf.describelf.Describedone
lf.droplf.Dropdone
lf.drop_nanslf.DropNansdone
lf.drop_nullslf.DropNullsdone
lf.dtypeslf.DTypesdone
lf.explodelf.Explodedone
lf.fill_nanlf.FillNandone
lf.fill_nulllf.FillNulldone
lf.filterlf.Filterdone
lf.firstlf.Firstdone
lf.gather_everylf.GatherEverydone
lf.group_bylf.GroupBydone
lf.group_by_dynamiclf.GroupByDynamicdone
lf.headlf.Headdone
lf.inspectlf.Inspectdone
lf.interpolatetodo
lf.joinlf.Joinpartialkeys are column names (WithJoinKeys for left_on/right_on), not expressions
lf.join_asoflf.JoinAsofdone
lf.join_wherelf.JoinWheredone
lf.lastlf.Lastdone
lf.limitlf.Limitdone
lf.map_batcheslf.MapBatchesdone
lf.match_to_schemalf.MatchToSchemadone
lf.maxlf.Maxdone
lf.meanlf.Meandone
lf.medianlf.Mediandone
lf.merge_sortedlf.MergeSorteddone
lf.minlf.Mindone
lf.null_countlf.NullCountdone
lf.pipelf.Pipedone
lf.pivotlf.Pivotdone
lf.quantilelf.Quantiledone
lf.removetodo
lf.renamelf.Renamedone
lf.reverself.Reversedone
lf.rollinglf.Rollingdone
lf.schemalf.Schemadone
lf.selectlf.Selectdone
lf.select_seqlf.SelectSeqdone
lf.set_sortedtodo
lf.shiftlf.Shiftdone
lf.showtodo
lf.sink_deltatodo
lf.sink_icebergtodo
lf.slicelf.Slicedone
lf.sortlf.Sortdone
lf.sqlgolars.SQLLazydone
lf.stdlf.Stddone
lf.sumlf.Sumdone
lf.taillf.Taildone
lf.top_klf.TopKdone
lf.uniquelf.Uniquedone
lf.unnestlf.Unnestdone
lf.unpivotlf.Unpivotdone
lf.updatelf.Updatedone
lf.varlf.Vardone
lf.widthlf.Widthdone
lf.with_columnslf.WithColumnsdone
lf.with_columns_seqlf.WithColumnsSeqdone
lf.with_row_indexlf.WithRowIndexdone

GroupBy

df.group_by(...) against *dataframe.GroupBy.

polarsgolarsStatusNotes
gb.agggb.Aggdone
gb.allgb.Alldone
gb.firstgb.Firstdone
gb.havingtodo
gb.headgb.Headdone
gb.lastgb.Lastdone
gb.lengb.Lendone
gb.map_groupsgb.MapGroupsdone
gb.maxgb.Maxdone
gb.meangb.Meandone
gb.mediangb.Mediandone
gb.mingb.Mindone
gb.n_uniquegb.NUniquedone
gb.quantilegb.Quantiledone
gb.sumgb.Sumdone
gb.tailgb.Taildone

LazyGroupBy

lf.group_by(...) against lazy.LazyGroupBy.

polarsgolarsStatusNotes
lgb.agglgb.Aggdone
lgb.alllgb.Alldone
lgb.firstlgb.Firstdone
lgb.havingtodo
lgb.headlgb.Headdone
lgb.lastlgb.Lastdone
lgb.lenlgb.Lendone
lgb.map_groupslgb.MapGroupsdone
lgb.maxlgb.Maxdone
lgb.meanlgb.Meandone
lgb.medianlgb.Mediandone
lgb.minlgb.Mindone
lgb.n_uniquelgb.NUniquedone
lgb.quantilelgb.Quantiledone
lgb.sumlgb.Sumdone
lgb.taillgb.Taildone

Series

pl.Series against *series.Series. Some rows point at compute.* kernels or root helpers.

polarsgolarsStatusNotes
s.abss.Absdone
s.aliass.Renamedone
s.alls.Alldone
s.anys.Anydone
s.appends.Appenddone
s.approx_n_uniques.ApproxNUniquedone
s.arccoss.Arccosdone
s.arccoshs.Arccoshdone
s.arcsins.Arcsindone
s.arcsinhs.Arcsinhdone
s.arctans.Arctandone
s.arctanhs.Arctanhdone
s.arg_maxs.ArgMaxdone
s.arg_mins.ArgMindone
s.arg_sorts.ArgSortdone
s.arg_trues.ArgTruedone
s.arg_uniques.ArgUniquedone
s.arrs.Arrdone
s.backward_fills.BackwardFilldone
s.bins.Bindone
s.bitwise_ands.BitwiseAnddone
s.bitwise_count_oness.BitCount("count_ones")done
s.bitwise_count_zeross.BitCount("count_zeros")done
s.bitwise_leading_oness.BitCount("leading_ones")done
s.bitwise_leading_zeross.BitCount("leading_zeros")done
s.bitwise_ors.BitwiseOrdone
s.bitwise_trailing_oness.BitCount("trailing_ones")done
s.bitwise_trailing_zeross.BitCount("trailing_zeros")done
s.bitwise_xors.BitwiseXordone
s.bottom_ks.BottomKdone
s.bottom_k_bys.BottomKBydone
s.castcompute.Castdone
s.cats.Catdone
s.cbrts.Cbrtdone
s.ceils.Ceildone
s.chunk_lengthss.ChunkLengthsdone
s.clears.Cleardone
s.clips.Clipdone
s.clones.Clonedone
s.coss.Cosdone
s.coshs.Coshdone
s.cots.Cotdone
s.countcompute.Countdone
s.cum_counts.CumCountdone
s.cum_maxs.CumMaxdone
s.cum_mins.CumMindone
s.cum_prods.CumProddone
s.cum_sums.CumSumdone
s.cumulative_evaltodo
s.cuts.Cutdone
s.describegolars.DescribeSeriesdone
s.diffs.Diffdone
s.dots.Dotdone
s.drop_nanss.DropNansdone
s.drop_nullss.DropNullsdone
s.dts.Dtdone
s.dtypes.DTypedone
s.entropys.Entropydone
s.eqcompute.Eqdone
s.eq_missings.EqMissingdone
s.equalss.Equalsdone
s.estimated_sizetodo
s.ewm_means.EWMMeandone
s.ewm_mean_bytodo
s.ewm_stds.EWMStddone
s.ewm_vars.EWMVardone
s.exps.Expdone
s.explodes.Explodedone
s.extends.Extenddone
s.extend_constants.ExtendConstantdone
s.fill_nans.FillNandone
s.fill_nulls.FillNulldone
s.filtercompute.Filterdone
s.firsts.Firstdone
s.flagstodo
s.floors.Floordone
s.forward_fills.ForwardFilldone
s.gathers.Gatherdone
s.gather_everys.GatherEverydone
s.gecompute.Gedone
s.get_chunkss.Chunksdone
s.gtcompute.Gtdone
s.has_nullss.HasNullsdone
s.hashs.Hashdone
s.heads.Headdone
s.hists.Histdone
s.implodes.Implodedone
s.index_ofs.IndexOfdone
s.interpolates.Interpolatedone
s.interpolate_bys.InterpolateBydone
s.is_betweens.IsBetweendone
s.is_closes.IsClosedone
s.is_duplicateds.IsDuplicateddone
s.is_emptys.IsEmptydone
s.is_finites.IsFinitedone
s.is_first_distincts.IsFirstDistinctdone
s.is_intodo
s.is_infinites.IsInfinitedone
s.is_last_distincts.IsLastDistinctdone
s.is_nans.IsNaNdone
s.is_not_nantodo
s.is_not_nulls.IsNotNulldone
s.is_nulls.IsNulldone
s.is_sorteds.IsSorteddone
s.is_uniques.IsUniquedone
s.items.Itemdone
s.kurtosiss.Kurtosisdone
s.lasts.Lastdone
s.lecompute.Ledone
s.lens.Lendone
s.limits.Headdone
s.lists.Listdone
s.logs.Logdone
s.log10s.Log10done
s.log1ps.Log1pdone
s.lower_bounds.LowerBounddone
s.ltcompute.Ltdone
s.maxs.Maxdonereturns float64; empty or all-null gives NaN, not None
s.max_bys.MaxBydone
s.means.Meandonereturns float64; empty or all-null gives NaN, not None
s.medians.Mediandone
s.mins.Mindonereturns float64; empty or all-null gives NaN, not None
s.min_bys.MinBydone
s.modes.Modedone
s.n_chunkss.NChunksdone
s.n_uniques.NUniquedone
s.names.Namedone
s.nan_maxs.NanMaxdone
s.nan_mins.NanMindone
s.necompute.Nedone
s.ne_missings.NeMissingdone
s.new_from_indexs.NewFromIndexdone
s.not_compute.Notdone
s.null_counts.NullCountdone
s.pct_changes.PctChangedone
s.peak_maxs.PeakMaxdone
s.peak_mins.PeakMindone
s.pows.Powdone
s.products.Productdone
s.qcuts.QCutdone
s.quantiles.Quantiledone
s.ranks.Rankdone
s.rechunks.Rechunkdone
s.reinterprets.Reinterpretdone
s.renames.Renamedone
s.repeat_bys.RepeatBydone
s.replace_stricts.ReplaceStrictSeriesdone
s.reshapes.Reshapedone
s.reverses.Reversedone
s.rles.Rledone
s.rle_ids.RleIDdone
s.rolling_kurtosiss.RollingKurtosisdone
s.rolling_maps.RollingMapdone
s.rolling_maxs.RollingMaxdone
s.rolling_max_bys.RollingBy("max", ...)done
s.rolling_means.RollingMeandone
s.rolling_mean_bys.RollingBy("mean", ...)done
s.rolling_medians.RollingMedianWindowdone
s.rolling_median_bys.RollingBy("median", ...)done
s.rolling_mins.RollingMindone
s.rolling_min_bys.RollingBy("min", ...)done
s.rolling_quantiles.RollingQuantiledone
s.rolling_quantile_bys.RollingBy("quantile", ...)done
s.rolling_ranks.RollingRankdone
s.rolling_rank_bytodo
s.rolling_skews.RollingSkewdone
s.rolling_stds.RollingStddone
s.rolling_std_bys.RollingBy("std", ...)done
s.rolling_sums.RollingSumdone
s.rolling_sum_bys.RollingBy("sum", ...)done
s.rolling_vars.RollingVardone
s.rolling_var_bys.RollingBy("var", ...)done
s.rounds.Rounddone
s.round_sig_figss.RoundSigFigsdone
s.samples.Sampledone
s.scatters.Scatterdone
s.search_sorteds.SearchSorteddone
s.sets.Scatterdone
s.set_sortedtodo
s.shapes.Shapedone
s.shifts.Shiftdone
s.shrink_dtypes.ShrinkDtypedone
s.shuffles.Shuffledone
s.signs.Signdone
s.sins.Sindone
s.sinhs.Sinhdone
s.skews.Skewdone
s.slices.Slicedone
s.sorts.SortWithdone
s.sqltodo
s.sqrts.Sqrtdone
s.stds.Stddone
s.strs.Strdone
s.structs.Structdone
s.sums.Sumdonereturns float64; empty or all-null gives NaN, not None
s.tails.Taildone
s.tans.Tandone
s.tanhs.Tanhdone
s.to_arrows.ToArrowdone
s.to_dummiestodo
s.to_framegolars.ToFramedone
s.to_lists.ToListdone
s.to_physicals.ToPhysicaldone
s.top_ks.TopKdone
s.top_k_bys.TopKBydone
s.truncatetodo
s.uniques.Uniquedone
s.unique_countss.UniqueCountsdone
s.upper_bounds.UpperBounddone
s.value_countss.ValueCountsdone
s.vars.Vardone
s.zip_withs.ZipWithdone

Series.str

pl.Series.str against series.StrOps, reached with s.Str().

polarsgolarsStatusNotes
s.str.containss.Str().Containsdone
s.str.contains_anys.Str().ContainsAnydone
s.str.count_matchess.Str().CountMatchesdone
s.str.decodes.Str().Decodedone
s.str.encodes.Str().Encodedone
s.str.ends_withs.Str().EndsWithdone
s.str.escape_regexs.Str().EscapeRegexdone
s.str.extracts.Str().Extractdone
s.str.extract_alls.Str().ExtractAlldone
s.str.extract_groupss.Str().ExtractGroupsdone
s.str.extract_manys.Str().ExtractManydone
s.str.finds.Str().Finddone
s.str.find_manys.Str().FindManydone
s.str.heads.Str().Headdone
s.str.joins.Str().Joindone
s.str.json_decodes.Str().JSONDecodedone
s.str.json_path_matchs.Str().JSONPathMatchdone
s.str.len_bytess.Str().LenBytesdone
s.str.len_charss.Str().LenCharsdone
s.str.normalizetodo
s.str.pad_ends.Str().PadEnddone
s.str.pad_starts.Str().PadStartdone
s.str.replaces.Str().Replacedone
s.str.replace_alls.Str().ReplaceAlldone
s.str.replace_manys.Str().ReplaceManydone
s.str.reverses.Str().Reversedone
s.str.slices.Str().Slicedone
s.str.splits.Str().Splitdone
s.str.split_exacts.Str().SplitExactdone
s.str.splitns.Str().SplitNdone
s.str.starts_withs.Str().StartsWithdone
s.str.strip_charss.Str().StripCharsdone
s.str.strip_chars_ends.Str().StripCharsEnddone
s.str.strip_chars_starts.Str().StripCharsStartdone
s.str.strip_prefixs.Str().StripPrefixdone
s.str.strip_suffixs.Str().StripSuffixdone
s.str.strptimes.Str().Strptimedone
s.str.tails.Str().Taildone
s.str.to_dates.Str().ToDatedone
s.str.to_datetimes.Str().ToDatetimedone
s.str.to_decimaltodo
s.str.to_integers.Str().ToIntegerdone
s.str.to_lowercases.Str().ToLowercasedone
s.str.to_times.Str().ToTimedone
s.str.to_titlecases.Str().ToTitlecasedone
s.str.to_uppercases.Str().ToUppercasedone
s.str.zfills.Str().ZFilldone

Series.dt

pl.Series.dt against series.DtOps, reached with s.Dt().

polarsgolarsStatusNotes
s.dt.add_business_dayss.Dt().AddBusinessDaysdone
s.dt.base_utc_offsettodo
s.dt.cast_time_units.Dt().CastTimeUnitdone
s.dt.centurys.Dt().Centurydone
s.dt.combines.Dt().Combinedone
s.dt.convert_time_zones.Dt().ConvertTimeZonedone
s.dt.dates.Dt().Datedone
s.dt.days.Dt().Daydone
s.dt.days_in_months.Dt().DaysInMonthdone
s.dt.dst_offsettodo
s.dt.epochs.Dt().Epochdone
s.dt.hours.Dt().Hourdone
s.dt.is_business_days.Dt().IsBusinessDaydone
s.dt.is_leap_years.Dt().IsLeapYeardone
s.dt.iso_years.Dt().IsoYeardone
s.dt.maxtodo
s.dt.microseconds.Dt().Microseconddone
s.dt.millenniums.Dt().Millenniumdone
s.dt.milliseconds.Dt().Milliseconddone
s.dt.mintodo
s.dt.minutes.Dt().Minutedone
s.dt.months.Dt().Monthdone
s.dt.month_ends.Dt().MonthEnddone
s.dt.month_starts.Dt().MonthStartdone
s.dt.nanoseconds.Dt().Nanoseconddone
s.dt.offset_bys.Dt().OffsetBydone
s.dt.ordinal_days.Dt().OrdinalDaydone
s.dt.quarters.Dt().Quarterdone
s.dt.replaces.Dt().Replacedone
s.dt.replace_time_zones.Dt().ReplaceTimeZonedone
s.dt.rounds.Dt().Rounddone
s.dt.seconds.Dt().Seconddone
s.dt.strftimes.Dt().Strftimedone
s.dt.times.Dt().Timedone
s.dt.timestamps.Dt().Timestampdone
s.dt.to_strings.Dt().ToStringdone
s.dt.total_dayss.Dt().TotalDaysdone
s.dt.total_hourss.Dt().TotalHoursdone
s.dt.total_microsecondss.Dt().TotalMicrosecondsdone
s.dt.total_millisecondss.Dt().TotalMillisecondsdone
s.dt.total_minutess.Dt().TotalMinutesdone
s.dt.total_nanosecondss.Dt().TotalNanosecondsdone
s.dt.total_secondss.Dt().TotalSecondsdone
s.dt.truncates.Dt().Truncatedone
s.dt.weeks.Dt().Weekdone
s.dt.weekdays.Dt().Weekdaydone
s.dt.years.Dt().Yeardone

Series.list

pl.Series.list against series.ListOps, reached with s.List().

polarsgolarsStatusNotes
s.list.aggtodo
s.list.alls.List().Alldone
s.list.anys.List().Anydone
s.list.arg_maxs.List().ArgMaxdone
s.list.arg_mins.List().ArgMindone
s.list.concats.List().Concatdone
s.list.containss.List().Containsdone
s.list.count_matchess.List().CountMatchesdone
s.list.diffs.List().Diffdone
s.list.drop_nullss.List().DropNullsdone
s.list.evaltodo
s.list.explodes.List().Explodedone
s.list.filters.List().Filterdone
s.list.firsts.List().Firstdone
s.list.gathers.List().Gatherdone
s.list.gather_everys.List().GatherEverydone
s.list.gets.List().Getdone
s.list.heads.List().Headdone
s.list.items.List().Itemdone
s.list.joins.List().Joindone
s.list.lasts.List().Lastdone
s.list.lens.List().Lendone
s.list.maxs.List().Maxdone
s.list.means.List().Meandone
s.list.medians.List().Mediandone
s.list.mins.List().Mindone
s.list.n_uniques.List().NUniquedone
s.list.reverses.List().Reversedone
s.list.samples.List().Sampledone
s.list.set_differences.List().SetOperation(other, SetDifference)done
s.list.set_intersections.List().SetOperation(other, SetIntersection)done
s.list.set_symmetric_differences.List().SetOperation(other, SetSymmetricDifference)done
s.list.set_unions.List().SetOperation(other, SetUnion)done
s.list.shifts.List().Shiftdone
s.list.slices.List().Slicedone
s.list.sorts.List().Sortdone
s.list.stds.List().Stddone
s.list.sums.List().Sumdone
s.list.tails.List().Taildone
s.list.to_arrays.List().ToArraydone
s.list.to_structs.List().ToStructdone
s.list.uniques.List().Uniquedone
s.list.vars.List().Vardone

Series.arr

pl.Series.arr against series.ArrOps, reached with s.Arr().

polarsgolarsStatusNotes
s.arr.aggtodo
s.arr.alls.Arr().Alldone
s.arr.anys.Arr().Anydone
s.arr.arg_maxs.Arr().ArgMaxdone
s.arr.arg_mins.Arr().ArgMindone
s.arr.containss.Arr().Containsdone
s.arr.count_matchess.Arr().CountMatchesdone
s.arr.evaltodo
s.arr.explodes.Arr().Explodedone
s.arr.firsts.Arr().Firstdone
s.arr.gets.Arr().Getdone
s.arr.heads.Arr().Headdone
s.arr.joins.Arr().Joindone
s.arr.lasts.Arr().Lastdone
s.arr.lens.Arr().Lendone
s.arr.maxs.Arr().Maxdone
s.arr.means.Arr().Meandone
s.arr.medians.Arr().Mediandone
s.arr.mins.Arr().Mindone
s.arr.n_uniques.Arr().NUniquedone
s.arr.reverses.Arr().Reversedone
s.arr.shifts.Arr().Shiftdone
s.arr.slices.Arr().Slicedone
s.arr.sorts.Arr().Sortdone
s.arr.stds.Arr().Stddone
s.arr.sums.Arr().Sumdone
s.arr.tails.Arr().Taildone
s.arr.to_lists.Arr().ToListdone
s.arr.to_structs.Arr().ToStructdone
s.arr.uniques.Arr().Uniquedone
s.arr.vars.Arr().Vardone

Series.struct

pl.Series.struct against series.StructOps, reached with s.Struct().

polarsgolarsStatusNotes
s.struct.fields.Struct().Fielddone
s.struct.fieldss.Struct().FieldNamesdone
s.struct.json_encodes.Struct().JSONEncodedone
s.struct.rename_fieldss.Struct().RenameFieldsdone
s.struct.schematodo
s.struct.unnests.Struct().Unnestdone

Series.bin

pl.Series.bin against series.BinOps, reached with s.Bin().

polarsgolarsStatusNotes
s.bin.containss.Bin().Containsdone
s.bin.decodes.Bin().Decodedone
s.bin.encodes.Bin().Encodedone
s.bin.ends_withs.Bin().EndsWithdone
s.bin.gets.Bin().Getdone
s.bin.heads.Bin().Headdone
s.bin.reinterprets.Bin().Reinterpretdone
s.bin.sizes.Bin().Sizedone
s.bin.slices.Bin().Slicedone
s.bin.starts_withs.Bin().StartsWithdone
s.bin.tails.Bin().Taildone

Series.cat

pl.Series.cat against series.CatOps, reached with s.Cat().

polarsgolarsStatusNotes
s.cat.ends_withs.Cat().EndsWithdone
s.cat.get_categoriess.Cat().GetCategoriesdone
s.cat.len_bytess.Cat().LenBytesdone
s.cat.len_charss.Cat().LenCharsdone
s.cat.slices.Cat().Slicedone
s.cat.starts_withs.Cat().StartsWithdone

Data types

polars data type classes against the dtype package constructors.

polarsgolarsStatusNotes
pl.Arraydtype.FixedListdone
pl.Binarydtype.Binarydone
pl.Booleandtype.Booldone
pl.Categoricaldtype.Categoricaldone
pl.Datedtype.Datedone
pl.Datetimedtype.Datetimedone
pl.Decimaltodo
pl.Durationdtype.Durationdone
pl.Enumdtype.Enumdone
pl.Float16todo
pl.Float32dtype.Float32done
pl.Float64dtype.Float64done
pl.Int128todo
pl.Int16dtype.Int16done
pl.Int32dtype.Int32done
pl.Int64dtype.Int64done
pl.Int8dtype.Int8done
pl.Listdtype.Listdone
pl.Nulldtype.Nulldone
pl.Stringdtype.Stringdone
pl.Structdtype.Structdone
pl.Timedtype.Timedone
pl.UInt128todo
pl.UInt16dtype.Uint16done
pl.UInt32dtype.Uint32done
pl.UInt64dtype.Uint64done
pl.UInt8dtype.Uint8done
pl.Utf8dtype.Stringdone

Top-level functions

pl.* functions against the root golars package, then expr, dataframe, lazy, series and the io/* packages.

polarsgolarsStatusNotes
pl.align_framestodo
pl.allgolars.Alldone
pl.all_horizontalgolars.AllHorizontaldone
pl.anygolars.Anydone
pl.any_horizontalgolars.AnyHorizontaldone
pl.approx_n_uniquegolars.ApproxNUniquedone
pl.arangegolars.IntRangedone
pl.arctan2golars.Arctan2done
pl.arg_sort_bygolars.ArgSortBydone
pl.arg_wheregolars.ArgWheredone
pl.business_day_counttodo
pl.coalescegolars.Coalescedone
pl.concatgolars.Concatdone
pl.concat_arrgolars.ConcatArrdone
pl.concat_listgolars.ConcatListdone
pl.concat_strgolars.ConcatStrdone
pl.countgolars.Countdone
pl.covgolars.Covdone
pl.cum_countexpr.Expr.CumCountpartialmethod only: Col(x).CumCount()
pl.cum_foldgolars.CumFolddone
pl.cum_reducegolars.CumReducedone
pl.cum_sumgolars.CumSumHorizontalpartialhorizontal form; for one column use Col(x).CumSum()
pl.cum_sum_horizontalgolars.CumSumHorizontaldone
pl.dategolars.Datedone
pl.date_rangegolars.DateRangedone
pl.date_rangestodo
pl.datetimegolars.Datetimedone
pl.datetime_rangegolars.DatetimeRangedone
pl.datetime_rangestodo
pl.dtype_oftodo
pl.durationgolars.Durationdone
pl.elementgolars.Elementdone
pl.escape_regexexpr.StrOps.EscapeRegexdone
pl.excludegolars.Excludedone
pl.explain_alltodo
pl.fieldgolars.Fielddone
pl.firstgolars.Firstdone
pl.foldgolars.Folddone
pl.formatgolars.Formatdone
pl.from_arrowdataframe.FromArrowTabledone
pl.from_dataframelazy.FromDataFramedone
pl.from_dictgolars.FromMapdone
pl.from_dictsdataframe.DataFrame.ToDictspartialreverse direction only; build frames with FromMap
pl.from_epochtodo
pl.from_recordsdataframe.FromRecordpartialtakes an arrow RecordBatch, not Python rows
pl.from_reprtodo
pl.headgolars.Headdone
pl.implodeexpr.Expr.Implodepartialmethod only: Col(x).Implode()
pl.int_rangegolars.IntRangedone
pl.int_rangesgolars.IntRangesdone
pl.json_normalizetodo
pl.lastgolars.Lastdone
pl.lengolars.Lendone
pl.linear_spacegolars.LinearSpacedone
pl.linear_spacestodo
pl.litgolars.Litdone
pl.maxgolars.Maxdone
pl.max_horizontalgolars.MaxHorizontaldone
pl.meangolars.Meandone
pl.mean_horizontalgolars.MeanHorizontaldone
pl.mediangolars.Mediandone
pl.mingolars.Mindone
pl.min_horizontalgolars.MinHorizontaldone
pl.n_uniquegolars.NUniquedone
pl.nthgolars.Nthdone
pl.onesgolars.Onesdone
pl.quantilegolars.Quantiledone
pl.read_avrotodo
pl.read_clipboardclipboard.Readdone
pl.read_databasesql.ReadSQLdone
pl.read_database_uritodo
pl.read_deltatodo
pl.read_exceltodo
pl.read_ipcgolars.ReadIPCdone
pl.read_ipc_schematodo
pl.read_ipc_streamgolars.NewIPCStreamReaderdone
pl.read_jsongolars.ReadJSONdone
pl.read_linestodo
pl.read_odstodo
pl.read_parquet_schemaparquet.ReadSchemadone
pl.reducegolars.Reducedone
pl.repeatgolars.Repeatdone
pl.rolling_corrgolars.RollingCorrdone
pl.rolling_covgolars.RollingCovdone
pl.row_indexdataframe.DataFrame.WithRowIndexpartialframe method only: df.WithRowIndex / lf.WithRowIndex
pl.scan_deltatodo
pl.scan_icebergtodo
pl.scan_linestodo
pl.selectgolars.Selectdone
pl.self_dtypetodo
pl.sqlgolars.SQLdone
pl.sql_exprtodo
pl.stdgolars.Stddone
pl.structgolars.Structdone
pl.struct_with_fieldstodo
pl.sumgolars.Sumdone
pl.sum_horizontalgolars.SumHorizontaldone
pl.tailgolars.Taildone
pl.timeexpr.LitTimepartialliteral only; no expression-built time
pl.time_rangegolars.TimeRangedone
pl.time_rangestodo
pl.uniongolars.Concatpartialvertical concat; polars union does not keep order
pl.vargolars.Vardone
pl.whengolars.Whendone
pl.zerosgolars.Zerosdone

Intentional differences

These are deliberate, checked against polars 1.39.3 and the golars source. Most of them are "same as polars" confirmations for behaviour people often ask about.

  • Null order in sorts matches polars. Nulls sort first by default, in both ascending and descending order (nulls_last=False in polars). compute.NullsFirst is the zero value of compute.NullPosition; pass NullsLast to flip it.
  • NaN order matches polars. NaN sorts as the largest float: last when ascending, first when descending. min and max skip NaN unless every non-null value is NaN.
  • Integer / in expressions is true division, like polars. It returns f64 and x / 0 gives inf or NaN. FloorDiv keeps integer semantics. The low-level kernel compute.Div on two integer Series is different: it stays integer and a zero divisor gives null.
  • Counts are u32, like polars. count, len, n_unique, null_count, arg_*, group sizes and boolean sums come back as u32.
  • Eager scalar aggregations return Go values. Series.Sum, Mean, Min, Max, Std and Median return (float64, error). An empty or all-null input returns NaN where polars returns None. The expression forms (Col(x).Sum()) keep the input dtype and return null like polars.
  • Errors instead of exceptions. Eager operations take a context.Context and return error. The public API does not panic.
  • Expression entry points on DataFrame. df.Select takes column names and df.WithColumns takes Series. Use golars.SelectExpr and golars.WithColumnsExpr, or a LazyFrame, for expressions.
  • Hash values differ. hash and hash_rows are stable within golars but do not reproduce polars' hash values.
  • No global string cache. Categoricals carry their own dictionary, so enable_string_cache and cat.to_local have nothing to do.
  • Group order. Without MaintainOrder, the output order of group_by is an implementation detail, as in polars. With it, groups come out in first-appearance order.

Known gaps

Every todo row from the tables above, grouped by surface.

  • Expr: append, ewm_mean_by, rolling, rolling_rank_by, truncate
  • Expr.str: normalize, to_decimal
  • Expr.dt: base_utc_offset, dst_offset
  • Expr.list: agg
  • Expr.arr: agg, eval
  • DataFrame: drop_in_place, flags, interpolate, remove, set_sorted, write_avro, write_database, write_excel, write_iceberg
  • LazyFrame: interpolate, remove, set_sorted, show, sink_delta, sink_iceberg
  • GroupBy: having
  • LazyGroupBy: having
  • Series: cumulative_eval, estimated_size, ewm_mean_by, flags, is_in, is_not_nan, rolling_rank_by, set_sorted, sql, to_dummies, truncate
  • Series.str: normalize, to_decimal
  • Series.dt: base_utc_offset, dst_offset, max, min
  • Series.list: agg, eval
  • Series.arr: agg, eval
  • Series.struct: schema
  • Data types: Decimal, Float16, Int128, UInt128
  • Top-level functions: align_frames, business_day_count, date_ranges, datetime_ranges, dtype_of, explain_all, from_epoch, from_repr, json_normalize, linear_spaces, read_avro, read_database_uri, read_delta, read_excel, read_ipc_schema, read_lines, read_ods, scan_delta, scan_iceberg, scan_lines, self_dtype, sql_expr, struct_with_fields, time_ranges

Partial rows, where golars covers a narrower form:

  • meta: package functions, not a namespace: OutputName, ReferencedColumns, IsMultiColumn, Equal
  • df.join: keys are column names (WithJoinKeys for left_on/right_on), not expressions
  • df.select: takes column names; use golars.SelectExpr for expressions
  • df.with_columns: takes Series; use golars.WithColumnsExpr for expressions
  • lf.join: keys are column names (WithJoinKeys for left_on/right_on), not expressions
  • pl.cum_count: method only: Col(x).CumCount()
  • pl.cum_sum: horizontal form; for one column use Col(x).CumSum()
  • pl.from_dicts: reverse direction only; build frames with FromMap
  • pl.from_records: takes an arrow RecordBatch, not Python rows
  • pl.implode: method only: Col(x).Implode()
  • pl.row_index: frame method only: df.WithRowIndex / lf.WithRowIndex
  • pl.time: literal only; no expression-built time
  • pl.union: vertical concat; polars union does not keep order

Not applicable

Excluded from the totals because they only make sense in Python.

SurfacepolarsReason
ExprdeserializePython plan serialization format
Exprextunstable extension-type API
ExprinspectPython print debugging
DataFramedf.deserializePython plan serialization format
DataFramedf.map_columnsPython UDF
DataFramedf.plotPython plotting backend
DataFramedf.serializePython plan serialization format
DataFramedf.shrink_to_fitmemory tuning hint; arrow buffers are sized on build
DataFramedf.stylePython great_tables styling
DataFramedf.to_init_reprPython repr round-trip
DataFramedf.to_jaxno jax in Go
DataFramedf.to_pandasno pandas in Go
DataFramedf.to_torchno torch in Go
LazyFramelf.deserializePython plan serialization format
LazyFramelf.lazyidentity on a LazyFrame
LazyFramelf.pipe_with_schemaPython callable chaining
LazyFramelf.remotePolars Cloud
LazyFramelf.serializePython plan serialization format
LazyFramelf.sink_batchesPython callback per batch
Seriess.extunstable extension-type API
Seriess.map_elementsPython UDF
Seriess.plotPython plotting backend
Seriess.shrink_to_fitmemory tuning hint; arrow buffers are sized on build
Seriess.to_init_reprPython repr round-trip
Seriess.to_jaxno jax in Go
Seriess.to_pandasno pandas in Go
Seriess.to_torchno torch in Go
Series.cats.cat.to_localgolars has no global string cache
Data typespl.BaseExtensionunstable extension-type API
Data typespl.Extensionunstable extension-type API
Data typespl.Objectpolars escape hatch for Python objects
Data typespl.Unknownpolars-internal placeholder
Top-level functionspl.build_infoPython build metadata
Top-level functionspl.collect_all_asyncPython asyncio
Top-level functionspl.deferPython callable source
Top-level functionspl.disable_string_cachegolars has no global string cache
Top-level functionspl.enable_string_cachegolars has no global string cache
Top-level functionspl.from_numpyno numpy in Go
Top-level functionspl.from_pandasno pandas in Go
Top-level functionspl.from_torchno torch in Go
Top-level functionspl.get_extension_typeunstable extension-type API
Top-level functionspl.get_index_typegolars indices are Go int; counts are u32 like polars
Top-level functionspl.map_batchesPython UDF
Top-level functionspl.map_groupsPython UDF
Top-level functionspl.register_extension_typeunstable extension-type API
Top-level functionspl.scan_pyarrow_datasetpyarrow-specific
Top-level functionspl.set_random_seedgolars sampling takes an explicit seed argument
Top-level functionspl.show_versionsPython environment report
Top-level functionspl.thread_pool_sizeGo runtime schedules goroutines; see compute.WithParallelism
Top-level functionspl.unregister_extension_typeunstable extension-type API
Top-level functionspl.using_string_cachegolars has no global string cache
Top-level functionspl.wrap_dfinternal Python helper
Top-level functionspl.wrap_sinternal Python helper

See roadmap.md for the perf side of the same picture (throughput ratios vs polars 1.39 on the bench suite).

On this page