lib.linux-x86_64-cpython-310/tensorrt_llm/runtime/session.py

# SPDX-FileCopyrightText: Copyright (c) 2022-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from __future__ import annotations

import contextlib
from dataclasses import dataclass
from typing import Any, Dict, List, Optional

# isort: off
import torch
import tensorrt as trt
# isort: on

from .._utils import torch_dtype_to_trt, trt_dtype_to_torch, trt_gte_10
from ..logger import logger


@contextlib.contextmanager
def _scoped_stream():
    '''Create a scoped cuda stream, and synchronize it when the context is destroyed
    '''
    #TODO: delete torch, use cuda native python bindings
    import torch
    stream = torch.cuda.current_stream()
    try:
        # return a handle, trt and other lib does not recognize torch.cuda.Stream
        yield stream.cuda_stream
    finally:
        stream.synchronize()


@dataclass
class TensorInfo:
    name: str
    dtype: trt.DataType
    shape: tuple
    # add more info like strides, formats if needed


class Session(object):
    ''' Session is a managed TensorRT runtime.  '''

    def __init__(self, **kwargs):
        # use Session.from_serialized_engine to create a session
        pass

    def _init(self, engine_buffer=None):
        '''
        @brief: Setup TensorRT engines and context from a serialized engine file
        @param engine_buffer: a buffer holds the serialized TRT engine
        '''
        self._runtime = trt.Runtime(logger.trt_logger)
        if engine_buffer is not None:
            self._engine = self.runtime.deserialize_cuda_engine(engine_buffer)

        self._context = None
        if not (trt_gte_10() and self.engine.streamable_weights_size):
            self.__prepare_execution_contexts()
        return self

    def __prepare_execution_contexts(self):
        self._context = self.engine.create_execution_context()
        assert self._context is not None, "Failed to create an execution context!"
        with _scoped_stream() as stream:
            self._context.set_optimization_profile_async(0, stream)

    @staticmethod
    def from_serialized_engine(engine) -> Session:
        '''
        @brief: Create a session from a serialized engine
        @param engine: a serialized engine
        @return: a Session object
        '''
        session = Session()
        return session._init(engine)

    @staticmethod
    def from_engine(engine) -> Session:
        '''
        @brief: Create a session from an existing ICudaEngine engine
        @param engine: an ICudaEngine
        @return: a Session object
        '''
        session = Session()
        session.engine = engine
        return session._init()

    @property
    def runtime(self) -> trt.Runtime:
        return self._runtime

    @property
    def engine(self) -> trt.ICudaEngine:
        return self._engine

    @engine.setter
    def engine(self, engine: trt.ICudaEngine):
        self._engine = engine

    @property
    def context(self) -> trt.IExecutionContext:
        '''
        @brief: Get the default TensorRT execution context,
            use self.engine.create_execution_context() to create a new context if needed
        @return: one TensorRT execution context object
        '''
        return self._context

    @property
    def context_mem_size(self) -> int:
        return self.engine.device_memory_size

    def _print_engine_info(self):
        '''print engine info for debug purpose, internal use only.
        '''
        refittable = self.engine.refittable
        num_layers = self.engine.num_layers
        device_memory_size = self.engine.device_memory_size
        name = self.engine.name
        nb_profiles = self.engine.num_optimization_profiles
        logger.info(
            f"Engine:{name=:}, {refittable=:}, {num_layers=:}, {device_memory_size=:}, {nb_profiles=:}"
        )
        self._print_io_info()

    def _print_io_info(self):
        '''print engine i/o info for debug purpose, internal use only.
        '''

        for i in range(self.engine.num_io_tensors):
            name = self.engine.get_tensor_name(i)
            mode = self.engine.get_tensor_mode(name)
            shape = self.engine.get_tensor_shape(name)
            dtype = self.engine.get_tensor_dtype(name)
            tformat = ";".join([
                self.engine.get_tensor_format_desc(name, p)
                for p in range(self.engine.num_optimization_profiles)
            ])
            logger.info(
                f"Tensor:{name=:}, {mode=:}, {shape=:}, {dtype=:}, {tformat=:}")

    def set_shapes(self,
                   tensor_dict: Dict[str, torch.Tensor],
                   context: Optional[trt.IExecutionContext] = None):
        if context is None:
            context = self.context

        for i in range(self.engine.num_io_tensors):
            name = self.engine.get_tensor_name(i)
            if self.engine.get_tensor_mode(name) == trt.TensorIOMode.INPUT:
                ok = context.set_input_shape(name, tensor_dict[name].shape)
                logger.debug(
                    f"setting input tensor {name} with shape {tensor_dict[name].shape}"
                )
                if not ok:
                    raise ValueError(
                        f"Couldn't assign {name} with shape {tensor_dict[name].shape}, "
                        f"engine supports [min, opt, max] = {self.engine.get_tensor_profile_shape(name, context.active_optimization_profile)}"
                    )

    def infer_shapes(
            self,
            inputs: List[TensorInfo],
            context: Optional[trt.IExecutionContext] = None
    ) -> List[TensorInfo]:
        '''
        @brief: Set input shapes to given context, and infer the output shapes from the given input shapes.
               This function should be called every time when the input shapes are changed before calling run().
               Or call the context.set_input_shape on all dynamic shaped input tensors manually.
        @param inputs: list of TensorInfo object, each item represents an input tensor
        @param context: TensorRT execution context, if None, use the default context
        @return: list of TensorInfo object, each item represents an output tensor, returns None if failed
        '''
        # set shape to the default context if context is not specified
        if context is None:
            context = self.context
        for i in inputs:
            if self.engine.get_tensor_mode(i.name) != trt.TensorIOMode.INPUT:
                raise ValueError(f"Tensor:{i.name} is not an input tensor")
            if self.engine.get_tensor_dtype(i.name) != i.dtype:
                raise ValueError(f"Tensor:{i.name} has wrong dtype")
            if not context.set_input_shape(i.name, i.shape):
                raise RuntimeError(
                    f"Could not set shape {i.shape} for tensor {i.name}. Please check the profile range for which your model was build."
                )

        outputs = []
        for i in range(self.engine.num_io_tensors):
            name = self.engine.get_tensor_name(i)
            if self.engine.get_tensor_mode(name) == trt.TensorIOMode.OUTPUT:
                shape = context.get_tensor_shape(name)
                dtype = self.engine.get_tensor_dtype(name)
                outputs.append(TensorInfo(name, dtype, shape))
        return outputs

    def _set_weight_streaming(self, gpu_weights_percent):
        assert self.engine is not None

        self._context = None

        if not trt_gte_10():
            assert gpu_weights_percent == 1, "Weight streaming is only supported by TensorRT 10.0 or later."
            return
        else:
            min = self.engine.minimum_weight_streaming_budget
            max = self.engine.streamable_weights_size
            budget = int(min + gpu_weights_percent * (max - min))

            budget_config = budget if gpu_weights_percent != 1 else 0
            self.engine.weight_streaming_budget = budget_config
            assert self.engine.weight_streaming_budget == budget_config, "Failed to set weight streaming budget!"
            logger.info(
                f"Set gpu weights percent to {gpu_weights_percent}, which is {budget} bytes. Valid range: {min} bytes ~ {max} bytes."
            )

        if self.engine.streamable_weights_size:
            try:
                self.__prepare_execution_contexts()
            except:
                free_mem = torch.cuda.mem_get_info()[0]
                if free_mem < budget:
                    raise torch.cuda.OutOfMemoryError(
                        f"Out of Memory: Memory budget is {budget} bytes but only {free_mem} bytes are available on the GPU."
                    )
                raise

    def run(self,
            inputs: Dict[str, Any],
            outputs: Dict[str, Any],
            stream,
            context=None) -> bool:
        '''
        @brief: Run the TensorRT engine with the given inputs and outputs
        @param inputs: dict of input tensors, key is tensor name, value is tensor pointer or torch tensor
        @param outputs: dict of output tensors, key is tensor name, value is tensor pointer or torch tensor
        @param stream: cuda stream to enqueue the TensorRT engine on
        @param context: TensorRT execution context, if None, use the default context
        @return: True if enqueue succeeded, note the enqueue is an async call,
            returning True does not mean the execution is finished
        '''
        # enqueue to the default context if context is not specified
        if context is None:
            context = self.context

        import torch
        for tensor_name in inputs:
            tensor = inputs[tensor_name]
            ptr = tensor.data_ptr() if isinstance(tensor,
                                                  torch.Tensor) else tensor
            context.set_tensor_address(tensor_name, ptr)
        for tensor_name in outputs:
            tensor = outputs[tensor_name]
            ptr = tensor.data_ptr() if isinstance(tensor,
                                                  torch.Tensor) else tensor
            context.set_tensor_address(tensor_name, ptr)
        ok = context.execute_async_v3(stream)
        return ok

    def _debug_run(self,
                   inputs: Dict[str, "torch.Tensor"],
                   context=None) -> Dict[str, "torch.Tensor"]:
        '''Run the engine enqueue with allocated output tensors, for debug purpose, since it is a sync call and slower than run
        '''
        import torch

        inputs_info = [
            TensorInfo(name, torch_dtype_to_trt(tensor.dtype), tensor.shape)
            for name, tensor in inputs.items()
        ]
        outputs_info = self.infer_shapes(inputs_info)
        outputs = {
            t.name: torch.empty(tuple(t.shape),
                                dtype=trt_dtype_to_torch(t.dtype),
                                device='cuda')
            for t in outputs_info
        }
        with _scoped_stream() as stream:
            self.run(inputs=inputs,
                     outputs=outputs,
                     stream=stream,
                     context=context)
        return outputs