GeoCamPal is a modular, GUI‑driven toolkit for image‑processing and geomatics. From HSV‑based feature extraction to homography‑assisted georeferencing and DEM creation.
| Module | What it does |
|---|---|
| Feature Identifier | HSV masking + manual polygon editing for feature identification and export |
| Pixel → GCP Converter | Pick Ground‑Control Points (GCPs) in imagery and export pixel‑to‑world mappings. |
| Homography Matrix Creator | Derive homography matrices (RANSAC & optional simulated‑annealing subset selection). |
| Georeferencing Tool | Batch‑warp oblique images into spatial reference systems with secondary AOI cropping. |
| DEM Generator | Fuse shorelines and water‑level data into daily DEM rasters (with optional XYZ export). |
| Raw Timestacker | Build calibrated timestack images from video/photo bursts. |
| Wave Run‑Up Calculator | Extract run‑up contours and generate distance‑time plots or CSV outputs. |
Grab the latest release for Windows from the Releases page and run GeoCamPal.exe. No Python environment required but available through main.py.
# clone the repo
$ git clone https://github.com/capt-clay10/GeoCamPal.git && cd GeoCamPal
# create (optional) venv & install deps
$ python -m venv .venv && source .venv/bin/activate
$ pip install -r requirements.txt
# launch the GUI
$ python main.pyGeoCamPal targets Python 3.8 or newer.
1. Launch the application → select the desired module from the launcher window.
2. Follow the left‑to‑right workflow inside each module (input → configure → run → export).
3. For help, hover tooltips or check the status console at the bottom of every window.
The central hub: click any card to open the corresponding tool in a new window.
Input: A folder of GCP_XX_cam*.jpg images and a CSV of GCP lat/longs.
Output: CSV mapping Pixel_X Pixel_Y ↔ Real_X Real_Y (optionally converted to UTM).
- Compute 3 × 3 homography matrices with RANSAC.
- Advanced mode: simulated‑annealing search to select the optimal GCP subset.
- Batch‑warp images using the previously computed homography.
- Secondary AOI cropping & on‑the‑fly previews.
Automatic HSV masking + manual editing.
| Mode | Use Case |
|---|---|
| Individual | Tweak HSV sliders on a single image. |
| Machine Learning | Step through a folder, export masks/edges as COCO. |
| Batch | Fire‑and‑forget detection across a directory. |
Creates DEM rasters from shoreline GeoJSONs (exported from feature identifier tool) and water‑level data, with optional XYZ export and batch mode support.
Generate distance‑time timestack PNGs from image bursts or video frames. Includes ROI selector, resolution tagging, and batch processing. Feed time stack in the Feature identifier tool to identify the wave runup line, currently limited to HSV based or manual Overlay the binary mask (exported from feature identifier tool), extract the run‑up contour, and export (time, distance) CSVs.
Contributions, bug reports, and feature requests are welcome! Please open an issue or pull request. If youʼre new to the project, start with the open good first issues.
GeoCamPal is distributed under the MIT License — see the LICENSE file for details.
This software is provided as is. Always validate results before using them in critical analyses.