Importação de dados — read.inv • d2h

read.inv função utilizada para leitura de banco de dados de inventário florestal.

read.inv(
  path,
  variavel,
  d,
  h,
  par,
  areapar,
  areatotal,
  metodo = "fixo",
  processo = "AAS",
  aggfun,
  ha = TRUE,
  ...
)

Arguments

path: Caractere com o caminho relativo do arquivo a ser importado.
variavel: Caractere contendo o nome da coluna de interesse no inventário ou numérico contendo o número da coluna de interesse.
d: Caractere contendo o nome da coluna dos diâmetros, ou numérico contendo o número da coluna de diâmetros.
h: Caractere contendo o nome da coluna das alturas, ou numérico contendo o número da coluna de alturas.
par: Caractere contendo o nome da coluna que contém as parcelas ou numérico contendo o número da coluna de interesse.
areapar: Numérico contendo a área da parcela, em hectares, ou caractere informando a coluna que contém a área da parcela.
areatotal: Numérico informando a área total do inventário.
metodo: Caractere com as opções fixo e variavel, que informam o método de amostragem utilizado
processo: Caractere informando o processo amostral. Padrão é "AAS".
aggfun: Função para aplicar a ids/parcelas agregadas. Utilizada se ids não são únicos. Padrão é sum.
ha: Lógico informando se as unidades de areapar e areatotal são em hectares. Padrão é TRUE (sim).
...: Demais argumentos passados para funções read.* no caso de arquivos de texto, ou st_read no caso de arquivos espaciais.

Value

Objeto da classe Inv, que contém informações do inventário bem como a base de dados utilizada.

Details

Por padrão, se o arquivo indicado for objeto espacial (shapefile, kml, geojson), então a área da parcela será automaticamente preenchida desde que o usuário não informe areapar e que as feições dos objetos espaciais sejam polígonos. Nesse caso, a função utiliza como padrão a média das áreas dos polígonos caso existam divergências. Caso todas as feições tenham mesma área, então essa área será utilizada. Esse comportamento é sobreescrito caso areapar seja informado.

Caso o argumento par seja omitido, então a função criará um índice ordinal de id's (identificadores), e identificará cada linha de observação como uma parcela distinta. Caso par seja informado e seja composto por valores que se repitam (não únicos), então a variável de interesse passada em variavel será agregada nesses índices por meio de soma. Esse é o caso de um arquivo contendo árvores, e não parcelas, como linhas.

Por padrão, um método de área fixa metodo='fixo' e processo aleatório simples processo='AAS' são utilizados.

O argumento ha indica se a coluna de dados de interesse variavel está na escala em hectares ou não. Caso contrário, os dados serão extrapolados para hectare via fator de expansão 1/areapar. O padrão é ha=TRUE.

O argumento aggfun é utilizada quando os ids/parcelas não são únicos, por exemplo várias árvores em uma parcela. A função utilizada por padrão é soma sum. O argumento aceita caracteres, podendo ser entre as opções "soma", "média" e "produto", e também aceita funções que retornem um único elemento, como sum, mean, var, prod etc.