{"id":47739723,"url":"https://github.com/mirohallo/sql-query-vs30-japan","last_synced_at":"2026-04-20T06:06:03.983Z","repository":{"id":348681261,"uuid":"1199347036","full_name":"MiroHallo/sql-query-vs30-japan","owner":"MiroHallo","description":"SQL Query Tool for Vs30 data in Japan","archived":false,"fork":false,"pushed_at":"2026-04-13T17:56:45.000Z","size":78,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T19:29:23.243Z","etag":null,"topics":["japan","python","risk-analysis","seismic-hazard","site-effects","spatial-analysis","sql","sqlite","vs30"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MiroHallo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-02T09:03:50.000Z","updated_at":"2026-04-13T17:56:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/MiroHallo/sql-query-vs30-japan","commit_stats":null,"previous_names":["mirohallo/sql-query-vs30-japan"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/MiroHallo/sql-query-vs30-japan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiroHallo%2Fsql-query-vs30-japan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiroHallo%2Fsql-query-vs30-japan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiroHallo%2Fsql-query-vs30-japan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiroHallo%2Fsql-query-vs30-japan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MiroHallo","download_url":"https://codeload.github.com/MiroHallo/sql-query-vs30-japan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiroHallo%2Fsql-query-vs30-japan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31869050,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"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":["japan","python","risk-analysis","seismic-hazard","site-effects","spatial-analysis","sql","sqlite","vs30"],"created_at":"2026-04-02T23:31:05.202Z","updated_at":"2026-04-20T06:06:03.976Z","avatar_url":"https://github.com/MiroHallo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SQL Query Tool for V\u003csub\u003eS30\u003c/sub\u003e data in Japan\n\nSQL Query Tool for V\u003csub\u003eS30\u003c/sub\u003e for seismic hazard analysis in Japan (derived from J-SHIS)\n\n---\n\nThis tool is intended for the reading and querying the SQLite \ndatabase with a processed subset of the J-SHIS seismic hazard data (National\nResearch Institute for Earth Science and Disaster Resilience, NIED). It is \nspecifically designed as a computational tool for high-performance spatial \nqueries in seismic hazard and risk analysis and site effect modeling.\n\n## 1 TARGET DATABASE\n\n  Hallo, M. (2026). Research Dataset: Optimized Site Parameters Vs30 for Seismic Hazard Analysis in Japan (derived from J-SHIS) (v1.0) [Dataset]. Zenodo. [https://doi.org/10.5281/zenodo.19379171](https://doi.org/10.5281/zenodo.19379171)\n\n## 2 TECHNICAL IMPLEMENTATION\n\n[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)\n\nPython 3, SQLite, SQL engine, Automatic database download, Coordinate-based indexing\n\n*   **Zero-Configuration:** The script automatically resolves the DOI, downloads the latest SQLite database from Zenodo, and stores it locally.\n*   **High-Speed SQL Queries:** Uses an optimized SQLite container with spatial indexing for rapid coordinate-based lookups.\n*   **Geospatial Precision:** Performs automatic UTM projection estimation to calculate exact metric distances (km) between targets and grid points.\n*   **Batch Processing:** Supports automated processing of target locations from text files.\n*   **Professional Output:** Generates clean, fixed-width formatted reports with metadata and provenance tracking.\n\nThe official software version is archived on Zenodo:\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19386410.svg)](https://doi.org/10.5281/zenodo.19386410)\n\n## 3 PACKAGE CONTENT\n\n1. `jshis_sqlite_query.py` - Python script\n2. `example_targets.txt` - Example of input text file with target locations\n3. `requirements.txt` - pip requirements file for instalation of dependencies\n\n## 4 REQUIREMENTS\n\n  Python: Version 3.12 or higher\n  \n  Libraries: pandas, geopandas, sqlalchemy, requests, shapely\n  \n  Install dependencies via pip:\n\n```bash\npip install -r requirements.txt\n```\n\n## 5 USAGE\n\n1. Prepare your `example_targets.txt` input file (longitude-latitude pairs)\n2. Run the tool: `python jshis_sqlite_query.py`\n3. Check `example_results_vs30.txt` for the output V\u003csub\u003eS30\u003c/sub\u003e\n\n## 6 EXAMPLE OUTPUT\n\nThis tool extracts site-specific V\u003csub\u003eS30\u003c/sub\u003e for a set of target Longitude-Latitude \npairs from a SQLite database for Japan. Results are automatically saved to a \nformatted text file.\n```text\n# RESULTS OF VS30 FOR TARGET LOCATIONS\n# Generated on: 2026-04-03 09:42:57.783795\n# Target_Lon Target_Lat Lon Lat Vs30(m/s) AF(-) Dist(km)\n136.9878 36.8520 136.9867 36.8515 194.5 1.8484 0.113\n136.7053 34.4871 136.7047 34.4865 392.5 1.0162 0.091\n136.6515 36.5661 136.6523 36.5661 338.8 1.1520 0.072\n136.2588 35.2675 136.2585 35.2682 184.1 1.9374 0.082\n136.2133 36.0639 136.2148 36.0640 166.8 2.1073 0.136\n```\n\n## 7 COPYRIGHT\n\nCopyright (C) 2026 Kyoto University\n\nThis program is published under the GNU General Public License (GNU GPL).\n\nThis program is free software: you can modify it and/or redistribute it\nor any derivative version under the terms of the GNU General Public\nLicense as published by the Free Software Foundation, either version 3\nof the License, or (at your option) any later version.\n\nThis code is distributed in the hope that it will be useful, but WITHOUT\nANY WARRANTY. We would like to kindly ask you to acknowledge the authors\nand don't remove their names from the code.\n\nYou should have received a copy of the GNU General Public License along\nwith this program. If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\n## 8 CITE AS\n\nIf you use this tools suite, please cite both the original database and the software as follows:\n\n### For the database:\n\u003e Hallo, M. (2026). Research Dataset: Optimized Site Parameters Vs30 for Seismic Hazard Analysis in Japan (derived from J-SHIS) (v1.0) [Dataset]. Zenodo. [https://doi.org/10.5281/zenodo.19379171](https://doi.org/10.5281/zenodo.19379171)\n\n### For the specific software version:\n\u003e Hallo, M. (2026). SQL Query Tool for Vs30 data in Japan (v1.2.3) [Software]. Zenodo. [https://doi.org/10.5281/zenodo.19386410](https://doi.org/10.5281/zenodo.19386410)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirohallo%2Fsql-query-vs30-japan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmirohallo%2Fsql-query-vs30-japan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirohallo%2Fsql-query-vs30-japan/lists"}