Outdated version of the documentation. Find the latest one here.

래스터 레이어 사용

이 장에서는 래스터 레이어에 대해 할 수 있는 다양한 작업을 소개합니다.

레이어 상세 정보

래스터 레이어는 하나 이상의 래스터 밴드로 이루어져 있습니다. 각각 단일 밴드 또는 다중 밴드로 부릅니다. 하나의 밴드는 값들의 행렬을 나타냅니다. 일반 컬러 이미지(항공사진 등)는 빨간색, 파란색, 녹색 밴드로 이루어진 래스터입니다. 단일 밴드 레이어는 일반적으로 연속적인 변수(표고 등) 또는 불연속 변수(토지이용 등)를 나타냅니다. 어떤 경우, 래스터 레이어에 색상표가 포함돼 있어 색상표에 지정된 색상으로 래스터 값을 나타내기도 합니다.

rlayer.width(), rlayer.height()
(812, 301)
rlayer.extent()
<qgis._core.QgsRectangle object at 0x000000000F8A2048>
rlayer.extent().toString()
u'12.095833,48.552777 : 18.863888,51.056944'
rlayer.rasterType()
2  # 0 = GrayOrUndefined (single band), 1 = Palette (single band), 2 = Multiband
rlayer.bandCount()
3
rlayer.metadata()
u'<p class="glossy">Driver:</p>...'
rlayer.hasPyramids()
False

Drawing Style

When a raster layer is loaded, it gets a default drawing style based on its type. It can be altered either in raster layer properties or programmatically. The following drawing styles exist:

Index Constant: QgsRasterLater.X Comment
1 SingleBandGray Single band image drawn as a range of gray colors
2 SingleBandPseudoColor Single band image drawn using a pseudocolor algorithm
3 PalettedColor “Palette” image drawn using color table
4 PalettedSingleBandGray “Palette” layer drawn in gray scale
5 PalettedSingleBandPseudoColor “Palette” layer drawn using a pseudocolor algorithm
7 MultiBandSingleBandGray Layer containing 2 or more bands, but a single band drawn as a range of gray colors
8 MultiBandSingleBandPseudoColor Layer containing 2 or more bands, but a single band drawn using a pseudocolor algorithm
9 MultiBandColor Layer containing 2 or more bands, mapped to RGB color space.

To query the current drawing style:

rlayer.renderer().type()
u'singlebandpseudocolor'

단일 밴드 래스터 레이어를 회색조(낮은 값=검은색, 높은 값=하얀색)로 그릴 수도 있고, 단일 밴드의 값에 색상을 배정하는 의사색채 알고리즘으로 그릴 수도 있습니다. 계단식 값(palette)을 가진 단일 밴드 래스터는 그 값에 지정된 색상표를 적용해서 그릴 수 있습니다. 다중 밴드 레이어는 일반적으로 밴드들을 RGB 색상에 매핑해서 그리지만 단 하나의 밴드만 사용해서 회색조나 의사색채 알고리즘으로 그리는 것도 가능합니다.

다음 단계에서는 레이어의 그리기 스타일을 조회 및 수정하는 방법을 설명합니다. 변경을 완료한 다음 맵 캔버스를 강제로 업데이트하고자 할 경우 레이어 새로고침 을 참조하세요.

TODO:

대비 향상, 투명처리 (널 데이터), 사용자 정의 최대값/최소값, 밴드 통계

단일 밴드 래스터

They are rendered in gray colors by default. To change the drawing style to pseudocolor:

# Check the renderer
rlayer.renderer().type()
u'singlebandgray'
rlayer.setDrawingStyle("SingleBandPseudoColor")
# The renderer is now changed
rlayer.renderer().type()
u'singlebandpseudocolor'
# Set a color ramp hader function
shader_func = QgsColorRampShader()
rlayer.renderer().shader().setRasterShaderFunction(shader_func)

The PseudoColorShader is a basic shader that highlights low values in blue and high values in red. There is also ColorRampShader which maps the colors as specified by its color map. It has three modes of interpolation of values:

  • 선형(linear) (INTERPOLATED) : 실제 픽셀값 위아래의 색상 맵 항목들로부터 선형적으로 보간된 색상이 산출됩니다.

  • 이산(discrete) (DISCRETE) : 색상 맵 항목에서 동일하거나 높은 값으로 색상이 산출됩니다.

  • 동일(exact) (EXACT) : 색상을 보간하지 않고, 색상 맵 항목과 동일한 값을 가진 픽셀만 그립니다.

To set an interpolated color ramp shader ranging from green to yellow color (for pixel values from 0 to 255):

rlayer.renderer().shader().setRasterShaderFunction(QgsColorRampShader())
lst = [QgsColorRampShader.ColorRampItem(0, QColor(0, 255, 0)), \
    QgsColorRampShader.ColorRampItem(255, QColor(255, 255 ,0))]
fcn = rlayer.renderer().shader().rasterShaderFunction()
fcn.setColorRampType(QgsColorRampShader.INTERPOLATED)
fcn.setColorRampItemList(lst)

To return back to default gray levels, use:

rlayer.setDrawingStyle('SingleBandGray')

다중 밴드 래스터

QGIS는 기본적으로 처음 세 밴드를 각각 빨간색, 녹색, 파란색에 매핑해서 컬러 이미지를 생성합니다. (바로 MultiBandColor 그리기 스타일입니다.) 때로는 사용자가 이 설정을 바꾸고 싶을 수도 있습니다. 다음은 빨간색 밴드 (1)과 녹색 밴드 (2)를 맞바꾸는 코드입니다.

rlayer.setDrawingStyle('MultiBandColor')
rlayer.renderer().setGreenBand(1)
rlayer.setRedBand(2)

레이어 새로고침

레이어의 심볼을 변경하고 변경 사항을 즉시 사용자에게 보여주고 싶은 경우에는 다음 메소드를 호출하십시오.

if hasattr(layer, "setCacheImage"):
  layer.setCacheImage(None)
layer.triggerRepaint()

소스의 첫번째 부분은 렌더링 캐시 옵션이 활성화된 경우 렌더링된 레이어의 캐시 이미지를 소거합니다. QGIS 1.4 버전부터 이 기능을 사용할 수 있고, 그 이전 버전에는 이 기능이 없습니다. 따라서 QGIS의 모든 버전에서 이 코드를 작동시키려면 먼저 이 메소드가 존재하는지 확인해야 합니다.

두 번째 부분은 레이어를 담고 있는 모든 맵 캔버스를 새로고침 하게 만드는 신호를 보냅니다.

WMS 래스터 레이어의 경우, 이 명령어들이 작동하지 않습니다. 이 경우 별도로 다음과 같이 하셔야 합니다.

layer.dataProvider().reloadData()
layer.triggerRepaint()

레이어의 심볼을 변경한 경우 (그 방법은 래스터 및 벡터 레이어 관련 항목을 참조하세요) QGIS에서 레이어 목록(범례) 위젯에 있는 레이어 심볼을 업데이트하도록 할 수도 있습니다. 다음과 같이 하면 됩니다. (ifaceQgisInterface 클래스의 인스턴스입니다.)

iface.legendInterface().refreshLayerSymbology(layer)

값 조회

래스터 레이어의 어떤 특정 포인트의 밴드 값을 조회하려면 다음 함수를 사용하십시오.

ident = rlayer.dataProvider().identify(QgsPoint(15.30, 40.98), \
  QgsRaster.IdentifyFormatValue)
if ident.isValid():
  print ident.results()

이 경우 results 메소드가 키(key)로 밴드 인덱스를, 값(value)으로 밴드 값을 담은 사전식으로 정리된 목록(dictionary)을 반환합니다.

{1: 17, 2: 220}