Layout de mapa no QGIS
Transforma uma camada do projeto aberto no QGIS em mapa pronto para o
cliente, sempre no mesmo modelo. O trabalho é feito no QGIS do usuário, pelo
conector ClaudIA QGIS; nada roda no chat.
Para que serve
- Montar o layout de impressão sem o usuário arrastar caixa por caixa.
- Calcular a área de cada classe em ha e em % e escrever na legenda.
- Padronizar: todo mapa do escritório sai com a mesma cara.
- Exportar PDF e PNG, e uma página por talhão quando ele pedir.
Para que NÃO serve
- Não cria o dado: a camada (raster interpolado, zonas, índice) já tem de
estar no projeto. Para gerar o raster, use
interpolacao-idw ou
interpolacao-krigagem.
- Não escolhe os limites das classes. Se a camada não estiver classificada,
PERGUNTE os limites ao usuário.
- Não inventa logo. A logo é a do cliente: peça o arquivo; se ele não
tiver, o mapa sai sem logo. Nunca use logo de outra empresa.
O que precisa estar pronto
- Conector ClaudIA QGIS ligado na IA e o QGIS do usuário aberto com o
plugin conectado. Comece por
ping. Sem resposta, avise e pare.
- O projeto com a camada do mapa e, de preferência, a camada dos talhões.
Fluxo de trabalho (siga nesta ordem)
- Veja o projeto:
ping, get_project_info e get_layers. Diga ao
usuário quais camadas você achou e confirme qual é a do mapa e qual é a dos
talhões (o perímetro). Guarde os id das duas.
- Defina a pasta de trabalho. Se o projeto tem arquivo salvo, é a pasta
dele. Se não tem (
get_project_info sem nome de arquivo), PERGUNTE ao
usuário em que pasta gravar; não escolha por ele. É nessa pasta que ficam o
módulo (subpasta layout_agro/) e os arquivos exportados.
- Pergunte o que vai escrito no mapa (o que ele não disser, fica vazio):
título; fazenda; proprietário; safra; atributo; profundidade ou outra
informação; unidade das classes; A4 ou A3; e a logo (caminho do arquivo na
máquina dele, PNG, JPG ou SVG). O nome do layout você mesmo monta com o
atributo e a profundidade (ex.:
Argila 0-20) e diz a ele qual é.
- Avise e instale o módulo. Diga ao usuário, numa frase, o que vai
fazer: gravar o arquivo
layout_agro.py na pasta de trabalho e carregá-lo
no QGIS, sem alterar nenhuma camada. Com o ok dele, mande o Bloco A por
execute_code. Uma vez por conversa basta.
- Confira a camada com o Bloco C. Ele diz se a camada já está em
classes e lista os campos da camada dos talhões. Raster em cor contínua ou
vetor de símbolo único não tem legenda de classes: pergunte os limites e
use o Bloco D. Avise antes: isso troca o estilo da camada dele.
- Monte o layout com o Bloco E. O resultado traz as classes com ha e
%, a área total, o mínimo, o máximo, a média e a escala. Mostre esses
números ao usuário e pergunte se batem com o que ele espera.
- Exporte para ele ver: tool
export_layout com layout_name, path
(um arquivo dentro da pasta de trabalho), format (png ou pdf) e
dpi: 150. Diga o caminho. Você não enxerga o arquivo: peça que ele abra e
diga se algo ficou cortado, sobreposto ou escondido.
- Ajuste o que ele pedir e rode o Bloco E de novo, com TODOS os
argumentos (o layout de mesmo nome é refeito do zero). Para um retoque
fora do modelo, use
add_layout_label e add_layout_picture sobre o
layout já montado.
- Uma página por talhão (se ele pedir): confirme com ele qual campo da
camada dos talhões tem o nome (o Bloco C listou os campos com exemplos).
Rode o Bloco E com o acréscimo do atlas e com outro nome de layout
(o mesmo nome +
por talhão), para o layout do mapa inteiro continuar
existindo. Depois, a tool export_atlas (layout_name, output_path,
format: "pdf", dpi: 150). Cada página traz o nome e a área do talhão,
que aparece com o contorno grosso; os vizinhos ficam em cinza. Avise que a
legenda continua com as áreas do mapa inteiro. Não exporte o layout do
atlas pelo export_layout: fora do atlas, o nome e a área do talhão saem
em branco.
- Vários atributos: repita os passos 5 a 7 para cada camada, um layout
por atributo, mudando o nome do layout,
Atributo e a unidade.
Os blocos de código
Mande cada bloco como está, começando na primeira coluna. Troque só o que
está entre << >>. Em <<pasta que o usuário indicou>> vai a pasta do
passo 2; com o projeto salvo essa pasta não é usada, e o marcador pode ficar
como está.
Bloco A — instalar o módulo (uma vez por conversa)
O conteúdo de scripts/layout_agro.py vai INTEIRO dentro de CODIGO, sem
alteração. O bloco confere se o arquivo chegou completo e fiel.
import hashlib, os, sys
from qgis.core import QgsProject
BASE = QgsProject.instance().homePath() or r'<<pasta que o usuário indicou>>'
CODIGO = r'''
<<conteúdo de scripts/layout_agro.py>>
'''
compile(CODIGO, 'layout_agro.py', 'exec')
pasta = os.path.join(BASE, 'layout_agro')
os.makedirs(pasta, exist_ok=True)
with open(os.path.join(pasta, 'layout_agro.py'), 'w', encoding='utf-8') as f:
f.write(CODIGO.lstrip())
if pasta not in sys.path:
sys.path.insert(0, pasta)
sys.modules.pop('layout_agro', None)
import layout_agro as la
assert getattr(la, 'FIM_DO_ARQUIVO', False), 'o arquivo chegou cortado: mande o bloco de novo'
fiel = hashlib.md5(''.join(CODIGO.split()).encode('utf-8')).hexdigest()[:12] == 'ffdbcb413df1'
print('layout_agro pronto em', pasta, '|', 'cópia fiel' if fiel else 'CÓPIA DIFERENTE do original')
- Se o
assert ou o compile falhar, o código foi cortado: mande o bloco de
novo, com o arquivo inteiro, sem resumir nem pular função.
- Se imprimir
CÓPIA DIFERENTE, algum trecho foi alterado na cópia: mande o
bloco de novo, com o arquivo exatamente como está. Se repetir, siga em
frente e avise o usuário de que o módulo pode ter diferença do original.
Bloco B — cabeçalho de toda chamada seguinte
Cada execute_code é uma execução nova: comece os blocos C, D e E com isto.
import os, sys
from qgis.core import QgsProject
BASE = QgsProject.instance().homePath() or r'<<pasta que o usuário indicou>>'
pasta = os.path.join(BASE, 'layout_agro')
if pasta not in sys.path:
sys.path.insert(0, pasta)
import layout_agro as la
p = QgsProject.instance()
Bloco C — conferir as classes e os campos dos talhões (depois do Bloco B)
camada = p.mapLayer('<<id da camada do mapa>>')
try:
print('EM CLASSES:', [c['rotulo'] for c in la.areas_por_classe(camada)[0]])
except ValueError as erro:
print('SEM CLASSES:', erro)
talhoes = p.mapLayer('<<id dos talhões>>')
amostra = [f for _, f in zip(range(3), talhoes.getFeatures())]
print('CAMPOS DOS TALHÕES:', {c.name(): [str(f[c.name()]) for f in amostra] for c in talhoes.fields()})
Sem camada de talhões, apague as três últimas linhas.
Bloco D — pôr o raster em classes (depois do Bloco B)
camada = p.mapLayer('<<id da camada do mapa>>')
print(la.classificar_raster(camada, [<<limites, ex.: 150, 250, 350, 450>>]))
invertida=True para variável em que mais é pior (alumínio, saturação por
Al). Em vetor, o usuário categoriza ou gradua no QGIS, ou você usa
set_layer_style.
Bloco E — montar o layout (depois do Bloco B)
resumo = la.montar_layout(
'<<nome do layout, ex.: Argila 0-20>>', p.mapLayer('<<id da camada do mapa>>'),
titulo='<<título>>', fazenda='<<fazenda>>', proprietario='<<proprietário>>',
campos=[('Safra', '<<safra>>'), ('Atributo', '<<atributo>>'), ('Profundidade', '<<profundidade>>')],
perimetro=p.mapLayer('<<id dos talhões>>'), unidade='<<unidade>>', logo=None, pagina='A4')
print(resumo)
Para o atlas, troque o nome do layout (ex.: Argila 0-20 por talhão) e
acrescente antes do parêntese final:
atlas_camada=p.mapLayer('<<id dos talhões>>'), atlas_campo='<<campo com o nome do talhão>>'.
O resumo passa a trazer atlas_paginas.
Opções do montar_layout
| Parâmetro |
O que faz |
Padrão |
titulo |
texto do quadro de cima, à direita |
'Mapa' |
fazenda, proprietario |
faixa de cima |
vazio |
campos |
lista de pares (rótulo, valor) na coluna da direita |
nenhum |
perimetro |
camada dos talhões: enquadra o mapa e é desenhada por cima, só o contorno |
a própria camada |
contorno_perimetro |
False desenha os talhões com o estilo que a camada já tem |
True |
logo |
caminho da imagem da logo do cliente |
sem logo |
unidade |
aparece ao lado de "CLASSE" |
vazio |
pagina |
'A4' ou 'A3' (deitada) |
'A4' |
grade |
coordenadas na borda do mapa |
False |
casas |
casas decimais das áreas e das estatísticas |
2 |
ocultar_vazias |
tira da legenda a classe com 0 ha |
False |
camadas_extra |
outras camadas a desenhar (pontos de amostra, por exemplo) |
nenhuma |
atlas_camada, atlas_campo |
uma página por feição, com o nome lido do campo |
sem atlas |
atlas_rotulo |
como chamar a feição na página |
'Talhão' |
Detalhes fixos
- O módulo não altera as camadas do usuário. Os talhões saem só com o
contorno no mapa do layout, mesmo que na tela estejam preenchidos, e o
estilo deles no projeto fica como estava. A única troca de estilo é a do
classificar_raster, que você avisa antes.
- O layout guarda o estilo do momento em que foi montado. Se o usuário
reclassificar a camada depois, monte de novo: a legenda é texto fixo.
- Áreas: no raster, número de pixels de cada classe × área do pixel. No
vetor, a área elipsoidal dos polígonos de cada classe. A área total é a
soma das classes; diga isso se ela diferir da área que o usuário conhece
(pixel de borda e áreas sem dado explicam a diferença).
- Projeção do mapa: se a camada estiver em graus, o mapa do layout é posto
na zona UTM SIRGAS 2000 do local, para a escala sair em metros.
- Escala: o passo é sempre um número redondo que cabe na coluna; no atlas
ele é recalculado em cada página.
- Mínimo, máximo e média são do raster inteiro (ou do campo do vetor
graduado), não das amostras.
- Raster acima de 30 milhões de pixels é lido reduzido para a contagem; a
diferença nas áreas fica abaixo de 1 %.
- Cada
execute_code precisa terminar em menos de 55 s. Exporte pelas tools
export_layout e export_atlas, que não têm esse limite.
- No fim, diga ao usuário que a subpasta
layout_agro/ pode ser apagada: ela
só guarda o módulo.
- O modelo, medida por medida, e as regras de um mapa bem apresentado:
references/modelo.md.
1---2name: layout-mapa-qgis3description: >-4 Monta no QGIS do usuário, pela ClaudIA QGIS, o layout final de um mapa num5 modelo profissional fixo, com a área de cada classe em hectares e em % na6 legenda, e exporta em PDF e PNG. O modelo tem moldura, faixa com a logo do7 cliente e os campos Fazenda e Proprietário, título, dados do mapa, escala,8 norte, data e mínimo, máximo e média; sai em A4 ou A3 e faz uma página por9 talhão com o atlas.10 Serve para mapa de fertilidade, produtividade, índice de vegetação, zonas de11 manejo ou qualquer camada em classes. Acione com "layout do mapa", "montar o12 mapa para impressão", "mapa para o cliente", "exportar o mapa em PDF",13 "legenda com hectares" ou quando houver uma camada no QGIS e o usuário pedir14 o mapa final.15metadata:16 source: https://skillmd.com/skills/guilherme-iaparaagronomos/layout-mapa-qgis17---1819# Layout de mapa no QGIS2021Transforma uma camada do projeto aberto no QGIS em **mapa pronto para o22cliente**, sempre no mesmo modelo. O trabalho é feito no QGIS do usuário, pelo23conector **ClaudIA QGIS**; nada roda no chat.2425## Para que serve26- Montar o layout de impressão sem o usuário arrastar caixa por caixa.27- Calcular a **área de cada classe em ha e em %** e escrever na legenda.28- Padronizar: todo mapa do escritório sai com a mesma cara.29- Exportar PDF e PNG, e uma página por talhão quando ele pedir.3031## Para que NÃO serve32- Não cria o dado: a camada (raster interpolado, zonas, índice) já tem de33 estar no projeto. Para gerar o raster, use `interpolacao-idw` ou34 `interpolacao-krigagem`.35- Não escolhe os limites das classes. Se a camada não estiver classificada,36 PERGUNTE os limites ao usuário.37- Não inventa logo. A logo é a **do cliente**: peça o arquivo; se ele não38 tiver, o mapa sai sem logo. Nunca use logo de outra empresa.3940## O que precisa estar pronto41- Conector **ClaudIA QGIS** ligado na IA e o QGIS do usuário aberto com o42 plugin conectado. Comece por `ping`. Sem resposta, avise e pare.43- O projeto com a camada do mapa e, de preferência, a camada dos talhões.4445## Fluxo de trabalho (siga nesta ordem)46471. **Veja o projeto**: `ping`, `get_project_info` e `get_layers`. Diga ao48 usuário quais camadas você achou e confirme qual é a do mapa e qual é a dos49 talhões (o perímetro). Guarde os `id` das duas.502. **Defina a pasta de trabalho.** Se o projeto tem arquivo salvo, é a pasta51 dele. Se não tem (`get_project_info` sem nome de arquivo), PERGUNTE ao52 usuário em que pasta gravar; não escolha por ele. É nessa pasta que ficam o53 módulo (subpasta `layout_agro/`) e os arquivos exportados.543. **Pergunte o que vai escrito no mapa** (o que ele não disser, fica vazio):55 título; fazenda; proprietário; safra; atributo; profundidade ou outra56 informação; unidade das classes; A4 ou A3; e a logo (caminho do arquivo na57 máquina dele, PNG, JPG ou SVG). O **nome do layout** você mesmo monta com o58 atributo e a profundidade (ex.: `Argila 0-20`) e diz a ele qual é.594. **Avise e instale o módulo.** Diga ao usuário, numa frase, o que vai60 fazer: gravar o arquivo `layout_agro.py` na pasta de trabalho e carregá-lo61 no QGIS, sem alterar nenhuma camada. Com o ok dele, mande o **Bloco A** por62 `execute_code`. Uma vez por conversa basta.635. **Confira a camada** com o **Bloco C**. Ele diz se a camada já está em64 classes e lista os campos da camada dos talhões. Raster em cor contínua ou65 vetor de símbolo único não tem legenda de classes: pergunte os limites e66 use o **Bloco D**. Avise antes: isso troca o estilo da camada dele.676. **Monte o layout** com o **Bloco E**. O resultado traz as classes com ha e68 %, a área total, o mínimo, o máximo, a média e a escala. **Mostre esses69 números ao usuário** e pergunte se batem com o que ele espera.707. **Exporte para ele ver**: tool `export_layout` com `layout_name`, `path`71 (um arquivo dentro da pasta de trabalho), `format` (`png` ou `pdf`) e72 `dpi: 150`. Diga o caminho. Você não enxerga o arquivo: peça que ele abra e73 diga se algo ficou cortado, sobreposto ou escondido.748. **Ajuste o que ele pedir** e rode o Bloco E de novo, com TODOS os75 argumentos (o layout de mesmo nome é refeito do zero). Para um retoque76 fora do modelo, use `add_layout_label` e `add_layout_picture` sobre o77 layout já montado.789. **Uma página por talhão** (se ele pedir): confirme com ele qual campo da79 camada dos talhões tem o nome (o Bloco C listou os campos com exemplos).80 Rode o Bloco E com o acréscimo do atlas e com **outro nome de layout**81 (o mesmo nome + ` por talhão`), para o layout do mapa inteiro continuar82 existindo. Depois, a tool `export_atlas` (`layout_name`, `output_path`,83 `format: "pdf"`, `dpi: 150`). Cada página traz o nome e a área do talhão,84 que aparece com o contorno grosso; os vizinhos ficam em cinza. Avise que a85 legenda continua com as áreas do mapa inteiro. Não exporte o layout do86 atlas pelo `export_layout`: fora do atlas, o nome e a área do talhão saem87 em branco.8810. **Vários atributos**: repita os passos 5 a 7 para cada camada, um layout89 por atributo, mudando o nome do layout, `Atributo` e a unidade.9091## Os blocos de código9293Mande cada bloco como está, começando na primeira coluna. Troque só o que94está entre `<< >>`. Em `<<pasta que o usuário indicou>>` vai a pasta do95passo 2; com o projeto salvo essa pasta não é usada, e o marcador pode ficar96como está.9798### Bloco A — instalar o módulo (uma vez por conversa)99100O conteúdo de `scripts/layout_agro.py` vai INTEIRO dentro de `CODIGO`, sem101alteração. O bloco confere se o arquivo chegou completo e fiel.102103```python104import hashlib, os, sys105from qgis.core import QgsProject106BASE = QgsProject.instance().homePath() or r'<<pasta que o usuário indicou>>'107CODIGO = r'''108<<conteúdo de scripts/layout_agro.py>>109'''110compile(CODIGO, 'layout_agro.py', 'exec')111pasta = os.path.join(BASE, 'layout_agro')112os.makedirs(pasta, exist_ok=True)113with open(os.path.join(pasta, 'layout_agro.py'), 'w', encoding='utf-8') as f:114 f.write(CODIGO.lstrip())115if pasta not in sys.path:116 sys.path.insert(0, pasta)117sys.modules.pop('layout_agro', None)118import layout_agro as la119assert getattr(la, 'FIM_DO_ARQUIVO', False), 'o arquivo chegou cortado: mande o bloco de novo'120fiel = hashlib.md5(''.join(CODIGO.split()).encode('utf-8')).hexdigest()[:12] == 'ffdbcb413df1'121print('layout_agro pronto em', pasta, '|', 'cópia fiel' if fiel else 'CÓPIA DIFERENTE do original')122```123124- Se o `assert` ou o `compile` falhar, o código foi cortado: mande o bloco de125 novo, com o arquivo inteiro, sem resumir nem pular função.126- Se imprimir `CÓPIA DIFERENTE`, algum trecho foi alterado na cópia: mande o127 bloco de novo, com o arquivo exatamente como está. Se repetir, siga em128 frente e avise o usuário de que o módulo pode ter diferença do original.129130### Bloco B — cabeçalho de toda chamada seguinte131132Cada `execute_code` é uma execução nova: comece os blocos C, D e E com isto.133134```python135import os, sys136from qgis.core import QgsProject137BASE = QgsProject.instance().homePath() or r'<<pasta que o usuário indicou>>'138pasta = os.path.join(BASE, 'layout_agro')139if pasta not in sys.path:140 sys.path.insert(0, pasta)141import layout_agro as la142p = QgsProject.instance()143```144145### Bloco C — conferir as classes e os campos dos talhões (depois do Bloco B)146147```python148camada = p.mapLayer('<<id da camada do mapa>>')149try:150 print('EM CLASSES:', [c['rotulo'] for c in la.areas_por_classe(camada)[0]])151except ValueError as erro:152 print('SEM CLASSES:', erro)153talhoes = p.mapLayer('<<id dos talhões>>')154amostra = [f for _, f in zip(range(3), talhoes.getFeatures())]155print('CAMPOS DOS TALHÕES:', {c.name(): [str(f[c.name()]) for f in amostra] for c in talhoes.fields()})156```157158Sem camada de talhões, apague as três últimas linhas.159160### Bloco D — pôr o raster em classes (depois do Bloco B)161162```python163camada = p.mapLayer('<<id da camada do mapa>>')164print(la.classificar_raster(camada, [<<limites, ex.: 150, 250, 350, 450>>]))165```166167`invertida=True` para variável em que mais é pior (alumínio, saturação por168Al). Em vetor, o usuário categoriza ou gradua no QGIS, ou você usa169`set_layer_style`.170171### Bloco E — montar o layout (depois do Bloco B)172173```python174resumo = la.montar_layout(175 '<<nome do layout, ex.: Argila 0-20>>', p.mapLayer('<<id da camada do mapa>>'),176 titulo='<<título>>', fazenda='<<fazenda>>', proprietario='<<proprietário>>',177 campos=[('Safra', '<<safra>>'), ('Atributo', '<<atributo>>'), ('Profundidade', '<<profundidade>>')],178 perimetro=p.mapLayer('<<id dos talhões>>'), unidade='<<unidade>>', logo=None, pagina='A4')179print(resumo)180```181182Para o atlas, troque o nome do layout (ex.: `Argila 0-20 por talhão`) e183acrescente antes do parêntese final:184`atlas_camada=p.mapLayer('<<id dos talhões>>'), atlas_campo='<<campo com o nome do talhão>>'`.185O `resumo` passa a trazer `atlas_paginas`.186187## Opções do `montar_layout`188189| Parâmetro | O que faz | Padrão |190|---|---|---|191| `titulo` | texto do quadro de cima, à direita | `'Mapa'` |192| `fazenda`, `proprietario` | faixa de cima | vazio |193| `campos` | lista de pares (rótulo, valor) na coluna da direita | nenhum |194| `perimetro` | camada dos talhões: enquadra o mapa e é desenhada por cima, só o contorno | a própria camada |195| `contorno_perimetro` | `False` desenha os talhões com o estilo que a camada já tem | `True` |196| `logo` | caminho da imagem da logo do cliente | sem logo |197| `unidade` | aparece ao lado de "CLASSE" | vazio |198| `pagina` | `'A4'` ou `'A3'` (deitada) | `'A4'` |199| `grade` | coordenadas na borda do mapa | `False` |200| `casas` | casas decimais das áreas e das estatísticas | `2` |201| `ocultar_vazias` | tira da legenda a classe com 0 ha | `False` |202| `camadas_extra` | outras camadas a desenhar (pontos de amostra, por exemplo) | nenhuma |203| `atlas_camada`, `atlas_campo` | uma página por feição, com o nome lido do campo | sem atlas |204| `atlas_rotulo` | como chamar a feição na página | `'Talhão'` |205206## Detalhes fixos207208- **O módulo não altera as camadas do usuário.** Os talhões saem só com o209 contorno no mapa do layout, mesmo que na tela estejam preenchidos, e o210 estilo deles no projeto fica como estava. A única troca de estilo é a do211 `classificar_raster`, que você avisa antes.212- **O layout guarda o estilo do momento em que foi montado.** Se o usuário213 reclassificar a camada depois, monte de novo: a legenda é texto fixo.214- **Áreas**: no raster, número de pixels de cada classe × área do pixel. No215 vetor, a área elipsoidal dos polígonos de cada classe. A área total é a216 soma das classes; diga isso se ela diferir da área que o usuário conhece217 (pixel de borda e áreas sem dado explicam a diferença).218- **Projeção do mapa**: se a camada estiver em graus, o mapa do layout é posto219 na zona UTM SIRGAS 2000 do local, para a escala sair em metros.220- **Escala**: o passo é sempre um número redondo que cabe na coluna; no atlas221 ele é recalculado em cada página.222- **Mínimo, máximo e média** são do raster inteiro (ou do campo do vetor223 graduado), não das amostras.224- Raster acima de 30 milhões de pixels é lido reduzido para a contagem; a225 diferença nas áreas fica abaixo de 1 %.226- Cada `execute_code` precisa terminar em menos de 55 s. Exporte pelas tools227 `export_layout` e `export_atlas`, que não têm esse limite.228- No fim, diga ao usuário que a subpasta `layout_agro/` pode ser apagada: ela229 só guarda o módulo.230- O modelo, medida por medida, e as regras de um mapa bem apresentado:231 `references/modelo.md`.