diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..d457922 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +application_store/bellandeos/Application_Store +document_processor/bellandeos/Document_Processor +application_store/bellandeos/Application_Store +document_processor/bellandeos/Document_Processor diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..13e3224 --- /dev/null +++ b/LICENSE @@ -0,0 +1,17 @@ +Copyright (C) 2024 Bellande Artificial Intelligence & Computer Vision Research Innovation Center, Ronaldson Bellande + +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. +To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. + +You are free to: + +- Share — copy and redistribute the material in any medium or format +- Adapt — remix, transform, and build upon the material for any purpose, even commercially. + +Under the following terms: + +- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use. +- ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original. +- No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits. + +This is a human-readable summary of (and not a substitute for) the license. See the full license text for more details. diff --git a/README.md b/README.md index 36ff1ae..b733387 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,64 @@ -# bellande_node_importance_models_executables -The Bellande Node Importance Executable is an n-dimensional tool that determines node significance through coverage, connectivity, and neighborhood density analysis. +# 📦 Bellande Node Importance Models & Executables + +# Demo of Bellande Node Importance +![Demo GIF](executable/bellande_node_importance.gif) + +## 🧙 Organization Website +- [![Organization Website](https://img.shields.io/badge/Explore%20Our-Website-0099cc?style=for-the-badge)](https://robotics-sensors.github.io) + +## 🧙 Organization Github +- [![Organization Github ](https://img.shields.io/badge/Explore%20Our-Github-0099cc?style=for-the-badge)](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. diff --git a/executable/bellandeos/Bellande_Node_Importance b/executable/bellandeos/Bellande_Node_Importance new file mode 100755 index 0000000..009331d Binary files /dev/null and b/executable/bellandeos/Bellande_Node_Importance differ diff --git a/executable/linux/Bellande_Node_Importance b/executable/linux/Bellande_Node_Importance new file mode 100755 index 0000000..009331d Binary files /dev/null and b/executable/linux/Bellande_Node_Importance differ diff --git a/git_scripts/.gitignore b/git_scripts/.gitignore new file mode 100644 index 0000000..e5a7a9c --- /dev/null +++ b/git_scripts/.gitignore @@ -0,0 +1,3 @@ +fix_errors.sh +push.sh +repository_recal.sh diff --git a/run_executable.bellos b/run_executable.bellos new file mode 100755 index 0000000..0c02961 --- /dev/null +++ b/run_executable.bellos @@ -0,0 +1 @@ +./executable/linux/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" diff --git a/run_executable.sh b/run_executable.sh new file mode 100755 index 0000000..0c02961 --- /dev/null +++ b/run_executable.sh @@ -0,0 +1 @@ +./executable/linux/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"