פעולות
mhlo.abs
(mhlo::AbsOp)
ניתוח שרירי הבטן
תַחבִּיר:
operation ::= `mhlo.abs` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצעת פעולת abs אלמנט על טנסור operand
ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#abs
דוּגמָה:
%result = mhlo.abs %operand : tensor<3xi32>
תכונות: AlwaysSpeculatableImplTrait
, Elementwise
, SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 2/4/8/16/32/64 סיביות חסר סימנים או מספר שלם 4/6/8/16/32/64 סיביות צף או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או 2/4/8/16/32 סיביות אחיד עם סימן שלם או 2/4/2/8/16 סימן שלם אחיד 2/4/8/16 2/4/8/16/32 סיביות אחיד מכומד ללא סימן או 2/4/8/16/32 סיביות אחיד מכומד לכל ציר ערכי מספר שלם ללא סימן |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור מדורג של 2/4/8/16/32/64 סיביות חסר סימנים או 4/6/8/16/32/64 סיביות ציפה או 2/4/8/16/32 סיביות אחידה כמותית סימנים שלם או 2/4/8/16/32 סיביות אחידה מכומדת שלם/8 סיביות/8 סיביות אחידה לכל ציר/8 סיביות. ערכי מספר שלם ללא סימן מכומת או 2/4/8/16/32 סיביות אחיד בקומות לכל ציר ללא סימן |
mhlo.acos
(mhlo::AcosOp)
מבצע אקוס
תַחבִּיר:
operation ::= `mhlo.acos` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע פעולת acos מבחינת אלמנט על טנסור operand
ומייצר טנזור result
.
דוּגמָה:
%result = mhlo.acos %operand : tensor<2x2xf32>
תכונות: CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: InferShapedTypeOpInterface
, InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
mhlo.acosh
(mhlo::AcoshOp)
מבצע עכוש
תַחבִּיר:
operation ::= `mhlo.acosh` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע פעולת אקוש מבחינה אלמנטית על טנסור operand
ומייצר טנזור result
.
דוּגמָה:
%result = mhlo.acosh %operand : tensor<2x2xf32>
תכונות: CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: InferShapedTypeOpInterface
, InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
mhlo.add
(mhlo::AddOp)
הוסף פעולה
תַחבִּיר:
operation ::= `mhlo.add` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
מבצע הוספת אלמנט של שני טנסורים lhs
ו- rhs
ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#add
דוּגמָה:
%result = mhlo.add %lhs, %rhs : tensor<2x2xi32>
תכונות: AlwaysSpeculatableImplTrait
, Commutative
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
rhs | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.add_dependency
(mhlo::AddDependencyOp)
פעולת AddDependency
תַחבִּיר:
operation ::= `mhlo.add_dependency` operands attr-dict `:` functional-type(operands, results)
פעולה זו פרטית ל-XLA מהדר, ולכן אין לה עדיין מפרט.
באופן לא רשמי, הפעולה הזו שני אופרנדים: אופרנד נתונים ואסימון. הפלט של הפעולה הוא אופרנד הנתונים. בשימוש עם AfterAll פעולה זו מאפשרת הזמנת פעולות שאינן משפיעות לוואי (אלו שאינן מייצרות ערכי אסימון).
דוּגמָה:
%1 = mhlo.add_dependency %arg0, %0 : (tensor<3x4xf32>, !mhlo.token) -> tensor<3x4xf32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float 32/64-bit או ערכים מכומדים של מספר שלם לכל טנסור או טנסור מדורג של ערכים מכוימים לכל ציר שלם token token or sthlo |
token | token או stablehlo token |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
output | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float 32/64-bit או ערכים מכומדים של מספר שלם לכל טנסור או טנסור מדורג של ערכים מכוימים לכל ציר שלם token token or sthlo |
mhlo.after_all
(mhlo::AfterAllOp)
מבצע אחרי הכל
תַחבִּיר:
operation ::= `mhlo.after_all` $inputs attr-dict
`:` custom<VariadicSameOperandsAndResultType>(ref($inputs), type($inputs), type($result))
מבטיח שהפעולות המייצרות את inputs
מבוצעות לפני כל פעולות התלויות result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#after_all
דוּגמָה:
%result = mhlo.after_all %input0, %input1 : !mhlo.token
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
inputs | וריאדית של אסימון |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | אֲסִימוֹן |
mhlo.all_gather
(mhlo::AllGatherOp)
פעולת AllGather
בתוך כל קבוצת תהליך ברשת התהליך, משרשרת את הערכים של טנסור האופרנד מכל תהליך לאורך all_gather_dim
ומייצר טנזור תוצאה. computation
מיושם בנפרד עבור כל אופרנד operands
, ומפיק תוצאה אחת לכל אופרנד.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#all_gather
דוּגמָה:
%result = "mhlo.all_gather"(%operand) {
all_gather_dim = 1 : i64,
replica_groups = dense<[[0, 1]]> : tensor<1x2xi64>
// channel_id = 0
channel_handle = #mhlo.channel_handle<handle = 0, type = 0>,
// use_global_device_ids = false
} : (tensor<2x2xf32>) -> tensor<2x4xf32>
תכונות: SameOperandsAndResultElementType
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
all_gather_dim | ::mlir::IntegerAttr | תכונת מספר שלם ללא סימן של 64 סיביות שהערך שלה אינו שלילי |
replica_groups | ::mlir::DenseIntElementsAttr | תכונת רכיבי מספר שלם ללא סימן של 64 סיביות |
channel_handle | ::mlir::mhlo::ChannelHandleAttr | שני מספרים שלמים של 64 סיביות 'ידית' ו'סוג' |
use_global_device_ids | ::mlir::UnitAttr | תכונת יחידה |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operands | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כומתיים לכל טנסור או מספר שלם לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כומתיים לכל טנסור או מספר שלם לכל ציר |
mhlo.all_reduce
(mhlo::AllReduceOp)
AllReduce פעולה
בתוך כל קבוצת תהליך ברשת התהליך, מיישמת computation
פונקציית הפחתה על הערכים של טנסור אופרנד מכל תהליך ומפיקה טנזור תוצאה. computation
מיושם בנפרד עבור כל אופרנד operands
, ומפיק תוצאה אחת לכל אופרנד.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#all_reduce
דוּגמָה:
%result = "mhlo.all_reduce"(%operand) ({
^bb0(%arg0: tensor<f32>, %arg1: tensor<f32>):
%0 = mhlo.add %arg1, %arg2 : tensor<f32>
mhlo.return %0 : tensor<f32>
}) {
replica_groups = dense<[[0, 1]]> : tensor<1x2xi64>
// channel_id = 0
channel_handle = #mhlo.channel_handle<handle = 0, type = 0>
// use_global_device_ids = false
} : (tensor<4xf32>) -> tensor<4xf32>
תכונות: InferTensorType
, SingleBlockImplicitTerminator<ReturnOp>
, SingleBlock
ממשקים: InferShapedTypeOpInterface
, InferTypeOpInterface
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
replica_groups | ::mlir::DenseIntElementsAttr | תכונת רכיבי מספר שלם ללא סימן של 64 סיביות |
channel_handle | ::mlir::mhlo::ChannelHandleAttr | שני מספרים שלמים של 64 סיביות 'ידית' ו'סוג' |
use_global_device_ids | ::mlir::UnitAttr | תכונת יחידה |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operands | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כומתיים לכל טנסור או מספר שלם לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כומתיים לכל טנסור או מספר שלם לכל ציר |
mhlo.all_to_all
(mhlo::AllToAllOp)
פעולת AllToAll
בתוך כל קבוצת תהליכים ברשת התהליך, מפצל את ערכי הטנזור operand
לאורך split_dimension
לחלקים, מפזר את החלקים המפוצלים בין התהליכים, משרשר את החלקים המפוזרים לאורך concat_dimension
ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#all_to_all
דוּגמָה:
%result = "mhlo.all_to_all"(%operand) {
split_dimension = 1 : i64,
concat_dimension = 0 : i64,
split_count = 2 : i64,
replica_groups = dense<[[0, 1]]> : tensor<1x2xi64>
} : (tensor<2x4xf32>) -> tensor<4x2xf32>
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
, SameOperandsElementType
, SameOperandsShape
, SameVariadicOperandSize
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
split_dimension | ::mlir::IntegerAttr | תכונת מספר שלם ללא סימן של 64 סיביות שהערך שלה אינו שלילי |
concat_dimension | ::mlir::IntegerAttr | תכונת מספר שלם ללא סימן של 64 סיביות שהערך שלה אינו שלילי |
split_count | ::mlir::IntegerAttr | תכונת מספר שלם ללא סימן של 64 סיביות שערכה חיובי |
replica_groups | ::mlir::DenseIntElementsAttr | תכונת רכיבי מספר שלם ללא סימן של 64 סיביות |
channel_handle | ::mlir::mhlo::ChannelHandleAttr | שני מספרים שלמים של 64 סיביות 'ידית' ו'סוג' |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כומתיים לכל טנסור או מספר שלם לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כומתיים לכל טנסור או מספר שלם לכל ציר |
mhlo.and
(mhlo::AndOp)
וגם תפעול
תַחבִּיר:
operation ::= `mhlo.and` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
מבצע AND מבחינה אלמנטית של שני טנסורים lhs
ו- rhs
ומייצר טנזור result
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#and
דוּגמָה:
%result = mhlo.and %lhs, %rhs : tensor<2x2xi32>
תכונות: AlwaysSpeculatableImplTrait
, Commutative
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנסור מדורג של bool או 2/4/8/16/32/64 סיביות ערכים שלמים |
rhs | טנסור מדורג של bool או 2/4/8/16/32/64 סיביות ערכים שלמים |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.asin
(mhlo::AsinOp)
מבצע אסין
תַחבִּיר:
operation ::= `mhlo.asin` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע פעולת Asin מבחינה אלמנטית על טנסור operand
ומייצר טנזור result
.
דוּגמָה:
%result = mhlo.asin %operand : tensor<2x2xf32>
תכונות: CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: InferShapedTypeOpInterface
, InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
mhlo.async_done
(mhlo::AsyncDoneOp)
פעולת AsyncDone
פעולה זו פרטית ל-XLA מהדר, ולכן אין לה עדיין מפרט.
באופן לא רשמי, פעולה זו חוסמת עד לסיום חישוב אסינכרוני. הוא מחזיר את התוצאה הסופית של החישוב האסינכרוני.
עיין בתיעוד עבור AsyncStart למידע נוסף.
ממשקים: InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
bundle | async_bundle עם כל שילוב של טנסור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם 32/64-bit float elements או לכל-tensor מספר שלם quantized או לכל ציר shlo token ערך quantized |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או מספר שלם לפי טנסור מכומתי או לכל ציר שלם מכומת ערכים או אסימון סטוק או שילוב של אסימון או אסימון קבוע או שילוב כל שהוא. של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או memref של 4/6/8/16/32/64-bit bool/64-bit/6/4 float/64-bit או float. או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כמותיים של מספר שלם לכל טנסור או טנזור מדורג של ערכים כמותיים או ערכים סמליים לכל ציר |
mhlo.async_start
(mhlo::AsyncStartOp)
פעולת AsyncStart
פעולה זו פרטית ל-XLA מהדר, ולכן אין לה עדיין מפרט.
באופן לא רשמי, פעולה זו מתחילה חישוב אסינכרוני.
זה משמש כאשר יש פונקציות המכילות גם המתנה אסינכרונית (כגון DMAs) וגם חישוב על-פתיל. לדוגמה, פונקציה עשויה להיות מורכבת מחישוב, DMA, חישוב אחר, DMA שני וחישוב סופי. זה יוצג כ-async_start ואחריו ו-async_update ו-async_done. ה-async_start יבצע את החישוב הראשון על השרשור ולאחר מכן יתחיל את ה-DMA. ה-async_update ימתין להשלמת ה-DMA אם הוא עדיין לא נעשה, ואז יבצע את החישוב השני בפונקציה, ויתחיל את ה-DMA השני. לבסוף, ה-async_done ימתין ב-DMA האחרון הזה, ולאחר מכן יריץ את החישוב האחרון שצריך להפעיל ב-thread ויחזיר את התוצאה של החישוב הסופי הזה.
operands
מועברים לחישוב ישירות called_computation
היא הפונקציה שתופעל באופן אסינכרוני execution_thread
הוא שם השרשור בו הוא יופעל. החוט הראשי נקרא "ראשי". לכל האשכולות יש שמות.
זה מחזיר את כל המצב הדרוש בין פעולות אסינכרון. לאחר הקצאת מאגר, ערכי ההחזרה מייצגים את השטח הדרוש כדי להחזיק את הקלט, התוצאות וכל משטחי הגירוד הדרושים או נערכו על ידי ה-async op.
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
called_computation | ::mlir::FlatSymbolRefAttr | תכונת הפניה לסמל שטוח |
execution_thread | ::mlir::StringAttr | תכונת מחרוזת |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
inputs | וריאדי של טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או מספר שלם לפי טנסור מכומתי או לכל ציר שלם מכומת ערכים או אסימון סטוק או שילוב של אסימון או אסימון קבוע או שילוב כל שהוא. של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או memref של 4/6/8/16/32/64-bit bool/64-bit/6/4 float/64-bit או float. או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כמותיים של מספר שלם לכל טנסור או טנזור מדורג של ערכים כמותיים או ערכים סמליים לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | async_bundle עם כל שילוב של טנסור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם 32/64-bit float elements או לכל-tensor מספר שלם quantized או לכל ציר shlo token ערך quantized |
mhlo.async_update
(mhlo::AsyncUpdateOp)
פעולת AsyncUpdate
פעולה זו פרטית ל-XLA מהדר, ולכן אין לה עדיין מפרט.
באופן לא רשמי, פעולה זו חוסמת חישוב אסינכרוני עד למחסום סנכרון. זה מחזיר bundle
לאחר הפעלתו.
עיין בתיעוד עבור AsyncStart למידע נוסף.
ממשקים: InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
bundle | async_bundle עם כל שילוב של טנסור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם 32/64-bit float elements או לכל-tensor מספר שלם quantized או לכל ציר shlo token ערך quantized |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | async_bundle עם כל שילוב של טנסור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם 32/64-bit float elements או לכל-tensor מספר שלם quantized או לכל ציר shlo token ערך quantized |
mhlo.atan2
(mhlo::Atan2Op)
מבצע Atan2
תַחבִּיר:
operation ::= `mhlo.atan2` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
מבצע פעולת atan2 מבחינת אלמנט על טנזור lhs
ו- rhs
ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#atan2
דוּגמָה:
%result = mhlo.atan2 %lhs, %rhs : tensor<3xf32>
תכונות: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כמותיים לכל טנסור |
rhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כמותיים לכל טנסור |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כמותיים לכל טנסור |
mhlo.atanh
(mhlo::AtanhOp)
מבצע Atanh
תַחבִּיר:
operation ::= `mhlo.atanh` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע את פעולת atanh מבחינה אלמנטית על טנסור operand
ומייצר טנזור result
.
דוּגמָה:
%result = mhlo.atanh %operand : tensor<2x2xf32>
תכונות: CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: InferShapedTypeOpInterface
, InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
mhlo.batch_norm_grad
(mhlo::BatchNormGradOp)
פעולת BatchNormGrad
מחשב גרדיאנטים של מספר כניסות של BatchNormTrainingOp המתפשטות בחזרה מ- grad_output
, ומייצר טנסורים grad_operand
, grad_scale
ו- grad_offset
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#batch_norm_grad
דוּגמָה:
%grad_operand, %grad_scale, %grad_offset =
"mhlo.batch_norm_grad"(%operand, %scale, %mean, %variance, %grad_output) {
epsilon = 0.0 : f32,
feature_index = 2 : i64
} : (tensor<2x2x2xf32>, tensor<2xf32>, tensor<2xf32>, tensor<2xf32>,
tensor<2x2x2xf32>) -> (tensor<2x2x2xf32>, tensor<2xf32>, tensor<2xf32>)
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
epsilon | ::mlir::FloatAttr | תכונת ציפה של 32 סיביות |
feature_index | ::mlir::IntegerAttr | תכונת מספר שלם ללא סימן של 64 סיביות שהערך שלה אינו שלילי |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור מדורג של ערכי ציפה של 4/6/8/16/32/64 סיביות |
scale | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
mean | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
variance | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
grad_output | טנסור מדורג של ערכי ציפה של 4/6/8/16/32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
grad_operand | טנסור מדורג של ערכי ציפה של 4/6/8/16/32/64 סיביות |
grad_scale | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
grad_offset | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
mhlo.batch_norm_inference
(mhlo::BatchNormInferenceOp)
פעולת BatchNormInference
מנרמל את טנסור operand
על פני כל הממדים מלבד הממד feature_index
ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#batch_norm_inference
דוּגמָה:
%result = "mhlo.batch_norm_inference"(%operand, %scale, %offset, %mean, %variance) {
epsilon = 0.0 : f32,
feature_index = 2 : i64
} : (tensor<2x2x2xf32>, tensor<2xf32>, tensor<2xf32>, tensor<2xf32>, tensor<2xf32>) -> tensor<2x2x2xf32>
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
epsilon | ::mlir::FloatAttr | תכונת ציפה של 32 סיביות |
feature_index | ::mlir::IntegerAttr | תכונת מספר שלם ללא סימן של 64 סיביות שהערך שלה אינו שלילי |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור מדורג של ערכי ציפה של 4/6/8/16/32/64 סיביות |
scale | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
offset | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
mean | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
variance | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור מדורג של ערכי ציפה של 4/6/8/16/32/64 סיביות |
mhlo.batch_norm_training
(mhlo::BatchNormTrainingOp)
פעולת BatchNormTraining
מחשב את הממוצע והשונות על פני מימדים אצווה ומרחביים ומנרמל את טנסור operand
, עבור כל תכונה בממד feature_index
ומייצר טנסור output
, batch_mean
ו- batch_var
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#batch_norm_training
דוּגמָה:
%output, %batch_mean, %batch_var = "mhlo.batch_norm_training"(%operand, %scale, %offset) {
epsilon = 0.0 : f32,
feature_index = 2 : i64
} : (tensor<2x2x2xf32>, tensor<2xf32>, tensor<2xf32>) -> (tensor<2x2x2xf32>, tensor<2xf32>, tensor<2xf32>)
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
epsilon | ::mlir::FloatAttr | תכונת ציפה של 32 סיביות |
feature_index | ::mlir::IntegerAttr | תכונת מספר שלם ללא סימן של 64 סיביות שהערך שלה אינו שלילי |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור מדורג של ערכי ציפה של 4/6/8/16/32/64 סיביות |
scale | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
offset | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
output | טנסור מדורג של ערכי ציפה של 4/6/8/16/32/64 סיביות |
batch_mean | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
batch_var | טנסור 1D של ערכי ציפה של 4/6/8/16/32/64 סיביות |
mhlo.bitcast
(mhlo::BitcastOp)
פעולת Bitcast
תַחבִּיר:
operation ::= `mhlo.bitcast` operands attr-dict `:` functional-type(operands, results)
פעולה זו פרטית ל-XLA מהדר, ולכן אין לה עדיין מפרט.
באופן לא רשמי, פעולה זו משנה את צורת הקלט באופן שבו הסידור הפיזי של האלמנטים אינו משתנה.
פעולה זו זקוקה למידע על פריסה כדי להבין "סידור פיזי של אלמנטים", ותמיכה בפריסה ב-MHLO נמצאת כעת בתהליך.
דוּגמָה:
%0 = mhlo.bitcast %arg0 : (tensor<3x4xf32>) -> tensor<3x4x1xf32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.bitcast_convert
(mhlo::BitcastConvertOp)
פעולת BitcastConvert
תַחבִּיר:
operation ::= `mhlo.bitcast_convert` operands attr-dict `:` functional-type(operands, results)
מבצע פעולת bitcast על טנזור operand
ומייצר טנזור result
שבו הביטים של טנזור operand
כולו מתפרשים מחדש באמצעות סוג טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#bitcast_convert
דוּגמָה:
%result = mhlo.bitcast_convert %operand : (tensor<2xf32>) -> tensor<2x4xi8>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.broadcast
(mhlo::BroadcastOp)
פעולת שידור
פעולה זו נמצאת בדרכה החוצה מ-StableHLO, ולכן היא אינה כלולה במפרט: https://github.com/openxla/stablehlo/issues/3
באופן לא רשמי, הפעולה הזו עושה את אותו הדבר כמו השידור של XLA: https://www.tensorflow.org/xla/operation_semantics#broadcast
דוּגמָה:
%result = mhlo.broadcast %operand, sizes = [1, 2] : (tensor<3xi32>) -> tensor<1x2x3xi32>
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
, SameOperandsAndResultElementType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
broadcast_sizes | ::mlir::DenseIntElementsAttr | תכונת רכיבי מספר שלם ללא סימן של 64 סיביות |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.broadcast_in_dim
(mhlo::BroadcastInDimOp)
פעולת BroadcastInDim
מרחיב את הממדים ו/או הדירוג של טנזור קלט על ידי שכפול הנתונים בטנזור operand
ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#broadcast_in_dim
דוּגמָה:
%result = mhlo.broadcast_in_dim %operand, dims = [2, 1] : (tensor<1x3xi32>) -> tensor<2x3x2xi32>
תכונות: AlwaysSpeculatableImplTrait
, HLO_CompatibleOperandsAndResultElementType
ממשקים: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
broadcast_dimensions | ::mlir::DenseIntElementsAttr | תכונת רכיבי מספר שלם ללא סימן של 64 סיביות |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנזור ממד בעל צורה סטטית או מוגבלת יחידה של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כומתיים לכל טנסור או מספר שלם לכל ציר |
mhlo.case
(mhlo::CaseOp)
תפעול מקרה
מפיקה את הפלט מביצוע function
אחת בדיוק branches
בהתאם לערך של index
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#case
דוּגמָה:
%result0, %result1 = "mhlo.case"(%index) ({
mhlo.return %result_branch0, %result_branch0 : tensor<2xi64>, tensor<2xi64>
}, {
mhlo.return %result_branch1, %result_branch1 : tensor<2xi64>, tensor<2xi64>
}) : (tensor<i32>) -> (tensor<2xi64>, tensor<2xi64>)
תכונות: RecursiveMemoryEffects
, SingleBlockImplicitTerminator<ReturnOp>
, SingleBlock
ממשקים: InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
index | טנסור של ערכי מספרים שלמים ללא סימן של 32 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | וריאדי של טנזור מדורג של 4/6/8/16/32/64 סיביות ציפה או bool או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים מכומתיים לכל טנסור או טנסור מדורג של ערך שלם לכל ציר קוואנטי |
mhlo.cbrt
(mhlo::CbrtOp)
פעולת Cbrt
תַחבִּיר:
operation ::= `mhlo.cbrt` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע פעולת שורש מעוקב מבחינת אלמנט על טנסור operand
ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#cbrt
דוּגמָה:
%result = mhlo.cbrt %operand : tensor<4xf32>
תכונות: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | הדיוק המבוקש עבור פעולות לא נכונות. |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כמותיים לכל טנסור |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם רכיבי ציפה של 32/64 סיביות או ערכים כמותיים לכל טנסור |
mhlo.ceil
(mhlo::CeilOp)
תפעול תקרה
תַחבִּיר:
operation ::= `mhlo.ceil` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע תקרה אלמנט של טנזור operand
ומפיק טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#ceil
דוּגמָה:
%result = mhlo.ceil %operand : tensor<5xf32>
תכונות: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או ערכים כמותיים לכל טנסור |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור מדורג של 4/6/8/16/32/64 סיביות ציפה או ערכים כמותיים לכל טנסור |
mhlo.cholesky
(mhlo::CholeskyOp)
ניתוח כושל
מחשב את הפירוק Cholesky של אצווה של מטריצות.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#cholesky
דוּגמָה:
%result = mhlo.cholesky %a, lower = true : tensor<3x3xf32>
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
, SameOperandsAndResultElementType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
lower | ::mlir::BoolAttr | תכונת bool |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
a | טנסור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנסור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי רכיבי ציפה של 32/64 סיביות |
mhlo.clamp
(mhlo::ClampOp)
פעולת מהדק
תַחבִּיר:
operation ::= `mhlo.clamp` $min `,` $operand `,` $max attr-dict
`:` custom<SameOperandsAndResultType>(type($min), type($operand), type($max), type($result))
מהדק כל אלמנט של טנסור operand
בין ערך מינימלי למקסימום ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#clamp
דוּגמָה:
%result = mhlo.clamp %min, %operand, %max : tensor<3xi32>
תכונות: AlwaysSpeculatableImplTrait
, HLO_BroadcastingElementwise
, InferTensorType
, SameOperandsAndResultElementType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
min | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
max | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.collective_broadcast
(mhlo::CollectiveBroadcastOp)
פעולת Collective Broadcast
בתוך כל קבוצת תהליך ברשת התהליך, שלח את הערך של טנסור operand
מתהליך המקור לתהליכי היעד והפק טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#collective_broadcast
דוּגמָה:
%result = "mhlo.collective_broadcast"(%operand) {
replica_groups = dense<[[0, 1]]> : tensor<1x2xi64>,
channel_handle = #mhlo.channel_handle<handle = 0, type = 0>
} : (tensor<1x2xi64>) -> tensor<1x2xi64>
תכונות: CompatibleOperandsAndResultType
ממשקים: InferShapedTypeOpInterface
, InferTypeOpInterface
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
replica_groups | ::mlir::DenseIntElementsAttr | תכונת רכיבי מספר שלם ללא סימן של 64 סיביות |
channel_handle | ::mlir::mhlo::ChannelHandleAttr | שני מספרים שלמים של 64 סיביות 'ידית' ו'סוג' |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.collective_permute
(mhlo::CollectivePermuteOp)
פעולת CollectivePermute
בתוך כל קבוצת תהליך ברשת התהליך, שולח את הערך של טנסור operand
מתהליך המקור לתהליך היעד ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#collective_permute
דוּגמָה:
%result = "mhlo.collective_permute"(%operand) {
source_target_pairs = dense<[[0, 1], [1, 2]]> : tensor<2x2xi64>,
// channel_id = 0
channel_handle = #mhlo.channel_handle<handle = 0, type = 0>
} : (tensor<4x2xf32>) -> tensor<4x2xf32>
תכונות: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
source_target_pairs | ::mlir::DenseIntElementsAttr | תכונת רכיבי מספר שלם ללא סימן של 64 סיביות |
channel_handle | ::mlir::mhlo::ChannelHandleAttr | שני מספרים שלמים של 64 סיביות 'ידית' ו'סוג' |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
mhlo.compare
(mhlo::CompareOp)
השווה פעולה
תַחבִּיר:
operation ::= `mhlo.compare` $comparison_direction `,` $lhs `,` $rhs (`,` $compare_type^)?
attr-dict `:` functional-type(operands, results)
מבצע השוואה מבחינה אלמנטית של טנסור lhs
ו- rhs
לפי comparison_direction
ו- compare_type
, ומפיק טנסור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#compare
דוּגמָה:
%result = mhlo.compare LT, %lhs, %rhs, FLOAT : (tensor<2xf32>, tensor<2xf32>) -> tensor<2xi1>
תכונות: AlwaysSpeculatableImplTrait
, Elementwise
, InferTensorType
, SameOperandsAndResultShape
, SameOperandsElementType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
comparison_direction | ::mlir::mhlo::ComparisonDirectionAttr | איזו פעולת השוואה לבצע. |
compare_type | ::mlir::mhlo::ComparisonTypeAttr | באיזה סוג השוואה להשתמש. |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
rhs | טנזור מדורג של 4/6/8/16/32/64-bit float או bool או 2/4/8/16/32/64-bit מספר שלם או סוג מורכב עם רכיבי float של 32/64-bit או ערכים כומתיים לכל טנסור או לכל ציר |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
"ללא שם" | טנסור מדורג של ערכי bool |
mhlo.complex
(mhlo::ComplexOp)
פעולה מורכבת
תַחבִּיר:
operation ::= `mhlo.complex` operands attr-dict
`:` custom<ComplexOpType>(type($lhs), type($rhs), type($result))
מבצע המרה אלמנטרית לערך מורכב מצמד ערכים אמיתיים ודמיוניים, lhs
ו- rhs
, ומייצר טנזור result
.
ראה: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#complex
דוּגמָה:
%result = mhlo.complex %lhs, %rhs : tensor<2xcomplex<f32>>
תכונות: AlwaysSpeculatableImplTrait
, Elementwise
, SameOperandsAndResultShape
, SameOperandsElementType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של ערכי ציפה של 32/64 סיביות |
rhs | טנזור מדורג של ערכי ציפה של 32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג מסוג מורכב עם ערכי אלמנטים צפים של 32/64 סיביות |
mhlo.composite
(mhlo :: compositeop)
פעולה מורכבת
תַחבִּיר:
operation ::= `mhlo.composite` $name $inputs attr-dict `:` functional-type(operands, results)
עוטף פעולה המורכבת (מורכבת) של פעולות אחרות של StavelHlo, נטילת inputs
composite_attributes
ומייצרת results
. הסמנטיקה של ה- OP מיושמת על ידי תכונת decomposition
. ניתן להחליף את ה- OP composite
בפירוק שלה מבלי לשנות סמנטיקה של התוכנית. במקרים שבהם הפירוק הפירוק אינו מספק את אותה סמנטיקה של OP, העדיפו להשתמש custom_call
.
שדה version
(ברירת המחדל ל- 0
) משמש לציון כאשר הסמנטיקה של המורכב משתנה.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#composite
דוּגמָה:
%results = mhlo.composite "my.op" %arg0, %arg1 {
decomposition = @my_op,
composite_attributes = { my_attribute = "my_value" },
version = 1 : i32
} : (tensor<f32>, tensor<f32>) -> tensor<f32>
ממשקים: SymbolUserOpInterface
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
name | :: mlir :: stringattr | תכונה מחרוזת |
composite_attributes | :: mlir :: Dictionaryattr | מילון ערכי תכונה ששמו |
decomposition | :: mlir :: flatsymbolrefattr | תכונה התייחסות לסמל שטוח |
version | :: mlir :: integerattr | תכונה שלם שלם ללא אותות 32 סיביות |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
inputs | משתנה של טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או בול או 2/4/8/16/32/64 סיביות או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או שלם שלם שלם או טנסור לשילוב שלם או לשילוב שלם של משך שלם או טנסור מקורב או טנסור משולב של משלמה של דרגה או TEDSOR או TEDSOR עם כל שילוב של RAGEDED של RAGEDER של INTER או TEDSOR TERKED או TEDKEN TERKED או TEDKEN TERKED או TEDKEKED TERKED או TEKEN DEKEN או TEKEN DEKEN TERKED TENEDS. 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים של מספר שלם או תמ"ג או 2/6/64/6/6/16/32/64-bit או Bood או 2/6/64/64/64/16/32/64-bit Float או Bood או 2/16/622222222222/32-622 סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים שלם שלם או טנזור מדורגים של ערכים כמותיים או ערכי אסימון שלם לכל ציר או ערכי אסימון |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | משתנה של טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או בול או 2/4/8/16/32/64 סיביות או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או שלם שלם שלם או טנסור לשילוב שלם או לשילוב שלם של משך שלם או טנסור מקורב או טנסור משולב של משלמה של דרגה או TEDSOR או TEDSOR עם כל שילוב של RAGEDED של RAGEDER של INTER או TEDSOR TERKED או TEDKEN TERKED או TEDKEN TERKED או TEDKEKED TERKED או TEKEN DEKEN או TEKEN DEKEN TERKED TENEDS. 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים של מספר שלם או תמ"ג או 2/6/64/6/6/16/32/64-bit או Bood או 2/6/64/64/64/16/32/64-bit Float או Bood או 2/16/622222222222/32-622 סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים שלם שלם או טנזור מדורגים של ערכים כמותיים או ערכי אסימון שלם לכל ציר או ערכי אסימון |
mhlo.concatenate
(mhlo :: concatenateop)
פעולת שרשור
משרשר מספר משתנה של טנזורים inputs
לאורך ממד dimension
באותו סדר כמו הטיעונים הנתונים ומייצר טנזור result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#concatenate
דוּגמָה:
%result = mhlo.concatenate %input0, %input1, dim = 0 : (tensor<3x2xi64>, tensor<1x2xi64>) -> tensor<4x2xi64>
תכונות: AlwaysSpeculatableImplTrait
SameOperandsAndResultElementType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
dimension | :: mlir :: integerattr | תכונה שלם שלם של מספר שלם 64 סיביות שערכתה אינה שלילית |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
val | משתנה של טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיביות מספר שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.constant
(mhlo :: constantop)
פעולה מתמדת
מייצר output
פלט value
קבוע.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#constant
דוּגמָה:
%output = mhlo.constant dense<[[0.0, 1.0], [2.0, 3.0]]> : tensor<2x2xf32>
תכונות: AlwaysSpeculatableImplTrait
את הדיוקן, ConstantLike
ממשקים: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
value | :: mlir :: ElementSattr | תכונה וקטורית/טנזור קבועה |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
output | טנזור בצורת סטטי של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.convert
(mhlo :: convertop)
המרת פעולה
תַחבִּיר:
operation ::= `mhlo.convert` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע המרה מבחינה אלמנטית מסוג אלמנט אחד למשנהו על טנזור operand
ומייצר טנזור result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#convert
דוּגמָה:
%result = mhlo.convert %operand : (tensor<3xi32>) -> tensor<3xcomplex<f32>>
תכונות: AlwaysSpeculatableImplTrait
Elementwise
SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.convolution
(mhlo :: convolutionOp)
פעולת התפתחות
תַחבִּיר:
operation ::= `mhlo.convolution` `(`operands`)`
`dim_numbers` `=` custom<ConvolutionDimensions>($dimension_numbers) `,`
`window` `=` `{` custom<WindowAttributes>($window_strides, $padding,
$lhs_dilation, $rhs_dilation,
$window_reversal) `}`
attr-dict `:` functional-type(operands, results)
מחשב מוצרי DOT בין חלונות lhs
לפרוסות rhs
ומייצר result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#convolution
דוּגמָה:
%result = "mhlo.convolution"(%lhs, %rhs) {
window_strides = dense<4> : tensor<2xi64>,
padding = dense<0> : tensor<2x2xi64>,
lhs_dilation = dense<2> : tensor<2xi64>,
rhs_dilation = dense<1> : tensor<2xi64>,
window_reversal = dense<false> : tensor<2xi1>,
dimension_numbers = #mhlo.conv<[b, 0, 1, f]x[0, 1, i, o]->[b, 0, 1, f]>,
feature_group_count = 1 : i64,
batch_group_count = 1 : i64,
precision_config = [#stablehlo<precision DEFAULT>, #stablehlo<precision DEFAULT>]
} : (tensor<1x4x4x1xi32>, tensor<3x3x1x1xi32>) -> tensor<1x2x2x1xi32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
window_strides | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
padding | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
lhs_dilation | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
rhs_dilation | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
window_reversal | :: mlir :: denseelementsattr | תכונה וקטורית בוליאנית/טנסור קבועה |
dimension_numbers | :: mlir :: mhlo :: convdimensionnumbersattr | מבנה מידע על מימד עבור conv op |
feature_group_count | :: mlir :: integerattr | תכונה שלמה שלמה חסרת סיביות של 64 סיביות שערכתה חיובית |
batch_group_count | :: mlir :: integerattr | תכונה שלמה שלמה חסרת סיביות של 64 סיביות שערכתה חיובית |
precision_config | :: mlir :: arrayattr | תכונה של תצורת דיוק |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
rhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.copy
(mhlo :: copyop)
פעולת העתק
תַחבִּיר:
operation ::= `mhlo.copy` operands attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
פעולה זו היא פרטית למהדר XLA, ולכן אין לה עדיין מפרט.
באופן לא פורמלי, פעולה זו עותק של operand
. תלוי במטא נתונים המחוברים לפעולה, זה יכול להתנהג בצורה שונה למדי ללא לא-אופ.
דוּגמָה:
%0 = mhlo.copy %arg0 : tensor<f32>
תכונות Elementwise
AlwaysSpeculatableImplTrait
CompatibleOperandsAndResultType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
cross_program_prefetch_index | :: mlir :: integerattr | תכונה שלם שלם ללא אותות 32 סיביות |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנסור מדורג של 4/6/8/16/32/64 סיביות צף או Bool או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או שלם שלם שלם או שלם שלם שלם של שלב או אסימון או קיננו עם כל שילוב של טנח מדורג של דרגה שלם מדגם או אסימון או טופל מקומן עם שילוב של דרגת מדגם מדגם מדגם. 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים של מספר שלם או תמ"ג או 2/6/64/6/6/16/32/64-bit או Bood או 2/6/64/64/64/16/32/64-bit Float או Bood או 2/16/622222222222/32-622 סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים שלם שלם או טנזור מדורגים של ערכים כמותיים או ערכי אסימון שלם לכל ציר או ערכי אסימון |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנסור מדורג של 4/6/8/16/32/64 סיביות צף או Bool או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או שלם שלם שלם או שלם שלם שלם של שלב או אסימון או קיננו עם כל שילוב של טנח מדורג של דרגה שלם מדגם או אסימון או טופל מקומן עם שילוב של דרגת מדגם מדגם מדגם. 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים של מספר שלם או תמ"ג או 2/6/64/6/6/16/32/64-bit או Bood או 2/6/64/64/64/16/32/64-bit Float או Bood או 2/16/622222222222/32-622 סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים שלם שלם או טנזור מדורגים של ערכים כמותיים או ערכי אסימון שלם לכל ציר או ערכי אסימון |
mhlo.cosh
(mhlo :: coshop)
פעולת COSH
תַחבִּיר:
operation ::= `mhlo.cosh` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע פעולת COSH מבחינה אלמנטית ב- operand
Tensor ומייצר טנזור result
.
דוּגמָה:
%result = mhlo.cosh %operand : tensor<2x2xf32>
תכונות SameOperandsAndResultShape
CompatibleOperandsAndResultType
Elementwise
ממשקים: InferShapedTypeOpInterface
, InferTypeOpInterface
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי אלמנטים צף 32/64 סיביות |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם ערכי אלמנטים צף 32/64 סיביות |
mhlo.cosine
(mhlo :: cosineop)
פעולה קוסינוסית
תַחבִּיר:
operation ::= `mhlo.cosine` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע פעולת cosine מבחינה אלמנטית ב- operand
Tensor ומייצר טנזור result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#cosine
דוּגמָה:
%result = mhlo.cosine %operand : tensor<2xf32>
תכונות: AlwaysSpeculatableImplTrait
CompatibleOperandsAndResultType
, Elementwise
SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
result_accuracy | :: mlir :: mhlo :: actureccuracyattr | הדיוק המבוקש עבור Unary Ops. |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם אלמנטים צפים של 32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או סוג מורכב עם אלמנטים צפים של 32/64 סיב |
mhlo.count_leading_zeros
(mhlo :: clzop)
פעולת CLZ
תַחבִּיר:
operation ::= `mhlo.count_leading_zeros` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע ספירת אלמנט מבחינה אלמנטית של מספר חתיכות האפס המובילות במתחם operand
ומייצר טנזור result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#count_leading_zeros
דוּגמָה:
%result = mhlo.count_leading_zeros %operand : tensor<2x2xi8>
תכונות: AlwaysSpeculatableImplTrait
CompatibleOperandsAndResultType
, Elementwise
SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 2/4/8/16/32/64 סיביות ערכים שלם |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 2/4/8/16/32/64 סיביות ערכים שלם |
mhlo.create_token
(mhlo :: createTokenop)
מבצע CreateToken
תַחבִּיר:
operation ::= `mhlo.create_token` attr-dict `:` type(results)
פעולה זו בדרך החוצה מ- StableHlo, כך שהיא אינה כלולה במפרט: https://github.com/openxla/stablehlo/issues/3
באופן לא פורמלי, פעולה זו עושה את אותו הדבר כמו Afterellop עם 0 כניסות: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#after_all
דוּגמָה:
%output = mhlo.create_token : !mhlo.token
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
output | אֲסִימוֹן |
mhlo.cross-replica-sum
(mhlo :: crossreplicasumop)
פעולת CrossReplicasum
פעולה זו בדרך החוצה מ- StableHlo, כך שהיא אינה כלולה במפרט: https://github.com/openxla/stablehlo/issues/3
באופן לא פורמלי, פעולה זו עושה את אותו הדבר כמו allroduceop עם channel_id = 0
, use_global_device_ids = false
computation
יישום תוספת: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#all_reduceuce
דוּגמָה:
%result = "mhlo.cross-replica-sum"(%operand) {
replica_groups = dense<[[0, 1]]> : tensor<1x2xi64>
} : (tensor<4xf32>) -> tensor<4xf32>
תכונות: AlwaysSpeculatableImplTrait
CompatibleOperandsAndResultType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
replica_groups | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.custom_call
(mhlo :: customcallop)
פעולת CustomCall
תַחבִּיר:
operation ::= `mhlo.custom_call` custom<CustomCallTarget>($call_target_name) `(` $inputs `)`
attr-dict `:` functional-type(operands, results)
מכסה פעולה מוגדרת על ידי יישום call_target_name
שלוקח inputs
called_computations
ומניב results
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#custom_call
דוּגמָה:
%results = "mhlo.custom_call"(%input0) {
call_target_name = "foo",
has_side_effect = false,
backend_config = "bar",
api_version = 1 : i32,
called_computations = [@foo]
} : (tensor<f32>) -> tensor<f32>
A custom call invokes code external to XLA. The `inputs` are passed to the
external code, and the external code is expected to produce a result of the
given type. The exact mechanism is backend-specific. For example, in the CPU
backend, a call instruction is emitted which targets a symbol with the name
`call_target_name`.
If XLA runtime is enabled for a backend, then custom calls use the runtime
custom call calling convention to call into the external functions. This
calling convention defines an ABI for encoding arguments, attributes and
results.
Depending on the API version there are two ways to pass extra bits of static
information to the external function:
1. For `API_VERSION_TYPED_FFI` custom calls `backend_config` must be a
dictionary attribute, that will be encoded according to the custom call
calling convention and passed to the external function as the attributes
argument. External code is expected to use declarative bindings (see
`xla/runtime/custom_call.h`) to decode them at run time. These custom
calls are only supported if XLA uses XLA runtime.
2. For previous API versions it is the user responsibility to encode extra
bits of static information as a string `backend_config` attribute, and
decode it at run time.
ממשקים: MemoryEffectOpInterface
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
call_target_name | :: mlir :: stringattr | תכונה מחרוזת |
has_side_effect | :: mlir :: boolattr | תכונה Bool |
backend_config | :: mlir :: תכונה | תכונה מחרוזת או מילון של ערכי תכונה ששמו |
api_version | :: mlir :: mhlo :: CustomCallapiversionattr | גרסת API לשיחה בהתאמה אישית |
called_computations | :: mlir :: arrayattr | תכונה של מערך סמל שטוח |
custom_call_schedule | :: mlir :: mhlo :: customcallscheduleattr | מציין את לוח הזמנים הרצוי עבור השיחה המותאמת אישית. |
operand_layouts | :: mlir :: arrayattr | מערך הפריסה (טנזור 1D מסוג אינדקס) תכונות |
result_layouts | :: mlir :: arrayattr | מערך הפריסה (טנזור 1D מסוג אינדקס) תכונות |
output_operand_aliases | :: mlir :: arrayattr | תכונה של Aliasing עבור תפוקות ואופרות של CustomCall |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
inputs | משתנה של טנזור של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או שלם שלם או שלם שלם או 62/64/64/64/64/64/64/64/64/64/64-bit או 624/6 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או לטיפל שלם שלם או טופל אסימון או מקונן עם כל שילוב של טנסור של 4/6/8/16/32/64 סיביות או בול או 2/4/4/16/32/64 סיביות עם סוג 32/64 סיביות עם סוג 32/64-bib-32/64-bib או 64-bib-32/64-bit 32/64-bib או 64-bib או 264-64-64-64-644-644, מורכב, אלמנטים צפים או מספר שלם של מספר כמותי או לכל ציר שלם ערכים כמותיים או memRef של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | משתנה של טנזור של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או שלם שלם או שלם שלם או 62/64/64/64/64/64/64/64/64/64/64-bit או 624/6 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או לטיפל שלם שלם או טופל אסימון או מקונן עם כל שילוב של טנסור של 4/6/8/16/32/64 סיביות או בול או 2/4/4/16/32/64 סיביות עם סוג 32/64 סיביות עם סוג 32/64-bib-32/64-bib או 64-bib-32/64-bit 32/64-bib או 64-bib או 264-64-64-64-644-644, מורכב, אלמנטים צפים או מספר שלם של מספר כמותי או לכל ציר שלם ערכים כמותיים או memRef של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.divide
(mhlo :: divop)
פעולת DIV
תַחבִּיר:
operation ::= `mhlo.divide` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
מבצע את חלוקת האלמנטים של דיבידנד lhs
ו- Tensors rhs
מחלקים ומייצר טנזור result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#divide
דוּגמָה:
%result = mhlo.divide %lhs, %rhs : tensor<4xf32>
תכונות: AlwaysSpeculatableImplTrait
CompatibleOperandsAndResultType
, Elementwise
SameOperandsAndResultShape
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של מספר שלם של מספר 2/4/8/16/32/64 סיביות או 4/6/8/16/32/64 סיב |
rhs | טנזור מדורג של מספר שלם של מספר 2/4/8/16/32/64 סיביות או 4/6/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של מספר שלם של מספר 2/4/8/16/32/64 סיביות או 4/6/8/16/32/64 סיב |
mhlo.domain
(mhlo :: domainop)
פעולת דומיין
פעולה זו היא פרטית למהדר XLA, ולכן אין לה עדיין מפרט.
באופן לא פורמלי, פעולות אלה משמשות לקבוצת הוראות עם אותו נכס DomainMetadata. ShardingMetadata הוא מקרה השימוש העיקרי כיום כדי לקבץ הוראות באותו מכשיר. הוראות תחום מספקות שני יתרונות עיקריים:
- למנוע מיטוב של הוראות מיטוב שלא בכוונה על תחומים.
- הקצה אוטומטית את המטא נתונים של ההוראות שנוצרו בתחום. ללא הוראות תחום, כל מעבר אופטימיזציה של HLO יצטרך לבדוק ולהפיץ את המטא נתונים, שיהיה קל להחמיץ וגם מוסיף מורכבות למהדר. מכיוון שהוראות הדומיין מחברות בין שני תחומים שונים, כל הוראות תחום קשורות לשני DOMAINMETADATA - אחד בצד האופרנד ואחד בצד המשתמש של הדומיין.
תכונות: AlwaysSpeculatableImplTrait
CompatibleOperandsAndResultType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
kind | :: mlir :: mhlo :: domainkindattr | סוג של תחום metatdata המחובר לתחום HLO. |
entry_metadata | :: mlir :: stringattr | תכונה מחרוזת |
exit_metadata | :: mlir :: stringattr | תכונה מחרוזת |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או Bool או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים של שלם שלם או טנסור מדורגים של מספר שלם של שלל ציר או אריזור או אריזור או אריקים או אריקים או אריקים או אריקים או אריקים או אריקים או אריקים או Deke Deke או Deke Deke או Deke Deke או Tenked Akkיר או Tenked Ackerice Couther ערכים שלם של ציר. |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או Bool או 2/4/8/16/32/64 סיביות שלם או סוג מורכב עם אלמנטים צפים של 32/64 סיביות או ערכים כמותיים של שלם שלם או טנסור מדורגים של מספר שלם של שלל ציר או אריזור או אריזור או אריקים או אריקים או אריקים או אריקים או אריקים או אריקים או אריקים או Deke Deke או Deke Deke או Deke Deke או Tenked Akkיר או Tenked Ackerice Couther ערכים שלם של ציר. |
mhlo.dot
(mhlo :: dotop)
פעולת נקודה
פעולה זו בדרך החוצה מ- StableHlo, כך שהיא אינה כלולה במפרט: https://github.com/openxla/stablehlo/issues/3
באופן לא פורמלי, פעולה זו עושה את אותו הדבר כמו הנקודה של XLA: https://www.tensorflow.org/xla/operation_semantics#dot
דוּגמָה:
%0 = mhlo.dot %arg0, %arg1 : (tensor<1x2xi32>, tensor<2x1xi32>) -> tensor<1x1xi32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
precision_config | :: mlir :: arrayattr | תכונה של תצורת דיוק |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
rhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dot_general
(mhlo :: dotgeneralop)
מבצע דו -דקנרלי
מחשב מוצרי DOT בין פרוסות lhs
לפרוסות rhs
ומייצר טנזור result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#dot_general
דוּגמָה:
%result = "mhlo.dot_general"(%lhs, %rhs) {
dot_dimension_numbers = #mhlo.dot<
lhs_batching_dimensions = [0],
rhs_batching_dimensions = [0],
lhs_contracting_dimensions = [2],
rhs_contracting_dimensions = [1]
>,
precision_config = [#stablehlo<precision DEFAULT>, #stablehlo<precision DEFAULT>]
} : (tensor<2x2x2xi32>, tensor<2x2x2xi32>) -> tensor<2x2x2xi32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
dot_dimension_numbers | :: mlir :: mhlo :: dotdimensionnumbersattr | מייחס שמדגים את מידע הממד עבור DOT. |
precision_config | :: mlir :: arrayattr | תכונה של תצורת דיוק |
algorithm | :: mlir :: mhlo :: dotalgorithmattr | מייחס שמדגם את מגבלות האלגוריתמים שישמשו למחשוב נקודה. |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
rhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_broadcast_in_dim
(mhlo :: dynamicbroadcastindimop)
פעולת DynamicBroadcastIndim
פעולה זו זהה באופן פונקציונלי ל- Broadcast_in_dim OP, אך צורת התוצאה מוגדרת באופן דינמי באמצעות output_dimensions
.
היא גם מקבלת תכונות אופציונליות לביטוי ידע סטטי אודות התנהגות המתרחבת של הממדים. אם לא צוין, מניחים כי כל הממדים מתרחבים. מערכות הממדים שידוע כי מתרחבות ומערכת הממדים הידועה כבלתי מתרחשת חייבת להיות לא מתקדמת והם חייבים להיות תת-קבוצה של ממדי האופרנד.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#dynamic_broadcast_in_dim
דוּגמָה:
%operand = mhlo.constant dense<[[1, 2, 3]]> : tensor<1x3xi64>
%output_dimensions = mhlo.constant dense<[2, 3, 2]> : tensor<3xi64>
%result = "mhlo.dynamic_broadcast_in_dim"(%operand, %output_dimensions) {
broadcast_dimensions = array<i64: 2, 1>,
known_expanding_dimensions = array<i64: 0>,
known_nonexpanding_dimensions = array<i64: 1>
} : (tensor<1x3xi64>, tensor<3xi64>) -> tensor<2x3x2xi64>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
broadcast_dimensions | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
known_expanding_dimensions | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
known_nonexpanding_dimensions | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
output_dimensions | טנזור 1D של אינדקס או 2/4/8/16/32/64 סיביות ערכים שלמים |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_conv
(mhlo :: dynamicconvop)
פעולת DynamicConv
פעולה זו היא עבודה שמתבצעת, כך שהיא עדיין לא כלולה במפרט: https://github.com/openxla/stablehlo/issues/8
באופן לא פורמלי, פעולה זו עושה את אותו הדבר כמו convolutionop פרט לכך padding
מוגדר באופן דינמי באמצעות d_padding
: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#convultion
דוּגמָה:
%result = "mhlo.dynamic_conv"(%lhs, %rhs, %d_padding) {
window_strides = dense<4> : tensor<2xi64>,
lhs_dilation = dense<2> : tensor<2xi64>,
rhs_dilation = dense<1> : tensor<2xi64>,
window_reversal = dense<false> : tensor<2xi1>,
dimension_numbers = #mhlo.conv<[b, 0, 1, f]x[0, 1, i, o]->[b, 0, 1, f]>,
feature_group_count = 1 : i64,
batch_group_count = 1 : i64,
precision_config = [#stablehlo<precision DEFAULT>, #stablehlo<precision DEFAULT>]
} : (tensor<1x4x4x1xi32>, tensor<3x3x1x1xi32>, tensor<2x2xi64>) -> tensor<1x2x2x1xi32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
window_strides | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
padding | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
lhs_dilation | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
rhs_dilation | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
window_reversal | :: mlir :: denseelementsattr | תכונה וקטורית בוליאנית/טנסור קבועה |
dimension_numbers | :: mlir :: mhlo :: convdimensionnumbersattr | מבנה מידע על מימד עבור conv op |
feature_group_count | :: mlir :: integerattr | תכונה שלמה שלמה חסרת סיביות של 64 סיביות שערכתה חיובית |
batch_group_count | :: mlir :: integerattr | תכונה שלמה שלמה חסרת סיביות של 64 סיביות שערכתה חיובית |
precision_config | :: mlir :: arrayattr | תכונה של תצורת דיוק |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
rhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
d_padding | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_gather
(mhlo :: dynamicgatherop)
פעולת Dynamicgather
פעולה זו היא עבודה שמתבצעת, כך שהיא עדיין לא כלולה במפרט: https://github.com/openxla/stablehlo/issues/8
באופן לא פורמלי, פעולה זו עושה את אותו הדבר כמו איסוף פרט לכך ש- slice_sizes
מוגדרים באופן דינמי: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#gather
דוּגמָה:
%result = "mhlo.dynamic_gather"(%operand, %start_indices, %slice_sizes) {
dimension_numbers = #mhlo.gather<
offset_dims = [2, 3],
collapsed_slice_dims = [0],
start_index_map = [0, 2],
index_vector_dim = 2>,
indices_are_sorted = false
} : (tensor<3x4x2xi32>, tensor<2x3x2xi64>, tensor<3xi64>) -> tensor<2x3x2x2xi32>
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
dimension_numbers | :: mlir :: mhlo :: asdlicdimensionNumberSattr | מייחס שמדגמן את מידע הממד לאיסוף |
indices_are_sorted | :: mlir :: boolattr | תכונה Bool |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
start_indices | טנזור מדורג של 2/4/8/16/32/64 סיביות ערכים שלם |
slice_sizes | טנזור שלם שלם של מספר דו-ממדי מעוצב סטטי של 2/4/8/16/32/64 סיביות ערכים שלמים שלמים |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_iota
(mhlo :: dynamiciotaop)
פעולת Dynamiciota
פעולה זו זהה באופן פונקציונלי ל- IOTA OP, אך צורת התוצאה מוגדרת באופן דינמי באמצעות output_shape
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#dynamic_iota
דוּגמָה:
%0 = mhlo.dynamic_iota %arg0, dim = 0 : (tensor<1xindex>) -> tensor<4xi32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
iota_dimension | :: mlir :: integerattr | תכונה שלם שלם של מספר שלם 64 סיביות שערכתה אינה שלילית |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
output_shape | טנזור 1D של אינדקס או 2/4/8/16/32/64 סיביות ערכים שלמים |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_pad
(mhlo :: dynamicpadop)
פעולת DynamicPad
תַחבִּיר:
operation ::= `mhlo.dynamic_pad` operands attr-dict `:` functional-type(operands, results)
באופן דינמי רפידות את operand
, עם כמות הריפוד שנוספה בקצה נמוך/מקצה/פנים מועבר דרך טנזורי קלט.
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
padding_value | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
edge_padding_low | טנזור 1D של אינדקס או 2/4/8/16/32/64 סיביות ערכים שלמים |
edge_padding_high | טנזור 1D של אינדקס או 2/4/8/16/32/64 סיביות ערכים שלמים |
interior_padding | טנזור 1D של אינדקס או 2/4/8/16/32/64 סיביות ערכים שלמים |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_reshape
(mhlo :: dynamicreshapeop)
פעולת DynamicReshape
תַחבִּיר:
operation ::= `mhlo.dynamic_reshape` operands attr-dict `:` functional-type(operands, results)
פעולה זו זהה באופן פונקציונלי לעיצוב מחדש של OP, אך צורת התוצאה מוגדרת באופן דינמי באמצעות output_shape
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#dynamic_reshape
דוּגמָה:
%output_shape = mhlo.constant dense<[3, 2]> : tensor<2xi64>
%result = mhlo.dynamic_reshape %operand, %output_shape : (tensor<2x3xi64>, tensor<2xi64>) -> tensor<3x2xi64>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
output_shape | טנזור 1D של אינדקס או 2/4/8/16/32/64 סיביות ערכים שלמים |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_slice
(mhlo :: dynamicsliceop)
פעולת Dynamicslice
מחלץ פרוסה operand
באמצעות מדדי התחלה מחושבים באופן דינמי ומייצר טנזור result
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#dynamic_slice
דוּגמָה:
%result = mhlo.dynamic_slice %operand, %start_indices0, %start_indices1, sizes = [2, 2]
: (tensor<4x4xi32>, tensor<i64>, tensor<i64>) -> tensor<2x2xi32>
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
slice_sizes | :: mlir :: densintelementsattr | תכונה של תכונה של מספר שלם שלם 64 סיביות |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
start_indices | variadic של טנזור 0D של 2/4/8/16/32/64 סיביות ערכי מספר שלם |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.dynamic_update_slice
(mhlo :: dynamicupdatesliceop)
פעולת DynamicupDatesLice
תַחבִּיר:
operation ::= `mhlo.dynamic_update_slice` operands attr-dict `:` functional-type(operands, results)
מייצר טנזור result
השווה לטנזור operand
פרט לכך שהפרוסת המתחילה ב- start_indices
מתעדכנת עם הערכים update
.
ראו: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#dynamic_update_slice
דוּגמָה:
%result = mhlo.dynamic_update_slice %operand, %update, %start_indices0, %start_indices1
: (tensor<4x4xi32>, tensor<2x2xi32>, tensor<i64>, tensor<i64>) -> tensor<4x4xi32>
תכונות: AlwaysSpeculatableImplTrait
, InferTensorType
ממשקים: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
אופרנדים:
אופרנד | תֵאוּר |
---|---|
operand | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
update | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
start_indices | variadic של טנזור 0D של 2/4/8/16/32/64 סיביות ערכי מספר שלם |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.einsum
(mhlo :: einsumop)
פעולת EINSUM
פעולה זו בדרך החוצה מ- StableHlo, כך שהיא אינה כלולה במפרט: https://github.com/openxla/stablehlo/issues/3
באופן לא פורמלי, פעולה זו עושה את אותו הדבר כמו ה- Einsum של TF: https://www.tensorflow.org/api_docs/python/tf/einsum
דוּגמָה:
%result = "mhlo.einsum"(%lhs, %rhs) {
einsum_config = "ab,bc->ac"
} : (tensor<4x16xf32>, tensor<16x4xf32>) -> tensor<4x4xf32>
תכונות: AlwaysSpeculatableImplTrait
ממשקים: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
אפקטים: MemoryEffects::Effect{}
תכונות:
תְכוּנָה | סוג MLIR | תֵאוּר |
---|---|---|
einsum_config | :: mlir :: stringattr | תכונה מחרוזת |
אופרנדים:
אופרנד | תֵאוּר |
---|---|
lhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
rhs | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«ללא שם» | טנזור מדורג של 4/6/8/16/32/64 סיביות צף או בול או 2/4/8/16/32/64 סיב |
mhlo.erf
(mhlo :: erfop)
פעולת ERF
תַחבִּיר:
operation ::= `mhlo.erf` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
מבצע פעולת ERF מבחינה אלמנטית ב- operand
Tensor ומייצר טנזור result
.
דוּגמָה:
%result = mhlo.erf %operand : tensor<2x2xf32>
תכונות: AlwaysSpeculatableImplTrait
CompatibleOperandsAndResultType
, Elementwise
SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float values |
mhlo.exponential
(mhlo::ExpOp)
Exp operation
תַחבִּיר:
operation ::= `mhlo.exponential` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise exponential operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#exponential
דוּגמָה:
%result = mhlo.exponential %operand : tensor<2x2xf64>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.exponential_minus_one
(mhlo::Expm1Op)
Expm1 operation
תַחבִּיר:
operation ::= `mhlo.exponential_minus_one` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise exponential minus one operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#exponential_minus_one
דוּגמָה:
%result = mhlo.exponential_minus_one %operand : tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.fft
(mhlo::FftOp)
Fft operation
Performs the forward and inverse Fourier transforms for real and complex inputs/outputs.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#fft
דוּגמָה:
%result = mhlo.fft %operand, type = FFT, length = [4] : (tensor<4xcomplex<f32>>) -> tensor<4xcomplex<f32>>
Traits: AlwaysSpeculatableImplTrait
, InferTensorType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
fft_type | ::mlir::mhlo::FftTypeAttr | XLA fast fourier transform type. |
fft_length | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.floor
(mhlo::FloorOp)
Floor operation
תַחבִּיר:
operation ::= `mhlo.floor` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise floor of operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#floor
דוּגמָה:
%result = mhlo.floor %operand : tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or per-tensor integer quantized values |
mhlo.fusion
(mhlo::FusionOp)
Fusion operation
This operation is private to the XLA compiler, so it is does not yet have a specification.
Informally, this operation consists of a group of basic ops (represented as a region attached to it). It serves as a hint to the backend that it is beneficial to emit the contained ops into a single loop nest or kernel.
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
fusion_kind | ::mlir::mhlo::FusionKindAttr | fusion kind |
output_operand_aliases | ::mlir::ArrayAttr | Aliasing attribute for outputs and operands of Fusion |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
results | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values or nested tuple with any combination of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token values |
mhlo.gather
(mhlo::GatherOp)
Gather operation
Gathers slices from operand
tensor from offsets specified in start_indices
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#gather
דוּגמָה:
%result = "mhlo.gather"(%operand, %start_indices) {
dimension_numbers = #stablehlo.gather<
offset_dims = [3, 4],
collapsed_slice_dims = [1],
operand_batching_dims = [0],
start_indices_batching_dims = [1],
start_index_map = [2, 1],
index_vector_dim = 3>,
slice_sizes = dense<[0, 2, 2]> : tensor<3xi64>,
indices_are_sorted = false
} : (tensor<2x3x4x2xi64>, tensor<2x2x3x2xi64>) -> tensor<2x2x3x2x2xi64>
Traits: AlwaysSpeculatableImplTrait
, InferTensorType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dimension_numbers | ::mlir::mhlo::GatherDimensionNumbersAttr | Attribute that models the dimension information for gather |
slice_sizes | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
indices_are_sorted | ::mlir::BoolAttr | bool attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
start_indices | ranked tensor of 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.get_dimension_size
(mhlo::GetDimensionSizeOp)
GetDimensionSize operation
Produces the size of the given dimension
of the operand
.
See https://github.com/openxla/stablehlo/blob/main/docs/spec.md#get_dimension_size
דוּגמָה:
%result = mhlo.get_dimension_size %operand, dim = 1 : (tensor<2x3xf32>) -> tensor<i32>
Traits: AlwaysSpeculatableImplTrait
, InferTensorType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dimension | ::mlir::IntegerAttr | 64-bit signless integer attribute whose value is non-negative |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | tensor of 32-bit signless integer values |
mhlo.get_tuple_element
(mhlo::GetTupleElementOp)
GetTupleElement operation
תַחבִּיר:
operation ::= `mhlo.get_tuple_element` $operand `[` $index `]` attr-dict `:` functional-type(operands, results)
Extracts element at index
position of the operand
tuple and produces a result
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#get_tuple_element
דוּגמָה:
%result = mhlo.get_tuple_element %operand[0] : (tuple<tensor<2xf32>, tuple<tensor<i32>>>) -> tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
index | ::mlir::IntegerAttr | 32-bit signless integer attribute whose value is non-negative |
Operands:
Operand | תֵאוּר |
---|---|
operand | nested tuple with any combination of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values or token or nested tuple with any combination of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.if
(mhlo::IfOp)
If operation
Produces the output from executing exactly one branch from true_branch
or false_branch
depending on the value of pred
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#if
Example: %result = "mhlo.if"(%pred) ({ "mhlo.return"(%result_true_branch) : (tensor
Traits: RecursiveMemoryEffects
, SingleBlockImplicitTerminator<ReturnOp>
, SingleBlock
Interfaces: InferTypeOpInterface
Operands:
Operand | תֵאוּר |
---|---|
pred | ranked tensor of bool values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token |
mhlo.imag
(mhlo::ImagOp)
Imag operation
תַחבִּיר:
operation ::= `mhlo.imag` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Extracts the imaginary part, element-wise, from the operand
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#imag
דוּגמָה:
%result = mhlo.imag %operand : (tensor<2xcomplex<f32>>) -> tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float values |
mhlo.infeed
(mhlo::InfeedOp)
Infeed operation
Reads data from the infeed and produces results
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#infeed
דוּגמָה:
%results:2 = "mhlo.infeed"(%token) {
infeed_config = ""
} : (!mhlo.token) -> (tensor<3x3x3xi32>, !mhlo.token)
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
infeed_config | ::mlir::StringAttr | string attribute |
layout | ::mlir::ArrayAttr | array attribute |
Operands:
Operand | תֵאוּר |
---|---|
token | אֲסִימוֹן |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of statically shaped tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or statically shaped tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values or token |
mhlo.iota
(mhlo::IotaOp)
Iota operation
Fills an output
tensor with values in increasing order starting from zero along the iota_dimension
dimension.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#iota
דוּגמָה:
%output = mhlo.iota dim = 0 : tensor<4x5xi32>
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
iota_dimension | ::mlir::IntegerAttr | 64-bit signless integer attribute whose value is non-negative |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
output | statically shaped tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
mhlo.is_finite
(mhlo::IsFiniteOp)
IsFinite operation
תַחבִּיר:
operation ::= `mhlo.is_finite` $x attr-dict `:` functional-type(operands, results)
Performs element-wise check whether the value in x
is finite (ie is neither +Inf, -Inf, nor NaN) and produces a y
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#is_finite
דוּגמָה:
%y = mhlo.is_finite %x : (tensor<7xf32>) -> tensor<7xi1>
Traits: AlwaysSpeculatableImplTrait
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
x | ranked tensor of 4/6/8/16/32/64-bit float values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
y | ranked tensor of bool values |
mhlo.log
(mhlo::LogOp)
Log operation
תַחבִּיר:
operation ::= `mhlo.log` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise logarithm operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#log
דוּגמָה:
%result = mhlo.log %operand : tensor<2x2xf64>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.log_plus_one
(mhlo::Log1pOp)
Log1p operation
תַחבִּיר:
operation ::= `mhlo.log_plus_one` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise logarithm plus one operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#log_plus_one
דוּגמָה:
%result = mhlo.log_plus_one %operand : tensor<6xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.logistic
(mhlo::LogisticOp)
Logistic operation
תַחבִּיר:
operation ::= `mhlo.logistic` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise logistic operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#logistic
דוּגמָה:
%result = mhlo.logistic %operand : tensor<2x2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.map
(mhlo::MapOp)
Map operation
Applies a map function computation
to inputs
along the dimensions
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#map
דוּגמָה:
%result = "mhlo.map"(%input0, %input1) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = mhlo.multiply %arg0, %arg1 : tensor<i32>
mhlo.return %0 : tensor<i32>
}) {
dimensions = dense<[0, 1]> : tensor<2xi64>
} : (tensor<2x2xi32>, tensor<2x2xi32>) -> tensor<2x2xi32>
Traits: InferTensorType
, RecursiveMemoryEffects
, SameOperandsAndResultShape
, SingleBlockImplicitTerminator<ReturnOp>
, SingleBlock
Interfaces: InferShapedTypeOpInterface
, InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dimensions | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.maximum
(mhlo::MaxOp)
Max operation
תַחבִּיר:
operation ::= `mhlo.maximum` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise max operation on tensors lhs
and rhs
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#maximum
דוּגמָה:
%result = mhlo.maximum %lhs, %rhs : tensor<4xf32>
Traits: AlwaysSpeculatableImplTrait
, Commutative
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
rhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.minimum
(mhlo::MinOp)
Min operation
תַחבִּיר:
operation ::= `mhlo.minimum` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise min operation on tensors lhs
and rhs
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#minimum
דוּגמָה:
%result = mhlo.minimum %lhs, %rhs : tensor<4xf32>
Traits: AlwaysSpeculatableImplTrait
, Commutative
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
rhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.minimum_broadcast_shapes
(mhlo::MinimumBroadcastShapesOp)
Minimizes the rank of two or more shapes to be broadcasted
תַחבִּיר:
operation ::= `mhlo.minimum_broadcast_shapes` $shapes attr-dict `:` type($shapes) `->` type($results)
Given two or more 1D tensors representing shapes, returns one 1D tensor for each operand, where operand i
corresponds to output i
.
The returned tensors have the property that they specify a shape which is a reshape of the corresponding input shape, and the broadcasted output shape (using shape::BroadcastOp) of the returned shapes is a reshape of the broadcasted output shape of the input shapes. Among all possibilities with this property, the one is chosen which minimizes the rank of each returned shape.
The general idea of this op is that it can be used for ops which have a broadcasting semantic to operate on shapes with a possibly smaller rank while preserving equivalence of the computed values. After computing the result of the op using reshaped operands, the result can be reshaped to the result that would have been originally computed.
Here is an example with two input shapes:
mhlo.minimum_broadcast_shapes [1, 2, 3, 1, 2, 1],
[1, 1, 1, 2, 3] -> [6, 2, 1], [2, 3]
The broadcasted output shape of the operands is [1, 2, 3, 1, 2, 3], the broadcasted output shape of the outputs is [6, 2, 3]. These two shapes are reshapes of each other, and also each output is a reshape of the corresponding input.
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
shapes | variadic of 1D tensor of index values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
results | variadic of 1D tensor of index values |
mhlo.multiply
(mhlo::MulOp)
Mul operation
תַחבִּיר:
operation ::= `mhlo.multiply` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise product of two tensors lhs
and rhs
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#multiply
דוּגמָה:
%result = mhlo.multiply %lhs, %rhs : tensor<2xi32>
Traits: AlwaysSpeculatableImplTrait
, Commutative
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
rhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.negate
(mhlo::NegOp)
Neg operation
תַחבִּיר:
operation ::= `mhlo.negate` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise negation of operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#negate
דוּגמָה:
%result = mhlo.negate %operand : tensor<2x3xi32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.not
(mhlo::NotOp)
Not operation
תַחבִּיר:
operation ::= `mhlo.not` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise NOT of tensor operand
of type integer and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#not
דוּגמָה:
%result = mhlo.not %operand : tensor<5x3x1xi1>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of bool or 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of bool or 2/4/8/16/32/64-bit integer values |
mhlo.optimization_barrier
(mhlo::OptimizationBarrierOp)
OptimizationBarrier operation
תַחבִּיר:
operation ::= `mhlo.optimization_barrier` attr-dict ($operand^ `:` custom<PairwiseOpType>(type($operand), type($result))):(`(` `)`)?
Ensures that the operations that produce the operand
are executed before any operations that depend on the result
and prevents compiler transformations from moving operations across the barrier. Other than that, the operation is an identity, ie result
= operand
.
See https://github.com/openxla/stablehlo/blob/main/docs/spec.md#optimization_barrier
דוּגמָה:
%result0, %result1 = mhlo.optimization_barrier %operand0, %operand1 : tensor<f32>, tensor<f32>
Traits: AlwaysSpeculatableImplTrait
, HLO_PairwiseSameOperandAndResultType
Interfaces: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token |
mhlo.or
(mhlo::OrOp)
Or operation
תַחבִּיר:
operation ::= `mhlo.or` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise OR of two tensors lhs
and rhs
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#or
דוּגמָה:
%result = mhlo.or %lhs, %rhs : tensor<2xi1>
Traits: AlwaysSpeculatableImplTrait
, Commutative
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of bool or 2/4/8/16/32/64-bit integer values |
rhs | ranked tensor of bool or 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.outfeed
(mhlo::OutfeedOp)
Outfeed operation
Writes inputs
to the outfeed and produces a result
token.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#outfeed
דוּגמָה:
%result = "mhlo.outfeed"(%input0, %token) {
outfeed_config = ""
} : (tensor<3x3x3xi32>, !mhlo.token) -> !mhlo.token
Interfaces: InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
outfeed_config | ::mlir::StringAttr | string attribute |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
token | אֲסִימוֹן |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | אֲסִימוֹן |
mhlo.pad
(mhlo::PadOp)
Pad operation
Expands operand
by padding around the tensor as well as between the elements of the tensor with the given padding_value
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#pad
דוּגמָה:
%0 = mhlo.pad %arg0, %arg1, low = [0, 1], high = [2, 1], interior = [1, 2]
: (tensor<2x3xi32>, tensor<i32>) -> tensor<5x9xi32>
Traits: AlwaysSpeculatableImplTrait
, SameOperandsAndResultElementType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
edge_padding_low | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
edge_padding_high | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
interior_padding | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
padding_value | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.partition_id
(mhlo::PartitionIdOp)
PartitionId operation
תַחבִּיר:
operation ::= `mhlo.partition_id` attr-dict `:` type(results)
Produces partition_id
of the current process.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#partition_id
דוּגמָה:
%result = mhlo.partition_id : tensor<ui32>
Interfaces: InferTypeOpInterface
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 32-bit unsigned integer values |
mhlo.popcnt
(mhlo::PopulationCountOp)
PopulationCount operation
תַחבִּיר:
operation ::= `mhlo.popcnt` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise count of the number of bits set in the operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#popcnt
דוּגמָה:
%result = mhlo.popcnt %operand : tensor<4xi8>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer values |
mhlo.power
(mhlo::PowOp)
Pow operation
תַחבִּיר:
operation ::= `mhlo.power` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise exponentiation of lhs
tensor by rhs
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#power
דוּגמָה:
%result = mhlo.power %lhs, %rhs : tensor<6xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
rhs | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.ragged_dot
(mhlo::RaggedDotOp)
Ragged matrix multiplication over a single ragged dimension
This operation takes three tensor args---lhs, rhs, and group_sizes---and a "ragged_dot_dimension_numbers" attribute. Like dot_general, the lhs and rhs are allowed arbitrary batch and contracting dimensions. Additionally, the lhs is required to have one ragged dimension, and the rhs may have at most one group dimension. The op has three modes, depending on the kind of the lhs ragged dimension.
In mode 1, the shape-signature is [b,m,k], [g,b,k,n], [b,g] -> [b,m,n]
. Here the ragged dimension is an lhs non-contracting dimension ( m
). The dimensions b
and k
represent batch and contracting dimensions respectively. The rhs is required to have a group dimension ( g
).
In mode 2, the shape-signature is [b,m,k], [b,k,n], [b,g] -> [g,b,m,n]
. Here the ragged dimension is an lhs/rhs contracting dimension ( k
).
In mode 3, the shape-signature is [b,m,k], [b,k,n], [g] -> [b,m,n]
. Here the ragged dimension is an lhs/rhs batch dimension ( b
).
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
ragged_dot_dimension_numbers | ::mlir::mhlo::RaggedDotDimensionNumbersAttr | Attribute that models the dimension information for ragged dot. |
precision_config | ::mlir::ArrayAttr | Precision Config attribute |
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
rhs | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
group_sizes | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.real
(mhlo::RealOp)
Real operation
תַחבִּיר:
operation ::= `mhlo.real` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Extracts the real part, element-wise, from the operand
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#real
דוּגמָה:
%result = mhlo.real %operand : (tensor<2xcomplex<f32>>) -> tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float values |
mhlo.real_dynamic_slice
(mhlo::RealDynamicSliceOp)
RealDynamicSlice operation
תַחבִּיר:
operation ::= `mhlo.real_dynamic_slice` operands attr-dict `:` functional-type(operands, results)
This operation is a work in progress, so it is not yet included in the specification: https://github.com/openxla/stablehlo/issues/8
Informally, this operation does the same thing as SliceOp except that start_indices
, limit_indices
and strides
are specified dynamically: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#slice
דוּגמָה:
%result = mhlo.real_dynamic_slice %operand,
%start_indices, %limit_indices, %strides
: (tensor<256x?xf32>, tensor<2xindex>, tensor<2xindex>, tensor<2xindex>) -> tensor<256x?xf32>
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
start_indices | 1D tensor of index or 2/4/8/16/32/64-bit integer values |
limit_indices | 1D tensor of index or 2/4/8/16/32/64-bit integer values |
strides | 1D tensor of index or 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.recv
(mhlo::RecvOp)
Recv operation
Receives data from a channel with channel_id
and produces results
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#recv
דוּגמָה:
%results:2 = "mhlo.recv"(%token) {
// channel_id = 5 : i64,
// channel_type = #stablehlo<channel_type DEVICE_TO_DEVICE>,
channel_handle = #mhlo.channel_handle<handle = 5, type = 1>,
is_host_transfer = false,
source_target_pairs = dense<[[0, 1], [1, 2]]> : tensor<2x2xi64>
} : (!mhlo.token) -> (tensor<3x4xi32>, !mhlo.token)
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
channel_handle | ::mlir::mhlo::ChannelHandleAttr | two 64-bit integers 'handle' and 'type' |
is_host_transfer | ::mlir::BoolAttr | bool attribute |
source_target_pairs | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
token | אֲסִימוֹן |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of statically shaped tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or statically shaped tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values or token |
mhlo.reduce
(mhlo::ReduceOp)
Reduce operation
Applies a reduction function body
to inputs
and init_values
along the dimensions
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#reduce
דוּגמָה:
%result = "mhlo.reduce"(%input, %init_value) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = "mhlo.add"(%arg0, %arg1) : (tensor<i32>, tensor<i32>) -> tensor<i32>
"mhlo.return"(%0) : (tensor<i32>) -> ()
}) {
dimensions = dense<1> : tensor<1xi64>
} : (tensor<1x6xi32>, tensor<i32>) -> tensor<1xi32>
Traits: InferTensorType
, RecursiveMemoryEffects
, SameVariadicOperandSize
, SingleBlockImplicitTerminator<ReturnOp>
, SingleBlock
Interfaces: InferShapedTypeOpInterface
, InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dimensions | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
init_values | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.reduce_precision
(mhlo::ReducePrecisionOp)
ReducePrecision operation
תַחבִּיר:
operation ::= `mhlo.reduce_precision` $operand `,` `format` `=` custom<ExponentMantissa>($exponent_bits, $mantissa_bits)
attr-dict `:` custom<SameOperandsAndResultType>(type($operand), type($output))
Performs element-wise conversion of operand
to another floating-point type that uses exponent_bits
and mantissa_bits
and back to the original floating-point type and produces an output
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#reduce_precision
דוּגמָה:
%output = mhlo.reduce_precision %operand, format = e5m2 : tensor<6xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
exponent_bits | ::mlir::IntegerAttr | 32-bit signless integer attribute whose value is positive |
mantissa_bits | ::mlir::IntegerAttr | 32-bit signless integer attribute whose value is non-negative |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
output | ranked tensor of 4/6/8/16/32/64-bit float values |
mhlo.reduce_scatter
(mhlo::ReduceScatterOp)
ReduceScatter operation
Within each process group in the process grid, performs reduction, using computations
, over the values of the operand
tensor from each process, splits the reduction result along scatter_dimension
into parts, and scatters the split parts between the processes to produce the result
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#reduce_scatter
דוּגמָה:
%result = "mhlo.reduce_scatter"(%operand) ({
^bb0(%arg0: tensor<f32>, %arg1: tensor<f32>):
%0 = mhlo.add %arg0, %arg1 : tensor<f32>
mhlo.return %0 : tensor<f32>
}) {
scatter_dimension = 1 : i64,
replica_groups = dense<[[0, 1]]> : tensor<1x2xi64>,
// channel_id = 0
channel_handle = #mhlo.channel_handle<handle = 0, type = 0>
// use_global_device_ids = false
} : (tensor<2x4xf32>) -> tensor<2x2xf32>
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
scatter_dimension | ::mlir::IntegerAttr | 64-bit signless integer attribute whose value is non-negative |
replica_groups | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
channel_handle | ::mlir::mhlo::ChannelHandleAttr | two 64-bit integers 'handle' and 'type' |
use_global_device_ids | ::mlir::UnitAttr | unit attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.reduce_window
(mhlo::ReduceWindowOp)
ReduceWindow operation
Applies a reduction function body
to windows of inputs
and init_values
and produces results
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#reduce_window
דוּגמָה:
%result = "mhlo.reduce_window"(%input, %init_value) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = mhlo.add %arg0, %arg1 : tensor<i32>
mhlo.return %0 : tensor<i32>
}) {
window_dimensions = dense<[2, 1]> : tensor<2xi64>,
window_strides = dense<[4, 1]> : tensor<2xi64>,
base_dilations = dense<[2, 1]> : tensor<2xi64>,
window_dilations = dense<[3, 1]> : tensor<2xi64>,
padding = dense<[[2, 1], [0, 0]]> : tensor<2x2xi64>
} : (tensor<3x2xi32>, tensor<i32>) -> tensor<2x2xi32>
Traits: InferTensorType
, RecursiveMemoryEffects
, SameVariadicOperandSize
, SingleBlockImplicitTerminator<ReturnOp>
, SingleBlock
Interfaces: InferShapedTypeOpInterface
, InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
window_dimensions | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
window_strides | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
base_dilations | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
window_dilations | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
padding | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
init_values | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.remainder
(mhlo::RemOp)
Rem operation
תַחבִּיר:
operation ::= `mhlo.remainder` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise remainder of dividend lhs
and divisor rhs
tensors and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#remainder
דוּגמָה:
%result = mhlo.remainder %lhs, %rhs : tensor<4xi64>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
rhs | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.replica_id
(mhlo::ReplicaIdOp)
ReplicaId operation
תַחבִּיר:
operation ::= `mhlo.replica_id` attr-dict `:` type(results)
Produces replica_id
of the current process.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#replica_id
דוּגמָה:
%result = mhlo.replica_id : tensor<ui32>
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 32-bit unsigned integer values |
mhlo.reshape
(mhlo::ReshapeOp)
Reshape operation
תַחבִּיר:
operation ::= `mhlo.reshape` operands attr-dict `:` functional-type(operands, results)
Performs reshape of operand
tensor to a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#reshape
דוּגמָה:
%result = mhlo.reshape %operand : (tensor<2xf32>) -> tensor<1x2xf32>
Traits: AlwaysSpeculatableImplTrait
, HLO_CompatibleOperandsAndResultElementType
Interfaces: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | statically shaped or single bounded dimension tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.return
(mhlo::ReturnOp)
_This operation is a work in progress, so it is not yet included in the specification: https://github.com/openxla/stablehlo/issues/425
Informally, this operation serves as a terminator for regions defined by
the StableHLO ops. Non-StableHLO ops, e.g. `func.func`, have their own
terminators, e.g. `func.return`.
Example:
```mlir
%result = "mhlo.reduce"(%input, %init_value) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = "mhlo.add"(%arg0, %arg1) : (tensor<i32>, tensor<i32>) -> tensor<i32>
"mhlo.return"(%0) : (tensor<i32>) -> ()
}) {
dimensions = dense<1> : tensor<1xi64>
} : (tensor<1x6xi32>, tensor<i32>) -> tensor<1xi32>
```_
Syntax:
```
operation ::= mhlo.return
$results attr-dict ( :
type($results)^)?
Traits: `AlwaysSpeculatableImplTrait`, `Terminator`
Interfaces: `ConditionallySpeculatable`, `NoMemoryEffect (MemoryEffectOpInterface)`
Effects: `MemoryEffects::Effect{}`
#### Operands:
| Operand | Description |
| :-----: | ----------- |
| `results` | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values or token or nested tuple with any combination of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values |
### `mhlo.reverse` (mhlo::ReverseOp)
_Reverse operation_
Reverses the order of elements in the `operand` along the specified
`dimensions` and produces a `result` tensor.
See:
<a href="https://github.com/openxla/stablehlo/blob/main/docs/spec.md#reverse">https://github.com/openxla/stablehlo/blob/main/docs/spec.md#reverse</a>
Example:
```mlir
%result = mhlo.reverse %operand, dims = [1] : tensor<3x2xi32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dimensions | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.rng
(mhlo::RngOp)
Rng operation
Generates random numbers using the rng_distribution
algorithm and produces a result
tensor of a given shape shape
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#rng
דוּגמָה:
%result = mhlo.rng %a, %b, %shape, distribution = NORMAL : (tensor<i32>, tensor<i32>, tensor<2xi64>) -> tensor<3x3xi32>
Traits: InferTensorType
Interfaces: InferShapedTypeOpInterface
, InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
rng_distribution | ::mlir::mhlo::RngDistributionAttr | XLA PRNG distribution to be used. |
Operands:
Operand | תֵאוּר |
---|---|
a | 0D tensor of bool or 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float values |
b | 0D tensor of bool or 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float values |
shape | 1D tensor of index or 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of bool or 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float values |
mhlo.rng_bit_generator
(mhlo::RngBitGeneratorOp)
RngBitGenerator operation
Returns an output
filled with uniform random data and an updated output state output_state
given an initial state initial_state
using the pseudorandom number generator algorithm rng_algorithm
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#rng_bit_generator
דוּגמָה:
%output_state, %output = mhlo.rng_bit_generator %initial_state, algorithm = THREE_FRY : (tensor<2xui64>) -> (tensor<2xui64>, tensor<2x2xui64>)
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
rng_algorithm | ::mlir::mhlo::RngAlgorithmAttr | XLA PRNG algorithm to be used. |
Operands:
Operand | תֵאוּר |
---|---|
initial_state | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
output_state | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float values |
output | statically shaped tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float values |
mhlo.round_nearest_afz
(mhlo::RoundOp)
Round operation
תַחבִּיר:
operation ::= `mhlo.round_nearest_afz` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise rounding towards the nearest integer, breaking ties away from zero, on the operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#round_nearest_afz
דוּגמָה:
%result = mhlo.round_nearest_afz %operand : tensor<5xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float values |
mhlo.round_nearest_even
(mhlo::RoundNearestEvenOp)
RoundNearestEven operation
תַחבִּיר:
operation ::= `mhlo.round_nearest_even` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise rounding towards the nearest integer, breaking ties towards the even integer, on the operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#round_nearest_even
דוּגמָה:
%result = mhlo.round_nearest_even %operand : tensor<5xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float values |
mhlo.rsqrt
(mhlo::RsqrtOp)
Rsqrt operation
תַחבִּיר:
operation ::= `mhlo.rsqrt` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise reciprocal square root operation on operand
tensor and produces a result
tensor, implementing the rSqrt
operation from the IEEE-754 specification.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#rsqrt
דוּגמָה:
%result = mhlo.rsqrt %operand : tensor<2x2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.scatter
(mhlo::ScatterOp)
Scatter operation
Produces results
tensors which are equal to inputs
tensors except that several slices specified by scatter_indices
are updated with the values updates
using update_computation
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#scatter
דוּגמָה:
%result = "mhlo.scatter"(%input, %scatter_indices, %update) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = mhlo.add %arg0, %arg1 : tensor<i32>
mhlo.return %0 : tensor<i32>
}) {
scatter_dimension_numbers = #mhlo.scatter<
update_window_dims = [3, 4],
inserted_window_dims = [1],
input_batching_dims = [0],
scatter_indices_batching_dims = [1],
scatter_dims_to_operand_dims = [2, 1],
index_vector_dim = 3>,
indices_are_sorted = false,
unique_indices = false
} : (tensor<2x3x4x2xi64>, tensor<2x2x3x2xi64>, tensor<2x2x3x2x2xi64>) -> tensor<2x3x4x2xi64>
Traits: RecursiveMemoryEffects
, SameVariadicOperandSize
Interfaces: InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
scatter_dimension_numbers | ::mlir::mhlo::ScatterDimensionNumbersAttr | Attribute that models the dimension information for scatter |
indices_are_sorted | ::mlir::BoolAttr | bool attribute |
unique_indices | ::mlir::BoolAttr | bool attribute |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
scatter_indices | ranked tensor of integer or index values |
updates | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.select
(mhlo::SelectOp)
Select operation
תַחבִּיר:
operation ::= `mhlo.select` operands attr-dict `:`
custom<SelectOpType>(type($pred), type($on_true), type($on_false), type($result))
Produces a result
tensor where each element is selected from on_true
or on_false
tensor based on the value of the corresponding element of pred
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#select
דוּגמָה:
%result = mhlo.select %pred, %on_true, %on_false : tensor<2x2xi1>, tensor<2x2xi32>
Traits: AlwaysSpeculatableImplTrait
, HLO_BroadcastingElementwise
, InferTensorType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
pred | ranked tensor of bool values |
on_true | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
on_false | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.select_and_scatter
(mhlo::SelectAndScatterOp)
SelectAndScatter operation
Scatters the values from the source
tensor using scatter
based on the outcome of reduce_window
of the input
tensor using select
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#select_and_scatter
דוּגמָה:
%result = "mhlo.select_and_scatter"(%operand, %source, %init_value) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = "mhlo.compare"(%arg0, %arg1) {
comparison_direction = #stablehlo<comparison_direction GE>
} : (tensor<i32>, tensor<i32>) -> tensor<i1>
"mhlo.return"(%0) : (tensor<i1>) -> ()
}, {
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = "mhlo.add"(%arg0, %arg1) : (tensor<i32>, tensor<i32>) -> tensor<i32>
"mhlo.return"(%0) : (tensor<i32>) -> ()
}) {
window_dimensions = dense<[3, 1]> : tensor<2xi64>,
window_strides = dense<[2, 1]> : tensor<2xi64>,
padding = dense<[[0, 1], [0, 0]]> : tensor<2x2xi64>
} : (tensor<4x2xi32>, tensor<2x2xi32>, tensor<i32>) -> tensor<4x2xi32>
Traits: RecursiveMemoryEffects
Interfaces: InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
window_dimensions | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
window_strides | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
padding | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
source | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
init_value | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.send
(mhlo::SendOp)
Send operation
Sends inputs
to a channel channel_id
and produces a result
token.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#send
דוּגמָה:
%result = "mhlo.send"(%operand, %token) {
// channel_id = 5 : i64,
// channel_type = #stablehlo<channel_type DEVICE_TO_DEVICE>,
channel_handle = #mhlo.channel_handle<handle = 5, type = 1>,
is_host_transfer = false,
source_target_pairs = dense<[[0, 1], [1, 2]]> : tensor<2x2xi64>
} : (tensor<3x4xi32>, !mhlo.token) -> !mhlo.token
Interfaces: InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
channel_handle | ::mlir::mhlo::ChannelHandleAttr | two 64-bit integers 'handle' and 'type' |
is_host_transfer | ::mlir::BoolAttr | bool attribute |
source_target_pairs | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
token | אֲסִימוֹן |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | אֲסִימוֹן |
mhlo.set_dimension_size
(mhlo::SetDimensionSizeOp)
SetDimensionSize operation
This operation is a work in progress, so it is not yet included in the specification: https://github.com/openxla/stablehlo/issues/8
Informally, this operation does the same thing as XLA's SetDimensionSize: https://www.tensorflow.org/xla/operation_semantics#setdimensionsize
דוּגמָה:
%0 = mhlo.set_dimension_size %arg0, %arg1, dim = 1 : (tensor<4x2xf32>, tensor<i32>) -> tensor<4x2xf32>
Traits: AlwaysSpeculatableImplTrait
, InferTensorType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dimension | ::mlir::IntegerAttr | 64-bit signless integer attribute whose value is non-negative |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
size | tensor of 32-bit signless integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.shift_left
(mhlo::ShiftLeftOp)
ShiftLeft operation
תַחבִּיר:
operation ::= `mhlo.shift_left` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise left-shift operation on the lhs
tensor by rhs
number of bits and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#shift_left
דוּגמָה:
%result = mhlo.shift_left %lhs, %rhs : tensor<6xi8>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 2/4/8/16/32/64-bit integer values |
rhs | ranked tensor of 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer values |
mhlo.shift_right_arithmetic
(mhlo::ShiftRightArithmeticOp)
ShiftRightArithmetic operation
תַחבִּיר:
operation ::= `mhlo.shift_right_arithmetic` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise arithmetic right-shift operation on the lhs
tensor by rhs
number of bits and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#shift_right_arithmetic
דוּגמָה:
%result = mhlo.shift_right_arithmetic %lhs, %rhs : tensor<6xi8>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 2/4/8/16/32/64-bit integer values |
rhs | ranked tensor of 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer values |
mhlo.shift_right_logical
(mhlo::ShiftRightLogicalOp)
ShiftRightLogical operation
תַחבִּיר:
operation ::= `mhlo.shift_right_logical` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise logical right-shift operation on the lhs
tensor by rhs
number of bits and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#shift_right_logical
דוּגמָה:
%result = mhlo.shift_right_logical %lhs, %rhs : tensor<6xi8>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 2/4/8/16/32/64-bit integer values |
rhs | ranked tensor of 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer values |
mhlo.sign
(mhlo::SignOp)
Sign operation
תַחבִּיר:
operation ::= `mhlo.sign` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Returns the sign of the operand
element-wise and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#sign
דוּגמָה:
%result = mhlo.sign %operand : tensor<7xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 2/4/8/16/32/64-bit signless integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit signless integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.sine
(mhlo::SineOp)
Sine operation
תַחבִּיר:
operation ::= `mhlo.sine` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise sine operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#sine
דוּגמָה:
%result = mhlo.sine %operand : tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.sinh
(mhlo::SinhOp)
Sinh operation
תַחבִּיר:
operation ::= `mhlo.sinh` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise sinh operation on operand
tensor and produces a result
tensor.
דוּגמָה:
%result = mhlo.sinh %operand : tensor<2x2xf32>
Traits: CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: InferShapedTypeOpInterface
, InferTypeOpInterface
Operands:
Operand | תֵאוּר |
---|---|
operand | tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
mhlo.slice
(mhlo::SliceOp)
Slice operation
Extracts a slice from the operand
using statically-computed starting indices and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#slice
דוּגמָה:
%result = "mhlo.slice" (%operand) {
start_indices = dense<[1, 2]> : tensor<2xi64>,
limit_indices = dense<[3, 4]> : tensor<2xi64>,
strides = dense<1> : tensor<2xi64>
} : (tensor<3x4xi64>) -> tensor<2x2xi64>
Traits: AlwaysSpeculatableImplTrait
, SameOperandsAndResultElementType
Interfaces: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
start_indices | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
limit_indices | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
strides | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.sort
(mhlo::SortOp)
Sort operation
Sorts a variadic number of tensors in inputs
together, according to a custom comparator
, along the given dimension
and produces a variadic number of tensors as results
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#sort
דוּגמָה:
%result0, %result1 = "mhlo.sort"(%input0, %input1) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>, %arg2: tensor<i32>, %arg3: tensor<i32>):
%predicate = "mhlo.compare"(%arg0, %arg1) {
comparison_direction = #stablehlo<comparison_direction GT>
} : (tensor<i32>, tensor<i32>) -> tensor<i1>
"mhlo.return"(%predicate) : (tensor<i1>) -> ()
}) {
dimension = 0 : i64,
is_stable = true
} : (tensor<2x3xi32>, tensor<2x3xi32>) -> (tensor<2x3xi32>, tensor<2x3xi32>)
Traits: InferTensorType
, RecursiveMemoryEffects
, SameOperandsAndResultShape
Interfaces: InferShapedTypeOpInterface
, InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dimension | ::mlir::IntegerAttr | 64-bit signless integer attribute |
is_stable | ::mlir::BoolAttr | bool attribute |
Operands:
Operand | תֵאוּר |
---|---|
inputs | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.sqrt
(mhlo::SqrtOp)
Sqrt operation
תַחבִּיר:
operation ::= `mhlo.sqrt` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise square root operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#sqrt
דוּגמָה:
%result = mhlo.sqrt %operand : tensor<2x2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.stochastic_convert
(mhlo::StochasticConvertOp)
StochasticConvert operation
This operation is a work in progress, so it is not yet included in the specification: https://github.com/openxla/stablehlo/issues/295
Informally, this operation performs element-wise conversion of values from a bigger type to a smaller one with stochastic rounding using the random number passed in.
Traits: AlwaysSpeculatableImplTrait
, Elementwise
Interfaces: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float values |
random | ranked tensor of 2/4/8/16/32/64-bit unsigned integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.subtract
(mhlo::SubtractOp)
Subtract operation
תַחבִּיר:
operation ::= `mhlo.subtract` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise subtraction of two tensors lhs
and rhs
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#subtract
דוּגמָה:
%result = mhlo.subtract %lhs, %rhs : tensor<2xi32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
rhs | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 2/4/8/16/32/64-bit integer or 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.tan
(mhlo::TanOp)
Tan operation
תַחבִּיר:
operation ::= `mhlo.tan` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
This operation is a work in progress, so it is not yet included in the specification: https://github.com/openxla/stablehlo/issues/954
Informally, this operation returns Tan(operand)
element-wise.
דוּגמָה:
%0 = mhlo.tan %arg0 : tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.tanh
(mhlo::TanhOp)
Tanh operation
תַחבִּיר:
operation ::= `mhlo.tanh` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise hyperbolic tangent operation on operand
tensor and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#tanh
דוּגמָה:
%result = mhlo.tanh %operand : tensor<2xf32>
Traits: AlwaysSpeculatableImplTrait
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
result_accuracy | ::mlir::mhlo::ResultAccuracyAttr | The requested accuracy for unary ops. |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.topk
(mhlo::TopKOp)
TopK operation
תַחבִּיר:
operation ::= `mhlo.topk` `(`$operand `,` `k` `=` $k (`,` `largest` `=` $largest^)? `)` attr-dict `:`
type($operand) `->` `(`type($values)`,` type($indices)`)`
Returns top k
values and their indices, along the last dimension of the operand if largest=true
or the bottom k
values if largest=false
.
See: https://www.tensorflow.org/xla/operation_semantics#top-k
דוּגמָה:
%values, %indices = mhlo.topk(%operand, k=5, largest=true)
: tensor<100xf32> -> (tensor<5xf32>, tensor<5xi32>)
Traits: InferTensorType
, RecursiveMemoryEffects
Interfaces: InferShapedTypeOpInterface
, InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
k | ::mlir::IntegerAttr | 64-bit signless integer attribute |
largest | ::mlir::BoolAttr | bool attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
values | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
indices | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.torch_index_select
(mhlo::TorchIndexSelectOp)
TorchIndexSelect operation
This operation is on its way out of StableHLO, so it is not included in the specification: https://github.com/openxla/stablehlo/issues/3
Informally, this operation does the same thing as PyTorch's index_select, augmented with support for batch dimensions: https://pytorch.org/docs/stable/generated/torch.index_select.html
The batch_dims
attribute specifies the number of major batch dimensions (0 or more) that act like a multidimensional loop over both the operand and the index.
דוּגמָה:
%result = "mhlo.torch_index_select"(%operand, %index) {
dim = 2 : i64,
batch_dims = 1 : i64
} : (tensor<8x128x3072x64xf32>, tensor<8x16x1024xi32>) -> tensor<8x128x16x1024x64xf32>
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
dim | ::mlir::IntegerAttr | 64-bit signless integer attribute |
batch_dims | ::mlir::IntegerAttr | 64-bit signless integer attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
index | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.trace
(mhlo::TraceOp)
Trace operation
תַחבִּיר:
operation ::= `mhlo.trace` $operand `,` $tag attr-dict `:` type($operand)
This operation is on its way out of StableHLO, so it is not included in the specification: https://github.com/openxla/stablehlo/issues/604
It is not used by JAX, PyTorch or TensorFlow, so it looks like we should've classified it as "Private to XLA" and not included it in StableHLO in the first place. With that in mind, its semantics will not be documented here.
דוּגמָה:
mhlo.trace %arg0, "In test code." : tensor<5x1x5xi32>
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
tag | ::mlir::StringAttr | string attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.transpose
(mhlo::TransposeOp)
Transpose operation
Permutes the dimensions of operand
tensor using permutation
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#transpose
דוּגמָה:
%0 = mhlo.transpose %arg0, dims = [2, 1, 0] : (tensor<1x2x3xi32>) -> tensor<3x2x1xi32>
Traits: AlwaysSpeculatableImplTrait
, HLO_CompatibleOperandsAndResultElementType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
permutation | ::mlir::DenseIntElementsAttr | 64-bit signless integer elements attribute |
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
mhlo.triangular_solve
(mhlo::TriangularSolveOp)
TriangularSolve operation
Solves batches of systems of linear equations with lower or upper triangular coefficient matrices.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#triangular_solve
דוּגמָה:
%result = "mhlo.triangular_solve"(%a, %b) {
left_side = true,
lower = true,
unit_diagonal = false,
transpose_a = #stablehlo<transpose NO_TRANSPOSE>
} : (tensor<3x3xf32>, tensor<3x3xf32>) -> tensor<3x3xf32>
Traits: AlwaysSpeculatableImplTrait
, InferTensorType
, SameOperandsAndResultElementType
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
left_side | ::mlir::BoolAttr | bool attribute |
lower | ::mlir::BoolAttr | bool attribute |
unit_diagonal | ::mlir::BoolAttr | bool attribute |
transpose_a | ::mlir::mhlo::TransposeAttr | Transpose options |
Operands:
Operand | תֵאוּר |
---|---|
a | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
b | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | ranked tensor of 4/6/8/16/32/64-bit float or complex type with 32/64-bit float elements values |
mhlo.tuple
(mhlo::TupleOp)
Tuple operation
תַחבִּיר:
operation ::= `mhlo.tuple` $val attr-dict `:` custom<TupleOpType>(type($val), type($result))
Produces a result
tuple from values val
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#tuple
דוּגמָה:
%result = mhlo.tuple %val0, %val1 : tuple<tensor<2xf32>, tuple<tensor<i32>>>
Traits: AlwaysSpeculatableImplTrait
Interfaces: ConditionallySpeculatable
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
val | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values or token or nested tuple with any combination of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | nested tuple with any combination of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token values |
mhlo.uniform_dequantize
(mhlo::UniformDequantizeOp)
UniformDequantize operation
תַחבִּיר:
operation ::= `mhlo.uniform_dequantize` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise conversion of quantized tensor operand
to a floating-point tensor result
according to the quantization parameters defined by the operand
type.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#uniform_dequantize
דוּגמָה:
%result = mhlo.uniform_dequantize %operand : (tensor<16x16x!quant.uniform<i8:f32, 34.0:16>>) -> tensor<16x16xf32>
Traits: AlwaysSpeculatableImplTrait
, Elementwise
, InferTensorType
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of per-tensor integer quantized or per-axis integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float values |
mhlo.uniform_quantize
(mhlo::UniformQuantizeOp)
UniformQuantize operation
תַחבִּיר:
operation ::= `mhlo.uniform_quantize` $operand attr-dict
`:` custom<SameOperandsAndResultType>(type($operand), type($result))
Performs element-wise conversion of floating-point tensor or quantized tensor operand
to a quantized tensor result
according to the quantization parameters defined by the result
type.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#uniform_quantize
דוּגמָה:
%result = mhlo.uniform_quantize %operand : (tensor<16x16xf32>) -> tensor<16x16x!quant.uniform<ui8:f32, 34.0:16>>
Traits: AlwaysSpeculatableImplTrait
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
operand | ranked tensor of 4/6/8/16/32/64-bit float or 2/4/8/16/32-bit uniform quantized signed integer or 2/4/8/16/32-bit uniform quantized per axis signed integer or 2/4/8/16/32-bit uniform quantized unsigned integer or 2/4/8/16/32-bit uniform quantized per axis unsigned integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of per-tensor integer quantized or per-axis integer quantized values |
mhlo.while
(mhlo::WhileOp)
While operation
Produces the output from executing body
function 0 or more times while the cond
function outputs true
.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#while
דוּגמָה:
%results0, %results1 = "mhlo.while"(%operand0, %operand1) ({
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = "mhlo.compare"(%arg0, %arg1) {
comparison_direction = #stablehlo<comparison_direction LT>
} : (tensor<i32>, tensor<i32>) -> tensor<i1>
"mhlo.return"(%0) : (tensor<i1>) -> ()
}, {
^bb0(%arg0: tensor<i32>, %arg1: tensor<i32>):
%0 = "mhlo.add"(%arg0, %constant0) : (tensor<i32>, tensor<i32>) -> tensor<i32>
"mhlo.return"(%0, %arg1) : (tensor<i32>, tensor<i32>) -> ()
}) : (tensor<i32>, tensor<i32>) -> (tensor<i32>, tensor<i32>)
Traits: RecursiveMemoryEffects
, SingleBlockImplicitTerminator<ReturnOp>
, SingleBlock
Interfaces: InferTypeOpInterface
, OpAsmOpInterface
Operands:
Operand | תֵאוּר |
---|---|
operand | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | variadic of ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values or ranked tensor of per-axis integer quantized values or token or memref of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized values |
mhlo.xla.rng_get_and_update_state
(mhlo::XlaRngGetAndUpdateStateOp)
XlaRngGetAndUpdateState operation
תַחבִּיר:
operation ::= `mhlo.xla.rng_get_and_update_state` attr-dict
This operation is private to the XLA compiler, so it is does not yet have a specification.
Informally, this operation represents the change of the global random number generator state for rng instructions. The global state is incremented by delta and the old state is returned.
The output is currently defined for a single output type. If this changes in the future to support multiple types, lowering to use of a global memref must ensure that a single memref is still used and updated appropriately.
Interfaces: InferTypeOpInterface
Attributes:
תְכוּנָה | MLIR Type | תֵאוּר |
---|---|---|
delta | ::mlir::IntegerAttr | 64-bit signless integer attribute |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
«unnamed» | statically shaped tensor of 64-bit unsigned integer values |
mhlo.xor
(mhlo::XorOp)
Xor operation
תַחבִּיר:
operation ::= `mhlo.xor` $lhs `,` $rhs attr-dict
`:` custom<SameOperandsAndResultType>(type($lhs), type($rhs), type($result))
Performs element-wise XOR of two tensors lhs
and rhs
and produces a result
tensor.
See: https://github.com/openxla/stablehlo/blob/main/docs/spec.md#xor
דוּגמָה:
%result = mhlo.xor %lhs, %rhs : tensor<2xi32>
Traits: AlwaysSpeculatableImplTrait
, Commutative
, CompatibleOperandsAndResultType
, Elementwise
, SameOperandsAndResultShape
Interfaces: ConditionallySpeculatable
, InferShapedTypeOpInterface
, InferTypeOpInterface
, NoMemoryEffect (MemoryEffectOpInterface)
Effects: MemoryEffects::Effect{}
Operands:
Operand | תֵאוּר |
---|---|
lhs | ranked tensor of bool or 2/4/8/16/32/64-bit integer values |
rhs | ranked tensor of bool or 2/4/8/16/32/64-bit integer values |
תוצאות:
תוֹצָאָה | תֵאוּר |
---|---|
result | ranked tensor of 4/6/8/16/32/64-bit float or bool or 2/4/8/16/32/64-bit integer or complex type with 32/64-bit float elements or per-tensor integer quantized or per-axis integer quantized values |
תכונות
ArgResultAliasAttr
Attribute that models the alias relationship of entry function argument
This attribute captures the alias relationship of an MHLO main function argument to one of the results, denoted by resultIndex
. The argTupleIndices
and resultTupleIndices
are used to index into nested tuples in operand and result respectively. If isMustAlias
is true then the operand-result pair must alias.
This is meant to be used as an attribute on a function argument in MHLO. For example, in the following code it expresses that %arg1
may alias 0-th result.
func @main(%arg0: tensor<2xf32>, %arg1: tensor<3xf32> {mhlo.result_alias =
mhlo.result_alias<result_index = [2], ...>}
) -> tensor<2xf32>, tensor<3xf32> {
// function body ...
}
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
argTupleIndices | ::llvm::ArrayRef<int64_t> | מֵמַד |
resultIndex | int64_t | |
resultTupleIndices | ::llvm::ArrayRef<int64_t> | מֵמַד |
isMustAlias | bool |
ChannelHandleAttr
Two 64-bit integers 'handle' and 'type'
תַחבִּיר:
#mhlo.channel_handle<
int64_t, # handle
int64_t # type
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
יָדִית | int64_t | |
סוּג | int64_t |
ComparisonDirectionAttr
Which comparison operation to perform.
תַחבִּיר:
#mhlo.comparison_direction<
::mlir::mhlo::ComparisonDirection # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::ComparisonDirection | an enum of type ComparisonDirection |
ComparisonTypeAttr
Which comparison type to use.
תַחבִּיר:
#mhlo.comparison_type<
::mlir::mhlo::ComparisonType # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::ComparisonType | an enum of type ComparisonType |
ConvDimensionNumbersAttr
Structure of dimension information for conv op
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
inputBatchDimension | int64_t | |
inputFeatureDimension | int64_t | |
inputSpatialDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
kernelInputFeatureDimension | int64_t | |
kernelOutputFeatureDimension | int64_t | |
kernelSpatialDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
outputBatchDimension | int64_t | |
outputFeatureDimension | int64_t | |
outputSpatialDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
CrossProgramPrefetchAttr
Argument that is prefetched from another program
תַחבִּיר:
#mhlo.cross_program_prefetch<
int64_t, # parameter
::llvm::ArrayRef<int64_t>, # indices
std::optional<int64_t> # offset
>
This attribute captures an argument that is prefetched from another program. For a given CrossProgramPrefetchAttr
, parameter
tells us which argument of the main
function of the module is prefetched, and indices
is a shape index telling us what subshape of that argument is prefetched.
A shape has a subshape iff it is a tuple. In that case, the subshape of the tuple by indices
is the shape achieved after indexing by each element of indices
in turn. For example, the [1,0] subshape of tuple<tuple<token, token>, tuple<tensor<i32>, token>>
is tensor<i32>
.
An empty value for indices
means the whole shape is prefetched.
לְדוּגמָה,
module attributes { mhlo.cross_program_prefetch = [ #mhlo.cross_program_prefetch< parameter = 0, indices = [0]> ]} {
func.func @copy(%arg0 : tuple<tensor<2x3xi32>, tensor<i32>>) -> tuple<tensor<2x3xi32>, tensor<i32>> {
%0 = "mhlo.copy"(%arg0) {is_cross_program_prefetch}
return %0 : tuple<tensor<2x3xi32>, tensor<i32>>
}
func.func @main(%arg0 : tuple<tensor<2x3xi32>, tensor<i32>>) -> tuple<tensor<2x3xi32>, tensor<i32>> {
%1 = "mhlo.async_start"(%arg0) {called_computation=@copy}
%2 = "mhlo.async_done"(%1) {called_computation=@copy}
return %2 : tuple<tensor<2x3xi32>, tensor<i32>>
}
}
The parameter = 0
tells us that the async copy of the 0
th parameter is a cross_program_prefetch
, while the index
of [0]
tells us that the 0
th element of the tuple is prefetched while the other element of the tuple is not.
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
פָּרָמֶטֶר | int64_t | |
indices | ::llvm::ArrayRef<int64_t> | מֵמַד |
לְקַזֵז | std::optional<int64_t> |
CustomCallScheduleAttr
Specifies the desired schedule for the custom-call.
תַחבִּיר:
#mhlo.custom_call_schedule<
::mlir::mhlo::CustomCallSchedule # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::CustomCallSchedule | an enum of type CustomCallSchedule |
DequantizeModeAttr
_Dequantization mode. Only MIN COMBINED is supported.
תַחבִּיר:
#mhlo.dequantize_mode<
::mlir::mhlo::DequantizeMode # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::DequantizeMode | an enum of type DequantizeMode |
DomainKindAttr
Kind of domain metatdata attached to an HLO domain.
תַחבִּיר:
#mhlo.kind<
::mlir::mhlo::DomainKind # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::DomainKind | an enum of type DomainKind |
DotAlgorithmAttr
Attribute that models the algorithm constraints to use for computing dot.
תַחבִּיר:
#mhlo.dot_algorithm<
Type, # lhsPrecisionType
Type, # rhsPrecisionType
Type, # accumulationType
int64_t, # lhsComponentCount
int64_t, # rhsComponentCount
int64_t, # numPrimitiveOperations
bool # allowImpreciseAccumulation
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
lhsPrecisionType | Type | |
rhsPrecisionType | Type | |
accumulationType | Type | |
lhsComponentCount | int64_t | |
rhsComponentCount | int64_t | |
numPrimitiveOperations | int64_t | |
allowImpreciseAccumulation | bool |
DotDimensionNumbersAttr
Attribute that models the dimension information for dot.
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
lhsBatchingDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
rhsBatchingDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
lhsContractingDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
rhsContractingDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
FftTypeAttr
XLA fast fourier transform type.
תַחבִּיר:
#mhlo.fft_type<
::mlir::mhlo::FftType # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::FftType | an enum of type FftType |
FusionKindAttr
Fusion kind
תַחבִּיר:
#mhlo.fusion_kind<
::mlir::mhlo::FusionKind # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::FusionKind | an enum of type FusionKind |
GatherDimensionNumbersAttr
Attribute that models the dimension information for gather
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
offsetDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
collapsedSliceDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
operandBatchingDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
startIndicesBatchingDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
startIndexMap | ::llvm::ArrayRef<int64_t> | מֵמַד |
indexVectorDim | int64_t |
OutputOperandAliasAttr
Attribute that models the alias relationship of output and operand of a CustomCall op
תַחבִּיר:
#mhlo.output_operand_alias<
::llvm::ArrayRef<int64_t>, # outputTupleIndices
int64_t, # operandIndex
::llvm::ArrayRef<int64_t> # operandTupleIndices
>
This attribute captures the alias relationship of the output to one of the operands for a CustomCall op, denoted by operand_index
. The output_tuple_indices
and operand_tuple_indices
are used to index into output and operand types. These indices lists are empty if the corresponding types are not tuple types, and can be arbitrarily long in case of arbitrarily nested tuple types.
See https://www.tensorflow.org/xla/aliasing
Example when used as array with in mhlo.custom-call:
%0 = "mhlo.custom_call"(%arg0, %arg1) {
// other attributes
output_operand_alias = [
#mhlo.output_operand_alias<output_tuple_indices = [0],
operand_index = 0,
operand_tuple_indices = [1]>
]
} : (tuple<tensor<1x1xf32>, tensor<2x3xf32>>, tensor<5x5xf32>) -> tuple<tensor<2x3xf32>>
The output and the 0th operand are both tuples. The aliasing shows the
relationship between the 0th element in output tuple with the 1st element in
the 0th operand. And both of them are of the same type: tensor<2x3xf32>.
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
outputTupleIndices | ::llvm::ArrayRef<int64_t> | מֵמַד |
operandIndex | int64_t | |
operandTupleIndices | ::llvm::ArrayRef<int64_t> | מֵמַד |
PrecisionAttr
XLA precision for an operand. Has backend specific meaning.
תַחבִּיר:
#mhlo.precision<
::mlir::mhlo::Precision # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::Precision | an enum of type Precision |
RaggedDotDimensionNumbersAttr
Attribute that models the dimension information for ragged dot.
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
dotDimensionNumbers | ::mlir::mhlo::DotDimensionNumbersAttr | Attribute that models the dimension information for dot. |
lhsRaggedDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
rhsGroupDimensions | ::llvm::ArrayRef<int64_t> | מֵמַד |
ResultAccuracyAttr
The requested accuracy for unary ops.
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
atol | APFloat | |
rtol | APFloat | |
ulps | int64_t | |
מצב | ::mlir::mhlo::ResultAccuracyModeAttr | XLA result accuracy mode. |
ResultAccuracyModeAttr
XLA result accuracy mode.
תַחבִּיר:
#mhlo.result_accuracy_mode<
::mlir::mhlo::ResultAccuracyMode # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::ResultAccuracyMode | an enum of type ResultAccuracyMode |
RngAlgorithmAttr
XLA PRNG algorithm to be used.
תַחבִּיר:
#mhlo.rng_algorithm<
::mlir::mhlo::RngAlgorithm # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::RngAlgorithm | an enum of type RngAlgorithm |
RngDistributionAttr
XLA PRNG distribution to be used.
תַחבִּיר:
#mhlo.rng_distribution<
::mlir::mhlo::RngDistribution # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::RngDistribution | an enum of type RngDistribution |
ScatterDimensionNumbersAttr
Attribute that models the dimension information for scatter
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
updateWindowDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
insertedWindowDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
inputBatchingDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
scatterIndicesBatchingDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
scatterDimsToOperandDims | ::llvm::ArrayRef<int64_t> | מֵמַד |
indexVectorDim | int64_t |
TransposeAttr
Transpose options
תַחבִּיר:
#mhlo.transpose<
::mlir::mhlo::Transpose # value
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
עֵרֶך | ::mlir::mhlo::Transpose | an enum of type Transpose |
TypeExtensionsAttr
Attribute that extends tensor type with MHLO type properties.
תַחבִּיר:
#mhlo.type_extensions<
::llvm::ArrayRef<int64_t> # bounds
>
This attribute is used to extend MLIR tensor type with MHLO tensor specific properties. These properties aren't modeled in the MLIR type. This attribute is set in the encoding
field of the tensor type.
See HLO_BoundedAttrInterface
for documentation for bounds
.
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
גבולות | ::llvm::ArrayRef<int64_t> |
סוגים
AsyncBundleType
Opaque collection of other types
תַחבִּיר:
!mhlo.async_bundle<
::llvm::ArrayRef<Type> # types
>
פרמטרים:
פָּרָמֶטֶר | C++ type | תֵאוּר |
---|---|---|
סוגים | ::llvm::ArrayRef<Type> |
Enums
ComparisonDirection
Which comparison operation to perform.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
EQ | 0 | EQ |
NE | 1 | NE |
GE | 2 | GE |
GT | 3 | GT |
LE | 4 | LE |
LT | 5 | LT |
ComparisonType
Which comparison type to use.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
NOTYPE | 0 | NOTYPE |
לָצוּף | 1 | לָצוּף |
TOTALORDER | 2 | TOTALORDER |
חָתוּם | 3 | חָתוּם |
UNSIGNED | 4 | UNSIGNED |
CustomCallApiVersion
Custom call API version
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
API_VERSION_UNSPECIFIED | 0 | API_VERSION_UNSPECIFIED |
API_VERSION_ORIGINAL | 1 | API_VERSION_ORIGINAL |
API_VERSION_STATUS_RETURNING | 2 | API_VERSION_STATUS_RETURNING |
API_VERSION_STATUS_RETURNING_UNIFIED | 3 | API_VERSION_STATUS_RETURNING_UNIFIED |
API_VERSION_TYPED_FFI | 4 | API_VERSION_TYPED_FFI |
CustomCallSchedule
Specifies the desired schedule for the custom-call.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
אַף לֹא אֶחָד | 0 | אַף לֹא אֶחָד |
האחרון | 1 | האחרון |
EARLIEST | 2 | EARLIEST |
DequantizeMode
_Dequantization mode. Only MIN COMBINED is supported.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
MIN_COMBINED | 0 | MIN_COMBINED |
DomainKind
Kind of domain metatdata attached to an HLO domain.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
ריסוק | 0 | ריסוק |
FftType
XLA fast fourier transform type.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
FFT | 0 | FFT |
IFFT | 1 | IFFT |
RFFT | 2 | RFFT |
IRFFT | 3 | IRFFT |
FusionKind
Fusion kind
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
kLoop | 0 | kLoop |
kInput | 1 | kInput |
kOutput | 2 | kOutput |
kCustom | 3 | kCustom |
דִיוּק
XLA precision for an operand. Has backend specific meaning.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
בְּרִירַת מֶחדָל | 0 | בְּרִירַת מֶחדָל |
גָבוֹהַ | 1 | גָבוֹהַ |
הֲכִי גָבוֹהַ | 2 | הֲכִי גָבוֹהַ |
ResultAccuracyMode
XLA result accuracy mode.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
בְּרִירַת מֶחדָל | 0 | בְּרִירַת מֶחדָל |
הֲכִי גָבוֹהַ | 1 | הֲכִי גָבוֹהַ |
סוֹבלָנוּת | 2 | סוֹבלָנוּת |
RngAlgorithm
XLA PRNG algorithm to be used.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
בְּרִירַת מֶחדָל | 0 | בְּרִירַת מֶחדָל |
THREE_FRY | 1 | THREE_FRY |
PHILOX | 2 | PHILOX |
RngDistribution
XLA PRNG distribution to be used.
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
אָחִיד | 1 | אָחִיד |
נוֹרמָלִי | 2 | נוֹרמָלִי |
לְשַׁרבֵּב
Transpose options
Cases:
סֵמֶל | עֵרֶך | חוּט |
---|---|---|
TRANSPOSE_INVALID | 0 | TRANSPOSE_INVALID |
NO_TRANSPOSE | 1 | NO_TRANSPOSE |
לְשַׁרבֵּב | 2 | לְשַׁרבֵּב |
ADJOINT | 3 | ADJOINT |