matplotlib.axes.Axes.scatter #

Machados. 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 ,data = None , ** kwargs ) [source] #

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:

Uma instância Normalizeou uma de suas subclasses (consulte Normalização do mapa de cores ).
Um nome de escala, ou seja, um de "linear", "log", "symlog", "logit", etc. Para obter uma lista de escalas disponíveis, chame matplotlib.scale.get_scale_names(). Nesse caso, uma Normalizesubclasse adequada é gerada e instanciada dinamicamente.

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 .