Skip to content

contrib.util.md

Latest commit

 

History

History
85 lines (49 loc) · 2.32 KB

contrib.util.md

File metadata and controls

85 lines (49 loc) · 2.32 KB

Utilities (contrib)

[TOC]

Utilities for dealing with Tensors.

Miscellaneous Utility Functions

tf.contrib.util.constant_value(tensor) {#constant_value}

Returns the constant value of the given tensor, if efficiently calculable.

This function attempts to partially evaluate the given tensor, and returns its value as a numpy ndarray if this succeeds.

TODO(mrry): Consider whether this function should use a registration mechanism like gradients and ShapeFunctions, so that it is easily extensible.

Args:
  • tensor: The Tensor to be evaluated.
Returns:

A numpy ndarray containing the constant value of the given tensor, or None if it cannot be calculated.

Raises:
  • TypeError: if tensor is not an ops.Tensor.

tf.contrib.util.make_tensor_proto(values, dtype=None, shape=None) {#make_tensor_proto}

Create a TensorProto.

Args:
  • values: Values to put in the TensorProto.
  • dtype: Optional tensor_pb2 DataType value.
  • shape: List of integers representing the dimensions of tensor.
Returns:

A TensorProto. Depending on the type, it may contain data in the "tensor_content" attribute, which is not directly useful to Python programs. To access the values you should convert the proto back to a numpy ndarray with tensor_util.MakeNdarray(proto).

Raises:
  • TypeError: if unsupported types are provided.
  • ValueError: if arguments have inappropriate values.

make_tensor_proto accepts "values" of a python scalar, a python list, a numpy ndarray, or a numpy scalar.

If "values" is a python scalar or a python list, make_tensor_proto first convert it to numpy ndarray. If dtype is None, the conversion tries its best to infer the right numpy data type. Otherwise, the resulting numpy array has a compatible data type with the given dtype.

In either case above, the numpy ndarray (either the caller provided or the auto converted) must have the compatible type with dtype.

make_tensor_proto then converts the numpy array to a tensor proto.

If "shape" is None, the resulting tensor proto represents the numpy array precisely.

Otherwise, "shape" specifies the tensor's shape and the numpy array can not have more elements than what "shape" specifies.