{"id":30201929,"url":"https://github.com/jameshgrn/based_api","last_synced_at":"2026-05-14T23:36:10.180Z","repository":{"id":258453683,"uuid":"601353601","full_name":"jameshgrn/based_api","owner":"jameshgrn","description":"This is the backend for the BASED streamlit app","archived":false,"fork":false,"pushed_at":"2024-12-14T17:16:16.000Z","size":2837,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-14T17:27:07.507Z","etag":null,"topics":["geomorphology","hydrology","machine-learning","sedimentology","streamlit","xgboost"],"latest_commit_sha":null,"homepage":"https://based-estimator.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jameshgrn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-13T22:14:33.000Z","updated_at":"2024-12-14T17:16:16.000Z","dependencies_parsed_at":"2024-10-22T07:46:46.351Z","dependency_job_id":null,"html_url":"https://github.com/jameshgrn/based_api","commit_stats":null,"previous_names":["jameshgrn/based_api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jameshgrn/based_api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameshgrn%2Fbased_api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameshgrn%2Fbased_api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameshgrn%2Fbased_api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameshgrn%2Fbased_api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jameshgrn","download_url":"https://codeload.github.com/jameshgrn/based_api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameshgrn%2Fbased_api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270228434,"owners_count":24548819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["geomorphology","hydrology","machine-learning","sedimentology","streamlit","xgboost"],"created_at":"2025-08-13T10:52:58.325Z","updated_at":"2026-05-14T23:36:10.175Z","avatar_url":"https://github.com/jameshgrn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BASED: Boost-Assisted Stream Estimator for Depth\n\n[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nBASED is an XGBoost regressor deployed using Streamlit, designed for predicting channel depth using channel width, slope, and discharge.\n\n## Features\n\n- 🌊 Accurate channel depth predictions\n- 🚀 Fast inference using XGBoost\n- 🖥️ User-friendly Streamlit interface\n- 📊 Built-in error benchmarks and validation\n\n## Quick Start\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/JakeGearon/based-api.git\n   cd based-api\n   ```\n\n2. Install dependencies:\n   ```\n   poetry install\n   ```\n\n3. Run the Streamlit app:\n   ```\n   poetry run streamlit run st_app.py\n   ```\n\n4. Input values for slope, discharge, and width to predict channel depth.\n\n## Model Performance\n\n- Mean Absolute Error (MAE): 28 cm\n- Root Mean Square Error (RMSE): 94 cm\n- R-squared (R²): 0.84\n- Mean Absolute Percentage Error (MAPE): 15.6%\n\n![BASED Validation](img/BASED_validation.png)\n\n*Image source: Gearon, J.H. et al. Rules of river avulsion change downstream. Nature 634, 91–95 (2024). https://doi.org/10.1038/s41586-024-07964-2*\n\n## Citation\n\nIf you use BASED in your research, please either cite the paper it came from (above) or the software itself as follows:\n\n```\nGearon, J. (2024). Boost-Assisted Stream Estimator for Depth (BASED) [Computer software]. Version 1.0.0. https://github.com/JakeGearon/based-api\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Contact\n\nJake Gearon - jake.gearon@gmail.com\n\nProject Link: [https://based-estimator.streamlit.app/](https://based-estimator.streamlit.app/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjameshgrn%2Fbased_api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjameshgrn%2Fbased_api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjameshgrn%2Fbased_api/lists"}