API Reference - jeanbauer/d3 GitHub Wiki

D3 Referência da API

D3 é uma coleção de módulos que são projetados para trabalhar juntos; você pode usar os módulos independentemente ou pode usá-los juntos como parte da compilação padrão. A fonte e a documentação de cada módulo estão disponíveis em seu repositório. Siga os links abaixo para saber mais. Para alterações entre as versões principais, consulte CHANGES; consulte também as notas de lançamento e a referência 3.x.

D3 usa versão semântica. A versão atual é exposta como d3.version.

Arrays (d3-array)

Manipulação de matriz, ordenação, pesquisa, resumo, etc.

Estatística

Métodos estatísticos básicas para calcular sumarizar .

  • d3.min - calcula o valor mínimo em um iterável.
  • d3.minIndex - calcula o índice do valor mínimo em um iterável.
  • d3.max - calcula o valor máximo em um iterável.
  • d3.maxIndex - calcula o índice do valor máximo em um iterável.
  • d3.extent - calcula o valor mínimo e máximo em um iterável.
  • d3.sum - calcula a soma de uma iteração de números.
  • d3.mean - calcula a média aritmética de uma iteração de números.
  • d3.median - calcula a mediana de um iterável de números (o quantil 0,5).
  • d3.medianIndex - calcula o índice mediano de um iterável de números (o quantil 0,5) .
  • d3.mode - calcula o modo (o valor mais comum) de um iterável de números.
  • d3.cumsum - calcula a soma cumulativa de um iterável.
  • d3.rank - calcula a ordem de classificação de um iterável.
  • d3.quantile - calcula um quantil para uma iteração de números.
  • d3.quantileIndex - calcula um quantil de índice para um iterável de números.
  • d3.quantileSorted - calcula um quantil para uma matriz classificada de números.
  • d3.variance - calcula a variância de uma iteração de números.
  • d3.deviation - calcula o desvio padrão de uma iteração de números.
  • d3.fcumsum - calcula uma soma cumulativa de números com precisão total.
  • d3.fsum - calcula uma soma de precisão completa de um iterável de números.
  • novo d3.Adder - cria um somador de precisão total.
  • adder.add - adiciona um valor a um somador.
  • adder.valueOf - retorna uma representação de precisão dupla do valor de um somador.
  • d3.blur - desfoca uma matriz de números no lugar.
  • d3.blur2 - desfoca uma matriz bidimensional de números no lugar.
  • d3.blurImage - desfoque um RGBA ImageData no local.

Busca

Métodos para pesquisar arrays para um elemento específico.

Transformações

Métodos para transformar arrays e para gerar novos arrays.

  • d3.flatGroup - agrupa um iterável em uma matriz plana.
  • d3.flatRollup - reduz um iterável em uma matriz simples.
  • d3.group - agrupa um iterável em um mapa aninhado.
  • d3.groups - agrupa um iterável em uma matriz aninhada.
  • d3.groupSort - classifica as chaves de acordo com os valores agrupados.
  • d3.index - indexa um iterável em um mapa aninhado.
  • d3.indexes - indexa um iterável em uma matriz aninhada.
  • d3.rollup - reduz um iterável em um mapa aninhado.
  • d3.rollups - reduz um iterável em uma matriz aninhada.
  • d3.count - conta valores numéricos válidos em um iterável.
  • d3.cross - calcula o produto cartesiano de dois iteráveis.
  • d3.merge - mescla vários iteráveis em um array.
  • d3.pairs - cria uma matriz de pares adjacentes de elementos.
  • d3.permute - reordene um iterável de elementos de acordo com um iterável de índices.
  • d3.shuffle - randomize a ordem de um iterável.
  • d3.shuffler - randomize a ordem de um iterável.
  • d3.ticks - gera valores representativos a partir de um intervalo numérico.
  • d3.tickIncrement - gera valores representativos de um intervalo numérico.
  • d3.tickStep - gera valores representativos de um intervalo numérico.
  • d3.nice - estende um intervalo para alinhar com os ticks.
  • d3.range - gera um intervalo de valores numéricos.
  • d3.transpose - transpõe um array de arrays.
  • d3.zip - transpõe um número variável de arrays.

Iteráveis

  • d3.every - teste se todos os valores satisfazem uma condição.
  • d3.some - teste se algum valor satisfaz uma condição.
  • d3.filter - valores de filtro.
  • d3.map - valores do mapa.
  • d3.reduce - reduz os valores.
  • d3.reverse - inverte a ordem dos valores.
  • d3.sort - classifica valores.

Conjuntos

Histogramas

Bin discrete samples into continuous, non-overlapping intervals.

Interando

Eixos (d3-axis)

Marcas de referência legíveis por humanos para escalas.

Brushes (d3-brush)

Selecione uma região uni ou bidimensional usando o mouse ou toque.

Chords (d3-chord)

Cores (d3-color)

Manipulação de cores e conversão de espaços de cores.

  • d3.color - analisa o especificador de cor CSS fornecido.
  • color.opacity - a opacidade da cor.
  • color.rgb - calcule o equivalente RGB desta cor.
  • color.copy - retorna uma cópia desta cor.
  • color.brighter - crie uma cópia mais brilhante desta cor.
  • color.darker - cria uma cópia mais escura desta cor.
  • color.displayable - retorna verdadeiro se a cor puder ser exibida em hardware padrão.
  • color.formatHex - retorna a representação de string RRGBBB hexadecimal desta cor.
  • color.formatHex8 - retorna a representação de string hexadecimal RRGGBBAA desta cor.
  • color.formatHsl - retorna a representação de string RGB desta cor.
  • color.formatRgb - retorna a representação de string HSL desta cor.
  • color.toString - retorna a representação de string RGB desta cor.
  • d3.rgb - cria uma nova cor RGB.
  • rgb.clamp - retorna a cópia desta cor presa ao espaço de cores RGB.
  • d3.hsl - crie uma nova cor HSL.
  • hsl.clamp - retorna a cópia desta cor presa ao espaço de cores HSL.
  • d3.lab - crie uma nova cor Lab.
  • d3.gray - crie um novo Lab gray.
  • d3.hcl - crie uma nova cor HCL.
  • d3.lch - cria uma nova cor HCL.
  • d3.cubehelix - crie uma nova cor Cubehelix.

Esquema de cores (d3-scale-chromatic)

Cores e paletas para escalas quantitativas, ordinais e categóricas.

Categórico

Divergente

Sequencial (Single Hue)

Sequencial (Multi-Hue)

Cíclico

Contornos (d3-contour)

Calcular polígonos de contorno usando quadrados em movimento.

Diagrama Voronoi (d3-delaunay)

Calcule o diagrama de Voronoi de um conjunto de pontos bidimensionais.

Despachos (d3-dispatch)

Separe preocupações usando retornos de chamada nomeados.

Dragging (d3-drag)

Arraste e solte SVG, HTML ou Canvas usando o mouse ou entrada de toque.

  • d3.drag - cria um comportamento de arrastar.
  • drag - aplica o comportamento de arrastar a uma seleção.
  • drag.container - defina o sistema de coordenadas.
  • drag.filter - ignore alguns eventos de entrada iniciais.
  • drag.touchable - defina o detector de suporte de toque.
  • drag.subject - define o que está sendo arrastado.
  • drag.clickDistance - defina o limite de distância do clique.
  • drag.on - ouça eventos de arrastar.
  • d3.dragDisable - evita arrastar e soltar nativo e seleção de texto.
  • d3.dragEnable - permite arrastar e soltar nativo e seleção de texto.
  • event.on - ouça eventos de arrastar no gesto atual.

Valores separados por delimitador (d3-dsv)

Analisar e formatar valores separados por delimitador, mais comumente CSV e TSV.

Easings (d3-ease)

Easing funções para animação suave.

Fetches (d3-fetch)

Métodos de conveniência no topo da API Fetch.

  • d3.blob - obtenha um arquivo como um blob.
  • d3.buffer - obtém um arquivo como um buffer de matriz.
  • d3.csv - obtenha um arquivo de valores separados por vírgula (CSV).
  • d3.dsv - obtenha um arquivo de valores separados por delimitador (CSV).
  • d3.html - obtenha um arquivo HTML.
  • d3.image - obtenha uma imagem.
  • d3.json - obtenha um arquivo JSON.
  • d3.svg - obtenha um arquivo SVG.
  • d3.text - obtenha um arquivo de texto simples.
  • d3.tsv - obtenha um arquivo de valores separados por tabulações (TSV).
  • d3.xml - obtenha um arquivo XML.

Forças (d3-force)

Layout de gráfico direcionado por força usando a integração Verlet de velocidade.

Formatos numéricos (d3-format)

Formatar números para consumo humano.

Geografias (d3-geo)

Projeções geográficas, formas e matemática.

Paths

  • d3.geoPath - crie um novo gerador de caminho geográfico.
  • path - projeta e renderiza o recurso especificado.
  • path.area - calcula a área planar projetada de um determinado recurso.
  • path.bounds - calcula a caixa delimitadora planar projetada de um determinado recurso.
  • path.centroid - calcula o centróide planar projetado de um determinado recurso.
  • path.measure - calcula o comprimento planar projetado de um determinado recurso.
  • path.projection - defina a projeção geográfica.
  • path.context - defina o contexto de renderização.
  • path.digits - defina a precisão de saída.
  • path.pointRadius - defina o raio para exibir recursos de ponto.

Projeções

Projeções brutas

Esférica matemática

  • d3.geoArea - calcula a área esférica de um determinado recurso.
  • d3.geoBounds - calcula a caixa delimitadora de latitude-longitude para um determinado recurso.
  • d3.geoCentroid - calcula o centróide esférico de um determinado recurso.
  • d3.geoDistance - calcula a distância do grande arco entre dois pontos.
  • d3.geoLength - calcula o comprimento de uma string de linha ou o perímetro de um polígono.
  • d3.geoInterpolate - interpolar entre dois pontos ao longo de um grande arco.
  • d3.geoContains - teste se um ponto está dentro de um determinado recurso.
  • d3.geoRotation - cria uma função de rotação para os ângulos especificados.
  • rotation - gire o ponto dado ao redor da esfera.
  • rotation.invert - desgirar o ponto dado ao redor da esfera.

Formas Esféricas

Streams

Transformações

Recorte

Hierarquias (d3-hierarchy)

Algoritmos de layout para visualização de dados hierárquicos.

Interpoladores (d3-interpolate)

Interpole números, cores, strings, arrays, objetos, o que for!

Paths (d3-path)

Serialize comandos de caminho do Canvas para SVG.

Poligonos (d3-polygon)

Operações geométricas para polígonos bidimensionais.

Quadtrees (d3-quadtree)

Subdivisão espacial recursiva bidimensional.

Números aleatórios (d3-random)

Gere números aleatórios de várias distribuições.

Escalas (d3-scale)

Codificações que mapeiam dados abstratos para representação visual.

Escalas Contínuas

Mapeie um domínio quantitativo contínuo para um intervalo contínuo.

Escalas sequenciais

Mapeie um domínio quantitativo contínuo para um interpolador fixo contínuo.

Escalas Divergentes

Mapeie um domínio quantitativo contínuo para um interpolador fixo contínuo.

Escalas de quantização

Mapeie um domínio quantitativo contínuo para um intervalo discreto.

Escalas Ordinais

Mapeie um domínio discreto para um intervalo discreto.

Seleções (d3-selection)

Transforme o DOM selecionando elementos e juntando-se aos dados.

Selecionando Elementos

Modificando Elementos

Junção de Dados

Manipulando Eventos

Controle de fluxo

Variáveis locais

Namespaces

Formas (d3-shape)

Primitivas gráficas para visualização.

Arcos

Setores circulares ou anulares, como em um gráfico de pizza ou rosca.

Tortas

Calcule os ângulos necessários para representar um conjunto de dados tabular como um gráfico de pizza ou rosca.

  • d3.pie - crie um novo gerador de pizza.
  • pie - calcule os ângulos do arco para o conjunto de dados fornecido.
  • pie.value - defina o acessador de valor.
  • pie.sort - defina o comparador de ordem de classificação.
  • pie.sortValues - defina o comparador de ordem de classificação.
  • pie.startAngle - defina o ângulo inicial geral.
  • pie.endAngle - defina o ângulo final geral.
  • pie.padAngle - defina o ângulo do pad entre arcos adjacentes.

Linhas

Uma spline ou polilinha, como em um gráfico de linha.

Áreas

Uma área, definida por uma linha superior e uma linha de base delimitadoras, como em um gráfico de área.

Curvas

Interpolar entre pontos para produzir uma forma contínua.

Ligações

Uma curva de Bézier cúbica suave de uma fonte para um alvo.

Símbolos

Uma codificação de forma categórica, como em um gráfico de dispersão.

Pilhas

Empilhe as formas, posicionando uma adjacente à outra, como em um gráfico de barras empilhadas.

Formatos de Tempo (d3-time-format)

Analisar e formatar horários, inspirados em strptime e strftime.

Intervalos de Tempo (d3-time)

Uma calculadora para as peculiares convenções de tempo da humanidade.

Temporizadores (d3-timer)

Uma fila eficiente para gerenciar milhares de animações simultâneas.

  • d3.now - obtenha o tempo atual de alta resolução.
  • d3.timer - agende um novo cronômetro.
  • timer.restart - redefina a hora de início do cronômetro e o retorno de chamada.
  • timer.stop - pare o cronômetro.
  • d3.timerFlush - execute imediatamente quaisquer temporizadores qualificados.
  • d3.timeout - agende um cronômetro que pare em seu primeiro retorno de chamada.
  • d3.interval - agende um timer que é chamado com um período configurável.

Transições (d3-transition)

Transições animadas para seleções.

Zoom (d3-zoom)

Pan e zoom no SVG, HTML ou Canvas usando o mouse ou a entrada de toque.