Visão geral

É possível combinar vários tipos de gráficos com marcadores de linhas ou velas para destacar tendências de dados ou mostrar variações. Quando você adiciona marcadores de linha ou vela a gráficos de barras, dispersão ou outros, o gráfico resultante é chamado de gráfico composto. Alguns gráficos compostos parecem uma combinação de dois tipos de gráfico. Por exemplo, um gráfico de barras com uma linha de rastreamento:

enquanto outros parecem tipos de gráficos completamente novos, por exemplo, um gráfico de caixa:

.

Como criar um gráfico composto

Todos os gráficos compostos consistem em um ou mais tipos básicos de gráfico (linhas, dispersão, barras ou radar) combinados com um ou mais conjuntos de marcadores. Esses marcadores precisam de dados para que sejam inseridos no gráfico. Em alguns casos, é possível usar a mesma série de dados usada para desenhar as barras ou os pontos no gráfico, mas normalmente os marcadores precisam ter os próprios conjuntos de dados independentes. Se você quiser que o gráfico tenha séries de dados diferentes para o gráfico de base e para os marcadores, oculte os dados do marcador do gráfico de base para que ele não tente desenhar mais barras ou linhas com esses dados. Veja como fazer isso:

1. Adicione a série de dados dos marcadores ao final do parâmetro chd. Por exemplo, se o gráfico de barras tiver dados chd=t:30,10,20, será possível adicionar novos dados a um marcador de linha como este: chd=t:30,10,20|60,40,50.
2. Oculte os dados extras do marcador do gráfico básico. Se você simplesmente adicionar uma série de dados extra a um gráfico de barras para a linha de acompanhamento, o gráfico a mostrará como uma nova série de barras. Para evitar isso, é necessário ocultar essa série extra. Para ocultar uma série, inclua um único dígito após o descritor de formato chd: por exemplo, chd=t1:30,10,20|60,40,50. Esse dígito informa à API de gráficos quantas séries de dados usar para desenhar elementos para esse tipo de gráfico base, conforme definido pelo parâmetro cht (barras para gráficos de barras, pontos de dados para gráficos de linhas e assim por diante). Todas as outras séries de dados serão ignoradas por esse tipo de gráfico ao desenhá-lo. Observe que esse é um número baseado em 1, não em 0. Portanto, t1 significa "usar somente a primeira série de dados para barras", t2 significa "usar apenas as duas primeiras séries para barras" etc.
   1. Observações:
      1. Gráficos de dispersão: os gráficos de dispersão ocultam dados de uma maneira diferente. Consulte a documentação para saber mais detalhes.
      2. Gráficos de linhas lxy: especifica um número par de séries a serem exibidas (t0, t2, t4 etc.). Isso ocorre porque cada linha em um gráfico lxy é descrita por duas séries de dados: uma para os valores x e outra para os valores y.
3. Use as séries de dados ocultas para desenhar marcadores de vela, marcadores de linha ou outros. A forma de desenhar marcadores é abordada nas seções vinculadas. Faça referência à série de dados oculta como a fonte dos seus marcadores. Você pode incluir quantas séries de dados ocultas quiser e usá-las para outros marcadores do gráfico.

Aqui está o gráfico que acabamos de descrever:

cht=bvg
chd=t1:30,10,20|60,40,50
chm=D,0033FF,1,0,5,1

 

Tipos de gráficos

Apresentamos abaixo uma lista de tipos de marcadores e os tipos de gráficos com os quais podem ser usados:

Tipo de marcador	Tipos de gráficos base que o suportam
Linha	Linha, Dispersão, Barras, Radar
Velas	Linha, Barra
Todos os outros	Linha, Dispersão, Barras, Radar

Veja alguns exemplos de tipos de gráficos compostos que você pode criar:

Tipo de gráfico	Descrição	Exemplo
Gráficos de marcadores de linha	Os marcadores de linha podem ser usados para mostrar tendências em muitos outros tipos de gráficos.
Gráficos candlestick	Os gráficos de velas são usados com frequência para mostrar dados financeiros.
Diagramas de caixa	Os gráficos de caixa são usados para mostrar dados agrupados em quartis de intervalos.
Gráficos incorporados	Você pode incorporar um gráfico em outro.
Outros marcadores	Você pode ocultar os dados dos marcadores em qualquer um dos tipos de gráficos base aceitáveis e usar com outros tipos de marcadores que quiser.	chd=t1:   10,20,30,40,50,60,70,80   5,10,15,20,25,30,35,40,45,50 chm=o,000000,1,-1,5

Voltar ao início

 

Gráficos de marcadores de linha

Você pode adicionar linhas a gráficos de linhas, scatter, barras ou radar para destacar tendências.

Tipo de base + tipo de marcador	Descrição	Exemplo
Barra + linha	Este exemplo é de um gráfico de barras com uma linha de acompanhamento. As duas primeiras séries de dados são usadas para as barras empilhadas, e as séries restantes são usadas para a linha. chd=s2 indica que o gráfico precisa usar apenas as duas primeiras séries de barras. Os dados da terceira série são usados para a linha. chd=s2:1XQbnf4,EWoQMUB,9halxp9: codificação simples, em que as duas primeiras séries são usadas para desenhar as barras e a última série é usada para a linha. chm=D,0033FF,2,0,5,1: linha de rastreamento (D), azul, dados do índice de série 2, todos os pontos (0), a linha tem 5 pixels de largura e a ordem z de 1.	chm=   D,0033FF,2,0,5,1 chd=s2:   1XQbnf4,   EWoQMUB,   9halxp9
Dispersão + linha	Você pode adicionar uma linha a um gráfico de dispersão para mostrar médias. Os gráficos de dispersão ocultam os dados do marcador de maneira diferente. Consulte Gráficos de dispersão para mais detalhes.	chd=t:   12,16,16,24,26,28,41,51,66,68,13,45,81|   16,14,22,34,22,31,31,48,71,64,15,38,84 chm=   o,0000FF,0,-1,0|   o,FF0000,0,0:9:,5|   D,000000,1,10:,1,-1
Barra + linha	Este é outro gráfico de barras empilhadas com uma linha independente desenhada sobre ela.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=D,76A4FB,2,0,3
Barra + Círculos	Igual ao gráfico anterior, mas com marcadores de círculo em vez de um marcador de linha. Especificamos cada valor de dados de 0,5, o que adiciona pontos intermediários calculados na linha pontilhada.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=o,76A4FB,2,-.5,10

Voltar ao início

 

Gráficos candlestick

Os gráficos candlestick exigem pelo menos quatro séries de dados para desenhar as velas, além de séries adicionais para quaisquer outros elementos do gráfico. Os gráficos candlestick podem mostrar apenas um conjunto de marcadores de vela ou podem ser uma combinação desses elementos com gráficos de barras ou linhas, como mostrado aqui:

Tipo de base + tipo de marcador	Descrição	Exemplo
Linha (oculta) + Candlestick	Este exemplo mostra um gráfico que exibe somente marcadores de vela. chd=t0: 0 significa que todas as séries de dados estão ocultas para o tipo de gráfico básico (aqui, um gráfico de linhas), de modo que apenas as velas são desenhadas. O primeiro e o último valores de cada série são -1 para indicar os valores ausentes para evitar a exibição da primeira ou da última vela, que se sobreporiam ao eixo ou à margem do gráfico e seriam cortadas. chm=F,0000FF,0,-1,20: o F indica marcadores de vela (originalmente "marcadores financeiros"). 0000FF significa que os marcadores ficam azuis quando o valor está diminuindo. 0 indica que os dados das velas começam na série 0, -1 indica marcadores em todos os pontos. Também poderíamos ter especificado 0:4 aqui para ocultar a primeira e a última vela em vez de usar -1 valores de dados. 20 é a largura das velas.	cht=lc chd=t0:   -1,5,10,7,12,-1|   -1,25,45,47,24,-1|   -1,40,30,27,39,-1|   -1,55,63,59,80,-1 chm=F,0000FF,0,-1,20
Linha + Candlestick	Confira um exemplo de gráfico de linhas com marcadores de vela. Cinco séries de dados são fornecidas: a primeira é usada para o tipo de gráfico (linha) e as demais séries de dados "ocultas" são usadas para os marcadores de vela. O parâmetro chd=t1 especifica que somente a primeira série é usada para esse tipo de gráfico (gráfico de linhas). Omitimos o primeiro e o último marcadores de vela usando 1:4 no valor <which_points> porque o primeiro e o último marcador de vela são cortados pelas bordas da área do gráfico. O parâmetro chm especifica os marcadores de vela com a sintaxe F,<declining_color>,<data_series_index>,<which_points>,<width>,<order>.	cht=lc chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20
Linha + Candlestick	Outro exemplo de gráfico candlestick, mas com cores de preenchimento personalizadas.	chd=t1: t1:   90,80,70,50,40,30,20,10|   0,5,10,0,5,10,0|2,15,20,5,15,40,0|   5,35,20,2,35,20,0|   15,40,30,15,40,50,0 chm=   F,000000,1,1:-2,20
Bar + Candlestick	Este é um exemplo de gráfico de barras com marcadores de vela. Mostramos o primeiro e o último marcadores de vela aqui, porque as barras adicionam espaçamento suficiente para evitar que sejam cortadas pelos limites do gráfico.	cht=bvg chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20

Voltar ao início

 

Gráficos de caixa

Diagramas de caixa, também chamados de gráficos de caixa ou gráficos de caixa e bigode, são um tipo de gráfico que mostra o agrupamento de uma ou mais séries em quartis. Os quartis são grupos que abrangem 25% do intervalo de valores, com a possível exceção de outliers. Os gráficos de caixa são semelhantes aos gráficos candlestick, mas têm marcadores adicionados para a parte de baixo e de cima da vela, além de um marcador de 50%.

Um gráfico de caixa é composto totalmente de marcadores, como mostrado aqui:

chm=   F,0000FF,0,1,10	chm=   H,0000FF,0,1,1:10|   H,0000FF,3,1,1:10|   H,0000FF,4,1,1:10	chm=   o,FF0000,5,,5|   o,FF0000,6,,5
Um conjunto de marcadores de vela (chm=F) para o corpo das caixas:	Um conjunto de marcadores de forma de linha horizontais de comprimento ajustável (chm=H) para as linhas mínimas, 50o e 100o percentis:	Como opção, alguns marcadores de forma circular (chm=o) para mostrar valores atípicos no conjunto de dados.	Colocando tudo junto, você terá um gráfico de caixa!

O tipo de gráfico base para gráficos de caixa é qualquer um dos tipos de gráfico de barras (bhs, bvs, bhg, bvg) ou de linhas (lc, ls, lxy). No entanto, se você ocultar o tipo de gráfico base adicionando um zero ao parâmetro de formato de dados (por exemplo: chd=t0: ou chd=s0:), não importa o tipo de gráfico escolhido.

Um gráfico de caixa precisa ter pelo menos cinco séries de dados: quatro para as caixas e os marcadores máximo e mínimo, uma para o marcador de 50% e outras séries de dados para outros marcadores que você quiser, como os de outlier. Veja a ordem das séries recomendada. Se o valor na série 1 for maior que o valor correspondente na série 2, a caixa será preenchida com a cor do marcador chm=F. Se o valor na série 1 for menor que o da série 2, a caixa não será preenchida. Consulte Marcadores de vela para mais informações.

Ordem das séries para uma caixa não preenchida:

0. Valor mínimo
1. Marcador 25% (75% para uma caixa preenchida)
2. Marcador 75% (25% para uma caixa preenchida)
3. Valor máximo
4. Marcador 50%
5. A série seis e as posteriores são para quaisquer dados de marcadores adicionais, como os de valores extremos.

Na verdade, você pode colocar as séries de marcadores adicionais antes ou depois dos dados do marcador de vela, mas é mais simples colocar todas elas por último.

É possível criar diferentes estilos de gráficos de caixa especificando diferentes marcadores, tipos de gráficos base ou ordenando os dados de maneira distinta

Descrição	Exemplo
Este é um gráfico de caixa padrão, mas com cores diferentes atribuídas aos diferentes elementos do gráfico para destacar qual marcador está sendo usado para criar cada elemento do gráfico. cht=bvs: o tipo de gráfico base é bvs, mas nenhuma barra desse gráfico de base é realmente exibida. Poderíamos ter especificado qualquer tipo de gráfico composto aqui. chd=t0: o t0 oculta todas as linhas neste gráfico. Todos os dados serão usados somente para os marcadores. Nos dados, o primeiro e o último valores são -1 para evitar marcadores que se sobreponham às bordas esquerda e direita do gráfico. Todos os valores da segunda série são menores do que os valores correspondentes da terceira série. Portanto, todas as caixas não são preenchidas. -1,5,10,7,12,-1: valor mínimo: ponto inferior dos bastões laranjas inferiores. Também é a altura das linhas verdes horizontais. -1,25,30,27,24,-1 - valor de 25%: borda horizontal inferior das caixas laranjas. -1,40,45,47,39,-1: valor de 75%: borda horizontal superior das caixas laranjas. -1,55,63,59,80,-1: valor máximo: ponto superior dos bastões laranjas superiores; também a altura das linhas azuis horizontais. -1,30,40,35,30,-1: linhas pretas horizontais "Mediana" dentro das velas. -1,-1,5,70,90,-1: dados de outlier (círculos vermelhos) -1,-1,-1,80,5,-1: mais dados dos valores atípicos (círculos vermelhos). Os dados dos valores atípicos são divididos em dois conjuntos porque não é possível especificar dois marcadores, um acima do outro, na mesma série sem usar deslocamentos ou outros truques complicados. chm= – Dados do marcador, conforme descrito abaixo: F,FF9900,0,1:4,40: marcadores de vela laranja (F) usando quatro séries de dados começando na primeira série (0), nos pontos 1 a 4, tamanho 40. H,0CBF0B,0,1:4,1:20: marcadores de linha horizontais verdes mostrando o valor mínimo. Eles vêm da primeira série. H,0000FF,3,1:4,1:20: marcadores de linha horizontais azuis mostrando o valor máximo. Eles vêm da série 3. H,000000,4,1:4,1:40: marcadores de linha horizontais pretos mostrando o valor de 50%. Eles vêm da série 4. o,FF0000,5,-1,7: círculos vermelhos atribuídos à sexta série de dados para outliers. Os marcadores são atribuídos a todos os elementos desta série, que usa -1 para caixas sem valores atípicos. o,FF0000,6,-1,7: mais outliers. Outra série de dados é necessária quando você quer empilhar outliers uns sobre os outros em torno da mesma caixa.	cht=bvs chd=t0:   -1,5,10,7,12,-1|   -1,25,30,27,24,-1|   -1,40,45,47,39,-1|   -1,55,63,59,80,-1|   -1,30,40,35,30,-1|   -1,-1,5,70,90,-1|   -1,-1,-1,80,5,-1 chm=   F,FF9900,0,1:4,40|   H,0CBF0B,0,1:4,1:20|   H,000000,4,1:4,1:40|   H,0000FF,3,1:4,1:20|   o,FF0000,5,-1,7|   o,FF0000,6,-1,7
O tipo de gráfico lc sempre mostrará as linhas de eixos. Para criar um gráfico sem linhas de eixo, especifique o tipo de gráfico ls.	cht=lc    cht=ls
Para criar uma caixa preenchida, faça com que o ponto da segunda série seja maior que o ponto correspondente da terceira série. O valor maior está marcado em vermelho no código mostrado à direita.	chd=t0:   -1,5,10,7,12,-1   -1,40,30,27,24,-1   -1,25,45,47,39,-1   -1,55,63,59,80,-1

Voltar ao início

 

Gráficos incorporados

Você pode incorporar qualquer tipo de gráfico a um gráfico de barras, linhas, radar ou scatter usando ícones dinâmicos. Consulte a seção Gráficos incorporados da documentação do marcador "Ícones dinâmicos" (chem).

Voltar ao início

 

Recursos padrão

Os demais recursos nesta página são recursos de gráficos padrão.

Marcadores de linha chm=D [barras, velas, linhas, radar, dispersão]

Você pode adicionar uma linha que rastreie dados no seu gráfico. Na maioria das vezes, ele é usado em gráficos compostos.

Para adicionar várias linhas (ou combiná-las com outros marcadores chm), separe os conjuntos de parâmetros chm usando uma barra vertical ( | ). Não é possível criar um marcador de linha tracejada com esse parâmetro.

Sintaxe

chm=
  D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>

D

Indica que este é um marcador de linha.

<color>

A cor da linha, no formato hexadecimal RRGGBB.

<series_index>

O índice da série de dados usado para desenhar a linha. O índice da série de dados é 0 para a primeira, 1 para a segunda e assim por diante.

<which_points>

Os pontos de uma série a serem usados para desenhar a linha. Use um dos seguintes valores:

• 0: usa todos os pontos da série.
• start:end: usa um intervalo específico de pontos da série, do início ao fim, inclusive (índice baseado em zero). Também é possível usar valores de ponto flutuante para especificar pontos intermediários ou deixar start ou end em branco para indicar o primeiro ou o último ponto de dados, respectivamente. start e end podem ser negativos, como um índice inverso do último valor. Se start e end forem negativos, escreva-os em valor crescente (por exemplo, -6:-1).

<size>

A largura da linha em pixels.

<opt_z_order>

[Opcional] A camada em que o marcador será desenhado, em comparação com outros marcadores e com todos os outros elementos do gráfico. Esse é um número de ponto flutuante de -1,0 a 1,0, inclusive, em que -1,0 é o mínimo e 1,0 é o topo. Os elementos do gráfico (linhas e barras) ficam logo abaixo de zero. Se dois marcadores tiverem o mesmo valor, eles serão desenhados na ordem informada pelo URL. O valor padrão é 0.0 (logo acima dos elementos do gráfico).

 

Exemplos

Descrição	Exemplo
Este é um exemplo de como desenhar um marcador de linha em um gráfico de barras. A ordem z é definida como 1, então a linha é desenhada por cima das barras. Este exemplo usa os mesmos dados tanto para as barras como para a linha de dados.	chm=D,0033FF,0,0,5,1 chd=s:1XQbnf4
Este é o mesmo gráfico de barras, mas com uma série de dados adicionais apenas para a linha. É um exemplo de gráfico composto. Os gráficos compostos são exibidos com a adição de outras séries de dados ao parâmetro chd, além de um valor para chd, instruindo o gráfico a "ignorar" as outras séries de dados. Consulte Gráficos compostos para mais informações.	chm=D,0033FF,1,0,5,1 chd=s1:1XQbnf4,43ksfg6

Voltar ao início

Marcadores de forma chm [barras, linhas, radar, dispersão]

Você pode especificar marcadores gráficos para todos ou alguns pontos de dados em um gráfico. Se dois ou mais marcadores ocuparem o mesmo ponto, eles serão desenhados na ordem em que aparecerem no parâmetro chm. Você também pode criar marcadores de texto em pontos de dados, o que é abordado em Marcadores de pontos de dados.

Você pode combinar marcadores de forma com quaisquer outros parâmetros chm usando uma barra vertical ( | ) para separar os parâmetros chm.

Sintaxe

Especifique um conjunto com os parâmetros a seguir para cada série a ser marcada. Para marcar várias séries, crie conjuntos de parâmetros adicionais, delimitados por uma barra vertical. Não é necessário marcar todas as séries. Se você não atribuir marcadores a uma série de dados, ela não receberá marcadores.

Os marcadores de forma se comportam de maneira um pouco diferente nos gráficos de dispersão. Consulte a documentação para mais informações.

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>

@

[Opcional] Se você usar o caractere opcional "@" antes do tipo de marcador, os <opt_which_points> precisam usar o formato x:y.

<marker_type>

O tipo de marcador que será usado. Especifique um dos seguintes tipos:

• a: seta
• c - Cruzado
• C: retângulo. Se for um marcador de retângulo, você precisa ter pelo menos duas séries de dados, em que a série 0 especifica a borda inferior e a série 1 especifica a borda superior. <size> especifica a largura do retângulo em pixels.
• d: losango
• E: marcador da barra de erro ( ). Esse marcador requer a criação de duas séries de dados, um valor para a parte inferior e o ponto correspondente na segunda série para a parte superior. Ele também expõe uma sintaxe <size> estendida: line_thickness[:top_and_bottom_width], em que top_and_bottom_width é opcional. Veja os exemplos a seguir.
• h: linha horizontal do gráfico a uma altura especificada. O único formato válido para o parâmetro <opt_which_points> é n.d..
• H: linha horizontal que atravessa o marcador de dados especificado. É compatível com uma sintaxe <size> estendida que permite especificar um comprimento de linha exato: line_thickness[:length], em que :length é opcional, e o padrão é a largura total da área do gráfico.
• o: círculo
• s: quadrado
• v: linha vertical do eixo x até o ponto dos dados
• V: linha vertical de comprimento ajustável. É compatível com uma sintaxe estendida do valor <size>, que permite especificar um comprimento de linha exato: line_thickness[:length], em que :length é opcional, e o padrão é a altura completa da área do gráfico. O marcador é centralizado no ponto de dados.
• x: um X

<color>

A cor dos marcadores dessa série, no formato hexadecimal RRGGBB.

<series_index>

O índice da série de dados em que os marcadores serão desenhados, começando no zero. Ignorado para marcadores h e marcadores que especificam a localização pela posição x/y (começa com o caractere @). Você pode usar séries de dados ocultas como uma fonte para marcadores. Consulte Gráficos compostos para mais informações. Os gráficos de barras verticais agrupadas são compatíveis com uma sintaxe estendida especial para alinhar marcadores com barras específicas.

<opt_which_points>

[Opcional] Em quais pontos desenhar marcadores. O padrão é todos os marcadores. Use um dos seguintes valores:

• n.d: onde o marcador deve ser desenhado. O significado depende do tipo de marcador:
  • Todos os tipos, exceto h: em qual ponto de dados o marcador deve ser desenhado, em que n.d é o índice da série baseado em zero. Se você especificar um valor não inteiro, a fração indicará um ponto intermediário calculado. Por exemplo, 3,5 significa meio caminho entre os pontos 3 e os pontos 4.
  • h - um número de 0,0 a 1,0, em que 0,0 é a parte inferior do gráfico e 1,0 é o topo do gráfico.
• -1: desenha um marcador em todos os pontos de dados. Você também pode deixar esse parâmetro vazio para desenhar em todos os pontos de dados.
• -n: desenha um marcador a cada no ponto de dados. Valor de ponto flutuante. Se n for menor que 1, o gráfico calculará pontos intermediários adicionais para você. Por exemplo, -0,5 colocará o dobro de marcadores do que pontos de dados.
• start:end:n: desenhe um marcador em cada no ponto de dados em um intervalo, de valores de índice de start a end, inclusive. Todos os parâmetros são opcionais (podem estar ausentes). Portanto, 3::1 seria do quarto elemento para o último, etapa 1, e a omissão desse parâmetro usaria o padrão first:last:1 por padrão. Todos os valores podem ser números de ponto flutuante. start e end podem ser negativos, para contar de trás para frente a partir do último valor. Se start e end forem negativos, verifique se estão listados em ordem crescente de valor (por exemplo, -6:-1:1). Se o valor da etapa n for menor que 1, serão calculados pontos de dados adicionais por meio da interpolação dos valores de dados fornecidos. Os valores padrão são first:last:1
• x:y: desenhe um marcador em um ponto x/y específico no gráfico. Este ponto não precisa estar em uma linha. Adicione o caractere @ antes do tipo de marcador para usar essa opção. Especifique as coordenadas como valores de ponto flutuante, em que 0:0 é o canto inferior esquerdo e 1:1 é o canto superior direito. Por exemplo, para adicionar um losango vermelho de 15 pixels ao centro de um gráfico, use @d,FF0000,0,0.5:0.5,15.

<size>

O tamanho do marcador, em pixels. A maioria usa um único valor numérico para esse parâmetro. Os marcadores V, H e S são compatíveis com a sintaxe <size>[:width], em que a segunda parte opcional especifica o comprimento da linha ou do marcador.

<opt_z_order>

[Opcional] A camada em que o marcador será desenhado, em comparação com outros marcadores e com todos os outros elementos do gráfico. Esse é um número de ponto flutuante de -1,0 a 1,0, inclusive, em que -1,0 é o mínimo e 1,0 é o topo. Os elementos do gráfico (linhas e barras) ficam logo abaixo de zero. Se dois marcadores tiverem o mesmo valor, eles serão desenhados na ordem informada pelo URL. O valor padrão é 0.0 (logo acima dos elementos do gráfico).

<opt_offset>

[Opcional] Permite especificar deslocamentos horizontais e verticais do local especificado. Esta é a sintaxe, que usa um delimitador : (reserved:<horizontal_offset>:<vertical_offset>). Se especificado, você pode incluir um valor vazio na string de parâmetro chm para <opt_z_order>. Exemplos: o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20

• reservado: deixe em branco.
• <horizontal_offset>: um número positivo ou negativo que especifica o deslocamento horizontal, em pixels. Opcional. Deixe em branco se não for usado.
• <vertical_offset>: um número positivo ou negativo que especifica o deslocamento vertical, em pixels. Opcional. Deixe em branco se não for usado.

 

Exemplos

Descrição	Exemplo
Este é um exemplo com vários marcadores de forma e linha. a,990066,0,0.0,9.0: seta roxa, primeira série, primeiro ponto, tamanho 9. c,FF0000,0,1.0,20.0: cruz vermelha, primeira série, segundo ponto, tamanho 9. d,80C65A,0,2,20.0: losango verde, primeira série, terceiro ponto, tamanho 9. H,000000,0,3,1:40: linha horizontal preta, primeira série, ponto de dados 3, um pixel de largura, 40 pixels de comprimento. o,FF9900,0,4.0,12.0: círculo laranja, primeira série, quinto ponto, tamanho 12. s,3399CC,0,5.0,11.0: quadrado azul, primeira série, sexto ponto, tamanho 11. v,BBCCED,0,6.0,1.0: linha vertical até o ponto, primeira série, sétimo ponto, um pixel de largura. V,3399CC,0,7.0,1.0: linha vertical da base ao topo do gráfico, primeira série, oitavo ponto, um pixel de largura. x,FFCC33,0,8.0,20.0: "X" amarelo, primeira série, nono ponto, tamanho 20. H,FFFF00,0,9,2: linha horizontal amarela da largura do gráfico no ponto de dados 9. h,FF0000,0,0.5,1: linha horizontal vermelha na altura designada, primeira série, na metade do gráfico, um pixel de largura.	chm=   a,990066,0,0.0,9.0|   c,FF0000,0,1.0,20|   d,80C65A,0,2.0,20.0|   H,000000,0,3,1:40|   o,FF9900,0,4.0,12.0|   s,3399CC,0,5.0,11.0|   v,BBCCED,0,6,1.0|   V,3399CC,0,7,1.0|   x,FFCC33,0,8,20|   H,FFFF00,0,9,2|   h,FF0000,0,0.5,1
Este é um exemplo que usa losangos para uma série de dados e círculos para a outra série de dados. Se dois ou mais marcadores ocuparem o mesmo ponto, eles serão desenhados na ordem em que aparecem no parâmetro chm. Aqui, o círculo é o primeiro marcador especificado com chm, então ele é desenhado primeiro. O losango é especificado e desenhado em segundo lugar, o que resulta em ele sendo desenhado no topo do círculo.	chm=   o,FF9900,0,-1,15.0|   d,FF0000,1,-1,10.0
Este é um gráfico de linhas com um marcador em cada segundo ponto de dados (-2 significa um ponto em outro).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-2,6
Este gráfico de linhas tem o dobro de marcadores em comparação com pontos de dados (-0,5 significa cada meio ponto).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-.5,6
Este exemplo mostra como usar os marcadores h e v para criar linhas de grade com cores e espessura personalizadas. O valor da ordem z (o último valor) é definido como -1 para que as linhas de grade sejam desenhadas abaixo da linha de dados.	chm=   h,76A4FB,0,0:1:.2,2,-1|   V,76A4FB,0,::2,0.5,-1
Este gráfico adiciona linhas de preenchimento verticais a um gráfico de linhas: v: linhas verticais no gráfico FF0000: linhas vermelhas 0: índice da série : :.5: especificador de intervalo: do início ao fim, a cada 0,5 ponto. 2: espessura de 2 pixels.	chm=   v,FF0000,0,::.5,2
Este exemplo adiciona uma seta e um marcador de texto ao gráfico usando coordenadas exatas. O primeiro marcador D é a linha traçada abaixo das barras. O segundo marcador é a seta, e o terceiro é o texto da seta.	chm=   D,003971,1,0,3|   @a,000000,0,.25:.75,7|   @tExpected,000000,0,.35:.85,10
Uma linha horizontal fixa em um ponto de dados específico (H) pode ser útil para mostrar valores relativos ou enfatizar a altura de um valor de dados em um gráfico.	chm=H,FF0000,0,18,1
Este gráfico demonstra os marcadores que podem especificar a espessura e o comprimento da linha no parâmetro <size>. E,000000,0,6,1:20: barra de erro preta com linhas de 1 pixel de largura e barras de cima e de baixo de 20 pixels de comprimento. A parte inferior está ancorada no ponto 8 da série 0 e a parte superior está ancorada no ponto 8 da série 1. H,990066,1,2,5:50: linha horizontal roxa com cinco pixels de largura e 50 pixels de comprimento, centralizada no ponto de dados 2. V,3399CC,0,8,3:50- linha vertical azul com largura de três pixels e comprimento de 50 pixels, centralizada no ponto de dados 8.	title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50%7,1,2,5:50%CEchm=   E,000000,0,6,1:20|   H,990066,1,2,5:50|   V,3399CC,0,8,3:50

Voltar ao início

Marcadores de vela chm=F [barra, linha]

Os marcadores de vela indicam a variação e a mudança de direção em uma série de dados. Muitas vezes, eles são usados para mostrar valores de ações ao longo de um dia. O marcador inclui segmentos que mostram o valor alto e baixo, bem como o valor de abertura e fechamento de um período específico (normalmente um dia). Para saber mais sobre marcadores de vela, clique aqui.

Um marcador vela é desenhado como um retângulo dividido ao meio por uma linha vertical. São necessárias quatro séries de dados para desenhar um marcador de vela. Veja o que cada série especifica:

• As séries 1 e 4 especificam a parte inferior e superior da linha vertical, respectivamente. Normalmente, eles representam os valores baixos e altos do dia.
• As séries 2 e 3 especificam as bordas verticais do retângulo. A série 2 é o valor de abertura e a série 3 é o valor de fechamento. A cor do retângulo depende do que é maior: quando o valor de abertura (série 2) é menor que o valor de fechamento (série 3), o preço aumentou e o retângulo é preenchido com verde sólido por padrão. Quando o valor de abertura (série 2) é maior que o valor de fechamento (série 3), o preço diminuiu e o retângulo é preenchido com vermelho sólido por padrão. Só é possível especificar uma cor de preenchimento para o retângulo com valor decrescente. Quando você especifica isso, o retângulo com valor crescente não é preenchido (vazio). A série 2 pode ser a parte de cima ou de baixo do retângulo, dependendo se o preço subiu ou desce.

Você pode combinar os marcadores de vela com qualquer outro parâmetro chm usando uma barra vertical ( | ) para separar os parâmetros chm.

Observação:se você não quiser que as linhas dos dados usados para desenhar os marcadores apareçam no gráfico, inclua um 0 após o tipo de formato. Por exemplo: chd=t0:10,20,30,40 em uma string de dados de formato de texto. Consulte Gráficos compostos para mais informações.

Este é um exemplo que mostra as linhas de cada série:

Sintaxe

chm=
  F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>

F

Indica que este é um marcador de vela.

<opt_declining_color>

[Opcional] Cor de preenchimento dos retângulos quando o valor está diminuindo (quando o valor da série 2 é > o valor correspondente da série 3). É um número hexadecimal no formato RRGGBB. Quando os valores aumentam, o retângulo fica vazio. O padrão é verde sólido para crescente, vermelho sólido para decrescente. Não é possível especificar uma cor de preenchimento personalizada para valores crescentes.

<data_series_index>

O índice da série de dados a ser usada como a primeira série dos marcadores de vela. Esse índice começa no zero. Portanto, se você especificar 1 aqui e tiver seis séries, o segundo, terceiro, quarto e quinto serão usados para desenhar marcadores de vela.

<opt_which_points> (em inglês)

[Opcional] Especifica quais pontos de dados são usados para desenhar marcadores. O padrão é todos os marcadores. Use um dos seguintes formatos:

• n.d: desenhe um marcador em um único ponto na série, em que n.d é o índice do ponto na série. Se você especificar um valor não inteiro, a fração indicará um ponto intermediário calculado. Por exemplo, 3,5 significa meio caminho entre os pontos 3 e os pontos 4.
• -1: desenha um marcador em todos os pontos de dados. Você também pode deixar esse parâmetro vazio para desenhar em todos os marcadores.
• -n: desenha um marcador a cada no ponto de dados.
• start:end:n: desenha um marcador em cada n o ponto de dados em um intervalo, de valores de índice start a end, inclusive. Todos os parâmetros são opcionais (podem estar ausentes). Portanto, 3::1 seria do quarto elemento para o último, etapa 1, e a omissão desse parâmetro usaria o padrão first:last:1 por padrão. Todos os valores podem ser números de ponto flutuante. start e end podem ser negativos, para contar de trás para frente a partir do último valor. Se start e end forem negativos, verifique se estão listados em ordem crescente de valor (por exemplo, -6:-1:1). Se o valor da etapa n for menor que 1, pontos de dados adicionais serão calculados por meio da interpolação dos valores de dados fornecidos. Os valores padrão são first:last:1

<largura>

A largura de todos os retângulos, em pixels.

<opt_z_order>

[Opcional] A camada em que o marcador será desenhado, em comparação com outros marcadores e com todos os outros elementos do gráfico. Esse é um número de ponto flutuante de -1,0 a 1,0, inclusive, em que -1,0 é o mínimo e 1,0 é o topo. Os elementos do gráfico (linhas e barras) ficam logo abaixo de zero. Se dois marcadores tiverem o mesmo valor, eles serão desenhados na ordem informada pelo URL. O valor padrão é 0.0 (logo acima dos elementos do gráfico).

 

Exemplos

Descrição	Exemplo
Este é um exemplo de marcadores de vela em um gráfico de linhas com quatro séries. A cor de preenchimento personalizada 0000FF (azul) é especificada. Essa cor é usada para preencher os retângulos quando o ponto na série 3 é menor que o ponto equivalente na série 2. O primeiro e último retângulos são cortados pelo gráfico. Para eliminar esses valores, especifique 1:4 para o quarto parâmetro de chm. Observe o zero na string de dados para ocultar as linhas da série: chd=t0. Isso indica que todos os dados do gráfico devem ser usados pelos marcadores. O parâmetro <which_point> está em branco, o que desenha velas em todos os pontos de dados.	chd=t0:   0, 5,10, 7,12, 6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,60 chm=F,0000FF,0,,20
Veja um exemplo do mesmo gráfico, usando as cores padrão e removendo o primeiro e o último item. Este é um gráfico composto: é uma combinação de um gráfico de linhas (o tipo de gráfico base) e marcadores de vela. O valor de 1 em cht=t:1 significa que todas as séries de dados após a primeira devem ser ocultadas do tipo de gráfico básico (gráfico de linhas). O primeiro 1 em chm=F,,1,1:4,20 significa que os dados das velas são das séries 2, 3, 4 e 5 (o 1 é baseado em zero). Consulte Gráficos compostos para mais informações sobre como desenhar um gráfico composto como este.	cht=lc chm=   F,,1,1:4,20 chd=t1:   15,40,30,27,39,54|   ...

Voltar ao início