matplotlib.pyplot.quiver #

matplotlib.pyplot. quiver ( * args , data = None , ** kwargs ) [출처] #

화살표의 2D 필드를 플로팅합니다.

호출 서명:

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

X , Y 는 화살표 위치를 정의하고 U , V 는 화살표 방향을 정의하며 C 는 선택적으로 색상을 설정합니다.

화살표 길이

기본 설정은 화살표 길이를 적절한 크기로 자동 조정합니다. 이 동작을 변경하려면 scalescale_units 매개변수를 참조하십시오.

화살표 모양

화살표 모양은 width , headwidth , headlengthheadaxislength 에 의해 결정됩니다 . 아래 참고 사항을 참조하십시오.

화살표 스타일링

각 화살표는 내부적으로 기본 가장자리 선 너비가 0인 채워진 다각형으로 표시됩니다. 결과적으로 화살표는 머리가 있는 선이 아니라 채워진 영역이며 linewidth , edgecolor , facecolorPolyCollection 등과 같은 속성이 그에 따라 작동합니다.

매개변수 :
X, Y 1D 또는 2D 어레이 유사, 옵션

화살표 위치의 x 및 y 좌표입니다.

지정하지 않으면 UV 의 차원을 기반으로 균일한 정수 메시 그리드로 생성됩니다 .

XY 가 1D 이고 U , V 가 2D인 경우 X , Y 를 사용하여 2D로 확장됩니다 . 이 경우 and 는 UV 의 열 및 행 차원과 일치해야 합니다 .X, Y = np.meshgrid(X, Y)len(X)len(Y)

U, V 1D 또는 2D 어레이형

화살표 벡터의 x 및 y 방향 구성 요소입니다. 이러한 구성 요소의 해석(데이터 또는 화면 공간에서)은 각도 에 따라 다릅니다 .

UV 는 X , Y 의 화살표 위치 수와 일치하는 동일한 수의 요소를 가져야 합니다 . UV 는 마스킹될 수 있습니다. U , VC 중 하나로 가려진 위치 는 그려지지 않습니다.

C 1D 또는 2D 어레이 유사, 옵션

normcmap 을 통한 색상 매핑으로 화살표 색상을 정의하는 숫자 데이터 .

이것은 명시적인 색상을 지원하지 않습니다. 색상을 직접 설정하려면 color 를 대신 사용하십시오. C 의 크기는 화살표 위치의 수와 일치해야 합니다.

각도 {'uv', 'xy'} 또는 배열 유사, 기본값: 'uv'

화살표의 각도를 결정하는 방법.

  • 'uv': 화면 좌표의 화살표 방향. 화살표가 X , Y 데이터 좌표 를 기반으로 하지 않는 수량을 상징하는 경우 사용합니다 .

    U == V 인 경우 플롯의 화살표 방향은 가로축에서 시계 반대 방향으로 45도(오른쪽 양수)입니다.

  • 'xy': 데이터 좌표의 화살표 방향, 즉 화살표가 (x, y)에서 (x+u, y+v)를 가리킵니다. 예를 들어 그래디언트 필드를 그리기 위해 이것을 사용하십시오.

  • 임의의 각도는 가로 축에서 시계 반대 방향으로 각도 값의 배열로 명시적으로 지정할 수 있습니다.

    이 경우 U , V 는 화살표의 길이를 결정하는 데만 사용됩니다.

참고: 데이터 축을 반전하면 화살표만 반전됩니다 angles='xy'.

피벗 {'tail', 'mid', 'middle', 'tip'}, 기본값: 'tail'

X , Y 그리드 에 고정된 화살표 부분입니다 . 화살표는 이 점을 기준으로 회전합니다.

'중간'은 '중간'의 동의어입니다.

스케일 플로트, 옵션

화살표의 길이를 반대로 조정합니다.

화살표 길이 단위당 데이터 단위 수, 예: 플롯 너비당 m/s; 축척 매개변수가 작을수록 화살표가 길어집니다. 기본값은 없음 입니다.

None 이면 평균 벡터 길이와 벡터 수를 기반으로 간단한 자동 크기 조정 알고리즘이 사용됩니다. 화살표 길이 단위는 scale_units 매개변수로 지정됩니다.

scale_units {'너비', '높이', '도트', '인치', 'x', 'y', 'xy'}, 선택 사항

스케일 kwarg가 None 이면 화살표 길이 단위입니다. 기본값은 없음 입니다.

예 를 들어 scale_units 가 'inches'이고 scale 이 2.0이면 벡터의 길이는 0.5인치가 됩니다.(u, v) = (1, 0)

scale_units 가 '너비' 또는 '높이'인 경우 벡터는 축 너비/높이의 절반이 됩니다 .

scale_units 가 'x' 이면 벡터는 0.5 x축 단위가 됩니다. u 및 v가 x 및 y와 동일한 단위를 갖는 xy 평면에 벡터를 플로팅하려면 를 사용 하십시오.angles='xy', scale_units='xy', scale=1

단위 {'너비', '높이', '도트', '인치', 'x', 'y', 'xy'}, 기본값: '너비'

화살표 크기에 영향을 미칩니다(길이 제외). 특히 샤프트 은 이 단위의 배수로 측정됩니다.

지원되는 값은 다음과 같습니다.

  • 'width', 'height': 축의 너비 또는 높이입니다.

  • 'dots', 'inches': 숫자 dpi를 기준으로 한 픽셀 또는 인치.

  • 'x', 'y', 'xy': X , Y 또는\(\sqrt{X^2 + Y^2}\)데이터 단위로.

다음 표에는 이러한 값이 확대/축소 및 그림 크기 변경 시 보이는 화살표 크기에 미치는 영향이 요약되어 있습니다.

단위

그림 크기 변경

'x', 'y', 'xy'

화살표 크기 저울

'너비', '높이'

화살표 크기 저울

'점', '인치'

부동, 선택 사항

화살표 단위의 샤프트 너비. 모든 머리 매개변수는 에 상대적 입니다.

기본값은 위의 단위 선택 과 벡터 수에 따라 다릅니다. 일반적인 시작 값은 플롯 너비의 약 0.005배입니다.

헤드폭 플로트, 기본값: 3

헤드 너비는 샤프트 너비 의 배수입니다 . 아래 참고 사항을 참조하십시오.

헤드 길이 부동, 기본값: 5

헤드 길이는 샤프트 너비 의 배수입니다 . 아래 참고 사항을 참조하십시오.

headaxislength float, 기본값: 4.5

샤프트 너비 의 배수로 샤프트 교차점의 헤드 길이 . 아래 참고 사항을 참조하십시오.

민샤프트 플로트, 기본값: 1

머리 길이 단위로 표시되는 화살표 크기 이하의 길이. 이 값을 1 미만으로 설정하지 마십시오. 그렇지 않으면 작은 화살표가 끔찍하게 보입니다!

최소 길이 부동 소수점, 기본값: 1

최소 길이는 축 너비의 배수입니다. 화살표 길이가 이보다 작으면 대신 이 지름의 점(육각형)을 그립니다.

색상 색상 또는 색상 순서, 옵션

화살표의 명시적 색상입니다. C 가 설정되어 있으면 색상 이 영향을 미치지 않습니다.

이는 facecolor 매개변수와 동의어입니다.PolyCollection

반환 :
Quiver
기타 매개변수 :
데이터 인덱싱 가능 개체, 선택 사항

주어진 경우, 모든 매개변수는 문자열도 허용하며 , 이는 (예외가 발생하지 않는 한 s) 로 해석됩니다 .data[s]

**kwargs PolyCollection속성, 선택 사항

다른 모든 키워드 인수는 다음에 전달됩니다 PolyCollection.

재산

설명

agg_filter

(m, n, 3) 부동 소수점 배열과 dpi 값을 사용하고 (m, n, 3) 배열과 이미지의 왼쪽 하단에서 두 오프셋을 반환하는 필터 함수

alpha

배열형 또는 스칼라 또는 없음

animated

부울

antialiased또는 aa 또는 앤티앨리어싱

부울 또는 부울 목록

array

배열형 또는 없음

capstyle

CapStyle또는 {'butt', 'projecting', 'round'}

clim

(vmin: 플로트, vmax: 플로트)

clip_box

Bbox

clip_on

부울

clip_path

패치 또는 (경로, 변환) 또는 없음

cmap

Colormap또는 str 또는 없음

color

rgba 튜플의 색상 또는 목록

edgecolor또는 ec 또는 edgecolors

색상 또는 색상 목록 또는 '얼굴'

facecolor또는 facecolors 또는 fc

색상 또는 색상 목록

figure

Figure

gid

str

hatch

{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

in_layout

부울

joinstyle

JoinStyle또는 {'마이터', '라운드', '베벨'}

label

물체

linestyle또는 대시 또는 선 스타일 또는 ls

str 또는 튜플 또는 그 목록

linewidth또는 선폭 또는 lw

플로트 또는 플로트 목록

mouseover

부울

norm

Normalize또는 str 또는 없음

offset_transform또는 트랜스오프셋

알려지지 않은

offsets

(N, 2) 또는 (2,) 배열형

path_effects

AbstractPathEffect

paths

배열과 같은 목록

picker

None 또는 bool 또는 float 또는 호출 가능

pickradius

알려지지 않은

rasterized

부울

sizes

ndarray 또는 없음

sketch_params

(스케일: float, 길이: float, 임의성: float)

snap

부울 또는 없음

transform

Transform

url

str

urls

str 또는 None 목록

verts

배열과 같은 목록

verts_and_codes

알려지지 않은

visible

부울

zorder

뜨다

또한보십시오

Axes.quiverkey

퀴버 플롯에 키를 추가합니다.

메모

화살표 모양

화살표는 아래와 같이 노드를 사용하여 다각형으로 그려집니다. 값 headwidth , headlengthheadaxislength너비 단위입니다 .

../../_images/quiver_sizes.svg

기본값은 약간 후퇴된 화살표를 제공합니다. 다음은 다른 머리 모양을 얻는 방법에 대한 몇 가지 지침입니다.

  • 머리를 삼각형으로 만들려면 headaxislength 를 headlength 동일하게 만드십시오 .

  • 화살표를 더 뾰족하게 만들려면 headwidth 를 줄이거 나 headlengthheadaxislength 를 늘립니다 .

  • 샤프트에 비해 헤드를 더 작게 만들려면 모든 헤드 매개변수를 비례적으로 축소합니다.

  • 머리를 완전히 제거하려면 모든 머리 매개변수를 0으로 설정합니다.

  • 다이아몬드 모양의 머리를 얻으려면 headaxislength 를 headlength 보다 크게 만드십시오 .

  • 경고: headaxislength < ( headlength / headwidth )의 경우 "headaxis" 노드(즉, 헤드와 샤프트를 연결하는 노드)가 헤드에서 전방 방향으로 돌출되어 화살촉이 부러진 것처럼 보입니다.