| Les deux révisions précédentesRévision précédente | |
| issue161:python [2020/10/01 16:33] – andre_domenech | issue161:python [2020/10/01 17:07] (Version actuelle) – auntiee |
|---|
| **Alright, I admit it. I let things slide on my FCM duties this month (and other things as well, but that's another story for another time). Between the medical issues, and trying to write chapters for the book, it just never happened. Thankfully, my friend in Norway, Halvard, came to my rescue once again. A few weeks ago, he sent me a message about a neat visualization tool for Python called Folium. I thanked him and took a look. I was really impressed until I realized that all the examples that I was seeing were for Jupyter Notebook. I spent a little bit of time looking for examples that didn't use Jupyter Notebook, but since I didn't put much effort into it, I really couldn't find anything. Today, just before I needed to leave to go to a Doctor's appointment, I received Ronnie's monthly gentle nudge about the deadline for articles. Rolling my eyes like a 14 year-old girl, and sighing deeply, I sent myself a reminder that when I got back home, I REALLY needed to get to work on this.** | **Alright, I admit it. I let things slide on my FCM duties this month (and other things as well, but that's another story for another time). Between the medical issues, and trying to write chapters for the book, it just never happened. Thankfully, my friend in Norway, Halvard, came to my rescue once again. A few weeks ago, he sent me a message about a neat visualization tool for Python called Folium. I thanked him and took a look. I was really impressed until I realized that all the examples that I was seeing were for Jupyter Notebook. I spent a little bit of time looking for examples that didn't use Jupyter Notebook, but since I didn't put much effort into it, I really couldn't find anything. Today, just before I needed to leave to go to a Doctor's appointment, I received Ronnie's monthly gentle nudge about the deadline for articles. Rolling my eyes like a 14 year-old girl, and sighing deeply, I sent myself a reminder that when I got back home, I REALLY needed to get to work on this.** |
| |
| Bon, je l'admets. Je me suis laissé aller ce mois-ci dans mes devoirs pour le FCM (et aussi pour d'autres choses, mais c'est une autre histoire pour une autre fois). Entre les problèmes médicaux et des essais d'écriture de chapitres pour le livre, il ne s'est rien passé. Par chance, mon ami norvégien Halvard est venu à mon secours une fois encore. Il y a quelques semaines, il m'a envoyé un message à propos d'un outil de visualisation soignée pour Python appelé Folium. Je l'ai remercié et j'ai jeté un œil. J'ai été réellement impressionné jusqu'à ce que je réalise que tous les exemples que je voyais étaient pour un notebook Jupyter. J'ai passé un peu de temps à chercher les exemples qui n'utilisaient pas le notebook Jupyter, mais, comme je n'ai pas poussé la chose bien loin, je n'ai, en fait, rien trouvé. Aujourd'hui, juste avant que je sorte pour aller à un rendez-vous médical, j'ai reçu le gentil rappel de Ronnie à propos de la date limite pour les articles. En me faisant rouler les yeux comme une gamine de 14 ans et en soupirant profondément, je me suis envoyé un rappel pour que, à mon retour à la maison, je me mette VRAIMENT au travail sur le sujet. | Bon, je l'admets. Je me suis laissé aller ce mois-ci dans mes devoirs pour le FCM (et aussi pour d'autres choses, mais c'est une autre histoire pour une autre fois). Entre les problèmes médicaux et des essais d'écriture de chapitres pour le livre, il ne s'est rien passé. Par chance, mon ami norvégien Halvard est venu à mon secours une fois encore. Il y a quelques semaines, il m'a envoyé un message à propos d'un outil de visualisation soignée pour Python appelé Folium. Je l'ai remercié et j'ai jeté un œil. J'ai été réellement impressionné jusqu'à ce que je réalise que tous les exemples que je voyais étaient pour un notebook Jupyter. J'ai passé un peu de temps à chercher les exemples qui n'utilisaient pas le notebook Jupyter, mais, comme je n'ai pas poussé la chose bien loin, je n'ai, en fait, rien trouvé. Aujourd'hui, juste avant de sortir pour aller à un rendez-vous médical, j'ai reçu le gentil rappel de Ronnie à propos de la date limite pour les articles. En levant les yeux au ciel comme une gamine de 14 ans et en soupirant profondément, je me suis envoyé un rappel pour que, à mon retour à la maison, je me mette VRAIMENT au travail sur le sujet. |
| |
| **So let me tell you about Folium. Directly from their website: | **So let me tell you about Folium. Directly from their website: |
| « Folium facilite la visualisation, sur une carte interactive, des données qui ont été manipulées dans Python. Il permet à la fois le lien des données à la carte pour une visualisation avec choropleth et la transmission de visualisations enrichies sous forme vectorielle/raster/html comme marqueurs sur la carte. | « Folium facilite la visualisation, sur une carte interactive, des données qui ont été manipulées dans Python. Il permet à la fois le lien des données à la carte pour une visualisation avec choropleth et la transmission de visualisations enrichies sous forme vectorielle/raster/html comme marqueurs sur la carte. |
| |
| « La bibliothèque a un certain nombre de jeux de tuiles intégrés pour OpenStreetMap, Mapbox et Stamen, et supporte les jeux de tuiles personnalisés avec les clés API de Mapbox ou Cloudmade. folium supporte les superpositions avec des images, de la vidéo, du GeoJSON et du TopoJSON. » | « La bibliothèque a un certain nombre de jeux de tuiles intégrés pour OpenStreetMap, Mapbox et Stamen, et supporte les jeux de tuiles personnalisés avec les clés API de Mapbox ou Cloudmade. Folium supporte les superpositions avec des images, de la vidéo, du GeoJSON et du TopoJSON. » |
| |
| Quand Halvard m'a envoyé le lien, j'ai repris mon Jupyter avec réticence et j'ai essayé l'exemple de code. Je pouvais voir un certain nombre de choses que j'aurais aimé essayé de faire avec cet outil réellement soigné. Mais à nouveau, des perturbations vinrent et je l'ai laissé de côté, « à faire dans le futur ». Le chose qui m'a le plus empêché de creuser plus loin à ce moment-là, c'est la nécessité d'un notebook Jupyter (JN). Je ne sais pas pourquoi je le déteste tant. C'est comme ça. | Quand Halvard m'a envoyé le lien, j'ai repris mon Jupyter avec réticence et j'ai essayé l'exemple de code. Je pouvais voir un certain nombre de choses que j'aurais aimé essayer de faire avec cet outil réellement soigné. Mais, à nouveau, des perturbations vinrent et je l'ai laissé de côté, « à faire dans le futur ». La chose qui m'a le plus empêché de creuser plus loin à ce moment-là, c'était la nécessité d'un notebook Jupyter (JN). Je ne sais pas pourquoi je le déteste tant. C'est comme ça. |
| |
| **When I got back from the Doctor's office, I did a semi-intelligent web search for a way to use folium without needing to use JN. Sure enough, there were a number of links that gave me a starting point. So may I present my findings. | **When I got back from the Doctor's office, I did a semi-intelligent web search for a way to use folium without needing to use JN. Sure enough, there were a number of links that gave me a starting point. So may I present my findings. |
| You can also download the source code from the github repository at https://github.com/python-visualization/folium. The repository has a large number of examples that you can try out, but I'm guessing that they are all run under Notebook, since the extensions are all "ipynb". That's for another day.** | You can also download the source code from the github repository at https://github.com/python-visualization/folium. The repository has a large number of examples that you can try out, but I'm guessing that they are all run under Notebook, since the extensions are all "ipynb". That's for another day.** |
| |
| Quand je suis rentré du cabinet médical, j'ai effectué une recherche à demi-intelligente sur le Web sur une façon d'utiliser Folium sans utiliser un JN. Bien sûr, il y a un bon nombre de liens qui m'ont donné un point de départ. Aussi, permettez que je vous présente mes découvertes. | Quand je suis rentré du cabinet médical, j'ai effectué une recherche à demi-intelligente sur le Web sur une façon d'utiliser Folium sans utiliser un JN. Bien sûr, il y a un bon nombre de liens qui m'ont donné un point de départ. Aussi, permettez-moi de vous présenter mes découvertes. |
| |
| En premier lieu, vous devez installer la bibliothèque Folium (comme si vous ne l'avez pas vu venir). La version actuelle est la 0.11.0. C'est facile en utilisant pip : | En premier lieu, vous devez installer la bibliothèque Folium (comme si vous n'avez pas prévu de le faire). La version actuelle est la 0.11.0. C'est facile en utilisant pip : |
| |
| $ pip install folium | $ pip install folium |
| Commençons. | Commençons. |
| |
| J'ai vécu pendant des années dans une petite commune appelée Canyon Lake, au Texas. C'était une belle région et cette période fut très heureuse pour moi et ma famille ; aussi, nous utiliserons cet endroit pour la première démonstration. En supposant que vous voulez faire ça directement à partir d'un JN, c'est vraiment facile : | J'ai vécu pendant des années dans une petite municipalité appelée Canyon Lake, au Texas. C'était une belle région et cette période fut très heureuse pour moi et ma famille ; aussi, nous utiliserons cet endroit pour la première démonstration. En supposant que vous voulez faire ça directement à partir d'un JN, c'est vraiment facile : |
| |
| import folium | import folium |
| This will give you a somewhat nicer map in my opinion (below).** | This will give you a somewhat nicer map in my opinion (below).** |
| |
| La sortie est vraiment jolie et la carte est facile à agrandir et à réduire. Mais que se passe-t-il si nous voulons qu'elle arrive déjà agrandie ? C'est facile aussi. Changez juste la ligne m=folium.Map par : | La sortie est vraiment jolie et la carte est facile à agrandir et à réduire. Mais que se passe-t-il si nous voulons qu'elle arrive déjà agrandie ? C'est facile aussi. Il suffit de remplacer la ligne m = folium.Map par : |
| |
| m = folium.Map(location=[29.8752, -98.2625], zoom_start=13) | m = folium.Map(location=[29.8752, -98.2625], zoom_start=13) |
| Vraiment, c'est super facile ! | Vraiment, c'est super facile ! |
| |
| Nous pouvons aussi définir le type de carte en tuiles que folium utilisera. C'est un simple ajout sur la ligne d'initialisation de l'objet. Remplacez la ligne m=folium.Map par ceci : | Nous pouvons aussi définir le type de carte en tuiles que folium utilisera. C'est un simple ajout sur la ligne d'initialisation de l'objet. Remplacez la ligne m = folium.Map par ceci : |
| |
| m = folium.Map(location=[29.8752, -98.2625], tiles='Stamen Terrain', zoom_start=13) | m = folium.Map(location=[29.8752, -98.2625], tiles='Stamen Terrain', zoom_start=13) |
| I’ve included just a small selection of the actual map output. If you click on one of the markers you will see something like that shown right.** | I’ve included just a small selection of the actual map output. If you click on one of the markers you will see something like that shown right.** |
| |
| Si vous voulez améliorer la carte, vous pouvez facilement ajouter des marqueurs à une latitude/longitude spécifique. Là encore, c'est très facile. Ajoutez simplement les lignes suivantes avant la ligne qui assigne le nom du fichier, mais après celle qui crée la carte folium. Dans la cas présent, je vais ajouter trois marqueurs (en haut à droite). | Si vous voulez améliorer la carte, vous pouvez facilement ajouter des marqueurs à une latitude/longitude spécifique. Là encore, c'est très facile. Ajoutez simplement les lignes suivantes avant la ligne qui assigne le nom du fichier, mais après celle qui crée la carte folium. Dans le cas présent, je vais ajouter trois marqueurs (en haut à droite). |
| |
| Enregistrez et relancez le programme ; vous verrez quelque chose comme l'image ci-dessous à droite. | Enregistrez et relancez le programme ; vous verrez quelque chose comme l'image ci-dessous à droite. |
| Again, I’ve zoomed in pretty deeply. There are plenty of other types of maps like these that you can use. You can check the documentation at https://python-visualization.github.io/folium/index.html .** | Again, I’ve zoomed in pretty deeply. There are plenty of other types of maps like these that you can use. You can check the documentation at https://python-visualization.github.io/folium/index.html .** |
| |
| Comme nous pouvons le dire en France : « Hé ! Attendez : il y en a encore plus ! » Ne serait-ce pas sympa d'ajouter la possibilité pour l'utilisateur (vous et moi dans notre cas) de cliquer quelque part avec la souris et d'obtenir les latitude et longitude dans une info-bulle ? Là encore, un ajout facile. Ajoutez juste la ligne suivante, avant l'assignement du nom du fichier : | Comme nous pouvons le dire en France : « Hé ! Attendez : il y en a encore plus ! » Ne serait-ce pas sympa d'ajouter la possibilité pour l'utilisateur (vous et moi dans notre cas) de cliquer quelque part avec la souris et d'obtenir les latitude et longitude dans une info-bulle ? Là encore, un ajout facile. Il suffit d'ajouter la ligne suivante, avant l'assignement du nom du fichier : |
| |
| m.add_child(folium.LatLngPopup()) | m.add_child(folium.LatLngPopup()) |
| Top right is an example image from that website.** | Top right is an example image from that website.** |
| |
| Maintenant, nous commençons l'exploration d'un des autres types de cartes que Folium peut produire, une carte Choropleth. D'après le site Web du catalogue de visualisation des données (https://datavizcatalogue.com/methods/choropleth.html) : | Maintenant, nous commençons l'exploration d'un des autres types de cartes que Folium peut produire, une carte Choropleth. D'après le site Web du Catalogue de visualisation des données (https://datavizcatalogue.com/methods/choropleth.html) : |
| |
| « L'affichage Choropleth des cartes est divisé en zones ou régions géographiques qui sont colorées, ombrées ou avec motifs en lien avec une variable des données. Cela fournit une façon de visualiser des valeurs sur une zone géographique, ce qui peut montrer une variation ou des motifs sur le lieu affiché. » | « L'affichage Choropleth des cartes est divisé en zones ou régions géographiques qui sont colorées, ombrées ou avec motifs en lien avec une variable des données. Cela fournit une façon de visualiser des valeurs sur une zone géographique, ce qui peut montrer une variation ou des motifs sur le lieu affiché. » |
| import webbrowser | import webbrowser |
| |
| Maintenant, nous avons besoin de paramétrer un adresse url qui pointe sur les données, de régler quelques autres variables (voir ci-dessous) et que pandas les charge. | Maintenant, nous devons paramétrer une adresse url qui pointe sur les données, régler quelques autres variables (voir ci-dessous) et demander à pandas de les charger. |
| |
| Ensuite, nous créons la carte folium comme nous l'avons fait précédemment : | Ensuite, nous créons la carte folium comme nous l'avons fait précédemment : |
| As always, until next time; stay safe, healthy, positive and creative!** | As always, until next time; stay safe, healthy, positive and creative!** |
| |
| Bon ! C'est tout pour cette fois. Je vous suggère grandement d'essayer les exemples tirés de Folium et d'autres sur le Web pour voir comment Folium peut vous aider dans votre propre programmation. Il y avait un grand nombre d'exemples dans « jupyter notebook gallery », mais, entre le moment où j'ai commencé et maintenant où je termine, beaucoup d'entre eux ont disparu ; quand je vérifie la version de Folium sur le site de la galerie, une valeur est présentée qui est supérieure à celle disponible dans le dépôt. Attendez-vous à une nouvelle version bientôt. | Bon ! C'est tout pour cette fois-ci. Je vous suggère vivement d'essayer les exemples tirés de Folium et d'autres sur le Web pour voir comment Folium peut vous aider dans votre propre programmation. Il y avait un grand nombre d'exemples dans une « jupyter notebook gallery », mais, entre le moment où j'ai commencé et maintenant où je termine, beaucoup d'entre eux ont disparu ; quand je vérifie la version de Folium sur le site de la galerie, une valeur est présentée qui est supérieure à celle disponible dans le dépôt. Attendez-vous à une nouvelle version bientôt. |
| |
| J'ai mis le code source de ce mois sur pastebin. Les liens sont : | J'ai mis le code source de ce mois sur pastebin. Les liens sont : |
