# Bird Cloud GNN
[![github repo badge](https://img.shields.io/badge/github-repo-000.svg?logo=github&labelColor=gray&color=blue)](https://github.com/point-cloud-radar/bird-cloud-gnn)
[![github license badge](https://img.shields.io/github/license/point-cloud-radar/bird-cloud-gnn)](https://github.com/point-cloud-radar/bird-cloud-gnn)
[![RSD]( https://img.shields.io/badge/rsd-bird_cloud_gnn-blue)](https://research-software-directory.org/projects/bird-movements-with-meteorological-radar)
[![fair-software badge](https://img.shields.io/badge/fair--software.eu-%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8B-yellow)](https://fair-software.eu)
[![workflow scq badge](https://sonarcloud.io/api/project_badges/measure?project=point-cloud-radar_bird-cloud-gnn&metric=alert_status)](https://sonarcloud.io/dashboard?id=point-cloud-radar_bird-cloud-gnn)
[![workflow scc badge](https://sonarcloud.io/api/project_badges/measure?project=point-cloud-radar_bird-cloud-gnn&metric=coverage)](https://sonarcloud.io/dashboard?id=point-cloud-radar_bird-cloud-gnn)
[![read the docs badge](https://readthedocs.org/projects/bird-cloud-gnn/badge/?version=latest)](https://bird-cloud-gnn.readthedocs.io/en/latest/?badge=latest)
[![build](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/build.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/build.yml)
[![cffconvert](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/cffconvert.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/cffconvert.yml)
[![sonarcloud](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/sonarcloud.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/sonarcloud.yml)
[![markdown-link-check](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/markdown-link-check.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/markdown-link-check.yml)
<!-- [![DOI](https://zenodo.org/badge/500818250.svg)](https://zenodo.org/badge/latestdoi/500818250) -->
<!-- [![docker hub badge](https://img.shields.io/static/v1?label=Docker%20Hub&message=mexca&color=blue&style=flat&logo=docker)](https://hub.docker.com/u/mexca) -->
<!-- [![docker build badge](https://img.shields.io/github/actions/workflow/status/mexca/mexca/docker.yml?label=Docker%20build&logo=docker)](https://github.com/mexca/mexca/actions/workflows/docker.yml) -->
[![black code style badge](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
## Synopsis
This software produces a graph representation derived from point cloud data, which is then used as input for a Graph Neural Network (GNN).This allows to increase the amount of data by the factor of 1000.
## Code example
## Motivation
In scenarios where labeled data is limited, there's a pressing need to expand the dataset effectively. One effective strategy involves altering the data's representation. In this context, we adopted such an approach by acquiring a graph representation from point cloud data. Depending on the chosen parameters, this transformation can augment the dataset by a factor of up to 1000. Subsequently, this graph representation is harnessed as input for Graph Neural Networks (GNNs). GNNs are highly sought after due to their innate ability to adeptly capture and leverage the inherent properties of graph-structured data. They excel in modeling intricate network relationships, autonomously acquiring informative features, and facilitating effective knowledge transfer.
## Installation
To install bird_cloud_gnn from GitHub repository, do:
```console
git clone https://github.com/point-cloud-radar/bird-cloud-gnn.git
cd bird-cloud-gnn
python3 -m pip install .
```
## Documentation
The documentation can be found on [Read the Docs](https://bird-cloud-gnn.readthedocs.io/en/latest/index.html).
## Contributing
If you want to contribute to the development of bird_cloud_gnn,
have a look at the [contribution guidelines](CONTRIBUTING.md).
## Credits
This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [NLeSC/python-template](https://github.com/NLeSC/python-template).
Raw data
{
"_id": null,
"home_page": "https://github.com/point-cloud-radar/bird-cloud-gnn",
"name": "bird-cloud-gnn",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "graph neural network,point cloud,bird identification",
"author": "Olga Lyashevska",
"author_email": "o.lyashevska@esciencecenter.nl",
"download_url": "https://files.pythonhosted.org/packages/19/54/33b377866ecbe26dce0011ab204ac67573bd25f91ee62b1f2189168a6876/bird_cloud_gnn-0.1.0.tar.gz",
"platform": null,
"description": "# Bird Cloud GNN\n\n[![github repo badge](https://img.shields.io/badge/github-repo-000.svg?logo=github&labelColor=gray&color=blue)](https://github.com/point-cloud-radar/bird-cloud-gnn)\n[![github license badge](https://img.shields.io/github/license/point-cloud-radar/bird-cloud-gnn)](https://github.com/point-cloud-radar/bird-cloud-gnn)\n[![RSD]( https://img.shields.io/badge/rsd-bird_cloud_gnn-blue)](https://research-software-directory.org/projects/bird-movements-with-meteorological-radar)\n[![fair-software badge](https://img.shields.io/badge/fair--software.eu-%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8F%20%20%E2%97%8B-yellow)](https://fair-software.eu)\n[![workflow scq badge](https://sonarcloud.io/api/project_badges/measure?project=point-cloud-radar_bird-cloud-gnn&metric=alert_status)](https://sonarcloud.io/dashboard?id=point-cloud-radar_bird-cloud-gnn)\n[![workflow scc badge](https://sonarcloud.io/api/project_badges/measure?project=point-cloud-radar_bird-cloud-gnn&metric=coverage)](https://sonarcloud.io/dashboard?id=point-cloud-radar_bird-cloud-gnn)\n[![read the docs badge](https://readthedocs.org/projects/bird-cloud-gnn/badge/?version=latest)](https://bird-cloud-gnn.readthedocs.io/en/latest/?badge=latest)\n[![build](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/build.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/build.yml)\n[![cffconvert](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/cffconvert.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/cffconvert.yml)\n[![sonarcloud](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/sonarcloud.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/sonarcloud.yml)\n[![markdown-link-check](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/markdown-link-check.yml/badge.svg)](https://github.com/point-cloud-radar/bird-cloud-gnn/actions/workflows/markdown-link-check.yml)\n\n\n\n<!-- [![DOI](https://zenodo.org/badge/500818250.svg)](https://zenodo.org/badge/latestdoi/500818250) -->\n<!-- [![docker hub badge](https://img.shields.io/static/v1?label=Docker%20Hub&message=mexca&color=blue&style=flat&logo=docker)](https://hub.docker.com/u/mexca) -->\n<!-- [![docker build badge](https://img.shields.io/github/actions/workflow/status/mexca/mexca/docker.yml?label=Docker%20build&logo=docker)](https://github.com/mexca/mexca/actions/workflows/docker.yml) -->\n[![black code style badge](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n## Synopsis\n\nThis software produces a graph representation derived from point cloud data, which is then used as input for a Graph Neural Network (GNN).This allows to increase the amount of data by the factor of 1000.\n\n## Code example\n\n## Motivation\nIn scenarios where labeled data is limited, there's a pressing need to expand the dataset effectively. One effective strategy involves altering the data's representation. In this context, we adopted such an approach by acquiring a graph representation from point cloud data. Depending on the chosen parameters, this transformation can augment the dataset by a factor of up to 1000. Subsequently, this graph representation is harnessed as input for Graph Neural Networks (GNNs). GNNs are highly sought after due to their innate ability to adeptly capture and leverage the inherent properties of graph-structured data. They excel in modeling intricate network relationships, autonomously acquiring informative features, and facilitating effective knowledge transfer.\n\n## Installation\n\nTo install bird_cloud_gnn from GitHub repository, do:\n\n```console\ngit clone https://github.com/point-cloud-radar/bird-cloud-gnn.git\ncd bird-cloud-gnn\npython3 -m pip install .\n```\n\n## Documentation\n\nThe documentation can be found on [Read the Docs](https://bird-cloud-gnn.readthedocs.io/en/latest/index.html).\n\n## Contributing\n\nIf you want to contribute to the development of bird_cloud_gnn,\nhave a look at the [contribution guidelines](CONTRIBUTING.md).\n\n## Credits\n\nThis package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [NLeSC/python-template](https://github.com/NLeSC/python-template).\n",
"bugtrack_url": null,
"license": "",
"summary": "Graph Neural Network for bird point cloud data",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/point-cloud-radar/bird-cloud-gnn/issues",
"Homepage": "https://github.com/point-cloud-radar/bird-cloud-gnn"
},
"split_keywords": [
"graph neural network",
"point cloud",
"bird identification"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "06fb78b07bda6ea11477c234d5833fdd804d9becdd7326548eaab2d860aa0f1c",
"md5": "32b3cd32cae2c0dfa69a0bdf82a78c34",
"sha256": "930b2da941fd1cb514d224c54d5b257892714ecaba0172605200e74154e3f645"
},
"downloads": -1,
"filename": "bird_cloud_gnn-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "32b3cd32cae2c0dfa69a0bdf82a78c34",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 20482,
"upload_time": "2023-11-28T15:21:08",
"upload_time_iso_8601": "2023-11-28T15:21:08.683726Z",
"url": "https://files.pythonhosted.org/packages/06/fb/78b07bda6ea11477c234d5833fdd804d9becdd7326548eaab2d860aa0f1c/bird_cloud_gnn-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "195433b377866ecbe26dce0011ab204ac67573bd25f91ee62b1f2189168a6876",
"md5": "dd2b61eadac6c9d79fac226d283592d5",
"sha256": "ef72190558bf1fe7ef1e13e4a447a9a3f42fa99e85861e623691abb7f0c11d56"
},
"downloads": -1,
"filename": "bird_cloud_gnn-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "dd2b61eadac6c9d79fac226d283592d5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 24538,
"upload_time": "2023-11-28T15:21:10",
"upload_time_iso_8601": "2023-11-28T15:21:10.807552Z",
"url": "https://files.pythonhosted.org/packages/19/54/33b377866ecbe26dce0011ab204ac67573bd25f91ee62b1f2189168a6876/bird_cloud_gnn-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-28 15:21:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "point-cloud-radar",
"github_project": "bird-cloud-gnn",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bird-cloud-gnn"
}