Módulo:Graph/doc

Módulo com funções auxiliares para a extensão Gráfico para exibir gráficos e mapas. A partir de de:Modul:Graph.

Funções para predefinições

map

Cria um objeto JSON para <graph> para exibir um mapa político com destaques coloridos. No namespace do artigo, a predefinição {{Graph:Map}} deve ser usada. Veja sua página para casos de uso.

Os mapas podem ser encontrados em Especial:Índice por prefixo/Predefinição:Graph:Map/Inner/ (por exemplo Worldmap2c-json com as fronteiras dos países) e novos mapas também devem ser salvos em Módulo:Graph/.

Parâmetros:

• basemap: define o mapa básico. As definições do mapa devem seguir o formato TopoJSON e se salvos na Wikipedia estão disponíveis para este módulo. Mapas no diretório padrão Especial:Índice por prefixo/Predefinição:Graph:Map/Inner/ como Worldmap2c-json só deve ser referenciado por seu nome, omitindo o prefixo Modul:Graph/ para permitir uma melhor portabilidade. O parâmetro também aceita URLs, por exemplo mapas de outras versões da Wikipedia (o link deve seguir o esquema de//en.wikipedia.org/w/index.php?title=mapname&action=raw, ou seja, relativo ao protocolo sem http/s inicial e uma ação final = raw para buscar apenas o conteúdo bruto). URLs para mapas em sites externos devem ser evitados por questões de estabilidade, desempenho e segurança do link, e deve-se considerar que ela está bloqueada pelo software ou navegador de qualquer maneira.
• scale: o fator de escala do mapa (padrão: 100)
• projection: A projeção cartográfica a ser utilizada. Os valores suportados estão listados em https://github.com/mbostock/d3/wiki/Geo-Projections. O valor padrão é equirretangular para uma projeção cilíndrica equidistante.
• center: centro do mapa (corresponde nos dados do mapa a ambos os valores separados por vírgula do campo scale)
• feature: quais objetos geográficos devem ser exibidos (corresponde nos dados do mapa ao nome do campo no campo objects). O padrão é valor countries.
• ids of geographic entities: Os nomes dos parâmetros reais dependem do mapa básico e do recurso selecionado. Por exemplo, para o mapa mundial mencionado acima, os ids são códigos de país ISO. Os valores podem ser cores ou números, caso as entidades geográficas devam ser associadas a dados numéricos: DE=lightblue marca a Alemanha na cor azul claro e DE=80.6 atribui a Alemanha o valor 80,6 (população em milhões). Neste último caso, a cor real depende dos seguintes parâmetros.
• colorScale: a paleta de cores a ser usada para a escala de cores. A paleta deve ser fornecida como uma lista separada por vírgulas de valores de cores. Os valores de cor devem ser fornecidos como #rgb/#rrggbb ou por um nome da cor CSS. Em vez de uma lista, as paletas de cores integradas category10 e category20 também podem ser usadsa.
• scaleType: os valores suportados são linear para um mapeamento linear entre os valores dos dados e a escala de cores, log para um mapeamento de log, pow para um mapeamento de potência (o expoente pode ser fornecido como pow 0.5), sqrt para um mapeamento de raiz quadrada e quantize para uma escala quantizada , ou seja, os dados são agrupados em tantas classes quantas as cores da paleta.
• domainMin: limite inferior dos valores de dados, ou seja, valores de dados menores são mapeados para o limite inferior
• domainMax: limite superior dos valores de dados, ou seja, valores de dados maiores são mapeados para o limite superior
• legend: mostrar legenda de cores (não funciona com quantize)
• defaultValue: valor padrão para entidades geográficas não utilizadas. No caso dos valores de id serem cores o valor padrão é silver, no caso de números é 0.
• formatjson: formate o objeto JSON para melhor legibilidade

Predefinições de invólucro

As funções mapWrapper e chartWrapper são wrappers para passar todos os parâmetros do modelo de chamada para as respectivas funções map e chart.

Nota: Na visualização do editor, a extensão do gráfico cria um elemento canvas com gráficos vetoriais. No entanto, ao salvar a página, um gráfico raster PNG é gerado. {{#invoke:Graph|function_wrapper_name}}