deafrica_tools.app.widgetconstructors

Fonctions permettant de définir facilement des widgets dans le contexte des notebooks DE Africa.

Il s’agit en grande partie d’enveloppes personnalisées autour de widgets existants.

Fonctions

create_boundedfloattext(valeur, min_val, ...)

Créer un widget BoundedFloatText

create_checkbox(valeur[, description, mise en page])

Créer un widget de case à cocher

create_datepicker([description, valeur, mise en page])

Créer un widget DatePicker

create_dea_wms_layer(produit, date)

Créez une couche WMS Digital Earth Africa à ajouter à une carte

create_drawcontrol([draw_controls, ...])

Créez un widget de contrôle de dessin à ajouter aux cartes ipyleaflet

create_dropdown(options, valeur[, ...])

Créer un widget déroulant

create_html(valeur)

Créer un widget HTML

create_inputtext(valeur, espace réservé[, ...])

Créer un widget de texte

create_map([carte_centre, zoom_niveau, ...])

Créer une carte interactive ipyleaflet
deafrica_tools.app.widgetconstructors.create_boundedfloattext(value, min_val, max_val, step_val, description='', layout={'width': '85%'})

Créer un widget BoundedFloatText

Dernière modification : octobre 2021

Paramètres:

  • value (float) – valeur initiale du widget

  • min_val (float) – valeur minimale autorisée pour le flotteur

  • max_val (float) – valeur maximale autorisée pour le flotteur

  • step_val (float) – incrément autorisé pour le flotteur

  • description (string) – étiquette descriptive à coller

  • layout (dictionary) – toutes les commandes de mise en page pour le widget

Renvoie:

texte flottant

Type renvoyé:

ipywidgets.widgets.widget_float.BoundedFloatText

deafrica_tools.app.widgetconstructors.create_checkbox(value, description='', layout={'width': '85%'})

Créer un widget de case à cocher

Dernière modification : juillet 2022

Paramètres:

  • value (string) – valeur initiale du widget ; Vrai ou Faux

  • description (string) – étiquette descriptive à joindre

  • layout (dictionary) – toutes les commandes de mise en page pour le widget

Renvoie:

dérouler

Type renvoyé:

ipywidgets.widgets.widget_selection.Dropdown

deafrica_tools.app.widgetconstructors.create_datepicker(description='', value=None, layout={'width': '85%'})

Créer un widget DatePicker

Dernière modification : juillet 2022

Paramètres:

  • description (string) – étiquette descriptive à coller

  • layout (dictionary) – toutes les commandes de mise en page pour le widget

Renvoie:

sélecteur de date

Type renvoyé:

ipywidgets.widgets.widget_date.DatePicker

deafrica_tools.app.widgetconstructors.create_dea_wms_layer(product, date)

Créez une couche WMS Digital Earth Africa à ajouter à une carte

Dernière modification : octobre 2021

Paramètres:

  • product (string) – Le produit Digital Earth Africa à charger (par exemple « gm_s2_annual »)

  • date (string (yyyy-mm-dd format)) – La date de chargement du produit pour

Renvoie:

time_wms

Type renvoyé:

ipyleaflet WMS layer

deafrica_tools.app.widgetconstructors.create_drawcontrol(draw_controls=['rectangle', 'polygon', 'circle', 'polyline', 'marker', 'circlemarker'], rectangle_options={}, polygon_options={}, circle_options={}, polyline_options={}, marker_options={}, circlemarker_options={})

Créez un widget de contrôle de dessin à ajouter aux cartes ipyleaflet

Dernière modification : octobre 2021

Paramètres:

  • draw_controls (list) – Liste des contrôles de dessin à ajouter à la carte. Par défaut, toutes les options viables sont ajoutées : « rectangle », « polygone », « cercle », « polyligne », « marqueur », « marqueur de cercle »

  • rectangle_options (dict) – Options pour personnaliser l’apparence de la forme concernée L’utilisateur peut fournir ou laisser vide pour obtenir l’apparence par défaut de l’Afrique du Sud

  • polygon_options (dict) – Options pour personnaliser l’apparence de la forme concernée L’utilisateur peut fournir ou laisser vide pour obtenir l’apparence par défaut de l’Afrique du Sud

  • circle_options (dict) – Options pour personnaliser l’apparence de la forme concernée L’utilisateur peut fournir ou laisser vide pour obtenir l’apparence par défaut de l’Afrique du Sud

  • polyline_options (dict) – Options pour personnaliser l’apparence de la forme concernée L’utilisateur peut fournir ou laisser vide pour obtenir l’apparence par défaut de l’Afrique du Sud

  • marker_options (dict) – Options pour personnaliser l’apparence de la forme concernée L’utilisateur peut fournir ou laisser vide pour obtenir l’apparence par défaut de l’Afrique du Sud

  • circlemarker_options (dict) – Options pour personnaliser l’apparence de la forme concernée L’utilisateur peut fournir ou laisser vide pour obtenir l’apparence par défaut de l’Afrique du Sud

Renvoie:

contrôle_de_dessin

Type renvoyé:

ipyleaflet.leaflet.DrawControl

deafrica_tools.app.widgetconstructors.create_dropdown(options, value, description='', layout={'width': '85%'})

Créer un widget déroulant

Dernière modification : octobre 2021

Paramètres:

  • options (list) – une liste d’options parmi lesquelles l’utilisateur peut choisir

  • value (string) – valeur initiale du widget

  • description (string) – étiquette descriptive à coller

  • layout (dictionary) – toutes les commandes de mise en page pour le widget

Renvoie:

dérouler

Type renvoyé:

ipywidgets.widgets.widget_selection.Dropdown

deafrica_tools.app.widgetconstructors.create_html(value)

Créer un widget HTML

Dernière modification : octobre 2021

Paramètres:

value (string) – Texte HTML à afficher

Renvoie:

html

Type renvoyé:

ipywidgets.widgets.widget_string.HTML

deafrica_tools.app.widgetconstructors.create_inputtext(value, placeholder, description='', layout={'width': '85%'})

Créer un widget de texte

Dernière modification : octobre 2021

Paramètres:

  • value (string) – valeur initiale du widget

  • placeholder (string) – texte d’espace réservé à afficher à l’utilisateur avant la saisie

  • description (string) – étiquette descriptive à coller

  • layout (dictionary) – toutes les commandes de mise en page pour le widget

Renvoie:

texte d’entrée

Type renvoyé:

ipywidgets.widgets.widget_string.Text

deafrica_tools.app.widgetconstructors.create_map(map_center=(4, 20), zoom_level=3, basemap=ipyleaflet.basemaps.OpenStreetMap.Mapnik, basemap_name='Open Street Map')

Créer une carte interactive ipyleaflet

Dernière modification : octobre 2021

Paramètres:

  • map_center (tuple) – Un tuple contenant la latitude et la longitude sur lesquelles se concentrer. La valeur par défaut est le centre de l’Afrique, (4, 20)

  • zoom_level (integer) – Niveau de zoom de la carte Par défaut à 3 pour voir toute l’Afrique

  • basemap (ipyleaflet basemap (dict)) – Carte de base à utiliser, peut être n’importe laquelle de https://ipyleaflet.readthedocs.io/en/latest/api_reference/basemaps.html La valeur par défaut est Open Street Map (basemaps.OpenStreetMap.Mapnik)

  • basemap_name (string) – Nom de la couche pour la carte de base

Renvoie:

m – carte interactive ipyleaflet

Type renvoyé:

ipyleaflet.leaflet.Map