geomoz 0.1.4

Geospatial data library for Mozambique with geological and administrative datasets

GeoMoz - Dados Geográficos de Moçambique

GeoMoz é um pacote Python que fornece acesso fácil a dados geográficos de Moçambique, incluindo divisões administrativas (11 províncias, 161 distritos, 459 postos, 11.524 aldeias) e dados geológicos completos.

Inspirado no geobr (Brasil).

Agora também disponível em R! Veja a pasta R/ para o pacote GeoMozR.

---

Versões Disponíveis

Linguagem	Instalação	Pasta
Python	pip install geomoz	Raiz do projeto
R	devtools::install_github("geolithicamz-hub/geomoz", subdir="R")	R/

---

Instalação

pip install geomoz

Com dependências completas:

pip install geomoz geopandas matplotlib folium

---

Uso Rápido

import geomoz
import matplotlib.pyplot as plt

# Carregar dados
provincias = geomoz.read_province()
print(f"{len(provincias)} províncias carregadas")

# Criar figura
fig, ax = plt.subplots(figsize=(8, 12))

# Plot — a legenda é colocada FORA do mapa para não sobrepor a figura
provincias.plot(
    ax=ax,
    column="Provincia",
    cmap="tab20",
    edgecolor="black",
    linewidth=0.8,
    legend=True,
    legend_kwds={
        "loc": "center left",
        "bbox_to_anchor": (1.02, 0.5),  # à direita, fora do mapa
        "title": "Província",
    },
)

# Ajustes
ax.set_title("Províncias de Moçambique", fontsize=14)
ax.axis("off")

plt.tight_layout()
plt.show()

---

Dados Disponíveis

Dataset	Registros	Função
Províncias	11	read_province()
Distritos	161	read_district()
Postos Administrativos	459	read_admin_post()
Aldeias	11.524	read_village() / CachedGeoMoz.read_village()
Geologia	~50.000	read_geology()

---

Exemplos

Mapa de Províncias

from geomoz import plot_provinces
plot_provinces(show_names=True, save_path='mapa.png')

Geologia por Província

import geopandas as gpd
from geomoz import read_province, read_geology

province = read_province(name_province="Tete")
geology = read_geology()
geo_tete = gpd.overlay(geology, province, how='intersection')
print(f"Unidades geológicas em Tete: {len(geo_tete)}")

Mapa Web Interativo

import folium
from geomoz import read_province

province = read_province(name_province="Nampula")
m = folium.Map(location=[-14.5, 39], zoom_start=7)
folium.GeoJson(province).add_to(m)
m.save('mapa.html')

---

Documentação

• Guia Completo - Documentação detalhada
• Tutorial Educativo - Guia passo a passo
• Referência Rápida - Cheat sheet
• Mapeamento Geológico - Exemplos de mapas
• Exemplos - Códigos de exemplo
• Artigo Técnico - Visão geral da biblioteca
• Changelog - Histórico de versões

---

Desenvolvimento

git clone https://github.com/geolithicamz-hub/geomoz.git
cd geomoz
pip install -e ".[dev]"
pytest -m "not network"

---

Licença

MIT License - veja LICENSE

---

GeoMoz - Dados geográficos de Moçambique ao alcance de todos!