.. pygmt:

Figure.basemap
==============

Ici vous aurez des explications sur la commande et ses différents paramètres.

.. code-block:: python 
	
	Figure.basemap(\*, region=None, projection=None, zscale=None,
	zsize=None, frame=None, map_scale=None, box=None, rose=None,
	compass=None, verbose=None, panel=None, coltypes=None,
	perspective=None, transparency=None, \**kwargs)


Utilité :
---------
	
Cette commande permet d'élaborer des cartes de base et des emplacements pour la figure.  
                                 
Créer une carte de base simple ou sophistiquée avec des axes, un remplissage et des titres. Plusieurs projections cartographiques sont disponibles et l'utilisateur peut spécifier des intervalles de repères distincts pour l'annotation des limites, le graduation et les éventuelles lignes de quadrillage. Une simple échelle cartographique ou 
une rose des vents peut également être dessinée.
   
Au moins l'un des paramètres **frame**, **map_scale**, **rose**, ou **compass** doivent être spécifiés si ce n'est pas en mode sous-figure.


Paramètres :
------------

**projection** (str) Sélectionner une projection cartographique.  

**zscale/zsize** (float ou str) - Définir la mise à l'échelle de l'axe z ou la taille de l'axe z.  

**region** (str ou liste)- xmin/xmax/ymin/ymax[+r][+uunit].
Préciser la région d'intérêt. Requis si c'est le premier 
commande de tracé.

**frame** (bool ou str ou liste) - Définir le cadre de la limite de la carte et les attributs des axes.

**map_scale** (str)- [g|j|J|n|x] refpoint+wlength.  
Tracer une échelle cartographique simple centrée sur le point de référence spécifié.

**box** (bool ou str) - [+cclearances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]   .  
Si défini sur True, dessiner une bordure rectangulaire autour de  
l'échelle cartographique ou la rose. Alternativement, spécifier un stylo différent avec  
+ppen. Ajoutez +gfill pour remplir le panneau d'échelle [par défaut,pas de remplissage]. Ajoutez +cclearance où clearance est soit gap,  
séparés en direction x et y, ou des espacements de côté individuels entre 
l'échelle et la bordure. Ajoutez +i pour tracer une seconde bordure intérieure. Nous utilisons un écart uniforme entre les bordures de 2p et le  
stylo MAP_DEFAULTS_PEN à moins que d'autres valeurs ne soient spécifiées. Ajoutez  
+r pour dessiner des bordures rectangulaires arrondies au lieu de cela, avec un rayon d'angle de 6p. Vous pouvez remplacer ce rayon   en ajoutant une autre valeur.  
Enfin, ajoutez +s pour dessiner une région d'arrière-plan ombré décalé.  
Ici, dx/dy indique le décalage par rapport au cadre avant-plan  
[par défaut est "4p/-4p"] et shade définit le style de remplissage à utiliser pour l'ombrage [par défaut est "gray50"].

**rose** (str) - Dessiner une rose des vents directionnelle sur la carte à l'emplacement défini par  
les points de référence et d'ancrage.

**compass** (str) - Dessiner une rose magnétique sur la carte à l'emplacement défini par les points de référence et d'ancrage.

**verbose** (bool ou str) -
Sélectionner le niveau de verbitosité [par défaut est w], ce qui module les messages   
écrits sur stderr. Choisissez parmi 7 niveaux de verbitosité:

**panel** (bool ou int ou liste) - [ligne,colonne | index].    
Sélectionner un panneau de sous-figure spécifique. Autorisé uniquement en  
mode sous-figure. Utilisez panel = True pour passer au panneau suivant dans
l'ordre sélectionné. Au lieu de ligne,colonne, vous pouvez également donner une valeur scalaire, index qui dépend de l'ordre que vous définissez via autolabel  
lorsque le sous-plot a été défini. Note: ligne, colonne et index
tous commencent à 0.

**coltypes** (str) - [i|o] colinfo.    
Spécifier les types de données des colonnes d'entrée et/ou de sortie (données temporelles ou 
géographiques).

**perspective** (list or str) - [x|y|z] azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0].  
Sélectionner une vue en perspective et définir l'angle d'azimut et d'élévation du point de vue[ par défaut est [180,90]].


**transparency** (int ou float) - Définir le niveau de transparence, dans la plage de [0-100]
[par défaut est 0, c'est-à-dire opaque]. 
Visible uniquement lorsque la sortie PDF ou raster est sélectionnée.
Uniquement la sélection du format PNG ajoute une couche de transparence 
dans l'image (pour un traitement ultérieur).