Importation d'un modèle basé sur TensorFlow GraphDef dans TensorFlow.js

Les modèles basés sur TensorFlow GraphDef (généralement créés via l'API Python) peuvent être enregistrés dans l'un des formats suivants :

1. TensorFlow SavedModel
2. Modèle congelé
3. Module de concentrateur Tensorflow

Tous les formats ci-dessus peuvent être convertis par le convertisseur TensorFlow.js dans un format qui peut être chargé directement dans TensorFlow.js pour l'inférence.

(Remarque : TensorFlow a abandonné le format de groupe de sessions, veuillez migrer vos modèles vers le format SavedModel.)

Conditions

La procédure de conversion nécessite un environnement Python ; vous voudrez peut-être en garder un isolé en utilisant pipenv ou virtualenv . Pour installer le convertisseur, exécutez la commande suivante :

 pip install tensorflowjs

L'importation d'un modèle TensorFlow dans TensorFlow.js est un processus en deux étapes. Tout d'abord, convertissez un modèle existant au format Web TensorFlow.js, puis chargez-le dans TensorFlow.js.

Étape 1. Convertir un modèle TensorFlow existant au format Web TensorFlow.js

Exécutez le script de conversion fourni par le package pip :

Utilisation : exemple SavedModel :

tensorflowjs_converter \
    --input_format=tf_saved_model \
    --output_node_names='MobilenetV1/Predictions/Reshape_1' \
    --saved_model_tags=serve \
    /mobilenet/saved_model \
    /mobilenet/web_model

Exemple de modèle gelé :

tensorflowjs_converter \
    --input_format=tf_frozen_model \
    --output_node_names='MobilenetV1/Predictions/Reshape_1' \
    /mobilenet/frozen_model.pb \
    /mobilenet/web_model

Exemple de module Tensorflow Hub :

tensorflowjs_converter \
    --input_format=tf_hub \
    'https://tfhub.dev/google/imagenet/mobilenet_v1_100_224/classification/1' \
    /mobilenet/web_model

Utilisez la commande suivante pour obtenir un message d'aide détaillé :

tensorflowjs_converter --help

Convertisseur de fichiers générés

Le script de conversion ci-dessus produit deux types de fichiers :

• model.json (le graphique de flux de données et le manifeste de pondération)
• group1-shard\*of\* (collection de fichiers de poids binaires)

Par exemple, voici le résultat de la conversion de MobileNet v2 :

  output_directory/model.json
  output_directory/group1-shard1of5
  ...
  output_directory/group1-shard5of5

Étape 2 : Chargement et exécution dans le navigateur

1. Installez le package npm tfjs-converter

yarn add @tensorflow/tfjs ou npm install @tensorflow/tfjs

1. Instanciez la classe FrozenModel et exécutez l'inférence.

import * as tf from '@tensorflow/tfjs';
import {loadGraphModel} from '@tensorflow/tfjs-converter';

const MODEL_URL = 'model_directory/model.json';

const model = await loadGraphModel(MODEL_URL);
const cat = document.getElementById('cat');
model.execute(tf.browser.fromPixels(cat));

Découvrez notre démo MobileNet .

L'API loadGraphModel accepte un paramètre LoadOptions supplémentaire, qui peut être utilisé pour envoyer des informations d'identification ou des en-têtes personnalisés avec la demande. Veuillez consulter la documentation loadGraphModel() pour plus de détails.

Opérations prises en charge

Actuellement, TensorFlow.js prend en charge un ensemble limité d'opérations TensorFlow. Si votre modèle utilise une opération non prise en charge, le script tensorflowjs_converter échouera et imprimera une liste des opérations non prises en charge dans votre modèle. Veuillez signaler un problème pour chaque opération afin de nous indiquer les opérations pour lesquelles vous avez besoin d'assistance.

Chargement des poids uniquement

Si vous préférez charger uniquement les pondérations, vous pouvez utiliser l'extrait de code suivant.

import * as tf from '@tensorflow/tfjs';

const weightManifestUrl = "https://example.org/model/weights_manifest.json";

const manifest = await fetch(weightManifestUrl);
this.weightManifest = await manifest.json();
const weightMap = await tf.io.loadWeights(
        this.weightManifest, "https://example.org/model");