Pacote 'RPyGeo'

14 de novembro de 2018
Tipo Pacote
Título Geoprocessamento ArcGIS via Python
Versão 1.0.0
Data 2018-11-12
Descrição Fornece acesso às ferramentas de geoprocessamento do
ArcGIS criando uma interface entre o R e o pacote lateral do
ArcPy Python por meio do pacote reticulado.

URL https://github.com/fapola/RPyGeo

BugReports https://github.com/fapola/RPyGeo/issues
Licença GPL-3
LazyData TRUE
Importa reticulate (> = 1.2), sf, raster, ferramentas,
stringr, utils, rmarkdown, magrittr, stats, purrr
Requisitos do sistema Python (> = 2.6.0), ArcGIS (> = 10.0)
RoxygenNote 6.1.1
Sugere testthat, knitr, spData, rstudioapi, bookdown
VignetteBuilder knitr
NeedsCompilation no
Autor Alexander Brenning [aut, cre],
Fabian Polakowski [aut],
Marc Becker [aut],
Jannes Muenchow [ctb] (<https://orcid.org/0000-0001-7834-4717>)
Mantenedor Alexander Brenning <alexander.brenning@uni-jena.de>
Repositório CRAN
Data / publicação 2018-11-14 11:00:11 UTC

2 pacote RPyGeo

Tópicos R documentados:
Pacote RPyGeo. .....................................2
rpygeo_build_env. .....................................3
rpygeo_help. . . . .....................................4
rpygeo_load. . . . .....................................5
 rpygeo_save. . . . .....................................7
rpygeo_search. . . .....................................8
% rpygeo _-%. . . .....................................9
% rpygeo _ +%. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
% rpygeo _ /%. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
% rpygeo _ *%. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Índice 14

Pacote RPyGeo RPyGeo: Geoprocessamento ArcGIS em R via Python

Descrição

Forneça acesso a (praticamente qualquer) ferramenta de geoprocessamento ArcGIS a

partir do R executando o geoprocessamento Python sem escrever código Python ou tocar
em ArcGIS.

Detalhes
O pacote utiliza a ArcPy Python local-pacote ou a API do ArcGIS, a fim de funcionalidade
de acesso ArcGIS. A função rpygeo_build_env pode ser aplicada para gerar um objeto
ArcPy ou arcgis.

Autor (es)
Mantenedor: Alexander Brenning <alexander.brenning@uni-jena.de>
Autores:

• Fabian Polakowski <fabian.polakowski@gmail.com>

• Marc Becker <marc.becker@uni-jena.de>

Outros colaboradores:

Jannes Muenchow (0000-0001-7834-4717) [colaborador]

Veja também

Links Úteis:

• https://github.com/fapola/RPyGeo
• Relatar erros em https://github.com/fapola/RPyGeo/issues

rpygeo_build_env 3

Exemplos

# carregue o módulo ArcPy relacionado ao ArcGIS Pro (e salve-o como um R

# objeto chamado "arcpy_m") em R e também defina o parâmetro overwrite
# para FALSE e adicione algumas extensões. Observe que não precisamos definir o caminho
# porque a versão do Python está localizada no local padrão
# (C: / Arquivos de programas / ArcGIS / Pro / bin / Python / envs / arcgispro-py3 /)
neste exemplo. ## Não executar: arcpy <- rpygeo_build_env (substituir = TRUE,
extensões = c ("3d", "espacial", "na"), pro =
VERDADEIRO)
## Fim (não executado)
# Suponha que desejemos calcular a inclinação de um modelo de elevação digital.
# É possível obter a descrição de qualquer função do ArcPy como uma lista R: ##
Não execute: py_function_docs ("arcpy $ Slope_3d")
# Agora podemos executar nossa computação:
## Não executado: arcpy $ Slope_3d (arcpy $ Slope_3d (in_raster = "dem.tif", out_raster = "slope.tif")
 rpygeo_build_env Inicialize o pacote do site ArcPy em R

Descrição

Inicializa o pacote do site Python ArcPy no R por meio do pacote reticulado. Configurações
e extensões adicionais do ambiente são configuradas.

Uso

rpygeo_build_env (caminho = NULL, sobrescreve = TRUE, extensões = NULL,

x64 = FALSE, pro = FALSE, arcgisAPI = FALSE, espaço de trabalho = NULL,
scratch_workspace = NULL)

Argumentos
caminho Caminho completo para a pasta que contém a versão Python, que está vinculada ao ArcPy
pacote do site. Se deixada em branco, a função procurará python.exe na maioria dos
localização provável (C: / Python27 /). Também é possível fornecer um caminho para o
API do ArcGIS para Python aqui. Para fazer isso, você precisa fornecer o caminho para
a biblioteca python anaconda onde o pacote arcgis está instalado. Além disso
arcgisAPI deve estar definido como true.
substituir Se TRUE (padrão), os conjuntos de dados existentes do ArcGIS podem ser substituídos (não funciona
enquanto estiver usando a API do ArcGIS para Python).
extensões Vetor de caracteres opcional que lista a extensão ArcGIS que deve ser ativada (não
não funciona enquanto estiver usando a API do ArcGIS para Python)
x64 Lógico (padrão: FALSE). Determina se a pesquisa de caminho deve procurar por Python de 64 bits
Versão do ArcPy na pasta padrão (C: / Python27)

4 rpygeo_help

pró Lógico (padrão: FALSE). Se definido como TRUE ', o rpygeo_build_env tenta encontrar o Python
versão a ser usada no local padrão do ArcGIS Pro (C: / Arquivos de Programas / ArcGIS / Pro / bin / Pyth
arcgisAPI Lógico (padrão: FALSE). Deve ser definido como TRUE para usar a API do ArcGIS.
Esta é a única opção para trabalhar com o pacote RPyGeo em uma operação Linux
sistema.
área de trabalho Caminho do espaço de trabalho do ArcGIS no qual executar o geoprocessamento (não
trabalhar enquanto estiver usando a API do ArcGIS para Python).
scratch_workspace
Caminho para o espaço de trabalho de rascunho do ArcGIS no qual
armazenar arquivos temporários (não funciona ao usar a API do ArcGIS
para Python). Se NULL, uma pasta chamada scratch é criada dentro da
pasta da área de trabalho ou no mesmo nível de diretório que o
geodatabase do arquivo da área de trabalho.

Valor

Retorna os módulos ArcPy ou ArcGIS em R

Autor (es)

Marc Becker, Fabian Polakowski

Exemplos

## Não correr:
# Carregue o pacote lateral ArcPy do ArcGIS Pro com a extensão 3D e análise espacial.
# Defina a configuração do ambiente 'substituir' como TRUE.
# Observe que nenhum parâmetro de caminho é necessário porque o Python está localizado no diretório
# local padrão.
arcpy <- rpygeo_build_env (substituir = TRUE,
extensões = c ("3d", "espacial"), pro
= VERDADEIRO)
 ## Fim (não executado)

# Carregue o módulo ArcPy quando sua versão do Python estiver localizada em um local diferente
pasta #

rpygeo_help Obtenha um arquivo de ajuda para a função ArcPy

Descrição
Esta função abre o arquivo de ajuda da função ArcPy no painel do visualizador ou se não estiver disponível no
navegador.

Uso

rpygeo_help (arcpy_function)

rpygeo_load 5

Argumentos
arcpy_function Módulo ArcPy com função ou classe

Autor (es)

Marc Becker

Exemplos

## Não correr:
# Carregue o módulo ArcPy e construa o ambiente
arcpy <- arcpy_build_env (sobrescreve = TRUE, espaço de trabalho = tempdir ())

# Abrir arquivo de ajuda

rpygeo_help (arcpy $ Slope_3d)

## Fim (não executado)

rpygeo_load Carregar saída das funções do ArcPy na sessão R

Descrição

Esta função carrega a saída de uma função ArcPy na sessão R. Arquivos rasterizados são
carregados como objetos rasterizados e arquivos vetoriais como objetos sf.

Uso

rpygeo_load (dados)

Argumentos
dados objeto reticulado ou nome de arquivo da saída da função ArcPy

Detalhes

Atualmente, arquivos e conjuntos de dados armazenados em bancos de dados geográficos são suportados.
Formatos de arquivo suportados:

• Formato de arquivo de imagem marcado (.tif)

• Imagens Imagine Erdas (.img)
 • Esri Arc / Info Binary Grid (.adf)
• Esri ASCII Raster (.asc)
• Arquivos Esri Shape (.shp)

6 rpygeo_load

Conjuntos de dados suportados:

• Classe de recurso
• Conjunto de dados raster

A Esri não lançou uma API para conjuntos de dados raster em geodatabases. rpygeo_load
converte um conjunto de dados raster em um raster ASCII temporário primeiro e depois o
carrega na sessão R. Esteja ciente de que isso pode levar muito tempo para grandes
conjuntos de dados de varredura.
Esta função pode ser usada com o operador%>% do pacote dplyr. O operador%>% encaminha o objeto
reticulado da função ArcPy para rpygeo_load (s. Exemplo 1). Se usado sem o operador%>%, um objeto
reticulado pode ser especificado para o parâmetro de dados (s. Exemplo 2). Também é possível usar o
nome de arquivo da saída da função ArcPy (s. Exemplo 3). Para Arc / Info Binary Grids, o parâmetro data é
apenas o nome do diretório, que contém os arquivos de ajuste.

Valor

raster ou objeto sf

Autor (es)

Marc Becker

Exemplos

## Não correr:
# Carregar
biblioteca da
biblioteca de
pacotes (RPyGeo)
(magrittr) (RQGIS)
(spData)

# Obter dados
data (dem, pacote = "RQGIS")
dados (nz, pacote = "spData")

# Gravar dados no disco

writeRaster (dem, arquivo.caminho (tempdir (), "dem.tif"), formato = "GTiff")
st_write (nz, arquivo.caminho (tempdir (), "nz.shp"))

# Carregue o módulo ArcPy e construa o ambiente

arcpy <- arcpy_build_env (sobrescreve = TRUE, espaço de trabalho = tempdir ())

# Crie uma varredura de inclinação e carregue-a na inclinação da sessão

R (Exemplo 1) <-
arcpy $ Slope_3d (in_raster = "dem.tif", out_raster = "slope.tif")%>%
rpygeo_load ()

# Crie um raster de aspecto e carregue-o na sessão R (exemplo 2)

ras_aspect <- arcpy $ sa $ Aspect (in_raster = "dem.tif") rpygeo_load
(ras_aspect)
rpygeo_save 7

# Converta raster de elevação em shapefile de polígono e carregue-o na sessão R (Exemplo 3)

arcpy $ RasterToPolygon_conversion ("dem.tif", "elev.shp")
rpygeo_load ("elev.shp")

## Fim (não executado)

rpygeo_save Salvar rasterização temporária na área de trabalho

Descrição

Essa função salva temporariamente uma varredura como varredura permanente na área de trabalho.

Uso

rpygeo_save (dados, nome do arquivo)

Argumentos
dados objeto reticulado ou caminho completo da saída da função ArcPy
nome do arquivoNome do arquivo com extensão ou sem extensão, se o espaço de trabalho for geodatabase

Detalhes

Algumas funções do ArcPy não têm parâmetro para especificar uma varredura de saída.
Em vez disso, eles retornam um objeto de varredura e uma varredura temporária é salva no
espaço de trabalho inicial. Esta função grava a varredura temporária como uma varredura
permanente na área de trabalho.
A maneira como o arquivo é gravado depende das configurações do ambiente de trabalho e do ambiente de
trabalho de rascunho.

• Área de trabalho e área de trabalho inicial são diretórios: a varredura é carregada

com o pacote raster e gravada no diretório da área de trabalho. O formato do arquivo
é inferido a partir da extensão do arquivo no parâmetro filename.
• A área de trabalho e a área de trabalho de rascunho são bancos de dados
geográficos: a varredura é copiada no banco de dados geográfico de arquivos da área
de trabalho. Não é necessária extensão de arquivo para o parâmetro filename.
• O espaço de trabalho é um banco de dados geográfico e o espaço de trabalho inicial é
um diretório: a varredura é copiada para o geodatabase do espaço de trabalho. Não é
necessária extensão de arquivo para o parâmetro filename.
• Área de trabalho é diretório e área de trabalho inicial é geodatabase: o raster é exportado para
diretório da área de trabalho. O parâmetro filename é ignorado devido a restrições na função
arcpy.RasterToOtherFormat_convers. Se o nome do arquivo gerado automaticamente já existir, um número será
anexado ao
final do nome do arquivo.

Autor (es)

Marc Becker

8 rpygeo_search

Exemplos

## Não correr:
# Carregar
biblioteca da
biblioteca de
 pacotes (RPyGeo)
(RQGIS) (magrittr)

# Obter dados
dados (dem, pacote = "RQGIS")

# Carregue o módulo ArcPy e construa o ambiente

arcpy <- arcpy_build_env (sobrescreve = TRUE, espaço de trabalho = tempdir ())

# Grava raster no diretório da área de trabalho

writeRaster (dem, arquivo.caminho (tempdir (), "dem.tif"), format = "GTiff")

# Calcule o arquivo de aspecto temporário e salve no espaço

de trabalho arcpy $ sa $ Aspect (in_raster = "dem.tif")%>%
rpygeo_save ("aspect.tif")

## Fim (não executado)

rpygeo_search Pesquise funções e classes do ArcPy

Descrição
Procure funções e classes do ArcPy com uma sequência de caracteres ou expressão regular.

Uso

rpygeo_search (search_term = NULL)

Argumentos
search_term Termo de pesquisa. Expressões regulares são possíveis.

Detalhes

Os membros da lista são referenciados pelos nomes dos módulos do ArcPy. Cada membro
contém um vetor de caracteres correspondente às funções e classes do ArcPy. Exceto
pelo módulo principal, funções e classes devem ser acessadas por seus nomes de módulo
(s. Exemplos).

Valor

Lista nomeada de vetores de caracteres de funções e classes correspondentes do ArcPy

% rpygeo _-% 9

Autor (es)

Marc Becker

Exemplos

## Não correr:
# Carregar
biblioteca da
biblioteca de
pacotes (RPyGeo)
(magrittr) (RQGIS)

# Obter dados
dados (dem, pacote = "RQGIS")

# Gravar dados no disco

writeRaster (dem, arquivo.caminho (tempdir (), "dem.tif"), format = "GTiff")
 # Carregue o módulo ArcPy e construa o
ambiente arcpy <- rpygeo_build_env (substituir =
TRUE,
espaço de trabalho =
tempdir (), extensões =
"espacial")

# Pesquise funções do ArcPy, que contêm o termo slope

rpygeo_search ("slope")

#> $ toolbox
#> [1] "Slope_3d" "SurfaceSlope_3d"
#>
#> $ main
#> [1] "Slope_3d" "SurfaceSlope_3d"
#>
#> $ sa
#> [1] "Inclinação"
#>
#> $ ddd
#> [1] "Inclinação" "SurfaceSlope"

# Executar função do módulo sa

inclinação $ sa $ arcpy (in_raster = "dem.tif")

# Função de execução do módulo

principal arcpy $ Slope_3d (in_raster =
"dem.tif")

## Fim (não executado)

% rpygeo _-% Operador de subtração

10 % rpygeo _ +%

Descrição
Operador de subtração para álgebra de mapa. A extensão de Analisador espacial é requerida para álgebra de
mapa.

Uso

raster_1 % rpygeo _-% raster_2

Argumentos
raster_1 conjunto de dados raster ou numérico
raster_2 conjunto de dados raster ou numérico

Valor
objeto reticulado

Autor (es)
Marc Becker

Exemplos

## Não correr:
# Carregue o módulo ArcPy e construa o ambiente
arcpy <- arcpy_build_env (sobrescreve = TRUE, espaço de trabalho = "C: / espaço de trabalho")

# Grava raster no diretório da área de trabalho

writeRater (elev, "C: /workspace/elev.tif", extensões = "espacial")
 # Criar objeto raster
ras <- arcpy $ sa $ Raster ("elev.tif")

# Subtrair raster por si só ras%

rpygeo _ +% ras%>%
rpygeo_load ()

## Fim (não executado)

% rpygeo _ +% Operador de adição

Descrição

Operador de adição para álgebra de mapa. A extensão de Analisador espacial é requerida para álgebra de mapa.

Uso

raster_1% rpygeo _ +% raster_2

% rpygeo _ /% 11

Argumentos
raster_1 conjunto de dados raster ou numérico
raster_2 conjunto de dados raster ou numérico

Valor

objeto reticulado

Autor (es)

Marc Becker

Exemplos

## Não correr:
# Carregue o módulo ArcPy e construa o ambiente
arcpy <- arcpy_build_env (sobrescreve = TRUE, espaço de trabalho = "C: / espaço de trabalho")

# Grava raster no diretório da área de trabalho

writeRater (elev, "C: /workspace/elev.tif", extensões = "espacial")

# Criar objeto raster

ras <- arcpy $ sa $ Raster ("elev.tif")

# Adicione raster a si
mesmo ras% rpygeo _
+% ras%>%
rpygeo_load ()

## Fim (não executado)

% rpygeo _ /% Operador de divisão

Descrição

Operador de divisão para álgebra de mapa. A extensão de Analisador espacial é requerida para álgebra de mapa.

Uso
 raster_1% rpygeo _ /% raster_2

Argumentos
raster_1conjunto de dados raster ou numérico
raster_2conjunto de dados raster ou numérico

12 % rpygeo _ *%

Valor
objeto reticulado

Autor (es)
Marc Becker

Exemplos

## Não correr:
# Carregue o módulo ArcPy e construa o ambiente
arcpy <- arcpy_build_env (sobrescreve = TRUE, espaço de trabalho = "C: / espaço de trabalho")

# Grava raster no diretório da área de trabalho

writeRater (elev, "C: /workspace/elev.tif", extensões = "espacial")

# Criar objeto raster

ras <- arcpy $ sa $ Raster ("elev.tif")

# Divida a varredura por si

só ras% rpygeo _ +%
ras%>%
rpygeo_load ()

## Fim (não executado)

% rpygeo _ *% Operador de multiplicação

Descrição

Operador de multiplicação para álgebra de mapas. A extensão de Analisador espacial é requerida para álgebra de
mapa.

Uso

raster_1% rpygeo _ *% raster_2

Argumentos
raster_1 conjunto de dados raster ou numérico
raster_2 conjunto de dados raster ou numérico

Valor
objeto reticulado

Autor (es)
Marc Becker
% rpygeo _ *% 13

Exemplos

## Não correr:
# Carregue o módulo ArcPy e construa o ambiente
arcpy <- arcpy_build_env (sobrescreve = TRUE, espaço de trabalho = "C: / espaço de trabalho")

# Grava raster no diretório da área de trabalho

writeRater (elev, "C: /workspace/elev.tif", extensões = "espacial")

# Criar objeto raster

ras <- arcpy $ sa $ Raster ("elev.tif")

# Multiplique a varredura por

si mesma ras% rpygeo _ +%
ras%>%
rpygeo_load ()

## Fim (não executado)

Índice

% rpygeo _ *%, 12
% rpygeo _ +%, 10
% rpygeo _-%, 9 %
rpygeo _ /%, 11

RPyGeo (pacote RPyGeo), 2

pacotes RPyGeo, 2
rpygeo_build_env, 2 , 3
rpygeo_help, 4 rpygeo_load,
5 rpygeo_save, 7
rpygeo_search, 8

14