Alocação de Parcelas

Esse módulo permite a alocação de parcelas amostrais com vários tipos de amostragem e formatos de parcelas.
Se preferir uma interface visual, considere usar o módulo QGIS.

Parâmetros da Classe

PlotAllocation(shp_dir, epsg)

Parâmetros	Descrição
shp_dir	Diretório do shapefile que define os limites da área a ser amostrada.
epsg	Código EPSG do shapefile que define os limites da área a ser amostrada.

Métodos da Classe

methods and parameters

PlotAllocation.create_plots(distribution, plot_format, plot_area, sample_number,
                            by_hectare, min_border_distance, rectangle_size,
                            x_y_angle, save_buffer, show_plot, save_dir)

Parâmetro	Descrição
distribution	Tipo de distribuição ou alocação à qual as parcelas serão submetidas.
plot_format	Formato da parcela que será instalada.
plot_area	Área da parcela que será instalada. Não utilizada quando `plot_format = 'rectangle'`.
sample_number	Pode ser o número de parcelas, a porcentagem da área total que será amostrada ou uma coluna na tabela de atributos contendo o número de parcelas por polígono. Se o valor for < 1, será entendido como uma porcentagem. Se o valor for >= 1, será entendido como a quantidade de parcelas a serem alocadas.
by_hectare	Se `True`, utilizará `sample_number` como parcelas por hectare. Se `sample_number < 1`, usará apenas a porcentagem.
min_border_distance	Distância mínima em metros que as parcelas devem estar da borda dos limites do shapefile.
rectangle_size	Usado quando `plot_format = 'rectangle'`. Tupla contendo os tamanhos de X e Y do retângulo `(x,y)`.
x_y_angle	Usado quando `distribution = 'systematic custom'`. Define a distância em X e Y de cada linha na grade da distribuição sistemática e também o ângulo de rotação da grade em graus `(x,y,angle)`.
save_buffer	Se `True`, salva o buffer considerando o tamanho da parcela ao redor do ponto.
show_plot	Se `True`, exibe uma figura da alocação realizada.
save_dir	Diretório onde os shapefiles serão salvos. Se `None`, nenhum shapefile será salvo.

Argumentos disponíveis

Tipo de distribuiçãoFormato da parcelaEPSG

random : Aloca as parcelas em uma distribuição aleatória.
best sampling : (recomendado) Aloca as parcelas na melhor distribuição possível para a área considerando os parâmetros estabelecidos.
systematic : Aloca as parcelas em uma distribuição em grade, não permite a definição de sample_number e aloca todas as parcelas possíveis.
systematic custom : Aloca as parcelas em uma distribuição em grade com as distâncias x e y das linhas da grade e o ângulo de rotação da grade definidos pelo usuário.

round : Considera que as parcelas terão formato arredondado.
squared : Considera que as parcelas terão formato quadrado.
rectangle : Permite que o usuário insira os tamanhos X e Y do formato retangular desejado.

Para obter a melhor precisão nos cálculos, você deve selecionar a zona UTM na qual sua área está localizada. Encontre sua zona UTM.

Exemplo de Uso

Considere os dados de 3 talhões fictícios, delimitados em uma floresta próxima a Universidade Federal de Santa Maria, Campus Frederico Westphalen, RS-Brasil.
Baixar shapefile de exemplo.

Informações da tabela de atributos:

id	talhao	area_ha	n_par
1	A	4,049	3
2	B	15,521	5
3	C	39,964	14

Distribuição Aleatória

plot_allocation_example_1.py
from fptools.inventory_plots import PlotAllocation#(1)!

plots = PlotAllocation(r"your/path/exemplo_shapefile.shp", epsg='32722')#(2)!

plots.create_plots(distribution="random", sample_number="n_par",
                   plot_area=400, min_border_distance=2, 
                   save_dir="C:/Users/Desktop",
                   show_plot=True, save_buffer=True)#(3)!

Importa a classe PlotAllocation.
Cria a variável plots com a classe PlotAllocation. Define o caminho do shapefile da área limite e o EPSG.
Cria as parcelas com distribuição random, utilizando a coluna "n_par" da tabela de atributos para definir o número de parcelas, plot area = 400 m², uma distância mínima da borda de 20 metros e salva o shapefile em C:\Users\Desktop.

example-1 — Como `show_plot=True`, uma figura de exibição prévia de alocação das parcelas será gerada.

Distribuição Sistemática Personalizada

plot_allocation_example_2.py
from fptools.inventory_plots import PlotAllocation#(1)!

plots = PlotAllocation(r"your/path/exemplo_shapefile.shp", epsg='32722')#(2)!

plots.create_plots(distribution="systematic custom", x_y_angle=(100,50,45),
                    plot_area=400, min_border_distance=2, save_dir="C:\Users\Desktop",
                    show_plot=True, save_buffer=True)#(3)!

Importa a classe PlotAllocation.
Cria a variável plots com a classe PlotAllocation. Define o caminho do shapefile da área limite e o EPSG.
Cria as parcelas com distribuição systematic custom, plot area = 400 m², com distância x = 100 metros, distância y = 50 metros e rotação da grade de 45º, com uma distância mínima da borda de 2 metros e salva o shapefile em C:\Users\Desktop.

example-2 — Como `show_plot=True`, uma figura de exibição prévia de alocação das parcelas será gerada.

Formato de parcela retangular

plot_alocation_example_3.py
from fptools.inventory_plots import PlotAllocation #(1)!

plots = PlotAllocation(r"your/path/exemplo_shapefile.shp", epsg='32722')#(2)!

plots.create_plots(distribution="best sampling", rectangle_size=(20,30),
                    sample_number = 2, by_hectare = True,
                    min_border_distance=2, save_dir="C:\Users\Desktop",
                    show_plot=True, save_buffer=True)#(3)!

Importa a classe PlotAllocation.
Cria a variável plots com a classe PlotAllocation. Define o caminho do shapefile da área limite e o EPSG.
Cria as parcelas com distribuição best sampling, uma largura do retângulo (x) = 2 metros e altura (y) = 30 metros, com uma distância mínima da borda de 2 metros, uma amostragem de 2 parcelas por hectare e salva o shapefile em C:\Users\Desktop.