Wikinews

Wikinews:Jargon/Modèle de paramétrage de carte

Modèle:Patch Jargon Cette page décrit les caractéristiques d'un "Modèle de paramétrage de carte".

Définition

modifier

Un modèle de paramétrage de carte est une sous-page de Modèle:Géolocalisation de la forme Modèle:Géolocalisation/<nom de code de la carte> qui fournit des informations (métadonnées) sur l'image d'une carte géographique. Un tel modèle est employé (entre autres) par le modèle {{G}} où il assure la conversion des coordonnées (latitude, longitude) d'un emplacement, en position (x, y) sur la carte ; ce qui permet une géolocalisation.


Description détaillée

modifier

Modèle:Catégorie principale Un nom d'un modèle de paramétrage de carte est Modèle:Géolocalisation/<nom de code de carte>. Ce type de modèle est avant tout employé par le modèle {{G}} ({{G/dms}}, {{Géolocalisation}} ou autres modèles similaires) ainsi : 

 {{G|<nom de code de carte>|<latitude>|<longitude>|<toponyme>|<point>|<arg1>|<arg2>}}

Les fonctions

modifier

Voici les fonctions que ce type de modèle doit assurer au minimum pour que la géolocalisation fonctionne :

Code Wiki Explication
Les fonctions essentielles des modèles de paramétrage de carte
{{Géolocalisation/<nom>|y|<latitude>|<longitude>}} retourne un coefficient qui, multiplié à une largeur donnée pour l'image, donne la position verticale sur l'image d'un lieu dont les coordonnées géographiques sont passées en paramètres.
{{Géolocalisation/<nom>|x|<latitude>|<longitude>}} retourne un coefficient qui, multiplié à une largeur donnée pour l'image, donne la position horizontale sur l'image d'un lieu dont les coordonnées géographiques sont passées en paramètres.
{{Géolocalisation/<nom>|image}} retourne le nom de l'image (sans l'espace de noms).

Les fonctions supplémentaires suivantes ne sont pas nécessaires à la géolocalisation ; mais apporte des informations très utiles pour la documentation, la catégorisation, et l'utilisation du modèle. La présence de ces paramètres est donc devenue obligatoire :

Code Wiki Explication
Les fonctions supplémentaires communes aux modèles de paramétrage de carte
{{Géolocalisation/<nom>|name}} Lien (sans [[ ]]) vers l'article correspondant à la région (zone) représentée. Cela correspond le plus souvent au nom de code de la carte. Plus rarement, il faut employer la syntaxe <page>{{!}}<nom> ; par exemple : 
|name=Géorgie (pays){{!}}Géorgie
{{Géolocalisation/<nom>|zone}} Modèle:Wikipédia:Jargon/Fonction genre
{{Géolocalisation/<nom>|genre}} Modèle:Wikipédia:Jargon/Fonction zone
{{Géolocalisation/<nom>|geo}} Modèle:Wikipédia:Jargon/Paramètre geo

De même, les modèles annexes de Catégorie:Modèle de fonction mathématique pour la cartographie réclament certaines des fonctions suivantes :

Code Wiki Explication
Les fonctions supplémentaires requises par les modèles annexes : échelle, distance, déformation, ...
{{Géolocalisation/<nom>|iwidth}} retourne la largeur de l'image en pixels
{{Géolocalisation/<nom>|iheight}} retourne la hauteur de l'image en pixels
{{Géolocalisation/<nom>|latitude}} retourne (une estimation de[1]) la latitude au centre de la carte.
{{Géolocalisation/<nom>|top}} retourne la latitude sur le méridien centrale en haut de la carte.
{{Géolocalisation/<nom>|bottom}} retourne la latitude sur le méridien centrale en bas de la carte.
{{Géolocalisation/<nom>|longitude}} retourne la longitude au centre de la carte.
{{Géolocalisation/<nom>|left}} retourne la longitude sur le parallèle centrale à gauche de la carte.
{{Géolocalisation/<nom>|right}} retourne la longitude sur le parallèle centrale à droite de la carte.
Important
Si le paramétrage de la carte n'est pas satisfaisant, vous devez blanchir le paramétre iwidth. En effet, un modèle de paramétrage de carte est susceptible d'être employé automatiquement dans des infobox telles que {{Infobox Montagne}}. Cependant si iwidth est laissé vierge, le modèle est considéré « pas fini » et ne sera pas utilisé.

Les images alternatives:

Code Wiki Explication
La fonction image avec le prise en compte d'images alternatives
{{Géolocalisation/<nom>|image|<type>}} retourne le nom de l'image (sans l'espace de noms). <type> est facultatif et permet de prendre en compte des images alternatives pour certaines cartes.

La projection employée :

Code Wiki Explication
Les fonctions qui donnent la projection
{{Géolocalisation/<nom>|modèle}} Les modèles génériques retournent leur nom (par exemple {{Géolocalisation/Projection conique avec DL}} retourne « Projection conique avec DL »). Cela permet de détecter si le modèle à été optimisé.
{{Géolocalisation/<nom>|projection}} retourne la même valeur que modèle ; mais pour tous les modèles.

Enfin, lorsque la zone est planète, la fonction suivantes est obligatoire :

Code Wiki Explication
La fonction supplémentaire pour les planètes et satellites
{{Géolocalisation/<nom>|diamètre}} retourne la valeur du diamètre (équatorial) de la planète en km.

Modèle:...

Le code wiki de ces modèles prend la forme suivante : 

{{#switch:{{{1}}} 
|y={{#expr: ... }} 
|x={{#expr: ... }}
|image=...
|iwidth=...
|iheight=...
...
}}</includeonly><noinclude>
{{Documentation paramétrage de carte}}
</noinclude>

Les modèles génériques

modifier

Modèle:Catégorie principale Cependant ces modèles peuvent être construit à l'aide de modèles génériques (ou méta-modèle) dont le nom prend la forme Modèle:Géolocalisation/Projection <type>. Les modèles génériques assure une fonction supplémentaire : {{Géolocalisation/<nom>|code}} qui permet le remplacement du modèle générique par une version optimisée. Un modèle générique doit assurer une fonction supplémentaire : la fonction {{Géolocalisation/<nom>|code}} qui doit retourner le code d'un modèle équivalent sous une forme optimisée. Il peut également assurer des fonctions pour ses propres arguments (entre autres).

Le plus couramment employé est {{Géolocalisation/Projection équirectangulaire}} pour la projection équirectangulaire.

   Attention ! l'écriture de modèles génériques de paramétrage de carte, et particulièrement de leur fonction code est extrêmement délicate. Il est donc fortement recommandé de ne pas y toucher sans une parfaite connaissance de la syntaxe wiki et de bonnes connaissances en mathématiques. Modèle:Wikipédia:Jargon/Modèle de paramétrage de carte/Projection

La version optimisée

modifier
Qu'est-ce que c'est ?
Un modèle de paramétrage de carte recourt (donc tout d'abord) à un modèle générique. L'utilisation de ce méta-modèle est coûteuse (en mémoire aussi bien qu'en temps de calcul). Une fois les paramètres convenablement ajustés, un modèle de paramétrage de carte peut-être optimisé. Il s'agit là d'une forme de "subst:itution" du méta-modèle.
Comment cela fonctionne ?
Pour alléger le code d'un modèle de paramétrage de carte qui emploie un modèle générique, les modèles génériques disposent d'une fonction supplémentaire code
{{Géolocalisation/<nom>|code|...}}
qui retourne un code de substitution pour le modèle de paramétrage de carte qui l'emploie.
Pourquoi optimiser le modèle ?
La version optimisée simplifie considérablement les formules de conversion.
Un exemple

Voici comment fonctionne l'évaluation de {{Géolocalisation/Chine|x|2=<latitude>|3=<longitude>}} (c'est sans commentaires) :

Avant optimisation Après optimisation
Comparaisons entre les versions avant et après optimisation

On a à évaluer 

{{Géolocalisation/Projection conique équidistante
|{{{1}}}|{{{2}}}|{{{3}}}
|top=57
|bottom=17.96
|left=73
|right=135
|image={{#switch: {{{2|}}}
|relief=China edcp relief location map.jpg
|#default=China edcp location map.svg
}}
|iwidth=1181
|iheight=940
|name=Chine
|zone=pays
|geo=-54
|longitude=104
|latitude1=42
|latitude2=30
}}

qui (c'est exceptionnel) fait appel a un second modèle générique : 

{{Géolocalisation/Projection conique linéaire
<!-- ... -->
|n=(
(cos({{{latitude1}}}*pi/180)-cos({{{latitude2}}}*pi/180))/
(({{{latitude2}}}-{{{latitude1}}})*pi/180)
)
|latitudeG=(
({{{latitude2}}}-{{{latitude1}}})
*cos({{{latitude1}}}*pi/180)/
(cos({{{latitude1}}}*pi/180)-cos({{{latitude2}}}*pi/180))
+
{{{latitude1}}}
)
|dx={{{dx|1}}}
}}

Finalement, la formule 

100*({{#if:{{{x0|}}}| ({{{x0}}})/({{{iwidth}}}) | 0.5}} + 
     ({{{dx|1}}})*(({{{iheight}}})/({{{iwidth}}}))/
     ({{{top}}}-({{{bottom}}}))*({{{latitudeG|90}}}-({{{2}}}))* 
sin(
     ({{{n|sin(({{{latitude0|({{{top}}}+{{{bottom}}})*0.5}}})*pi/180)}}})
     * pi/180 *({{{3}}}-({{{longitude}}})) 
   ) 
)

est évaluée. Ce qui donne après simplification : 

100*(0.5 + 
     (1)*((940)/(1181))/
     (57-(17.96))*(
     (30-42)
     *cos(42*pi/180)/
     (cos({42*pi/180)-cos(30*pi/180))
     +42
     -({{{2}}}))* 
sin(
     ((
      (cos(42*pi/180)-cos(30*pi/180))/
      ((30-42)*pi/180)
     ))
     * pi/180 *({{{3}}}-(104)) 
   ) 
)

La formule 

(50 + 
  2.0387695895393*(114.57239531739-({{{2}}}))* 
  sin(0.010240048192254*({{{3}}}-104) ) 
)

est évaluée.

 
Quand optimiser le modèle ?
Dès que le paramétrage est bon.
Comment optimiser le modèle ?
  Aide détaillée : Comment optimiser le modèle ?.

Images alternatives

modifier

Un modèle de paramétrage de carte permet également de recenser des images alternatives à la condition qu'elles aient même cadrage[2]. Pour que la prise en compte d'autre images soit possible, il faut d'abord optimiser le modèle.

Ensuite il faut remplacer 

|image=<nom de l'image par défaut>

par 

|image={{#switch: {{{2|}}}
|départementale
|administrative=<autre nom>
|relief=<autre nom>
|blank
|#default=<nom de l'image par défaut>
}}

Ici administrative, départementale[3], blank et relief sont les types des images alternatives. On obtient alors le nom de l'image de la carte administrative d'un <pays> avec : 

 {{Géolocalisation/<pays>|image|administrative}}

En revanche 

{{Géolocalisation/<pays>|image|n'importe quoi}}

ne génère pas d'erreur, mais retournera l'image par défaut.


Recommandation pour les types standards et suggestions
<type> Description
par défaut L'image la meilleur pour la géolocalisation : une carte administrative sans toponyme pas trop chargée

(pas ou peu de découpages)

administrative[4] Avec un découpage administratif
relief[4] L'image de la carte topographique
blank Une carte "vierge" (sans découpage administratif, ni toponyme)
<région> Lorsque l'image met en valeur une zone donnée nommée <région>.[5]
départementale, régionale, provinces, landers, états, population De simples suggestions

Suggestion pour le nom des images

modifier

Si l'on adopte pour le nom des images la nomenclature 

 Image:<nom de code de la carte> (<type>).svg

on peut alors écrire : 

|image={{#ifexist:<nom de code de la carte> ({{{2|}}}).svg
|<nom de code de la carte> ({{{2|}}}).svg
|<nom de code de la carte> (blank).svg
}}

ou simplement (mais c'est moins "fiable") 

|image=<nom de code de la carte> ({{{2|}}}).svg

Comparaisons avec la version ((en))

modifier

Contrairement à la version ((en)) (cf. en:Template:Location map), un modèle de paramétrage de carte ne contient pas seulement des paramètres d'une carte, mais également les fonctions de conversion coordoonnées géographiques → position sur la carte. Cela présente de multiples avantages :

  1. le procédé n'est pas limité à la seule projection équirectangulaire, mais est adaptable à tout système de projection.
  2. le procédé permet également de paramétrer des "sous-cartes" en encadré (par exemple, l'Alaska et Hawaï pour le modèle {{Géolocalisation/États-Unis}} ; voir {{Carte/États-Unis}})
  3. plusieurs points, pictogrammes, signalétiques, toponymies peuvent être placées sur une carte
  4. le paramétrage est plus complet et permet des calculs annexes : échelle, déformation, cadrage, taille de la signalétique (voir Liste des mers lunaires)
  5. le nombre "d'appel" au modèle de paramétrage de carte est réduit
  6. le modèle {{Géolocalisation}} est très simple
  7. l'emploie d'une version optimisée permet de réduire le coût des calculs de conversion.

En revanche, un modèle de paramétrage de carte est plus complexe (il suffit de comparer Modèle:Géolocalisation/Iran et en:Template:Location map of Iran). C'est pourquoi un modèle de paramétrage de carte doit d'abord être créé à l'aide d'un modèle générique.

Exemples

modifier

Modèle:Catégorie principale

{{Géolocalisation/Iran}}

modifier

Modèle:Tableau de paramétrage de carte

{{Géolocalisation/Russie}}

modifier

Modèle:Géolocalisation/Russie/Exemple

Améliorations envisageables

modifier

Préposition, article défini approprié (et contraction éventuelle)

modifier

L'ajout de la fonction genre est en cours.

Maintenance

modifier

Modèle:Catégorie principale

Notes

modifier
  1. ↑ Lorsque la projection n'est pas équirectangulaire, la valeur retournée est parfois approximative. Essentiellement, ce paramètre (et {{Géolocalisation/<nom>|longitude}}, ou {{Latitude}} et {{Longitude}}) permet de placer des étiquettes sur des cartes plus importantes (voir Projet:Cartographie/Géolocalisation/Maintenance/Carte des pays par exemple).
  2. ↑ ... et même proportion. En revanche la taille de l'image peut être différente, mais il faudra alors fournir le paramètre largeur aux modèles.
  3. ↑ les redondances (c'est à dire, plusieurs types pour une même image) sont les bienvenus
  4. ↑ 4,0 et 4,1 terme polyglotte.
  5. ↑ On peut aussi opter pour une numérotation (voir par exemple Image:Iran locator1.png).

Voir aussi

modifier
Récupérée de « https://fr.wikinews.org/w/index.php?title=Wikinews:Jargon/Modèle_de_paramétrage_de_carte&oldid=227439 »