- iOS 11.0+
- Xcode 10.0+Beta
With the Core ML framework, you can use a trained machine learning model to classify input data. The Vision framework works with Core ML to apply classification models to images, and to preprocess those images to make machine learning tasks easier and more reliable.
This sample app uses the open source MobileNet model, one of several available classification models, to identify an image using 1000 classification categories as seen in the example screenshots below.
Preview the Sample App
To see this sample app in action, build and run the project, then use the buttons in the sample app’s toolbar to take a picture or choose an image from your photo library. The sample app then uses Vision to apply the Core ML model to the chosen image, and shows the resulting classification labels along with numbers indicating the confidence level of each classification. It displays the top two classifications in order of the confidence score the model assigns to each.
Set Up Vision with a Core ML Model
Core ML automatically generates a Swift class that provides easy access to your ML model; in this sample, Core ML automatically generates the
Mobile class from the
Mobile model. To set up a Vision request using the model, create an instance of that class and use its
model property to create a
VNCore object. Use the request object’s completion handler to specify a method to receive results from the model after you run the request.
An ML model processes input images in a fixed aspect ratio, but input images may have arbitrary aspect ratios, so Vision must scale or crop the image to fit. For best results, set the request’s
image property to match the image layout the model was trained with. For the available classification models, the
VNImage option is appropriate unless noted otherwise.
Run the Vision Request
VNImage object with the image to be processed, and pass the requests to that object’s
perform(_:) method. This method runs synchronously—use a background queue so that the main queue isn’t blocked while your requests execute.
Most models are trained on images that are already oriented correctly for display. To ensure proper handling of input images with arbitrary orientations, pass the image’s orientation to the image request handler. (This sample app adds an initializer,
init(_:), to the
CGImage type for converting from
UIImage orientation values.)