{"id":22756460,"url":"https://github.com/gher-uliege/divapythontools","last_synced_at":"2025-08-16T17:08:17.205Z","repository":{"id":45751949,"uuid":"44103456","full_name":"gher-uliege/DivaPythonTools","owner":"gher-uliege","description":"Interface to run Diva software tool (spatial interpolation).","archived":false,"fork":false,"pushed_at":"2019-03-27T12:46:44.000Z","size":24685,"stargazers_count":21,"open_issues_count":4,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-17T11:48:54.086Z","etag":null,"topics":["data-analysis","diva","finite-elements","interpolation-methods","leaflet-map","matplotlib","ocean-sciences","oceanography","python","variational-method"],"latest_commit_sha":null,"homepage":"","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/gher-uliege.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-10-12T11:35:46.000Z","updated_at":"2024-09-30T02:50:47.000Z","dependencies_parsed_at":"2022-08-31T04:41:50.803Z","dependency_job_id":null,"html_url":"https://github.com/gher-uliege/DivaPythonTools","commit_stats":null,"previous_names":["gher-ulg/divapythontools"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/gher-uliege/DivaPythonTools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gher-uliege%2FDivaPythonTools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gher-uliege%2FDivaPythonTools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gher-uliege%2FDivaPythonTools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gher-uliege%2FDivaPythonTools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gher-uliege","download_url":"https://codeload.github.com/gher-uliege/DivaPythonTools/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gher-uliege%2FDivaPythonTools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270742043,"owners_count":24637504,"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-16T02:00:11.002Z","response_time":91,"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":["data-analysis","diva","finite-elements","interpolation-methods","leaflet-map","matplotlib","ocean-sciences","oceanography","python","variational-method"],"created_at":"2024-12-11T07:13:49.487Z","updated_at":"2025-08-16T17:08:17.184Z","avatar_url":"https://github.com/gher-uliege.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![DOI](https://zenodo.org/badge/44103456.svg)](https://zenodo.org/badge/latestdoi/44103456)\n\n# Diva Python Tools\n\nA set of python modules to help users with\n1. the preparation of the Diva input files: data, contours, parameters;\n2. the execution of the Diva interpolation tool,\n3. the reading of output files (analysis, finite-element mesh),\n4. the input and output plotting.\n\n## Getting started \n\n### Prerequisites\n\nThe [Diva](https://github.com/gher-ulg/diva) interpolation tool has to be installed and compiled on your machine. See the related [documentation](https://github.com/gher-ulg/DIVA/blob/master/README.md#installing) for the installation.\n\n### Installing\n\nClone the package:\n```bash\ngit clone git@github.com:gher-ulg/DivaPythonTools.git\n```\nor download the latest stable [release](https://github.com/gher-ulg/DivaPythonTools/releases).\n\nInside DivaPythonTools directory execute:\n```python\npip install -r requirements.txt\npython setup.py install\n```\n\nAfter this you should use it as:\n```python\nfrom pydiva import pydiva2d, pydiva4d\n```\n\n## Module description\n\nThe main modules are [`pydiva2d`](./pydiva2d.py) and [`pydiva4d`](./pydiva4D.py), which define the classes for the 2D and 4D version of Diva, respectively.\n\n### pydiva2d\n\nThe module defines classes corresponding to the main Diva input (data, parameters, contours) and output files (analysed and error fields, finite-element mesh).\n\n### pydiva4d\n\nThe module defines classes to run the 4D version of Diva.\n\n## Plots\n\nThe figures can be generated with and without the [Basemap](https://github.com/matplotlib/basemap) module (Plot on map projections). \n\nSome examples obtained with mixed-layer depth (MLD) data are shown below. The complete example to generate these plots is inside the Notebooks directory [(run_diva2D_MLD)](./Notebooks/run_diva2D_MLD.ipynb).\n\nThe [Notebooks](./Notebooks) directory contains additional examples showing how to run 2D and 4D cases.\n\n### Data values\nScatter plot showing the data positions and values.    \n![Data](./figures/datapoints.png)\n\n### Contours\nBy default, each sub-contour is displayed in a different color.     \n![Contour](./figures/contours.png)\n\n### Finite-element mesh\nTriangular mesh covering the region of interest.     \n![Mesh](./figures/mesh.png)\n\n### Analysed fields\nPseudo-color plot of the gridded field obtained by the interpolation.     \n![Analysis](./figures/analysis.png)\n\n### Combined information\nData, contours, mesh and analysis on the same figure.     \n![Combined](./figures/AnalysisMeshData.png)\n\n## Acknowledgments\n\n[Diva](https://github.com/gher-ulg/DIVA) developments have benefited from the users' feedback and numerous comments, especially during the editions of the Diva workshops.\n\nThe present module was initiated in the frame of [SeaDataCloud](SeaDataCloud) project.  \n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgher-uliege%2Fdivapythontools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgher-uliege%2Fdivapythontools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgher-uliege%2Fdivapythontools/lists"}