bellande_step/README.md

192 lines
7.8 KiB
Markdown
Raw Normal View History

2024-07-23 18:25:26 +00:00
# 📦 Bellande Step (Infinite Dimensions)
2024-06-06 21:02:05 +00:00
2024-06-27 20:46:55 +00:00
# API Usability
```
{
"url": "https://bellanderoboticssensorsresearchinnovationcenter-kot42qxp.b4a.run",
"endpoint_path": {
2024-08-04 04:10:22 +00:00
"bellande_step": "/api/Bellande_Step/bellande_step_nd"
2024-06-27 20:46:55 +00:00
},
"Bellande_Framework_Access_Key": "bellande_web_api_opensource"
}
```
2024-08-04 04:12:33 +00:00
# API Payload Example
```
{
"node0": [0, 0, 0],
"node1": [100, 100, 100],
"limit": 75,
"dimensions": 3,
"auth": {
"authorization_key": "bellande_web_api_opensource"
}
}
```
2024-06-27 20:46:55 +00:00
2024-08-04 05:40:23 +00:00
# Quick API Testing
2024-08-04 05:39:31 +00:00
```
curl -X 'POST' \
'https://bellanderoboticssensorsresearchinnovationcenterwebsite-kot42qxp.b4a.run/api/Bellande_Step/bellande_step_nd' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"node0": [0, 0, 0],
"node1": [100, 100, 100],
"limit": 75,
"dimensions": 3,
"auth": {
"authorization_key": "bellande_web_api_opensource"
}
}'
```
2024-06-27 20:46:55 +00:00
# BS(Bellande Step) Algorithm API
2024-06-06 21:08:31 +00:00
## Experiment 1 -- Limit = 1
2024-06-06 21:02:05 +00:00
2024-06-06 21:06:16 +00:00
| ![2D](graphs_charts/graph_charts_1/2D_Space.png) *Figure 2D* | ![3D](graphs_charts/graph_charts_1/3D_Space.png) *Figure 3D* | ![4D](graphs_charts/graph_charts_1/4D_Space.png) *Figure 4D* |
|:------------------------------------------------------------:|:------------------------------------------------------------:|:------------------------------------------------------------:|
| ![5D](graphs_charts/graph_charts_1/5D_Space.png) *Figure 5D* | ![6D](graphs_charts/graph_charts_1/6D_Space.png) *Figure 6D* | ![7D](graphs_charts/graph_charts_1/7D_Space.png) *Figure 7D* |
| ![8D](graphs_charts/graph_charts_1/8D_Space.png) *Figure 8D* | ![9D](graphs_charts/graph_charts_1/9D_Space.png) *Figure 9D* | ![10D](graphs_charts/graph_charts_1/10D_Space.png) *Figure 10D* |
2024-06-06 21:02:05 +00:00
2024-06-06 21:08:31 +00:00
## Experiment 2 -- Limit = 25
2024-06-06 21:02:05 +00:00
2024-06-06 21:06:16 +00:00
| ![2D](graphs_charts/graph_charts_25/2D_Space.png) *Figure 2D* | ![3D](graphs_charts/graph_charts_25/3D_Space.png) *Figure 3D* | ![4D](graphs_charts/graph_charts_25/4D_Space.png) *Figure 4D* |
|:-------------------------------------------------------------:|:-------------------------------------------------------------:|:-------------------------------------------------------------:|
| ![5D](graphs_charts/graph_charts_25/5D_Space.png) *Figure 5D* | ![6D](graphs_charts/graph_charts_25/6D_Space.png) *Figure 6D* | ![7D](graphs_charts/graph_charts_25/7D_Space.png) *Figure 7D* |
| ![8D](graphs_charts/graph_charts_25/8D_Space.png) *Figure 8D* | ![9D](graphs_charts/graph_charts_25/9D_Space.png) *Figure 9D* | ![10D](graphs_charts/graph_charts_25/10D_Space.png) *Figure 10D* |
2024-06-06 21:02:05 +00:00
2024-06-06 21:08:31 +00:00
## Experiment 3 -- Limit = 50
2024-06-06 21:02:05 +00:00
2024-06-06 21:06:16 +00:00
| ![2D](graphs_charts/graph_charts_50/2D_Space.png) *Figure 2D* | ![3D](graphs_charts/graph_charts_50/3D_Space.png) *Figure 3D* | ![4D](graphs_charts/graph_charts_50/4D_Space.png) *Figure 4D* |
|:-------------------------------------------------------------:|:-------------------------------------------------------------:|:-------------------------------------------------------------:|
| ![5D](graphs_charts/graph_charts_50/5D_Space.png) *Figure 5D* | ![6D](graphs_charts/graph_charts_50/6D_Space.png) *Figure 6D* | ![7D](graphs_charts/graph_charts_50/7D_Space.png) *Figure 7D* |
| ![8D](graphs_charts/graph_charts_50/8D_Space.png) *Figure 8D* | ![9D](graphs_charts/graph_charts_50/9D_Space.png) *Figure 9D* | ![10D](graphs_charts/graph_charts_50/10D_Space.png) *Figure 10D* |
2024-06-06 21:02:05 +00:00
2024-06-06 21:08:31 +00:00
## Experiment 4 -- Limit = 75
2024-06-06 21:02:05 +00:00
2024-06-06 21:06:16 +00:00
| ![2D](graphs_charts/graph_charts_75/2D_Space.png) *Figure 2D* | ![3D](graphs_charts/graph_charts_75/3D_Space.png) *Figure 3D* | ![4D](graphs_charts/graph_charts_75/4D_Space.png) *Figure 4D* |
|:-------------------------------------------------------------:|:-------------------------------------------------------------:|:-------------------------------------------------------------:|
| ![5D](graphs_charts/graph_charts_75/5D_Space.png) *Figure 5D* | ![6D](graphs_charts/graph_charts_75/6D_Space.png) *Figure 6D* | ![7D](graphs_charts/graph_charts_75/7D_Space.png) *Figure 7D* |
| ![8D](graphs_charts/graph_charts_75/8D_Space.png) *Figure 8D* | ![9D](graphs_charts/graph_charts_75/9D_Space.png) *Figure 9D* | ![10D](graphs_charts/graph_charts_75/10D_Space.png) *Figure 10D* |
2024-06-06 21:02:05 +00:00
2024-06-06 21:08:31 +00:00
## Experiment 5 -- Limit = 100
2024-06-06 21:02:05 +00:00
2024-06-06 21:06:16 +00:00
| ![2D](graphs_charts/graph_charts_100/2D_Space.png) *Figure 2D* | ![3D](graphs_charts/graph_charts_100/3D_Space.png) *Figure 3D* | ![4D](graphs_charts/graph_charts_100/4D_Space.png) *Figure 4D* |
|:--------------------------------------------------------------:|:--------------------------------------------------------------:|:--------------------------------------------------------------:|
| ![5D](graphs_charts/graph_charts_100/5D_Space.png) *Figure 5D* | ![6D](graphs_charts/graph_charts_100/6D_Space.png) *Figure 6D* | ![7D](graphs_charts/graph_charts_100/7D_Space.png) *Figure 7D* |
| ![8D](graphs_charts/graph_charts_100/8D_Space.png) *Figure 8D* | ![9D](graphs_charts/graph_charts_100/9D_Space.png) *Figure 9D* | ![10D](graphs_charts/graph_charts_100/10D_Space.png) *Figure 10D* |
2024-06-06 21:02:05 +00:00
2024-03-18 05:33:59 +00:00
# Check Out Research Organization for open-source/semi-open-source API
- https://robotics-sensors.github.io
- Check out website for more information avaliable open-source API
2024-03-05 00:27:28 +00:00
2024-03-02 04:51:35 +00:00
# API in api_docs
2024-06-27 20:46:55 +00:00
- Temporarily Enabled for OpenSource
2024-03-18 05:33:59 +00:00
- 2D Space
- 3D Space
- 4D Space
- 5D Space
- 6D Space
- 7D Space
- 8D Space
- 9D Space
- 10D Space
2024-06-27 20:46:55 +00:00
2024-03-20 03:07:02 +00:00
# Can also checkout portion of the docs at [Portion API DOCS](https://github.com/Robotics-Sensors/bellande_robots_step/blob/main/api_docs.md)
2024-01-29 00:43:38 +00:00
### ✔️ confirmed versions
2024-01-29 03:44:59 +00:00
- `The step function efficiently computes the next step towards a target node within a specified distance limit.`
2024-01-29 05:59:37 +00:00
## Usage 2D Space
2024-01-29 03:44:59 +00:00
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.
```python
2024-01-30 18:55:48 +00:00
# Define Import
2024-01-30 19:04:19 +00:00
from bellande_robot_step.bellande_robot_step_2d import bellande_step_2d, Node2D
2024-01-30 18:55:48 +00:00
2024-01-29 03:44:59 +00:00
# Define the nodes
2024-01-29 16:37:23 +00:00
node0 = Node2D(0, 0)
node1 = Node2D(5, 5)
2024-01-29 03:44:59 +00:00
# Compute the next step within a distance limit of 3 units
2024-01-29 05:49:36 +00:00
next_step = bellande_step_2d(node0, node1, limit=3)
2024-01-29 03:44:59 +00:00
# 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.
```python
2024-01-30 18:55:48 +00:00
# Define Import
2024-01-30 20:32:30 +00:00
from bellande_robot_step.bellande_robot_step_3d import bellande_step_3d, Node3D
2024-01-30 18:55:48 +00:00
2024-01-29 03:44:59 +00:00
# Define the nodes
2024-01-29 16:37:23 +00:00
node0 = Node3D(0, 0, 0)
node1 = Node3D(5, 5, 5)
2024-01-29 03:44:59 +00:00
# Compute the next step within a distance limit of 3 units
2024-01-29 05:49:36 +00:00
next_step = bellande_step_3d(node0, node1, limit=3)
2024-01-29 03:44:59 +00:00
# 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
2024-01-29 00:43:38 +00:00
## Website
2024-03-02 04:51:35 +00:00
- https://pypi.org/project/bellande_robot_step
2024-01-29 00:43:38 +00:00
### Installation
- `$ pip install bellande_robot_step`
2024-01-30 19:04:19 +00:00
### Upgrade (if not upgraded)
- `$ pip install --upgrade bellande_robot_step`
2024-01-29 00:43:38 +00:00
```
Name: bellande_robot_step
2024-01-30 19:04:52 +00:00
Version: 0.3.0
2024-01-29 00:43:38 +00:00
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
Requires: numpy
Required-by:
```
2024-06-06 21:06:16 +00:00
## Published Paper
```
Coming Soon
```
2024-04-25 03:02:15 +00:00
## License
This Algorithm or Models is distributed under the [Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/), see [LICENSE](https://github.com/RonaldsonBellande/bellande_robots_step/blob/main/LICENSE) and [NOTICE](https://github.com/RonaldsonBellande/bellande_robots_step/blob/main/LICENSE) for more information.