maxframe 2.4.0rc1__cp312-cp312-win32.whl

maxframe/core/entity/tileables.py

@@ -0,0 +1,376 @@
+# Copyright 1999-2025 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import builtins
+import itertools
+from operator import attrgetter
+from weakref import WeakKeyDictionary, WeakSet
+
+import numpy as np
+
+from ...serialization.serializables import BoolField, FieldTypes, TupleField
+from ...typing_ import TileableType
+from ...utils import on_deserialize_shape, on_serialize_nsplits, on_serialize_shape
+from ..base import Base
+from ..mode import enter_mode
+from .core import Entity, EntityData
+from .executable import _ExecutableMixin
+
+
+class NotSupportTile(Exception):
+    pass
+
+
+class _ChunksIndexer:
+    __slots__ = ("_tileable",)
+
+    def __init__(self, tileable):
+        self._tileable = tileable
+
+    def __getitem__(self, item):
+        """
+        The indices for `cix` can be [x, y] or [x, :].
+        For the former the result will be a single chunk,
+        and for the later the result will be a list of chunks (flattened).
+
+        The length of indices must be the same with `chunk_shape` of tileable.
+        """
+        if isinstance(item, int):
+            item = (item,)
+        if isinstance(item, tuple):
+            if len(item) == 0 and self._tileable.is_scalar():
+                return self._tileable.chunks[0]
+            if len(item) != self._tileable.ndim:
+                raise ValueError(
+                    f"Cannot get chunk by {item}, "
+                    f"expect length {self._tileable.ndim}"
+                )
+            slices, singleton = [], True
+            for it, dim in zip(item, self._tileable.chunk_shape):
+                if isinstance(it, slice):
+                    slices.append(range(dim)[it])
+                    singleton = False
+                elif np.issubdtype(type(it), np.integer):
+                    slices.append([it if it >= 0 else dim + it])
+                else:
+                    raise TypeError(
+                        f"Cannot get chunk by {it}, "
+                        f"invalid value has type {type(it)}"
+                    )
+
+            indexes = tuple(zip(*itertools.product(*slices)))
+
+            try:
+                flat_index = np.ravel_multi_index(indexes, self._tileable.chunk_shape)
+            except ValueError as ex:  # pragma: no cover
+                raise ValueError(
+                    f"Cannot get index {indexes} from chunk shape "
+                    f"{self._tileable.chunk_shape}: {ex}"
+                ) from None
+
+            if singleton:
+                return self._tileable._chunks[flat_index[0]]
+            else:
+                return [self._tileable._chunks[idx] for idx in flat_index]
+
+        raise ValueError(f"Cannot get {type(self._tileable).__name__} chunk by {item}")
+
+
+class EntityDataModificationHandler:
+    def __init__(self):
+        self._data_to_entities = WeakKeyDictionary()
+
+    def _add_observer(self, data, entity):
+        # only tileable data should be considered
+        assert isinstance(data, TileableData)
+        assert isinstance(entity, Tileable)
+
+        if data not in self._data_to_entities:
+            self._data_to_entities[data] = WeakSet()
+
+        self._data_to_entities[data].add(entity)
+
+    @enter_mode(build=True)
+    def add_observer(self, data, entity):
+        self._add_observer(data, entity)
+
+    def _update_observe_data(self, observer, data, new_data):
+        self._data_to_entities.get(data, set()).discard(observer)
+        self._add_observer(new_data, observer)
+
+    @staticmethod
+    def _set_data(entity, data):
+        entity._data.detach(entity)
+        entity._data = data
+        data.attach(entity)
+
+    @staticmethod
+    def _get_data(obj):
+        return obj.data if isinstance(obj, Entity) else obj
+
+    @enter_mode(build=True)
+    def data_changed(self, old_data, new_data):
+        notified = set()
+        processed_data = set()
+        old_to_new = {old_data: new_data}
+        q = [old_data]
+        while len(q) > 0:
+            data = q.pop()
+
+            # handle entities
+            for entity in data.entities:
+                self._set_data(entity, old_to_new[data])
+                notified.add(entity)
+
+            observers = {
+                ob
+                for ob in self._data_to_entities.pop(data, set())
+                if ob not in notified
+            }
+            for ob in observers:
+                new_data = self._get_data(ob.op.on_input_modify(old_to_new[data]))
+                old_data = ob.data
+                self._update_observe_data(ob, ob.data, new_data)
+                old_to_new[old_data] = new_data
+                if old_data not in processed_data:
+                    q.append(old_data)
+                    processed_data.add(old_data)
+                notified.add(ob)
+
+            if data.op.create_view:
+                old_input_data = data.inputs[0]
+                new_input_data = self._get_data(
+                    data.op.on_output_modify(old_to_new[data])
+                )
+                old_to_new[old_input_data] = new_input_data
+                if old_input_data not in processed_data:
+                    q.append(old_input_data)
+                    processed_data.add(old_input_data)
+
+
+entity_view_handler = EntityDataModificationHandler()
+
+
+class TileableData(EntityData, _ExecutableMixin):
+    __slots__ = "_chunks", "_cix", "_entities", "_executed_sessions"
+    _no_copy_attrs_ = Base._no_copy_attrs_ | {"_cix"}
+
+    # optional fields
+    # `nsplits` means the sizes of chunks for each dimension
+    _nsplits = TupleField(
+        "nsplits",
+        FieldTypes.tuple(FieldTypes.tuple(FieldTypes.uint64)),
+        on_serialize=on_serialize_nsplits,
+    )
+    # cache tileable data, if true, this data will be materialized
+    cache = BoolField("cache", default=False)
+
+    def __init__(self: TileableType, *args, **kwargs):
+        if kwargs.get("chunks") is not None:
+            self._chunks = kwargs.pop("chunks")
+        if "nsplits" in kwargs:
+            kwargs["_nsplits"] = kwargs.pop("nsplits")
+        if kwargs.get("_nsplits", None) is not None:
+            kwargs["_nsplits"] = tuple(tuple(s) for s in kwargs["_nsplits"])
+
+        super().__init__(*args, **kwargs)
+
+        try:
+            chunks = self._chunks
+            if chunks:
+                self._chunks = sorted(chunks, key=attrgetter("index"))
+        except AttributeError:  # pragma: no cover
+            pass
+        self._entities = WeakSet()
+        self._executed_sessions = []
+
+    def __on_deserialize__(self):
+        super(TileableData, self).__on_deserialize__()
+        self._entities = WeakSet()
+        self._executed_sessions = []
+
+    @property
+    def chunk_shape(self):
+        if hasattr(self, "_nsplits") and self._nsplits is not None:
+            return tuple(map(len, self._nsplits))
+
+    @property
+    def chunks(self) -> list:
+        return getattr(self, "_chunks", None) or self._extra_params.get("_chunks")
+
+    @property
+    def nsplits(self):
+        return getattr(self, "_nsplits", None)
+
+    @nsplits.setter
+    def nsplits(self, new_nsplits):
+        self._nsplits = new_nsplits
+
+    @property
+    def params(self) -> dict:
+        # params return the properties which useful to rebuild a new tileable object
+        return dict()
+
+    @property
+    def cix(self):
+        if self.ndim == 0:
+            return _ChunksIndexer(self)
+
+        try:
+            if getattr(self, "_cix", None) is None:
+                self._cix = _ChunksIndexer(self)
+            return self._cix
+        except (TypeError, ValueError):
+            return _ChunksIndexer(self)
+
+    @property
+    def entities(self):
+        return self._entities
+
+    def is_coarse(self):
+        if not hasattr(self, "_chunks"):
+            return True
+        if not self._chunks:
+            return True
+        return False
+
+    def attach(self, entity):
+        self._entities.add(entity)
+
+    def detach(self, entity):
+        self._entities.discard(entity)
+
+
+class Tileable(Entity):
+    def __init__(self, data: TileableType = None, **kw):
+        super().__init__(data=data, **kw)
+        data = self._data
+        if data is not None:
+            data.attach(self)
+            if data.op.create_view:
+                entity_view_handler.add_observer(data.inputs[0], self)
+
+    def __copy__(self):
+        return self._view()
+
+    def _view(self):
+        return super().copy()
+
+    def copy(self: TileableType) -> TileableType:
+        new_op = self.op.copy()
+        if new_op.create_view:
+            # if the operator is a view, make it a copy
+            new_op.create_view = False
+        params = []
+        for o in self.op.outputs:
+            param = o.params
+            param["_key"] = o.key
+            param.update(o.extra_params)
+            params.append(param)
+        new_outs = new_op.new_tileables(
+            self.op.inputs, kws=params, output_limit=len(params)
+        )
+        pos = -1
+        for i, out in enumerate(self.op.outputs):
+            # create a ref to copied one
+            new_out = new_outs[i]
+            if not hasattr(new_out.data, "_siblings"):
+                new_out.data._siblings = []
+            new_out.data._siblings.append(out)
+
+            if self._data is out:
+                pos = i
+                break
+        assert pos >= 0
+        return new_outs[pos]
+
+    @Entity.data.setter
+    def data(self, new_data):
+        self._check_data(new_data)
+        if self._data is None:
+            self._data = new_data
+            self._data.attach(self)
+        else:
+            entity_view_handler.data_changed(self._data, new_data)
+
+
+TILEABLE_TYPE = (Tileable, TileableData)
+
+
+class HasShapeTileableData(TileableData):
+    # required fields
+    _shape = TupleField(
+        "shape",
+        FieldTypes.int64,
+        on_serialize=on_serialize_shape,
+        on_deserialize=on_deserialize_shape,
+    )
+
+    @property
+    def ndim(self):
+        return len(self.shape) if self.shape is not None else np.nan
+
+    def __len__(self):
+        try:
+            return int(self.shape[0])
+        except (IndexError, ValueError):  # pragma: no cover
+            if len(self.shape) == 0:
+                raise TypeError("len() of unsized object") from None
+            return 0
+
+    @property
+    def shape(self):
+        if hasattr(self, "_shape") and self._shape is not None:
+            return self._shape
+        if hasattr(self, "_nsplits") and self._nsplits is not None:
+            self._shape = tuple(builtins.sum(nsplit) for nsplit in self._nsplits)
+            return self._shape
+
+    def _update_shape(self, new_shape):
+        self._shape = new_shape
+
+    @property
+    def size(self):
+        return np.prod(self.shape).item()
+
+    @property
+    def params(self):
+        # params return the properties which useful to rebuild a new tileable object
+        return {"shape": self.shape}
+
+    def _equals(self, o):
+        return self is o
+
+
+class HasShapeTileable(Tileable):
+    __slots__ = ()
+
+    @property
+    def shape(self):
+        return self._data.shape
+
+    @property
+    def ndim(self):
+        return self._data.ndim
+
+    @property
+    def size(self):
+        return self._data.size
+
+    def execute(self, session=None, **kw):
+        result = self.data.execute(session=session, **kw)
+        if isinstance(result, TILEABLE_TYPE):
+            return self
+        else:
+            return result

maxframe/core/entity/utils.py

@@ -0,0 +1,39 @@
+# Copyright 1999-2025 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import numpy as np
+
+from ...typing_ import TileableType
+from ...utils import calc_nsplits, has_unknown_shape
+
+
+def refresh_tileable_shape(tileable):
+    if has_unknown_shape(tileable):
+        # update shape
+        nsplits = calc_nsplits({c.index: c.shape for c in tileable.chunks})
+        shape = tuple(sum(ns) for ns in nsplits)
+        tileable._nsplits = nsplits
+        tileable._shape = shape
+
+
+def fill_chunk_slices(tileable: TileableType) -> None:
+    if tileable is None or not tileable.nsplits or not tileable.chunks:
+        # errors may occurred
+        return
+    acc_splits = tuple((0,) + tuple(np.cumsum(sp)) for sp in tileable.nsplits)
+    for chunk in tileable.chunks:
+        chunk.slices = list(
+            (acc_splits[i][chunk.index[i]], acc_splits[i][chunk.index[i] + 1])
+            for i in range(tileable.ndim)
+        )

maxframe/core/graph/__init__.py

@@ -0,0 +1,22 @@
+# Copyright 1999-2025 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .builder import TileableGraphBuilder
+from .core import DAG, DirectedGraph, GraphContainsCycleError
+from .entity import EntityGraph, GraphSerializer, SerializableGraph, TileableGraph
+
+try:
+    from ._internal import SubDAG
+except ImportError:  # pragma: no cover
+    pass

maxframe/core/graph/builder/__init__.py

@@ -0,0 +1,15 @@
+# Copyright 1999-2025 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .tileable import TileableGraphBuilder

maxframe/core/graph/builder/base.py

@@ -0,0 +1,90 @@
+# Copyright 1999-2025 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from abc import ABC, abstractmethod
+from typing import Generator, List, Set
+
+from ....typing_ import EntityType
+from ..entity import EntityGraph
+
+
+def _default_inputs_selector(inputs: List[EntityType]) -> List[EntityType]:
+    return inputs
+
+
+class AbstractGraphBuilder(ABC):
+    _graph: EntityGraph
+
+    def __init__(self, graph: EntityGraph):
+        self._graph = graph
+
+    def _process_node(self, entity: EntityType):
+        return entity
+
+    def _select_inputs(self, inputs: List[EntityType]):
+        return inputs
+
+    def _if_add_node(
+        self, node: EntityType, visited: Set
+    ):  # pylint: disable=no-self-use
+        return node not in visited
+
+    @classmethod
+    def _get_node_outputs(cls, node: EntityType):
+        return node.op.outputs
+
+    def _add_nodes(
+        self,
+        graph: EntityGraph,
+        nodes: List[EntityType],
+        visited: Set,
+    ):
+        # update visited
+        visited.update(nodes)
+
+        while len(nodes) > 0:
+            node = nodes.pop()
+            node = self._process_node(node)
+
+            # mark node as visited
+            visited.add(node)
+
+            # add node to graph if possible
+            if not graph.contains(node):
+                graph.add_node(node)
+
+            children = self._select_inputs(node.inputs or [])
+            if children:
+                node.inputs = children
+            for c in children:
+                c = self._process_node(c)
+                if not graph.contains(c):
+                    graph.add_node(c)
+                if not graph.has_successor(c, node):
+                    graph.add_edge(c, node)
+                for out in self._get_node_outputs(c):
+                    if self._if_add_node(out, visited):
+                        nodes.append(out)
+
+    @abstractmethod
+    def build(self) -> Generator[EntityGraph, None, None]:
+        """
+        Build a entity graph.
+
+        Returns
+        -------
+        graph : EntityGraph
+            Entity graph.
+        """
+        raise NotImplementedError

maxframe/core/graph/builder/tileable.py

@@ -0,0 +1,34 @@
+# Copyright 1999-2025 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Generator
+
+from ...mode import enter_mode
+from ..entity import TileableGraph
+from .base import AbstractGraphBuilder
+
+
+class TileableGraphBuilder(AbstractGraphBuilder):
+    _graph: TileableGraph
+
+    def __init__(self, graph: TileableGraph):
+        super().__init__(graph=graph)
+
+    @enter_mode(build=True, kernel=True)
+    def _build(self) -> TileableGraph:
+        self._add_nodes(self._graph, list(self._graph.result_tileables), set())
+        return self._graph
+
+    def build(self) -> Generator[TileableGraph, None, None]:
+        yield self._build()

maxframe/core/graph/builder/utils.py

@@ -0,0 +1,37 @@
+# Copyright 1999-2025 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import itertools
+from typing import List
+
+from ....typing_ import TileableType
+from ...mode import enter_mode
+from ..entity import EntityGraph, TileableGraph
+from .tileable import TileableGraphBuilder
+
+
+@enter_mode(kernel=True)
+def build_graph(
+    tileables: List[TileableType],
+    tile: bool = False,
+    fuse_enabled: bool = True,
+    **chunk_graph_build_kwargs
+) -> EntityGraph:
+    tileables = list(itertools.chain(*(tileable.op.outputs for tileable in tileables)))
+    tileable_graph = TileableGraph(tileables)
+    tileable_graph_builder = TileableGraphBuilder(tileable_graph)
+    tileable_graph = next(tileable_graph_builder.build())
+    if not tile:
+        return tileable_graph
+    raise NotImplementedError