maxframe 1.3.0__cp37-cp37m-win_amd64.whl → 2.0.0b1__cp37-cp37m-win_amd64.whl

maxframe/tensor/arithmetic/copysign.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/core.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -14,9 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from typing import List
+
 import numpy as np
 
-from ...core import ExecutableTuple
+from ...core import EntityData, ExecutableTuple
 from ...serialization.serializables import (
     AnyField,
     DictField,
@@ -84,22 +84,27 @@ class TensorBinOp(TensorOperator, TensorBinOpMixin):
     def _is_sparse(cls, x1, x2):
         return False
 
+    @classmethod
+    def _is_sparse_with_scalar(cls, scalar_val, lhs):
+        return False
+
     def _set_sparse(self, inputs):
         inputs_iter = iter(inputs)
         x1 = self.lhs if np.isscalar(self.lhs) else next(inputs_iter)
         x2 = self.rhs if np.isscalar(self.rhs) else next(inputs_iter)
         setattr(self, "sparse", self._is_sparse(x1, x2))
 
-    def _set_inputs(self, inputs):
-        super()._set_inputs(inputs)
-        inputs_iter = iter(self._inputs)
+    @classmethod
+    def _set_inputs(cls, op: "TensorBinOp", inputs: List[EntityData]):
+        super()._set_inputs(op, inputs)
+        inputs_iter = iter(op._inputs)
 
-        self.lhs = self.lhs if np.isscalar(self.lhs) else next(inputs_iter)
-        self.rhs = self.rhs if np.isscalar(self.rhs) else next(inputs_iter)
-        if getattr(self, "out", None) is not None:
-            self.out = next(inputs_iter)
-        if getattr(self, "where", None) is not None:
-            self.where = next(inputs_iter)
+        op.lhs = op.lhs if np.isscalar(op.lhs) else next(inputs_iter)
+        op.rhs = op.rhs if np.isscalar(op.rhs) else next(inputs_iter)
+        if getattr(op, "out", None) is not None:
+            op.out = next(inputs_iter)
+        if getattr(op, "where", None) is not None:
+            op.where = next(inputs_iter)
 
     def _process_inputs(self, x1, x2, out, where):
         x1 = x1 if np.isscalar(x1) else astensor(x1)
@@ -237,15 +242,16 @@ class TensorUnaryOp(TensorOperator, TensorUnaryOpMixin):
         else:
             return False
 
-    def _set_inputs(self, inputs):
-        super()._set_inputs(inputs)
-        inputs_iter = iter(self._inputs)
+    @classmethod
+    def _set_inputs(cls, op: "TensorUnaryOp", inputs: List[EntityData]):
+        super()._set_inputs(op, inputs)
+        inputs_iter = iter(op._inputs)
 
-        self._input = next(inputs_iter)
-        if getattr(self, "out", None) is not None:
-            self.out = next(inputs_iter)
-        if getattr(self, "where", None) is not None:
-            self.where = next(inputs_iter)
+        op._input = next(inputs_iter)
+        if getattr(op, "out", None) is not None:
+            op.out = next(inputs_iter)
+        if getattr(op, "where", None) is not None:
+            op.where = next(inputs_iter)
 
     def _process_inputs(self, x, out, where):
         x = astensor(x)
@@ -345,17 +351,18 @@ class TensorOutBinOp(TensorOperator, TensorElementWiseWithInputs):
     def input(self):
         return self._input
 
-    def _set_inputs(self, inputs):
-        super()._set_inputs(inputs)
-        inputs_iter = iter(self._inputs)
-
-        self._input = next(inputs_iter)
-        if getattr(self, "out1", None) is not None:
-            self.out1 = next(inputs_iter)
-        if getattr(self, "out2", None) is not None:
-            self.out2 = next(inputs_iter)
-        if getattr(self, "where", None) is not None:
-            self.where = next(inputs_iter)
+    @classmethod
+    def _set_inputs(cls, op: "TensorOutBinOp", inputs: List[EntityData]):
+        super()._set_inputs(op, inputs)
+        inputs_iter = iter(op._inputs)
+
+        op._input = next(inputs_iter)
+        if getattr(op, "out1", None) is not None:
+            op.out1 = next(inputs_iter)
+        if getattr(op, "out2", None) is not None:
+            op.out2 = next(inputs_iter)
+        if getattr(op, "where", None) is not None:
+            op.where = next(inputs_iter)
 
     def _process_inputs(self, x, out1, out2, where):
         x = astensor(x)
@@ -491,20 +498,21 @@ class TensorMultiOp(TensorElementWiseWithInputs, TensorOperator):
                 args[idx] = next(inputs_iter)
         setattr(self, "sparse", self._is_sparse(*args))
 
-    def _set_inputs(self, inputs):
-        super()._set_inputs(inputs)
+    @classmethod
+    def _set_inputs(cls, op: "TensorMultiOp", inputs: List[EntityData]):
+        super()._set_inputs(op, inputs)
         inputs_iter = iter(inputs or ())
 
-        args = list(self.args)
+        args = list(op.args)
         for idx in range(len(args)):
             if not np.isscalar(args[idx]):
                 args[idx] = next(inputs_iter)
-        self.args = args
+        op.args = args
 
-        if getattr(self, "out", None) is not None:
-            self.out = next(inputs_iter)
-        if getattr(self, "where", None) is not None:
-            self.where = next(inputs_iter)
+        if getattr(op, "out", None) is not None:
+            op.out = next(inputs_iter)
+        if getattr(op, "where", None) is not None:
+            op.where = next(inputs_iter)
 
     def _process_inputs(self, *args, out=None):
         self.args = [a if np.isscalar(a) else astensor(a) for a in args]

maxframe/tensor/arithmetic/cos.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorCos(TensorUnaryOp):
     _op_type_ = opcodes.COS
     _func_name = "cos"

maxframe/tensor/arithmetic/cosh.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/deg2rad.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/degrees.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/divide.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/equal.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/exp.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorExp(TensorUnaryOp):
     _op_type_ = opcodes.EXP
     _func_name = "exp"

maxframe/tensor/arithmetic/exp2.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/expm1.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/fabs.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/fix.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/float_power.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/floor.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/floordiv.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/fmax.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/fmin.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/fmod.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/frexp.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -31,6 +29,12 @@ class TensorFrexp(TensorOutBinOp):
     def _fun(self):
         return np.frexp
 
+    @classmethod
+    def _is_sparse(cls, x):
+        if hasattr(x, "issparse") and x.issparse():
+            return True
+        return False
+
 
 def frexp(x, out1=None, out2=None, out=None, where=None, **kwargs):
     """

maxframe/tensor/arithmetic/greater.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/greater_equal.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/hypot.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/i0.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorI0(TensorUnaryOp):
     _op_type_ = opcodes.I0
     _func_name = "i0"

maxframe/tensor/arithmetic/imag.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/invert.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorInvert(TensorUnaryOp):
     _op_type_ = opcodes.INVERT
     _func_name = "invert"

maxframe/tensor/arithmetic/isclose.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/iscomplex.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/isfinite.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorIsFinite(TensorUnaryOp):
     _op_type_ = opcodes.ISFINITE
     _func_name = "isfinite"

maxframe/tensor/arithmetic/isinf.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/isnan.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/isreal.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/ldexp.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/less.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/less_equal.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/log.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorLog(TensorUnaryOp):
     _op_type_ = opcodes.LOG
     _func_name = "log"

maxframe/tensor/arithmetic/log10.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorLog10(TensorUnaryOp):
     _op_type_ = opcodes.LOG10
     _func_name = "log10"

maxframe/tensor/arithmetic/log1p.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorLog1p(TensorUnaryOp):
     _op_type_ = opcodes.LOG1P
     _func_name = "log1p"

maxframe/tensor/arithmetic/log2.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorLog2(TensorUnaryOp):
     _op_type_ = opcodes.LOG2
     _func_name = "log2"

maxframe/tensor/arithmetic/logaddexp.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/logaddexp2.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/logical_and.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/logical_not.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +20,7 @@ from .core import TensorUnaryOp
 from .utils import arithmetic_operator
 
 
-@arithmetic_operator(sparse_mode="unary")
+@arithmetic_operator(sparse_mode="always_false")
 class TensorNot(TensorUnaryOp):
     _op_type_ = opcodes.NOT
     _func_name = "logical_not"

maxframe/tensor/arithmetic/logical_or.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/logical_xor.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/lshift.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/maximum.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/minimum.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/mod.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

maxframe/tensor/arithmetic/modf.py

@@ -1,5 +1,3 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
 # Copyright 1999-2025 Alibaba Group Holding Ltd.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -31,6 +29,12 @@ class TensorModf(TensorOutBinOp):
     def _fun(self):
         return np.modf
 
+    @classmethod
+    def _is_sparse(cls, x):
+        if hasattr(x, "issparse") and x.issparse():
+            return True
+        return False
+
 
 def modf(x, out1=None, out2=None, out=None, where=None, **kwargs):
     """