BADA-BEAM is an advanced web application designed to facilitate the translation of 2D antenna radiation patterns into accurate 3D volumetric representations. By importing standard 2D plots for both Azimuth and Elevation planes, RF engineers and enthusiasts can intuitively generate, visualize, and analyze the corresponding 3D radiation structures directly within their browser.
- Dual-Plane Calibration: Fully independent workflows to calibrate both Azimuth (Horizontal) and Elevation (Vertical) planes using custom imported images.
- Smart Auto-Tracing: Integrated color-detection algorithms to automatically trace and convert pixel data from uploaded plots into precision polar coordinates.
- Interactive 3D Render: A built-in, real-time 3D engine powered by Three.js allows users to pan, zoom, and inspect generated antenna lobes dynamically.
- Data Export: Seamless functionality to export the computed 3D objects as industry-standard STL files for downstream analysis or 3D printing.
The application adopts a robust client-server software architecture:
- Backend Framework: Built with Flask (Python), handling complex numerical operations, coordinate transformations (from Polar to Cartesian), and geometric mesh generation leveraging NumPy.
- Frontend Stack: Developed using standardized web technologies (HTML5, CSS3, JavaScript), leveraging the HTML5
<canvas>element for tracing logic and Three.js for high-fidelity 3D visualization. - Containerization: Fully containerized using Docker to ensure cross-platform consistency and streamline deployment pipelines.
You can deploy BADA-BEAM either via Docker (recommended for environmental consistency) or by setting up a local Python virtual environment.
Prerequisites: Docker and Docker Compose must be installed on your host system.
-
Clone the repository:
git clone https://github.com/ClementLG/BADA-BEAM.git cd BADA-BEAM -
Build and spin up the environment:
docker-compose up -d --build
-
Access the platform: Navigate to
http://localhost:5010via your preferred web browser.
Prerequisites: Python 3.8+ installed on your host system.
-
Clone the repository:
git clone https://github.com/ClementLG/BADA-BEAM.git cd BADA-BEAM -
Install dependencies:
pip install -r requirements.txt
-
Launch the application:
python app.py
-
Access the platform: Navigate to
http://localhost:5010via your web browser.
- Upload Patterns: Load your 2D radiation pattern images into the respective Azimuth and Elevation drag-and-drop zones.
- Calibrate Axes: Follow the precise on-screen prompts to define the center origin, scale, and reference directions for both distinct plots.
- Trace the Plot: Utilize the Auto-Trace feature by clicking on the targeted color of your data plot, commanding the application to capture the radiation shape.
- Generate 3D: Once both planes are adequately traced and processed, initiate the generation sequence to compute the intersection and resulting 3D volume.
- Export Data: Use the internal viewer controls to critically inspect the results, and download the
.stlfile securely to your local machine for integration into simulation software.
Contributions make the open-source community an invaluable place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request on GitHub.
This project is distributed under the GNU General Public License v3.0 (GPLv3). See the LICENSE file for further programmatic and legal information.