1#!/usr/bin/env python
2# -*- coding: utf-8 -*-
3# *******************************************************************************
4#
5# Copyright (c) 2020 Baidu.com, Inc. All Rights Reserved
6#
7# *******************************************************************************
8import numpy as np
9
10ERROR_CODE_FAILED_DECODING_INPUT = 336005
11MESSAGE_FAILED_DECODING_INPUT = "Failed decoding input"
12ERROR_CODE_MISSING_REQUIRED_PARAMETER = 336006
13MESSAGE_MISSING_REQUIRED_PARAMETER = "Missing required parameter"
14
15
16class CustomException(RuntimeError):
17    """
18    进行模型验证和部署服务必需的异常类，缺少该类在代码验证时将会失败
19    在处理异常数据或者请求时，推荐在`PredictWrapper`中的自定义预处理preprocess和后处理postprocess函数中抛出`CustomException`类，
20    并为`message`指定准确可读的错误信息，以便在服务响应包中的`error_msg`参数中返回。
21    """
22    def __init__(self, error_code, message, orig_error=None):
23        """ init with error_code, message and origin exception """
24        super(CustomException, self).__init__(message)
25        self.error_code = error_code
26        self.orig_error = orig_error
27
28
29class PredictWrapper(object):
30    """ 模型服务预测封装类，支持用户自定义对服务请求数据的预处理和模型预测结果的后处理函数 """
31
32    def __init__(self, model_path, use_gpu, logger):
33        """
34        根据`model_path`初始化`PredictWrapper`类，如解析label_list.txt，加载模型输出标签id和标签名称的映射关系
35        :param model_path: 该目录下存放了用户选择的模型版本中包含的所有文件
36        """
37        # 加载模型
38        model_filename = model_path + '/model.pkl'
39        with open(model_filename, 'rb') as pk_fin:
40            import pickle
41            self._model = pickle.load(pk_fin)
42
43    def preprocess(self, request_body):
44        """
45        自定义对请求体的预处理，针对图像类模型服务，包括对图片对图像的解析、转化等
46        :param request_body: 请求体的json字典
47        :return:
48            data: 用于模型预测的输入。
49            infer_args: 用于模型预测的其他参数
50            request_context: 透传给自定义后处理函数`postprocess`的参数，例如指定返回预测结果的top N，过滤低score的阈值threshold.
51        """
52        try:
53            features = request_body['features']
54            features_np = np.array(features)
55        except KeyError:
56            raise CustomException(error_code=ERROR_CODE_MISSING_REQUIRED_PARAMETER,
57                                  message=MESSAGE_FAILED_DECODING_INPUT)
58        except Exception as e:
59            raise CustomException(error_code=ERROR_CODE_FAILED_DECODING_INPUT,
60                                  message=MESSAGE_FAILED_DECODING_INPUT, orig_error=e)
61        return features_np, {}, {}
62
63    def predict(self, data, infer_args):
64        """
65        模型预测
66        :param data: 预处理后的数据
67        :param infer_args: 预处理返回的`infer_args`
68        :return: infer_result 预测结果
69        """
70        return self._model.predict(data, **infer_args)
71
72    def postprocess(self, infer_result, request_context):
73        """
74        对ml模型预测结果进行后处理
75        :param infer_result: ML模型的预测结果
76        :param request_context: 自定义预处理函数中返回的`request context`
77        :return: request results 请求的处理结果
78        """
79        if not isinstance(infer_result, np.ndarray):
80            infer_result = np.array(infer_result)
81        return {'categories': infer_result.tolist()}