[](https://discord.com/servers/agora-999382051935506503)
# Sonar Vision Mapping System
This project aims to recreate the vision mapping system inspired by Batman in "The Dark Knight." The system uses high-frequency sound pulses to create a real-time, three-dimensional map of an environment. It is designed for applications in security, surveillance, and search-and-rescue operations.
## Features
- Emit ultrasonic chirp signals
- Record echoes and process the response
- Calculate distances to objects based on echo timings
- Construct and visualize a 3D point cloud of the environment
## Requirements
- Python 3.6+
- `numpy`
- `sounddevice`
- `scipy`
- `matplotlib`
# Install
```bash
$ pip install svms
```
## Usage
```python
from svms.main import SonarVisionMappingSystem
# Example usage
sonar_system = SonarVisionMappingSystem()
sonar_system.run()
```
This script will emit ultrasonic pulses, record the echoes, and visualize the 3D point cloud of the environment.
## Code Overview
### `SonarVisionMappingSystem` Class
The main functionality is encapsulated in the `SonarVisionMappingSystem` class. Here's a breakdown of the key methods:
- `__init__(self, fs=44100, duration=0.5, f0=20000, f1=20000, num_directions=36, elevation_angles=9)`: Initializes the system with sampling frequency, duration, and frequency range for the chirp signal, along with the number of directions and elevation angles for mapping.
- `generate_chirp_signal(self)`: Generates a chirp signal.
- `record_response(self)`: Emits the chirp signal and records the response.
- `process_signal(self, response)`: Processes the recorded response to find echoes and calculate distances.
- `collect_data(self)`: Collects responses and distances for multiple directions and elevation angles.
- `plot_3d_mapping(self)`: Plots the 3D point cloud of the environment.
- `run(self)`: Runs the complete process of data collection and 3D mapping.
### Example Usage
```python
sonar_system = SonarVisionMappingSystem()
sonar_system.run()
```
## Safety Considerations
The system uses ultrasonic frequencies (20 kHz), which are generally considered safe. However, ensure that the intensity of the emitted pulses is within safe limits, and avoid prolonged exposure to ultrasonic waves.
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request for any enhancements or bug fixes.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/kyegomez/SVMS",
"name": "svms",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "artificial intelligence, deep learning, optimizers, Prompt Engineering",
"author": "Kye Gomez",
"author_email": "kye@apac.ai",
"download_url": "https://files.pythonhosted.org/packages/b3/28/ea6989960f8fcac2feaa2db3006360326529ca3e67f8ee70c555bd2d7080/svms-0.0.2.tar.gz",
"platform": null,
"description": "[](https://discord.com/servers/agora-999382051935506503)\n\n# Sonar Vision Mapping System\n\nThis project aims to recreate the vision mapping system inspired by Batman in \"The Dark Knight.\" The system uses high-frequency sound pulses to create a real-time, three-dimensional map of an environment. It is designed for applications in security, surveillance, and search-and-rescue operations.\n\n## Features\n\n- Emit ultrasonic chirp signals\n- Record echoes and process the response\n- Calculate distances to objects based on echo timings\n- Construct and visualize a 3D point cloud of the environment\n\n## Requirements\n\n- Python 3.6+\n- `numpy`\n- `sounddevice`\n- `scipy`\n- `matplotlib`\n\n# Install\n```bash\n$ pip install svms\n```\n\n## Usage\n```python\n\nfrom svms.main import SonarVisionMappingSystem\n\n# Example usage\nsonar_system = SonarVisionMappingSystem()\nsonar_system.run()\n\n```\n\n\n\nThis script will emit ultrasonic pulses, record the echoes, and visualize the 3D point cloud of the environment.\n\n## Code Overview\n\n### `SonarVisionMappingSystem` Class\n\nThe main functionality is encapsulated in the `SonarVisionMappingSystem` class. Here's a breakdown of the key methods:\n\n- `__init__(self, fs=44100, duration=0.5, f0=20000, f1=20000, num_directions=36, elevation_angles=9)`: Initializes the system with sampling frequency, duration, and frequency range for the chirp signal, along with the number of directions and elevation angles for mapping.\n\n- `generate_chirp_signal(self)`: Generates a chirp signal.\n\n- `record_response(self)`: Emits the chirp signal and records the response.\n\n- `process_signal(self, response)`: Processes the recorded response to find echoes and calculate distances.\n\n- `collect_data(self)`: Collects responses and distances for multiple directions and elevation angles.\n\n- `plot_3d_mapping(self)`: Plots the 3D point cloud of the environment.\n\n- `run(self)`: Runs the complete process of data collection and 3D mapping.\n\n### Example Usage\n\n```python\nsonar_system = SonarVisionMappingSystem()\nsonar_system.run()\n```\n\n## Safety Considerations\n\nThe system uses ultrasonic frequencies (20 kHz), which are generally considered safe. However, ensure that the intensity of the emitted pulses is within safe limits, and avoid prolonged exposure to ultrasonic waves.\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit a pull request for any enhancements or bug fixes.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.",
"bugtrack_url": null,
"license": "MIT",
"summary": "Paper - Pytorch",
"version": "0.0.2",
"project_urls": {
"Documentation": "https://github.com/kyegomez/SVMS",
"Homepage": "https://github.com/kyegomez/SVMS",
"Repository": "https://github.com/kyegomez/SVMS"
},
"split_keywords": [
"artificial intelligence",
" deep learning",
" optimizers",
" prompt engineering"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c9fc4d0c09a1494ec82d6f1e9e057270872a662063060d5a0652874bb45ce980",
"md5": "6792702188b6e983d04da1b2e4d858bc",
"sha256": "0f5e42af9453e7270697ba7ff0452c44981c37bbfd3aaecbb7c84f00ca6dfe79"
},
"downloads": -1,
"filename": "svms-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6792702188b6e983d04da1b2e4d858bc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 4886,
"upload_time": "2024-07-04T05:03:38",
"upload_time_iso_8601": "2024-07-04T05:03:38.898110Z",
"url": "https://files.pythonhosted.org/packages/c9/fc/4d0c09a1494ec82d6f1e9e057270872a662063060d5a0652874bb45ce980/svms-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b328ea6989960f8fcac2feaa2db3006360326529ca3e67f8ee70c555bd2d7080",
"md5": "101fb064602006a9548b0902d610d295",
"sha256": "6835348f8f62d3e02938e139855d95c9317f7e753169f08c86d76ac20742e818"
},
"downloads": -1,
"filename": "svms-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "101fb064602006a9548b0902d610d295",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 4582,
"upload_time": "2024-07-04T05:03:40",
"upload_time_iso_8601": "2024-07-04T05:03:40.963392Z",
"url": "https://files.pythonhosted.org/packages/b3/28/ea6989960f8fcac2feaa2db3006360326529ca3e67f8ee70c555bd2d7080/svms-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-04 05:03:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kyegomez",
"github_project": "SVMS",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "svms"
}
JSON
