{"id":28717018,"url":"https://github.com/kinverarity1/python-sa-gwdata","last_synced_at":"2025-06-15T03:13:00.927Z","repository":{"id":57457488,"uuid":"161971608","full_name":"kinverarity1/python-sa-gwdata","owner":"kinverarity1","description":"Python package for the Groundwater Data section of the DEW WaterConnect website","archived":false,"fork":false,"pushed_at":"2024-12-04T01:23:48.000Z","size":15800,"stargazers_count":3,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-23T20:09:34.887Z","etag":null,"topics":["data-access","groundwater","python","south-australia"],"latest_commit_sha":null,"homepage":"https://python-sa-gwdata.readthedocs.io/en/latest/index.html","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kinverarity1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2018-12-16T05:42:05.000Z","updated_at":"2024-07-11T04:39:00.000Z","dependencies_parsed_at":"2023-12-01T02:44:15.433Z","dependency_job_id":"1cb038c4-9452-4c0f-9134-5917066d06ec","html_url":"https://github.com/kinverarity1/python-sa-gwdata","commit_stats":{"total_commits":176,"total_committers":9,"mean_commits":"19.555555555555557","dds":"0.36931818181818177","last_synced_commit":"1c9f3c501d34d69185929aa340c773309a5380f7"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/kinverarity1/python-sa-gwdata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinverarity1%2Fpython-sa-gwdata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinverarity1%2Fpython-sa-gwdata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinverarity1%2Fpython-sa-gwdata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinverarity1%2Fpython-sa-gwdata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kinverarity1","download_url":"https://codeload.github.com/kinverarity1/python-sa-gwdata/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinverarity1%2Fpython-sa-gwdata/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259914963,"owners_count":22931333,"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","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":["data-access","groundwater","python","south-australia"],"created_at":"2025-06-15T03:12:48.153Z","updated_at":"2025-06-15T03:13:00.902Z","avatar_url":"https://github.com/kinverarity1.png","language":"Jupyter Notebook","readme":"# python-sa-gwdata\n\n[![License](http://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/kinverarity1/aseg_gdf2/blob/master/LICENSE)\n\nPython code to get groundwater data for South Australia\n\nThis code provides the Python package ``sa_gwdata`` to make it easier to download and access groundwater data from the South Australian Department for Environment and Water's [Groundwater Data website](https://www.waterconnect.sa.gov.au/Systems/GD/Pages/Default.aspx). It also provides some help for getting related data from the Department for Energy and Mining's [South Australian Resources Information Gateway (SARIG) website](https://minerals.sarig.sa.gov.au/QuickSearch.aspx).\n\nThis is an unofficial side-project done in my spare time.\n\n## How to use\n\nCheck out the [complete package documentation](https://python-sa-gwdata.readthedocs.io/en/latest/index.html), and\nsome tutorial Jupyter Notebooks in the [notebooks](notebooks) folder.\n\nDefine the wells you are interested in manually:\n\n```python\n\u003e\u003e\u003e import sa_gwdata\n\u003e\u003e\u003e wells = sa_gwdata.find_wells(\"5928-203 and also ULE 96\")\n\u003e\u003e\u003e wells\n[\"LKW042\", \"ULE096\"]\n```\n\n(It has recognised automatically that [5928-203](https://www.waterconnect.sa.gov.au/Systems/GD/Pages/Details.aspx?DHNO=7207\u0026PN=1421712654109#Summary) is also known as LKW042).\n\nOr search for wells by geographic area:\n\n```python\n\u003e\u003e\u003e wells = sa_gwdata.find_wells_in_lat_lon([-34.65, -34.62], [135.47, 135.51])\n```\n\nThen you can download data as pandas DataFrames:\n\n```python\n\u003e\u003e\u003e wls = sa_gwdata.water_levels(wells)\n\u003e\u003e\u003e tds = sa_gwdata.salinities(wells)\n\u003e\u003e\u003e dlogs = sa_gwdata.drillers_logs(wells)\n```\n\nThere is also full access to the underlying [set of web services](https://python-sa-gwdata.readthedocs.io/en/latest/webservices.html) which provide a variety of data in JSON format.\n\nStart a session with Groundwater Data:\n\n```python\n\u003e\u003e\u003e session = sa_gwdata.WaterConnectSession()\n```\n\nOn initialisation it downloads some summary information.\n\n```python\n\u003e\u003e\u003e session.networks\n{'ANGBRM': 'Angas Bremer PWA',\n 'AW_NP': 'Alinytjara Wilurara Non-Prescribed Area',\n 'BAROOTA': 'Baroota PWRA',\n 'BAROSSA': 'Barossa PWRA',\n 'BAROSS_IRR': 'Barossa irrigation wells salinity monitoring',\n 'BERI_REN': 'Berri and Renmark Irrigation Areas',\n 'BOT_GDNS': 'Botanic Gardens wetlands',\n 'CENT_ADEL': 'Central Adelaide PWA',\n 'CHOWILLA': 'Chowilla Floodplain',\n ...\n}\n```\n\nWith this information we can make some direct REST calls:\n\n```python\n\u003e\u003e\u003e r = session.get(\"GetObswellNetworkData\", params={\"Network\": \"CENT_ADEL\"})\n\u003e\u003e\u003e r.df.head(5)\n```\n\n```\n\taq_mon\tchem\tclass\tdhno\tdrill_date\tlat\tlatest_open_date\tlatest_open_depth\tlatest_sal_date\tlatest_swl_date\t...\tpwa\treplaceunitnum\tsal\tsalstatus\tstat_desc\tswl\tswlstatus\ttds\twater\tyield\n0\tTomw(T2)\tY\tWW\t27382\t1968-02-07\t-34.764662\t1992-02-20\t225.00\t2013-09-02\t2018-09-18\t...\tCentral Adelaide\tNaN\tY\tC\tOPR\t3.47\tC\t3620.0\tY\t2.00\n1\tQhcks\tN\tWW\t27437\t1963-01-01\t-34.800905\t1963-01-01\t6.40\t1984-02-01\t1986-03-05\t...\tCentral Adelaide\tNaN\tY\tH\tNaN\t5.86\tH\t1121.0\tY\tNaN\n2\tTomw(T1)\tY\tWW\t27443\t1972-04-20\t-34.811124\t2014-04-01\t0.00\t1991-10-09\t2003-07-04\t...\tCentral Adelaide\tNaN\tY\tH\tBKF\tNaN\tH\t2030.0\tY\t5.00\n3\tTomw(T1)\tY\tWW\t27504\t1978-02-28\t-34.779893\t1978-02-28\t144.50\t2016-04-06\t2011-09-18\t...\tCentral Adelaide\tNaN\tY\tH\tOPR\t11.21\tH\t2738.0\tY\t0.00\n4\tTomw(T1)\tY\tWW\t27569\t1975-01-01\t-34.891250\t1975-07-09\t131.10\t1986-11-13\t1988-09-21\t...\tCentral Adelaide\tNaN\tY\tH\tBKF\t9.90\tH\t42070.0\tY\t12.50\n```\n\n## Install\n\nYou will need Python 3.8 or a more recent version.\n\n```bash\n$ pip install -U python-sa-gwdata\n```\n\nThis installs the latest [release](https://github.com/kinverarity1/python-sa-gwdata/releases) of the Python package ``sa_gwdata``.\n\nTo install the latest code from GitHub, make sure you the dependencies ``pandas`` and ``requests`` installed, then use:\n\n```bash\n$ pip install https://github.com/kinverarity1/python-sa-gwdata/archive/master.zip\n```\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkinverarity1%2Fpython-sa-gwdata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkinverarity1%2Fpython-sa-gwdata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkinverarity1%2Fpython-sa-gwdata/lists"}