Commit 2de72a26f945d73044e2f1ff52b3b7f72207df35

Authored by Edmar Moretti
1 parent a05c77d6

--no commit message

Showing 1 changed file with 278 additions and 9 deletions   Show diff stats
ferramentas/metaestat/index.js
... ... @@ -195,6 +195,11 @@ i3GEOF.metaestat = {
195 195 icone: "imagens/gisicons/label.png"
196 196 }
197 197 ],
  198 + /**
  199 + * Inicia a ferramenta ativando os componentes da interface
  200 + * Executa as funcoes i3GEOF.metaestat.analise.abreJanela() e i3GEOF.metaestat.analise.comboCamadas()
  201 + * @param id do div que recebera os componentes HTML da ferramenta
  202 + */
198 203 inicia: function(iddiv){
199 204 var ics,n,i;
200 205 if(!iddiv || !$i(iddiv)){
... ... @@ -220,6 +225,10 @@ i3GEOF.metaestat = {
220 225 }
221 226 i3GEOF.metaestat.analise.comboCamadas();
222 227 },
  228 + /**
  229 + * Abre a janela flutuante com os componentes da ferramenta
  230 + * Para recuperar o objeto YUI utilize janela = YAHOO.i3GEO.janela.manager.find("i3geoCartoAnalise")
  231 + */
223 232 abreJanela: function(){
224 233 var cabecalho,minimiza,imagemxy,janela;
225 234 if (!$i("i3geoCartoAnalise")){
... ... @@ -252,6 +261,11 @@ i3GEOF.metaestat = {
252 261 imagemxy = i3GEO.util.pegaPosicaoObjeto($i(i3GEO.Interface.IDCORPO));
253 262 janela.moveTo(imagemxy[0]+(i3GEOF.metaestat.LEFT*2)+i3GEOF.metaestat.LARGURA+10,i3GEOF.metaestat.TOP);
254 263 },
  264 + /**
  265 + * Monta o HTML contendo os elementos DIV que receberao os principais componentes da ferramenta
  266 + * Utilizado para criar a janela da ferramenta
  267 + * @return HTML
  268 + */
255 269 html: function(){
256 270 var ins = '<div id="i3geoCartoAnaliseContainer" style="margin-left:5px;line-height:25px">',
257 271 b = i3GEOF.metaestat.analise.botoes,
... ... @@ -264,6 +278,12 @@ i3GEOF.metaestat = {
264 278 ins += '</div><input type=hidden value="" id="listaColourRampAnaliseMetaestat" onchange="i3GEOF.metaestat.analise.aplicaColourRamp()" />'; //utilizado pelo seletor de colourramp
265 279 return ins;
266 280 },
  281 + /**
  282 + * Monta um combo contendo a lista de camadas originadas do sistema de metadados estatisticos
  283 + * A lista de camadas e obtida com i3GEO.php.listaCamadasMetaestat()
  284 + * O ombo e utilizado para o usuario escolher qual a camada que sera alvo de determinado porcesso de analise
  285 + * O combo e inserido no elemento DOM com ID i3geoCartoAnaliseCamadas
  286 + */
267 287 comboCamadas: function(){
268 288 if(!$i("i3geoCartoAnaliseCamadas")){
269 289 return;
... ... @@ -289,6 +309,11 @@ i3GEOF.metaestat = {
289 309 };
290 310 i3GEO.php.listaCamadasMetaestat(temp);
291 311 },
  312 + /**
  313 + * Abre a janela da ferramenta que permite adicionar labels
  314 + * Executa i3GEO.util.dialogoFerramenta() mas com a funcao i3GEOF.metaestat.analise.abreToponimia()
  315 + * isso permite a obtencao dos parametros necessarios, como a lista de itens que o usuario podera escolher
  316 + */
292 317 toponimia: function(){
293 318 if($i("i3geoCartoAnaliseCamadasCombo").value == ""){
294 319 i3GEO.janela.tempoMsg("Ative uma camada primeiro");
... ... @@ -297,6 +322,10 @@ i3GEOF.metaestat = {
297 322 i3GEO.mapa.ativaTema($i("i3geoCartoAnaliseCamadasCombo").value);
298 323 i3GEO.util.dialogoFerramenta("i3GEO.tema.dialogo.toponimia()","toponimia","toponimia","index.js","i3GEOF.metaestat.analise.abreToponimia()");
299 324 },
  325 + /**
  326 + * Obtem os parametros necessarios ao funcionamento de i3GEOF.metaestat.analise.toponimia()
  327 + * Abre a janela de opcoes de i3GEOF.toponimia.iniciaJanelaFlutuante()
  328 + */
300 329 abreToponimia: function(){
301 330 var p = i3GEO.configura.locaplic+"/ferramentas/metaestat/analise.php?g_sid="+i3GEO.configura.sid +
302 331 "&funcao=pegaDadosTME&tema="+i3GEO.temaAtivo,
... ... @@ -308,6 +337,10 @@ i3GEOF.metaestat = {
308 337 i3GEO.janela.abreAguarde("aguardeBuscaDados","Aguarde...");
309 338 i3GEO.util.ajaxGet(p,temp);
310 339 },
  340 + /**
  341 + * Ativa a ferramenta que permite a modificacao do tipo de representacao da camada
  342 + * Executa i3GEOF.alterarep.iniciaJanelaFlutuante();
  343 + */
311 344 alteraRep: function(){
312 345 if(typeof(i3GEOF.alterarep) === 'undefined'){
313 346 i3GEO.util.scriptTag(
... ... @@ -320,6 +353,10 @@ i3GEOF.metaestat = {
320 353 i3GEOF.alterarep.iniciaJanelaFlutuante();
321 354 }
322 355 },
  356 + /**
  357 + * Ativa a ferramenta que permite a criacao de mapa de calor
  358 + * Executa ferramentas/metaestat/analise.php?funcao=calor;
  359 + */
323 360 calor: function(){
324 361 if($i("i3geoCartoAnaliseCamadasCombo").value == ""){
325 362 i3GEO.janela.tempoMsg("Ative uma camada primeiro");
... ... @@ -339,6 +376,10 @@ i3GEOF.metaestat = {
339 376 i3GEO.janela.abreAguarde("aguardecalor","Aguarde...");
340 377 i3GEO.util.ajaxGet(p,temp);
341 378 },
  379 + /**
  380 + * Ativa a ferramenta que permite ativar a visualizacao de determinada regiao cadastrada
  381 + * Executa i3GEOF.mostraregiao.iniciaJanelaFlutuante();
  382 + */
342 383 mostraRegiao: function(){
343 384 if(typeof(i3GEOF.mostraregiao) === 'undefined'){
344 385 i3GEO.util.scriptTag(
... ... @@ -351,6 +392,10 @@ i3GEOF.metaestat = {
351 392 i3GEOF.mostraregiao.iniciaJanelaFlutuante();
352 393 }
353 394 },
  395 + /**
  396 + * Ativa a ferramenta que permite ativar/desativar o contorno dos limites utilizados em uma camada
  397 + * Executa ferramentas/metaestat/analise.php?funcao=alteraContorno;
  398 + */
354 399 contorno: function(){
355 400 if($i("i3geoCartoAnaliseCamadasCombo").value == ""){
356 401 i3GEO.janela.tempoMsg("Ative uma camada primeiro");
... ... @@ -368,6 +413,11 @@ i3GEOF.metaestat = {
368 413 i3GEO.janela.abreAguarde("aguardecontorno","Aguarde...");
369 414 i3GEO.util.ajaxGet(p,temp);
370 415 },
  416 + /**
  417 + * Ativa a ferramenta que permite obter e visualizar os dados em KMZ no Google Earth
  418 + * Primeiro obtem os parametros necesarios, como a lista de itens da camada
  419 + * Executa i3GEO.tema.dialogo.tme() com a funcao i3GEOF.metaestat.analise.abreTme()
  420 + */
371 421 ativaTme: function(){
372 422 if($i("i3geoCartoAnaliseCamadasCombo").value == ""){
373 423 i3GEO.janela.tempoMsg("Ative uma camada primeiro");
... ... @@ -376,6 +426,10 @@ i3GEOF.metaestat = {
376 426 i3GEO.mapa.ativaTema($i("i3geoCartoAnaliseCamadasCombo").value);
377 427 i3GEO.util.dialogoFerramenta("i3GEO.tema.dialogo.tme()","tme","tme","index.js","i3GEOF.metaestat.analise.abreTme()");
378 428 },
  429 + /**
  430 + * Abre a ferramenta de visualização em 3d
  431 + * Executa i3GEOF.tme.iniciaJanelaFlutuante();
  432 + */
379 433 abreTme: function(){
380 434 //i3GEOF.tme.ITEMNOMEREGIOES
381 435 var p = i3GEO.configura.locaplic+"/ferramentas/metaestat/analise.php?g_sid="+i3GEO.configura.sid +
... ... @@ -389,6 +443,10 @@ i3GEOF.metaestat = {
389 443 i3GEO.janela.abreAguarde("aguardeBuscaDados","Aguarde...");
390 444 i3GEO.util.ajaxGet(p,temp);
391 445 },
  446 + /**
  447 + * Abre a ferramenta que mostra um relatorio com sumario estatistico dos dados
  448 + * Executa ferramentas/tabela/exec.php?funcao=estatistica
  449 + */
392 450 estatistica: function(){
393 451 if($i("i3geoCartoAnaliseCamadasCombo").value == ""){
394 452 i3GEO.janela.tempoMsg("Ative uma camada primeiro");
... ... @@ -443,9 +501,18 @@ i3GEOF.metaestat = {
443 501 i3GEO.janela.abreAguarde("aguardeBuscaDados","Aguarde...");
444 502 i3GEO.util.ajaxGet(p,temp);
445 503 },
  504 + /**
  505 + * Abre a ferramenta que permite realizar uma animacao baseada nas camadas existentes no mapa
  506 + * executa i3GEO.mapa.dialogo.animacao() com a funcao i3GEOF.metaestat.analise.listaCamadasAnimacao()
  507 + */
446 508 ativaAnimacao: function(){
447 509 i3GEO.util.dialogoFerramenta("i3GEO.mapa.dialogo.animacao()","animacao","animacao","index.js","i3GEOF.metaestat.analise.listaCamadasAnimacao()");
448 510 },
  511 + /**
  512 + * Lista as camadas que podem ser usadas na ferramenta de animacao
  513 + * Preenche o div com a lista usando i3GEOF.animacao.listaDeCamadas()
  514 + * Marca os checkbox das camadas que sao oriundas do sistema metaestat e que estao no mapa
  515 + */
449 516 listaCamadasAnimacao: function(){
450 517 i3GEOF.animacao.iniciaJanelaFlutuante();
451 518 i3GEOF.animacao.listaDeCamadas();
... ... @@ -465,6 +532,10 @@ i3GEOF.metaestat = {
465 532 };
466 533 i3GEO.php.listaCamadasMetaestat(temp);
467 534 },
  535 + /**
  536 + * Ativa a ferramenta que permite alterar a classificacao dos dados utilizada na legenda de uma camada
  537 + * Executa i3GEOF.legenda.iniciaJanelaFlutuante(); e ativa a guia com as opcoes de alteracao das classes
  538 + */
468 539 ativaEditorLegenda: function(){
469 540 if($i("i3geoCartoAnaliseCamadasCombo").value == ""){
470 541 i3GEO.janela.tempoMsg("Ative uma camada primeiro");
... ... @@ -483,14 +554,24 @@ i3GEOF.metaestat = {
483 554 var temp = $i("i3GEOF.legenda_corpo");
484 555 temp.getElementsByTagName("div")[0].style.display = "none";
485 556 },
  557 + /**
  558 + * Ativa a ferramenta que permite editar os simbolos utilizados em uma classe da legenda
  559 + * Executa i3GEO.tema.dialogo.editaLegenda()
  560 + */
486 561 alteraClasses: function(){
487 562 i3GEO.util.dialogoFerramenta("i3GEO.tema.dialogo.editaLegenda()","legenda","legenda","index.js","i3GEOF.metaestat.analise.ativaEditorLegenda()");
488 563 },
  564 + /**
  565 + * Ativa a ferramenta que permite modificar o degrade de cores utilizado
  566 + */
489 567 alteraCores: function(){
490 568 //listaColourRampAnaliseMetaestat e o id do elemento input que recebera a lista de cores
491 569 i3GEO.util.abreColourRamp("","listaColourRampAnaliseMetaestat",10);
492 570 },
493   - //disparado no evento onchange do input que guarda o numero de cores
  571 + /**
  572 + * Aplica o novo degrade de cores
  573 + * Disparado no evento onchange do input que guarda o numero de cores
  574 + */
494 575 aplicaColourRamp: function(){
495 576 var i = $i("listaColourRampAnaliseMetaestat");
496 577 if(i.value != ""){
... ... @@ -512,6 +593,7 @@ i3GEOF.metaestat = {
512 593 i3GEO.util.ajaxGet(p,temp);
513 594 }
514 595 },
  596 + //TODO documentar e testar
515 597 filtraPeriodo: {
516 598 //CAMADAS: "",
517 599 inicia: function(){
... ... @@ -690,7 +772,19 @@ i3GEOF.metaestat = {
690 772 }
691 773 }
692 774 },
  775 + /**
  776 + * Funcoes que controlam a janela de parametros
  777 + * Os parametros permitem que o usuario modifique as opcoes default
  778 + * aplicadas quando uma camada e adicionada ao mapa
  779 + */
693 780 classes:{
  781 + /**
  782 + * Inicia a ferramenta
  783 + * Preenche os componetes da interface conforme o tipo definido em i3GEOF.metaestat.INTERFACE
  784 + * Executa as funcoes que constroem os combos
  785 + * Executa i3GEOF.metaestat.classes.abreJanela(); e i3GEOF.metaestat.classes.html();
  786 + * @param ID do div que recebera os componentes da ferramenta
  787 + */
694 788 inicia: function(iddiv){
695 789 if(!$i("i3geoCartoComboMedidasVariavel")){
696 790 i3GEO.janela.tempoMsg("erro: i3geoCartoComboMedidasVariavel???");
... ... @@ -716,6 +810,9 @@ i3GEOF.metaestat = {
716 810 i3GEOF.metaestat.classes.comboTipoClassificacao();
717 811 }
718 812 },
  813 + /**
  814 + * Abre a janela flutuante da ferramenta
  815 + */
719 816 abreJanela: function(){
720 817 var cabecalho,minimiza,janela;
721 818 if (!$i("i3geoCartoClasses")){
... ... @@ -748,6 +845,11 @@ i3GEOF.metaestat = {
748 845 //imagemxy = i3GEO.util.pegaPosicaoObjeto($i(i3GEO.Interface.IDCORPO));
749 846 //janela.moveTo(imagemxy[0]+i3GEOF.metaestat.LEFT+i3GEOF.metaestat.LARGURA+20,i3GEOF.metaestat.TOP);
750 847 },
  848 + /**
  849 + * Ativa o botao que aplica e guarda os parametros escolhidos
  850 + * O botao e o elemento com ID i3GEOcartoClassesBotaoAaplicar
  851 + * A funcao a ser executada e i3GEOF.metaestat.classes.aplicar()
  852 + */
751 853 botaoAplicar: function(){
752 854 YAHOO.i3GEO.janela.manager.find("i3geoCartoClasses").setFooter('<input type="button" id="i3GEOcartoClassesBotaoAaplicar" value="Aplicar" class="paragrafo" style="width:200px;cursor:pointer;color:blue" />');
753 855 new YAHOO.widget.Button(
... ... @@ -756,6 +858,13 @@ i3GEOF.metaestat = {
756 858 );
757 859 $i("i3GEOcartoClassesBotaoAaplicar-button").style.width = i3GEOF.metaestat.LARGURA - 15 + "px";
758 860 },
  861 + /**
  862 + * Aplica os parametros
  863 + * Os valores sao armazenados nas variaveis
  864 + * i3GEOF.metaestat.comum.tipoRep
  865 + * i3GEOF.metaestat.comum.tipoClassificacao
  866 + * i3GEOF.metaestat.comum.tipoRegiao
  867 + */
759 868 aplicar: function(){
760 869 if($i("i3geoCartoComboTipoRep") && $i("i3geoCartoComboTipoRep").options){
761 870 i3GEOF.metaestat.comum.tipoRep = [$i("i3geoCartoComboTipoRep").value,$i("i3geoCartoComboTipoRep").options[$i("i3geoCartoComboTipoRep").selectedIndex].label];
... ... @@ -768,17 +877,31 @@ i3GEOF.metaestat = {
768 877  
769 878 i3GEOF.metaestat.classes.destroiJanela();
770 879 },
  880 + /**
  881 + * Zera os parametros escolhidos alterando as variaveis
  882 + * i3GEOF.metaestat.comum.tipoRep
  883 + * i3GEOF.metaestat.comum.tipoClassificacao
  884 + * i3GEOF.metaestat.comum.tipoRegiao
  885 + */
771 886 zeraParametros: function(){
772 887 i3GEOF.metaestat.comum.tipoRep = ["",""];
773 888 i3GEOF.metaestat.comum.tipoClassificacao = ["",""];
774 889 i3GEOF.metaestat.comum.tipoRegiao = ["",""];
775 890 },
  891 + /**
  892 + * Destroi a janela com os parameros
  893 + */
776 894 destroiJanela: function(){
777 895 var janela = YAHOO.i3GEO.janela.manager.find("i3geoCartoClasses");
778 896 if(janela){
779 897 janela.destroy();
780 898 }
781 899 },
  900 + /**
  901 + * Constroi o HtmL que recera os componentes da interface
  902 + * Usado pela funcao que abre a janela flutuante
  903 + * @return HTML
  904 + */
782 905 html: function(){
783 906 var ins = '<div id="i3geoCartoClassesContainer" style="margin-left:5px;">' +
784 907 '<div class="paragrafo" id="i3geoCartoTipoRep" >' +
... ... @@ -790,6 +913,10 @@ i3GEOF.metaestat = {
790 913 '</div>';
791 914 return ins;
792 915 },
  916 + /**
  917 + * Monta o combo com as opcoes de tipo de representacao
  918 + * @return HTML
  919 + */
793 920 comboTipoRep: function(){
794 921 var onde = $i("i3geoCartoTipoRep"),
795 922 ins,i,
... ... @@ -811,6 +938,11 @@ i3GEOF.metaestat = {
811 938 }
812 939 return ins;
813 940 },
  941 + /**
  942 + * Monta o combo com as opcoes de tipo de classificacao
  943 + * Obtem a lista de i3GEO.php.listaClassificacaoMedida()
  944 + * @retrun HTML
  945 + */
814 946 comboTipoClassificacao: function(){
815 947 var onde = $i("i3geoCartoTipoClassificacao"),
816 948 combo = $i("i3geoCartoComboMedidasVariavel"),
... ... @@ -840,6 +972,11 @@ i3GEOF.metaestat = {
840 972 comboTipoClassificacaoOnchange: function(){
841 973  
842 974 },
  975 + /**
  976 + * Monta o combo com as opcoes de tipo de regiao
  977 + * Obtem a lista de i3GEO.php.listaRegioesMedidaVariavel()
  978 + * @retrun HTML
  979 + */
843 980 comboRegiao: function(id_medida_variavel){
844 981 i3GEOF.metaestat.comum.aguarde($i("i3geoCartoRegioesMedidasVariavel"));
845 982 var onde = $i("i3geoCartoRegioesMedidasVariavel"),
... ... @@ -864,6 +1001,9 @@ i3GEOF.metaestat = {
864 1001 }
865 1002 }
866 1003 },
  1004 + /**
  1005 + * Funcoes de uso comum das demais funcoes
  1006 + */
867 1007 comum:{
868 1008 /**
869 1009 * Faz a carga do dicionario de traducao e na sequencia inicia a ferramenta com i3GEOF.metaestat.principal.inicia()
... ... @@ -880,15 +1020,46 @@ i3GEOF.metaestat = {
880 1020 i3GEOF.metaestat.principal.inicia();
881 1021 }
882 1022 },
  1023 + /**
  1024 + * Aplica ao mapa o status de ligado/desligado de cada camada
  1025 + * O status das camadas e mantido em i3GEOF.metaestat.CAMADAS
  1026 + * Utiliza a funcao i3GEO.arvoreDeCamadas.ligaDesligaTemas
  1027 + */
883 1028 desligaCamadas: function(){
884 1029 if(i3GEOF.metaestat.CAMADAS.length > 0){
885 1030 i3GEO.arvoreDeCamadas.ligaDesligaTemas(i3GEOF.metaestat.CAMADAS.join(","),false);
886 1031 }
887 1032 },
888   - //parametros para adicionar a camada
  1033 + /**
  1034 + * Armazena o tipo de representacao que o usuario escolheu pela ultima vez
  1035 + * O tipo de representacao corresponde ao tipo de geometria que sera utilizada para desenhar os componentes da camada
  1036 + * E definida pelo onchange do combo criado por i3GEOF.metaestat.classes.comboTipoRep();
  1037 + * Armazena o valor de [value,texto]
  1038 + */
889 1039 tipoRep: [],
  1040 + /**
  1041 + * Armazena o tipo de regiao que o usuario escolheu pela ultima vez
  1042 + * O tipo de regiao corresponde ao tipo de limite geografico utilizado para desenhar a camada a ser escolhida
  1043 + * E definida pelo onchange do combo criado por i3GEOF.metaestat.classes.comboRegiao();
  1044 + * Armazena o valor de [value,texto]
  1045 + */
890 1046 tipoRegiao: [],
  1047 + /**
  1048 + * Armazena o tipo de classificacao que o usuario escolheu pela ultima vez
  1049 + * E definida pelo onchange do combo criado por i3GEOF.metaestat.classes.comboTipoClassificacao();
  1050 + * A classificacao define os intervalos de classe e simbologia utilizadas pela camada
  1051 + * Armazena o valor de [value,texto]
  1052 + */
891 1053 tipoClassificacao: [],
  1054 + /**
  1055 + * Adiciona uma nova camada ao mapa conforme as opcoes escolhidas pelo usuario
  1056 + * O usuario deve ter escolhido antes a variavel, medida e demais parametros
  1057 + * Os parametros sao obtidos dos componentes de formulario ou variaveis ja definidas em
  1058 + * funcao das escolhas feitas pelo usuario
  1059 + * Ao executar, primeiro cria um mapfile temporario com i3GEO.php.mapfileMedidaVariavel() e
  1060 + * depois adiciona com i3GEO.php.adtema()
  1061 + * Atualiza o combo da janela de analise com i3GEOF.metaestat.analise.comboCamadas();
  1062 + */
892 1063 adicionaCamada: function(){
893 1064 //function mapfileMedidaVariavel($id_medida_variavel,$filtro="",$todasascolunas = 0,$tipolayer="polygon",$titulolayer="",$id_classificacao="",$agruparpor=""){
894 1065 var v = i3GEOF.metaestat.comum.verificaParametros(),
... ... @@ -934,6 +1105,12 @@ i3GEOF.metaestat = {
934 1105 opacidade
935 1106 );
936 1107 },
  1108 + /**
  1109 + * Mostra no mapa uma camada escolhida
  1110 + * E usado quando uma nova camada e adicionada ao mapa
  1111 + * Primeiro todas as camadas guardadas em i3GEOF.metaestat.CAMADAS sao desligadas
  1112 + * @param identificador da camada que sera ligada. Correpsonde ao item "name" do mapfile atual do mapa
  1113 + */
937 1114 ativaCamada: function(camada){
938 1115 if(i3GEOF.metaestat.CAMADAS.length > 0){
939 1116 i3GEO.arvoreDeCamadas.ligaDesligaTemas(i3GEOF.metaestat.CAMADAS.join(","),false);
... ... @@ -941,6 +1118,11 @@ i3GEOF.metaestat = {
941 1118 i3GEO.mapa.ativaTema(camada);
942 1119 }
943 1120 },
  1121 + /**
  1122 + * Avalia os parametros escolhidos pelo usuario e define qual sera o titulo da camada escolhida
  1123 + * E usado quando uma camada e adicionada ao mapa
  1124 + * @return string
  1125 + */
944 1126 defineTitulo: function(){
945 1127 //se nao tiver parametros, filtro e vazio
946 1128 if(i3GEOF.metaestat.parametros.dados.length == 0 || i3GEOF.metaestat.INTERFACE === "flutuanteSimples"){
... ... @@ -974,6 +1156,11 @@ i3GEOF.metaestat = {
974 1156 return titulo;
975 1157 }
976 1158 },
  1159 + /**
  1160 + * Avalia os parametros escolhidos pelo usuario e define qual sera o filtro para a camada escolhida
  1161 + * E usado quando uma camada e adicionada ao mapa
  1162 + * @return string
  1163 + */
977 1164 defineFiltro: function(){
978 1165 //se nao tiver parametros, filtro e vazio
979 1166 if(i3GEOF.metaestat.parametros.dados.length == 0){
... ... @@ -997,6 +1184,11 @@ i3GEOF.metaestat = {
997 1184 return "";
998 1185 }
999 1186 },
  1187 + /**
  1188 + * Avalia os parametros escolhidos pelo usuario e define qual o nivel de agregacao dos dados para a camada escolhida
  1189 + * E usado quando uma camada e adicionada ao mapa
  1190 + * @return string
  1191 + */
1000 1192 defineAgruparPor: function(){
1001 1193 //se nao tiver parametros, filtro e vazio
1002 1194 if(i3GEOF.metaestat.parametros.dados.length == 0){
... ... @@ -1020,6 +1212,10 @@ i3GEOF.metaestat = {
1020 1212 return "";
1021 1213 }
1022 1214 },
  1215 + /**
  1216 + * Verifica se os parametros obrigatorios foram escolhidos
  1217 + * Utilizado quando uma nova camada e adicionada ao mapa
  1218 + */
1023 1219 verificaParametros: function(){
1024 1220 var ok = true,
1025 1221 combos = ["i3geoCartoComboMedidasVariavel"],
... ... @@ -1036,6 +1232,11 @@ i3GEOF.metaestat = {
1036 1232 }
1037 1233 return ok;
1038 1234 },
  1235 + /**
  1236 + * Torna visivel/invisivel a imagem com o sinal de aguarde
  1237 + * @param objeto DOM que contem a imagem
  1238 + * @return objeto DOM com a imagem caso nao exista
  1239 + */
1039 1240 aguarde: function(obj){
1040 1241 if(!obj){
1041 1242 return "<img style='display:block;z-index:2' src=\'"+i3GEO.configura.locaplic+"/imagens/aguarde.gif\' />";
... ... @@ -1054,7 +1255,16 @@ i3GEOF.metaestat = {
1054 1255 }
1055 1256 }
1056 1257 },
  1258 + /**
  1259 + * Funcoes que controlam o ajudante de edicao do cadastro de variaveis
  1260 + */
1057 1261 editor: {
  1262 + /**
  1263 + * Inicia o editor carregando as dependencias de javascript necessarias
  1264 + * Como as dependencias sao carregadas em paralelo, a carga e definida em funcoes em cascata
  1265 + * Carrega ferramentas/metaestat/dicionario1.js
  1266 + * Executa i3GEOF.metaestat.editor.dependenciasjs0()
  1267 + */
1058 1268 inicia: function(){
1059 1269 YAHOO.namespace("admin.container");
1060 1270 if(typeof(i3GEOF.metaestat.dicionario1) === 'undefined'){
... ... @@ -1068,7 +1278,11 @@ i3GEOF.metaestat = {
1068 1278 i3GEOF.metaestat.editor.dependenciasjs0();
1069 1279 }
1070 1280 },
1071   - //carrega os javascripts do sistema de administracao e que tbm sao usados aqui
  1281 + /**
  1282 + * Carrega os javascripts do sistema de administracao do i3Geo e que tbm sao usados aqui
  1283 + * Carrega admin/js/core.js
  1284 + * Executa i3GEOF.metaestat.editor.dependenciasjs1()
  1285 + */
1072 1286 dependenciasjs0: function(){
1073 1287 i3GEO.util.scriptTag(
1074 1288 i3GEO.configura.locaplic+"/admin/js/core.js",
... ... @@ -1076,6 +1290,11 @@ i3GEOF.metaestat = {
1076 1290 "i3GEOF.metaestat.dependenciasjs0_script"
1077 1291 );
1078 1292 },
  1293 + /**
  1294 + * Carrega os javascripts do sistema de administracao do i3Geo e que tbm sao usados aqui
  1295 + * Carrega admin/js/estat_variavel.js
  1296 + * Executa i3GEOF.metaestat.editor.ativa()
  1297 + */
1079 1298 dependenciasjs1: function(){
1080 1299 i3GEO.util.scriptTag(
1081 1300 i3GEO.configura.locaplic+"/admin/js/estat_variavel.js",
... ... @@ -1646,11 +1865,20 @@ i3GEOF.metaestat = {
1646 1865 }
1647 1866 }
1648 1867 },
  1868 + /**
  1869 + * Funcoes que controlam a exibicao e escolha dos parametros cadastrados para uma medida de variavel
  1870 + * Parametros podem ter filhos
  1871 + */
1649 1872 parametros: {
1650   - //guarda a lista de parametros
  1873 + /**
  1874 + * Guarda a lista de parametros que foram obtidos na inicializacao
  1875 + */
1651 1876 dados: [],
1652   - //obtem a lista com os parametros da medida
1653   - //cria os combos para os parametros que sao pai de todos
  1877 + /**
  1878 + * Obtem a lista com os parametros da medida
  1879 + * Cria os combos para os parametros que sao pai de todos
  1880 + * Executa i3GEO.php.listaParametrosMedidaVariavel()
  1881 + */
1654 1882 lista: function(id_medida_variavel){
1655 1883 i3GEOF.metaestat.comum.aguarde($i("i3geoCartoParametrosMedidasVariavel"));
1656 1884 var temp = function(dados){
... ... @@ -1660,7 +1888,14 @@ i3GEOF.metaestat = {
1660 1888 };
1661 1889 i3GEO.php.listaParametrosMedidaVariavel(id_medida_variavel,temp);
1662 1890 },
1663   - //cria um combo para escolher os valores de um parametro
  1891 + /**
  1892 + * Cria os elementos que receberao so combos para escolher os valores de um parametro
  1893 + * Para criar os combos, executa i3GEOF.metaestat.parametros.valoresCombo()
  1894 + * O combo e inserido no elemento com ID i3geoCartoParametrosMedidasVariavel
  1895 + * Cada combo recebe um ID cujo valor e definido em funcao do id do parametro e do nivel na hierarquia
  1896 + * O combo e inserido dentro de um div ja existente ou e criado um novo se o nivel for 0
  1897 + * @param nivel do parametro na hierarquia, sendo 0 para o pai de todos
  1898 + */
1664 1899 combos: function(nivel){
1665 1900 var dados = i3GEOF.metaestat.parametros.dados,
1666 1901 n = dados.length,
... ... @@ -1696,6 +1931,15 @@ i3GEOF.metaestat = {
1696 1931 }
1697 1932 }
1698 1933 },
  1934 + /**
  1935 + * Cria um combo com os valores de um determinado parametro
  1936 + * Executa i3GEO.php.listaValoresParametroMedidaVariavel() para obter os dados
  1937 + * @param id da medida da variavel
  1938 + * @param titulo do combo
  1939 + * @param nivel na hierarquia de parametros
  1940 + * @param onde o combo sera inserido
  1941 + * @param id que o combo recebera
  1942 + */
1699 1943 valoresCombo: function(id_parametro_medida,titulo,nivel,onde,idcombo){
1700 1944 var temp = function(dados){
1701 1945 var n = dados.length,
... ... @@ -1725,7 +1969,12 @@ i3GEOF.metaestat = {
1725 1969 //i3GEOF.metaestat.classes.inicia();
1726 1970 //}
1727 1971 },
1728   - //retorna o id do parametro que e filho de um outro parametro
  1972 + /**
  1973 + * Retorna o id do parametro que e filho de um outro parametro
  1974 + * Varre a variavel i3GEOF.metaestat.parametros.dados para pegar o filho
  1975 + * @param id pai
  1976 + * @return id do parametro ou false
  1977 + */
1729 1978 retornaIdFilho:function(pai){
1730 1979 var dados = i3GEOF.metaestat.parametros.dados,
1731 1980 n = dados.length,
... ... @@ -1737,7 +1986,12 @@ i3GEOF.metaestat = {
1737 1986 }
1738 1987 return false;
1739 1988 },
1740   - //retorna o id do parametro que e pai de um outro parametro
  1989 + /**
  1990 + * Retorna o id do parametro que e pai de um outro parametro
  1991 + * Varre a variavel i3GEOF.metaestat.parametros.dados para pegar o pai
  1992 + * @param id filho
  1993 + * @return id do parametro ou false
  1994 + */
1741 1995 retornaIdPai:function(filho){
1742 1996 var dados = i3GEOF.metaestat.parametros.dados,
1743 1997 n = dados.length,
... ... @@ -1750,6 +2004,9 @@ i3GEOF.metaestat = {
1750 2004 return false;
1751 2005 }
1752 2006 },
  2007 + /**
  2008 + * Funcoes utilizadas pelos componentes principais da ferramenta (janela inicial)
  2009 + */
1753 2010 principal: {
1754 2011 /**
1755 2012 * Inicia a ferramenta principal com as opcoes de escolha de variaveis, medidas e parametros
... ... @@ -2142,6 +2399,14 @@ i3GEOF.metaestat = {
2142 2399 }
2143 2400 i3GEOF.metaestat.classes.zeraParametros();
2144 2401 },
  2402 + /**
  2403 + * Executado quando o usuário opta por alterar a classificacao default utilizada (sempre a primeira cadastrada)
  2404 + * Monta o combo com a lista de classificacoes
  2405 + *
  2406 + * @param objeto contendo os dados que farao parte do combo
  2407 + * @param string que sera atribuida como ID do combo
  2408 + * @return string HTML (select)
  2409 + */
2145 2410 comboClassificacoesMedidaVariavel: function(dados,idcombo){
2146 2411 var ins,i,n = dados.length;
2147 2412 ins = "<select id='"+idcombo+"' style='box-shadow:0 1px 5px gray;width:"+(i3GEOF.metaestat.LARGURA - 20)+"px' onchange='i3GEOF.metaestat.principal.comboClassificacoesMedidaVariavelOnchange(this)'><option value=''>---</option>";
... ... @@ -2154,6 +2419,10 @@ i3GEOF.metaestat = {
2154 2419 comboClassificacoesMedidaVariavelOnchange: function(combo){
2155 2420  
2156 2421 },
  2422 + /**
  2423 + * Abre uma nova janela do navegador para download dos dados de uma medida de uma variavel
  2424 + * Executa admin/php/metaestat.php?funcao=dadosMedidaVariavel que retorna os dados em CSV
  2425 + */
2157 2426 downloadMedida: function(){
2158 2427 if(!$i("i3geoCartoComboMedidasVariavel")){
2159 2428 i3GEO.janela.tempoMsg("erro: i3geoCartoComboMedidasVariavel???");
... ...