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

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.

Aide détaillée : Aide:Géolocalisation#Modèle de paramétrage de carte.

Description détaillée

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

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

Les *fonctions* essentielles des modèles de paramétrage de carte
Code Wiki	Explication
`{{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 :

Les *fonctions* supplémentaires communes aux modèles de paramétrage de carte
Code Wiki	Explication
`{{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 :

Les *fonctions* supplémentaires requises par les modèles annexes : échelle, distance, déformation, ...
Code Wiki	Explication
`{{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:

La *fonction* `image` avec le prise en compte d'images alternatives
Code Wiki	Explication
`{{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 :

Les *fonctions* qui donnent la projection
Code Wiki	Explication
`{{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 :

La *fonction* supplémentaire pour les planètes et satellites
Code Wiki	Explication
`{{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

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.

Aide détaillée : Les systèmes de projection (aspects mathématiques).

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

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

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

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))

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 :

le procédé n'est pas limité à la seule projection équirectangulaire, mais est adaptable à tout système de projection.
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}})
plusieurs points, pictogrammes, signalétiques, toponymies peuvent être placées sur une carte
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)
le nombre "d'appel" au modèle de paramétrage de carte est réduit
le modèle {{Géolocalisation}} est très simple
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

Modèle:Catégorie principale

Modèle:Tableau de paramétrage de carte

Modèle:Géolocalisation/Russie/Exemple

Améliorations envisageables

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

L'ajout de la fonction genre est en cours.

Maintenance