iOS MachineLearning 系列(15)—— 可进行个性化更新的 CoreML 模型
上一篇文章,介绍了使用官方提供的 CoreML 模型来实现手写数字识别。其实,更多时候我们需要一个更加个性化的模型,对于手写图像来说,每个人的写法可能风格各异,如果可以在用户的使用过程中不断的更新模型,适应更加个性化的场景,就更完美了。幸运的是,CoreML 正提供了这样的功能。我们可以创建一个可更新的模型来实现个性化 Learning,同样,本文暂无设计模型的训练,我们通过官方的 UpdatableDrawingClassifier 模型来演示可更新模型的使用。
1 - 关于 UpdatableDrawingClassifier 模型
UpdatableDrawingClassifier 是 Apple 官方提供的一个训练好的并且支持更新迭代的手绘识别模型。其尺寸大小约为 394KB,从其大小也可以看出,其本身并没太多的识别能力,我们需要在 iOS 应用内对其进行更新,使其能够识别个性化的手绘事物。
此处可以下载到此模型:
https://developer.apple.com/machine-learning/models/
首先,我们可以在 Xcode 中观察下模型的概要信息:
相比之前使用的 MNIST 模型,其多了 Updates 一栏。我们主要关注 Predictions 和 Updates 栏目,其中 Predictions 说明了使用模型预测时的参数和返回数据,Updates 则说明了模型更新时的参数。如下图:
Predictions 输入参数为图片(需要黑色背景,白色前景),输入有数据有两个,一个是字符串类型的最佳预测结果,一个是字典类型的可能的预测结果。
Updates 输入参数为图片(需要黑色背景,白色前景),以及此图片对应的预测文本。
2 - UpdatableDrawingClassifier 使用示例
以前面文章的手写数字为例,之前使用此模型进行预测,会发现其并不能识别出数字。下面我们尝试让其对此图像进行 Learning。
首先定义两个模型操作类实例,分别用来承载原模型与更新后的模型:
// 更新后的模型var updatedDrawingClassifier: UpdatableDrawingClassifier?// 原模型var baseDrawingClassifier: UpdatableDrawingClassifier?
复制代码
其中 UpdatableDrawingClassifier 类是 Xcode 自动生成的,此类文件前一篇文章有过详细的介绍,这里不再赘述。
我们首先使用原始的模型对图像进行预测,如下:
baseDrawingClassifier = try! UpdatableDrawingClassifier(configuration: MLModelConfiguration())
// 未更新前的模型进行测试let output = try! baseDrawingClassifier.prediction(input: UpdatableDrawingClassifierInput(drawingWith: UIImage(named: "3")!.cgImage!))print("未更新前的预测:'\(output.label)'")
label.text = label.text!.appending("模型未更新前的预测结果:\(output.label)\n")
复制代码
不出意外,你将得到“unknow”的结果。
下面我们让模型以此图像作为输入进行 Learning,先定义一些要使用到的路径 URL:
// 原模型路径let defaultModelURL = UpdatableDrawingClassifier.urlOfModelInThisBundle// 用户目录let appDirectory = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask).first!// 临时模型文件路径lazy var tempUpdatedModelURL = appDirectory.appendingPathComponent("personalized_tmp.mlmodelc")// 更新后的模型文件路径lazy var updatedModelURL = appDirectory.appendingPathComponent("personalized.mlmodelc")
复制代码
如下代码演示了对模型进行更新的过程:
// 定义预期的预测结果let outputValue = MLFeatureValue(string: "手写数字3")// 更新的输入参数名let inputName = "drawing" // 图片参数let labelName = "label" // 预测结果参数
// 获取模型的描述let description = baseDrawingClassifier.model.modelDescription// 获取输入参数的描述let imageInputDescription = description.inputDescriptionsByName[inputName]!// 获取图片约束字段let imageConstraint = imageInputDescription.imageConstraint!// 将图片封装成特征对象let imageFeatureValue = try! MLFeatureValue(cgImage: UIImage(named: "3")!.cgImage!, constraint: imageConstraint)// 组合预期结果与对应的特征对象let dataPointFeatures: [String: MLFeatureValue] = [inputName: imageFeatureValue, labelName: outputValue]// 定义特征Provider对象let provider = try! MLDictionaryFeatureProvider(dictionary: dataPointFeatures)
// 使用一组provider创建更新任务let updateTask = try? MLUpdateTask(forModelAt: defaultModelURL, trainingData: MLArrayBatchProvider(array: [provider]), configuration: nil, completionHandler: updateModelCompletionHandler)// 执行更新任务updateTask!.resume()
复制代码
需要注意,通常为了增加模型的预测能力,我们不会仅仅使用一组输入来进行更新,以手写数字为例,我们可以让用户多写几次同样的数字,再进行更新。代码中的 updateModelCompletionHandler 是更新的回调函数,实现如下:
func updateModelCompletionHandler(updateContext: MLUpdateContext) { saveUpdatedModel(updateContext) print("更新完成") // 重新预测 updatedDrawingClassifier = try! UpdatableDrawingClassifier(contentsOf: updatedModelURL) let output = try! updatedDrawingClassifier.prediction(input: UpdatableDrawingClassifierInput(drawingWith: UIImage(named: "3")!.cgImage!)) print("更新后的预测:'\(output.label)'") DispatchQueue.main.async { self.label.text = self.label.text!.appending("新的预测结果:\(output.label)\n") }}
// 存储更新后的模型func saveUpdatedModel(_ updateContext: MLUpdateContext) { let updatedModel = updateContext.model let fileManager = FileManager.default do { // Create a directory for the updated model. try fileManager.createDirectory(at: tempUpdatedModelURL, withIntermediateDirectories: true, attributes: nil) try updatedModel.write(to: tempUpdatedModelURL) _ = try fileManager.replaceItemAt(updatedModelURL, withItemAt: tempUpdatedModelURL) } catch let error { return }}
复制代码
运行代码效果如下图所示,可以看到对同样的图片,新的模型已经可以正确识别了。
最后,我们再来总结下可更新模型的使用流程:
准备要更新的物料数据,包括模型的输入数据,以及预期的输出数据。(通常提供一组)
将输入与预期结果对应起来创建 MLDictionaryFeatureProvider 对象。
通过一组 MLDictionaryFeatureProvider 对象来创建 MLUpdateTask 更新任务对象。
执行更新任务,并在回调中存储更新后的模型。
使用新的模型进行预测。
完整的示例代码可以在如下地址找到:
https://github.com/ZYHshao/MachineLearnDemo
评论