extrativismo_vegetal v1.0¶
Extractive plant production (açaí, Brazil nut, yerba mate, palm heart, etc.) by state or municipality.
Sources¶
| Priority | Source | Description |
|---|---|---|
| 1 | IBGE PEVS | Plant Extraction and Silviculture Production |
Products¶
acai, castanha_para, erva_mate, palmito, pequi_fruto, babacu, piacava, carnauba_cera, carvao, lenha, madeira_tora, hevea_coagulado
Schema¶
| Column | Type | Nullable | Description |
|---|---|---|---|
ano |
int | ❌ | Reference year |
localidade |
str | ✅ | State or municipality |
localidade_cod |
int | ✅ | IBGE code |
produto |
str | ❌ | Product name |
valor |
float64 | ✅ | Value (tons or cubic meters) |
unidade |
str | ❌ | Unit of measure |
fonte |
str | ❌ | Data origin |
Primary Key¶
[ano, produto, localidade]
Guarantees¶
- Consolidated annual data
- Typical latency: Y+1 (data available the following year)
- Historical series since 1986
Example¶
from agrobr import datasets
# Açaí output by state
df = await datasets.extrativismo_vegetal("acai", ano=2023)
# Brazil nut in Amazonas
df = await datasets.extrativismo_vegetal("castanha_para", ano=2023, uf="AM")
# Filter by state
df = await datasets.extrativismo_vegetal("erva_mate", ano=2023, uf="PR")
# With metadata
df, meta = await datasets.extrativismo_vegetal("acai", ano=2023, return_meta=True)
JSON Schema¶
Available at agrobr/schemas/extrativismo_vegetal.json.
from agrobr.contracts import get_contract
contract = get_contract("extrativismo_vegetal")
print(contract.to_json())
Territorial Levels¶
| Level | Description |
|---|---|
brasil |
National total |
uf |
By state (default) |
municipio |
By municipality |