OpenSourceFellows / OpenSourceFellows/map_dashboard_hackathon

Add HydroBASINS North America Level 10 polygon data

Open
#38 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

Issue created with ChatGPT models' help

Description

Add HydroBASINS North America Level 10 polygon data into the repository by converting the provided HydroBASINS GIS dataset into valid GeoJSON format.

HydroBASINS contains multiple hierarchical watershed levels (12 total levels), but this issue should only focus on Level 10 polygon data for North America to keep the contribution small and beginner-friendly.

The converted GeoJSON file should then be uploaded into the repository fixtures folder so the existing map setup can consume and render the dataset.


Goals

  • Obtain HydroBASINS North America Level 10 polygon dataset
  • Convert the source GIS data into valid GeoJSON
  • Upload converted GeoJSON into the repo fixtures folder
  • Verify the GeoJSON structure remains valid
  • Keep implementation lightweight and beginner-friendly

Implementation Instructions

Level 10 files: hybas_na_lev10_v1c
  • Ignore the remaining HydroBASINS levels for this issue

  • Convert to valid .geojson format by selecting all geospatial files in the dataset for Level 10:

    • dBase database file (.dbf)

    • Projection file (.prj)

    • Binary spatial index file (.sbn)

    • ESRI spatial index shapefile (.sbx)

    • Shapefile (.shp)

    • Shapefile XML (.shp.xml)

    • File Geodatabase (.gdb)

    • Compiled shapefile (.shx)

    • or other provided GIS formats

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

  • Name the final GeoJSON file:

HydroBASINS Level 10 (North America).geojson
  • Upload the GeoJSON file into:
public/fixtures/

Repo path:

https://github.com/OpenSourceFellows/map_dashboard_hackathon/tree/main/public/fixtures
  • Verify the GeoJSON structure is valid
  • Verify the dataset renders correctly in the existing map setup
  • Keep the dataset limited to North America only

Optional lightweight cleanup improvements:

  • Remove unnecessary attributes/properties
  • Reduce file size if conversion output is extremely large
  • Preserve polygon geometry accuracy during conversion

Expected Functionalities

GeoJSON Conversion
  • HydroBASINS Level 10 polygon data converts successfully into valid GeoJSON
  • Polygon geometry and key properties remain intact after conversion
Repository Integration
  • GeoJSON file is uploaded into the fixtures folder
  • Existing map setup can load and render the dataset

Notes

  • HydroBASINS contains 12 hierarchical levels, but this issue only covers Level 10 polygons
  • Contributors may use any reasonable GIS conversion workflow/tool
  • Keep PR scope small and focused on dataset conversion/upload
  • No frontend UI work is required for this issue
  • Contributors do not need to process all HydroBASINS layers

Acceptance Criteria

  • HydroBASINS North America Level 10 polygon dataset converted to valid GeoJSON
  • GeoJSON file uploaded into public/fixtures/
  • File named HydroBASINS Level 10 (North America).geojson
  • GeoJSON structure is valid and readable
  • Dataset renders correctly in existing map setup
  • PR scope remains small and beginner-friendly

Resources

  1. HydroBASINS Product Page
  2. HydroBASINS Technical Documentation PDF

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 inspecting public/fixtures and the existing map setup, then download the HydroBASINS North America Level 10 source dataset and convert only hybas_na_lev10_v1c to GeoJSON. Done means the file is named HydroBASINS Level 10 (North America).geojson, is valid and readable, is placed in public/fixtures/, and renders in the existing map.

Written by the indexing model from the issue text.

Assessment

Tech stack
json
Domain
data, web-dev
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.