ee.Classifier.smileKNN

Cria um classificador k-NN vazio.

O algoritmo de k-vizinhos mais próximos (k-NN) é um método para classificar objetos por uma votação majoritária dos vizinhos, com o objeto sendo atribuído à classe mais comum entre os k vizinhos mais próximos (k é um número inteiro positivo, geralmente pequeno e ímpar).

UsoRetorna
ee.Classifier.smileKNN(k, searchMethod, metric)Classificador
ArgumentoTipoDetalhes
kNúmero inteiro, padrão: 1O número de vizinhos para classificação.
searchMethodString, padrão: "AUTO"Método de pesquisa. As seguintes opções são válidas: [AUTO, LINEAR_SEARCH, KD_TREE, COVER_TREE]:

  • `AUTO` escolhe entre KD_TREE e COVER_TREE dependendo da contagem de dimensões. Se os recursos tiverem menos de 10 dimensões, o KD_TREE será usado.
  • `LINEAR_SEARCH`: tem uma performance melhor do que as abordagens de particionamento de espaço (como árvores K-D) em espaços de dimensões mais altas.
  • Método de pesquisa do vizinho mais próximo "KD_TREE" usando uma estrutura de conjunto de dados de particionamento de espaço para organizar pontos em um espaço k-dimensional. As árvores KD não são adequadas para encontrar o vizinho mais próximo de maneira eficiente em espaços de alta dimensão. Como regra geral, se a dimensionalidade for D, o número de pontos no conjunto de dados, N, deverá ser N >> 2^D.
  • `COVER_TREE` A árvore de cobertura é uma estrutura de dados para pesquisa genérica do vizinho mais próximo, que é especialmente eficiente em espaços com pequena dimensão intrínseca.

Os resultados podem variar entre os diferentes métodos de pesquisa para empates de distância e valores de probabilidade. Como a performance e os resultados podem variar, consulte a documentação do SMILE e outras fontes.

metricString, padrão: "EUCLIDEAN"A métrica de distância a ser usada. OBSERVAÇÃO: KD_TREE (e AUTO para dimensões baixas) não usará a métrica selecionada. As opções são:
  • `EUCLIDEAN`: distância euclidiana.
  • `MAHALANOBIS`: distância de Mahalanobis.
  • `MANHATTAN`: distância de Manhattan.
  • `BRAYCURTIS`: distância de Bray-Curtis.

Exemplos

Editor de código (JavaScript)

// Cloud masking for Landsat 8.
function maskL8sr(image) {
  var qaMask = image.select('QA_PIXEL').bitwiseAnd(parseInt('11111', 2)).eq(0);
  var saturationMask = image.select('QA_RADSAT').eq(0);

  // Apply the scaling factors to the appropriate bands.
  var opticalBands = image.select('SR_B.').multiply(0.0000275).add(-0.2);
  var thermalBands = image.select('ST_B.*').multiply(0.00341802).add(149.0);

  // Replace the original bands with the scaled ones and apply the masks.
  return image.addBands(opticalBands, null, true)
      .addBands(thermalBands, null, true)
      .updateMask(qaMask)
      .updateMask(saturationMask);
}

// Map the function over one year of data.
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_L2')
                     .filterDate('2020-01-01', '2021-01-01')
                     .map(maskL8sr);

// Make a median composite.
var composite = collection.median();

// Demonstration labels.
var labels = ee.FeatureCollection('projects/google/demo_landcover_labels')

// Use these bands for classification.
var bands = ['SR_B2', 'SR_B3', 'SR_B4', 'SR_B5', 'SR_B6', 'SR_B7'];
// The name of the property on the points storing the class label.
var classProperty = 'landcover';

// Sample the composite to generate training data.  Note that the
// class label is stored in the 'landcover' property.
var training = composite.select(bands).sampleRegions(
    {collection: labels, properties: [classProperty], scale: 30});

// Train a kNN classifier.
var classifier = ee.Classifier.smileKNN(5).train({
  features: training,
  classProperty: classProperty,
});

// Classify the composite.
var classified = composite.classify(classifier);
Map.setCenter(-122.184, 37.796, 12);
Map.addLayer(classified, {min: 0, max: 2, palette: ['red', 'green', 'blue']});

Configuração do Python

Consulte a página Ambiente Python (em inglês) para informações sobre a API Python e como usar geemap para desenvolvimento interativo.

import ee
import geemap.core as geemap

Colab (Python)

# Cloud masking for Landsat 8.
def mask_l8_sr(image):
  qa_mask = image.select('QA_PIXEL').bitwiseAnd(int('11111', 2)).eq(0)
  saturation_mask = image.select('QA_RADSAT').eq(0)

  # Apply the scaling factors to the appropriate bands.
  optical_bands = image.select('SR_B.').multiply(0.0000275).add(-0.2)
  thermal_bands = image.select('ST_B.*').multiply(0.00341802).add(149.0)

  # Replace the original bands with the scaled ones and apply the masks.
  return (
      image.addBands(optical_bands, None, True)
      .addBands(thermal_bands, None, True)
      .updateMask(qa_mask)
      .updateMask(saturation_mask)
  )


# Map the function over one year of data.
collection = (
    ee.ImageCollection('LANDSAT/LC08/C02/T1_L2')
    .filterDate('2020-01-01', '2021-01-01')
    .map(mask_l8_sr)
)

# Make a median composite.
composite = collection.median()

# Demonstration labels.
labels = ee.FeatureCollection('projects/google/demo_landcover_labels')

# Use these bands for classification.
bands = ['SR_B2', 'SR_B3', 'SR_B4', 'SR_B5', 'SR_B6', 'SR_B7']
# The name of the property on the points storing the class label.
class_property = 'landcover'

# Sample the composite to generate training data.  Note that the
# class label is stored in the 'landcover' property.
training = composite.select(bands).sampleRegions(
    collection=labels, properties=[class_property], scale=30
)

# Train a kNN classifier.
classifier = ee.Classifier.smileKNN(5).train(
    features=training, classProperty=class_property
)

# Classify the composite.
classified = composite.classify(classifier)

m = geemap.Map()
m.set_center(-122.184, 37.796, 12)
m.add_layer(
    classified, {'min': 0, 'max': 2, 'palette': ['red', 'green', 'blue']}
)
m