tf.ragged.constant
Constructs a constant RaggedTensor from a nested Python list.
tf.ragged.constant(
pylist, dtype=None, ragged_rank=None, inner_shape=None, name=None,
row_splits_dtype=tf.dtypes.int64
)
Example:
tf.ragged.constant([[1, 2], [3], [4, 5, 6]])
<tf.RaggedTensor [[1, 2], [3], [4, 5, 6]]>
All scalar values in pylist must have the same nesting depth K, and the returned RaggedTensor will have rank K. If pylist contains no scalar values, then K is one greater than the maximum depth of empty lists in pylist. All scalar values in pylist must be compatible with dtype.
| Args | |
|---|---|
pylist |
A nested list, tuple or np.ndarray. Any nested element that is not a list, tuple or np.ndarray must be a scalar value compatible with dtype. |
dtype |
The type of elements for the returned RaggedTensor. If not specified, then a default is chosen based on the scalar values in pylist. |
ragged_rank |
An integer specifying the ragged rank of the returned RaggedTensor. Must be nonnegative and less than K. Defaults to max(0, K - 1) if inner_shape is not specified. Defaults to max(0, K - 1 - len(inner_shape)) if inner_shape is specified. |
inner_shape |
A tuple of integers specifying the shape for individual inner values in the returned RaggedTensor. Defaults to () if ragged_rank is not specified. If ragged_rank is specified, then a default is chosen based on the contents of pylist. |
name |
A name prefix for the returned tensor (optional). |
row_splits_dtype |
data type for the constructed RaggedTensor's row_splits. One of tf.int32 or tf.int64. |
| Returns | |
|---|---|
A potentially ragged tensor with rank K and the specified ragged_rank, containing the values from pylist. |
| Raises | |
|---|---|
ValueError |
If the scalar values in pylist have inconsistent nesting depth; or if ragged_rank or inner_shape are incompatible with pylist. |
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/ragged/constant