xref: /aosp_15_r20/external/tensorflow/tensorflow/compiler/xla/client/lib/dynamic_shaped_ops.h (revision b6fb3261f9314811a0f4371741dbb8839866f948)
1 /* Copyright 2021 The TensorFlow Authors. All Rights Reserved.
2 
3 Licensed under the Apache License, Version 2.0 (the "License");
4 you may not use this file except in compliance with the License.
5 You may obtain a copy of the License at
6 
7     http://www.apache.org/licenses/LICENSE-2.0
8 
9 Unless required by applicable law or agreed to in writing, software
10 distributed under the License is distributed on an "AS IS" BASIS,
11 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 See the License for the specific language governing permissions and
13 limitations under the License.
14 ==============================================================================*/
15 
16 #ifndef TENSORFLOW_COMPILER_XLA_CLIENT_LIB_DYNAMIC_SHAPED_OPS_H_
17 #define TENSORFLOW_COMPILER_XLA_CLIENT_LIB_DYNAMIC_SHAPED_OPS_H_
18 
19 #include "tensorflow/compiler/xla/client/lib/constants.h"
20 #include "tensorflow/compiler/xla/client/value_inference.h"
21 #include "tensorflow/compiler/xla/client/xla_builder.h"
22 #include "tensorflow/compiler/xla/primitive_util.h"
23 #include "tensorflow/compiler/xla/types.h"
24 #include "tensorflow/compiler/xla/xla_data.pb.h"
25 
26 namespace xla {
27 
28 // Similar to static shaped conditional, but allows true_computation and
29 // false_computation to have different dimension sizes (ranks still have to be
30 // the same). Fall back to static conditional if dynamism is not presented.
31 XlaOp DynamicConditional(XlaBuilder* builder, XlaOp predicate,
32                          XlaOp true_operand,
33                          const XlaComputation& true_computation,
34                          XlaOp false_operand,
35                          const XlaComputation& false_computation);
36 
37 // Similar to DynamicConditional, but support multiple branches.
38 XlaOp DynamicConditional(
39     XlaBuilder* builder, XlaOp branch_index,
40     absl::Span<const XlaComputation* const> branch_computations,
41     absl::Span<const XlaOp> branch_operands);
42 
43 // Similar to SetDimensionSize, but automatically adjust the bound of output if
44 // a tighter one can be inferred by `value_inference`.
45 StatusOr<XlaOp> SetDimensionSizeWithRebound(ValueInference* value_inference,
46                                             XlaOp operand, XlaOp dimension_size,
47                                             int64_t dimension);
48 
49 // Take a `operand` tensor and a R1 tensor `size_vector` representing the sizes
50 // of `operand`, Call SetDimensionSize if for each dimension whose size is
51 // dynamic.
52 StatusOr<XlaOp> SetAllDimensionSizes(ValueInference* value_inference,
53                                      XlaOp operand, XlaOp size_vector);
54 }  // namespace xla
55 
56 #endif  // TENSORFLOW_COMPILER_XLA_CLIENT_LIB_DYNAMIC_SHAPED_OPS_H_
57