blob: f64434ae737ac5cedd90fb107270b5f5b36330c5 [file] [log] [blame]
/* Copyright 2018 The TensorFlow Authors. All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
==============================================================================*/
#include "tensorflow/compiler/xla/service/hlo_creation_utils.h"
#include "absl/algorithm/container.h"
#include "absl/memory/memory.h"
#include "absl/strings/str_cat.h"
#include "tensorflow/compiler/xla/client/lib/comparators.h"
#include "tensorflow/compiler/xla/client/xla_builder.h"
#include "tensorflow/compiler/xla/client/xla_computation.h"
#include "tensorflow/compiler/xla/literal.h"
#include "tensorflow/compiler/xla/literal_util.h"
#include "tensorflow/compiler/xla/service/hlo_clone_context.h"
#include "tensorflow/compiler/xla/service/hlo_instruction.h"
#include "tensorflow/compiler/xla/service/hlo_module.h"
#include "tensorflow/compiler/xla/service/hlo_module_config.h"
#include "tensorflow/compiler/xla/service/shape_inference.h"
#include "tensorflow/compiler/xla/util.h"
namespace xla {
using absl::StrCat;
StatusOr<HloInstruction*> MakeBinaryHlo(HloOpcode opcode, HloInstruction* lhs,
HloInstruction* rhs) {
HloComputation* computation = lhs->parent();
CHECK_EQ(computation, rhs->parent());
TF_ASSIGN_OR_RETURN(Shape binary_op_shape,
ShapeInference::InferBinaryOpShape(opcode, lhs, rhs));
return computation->AddInstruction(
HloInstruction::CreateBinary(binary_op_shape, opcode, lhs, rhs));
}
StatusOr<HloInstruction*> MakeCompareHlo(ComparisonDirection direction,
HloInstruction* lhs,
HloInstruction* rhs) {
HloComputation* computation = lhs->parent();
CHECK_EQ(computation, rhs->parent());
TF_ASSIGN_OR_RETURN(
Shape binary_op_shape,
ShapeInference::InferBinaryOpShape(HloOpcode::kCompare, lhs, rhs));
return computation->AddInstruction(
HloInstruction::CreateCompare(binary_op_shape, lhs, rhs, direction));
}
StatusOr<HloInstruction*> MakePadHlo(HloInstruction* operand,
HloInstruction* padding_value,
const PaddingConfig& padding_config) {
HloComputation* computation = operand->parent();
CHECK_EQ(computation, padding_value->parent());
TF_ASSIGN_OR_RETURN(
Shape pad_shape,
ShapeInference::InferPadShape(operand->shape(), padding_value->shape(),
padding_config));
return computation->AddInstruction(HloInstruction::CreatePad(
pad_shape, operand, padding_value, padding_config));
}
StatusOr<HloInstruction*> MakeSliceHlo(HloInstruction* operand,
absl::Span<const int64> start_indices,
absl::Span<const int64> limit_indices,
absl::Span<const int64> strides) {
HloComputation* computation = operand->parent();
TF_ASSIGN_OR_RETURN(Shape slice_shape, ShapeInference::InferSliceShape(
operand->shape(), start_indices,
limit_indices, strides));
return computation->AddInstruction(HloInstruction::CreateSlice(
slice_shape, operand, start_indices, limit_indices, strides));
}
StatusOr<HloInstruction*> MakeConvolveHlo(
HloInstruction* lhs, HloInstruction* rhs, int64 feature_group_count,
const Window& window, const ConvolutionDimensionNumbers& dimension_numbers,
const PrecisionConfig& precision_config) {
HloComputation* computation = lhs->parent();
CHECK_EQ(computation, rhs->parent());
TF_ASSIGN_OR_RETURN(Shape convolve_shape,
ShapeInference::InferConvolveShape(
lhs->shape(), rhs->shape(), feature_group_count, 1,
window, dimension_numbers));
return computation->AddInstruction(HloInstruction::CreateConvolve(
convolve_shape, lhs, rhs, feature_group_count, 1, window,
dimension_numbers, precision_config));
}
StatusOr<HloInstruction*> MakeTransposeHlo(HloInstruction* operand,
absl::Span<const int64> dimensions) {
HloComputation* computation = operand->parent();
TF_ASSIGN_OR_RETURN(
Shape transpose_shape,
ShapeInference::InferTransposeShape(operand->shape(), dimensions));
return computation->AddInstruction(
HloInstruction::CreateTranspose(transpose_shape, operand, dimensions));
}
StatusOr<HloInstruction*> MakeReshapeHlo(const Shape& result_shape,
HloInstruction* operand) {
HloComputation* computation = operand->parent();
return computation->AddInstruction(
HloInstruction::CreateReshape(result_shape, operand));
}
StatusOr<HloInstruction*> MakeReshapeHlo(
absl::Span<const int64> result_shape_dim_bounds, HloInstruction* operand) {
Shape new_shape = ShapeUtil::MakeShape(operand->shape().element_type(),
result_shape_dim_bounds);
return MakeReshapeHlo(new_shape, operand);
}
StatusOr<HloInstruction*> MakeDynamicSliceHlo(
HloInstruction* operand, absl::Span<HloInstruction* const> start_indices,
absl::Span<const int64> slice_sizes) {
HloComputation* computation = operand->parent();
std::vector<Shape> scalar_start_indices_shapes(
start_indices.size(),
ShapeUtil::MakeShape(start_indices[0]->shape().element_type(), {}));
TF_ASSIGN_OR_RETURN(
Shape dynamic_slice_shape,
ShapeInference::InferDynamicSliceShape(
operand->shape(), scalar_start_indices_shapes, slice_sizes));
return computation->AddInstruction(HloInstruction::CreateDynamicSlice(
dynamic_slice_shape, operand, start_indices, slice_sizes));
}
StatusOr<HloInstruction*> MakeDynamicSliceHlo(
HloInstruction* operand, HloInstruction* start_indices,
absl::Span<const int64> slice_sizes) {
HloComputation* computation = operand->parent();
CHECK_EQ(computation, start_indices->parent());
int64 rank = start_indices->shape().dimensions(0);
std::vector<HloInstruction*> scalar_start_indices;
for (int i = 0; i < rank; ++i) {
// TODO(b/118437727): Update callers to provide scalars directly.
auto slice = computation->AddInstruction(HloInstruction::CreateSlice(
ShapeUtil::MakeShape(start_indices->shape().element_type(), {1}),
start_indices, {i}, {i + 1}, {1}));
scalar_start_indices.push_back(
computation->AddInstruction(HloInstruction::CreateReshape(
ShapeUtil::MakeShape(start_indices->shape().element_type(), {}),
slice)));
}
std::vector<Shape> scalar_start_indices_shapes(
rank, ShapeUtil::MakeShape(start_indices->shape().element_type(), {}));
TF_ASSIGN_OR_RETURN(
Shape dynamic_slice_shape,
ShapeInference::InferDynamicSliceShape(
operand->shape(), scalar_start_indices_shapes, slice_sizes));
return computation->AddInstruction(HloInstruction::CreateDynamicSlice(
dynamic_slice_shape, operand, scalar_start_indices, slice_sizes));
}
StatusOr<HloInstruction*> MakeDynamicUpdateSliceHlo(
HloInstruction* operand, HloInstruction* update,
HloInstruction* start_indices) {
HloComputation* computation = operand->parent();
CHECK_EQ(computation, update->parent());
CHECK_EQ(computation, start_indices->parent());
int64 rank = start_indices->shape().dimensions(0);
std::vector<HloInstruction*> scalar_start_indices;
for (int i = 0; i < rank; ++i) {
// TODO(b/118437727): Update callers to provide scalars directly.
auto slice = computation->AddInstruction(HloInstruction::CreateSlice(
ShapeUtil::MakeShape(start_indices->shape().element_type(), {1}),
start_indices, {i}, {i + 1}, {1}));
scalar_start_indices.push_back(
computation->AddInstruction(HloInstruction::CreateReshape(
ShapeUtil::MakeShape(start_indices->shape().element_type(), {}),
slice)));
}
std::vector<Shape> scalar_start_indices_shapes(
rank, ShapeUtil::MakeShape(start_indices->shape().element_type(), {}));
TF_ASSIGN_OR_RETURN(
Shape dynamic_update_slice_shape,
ShapeInference::InferDynamicUpdateSliceShape(
operand->shape(), update->shape(), scalar_start_indices_shapes));
return computation->AddInstruction(HloInstruction::CreateDynamicUpdateSlice(
dynamic_update_slice_shape, operand, update, scalar_start_indices));
}
HloInstruction* MakeBroadcastHlo(HloInstruction* operand,
absl::Span<const int64> broadcast_dimensions,
absl::Span<const int64> result_shape_bounds) {
HloComputation* computation = operand->parent();
Shape broadcast_shape = ShapeUtil::MakeShape(operand->shape().element_type(),
result_shape_bounds);
return computation->AddInstruction(HloInstruction::CreateBroadcast(
broadcast_shape, operand, broadcast_dimensions));
}
HloInstruction* MakeBroadcastHlo(HloInstruction* operand,
absl::Span<const int64> broadcast_dimensions,
const Shape& shape) {
return MakeBroadcastHlo(operand, broadcast_dimensions, shape.dimensions());
}
StatusOr<HloInstruction*> MakeGetTupleElementHlo(HloInstruction* operand,
int64 index) {
HloComputation* computation = operand->parent();
TF_ASSIGN_OR_RETURN(
Shape gte_shape,
ShapeInference::InferGetTupleElementShape(operand->shape(), index));
return computation->AddInstruction(
HloInstruction::CreateGetTupleElement(gte_shape, operand, index));
}
StatusOr<HloInstruction*> MakeConcatHlo(
absl::Span<HloInstruction* const> operands, int64 dimension) {
CHECK_GT(operands.size(), 0);
HloComputation* computation = operands[0]->parent();
CHECK(absl::c_all_of(operands, [&](HloInstruction* instr) {
return instr->parent() == computation;
}));
std::vector<const Shape*> operand_shapes;
absl::c_transform(operands, std::back_inserter(operand_shapes),
[](HloInstruction* instr) { return &instr->shape(); });
TF_ASSIGN_OR_RETURN(Shape concat_shape, ShapeInference::InferConcatOpShape(
operand_shapes, dimension));
return computation->AddInstruction(
HloInstruction::CreateConcatenate(concat_shape, operands, dimension));
}
HloInstruction* MakeConvertToHlo(HloInstruction* hlo, PrimitiveType type) {
CHECK_NE(hlo->shape().element_type(), type);
Shape shape = ShapeUtil::ChangeElementType(hlo->shape(), type);
hlo =
hlo->parent()->AddInstruction(HloInstruction::CreateConvert(shape, hlo));
CHECK_EQ(hlo->shape().element_type(), type);
return hlo;
}
HloInstruction* MakeBitcastConvertToHlo(HloInstruction* hlo,
PrimitiveType type) {
CHECK_NE(hlo->shape().element_type(), type);
Shape shape = ShapeUtil::ChangeElementType(hlo->shape(), type);
hlo = hlo->parent()->AddInstruction(
HloInstruction::CreateBitcastConvert(shape, hlo));
CHECK_EQ(hlo->shape().element_type(), type);
return hlo;
}
HloInstruction* MakeIotaHlo(HloComputation* computation, const Shape& shape,
int64 iota_dimension) {
return computation->AddInstruction(
HloInstruction::CreateIota(shape, iota_dimension));
}
StatusOr<HloInstruction*> MakeDotHlo(HloInstruction* lhs, HloInstruction* rhs,
const DotDimensionNumbers& dim_numbers,
const PrecisionConfig& precision_config) {
HloComputation* computation = lhs->parent();
CHECK_EQ(computation, rhs->parent());
TF_ASSIGN_OR_RETURN(
Shape dot_shape,
ShapeInference::InferDotOpShape(lhs->shape(), rhs->shape(), dim_numbers));
return computation->AddInstruction(HloInstruction::CreateDot(
dot_shape, lhs, rhs, dim_numbers, precision_config));
}
StatusOr<HloInstruction*> MakeMapHlo(absl::Span<HloInstruction* const> operands,
HloComputation* map_computation) {
CHECK(!operands.empty()) << "Map Hlo requires at least one operand.";
HloComputation* computation = operands.front()->parent();
std::vector<const Shape*> operand_shapes;
int64 max_operand_rank = 0;
for (const HloInstruction* operand : operands) {
CHECK_EQ(computation, operand->parent());
operand_shapes.push_back(&operand->shape());
max_operand_rank = std::max(max_operand_rank, operand->shape().rank());
}
std::vector<int64> map_dims(max_operand_rank);
std::iota(map_dims.begin(), map_dims.end(), 0);
TF_ASSIGN_OR_RETURN(
Shape map_shape,
ShapeInference::InferMapShape(
operand_shapes, map_computation->ComputeProgramShape(), map_dims));
return computation->AddInstruction(
HloInstruction::CreateMap(map_shape, operands, map_computation));
}
StatusOr<HloInstruction*> MakeReduceHlo(HloInstruction* operand,
HloInstruction* init_value,
HloOpcode binary_opcode,
HloModule* module) {
DCHECK_NE(nullptr, module);
std::vector<int64> all_dims(operand->shape().rank());
std::iota(all_dims.begin(), all_dims.end(), 0);
auto scalar_shape = ShapeUtil::MakeShape(operand->shape().element_type(), {});
HloComputation* reduce_computation;
{
HloComputation::Builder b(operand->name() + ".reduce_sub_computation");
auto lhs = b.AddInstruction(
HloInstruction::CreateParameter(0, scalar_shape, "lhs"));
auto rhs = b.AddInstruction(
HloInstruction::CreateParameter(1, scalar_shape, "rhs"));
b.AddInstruction(
HloInstruction::CreateBinary(scalar_shape, binary_opcode, lhs, rhs));
reduce_computation = module->AddEmbeddedComputation(b.Build());
}
return operand->parent()->AddInstruction(HloInstruction::CreateReduce(
scalar_shape, operand, init_value, all_dims, reduce_computation));
}
StatusOr<HloInstruction*> MakeSelectHlo(HloInstruction* pred,
HloInstruction* on_true,
HloInstruction* on_false,
HloInstruction* derived_from) {
HloComputation* computation = pred->parent();
DCHECK_EQ(computation, on_true->parent());
DCHECK_EQ(computation, on_false->parent());
Shape op_shape = on_true->shape();
if (ShapeUtil::IsScalar(pred->shape())) {
if (!ShapeUtil::IsScalar(op_shape) && !op_shape.IsTuple()) {
// If the output is not scalar, we need to broadcast the condition
// to match the contract of kSelect. For tuples, we use kTupleSelect
// which expects the condition to be a scalar.
pred = computation->AddInstruction(HloInstruction::CreateBroadcast(
ShapeUtil::ChangeElementType(op_shape, PrimitiveType::PRED), pred,
{}));
if (derived_from) {
derived_from->SetupDerivedInstruction(pred);
}
}
}
HloOpcode select_op_code =
op_shape.IsTuple() ? HloOpcode::kTupleSelect : HloOpcode::kSelect;
TF_ASSIGN_OR_RETURN(Shape select_shape,
ShapeInference::InferTernaryOpShape(select_op_code, pred,
on_true, on_false));
HloInstruction* select =
computation->AddInstruction(HloInstruction::CreateTernary(
select_shape, select_op_code, pred, on_true, on_false));
if (derived_from) {
derived_from->SetupDerivedInstruction(select);
}
return select;
}
StatusOr<HloInstruction*> MakeSortHlo(
const Shape& sort_shape, absl::Span<HloInstruction* const> operands,
int64 dimension_to_sort, bool is_stable, HloComputation::Builder* builder,
HloModule* module) {
CHECK(!operands.empty()) << "Sort Hlo requires at least one operand.";
HloComputation* compare_computation;
XlaBuilder b("Sort.Compare");
std::vector<PrimitiveType> operand_types(operands.size());
for (int64 i = 0; i < operands.size(); ++i) {
operand_types[i] = operands[i]->shape().element_type();
}
XlaComputation comparator = CreateScalarLtComputation(operand_types, &b);
TF_ASSIGN_OR_RETURN(ProgramShape program_shape, comparator.GetProgramShape());
HloModuleConfig config(program_shape);
TF_ASSIGN_OR_RETURN(auto new_module,
HloModule::CreateFromProto(comparator.proto(), config));
HloCloneContext context(module);
compare_computation =
module->DeepCloneComputation(new_module->entry_computation(), &context);
return builder->AddInstruction(HloInstruction::CreateSort(
sort_shape, dimension_to_sort, operands, compare_computation, is_stable));
}
StatusOr<HloInstruction*> CollapseFirstNDims(HloInstruction* operand, int64 n) {
CHECK_GT(n, 0);
const Shape& operand_shape = operand->shape();
CHECK_GE(operand_shape.dimensions_size(), n);
int64 new_shape_leading_bound = 1;
for (int64 i = 0; i < n; i++) {
new_shape_leading_bound *= operand_shape.dimensions(i);
}
std::vector<int64> new_shape_dims;
new_shape_dims.reserve(operand_shape.dimensions_size() - n + 1);
new_shape_dims.push_back(new_shape_leading_bound);
std::copy(operand_shape.dimensions().begin() + n,
operand_shape.dimensions().end(),
std::back_inserter(new_shape_dims));
Shape output_shape =
ShapeUtil::MakeShape(operand_shape.element_type(), new_shape_dims);
return MakeReshapeHlo(output_shape, operand);
}
StatusOr<HloInstruction*> PrependDegenerateDims(HloInstruction* operand,
int64 n) {
CHECK_GT(n, 0);
std::vector<int64> new_shape_dims;
const Shape& operand_shape = operand->shape();
new_shape_dims.reserve(n + operand_shape.dimensions_size());
new_shape_dims.insert(new_shape_dims.begin(), n, 1);
absl::c_copy(operand_shape.dimensions(), std::back_inserter(new_shape_dims));
return MakeReshapeHlo(new_shape_dims, operand);
}
StatusOr<HloInstruction*> ExpandFirstDimIntoNDims(
HloInstruction* operand, absl::Span<const int64> expanded_dims) {
CHECK_GT(operand->shape().dimensions_size(), 0);
CHECK_EQ(operand->shape().dimensions(0), Product(expanded_dims));
std::vector<int64> expanded_shape_dim_bounds;
expanded_shape_dim_bounds.reserve(expanded_dims.size() +
operand->shape().dimensions_size() - 1);
absl::c_copy(expanded_dims, std::back_inserter(expanded_shape_dim_bounds));
std::copy(operand->shape().dimensions().begin() + 1,
operand->shape().dimensions().end(),
std::back_inserter(expanded_shape_dim_bounds));
Shape new_shape = ShapeUtil::MakeShape(operand->shape().element_type(),
expanded_shape_dim_bounds);
return MakeReshapeHlo(new_shape, operand);
}
StatusOr<HloInstruction*> ElideDegenerateDims(
HloInstruction* operand, absl::Span<const int64> dims_to_elide) {
return MakeReshapeHlo(
ShapeUtil::FilterDimensions(
[&](int64 dim) { return !absl::c_linear_search(dims_to_elide, dim); },
operand->shape()),
operand);
}
StatusOr<HloInstruction*> InsertDegenerateDims(
HloInstruction* operand, absl::Span<const int64> dims_to_insert) {
CHECK(absl::c_is_sorted(dims_to_insert));
const Shape& operand_shape = operand->shape();
int64 output_shape_rank =
operand_shape.dimensions_size() + dims_to_insert.size();
for (auto dim_to_insert : dims_to_insert) {
CHECK_LT(dim_to_insert, output_shape_rank);
}
std::vector<int64> output_shape_dim_bounds;
output_shape_dim_bounds.reserve(output_shape_rank);
int64 operand_dims_idx = 0;
int64 dims_to_insert_idx = 0;
for (int64 i = 0; i < output_shape_rank; ++i) {
if (dims_to_insert_idx < dims_to_insert.size() &&
i == dims_to_insert[dims_to_insert_idx]) {
output_shape_dim_bounds.push_back(1);
++dims_to_insert_idx;
} else {
output_shape_dim_bounds.push_back(
operand_shape.dimensions(operand_dims_idx));
++operand_dims_idx;
}
}
Shape output_shape = ShapeUtil::MakeShape(operand_shape.element_type(),
output_shape_dim_bounds);
return MakeReshapeHlo(output_shape, operand);
}
StatusOr<HloInstruction*> PadVectorWithZeros(HloInstruction* operand,
int64 zeros_to_prepend,
int64 zeros_to_append) {
HloComputation* computation = operand->parent();
CHECK_EQ(operand->shape().dimensions_size(), 1);
PaddingConfig padding_config;
PaddingConfig::PaddingConfigDimension padding_config_dim;
padding_config_dim.set_edge_padding_low(zeros_to_prepend);
padding_config_dim.set_edge_padding_high(zeros_to_append);
*padding_config.add_dimensions() = padding_config_dim;
HloInstruction* zero =
computation->AddInstruction(HloInstruction::CreateConstant(
LiteralUtil::Zero(operand->shape().element_type())));
return MakePadHlo(operand, zero, padding_config);
}
HloInstruction* BroadcastZeros(HloComputation* computation,
PrimitiveType element_type,
absl::Span<const int64> broadcast_dimensions) {
HloInstruction* zero = computation->AddInstruction(
HloInstruction::CreateConstant(LiteralUtil::Zero(element_type)));
return MakeBroadcastHlo(zero, /*broadcast_dimensions=*/{},
/*result_shape_bounds=*/broadcast_dimensions);
}
// Recursively creates a dummy op given a shape. Leaf nodes are broadcasted zero
// while internal nodes are tuples.
HloInstruction* CreateDummyOp(HloComputation::Builder* b, const Shape& shape) {
if (shape.IsArray()) {
auto zero = b->AddInstruction(HloInstruction::CreateConstant(
LiteralUtil::Zero(shape.element_type())));
return b->AddInstruction(HloInstruction::CreateBroadcast(shape, zero, {}));
}
CHECK(shape.IsTuple());
std::vector<HloInstruction*> sub_instructions;
for (const Shape& subshape : shape.tuple_shapes()) {
sub_instructions.push_back(CreateDummyOp(b, subshape));
}
return b->AddInstruction(HloInstruction::CreateTuple(sub_instructions));
}
StatusOr<std::unique_ptr<HloComputation>> CreateComputationWithSignature(
absl::Span<const Shape* const> domain, const Shape& range,
absl::string_view name) {
HloComputation::Builder b{string(name)};
int64 param_idx = 0;
for (const Shape* param_shape : domain) {
b.AddInstruction(HloInstruction::CreateParameter(
param_idx, *param_shape, StrCat("param.", param_idx)));
param_idx++;
}
// We can't change the root type of a computation once it is created so create
// a dummy root instruction to give the computation the right root shape. Use
// a (recursive) broadcast here to avoid creating large constants.
CreateDummyOp(&b, range);
return b.Build();
}
} // namespace xla