File: C:/Users/fred/anaconda3/Lib/site-packages/dask_expr/_repartition.py
import functools
from collections.abc import Callable
from operator import getitem
from pprint import pformat
import numpy as np
import pandas as pd
from dask.base import tokenize
from dask.dataframe import methods
from dask.dataframe.core import _concat, _map_freq_to_period_start, split_evenly
from dask.dataframe.utils import is_series_like
from dask.utils import iter_chunks, parse_bytes
from pandas.api.types import is_datetime64_any_dtype, is_numeric_dtype
from tlz import unique
from dask_expr._expr import Expr, Filter, Projection, plain_column_projection
from dask_expr._reductions import TotalMemoryUsageFrame
from dask_expr._util import LRU
class Repartition(Expr):
"""Abstract repartitioning expression"""
_parameters = [
"frame",
"new_partitions",
"new_divisions",
"force",
"partition_size",
]
_defaults = {
"new_partitions": None,
"new_divisions": None,
"force": False,
"partition_size": None,
}
_is_length_preserving = True
_filter_passthrough = True
@functools.cached_property
def _meta(self):
return self.frame._meta
def _divisions(self):
if (
self.operand("new_partitions") is not None
or self.partition_size is not None
):
x = self.optimize(fuse=False)
return x._divisions()
return self.new_divisions
@property
def npartitions(self):
if (
"new_partitions" in self._parameters
and self.operand("new_partitions") is not None
):
new_partitions = self.operand("new_partitions")
if isinstance(new_partitions, Callable):
return new_partitions(self.frame.npartitions)
return new_partitions
return super().npartitions
@functools.cached_property
def unique_partition_mapping_columns_from_shuffle(self):
if (
"new_partitions" in self._parameters
and self.operand("new_partitions") is not None
and self.npartitions <= self.frame.npartitions
):
return self.frame.unique_partition_mapping_columns_from_shuffle
else:
return set()
def _lower(self):
if type(self) != Repartition:
# This lower logic should not be inherited
return None
if self.operand("new_partitions") is not None:
if self.new_partitions < self.frame.npartitions:
return RepartitionToFewer(self.frame, self.operand("new_partitions"))
elif self.new_partitions == self.frame.npartitions:
# Remove if partitions are equal
return self.frame
else:
original_divisions = divisions = pd.Series(
self.frame.divisions
).drop_duplicates()
if self.frame.known_divisions and (
is_datetime64_any_dtype(divisions.dtype)
or is_numeric_dtype(divisions.dtype)
):
npartitions = self.new_partitions
df = self.frame
if is_datetime64_any_dtype(divisions.dtype):
divisions = divisions.values.astype("float64")
if is_series_like(divisions):
divisions = divisions.values
n = len(divisions)
divisions = np.interp(
x=np.linspace(0, n, npartitions + 1),
xp=np.linspace(0, n, n),
fp=divisions,
)
if is_datetime64_any_dtype(original_divisions.dtype):
divisions = methods.tolist(
pd.Series(divisions).astype(original_divisions.dtype)
)
elif np.issubdtype(original_divisions.dtype, np.integer):
divisions = divisions.astype(original_divisions.dtype)
if isinstance(divisions, np.ndarray):
divisions = divisions.tolist()
divisions = list(divisions)
divisions[0] = df.divisions[0]
divisions[-1] = df.divisions[-1]
# Ensure the computed divisions are unique
divisions = list(unique(divisions[:-1])) + [divisions[-1]]
return RepartitionDivisions(df, divisions, self.force)
else:
return RepartitionToMore(self.frame, self.operand("new_partitions"))
elif self.new_divisions:
if tuple(self.new_divisions) == self.frame.divisions:
return self.frame
elif self.frame.divisions[0] is None:
raise ValueError(
"Cannot repartition on divisions with unknown divisions"
)
return RepartitionDivisions(self.frame, self.new_divisions, self.force)
elif self.partition_size is not None:
return RepartitionSize(self.frame, partition_size=self.partition_size)
else:
raise NotImplementedError()
def _simplify_up(self, parent, dependents):
if isinstance(parent, Filter) and self._filter_passthrough_available(
parent, dependents
):
return self._filter_simplification(parent)
if isinstance(parent, Projection):
return plain_column_projection(self, parent, dependents)
@functools.cached_property
def new_partitions(self):
return (
self.operand("new_partitions")(self.frame.npartitions)
if isinstance(self.operand("new_partitions"), Callable)
else self.operand("new_partitions")
)
class RepartitionToFewer(Repartition):
"""Reduce the partition count"""
_parameters = ["frame", "new_partitions"]
def _divisions(self):
return tuple(self.frame.divisions[i] for i in self._partitions_boundaries)
@functools.cached_property
def _partitions_boundaries(self):
npartitions = self.new_partitions
npartitions_input = self.frame.npartitions
assert npartitions_input > npartitions
npartitions_ratio = npartitions_input / npartitions
new_partitions_boundaries = [
int(new_partition_index * npartitions_ratio)
for new_partition_index in range(npartitions + 1)
]
return _clean_new_division_boundaries(
new_partitions_boundaries, self.frame.npartitions
)
def _layer(self):
new_partitions_boundaries = self._partitions_boundaries
return {
(self._name, i): (
_concat,
[(self.frame._name, j) for j in range(start, end)],
)
for i, (start, end) in enumerate(
zip(new_partitions_boundaries, new_partitions_boundaries[1:])
)
}
class RepartitionToMore(Repartition):
"""Increase the partition count"""
_parameters = ["frame", "new_partitions"]
def _divisions(self):
return (None,) * (1 + sum(self._nsplits))
@functools.cached_property
def _nsplits(self):
df = self.frame
div, mod = divmod(self.new_partitions, df.npartitions)
nsplits = [div] * df.npartitions
nsplits[-1] += mod
if len(nsplits) != df.npartitions:
raise ValueError(f"nsplits should have len={df.npartitions}")
return nsplits
def _layer(self):
dsk = {}
nsplits = self._nsplits
df = self.frame
new_name = self._name
split_name = f"split-{new_name}"
j = 0
for i, k in enumerate(nsplits):
if k == 1:
dsk[new_name, j] = (df._name, i)
j += 1
else:
dsk[split_name, i] = (split_evenly, (df._name, i), k)
for jj in range(k):
dsk[new_name, j] = (getitem, (split_name, i), jj)
j += 1
return dsk
class RepartitionDivisions(Repartition):
"""Repartition to specific divisions"""
_parameters = ["frame", "new_divisions", "force"]
_defaults = {"force": False}
def _divisions(self):
return self.new_divisions
def _layer(self):
# Simplify copy from dask.dataframe
token = self._name.split("-")[-1]
a = self.frame.divisions
b = self.new_divisions
name = self.frame._name
out1 = "repartition-split-" + token
out2 = self._name
force = self.force
if len(b) < 2:
# minimum division is 2 elements, like [0, 0]
raise ValueError("New division must be longer than 2 elements")
if force:
if a[0] < b[0]:
msg = (
"left side of the new division must be equal or smaller "
"than old division"
)
raise ValueError(msg)
if a[-1] > b[-1]:
msg = (
"right side of the new division must be equal or larger "
"than old division"
)
raise ValueError(msg)
else:
if a[0] != b[0]:
msg = "left side of old and new divisions are different"
raise ValueError(msg)
if a[-1] != b[-1]:
msg = "right side of old and new divisions are different"
raise ValueError(msg)
def _is_single_last_div(x):
"""Whether last division only contains single label"""
return len(x) >= 2 and x[-1] == x[-2]
c = [a[0]]
d = dict()
low = a[0]
i, j = 1, 1 # indices for old/new divisions
k = 0 # index for temp divisions
last_elem = _is_single_last_div(a)
# process through old division
# left part of new division can be processed in this loop
while i < len(a) and j < len(b):
if a[i] < b[j]:
# tuple is something like:
# (methods.boundary_slice, ('from_pandas-#', 0), 3, 4, False))
d[(out1, k)] = (methods.boundary_slice, (name, i - 1), low, a[i], False)
low = a[i]
i += 1
elif a[i] > b[j]:
d[(out1, k)] = (methods.boundary_slice, (name, i - 1), low, b[j], False)
low = b[j]
j += 1
else:
d[(out1, k)] = (methods.boundary_slice, (name, i - 1), low, b[j], False)
low = b[j]
if len(a) == i + 1 or a[i] < a[i + 1]:
j += 1
i += 1
c.append(low)
k += 1
# right part of new division can remain
if a[-1] < b[-1] or b[-1] == b[-2]:
for _j in range(j, len(b)):
# always use right-most of old division
# because it may contain last element
m = len(a) - 2
d[(out1, k)] = (methods.boundary_slice, (name, m), low, b[_j], False)
low = b[_j]
c.append(low)
k += 1
else:
# even if new division is processed through,
# right-most element of old division can remain
if last_elem and i < len(a):
d[(out1, k)] = (
methods.boundary_slice,
(name, i - 1),
a[i],
a[i],
False,
)
k += 1
c.append(a[-1])
# replace last element of tuple with True
d[(out1, k - 1)] = d[(out1, k - 1)][:-1] + (True,)
i, j = 0, 1
last_elem = _is_single_last_div(c)
while j < len(b):
tmp = []
while c[i] < b[j]:
tmp.append((out1, i))
i += 1
while (
last_elem
and c[i] == b[-1]
and (b[-1] != b[-2] or j == len(b) - 1)
and i < k
):
# append if last split is not included
tmp.append((out1, i))
i += 1
if len(tmp) == 0:
# dummy slice to return empty DataFrame or Series,
# which retain original data attributes (columns / name)
d[(out2, j - 1)] = (
methods.boundary_slice,
(name, 0),
a[0],
a[0],
False,
)
elif len(tmp) == 1:
d[(out2, j - 1)] = tmp[0]
else:
if not tmp:
raise ValueError(
"check for duplicate partitions\nold:\n%s\n\n"
"new:\n%s\n\ncombined:\n%s"
% (pformat(a), pformat(b), pformat(c))
)
d[(out2, j - 1)] = (methods.concat, tmp)
j += 1
return d
class RepartitionFreq(Repartition):
_parameters = ["frame", "freq"]
def _divisions(self):
freq = _map_freq_to_period_start(self.freq)
try:
start = self.frame.divisions[0].ceil(freq)
except ValueError:
start = self.frame.divisions[0]
divisions = methods.tolist(
pd.date_range(start=start, end=self.frame.divisions[-1], freq=freq)
)
if not len(divisions):
divisions = [self.frame.divisions[0], self.frame.divisions[-1]]
else:
divisions.append(self.frame.divisions[-1])
if divisions[0] != self.frame.divisions[0]:
divisions = [self.frame.divisions[0]] + divisions
return divisions
def _lower(self):
if not isinstance(self.frame.divisions[0], pd.Timestamp):
raise TypeError("Can only repartition on frequency for timeseries")
return RepartitionDivisions(self.frame, self._divisions())
class RepartitionSize(Repartition):
@functools.cached_property
def _size(self):
size = self.operand("partition_size")
if isinstance(size, str):
size = parse_bytes(size)
return int(size)
@functools.cached_property
def _nsplits(self):
return 1 + _get_mem_usages(self.frame) // self._size
@functools.cached_property
def _partition_boundaries(self):
nsplits = self._nsplits
mem_usages = _get_mem_usages(self.frame)
if np.any(nsplits > 1):
split_mem_usages = []
for n, usage in zip(nsplits, mem_usages):
split_mem_usages.extend([usage / n] * n)
mem_usages = pd.Series(split_mem_usages)
assert np.all(mem_usages <= self._size)
new_npartitions = list(map(len, iter_chunks(mem_usages, self._size)))
new_partitions_boundaries = np.cumsum(new_npartitions)
return _clean_new_division_boundaries(
new_partitions_boundaries, self.frame.npartitions
)
def _divisions(self):
if np.any(self._nsplits > 1):
return (None,) * len(self._partition_boundaries)
return (self.frame.divisions[i] for i in self._partition_boundaries)
def _layer(self) -> dict:
df = self.frame
dsk = {}
if np.any(self._nsplits > 1):
split_name = f"split-{tokenize(df, self._nsplits)}"
new_name = f"repartition-split-{self._size}-{tokenize(df)}"
j = 0
for i, k in enumerate(self._nsplits):
if k == 1:
dsk[new_name, j] = (df._name, i)
j += 1
else:
dsk[split_name, i] = (split_evenly, (df._name, i), k)
for jj in range(k):
dsk[new_name, j] = (getitem, (split_name, i), jj)
j += 1
else:
new_name = self.frame._name
dsk.update(
{
(self._name, i): (
methods.concat,
[(new_name, j) for j in range(start, end)],
)
for i, (start, end) in enumerate(
zip(self._partition_boundaries, self._partition_boundaries[1:])
)
}
)
return dsk
def _clean_new_division_boundaries(new_partitions_boundaries, frame_npartitions):
if not isinstance(new_partitions_boundaries, list):
new_partitions_boundaries = list(new_partitions_boundaries)
if new_partitions_boundaries[0] > 0:
new_partitions_boundaries.insert(0, 0)
if new_partitions_boundaries[-1] < frame_npartitions:
new_partitions_boundaries[-1] = frame_npartitions
return new_partitions_boundaries
mem_usages_lru = LRU(10)
def _get_mem_usages(frame):
if frame._name in mem_usages_lru:
return mem_usages_lru[frame._name]
result = _compute_mem_usages(frame)
mem_usages_lru[frame._name] = result
return result
def _compute_mem_usages(frame):
from dask_expr._collection import new_collection
return new_collection(TotalMemoryUsageFrame(frame, deep=True)).compute()