65 lines
2.9 KiB
Markdown
65 lines
2.9 KiB
Markdown
# 📦 Bellande Node Importance Models & Executables
|
|
|
|
# Demo of Bellande Node Importance
|
|
|
|
|
|
## 🧙 Organization Website
|
|
- [](https://robotics-sensors.github.io)
|
|
|
|
## 🧙 Organization Github
|
|
- [](https://github.com/Robotics-Sensors)
|
|
|
|
# Author, Creator and Maintainer
|
|
- **Ronaldson Bellande**
|
|
|
|
## Usage
|
|
```
|
|
./Bellande_Node_Importance passcode node recent_nodes important_nodes adjacent_segments grid_steps min_segment_coverage
|
|
```
|
|
|
|
### Arguments
|
|
1. `passcode`: The access key (must be "bellande_node_importance_executable_access_key")
|
|
2. `node`: Node to evaluate as [coordinates, segment] (e.g., "[[5.0, 5.0, 5.0], 1]")
|
|
3. `recent_nodes`: List of recent nodes as [[coordinates, segment], ...] (e.g., "[[[4.0, 4.0, 4.0], 1], [[6.0, 6.0, 6.0], 1]]")
|
|
4. `important_nodes`: Dictionary of important nodes by segment (e.g., "{'1': [[[4.0, 4.0, 4.0], 1]], '2': [[[15.0, 15.0, 15.0], 2]]}")
|
|
5. `adjacent_segments`: Dictionary of adjacent segments (e.g., "{'1': [2], '2': [1]}")
|
|
6. `grid_steps`: Step sizes for each dimension as a list (e.g., "[10.0, 10.0, 10.0]")
|
|
7. `min_segment_coverage`: Float value for minimum segment coverage ratio (default: 0.5)
|
|
|
|
### Example
|
|
```bash
|
|
./Bellande_Node_Importance \
|
|
"bellande_node_importance_executable_access_key" \
|
|
"[[5.0, 5.0, 5.0], 1]" \
|
|
"[[[4.0, 4.0, 4.0], 1], [[6.0, 6.0, 6.0], 1], [[5.5, 5.5, 5.5], 1]]" \
|
|
"{'1': [[[4.0, 4.0, 4.0], 1]], '2': [[[15.0, 15.0, 15.0], 2]]}" \
|
|
"{'1': [2], '2': [1]}" \
|
|
"[10.0, 10.0, 10.0]" \
|
|
"0.5"
|
|
```
|
|
|
|
### Notes
|
|
- Passcode must be exactly "bellande_node_importance_executable_access_key"
|
|
- All coordinates within nodes must have the same dimensions
|
|
- Grid steps must match the dimensionality of the nodes
|
|
- Use proper Python list and dictionary syntax for all inputs
|
|
- The script supports infinite dimensions, limited only by system resources
|
|
- All numeric values can have decimal precision
|
|
- The function evaluates node importance based on:
|
|
- Coverage ratio in the segment
|
|
- Connection potential with important nodes in adjacent segments
|
|
- Local neighbor density
|
|
|
|
### Error Handling
|
|
The script includes error handling for:
|
|
- Incorrect number of arguments
|
|
- Invalid passcode
|
|
- Mismatched dimensions across coordinates
|
|
- Invalid input format (syntax errors)
|
|
- Invalid data structure formats
|
|
- Inconsistent dimensionality between nodes and grid steps
|
|
- Other unexpected errors
|
|
|
|
## 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_node_importance_models/blob/main/LICENSE) and [NOTICE](https://github.com/RonaldsonBellande/bellande_node_importance_models/blob/main/LICENSE) for more information.
|