mindspore.ops.Morph
==============================

.. py:class:: mindspore.ops.Morph(fn, infer_shape, infer_dtype)

    `Morph` 算子用于对用户自定义函数 `fn` 进行封装，允许其被当做自定义算子使用。

    `Morph` 算子主要适用于静态图自定义图优化场景。例如：分布式自动并行场景可以使用Morph封装非规整集合通信（如 :func:`mindspore.ops.AlltoAllV`）。

    `Morph` 算子作用于输入时，实际上是其内封装的自定义函数 `fn` 作用于输入。

    `Morph` 算子与 :func:`mindspore.ops.Custom` 的主要区别在于，前者会在自动微分前被展开替换为用户自定义 `fn`，故无需实现反向函数。

    .. note::
        - 本算子只支持图模式。
        - `fn` 必须满足图模式语法约束。
        - 用户无需实现自定义反向函数。
        - 用户自定义函数不支持 `vararg`、`kwarg`、`kwonlyargs` 和自由变量。

    参数：
        - **fn** (Function) - MindSpore Function，用户自定义函数。
        - **infer_shape** (Function) - Mindspore Function，用户自定义 `infer_shape` 函数。
        - **infer_dtype** (Function) - Mindspore Function，用户自定义 `infer_dtype` 函数。

    输入：
        用户自定义 `fn` 的输入。

    输出：
        用户自定义 `fn` 的输出。

    异常：
        - **RuntimeError** - 如果算子在非图模式下被使用。