matplotlib.quiver.Barbs

classe matplotlib.quiver. Barbs ( ax , * args , pivot = 'tip' , length = 7 , barbcolor = None , flagcolor = None , tamanhos = None , fill_empty = False , barb_increments = None , rounding = True , flip_barb = False , ** kwargs )

Bases:PolyCollection

PolyCollection especializada para farpas.

O único método API é set_UVC(), que pode ser usado para alterar o tamanho, a orientação e a cor das setas. Os locais são alterados usando o set_offsets()método de coleta. Possivelmente este método será útil em animações.

Existe uma função interna _find_tails()que encontra exatamente o que deve ser colocado na farpa dada a magnitude do vetor. A partir daí _make_barbs()é usado para encontrar os vértices do polígono para representar a farpa com base nesta informação.

O construtor usa um argumento obrigatório, uma instância de Axes, seguida pelos args e kwargs descritos pela seguinte documentação da interface pyplot:

Traçar um campo 2D de farpas.

Assinatura de chamada:

barbs([X, Y], U, V, [C], **kwargs)

Onde X , Y definem os locais da rebarba, U , V definem as direções da rebarba e C opcionalmente define a cor.

Todos os argumentos podem ser 1D ou 2D. U , V , C podem ser arrays mascarados, mas mascarados X , Y não são suportados no momento.

As farpas são tradicionalmente usadas em meteorologia como uma forma de plotar a velocidade e a direção das observações do vento, mas podem ser usadas tecnicamente para plotar qualquer quantidade vetorial bidimensional. Ao contrário das setas, que fornecem a magnitude do vetor pelo comprimento da seta, as farpas fornecem informações mais quantitativas sobre a magnitude do vetor, colocando linhas inclinadas ou um triângulo para vários incrementos de magnitude, conforme mostrado esquematicamente abaixo:

:                   /\    \
:                  /  \    \
:                 /    \    \    \
:                /      \    \    \
:               ------------------------------

O maior incremento é dado por um triângulo (ou "bandeira"). Depois disso, vêm as linhas completas (farpas). O menor incremento é uma meia linha. Há apenas, é claro, no máximo 1 meia linha. Se a magnitude for pequena e precisar apenas de uma única meia linha e sem linhas completas ou triângulos, a meia linha é deslocada do final da rebarba para que possa ser facilmente distinguida das rebarbas com uma única linha completa. A magnitude da farpa mostrada acima seria nominalmente 65, usando os incrementos padrão de 50, 10 e 5.

Veja também https://en.wikipedia.org/wiki/Wind_barb .

Parâmetros :

X, Y 1D ou 2D tipo matriz, opcional

As coordenadas x e y dos locais da rebarba. Veja pivô para saber como as farpas são desenhadas para as posições x, y.

Se não forem fornecidos, eles serão gerados como uma grade de malha inteira uniforme com base nas dimensões de U e V .

Se X e Y são 1D, mas U , V são 2D, X , Y são expandidos para 2D usando . Nesse caso, e deve corresponder às dimensões de coluna e linha de U e V .X, Y = np.meshgrid(X, Y)len(X)len(Y)

U, V 1D ou 2D tipo matriz

Os componentes x e y do eixo farpado.

C 1D ou 2D tipo array, opcional

Dados numéricos que definem as cores da farpa por mapeamento de cores via norm e cmap .

Isso não suporta cores explícitas. Se você quiser definir as cores diretamente, use barbcolor .

flutuação de comprimento , padrão: 7

Comprimento da farpa em pontos; as outras partes da rebarba são dimensionadas contra isso.

pivot {'tip', 'middle'} ou float, padrão: 'tip'

A parte da seta que está ancorada na grade X , Y. A rebarba gira em torno deste ponto. Isso também pode ser um número, que desloca o início da farpa muitos pontos para longe do ponto da grade.

cor barbcolor ou sequência de cores

A cor de todas as partes da farpa, exceto as bandeiras. Este parâmetro é análogo ao parâmetro edgecolor para polígonos, que pode ser usado em seu lugar. No entanto, este parâmetro substituirá a cor da face.

cor da bandeira ou sequência de cores

A cor de qualquer bandeira na farpa. Este parâmetro é análogo ao parâmetro facecolor para polígonos, que pode ser usado em seu lugar. No entanto, este parâmetro substituirá a cor da face. Se isso não for definido (e C também não), então flagcolor será definido para corresponder à barbcolor para que a farpa tenha uma cor uniforme. Se C foi definido, flagcolor não tem efeito.

tamanhos dict, opcional

Um dicionário de coeficientes que especifica a proporção de um determinado recurso para o comprimento da rebarba. Apenas os valores que se deseja substituir precisam ser incluídos. Esses recursos incluem:

• 'espaçamento' - espaço entre feições (bandeiras, full/half farpas)

• 'height' - altura (distância do eixo ao topo) de uma bandeira ou farpa completa

• 'largura' - largura de uma bandeira, duas vezes a largura de uma farpa completa

• 'emptybarb' - raio do círculo usado para baixas magnitudes

fill_empty bool, padrão: Falso

Se as farpas vazias (círculos) desenhadas devem ser preenchidas com a cor da bandeira. Se não estiverem preenchidos, o centro é transparente.

arredondamento bool, padrão: True

Se a magnitude do vetor deve ser arredondada ao alocar componentes de farpa. Se True, a magnitude é arredondada para o múltiplo mais próximo do incremento de meia farpa. Se Falso, a magnitude é simplesmente truncada para o próximo múltiplo mais baixo.

barb_increments dict, opcional

Um dicionário de incrementos especificando valores a serem associados a diferentes partes da rebarba. Apenas os valores que se deseja substituir precisam ser incluídos.

• 'half' - metade farpas (o padrão é 5)

• 'full' - farpas completas (o padrão é 10)

• 'flag' - sinalizadores (o padrão é 50)

flip_barb bool ou tipo array de bool, padrão: False

Se as linhas e sinalizadores devem apontar para o lado oposto ao normal. O comportamento normal é que as farpas e linhas apontem para a direita (vem de farpas de vento com essas características apontando para baixa pressão no Hemisfério Norte).

Um único valor é aplicado a todas as farpas. Farpas individuais podem ser invertidas passando uma matriz bool do mesmo tamanho que U e V .

Devoluções :

farpasBarbs

Outros Parâmetros :

objeto indexável de dados , opcional

DATA_PARAMETER_PLACEHOLDER

** kwargs

As farpas podem ainda ser personalizadas usando PolyCollectionargumentos de palavra-chave:

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

barbs_doc = '\nPlote um campo 2D de farpas.\n\nAssinatura de chamada ::\n\n farpas([X, Y], U, V, [C], **kwargs)\n\nOnde *X*, *Y* define a localização da farpa , *U*, *V* define as \ndireções da farpa e *C* opcionalmente define a cor.\n\nTodos os argumentos podem ser 1D ou 2D. *U*, *V*, *C* podem ser arrays mascarados , mas   mascarados\n*X*, *Y* não são suportados no momento.\n\nBarbs são tradicionalmente usados ​​em meteorologia como uma forma de plotar a velocidade\ne direção das observações do vento , mas tecnicamente podem ser usados ​​para \ntraçar qualquer bidimensional quantidade vetorial . Ao contrário das setas, que\nfornecem a magnitude do vetor pelo comprimento do   seta, as farpas fornecem mais\ninformações quantitativas sobre a magnitude do vetor , colocando \nlinhas inclinadas ou um triângulo para vários incrementos na magnitude, como mostrado\nesquematicamente abaixo::\n\n : /\\ \\\n : / \\ \\\n : / \\ \\ \\\n : / \\ \\ \\\n : ------------------------- -----\n\nO maior incremento é                                                                                                                                    dada por um triângulo (ou "bandeira"). Depois disso\nvem linhas cheias (farpas). O menor incremento é uma meia linha. Há\nsomente , é claro , no máximo 1 meia linha. Se a magnitude for\npequena e precisar apenas de uma única meia linha e nenhuma linha completa ou\ntriângulos, a meia linha será deslocada     do final da rebarba para que ela \n possa ser facilmente distinguida das rebarbas com uma única linha cheia . A\nmagnitude da farpa mostrada acima seria nominalmente 65, usando os \nincrementos padrão de 50 , 10 e 5. \n\nConsulte também https://en.wikipedia.org/wiki/Wind_barb.\n\nParâmetros\ n----------\nX, Y : 1D ou 2D   semelhante a uma matriz, opcional\n     As coordenadas x e y das localizações da rebarba . Veja *pivot* para saber como as\n farpas são desenhadas nas posições x, y .\n\n Se não forem fornecidas, elas serão geradas como uma grade de malha inteira uniforme com base\n nas dimensões de *U* e *V* .\n\n Se *X* e *Y* forem                 1D mas *U*, *V* são 2D, *X*, *Y* são expandidos para 2D\n     usando ``X, Y = np.meshgrid(X, Y)``. Neste caso , ``len(X)`` e ``len(Y)``\n     devem corresponder às dimensões de coluna e linha de *U* e *V*.\n\nU, V : 1D ou 2D array- como \ n Os componentes x e y da farpa     eixo.\n\nC : tipo matriz 1D ou 2D , opcional\n Dados numéricos que definem as cores da farpa por mapeamento de cores via *norm* e\n *cmap*.\n\n Isso não suporta cores explícitas . Se você quiser definir as cores diretamente,\n use * barbcolor* em vez disso.\n\nlength : float, default: 7\n Length of the barb in points;                     as outras partes da rebarba\n são dimensionadas em relação a esta .\n\npivot : {\'tip\', \'middle\'} ou flutuante, padrão: \ 'tip\'\n A parte da seta que é ancorado na grade *X*, *Y* . A rebarba\n gira em torno deste ponto. Também pode ser um número, que desloca o \ n início do                barb que muitos pontos de distância do ponto de grade .\n\nbarbcolor : cor ou seqüência de cores \n     A cor de todas as partes da farpa , exceto para as bandeiras. Este parâmetro\n é análogo ao parâmetro *edgecolor* para polígonos , que pode ser usado\n em seu lugar. No entanto , este parâmetro substituirá a cor da face.\n\nflagcolor           : cor ou sequência de cores\ n A cor de qualquer bandeira na rebarba . Este parâmetro é análogo ao parâmetro \n *facecolor* para polígonos, que pode ser usado em seu lugar. No entanto,\n este parâmetro substituirá a cor da face. Se isso não for definido (e *C* também não \n ) então *flagcolor* irá                    ser definido para corresponder à *barbcolor* para que \n a     farpa tenha uma cor uniforme . Se *C* foi definido, *flagcolor* não tem efeito .\n\nsizes : dict, opcional\n Um dicionário de coeficientes especificando a proporção de um dado\n recurso para o comprimento da farpa . Somente os valores que se deseja \n             substituição precisa ser incluída .   Esses recursos incluem:\n\n     - \'espaçamento\' - espaço entre os recursos (bandeiras, farpas completas/meias )\n - \'altura\' - altura (distância do eixo ao topo) de uma bandeira ou farpa completa \ n - \'width\' - largura de uma bandeira, duas vezes a largura de uma farpa completa \n - \'emptybarb\'            - raio do círculo usado para magnitudes baixas \n\nfill_empty : bool , padrão: False\n Se as farpas vazias (círculos) que são desenhadas devem ser preenchidas com\n a cor da bandeira . Se eles não estiverem preenchidos, o centro é transparente.\n\nrounding : bool, padrão: True\n Se a magnitude do vetor deve               ser arredondado ao alocar componentes barb\n     .   Se True, a magnitude é arredondada para o múltiplo mais próximo \n do incremento de meia barb . Se False, a magnitude é simplesmente truncada\n para o próximo múltiplo mais baixo .\n\nbarb_increments : dict, opcional\n Um dicionário de incrementos especificando valores para associar \n                  diferentes partes da farpa . Apenas os valores que se deseja substituir \n     precisam ser incluídos.\n\n - \'half\' - half farpas (o padrão é 5)\n - \'full\' - farpas completas (o padrão é 10)\n - \'flag\' - flags (o padrão é 50)\n\nflip_barb : bool ou tipo array de bool, padrão: False\n Se                 as linhas e bandeiras devem apontar no sentido oposto ao normal.\n O     comportamento normal é que as farpas e linhas apontem para a direita (vem do vento\n farpas com essas características apontando para baixa pressão no Hemisfério \n Norte).\n\n A valor único é aplicado a todas as farpas. Farpas individuais podem ser             invertida por\n     passando um array booleano do mesmo tamanho que *U* e *V* . \n\nRetorna\n-------\nbarbs : `~matplotlib.quiver.Barbs`\n\nOutros Parâmetros \n----------------\ndata : objeto indexável , opcional\n DATA_PARAMETER_PLACEHOLDER\n\n**kwargs\n As farpas podem ainda ser personalizadas usando a palavra-chave `.PolyCollection` \ n argumentos:\n\n \n .. tabela::\n :classe: propriedade-tabela\n\n                                   ==================================================== ==================================================    _ ==================================================== ==================================================== ==================================================== =====\n        Descrição do Imóvel                                                                                             \n ===================================== ==================================================== ======== =========================================== ==================================================== ==================================================== ================\n :meth:`agg_filter <matplotlib.artist.Artist.set_agg_filter>` uma função de filtro , que leva um (m, n,                                                                                                                                                                                                            3) array flutuante e um valor de dpi, e retorna um array ( m , n, 3) e dois deslocamentos do canto inferior esquerdo da imagem \n :meth:`alpha <matplotlib.collections.Collection.set_alpha>` array- como ou escalar ou Nenhum \n :meth:`animated <matplotlib.artist.Artist.set_animated>` bool \n :meth:`antialiased <matplotlib.collections.Collection.set_antialiased>` ou aa                                                                                                                                                                                                                                                                                                                                                                                                       ou antialiaseds        bool ou lista de bools                                                                                                                                          \n        :meth:`array <matplotlib.cm.ScalarMappable.set_array>`                                               tipo array ou None                                                                                                                                             \n        :meth:`capstyle <matplotlib.collections.Collection.set_capstyle>`                                    `.CapStyle` ou {\'butt\', \'projecting\', \'round\'}                                                                                                                 \n        :meth:`clim <matplotlib.cm.ScalarMappable.set_clim>`                                                 (vmin: float, vmax: float)                                                                                                                                     \n        :meth :`clip_box <matplotlib.artist.Artist.set_clip_box>`                                             `.Bbox`                                                                                                                                                        \n        :meth:`clip_on <matplotlib.artist.Artist.set_clip_on>`                                               bool                                                                                                                                                           \n        :meth:`clip_path <matplotlib.artist.Artist.set_clip_path>`                                           Patch ou (Caminho, Transform) ou Nenhum                                                                                                                             \n        :meth:`cmap <matplotlib.cm.ScalarMappable .set_cmap>`                                                 `.Colormap` ou str ou None                                                                                                                                     \n        :meth:`color <matplotlib.collections.Collection.set_color>`                                          cor ou lista de tuplas rgba \n :meth:`edgecolor <matplotlib.collections.Collection.set_edgecolor >` ou ec ou cor edgecolors                                                                                                                                                      ou lista de cores ou \'face\'                                                                                                                              \n        :meth:`facecolor <matplotlib.collections.Collection.set_facecolor>` ou facecolors ou fc              color ou lista de cores                                                                                                                                        \n        :meth:`figure <matplotlib.artist.Artist. set_figure>`                                                 `.Figure`                                                                                                                                                      \n        :meth:`gid <matplotlib.artist.Artist.set_gid>`                                                       str                                                                                                                                                            \n        :meth:`hatch <matplotlib.collections.Collection.set_hatch>`                                          {\'/\', \ '\\\\\', \'|\', \'-\', \'+\', \'x\', \'o\', \'O\', \'.\', \'*\'}                                                                                                            \n        :meth:`in_layout <matplotlib.artist.Artist.set_in_layout>`                                           bool                                                                                                                                                           \n        :meth:`joinstyle <matplotlib.collections.Collection.set_joinstyle>`                                  `.JoinStyle` ou {\'miter \', \'round\', \'bevel\'}                                                                                                                    \n        :meth:`label <matplotlib.artist.Artist.set_label>`                                                   objeto                                                                                                                                                         \n        :meth:`linestyle <matplotlib.collections.Collection.set_linestyle>` ou traços ou estilos de linha ou ls    str ou tupla ou lista dos mesmos                                                                                                                                   \n        :meth:`linewidth <matplotlib.collections.Collection.set_linewidth>` ou larguras de linha ou lw              float ou lista de floats                                                                                                                                        \n        :meth:`mouseover <matplotlib.artist.Artist.set_mouseover>`                                           bool                                                                                                                                                           \n        :meth:`norm <matplotlib.cm.ScalarMappable .set_norm>`                                                 `.Normalize` ou str ou None                                                                                                                                    \n        :meth:`offset_transform <matplotlib.collections.Collection.set_offset_transform>` ou transOffset     desconhecido                                                                                                                                                        \n        :meth:`offsets <matplotlib.collections.Collection.set_offsets>`                                      ( N, 2) ou (2,) array-like                                                                                                                                      \n        :meth:`path_effects <matplotlib.artist.Artist.set_path_effects>`                                     `.AbstractPathEffect`                                                                                                                                          \n        :meth:`paths <matplotlib.collections.PolyCollection.set_verts>`                                      lista de array-like                                                                                                                                             \n        :meth :`picker <matplotlib.artist.Artist.set_picker>`                                                 None ou bool ou float ou callable                                                                                                                              \n        :meth:`pickradius <matplotlib.collections.Collection.set_pickradius>`                                desconhecido                                                                                                                                                        \n        :meth:`rasterizado <matplotlib.artist. Artist.set_rasterized>`                                         bool                                                                                                                                                           \n        :meth:`sizes <matplotlib.collections._CollectionWithSizes.set_sizes>`                                ndarray ou None                                                                                                                                                \n        :meth:`sketch_params <matplotlib.artist.Artist.set_sketch_params>`                                   (escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)                                                                                                               \n        :meth:`snap <matplotlib.artist.Artist.set_snap>`                                                     bool ou None                                                                                                                                                   \n        :meth:`transform <matplotlib.artist.Artist.set_transform>`                                           `.Transform`                                                                                                                                                   \n        :meth:`url <matplotlib.artist.Artist.set_url> `                                                       str                                                                                                                                                            \n        :meth:`urls <matplotlib.collections.Collection.set_urls>`                                            lista de str ou Nenhum                                                                                                                                            \n        :meth:`verts <matplotlib.collections.PolyCollection.set_verts>`                                      lista de \n :meth:`verts_and_codes tipo array <                                                                                                                                             matplotlib.collections.PolyCollection.set_verts_and_codes>` desconhecido \n :meth:`visible < matplotlib.artist.Artist.set_visible>` bool \n :meth:`zorder <matplotlib.artist.Artist.set_zorder>` float \n ==================== ==================================================== ========================= ========================= ==================================================== ==================================================== ===================================\n\n'                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       

set ( * , UVC=<UNSET> , agg_filter=<UNSET> , alpha=<UNSET> , animado=<UNSET> , antialiased=<UNSET> , array=<UNSET> , capstyle=<UNSET> , clim=<UNSET > , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , cmap=<UNSET> , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , gid=<UNSET> , hachura=<UNSET> , in_layout=<UNSET> , joinstyle=<UNSET>, label=<UNSET> , linestyle=<UNSET> , linewidth=<UNSET> , mouseover=<UNSET> , norm=<UNSET> , offset_transform=<UNSET> , offsets=<UNSET> , path_effects=<UNSET> , caminhos =<UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterizado=<UNSET> , tamanhos=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url=< UNSET> , urls=<UNSET> ,verts=<UNSET> ,verts_and_codes=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade	Descrição
UVC	desconhecido
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	sequência de pares de carros alegóricos
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

set_UVC ( U , V , C = Nenhum )

set_offsets ( xy )

Defina os deslocamentos para os polígonos farpados. Isso salva os deslocamentos passados ​​e os mascara conforme apropriado para os dados U/V existentes.

Parâmetros :

sequência xy de pares de floats