polars.Series.estimated_size

Series.estimated_size(
    unit: SizeUnit = 'b',
) → int | float

Возвращает оценку общего размера памяти (кучи), выделенной для Series.

Оценка размера задаётся в указанных единицах (по умолчанию — в байтах).

Эта оценка представляет собой сумму размеров буферов и данных о допустимости значений, включая вложенные массивы. Несколько массивов могут совместно использовать буферы и битовые карты. Поэтому размер двух массивов не равен сумме размеров, вычисленных этой функцией. В частности, размер [StructArray] является верхней границей.

При срезе массива его выделенный размер остаётся неизменным, поскольку буфер не изменяется. Однако эта функция вернёт меньшее значение. Это связано с тем, что функция возвращает видимый размер буфера, а не его полную ёмкость.

Буферы FFI включены в эту оценку.

Параметры:

unit{‘b’, ‘kb’, ‘mb’, ‘gb’, ‘tb’}

Масштабирует возвращаемый размер до указанных единиц.

Примечания

Для данных с типом Object оценка размера учитывает только размер указателя, что значительно занижает результат.

Примеры

>>> s = pl.Series("values", list(range(1_000_000)), dtype=pl.UInt32)
>>> s.estimated_size()
4000000
>>> s.estimated_size("mb")
3.814697265625