matplotlib.axes.Axes.pcolorfast #
- Machados. pcolorfast ( * args , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , data = None , ** kwargs ) [source] #
Crie um gráfico de pseudocor com uma grade retangular não regular.
Assinatura de chamada:
ax.pcolorfast([X, Y], C, /, **kwargs)
Este método é semelhante a
pcolor
epcolormesh
. Ele foi projetado para fornecer a plotagem do tipo pcolor mais rápida com o back-end Agg. Para conseguir isso, ele usa diferentes algoritmos internamente, dependendo da complexidade da grade de entrada (retangular regular, retangular não regular ou quadrilátero arbitrário).Aviso
Este método é experimental. Em comparação com
pcolor
oupcolormesh
tem algumas limitações:Suporta apenas sombreamento plano (sem contornos)
Falta suporte para escala de log dos eixos.
Ele não tem um wrapper pyplot.
- Parâmetros :
- tipo matriz C
Os dados da imagem. As formas de matriz suportadas são:
(M, N): uma imagem com dados escalares. O mapeamento de cores é controlado por cmap , norm , vmin e vmax .
(M, N, 3): uma imagem com valores RGB (0-1 float ou 0-255 int).
(M, N, 4): uma imagem com valores RGBA (0-1 float ou 0-255 int), ou seja, incluindo transparência.
As duas primeiras dimensões (M, N) definem as linhas e colunas da imagem.
Este parâmetro só pode ser passado posicionalmente.
- X, Y tupla ou tipo array, padrão: ,
(0, N)
(0, M)
X e Y são usados para especificar as coordenadas dos quadriláteros. Existem diferentes maneiras de fazer isso:
Use tuplas e para definir uma grade retangular uniforme .
X=(xmin, xmax)
Y=(ymin, ymax)
As tuplas definem as bordas externas da grade. Todos os quadriláteros individuais serão do mesmo tamanho. Esta é a versão mais rápida.
Use matrizes 1D X , Y para especificar uma grade retangular não uniforme .
Neste caso, X e Y devem ser matrizes 1D monotônicas de comprimento N+1 e M+1 , especificando os limites xey das células.
A velocidade é intermediária. Nota: A grade é verificada e, se for uniforme, a versão rápida é usada.
Use matrizes 2D X , Y se precisar de uma grade quadrilátera arbitrária (ou seja, se os quadriláteros não forem retangulares).
Neste caso, X e Y são matrizes 2D com forma (M + 1, N + 1), especificando as coordenadas x e y dos cantos dos quadriláteros coloridos.
Este é o mais geral, mas o mais lento para renderizar. No entanto, pode produzir uma saída mais rápida e compacta usando back-ends ps, pdf e svg.
Esses argumentos só podem ser passados posicionalmente.
- 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
Normalize
ou 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, umaNormalize
subclasse 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).
- snap bool, padrão: False
Se deve ajustar a malha aos limites de pixel.
- Devoluções :
AxesImage
ouPcolorImage
ouQuadMesh
O tipo de retorno depende do tipo de grade:
AxesImage
para uma grade retangular regular.PcolorImage
para uma grade retangular não regular.QuadMesh
para uma grade não retangular.
- Outros Parâmetros :
- objeto indexável de dados , opcional
Se fornecido, todos os parâmetros também aceitam uma string
s
, que é interpretada comodata[s]
(a menos que isso gere uma exceção).- ** kwargs
Parâmetros adicionais suportados dependem do tipo de grade. Veja os tipos de imagem de retorno para uma descrição mais detalhada.