이미지를 사용한 계산

이제 이미지를 로드하고 표시하는 방법을 알았으니 이미지에 계산을 적용해 보겠습니다. 예를 들어 SRTM 고도 이미지를 ee.Terrain 패키지의 slope 메서드에 전달하여 지형의 경사를 계산할 수 있습니다.

코드 편집기(JavaScript)

// Load the SRTM image.
var srtm = ee.Image('CGIAR/SRTM90_V4');

// Apply an algorithm to an image.
var slope = ee.Terrain.slope(srtm);

// Display the result.
Map.setCenter(-112.8598, 36.2841, 9); // Center on the Grand Canyon.
Map.addLayer(slope, {min: 0, max :60}, 'slope');

코드 ee.Terrain.slope(srtm)에서 srtm 이미지는 경사 알고리즘의 인수로 제공됩니다. 결과는 그림 3과 같이 표시됩니다.

Tutorial_api_03_slope.png
그림 3. 경사 이미지

이미지 수학

ee.Image 클래스에는 이미지 객체에서 호출할 수 있는 메서드도 있습니다. 예를 들어 이미지 밴드를 사용하여 수학을 수행하려는 경우(밴드 수학 또는 지도 대수라고도 함) 예를 들어 경사 방향 이미지에 대한 삼각법 연산에 관심이 있을 수 있습니다. 이를 위해 먼저 방향 이미지를 라디안으로 변환한 다음 sin()를 호출합니다. srtm 이미지를 재사용하여

코드 편집기(JavaScript)

// Get the aspect (in degrees).
var aspect = ee.Terrain.aspect(srtm);

// Convert to radians, compute the sin of the aspect.
var sinImage = aspect.divide(180).multiply(Math.PI).sin();

// Display the result.
Map.addLayer(sinImage, {min: -1, max: 1}, 'sin');

그림 4와 같은 결과가 표시됩니다. aspect.divide(180).multiply(Math.PI).sin() 코드를 자세히 살펴보는 것이 좋습니다. 이와 같이 여러 메서드를 연결하면 코드는 'aspect를 180으로 나누고 그 결과에 π를 곱한 다음 마지막으로 sin을 구한다'는 의미가 됩니다. 이러한 방식으로 메서드를 결합하여 이미지에 복잡한 수학 연산을 수행할 수 있습니다. 수학 연산, add(), subtract(), multiply() 등의 전체 목록은 Image 문서를 참조하세요.

Tutorial_api_04_sin.png
그림 4. 지형 방향의 사인입니다.

이미지 통계

이미지에 대한 또 다른 유용한 작업 클래스에는 이미지 영역의 픽셀 통계 또는 래스터 벡터 오버레이 계산이 포함됩니다. Earth Engine에서 통계를 계산하려면 ee.Reducer 패키지의 클래스로 표현되는 리듀서를 사용합니다. 예를 들어 특정 지역의 평균 고도에 관심이 있다고 가정해 보겠습니다. 도형 그리기 도구를 사용하여 다각형을 그려 영역을 정의할 수 있습니다. 대화형으로 영역을 그리려면 다각형 그리기 도구()를 가져온 다음 관심 영역 위에 다각형을 디지털화하고 완료되면 종료를 클릭합니다. 결과 ee.Geometry 객체는 자동으로 geometry로 이름이 지정되고 스크립트 상단에 가져오기로 추가됩니다. 가져오기에서 변수 이름을 클릭하고 새 이름을 입력하여 변수 이름을 'polygon'으로 바꿉니다.

다음으로, 다음 코드를 사용하여 다각형의 평균 픽셀 값을 가져옵니다.

코드 편집기(JavaScript)

// Compute the mean elevation in the polygon.
var meanDict = srtm.reduceRegion({
  reducer: ee.Reducer.mean(),
  geometry: polygon,
  scale: 90
});

// Get the mean from the dictionary and print it.
var mean = meanDict.get('elevation');
print('Mean elevation', mean);

여기서 몇 가지 유의할 사항이 있습니다. 먼저 reduceRegion()는 Image 객체에 사용할 수 있는 메서드입니다 (여기에서 영역 축소에 대해 자세히 알아보기). 둘째, 메서드 인수는 단일 인수로 전달되는 JavaScript 객체에 제공됩니다. (구체적으로, 객체의 키는 메서드 매개변수의 이름입니다. 값은 메서드의 인수입니다. 세 번째로, reducer 매개변수는 계산할 통계 유형을 지정하고 geometry 매개변수는 통계를 계산할 리전을 지정합니다. scale 매개변수는 사용할 픽셀 크기(미터)입니다. 모호성을 방지하려면 Earth Engine이 입력에서 적절한 축척을 자동으로 결정하지 못할 수 있으므로 축소를 수행할 때 항상 축척을 지정해야 합니다. (Earth Engine의 축척에 대해 자세히 알아보기)

마지막으로 reduceRegion()의 반환 값은 키가 밴드 이름이고 값이 밴드의 픽셀 통계인 사전입니다. 사전의 get() 메서드는 인수로 제공된 키에 해당하는 값을 반환합니다. 이 경우 srtm 이미지에는 'elevation'이라는 하나의 밴드가 있으므로 예시 코드는 사전에서 해당 통계를 가져와 출력합니다.

이 코드를 실행할 때 다음과 같은 오류가 표시되는 경우:

걱정하지 마세요. 오류를 해결하기 위해 취할 수 있는 몇 가지 조치가 있습니다. reduceRegion() 메서드에는 계산에 많은 픽셀을 포함할지 여부를 고려하는지 확인하는 검사가 있습니다. 이는 전 세계의 모든 1미터 픽셀의 평균을 계산하려고 시도하는 것과 같은 어리석은 실수를 방지하기 위한 것입니다 (이렇게 하지 마세요). 오류를 해결하려면 bestEffort: true를 매개변수 사전에 추가하여 bestEffort 매개변수를 true로 설정하거나 maxPixels 매개변수를 기본값인 1,000만 픽셀보다 큰 값으로 설정하거나 둘 다 설정합니다. bestEffort가 true이면 Earth Engine은 maxPixels를 초과하지 않도록 배율을 자동으로 다시 계산합니다.

참고: Earth Engine의 축척

이전 예시에서 scale은 SRTM 이미지의 기본 해상도와 거의 동일하게 설정됩니다. 다음과 같이 이미지의 기본 해상도를 확인할 수 있습니다.

코드 편집기(JavaScript)

var scale = srtm.projection().nominalScale();
print('SRTM scale in meters', scale);

기본 해상도보다 작은 배율을 지정하면 Earth Engine은 최근접 이웃을 사용하여 입력 이미지를 리샘플링한 다음 더 작은 픽셀을 모두 계산에 포함합니다. 스케일을 더 크게 설정하면 Earth Engine은 입력의 집계된 버전에서 입력 픽셀을 사용합니다 (즉, 이미지 피라미드의 더 높은 수준에서 픽셀을 가져옴). Earth Engine에서 스케일을 처리하는 방법에 대한 자세한 내용은 이 문서를 참조하세요.

지금까지는 단일 밴드가 있는 단일 이미지로 작업했습니다. 다음 페이지에서는 멀티밴드 이미지와 이미지 컬렉션에 대해 알아봅니다.