matplotlib.pyplot.scatter #

matplotlib.pyplot. scatter ( x , y , s = Nenhum , c = Nenhum , marcador = Nenhum , cmap = Nenhum , norm = Nenhum , vmin = Nenhum , vmax = Nenhum , alpha = Nenhum , linewidths = Nenhum , * , edgecolors = Nenhum , plotnonfinite = Falso, dados = Nenhum , ** kwargs ) [fonte] #

Um gráfico de dispersão de y x x com tamanho e/ou cor variável do marcador.

Parâmetros :
x, y float ou tipo array, forma (n, )

As posições de dados.

s float ou tipo array, forma (n, ), opcional

O tamanho do marcador em pontos**2. O padrão é .rcParams['lines.markersize'] ** 2

c semelhante a uma matriz ou lista de cores ou cor, opcional

As cores do marcador. Valores possíveis:

  • Um escalar ou sequência de n números a serem mapeados para cores usando cmap e norm .

  • Uma matriz 2D na qual as linhas são RGB ou RGBA.

  • Uma sequência de cores de comprimento n.

  • Uma string de formato de cor única.

Observe que c não deve ser uma única sequência numérica RGB ou RGBA, porque ela é indistinguível de uma matriz de valores a serem mapeados em cores. Se você deseja especificar o mesmo valor RGB ou RGBA para todos os pontos, use uma matriz 2D com uma única linha. Caso contrário, a correspondência de valor terá precedência no caso de uma correspondência de tamanho com x e y .

Se você deseja especificar uma única cor para todos os pontos, prefira o argumento da palavra-chave color .

O padrão é None. Nesse caso, a cor do marcador é determinada pelo valor de color , facecolor ou facecolors . Caso não sejam especificados ou None, a cor do marcador é determinada pela próxima cor do Axes' ciclo de cores "forma e preenchimento" atual. O padrão deste ciclo é rcParams["axes.prop_cycle"](padrão: ).cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])

marcador MarkerStyle, padrão: rcParams["scatter.marker"](padrão: 'o')

O estilo do marcador. O marcador pode ser uma instância da classe ou a abreviação de texto para um marcador específico. Consulte matplotlib.markerspara obter mais informações sobre estilos de marcador.

cmap str ou Colormap, padrão: rcParams["image.cmap"](padrão: 'viridis')

A instância do Colormap ou nome do mapa de cores registrado usado para mapear dados escalares para cores.

Este parâmetro é ignorado se c for RGB(A).

norma str ou Normalize, opcional

O método de normalização usado para dimensionar dados escalares para o intervalo [0, 1] antes de mapear para cores usando cmap . Por padrão, uma escala linear é usada, mapeando o valor mais baixo para 0 e o mais alto para 1.

Se fornecido, pode ser um dos seguintes:

Este parâmetro é ignorado se c for RGB(A).

vmin, vmax flutuante, opcional

Ao usar dados escalares e nenhuma norma explícita , vmin e vmax definem o intervalo de dados que o mapa de cores cobre. Por padrão, o mapa de cores cobre toda a faixa de valores dos dados fornecidos. É um erro usar vmin / vmax quando uma instância de norma é fornecida (mas usar um nome de norma junto com vmin / vmax é aceitável).str

Este parâmetro é ignorado se c for RGB(A).

float alfa , padrão: nenhum

O valor de mistura alfa, entre 0 (transparente) e 1 (opaco).

larguras de linha flutuantes ou semelhantes a matrizes, padrão: rcParams["lines.linewidth"](padrão: 1.5)

A largura da linha das bordas do marcador. Nota: As cores de borda padrão são 'face'. Você pode querer mudar isso também.

edgecolors {'face', 'none', None } ou cor ou sequência de cores, padrão: rcParams["scatter.edgecolors"](padrão: 'face')

A cor da borda do marcador. Valores possíveis:

  • 'face': A cor da borda sempre será a mesma da face.

  • 'none': Nenhum limite de patch será desenhado.

  • Uma cor ou sequência de cores.

Para marcadores não preenchidos, edgecolors é ignorado. Em vez disso, a cor é determinada como com 'face', ou seja, de c , colors ou facecolors .

plotnonfinite bool, padrão: False

Se deve plotar pontos com c não finito (isto é inf, -inf ou nan). Se Trueos pontos forem desenhados com a cor ruim do mapa de cores (consulte Colormap.set_bad).

Devoluções :
PathCollection
Outros Parâmetros :
objeto indexável de dados , opcional

Se fornecidos, os seguintes parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção):

x , y , s , larguras de linha , cores de borda , c , facecolor , facecolors , cor

** Collectionpropriedades dos kwargs

Veja também

plot

Para traçar gráficos de dispersão quando os marcadores são idênticos em tamanho e cor.

Notas

  • A plotfunção será mais rápida para gráficos de dispersão em que os marcadores não variam em tamanho ou cor.

  • Qualquer um ou todos os x , y , s e c podem ser matrizes mascaradas, caso em que todas as máscaras serão combinadas e apenas os pontos não mascarados serão plotados.

  • Fundamentalmente, a dispersão funciona com matrizes 1D; x , y , s e c podem ser inseridos como matrizes ND, mas dentro da dispersão eles serão nivelados. A exceção é c , que será nivelado apenas se seu tamanho corresponder ao tamanho de x e y .

Exemplos usando matplotlib.pyplot.scatter#

Dispersão Mascarada

Dispersão Mascarada

Dispersão Mascarada
gráfico de dispersão

gráfico de dispersão

gráfico de dispersão
Hiperlinks

Hiperlinks

Hiperlinks
Pyplot tutorial

Pyplot tutorial

Pyplot tutorial