23.1.9. 래스터 분석¶

래스터 불(boolean) AND
래스터 불(boolean) OR
래스터 계산기
래스터 레이어 통계
래스터 레이어 유일값 보고
래스터 레이어 구역 통계
래스터 표면 부피
래스터로 재범주화
테이블로 재범주화
래스터 값 샘플링
구역 히스토그램
구역 통계

23.1.9.1. 래스터 불(boolean) AND ¶

입력 래스터 집합에 대해 불(boolean) AND 를 계산합니다. 모든 입력 래스터들이 어떤 픽셀에 대해 0이 아닌 값을 가지고 있다면, 산출 래스터에서 해당 픽셀의 값을 1 로 설정할 것입니다. 입력 래스터 가운데 하나라도 어떤 픽셀에 대해 0 값을 가지고 있다면, 산출 래스터에서 해당 픽셀의 값을 0 으로 설정할 것입니다.

참조 레이어 파라미터는 산출 래스터 생성 시 참조물로 사용할 기존 래스터 레이어를 지정합니다. 산출 래스터는 참조 레이어와 동일한 범위, 좌표계, 그리고 픽셀 크기를 가질 것입니다.

입력 레이어 가운데 하나에만 NODATA 픽셀이 있어도, 기본적으로 산출 래스터에서도 NODATA 픽셀로 산출될 것입니다. Treat nodata values as false 옵션을 활성화한 경우, NODATA 입력을 0 입력값과 동일하게 취급할 것입니다.

래스터 불(boolean) OR

23.1.9.1.1. 파라미터¶

라벨	명칭	유형	설명
Input layers	`INPUT`	[raster] [list]	입력 래스터 레이어의 목록
Reference layer	`REF_LAYER`	[raster]	산출 레이어 생성 시 (범위, 좌표계, 픽셀 크기를) 참조할 참조 레이어
Treat nodata values as false	`NODATA_AS_FALSE`	[boolean] 기본값: False	작업 수행 시 입력 파일에 있는 NODATA 값을 0으로 취급
Output no data value	`NO_DATA`	[number] 기본값: -9999.0	산출 레이어에서 NODATA용으로 사용할 값
Output data type	`DATA_TYPE`	[enumeration] 기본값: 5	산출 래스터 데이터 유형입니다. 다음 가운데 하나를 선택할 수 있습니다: 0 — 바이트(Byte) 1 — 부호 있는 16비트 정수형(Int16) 2 — 부호 없는 16비트 정수형(UInt16) 3 — 부호 없는 32비트 정수형(UInt32) 4 — 부호 있는 32비트 정수형(Int32) 5 — 부동소수점 32비트 실수형(Float32) 6 — 부동소수점 64비트 실수형(Float64) 7 — 복잡 16비트 정수형(CInt16) 8 — 복잡 32비트 정수형(CInt32) 9 — 복잡 부동소수점 32비트 실수형(CFloat32) 10 — 복잡 부동소수점 64비트 실수형(CFloat64)
Output layer	`OUTPUT`	[raster]	산출 래스터 레이어

23.1.9.1.2. 산출물¶

라벨	명칭	유형	설명
Extent	`EXTENT`	[extent]	산출 래스터 레이어의 범위
CRS authority identifier	`CRS_AUTHID`	[crs]	산출 래스터 레이어의 좌표계
Width in pixels	`WIDTH_IN_PIXELS`	[integer]	산출 래스터 레이어의 픽셀 단위 너비
Height in pixels	`HEIGHT_IN_PIXELS`	[integer]	산출 래스터 레이어의 픽셀 단위 높이
Total pixel count	`TOTAL_PIXEL_COUNT`	[integer]	산출 래스터 레이어의 픽셀 개수
NODATA pixel count	`NODATA_PIXEL_COUNT`	[integer]	산출 래스터 레이어의 NODATA 픽셀 개수
True pixel count	`TRUE_PIXEL_COUNT`	[integer]	산출 래스터 레이어에 있는 (값이 1인) 참 픽셀의 개수
False pixel count	`FALSE_PIXEL_COUNT`	[integer]	산출 래스터 레이어에 있는 (값이 0인) 거짓 픽셀의 개수
Output layer	`OUTPUT`	[raster]	결과물을 담고 있는 산출 래스터 레이어

23.1.9.1.3. 파이썬 코드¶

Algorithm ID: qgis:rasterbooleanand

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.2. 래스터 불(boolean) OR ¶

입력 래스터 집합에 대해 불(boolean) OR 를 계산합니다. 모든 입력 래스터들이 어떤 픽셀에 대해 0 값을 가지고 있다면, 산출 래스터에서 해당 픽셀의 값을 0 으로 설정할 것입니다. 입력 래스터 가운데 하나라도 어떤 픽셀에 대해 1 값을 가지고 있다면, 산출 래스터에서 해당 픽셀의 값을 1 로 설정할 것입니다.

참조 레이어 파라미터는 산출 래스터 생성 시 참조물로 사용할 기존 래스터 레이어를 지정합니다. 산출 래스터는 참조 레이어와 동일한 범위, 좌표계, 그리고 픽셀 크기를 가질 것입니다.

입력 레이어 가운데 하나에만 NODATA 픽셀이 있어도, 기본적으로 산출 래스터에서도 NODATA 픽셀로 산출될 것입니다. Treat nodata values as false 옵션을 활성화한 경우, NODATA 입력을 0 입력값과 동일하게 취급할 것입니다.

래스터 불(boolean) AND

23.1.9.2.1. 파라미터¶

라벨	명칭	유형	설명
Input layers	`INPUT`	[raster] [list]	입력 래스터 레이어의 목록
Reference layer	`REF_LAYER`	[raster]	산출 레이어 생성 시 (범위, 좌표계, 픽셀 크기를) 참조할 참조 레이어
Treat nodata values as false	`NODATA_AS_FALSE`	[boolean] 기본값: False	작업 수행 시 입력 파일에 있는 NODATA 값을 0으로 취급
Output no data value	`NO_DATA`	[number] 기본값: -9999.0	산출 레이어에서 NODATA용으로 사용할 값
Output data type	`DATA_TYPE`	[enumeration] 기본값: 5	산출 래스터 데이터 유형입니다. 다음 가운데 하나를 선택할 수 있습니다: 0 — 바이트(Byte) 1 — 부호 있는 16비트 정수형(Int16) 2 — 부호 없는 16비트 정수형(UInt16) 3 — 부호 없는 32비트 정수형(UInt32) 4 — 부호 있는 32비트 정수형(Int32) 5 — 부동소수점 32비트 실수형(Float32) 6 — 부동소수점 64비트 실수형(Float64) 7 — 복잡 16비트 정수형(CInt16) 8 — 복잡 32비트 정수형(CInt32) 9 — 복잡 부동소수점 32비트 실수형(CFloat32) 10 — 복잡 부동소수점 64비트 실수형(CFloat64)
Output layer	`OUTPUT`	[raster]	산출 래스터 레이어

23.1.9.2.2. 산출물¶

라벨	명칭	유형	설명
Extent	`EXTENT`	[extent]	산출 래스터 레이어의 범위
CRS authority identifier	`CRS_AUTHID`	[crs]	산출 래스터 레이어의 좌표계
Width in pixels	`WIDTH_IN_PIXELS`	[integer]	산출 래스터 레이어의 픽셀 단위 너비
Height in pixels	`HEIGHT_IN_PIXELS`	[integer]	산출 래스터 레이어의 픽셀 단위 높이
Total pixel count	`TOTAL_PIXEL_COUNT`	[integer]	산출 래스터 레이어의 픽셀 개수
NODATA pixel count	`NODATA_PIXEL_COUNT`	[integer]	산출 래스터 레이어의 NODATA 픽셀 개수
True pixel count	`TRUE_PIXEL_COUNT`	[integer]	산출 래스터 레이어에 있는 (값이 1인) 참 픽셀의 개수
False pixel count	`FALSE_PIXEL_COUNT`	[integer]	산출 래스터 레이어에 있는 (값이 0인) 거짓 픽셀의 개수
Output layer	`OUTPUT`	[raster]	결과물을 담고 있는 산출 래스터 레이어

23.1.9.2.3. 파이썬 코드¶

Algorithm ID: qgis:rasterbooleanor

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.3. 래스터 계산기 ¶

래스터 레이어를 사용해 대수(algebra) 작업을 수행합니다.

산출되는 레이어는 표현식에 따라 계산된 값을 가질 것입니다. 표현식은 숫자값, 연산자를 담을 수 있고, 현재 프로젝트에 있는 모든 레이어를 참조할 수 있습니다.

참고

배치 프로세스 인터페이스 또는 QGIS 파이썬 콘솔 에서 계산기를 사용하는 경우 사용할 파일을 지정해야 합니다. 대응하는 레이어는 (전체 경로가 아닌) 기본명을 사용해서 참조시켜야 합니다. 예를 들어, path/to/my/rasterfile.tif 위치에 있는 레이어를 사용하는 경우 해당 레이어의 첫 번째 밴드는 rasterfile.tif@1 로 참조될 것입니다.

23.1.9.3.1. 파라미터¶

라벨	명칭	유형	설명
Layers	GUI 전용		범례에 불러온 모든 래스터 레이어의 목록을 표시합니다. 이 목록을 사용해서 (레이어명을 더블 클릭하면) 표현식란에 해당 레이어를 추가할 수 있습니다. 래스터 레이어는 `layer_name@band_number` 처럼 명칭 및 밴드 번호로 참조됩니다. 예를 들어 `DEM` 이라는 레이어의 첫 번째 밴드는 `DEM@1` 로 참조될 것입니다.
Operators	GUI 전용		표현식란을 채울 수 있는 몇몇 계산기 버튼을 담고 있습니다.
Expression	`EXPRESSION`	[string]	산출 래스터 레이어를 계산하기 위해 사용할 수 있는 표현식입니다. 제공된 연산자 버튼을 사용해서 표현식란에 표현식을 직접 입력할 수 있습니다.
Predefined expressions	GUI 전용		사전 정의된 `NDVI` 표현식을 사용할 수도 있고, 또는 계산을 위한 새 표현식을 정의할 수도 있습니다. Add… 버튼을 클릭하면 사전 정의 표현식을 불러올 수 있습니다. (그리고 사용자가 파라미터를 설정할 수 있지요.) Save… 버튼을 클릭하면 새 표현식을 정의할 수 있습니다.
Reference layer(s) (used for automated extent, cellsize, and CRS) 부가적	`LAYERS`	[raster] [list]	범위, 셀 크기 및 좌표계를 가져올 레이어(들)입니다. 이 상자에서 레이어를 선택하면 사용자가 직접 다른 모든 파라미터를 지정해야 할 필요가 사라집니다. 래스터 레이어는 `layer_name@band_number` 처럼 명칭 및 밴드 번호로 참조됩니다. 예를 들어 `DEM` 이라는 레이어의 첫 번째 밴드는 `DEM@1` 로 참조될 것입니다.
Cell size (use 0 or empty to set it automatically) 부가적	`CELLSIZE`	[number]	산출 래스터 레이어의 셀 크기입니다. 셀 크기를 지정하지 않은 경우, 선택한 참조 레이어(들)의 최소 셀 크기를 사용할 것입니다. 셀 크기는 X축 및 Y축에 대해 동일할 것입니다.
Output extent (xmin, xmax, ymin, ymax)	`EXTENT`	[extent]	산출 래스터 레이어의 범위입니다. 범위를 지정하지 않은 경우, 선택한 참조 레이어(들)을 모두 커버하는 최소 범위를 사용할 것입니다.
Output CRS 부가적	`CRS`	[crs]	산출 래스터 레이어의 좌표계입니다. 좌표계를 지정하지 않은 경우, 첫 번째 참조 레이어의 좌표계를 사용할 것입니다.
Output	`OUTPUT`	[raster] 기본값: `[Save to temporary file]`	산출 레이어를 지정합니다. 다음 가운데 하나로 저장할 수 있습니다: 임시 파일로 저장 파일로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.3.2. 산출물¶

라벨	명칭	유형	설명
Output	`OUTPUT`	[raster]	계산된 값을 가진 산출 래스터 파일

23.1.9.3.3. 파이썬 코드¶

Algorithm ID: qgis:rastercalculator

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.4. 래스터 레이어 통계 ¶

래스터 레이어의 지정한 밴드의 값으로부터 기본 통계를 계산합니다. Processing ▶ Results viewer 메뉴로 산출물을 불러옵니다.

23.1.9.4.1. 파라미터¶

라벨

명칭

유형

설명

Input layer

INPUT

[raster]

입력 래스터 레이어

Band number

BAND

[raster band]

기본값: 입력 레이어의 첫 번째 밴드

래스터가 다중 밴드인 경우, 통계를 얻고자 하는 밴드를 선택하십시오.

Output

OUTPUT_HTML_FILE

[html]

기본값: [Save to temporary file]

산출 레이어를 지정합니다:

산출물 건너뛰기
임시 파일로 저장
파일로 저장

이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.4.2. 산출물¶

라벨	명칭	유형	설명
Maximum value	`MAX`	[number]
Mean value	`MEAN`	[number]
Minimum value	`MIN`	[number]
Output	`OUTPUT_HTML_FILE`	[html]	산출물 파일은 다음 정보를 담고 있습니다: 파일 분석: 래스터 레이어의 경로 최소값: 래스터의 최소값 최대값: 래스터의 최대값 범위: 최대값과 최소값의 차 합계: 값들의 총합 평균값: 값들의 평균 표준 편차: 값들의 표준 편차 제곱 합계: 전체 평균과 각 관측값의 차를 제곱한 값의 합계
Range	`RANGE`	[number]
Standard deviation	`STD_DEV`	[number]
Sum	`SUM`	[number]
Sum of the squares	`SUM_OF_SQUARES`	[number]

23.1.9.4.3. 파이썬 코드¶

Algorithm ID: qgis:rasterlayerstatistics

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.5. 래스터 레이어 유일값 보고 ¶

지정한 래스터 레이어에 있는 각 유일값의 개수와 면적을 반환합니다.

23.1.9.5.1. 파라미터¶

라벨	명칭	유형	설명
Input layer	`INPUT`	[raster]	입력 래스터 레이어
Band number	`BAND`	[raster band] 기본값: 입력 레이어의 첫 번째 밴드	래스터가 다중 밴드인 경우, 통계를 얻고자 하는 밴드를 선택하십시오.
Unique values report	`OUTPUT_HTML_FILE`	[file] 기본값: `[Save to temporary file]`	산출 레이어를 지정합니다: 산출물 건너뛰기 임시 파일로 저장 파일로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.
Unique values table	`OUTPUT_TABLE`	[table] 기본값: `[Skip output]`	유일값을 위한 테이블을 지정합니다: 산출물 건너뛰기 임시 레이어 생성 파일로 저장 Geopackage로 저장 PostGIS 테이블로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.5.2. 산출물¶

라벨	명칭	유형	설명
CRS authority identifier	`CRS_AUTHID`	[crs]
Extent	`EXTENT`	[extent]
Height in pixels	`HEIGHT_IN_PIXELS`	[number]
NODATA pixel count	`NODATA_PIXEL_COUNT`	[number]
Total pixel count	`TOTAL_PIXEL_COUNT`	[number]
Unique values report	`OUTPUT_HTML_FILE`	[html]	산출 HTML 파일은 다음 정보를 담고 있습니다: 파일 분석: 래스터 레이어의 경로 범위: 범위의 xmin, ymin, xmax, ymax 좌표 투영체: 레이어의 투영체 픽셀 단위 너비: 열의 개수와 픽셀 너비 크기 픽셀 단위 높이: 행의 개수와 픽셀 너비 크기 총 픽셀 개수: 모든 픽셀의 개수 NODATA 픽셀 개수: NODATA 값을 가진 픽셀의 개수
Unique values table	`OUTPUT_TABLE`	[table]	다음 열 3개를 가진 테이블: value: 픽셀 값 count: 해당 값을 가진 픽셀의 개수 m²: 해당 값을 가진 픽셀의 제곱미터 단위 총 면적
Width in pixels	`WIDTH_IN_PIXELS`	[number]

23.1.9.5.3. 파이썬 코드¶

Algorithm ID: qgis:rasterlayeruniquevaluesreport

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.6. 래스터 레이어 구역 통계 ¶

래스터 레이어의 값을 또다른 레이어에서 정의한 구역(zone)으로 범주화한 통계를 계산합니다.

구역 통계

23.1.9.6.1. 파라미터¶

라벨	명칭	유형	설명
Input Layer	`INPUT`	[raster]	입력 래스터 레이어
Band number	`BAND`	[raster band] 기본값: 래스터 레이어의 첫 번째 밴드	래스터가 다중 밴드인 경우, 통계를 계산하고자 하는 밴드를 선택하십시오.
Zones layer	`ZONES`	[raster]	구역을 정의하는 래스터 레이어. 동일한 픽셀 값을 가진 인접한 픽셀들로 구역을 지정합니다.
Zones band number	`ZONES_BAND`	[raster band] 기본값: 래스터 레이어의 첫 번째 밴드	래스터가 다중 밴드인 경우, 구역을 정의하는 밴드를 선택하십시오.
Reference layer 부가적	`REF_LAYER`	[enumeration] 기본값: 0	산출 레이어에 구역을 결정할 때 참조물로 사용될 중심(centroid)을 계산하기 위해 사용되는 래스터 레이어입니다. 다음 가운데 하나를 선택할 수 있습니다: 0 — 입력 레이어 1 — 구역 레이어
Statistics	`OUTPUT_TABLE`	[table]	계산된 통계를 가진 테이블

23.1.9.6.2. 산출물¶

라벨	명칭	유형	설명
CRS authority identifier	`CRS_AUTHID`	[crs]
Extent	`EXTENT`	[extent]
Height in pixels	`HEIGHT_IN_PIXELS`	[number]
NODATA pixel count	`NODATA_PIXEL_COUNT`	[number]
Statistics	`OUTPUT_TABLE`	[table]	산출 레이어는 각 구역별로 다음 정보를 담고 있습니다: 면적: 구역의 제곱 래스터 단위 면적 합계: 구역에 있는 픽셀 값의 총합 개수: 구역에 있는 픽셀들의 개수 최소값: 구역에 있는 최소 픽셀 값 최대값: 구역에 있는 최대 픽셀 값 평균: 구역에 있는 픽셀 값들의 평균
Total pixel count	`TOTAL_PIXEL_COUNT`	[number]
Width in pixels	`WIDTH_IN_PIXELS`	[number]

23.1.9.6.3. 파이썬 코드¶

Algorithm ID: qgis:rasterlayerzonalstats

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.7. 래스터 표면 부피 ¶

지정한 기준면(base level)에 따라 래스터 표면 아래의 부피를 계산합니다. 주로 수치 표고 모델(DEM; Digital Elevation Model)에 유용한 알고리즘입니다.

23.1.9.7.1. 파라미터¶

라벨	명칭	유형	설명
INPUT layer	`INPUT`	[raster]	표면을 표현하는 입력 래스터
Band number	`BAND`	[raster band] 기본값: 래스터 레이어의 첫 번째 밴드	래스터가 다중 밴드인 경우, 표면을 정의할 밴드를 선택하십시오.
Base level	`LEVEL`	[number] 기본값: 0.0	기준 또는 참조 값을 정의합니다. 부피를 `Method` 파라미터에 따라 (아래 참조) 계산하는 데 이 기준을 사용합니다.
Method	`METHOD`	[enumeration] 기본값: 0	래스터 픽셀 값과 `Base level` 의 차로 지정하는 부피 계산용 방법을 정의합니다. 다음 옵션 가운데 하나를 선택할 수 있습니다: 0 — 기준면 위만 셉니다: 기준면 위에 있는 픽셀만 부피에 추가할 것입니다. 1 — 기준면 아래만 셉니다: 기준면 아래 있는 픽셀만 부피에 추가할 것입니다. 2 — 기준면 아래의 부피를 뺍니다: 기준면 위에 있는 픽셀을 부피에 추가하고, 기준면 아래 있는 픽셀을 부피에서 뺄 것입니다. 3 — 기준면 아래의 부피를 추가합니다: 픽셀이 기준면 위에 있든 아래 있든 상관없이 부피에 추가합니다. 이 옵션은 픽셀 값과 기준면의 차의 절대값을 합한 것과 동일합니다.
Surface volume report	`OUTPUT_HTML_FILE`	[html] 기본값: `[Save to temporary file]`	산출 HTML 파일을 지정합니다. 다음 가운데 하나를 선택할 수 있습니다: 산출물 건너뛰기 임시 파일로 저장 파일로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.
Surface volume table	`OUTPUT_TABLE`	[table] 기본값: `[Skip output]`	산출 테이블을 지정합니다. 다음 가운데 하나로 저장할 수 있습니다: 산출물 건너뛰기 임시 레이어 생성 (`TEMPORARY_OUTPUT`) 파일로 저장 Geopackage로 저장 PostGIS 테이블로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.7.2. 산출물¶

라벨	명칭	유형	설명
Volume	`VOLUME`	[number]	계산된 부피
Area	`AREA`	[number]	제곱 맵 단위의 면적
Pixel_count	`PIXEL_COUNT`	[number]	분석된 픽셀의 총 개수
Surface volume report	`OUTPUT_HTML_FILE`	[html]	HTML 서식으로 된 (부피, 면적 및 픽셀 개수를 담고 있는) 산출 보고서
Surface volume table	`OUTPUT_TABLE`	[table]	(부피, 면적 및 픽셀 개수를 담고 있는) 산출 테이블

23.1.9.7.3. 파이썬 코드¶

Algorithm ID: qgis:rastersurfacevolume

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.8. 래스터로 재범주화 ¶

래스터를 벡터 테이블에서 지정된 범위를 기반으로 하는 새 범주 값을 할당해서 재범주화합니다.

23.1.9.8.1. 파라미터¶

라벨	명칭	유형	설명
Raster layer	`INPUT_RASTER`	[raster]	재범주화할 래스터 레이어
Band number	`RASTER_BAND`	[raster band] 기본값: 래스터 레이어의 첫 번째 밴드	래스터가 다중 밴드인 경우, 재범주화하려는 밴드를 선택하십시오.
Layer containing class breaks	`INPUT_TABLE`	[vector: any]	범주화에 사용할 값을 담고 있는 벡터 레이어
Minimum class value field	`MIN_FIELD`	[tablefield: numeric]	범주용 범위의 최소값을 가진 필드
Maximum class value field	`MAX_FIELD`	[tablefield: numeric]	범주용 범위의 최대값을 가진 필드
Output value field	`VALUE_FIELD`	[tablefield: numeric]	(대응하는 최소 및 최대값 사이의) 범주에 들어오는 픽셀에 할당될 값을 가진 필드
Output no data value	`NO_DATA`	[number] 기본값: -9999.0	NODATA 값에 적용할 값
Range boundaries	`RANGE_BOUNDARIES`	[enumeration] 기본값: 0	범주화를 위한 비교 규칙을 정의합니다. 다음 옵션 가운데 선택할 수 있습니다: 0 — 최소값 < 값 <= 최대값 1 — 최소값 <= 값 < 최대값 2 — 최소값 <= 값 <= 최대값 3 — 최소값 < 값 < 최대값
Use no data when no range matches value	`NODATA_FOR_MISSING`	[boolean] 기본값: False	범주에 속하지 않는 값은 NODATA 값으로 산출될 것입니다. False로 설정한 경우, 원본 값을 유지합니다.
Output data type	`DATA_TYPE`	[enumeration] 기본값: 5	산출 래스터 파일의 데이터 유형을 정의합니다. 다음 가운데 하나로 지정할 수 있습니다: 0 — 바이트(Byte) 1 — 부호 있는 16비트 정수형(Int16) 2 — 부호 없는 16비트 정수형(UInt16) 3 — 부호 없는 32비트 정수형(UInt32) 4 — 부호 있는 32비트 정수형(Int32) 5 — 부동소수점 32비트 실수형(Float32) 6 — 부동소수점 64비트 실수형(Float64) 7 — 복잡 16비트 정수형(CInt16) 8 — 복잡 32비트 정수형(CInt32) 9 — 복잡 부동소수점 32비트 실수형(CFloat32) 10 — 복잡 부동소수점 64비트 실수형(CFloat64)
Reclassified raster	`OUTPUT`	[raster]	산출 레이어를 지정합니다. 다음 가운데 하나로 저장할 수 있습니다: 임시 파일로 저장 파일로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.8.2. 산출물¶

라벨	명칭	유형	설명
Reclassified raster	`OUTPUT`	[raster]	재범주화된 밴드 값을 가진 산출 래스터 레이어

23.1.9.8.3. 파이썬 코드¶

Algorithm ID: qgis:reclassifybylayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.9. 테이블로 재범주화 ¶

래스터를 고정 테이블에서 지정된 범위를 기반으로 하는 새 범주 값을 할당해서 재범주화합니다.

23.1.9.9.1. 파라미터¶

라벨	명칭	유형	설명
Raster layer	`INPUT_RASTER`	[raster]	재범주화할 래스터 레이어
Band number	`RASTER_BAND`	[raster band] 기본값: 1	값을 재계산하고자 하는 래스터 밴드
Reclassification table	`TABLE`	[table]	각 범주의 범위(`Minimum` 및 `Maximum`)를 설정할 값과 범주 안에 들어오는 밴드 값에 할당할 새 `Value` 로 채워질 열 3개로 이루어진 테이블
Output no data value	`NO_DATA`	[number] 기본값: -9999.0	NODATA 값에 적용할 값
Range boundaries	`RANGE_BOUNDARIES`	[enumeration] 기본값: 0	범주화를 위한 비교 규칙을 정의합니다. 다음 옵션 가운데 선택할 수 있습니다: 0 — 최소값 < 값 <= 최대값 1 — 최소값 <= 값 < 최대값 2 — 최소값 <= 값 <= 최대값 3 — 최소값 < 값 < 최대값
Use no data when no range matches value	`NODATA_FOR_MISSING`	[boolean] 기본값: False	어떤 범주에도 들어오지 않는 밴드 값에 NODATA 값을 적용합니다. False로 설정한 경우, 원본 값을 유지합니다.
Output data type	`DATA_TYPE`	[enumeration] 기본값: 5	산출 래스터 파일의 포맷을 정의합니다. 옵션: 0 — 바이트(Byte) 1 — 부호 있는 16비트 정수형(Int16) 2 — 부호 없는 16비트 정수형(UInt16) 3 — 부호 없는 32비트 정수형(UInt32) 4 — 부호 있는 32비트 정수형(Int32) 5 — 부동소수점 32비트 실수형(Float32) 6 — 부동소수점 64비트 실수형(Float64) 7 — 복잡 16비트 정수형(CInt16) 8 — 복잡 32비트 정수형(CInt32) 9 — 복잡 부동소수점 32비트 실수형(CFloat32) 10 — 복잡 부동소수점 64비트 실수형(CFloat64)
Reclassified raster	`OUTPUT`	[raster] 기본값: 〈[Save to temporary file]〉	산출 래스터 레이어를 지정합니다. 다음 가운데 하나로 저장할 수 있습니다: 임시 파일로 저장 파일로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.9.2. 산출물¶

라벨

명칭

유형

설명

Reclassified raster

OUTPUT

[raster]

기본값: 〈[Save to temporary file]〉

산출 래스터 레이어

23.1.9.9.3. 파이썬 코드¶

Algorithm ID: qgis:reclassifybytable

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.10. 래스터 값 샘플링 ¶

포인트 위치에 있는 래스터 값을 추출합니다. 래스터 레이어가 다중 밴드인 경우, 각 밴드를 샘플링합니다.

산출 레이어의 속성 테이블은 래스터 레이어의 밴드 개수만큼의 새 열을 가질 것입니다.

23.1.9.10.1. 파라미터¶

라벨	명칭	유형	설명
Input Point Layer	`INPUT`	[vector: point]	샘플링에 사용할 포인트 벡터 레이어
Raster Layer to sample	`RASTERCOPY`	[raster]	지정한 포인트 위치에서 샘플링할 래스터 레이어
Output column prefix	`COLUMN_PREFIX`	[string] 기본값: 〈rvalue〉	추가될 열의 명칭 앞에 붙일 접두어
Sampled Points (Optional)	`OUTPUT`	[vector: point] 기본값: `[Create temporary layer]`	샘플링된 값을 담고 있는 산출 레이어를 지정합니다. 다음 가운데 하나로 저장할 수 있습니다: 임시 레이어 생성 (`TEMPORARY_OUTPUT`) 파일로 저장 Geopackage로 저장 PostGIS 테이블로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.10.2. 산출물¶

라벨

명칭

유형

설명

Sampled Points

(Optional)

OUTPUT

[vector: point]

샘플링된 값을 담고 있는 산출 레이어

23.1.9.10.3. 파이썬 코드¶

Algorithm ID: qgis:rastersampling

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.11. 구역 히스토그램 ¶

폴리곤 피처 내부에 담겨진 래스터 레이어에서 나온 각 유일값의 개수를 표현하는 필드를 추가합니다.

산출 레이어의 속성 테이블은 폴리곤(들)과 교차하는 래스터 레이어의 유일값 개수만큼의 필드를 가질 것입니다.

../../../../_images/raster_histogram.png

그림 23.7 래스터 레이어 히스토그램 예시¶

23.1.9.11.1. 파라미터¶

라벨	명칭	유형	설명
Raster layer	`INPUT_RASTER`	[raster]	입력 래스터 레이어
Band number	`RASTER_BAND`	[raster band] 기본값: 입력 레이어의 첫 번째 밴드	래스터가 다중 밴드인 경우, 밴드를 선택하십시오.
Vector layer containing zones	`INPUT_VECTOR`	[vector: polygon]	구역을 정의하는 벡터 폴리곤 레이어
Output column prefix	`COLUMN_PREFIX` 부가적	[string] 기본값: 〈HISTO_〉	산출 열의 명칭 앞에 붙일 접두어
Output zones	`OUTPUT`	[vector: polygon] 기본값: `[Create temporary layer]`	산출 벡터 폴리곤 레이어를 지정합니다. 다음 가운데 하나로 저장할 수 있습니다: 임시 레이어 생성 (`TEMPORARY_OUTPUT`) 파일로 저장 Geopackage로 저장 PostGIS 테이블로 저장 이 파라미터에서 파일 인코딩도 변경할 수 있습니다.

23.1.9.11.2. 산출물¶

라벨

명칭

유형

설명

Output zones

(Optional)

OUTPUT

[vector: polygon]

기본값: [Create temporary layer]

산출 벡터 폴리곤 레이어

23.1.9.11.3. 파이썬 코드¶

Algorithm ID: qgis:zonalhistogram

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

23.1.9.12. 구역 통계 ¶

중첩하는 폴리곤 벡터 레이어의 각 피처에 해당하는 래스터 레이어 영역의 통계를 계산합니다.

경고

새 산출물 파일을 생성하지 않을 것입니다. 이 알고리즘은 소스 벡터 레이어에 새 열을 추가합니다.

23.1.9.12.1. 파라미터¶

라벨	명칭	유형	설명
Raster layer	`INPUT_RASTER`	[raster]	입력 래스터 레이어
Raster band	`RASTER_BAND`	[raster band] 기본값: 입력 레이어의 첫 번째 밴드	래스터가 다중 밴드인 경우, 통계를 얻고자 하는 밴드를 선택하십시오.
Vector layer containing zones	`INPUT_VECTOR`	[vector: polygon]	구역을 정의하는 벡터 폴리곤 레이어
Output column prefix	`COLUMN_PREFIX`	[string] 기본값: 〈_〉	산출 열의 명칭 앞에 붙일 접두어
Statistics to calculate	`STATISTICS`	[enumeration] [list] 기본값: [0,1,2]	산출물을 위한 통계 연산자의 목록. 다음 옵션 가운데 선택할 수 있습니다: 0 — 개수(Count) 1 — 합계(Sum) 2 — 평균(Mean) 3 — 중간값(Median) 4 — 표준 편차(St. dev.) 5 — 최소값(Minimum) 6 — 최대값(Maximum) 7 — 범위(Range) 8 — 소수 기준(Minority) 9 — 다수 기준(Majority) 10 — 다양도(Variety) 11 — 변동(Variance)

23.1.9.12.2. 산출물¶

라벨	명칭	유형	설명
Vector layer containing zones	`INPUT_VECTOR`	[vector: polygon]	추가 통계를 가진 입력 구역 벡터 레이어

23.1.9.12.3. 파이썬 코드¶

Algorithm ID: qgis:zonalstatistics

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 명칭 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.