Fir
fir
¶
The Fortran IR (FIR) dialect that is used by Flang.
This is used in two ways, firstly it is mixed with HLFIR, and this FIR+HLFIR is the first MLIR representation of a Fortran code in the compilation pipeline. Secondly, the HLFIR+FIR is then lowered to FIR only, before this is then lowered to LLVM IR.
See external documentation.
FIR = Dialect('fir', [AbsentOp, AddcOp, AddressOfOp, AllocmemOp, AllocaOp, ArrayAccessOp, ArrayAmendOp, ArrayCoorOp, ArrayFetchOp, ArrayLoadOp, ArrayMergeStoreOp, ArrayModifyOp, ArrayUpdateOp, BoxAddrOp, BoxcharLenOp, BoxDimsOp, BoxElesizeOp, BoxIsallocOp, BoxIsarrayOp, BoxIsptrOp, BoxOffsetOp, BoxprocHostOp, BoxRankOp, BoxTdescOp, CallOp, CharConvertOp, CmpcOp, ConvertOp, CoordinateOfOp, DeclareOp, DtEntryOp, DispatchOp, DivcOp, DoLoopOp, DummyScopeOp, EmboxcharOp, EmboxOp, EmboxprocOp, ExtractValueOp, FieldIndexOp, EndOp, FreememOp, GlobalLenOp, GlobalOp, HasValueOp, IfOp, InsertOnRangeOp, InsertValueOp, IsPresentOp, IterateWhileOp, LenParamIndexOp, LoadOp, MulcOp, NegcOp, NoReassocOp, ReboxOp, ResultOp, SaveResultOp, SelectCaseOp, SelectOp, SelectRankOp, SelectTypeOp, ShapeOp, ShapeShiftOp, ShiftOp, SliceOp, StoreOp, StringLitOp, SubcOp, UnboxcharOp, UnboxprocOp, UndefinedOp, UnreachableOp, ZeroBitsOp, AssumedSizeExtentOp, BoxTotalElementsOp, BoxTypeCodeOp, CopyOp, DeclareReductionOp, DoConcurrentOp, DoConcurrentLoopOp, DTComponentOp, IsAssumedSizeOp, IsAssumedSizeExtentOp, IsContiguousBoxOp, LocalitySpecifierOp, PackArrayOp, UnpackArrayOp, PrefetchOp, ReboxAssumedRankOp, TypeDescOp, TypeInfoOp, UseStmtOp, VolatileCastOp, YieldOp], [FortranVariableFlagsAttr, FortranProcedureFlagsAttr, FortranInlineFlagsAttr, PackArrayHeuristicsAttr, ReduceAttr, LocationKindAttr, LocationKindArrayAttr, LocalitySpecifierTypeAttr, UseRenameAttr, OpenACCSafeTempArrayCopyAttr, OpenMPSafeTempArrayCopyAttr, PointAttr, LowerAttr, UpperAttr, IntervalAttr, ExactTypeAttr, SubclassAttr, RealAttr, ReferenceType, DeferredAttr, DummyScopeType, LLVMPointerType, PointerType, LogicalType, NoneType, SequenceType, CharacterType, ShapeType, ShapeShiftType, HeapType, BoxType, BoxCharType, ShiftType, IntType, UnsignedType, ClassType, BoxProcType, FieldType, LenType, TypeDescType, VoidType, SliceType, VectorType, RecordType])
module-attribute
¶
FortranVariableFlags
¶
Bases: Enum
Source code in xdsl/dialects/experimental/fir.py
NOATTRIBUTES = 'None'
class-attribute
instance-attribute
¶
ALLOCATABLE = 'allocatable'
class-attribute
instance-attribute
¶
ASYNCHRONOUS = 'asynchronous'
class-attribute
instance-attribute
¶
BIND_C = 'bind_c'
class-attribute
instance-attribute
¶
CONTIGUOUS = 'contiguous'
class-attribute
instance-attribute
¶
INTENT_IN = 'intent_in'
class-attribute
instance-attribute
¶
INTENT_INOUT = 'intent_inout'
class-attribute
instance-attribute
¶
INTENT_OUT = 'intent_out'
class-attribute
instance-attribute
¶
OPTIONAL = 'optional'
class-attribute
instance-attribute
¶
PARAMETER = 'parameter'
class-attribute
instance-attribute
¶
POINTER = 'pointer'
class-attribute
instance-attribute
¶
TARGET = 'target'
class-attribute
instance-attribute
¶
VALUE = 'value'
class-attribute
instance-attribute
¶
VOLATILE = 'volatile'
class-attribute
instance-attribute
¶
HOSTASSOC = 'host_assoc'
class-attribute
instance-attribute
¶
INTERNALASSOC = 'internal_assoc'
class-attribute
instance-attribute
¶
CRAY_POINTER = 'cray_pointer'
class-attribute
instance-attribute
¶
CRAY_POINTEE = 'cray_pointee'
class-attribute
instance-attribute
¶
try_parse(parser: AttrParser) -> set[FortranVariableFlags] | None
staticmethod
¶
FortranVariableFlagsAttrBase
dataclass
¶
Bases: Data[tuple[FortranVariableFlags, ...]]
Source code in xdsl/dialects/experimental/fir.py
flags: set[FortranVariableFlags]
property
¶
Returns a copy of the Fortran variable flags.
__init__(flags: Sequence[FortranVariableFlags])
¶
parse_parameter(parser: AttrParser) -> tuple[FortranVariableFlags, ...]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
print_parameter(printer: Printer)
¶
Source code in xdsl/dialects/experimental/fir.py
FortranVariableFlagsAttr
dataclass
¶
Bases: FortranVariableFlagsAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.var_attrs'
class-attribute
instance-attribute
¶
FortranProcedureFlags
¶
Bases: Enum
Fortran procedure attributes (F2023 15.6.2.1). BIND attribute (18.3.7) is also tracked in the same enum.
Source code in xdsl/dialects/experimental/fir.py
NOATTRIBUTES = 'none'
class-attribute
instance-attribute
¶
ELEMENTAL = 'elemental'
class-attribute
instance-attribute
¶
PURE = 'pure'
class-attribute
instance-attribute
¶
NON_RECURSIVE = 'non_recursive'
class-attribute
instance-attribute
¶
SIMPLE = 'simple'
class-attribute
instance-attribute
¶
BIND_C = 'bind_c'
class-attribute
instance-attribute
¶
try_parse(parser: AttrParser) -> set[FortranProcedureFlags] | None
staticmethod
¶
FortranProcedureFlagsAttrBase
dataclass
¶
Bases: Data[tuple[FortranProcedureFlags, ...]]
Source code in xdsl/dialects/experimental/fir.py
flags: set[FortranProcedureFlags]
property
¶
__init__(flags: Sequence[FortranProcedureFlags])
¶
parse_parameter(parser: AttrParser) -> tuple[FortranProcedureFlags, ...]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
print_parameter(printer: Printer)
¶
FortranProcedureFlagsAttr
dataclass
¶
Bases: FortranProcedureFlagsAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.proc_attrs'
class-attribute
instance-attribute
¶
FortranInlineFlags
¶
Bases: Enum
Fortran inline hint attributes for fir.call.
Source code in xdsl/dialects/experimental/fir.py
NONE = 'none'
class-attribute
instance-attribute
¶
NO_INLINE = 'no_inline'
class-attribute
instance-attribute
¶
ALWAYS_INLINE = 'always_inline'
class-attribute
instance-attribute
¶
INLINE_HINT = 'inline_hint'
class-attribute
instance-attribute
¶
try_parse(parser: AttrParser) -> set[FortranInlineFlags] | None
staticmethod
¶
FortranInlineFlagsAttrBase
dataclass
¶
Bases: Data[tuple[FortranInlineFlags, ...]]
Source code in xdsl/dialects/experimental/fir.py
flags: set[FortranInlineFlags]
property
¶
__init__(flags: Sequence[FortranInlineFlags])
¶
parse_parameter(parser: AttrParser) -> tuple[FortranInlineFlags, ...]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
print_parameter(printer: Printer)
¶
FortranInlineFlagsAttr
dataclass
¶
Bases: FortranInlineFlagsAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.inline_attrs'
class-attribute
instance-attribute
¶
PackArrayHeuristics
¶
Bases: Enum
Optimization heuristics for fir.pack_array.
Source code in xdsl/dialects/experimental/fir.py
PackArrayHeuristicsAttrBase
dataclass
¶
Bases: Data[tuple[PackArrayHeuristics, ...]]
Source code in xdsl/dialects/experimental/fir.py
flags: set[PackArrayHeuristics]
property
¶
__init__(flags: Sequence[PackArrayHeuristics])
¶
parse_parameter(parser: AttrParser) -> tuple[PackArrayHeuristics, ...]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
print_parameter(printer: Printer)
¶
PackArrayHeuristicsAttr
dataclass
¶
Bases: PackArrayHeuristicsAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.pack_array_heuristics'
class-attribute
instance-attribute
¶
ReduceOperator
¶
Bases: Enum
Intrinsic reduction operations for DO CONCURRENT REDUCE. Upstream this is an I32BitEnumAttr; in practice each reduction declaration selects a single operation, so a single value is stored.
Source code in xdsl/dialects/experimental/fir.py
ADD = 'add'
class-attribute
instance-attribute
¶
MULTIPLY = 'multiply'
class-attribute
instance-attribute
¶
AND = 'and'
class-attribute
instance-attribute
¶
OR = 'or'
class-attribute
instance-attribute
¶
EQV = 'eqv'
class-attribute
instance-attribute
¶
NEQV = 'neqv'
class-attribute
instance-attribute
¶
MAX = 'max'
class-attribute
instance-attribute
¶
MIN = 'min'
class-attribute
instance-attribute
¶
IAND = 'iand'
class-attribute
instance-attribute
¶
IOR = 'ior'
class-attribute
instance-attribute
¶
IEOR = 'ieor'
class-attribute
instance-attribute
¶
try_parse(parser: AttrParser) -> ReduceOperator | None
staticmethod
¶
ReduceAttrBase
dataclass
¶
Bases: Data[ReduceOperator]
Source code in xdsl/dialects/experimental/fir.py
ReduceAttr
dataclass
¶
Bases: ReduceAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.reduce_attr'
class-attribute
instance-attribute
¶
LocationKind
¶
LocationKindAttrBase
dataclass
¶
Bases: Data[LocationKind]
Source code in xdsl/dialects/experimental/fir.py
LocationKindAttr
dataclass
¶
Bases: LocationKindAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.loc_kind'
class-attribute
instance-attribute
¶
LocationKindArrayAttrBase
dataclass
¶
Bases: Data[tuple[LocationKind, ...]]
Source code in xdsl/dialects/experimental/fir.py
__init__(data: DataElement) -> None
¶
parse_parameter(parser: AttrParser) -> tuple[LocationKind, ...]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
LocationKindArrayAttr
dataclass
¶
Bases: LocationKindArrayAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.loc_kind_array'
class-attribute
instance-attribute
¶
LocalitySpecifierType
¶
Bases: Enum
Locality kind for fir.local: LOCAL vs LOCAL_INIT.
Source code in xdsl/dialects/experimental/fir.py
LocalitySpecifierTypeAttrBase
dataclass
¶
Bases: Data[LocalitySpecifierType]
Source code in xdsl/dialects/experimental/fir.py
__init__(data: DataElement) -> None
¶
parse_parameter(parser: AttrParser) -> LocalitySpecifierType
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
LocalitySpecifierTypeAttr
dataclass
¶
Bases: LocalitySpecifierTypeAttrBase
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.locality_specifier_type'
class-attribute
instance-attribute
¶
UseRenameAttr
dataclass
¶
Bases: ParametrizedAttribute
A single rename mapping for a Fortran USE statement: local_name => module_var.
Source code in xdsl/dialects/experimental/fir.py
OpenACCSafeTempArrayCopyAttr
dataclass
¶
Bases: ParametrizedAttribute
Marker attribute implementing SafeTempArrayCopyAttrInterface for OpenACC.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.acc_safe_temp_array_copy'
class-attribute
instance-attribute
¶
OpenMPSafeTempArrayCopyAttr
dataclass
¶
Bases: ParametrizedAttribute
Marker attribute implementing SafeTempArrayCopyAttrInterface for OpenMP.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.omp_safe_temp_array_copy'
class-attribute
instance-attribute
¶
ReferenceType
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of a reference to an entity in memory.
Flang 22.x added an optional volatile marker that, when present,
indicates the reference wraps a Fortran VOLATILE entity. The textual
form is !fir.ref<T> for the default and !fir.ref<T, volatile>
when set.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.ref'
class-attribute
instance-attribute
¶
type: Attribute
instance-attribute
¶
is_volatile: BoolAttr
instance-attribute
¶
__init__(type: Attribute, is_volatile: bool = False) -> None
¶
print_parameters(printer: Printer) -> None
¶
parse_parameters(parser: AttrParser) -> list[Attribute]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
DeferredAttr
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
A deferred size which is represented with a question mark
Source code in xdsl/dialects/experimental/fir.py
PointAttr
dataclass
¶
Bases: ParametrizedAttribute
#fir.point case-tag — exact match case (X) in SELECT CASE.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.point'
class-attribute
instance-attribute
¶
LowerAttr
dataclass
¶
Bases: ParametrizedAttribute
#fir.lower case-tag — open lower bound case (X:) (selector >= X).
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.lower'
class-attribute
instance-attribute
¶
UpperAttr
dataclass
¶
Bases: ParametrizedAttribute
#fir.upper case-tag — open upper bound case (:X) (selector <= X).
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.upper'
class-attribute
instance-attribute
¶
IntervalAttr
dataclass
¶
Bases: ParametrizedAttribute
#fir.interval case-tag — closed range case (lo:hi) (lo <= sel <= hi).
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.interval'
class-attribute
instance-attribute
¶
ExactTypeAttr
dataclass
¶
Bases: ParametrizedAttribute
#fir.type_is<T> case-tag — matches when the dynamic type of the selector
is exactly T. Used in fir.select_type to encode Fortran's TYPE IS (...)
SELECT TYPE arm.
Source code in xdsl/dialects/experimental/fir.py
SubclassAttr
dataclass
¶
Bases: ParametrizedAttribute
#fir.class_is<T> case-tag — matches when the dynamic type of the selector
is T or an extension of T. Used in fir.select_type to encode Fortran's
CLASS IS (...) SELECT TYPE arm.
Source code in xdsl/dialects/experimental/fir.py
RealAttr
dataclass
¶
Bases: ParametrizedAttribute
#fir.real<kind, value> — a Fortran REAL constant of a given KIND. The
second field is stored verbatim as a textual payload because Flang accepts
two interchangeable forms: a decimal float literal (e.g. 3.14) and a hex
bit-pattern (e.g. i x4048F5C3).
This attribute exists to round-trip Flang output; xDSL does not interpret the payload numerically.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.real'
class-attribute
instance-attribute
¶
fkind: IntAttr
instance-attribute
¶
value: StringAttr
instance-attribute
¶
print_parameters(printer: Printer) -> None
¶
parse_parameters(parser: AttrParser) -> list[Attribute]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
DummyScopeType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
fir.dscope is a type returned by fir.dummy_scope operation. It defines a unique identifier for a runtime instance of a subroutine that is used by the [hl]fir.declare operations representing the dummy arguments' declarations.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.dscope'
class-attribute
instance-attribute
¶
LLVMPointerType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
A pointer type that does not have any of the constraints and semantics of other FIR pointer types and that translates to llvm pointer types. It is meant to implement indirection that cannot be expressed directly in Fortran, but are needed to implement some Fortran features (e.g, double indirections).
Source code in xdsl/dialects/experimental/fir.py
PointerType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of entities with the POINTER attribute. These pointers are explicitly distinguished to disallow the composition of multiple levels of indirection. For example, an ALLOCATABLE POINTER is invalid.
Source code in xdsl/dialects/experimental/fir.py
NoneType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
This isn't part of the FIR MLIR dialect, and is only represented internally with xDSL, but is useful to denote when there is a none or empty attribute
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.none'
class-attribute
instance-attribute
¶
SequenceType
¶
Bases: ParametrizedAttribute, TypeAttribute
A sequence type is a multi-dimensional array of values. The sequence type may have an unknown number of dimensions or the extent of dimensions may be unknown. A sequence type models a Fortran array entity, giving it a type in FIR. A sequence type is assumed to be stored in a column-major order, which differs from LLVM IR and other dialects of MLIR.
Source code in xdsl/dialects/experimental/fir.py
694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 | |
name = 'fir.array'
class-attribute
instance-attribute
¶
shape: ArrayAttr[IntegerAttr | DeferredAttr | NoneType]
instance-attribute
¶
type: Attribute
instance-attribute
¶
type2: Attribute
instance-attribute
¶
__init__(type1: IntegerType | AnyFloat | ReferenceType, shape: list[int | IntegerAttr[IndexType] | DeferredAttr] | None = None, type2: IntegerType | AnyFloat | ReferenceType | None = None)
¶
Source code in xdsl/dialects/experimental/fir.py
print_parameters(printer: Printer) -> None
¶
Source code in xdsl/dialects/experimental/fir.py
parse_parameters(parser: AttrParser) -> list[Attribute]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
hasDeferredShape()
¶
CharacterType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Model of the Fortran CHARACTER intrinsic type, including the KIND type parameter. The model optionally includes a LEN type parameter. A CharacterType is thus the type of both a single character value and a character with a LEN parameter.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.char'
class-attribute
instance-attribute
¶
from_index: IntAttr | DeferredAttr
instance-attribute
¶
to_index: IntAttr | DeferredAttr
instance-attribute
¶
print_parameters(printer: Printer) -> None
¶
Source code in xdsl/dialects/experimental/fir.py
parse_parameters(parser: AttrParser) -> list[Attribute]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
RecordType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Fortran derived type (TYPE).
The name includes any KIND type parameters. The record may carry runtime slots for LEN type parameters and for data components. Both lists are optional in the assembly form.
Examples:
!fir.type
Self-referential derived types (e.g. !fir.type<t{p:!fir.ptr<!fir.type
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.type'
class-attribute
instance-attribute
¶
type_name: StringAttr
instance-attribute
¶
lenparams: ArrayAttr
instance-attribute
¶
components: ArrayAttr
instance-attribute
¶
print_parameters(printer: Printer) -> None
¶
Source code in xdsl/dialects/experimental/fir.py
parse_parameters(parser: AttrParser) -> list[Attribute]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
LogicalType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Model of a Fortran LOGICAL intrinsic type, including the KIND type parameter
Source code in xdsl/dialects/experimental/fir.py
IntType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Model of a Fortran INTEGER intrinsic type, including the KIND type parameter.
Source code in xdsl/dialects/experimental/fir.py
UnsignedType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Model of the Fortran UNSIGNED extension intrinsic type, including the KIND type parameter.
Source code in xdsl/dialects/experimental/fir.py
ClassType
¶
Bases: ParametrizedAttribute, TypeAttribute
Class type is used to model the Fortran CLASS intrinsic type. A class type is equivalent to a fir.box type with a dynamic type.
Flang 22.x added an optional volatile marker mirroring fir.box.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.class'
class-attribute
instance-attribute
¶
type: Attribute
instance-attribute
¶
is_volatile: BoolAttr
instance-attribute
¶
__init__(type: Attribute, is_volatile: bool = False) -> None
¶
print_parameters(printer: Printer) -> None
¶
parse_parameters(parser: AttrParser) -> list[Attribute]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
BoxProcType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of a Fortran procedure pointer, optionally including a host context.
Source code in xdsl/dialects/experimental/fir.py
FieldType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of a derived-type field name.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.field'
class-attribute
instance-attribute
¶
LenType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of a LEN type-parameter name.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.len'
class-attribute
instance-attribute
¶
TypeDescType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of a type descriptor for a Fortran derived type.
Source code in xdsl/dialects/experimental/fir.py
VoidType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The empty/unit type.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.void'
class-attribute
instance-attribute
¶
SliceType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Type of an array slice descriptor.
Source code in xdsl/dialects/experimental/fir.py
VectorType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
A SIMD vector type with a fixed length and element type.
Source code in xdsl/dialects/experimental/fir.py
ShiftType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Type of a vector of runtime values that define the lower bounds of a multidimensional array object. The vector is the lower bounds of each array dimension. The rank of a ShiftType must be at least 1.
Source code in xdsl/dialects/experimental/fir.py
ShapeType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Type of a vector of runtime values that define the shape of a multidimensional array object. The vector is the extents of each array dimension. The rank of a ShapeType must be at least 1.
Source code in xdsl/dialects/experimental/fir.py
ShapeShiftType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
Type of a vector of runtime values that define the shape and the origin of a multidimensional array object. The vector is of pairs, origin offset and extent, of each array dimension. The rank of a ShapeShiftType must be at least 1.
Source code in xdsl/dialects/experimental/fir.py
HeapType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of a heap pointer. Fortran entities with the ALLOCATABLE attribute may be allocated on the heap at runtime. These pointers are explicitly distinguished to disallow the composition of multiple levels of indirection. For example, an ALLOCATABLE POINTER is invalid.
Source code in xdsl/dialects/experimental/fir.py
BoxType
¶
Bases: ParametrizedAttribute, TypeAttribute
Descriptors are tuples of information that describe an entity being passed from a calling context. This information might include (but is not limited to) whether the entity is an array, its size, or what type it has.
Flang 22.x added an optional volatile marker that, when present,
indicates the descriptor wraps a Fortran VOLATILE entity. The textual
form is !fir.box<T> for the default and !fir.box<T, volatile>
when set.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.box'
class-attribute
instance-attribute
¶
type: Attribute
instance-attribute
¶
is_volatile: BoolAttr
instance-attribute
¶
__init__(type: Attribute, is_volatile: bool = False) -> None
¶
print_parameters(printer: Printer) -> None
¶
parse_parameters(parser: AttrParser) -> list[Attribute]
classmethod
¶
Source code in xdsl/dialects/experimental/fir.py
BoxCharType
dataclass
¶
Bases: ParametrizedAttribute, TypeAttribute
The type of a pair that describes a CHARACTER variable. Specifically, a CHARACTER consists of a reference to a buffer (the string value) and a LEN type parameter (the runtime length of the buffer).
Source code in xdsl/dialects/experimental/fir.py
AbsentOp
dataclass
¶
Bases: IRDLOperation
Given the type of a function argument, create a value that will signal that an optional argument is absent in the call. On the caller side, fir.is_present can be used to query if the value of an optional argument was created with a fir.absent operation.
It is undefined to use a value that was created by a fir.absent op in any other operation than fir.call and fir.is_present.
%1 = fir.absent fir.box<fir.array<?xf32>> fir.call @_QPfoo(%1) : (fir.box<fir.array<?xf32>>) -> ()
Source code in xdsl/dialects/experimental/fir.py
AddcOp
dataclass
¶
Bases: IRDLOperation
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.addc'
class-attribute
instance-attribute
¶
lhs = operand_def()
class-attribute
instance-attribute
¶
rhs = operand_def()
class-attribute
instance-attribute
¶
fastmath = opt_prop_def(FastMathFlagsAttr)
class-attribute
instance-attribute
¶
result = result_def()
class-attribute
instance-attribute
¶
AddressOfOp
dataclass
¶
Bases: IRDLOperation
Convert a symbol (a function or global reference) to an SSA-value to be used in other operations. References to Fortran symbols are distinguished via this operation from other arbitrary constant values.
%p = fir.address_of(@symbol) : !fir.ref
Source code in xdsl/dialects/experimental/fir.py
AllocmemOp
dataclass
¶
Bases: IRDLOperation
Creates a heap memory reference suitable for storing a value of the
given type, T. The heap refernce returned has type !fir.heap<T>.
The memory object is in an undefined state. allocmem operations must
be paired with freemem operations to avoid memory leaks.
%0 = fir.allocmem !fir.array<10 x f32> fir.freemem %0 : !fir.heap<!fir.array<10 x f32>>
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.allocmem'
class-attribute
instance-attribute
¶
in_type = prop_def()
class-attribute
instance-attribute
¶
uniq_name = opt_prop_def(StringAttr)
class-attribute
instance-attribute
¶
bindc_name = opt_prop_def(StringAttr)
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
shape = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
AllocaOp
dataclass
¶
Bases: IRDLOperation
This primitive operation is used to allocate an object on the stack. A
reference to the object of type '!fir.ref
%c = ... : i64
%x = fir.alloca i32
%y = fir.alloca !fir.array<8 x i64>
%z = fir.alloca f32, %c
%i = ... : i16
%j = ... : i32
%w = fir.alloca !fir.type<PT(len1:i16, len2:i32)> (%i, %j : i16, i32)
Note that in the case of '%z', a contiguous block of memory is allocated and its size is a runtime multiple of a 32-bit REAL value.
In the case of '%w', the arguments '%i' and '%j' are LEN parameters ('len1', 'len2') to the type 'PT'.
Finally, the operation is undefined if the ssa-value '%c' is negative.
Fortran Semantics: There is no language mechanism in Fortran to allocate space on the stack like C's 'alloca()' function. Therefore fir.alloca is not control-flow dependent. However, the lifetime of a stack allocation is often limited to a small region and a legal implementation may reuse stack storage in other regions when there is no conflict. For example, take the following code fragment.
CALL foo(1) CALL foo(2) CALL foo(3)
A legal implementation can allocate a stack slot and initialize it with the constant '1', then pass that by reference to foo. Likewise for the second and third calls to foo, each stack slot being initialized accordingly. It is also a conforming implementation to reuse the same stack slot for all three calls, just initializing each in turn. This is possible as the lifetime of the copy of each constant need not exceed that of the CALL statement. Indeed, a user would likely expect a good Fortran compiler to perform such an optimization.
Until Fortran 2018, procedures defaulted to non-recursive. A legal implementation could therefore convert stack allocations to global allocations. Such a conversion effectively adds the SAVE attribute to all variables.
Some temporary entities (large arrays) probably should not be stack allocated as stack space can often be limited. A legal implementation can convert these large stack allocations to heap allocations regardless of whether the procedure is recursive or not.
The pinned attribute is used to flag fir.alloca operation in a specific region and avoid them being hoisted in an alloca hoisting pass.
Source code in xdsl/dialects/experimental/fir.py
1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 | |
name = 'fir.alloca'
class-attribute
instance-attribute
¶
in_type = prop_def()
class-attribute
instance-attribute
¶
uniq_name = opt_prop_def(StringAttr)
class-attribute
instance-attribute
¶
bindc_name = opt_prop_def(StringAttr)
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
shape = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
pinned = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ArrayAccessOp
dataclass
¶
Bases: IRDLOperation
The 'array_access' provides a reference to a single element from an array value. This is not a view in the immutable array, otherwise it couldn't be stored to. It can be see as a logical copy of the element and its position in the array. This reference can be written to and modified without changing the original array.
The 'array_access' operation is used to fetch the memory reference of an element in an array value.
real :: a(n,m) ... ... a ... ... a(r,s+1) ...
One can use 'fir.array_access' to recover the implied memory reference to the element 'a(i,j)' in an array expression 'a' as shown above. It can also be used to recover the reference element 'a(r,s+1)' in the second expression.
%s = fir.shape %n, %m : (index, index) -> !fir.shape<2>
// load the entire array 'a'
%v = fir.array_load %a(%s) : (!fir.ref<!fir.array<?x?xf32>>, !fir.shape<2>) -> !fir.array<?x?xf32>
// fetch the value of one of the array value's elements
%1 = fir.array_access %v, %i, %j : (!fir.array<?x?xf32>, index, index) -> !fir.ref
It is only possible to use 'array_access' on an 'array_load' result value or a value that can be trace back transitively to an 'array_load' as the dominating source. Other array operation such as 'array_amend' can be in between.
TODO: The above restriction is not enforced. The design of the operation might need to be revisited to avoid such restrictions.
More information about 'array_access' and other array operations can be found in Flang documentation at flang/docs/FIRArrayOperations.md.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.array_access'
class-attribute
instance-attribute
¶
sequence = operand_def()
class-attribute
instance-attribute
¶
indices = var_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
element = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ArrayAmendOp
dataclass
¶
Bases: IRDLOperation
The 'array_amend' operation marks an array value as having been changed via
a reference obtained by an array_access. It acts as a logical transaction
log that is used to merge the final result back with an array_merge_store
operation.
// fetch the value of one of the array value's elements
%1 = fir.array_access %v, %i, %j : (!fir.array<?x?xT>, index, index) -> !fir.ref
More information about array_amend and other array operations can be
found in Flang documentation at flang/docs/FIRArrayOperations.md.
Source code in xdsl/dialects/experimental/fir.py
ArrayCoorOp
dataclass
¶
Bases: IRDLOperation
Compute the location of an element in an array when the shape of the array is only known at runtime.
This operation is intended to capture all the runtime values needed to compute the address of an array reference in a single high-level op. Given the following Fortran input:
real :: a(n,m) ... ... a(i,j) ...
One can use 'fir.array_coor' to determine the address of 'a(i,j)'.
%s = fir.shape %n, %m : (index, index) -> !fir.shape<2>
%1 = fir.array_coor %a(%s) %i, %j : (!fir.ref<!fir.array<?x?xf32>>, !fir.shape<2>, index, index) -> !fir.ref
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.array_coor'
class-attribute
instance-attribute
¶
memref = operand_def()
class-attribute
instance-attribute
¶
shape = opt_operand_def()
class-attribute
instance-attribute
¶
slice = opt_operand_def()
class-attribute
instance-attribute
¶
indices = var_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ArrayFetchOp
dataclass
¶
Bases: IRDLOperation
Fetch the value of an element in an array value.
real :: a(n,m) ... ... a ... ... a(r,s+1) ...
One can use 'fir.array_fetch' to fetch the (implied) value of 'a(i,j)' in an array expression as shown above. It can also be used to extract the element 'a(r,s+1)' in the second expression.
%s = fir.shape %n, %m : (index, index) -> !fir.shape<2> // load the entire array 'a' %v = fir.array_load %a(%s) : (!fir.ref<!fir.array<?x?xf32>>, !fir.shape<2>) -> !fir.array<?x?xf32> // fetch the value of one of the array value's elements %1 = fir.array_fetch %v, %i, %j : (!fir.array<?x?xf32>, index, index) -> f32
It is only possible to use 'array_fetch' on an 'array_load' result value.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.array_fetch'
class-attribute
instance-attribute
¶
sequence = operand_def()
class-attribute
instance-attribute
¶
indices = var_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
element = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ArrayLoadOp
dataclass
¶
Bases: IRDLOperation
This operation taken with array_merge_store captures Fortran's copy-in/copy-out semantics. One way to think of this is that array_load creates a snapshot copy of the entire array. This copy can then be used as the "original value" of the array while the array's new value is computed. The array_merge_store operation is the copy-out semantics, which merge the updates with the original array value to produce the final array result. This abstracts the copy operations as opposed to always creating copies or requiring dependence analysis be performed on the syntax trees and before lowering to the IR.
Load an entire array as a single SSA value.
real :: a(o:n,p:m) ... ... = ... a ...
One can use 'fir.array_load' to produce an ssa-value that captures an
immutable value of the entire array a, as in the Fortran array expression
shown above. Subsequent changes to the memory containing the array do not
alter its composite value. This operation lets one load an array as a
value while applying a runtime shape, shift, or slice to the memory
reference, and its semantics guarantee immutability.
%s = fir.shape_shift %o, %n, %p, %m : (index, index, index, index) -> !fir.shapeshift<2> // load the entire array 'a' %v = fir.array_load %a(%s) : (!fir.ref<!fir.array<?x?xf32>>, !fir.shapeshift<2>) -> !fir.array<?x?xf32> // a fir.store here into array %a does not change %v
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.array_load'
class-attribute
instance-attribute
¶
memref = operand_def()
class-attribute
instance-attribute
¶
shape = opt_operand_def()
class-attribute
instance-attribute
¶
slice = opt_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ArrayMergeStoreOp
dataclass
¶
Bases: IRDLOperation
Store a merged array value to memory.
real :: a(n,m) ... a = ...
One can use 'fir.array_merge_store' to merge/copy the value of 'a' in an array expression as shown above.
%v = fir.array_load %a(%shape) : ... %r = fir.array_update %v, %f, %i, %j : (!fir.array<?x?xf32>, f32, index, index) -> !fir.array<?x?xf32> fir.array_merge_store %v, %r to %a : !fir.ref<!fir.array<?x?xf32>>
This operation merges the original loaded array value, '%v', with the chained updates, '%r', and stores the result to the array at address, '%a'.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.array_merge_store'
class-attribute
instance-attribute
¶
original = operand_def()
class-attribute
instance-attribute
¶
sequence = operand_def()
class-attribute
instance-attribute
¶
memref = operand_def()
class-attribute
instance-attribute
¶
slice = opt_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ArrayModifyOp
dataclass
¶
Bases: IRDLOperation
Modify the value of an element in an array value through actions done on the returned address. A new array value is also returned where all element values of the input array are identical except for the selected element which is the value after the modification done on the element address.
real :: a(n) ... ! Elemental user defined assignment from type(SomeType) to real. a = value_of_some_type
One can use 'fir.array_modify' to update the (implied) value of 'a(i)' in an array expression as shown above.
%s = fir.shape %n : (index) -> !fir.shape<1>
// Load the entire array 'a'.
%v = fir.array_load %a(%s) : (!fir.ref<!fir.array<?xf32>>, !fir.shape<1>) -> !fir.array<?xf32>
// Update the value of one of the array value's elements with a user
// defined assignment from %rhs.
%new = fir.do_loop %i = ... (%inner = %v) {
%rhs = ...
%addr, %r = fir.array_modify %inner, %i : (!fir.array<?xf32>, index) -> (fir.ref
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.array_modify'
class-attribute
instance-attribute
¶
sequence = operand_def()
class-attribute
instance-attribute
¶
indices = var_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
result_1 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ArrayUpdateOp
dataclass
¶
Bases: IRDLOperation
Updates the value of an element in an array value. A new array value is returned where all element values of the input array are identical except for the selected element which is the value passed in the update.
real :: a(n,m) ... a = ...
One can use 'fir.array_update' to update the (implied) value of 'a(i,j)' in an array expression as shown above.
%s = fir.shape %n, %m : (index, index) -> !fir.shape<2> // load the entire array 'a' %v = fir.array_load %a(%s) : (!fir.ref<!fir.array<?x?xf32>>, !fir.shape<2>) -> !fir.array<?x?xf32> // update the value of one of the array value's elements // %r_{ij} = %f if (i,j) = (%i,%j), %v_{ij} otherwise %r = fir.array_update %v, %f, %i, %j : (!fir.array<?x?xf32>, f32, index, index) -> !fir.array<?x?xf32> fir.array_merge_store %v, %r to %a : !fir.ref<!fir.array<?x?xf32>>
An array value update behaves as if a mapping function from the indices to the new value has been added, replacing the previous mapping. These mappings can be added to the ssa-value, but will not be materialized in memory until the 'fir.array_merge_store' is performed.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.array_update'
class-attribute
instance-attribute
¶
sequence = operand_def()
class-attribute
instance-attribute
¶
merge = operand_def()
class-attribute
instance-attribute
¶
indices = var_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
BoxAddrOp
dataclass
¶
Bases: IRDLOperation
This operator is overloaded to work with values of type 'box', 'boxchar', and 'boxproc'. The result for each of these cases, respectively, is the address of the data, the address of the 'CHARACTER' data, and the address of the procedure.
%51 = fir.box_addr %box : (!fir.box
Source code in xdsl/dialects/experimental/fir.py
BoxcharLenOp
dataclass
¶
Bases: IRDLOperation
Extracts the LEN type parameter from a 'boxchar' value.
%45 = ... : !boxchar<1> // CHARACTER(20) %59 = fir.boxchar_len %45 : (!fir.boxchar<1>) -> i64 // len=20
Source code in xdsl/dialects/experimental/fir.py
BoxDimsOp
dataclass
¶
Bases: IRDLOperation
Returns the triple of lower bound, extent, and stride for 'dim' dimension of 'val', which must have a 'box' type. The dimensions are enumerated from left to right from 0 to rank-1. This operation has undefined behavior if 'dim' is out of bounds.
%c1 = arith.constant 0 : i32 %52:3 = fir.box_dims %40, %c1 : (!fir.box<!fir.array<*:f64>>, i32) -> (index, index, index)
The above is a request to return the left most row (at index 0) triple from the box. The triple will be the lower bound, extent, and byte-stride, which are the values encoded in a standard descriptor.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.box_dims'
class-attribute
instance-attribute
¶
val = operand_def()
class-attribute
instance-attribute
¶
dim = operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
result_1 = result_def()
class-attribute
instance-attribute
¶
result_2 = result_def()
class-attribute
instance-attribute
¶
BoxElesizeOp
dataclass
¶
Bases: IRDLOperation
Returns the size of an element in an entity of 'box' type. This size may not be known until runtime.
%53 = fir.box_elesize %40 : (!fir.box
In the above example, '%53' may box an array of REAL values while '%54' must box an array of REAL values (with dynamic rank and extent).
Source code in xdsl/dialects/experimental/fir.py
BoxIsallocOp
dataclass
¶
Bases: IRDLOperation
Determine if the boxed value was from an ALLOCATABLE entity. This will
return true if the originating box value was from a 'fir.embox' op
with a mem-ref value that had the type !fir.heap
%r = ... : !fir.heap
The canonical descriptor implementation will carry a flag to record if the variable is an 'ALLOCATABLE'.
Source code in xdsl/dialects/experimental/fir.py
BoxIsarrayOp
dataclass
¶
Bases: IRDLOperation
Determine if the boxed value has a positive (> 0) rank. This will return
true if the originating box value was from a fir.embox with a memory
reference value that had the type !fir.array
%r = ... : !fir.ref
Source code in xdsl/dialects/experimental/fir.py
BoxIsptrOp
dataclass
¶
Bases: IRDLOperation
Determine if the boxed value was from a POINTER entity.
%p = ... : !fir.ptr
Source code in xdsl/dialects/experimental/fir.py
BoxOffsetOp
dataclass
¶
Bases: IRDLOperation
Given the address of a fir.box, compute the address of a field inside the fir.box. This allows keeping the actual runtime descriptor layout abstract in FIR while providing access to the pointer addresses in the runtime descriptor for OpenMP/OpenACC target mapping.
To avoid requiring too much information about the fields that the runtime descriptor implementation must have, only the base_addr and derived_type descriptor fields can be addressed.
%addr = fir.box_offset %box base_addr : (!fir.ref<!fir.box<!fir.array<?xi32>>>) -> !fir.llvm_ptr<!fir.ref<!fir.array<?xi32>>>
%tdesc = fir.box_offset %box derived_type : (!fir.ref<!fir.box<!fir.type
Source code in xdsl/dialects/experimental/fir.py
BoxprocHostOp
dataclass
¶
Bases: IRDLOperation
Extract the host context pointer from a boxproc value.
%8 = ... : !fir.boxproc<(!fir.ref<!fir.type
In the example, the reference to the closure over the host procedure's variables is returned. This allows an internal procedure to access the host's variables. It is up to lowering to determine the contract between the host and the internal procedure.
Source code in xdsl/dialects/experimental/fir.py
BoxRankOp
dataclass
¶
Bases: IRDLOperation
Return the rank of a value of 'box' type. If the value is scalar, the rank is 0.
%57 = fir.box_rank %40 : (!fir.box<!fir.array<*:f64>>) -> i32
%58 = fir.box_rank %41 : (!fir.box
The example '%57' shows how one would determine the rank of an array that has deferred rank at runtime. This rank should be at least 1. In %58, the descriptor may be either an array or a scalar, so the value is nonnegative.
Source code in xdsl/dialects/experimental/fir.py
BoxTdescOp
dataclass
¶
Bases: IRDLOperation
Return the opaque type descriptor of a value of 'box' type. A type descriptor is an implementation defined value that fully describes a type to the Fortran runtime.
%7 = fir.box_tdesc %41 : (!fir.box
Source code in xdsl/dialects/experimental/fir.py
CallOp
dataclass
¶
Bases: IRDLOperation
Call the specified function or function reference.
%a = fir.call %funcref(%arg0) : (!fir.ref
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.call'
class-attribute
instance-attribute
¶
callee = opt_prop_def(SymbolRefAttr)
class-attribute
instance-attribute
¶
fastmath = opt_prop_def(FastMathFlagsAttr)
class-attribute
instance-attribute
¶
procedure_attrs = opt_prop_def(FortranProcedureFlagsAttr)
class-attribute
instance-attribute
¶
inline_attr = opt_prop_def(FortranInlineFlagsAttr)
class-attribute
instance-attribute
¶
args = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = var_result_def()
class-attribute
instance-attribute
¶
CharConvertOp
dataclass
¶
Bases: IRDLOperation
Copy a CHARACTER (must be in memory) of KIND k1 to a CHARACTER (also must be in memory) of KIND k2 where k1 != k2 and the buffers do not overlap. This latter restriction is unchecked, as the Fortran language definition eliminates the overlapping in memory case.
The number of code points copied is specified explicitly as the second argument. The length of the !fir.char type is ignored.
fir.char_convert %1 for %2 to %3 : !fir.ref<!fir.char<1,?>>, i32, !fir.ref<!fir.char<2,20>>
Should future support for encodings other than ASCII be supported, codegen can generate a call to a runtime helper routine which will map the code points from UTF-8 to UCS-2, for example. Such remappings may not always be possible as they may involve the creation of more code points than the 'count' limit. These details are left as future to-dos.
Source code in xdsl/dialects/experimental/fir.py
CmpcOp
dataclass
¶
Bases: IRDLOperation
A complex comparison to handle complex types found in FIR.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.cmpc'
class-attribute
instance-attribute
¶
predicate = prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
fastmath = opt_prop_def(FastMathFlagsAttr)
class-attribute
instance-attribute
¶
lhs = operand_def()
class-attribute
instance-attribute
¶
rhs = operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
ConvertOp
dataclass
¶
Bases: IRDLOperation
Generalized type conversion. Convert the ssa-value from type T to type U. Not all pairs of types have conversions. When types T and U are the same type, this instruction is a NOP and may be folded away. This also supports integer to pointer conversion and pointer to integer conversion.
%v = ... : i64 %w = fir.convert %v : (i64) -> i32
The example truncates the value '%v' from an i64 to an i32.
Source code in xdsl/dialects/experimental/fir.py
CoordinateOfOp
dataclass
¶
Bases: IRDLOperation
Compute the internal coordinate address starting from a boxed value or unboxed memory reference. Returns a memory reference. When computing the coordinate of an array element, the rank of the array must be known and the number of indexing expressions must not exceed the rank of the array.
This operation will apply the access map from a boxed value implicitly.
Unlike LLVM's GEP instruction, one cannot stride over the outermost reference; therefore, the leading 0 index must be omitted.
%i = ... : index
%h = ... : !fir.heap<!fir.array<100 x f32>>
%p = fir.coordinate_of %h, %i : (!fir.heap<!fir.array<100 x f32>>, index) -> !fir.ref
In the example, '%p' will be a pointer to the '%i'-th f32 value in the array '%h'.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.coordinate_of'
class-attribute
instance-attribute
¶
baseType = prop_def()
class-attribute
instance-attribute
¶
field_indices = opt_prop_def()
class-attribute
instance-attribute
¶
ref = operand_def()
class-attribute
instance-attribute
¶
coor = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
DeclareOp
dataclass
¶
Bases: IRDLOperation
Tie the properties of a Fortran variable to an address. The properties include bounds, length parameters, and Fortran attributes.
The memref argument describes the storage of the variable. It may be a
raw address (fir.ref
The shape argument encodes explicit extents and lower bounds. It must be provided if the memref is the raw address of an array. The shape argument must not be provided if memref operand is a box or class value or address, unless the shape is a shift (encodes lower bounds) and the memref if a box value (this covers assumed shapes with local lower bounds).
The typeparams values are meant to carry the non-deferred length parameters (this includes both Fortran assumed and explicit length parameters). It must always be provided for characters and parametrized derived types when memref is not a box value or address.
Example:
CHARACTER(n), OPTIONAL, TARGET :: c(10:, 20:)
Can be represented as:
func.func @foo(%arg0: !fir.box<!fir.array>>, %arg1: !fir.ref
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.declare'
class-attribute
instance-attribute
¶
memref = operand_def()
class-attribute
instance-attribute
¶
shape = opt_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
dummy_scope = opt_operand_def()
class-attribute
instance-attribute
¶
storage = opt_operand_def()
class-attribute
instance-attribute
¶
storage_offset = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
uniq_name = prop_def(StringAttr)
class-attribute
instance-attribute
¶
fortran_attrs = opt_prop_def(FortranVariableFlagsAttr)
class-attribute
instance-attribute
¶
data_attr = opt_prop_def(Attribute)
class-attribute
instance-attribute
¶
dummy_arg_no = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
result = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
DtEntryOp
dataclass
¶
Bases: IRDLOperation
An entry in a dispatch table. Allows a function symbol to be bound to a specifier method identifier. A dispatch operation uses the dynamic type of a distinguished argument to determine an exact dispatch table and uses the method identifier to select the type-bound procedure to be called.
fir.dt_entry method_name, @uniquedProcedure
Source code in xdsl/dialects/experimental/fir.py
DispatchOp
dataclass
¶
Bases: IRDLOperation
Perform a dynamic dispatch on the method name via the dispatch table associated with the first operand. The attribute 'pass_arg_pos' can be used to select a dispatch operand other than the first one. The absence of 'pass_arg_pos' attribute means nopass.
// fir.dispatch with no attribute.
%r = fir.dispatch "methodA"(%o) : (!fir.class
// fir.dispatch with the pass_arg_pos attribute.
%r = fir.dispatch "methodA"(%o : !fir.class
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.dispatch'
class-attribute
instance-attribute
¶
method = prop_def(StringAttr)
class-attribute
instance-attribute
¶
pass_arg_pos = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
object = operand_def()
class-attribute
instance-attribute
¶
args = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = var_result_def()
class-attribute
instance-attribute
¶
DivcOp
dataclass
¶
Bases: IRDLOperation
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.divc'
class-attribute
instance-attribute
¶
lhs = operand_def()
class-attribute
instance-attribute
¶
rhs = operand_def()
class-attribute
instance-attribute
¶
fastmath = opt_prop_def(FastMathFlagsAttr)
class-attribute
instance-attribute
¶
result = result_def()
class-attribute
instance-attribute
¶
DoLoopOp
dataclass
¶
Bases: IRDLOperation
Generalized high-level looping construct. This operation is similar to MLIR's 'scf.for'.
%l = arith.constant 0 : index
%u = arith.constant 9 : index
%s = arith.constant 1 : index
fir.do_loop %i = %l to %u step %s unordered {
%x = fir.convert %i : (index) -> i32
%v = fir.call @compute(%x) : (i32) -> f32
%p = fir.coordinate_of %A, %i : (!fir.ref<!fir.array<?xf32>>, index) -> !fir.ref
The above example iterates over the interval '[%l, %u]'. The unordered keyword indicates that the iterations can be executed in any order.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.do_loop'
class-attribute
instance-attribute
¶
lowerBound = operand_def()
class-attribute
instance-attribute
¶
upperBound = operand_def()
class-attribute
instance-attribute
¶
step = operand_def()
class-attribute
instance-attribute
¶
reduceOperands = var_operand_def()
class-attribute
instance-attribute
¶
initArgs = var_operand_def()
class-attribute
instance-attribute
¶
unordered = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
finalValue = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
reduceAttrs = opt_prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
loopAnnotation = opt_prop_def(Attribute)
class-attribute
instance-attribute
¶
region = region_def('single_block')
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
DummyScopeOp
dataclass
¶
Bases: IRDLOperation
An abstract handle to be used to associate dummy arguments of the same subroutine between each other. By lowering, all [hl]fir.declare operations representing declarations of dummy arguments of a subroutine use the result of this operation. This allows recognizing the references of these dummy arguments as belonging to the same runtime instance of the subroutine even after MLIR inlining. Thus, the Fortran aliasing rules might be applied to those references based on the original declarations of the dummy arguments. For example: subroutine test(x, y) real, target :: x, y x = y ! may alias call inner(x, y) contains subroutine inner(x, y) real :: x, y x = y ! may not alias end subroutine inner end subroutine test
After MLIR inlining this may look like this:
func.func @_QPtest(
%arg0: !fir.ref
Without marking %3 and %4 as declaring the dummy arguments
of the same runtime instance of inner subroutine the FIR
AliasAnalysis cannot deduce non-aliasing for the second load/store pair.
This information may be preserved by using fir.dummy_scope operation:
func.func @_QPtest(
%arg0: !fir.ref
Note that even if inner is called and inlined twice inside
test, the two inlined instances of inner must use two different
fir.dummy_scope operations for their fir.declare ops. This
two distinct fir.dummy_scope must remain distinct during the optimizations.
This is guaranteed by the write memory effect on the DebuggingResource.
Source code in xdsl/dialects/experimental/fir.py
2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 | |
EmboxcharOp
dataclass
¶
Bases: IRDLOperation
Create a boxed CHARACTER value. The CHARACTER type has the LEN type parameter, the value of which may only be known at runtime. Therefore, a variable of type CHARACTER has both its data reference as well as a LEN type parameter.
CHARACTER(LEN=10) :: var
%4 = ... : !fir.ref<!fir.array<10 x !fir.char<1>>> %5 = arith.constant 10 : i32 %6 = fir.emboxchar %4, %5 : (!fir.ref<!fir.array<10 x !fir.char<1>>>, i32) -> !fir.boxchar<1>
In the above '%4' is a memory reference to a buffer of 10 CHARACTER units. This buffer and its LEN value (10) are wrapped into a pair in '%6'.
Source code in xdsl/dialects/experimental/fir.py
EmboxOp
dataclass
¶
Bases: IRDLOperation
Create a boxed reference value. In Fortran, the implementation can require extra information about an entity, such as its type, rank, etc. This auxiliary information is packaged and abstracted as a value with box type by the calling routine. (In Fortran, these are called descriptors.)
%c1 = arith.constant 1 : index %c10 = arith.constant 10 : index %5 = ... : !fir.ref<!fir.array<10 x i32>> %6 = fir.embox %5 : (!fir.ref<!fir.array<10 x i32>>) -> !fir.box<!fir.array<10 x i32>>
The descriptor tuple may contain additional implementation-specific information through the use of additional attributes. Specifically, - shape: emboxing an array may require shape information (an array's lower bounds and extents may not be known until runtime), - slice: an array section can be described with a slice triple, - typeparams: for emboxing a derived type with LEN type parameters, - accessMap: unused/experimental.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.embox'
class-attribute
instance-attribute
¶
memref = operand_def()
class-attribute
instance-attribute
¶
shape = var_operand_def()
class-attribute
instance-attribute
¶
slice = var_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
sourceBox = var_operand_def()
class-attribute
instance-attribute
¶
accessMap = opt_prop_def(Attribute)
class-attribute
instance-attribute
¶
allocator_idx = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
EmboxprocOp
dataclass
¶
Bases: IRDLOperation
Creates an abstract encapsulation of a PROCEDURE POINTER along with an optional pointer to a host instance context. If the pointer is not to an internal procedure or the internal procedure does not need a host context then the form takes only the procedure's symbol.
%f = ... : (i32) -> i32 %0 = fir.emboxproc %f : ((i32) -> i32) -> !fir.boxproc<(i32) -> i32>
An internal procedure requiring a host instance for correct execution uses the second form. The closure of the host procedure's state is passed as a reference to a tuple. It is the responsibility of the host to manage the context's values accordingly, up to and including inhibiting register promotion of local values.
%4 = ... : !fir.ref<tuple<!fir.ref
Source code in xdsl/dialects/experimental/fir.py
ExtractValueOp
dataclass
¶
Bases: IRDLOperation
Extract a value from an entity with a type composed of tuples, arrays, and/or derived types. Returns the value from entity with the type of the specified component. Cannot be used on values of '!fir.box' type. It can also be used to access complex parts and elements of a character string.
Note that the entity ssa-value must be of compile-time known size in order to use this operation.
%f = fir.field_index field, !fir.type
Source code in xdsl/dialects/experimental/fir.py
FieldIndexOp
dataclass
¶
Bases: IRDLOperation
Generate a field (offset) value from an identifier. Field values may be lowered into exact offsets when the layout of a Fortran derived type is known at compile-time. The type of a field value is '!fir.field' and these values can be used with the 'fir.coordinate_of', 'fir.extract_value', or 'fir.insert_value' instructions to compute (abstract) addresses of subobjects.
%f = fir.field_index field, !fir.type
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.field_index'
class-attribute
instance-attribute
¶
field_id = prop_def(StringAttr)
class-attribute
instance-attribute
¶
on_type = prop_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
res = result_def()
class-attribute
instance-attribute
¶
EndOp
dataclass
¶
Bases: IRDLOperation
The end terminator is a special terminator used inside various FIR operations that have regions. End is thus the custom invisible terminator for these operations. It is implicit and need not appear in the textual representation.
Source code in xdsl/dialects/experimental/fir.py
FreememOp
dataclass
¶
Bases: IRDLOperation
Deallocates a heap memory reference that was allocated by an 'allocmem'. The memory object that is deallocated is placed in an undefined state after 'fir.freemem'. Optimizations may treat the loading of an object in the undefined state as undefined behavior. This includes aliasing references, such as the result of an 'fir.embox'.
%21 = fir.allocmem !fir.type
Source code in xdsl/dialects/experimental/fir.py
GlobalLenOp
dataclass
¶
Bases: IRDLOperation
A global entity (that is not an automatic data object) can have extra LEN parameter (compile-time) constants associated with the instance's type. These values can be bound to the global instance used 'fir.global_len'.
global @g : !fir.type
Source code in xdsl/dialects/experimental/fir.py
GlobalOp
dataclass
¶
Bases: IRDLOperation
A global variable or constant with initial values.
The example creates a global variable (writable) named '@_QV_Mquark_Vvarble' with some initial values. The initializer should conform to the variable's type.
fir.global @_QV_Mquark_Vvarble : tuple
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.global'
class-attribute
instance-attribute
¶
region = opt_region_def()
class-attribute
instance-attribute
¶
sym_name = prop_def(SymbolNameConstraint())
class-attribute
instance-attribute
¶
symref = prop_def(SymbolRefAttr)
class-attribute
instance-attribute
¶
type = prop_def()
class-attribute
instance-attribute
¶
initVal = opt_prop_def()
class-attribute
instance-attribute
¶
constant = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
target = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
linkName = opt_prop_def(StringAttr)
class-attribute
instance-attribute
¶
data_attr = opt_prop_def()
class-attribute
instance-attribute
¶
alignment = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
traits = traits_def(SymbolOpInterface(), IsolatedFromAbove())
class-attribute
instance-attribute
¶
HasValueOp
dataclass
¶
Bases: IRDLOperation
The terminator for a GlobalOp with a body.
global @variable : tuple
Source code in xdsl/dialects/experimental/fir.py
IfOp
dataclass
¶
Bases: IRDLOperation
Used to conditionally execute operations. This operation is the FIR dialect's version of 'loop.if'.
%56 = ... : i1 %78 = ... : !fir.ref<!T> fir.if %56 { fir.store %76 to %78 : !fir.ref<!T> } else { fir.store %77 to %78 : !fir.ref<!T> }
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.if'
class-attribute
instance-attribute
¶
condition = operand_def()
class-attribute
instance-attribute
¶
output = var_result_def()
class-attribute
instance-attribute
¶
then_region = region_def()
class-attribute
instance-attribute
¶
else_region = opt_region_def()
class-attribute
instance-attribute
¶
InsertOnRangeOp
dataclass
¶
Bases: IRDLOperation
Insert copies of a value into an entity with an array type of constant shape and size. Returns a new ssa-value with the same type as the original entity. The values are inserted at a contiguous range of indices in Fortran row-to-column element order as specified by lower and upper bound coordinates.
%a = fir.undefined !fir.array<10x10xf32> %c = arith.constant 3.0 : f32 %1 = fir.insert_on_range %a, %c from (0, 0) to (7, 2) : (!fir.array<10x10xf32>, f32) -> !fir.array<10x10xf32>
The first 28 elements of %1, with coordinates from (0,0) to (7,2), have the value 3.0.
Source code in xdsl/dialects/experimental/fir.py
InsertValueOp
dataclass
¶
Bases: IRDLOperation
Insert a value into an entity with a type composed of tuples, arrays, and/or derived types. Returns a new ssa-value with the same type as the original entity. Cannot be used on values of '!fir.box' type. It can also be used to set complex parts and elements of a character string.
Note that the entity ssa-value must be of compile-time known size in order to use this operation.
%a = ... : !fir.array<10xtuple
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.insert_value'
class-attribute
instance-attribute
¶
adt = operand_def()
class-attribute
instance-attribute
¶
val = operand_def()
class-attribute
instance-attribute
¶
coor = prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
IsPresentOp
dataclass
¶
Bases: IRDLOperation
Determine if an optional function argument is PRESENT (i.e. that it was not created by a fir.absent op on the caller side).
func @_QPfoo(%arg0: !fir.box<!fir.array<?xf32>>) { %0 = fir.is_present %arg0 : (!fir.box<!fir.array<?xf32>>) -> i1 ...
Source code in xdsl/dialects/experimental/fir.py
IterateWhileOp
dataclass
¶
Bases: IRDLOperation
This single-entry, single-exit looping construct is useful for lowering counted loops that can exit early such as, for instance, implied-DO loops. It is very similar to fir.DoLoopOp with the addition that it requires a single loop-carried bool value that signals an early exit condition to the operation. A true disposition means the next loop iteration should proceed. A false indicates that the fir.iterate_while operation should terminate and return its iteration arguments. This is a degenerate counted loop in that the loop is not guaranteed to execute all iterations.
An example iterate_while that returns the counter value, the early termination condition, and an extra loop-carried value is shown here. This loop counts from %lo to %up (inclusive), stepping by %c1, so long as the early exit (%ok) is true. The iter_args %sh value is also carried by the loop. The result triple is the values of %i=phi(%lo,%i+%c1), %ok=phi(%okIn,%okNew), and %sh=phi(%shIn,%shNew) from the last executed iteration.
%v:3 = fir.iterate_while (%i = %lo to %up step %c1) and (%ok = %okIn) iter_args(%sh = %shIn) -> (index, i1, i16) { %shNew = fir.call @bar(%sh) : (i16) -> i16 %okNew = fir.call @foo(%sh) : (i16) -> i1 fir.result %i, %okNew, %shNew : index, i1, i16 }
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.iterate_while'
class-attribute
instance-attribute
¶
finalValue = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
lowerBound = operand_def()
class-attribute
instance-attribute
¶
upperBound = operand_def()
class-attribute
instance-attribute
¶
step = operand_def()
class-attribute
instance-attribute
¶
iterateIn = operand_def()
class-attribute
instance-attribute
¶
initArgs = var_operand_def()
class-attribute
instance-attribute
¶
region = region_def('single_block')
class-attribute
instance-attribute
¶
LenParamIndexOp
dataclass
¶
Bases: IRDLOperation
Generate a LEN parameter (offset) value from a LEN parameter identifier. The type of a LEN parameter value is '!fir.len' and these values can be used with the fir.coordinate_of instructions to compute (abstract) addresses of LEN parameters.
%e = fir.len_param_index len1, !fir.type
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.len_param_index'
class-attribute
instance-attribute
¶
field_id = prop_def(StringAttr)
class-attribute
instance-attribute
¶
on_type = prop_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
res = result_def()
class-attribute
instance-attribute
¶
LoadOp
dataclass
¶
Bases: IRDLOperation
Load a value from a memory reference into an ssa-value (virtual register).
Produces an immutable ssa-value of the referent type. A memory reference
has type '!fir.ref
%a = fir.alloca i32
%l = fir.load %a : !fir.ref
The ssa-value has an undefined value if the memory reference is undefined or null.
Source code in xdsl/dialects/experimental/fir.py
MulcOp
dataclass
¶
Bases: IRDLOperation
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.mulc'
class-attribute
instance-attribute
¶
lhs = operand_def()
class-attribute
instance-attribute
¶
rhs = operand_def()
class-attribute
instance-attribute
¶
fastmath = opt_prop_def(FastMathFlagsAttr)
class-attribute
instance-attribute
¶
result = result_def()
class-attribute
instance-attribute
¶
NegcOp
dataclass
¶
Bases: IRDLOperation
Source code in xdsl/dialects/experimental/fir.py
NoReassocOp
dataclass
¶
Bases: IRDLOperation
Primitive operation meant to intrusively prevent operator reassociation. The operation is otherwise a nop and the value returned is the same as the argument.
The presence of this operation prevents any local optimizations. In the example below, this would prevent possibly replacing the multiply and add operations with a single FMA operation.
%98 = arith.mulf %96, %97 : f32 %99 = fir.no_reassoc %98 : f32 %a0 = arith.addf %99, %95 : f32
Source code in xdsl/dialects/experimental/fir.py
ReboxOp
dataclass
¶
Bases: IRDLOperation
Create a new boxed reference value from another box. This is meant to be used when the taking a reference to part of a boxed value, or to an entire boxed value with new shape or type information.
The new extra information can be
- new shape information (new lower bounds, new rank, or new extents. New rank/extents can only be provided if the original fir.box is contiguous in all dimension but maybe the first row). The shape operand must be provided to set new shape information.
- new type (only for derived types). It is possible to set the dynamic type of the new box to one of the parent types of the input box dynamic type. Type parameters cannot be changed. This change is reflected in the requested result type of the new box.
A slice argument can be provided to build a reference to part of a boxed value. In this case, the shape operand must be absent or be a fir.shift that can be used to provide a non default origin for the slice.
The following example illustrates creating a fir.box for x(10:33:2) where x is described by a fir.box and has non default lower bounds, and then applying a new 2-dimension shape to this fir.box.
%0 = fir.slice %c10, %c33, %c2 : (index, index, index) -> !fir.slice<1> %1 = fir.shift %c0 : (index) -> !fir.shift<1> %2 = fir.rebox %x(%1) [%0] : (!fir.box<!fir.array<?xf32>>, !fir.shift<1>, !fir.slice<1>) -> !fir.box<!fir.array<?xf32>> %3 = fir.shape %c3, %c4 : (index, index) -> !fir.shape<2> %4 = fir.rebox %2(%3) : (!fir.box<!fir.array<?xf32>>, !fir.shape<2>) -> !fir.box<!fir.array<?x?xf32>>
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.rebox'
class-attribute
instance-attribute
¶
box = operand_def()
class-attribute
instance-attribute
¶
shape = opt_operand_def()
class-attribute
instance-attribute
¶
slice = opt_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ResultOp
dataclass
¶
Bases: IRDLOperation
Result takes a list of ssa-values produced in the block and forwards them as a result to the operation that owns the region of the block. The operation can retain the values or return them to its parent block depending upon its semantics.
Source code in xdsl/dialects/experimental/fir.py
YieldOp
dataclass
¶
Bases: IRDLOperation
fir.yield yields SSA values from a fir dialect op region and terminates the region. Used as the terminator for fir.local and fir.declare_reduction bodies.
Source code in xdsl/dialects/experimental/fir.py
SaveResultOp
dataclass
¶
Bases: IRDLOperation
Save the result of a function returning an array, box, or record type value into a memory location given the shape and LEN parameters of the result.
Function results of type fir.box, fir.array, or fir.rec are abstract values that require a storage to be manipulated on the caller side. This operation allows associating such abstract result to a storage. In later lowering of the function interfaces, this storage might be used to pass the result in memory.
For arrays, result, it is required to provide the shape of the result. For character arrays and derived types with LEN parameters, the LEN parameter values must be provided.
The fir.save_result associated to a function call must immediately follow the call and be in the same block.
%buffer = fir.alloca fir.array<?xf32>, %c100 %shape = fir.shape %c100 %array_result = fir.call @foo() : () -> fir.array<?xf32> fir.save_result %array_result to %buffer(%shape) %coor = fir.array_coor %buffer%(%shape), %c5 %fifth_element = fir.load %coor : f32
The above fir.save_result allows saving a fir.array function result into a buffer to later access its 5th element.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.save_result'
class-attribute
instance-attribute
¶
value = operand_def()
class-attribute
instance-attribute
¶
memref = operand_def()
class-attribute
instance-attribute
¶
shape = opt_operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
SelectCaseOp
dataclass
¶
Bases: IRDLOperation
Similar to 'select', select_case provides a way to express Fortran's SELECT CASE construct. In this case, the selector value is matched against variables (not just constants) and ranges. The structure is the same as 'select', but select_case allows for the expression of more complex match conditions.
fir.select_case %arg : i32 [ #fir.point, %0, ^bb1(%0 : i32), #fir.lower, %1, ^bb2(%2,%arg,%arg2,%1 : i32,i32,i32,i32), #fir.interval, %2, %3, ^bb3(%2,%arg2 : i32,i32), #fir.upper, %arg, ^bb4(%1 : i32), unit, ^bb5]
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.select_case'
class-attribute
instance-attribute
¶
selector = operand_def()
class-attribute
instance-attribute
¶
compareArgs = var_operand_def()
class-attribute
instance-attribute
¶
targetArgs = var_operand_def()
class-attribute
instance-attribute
¶
case_tags = prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
targets = var_successor_def()
class-attribute
instance-attribute
¶
traits = traits_def(IsTerminator())
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
SelectOp
dataclass
¶
Bases: IRDLOperation
A multiway branch terminator with similar semantics to C's 'switch' statement. A selector value is matched against a list of constants of the same type for a match. When a match is found, control is transferred to the corresponding basic block. A 'select' must have at least one basic block with a corresponding unit match, and that block will be selected when all other conditions fail to match.
fir.select %arg:i32 [1, ^bb1(%0 : i32), 2, ^bb2(%2,%arg,%arg2 : i32,i32,i32), -3, ^bb3(%arg2,%2 : i32,i32), 4, ^bb4(%1 : i32), unit, ^bb5]
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.select'
class-attribute
instance-attribute
¶
selector = operand_def()
class-attribute
instance-attribute
¶
compareArgs = var_operand_def()
class-attribute
instance-attribute
¶
targetArgs = var_operand_def()
class-attribute
instance-attribute
¶
case_tags = prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
targets = var_successor_def()
class-attribute
instance-attribute
¶
traits = traits_def(IsTerminator())
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
SelectRankOp
dataclass
¶
Bases: IRDLOperation
Similar to 'select', select_rank provides a way to express Fortran's SELECT RANK construct. In this case, the rank of the selector value is matched against constants of integer type. The structure is the same as 'select', but select_rank determines the rank of the selector variable at runtime to determine the best match.
fir.select_rank %arg:i32 [1, ^bb1(%0 : i32), 2, ^bb2(%2,%arg,%arg2 : i32,i32,i32), 3, ^bb3(%arg2,%2 : i32,i32), -1, ^bb4(%1 : i32), unit, ^bb5]
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.select_rank'
class-attribute
instance-attribute
¶
selector = operand_def()
class-attribute
instance-attribute
¶
compareArgs = var_operand_def()
class-attribute
instance-attribute
¶
targetArgs = var_operand_def()
class-attribute
instance-attribute
¶
case_tags = prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
targets = var_successor_def()
class-attribute
instance-attribute
¶
traits = traits_def(IsTerminator())
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
SelectTypeOp
dataclass
¶
Bases: IRDLOperation
Similar to 'select', select_type provides a way to express Fortran's SELECT TYPE construct. In this case, the type of the selector value is matched against a list of type descriptors. The structure is the same as 'select', but select_type determines the type of the selector variable at runtime to determine the best match.
fir.select_type %arg : !fir.box<()> [
#fir.type_is<!fir.type
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.select_type'
class-attribute
instance-attribute
¶
selector = operand_def()
class-attribute
instance-attribute
¶
compareArgs = var_operand_def()
class-attribute
instance-attribute
¶
targetArgs = var_operand_def()
class-attribute
instance-attribute
¶
case_tags = prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
targets = var_successor_def()
class-attribute
instance-attribute
¶
traits = traits_def(IsTerminator())
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
ShapeOp
dataclass
¶
Bases: IRDLOperation
The arguments are an ordered list of integral type values that define the runtime extent of each dimension of an array. The shape information is given in the same row-to-column order as Fortran. This abstract shape value must be applied to a reified object, so all shape information must be specified. The extent must be nonnegative.
%d = fir.shape %row_sz, %col_sz : (index, index) -> !fir.shape<2>
Source code in xdsl/dialects/experimental/fir.py
ShapeShiftOp
dataclass
¶
Bases: IRDLOperation
The arguments are an ordered list of integral type values that is a multiple of 2 in length. Each such pair is defined as: the lower bound and the extent for that dimension. The shifted shape information is given in the same row-to-column order as Fortran. This abstract shifted shape value must be applied to a reified object, so all shifted shape information must be specified. The extent must be nonnegative.
%d = fir.shape_shift %lo, %extent : (index, index) -> !fir.shapeshift<1>
Source code in xdsl/dialects/experimental/fir.py
ShiftOp
dataclass
¶
Bases: IRDLOperation
The arguments are an ordered list of integral type values that define the runtime lower bound of each dimension of an array. The shape information is given in the same row-to-column order as Fortran. This abstract shift value must be applied to a reified object, so all shift information must be specified.
%d = fir.shift %row_lb, %col_lb : (index, index) -> !fir.shift<2>
Source code in xdsl/dialects/experimental/fir.py
SliceOp
dataclass
¶
Bases: IRDLOperation
The array slicing arguments are an ordered list of integral type values that must be a multiple of 3 in length. Each such triple is defined as: the lower bound, the upper bound, and the stride for that dimension, as in Fortran syntax. Both bounds are inclusive. The array slice information is given in the same row-to-column order as Fortran. This abstract slice value must be applied to a reified object, so all slice information must be specified. The extent must be nonnegative and the stride must not be zero.
%d = fir.slice %lo, %hi, %step : (index, index, index) -> !fir.slice<1>
To support generalized slicing of Fortran's dynamic derived types, a slice op can be given a component path (narrowing from the product type of the original array to the specific elemental type of the sliced projection).
%fld = fir.field_index component, !fir.type
Projections of '!fir.char' type can be further narrowed to invariant substrings.
%d = fir.slice %lo, %hi, %step substr %offset, %width : (index, index, index, index, index) -> !fir.slice<1>
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.slice'
class-attribute
instance-attribute
¶
triples = var_operand_def()
class-attribute
instance-attribute
¶
fields = var_operand_def()
class-attribute
instance-attribute
¶
substr = var_operand_def()
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
StoreOp
dataclass
¶
Bases: IRDLOperation
Store an ssa-value (virtual register) to a memory reference. The stored value must be of the same type as the referent type of the memory reference.
%v = ... : f64
%p = ... : !fir.ptr
The above store changes the value to which the pointer is pointing and not the pointer itself. The operation is undefined if the memory reference, '%p', is undefined or null.
Source code in xdsl/dialects/experimental/fir.py
StringLitOp
dataclass
¶
Bases: IRDLOperation
An FIR constant that represents a sequence of characters that correspond to Fortran's CHARACTER type, including a LEN. We support CHARACTER values of different KINDs (different constant sizes).
%1 = fir.string_lit "Hello, World!"(13) : !fir.char<1> // ASCII
%2 = fir.string_lit [158, 2345](2) : !fir.char<2> // Wide chars
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.string_lit'
class-attribute
instance-attribute
¶
size = prop_def(IntegerAttr[IntegerType])
class-attribute
instance-attribute
¶
value = opt_prop_def(StringAttr)
class-attribute
instance-attribute
¶
xlist = opt_prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
result_0 = result_def()
class-attribute
instance-attribute
¶
SubcOp
dataclass
¶
Bases: IRDLOperation
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.subc'
class-attribute
instance-attribute
¶
lhs = operand_def()
class-attribute
instance-attribute
¶
rhs = operand_def()
class-attribute
instance-attribute
¶
fastmath = opt_prop_def(FastMathFlagsAttr)
class-attribute
instance-attribute
¶
result = result_def()
class-attribute
instance-attribute
¶
UnboxcharOp
dataclass
¶
Bases: IRDLOperation
Unboxes a value of 'boxchar' type into a pair consisting of a memory reference to the CHARACTER data and the LEN type parameter.
%45 = ... : !fir.boxchar<1> %46:2 = fir.unboxchar %45 : (!fir.boxchar<1>) -> (!fir.ref<!fir.char<1>>, i32)
Source code in xdsl/dialects/experimental/fir.py
UnboxprocOp
dataclass
¶
Bases: IRDLOperation
Unboxes a value of 'boxproc' type into a pair consisting of a procedure pointer and a pointer to a host context.
%47 = ... : !fir.boxproc<() -> i32>
%48:2 = fir.unboxproc %47 : (!fir.ref<() -> i32>, !fir.ref<tuple
Source code in xdsl/dialects/experimental/fir.py
UndefinedOp
dataclass
¶
Bases: IRDLOperation
Constructs an ssa-value of the specified type with an undefined value.
This operation is typically created internally by the mem2reg conversion
pass. An undefined value can be of any type except '!fir.ref
%a = fir.undefined !fir.array<10 x !fir.type
The example creates an array shaped ssa-value. The array is rank 1, extent
10, and each element has type '!fir.type
Source code in xdsl/dialects/experimental/fir.py
UnreachableOp
dataclass
¶
Bases: IRDLOperation
Terminates a basic block with the assertion that the end of the block will never be reached at runtime. This instruction can be used immediately after a call to the Fortran runtime to terminate the program, for example. This instruction corresponds to the LLVM IR instruction 'unreachable'.
fir.unreachable
Source code in xdsl/dialects/experimental/fir.py
ZeroBitsOp
dataclass
¶
Bases: IRDLOperation
Constructs an ssa-value of the specified type with a value of zero for all bits.
%a = fir.zero_bits !fir.box<!fir.array<10 x !fir.type
The example creates a value of type box where all bits are zero.
Source code in xdsl/dialects/experimental/fir.py
AssumedSizeExtentOp
dataclass
¶
Bases: IRDLOperation
Returns the magic extent value used for the last assumed-size dimension.
Source code in xdsl/dialects/experimental/fir.py
BoxTotalElementsOp
dataclass
¶
Bases: IRDLOperation
Returns the total number of elements described by a Fortran descriptor.
Source code in xdsl/dialects/experimental/fir.py
BoxTypeCodeOp
dataclass
¶
Bases: IRDLOperation
Returns the CFI type code stored in a descriptor.
Source code in xdsl/dialects/experimental/fir.py
CopyOp
dataclass
¶
Bases: IRDLOperation
Copy a Fortran entity from source to destination, with optional no-overlap promise.
Source code in xdsl/dialects/experimental/fir.py
DeclareReductionOp
dataclass
¶
Bases: IRDLOperation
User-defined reduction declaration used by fir.do_concurrent.loop.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.declare_reduction'
class-attribute
instance-attribute
¶
sym_name = prop_def(SymbolNameConstraint())
class-attribute
instance-attribute
¶
type = prop_def()
class-attribute
instance-attribute
¶
byref_element_type = opt_prop_def()
class-attribute
instance-attribute
¶
allocRegion = opt_region_def()
class-attribute
instance-attribute
¶
initializerRegion = region_def()
class-attribute
instance-attribute
¶
reductionRegion = region_def()
class-attribute
instance-attribute
¶
atomicReductionRegion = region_def()
class-attribute
instance-attribute
¶
cleanupRegion = region_def()
class-attribute
instance-attribute
¶
dataPtrPtrRegion = region_def()
class-attribute
instance-attribute
¶
traits = traits_def(SymbolOpInterface(), IsolatedFromAbove())
class-attribute
instance-attribute
¶
DoConcurrentOp
dataclass
¶
Bases: IRDLOperation
Wrapper region for a Fortran DO CONCURRENT loop nest.
Source code in xdsl/dialects/experimental/fir.py
DoConcurrentLoopOp
dataclass
¶
Bases: IRDLOperation
Inner loop nest of a fir.do_concurrent.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.do_concurrent.loop'
class-attribute
instance-attribute
¶
lowerBound = var_operand_def()
class-attribute
instance-attribute
¶
upperBound = var_operand_def()
class-attribute
instance-attribute
¶
step = var_operand_def()
class-attribute
instance-attribute
¶
local_vars = var_operand_def()
class-attribute
instance-attribute
¶
reduce_vars = var_operand_def()
class-attribute
instance-attribute
¶
loopAnnotation = opt_prop_def(Attribute)
class-attribute
instance-attribute
¶
local_syms = opt_prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
reduce_byref = opt_prop_def(Attribute)
class-attribute
instance-attribute
¶
reduce_syms = opt_prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
reduce_attrs = opt_prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
region = region_def('single_block')
class-attribute
instance-attribute
¶
irdl_options = (AttrSizedOperandSegments(as_property=True),)
class-attribute
instance-attribute
¶
DTComponentOp
dataclass
¶
Bases: IRDLOperation
A component descriptor entry inside a fir.type_info.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.dt_component'
class-attribute
instance-attribute
¶
name_attr = prop_def(StringAttr, prop_name='name')
class-attribute
instance-attribute
¶
lower_bounds = opt_prop_def(Attribute)
class-attribute
instance-attribute
¶
init_val = opt_prop_def(SymbolRefAttr)
class-attribute
instance-attribute
¶
IsAssumedSizeOp
dataclass
¶
Bases: IRDLOperation
True iff the box describes a Fortran assumed-size array.
Source code in xdsl/dialects/experimental/fir.py
IsAssumedSizeExtentOp
dataclass
¶
Bases: IRDLOperation
True iff the integer is the magic assumed-size extent value.
Source code in xdsl/dialects/experimental/fir.py
IsContiguousBoxOp
dataclass
¶
Bases: IRDLOperation
Runtime predicate: is the box contiguous (optionally only innermost)?
Source code in xdsl/dialects/experimental/fir.py
LocalitySpecifierOp
dataclass
¶
Bases: IRDLOperation
LOCAL/LOCAL_INIT specifier for fir.do_concurrent.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.local'
class-attribute
instance-attribute
¶
sym_name = prop_def(SymbolNameConstraint())
class-attribute
instance-attribute
¶
type = prop_def()
class-attribute
instance-attribute
¶
locality_specifier_type = prop_def(LocalitySpecifierTypeAttr)
class-attribute
instance-attribute
¶
init_region = region_def()
class-attribute
instance-attribute
¶
copy_region = region_def()
class-attribute
instance-attribute
¶
dealloc_region = region_def()
class-attribute
instance-attribute
¶
traits = traits_def(SymbolOpInterface(), IsolatedFromAbove())
class-attribute
instance-attribute
¶
PackArrayOp
dataclass
¶
Bases: IRDLOperation
Repack an array into a contiguous temporary.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.pack_array'
class-attribute
instance-attribute
¶
array = operand_def()
class-attribute
instance-attribute
¶
typeparams = var_operand_def()
class-attribute
instance-attribute
¶
stack = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
innermost = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
no_copy = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
max_size = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
max_element_size = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
min_stride = opt_prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
heuristics = opt_prop_def(PackArrayHeuristicsAttr)
class-attribute
instance-attribute
¶
is_safe = opt_prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
result = result_def()
class-attribute
instance-attribute
¶
UnpackArrayOp
dataclass
¶
Bases: IRDLOperation
Inverse of fir.pack_array.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.unpack_array'
class-attribute
instance-attribute
¶
temp = operand_def()
class-attribute
instance-attribute
¶
original = operand_def()
class-attribute
instance-attribute
¶
stack = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
no_copy = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
is_safe = opt_prop_def(ArrayAttr)
class-attribute
instance-attribute
¶
PrefetchOp
dataclass
¶
Bases: IRDLOperation
Cache prefetch hint for a memory reference.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.prefetch'
class-attribute
instance-attribute
¶
memref = operand_def()
class-attribute
instance-attribute
¶
rw = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
localityHint = prop_def(IntegerAttr)
class-attribute
instance-attribute
¶
cacheType = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
ReboxAssumedRankOp
dataclass
¶
Bases: IRDLOperation
Rebox an assumed-rank descriptor with a different lower-bound modifier.
Source code in xdsl/dialects/experimental/fir.py
TypeDescOp
dataclass
¶
Bases: IRDLOperation
Get the SSA value of a derived type's runtime type descriptor.
Source code in xdsl/dialects/experimental/fir.py
TypeInfoOp
dataclass
¶
Bases: IRDLOperation
Container for a derived type's dispatch table and component info.
Source code in xdsl/dialects/experimental/fir.py
name = 'fir.type_info'
class-attribute
instance-attribute
¶
sym_name = prop_def(SymbolNameConstraint())
class-attribute
instance-attribute
¶
type = prop_def()
class-attribute
instance-attribute
¶
parent_type = opt_prop_def()
class-attribute
instance-attribute
¶
abstract = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
no_init = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
no_destroy = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
no_final = opt_prop_def(UnitAttr)
class-attribute
instance-attribute
¶
dispatch_table = region_def()
class-attribute
instance-attribute
¶
component_info = region_def()
class-attribute
instance-attribute
¶
traits = traits_def(SymbolOpInterface(), IsolatedFromAbove())
class-attribute
instance-attribute
¶
UseStmtOp
dataclass
¶
Bases: IRDLOperation
Marker for Fortran USE-association (debug-info only).
Source code in xdsl/dialects/experimental/fir.py
VolatileCastOp
dataclass
¶
Bases: IRDLOperation
Cast that adds or drops the descriptor 'volatile' flag.