matplotlib.axes.Axes.quiver #
- 축. quiver ( * args , data = None , ** kwargs ) [출처] #
화살표의 2D 필드를 플로팅합니다.
호출 서명:
quiver([X, Y], U, V, [C], **kwargs)
X , Y 는 화살표 위치를 정의하고 U , V 는 화살표 방향을 정의하며 C 는 선택적으로 색상을 설정합니다.
화살표 길이
기본 설정은 화살표 길이를 적절한 크기로 자동 조정합니다. 이 동작을 변경하려면 scale 및 scale_units 매개변수를 참조하십시오.
화살표 모양
화살표 모양은 width , headwidth , headlength 및 headaxislength 에 의해 결정됩니다 . 아래 참고 사항을 참조하십시오.
화살표 스타일링
각 화살표는 내부적으로 기본 가장자리 선 너비가 0인 채워진 다각형으로 표시됩니다. 결과적으로 화살표는 머리가 있는 선이 아니라 채워진 영역이며 linewidth , edgecolor , facecolor
PolyCollection
등과 같은 속성이 그에 따라 작동합니다.- 매개변수 :
- X, Y 1D 또는 2D 어레이 유사, 옵션
화살표 위치의 x 및 y 좌표입니다.
지정하지 않으면 U 및 V 의 차원을 기반으로 균일한 정수 메시 그리드로 생성됩니다 .
X 와 Y 가 1D 이고 U , V 가 2D인 경우 X , Y 는 를 사용하여 2D로 확장됩니다 . 이 경우 and 는 U 및 V 의 열 및 행 차원과 일치해야 합니다 .
X, Y = np.meshgrid(X, Y)
len(X)
len(Y)
- U, V 1D 또는 2D 어레이형
화살표 벡터의 x 및 y 방향 구성 요소입니다. 이러한 구성 요소의 해석(데이터 또는 화면 공간에서)은 각도 에 따라 다릅니다 .
U 와 V 는 X , Y 의 화살표 위치 수와 일치하는 동일한 수의 요소를 가져야 합니다 . U 와 V 는 마스킹될 수 있습니다. U , V 및 C 중 하나로 가려진 위치 는 그려지지 않습니다.
- C 1D 또는 2D 어레이 유사, 옵션
norm 및 cmap 을 통한 색상 매핑으로 화살표 색상을 정의하는 숫자 데이터 .
이것은 명시적인 색상을 지원하지 않습니다. 색상을 직접 설정하려면 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
- 반환 :
- 기타 매개변수 :
- 데이터 인덱싱 가능 개체, 선택 사항
주어진 경우, 모든 매개변수는 문자열도 허용하며 , 이는 (예외가 발생하지 않는 한
s
) 로 해석됩니다 .data[s]
- **kwargs
PolyCollection
속성, 선택 사항 다른 모든 키워드 인수는 다음에 전달됩니다
PolyCollection
.재산
설명
(m, n, 3) 부동 소수점 배열과 dpi 값을 사용하고 (m, n, 3) 배열과 이미지의 왼쪽 하단에서 두 오프셋을 반환하는 필터 함수
배열형 또는 스칼라 또는 없음
부울
antialiased
또는 aa 또는 앤티앨리어싱부울 또는 부울 목록
배열형 또는 없음
CapStyle
또는 {'butt', 'projecting', 'round'}(vmin: 플로트, vmax: 플로트)
부울
패치 또는 (경로, 변환) 또는 없음
Colormap
또는 str 또는 없음rgba 튜플의 색상 또는 목록
edgecolor
또는 ec 또는 edgecolors색상 또는 색상 목록 또는 '얼굴'
facecolor
또는 facecolors 또는 fc색상 또는 색상 목록
str
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
부울
JoinStyle
또는 {'마이터', '라운드', '베벨'}물체
linestyle
또는 대시 또는 선 스타일 또는 lsstr 또는 튜플 또는 그 목록
linewidth
또는 선폭 또는 lw플로트 또는 플로트 목록
부울
Normalize
또는 str 또는 없음offset_transform
또는 트랜스오프셋알려지지 않은
(N, 2) 또는 (2,) 배열형
배열과 같은 목록
None 또는 bool 또는 float 또는 호출 가능
알려지지 않은
부울
sizes
ndarray 또는 없음
(스케일: float, 길이: float, 임의성: float)
부울 또는 없음
str
str 또는 None 목록
배열과 같은 목록
알려지지 않은
부울
뜨다
또한보십시오
Axes.quiverkey
퀴버 플롯에 키를 추가합니다.
메모
화살표 모양
화살표는 아래와 같이 노드를 사용하여 다각형으로 그려집니다. 값 headwidth , headlength 및 headaxislength 는 너비 단위입니다 .
기본값은 약간 후퇴된 화살표를 제공합니다. 다음은 다른 머리 모양을 얻는 방법에 대한 몇 가지 지침입니다.
머리를 삼각형으로 만들려면 headaxislength 를 headlength 와 동일하게 만드십시오 .
화살표를 더 뾰족하게 만들려면 headwidth 를 줄이거 나 headlength 및 headaxislength 를 늘립니다 .
샤프트에 비해 헤드를 더 작게 만들려면 모든 헤드 매개변수를 비례적으로 축소합니다.
머리를 완전히 제거하려면 모든 머리 매개변수를 0으로 설정합니다.
다이아몬드 모양의 머리를 얻으려면 headaxislength 를 headlength 보다 크게 만드십시오 .
경고: headaxislength < ( headlength / headwidth )의 경우 "headaxis" 노드(즉, 헤드와 샤프트를 연결하는 노드)가 헤드에서 전방 방향으로 돌출되어 화살촉이 부러진 것처럼 보입니다.