🌍 MapMiner
MapMiner is a geospatial and model-centric tool designed to efficiently download, process, and analyze geospatial data and metadata from various sources. It leverages powerful Python libraries like Selenium, Dask, Numba, and Xarray to provide high-performance data handling and integrates state-of-the-art models for advanced geospatial AI and visualization.
🛠 Installation
Base installation:
pip install mapminerFull installation (includes OCR + Chrome support):
pip install "mapminer[all]"🚀 Key Features
- 🌐 Selenium: Automated web interactions for metadata extraction.
- ⚙️ Dask: Distributed computing to manage large datasets.
- 🚀 Numba: JIT compilation for accelerating numerical computations.
- 📊 Xarray: Multi-dimensional array data handling for seamless integration.
📚 Supported Datasets
MapMiner supports a variety of geospatial datasets across multiple categories:
| Category | Datasets |
|---|---|
| 🌍 Satellite | Sentinel-2, Sentinel-1, MODIS, Landsat |
| 🚁 Aerial | NAIP |
| 🗺️ Basemap | Google, ESRI |
| 📍 Vectors | Google Building Footprint, OSM |
| 🏔️ DEM (Digital Elevation Model) | Copernicus DEM 30m, ALOS DEM |
| 🌍 LULC (Land Use Land Cover) | ESRI LULC |
| 🌾 Crop Layer | CDL Crop Mask |
| 🕒 Real-Time | Google Maps Real-Time Traffic |
🧠 Supported Models
MapMiner provides pre-integrated state-of-the-art vision models for geospatial AI:
| Model | Use Cases |
|---|---|
| 🔥 DINOv3 | Feature extraction, classification, segmentation, detection backbones |
| 🌀 NAFNet | Denoising, deblurring, super-resolution, temporal consistency |
| ⏳ ConvLSTM | Crop forecasting, temporal fusion (Sentinel-1/2), sequence modeling |
| 💎 SAM3 | Prompt-based instance segmentation, fast zero-shot object extraction |
🤖 Models
1️⃣ DINOv3 Model
You can import DINOv3 directly for feature extraction or downstream tasks:
from mapminer.models import DINOv3
model = DINOv3(pretrained=True)
x = normalize(input_tensor)
output = model(x)
2️⃣ NAFNet Model
Use NAFNet for denoising, enhancement, or temporal SR tasks:
from mapminer.models import NAFNet
model = NAFNet(in_channels=12, dim=32)
output = model(input_tensor)
3️⃣ SAM3 Model
Use SAM3 for prompt-based instance segmentation on high-resolution geospatial imagery:
from mapminer.models import SAM3
sam3 = SAM3()
df = sam3.inference(ds,text='building', exemplars=None)
⛏️ Miners
1️⃣ GoogleBaseMapMiner
from mapminer.miners import GoogleBaseMapMiner
miner = GoogleBaseMapMiner()
ds = miner.fetch(lat=40.748817, lon=-73.985428, radius=500)
2️⃣ CDLMiner
from mapminer.miners import CDLMiner
miner = CDLMiner()
ds = miner.fetch(lon=-95.665, lat=39.8283, radius=10000, daterange="2024-01-01/2024-01-10")
3️⃣ GoogleBuildingMiner
from mapminer.miners import GoogleBuildingMiner
miner = GoogleBuildingMiner()
ds = miner.fetch(lat=34.052235, lon=-118.243683, radius=1000)
🖼 Visualizing the Data
You can easily visualize the data fetched using hvplot:
import hvplot.xarray
ds.hvplot.image(title=f"Captured on {ds.attrs['metadata']['date']['value']}")📦 Dependencies
MapMiner relies on several Python libraries:
- Selenium: For automated browser control.
- Dask: For distributed computing and handling large data.
- Numba: For accelerating numerical operations.
- Xarray: For handling multi-dimensional array data.
- EasyOCR: For extracting text from images.
- HvPlot: For visualizing xarray data.
🛠 Contributing
Contributions are welcome! Fork the repository and submit pull requests. Include tests for any new features or bug fixes.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mapminer-0.2.0.tar.gz.
File metadata
- Download URL: mapminer-0.2.0.tar.gz
- Upload date:
- Size: 49.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
54a394a701f5b7f787fb436521bbf529651ba18dda32d7f555b830c11f8c2feb
|
|
| MD5 |
9ee399f2af80bf3d895efc8f98b3e30a
|
|
| BLAKE2b-256 |
b19f9c4c18dd5d1c460fcbb1e136791d47497c90fd2e19866e72eb00bc4fb72f
|
File details
Details for the file mapminer-0.2.0-py3-none-any.whl.
File metadata
- Download URL: mapminer-0.2.0-py3-none-any.whl
- Upload date:
- Size: 61.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
97ddcf1e6545cbba95edf24dbe94c084225e020d0ec8ac88ecc1bff60ce281b9
|
|
| MD5 |
8108d1dbd3d60c3761734e528748cf94
|
|
| BLAKE2b-256 |
c97193b9b89e419f6f2e46c6715ef868a9cf96e2971a1057b4d9ee7f4e135097
|
