Uma visão geral do aplicativo web woprVision

Grupo de Pesquisa WorldPop
Universidade de Southampton

17 Novembro 2020

Introdução

woprVision é um mapa web interactivo que lhe permite consultar estimativas populacionais para locais e grupos demográficos específicos a partir do WorldPop Open Population Repository. Isto pode ser usado para:

  1. Baixar os últimos conjuntos de dados e documentação sobre a população,
  2. Obter estimativas da população dentro de áreas geográficas definidas pelo utilizador, clicando no mapa,
  3. Obter estimativas da dimensão da população para grupos demográficos específicos (i.e. idade e sexo), e
  4. Obter estimativas probabilísticas da incerteza para todas as estimativas da população.
  5. Executar a woprVision aplicação web localmente a partir da consola R.

Este documento fornece instruções de como utilizar cada painel de controle:

O woprVision faz parte do wopr package para a linguagem de programação estatística R. O woprVision foi criado utilizando os pacotes para R shiny e leaflet (Chang et al. 2018, Cheng et al. 2018, R Core Team 2019). Veja a aba "Pacote R" para mais informações.

Início rápido

Na aba "Mapa":
1. Seleccionar um conjunto de dados (isto é, país e versão)
2. Clique no mapa para seleccionar um local
3. Clique em “Enviar” para obter a estimativa populacional para esse local
4. Clique em “Salvar" para salvar a estimativa populacional na aba “Salvo".
5. Clique em "Desenhar uma área" e depois desenhe um polígono usando a barra de ferramentas na parte superior esquerda do mapa.
6. Clique em “Enviar” para recuperar a estimativa populacional para essa área
7. Utilizar os cursores para seleccionar um grupo de idade e sexo
8. Clique em “Enviar" para recuperar a estimativa populacional para o grupo demográfico seleccionado no local seleccionado.

Componentes do aplicativo

Controles do usuário

O painel de controle do usuário encontra-se no lado esquerdo da aba "Mapa", com controles que podem ser utilizados para recuperar estimativas populacionais.

Seleccionar dados da população
Seleccione o conjunto de dados populacionais que gostaria de consultar. Isto inclui um país e um número de versão. Pode ler mais sobre o conjunto de dados seleccionado na aba “Leia-me dos Dados".

Seleccionar um local
Pode seleccionar locais de pontos com a ferramenta "Clique no Mapa". Pode desenhar um polígono para seleccionar uma área com a ferramenta "Desenhar uma área". Pode carregar um arquivo geojson com pontos ou polígonos utilizando a ferramenta "Carrega Arquivo".

Botão Enviar
Após ter seleccionado um local (utilizando as ferramentas de selecção "Clique no Mapa" ou "Desenhar uma Área"), utilize o botão "Enviar" para recuperar os dados populacionais para esse local a partir dos servidores WOPR.

Salvar resultado
Clique no botão “Salvar" para salvar o resultado actual na aba "Salvo". Pode adicionar um nome opcional na caixa de entrada "Salvar resultado como".

Grupos de Idade e Sexo
Utilize as barras deslizantes para seleccionar os grupos de idade e sexo para os quais gostaria de uma estimativa populacional.

Nível de Confiança
O nível de confiança para os intervalos de confiança. Este padrão é de 95%. Nesse caso, existe uma probabilidade de 95% de que a verdadeira população nesse local esteja dentro do intervalo de confiança fornecido nos resultados (com base num dado modelo estatístico e dados de entrada).

Tipo de Confiança
O tipo de intervalo de confiança.

Limiar Populacional
O limiar populacional fornecido aqui será utilizado para calcular a probabilidade de que a população exceda esse limite. O valor padrão é 100. Isto retornará a probabilidade de que a população exceda 100 pessoas.

Janela de Mapa

Basemaps Os seguintes mapas de base podem ser seleccionadas a partir do painel superior direito na janela de mapa:

Camadas de Mapa* As seguintes camadas de mapa podem ser alternadas a partir do painel superior direito na janela de mapa:

Draw Toolbar
A barra de ferramentas de desenho aparece no lado esquerdo da janela de mapa quando se selecciona a ferramenta de selecção "Desenhar uma área". A barra de ferramentas tem três ferramentas:

Zoom
Os controles de zoom estão no canto superior esquerdo da janela de mapa. Os botões mais e menos aumentam e diminuem o zoom. O botão com o ícone da Terra repõe o nível de zoom inicial (zoom out).

Resultados

O painel de resultados contém dois gráficos que representam a população no local seleccionado. O gráfico superior mostra a distribuição de probabilidade que representa a estimativa populacional e o gráfico inferior mostra uma pirâmide populacional que representa a estrutura de idade e sexo.

Estimativa Populacional
A estimativa populacional é a média da distribuição de probabilidade mostrada no gráfico. A distribuição de probabilidade é a distribuição de probabilidade posterior prevista a partir de um modelo estatístico Bayesiano (ver a aba “Leia-me dos dados” para detalhes). Os intervalos de confiança são calculados com base nas definições seleccionadas nos controles do usuário (ver "Controles do usuário: Nível de confiança" e "Controles do usuário: Tipo de confiança"). A probabilidade de exceder o limiar da população seleccionada é também reportada no gráfico superior (ver "Controles de Usuário: Limiar Populacional”).

Estrutura etária
As estimativas da estrutura demográfica que compõem as pirâmides demográficas são aqui utilizadas com permissão do projecto WorldPop Global High Resolution Population Denominators (Pezzulo et al. 2017, WorldPop et al. 2018). Estes dados fornecem estimativas regionais da proporção da população em cada grupo de idade e sexo em toda a área de estudo.

Abas

Mapa
Este é a aba padrão. Pode ser utilizada para alternar entre conjuntos de dados e para recuperar estimativas de população para áreas específicas, clicando no mapa ou desenhando um polígono. Esta aba contém um mapa Leaflet no meio, um painel de controle do usuário à esquerda, e um painel de resultados à direita.

Salvo
Esta aba tem uma planilha que contém quaisquer estimativas da população que tenha salvo. A planilha pode ser salvo no seu computador como um arquivo .csv clicando em “Baixar” ou pode ser apagada clicando em "Limpar".

Os resultados incluem as seguintes colunas:

As restantes colunas registam as entradas dos usuário que foram utilizadas para gerar os resultados:

Data Readme
A aba “Leia-me dos Dados” fornece a declaração de libertação de dados do WorldPop para o conjunto de dados populacionais actualmente seleccionado na aba "Mapa". As declarações de libertação fornecem informações sobre o conjunto de dados populacionais e como foi produzido.

WOPR Baixar
Esta aba permite-lhe baixar os dados populacionais directamente do WorldPop Open Population Repository (WOPR). Os arquivos LEIA-ME fornecem descrições dos conjuntos de dados que podem ser revistos antes de baixar os arquivos.

Pacote R
Esta aba fornece uma descrição do pacote wopr para a linguagem de programação estatística R. O pacote dá-lhe acesso ao WorldPop Open Population Repository a partir da sua consola R, permitindo-lhe executar o woprVision localmente, baixar dados directamente da consola R, e enviar consultas espaciais ao servidor WOPR para obter estimativas populacionais de polígonos ou pontos a partir dos seus próprios shapefiles.

REST API
Esta aba fornece uma visão geral do WOPR REST API. Esta é a forma como o pacote wopr R e o woprVision comunicam com os servidores WorldPop para recuperar as estimativas populacionais. O documento fornece a informação básica de que necessita para desenvolver os suas próprios aplicativos que consultam dados do WorldPop Open Population Repository usando o REST API.

Contribuindo

O WorldPop Open Population Repository (WOPR) foi desenvolvido pelo WorldPop Research Group dentro do Departamento de Geografia e Ciência Ambiental da Universidade de Southampton no Reino Unido. O financiamento foi fornecido pela Fundação Bill & Melinda Gates e pelo Foreign, Commonwealth & Development Office do Reino Unido (OPP1182408, OPP1182425, INV-002697). O Professor Andy Tatem supervisiona o Grupo de Pesquisa WorldPop. O pacote wopr R foi desenvolvido por Doug Leasure. Maksym Bondarenko e Niko Ves desenvolveram o servidor backend do API. Edith Darin adicionou funcionalidade multilingue ao aplicativo Shiny e a tradução francesa. Natalia Tejedor Garavito revisou a tradução em espanhol. Sandra Baptista revisou a tradução em português. Gianluca Boo criou o logótipo do WOPR. Os dados populacionais têm sido contribuídos para o WOPR por muitos investigadores diferentes dentro do Grupo de Pesquisa do WorldPop.

Citação Sugerida

Leasure DR, Bondarenko M, Darin E, Tatem AJ. 2021. wopr: An R package to query the WorldPop Open Population Repository, version 1.0.0. WorldPop, University of Southampton. doi: 10.5258/SOTON/WP00716. https://github.com/wpgp/wopr

Licença

GNU General Public License v3.0 (GNU GPLv3)

Referências

Chang W, Cheng J, Allaire JJ, Xie Y. 2018. shiny: Web Application Framework for R. R package version 1.1.0, https://CRAN.R-project.org/package=shiny.

Cheng J, Karambelkar B, Xie Y. 2018. leaflet: Create Interactive Web Maps with the JavaScript 'Leaflet' Library. R package version 2.0.2. https://CRAN.R-project.org/package=leaflet

Pezzulo C, Hornby GM, Sorichetta A, Gaughan AE, Linard C, Bird TJ, Kerr D, Lloyd CT, Tatem AJ. 2017. Sub-national mapping of population pyramids and dependency ratios in Africa and Asia. Sci. Data 4:170089 https://dx.doi.org/10.1038/sdata.2017.89

R Core Team. 2019. R: A Language and Environment for Statistical Computing, version 3.6.2. R Foundation for Statistical Computing: Vienna, Austria. https://www.R-project.org

WorldPop (www.worldpop.org - School of Geography and Environmental Science, University of Southampton; Department of Geography and Geosciences, University of Louisville; Departement de Geographie, Universite de Namur) and Center for International Earth Science Information Network (CIESIN), Columbia University (2018). Global High Resolution Population Denominators Project - Funded by The Bill & Melinda Gates Foundation (OPP1134076). https://www.worldpop.org/doi/10.5258/SOTON/WP00646