seerep-grpc

spatio-temporal-SEmantic Environment REPresentation for robots in an agricultural context

https://github.com/dfki-ni/seerep

Science Score: 52.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
    Organization dfki-ni has institutional domain (www.dfki.de)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.7%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

spatio-temporal-SEmantic Environment REPresentation for robots in an agricultural context

Basic Info
Statistics
  • Stars: 18
  • Watchers: 6
  • Forks: 3
  • Open Issues: 51
  • Releases: 23
Created almost 5 years ago · Last pushed 8 months ago
Metadata Files
Readme License Citation

README.md

Redoc logo

Spatio-Temporal-Semantic Sensor Data Management
for Agricultural Robotics

[![catkin build workflow](https://github.com/DFKI-NI/seerep/actions/workflows/main.yml/badge.svg)](https://github.com/DFKI-NI/seerep/actions) ![unstable](https://img.shields.io/badge/Stability-experimental-orange) [![License](https://img.shields.io/badge/License-BSD_3-brightgreen)](./LICENSE) Documentation | Examples

Table of Contents

🎯 Features

  • Robotic sensor data management integrated with ROS.
  • Creation of sub-datasets based on sub-symbolic information (positions, timestamps) and their corresponding symbolic (semantic) information.
  • Automated generation and evaluation (e.g neural network predictions) of datasets.
  • GDPR filtering of datasets (e.g excluding public roads) based on spatial polygon queries.

:muscle: Motivation

A key transition in robotics involves the adoption of data-driven approaches. As a result, increasing amounts of data are being captured by high-resolution sensors such as cameras and LiDAR. With ROS, the typical workflow involves recording rosbags during missions and uploading the resulting files to network or blob storage, organized according to use-case specific hierarchies. Later retrieval of data with specific properties, such as particular weather conditions or a specific area of interest, is non-trivial. The relevant data must be downloaded to open the rosbag where access to the data is only provided through the time modality.

In contrast, SEEREP offers an integrated solution for managing robotic sensor data and generating sub-datasets based on spatial, temporal, or semantic queries. Simplifying the workflow to uploading the sensor data post-mission and offering a gRPC-based query interface for subsequent applications.

🚀 Getting Started

The simplest way to start SEEREP is by using docker compose with the configuration provided in the docker/server directory:

bash git clone https://github.com/DFKI-NI/seerep.git cd seerep/docker/server docker compose up

Which should produce an output like this:

bash seerep_server | [2024-07-11 13:40:00.853800]<info>: Initialized logging seerep_server | [2024-07-11 13:40:00.860308]<info>: The used logging folder is: /mnt/seerep_data/log/ seerep_server | [2024-07-11 13:40:00.860730]<info>: Current timezone: CET seerep_server | [2024-07-11 13:40:00.861233]<info>: SEEREP version: N/A seerep_server | [2024-07-11 13:40:00.861567]<info>: The used data folder is: /mnt/seerep_data/ seerep_server | [2024-07-11 13:40:00.865541]<info>: Addded Protocol Buffers gRPC-services seerep_server | [2024-07-11 13:40:00.867241]<info>: Added Flatbuffers gRPC services seerep_server | [2024-07-11 13:40:00.903333]<info>: Serving gRPC Server on "[::]:9090"

For other ways to deploy SEEREP, check the documentation.

Refer to the examples section for instructions on uploading data.

:wrench: Maintainer

Mark Niemeyer
mark.niemeyer@dfki.de

German Research Center for Artificial Intelligence
DFKI Niedersachsen
Plan-Based Robot Control

:memo: Related Publications

```bibtex @inproceedings{Niemeyer2024, author = {Niemeyer, Mark and Arkenau, Julian and Pütz, Sebastian and Hertzberg, Joachim}, title = {Streamlined Acquisition of Large Sensor Data for Autonomous Mobile Robots to Enable Efficient Creation and Analysis of Datasets }, booktitle = {2024 IEEE International Conference on Robotics and Automation (ICRA)}, year = {2024}, publisher = {IEEE} }

@inproceedings{Niemeyer2023, author = {Niemeyer, Mark and Renz, Marian and Hertzberg, Joachim}, title = {Object Anchoring for Autonomous Robots using the Spatio-Temporal-Semantic Environment Representation SEEREP}, booktitle = {KI 2023. German Conference on Artificial Intelligence (KI-2023)}, year = {2023}, publisher = {Springer} }

@inproceedings{Niemeyer2022, author = {Niemeyer, Mark and Pütz, Sebastian and Hertzberg, Joachim}, title = {A Spatio-Temporal-Semantic Environment Representation for Autonomous Mobile Robots equipped with various Sensor Systems}, booktitle = {2022 IEEE International Conference on Multisensor Fusion and Integration for Intelligent Systems (MFI)}, year = {2022}, publisher = {IEEE} } ```

📄 License

This project is open-sourced software licensed under the BSD 3-Clause license.

Owner

  • Name: DFKI Niedersachsen
  • Login: DFKI-NI
  • Kind: organization
  • Location: Germany

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Niemeyer"
  given-names: "Mark"
title: "SEEREP: a spatio-temporal-SEmantic Environment REPresentation"
url: "https://github.com/DFKI-NI/seerep"
preferred-citation:
  type: conference-paper
  authors:
  - family-names: "Niemeyer"
    given-names: "Mark"
  - family-names: "Pütz"
    given-names: "Sebastian"
  - family-names: "Hertzberg"
    given-names: "Joachim"
  title: "A Spatio-Temporal-Semantic Environment Representation for Autonomous Mobile Robots equipped with various Sensor Systems"
  conference:
    name: "IEEE International Conference on Multisensor Fusion and Integration for Intelligent Systems"
  collection-title: "2022 IEEE International Conference on Multisensor Fusion and Integration for Intelligent Systems, September 20-22, 2022"
  publisher: "IEEE"
  month: 9
  year: 2022

GitHub Events

Total
  • Release event: 1
  • Watch event: 1
  • Delete event: 2
  • Member event: 2
  • Push event: 19
  • Pull request event: 6
  • Create event: 5
Last Year
  • Release event: 1
  • Watch event: 1
  • Delete event: 2
  • Member event: 2
  • Push event: 19
  • Pull request event: 6
  • Create event: 5

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 0
  • Total pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: 4 days
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: 4 days
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • Mark-Niemeyer (3)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 31 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 20
  • Total maintainers: 2
pypi.org: seerep-grpc

Package for the SEEREP gRPC API

  • Versions: 20
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 31 Last month
Rankings
Dependent packages count: 6.6%
Stargazers count: 17.2%
Average: 18.9%
Forks count: 19.6%
Downloads: 20.6%
Dependent repos count: 30.6%
Maintainers (2)
Last synced: 7 months ago

Dependencies

.github/workflows/build-docs.yml actions
  • actions/checkout v3 composite
  • peaceiris/actions-gh-pages v3 composite
.github/workflows/buildDocker.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v3 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
.github/workflows/gitlab-sync.yml actions
  • actions/checkout v3 composite
  • wangchucheng/git-repo-sync v0.1.0 composite
.github/workflows/main.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v3 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
  • tj-actions/changed-files v34 composite
.github/workflows/test.yml actions
  • actions/checkout v3 composite
docker/base/Dockerfile docker
  • ros noetic build
docker/docker-compose.yml docker
  • ghcr.io/agri-gaia/seerep_server latest
docker/server/Dockerfile docker
  • $IMAGEBASE $IMAGEBASETAG build
docker/base/requirements.txt pypi
  • build ==0.10.0
  • flatbuffers ==22.12.6
  • grpcio ==1.53.0
  • grpcio-tools ==1.51.1
  • imageio ==2.20.0
  • matplotlib ==3.6.3
  • mkdocs ==1.4.2
  • mkdocs-material ==9.0.2
  • numpy ==1.22.0
  • numpy-quaternion ==2022.4.2
  • pre-commit ==2.21.0
  • protobuf ==4.21.12
  • setuptools ==65.7.0
  • twine ==4.0.2
pyproject.toml pypi
  • flatbuffers == 22.12.6
  • grpcio == 1.51.1
  • protobuf == 4.21.12
setup.py pypi