| |
| |
| ``mx.symbol.reshape_like`` |
| ==================================================== |
| |
| Description |
| ---------------------- |
| |
| Reshape some or all dimensions of `lhs` to have the same shape as some or all dimensions of `rhs`. |
| |
| Returns a **view** of the `lhs` array with a new shape without altering any data. |
| |
| |
| **Example**:: |
| |
| |
| x = [1, 2, 3, 4, 5, 6] |
| y = [[0, -4], [3, 2], [2, 2]] |
| reshape_like(x, y) = [[1, 2], [3, 4], [5, 6]] |
| |
| More precise control over how dimensions are inherited is achieved by specifying \ |
| slices over the `lhs` and `rhs` array dimensions. Only the sliced `lhs` dimensions \ |
| are reshaped to the `rhs` sliced dimensions, with the non-sliced `lhs` dimensions staying the same. |
| |
| |
| **Example**:: |
| |
| |
| - lhs shape = (30,7), rhs shape = (15,2,4), lhs_begin=0, lhs_end=1, rhs_begin=0, rhs_end=2, output shape = (15,2,7) |
| - lhs shape = (3, 5), rhs shape = (1,15,4), lhs_begin=0, lhs_end=2, rhs_begin=1, rhs_end=2, output shape = (15) |
| |
| Negative indices are supported, and `None` can be used for either `lhs_end` or `rhs_end` to indicate the end of the range. |
| |
| |
| **Example**:: |
| |
| |
| - lhs shape = (30, 12), rhs shape = (4, 2, 2, 3), lhs_begin=-1, lhs_end=None, rhs_begin=1, rhs_end=None, output shape = (30, 2, 2, 3) |
| |
| |
| |
| |
| Usage |
| ---------- |
| |
| .. code:: r |
| |
| mx.symbol.reshape_like(...) |
| |
| Arguments |
| ------------------ |
| |
| +----------------------------------------+------------------------------------------------------------+ |
| | Argument | Description | |
| +========================================+============================================================+ |
| | ``lhs`` | NDArray-or-Symbol. | |
| | | | |
| | | First input. | |
| +----------------------------------------+------------------------------------------------------------+ |
| | ``rhs`` | NDArray-or-Symbol. | |
| | | | |
| | | Second input. | |
| +----------------------------------------+------------------------------------------------------------+ |
| | ``lhs.begin`` | int or None, optional, default='None'. | |
| | | | |
| | | Defaults to 0. The beginning index along which the lhs | |
| | | dimensions are to be reshaped. Supports negative | |
| | | indices. | |
| +----------------------------------------+------------------------------------------------------------+ |
| | ``lhs.end`` | int or None, optional, default='None'. | |
| | | | |
| | | Defaults to None. The ending index along which the lhs | |
| | | dimensions are to be used for reshaping. Supports negative | |
| | | indices. | |
| +----------------------------------------+------------------------------------------------------------+ |
| | ``rhs.begin`` | int or None, optional, default='None'. | |
| | | | |
| | | Defaults to 0. The beginning index along which the rhs | |
| | | dimensions are to be used for reshaping. Supports negative | |
| | | indices. | |
| +----------------------------------------+------------------------------------------------------------+ |
| | ``rhs.end`` | int or None, optional, default='None'. | |
| | | | |
| | | Defaults to None. The ending index along which the rhs | |
| | | dimensions are to be used for reshaping. Supports negative | |
| | | indices. | |
| +----------------------------------------+------------------------------------------------------------+ |
| | ``name`` | string, optional. | |
| | | | |
| | | Name of the resulting symbol. | |
| +----------------------------------------+------------------------------------------------------------+ |
| |
| Value |
| ---------- |
| |
| ``out`` The result mx.symbol |
| |
| |
| Link to Source Code: http://github.com/apache/incubator-mxnet/blob/1.6.0/src/operator/tensor/elemwise_unary_op_basic.cc#L513 |
| |