modelbox.BufferList

构造方法

构造BufferList对象。

modelbox.BufferList()

args:

无

modelbox.BufferList(device)

args:

• device (modelbox.Device) —— 构造当前Buffer所在的modelbox.Device对象

modelbox.BufferList(buffer)

args:

• buffer (modelbox.Buffer) —— 通过Buffer构建BufferList

modelbox.BufferList(buffer_list)

args:

• buffer_list (list[modelbox.Buffer]) —— 通过一组Buffer构建BufferList

return:

modelbox.BufferList

example:

    ...
    def process(self, data_ctx):
        inputbuf_list = data_ctx.input("input")
        outputbuf_list = data_ctx.output("output")
        ...

        return modelbox.Status()

inputbuf_list和output_buf_list均为构建好的BufferList，一般而言并不需要开发者构建BufferList。

modelbox.BufferList.build

BufferList申请Buffer内存空间

args:

• sizes (list[int]) —— BufferList当中每一个Buffer的大小

return:

modelbox.Status 申请结果

example:

    ...
    def process(self, data_ctx):
        buf_list = data_ctx.output("output")
        res = buf_list.build([20, 20, 20])
        print(res, buf_list.size())
        for buf in buf_list:
            print(buf.get_bytes())
        ...

        return modelbox.Status()

result:

true, 3
20
20
20

modelbox.BufferList.copy_meta

把参数的BufferList里面的Meta信息拷贝给当前的BufferList，按照Buffer一对一拷贝。

args:

• buffer_list (modelbox.BufferList) —— 源BufferList

return:

modelbox.Status

example:

    ...
    def process(self, data_ctx):
        input_bufs = data_ctx.input("input")
        output_bufs = data_ctx.output("output")
        input_bytes = []
        for buf in input_bufs:
            input_bytes.append(buf.get_bytes())
        output_bufs.build(input_bytes)

        # output_bufs具有和原始input_bufs相同的Meta信息
        res = output_bufs.copy_meta(input_bufs)
        ...

        return modelbox.Status()

modelbox.BufferList.get_bytes

获取BufferList中的所有的字节数

args:

无

return:

uint64

example:

    ...
    def process(self, data_ctx):
        buf_list = data_ctx.output("output")
        buf_list.build([20,20,20])
        print(buf_list.get_bytes())
        ...

        return modelbox.Status()

result:

60

modelbox.BufferList.push_back

往BufferList当中插入一个新的Buffer。

args:

• buffer (modelbox.Buffer) —— 需要插入到BufferList当中的Buffer

return:

无

example:

   import numpy as np
   ...
   def process(self, data_ctx):
       buf_list = data_ctx.output("output")
       infer_data = np.ones((5,5))
       new_buffer = modelbox.Buffer(self.get_bind_device(), infer_data)
       buf_list.push_back(new_buffer)
       ...

       return modelbox.Status()

modelbox.BufferList.size

获取当前BufferList的长度

args:

无

return:

modelbox.Bufferlist的长度

example:

    ...
    def process(self, data_ctx):
        buf_list = data_ctx.output("output")
        buf_list.build([20,20,20])
        size = buf_list.size()
        length = len(buf_list)
        print(size)
        print(length)
        for buf in buf_list:
            print(buf.get_bytes())
        ...

        return modelbox.Status()

result:

3
3
20
20
20

modelbox.BufferList.set

设置当前BufferList的某个Meta值

args:

• key (str) —— Meta的key值

• obj (int, str, double, bool, modelbox.ModelBoxDataType, list[str], list[int], list[double], list[bool]) —— Meta的value值

return:

无

example:

    ...
    def process(self, data_ctx):
        buf_list = data_ctx.output("output")
        for i in range(3):
            infer_data = np.ones((5,5))
            new_buffer = modelbox.Buffer(self.get_bind_device(), infer_data)
            buf_list.push_back(new_buffer)

        res = buf_list.set("key", "test")
        print(res)
        for buf in buf_list:
            print(buf.get("key"))
        ...

        return modelbox.Status()

result:

true
test
test
test