Author: ssec.wisc.edu
Exemplos de configuração do Interactive Image Composite Explorer (ICE) Versão 5 para seu próprio uso
Versão 5 - Lançado em 2017
Visão geral
O ICE5 foi desenvolvido para o Observatório da Terra da NASA na Universidade de Wisconsin-Madison, Centro de Ciência e Engenharia Espacial, por Tom Whittaker. É uma ferramenta que pode ser usada para permitir que as pessoas explorem imagens e dados de satélite usando um navegador da Web. Ele é projetado para ser flexível dentro do propósito pretendido, e pode ser facilmente configurado usando parâmetros HTML simples, conforme descrito abaixo.O ICE é codificado usando padrões HTML5 e, portanto, executado em qualquer navegador web moderno.
Ambiente do usuário final
O ICE5 é executado através de um navegador da Web. Foi codificado em HTML5 e CSS3. Isso pode ser usado em qualquer navegador web moderno, mas pode não ser adequado para dispositivos de tela pequena (por exemplo, smartphone).
Modos de configuração
O ICE possui quatro modos básicos de operação:- Combinação de cores (RGB)
- Combinações aritméticas
- Animações
- Mostrando 3 imagens
- Mostrando uma única imagem
- Escolher o botão de opção "Selecionar Região" permite a seleção de uma região retangular "arrastando" o ponteiro do mouse (segurando o botão esquerdo enquanto move o ponteiro). A "Outline Region" permite que você especifique uma região por um polígono fechado.
- Uma vez que uma região é selecionada, uma série de diagramas podem ser produzidos em uma segunda janela que ajuda a analisar os dados. Para esses diagramas (como um gráfico de dispersão) que precisam de dois conjuntos de dados, o usuário pode selecionar as miniaturas clicando neles; Caso contrário, os dois primeiros serão selecionados automaticamente.
Observe que, ao usar o modo "Mostrando 3 imagens", clicar em uma miniatura fará com que a imagem correspondente seja exibida no painel grande. Se você quiser fazer um diagrama de dispersão neste modo, o programa usará sempre o as duas últimas imagens visualizadas.
- A sonda irá ler os valores das 3 imagens originais. Existem duas formas da sonda: uma leitura simples de 3 valores e um pequeno gráfico projetado para ser usado com imagens que representam uma seqüência de tempo. Se o parâmetro 'calibração' for fornecido, a leitura da sonda será nessas unidades. Se o parâmetro 'navegação' for fornecido, a leitura da sonda também conterá a latitude e longitude do ponto.
- A caixa de seleção "Zoom / Roam" ativa esse modo. O zoom é feito com um clique no botão esquerdo; O zoom é um clique direito. (O botão Restaurar zooms para fora todo o caminho.) O roaming é feito "arrastando" o ponteiro do mouse, razão pela qual este modo e o modo 'Selecionar Região' são botões de rádio.
O que você precisa
Disponibilizar o ICE5 para seus usuários é tão fácil como colocar o arquivo "ice5_min.js" em um diretório acessível em seu servidor Web. (Clique direito neste link e "Save As".) Você então precisa disponibilizar suas imagens GIF ou JPEG no mesmo servidor (geralmente em um subdiretório de onde você coloca o código). Finalmente, você precisa inserir o start-up do webapp e os parâmetros no HTML para uma das suas páginas da Web nesse servidor.
A estrutura básica dos parâmetros que configuram o ICE5 é um objeto JavaScript, semelhante a este:
<html>
<head>
<script src="ice5_min.js">lt;script>
<script>
var ice5params = {
filenames : "images/band02.jpg,images/band06.jpg,images/band07.jpg",
labels : "0.87 micron,1.64 micron,2.13 micron",
do_rgb : "yes",
bgcolor :"#FFFF00"
};
</script>
<head>
<body onload="ICE5.init(ice5params, 'ice5div')">
<div id="ice5div"> <div>
<body>
<html>
Você precisará decidir qual modo você deseja usar para uma situação particular - é o que os seguintes exemplos irão ajudá-lo:
Exemplos dos modos
- Apresentar uma operação de combinação de cores (RGB), você incluirá essa lista de parâmetros em sua página HTML:
<script> var ice5params = { filenames : "images/band02.jpg,images/band06.jpg,images/band07.jpg", labels : "0.87 micron,1.64 micron,2.13 micron", do_rgb : "yes", bgcolor :"#FFFF00" }; </script>Clique aqui para ver este exemplo em ação. - Apresentar uma operação de combinação aritmética, você inseriu o seguinte fragmento no HTML da sua página (também adicionamos uma tabela de pesquisa de cores externa):
<script> var ice5params = { filenames : "images/band02.jpg,images/band06.jpg,images/band07.jpg", labels : "0.87 micron,1.64 micron,2.13 micron", do_math : "yes", colortable_labels : "AMSRE SST, modis_sky_wv, sst_35", colortable_filenames : "NEO_ACT2JSON/amsre_sst_anom.act.json, NEO_ACT2JSON/modis_sky_wv.act.json, NEO_ACT2JSON/sst_35.act.json", calibration_filenames : "NEO_DIDDY2JSON/amsre_sst_diddy.xml.json, NEO_DIDDY2JSON/modis_lst_diddy.xml.json, NEO_DIDDY2JSON/sst_35_diddy.xml.json", bgcolor :"#FFFF00", result_decimal : "2", initial_math : "3.0, 0, 1.0, 2, -2.7", resolution :"km,1.5,1.5" <\script>Note o parametro "initial_math". Isso ilustra o uso do "pre-computing" de modo que o painel de imagem principal do start-up mostre a combinação especificada das 3 imagens. Veja a descrição de "initial_math" mais tarde neste documento.Clique aqui para ver este exemplo em ação.
- Apresentar uma animação de três imagens, você colocaria o seguinte fragmento no HTML da sua página:
<script> var ice5params = { filenames : "images/band02.jpg,images/band06.jpg,images/band07.jpg", labels : "0.87 micron,1.64 micron,2.13 micron", do_animation : "yes", colortable_labels : "AMSRE SST, modis_sky_wv, sst_35", colortable_filenames : "NEO_ACT2JSON/amsre_sst_anom.act.json, NEO_ACT2JSON/modis_sky_wv.act.json, NEO_ACT2JSON/sst_35.act.json", calibration_filenames : "NEO_DIDDY2JSON/amsre_sst_diddy.xml.json, NEO_DIDDY2JSON/modis_cld_ci_diddy.xml.json, NEO_DIDDY2JSON/sst_35_diddy.xml.json", calibration_decimal : "1,2,0", calibration_missing : "99999,99999,99999", bgcolor :"#FFFF00", resolution :"km,1.5,1.5" <\script>Clique aqui para ver este exemplo em ação. - Apresentar apenas três imagens que você deseja exibir e permitir que o usuário explore, você usaria o parâmetro "do_nothing". Por exemplo, você poderia incluir os seguintes parâmetros no HTML da sua página:
var ice5params = { filenames : "images/band02.jpg,images/band06.jpg,images/band07.jpg", labels : "0.87 micron,1.64 micron,2.13 micron", do_nothing : "yes", colortable_labels : "AMSRE SST, modis_sky_wv, sst_35", colortable_filenames : "NEO_ACT2JSON/amsre_sst_anom.act.json, NEO_ACT2JSON/modis_sky_wv.act.json, NEO_ACT2JSON/sst_35.act.json", oldcalibration_filenames : "NEO_DIDDY2JSON/amsre_sst_diddy.xml.json, NEO_DIDDY2JSON/modis_npp_diddy.xml.json, NEO_DIDDY2JSON/sst_35_diddy.xml.json", oldcalibration_decimal : "1,2,0", calibration_decimal : "1,0,1", calibration : "^oC, 0=56.8, 176=-31.2, 254=110.2 & ^oK,slope=-.5,inter=320.1 & ~pix,0=255, 255=0", bgcolor :"#FFFF00", origresolution :"km,1.5,1.5", distance_decimal : "1", navigation : "45.0, -100.0, 40.0, -90.0, nmi" };Clique aqui para ver este exemplo em ação.Observe que também adicionamos uma curva de calibração para cada uma das imagens, e estas serão refletidas nos valores da sonda (juntamente com as unidades especificadas). Observe a "taquigrafia" para os sobrescritos para o grau e símbolo quadrado.
Se você quiser usar apenas uma imagem, você pode fazer algo como isto:
var ice5params = { filenames : "images/band02", labels : "0.87 micron", do_nothing : "yes", bgcolor :"#FFFF00" };Clique aqui para ver este exemplo em ação.
Lista completa de parâmetros e opções HTML
Aqui está uma lista completa dos parâmetros das opções disponíveis no ICE:- filenames lista os 3 nomes de arquivos de imagem a serem usados. A ordem será da esquerda para a direita nas miniaturas do visor e associada with "red", "green" e "blue", respectivamente.
- labels define o "short labels" para cada imagem
- longLabs define o "long labels" para cada imagem
- bgcolor especifica a cor de fundo para o painel de exibição do ICE. Você pode usar um nome comum (por exemplo, red, green, magenta, yellow, etc) ou uma cor RGB na forma: "#rrggbb" (valores hexadecimais).
- initial_math quando em modo matemático, você pode usar isso para especificar a combinação de matemática inicial exibida. Existem 5 itens separados por vírgulas: <red multiplier> <red/green operator> <green multiplier> <green/blue operator> códigos operador: 0 = add, 1 = subtract, 2=multiply, e 3 = divide
- distance_decimal o número de dígitos decimais a serem usados ao exibir a distância
- navigation_decimal o número de dígitos decimais a mostrar ao exibir as coordenadas de latitude / longitude
- result_decimal o número de dígitos decimais a mostrar ao exibir a sonda e usando o modo "do_math".
- navigation especifica a latitude e longitude dos cantos superior esquerdo e inferior direito da imagem original e define as unidades a serem usadas ao exibir distâncias. Exemplo:
navigation : "43., -90., 27.3, -77., nmi"
Com este parâmetro, tanto a leitura de latitude / longitude quando usa a sonda de dados, quanta distancia estão disponíveis. - resolution especifica as unidades e a resolução por pixel. As unidades aceitáveis são: m, km, mi, nm, pixels. E, por exemplo, para unidades de quilômetros, onde a resolução da linha é de 32,3 km e a resolução do elemento é de 51,7 km:
resolution = km, 32.3, 51.7
Com este parâmetro, a distância pode ser mostrado. - modo do_:
- do_math configura o modo matemático
- do_animation configura para permitir a animação
- do_rgb configura para permitir combinações RGB
- do_none configura apenas 3 imagens. Este é o padrão.
- calibration_filenames uma lista separada por vírgulas de 3 arquivos JSON de calibração que contêm conversões de valores de 8 bits para (possivelmente) valores físicos.
- calibration_decimal uma lista separada por vírgulas de 3 números que indicam o número de dígitos decimais a serem usados ao exibir valores calibrados na sonda
- calibration permite que sejam especificados os pontos de interrupção lineares e / ou formas de calibração de inclinação. Exemplo:
calibration : "^oC, 0=31.7, 120=0.5, 254=-97.3"
calibration : "^oC, 0=31.7, 120=0.5, 254=-97.3 & W/m^2, slope=2.3, intercept=83.1 & ^oK, 0=322, 255=243.3" - colortable_filenames uma lista separada por vírgulas de tabelas de cor JSON (aprimoramento) que o usuário pode escolher para colorir imagens (não para modo RGB).
- colortable_labels uma lista de nomes separados por vírgulas para mostrar ao usuário que corresponde ao colortable_filenames.
- image_colortables uma lista separada por vírgulas dos nomes dos arquivos das 3 tabelas de cores para usar ao mostrar as imagens em miniatura ao usar o modo do_none. A tabela associada também será usada quando a imagem selecionada for mostrada no painel principal.
- graphWindowOffsetXY um par separado por vírgulas de coordenadas de pixels X e Y que indicam a localização do canto superior esquerdo das janelas gráficas em relação ao widget principal. Este parâmetro é útil para alterar a localização das janelas gráficas dentro de uma página da Web como um todo.
graphWindowOffsetXY : "10,10" é a localização padrão, deslocada por 10 pixels do canto superior esquerdo do widget.
graphWindowOffsetXY : "350,-170" posicionará a janela do gráfico 350 pixels sobre (X) e 170 pixels acima (Y) o widget.
Aviso de direitos autorais
O software aqui descrito é o pacote ICE (Image Componsite Explorer), um kit de ferramentas baseado na web para explorar combinações de imagens. Foi desenvolvido sob contrato com o Observatório da Terra da NASA e é Copyright (C) 2002-2017 por Tom Whittaker.
Este programa é um software livre; você pode redistribuí-lo e / ou modificá-lo, mas você NÃO pode reembalá-lo e vendê-lo.
Este programa é distribuído na esperança de que seja útil, mas SEM QUALQUER GARANTIA; sem a garantia implícita de COMERCIALIZAÇÃO ou APTIDÃO PARA UM FIM ESPECÍFICO.
Os desenvolvedores ou seus empregadores ou a agência responsável não são responsáveis por todas e quaisquer ramificações, etc., que podem resultar da utilização deste software ou do software derivado disso. Além disso, você concorda em nos privar de quaisquer consequências relacionadas ao uso desse software..
É isso aí.

