ai.djl.translate

Interface Translator<I,O>

Type Parameters:

I - the input type

O - the output type

All Superinterfaces:

PostProcessor<O>, PreProcessor<I>

All Known Subinterfaces:

ServingTranslator

All Known Implementing Classes:

BaseImageTranslator, FileTranslator, ImageClassificationTranslator, InputStreamTranslator, InstanceSegmentationTranslator, NoopTranslator, ObjectDetectionTranslator, QATranslator, SimplePoseTranslator, SimpleText2TextTranslator, SingleShotDetectionTranslator, UrlTranslator, YoloTranslator, YoloV5Translator

public interface Translator<I,O>
extends PreProcessor<I>, PostProcessor<O>

The Translator interface provides model pre-processing and postprocessing functionality.

Users can use this in Predictor with input and output objects specified. The following is an example of processing an image and creating classification output:

 private static final class MyTranslator implements Translator<Image, Classification> {

     private int imageWidth;
     private int imageHeight;

     public MyTranslator(int imageWidth, int imageHeight) {
         this.imageWidth = imageWidth;
         this.imageHeight = imageHeight;
     }

     @Override
     public NDList processInput(TranslatorContext ctx, Image input) {
         NDArray imageND = input.toNDArray(ctx.getNDManager());
         return new NDList(NDImageUtils.resize(imageND, imageWidth, imageHeight);
     }

     @Override
     public Classification processOutput(TranslatorContext ctx, NDList list) throws TranslateException {
         Model model = ctx.getModel();
         NDArray array = list.get(0).at(0);
         NDArray sorted = array.argSort(-1, false);
         NDArray top = sorted.at(0);

         float[] probabilities = array.toFloatArray();
         int topIndex = top.toIntArray()[0];

         String[] synset;
         try {
             synset = model.getArtifact("synset.txt", MyTranslator::loadSynset);
         } catch (IOException e) {
             throw new TranslateException(e);
         }
         return new Classification(synset[topIndex], probabilities[topIndex]);
     }

     private static String[] loadSynset(InputStream is) {
         ...
     }
 }
 

Method Summary

Modifier and Type	Method and Description
Batchifier	getBatchifier() Gets the Batchifier.
default void	prepare(NDManager manager, Model model) Prepares the translator with the manager and model to use.

Methods inherited from interface ai.djl.translate.PreProcessor

getPipeline, processInput

Methods inherited from interface ai.djl.translate.PostProcessor

processOutput

Method Detail

getBatchifier

Batchifier getBatchifier()

Gets the Batchifier.

Returns:

the Batchifier

prepare

default void prepare(NDManager manager,
                     Model model)
              throws java.io.IOException

Prepares the translator with the manager and model to use.

Parameters:

manager - the manager for the translator

model - the model to translate for

Throws:

java.io.IOException - if there is an error reading inputs for preparing the translator