Gráficos compostos

  

Visão geral

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

Gráfico de barras com linha de acompanhamento

enquanto outros parecem tipos de gráfico completamente novos, como um gráfico de caixa:

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áficos (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. Às vezes, é possível usar a mesma série de dados usada para desenhar as barras ou os pontos no gráfico, mas o normal é que os marcadores tenham conjuntos de dados próprios independentes. Se você quiser que o gráfico tenha séries de dados diferentes para o gráfico base e para os marcadores, oculte os dados dos marcadores do gráfico base para que ele não tente desenhar mais barras ou linhas com esses dados. Veja como fazer isso:

  1. Adicione sua série de dados aos marcadores no fim do parâmetro chd. Por exemplo, se o gráfico de barras tivesse dados chd=t:30,10,20, você poderia adicionar novos dados para um marcador de linha como este: chd=t:30,10,20|60,40,50.
  2. Oculte os dados dos marcadores extras do gráfico base. Se você simplesmente adicionar uma série de dados extra a um gráfico de barras para sua linha de acompanhamento, o gráfico a mostrará como uma nova série de barras. Para evitar isso, oculte 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 o 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 etc.). Todas as outras séries de dados serão ignoradas por esse tipo de gráfico ao desenhar o gráfico. Esse é um número baseado em 1, não em 0. Portanto, t1 significa "usar apenas a primeira série de dados para barras", t2 significa "usar somente 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 outra maneira. Consulte a documentação para mais detalhes.
      2. Gráficos de linhas lxy: especifique 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 candlestick, de linha ou outros marcadores. O modo de desenhar marcadores é abordado nas seções vinculadas. Faça referência às séries de dados ocultas como fonte dos seus marcadores. Você pode incluir quantas séries de dados ocultas quiser e usá-las para outros marcadores de gráfico.

Veja o gráfico que acabamos de descrever:

Gráfico de barras com marcador de linha
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
Linhas Linha, Dispersão, Barra, Radar
Velas Linha, Barra
Todos os outros Linha, Dispersão, Barra, 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áfico de barras com marcador de linhaGráfico de barras com marcador de linha
Gráficos candlestick Os gráficos de velas são usados com frequência para mostrar dados financeiros. Gráfico de linhas com uma linha laranja e quatro marcadores financeiros.
Gráficos de caixa

Os gráficos de caixa são usados para mostrar dados agrupados em quartis de intervalos.

Gráfico de linhas com uma linha laranja e quatro marcadores financeiros.
Gráficos incorporados Você pode incorporar um gráfico em outro. Gráfico incorporado
Outros marcadores Você pode ocultar os dados dos marcadores em qualquer um dos tipos de gráficos base aceitos e usá-los com qualquer outro tipo de marcador 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 com marcadores de linha

É possível 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 para as 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 para a linha.
  • chm=D,0033FF,2,0,5,1: linha de trace (D), azul, dados do índice de série 2, todos os pontos (0), linha com 5 pixels de largura e ordem z de 1.
Gráfico de barras com marcador de linha
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 dos marcadores de outra forma. 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

Veja outro gráfico de barras empilhadas com uma linha independente sobre ele.

Gráfico de barras com marcador de linha
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 Gráfico igual ao 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 à linha pontilhada. Gráfico de barras com marcador de linha
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 candlestick ou podem ser uma combinação de marcadores candlestick com gráficos de barras ou linhas, conforme 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: o 0 significa que todas as séries de dados estão ocultas do tipo de gráfico básico (neste caso, um gráfico de linhas), então apenas as velas são desenhadas. O primeiro e o último valores em cada série são -1 para indicar valores ausentes para evitar o desenho da primeira ou da última vela, que sobreporia o eixo ou a margem do gráfico e seria cortada.
  • chm=F,0000FF,0,-1,20: F indica marcadores de vela (originalmente "marcadores financeiros"). 0000FF significa que os marcadores são azuis quando o valor está diminuindo; 0 indica que os dados das velas começam na série 0; -1 indica os marcadores de todos os pontos (poderíamos também ter especificado 0:4 aqui para ocultar o primeiro e o último candlestick em vez de usar os valores de dados -1); 20 é a largura dos candlesticks.
Gráfico de velas básico
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 (de linhas) e as demais séries de dados "ocultas" são usadas para os marcadores de vela. O parâmetro chd=t1 especifica que apenas 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 marcadores 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>.

Gráfico de linhas com uma linha laranja e quatro marcadores financeiros.
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.

Gráfico de barras com marcador de linha
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
Barra + 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 cortados pelos limites do gráfico.

Gráfico de linhas com uma linha laranja e quatro marcadores financeiros.
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

Os gráficos de caixa, também chamados de gráficos de caixa ou gráficos de caixa e de bigodes, 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 dos valores atípicos. Os gráficos de caixa são semelhantes aos gráficos candlestick, mas com marcadores adicionais para a parte inferior e superior do candlestick, além de um marcador de 50o percentil.

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

Marcador de vela
chm=
  F,0000FF,0,1,10
Marcador de vela
chm=
  H,0000FF,0,1,1:10|
  H,0000FF,3,1,1:10|
  H,0000FF,4,1,1:10
Marcador de vela
chm=
  o,FF0000,5,,5|
  o,FF0000,6,,5
Marcador de vela
Um conjunto de marcadores candlestick (chm=F) para o corpo das caixas: Um conjunto de marcadores de forma de linha horizontal (chm=H) de comprimento ajustável para as linhas de mínimo, 50o e 100o percentil: Opcionalmente, 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 dos gráficos de caixa é qualquer um dos tipos de gráfico de barras (bhs, bvs, bhg, bvg) ou de linhas (lc, ls, lxy). Mas, se você ocultar o tipo de gráfico de base adicionando um zero no parâmetro de formato de dados (por exemplo: chd=t0: ou chd=s0:), o tipo de gráfico escolhido não será relevante.

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%; além de qualquer série de dados adicional para marcadores adicionais que você queira, como marcadores atípicos. Veja a ordem recomendada das séries. Se o valor na série 1 for maior que o valor correspondente na série 2, a caixa vai ser preenchida com a cor do marcador chm=F. Se o valor na série 1 for menor que o valor na série 2, a caixa não vai ser preenchida. Consulte Marcadores candlestick para mais informações.

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

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

Você pode colocar as séries de marcadores adicionais antes ou depois dos dados dos marcadores de vela, mas é mais simples colocar todas por último.

Você pode criar estilos diferentes de gráficos de caixa especificando marcadores, tipos de gráficos base ou ordenando os dados de maneiras diferentes

Descrição Exemplo

Este é um gráfico de caixa padrão, mas com cores diferentes atribuídas aos diversos elementos do gráfico para destacar qual marcador está sendo usado para criar cada elemento.

  • cht=bvs: o tipo de gráfico base é bvs, mas nenhuma barra é exibida. Poderíamos ter especificado qualquer tipo de gráfico composto aqui.
  • chd=t0: o t0 oculta todas as linhas do 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 a existência de marcadores que se sobreponham às bordas esquerda e direita do gráfico. Todos os valores da segunda série são menores que os valores correspondentes da terceira série, portanto, todas as caixas ficam vazias.
    • -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.
    • Valor de -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 "Mediana" pretas e horizontais dentro dos candlesticks.
    • -1,-1,5,70,90,-1 – Dados atípicos (círculos vermelhos)
    • -1,-1,-1,80,5,-1: mais dados dos outliers (círculos vermelhos). Os dados dos outliers 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 pela primeira (0), nos pontos de 1 a 4, tamanho 40.
    • H,0CBF0B,0,1:4,1:20: marcadores de linha horizontais verdes que mostram o valor mínimo. Eles vêm da primeira série.
    • H,0000FF,3,1:4,1:20: marcadores de linha horizontais azuis que mostram o valor máximo. Eles vêm da série 3.
    • H,000000,4,1:4,1:40: marcadores de linha horizontais pretos que mostram 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 dessa 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 na mesma caixa.

Gráfico de barras verticais com dois conjuntos de dados: um em azul escuro e o outro empilhado em azul claro

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.
O tipo de gráfico lc mostra as bordas
  cht=lc
O tipo de gráfico ls não mostra as bordas
   cht=ls
Para criar uma caixa preenchida, torne o ponto da segunda série maior que o ponto correspondente da terceira série. O valor maior está marcado em vermelho no código mostrado à direita. Gráfico de barras verticais com dois conjuntos de dados: um em azul escuro e o outro empilhado em azul claro
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

Gráfico de setores incorporado em um gráfico de linhas

É possível 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 de í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 [barra, vela, linha, radar, dispersão]

É possível adicionar uma linha que trace os dados no seu gráfico. Na maioria das vezes, ele é usado em gráficos compostos.

Para adicionar várias linhas (ou combinar 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 usada para desenhar a linha. O índice da série de dados é 0 para a primeira série de dados, 1 para a segunda e assim por diante.
<which_points>
Quais pontos de uma série usar 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, de start ao end, inclusive (índice baseado em zero). Use também valores de ponto flutuante para especificar pontos intermediários ou deixe 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 é a parte inferior e 1,0 é a parte superior. 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 sobre as barras.

Este exemplo usa os mesmos dados tanto para as barras como para a linha de dados.
Gráfico de barras com marcador de linha
chm=D,0033FF,0,0,5,1
chd=s:1XQbnf4

Este é o mesmo gráfico de barras, mas com uma série de dados adicional apenas para a linha. É um exemplo de gráfico composto. Os gráficos compostos são desenhados adicionando outras séries de dados ao parâmetro chd, além de um valor para chd instruindo o gráfico a "ignorar" as séries de dados adicionais.

Consulte Gráficos compostos para mais informações.

Gráfico de barras com marcador de linha
chm=D,0033FF,1,0,5,1
chd=s1:1XQbnf4,43ksfg6

Voltar ao início

Marcadores de forma chm [barra, linha, radar, dispersão]

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

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

Sintaxe

Especifique um conjunto dos parâmetros a seguir para cada série a ser marcada. Para marcar diversas séries, crie outros conjuntos de parâmetros, delimitados por barra vertical. Não é necessário marcar todas as séries. Quando uma série de dados não é atribuída, nenhum marcador é atribuído a ela.

Os marcadores de forma se comportam de maneira um pouco diferente nos gráficos de dispersão. Consulte a respectiva 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ê colocar o caractere @ opcional antes do tipo de marcador, <opt_which_points>, usar o formato x:y.
<marker_type>
O tipo de marcador a ser usado. Especifique um dos tipos a seguir:
  • a: seta
  • c - Cruz
  • C: retângulo. Se um marcador de retângulo é usado, é preciso ter pelo menos duas séries de dados, em que a série 0 especifica a borda de baixo e a série 1 especifica a borda de cima. <size> especifica a largura do retângulo, em pixels.
  • d: diamante
  • E: marcador de barra de erro ( ). Esse marcador precisa de duas séries de dados para criar, 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 no gráfico com uma altura especificada. O único formato válido para o parâmetro <opt_which_points> é n.d.
  • H: linha horizontal pelo 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 completa da área do gráfico.
  • o: círculo
  • s: quadrado
  • v: linha vertical do eixo x até o ponto de dados
  • V: linha vertical de comprimento ajustável. É compatível com uma sintaxe de valor <size> estendida 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 desta série, no formato hexadecimal RRGGBB.
<series_index>.
: o índice da série de dados em que os marcadores vão ser desenhados, com base em zero. Ignorado para marcadores h e 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> (em inglês)
[Opcional] Em quais pontos desenhar marcadores. O padrão é todos os marcadores. Use um destes valores:
  • n.d: onde desenhar o marcador. O significado depende do tipo de marcador:
    • Todos os tipos, exceto h: em qual ponto de dados o marcador será desenhado, em que n.d é o índice da série a partir de zero. Se você especificar um valor não inteiro, a fração indicará um ponto intermediário calculado. Por exemplo, 3,5 significa metade do caminho entre os pontos 3 e 4.
    • h: um número de 0,0 a 1,0, em que 0,0 é a parte inferior do gráfico e 1,0 é a parte superior dele.
  • -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: desenhe um marcador em 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 coloca o dobro de marcadores que pontos de dados.
  • start:end:n: desenha um marcador em cada no ponto de dados de um intervalo, incluindo os valores de índice start e end. 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 inteiramente usaria first:last:1. Todos os valores podem ser números de ponto flutuante, ou seja, start e end podem ser negativos, para contar de maneira retroativa a partir do último valor. Se start e end forem negativos, verifique se estão listados em valor crescente (por exemplo, -6:-1:1). Se o valor da etapa n for menor que 1, ele calculará pontos de dados adicionais, interpolando os 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 do 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 do gráfico e 1:1 é o canto superior direito dele. 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 é a parte inferior e 1,0 é a parte superior. 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 a partir 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

Veja um exemplo de 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 e 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 parte inferior 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 amarela horizontal com a 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.
Gráfico de linhas com marcadores
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.

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. Portanto, ele é desenhado primeiro. O losango é especificado e desenhado em segundo lugar, o que faz com que ele seja desenhado sobre o círculo.

Gráfico de linhas, uma com círculos de 15 pixels em cada ponto de dados e a outra com losangos de 10 pixels. Um losango é desenhado no ponto de interseção das duas linhas
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

Este é um gráfico de linhas com um marcador a cada dois pontos de dados (-2 significa a cada dois pontos).

Gráfico de linhas com um marcador a cada dois pontos
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
Este é um gráfico de linhas com o dobro de marcadores que os pontos de dados (-0,5 significa a cada meio ponto). Gráfico de linhas com um marcador a cada dois pontos
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 da grade sejam desenhadas abaixo da linha de dados.
Gráfico de linhas com um marcador a cada dois pontos
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 ao 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.
Gráfico de linhas com um marcador a cada dois pontos
chm=
  v,FF0000,0,::.5,2
Neste exemplo, uma seta e um marcador de texto são adicionados 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 fixada a 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, barras superiores e inferiores 20 pixels. A parte inferior está ancorada no ponto 8 da série 0, e a 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 3 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%
chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

Voltar ao início

Marcadores candlestick chm=F [barra, linha]

Esses marcadores 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, além do valor de abertura e fechamento de um período específico (normalmente um dia). Para saber mais sobre os 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 de baixo e a parte de cima da linha vertical, respectivamente. Normalmente, eles representam os valores mais baixos e mais 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 de qual é 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 constante 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 fica vazio (vazio). A série 2 pode ser a parte de cima ou de baixo do retângulo, dependendo se o preço subiu ou desceu.

É possível combinar 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 em formato de texto. Consulte Gráficos compostos para mais informações.

Este é um exemplo que mostra as linhas para 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 candlestick.
<opt_declining_color>
[Opcional] Cor de preenchimento dos retângulos quando o valor está diminuindo (quando o valor da série 2 é igual ao valor correspondente da série 3). Esse é um número hexadecimal no formato RRGGBB. Quando os valores aumentam, o retângulo fica vazio. O padrão é verde constante para aumentar e vermelho para diminuir (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 para os marcadores candlestick. Esse índice começa no zero. Portanto, se você especificar 1 aqui e tiver seis séries, a segunda, terceira, quarta e quinta serão usadas para desenhar marcadores de vela.
<opt_which_points> (link 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: desenha um marcador em um único ponto da série, em que n.d é o índice do ponto da série. Se você especificar um valor não inteiro, a fração indicará um ponto intermediário calculado. Por exemplo, 3,5 significa metade do caminho entre os pontos 3 e 4.
  • -1: desenha um marcador em todos os pontos de dados. Você também pode deixar esse parâmetro vazio para desenhar todos os marcadores.
  • -n: desenhe um marcador em cada no ponto de dados.
  • start:end:n: desenha um marcador em cada n-ésimo ponto de dados de um intervalo, incluindo os valores de índice start e end. 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 inteiramente usaria first:last:1. Todos os valores podem ser números de ponto flutuante, ou seja, start e end podem ser negativos, para contar de maneira retroativa a partir do último valor. Se start e end forem negativos, verifique se estão listados em valor crescente (por exemplo, -6:-1:1). Se o valor de grau n for menor que 1, ele calculará pontos de dados adicionais, interpolando os 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 é a parte inferior e 1,0 é a parte superior. 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

Confira a seguir um exemplo de marcadores de vela em um gráfico de linhas com quatro séries. A cor de preenchimento personalizada 0000FF (azul) é especificada, e 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.

Gráfico de linhas com quatro linhas laranja e quatro marcadores financeiros

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.

Ele é uma combinação de um gráfico de linhas (o tipo de gráfico base) e marcadores candlestick. O valor de 1 em cht=t:1 significa que todas as séries de dados após a primeira precisam 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 de velas são provenientes 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.

Gráfico de linhas com uma linha laranja e quatro marcadores financeiros.
cht=lc
chm=
  F,,1,1:4,20

chd=t1:
  15,40,30,27,39,54|
  ...

Voltar ao início