matplotlib.testing
#
matplotlib.test()
#
matplotlib.testing
#
테스트를 위한 도우미 함수.
matplotlib.testing.compare
#
이미지 결과를 비교하기 위한 유틸리티.
- matplotlib.testing.compare. compute_rms ( 예상 _이미지 , 실제_이미지 ) [출처] #
픽셀당 오차를 계산한 다음 평균 제곱근 오차를 계산합니다.
- matplotlib.testing.compare. Comparable_formats ( ) [출처] #
compare_images
이 시스템에서 비교할 수 있는 파일 형식 목록을 반환합니다 .- 반환 :
- str 목록
예 를 들어
['png', 'pdf', 'svg', 'eps']
- matplotlib.testing.compare. compare_images ( 예상 , 실제 , tol , in_decorator = False ) [소스] #
공차 내에서 차이를 확인하는 두 개의 "이미지" 파일을 비교합니다.
주어진 두 파일 이름은
converter
사전을 통해 PNG로 변환할 수 있는 파일을 가리킬 수 있습니다. 기본 RMS는calculate_rms
함수로 계산됩니다.- 매개변수 :
- 예상 str
예상 이미지의 파일 이름입니다.
- 실제 str
실제 이미지의 파일 이름입니다.
- 톨 플로트
허용 오차(색상 값 차이, 여기서 255는 최대 차이)입니다. 평균 픽셀 차이가 이 값보다 크면 테스트에 실패합니다.
- in_decorator 부울
출력 형식을 결정합니다. image_comparison 데코레이터에서 호출되면 True여야 합니다. (기본값=거짓)
- 반환 :
- 없음 또는 dict 또는 str
주어진 허용 오차 내에서 이미지가 같으면 None 을 반환 합니다.
이미지가 다른 경우 반환 값은 in_decorator 에 따라 다릅니다 . in_decorator 가 true이면 다음 항목이 포함된 사전이 반환됩니다 .
rms : 이미지 차이의 RMS.
expected : 예상 이미지의 파일 이름입니다.
actual : 실제 이미지의 파일명.
diff_image : 차이 이미지의 파일 이름입니다.
tol : 비교 공차입니다.
그렇지 않으면 이 정보의 사람이 읽을 수 있는 여러 줄 문자열 표현이 반환됩니다.
예
img1 = "./baseline/plot.png" img2 = "./output/plot.png" compare_images(img1, img2, 0.001)
matplotlib.testing.decorators
#
- 클래스 matplotlib.testing.decorators. CleanupTestCase ( methodName = 'runTest' ) [소스] #
베이스:
TestCase
[ Deprecated ] 정리 작업을 포함하는 unittest.TestCase의 래퍼입니다.
메모
버전 3.6부터 사용되지 않음: 비공개 함수 _cleanup_cm을 포함하여 기존 코드의 공급업체 복사본을 대신 사용하세요.
실행될 때 명명된 테스트 메서드를 사용할 클래스의 인스턴스를 만듭니다. 인스턴스에 지정된 이름의 메서드가 없으면 ValueError 를 발생시킵니다.
- matplotlib.testing.decorators. check_figures_equal ( * , extensions = ('png', 'pdf', 'svg') , tol = 0 ) [출처] #
두 수치를 생성하고 비교하는 테스트 케이스용 데코레이터.
장식된 함수는 두 개의 키워드 인수인 fig_test 및 fig_ref 를 가져와 테스트 및 참조 이미지를 그려야 합니다. 함수가 반환된 후 수치가 저장되고 비교됩니다.
image_comparison
테스트 도구 모음의 크기가 커지지 않도록 하려면 가능한 경우 이 데코레이터를 사용하는 것이 좋습니다 .- 매개변수 :
- 확장 목록, 기본값: ["png", "pdf", "svg"]
테스트할 확장입니다.
- 톨 플로트
테스트가 실패한 것으로 간주되는 RMS 임계값입니다.
- 레이즈 :
- 런타임 에러
테스트 기능 내에서 새 그림이 생성되고 이후에 닫히지 않는 경우.
예
Axes.plot
단일 인수를 사용하여 호출하면 다음에 대해 플로팅되는지 확인하십시오 .[0, 1, 2, ...]
@check_figures_equal() def test_plot(fig_test, fig_ref): fig_test.subplots().plot([1, 3, 5]) fig_ref.subplots().plot([0, 1, 2], [1, 3, 5])
- matplotlib.testing.decorators. check_freetype_version ( ver ) [출처] #
[ 더 이상 사용되지 않음 ]
메모
버전 3.6부터 사용되지 않음: 대신 기존 _check_freetype_version 코드의 벤더 사본을 사용하십시오.
- matplotlib.testing.decorators. 정리 ( 스타일 = 없음 ) [출처] #
[ Deprecated ] 테스트를 실행하기 전에 전역 상태가 재설정되도록 하는 데코레이터입니다.
- 매개변수 :
- 스타일 str, dict 또는 list, 선택 사항
적용할 스타일입니다. 기본값은 입니다.
["classic", "_classic_test_patch"]
메모
버전 3.6부터 사용되지 않음: 비공개 함수 _cleanup_cm을 포함하여 기존 코드의 공급업체 복사본을 대신 사용하세요.
- matplotlib.testing.decorators. image_comparison ( baseline_images , extensions = None , tol = 0 , freetype_version = None , remove_text = False , savefig_kwarg = None , style = ('classic', '_classic_test_patch') ) [출처] #
테스트에서 생성된 이미지를 baseline_images 에 지정된 이미지와 비교 해야 합니다. 그렇지 않으면
ImageComparisonFailure
예외가 발생합니다.- 매개변수 :
- baseline_images 목록 또는 없음
에 대한 호출로 생성된 이미지의 이름을 지정하는 문자열 목록입니다
Figure.savefig
.None 이면 테스트 함수는
baseline_images
매개변수로 또는 와 함께 픽스처 를 사용해야 합니다pytest.mark.usefixtures
. 이 값은 pytest를 사용할 때만 허용됩니다.- 확장 없음 또는 str 목록
테스트할 확장 목록(예: .
['png', 'pdf']
None 이면 지원되는 모든 확장자(png, pdf 및 svg)가 기본값입니다.
단일 확장을 테스트할 때 baseline_images 에 전달된 이름에 직접 포함될 수 있습니다 . 이 경우 확장자 를 설정하지 않아야 합니다.
테스트 스위트의 크기가 커지지 않도록 하기 위해 테스트가 해당 백엔드에 종속된 기능을 명시적으로 실행하는 경우
svg
또는 출력만 포함합니다( 해당 목적을 위한 데코레이터 참조).pdf
check_figures_equal
- 톨 플로트, 기본값: 0
테스트가 실패한 것으로 간주되는 RMS 임계값입니다.
부동 소수점 계산에서 예상되는 작은 차이로 인해 32비트 시스템에서는 이 임계값에 0.06이 추가됩니다.
- freetype_version str 또는 튜플
이 테스트가 통과할 것으로 예상되는 자유 형식 버전 또는 버전 범위입니다.
- remove_text 부울
비교하기 전에 그림에서 제목과 눈금 텍스트를 제거하십시오. 이것은 FreeType의 서로 다른 버전 간의 텍스트 렌더링 변화와 독립적인 기본 이미지를 만드는 데 유용합니다.
이것은 범례 및 주석과 같은 다른 보다 의도적인 텍스트를 제거하지 않습니다.
- savefig_kwarg 사전
savefig 메서드에 전달되는 선택적 인수입니다.
- 스타일 str, dict 또는 목록
이미지 테스트에 적용할 선택적 스타일입니다. 원하는 경우 테스트 자체에서 추가 스타일을 적용할 수도 있습니다. 기본값은 입니다.
["classic", "_classic_test_patch"]
matplotlib.testing.exceptions
#
- 예외 matplotlib.testing.exceptions. ImageComparisonFailure [출처] #
베이스:
AssertionError
테스트를 두 이미지 간의 비교로 표시하려면 이 예외를 발생시킵니다.