matplotlib.pyplot.fill_between

matplotlib.pyplot. fill_between ( x , y1 , y2 = 0 , onde = None , interpolate = False , step = None , * , data = None , ** kwargs )

Preencha a área entre duas curvas horizontais.

As curvas são definidas pelos pontos ( x , y1 ) e ( x , y2 ). Isso cria um ou vários polígonos descrevendo a área preenchida.

Você pode excluir algumas seções horizontais do preenchimento usando where .

Por padrão, as arestas conectam os pontos fornecidos diretamente. Use step se o preenchimento deve ser uma função degrau, ou seja, constante entre x .

Parâmetros :

matriz x (comprimento N)

As coordenadas x dos nós que definem as curvas.

matriz y1 (comprimento N) ou escalar

As coordenadas y dos nós que definem a primeira curva.

matriz y2 (comprimento N) ou escalar, padrão: 0

As coordenadas y dos nós que definem a segunda curva.

onde matriz de bool (comprimento N), opcional

Defina onde excluir algumas regiões horizontais de serem preenchidas. As regiões preenchidas são definidas pelas coordenadas x[where]. Mais precisamente, preencha entre x[i]e x[i+1]se . Observe que esta definição implica que um valor True isolado entre dois valores False em where não resultará em preenchimento. Ambos os lados da posição True permanecem não preenchidos devido aos valores False adjacentes .where[i] and where[i+1]

interpolar bool, padrão: Falso

Esta opção só é relevante se where for usado e as duas curvas estiverem se cruzando.

Semanticamente, onde é frequentemente usado para y1 > y2 ou similar. Por padrão, os nós do polígono que define a região preenchida serão colocados apenas nas posições do array x . Tal polígono não pode descrever a semântica acima perto da interseção. As seções x contendo a interseção são simplesmente cortadas.

Definir interpolação como Verdadeiro calculará o ponto de interseção real e estenderá a região preenchida até este ponto.

etapa {'pré', 'pós', 'meio'}, opcional

Defina step se o preenchimento deve ser uma função degrau, ou seja, constante entre x . O valor determina onde a etapa ocorrerá:

• 'pré': O valor y continua constantemente à esquerda de cada posição x , ou seja, o intervalo tem o valor .(x[i-1], x[i]]y[i]

• 'pós': O valor y continua constantemente à direita de cada posição x , ou seja, o intervalo tem o valor .[x[i], x[i+1])y[i]

• 'mid': Os passos ocorrem a meio caminho entre as posições x .

Devoluções :

PolyCollection

A PolyCollectioncontendo os polígonos plotados.

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 , y1 , y2 , onde

** kwargs

Todos os outros argumentos de palavra-chave são passados ​​para PolyCollection. Eles controlam as Polygonpropriedades:

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	tipo array ou escalar ou Nenhum
animated	bool
antialiasedou aa ou antialiaseds	bool ou lista de bools
array	tipo array ou nenhum
capstyle	CapStyleou {'bunda', 'projetando', 'redondo'}
clim	(vmin: flutuante, vmax: flutuante)
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
cmap	Colormapou str ou Nenhum
color	cor ou lista de tuplas rgba
edgecolorou ec ou cores de borda	cor ou lista de cores ou 'face'
facecolorou facecolors ou fc	cor ou lista de cores
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleou {'esquadria', 'redondo', 'chanfrado'}
label	objeto
linestyleou traços ou estilos de linha ou ls	str ou tupla ou lista dos mesmos
linewidthou larguras de linha ou lw	flutuador ou lista de flutuadores
mouseover	bool
norm	Normalizeou str ou Nenhum
offset_transformou transOffset	desconhecido
offsets	(N, 2) ou (2,) tipo matriz
path_effects	AbstractPathEffect
paths	lista de tipo array
picker	None ou bool ou float ou callable
pickradius	desconhecido
rasterized	bool
sizes	ndarray ou nenhum
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
transform	Transform
url	str
urls	lista de str ou None
verts	lista de tipo array
verts_and_codes	desconhecido
visible	bool
zorder	flutuador

Veja também

fill_between

Preencha entre dois conjuntos de valores y.

fill_betweenx

Preencha entre dois conjuntos de valores de x.