Tracer.Io.to_image

Lorsque vous travaillez avec les graphiques de Plotly, vous rencontrerez une instance où vous devez exporter le tracé dans un fichier image. Bien que vous puissiez plonger dans des outils externes pour exporter l'image, Plotly a une fonctionnalité intégrée pour y parvenir.

Grâce à ce tutoriel, vous apprendrez à utiliser l'intrigue.Io.TO_IMAGE () Fonction Pour enregistrer une figure en tant qu'image.

Tracer.Io.to_image ()

L'intrigue.Io.La fonction TO_IMAGE () vous permet de convertir un tracé spécifique figure en une image statique.

La syntaxe de fonction est comme indiqué:

tracer.Io.to_image (Fig, format = aucun, largeur = aucun, hauteur = aucun, échelle = aucun, valider = true, moteur = 'auto')

La fonction accepte les paramètres comme indiqué:

1. figue - représente la figure à convertir en une image statique.
2. format - Ce paramètre définit le format d'image cible. Les valeurs prises en charge incluent: «PNG», «JPG», «JPEG», «SVG», «webp», «EPS» et «PDF."
3. largeur - Spécifie les dimensions de largeur de l'image exportée. Cette valeur est fournie en pixels.
4. hauteur - définit la dimension de hauteur de l'image en pixels.
5. escalader - représente le facteur d'échelle lors de l'exportation de la figure spécifique.
6. validé - Spécifie si l'image doit être validée avant de se convertir en image. Par défaut, cette valeur est définie sur true.
7. moteur - Utilisé pour définir le moteur d'exportation d'image. Les moteurs pris en charge comprennent: «Kaleido», «Orca» et «Auto."

La fonction renvoie les données d'image en octets.

Exemple 1

L'exemple de code suivant montre comment exporter une figure simple dans une image statique en utilisant le TO_IMAGE.

Importer un terrain.Exprime comme PX
Importer Numpy comme NP
x = np.aléatoire.Randn (50)
y = np.aléatoire.Randn (50)
Fig = px.disperser (x = x, y = y)
figue.montrer()

Dans le code ci-dessus, nous utilisons le module Plotly Express pour créer un graphique de diffusion simple avec des données aléatoires de la fonction Randn Numpy.

La figure résultante:

Pour exporter ce chiffre, nous pouvons exécuter le code comme:

importer parce que PLT
PLT.Io.to_image (fig, format = 'png')

Le code ci-dessus doit renvoyer les données des octets de l'image comme indiqué:

b '\ x89png \ r \ n \ x1a \ n \ x00 \ x00 \ x00 \ rihdr \ x00 \ x00 \ x02 \ xbc \ x00 \ x00 \ x01 \ xf4 \ x08 \ x06 \ x00 \ x00 \ x00
\ xdfy \ xfe \ xdf \ x00 \ x00
----tronqué

Notez que vous pouvez parfois faire face à l'erreur requise Kaleido lors de l'exécution de la fonction TO_IMAGE ().

Vous pouvez résoudre ce problème en utilisant le package Kaleido avec PIP comme:

$ pip install kaleido
$ pip3 installer kaledio

Une fois installé, relancez votre environnement de développement et réécoutez le code ci-dessus.

Exemple 2 - Enregistrer les octets pour fichier

Dans la plupart des cas, avoir des octets de données n'est pas très utile. Cependant, nous pouvons utiliser cet octet et l'écrire dans un fichier image comme indiqué dans le code:

importer parce que PLT
avec Open ("Target_Filename.png ", 'wb') comme f:
F.Écrire (PLT.Io.to_image (Fig, format = 'png'))

Dans l'exemple ci-dessus, nous utilisons l'opération de fichier Python pour créer un fichier et écrire les octets de la fonction TO_IMAGE (). La méthode ci-dessus doit créer un fichier avec le nom de fichier spécifié et enregistrer l'image.

L'image résultante est comme indiqué:

Exemple 3 - Spécification des dimensions d'image et de hauteur

Pour exporter l'image avec des dimensions de largeur et de hauteur spécifiques, nous pouvons spécifier ces paramètres comme indiqué:

importer parce que PLT
avec Open ("Target_Filename.png ", 'wb') comme f:
F.Écrire (PLT.Io.to_image (Fig, largeur = 1200, hauteur = 800, format = 'png')))

Dans l'exemple ci-dessus, nous enregistrons l'image en 1200 × 800 dimensions. Nous pouvons le vérifier en exécutant la commande:

$ exififool Target_filename.PNG

Cela devrait renvoyer la sortie comme indiqué:

Comme nous pouvons le voir, l'image résultante a 1200 x 800 dimensions.

Exemple 4 - Spécifiez le moteur d'exportation d'image

Plotly vous permet également de spécifier le moteur que vous souhaitez utiliser lors de l'exportation de l'image. Il soutient Kaleido et Orca comme moteurs.

Un exemple de la façon de spécifier le moteur d'exportation est illustré ci-dessous.

Avant de spécifier un moteur, assurez-vous qu'il est installé et disponible sur le chemin de votre système.

Par exemple, pour installer Kaleido, exécutez la commande:

$ sudo pip3 installer kaleido

Pour Orca, exécutez la commande:

Conda Installer -C Plotly-Orca PSUTIL Demandes
$ PIP3 Installer Plotly-Orca PSUTIL Demandes

Exemple:

importer parce que PLT
avec Open ("Target_Filename.png ", 'wb') comme f:
F.Écrire (PLT.Io.to_image (Fig, largeur = 1200, hauteur = 800, format = 'png', moteur = "kaleido"))

L'exemple ci-dessus illustre comment spécifier le moteur d'exportation d'image vers Kaleido.

Gardez à l'esprit que l'intrigue sera par défaut à la valeur automatique. Cela signifie que si Kaleido n'est pas installé, Plotly utilisera Orca et vice versa.

Conclusion

Dans cet article, nous avons appris comment nous pouvons exporter une figure en une image statique sous forme d'octets en utilisant l'IO.Fonction TO_IMAGE (). Nous avons également appris à spécifier une taille d'image personnalisée, à écrire les octets au disque comme image, etc.