migraphx.hpp 35.6 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
/*
 * The MIT License (MIT)
 *
 * Copyright (c) 2015-2022 Advanced Micro Devices, Inc. All rights reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */
Paul Fultz II's avatar
Paul Fultz II committed
24
25
26
#ifndef MIGRAPHX_GUARD_API_RTGLIB_MIGRAPHX_HPP
#define MIGRAPHX_GUARD_API_RTGLIB_MIGRAPHX_HPP

27
28
#include "migraphx.h"
#include <initializer_list>
Paul Fultz II's avatar
Paul Fultz II committed
29
30
31
32
33
#include <migraphx/migraphx.h>
#include <memory>
#include <exception>
#include <vector>
#include <cassert>
Shucai Xiao's avatar
Shucai Xiao committed
34
#include <iostream>
Paul Fultz II's avatar
Paul Fultz II committed
35
36

namespace migraphx {
37
#ifndef DOXYGEN
Paul Fultz II's avatar
Paul Fultz II committed
38
inline namespace api { // NOLINT
39
#endif
Paul Fultz II's avatar
Paul Fultz II committed
40

41
42
43
44
45
46
47
48
49
50
#ifdef __has_cpp_attribute
#if __has_cpp_attribute(deprecated)
#define MIGRAPHX_DEPRECATED(...) [[deprecated(__VA_ARGS__)]]
#endif
#endif

#ifndef MIGRAPHX_DEPRECATED
#define MIGRAPHX_DEPRECATED(...)
#endif

51
52
53
54
55
56
57
58
59
60
template <int N>
struct rank : rank<N - 1>
{
};

template <>
struct rank<0>
{
};

Paul Fultz II's avatar
Paul Fultz II committed
61
62
63
64
template <class T, class F, class... Ts>
T* make(F f, Ts&&... xs)
{
    T* result = nullptr;
65
    auto e    = f(&result, std::forward<Ts>(xs)...);
Paul Fultz II's avatar
Paul Fultz II committed
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
    if(e != migraphx_status_success)
        throw std::runtime_error("Failed to call function");
    return result;
}

template <class F, class... Ts>
void call(F f, Ts&&... xs)
{
    auto e = f(std::forward<Ts>(xs)...);
    if(e != migraphx_status_success)
        throw std::runtime_error("Failed to call function");
}

template <class F, class Iterator = std::size_t>
struct iota_iterator
{
    Iterator index;
    F f;

    using difference_type   = std::ptrdiff_t;
    using reference         = decltype(f(std::declval<Iterator>()));
    using value_type        = typename std::remove_reference<reference>::type;
    using pointer           = typename std::add_pointer<value_type>::type;
    using iterator_category = std::input_iterator_tag;

    iota_iterator& operator+=(int n)
    {
        index += n;
        return *this;
    }

    iota_iterator& operator-=(int n)
    {
        index += n;
        return *this;
    }

    iota_iterator& operator++()
    {
        index++;
        return *this;
    }

    iota_iterator& operator--()
    {
        index--;
        return *this;
    }

    iota_iterator operator++(int) // NOLINT
    {
        iota_iterator it = *this;
        index++;
        return it;
    }

    iota_iterator operator--(int) // NOLINT
    {
        iota_iterator it = *this;
        index--;
        return it;
    }
    // TODO: operator->
129
    reference operator*() const { return f(index); }
Paul Fultz II's avatar
Paul Fultz II committed
130

131
132
133
134
    friend iota_iterator operator+(iota_iterator x, iota_iterator y)
    {
        return iota_iterator(x.index + y.index, x.f);
    }
Paul Fultz II's avatar
Paul Fultz II committed
135

136
137
138
139
    friend iota_iterator operator-(iota_iterator x, iota_iterator y)
    {
        return iota_iterator(x.index - y.index, x.f);
    }
Paul Fultz II's avatar
Paul Fultz II committed
140

141
    friend bool operator==(iota_iterator x, iota_iterator y) { return x.index == y.index; }
Paul Fultz II's avatar
Paul Fultz II committed
142

143
144
    friend bool operator!=(iota_iterator x, iota_iterator y) { return x.index != y.index; }
};
Paul Fultz II's avatar
Paul Fultz II committed
145
146
147
148
149
150
151
152
153

template <class Derived>
struct array_base
{
    const Derived& derived() const { return static_cast<const Derived&>(*this); }

    template <class T>
    using value_type_t = decltype(std::declval<T>()[0]);

154
155
156
157
158
159
160
161
162
163
    struct iterator_read
    {
        const Derived* self;
        template <class D = Derived>
        value_type_t<D> operator()(size_t pidx) const
        {
            return (*self)[pidx];
        }
    };

Paul Fultz II's avatar
Paul Fultz II committed
164
    template <class T>
165
166
167
    using iterator_t = iota_iterator<iterator_read>;

    bool empty() const { return derived().size() == 0; }
Paul Fultz II's avatar
Paul Fultz II committed
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183

    template <class D = Derived>
    value_type_t<D> front() const
    {
        return derived()[0];
    }

    template <class D = Derived>
    value_type_t<D> back() const
    {
        return derived()[derived().size() - 1];
    }

    template <class D = Derived>
    iterator_t<D> begin() const
    {
184
        return {0, {&derived()}};
Paul Fultz II's avatar
Paul Fultz II committed
185
186
187
188
189
    }

    template <class D = Derived>
    iterator_t<D> end() const
    {
190
        return {derived().size(), {&derived()}};
Paul Fultz II's avatar
Paul Fultz II committed
191
192
193
    }
};

194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
#if defined(__GNUC__) && !defined(__clang__)
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wnon-template-friend"
#endif

template <class T>
struct holder
{
    // Friend injection
    friend auto migraphx_adl_handle_lookup(holder<T>);
    // Function left unimplemented since its only used in non-evaluated
    // context
    T get() const;
};

template <class C, class T>
struct handle_lookup
{
    friend auto migraphx_adl_handle_lookup(holder<T>) { return holder<C>{}; }
};

#if defined(__GNUC__) && !defined(__clang__)
#pragma GCC diagnostic pop
#endif

template <class T>
using as_handle = decltype(
    migraphx_adl_handle_lookup(holder<std::remove_cv_t<std::remove_pointer_t<T>>>{}).get());

Paul Fultz II's avatar
Paul Fultz II committed
223
224
225
226
227
228
229
struct own
{
};
struct borrow
{
};

230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
template <class T>
struct share
{
    share(std::shared_ptr<T> p) : ptr(std::move(p)) {}

    template <class U>
    std::shared_ptr<U> alias(U* p) const
    {
        return std::shared_ptr<U>{ptr, p};
    }

    private:
    std::shared_ptr<T> ptr;
};

245
246
template <class Derived, class T, class D, D Deleter, class A, A Assigner>
struct handle_base : handle_lookup<Derived, std::remove_cv_t<T>>
Paul Fultz II's avatar
Paul Fultz II committed
247
{
248
    using handle_type = T;
Paul Fultz II's avatar
Paul Fultz II committed
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
    handle_base() : m_handle(nullptr) {}
    template <class F, class... Ts>
    void make_handle(F f, Ts&&... xs)
    {
        using type = typename std::remove_cv<T>::type;
        set_handle(make<type>(f, std::forward<Ts>(xs)...), own{});
    }

    const std::shared_ptr<T>& get_handle() const { return m_handle; }

    T* get_handle_ptr() const
    {
        assert(m_handle != nullptr);
        return get_handle().get();
    }

    template <class U>
    void set_handle(U* ptr, own)
    {
        m_handle = std::shared_ptr<U>{ptr, Deleter};
    }

    template <class U>
    void set_handle(U* ptr, borrow)
    {
        m_handle = std::shared_ptr<U>{ptr, [](U*) {}};
    }

277
278
279
280
281
282
283
284
    template <class U, class V>
    void set_handle(U* ptr, share<V> b)
    {
        m_handle = std::shared_ptr<T>{ptr, [b](U*) {}};
    }

    share<T> share_handle() const { return {m_handle}; }

285
286
287
288
289
290
    template <class U>
    void assign_to_handle(U* x)
    {
        Assigner(x, this->get_handle_ptr());
    }

Paul Fultz II's avatar
Paul Fultz II committed
291
292
293
294
    protected:
    std::shared_ptr<T> m_handle;
};

295
296
297
298
299
300
301
302
303
304
305
// NOLINTNEXTLINE
#define MIGRAPHX_HANDLE_CONSTRUCTOR(name)                                                          \
    template <class HandleType,                                                                    \
              class Lifetime,                                                                      \
              class =                                                                              \
                  typename std::enable_if<std::is_convertible<HandleType*, handle_type*>{}>::type> \
    name(HandleType* p, Lifetime lifetime)                                                         \
    {                                                                                              \
        this->set_handle(p, std::move(lifetime));                                                  \
    }

306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
template <class Base>
struct interface_base : Base
{
    interface_base() : Base() {}

    protected:
    template <class F>
    static migraphx_status try_(F f) // NOLINT
    {
        try
        {
            f();
            return migraphx_status_success;
        }
        catch(...)
        {
            return migraphx_status_unknown_error;
        }
    }

    template <class F, class T, class... Ts>
    void make_interface(F f, T& obj, Ts&&... xs)
    {
        auto copy = [](void** out, void* input) {
            return try_([&] {
                T** y = reinterpret_cast<T**>(out);
                T* x  = reinterpret_cast<T*>(input);
                assert(x != nullptr and y != nullptr and *y == nullptr);
Paul Fultz II's avatar
Paul Fultz II committed
334
                // cppcheck-suppress useSmartPointer
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
                *y = new T(*x); // NOLINT
            });
        };
        auto del = [](void* input) {
            return try_([&] {
                T* x = reinterpret_cast<T*>(input);
                delete x; // NOLINT
            });
        };
        this->make_handle(f, &obj, copy, del, std::forward<Ts>(xs)...);
    }

    template <class T, class Setter, class F>
    void set_fp(Setter setter, F pf)
    {
        static F f = pf;
        (void)f; // avoid warning on gcc
        call(setter, this->get_handle_ptr(), [](auto... xs) -> migraphx_status {
            return try_([&] { call_cast_arg<T>(rank<1>{}, f, xs...); });
        });
    }

    template <class T, class Setter, class F>
    void set_auto_fp(Setter setter, F f)
    {
        return set_fp<T>(setter, [=](T& obj, auto out, auto... xs) {
            auto_invoke(f, out, obj, auto_convert_param(rank<2>{}, xs)...);
        });
    }

    struct no_out_arg
    {
    };

    template <class T, class F, class X, class... Xs, class = std::enable_if_t<std::is_void<X>{}>>
    static void call_cast_arg(rank<0>, F f, X* obj, Xs... xs)
    {
        f(reinterpret_cast<T*>(obj), no_out_arg{}, xs...);
    }

    template <class T,
              class F,
              class R,
              class X,
              class... Xs,
              class = std::enable_if_t<std::is_void<X>{}>>
    static void call_cast_arg(rank<1>, F f, R result, X* obj, Xs... xs)
    {
        f(*reinterpret_cast<T*>(obj), result, xs...);
    }

    template <class F, class T, class... Ts>
    void auto_invoke(F f, T* out, Ts&&... xs)
    {
        auto_assign(rank<2>{}, out, f(std::forward<Ts>(xs)...));
    }

    template <class F, class T, class... Ts>
    void auto_invoke(F f, no_out_arg, Ts&&... xs)
    {
        f(std::forward<Ts>(xs)...);
    }

    template <class T, class = std::enable_if_t<std::is_fundamental<T>{} or std::is_enum<T>{}>>
    T auto_convert_param(rank<0>, T x)
    {
        return x;
    }

404
405
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wdeprecated-declarations"
406
407
408
409
410
    template <class T>
    auto auto_convert_param(rank<1>, T x) -> decltype(as_handle<T>{x})
    {
        return as_handle<T>{x};
    }
411
#pragma GCC diagnostic pop
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441

    template <class T>
    auto auto_convert_param(rank<2>, T x) -> decltype(as_handle<T>{x, borrow{}})
    {
        return as_handle<T>{x, borrow{}};
    }

    template <class T, class U>
    void auto_assign(rank<0>, T* out, U x)
    {
        return *out = x;
    }

    template <class T, class U>
    auto auto_assign(rank<1>, T* out, U x) -> decltype(x.assign_to_handle(out))
    {
        x.assign_to_handle(out);
    }
};

// NOLINTNEXTLINE
#define MIGRAPHX_INTERFACE_LIFT(T, prefix, name)          \
    this->set_auto_fp<T>(&migraphx_##prefix##_set_##name, \
                         [](T& x, auto... xs) { return x.name(xs...); })

template <class Base, class T>
using require_interface =
    std::enable_if_t<std::is_base_of<Base, T>{} and not std::is_same<T, Base>{} and
                     std::is_copy_constructible<T>{} and std::is_final<T>{}>;

442
443
444
#ifdef DOXYGEN
#define MIGRAPHX_DETAIL_HANDLE_BASE(name, const_) handle_base<>
#else
445
#define MIGRAPHX_DETAIL_HANDLE_BASE(name, const_)       \
446
447
    handle_base<name,                                   \
                const_ migraphx_##name,                 \
448
449
450
451
                decltype(&migraphx_##name##_destroy),   \
                migraphx_##name##_destroy,              \
                decltype(&migraphx_##name##_assign_to), \
                migraphx_##name##_assign_to>
452
#endif
Paul Fultz II's avatar
Paul Fultz II committed
453
454
455
456
457
// NOLINTNEXTLINE
#define MIGRAPHX_HANDLE_BASE(name) MIGRAPHX_DETAIL_HANDLE_BASE(name, )
// NOLINTNEXTLINE
#define MIGRAPHX_CONST_HANDLE_BASE(name) MIGRAPHX_DETAIL_HANDLE_BASE(name, const)

458
459
460
461
462
/**
 * @brief Describe shape of tensor
 * @details A shape consists of a data type, lengths of multi-dimension tensor, and strides
 *
 */
Paul Fultz II's avatar
Paul Fultz II committed
463
464
465
466
struct shape : MIGRAPHX_CONST_HANDLE_BASE(shape)
{
    shape() {}

467
    MIGRAPHX_DEPRECATED("Contructor without lifetime annotation is deprecated.")
Paul Fultz II's avatar
Paul Fultz II committed
468
469
    shape(const migraphx_shape* p) { this->set_handle(p, borrow{}); }

470
    MIGRAPHX_HANDLE_CONSTRUCTOR(shape);
Paul Fultz II's avatar
Paul Fultz II committed
471

472
    /// Construct a scalar shape
473
474
475
476
477
    shape(migraphx_shape_datatype_t type)
    {
        this->make_handle(&migraphx_shape_create_scalar, type);
    }

478
479
    /// Construct a shape with its type and lengths. The strides are
    /// automatically computed assumming a packed layout.
Paul Fultz II's avatar
Paul Fultz II committed
480
481
482
483
484
    shape(migraphx_shape_datatype_t type, std::vector<size_t> plengths)
    {
        this->make_handle(&migraphx_shape_create, type, plengths.data(), plengths.size());
    }

485
486
487
    shape(migraphx_shape_datatype_t type,
          std::vector<size_t> plengths,
          std::vector<size_t> pstrides)
488
    {
489
490
491
492
493
494
        this->make_handle(&migraphx_shape_create_with_strides,
                          type,
                          plengths.data(),
                          plengths.size(),
                          pstrides.data(),
                          pstrides.size());
495
496
    }

Paul Fultz II's avatar
Paul Fultz II committed
497
498
499
500
501
    std::vector<size_t> lengths() const
    {
        const size_t* pout;
        size_t pout_size;
        call(&migraphx_shape_lengths, &pout, &pout_size, this->get_handle_ptr());
502
        return {pout, pout + pout_size};
Paul Fultz II's avatar
Paul Fultz II committed
503
504
505
506
507
508
509
    }

    std::vector<size_t> strides() const
    {
        const size_t* pout;
        size_t pout_size;
        call(&migraphx_shape_strides, &pout, &pout_size, this->get_handle_ptr());
510
        return {pout, pout + pout_size};
Paul Fultz II's avatar
Paul Fultz II committed
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
    }

    migraphx_shape_datatype_t type() const
    {
        migraphx_shape_datatype_t pout;
        call(&migraphx_shape_type, &pout, this->get_handle_ptr());
        return pout;
    }

    size_t bytes() const
    {
        size_t pout;
        call(&migraphx_shape_bytes, &pout, this->get_handle_ptr());
        return pout;
    }

    friend bool operator==(const shape& px, const shape& py)
    {
        bool pout;
        call(&migraphx_shape_equal, &pout, px.get_handle_ptr(), py.get_handle_ptr());
        return pout;
    }

    friend bool operator!=(const shape& px, const shape& py) { return !(px == py); }
};

537
538
539
540
541
542
/**
 * @brief Arguments to be passed to an migraphx arguments
 *
 * An `argument` represents a raw buffer of data with a shape.
 *
 */
Paul Fultz II's avatar
Paul Fultz II committed
543
544
545
546
struct argument : MIGRAPHX_CONST_HANDLE_BASE(argument)
{
    argument() {}

547
    MIGRAPHX_HANDLE_CONSTRUCTOR(argument);
Paul Fultz II's avatar
Paul Fultz II committed
548

549
    MIGRAPHX_DEPRECATED("Contructor without lifetime annotation is deprecated.")
Paul Fultz II's avatar
Paul Fultz II committed
550
551
552
553
554
555
556
557
558
559
560
    argument(const migraphx_argument* p) { this->set_handle(p, borrow{}); }

    argument(shape pshape, void* pbuffer)
    {
        this->make_handle(&migraphx_argument_create, pshape.get_handle_ptr(), pbuffer);
    }

    shape get_shape() const
    {
        const_migraphx_shape_t pout;
        call(&migraphx_argument_shape, &pout, this->get_handle_ptr());
561
        return {pout, this->share_handle()};
Paul Fultz II's avatar
Paul Fultz II committed
562
563
564
565
566
567
568
569
570
    }

    char* data() const
    {
        char* pout;
        call(&migraphx_argument_buffer, &pout, this->get_handle_ptr());
        return pout;
    }

571
572
573
574
575
576
577
578
    template <typename T>
    std::vector<T> as_vector() const
    {
        size_t vector_len = this->get_shape().bytes() / sizeof(T);
        T* buffer_ptr     = reinterpret_cast<T*>(this->data());
        return {buffer_ptr, buffer_ptr + vector_len};
    }

579
    /// Generate an argument using random data
Paul Fultz II's avatar
Paul Fultz II committed
580
581
    static argument generate(shape ps, size_t pseed = 0)
    {
582
583
        return {make<migraphx_argument>(&migraphx_argument_generate, ps.get_handle_ptr(), pseed),
                own{}};
Paul Fultz II's avatar
Paul Fultz II committed
584
585
586
587
588
589
590
591
592
593
594
595
    }

    friend bool operator==(const argument& px, const argument& py)
    {
        bool pout;
        call(&migraphx_argument_equal, &pout, px.get_handle_ptr(), py.get_handle_ptr());
        return pout;
    }

    friend bool operator!=(const argument& px, const argument& py) { return !(px == py); }
};

596
/// A target for compilation
Paul Fultz II's avatar
Paul Fultz II committed
597
598
599
600
struct target : MIGRAPHX_HANDLE_BASE(target)
{
    target() {}

601
    MIGRAPHX_HANDLE_CONSTRUCTOR(target);
Paul Fultz II's avatar
Paul Fultz II committed
602

603
    /// Construct a target from its name
Paul Fultz II's avatar
Paul Fultz II committed
604
605
606
607
608
609
610
    target(const char* name) { this->make_handle(&migraphx_target_create, name); }
};

struct program_parameter_shapes : MIGRAPHX_HANDLE_BASE(program_parameter_shapes)
{
    program_parameter_shapes() {}

611
    MIGRAPHX_HANDLE_CONSTRUCTOR(program_parameter_shapes);
Paul Fultz II's avatar
Paul Fultz II committed
612
613
614
615
616
617
618
619
620
621
622
623

    size_t size() const
    {
        size_t pout;
        call(&migraphx_program_parameter_shapes_size, &pout, this->get_handle_ptr());
        return pout;
    }

    shape operator[](const char* pname) const
    {
        const_migraphx_shape_t pout;
        call(&migraphx_program_parameter_shapes_get, &pout, this->get_handle_ptr(), pname);
624
        return {pout, this->share_handle()};
Paul Fultz II's avatar
Paul Fultz II committed
625
626
627
628
629
    }

    std::vector<const char*> names() const
    {
        std::vector<const char*> result(this->size());
Shucai Xiao's avatar
Shucai Xiao committed
630
631
632
633
        if(!result.empty())
        {
            call(&migraphx_program_parameter_shapes_names, result.data(), this->get_handle_ptr());
        }
Paul Fultz II's avatar
Paul Fultz II committed
634
635
636
637
        return result;
    }
};

638
/// A class to construct the inputs parameters for a program
Paul Fultz II's avatar
Paul Fultz II committed
639
640
struct program_parameters : MIGRAPHX_HANDLE_BASE(program_parameters)
{
641
    MIGRAPHX_HANDLE_CONSTRUCTOR(program_parameters);
Paul Fultz II's avatar
Paul Fultz II committed
642

643
    MIGRAPHX_DEPRECATED("Contructor without lifetime annotation is deprecated.")
Shucai Xiao's avatar
Shucai Xiao committed
644
645
    program_parameters(migraphx_program_parameters* p) { this->set_handle(p, borrow{}); }

Paul Fultz II's avatar
Paul Fultz II committed
646
647
    program_parameters() { this->make_handle(&migraphx_program_parameters_create); }

648
    /// Construct the parameters from initializer_list
649
650
651
652
653
654
655
    program_parameters(std::initializer_list<std::pair<std::string, argument>> l)
    {
        this->make_handle(&migraphx_program_parameters_create);
        for(auto&& p : l)
            this->add(p.first.c_str(), p.second);
    }

656
    /// Add a new parameter
Paul Fultz II's avatar
Paul Fultz II committed
657
658
659
660
661
662
663
664
665
666
667
    void add(const char* pname, const argument& pargument) const
    {
        call(&migraphx_program_parameters_add,
             this->get_handle_ptr(),
             pname,
             pargument.get_handle_ptr());
    }
};

struct arguments : MIGRAPHX_HANDLE_BASE(arguments), array_base<arguments>
{
668
    MIGRAPHX_HANDLE_CONSTRUCTOR(arguments);
Paul Fultz II's avatar
Paul Fultz II committed
669
670
671
672
673
674
675
676
677
678
679
680

    size_t size() const
    {
        size_t pout;
        call(&migraphx_arguments_size, &pout, this->get_handle_ptr());
        return pout;
    }

    argument operator[](size_t pidx) const
    {
        const_migraphx_argument_t pout;
        call(&migraphx_arguments_get, &pout, this->get_handle_ptr(), pidx);
681
        return {pout, this->share_handle()};
Paul Fultz II's avatar
Paul Fultz II committed
682
683
684
685
686
    }
};

struct shapes : MIGRAPHX_HANDLE_BASE(shapes), array_base<shapes>
{
687
    MIGRAPHX_HANDLE_CONSTRUCTOR(shapes);
Paul Fultz II's avatar
Paul Fultz II committed
688
689
690
691
692
693
694
695
696
697
698
699

    size_t size() const
    {
        size_t pout;
        call(&migraphx_shapes_size, &pout, this->get_handle_ptr());
        return pout;
    }

    shape operator[](size_t pidx) const
    {
        const_migraphx_shape_t pout;
        call(&migraphx_shapes_get, &pout, this->get_handle_ptr(), pidx);
700
        return {pout, this->share_handle()};
Paul Fultz II's avatar
Paul Fultz II committed
701
702
703
    }
};

704
705
struct operation : MIGRAPHX_HANDLE_BASE(operation)
{
706
    MIGRAPHX_HANDLE_CONSTRUCTOR(operation);
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723

    template <class... Ts>
    operation(const char* name, const char* attributes = nullptr, Ts... xs)
    {
        this->make_handle(&migraphx_operation_create, name, attributes, xs...);
    }

    std::string name()
    {
        std::array<char, 1024> out_name;
        call(&migraphx_operation_name, out_name.data(), 1024, this->get_handle_ptr());
        return {out_name.data()};
    }
};

struct instruction : MIGRAPHX_CONST_HANDLE_BASE(instruction)
{
724
    MIGRAPHX_HANDLE_CONSTRUCTOR(instruction);
725
726
727
728
};

struct instructions : MIGRAPHX_HANDLE_BASE(instructions)
{
729
    MIGRAPHX_HANDLE_CONSTRUCTOR(instructions);
730
731
732
733
734
735
736
737
738
739
740
741
742

    template <class... Ts>
    instructions(Ts... xs)
    {
        std::array<const_migraphx_instruction_t, sizeof...(Ts)> a{xs.get_handle_ptr()...};
        this->make_handle(&migraphx_instructions_create, a.data(), a.size());
    }
};

struct module;

struct modules : MIGRAPHX_HANDLE_BASE(modules)
{
743
    MIGRAPHX_HANDLE_CONSTRUCTOR(modules);
744
745
746
747

    template <class... Ts>
    modules(Ts... xs)
    {
748
        std::array<migraphx_module_t, sizeof...(Ts)> a = {xs.get_handle_ptr()...};
749
750
751
752
        this->make_handle(&migraphx_modules_create, a.data(), a.size());
    }
};

Shucai Xiao's avatar
Shucai Xiao committed
753
754
struct module
{
755
756
    MIGRAPHX_DEPRECATED("Constructor without lifetime annotation is deprecated.")
    module(migraphx_module* m) : mm(std::shared_ptr<migraphx_module*>(), m) {}
757

758
    module(migraphx_module* m, borrow) : mm(std::shared_ptr<migraphx_module*>(), m) {}
Shucai Xiao's avatar
Shucai Xiao committed
759

760
761
762
763
764
765
    template <class T>
    module(migraphx_module* m, share<T> b) : mm(b.alias(m))
    {
    }

    void print() const { call(&migraphx_module_print, mm.get()); }
766
767
768
769
770
771

    instruction add_instruction(const migraphx::operation& op, const migraphx::instructions& args)
    {
        migraphx_instruction_t op_ins;
        call(&migraphx_module_add_instruction,
             &op_ins,
772
             mm.get(),
773
774
775
776
777
778
779
780
781
782
783
784
             op.get_handle_ptr(),
             args.get_handle_ptr());
        return instruction(op_ins, own{});
    }

    instruction add_instruction(const migraphx::operation& op,
                                const migraphx::instructions& args,
                                const migraphx::modules& module_args)
    {
        migraphx_instruction_t op_ins;
        call(&migraphx_module_add_instruction_with_mod_args,
             &op_ins,
785
             mm.get(),
786
787
788
789
790
791
             op.get_handle_ptr(),
             args.get_handle_ptr(),
             module_args.get_handle_ptr());
        return instruction(op_ins, own{});
    }

792
793
794
795
796
797
798
799
800
    template <typename T>
    instruction add_literal(const migraphx::shape& s, T* buffer)
    {
        migraphx_instruction_t literal_ins;
        const auto* buffer_ptr = reinterpret_cast<const char*>(buffer);
        call(&migraphx_module_add_literal, &literal_ins, mm.get(), s.get_handle_ptr(), buffer_ptr);
        return instruction(literal_ins, own{});
    }

801
802
803
    instruction add_parameter(const std::string& name, shape s)
    {
        migraphx_instruction_t param_ins;
804
805
        call(
            &migraphx_module_add_parameter, &param_ins, mm.get(), name.c_str(), s.get_handle_ptr());
806
807
808
809
810
811
        return instruction(param_ins, own{});
    }

    instruction add_return(const migraphx::instructions& args)
    {
        migraphx_instruction_t ret_ins;
812
        call(&migraphx_module_add_return, &ret_ins, mm.get(), args.get_handle_ptr());
813
814
        return instruction(ret_ins, own{});
    }
815

816
817
818
819
820
821
822
    instruction add_allocation(const migraphx::shape& s)
    {
        migraphx_instruction_t ret_ins;
        call(&migraphx_module_add_allocation, &ret_ins, mm.get(), s.get_handle_ptr());
        return instruction(ret_ins, own{});
    }

823
824
825
826
    migraphx_module_t get_handle_ptr() const { return mm.get(); }

    private:
    std::shared_ptr<migraphx_module> mm;
Shucai Xiao's avatar
Shucai Xiao committed
827
828
};

829
struct context : handle_lookup<context, migraphx_context>
kahmed10's avatar
kahmed10 committed
830
{
831
    context(migraphx_context* p, borrow) : ctx(std::shared_ptr<migraphx_context*>(), p) {}
kahmed10's avatar
kahmed10 committed
832

833
834
835
836
837
838
    template <class T>
    context(migraphx_context* p, share<T> b) : ctx(b.alias(p))
    {
    }

    void finish() const { call(&migraphx_context_finish, ctx.get()); }
839
840
841
842
843

    template <class T>
    T get_queue()
    {
        void* out;
844
        call(&migraphx_context_get_queue, &out, ctx.get());
845
846
847
        // TODO: check type here
        return reinterpret_cast<T>(out);
    }
848
849
850

    private:
    std::shared_ptr<migraphx_context> ctx;
kahmed10's avatar
kahmed10 committed
851
852
};

853
854
855
856
struct compile_options : MIGRAPHX_HANDLE_BASE(compile_options)
{
    compile_options() { this->make_handle(&migraphx_compile_options_create); }

857
    MIGRAPHX_HANDLE_CONSTRUCTOR(compile_options);
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875

    /// For targets with offloaded memory(such as the gpu), this will insert
    /// instructions during compilation to copy the input parameters to the
    /// offloaded memory and to copy the final result from the offloaded
    /// memory back to main memory.
    void set_offload_copy(bool value = true)
    {
        call(&migraphx_compile_options_set_offload_copy, this->get_handle_ptr(), value);
    }

    /// Optimize math functions to use faster approximate versions. There may
    /// be slight accuracy degredation when enabled.
    void set_fast_math(bool value = true)
    {
        call(&migraphx_compile_options_set_fast_math, this->get_handle_ptr(), value);
    }
};

876
/// A program represents the all computation graphs to be compiled and executed
Paul Fultz II's avatar
Paul Fultz II committed
877
878
struct program : MIGRAPHX_HANDLE_BASE(program)
{
879
    program() { this->make_handle(&migraphx_program_create); }
Paul Fultz II's avatar
Paul Fultz II committed
880

881
    MIGRAPHX_HANDLE_CONSTRUCTOR(program);
Paul Fultz II's avatar
Paul Fultz II committed
882

883
    /// Compile the program for a specific target to be ran on
884
    void compile(const target& ptarget, const compile_options& poptions) const
Paul Fultz II's avatar
Paul Fultz II committed
885
    {
886
887
888
889
        call(&migraphx_program_compile,
             this->get_handle_ptr(),
             ptarget.get_handle_ptr(),
             poptions.get_handle_ptr());
Paul Fultz II's avatar
Paul Fultz II committed
890
891
    }

892
    /// Compile the program for a specific target to be ran on
Paul Fultz II's avatar
Paul Fultz II committed
893
894
    void compile(const target& ptarget) const
    {
895
896
897
898
        call(&migraphx_program_compile,
             this->get_handle_ptr(),
             ptarget.get_handle_ptr(),
             migraphx::compile_options{}.get_handle_ptr());
Paul Fultz II's avatar
Paul Fultz II committed
899
900
    }

901
    /// Return the shapes for the input parameters
Paul Fultz II's avatar
Paul Fultz II committed
902
903
904
905
906
907
908
    program_parameter_shapes get_parameter_shapes() const
    {
        migraphx_program_parameter_shapes_t pout;
        call(&migraphx_program_get_parameter_shapes, &pout, this->get_handle_ptr());
        return program_parameter_shapes(pout, own{});
    }

909
    /// Get the shapes of all the outputs returned by this program
Paul Fultz II's avatar
Paul Fultz II committed
910
911
912
913
914
915
916
    shapes get_output_shapes() const
    {
        migraphx_shapes_t pout;
        call(&migraphx_program_get_output_shapes, &pout, this->get_handle_ptr());
        return shapes(pout, own{});
    }

917
    /// Run the program using the inputs passed in
Paul Fultz II's avatar
Paul Fultz II committed
918
919
920
921
922
923
924
925
926
    arguments eval(const program_parameters& pparams) const
    {
        migraphx_arguments_t pout;
        call(&migraphx_program_run, &pout, this->get_handle_ptr(), pparams.get_handle_ptr());
        return arguments(pout, own{});
    }

    void print() const { call(&migraphx_program_print, this->get_handle_ptr()); }

927
928
929
930
931
932
    program sort()
    {
        call(&migraphx_program_sort, this->get_handle_ptr());
        return *this;
    }

Paul Fultz II's avatar
Paul Fultz II committed
933
934
935
936
937
938
939
    friend bool operator==(const program& px, const program& py)
    {
        bool pout;
        call(&migraphx_program_equal, &pout, px.get_handle_ptr(), py.get_handle_ptr());
        return pout;
    }

Shucai Xiao's avatar
Shucai Xiao committed
940
941
942
943
    module get_main_module()
    {
        migraphx_module_t p_modu;
        call(&migraphx_program_get_main_module, &p_modu, this->get_handle_ptr());
944
        return module{p_modu, this->share_handle()};
Shucai Xiao's avatar
Shucai Xiao committed
945
946
    }

947
    context experimental_get_context()
kahmed10's avatar
kahmed10 committed
948
949
    {
        migraphx_context_t ctx;
950
        call(&migraphx_program_experimental_get_context, &ctx, this->get_handle_ptr());
951
        return context{ctx, this->share_handle()};
kahmed10's avatar
kahmed10 committed
952
953
    }

954
    module create_module(const std::string& name)
955
    {
956
957
        migraphx_module_t p_modu;
        call(&migraphx_program_create_module, &p_modu, this->get_handle_ptr(), name.data());
958
        return module{p_modu, this->share_handle()};
959
960
    }

961
    friend bool operator!=(const program& px, const program& py) { return !(px == py); }
962
963
};

964
965
966
// options for migraphx file format options
struct file_options : MIGRAPHX_HANDLE_BASE(file_options)
{
967
    MIGRAPHX_HANDLE_CONSTRUCTOR(file_options);
968
969
970
971
972
973
974
975
976
    file_options() { this->make_handle(&migraphx_file_options_create); }

    // set file format
    void set_file_format(const char* format)
    {
        call(&migraphx_file_options_set_file_format, this->get_handle_ptr(), format);
    }
};

977
/// Load a saved migraphx program from a file
978
inline program load(const char* filename, const file_options& options)
979
{
980
981
    return program(make<migraphx_program>(&migraphx_load, filename, options.get_handle_ptr()),
                   own{});
982
983
}

984
/// Load a saved migraphx program from a file
985
986
inline program load(const char* filename)
{
987
988
989
    return program(
        make<migraphx_program>(&migraphx_load, filename, migraphx::file_options{}.get_handle_ptr()),
        own{});
990
991
}

992
/// Save a program to a file
993
inline void save(const program& p, const char* filename, const file_options& options)
994
{
995
    call(&migraphx_save, p.get_handle_ptr(), filename, options.get_handle_ptr());
996
997
}

998
/// Save a program to a file
999
1000
inline void save(const program& p, const char* filename)
{
1001
    call(&migraphx_save, p.get_handle_ptr(), filename, migraphx::file_options{}.get_handle_ptr());
1002
1003
}

1004
/// Options for parsing onnx options
1005
struct onnx_options : MIGRAPHX_HANDLE_BASE(onnx_options)
Paul Fultz II's avatar
Paul Fultz II committed
1006
{
1007
1008
    onnx_options() { this->make_handle(&migraphx_onnx_options_create); }

1009
    MIGRAPHX_HANDLE_CONSTRUCTOR(onnx_options);
1010

1011
    /// Make onnx parser treat an inputs with a certain dimensions
1012
1013
1014
1015
1016
1017
1018
1019
1020
    void set_input_parameter_shape(const std::string& name, std::vector<std::size_t> dim)
    {
        call(&migraphx_onnx_options_set_input_parameter_shape,
             this->get_handle_ptr(),
             name.c_str(),
             dim.data(),
             dim.size());
    }

kahmed10's avatar
kahmed10 committed
1021
    /// When there is a dimension parameter, then use this default value
1022
1023
1024
1025
    void set_default_dim_value(unsigned int value)
    {
        call(&migraphx_onnx_options_set_default_dim_value, this->get_handle_ptr(), value);
    }
Shucai Xiao's avatar
Shucai Xiao committed
1026
1027
1028
1029
1030
1031

    /// Set default max iteration number for the loop operator
    void set_default_loop_iterations(int64_t value)
    {
        call(&migraphx_onnx_options_set_default_loop_iterations, this->get_handle_ptr(), value);
    }
1032
1033
};

1034
/// Parse an onnx file into a migraphx program
1035
1036
1037
1038
inline program parse_onnx(const char* filename, const migraphx::onnx_options& options)
{
    return program(make<migraphx_program>(&migraphx_parse_onnx, filename, options.get_handle_ptr()),
                   own{});
Paul Fultz II's avatar
Paul Fultz II committed
1039
1040
}

1041
/// Parse an onnx file into a migraphx program
Paul Fultz II's avatar
Paul Fultz II committed
1042
1043
inline program parse_onnx(const char* filename)
{
1044
1045
1046
    migraphx::onnx_options options;
    return program(make<migraphx_program>(&migraphx_parse_onnx, filename, options.get_handle_ptr()),
                   own{});
Paul Fultz II's avatar
Paul Fultz II committed
1047
1048
}

1049
/// Parse a buffer of memory as an onnx file
1050
1051
inline program
parse_onnx_buffer(const void* data, size_t size, const migraphx::onnx_options& options)
Paul Fultz II's avatar
Paul Fultz II committed
1052
{
1053
1054
1055
    return program(
        make<migraphx_program>(&migraphx_parse_onnx_buffer, data, size, options.get_handle_ptr()),
        own{});
Paul Fultz II's avatar
Paul Fultz II committed
1056
1057
}

1058
/// Parse a buffer of memory as an onnx file
Paul Fultz II's avatar
Paul Fultz II committed
1059
1060
inline program parse_onnx_buffer(const void* data, size_t size)
{
1061
1062
1063
1064
    migraphx::onnx_options options;
    return program(
        make<migraphx_program>(&migraphx_parse_onnx_buffer, data, size, options.get_handle_ptr()),
        own{});
Paul Fultz II's avatar
Paul Fultz II committed
1065
1066
}

1067
/// Parse a buffer of memory as an onnx file
1068
inline program parse_onnx_buffer(const std::string& buffer, const migraphx::onnx_options& options)
Paul Fultz II's avatar
Paul Fultz II committed
1069
1070
{
    return program(
1071
1072
        make<migraphx_program>(
            &migraphx_parse_onnx_buffer, buffer.data(), buffer.size(), options.get_handle_ptr()),
Paul Fultz II's avatar
Paul Fultz II committed
1073
1074
1075
        own{});
}

1076
/// Parse a buffer of memory as an onnx file
Paul Fultz II's avatar
Paul Fultz II committed
1077
1078
inline program parse_onnx_buffer(const std::string& buffer)
{
1079
    migraphx::onnx_options options;
Paul Fultz II's avatar
Paul Fultz II committed
1080
    return program(
1081
1082
        make<migraphx_program>(
            &migraphx_parse_onnx_buffer, buffer.data(), buffer.size(), options.get_handle_ptr()),
Paul Fultz II's avatar
Paul Fultz II committed
1083
1084
1085
        own{});
}

kahmed10's avatar
kahmed10 committed
1086
1087
1088
1089
1090
/// Options for parsing tf options
struct tf_options : MIGRAPHX_HANDLE_BASE(tf_options)
{
    tf_options() { this->make_handle(&migraphx_tf_options_create); }

1091
    MIGRAPHX_HANDLE_CONSTRUCTOR(tf_options);
kahmed10's avatar
kahmed10 committed
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139

    /// Make tf parser treat an inputs with a certain dimensions
    void set_input_parameter_shape(const std::string& name, std::vector<std::size_t> dim)
    {
        call(&migraphx_tf_options_set_input_parameter_shape,
             this->get_handle_ptr(),
             name.c_str(),
             dim.data(),
             dim.size());
    }

    /// Change data layout to NHWC (default is NCHW)
    void set_nhwc(bool is_nhwc = true)
    {
        call(&migraphx_tf_options_set_nhwc, this->get_handle_ptr(), is_nhwc);
    }

    /// When there is a dimension parameter, then use this default value
    void set_default_dim_value(unsigned int value)
    {
        call(&migraphx_tf_options_set_default_dim_value, this->get_handle_ptr(), value);
    }

    /// Set output node names to return specific outputs from graph
    void set_output_names(std::vector<const char*> names)
    {
        call(&migraphx_tf_options_set_output_names,
             this->get_handle_ptr(),
             names.data(),
             names.size());
    }
};

/// Parse a tf file into a migraphx program
inline program parse_tf(const char* filename, const migraphx::tf_options& options)
{
    return program(make<migraphx_program>(&migraphx_parse_tf, filename, options.get_handle_ptr()),
                   own{});
}

/// Parse a tf file into a migraphx program
inline program parse_tf(const char* filename)
{
    migraphx::tf_options options;
    return program(make<migraphx_program>(&migraphx_parse_tf, filename, options.get_handle_ptr()),
                   own{});
}

Shucai Xiao's avatar
Shucai Xiao committed
1140
1141
1142
1143
struct quantize_op_names : MIGRAPHX_HANDLE_BASE(quantize_op_names)
{
    quantize_op_names() { this->make_handle(&migraphx_quantize_op_names_create); }

1144
    MIGRAPHX_HANDLE_CONSTRUCTOR(quantize_op_names);
Shucai Xiao's avatar
Shucai Xiao committed
1145
1146
1147
1148
1149
1150
1151

    void add(const std::string& name)
    {
        call(&migraphx_quantize_op_names_add, this->get_handle_ptr(), name.c_str());
    }
};

1152
/// Quantize program to use fp16
Shucai Xiao's avatar
Shucai Xiao committed
1153
1154
1155
1156
1157
inline void quantize_fp16(const program& prog, const quantize_op_names& names)
{
    call(&migraphx_quantize_fp16_with_op_names, prog.get_handle_ptr(), names.get_handle_ptr());
}

1158
/// Quantize program to use fp16
Shucai Xiao's avatar
Shucai Xiao committed
1159
1160
1161
1162
1163
inline void quantize_fp16(const program& prog)
{
    call(&migraphx_quantize_fp16, prog.get_handle_ptr());
}

1164
/// Options to be passed when quantizing for int8
Shucai Xiao's avatar
Shucai Xiao committed
1165
1166
1167
1168
struct quantize_int8_options : MIGRAPHX_HANDLE_BASE(quantize_int8_options)
{
    quantize_int8_options() { this->make_handle(&migraphx_quantize_int8_options_create); }

1169
    MIGRAPHX_HANDLE_CONSTRUCTOR(quantize_int8_options);
Shucai Xiao's avatar
Shucai Xiao committed
1170

1171
    /// Add an operator that should be quantized
Shucai Xiao's avatar
Shucai Xiao committed
1172
1173
1174
1175
1176
    void add_op_name(const std::string& name)
    {
        call(&migraphx_quantize_int8_options_add_op_name, this->get_handle_ptr(), name.c_str());
    }

1177
    /// Add calibrartion data to be used for quantizing
Shucai Xiao's avatar
Shucai Xiao committed
1178
1179
1180
1181
1182
1183
1184
1185
    void add_calibration_data(const program_parameters& pp)
    {
        call(&migraphx_quantize_int8_options_add_calibration_data,
             this->get_handle_ptr(),
             pp.get_handle_ptr());
    }
};

1186
/// Quantize program to use int8
Shucai Xiao's avatar
Shucai Xiao committed
1187
1188
1189
1190
1191
1192
1193
1194
1195
inline void
quantize_int8(const program& prog, const target& ptarget, const quantize_int8_options& options)
{
    call(&migraphx_quantize_int8,
         prog.get_handle_ptr(),
         ptarget.get_handle_ptr(),
         options.get_handle_ptr());
}

1196
1197
struct experimental_custom_op_base
{
1198
1199
1200
1201
    virtual std::string name() const                                            = 0;
    virtual argument compute(context ctx, shape output, arguments inputs) const = 0;
    virtual shape compute_shape(shapes inputs) const                            = 0;
    virtual ~experimental_custom_op_base()                                      = default;
1202
1203
1204
1205
1206
1207
1208
1209
1210
};

struct experimental_custom_op : interface_base<MIGRAPHX_HANDLE_BASE(experimental_custom_op)>
{
    template <class T>
    experimental_custom_op(T& obj)
    {
        this->make_interface(&migraphx_experimental_custom_op_create, obj, obj.name().c_str());
        MIGRAPHX_INTERFACE_LIFT(T, experimental_custom_op, compute_shape);
1211
        MIGRAPHX_INTERFACE_LIFT(T, experimental_custom_op, compute);
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
    }

    void register_op() { call(&migraphx_experimental_custom_op_register, this->get_handle_ptr()); }
};

template <class T, class = require_interface<experimental_custom_op_base, T>>
void register_experimental_custom_op(T& obj)
{
    experimental_custom_op op{obj};
    op.register_op();
}

1224
#ifndef DOXYGEN
Paul Fultz II's avatar
Paul Fultz II committed
1225
} // namespace api
1226
#endif
Paul Fultz II's avatar
Paul Fultz II committed
1227
1228
1229
} // namespace migraphx

#endif