Bellande Adaptive Step Size dynamically adjusts movement increments for optimal robotic path planning and navigation
Go to file
2024-11-21 15:36:42 -05:00
configs latest pushes 2024-11-21 15:36:42 -05:00
git_scripts latest pushes 2024-11-21 15:36:42 -05:00
Package/python latest pushes 2024-11-21 15:36:42 -05:00
LICENSE latest pushes 2024-11-21 15:36:42 -05:00
README.md latest pushes 2024-11-21 15:36:42 -05:00
run_api.bellos latest pushes 2024-11-21 15:36:42 -05:00
run_api.sh latest pushes 2024-11-21 15:36:42 -05:00

📦 Bellande Limit

Demo GIF

Preprint

  • Preprint

Preprint Citation

Bellande, R. (2024). Efficient Step Function for Infinite Multi-Dimensional Node Calculation within Model-Integrated Dimensional Space [version 1] [preprint]. Mathematics.

🧙 Organization Website

  • Organization Website

🧙 Organization Github

  • Organization Github

Author, Creator and Maintainer

  • Ronaldson Bellande

Bellande Limit Executables & Models

  • Bellande Limit Models & Executables

API HTTP Usability (BELLANDE FORMAT)

# Copyright (C) 2024 Bellande Robotics Sensors Research Innovation Center, Ronaldson Bellande
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.

# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.
# GNU General Public License v3.0 or later

url: https://bellande-robotics-sensors-research-innovation-center.org

endpoint_path:
    bellande_limit: /api/Bellande_Limit/bellande_limit

Bellande_Framework_Access_Key: bellande_web_api_opensource

API HTTP Usability (JSON FORMAT)

{
  "license": [
    "Copyright (C) 2024 Bellande Robotics Sensors Research Innovation Center, Ronaldson Bellande",
    "This program is free software: you can redistribute it and/or modify",
    "it under the terms of the GNU General Public License as published by",
    "the Free Software Foundation, either version 3 of the License, or",
    "(at your option) any later version.",
    "",
    "This program is distributed in the hope that it will be useful,",
    "but WITHOUT ANY WARRANTY; without even the implied warranty of",
    "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the",
    "GNU General Public License for more details.",
    "",
    "You should have received a copy of the GNU General Public License",
    "along with this program.  If not, see <https://www.gnu.org/licenses/>.",
    "GNU General Public License v3.0 or later"
  ],
  "url": "https://bellande-robotics-sensors-research-innovation-center.org",
  "endpoint_path": {
    "bellande_limit": "/api/Bellande_Limit/bellande_limit"
  },
  "Bellande_Framework_Access_Key": "bellande_web_api_opensource"
}

API Payload Example

{
    "node0": [0, 0, 0],
    "node1": [100, 100, 100],
    "goal": [200, 200, 200],
    "search_radius": 50,
    "sample_points": 20,
    "auth": {
      "authorization_key": "bellande_web_api_opensource"
    }
}

🧙 Website Bellande API Testing

  • Website API Testing

Quick Bellande API Testing

curl -X 'POST' \
  'https://bellande-robotics-sensors-research-innovation-center.org/api/Bellande_Limit/bellande_limit' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "node0": [0, 0, 0],
    "node1": [100, 100, 100],
    "goal": [100, 100, 100],
    "search_radius": 50,
    "sample_points": 20,
    "auth": {
      "authorization_key": "bellande_web_api_opensource"
    }
  }'

BS(Bellande Step) Algorithm API

Experiment 1 -- Limit = 1

2D Figure 2D 3D Figure 3D 4D Figure 4D
5D Figure 5D 6D Figure 6D 7D Figure 7D
8D Figure 8D 9D Figure 9D 10D Figure 10D

Experiment 2 -- Limit = 25

2D Figure 2D 3D Figure 3D 4D Figure 4D
5D Figure 5D 6D Figure 6D 7D Figure 7D
8D Figure 8D 9D Figure 9D 10D Figure 10D

Experiment 3 -- Limit = 50

2D Figure 2D 3D Figure 3D 4D Figure 4D
5D Figure 5D 6D Figure 6D 7D Figure 7D
8D Figure 8D 9D Figure 9D 10D Figure 10D

Experiment 4 -- Limit = 75

2D Figure 2D 3D Figure 3D 4D Figure 4D
5D Figure 5D 6D Figure 6D 7D Figure 7D
8D Figure 8D 9D Figure 9D 10D Figure 10D

Experiment 5 -- Limit = 100

2D Figure 2D 3D Figure 3D 4D Figure 4D
5D Figure 5D 6D Figure 6D 7D Figure 7D
8D Figure 8D 9D Figure 9D 10D Figure 10D

Check Out Research Organization for open-source/semi-open-source API

Package via Executable

  • Infinite Space
bellande_step "[0, 0, 0]" "[100, 100, 100]" 75 3

API in api_docs

  • 2D Space
  • 3D Space
  • 4D Space
  • 5D Space
  • 6D Space
  • 7D Space
  • 8D Space
  • 9D Space
  • 10D Space

Can also checkout portion of the docs at Portion API DOCS

✔️ confirmed versions

  • The step function efficiently computes the next step towards a target node within a specified distance limit.

Usage 2D Space

Suppose you have two nodes representing positions in a 2D space:

  • node0 at coordinates (0, 0)
  • node1 at coordinates (5, 5)

You want to compute the next step from node0 towards node1 while limiting the maximum distance to 3 units.

# Define Import 
from bellande_step.bellande_step_2d import bellande_step_2d

# Define the nodes
node0 = Node2D(0, 0)
node1 = Node2D(5, 5)

# Compute the next step within a distance limit of 3 units
next_step = bellande_step_2d(node0, node1, limit=3)

# Output the coordinates of the next step
print("Next Step Coordinates:", next_step.coord) 

Usage 3D Space

Suppose you have two nodes representing positions in a 3D space:

  • node0 at coordinates (0, 0, 0)
  • node1 at coordinates (5, 5, 5)

You want to compute the next step from node0 towards node1 while limiting the maximum distance to 3 units.

# Define Import 
from bellande_step.bellande_step_3d import bellande_step_3d

# Define the nodes
node0 = Node3D(0, 0, 0)
node1 = Node3D(5, 5, 5)

# Compute the next step within a distance limit of 3 units
next_step = bellande_step_3d(node0, node1, limit=3)

# Output the coordinates of the next step
print("Next Step Coordinates:", next_step.coord)

Avaliable

  • 2D Space
  • 3D Space
  • 4D Space
  • 5D Space
  • 6D Space
  • 7D Space
  • 8D Space
  • 9D Space
  • 10D Space

Website PYPI

Installation

  • $ pip install bellande_limit

Upgrade (if not upgraded)

  • $ pip install --upgrade bellande_limit
Name: bellande_limit
Version: 0.3.0
Summary: Computes the next step towards a target node
Home-page: github.com/RonaldsonBellande/bellande_robot_step
Author: Ronaldson Bellande
Author-email: ronaldsonbellande@gmail.com
License: GNU General Public License v3.0

Published Paper

Coming Soon

Preprint

  • Preprint

License

This Algorithm or Models is distributed under the Creative Commons Attribution-ShareAlike 4.0 International License, see LICENSE and NOTICE for more information.