28using namespace nanobind::literals;
37 R
"(Gets a DenseElementsAttr from a Python buffer or array.
39When `type` is not provided, then some limited type inferencing is done based
40on the buffer format. Support presently exists for 8/16/32/64 signed and
41unsigned integers and float16/float32/float64. DenseElementsAttrs of these
42types can also be converted back to a corresponding buffer.
44For conversions outside of these types, a `type=` must be explicitly provided
45and the buffer contents must be bit-castable to the MLIR internal
48 * Integer types: the buffer must be byte aligned to the next byte boundary.
49 * Floating point types: Must be bit-castable to the given floating point
51 * i1 (bool): Each boolean value is stored as a single byte (0 or 1).
53If a single element buffer is passed, then a splat will be created.
56 array: The array or buffer to convert.
57 signless: If inferring an appropriate MLIR type, use signless types for
58 integers (defaults True).
59 type: Skips inference of the MLIR element type and uses this instead. The
60 storage size must be consistent with the actual contents of the buffer.
61 shape: Overrides the shape of the buffer when constructing the MLIR
62 shaped type. This is needed when the physical and logical shape differ.
63 context: Explicit context, if not from context manager.
66 DenseElementsAttr on success.
69 ValueError: If the type of the buffer or array cannot be matched to an MLIR
70 type or if the buffer does not meet expectations.
74 R
"(Gets a DenseElementsAttr from a Python list of attributes.
76Note that it can be expensive to construct attributes individually.
77For a large number of elements, consider using a Python buffer or array instead.
80 attrs: A list of attributes.
81 type: The desired shape and type of the resulting DenseElementsAttr.
82 If not provided, the element type is determined based on the type
83 of the 0th attribute and the shape is `[len(attrs)]`.
84 context: Explicit context, if not from context manager.
87 DenseElementsAttr on success.
90 ValueError: If the type of the attributes does not match the type
91 specified by `shaped_type`.
95 R
"(Gets a DenseResourceElementsAttr from a Python buffer or array.
97This function does minimal validation or massaging of the data, and it is
98up to the caller to ensure that the buffer meets the characteristics
101The backing buffer and any user objects will be retained for the lifetime
102of the resource blob. This is typically bounded to the context but the
103resource can have a shorter lifespan depending on how it is used in
104subsequent processing.
107 buffer: The array or buffer to convert.
108 name: Name to provide to the resource (may be changed upon collision).
109 type: The explicit ShapedType to construct the attribute with.
110 context: Explicit context, if not from context manager.
113 DenseResourceElementsAttr on success.
116 ValueError: If the type of the buffer or array cannot be matched to an MLIR
117 type or if the buffer does not meet expectations.
122template <
typename Callable>
123class [[nodiscard]] scope_exit {
124 Callable ExitFunction;
128 template <
typename Fp>
129 explicit scope_exit(Fp &&F) : ExitFunction(std::forward<Fp>(F)) {}
131 scope_exit(scope_exit &&Rhs)
132 : ExitFunction(std::move(Rhs.ExitFunction)), Engaged(Rhs.Engaged) {
135 scope_exit(
const scope_exit &) =
delete;
136 scope_exit &operator=(scope_exit &&) =
delete;
137 scope_exit &operator=(
const scope_exit &) =
delete;
139 void release() { Engaged =
false; }
147template <
typename Callable>
148scope_exit(Callable) -> scope_exit<Callable>;
157 std::vector<Py_ssize_t> shape_in, std::vector<Py_ssize_t> strides_in,
159 std::unique_ptr<Py_buffer,
void (*)(Py_buffer *)> owned_view_in)
161 shape(std::move(shape_in)),
strides(std::move(strides_in)),
164 for (Py_ssize_t i = 0; i <
ndim; ++i) {
170 int flags = PyBUF_STRIDES | PyBUF_FORMAT;
171 auto *view =
new Py_buffer();
172 if (PyObject_GetBuffer(
ptr(), view, flags) != 0) {
174 throw nb::python_error();
181 static const char *
format() {
return "?"; }
185 static const char *
format() {
return "b"; }
189 static const char *
format() {
return "B"; }
193 static const char *
format() {
return "h"; }
197 static const char *
format() {
return "H"; }
201 static const char *
format() {
return "i"; }
205 static const char *
format() {
return "I"; }
209 static const char *
format() {
return "q"; }
213 static const char *
format() {
return "Q"; }
217 static const char *
format() {
return "f"; }
221 static const char *
format() {
return "d"; }
231 nb::arg(
"affine_map"),
"Gets an attribute wrapping an AffineMap.");
237 "Returns the value of the AffineMap attribute");
247 nb::arg(
"integer_set"),
"Gets an attribute wrapping an IntegerSet.");
250nb::typed<nb::object, PyAttribute>
253 if (PyArrayAttribute::PyArrayAttributeIterator::nextIndex >=
255 PyArrayAttribute::PyArrayAttributeIterator::attr.
get())) {
256 PyErr_SetNone(PyExc_StopIteration);
261 this->PyArrayAttribute::PyArrayAttributeIterator::attr
264 PyArrayAttribute::PyArrayAttributeIterator::attr.
get(),
265 PyArrayAttribute::PyArrayAttributeIterator::nextIndex++))
270 nb::class_<PyArrayAttributeIterator>(m,
"ArrayAttributeIterator")
283 std::vector<MlirAttribute> mlirAttributes;
284 mlirAttributes.reserve(nb::len(attributes));
285 for (
auto attribute : attributes) {
289 context->
get(), mlirAttributes.size(), mlirAttributes.data());
292 nb::arg(
"attributes"), nb::arg(
"context") = nb::none(),
293 "Gets a uniqued Array attribute");
296 intptr_t i) -> nb::typed<nb::object, PyAttribute> {
298 throw nb::index_error(
"ArrayAttribute index out of range");
309 std::vector<MlirAttribute> attributes;
311 attributes.reserve(numOldElements + nb::len(extras));
312 for (
intptr_t i = 0; i < numOldElements; ++i)
313 attributes.push_back(arr.
getItem(i));
314 for (nb::handle attr : extras)
317 arr.
getContext()->
get(), attributes.size(), attributes.data());
327 if (mlirAttributeIsNull(attr))
331 nb::arg(
"type"), nb::arg(
"value"), nb::arg(
"loc") = nb::none(),
332 "Gets an uniqued float point attribute associated to a type");
339 if (mlirAttributeIsNull(attr))
343 nb::arg(
"type"), nb::arg(
"value"), nb::arg(
"context") = nb::none(),
344 "Gets an uniqued float point attribute associated to a type");
352 nb::arg(
"value"), nb::arg(
"context") = nb::none(),
353 "Gets an uniqued float point attribute associated to a f32 type");
361 nb::arg(
"value"), nb::arg(
"context") = nb::none(),
362 "Gets an uniqued float point attribute associated to a f64 type");
364 "Returns the value of the float attribute");
366 "Converts the value of the float attribute to a Python float");
372 [](
PyType &type, nb::object value) {
375 int64_t intValue = nb::cast<int64_t>(value);
384 if (bitWidth <= 64) {
385 int64_t intValue = nb::cast<int64_t>(value);
391 unsigned numWords = std::ceil(
static_cast<double>(bitWidth) / 64);
392 std::vector<uint64_t> words(numWords, 0);
395 nb::object mask = nb::int_(0xFFFFFFFFFFFFFFFFULL);
396 nb::object shift = nb::int_(64);
397 nb::object current = value;
402 nb::object zero = nb::int_(0);
403 if (nb::cast<bool>(current < zero)) {
404 nb::object twoToTheBitWidth = nb::int_(1) << nb::int_(bitWidth);
405 current = current + twoToTheBitWidth;
409 for (
unsigned i = 0; i < numWords; ++i) {
410 words[i] = nb::cast<uint64_t>(current & mask);
411 current = current >> shift;
418 nb::arg(
"type"), nb::arg(
"value"),
419 "Gets an uniqued integer attribute associated to a type");
420 c.def_prop_ro(
"value", toPyInt,
"Returns the value of the integer attribute");
421 c.def(
"__int__", toPyInt,
422 "Converts the value of the integer attribute to a Python int");
423 c.def_prop_ro_static(
428 nb::sig(
"def static_typeid(/) -> TypeID"));
436 if (bitWidth <= 64) {
446 std::vector<uint64_t> words(numWords);
451 nb::object
result = nb::int_(0);
452 nb::object shift = nb::int_(64);
453 for (
unsigned i = numWords; i > 0; --i) {
461 bool signBitSet = (words[numWords - 1] >> ((bitWidth - 1) % 64)) & 1;
463 nb::object twoToTheBitWidth = nb::int_(1) << nb::int_(bitWidth);
478 nb::arg(
"value"), nb::arg(
"context") = nb::none(),
479 "Gets an uniqued bool attribute");
481 "Returns the value of the bool attribute");
483 "Converts the value of the bool attribute to a Python bool");
490 throw std::runtime_error(
"SymbolRefAttr must be composed of at least "
493 std::vector<MlirAttribute> referenceAttrs;
494 for (
size_t i = 1; i < symbols.size(); ++i) {
495 referenceAttrs.push_back(
500 referenceAttrs.size(),
501 referenceAttrs.
data()));
507 [](
const std::vector<std::string> &symbols,
511 nb::arg(
"symbols"), nb::arg(
"context") = nb::none(),
512 "Gets a uniqued SymbolRef attribute from a list of symbol names");
517 std::vector<std::string> symbols = {
523 symbols.push_back(std::string(nestedRef.
data, nestedRef.
length));
527 "Returns the value of the SymbolRef attribute as a list[str]");
538 nb::arg(
"value"), nb::arg(
"context") = nb::none(),
539 "Gets a uniqued FlatSymbolRef attribute");
544 return nb::str(stringRef.
data, stringRef.
length);
546 "Returns the value of the FlatSymbolRef attribute as a string");
552 [](
const std::string &dialectNamespace,
const nb_buffer &buffer,
558 static_cast<char *
>(bufferInfo.
ptr), type);
561 nb::arg(
"dialect_namespace"), nb::arg(
"buffer"), nb::arg(
"type"),
562 nb::arg(
"context") = nb::none(),
564 nb::sig(
"def get(dialect_namespace: str, buffer: typing_extensions.Buffer, type: Type, context: Context | None = None) -> OpaqueAttr"),
566 "Gets an Opaque attribute.");
571 return nb::str(stringRef.
data, stringRef.
length);
573 "Returns the dialect namespace for the Opaque attribute as a string");
578 return nb::bytes(stringRef.
data, stringRef.
length);
580 "Returns the data for the Opaqued attributes as `bytes`");
585 std::optional<PyType> explicitType,
587 const size_t numAttributes = nb::len(attributes);
588 if (numAttributes == 0)
589 throw nb::value_error(
"Attributes list must be non-empty.");
597 "Expected a static ShapedType for the shaped_type parameter: ",
598 nb::cast<std::string>(nb::repr(nb::cast(*explicitType))));
599 throw nb::value_error(message.c_str());
601 shapedType = *explicitType;
603 std::vector<int64_t>
shape = {
static_cast<int64_t>(numAttributes)};
610 std::vector<MlirAttribute> mlirAttributes;
611 mlirAttributes.reserve(numAttributes);
612 for (
const nb::handle &attribute : attributes) {
615 mlirAttributes.push_back(mlirAttribute);
619 "All attributes must be of the same type and match the type "
620 "parameter: expected=",
621 nb::cast<std::string>(nb::repr(nb::cast(shapedType))),
622 ", but got=", nb::cast<std::string>(nb::repr(nb::cast(attrType))));
623 throw nb::value_error(message.c_str());
628 shapedType, mlirAttributes.size(), mlirAttributes.data());
635 const std::optional<PyType> &explicitType,
636 std::optional<std::vector<int64_t>> explicitShape,
639 int flags = PyBUF_ND;
641 flags |= PyBUF_FORMAT;
644 if (PyObject_GetBuffer(array.ptr(), &view, flags) != 0) {
645 throw nb::python_error();
647 scope_exit freeBuffer([&]() { PyBuffer_Release(&view); });
649 MlirContext context = contextWrapper->
get();
650 MlirAttribute attr = getAttributeFromBuffer(
651 view, signless, explicitType, std::move(explicitShape), context);
652 if (mlirAttributeIsNull(attr)) {
653 throw std::invalid_argument(
654 "DenseElementsAttr could not be constructed from the given buffer. "
655 "This may mean that the Python buffer layout does not match that "
656 "MLIR expected layout and is a bug.");
664 auto contextWrapper =
668 std::string message =
"Illegal element type for DenseElementsAttr: ";
669 message.append(nb::cast<std::string>(nb::repr(nb::cast(elementAttr))));
670 throw nb::value_error(message.c_str());
674 std::string message =
675 "Expected a static ShapedType for the shaped_type parameter: ";
676 message.append(nb::cast<std::string>(nb::repr(nb::cast(shapedType))));
677 throw nb::value_error(message.c_str());
682 std::string message =
683 "Shaped element type and attribute type must be equal: shaped=";
684 message.append(nb::cast<std::string>(nb::repr(nb::cast(shapedType))));
685 message.append(
", element=");
686 message.append(nb::cast<std::string>(nb::repr(nb::cast(elementAttr))));
687 throw nb::value_error(message.c_str());
690 MlirAttribute elements =
706 return bufferInfo<float>(shapedType);
710 return bufferInfo<double>(shapedType);
714 return bufferInfo<uint16_t>(shapedType,
"e");
718 return bufferInfo<int64_t>(shapedType);
725 return bufferInfo<int32_t>(shapedType);
729 return bufferInfo<uint32_t>(shapedType);
736 return bufferInfo<int64_t>(shapedType);
740 return bufferInfo<uint64_t>(shapedType);
747 return bufferInfo<int8_t>(shapedType);
751 return bufferInfo<uint8_t>(shapedType);
758 return bufferInfo<int16_t>(shapedType);
762 return bufferInfo<uint16_t>(shapedType);
767 return bufferInfo<bool>(shapedType);
772 throw std::invalid_argument(
773 "unsupported data type for conversion to Python buffer");
777#if PY_VERSION_HEX < 0x03090000
778 PyTypeObject *tp =
reinterpret_cast<PyTypeObject *
>(c.ptr());
779 tp->tp_as_buffer->bf_getbuffer = PyDenseElementsAttribute::bf_getbuffer;
780 tp->tp_as_buffer->bf_releasebuffer =
781 PyDenseElementsAttribute::bf_releasebuffer;
786 nb::arg(
"signless") =
true, nb::arg(
"type") = nb::none(),
787 nb::arg(
"shape") = nb::none(), nb::arg(
"context") = nb::none(),
789 nb::sig(
"def get(array: typing_extensions.Buffer, signless: bool = True, type: Type | None = None, shape: Sequence[int] | None = None, context: Context | None = None) -> DenseElementsAttr"),
793 nb::arg(
"attrs"), nb::arg(
"type") = nb::none(),
794 nb::arg(
"context") = nb::none(),
797 nb::arg(
"shaped_type"), nb::arg(
"element_attr"),
798 "Gets a DenseElementsAttr where all values are the same")
799 .def_prop_ro(
"is_splat",
803 .def(
"get_splat_value",
805 -> nb::typed<nb::object, PyAttribute> {
807 throw nb::value_error(
808 "get_splat_value called on a non-splat attribute");
815bool PyDenseElementsAttribute::isUnsignedIntegerFormat(
816 std::string_view format) {
819 char code = format[0];
820 return code ==
'I' || code ==
'B' || code ==
'H' || code ==
'L' ||
824bool PyDenseElementsAttribute::isSignedIntegerFormat(std::string_view format) {
827 char code = format[0];
828 return code ==
'i' || code ==
'b' || code ==
'h' || code ==
'l' ||
832MlirType PyDenseElementsAttribute::getShapedType(
833 std::optional<MlirType> bulkLoadElementType,
834 std::optional<std::vector<int64_t>> explicitShape, Py_buffer &view) {
835 std::vector<int64_t>
shape;
837 shape.insert(
shape.end(), explicitShape->begin(), explicitShape->end());
839 shape.insert(
shape.end(), view.shape, view.shape + view.ndim);
844 throw std::invalid_argument(
"Shape can only be specified explicitly "
845 "when the type is not a shaped type.");
847 return *bulkLoadElementType;
851 *bulkLoadElementType, encodingAttr);
854MlirAttribute PyDenseElementsAttribute::getAttributeFromBuffer(
855 Py_buffer &view,
bool signless, std::optional<PyType> explicitType,
856 const std::optional<std::vector<int64_t>> &explicitShape,
857 MlirContext &context) {
862 std::optional<MlirType> bulkLoadElementType;
864 bulkLoadElementType = *explicitType;
866 std::string_view format(view.format);
869 assert(view.itemsize == 4 &&
"mismatched array itemsize");
871 }
else if (format ==
"d") {
873 assert(view.itemsize == 8 &&
"mismatched array itemsize");
875 }
else if (format ==
"e") {
877 assert(view.itemsize == 2 &&
"mismatched array itemsize");
879 }
else if (format ==
"?") {
882 }
else if (isSignedIntegerFormat(format)) {
883 if (view.itemsize == 4) {
887 }
else if (view.itemsize == 8) {
891 }
else if (view.itemsize == 1) {
895 }
else if (view.itemsize == 2) {
900 }
else if (isUnsignedIntegerFormat(format)) {
901 if (view.itemsize == 4) {
903 bulkLoadElementType = signless
906 }
else if (view.itemsize == 8) {
908 bulkLoadElementType = signless
911 }
else if (view.itemsize == 1) {
915 }
else if (view.itemsize == 2) {
917 bulkLoadElementType = signless
922 if (!bulkLoadElementType) {
923 throw std::invalid_argument(
924 std::string(
"unimplemented array format conversion from format: ") +
925 std::string(format));
929 MlirType type = getShapedType(bulkLoadElementType, explicitShape, view);
935#if PY_VERSION_HEX >= 0x03090000
937 reinterpret_cast<void *
>(PyDenseElementsAttribute::bf_getbuffer)},
938 {Py_bf_releasebuffer,
939 reinterpret_cast<void *
>(PyDenseElementsAttribute::bf_releasebuffer)},
944 int PyDenseElementsAttribute::bf_getbuffer(PyObject *obj,
948 std::unique_ptr<nb_buffer_info> info;
950 auto *attr = nb::cast<PyDenseElementsAttribute *>(nb::handle(obj));
951 info = attr->accessBuffer();
952 }
catch (nb::python_error &e) {
954 nb::chain_error(PyExc_BufferError,
"Error converting attribute to buffer");
956 }
catch (std::exception &e) {
957 nb::chain_error(PyExc_BufferError,
958 "Error converting attribute to buffer: %s", e.what());
963 view->buf = info->ptr;
964 view->itemsize = info->itemsize;
965 view->len = info->itemsize;
966 for (
auto s : info->shape) {
969 view->readonly = info->readonly;
970 if ((flags & PyBUF_FORMAT) == PyBUF_FORMAT) {
971 view->format =
const_cast<char *
>(info->format);
973 if ((flags & PyBUF_STRIDES) == PyBUF_STRIDES) {
974 view->ndim =
static_cast<int>(info->ndim);
975 view->strides = info->strides.data();
976 view->shape = info->shape.data();
978 view->suboffsets =
nullptr;
979 view->internal = info.release();
984 void PyDenseElementsAttribute::bf_releasebuffer(PyObject *,
986 delete reinterpret_cast<nb_buffer_info *
>(view->internal);
991 throw nb::index_error(
"attempt to access out of bounds element");
1000 "dense int elements attribute");
1044 throw nb::type_error(
"Unsupported integer type");
1052#if PY_VERSION_HEX < 0x030d0000
1053#define Py_IsFinalizing _Py_IsFinalizing
1059 std::optional<size_t> alignment,
bool isMutable,
1062 throw std::invalid_argument(
1063 "Constructing a DenseResourceElementsAttr requires a ShapedType.");
1068 int flags = PyBUF_STRIDES;
1069 std::unique_ptr<Py_buffer> view = std::make_unique<Py_buffer>();
1070 if (PyObject_GetBuffer(buffer.ptr(), view.get(), flags) != 0) {
1071 throw nb::python_error();
1076 scope_exit freeBuffer([&]() {
1078 PyBuffer_Release(view.get());
1081 if (!PyBuffer_IsContiguous(view.get(),
'A')) {
1082 throw std::invalid_argument(
"Contiguous buffer is required.");
1086 size_t inferredAlignment;
1088 inferredAlignment = *alignment;
1090 inferredAlignment = view->strides[view->ndim - 1];
1093 auto deleter = [](
void *userData,
const void *data,
size_t size,
1097 assert(Py_IsInitialized() &&
"expected interpreter to be initialized");
1098 Py_buffer *ownedView =
static_cast<Py_buffer *
>(userData);
1099 nb::gil_scoped_acquire gil;
1100 PyBuffer_Release(ownedView);
1104 size_t rawBufferSize = view->len;
1107 isMutable, deleter,
static_cast<void *
>(view.get()));
1108 if (mlirAttributeIsNull(attr)) {
1109 throw std::invalid_argument(
1110 "DenseResourceElementsAttr could not be constructed from the given "
1112 "This may mean that the Python buffer layout does not match that "
1113 "MLIR expected layout and is a bug.");
1122 nb::arg(
"array"), nb::arg(
"name"), nb::arg(
"type"),
1123 nb::arg(
"alignment") = nb::none(), nb::arg(
"is_mutable") =
false,
1124 nb::arg(
"context") = nb::none(),
1126 nb::sig(
"def get_from_buffer(array: typing_extensions.Buffer, name: str, type: Type, alignment: int | None = None, is_mutable: bool = False, context: Context | None = None) -> DenseResourceElementsAttr"),
1136 return !mlirAttributeIsNull(
1146 std::vector<MlirNamedAttribute> mlirNamedAttributes;
1147 mlirNamedAttributes.reserve(attributes.size());
1148 for (std::pair<nb::handle, nb::handle> it : attributes) {
1149 auto &mlirAttr = nb::cast<PyAttribute &>(it.second);
1150 auto name = nb::cast<std::string>(it.first);
1156 MlirAttribute attr =
1158 mlirNamedAttributes.data());
1161 nb::arg(
"value") = nb::dict(), nb::arg(
"context") = nb::none(),
1162 "Gets an uniqued dict attribute");
1163 c.def(
"__getitem__",
1165 const std::string &
name) -> nb::typed<nb::object, PyAttribute> {
1166 MlirAttribute attr =
1168 if (mlirAttributeIsNull(attr))
1169 throw nb::key_error(
"attempt to access a non-existent attribute");
1173 if (index < 0 || index >= self.
dunderLen()) {
1174 throw nb::index_error(
"attempt to access out of bounds attribute");
1185 throw nb::index_error(
"attempt to access out of bounds element");
1201 throw nb::type_error(
"Unsupported floating-point type");
1215 nb::arg(
"value"), nb::arg(
"context") = nb::none(),
1216 "Gets a uniqued Type attribute");
1231 nb::arg(
"context") = nb::none(),
"Create a Unit attribute.");
1237 [](
int64_t offset,
const std::vector<int64_t> &strides,
1240 ctx->
get(), offset, strides.size(), strides.data());
1243 nb::arg(
"offset"), nb::arg(
"strides"), nb::arg(
"context") = nb::none(),
1244 "Gets a strided layout attribute.");
1246 "get_fully_dynamic",
1249 std::vector<int64_t> strides(rank);
1250 std::fill(strides.begin(), strides.end(), dynamic);
1252 ctx->
get(), dynamic, strides.size(), strides.data());
1255 nb::arg(
"rank"), nb::arg(
"context") = nb::none(),
1256 "Gets a strided layout attribute with dynamic offset and strides of "
1264 "Returns the value of the float point attribute");
1269 std::vector<int64_t> strides(size);
1270 for (
intptr_t i = 0; i < size; i++) {
1275 "Returns the value of the float point attribute");
1294 std::string(
"Can't cast unknown element type DenseArrayAttr (") +
1295 nb::cast<std::string>(nb::repr(nb::cast(pyAttribute))) +
")";
1296 throw nb::type_error(msg.c_str());
1306 "Can't cast unknown element type DenseIntOrFPElementsAttr (") +
1307 nb::cast<std::string>(nb::repr(nb::cast(pyAttribute))) +
")";
1308 throw nb::type_error(msg.c_str());
1316 std::string msg = std::string(
"Can't cast unknown attribute type Attr (") +
1317 nb::cast<std::string>(nb::repr(nb::cast(pyAttribute))) +
1319 throw nb::type_error(msg.c_str());
1327 std::string msg = std::string(
"Can't cast unknown SymbolRef attribute (") +
1328 nb::cast<std::string>(nb::repr(nb::cast(pyAttribute))) +
1330 throw nb::type_error(msg.c_str());
1337 MlirAttribute attr =
1341 nb::arg(
"value"), nb::arg(
"context") = nb::none(),
1342 "Gets a uniqued string attribute");
1346 MlirAttribute attr =
1350 nb::arg(
"value"), nb::arg(
"context") = nb::none(),
1351 "Gets a uniqued string attribute");
1354 [](
PyType &type,
const std::string &value) {
1355 MlirAttribute attr =
1359 nb::arg(
"type"), nb::arg(
"value"),
1360 "Gets a uniqued string attribute associated to a type");
1365 return nb::str(stringRef.
data, stringRef.
length);
1367 "Returns the value of the string attribute");
1372 return nb::bytes(stringRef.
data, stringRef.
length);
1374 "Returns the value of the string attribute as `bytes`");
1380 PyDenseBoolArrayAttribute::PyDenseArrayIterator::bind(m);
1382 PyDenseI8ArrayAttribute::PyDenseArrayIterator::bind(m);
1384 PyDenseI16ArrayAttribute::PyDenseArrayIterator::bind(m);
1386 PyDenseI32ArrayAttribute::PyDenseArrayIterator::bind(m);
1388 PyDenseI64ArrayAttribute::PyDenseArrayIterator::bind(m);
1390 PyDenseF32ArrayAttribute::PyDenseArrayIterator::bind(m);
1392 PyDenseF64ArrayAttribute::PyDenseArrayIterator::bind(m);
1405 nb::cast<nb::callable>(
1413 nb::cast<nb::callable>(
static const char kDenseElementsAttrGetDocstring[]
static const char kDenseResourceElementsAttrGetFromBufferDocstring[]
static const char kDenseElementsAttrGetFromListDocstring[]
MlirContext mlirAttributeGetContext(MlirAttribute attribute)
MlirType mlirAttributeGetType(MlirAttribute attribute)
ReferrentTy * get() const
PyMlirContextRef & getContext()
Accesses the context reference.
Used in function arguments when None should resolve to the current context manager set instance.
Used in function arguments when None should resolve to the current context manager set instance.
static PyMlirContext & resolve()
static void bindDerived(ClassTy &c)
MlirAffineMap get() const
nanobind::typed< nanobind::object, PyAttribute > dunderNext()
PyArrayAttributeIterator & dunderIter()
static void bind(nanobind::module_ &m)
MlirAttribute getItem(intptr_t i) const
static void bindDerived(ClassTy &c)
Wrapper around the generic MlirAttribute.
PyAttribute(PyMlirContextRef contextRef, MlirAttribute attr)
MlirAttribute get() const
Bool Attribute subclass - BoolAttr.
static constexpr IsAFunctionTy isaFunction
static void bindDerived(ClassTy &c)
static void bind(nanobind::module_ &m, PyType_Slot *slots=nullptr)
nanobind::class_< PyAffineMapAttribute, PyAttribute > ClassTy
static PyDenseElementsAttribute getSplat(const PyType &shapedType, PyAttribute &elementAttr)
std::unique_ptr< nb_buffer_info > accessBuffer()
intptr_t dunderLen() const
static PyType_Slot slots[]
static void bindDerived(ClassTy &c)
static PyDenseElementsAttribute getFromList(const nanobind::list &attributes, std::optional< PyType > explicitType, DefaultingPyMlirContext contextWrapper)
static PyDenseElementsAttribute getFromBuffer(const nb_buffer &array, bool signless, const std::optional< PyType > &explicitType, std::optional< std::vector< int64_t > > explicitShape, DefaultingPyMlirContext contextWrapper)
Refinement of PyDenseElementsAttribute for attributes containing floating-point values.
static constexpr IsAFunctionTy isaFunction
static void bindDerived(ClassTy &c)
nanobind::float_ dunderGetItem(intptr_t pos) const
Refinement of the PyDenseElementsAttribute for attributes containing integer (and boolean) values.
static void bindDerived(ClassTy &c)
nanobind::int_ dunderGetItem(intptr_t pos) const
Returns the element at the given linear position.
static constexpr IsAFunctionTy isaFunction
static PyDenseResourceElementsAttribute getFromBuffer(const nb_buffer &buffer, const std::string &name, const PyType &type, std::optional< size_t > alignment, bool isMutable, DefaultingPyMlirContext contextWrapper)
static void bindDerived(ClassTy &c)
static const MlirStringRef name
static void bindDerived(ClassTy &c)
intptr_t dunderLen() const
bool dunderContains(const std::string &name) const
static const MlirStringRef name
static constexpr IsAFunctionTy isaFunction
static void bindDerived(ClassTy &c)
Float Point Attribute subclass - FloatAttr.
static void bindDerived(ClassTy &c)
static PyGlobals & get()
Most code should get the globals via this static accessor.
void registerTypeCaster(MlirTypeID mlirTypeID, nanobind::callable typeCaster, bool replace=false)
Adds a user-friendly type caster.
Integer Attribute subclass - IntegerAttr.
static constexpr IsAFunctionTy isaFunction
static void bindDerived(ClassTy &c)
static void bindDerived(ClassTy &c)
MlirIntegerSet get() const
static PyMlirContextRef forContext(MlirContext context)
Returns a context reference for the singleton PyMlirContext wrapper for the given context.
MlirContext get()
Accesses the underlying MlirContext.
PyMlirContextRef getRef()
Gets a strong reference to this context, which will ensure it is kept alive for the life of the refer...
Represents a Python MlirNamedAttr, carrying an optional owned name.
static void bindDerived(ClassTy &c)
Strided layout attribute subclass.
static void bindDerived(ClassTy &c)
static void bindDerived(ClassTy &c)
static void bindDerived(ClassTy &c)
static PySymbolRefAttribute fromList(const std::vector< std::string > &symbols, PyMlirContext &context)
static constexpr IsAFunctionTy isaFunction
static void bindDerived(ClassTy &c)
A TypeID provides an efficient and unique identifier for a specific C++ type.
Wrapper around the generic MlirType.
nanobind::typed< nanobind::object, PyType > maybeDownCast()
Unit Attribute subclass. Unit attributes don't have values.
static void bindDerived(ClassTy &c)
MLIR_CAPI_EXPORTED MlirAttribute mlirAffineMapAttrGet(MlirAffineMap map)
Creates an affine map attribute wrapping the given map.
MLIR_CAPI_EXPORTED MlirAttribute mlirOpaqueAttrGet(MlirContext ctx, MlirStringRef dialectNamespace, intptr_t dataLength, const char *data, MlirType type)
Creates an opaque attribute in the given context associated with the dialect identified by its namesp...
MLIR_CAPI_EXPORTED MlirAttribute mlirFloatAttrDoubleGetChecked(MlirLocation loc, MlirType type, double value)
Same as "mlirFloatAttrDoubleGet", but if the type is not valid for a construction of a FloatAttr,...
MLIR_CAPI_EXPORTED uint8_t mlirDenseElementsAttrGetUInt8Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED int64_t mlirStridedLayoutAttrGetOffset(MlirAttribute attr)
MLIR_CAPI_EXPORTED MlirAffineMap mlirAffineMapAttrGetValue(MlirAttribute attr)
Returns the affine map wrapped in the given affine map attribute.
MLIR_CAPI_EXPORTED int64_t mlirStridedLayoutAttrGetStride(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED int8_t mlirDenseElementsAttrGetInt8Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED MlirAttribute mlirStridedLayoutAttrGet(MlirContext ctx, int64_t offset, intptr_t numStrides, const int64_t *strides)
MLIR_CAPI_EXPORTED unsigned mlirIntegerAttrGetValueNumWords(MlirAttribute attr)
Returns the number of 64-bit words that make up the integer attribute's underlying APInt value.
MLIR_CAPI_EXPORTED MlirAttribute mlirFlatSymbolRefAttrGet(MlirContext ctx, MlirStringRef symbol)
Creates a flat symbol reference attribute in the given context referencing a symbol identified by the...
MLIR_CAPI_EXPORTED uint64_t mlirDenseElementsAttrGetIndexValue(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED MlirTypeID mlirIntegerAttrGetTypeID(void)
Returns the typeID of an Integer attribute.
MLIR_CAPI_EXPORTED int16_t mlirDenseElementsAttrGetInt16Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED MlirStringRef mlirSymbolRefAttrGetRootReference(MlirAttribute attr)
Returns the string reference to the root referenced symbol.
MLIR_CAPI_EXPORTED MlirTypeID mlirDenseIntOrFPElementsAttrGetTypeID(void)
Returns the typeID of an DenseIntOrFPElements attribute.
MLIR_CAPI_EXPORTED bool mlirAttributeIsAInteger(MlirAttribute attr)
Checks whether the given attribute is an integer attribute.
MLIR_CAPI_EXPORTED intptr_t mlirDictionaryAttrGetNumElements(MlirAttribute attr)
Returns the number of attributes contained in a dictionary attribute.
MLIR_CAPI_EXPORTED MlirAttribute mlirIntegerSetAttrGet(MlirIntegerSet set)
Creates an integer set attribute wrapping the given set.
MLIR_CAPI_EXPORTED uint16_t mlirDenseElementsAttrGetUInt16Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED uint64_t mlirDenseElementsAttrGetUInt64Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED bool mlirBoolAttrGetValue(MlirAttribute attr)
Returns the value stored in the given bool attribute.
MLIR_CAPI_EXPORTED MlirAttribute mlirIntegerAttrGet(MlirType type, int64_t value)
Creates an integer attribute of the given type with the given integer value.
MLIR_CAPI_EXPORTED bool mlirDenseElementsAttrGetBoolValue(MlirAttribute attr, intptr_t pos)
Returns the pos-th value (flat contiguous indexing) of a specific type contained by the given dense e...
MLIR_CAPI_EXPORTED MlirAttribute mlirDictionaryAttrGet(MlirContext ctx, intptr_t numElements, MlirNamedAttribute const *elements)
Creates a dictionary attribute containing the given list of elements in the provided context.
MLIR_CAPI_EXPORTED MlirAttribute mlirUnmanagedDenseResourceElementsAttrGet(MlirType shapedType, MlirStringRef name, void *data, size_t dataLength, size_t dataAlignment, bool dataIsMutable, void(*deleter)(void *userData, const void *data, size_t size, size_t align), void *userData)
Unlike the typed accessors below, constructs the attribute with a raw data buffer and no type/alignme...
MLIR_CAPI_EXPORTED MlirAttribute mlirSymbolRefAttrGetNestedReference(MlirAttribute attr, intptr_t pos)
Returns pos-th reference nested in the given symbol reference attribute.
MLIR_CAPI_EXPORTED void mlirIntegerAttrGetValueWords(MlirAttribute attr, uint64_t *words)
Copies the 64-bit words making up the integer attribute's APInt value into the provided buffer.
MLIR_CAPI_EXPORTED int64_t mlirIntegerAttrGetValueInt(MlirAttribute attr)
Returns the value stored in the given integer attribute, assuming the value is of signless type and f...
MLIR_CAPI_EXPORTED intptr_t mlirSymbolRefAttrGetNumNestedReferences(MlirAttribute attr)
Returns the number of references nested in the given symbol reference attribute.
MLIR_CAPI_EXPORTED MlirType mlirTypeAttrGetValue(MlirAttribute attr)
Returns the type stored in the given type attribute.
MLIR_CAPI_EXPORTED bool mlirDenseElementsAttrIsSplat(MlirAttribute attr)
Checks whether the given dense elements attribute contains a single replicated value (splat).
MLIR_CAPI_EXPORTED MlirAttribute mlirDenseElementsAttrGet(MlirType shapedType, intptr_t numElements, MlirAttribute const *elements)
Creates a dense elements attribute with the given Shaped type and elements in the same context as the...
MLIR_CAPI_EXPORTED MlirStringRef mlirOpaqueAttrGetData(MlirAttribute attr)
Returns the raw data as a string reference.
MLIR_CAPI_EXPORTED MlirAttribute mlirAttributeGetNull(void)
Returns an empty attribute.
MLIR_CAPI_EXPORTED MlirAttribute mlirBoolAttrGet(MlirContext ctx, int value)
Creates a bool attribute in the given context with the given value.
MLIR_CAPI_EXPORTED int64_t mlirIntegerAttrGetValueSInt(MlirAttribute attr)
Returns the value stored in the given integer attribute, assuming the value is of signed type and fit...
MLIR_CAPI_EXPORTED int64_t mlirDenseElementsAttrGetInt64Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED MlirNamedAttribute mlirDictionaryAttrGetElement(MlirAttribute attr, intptr_t pos)
Returns pos-th element of the given dictionary attribute.
MLIR_CAPI_EXPORTED MlirAttribute mlirArrayAttrGetElement(MlirAttribute attr, intptr_t pos)
Returns pos-th element stored in the given array attribute.
MLIR_CAPI_EXPORTED MlirAttribute mlirDictionaryAttrGetElementByName(MlirAttribute attr, MlirStringRef name)
Returns the dictionary attribute element with the given name or NULL if the given name does not exist...
MLIR_CAPI_EXPORTED MlirTypeID mlirSymbolRefAttrGetTypeID(void)
Returns the typeID of an SymbolRef attribute.
MLIR_CAPI_EXPORTED MlirTypeID mlirDenseArrayAttrGetTypeID(void)
MLIR_CAPI_EXPORTED MlirAttribute mlirDenseElementsAttrGetSplatValue(MlirAttribute attr)
Returns the single replicated value (splat) of a specific type contained by the given dense elements ...
MLIR_CAPI_EXPORTED float mlirDenseElementsAttrGetFloatValue(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED int64_t mlirElementsAttrGetNumElements(MlirAttribute attr)
Gets the total number of elements in the given elements attribute.
MLIR_CAPI_EXPORTED MlirStringRef mlirOpaqueAttrGetDialectNamespace(MlirAttribute attr)
Returns the namespace of the dialect with which the given opaque attribute is associated.
MLIR_CAPI_EXPORTED int32_t mlirDenseElementsAttrGetInt32Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED MlirStringRef mlirStringAttrGetValue(MlirAttribute attr)
Returns the attribute values as a string reference.
MLIR_CAPI_EXPORTED double mlirFloatAttrGetValueDouble(MlirAttribute attr)
Returns the value stored in the given floating point attribute, interpreting the value as double.
MLIR_CAPI_EXPORTED uint64_t mlirIntegerAttrGetValueUInt(MlirAttribute attr)
Returns the value stored in the given integer attribute, assuming the value is of unsigned type and f...
MLIR_CAPI_EXPORTED MlirAttribute mlirUnitAttrGet(MlirContext ctx)
Creates a unit attribute in the given context.
MLIR_CAPI_EXPORTED double mlirDenseElementsAttrGetDoubleValue(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED intptr_t mlirStridedLayoutAttrGetNumStrides(MlirAttribute attr)
MLIR_CAPI_EXPORTED MlirAttribute mlirFloatAttrDoubleGet(MlirContext ctx, MlirType type, double value)
Creates a floating point attribute in the given context with the given double value and double-precis...
MLIR_CAPI_EXPORTED MlirAttribute mlirArrayAttrGet(MlirContext ctx, intptr_t numElements, MlirAttribute const *elements)
Creates an array element containing the given list of elements in the given context.
MLIR_CAPI_EXPORTED bool mlirAttributeIsAFloat(MlirAttribute attr)
Checks whether the given attribute is a floating point attribute.
MLIR_CAPI_EXPORTED MlirAttribute mlirSymbolRefAttrGet(MlirContext ctx, MlirStringRef symbol, intptr_t numReferences, MlirAttribute const *references)
Creates a symbol reference attribute in the given context referencing a symbol identified by the give...
MLIR_CAPI_EXPORTED MlirAttribute mlirDenseElementsAttrSplatGet(MlirType shapedType, MlirAttribute element)
Creates a dense elements attribute with the given Shaped type containing a single replicated element ...
MLIR_CAPI_EXPORTED MlirAttribute mlirStringAttrGet(MlirContext ctx, MlirStringRef str)
Creates a string attribute in the given context containing the given string.
MLIR_CAPI_EXPORTED MlirAttribute mlirTypeAttrGet(MlirType type)
Creates a type attribute wrapping the given type in the same context as the type.
MLIR_CAPI_EXPORTED intptr_t mlirArrayAttrGetNumElements(MlirAttribute attr)
Returns the number of elements stored in the given array attribute.
MLIR_CAPI_EXPORTED unsigned mlirIntegerAttrGetValueBitWidth(MlirAttribute attr)
Returns the bit width of the integer attribute's underlying APInt value.
MLIR_CAPI_EXPORTED MlirAttribute mlirDenseElementsAttrRawBufferGet(MlirType shapedType, size_t rawBufferSize, const void *rawBuffer)
Creates a dense elements attribute with the given Shaped type and elements populated from a packed,...
MLIR_CAPI_EXPORTED MlirAttribute mlirStringAttrTypedGet(MlirType type, MlirStringRef str)
Creates a string attribute in the given context containing the given string.
MLIR_CAPI_EXPORTED MlirAttribute mlirIntegerAttrGetFromWords(MlirType type, unsigned numWords, const uint64_t *words)
Creates an integer attribute of the given type from an array of 64-bit words.
MLIR_CAPI_EXPORTED MlirStringRef mlirFlatSymbolRefAttrGetValue(MlirAttribute attr)
Returns the referenced symbol as a string reference.
MLIR_CAPI_EXPORTED uint32_t mlirDenseElementsAttrGetUInt32Value(MlirAttribute attr, intptr_t pos)
MLIR_CAPI_EXPORTED MlirType mlirRankedTensorTypeGet(intptr_t rank, const int64_t *shape, MlirType elementType, MlirAttribute encoding)
Creates a tensor type of a fixed rank with the given shape, element type, and optional encoding in th...
MLIR_CAPI_EXPORTED bool mlirIntegerTypeIsSignless(MlirType type)
Checks whether the given integer type is signless.
MLIR_CAPI_EXPORTED bool mlirTypeIsAInteger(MlirType type)
Checks whether the given type is an integer type.
MLIR_CAPI_EXPORTED MlirType mlirIntegerTypeGet(MlirContext ctx, unsigned bitwidth)
Creates a signless integer type of the given bitwidth in the context.
MLIR_CAPI_EXPORTED bool mlirIntegerTypeIsUnsigned(MlirType type)
Checks whether the given integer type is unsigned.
MLIR_CAPI_EXPORTED unsigned mlirIntegerTypeGetWidth(MlirType type)
Returns the bitwidth of an integer type.
MLIR_CAPI_EXPORTED MlirType mlirF64TypeGet(MlirContext ctx)
Creates a f64 type in the given context.
MLIR_CAPI_EXPORTED MlirType mlirIntegerTypeSignedGet(MlirContext ctx, unsigned bitwidth)
Creates a signed integer type of the given bitwidth in the context.
MLIR_CAPI_EXPORTED MlirType mlirF16TypeGet(MlirContext ctx)
Creates an f16 type in the given context.
MLIR_CAPI_EXPORTED bool mlirTypeIsAF64(MlirType type)
Checks whether the given type is an f64 type.
MLIR_CAPI_EXPORTED bool mlirTypeIsAF16(MlirType type)
Checks whether the given type is an f16 type.
MLIR_CAPI_EXPORTED bool mlirIntegerTypeIsSigned(MlirType type)
Checks whether the given integer type is signed.
MLIR_CAPI_EXPORTED MlirType mlirShapedTypeGetElementType(MlirType type)
Returns the element type of the shaped type.
MLIR_CAPI_EXPORTED bool mlirShapedTypeHasStaticShape(MlirType type)
Checks whether the given shaped type has a static shape.
MLIR_CAPI_EXPORTED MlirType mlirF32TypeGet(MlirContext ctx)
Creates an f32 type in the given context.
MLIR_CAPI_EXPORTED bool mlirTypeIsAShaped(MlirType type)
Checks whether the given type is a Shaped type.
MLIR_CAPI_EXPORTED MlirType mlirIntegerTypeUnsignedGet(MlirContext ctx, unsigned bitwidth)
Creates an unsigned integer type of the given bitwidth in the context.
MLIR_CAPI_EXPORTED bool mlirTypeIsAF32(MlirType type)
Checks whether the given type is an f32 type.
MLIR_CAPI_EXPORTED bool mlirTypeIsAIndex(MlirType type)
Checks whether the given type is an index type.
MLIR_CAPI_EXPORTED int64_t mlirShapedTypeGetDynamicStrideOrOffset(void)
Returns the value indicating a dynamic stride or offset in a shaped type.
MLIR_CAPI_EXPORTED MlirNamedAttribute mlirNamedAttributeGet(MlirIdentifier name, MlirAttribute attr)
Associates an attribute with the name. Takes ownership of neither.
MLIR_CAPI_EXPORTED MlirStringRef mlirIdentifierStr(MlirIdentifier ident)
Gets the string value of the identifier.
MLIR_CAPI_EXPORTED MlirContext mlirTypeGetContext(MlirType type)
Gets the context that a type was created with.
MLIR_CAPI_EXPORTED bool mlirTypeEqual(MlirType t1, MlirType t2)
Checks if two types are equal.
MLIR_CAPI_EXPORTED MlirIdentifier mlirIdentifierGet(MlirContext context, MlirStringRef str)
Gets an identifier with the given string value.
nb::object denseIntOrFPElementsAttributeCaster(PyAttribute &pyAttribute)
nb::object symbolRefOrFlatSymbolRefAttributeCaster(PyAttribute &pyAttribute)
nb::object integerOrBoolAttributeCaster(PyAttribute &pyAttribute)
MlirStringRef toMlirStringRef(const std::string &s)
static T pyTryCast(nanobind::handle object)
nb::object denseArrayAttributeCaster(PyAttribute &pyAttribute)
MLIR_PYTHON_API_EXPORTED void populateIRAttributes(nanobind::module_ &m)
Include the generated interface declarations.
std::string join(const Ts &...args)
Helper function to concatenate arguments into a std::string.
A pointer to a sized fragment of a string, not necessarily null-terminated.
const char * data
Pointer to the first symbol.
size_t length
Length of the fragment.
Custom exception that allows access to error diagnostic information.
Instantiate the python dense array classes.
static constexpr IsAFunctionTy isaFunction
static constexpr IsAFunctionTy isaFunction
static constexpr IsAFunctionTy isaFunction
static constexpr IsAFunctionTy isaFunction
static constexpr IsAFunctionTy isaFunction
static constexpr IsAFunctionTy isaFunction
static constexpr IsAFunctionTy isaFunction
RAII object that captures any error diagnostics emitted to the provided context.
std::vector< PyDiagnostic::DiagnosticInfo > take()
nb_buffer_info(void *ptr, Py_ssize_t itemsize, const char *format, Py_ssize_t ndim, std::vector< Py_ssize_t > shape_in, std::vector< Py_ssize_t > strides_in, bool readonly=false, std::unique_ptr< Py_buffer, void(*)(Py_buffer *)> owned_view_in=std::unique_ptr< Py_buffer, void(*)(Py_buffer *)>(nullptr, nullptr))
std::vector< Py_ssize_t > shape
std::vector< Py_ssize_t > strides
static const char * format()
static const char * format()
static const char * format()
static const char * format()
static const char * format()
static const char * format()
static const char * format()
static const char * format()
static const char * format()
static const char * format()
static const char * format()