OpenSourceFellows / OpenSourceFellows/map_dashboard_hackathon

Epic Feature - HydroLAKES

Open
#47 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

California Tribal GIS Hackathon Intermediate
Dominant language
HTML
Stars
2
Forks
11
PR merge metrics
No merged PRs in 30d

Description

Epic issue created with ChatGPT models' help

Description

Add HydroLAKES polygon and pour point datasets into the repository by converting the provided HydroLAKES GIS datasets into valid GeoJSON format.

HydroLAKES contains global lake polygon and pour point datasets across multiple levels of granularity. This epic tracks the work required to convert and upload the data files into the repository fixtures folder.

The converted GeoJSON files will allow the existing map setup to consume and render HydroLAKES data layers directly from static fixture data.


Goals

  • Convert all targeted GIS datasets into valid GeoJSON format
  • Upload GeoJSON files into the repository fixtures folder
  • Ensure datasets remain readable and render correctly in the existing map setup

Implementation Instructions

  • Download the HydroLAKES geodatabase OR shapefile datasets from the official HydroSHEDS source

  • Convert GIS datasets into valid .geojson format

  • Contributors may use standard GIS conversion workflows/tools including:

    • GDAL/OGR
    • QGIS
    • Mapshaper
    • MyGeoData
    • Geoutil
    • or similar lightweight GIS conversion workflows
  • Upload converted files into:

public/fixtures/

Repo path:

https://github.com/OpenSourceFellows/map_dashboard_hackathon/tree/main/public/fixtures
  • Verify GeoJSON validity before submitting PRs
  • Verify datasets render correctly in the existing map setup

Optional lightweight cleanup improvements:

  • Remove unnecessary properties
  • Reduce file size if datasets become extremely large
  • Preserve polygon geometry accuracy during conversion

Expected Functionalities

GeoJSON Dataset Conversion
  • Each HydroLAKES polygon dataset converts successfully into valid GeoJSON
  • Polygon geometry and important attributes remain intact after conversion
Repository Integration
  • GeoJSON files are uploaded into the fixtures folder
  • Existing map setup can load and render the datasets correctly

Notes

  • This epic is intended for hackathon-friendly contributions
  • Contributors do not need frontend UI changes
  • Contributors only need to focus on dataset conversion/upload tasks
  • Static GeoJSON fixtures are acceptable for this phase of development

Resources

  1. HydroLAKES Product Page

  2. HydroBASINS Technical Documentation PDF

  3. map_dashboard_hackathon fixtures folder

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the HydroLAKES product page and the existing map setup, then inspect public/fixtures/ to identify the dataset naming and loading conventions. Convert the targeted HydroLAKES polygon and pour point datasets into valid GeoJSON and place them in public/fixtures/. Done means the files retain important geometry and attributes, pass GeoJSON validation, and render correctly in the existing map setup.

Written by the indexing model from the issue text.

Assessment

Domain
data
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.