* Copyright (c) 2026 Huawei Technologies Co., Ltd.
* This program is free software, you can redistribute it and/or modify it under the terms and conditions of
* CANN Open Software License Agreement Version 2.0 (the "License").
* Please refer to the License for details. You may not use this file except in compliance with the License.
* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
* See LICENSE in the root of the software repository for the full text of the License.
*/
#if !defined(ASCENDC_TENSOR_API_INCLUDE_COMPILER_INTERNAL_HEADERS)
#define ASCENDC_TENSOR_API_INCLUDE_COMPILER_INTERNAL_HEADERS
#define UNDEF_ASCENDC_TENSOR_API_INCLUDE_COMPILER_INTERNAL_HEADERS_ASCENDC_TENSOR_API_H
#endif
* \file legacy.h
* \brief PascalCase wrapper functions for backward compatibility
*/
#ifndef IMPL_TENSOR_API_LEGACY_LEGACY_H
#define IMPL_TENSOR_API_LEGACY_LEGACY_H
#include "impl/tensor_api/legacy/legacy_atom.h"
#if !defined(ASC_DEPRECATED)
#define ASC_DEPRECATED(version, removal_date, replacement) \
[[deprecated("Deprecated since " #version ", Will be removed after " removal_date ", Use " #replacement \
" instead.")]]
#endif
namespace AscendC {
namespace Te {
using namespace asc::te;
namespace AttrInfo {
using Shape = asc::te::attr_info::shape;
using Stride = asc::te::attr_info::stride;
using Row = asc::te::attr_info::row;
using Column = asc::te::attr_info::column;
}
template <typename Info1, typename Info2, size_t Dim, typename Layout>
__aicore__ inline constexpr decltype(auto) GetElement(const Layout& layout)
{
return asc::te::get_element<Info1, Info2, Dim>(layout);
}
template <typename Info1, typename Info2, typename Layout>
__aicore__ inline constexpr decltype(auto) GetElement(const Layout& layout)
{
return asc::te::get_element<Info1, Info2>(layout);
}
template <typename Tensor>
using GetMemLocation = get_mem_location<Tensor>;
template <typename LayoutPattern, typename TraitType = layout_trait_default<>>
using FrameLayoutFormat = frame_layout_format<LayoutPattern, TraitType>;
template <typename DataType, typename C0 = Std::Int<c0_element<DataType>>>
using LayoutTrait = layout_trait<DataType, C0>;
using ArchVersion = arch_version;
template <typename TensorType, typename TargetLayoutPtn>
inline constexpr bool IsSatisfiedPtnFormatV = is_satisfied_ptn_format_v<TensorType, TargetLayoutPtn>;
template <typename Tensor>
inline constexpr bool IsAttrTensorV = asc::te::is_attr_tensor_v<Tensor>;
template <typename LayoutType>
ASC_DEPRECATED(9.2.0, "2027/09/07", get_total_column_shape)
__aicore__ inline constexpr auto GetTotalColumnShape(const LayoutType& layout)
{
return get_total_column_shape(layout);
}
template <typename LayoutType>
ASC_DEPRECATED(9.2.0, "2027/09/07", get_total_row_shape)
__aicore__ inline constexpr auto GetTotalRowShape(const LayoutType& layout)
{
return get_total_row_shape(layout);
}
template <typename Param>
ASC_DEPRECATED(9.2.0, "2027/09/07", set_mte2_nz_para)
__aicore__ inline void SetMTE2NzPara(const Param& para)
{
set_mte2_nz_para(para);
}
template <typename FirstShape, typename... Shapes>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_shape)
__aicore__ inline constexpr Shape<FirstShape, Shapes...> MakeShape(const FirstShape& value, const Shapes&... values)
{
return make_shape(value, values...);
}
template <typename FirstStride, typename... Strides>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_stride)
__aicore__ inline constexpr Stride<FirstStride, Strides...> MakeStride(
const FirstStride& value, const Strides&... values)
{
return make_stride(value, values...);
}
template <typename FirstCoord, typename... Coords>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_coord)
__aicore__ inline constexpr Coord<FirstCoord, Coords...> MakeCoord(const FirstCoord& value, const Coords&... values)
{
return make_coord(value, values...);
}
template <typename ShapeType, typename StrideType>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_layout)
__aicore__ inline constexpr auto MakeLayout(const ShapeType& shape, const StrideType& stride)
{
return make_layout(shape, stride);
}
template <typename ShapeType>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_layout)
__aicore__ inline constexpr auto MakeLayout(const ShapeType& shape)
{
return make_layout(shape);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", get_shape)
__aicore__ inline constexpr auto GetShape(const LayoutType& layout)
{
return get_shape<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", get_shape)
__aicore__ inline constexpr auto GetShape(LayoutType& layout)
{
return get_shape<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", get_stride)
__aicore__ inline constexpr auto GetStride(const LayoutType& layout)
{
return get_stride<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", get_stride)
__aicore__ inline constexpr auto GetStride(LayoutType& layout)
{
return get_stride<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", coshape)
__aicore__ inline constexpr auto Coshape(const LayoutType& layout)
{
return coshape<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", cosize)
__aicore__ inline constexpr auto Cosize(const LayoutType& layout)
{
return cosize<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", rank)
__aicore__ inline constexpr auto Rank(const LayoutType& layout)
{
return rank<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", select)
__aicore__ inline constexpr auto Select(const LayoutType& layout)
{
return select<Is...>(layout);
}
template <
size_t I, size_t... Is, typename Tuple, typename = Std::enable_if_t<Std::is_tuple_v<Std::remove_cvref_t<Tuple>>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", get)
__aicore__ inline constexpr auto Get(Tuple&& tuple)
{
return get<I, Is...>(static_cast<Tuple&&>(tuple));
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", get)
__aicore__ inline constexpr auto Get(const LayoutType& layout)
{
return get<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", size)
__aicore__ inline constexpr auto Size(const LayoutType& layout)
{
return size<Is...>(layout);
}
template <size_t... Is, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", capacity)
__aicore__ inline constexpr auto Capacity(const LayoutType& layout)
{
return capacity<Is...>(layout);
}
template <typename Tensor, typename CoordType, typename Info>
ASC_DEPRECATED(9.2.0, "2027/09/07", slice)
__aicore__ inline constexpr decltype(auto) Slice(Tensor&& tensor, const CoordType& coord, const Info& info)
{
return slice(tensor, coord, info);
}
template <typename CoordType, typename ShapeType, typename StrideType>
ASC_DEPRECATED(9.2.0, "2027/09/07", crd2idx)
__aicore__ inline constexpr auto Crd2Idx(const CoordType& coord, const ShapeType& shape, const StrideType& stride)
{
return crd2idx(coord, shape, stride);
}
template <typename CoordType, typename LayoutType, typename = Std::enable_if_t<asc::te::is_layout_v<LayoutType>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", crd2idx)
__aicore__ inline constexpr auto Crd2Idx(const CoordType& coord, const LayoutType& layout)
{
return crd2idx(coord, layout);
}
template <typename LayoutPattern, typename TraitType = Std::ignore_t, typename... Args>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_frame_layout)
__aicore__ inline decltype(auto) MakeFrameLayout(const Args&... args)
{
return make_frame_layout<LayoutPattern, TraitType>(args...);
}
template <typename LayoutPattern, size_t C0Element, typename... Args>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_frame_layout)
__aicore__ inline decltype(auto) MakeFrameLayout(const Args&... args)
{
return make_frame_layout<LayoutPattern, C0Element>(args...);
}
template <typename LayoutPattern, typename TraitType, typename ShapeType, typename StrideType>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_pattern_layout)
__aicore__ inline constexpr auto MakePatternLayout(const ShapeType& shape, const StrideType& stride)
{
return make_pattern_layout<LayoutPattern, TraitType>(shape, stride);
}
template <typename PtrPattern, typename Iterator>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_location_mem_ptr)
__aicore__ inline auto MakeLocationMemPtr(Iterator iterator)
{
return make_location_mem_ptr<PtrPattern>(iterator);
}
template <
typename PtrPattern, typename DataType, typename Addr, asc::te::enable_make_ptr_by_trait<PtrPattern, Addr> = 0>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_mem_ptr)
__aicore__ inline auto MakeMemPtr(Addr address)
{
return make_mem_ptr<PtrPattern, DataType>(address);
}
template <typename PtrPattern, typename Iterator, asc::te::enable_make_hardware_ptr<PtrPattern, Iterator> = 0>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_mem_ptr)
__aicore__ inline auto MakeMemPtr(Iterator iterator)
{
return make_mem_ptr<PtrPattern>(iterator);
}
template <typename Iterator, asc::te::enable_make_ptr_by_iter<Iterator> = 0>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_mem_ptr)
__aicore__ inline auto MakeMemPtr(Iterator iterator)
{
return make_mem_ptr(iterator);
}
template <typename Iterator, typename... Args>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_tensor)
__aicore__ inline auto MakeTensor(const Iterator& iterator, const Args&... args)
{
return make_tensor(iterator, args...);
}
template <
size_t... SqueezeDims, typename Input,
typename = Std::enable_if_t<
(asc::te::is_layout_v<Input> || asc::te::is_attr_tensor_v<Input>) && (sizeof...(SqueezeDims) > 0)>>
ASC_DEPRECATED(9.2.0, "2027/09/07", squeeze)
__aicore__ inline auto Squeeze(const Input& value)
{
return squeeze<SqueezeDims...>(value);
}
template <
typename Pattern, typename Input,
typename = Std::enable_if_t<
(asc::te::is_layout_v<Input> || asc::te::is_attr_tensor_v<Input>) &&
Std::is_tuple_v<Std::remove_cvref_t<Pattern>>>>
ASC_DEPRECATED(9.2.0, "2027/09/07", squeeze)
__aicore__ inline auto Squeeze(const Input& value, const Pattern& pattern)
{
return squeeze(value, pattern);
}
template <typename... Args, typename DstTensor, typename FmTensor, typename FilterTensor>
ASC_DEPRECATED(9.2.0, "2027/09/07", mmad)
__aicore__ inline void Mmad(
const MmadAtom<MmadTraits<Args...>>& atom, const DstTensor& dst, const FmTensor& fm, const FilterTensor& filter)
{
atom.Call(dst, fm, filter);
}
template <
typename... Args, typename DstTensor, typename FmTensor, typename FilterTensor, typename BiasTensor,
Std::enable_if_t<asc::te::is_attr_tensor_v<BiasTensor>, int> = 0>
ASC_DEPRECATED(9.2.0, "2027/09/07", mmad)
__aicore__ inline void Mmad(
const MmadAtom<MmadTraits<Args...>>& atom, const DstTensor& dst, const FmTensor& fm, const FilterTensor& filter,
const BiasTensor& bias)
{
atom.Call(dst, fm, filter, bias);
}
template <typename MmadOperationType>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_mmad)
__aicore__ inline constexpr auto MakeMmad(const MmadOperationType& operation)
{
return MmadAtom<MmadOperationType>{};
}
template <typename MmadOperationType, typename MmadTraitType>
ASC_DEPRECATED(9.2.0, "2027/09/07", make_mmad)
__aicore__ inline constexpr auto MakeMmad(const MmadOperationType& operation, const MmadTraitType& trait)
{
return MmadAtom<MmadTraits<MmadOperationType, MmadTraitType>>{};
}
}
}
namespace asc {
namespace te {
using ::AscendC::Te::MakeTensor;
}
}
#endif
#if defined(UNDEF_ASCENDC_TENSOR_API_INCLUDE_COMPILER_INTERNAL_HEADERS_ASCENDC_TENSOR_API_H)
#undef ASCENDC_TENSOR_API_INCLUDE_COMPILER_INTERNAL_HEADERS
#undef UNDEF_ASCENDC_TENSOR_API_INCLUDE_COMPILER_INTERNAL_HEADERS_ASCENDC_TENSOR_API_H
#endif
