Icon for the Image Recognition Tool

Image Recognition

Last modified: September 01, 2021

Use Image Recognition to build a machine learning model that can classify images by group. You can use your own data and labels to train a new model, or you can use one of the pre-trained models we provide.

Tool Components

Image Recognition has 3 anchors:

  • anchor: Use this anchor to input the data you want to use for training.
  • anchor: Use this anchor to input the data you want to use for validation.
  • anchor: Use this anchor to pass the model you've built downstream. 

The images you pass into Image Recognition must be in BLOB file format.

Configure the Tool

To use this tool...

  1. Drag the tool onto the canvas.
  2. Input your Training Images by specifying the Image Field and Image Labels
  3. Input your Validation Images by specifying the Image Field and Image Labels.
  4. Run the workflow.



An epoch is a single pass (forward and backward) of all data in a training set through a neural network. Epochs are related to iterations, but not the same. An iteration is a single pass of all data in a batch of a training set.

Increasing the number of epochs allows the model to learn from the training set for a longer time. But doing that also increases the computational expense.

You can increase the number of epochs to help reduce error in the model. But at some point, the amount of error reduction might not be worth the added computational expense. Also, increasing the number of epochs too much can cause problems of overfitting, while not using enough epochs can cause problems of underfitting.

Pre-trained Model

Pre-trained models are models that contain feature-extraction methods with parameters that are already defined. Models with more parameters tend to be more accurate, but slower and computationally expensive. The opposite is true for models with fewer parameters; they tend to be less accurate, but faster and computationally cheap.

Here are simplified explanations of the pre-trained models included in the tool. Keep in mind that the performance of these models drastically depends on your data, so the summaries won't always be true.

  • VGG16 tends to be the most accurate, slowest, and most computationally expensive.
  • InceptionResNetV2 tends to balance accuracy, speed, and computational expense, with some bias toward accuracy.
  • Resnet50V2 tends to balance of accuracy, speed, and computational expense, with some bias toward speed and less computational expense.
  • InceptionV3 tends to be the least accurate (but still quite accurate), fastest, and least computationally expensive.

Each of those models was trained on a dataset that contained over 14 million images with more than 20,000 labels.

Choosing a pre-trained model allows you to skip training an entire neural network using your own images. When you choose to use a pre-trained model, you're effectively assuming that your input parameters match what the pre-trained model expects, so you don't need to rebuild a model that does about the same thing as the pre-trained one (and might even perform worse). Because many of the features from images tend to be the same as the ones the models have used during training, often you can safely assume that a pre-trained model will work with your input.

Use a pre-trained model when you have images with features that match what the pre-trained model expects and want to avoid training your own model.

Batch Size

A batch is a subset of the entire training dataset.

Decreasing the batch size allows you to stagger how much data passes through a neural network at any given time. Doing that allows you to train models without taking up as much memory as you would if passing all data through a neural network at once. Sometimes batching can speed up training. But breaking your data into batches might also increase error in the model.

Separate your data into batches when your machine is unable to process all the data at once, or if you want to reduce training time.


If you enable multiprocessing, you can use more threads on your machine while training a model.

Enabling multiprocessing can decrease the time to train the model.

Consider using multiprocessing when your machine has multiple threads and you want to decrease model training time. You can specify the number of workers you want to use for multiprocessing. The number of workers can't exceed the number of threads your machine has.

Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.