Tracer.Io.write_image

Plotly est un outil polyvalent avec de grandes fonctionnalités dès la sortie de la boîte. Une telle fonctionnalité est la possibilité d'exporter vos graphiques en images statiques. En utilisant Plotly, vous pouvez enregistrer vos parcelles en tant qu'images de divers formats sur le disque de votre ordinateur ou les intégrer dans des cahiers Jupyter.

Dans ce tutoriel, nous apprendrons à exporter des tracés vers des images statiques à l'aide de la fonction write_image ().

Installation des dépendances requises

Avant de pouvoir effectuer toutes les exportations d'images statiques, vous devez installer un moteur d'exportation. Pour les exportations d'images statiques, Plotly prend en charge les moteurs Kaleido et Orca.

Bien que cela dépendra de vos besoins, recommande de l'utilisation de Kaleido pour les parcelles avec Plotly Version 4.9 et plus. Pour les versions héritées, utilisez le package ORCA.

Vous pouvez installer ces packages à l'aide des commandes suivantes:

$ sudo pip install kaleido
$ sudo pip3 installer kaleido

Si vous utilisez Anaconda, exécutez la commande:

$ sudo conda install -c conda-forge python-kaleido

Pour Orca, utilisez PIP ou Conda. Les commandes sont telles qu'elles sont fournies:

$ sudo pip install -c tracé tracely-orca
$ sudo pip3 install -c tracé tracely-orca
$ sudo conda install -c tracé tracely-orca

Une fois installé, vous pouvez utiliser la fonction write_image () pour générer des images statiques de vos parcelles.

Tracer.Io.write_iamge ()

Comme mentionné, la fonction write_image () vous permet de convertir une figure en une image statique et de l'enregistrer sur le disque comme objet écrivain.

La syntaxe de fonction est comme indiqué:

tracer.Io.write_image (fig, fichier, format = aucun, échelle = aucun, largeur = aucun, hauteur = aucun, valider = true, moteur = 'auto')

Les paramètres de fonction sont tels que décrits ci-dessous:

1. Fig - Spécifie l'objet de figure ou le dictionnaire pour se convertir en une image statique.
2. Fichier - Définit le chemin d'accès au nom de fichier ou à un objet inscriptible.
3. Format - Spécifie le format d'image cible souhaité. Les valeurs acceptées incluent:
   • 'png'
   • 'webp'
   • 'JPG ou JPEG'
   • «svg»
   • 'pdf'
   • 'EPS'

Si le format d'image n'est pas spécifié, la fonction sera par défaut au format par défaut du moteur.

1. Largeur - Spécifie la largeur de l'image exportée en pixels.
2. Hauteur - Définit la hauteur de l'image exportée en pixels.
3. Échelle - Définit le facteur d'échelle utilisé lors de l'exportation de l'image.
4. Valider - une valeur booléenne qui spécifie si la figure doit être validée avant de l'exporter vers une image statique.
5. Moteur - Spécifie le moteur d'exportation d'image cible. Les valeurs acceptées incluent «Kaleido», «Orca» ou «Auto».

La fonction renvoie un type aucun.

Exemple - Créer une figure

Illustrons comment nous pouvons utiliser la fonction write_image () pour exporter une figure vers une image statique.

Commençons par générer un complot. Le code est fourni ci-dessous:

Importer un terrain.Exprime comme PX
df = px.données.GapMinder ().Query ("Country == 'Ireland'")
Fig = px.bar (df, x = 'année', y = 'pop', color = "lifeExp")
figue.montrer()

Dans l'exemple ci-dessus, nous créons un graphique à barres simple à l'aide des données GapMinder. La figure résultante est comme indiqué:

Écrire une image dans le fichier

Pour écrire la figure ci-dessus dans un fichier image, nous pouvons utiliser la fonction write_image () comme indiqué:

figue.write_image ('my_figure.png ', format =' png ')

Le code ci-dessus doit exporter la figure comme une image PNG sous le nom de My_figure.PNG.

D'autres exemples incluent:

figue.write_image ('my_figure.jpg ', format =' jpg ')
figue.write_image ('my_figure.webp ', format =' webp ')
figue.write_image ('my_figure.svg ', format =' svg ')
figue.write_image ('my_figure.pdf ', format =' pdf ')

Le code ci-dessus doit exporter les images dans JPG, WebP, SVG et PDF, respectivement.

Écriture d'image avec des dimensions personnalisées

Plotly vous permet de spécifier des dimensions personnalisées lors de l'exportation d'une figure vers une image statique. Voici un exemple de code:

figue.write_image ('my_figure.png ', format =' png ', largeur = 1200, hauteur = 800)

Le code ci-dessus doit enregistrer l'image à 1200 x 800 pixels.

Spécification du moteur d'exportation

Si Kaleido est installé sur le système, Plotly l'utilisera comme moteur d'exportation par défaut. Nous pouvons remplacer ce paramètre en définissant le paramètre du moteur comme indiqué:

figue.write_image ('my_figure.png ', format =' png ', largeur = 1200, hauteur = 800, moteur =' orca ')

Le code ci-dessus oblige à installer Orca sur votre système.

Fermeture

Dans ce tutoriel, vous avez appris à exporter des chiffres en images statiques en utilisant l'intrigue.Io.Fonction écrite_image ().