Plotly.io.to_templated

Ας βουτήξουμε.

Συντακτικό συνάρτησης

Η συνάρτηση παρέχει μια απλή σύνταξη που σας επιτρέπει να εστιάσετε στον κώδικα. Η σύνταξη εκφράζεται ως εξής:

Οι παράμετροι συνάρτησης είναι:

1. Fig – καθορίζει το αντικείμενο σχήμα του οποίου το στυλ θέλετε να μετακινήσετε σε ένα πρότυπο.
2. Skip – καθορίζει μια συλλογή ονομάτων των ιδιοτήτων που θέλετε να εξαιρέσετε κατά τη μετακίνηση του στυλ σε ένα πρότυπο. Από προεπιλογή, περιλαμβάνεται μόνο η ιδιότητα τίτλου. Αυτό αποτρέπει την εισαγωγή του κειμένου του σχήματος, όπως τίτλους αξόνων, από άλλα σχήματα.

Η φιγούρα επιστρέφει ένα αντίγραφο της φιγούρας με το στυλ μετατοπισμένο σε ένα πρότυπο. Ο τύπος επιστροφής του go.Εικόνα.

Παράδειγμα

Ας δείξουμε πώς μπορούμε να χρησιμοποιήσουμε τη συνάρτηση to_templated() για να εξάγουμε το στυλ μιας συγκεκριμένης φιγούρας σε ένα πρότυπο.

Ας ξεκινήσουμε δημιουργώντας μια φιγούρα με προσαρμοσμένο στυλ. Ένα παράδειγμα κώδικα φαίνεται παρακάτω:

Σε αυτό το παράδειγμα, δημιουργούμε μια γραφική παράσταση διασποράς με προσαρμοσμένο στυλ κειμένου όπως οικογένεια γραμματοσειρών, χρώμα γραμματοσειράς, μέγεθος γραμματοσειράς κ.λπ.

Ο παραπάνω κώδικας θα πρέπει να επιστρέψει ένα απλό διάγραμμα διασποράς όπως φαίνεται:

Μπορούμε να μετατρέψουμε αυτό το σχήμα σε σχήμα με ένα πρότυπο στυλ χρησιμοποιώντας τη συνάρτηση to_template().

Ένα παράδειγμα κώδικα είναι όπως φαίνεται:

Στον παραπάνω κώδικα, ξεκινάμε εισάγοντας την ενότητα plotly io ως io. Στη συνέχεια, δημιουργούμε ένα αντίγραφο του σχήματος με το στυλ αποθηκευμένο σε ένα προσαρμοσμένο πρότυπο χρησιμοποιώντας τη συνάρτηση to_templated().

Μπορούμε να δούμε το πρότυπο εκτελώντας τον κώδικα:

Αυτό θα πρέπει να επιστρέψει ένα λεξικό με ιδιότητες που καθορίζουν το στυλ του σχήματος. Ένα παράδειγμα τιμής εξόδου είναι όπως φαίνεται:

Μπορείτε να εμφανίσετε το σχήμα απλά καλώντας το αποθηκευμένο πρότυπο ως:

Αυτό θα πρέπει να εμφανίζει το σχήμα που είναι αποθηκευμένο στο πρότυπο.

Δημιουργήστε μια εικόνα με το Πρότυπο

Αφού αποθηκεύσουμε το στυλ μιας φιγούρας σε ένα προσαρμοσμένο πρότυπο, μπορούμε να χρησιμοποιήσουμε αυτό το πρότυπο για να εφαρμόσουμε το στυλ σε μια άλλη φιγούρα.

Ένα παράδειγμα κώδικα είναι όπως φαίνεται:

Στο παραπάνω παράδειγμα, ξεκινάμε εισάγοντας την ενότητα graph_objects από το Plotly. Σε αυτήν την περίπτωση, χρησιμοποιούμε graph_objects καθώς θέλουμε να δημιουργήσουμε μια κενή φιγούρα αλλά χρησιμοποιούμε μόνο το στυλ.

Χρησιμοποιώντας τη συνάρτηση go.Figure(), περνάμε την παράμετρο διάταξης και καθορίζουμε το πρότυπο προορισμού χρησιμοποιώντας την ιδιότητα «πρότυπο».

Μπορούμε στη συνέχεια να εμφανίσουμε το σχήμα που προκύπτει καλώντας new_fig. Αυτό θα πρέπει να επιστρέψει:

Σημειώστε ότι το παραπάνω σχήμα δεν περιέχει δεδομένα ή κείμενο. Περιλαμβάνει μόνο το στυλ, όπως χρώμα κειμένου, οικογένεια γραμματοσειρών, μέγεθος γραμματοσειράς κ.λπ.

Για να δημιουργήσουμε ένα διάγραμμα διασποράς με αυτό το πρότυπο, μπορούμε να χρησιμοποιήσουμε τον κώδικα όπως φαίνεται:

Το παραπάνω παράδειγμα θα πρέπει να επιστρέψει ένα σχήμα όπως φαίνεται:

Σημειώστε ότι το χρώμα, η οικογένεια και το μέγεθος της γραμματοσειράς είναι παρόμοια με αυτά που ορίζονται στο πρότυπο.

Αποθήκευση ενός επώνυμου προτύπου

Μπορούμε να αποθηκεύσουμε το προσαρμοσμένο πρότυπο χρησιμοποιώντας το αντικείμενο templates όπως φαίνεται στον παρακάτω κώδικα:

Ο παραπάνω κώδικας θα αποθηκεύσει το πρότυπο με το όνομα 'my_custom_template'. Στη συνέχεια, μπορείτε να χρησιμοποιήσετε αυτό το όνομα για να καθορίσετε το πρότυπο που θέλετε να χρησιμοποιήσετε:

συμπέρασμα

Σε αυτό το σεμινάριο, μάθαμε πώς να δημιουργήσουμε μια φιγούρα με το στυλ αποθηκευμένο σε ένα προσαρμοσμένο πρότυπο. Καλύψαμε επίσης τον τρόπο χρήσης του προτύπου σε άλλα σχήματα και αποθηκεύσαμε το πρότυπο για μελλοντική χρήση.