É possível usar o Asset Manager ou a interface de linha de comando (CLI) para fazer upload de imagens ou outros conjuntos de dados raster georeferenciados no formato GeoTIFF ou TFRecord. Consulte Como importar dados vetoriais para saber como importar vetores usando o editor de código.
Fazer upload de recursos de imagem
GeoTIFF
No Code Editor, é possível fazer upload de arquivos de imagem GeoTIFF com até 10 GB de tamanho para a pasta de usuário do Earth Engine. Para arquivos maiores, use a opção upload de linha de comando.
Para fazer upload de um GeoTIFF usando o Code Editor, selecione a guia "Recursos" no canto superior esquerdo, clique no botão e selecione Upload de
imagem. O Earth Engine apresenta uma caixa de diálogo de upload semelhante à
Figura 1. Clique no botão SELECT e navegue até um GeoTIFF no seu sistema de arquivos local.
Dê à imagem um ID de recurso adequado (que ainda não exista) na
pasta do usuário. Se você quiser fazer upload da imagem em uma pasta ou coleção,
adicione o ID do recurso com o ID da pasta ou coleção, por exemplo,
projects/myproject/folder-or-collection-id/new-asset.
Clique em UPLOAD para iniciar o upload.
Depois que você iniciar o upload, uma tarefa de "Transferência de recursos" vai aparecer na guia "Tarefas"
no lado direito do editor de código. Passar o cursor sobre a tarefa no gerenciador de tarefas mostra um
? que pode ser usado para verificar o status do upload. Para cancelar um upload,
clique no ícone de carregamento ao lado da
tarefa. Quando a transferência for concluída, o recurso vai aparecer na pasta do usuário com
um ícone .
Compactação do GeoTIFF
Os arquivos GeoTIFF podem ser compactados com DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP ou ZSTD.
Recomendações para a melhor experiência de upload de arquivos grandes:
- Melhor escolha:o ZSTD oferece um bom equilíbrio entre velocidade e compactação.
- Evite:a LZMA pode ser muito lenta, apesar da boa compactação.
- Arquivos descompactados:resultam em arquivos maiores e em tempos de upload mais longos.
- Compressão com perdas (por exemplo, JPEG: pode alterar os valores dos pixels. Use compactação sem perdas (por exemplo, DEFLATE, LZMA, LZW, ZSTD) em vez de com perda, a menos que você entenda o possível impacto nos seus dados.
TFRecord
Para fazer upload de uma imagem de um arquivo TFRecord, você precisa ter o arquivo de mistura associado que foi gerado quando você exportou as imagens em que realizou a inferência. Consulte a página de exportação para saber mais sobre o arquivo do mixer. Mais especificamente, para importar previsões (como uma imagem) feitas em imagens exportadas,
- Exporte imagens para um ou mais arquivos TFRecord.
- Realize a inferência nas imagens (ou seja,
model.predict()). - Grave a saída de
model.predict()em um arquivo TFRecord. As previsões precisam estar na mesma ordem das exportações de imagem em que você realizou a inferência. A ordem pode ser aplicada por uma classificação dos nomes de arquivos produzidos pela exportação. Consulte a seção Exportações de arquivos grandes para mais detalhes. - Faça upload dos arquivos TFRecord e do mixer associado ao Earth Engine.
Edição de propriedades
Edite os metadados do recurso especificando uma ou mais propriedades de metadados. No menu
Properties, clique em Add property para
definir um nome e um valor de propriedade (Figura 2). O valor pode ser uma string ou um número.
Insira strings sem aspas. Para formatar um número como uma string, insira uma aspa simples
(') antes do número.
Por padrão, uma propriedade system:time_start
é adicionada sem valor. Essa propriedade é usada pelo Earth Engine ao aplicar filtros de data ImageCollection. Insira uma data no formato mostrado
na Figura 2 ou um número que represente milissegundos desde 1º de janeiro de 1970. Consulte o glossário para mais informações sobre carimbos de data/hora no Earth Engine.
O Asset Manager interpreta um número inserido como o valor de uma propriedade chamada
system:time_start ou system:time_end como milissegundos e
o formata como uma data.
Clique no ícone para remover uma propriedade.
Opções avançadas
No menu Advanced, escolha a política de pirâmide e o modo de mascaramento para seus dados.
A política de piramidização especifica como o Earth Engine gera versões de resolução mais baixa da imagem. Saiba mais sobre como o Earth Engine processa várias resoluções no documento de escalonamento. Escolha uma política de escalonamento "Média", "Mínimo" ou "Máximo" para calcular níveis de resolução mais baixos da pirâmide de imagens como a média, o mínimo ou o máximo de cada grupo de 2 x 2 pixels de resolução mais alta. Essa é uma opção adequada para imagens com valores contínuos. Para dados categóricos (por exemplo, cobertura de terra) ou de QA, escolha uma política de acúmulo de "Amostra" (o pixel superior esquerdo) ou "Modo" (valor que ocorre com mais frequência ou amostra, se não houver modo).
O modo de mascaramento indica como a imagem enviada é mascarada (se for o caso). Para especificar um valor sem dados, selecione "Valor sem dados" e insira o valor. Os pixels com esse valor serão mascarados na imagem enviada. Esse valor é aplicado a cada banda da imagem de forma independente. Para usar a última faixa da imagem como uma máscara para as outras faixas de imagem, selecione "Usar a última faixa como faixa alfa". A banda alfa precisa ser uma banda não assinada de 8 bits em que 0 é mascarado (totalmente transparente) e 255 é totalmente opaco.
Uploads em blocos
Para fazer upload de uma única imagem como vários blocos, em que cada bloco é armazenado em um arquivo de origem diferente, clique em Adicionar outro arquivo para adicionar mais arquivos ao upload. O Earth Engine vai combinar os blocos para criar uma única imagem na sua pasta de usuário.
Há algumas restrições sobre os tipos de arquivos que podem ser enviados para um recurso de imagem. Especificamente:
- As imagens precisam ter o mesmo número de bandas, profundidade de bits, projeção, resolução e valores de preenchimento.
- O deslocamento de um arquivo para o próximo precisa ser um múltiplo inteiro do tamanho do pixel.
- As lacunas entre os blocos serão preenchidas com pixels mascarados na imagem final. Portanto, os blocos precisam ser adjacentes e não espalhados. Imagens com lacunas ocupando mais de 99% da área da imagem não serão ingeridas.