mindsponge.common.apply_to_point
=========================================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/r2.2/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/mindscience/blob/r0.5/MindSPONGE/docs/api/api_python/common/mindsponge.common.apply_to_point.rst
    :alt: 查看源文件


.. py:function:: mindsponge.common.apply_to_point(rotation, translation, point, extra_dims=0)

    对输入坐标进行旋转平移变换。

    .. math::
        \begin{split}
        &rot_point = rotation \cdot point \\
        &result = rot_point + translation \\
        \end{split}

    具体的乘法过程与加法过程可以参考 `mindsponge.common.rots_mul_vecs` 和 `mindsponge.common.vecs_add` API。

    参数:
        - **rotation** (Tuple) - 旋转矩阵,:math:`(xx, xy, xz, yx, yy, yz, zx, zy, zz)` ,且 :math:`xx, xy` 等均为Tensor且shape相同。
        - **translation** (Tuple) - 平移向量, :math:`[(x, y, z)]` ,其中 :math:`x, y, z` 均为Tensor,且shape相同。
        - **point** (Tensor) - 初始坐标值, :math:`[(x, y, z)]` ,其中 :math:`x, y, z` 均为Tensor,且shape相同。
        - **extra_dims** (int) - 控制进行几次维度的拓展。默认值: ``0``。

    返回:
        Tuple,转化后的坐标,长度为3。