| _version_ | 1866902200461033472 |
|---|---|
| author | Shafafi, Kamran |
| author_facet | Shafafi, Kamran |
| contents | <h1>UAV Positioning System</h1> <h2>Description</h2> <p>This software implements an algorithm for optimal UAV placement in wireless communications scenarios. The system takes into account:</p> <ul> <li>Building obstacles and their heights</li> <li>Multiple User Equipment (UE) locations and their Signal-to-Noise Ratio (SNR) requirements</li> <li>Line-of-sight considerations using angle calculations</li> <li>Power optimization for the UAV transmitter</li> </ul> <p>The main features include:</p> <ul> <li>Automatic calculation of minimum required transmission power</li> <li>3D positioning that ensures line-of-sight with all UEs</li> <li>Building obstacle avoidance</li> <li>SNR requirement satisfaction for all connected UEs</li> </ul> <h2>User Manual</h2> <h3>File Structure</h3> <ol> <li><strong>obstacle</strong> - Contains building corner coordinates in format: <code>x, y, height</code> <ul> <li>Each line represents one corner of the building</li> <li>Coordinates must be listed in order to form a valid polygon</li> </ul> </li> <li><strong>UEs</strong> - Contains user equipment data in format: <code>ID, x, y, z, SNR</code> <ul> <li>ID: Unique identifier for each UE</li> <li>x, y, z: 3D coordinates of the UE</li> <li>SNR: Required Signal-to-Noise Ratio in dB</li> </ul> </li> </ol> <h3>Usage Instructions</h3> <ol> <li><strong>Setup Requirements</strong> <div> <div> <div><code>pip <span>install</span> numpy shapely gekko</code></div> <div> </div> </div> </div> </li> <li><strong>Input File Preparation</strong> <ul> <li>Create an <code>obstacle</code> file with building coordinates</li> <li>Create a <code>UEs</code> file with user equipment data</li> <li>Place both files in a directory named <code>UAVP</code></li> <li> </li> </ul> </li> <li><strong>Running the System</strong> <div> <div> <div><code>python app.py</code></div> </div> </div> </li> <li><strong>Output</strong> The system will output a tuple containing: <ul> <li>Optimal transmission power (PT) in dBm</li> <li>Optimal UAV position [x, y, z]</li> </ul> </li> </ol> <h3>Technical Notes</h3> <ul> <li>The system uses the GEKKO optimizer for solving the positioning problem</li> <li>Line-of-sight is guaranteed through angle calculations</li> <li>The algorithm iteratively increases transmission power until a valid solution is found</li> <li>The UAV will always be positioned above the maximum building height</li> </ul> <h3>Constraints</h3> <ul> <li>All UEs must have clear line-of-sight to the UAV</li> <li>The UAV must be positioned above the highest building</li> <li>Signal strength must meet SNR requirements for all UEs</li> </ul> <h3>Citation Requirements</h3> <p>As per the MIT License with Citation Requirement, when using this software, please cite:</p> <ul> <li>Author: Kamran Shafafi</li> <li>DOI: 10.5281/zenodo.14566274</li> </ul> |
| format | Recurso digital |
| id | zenodo_https___doi_org_10_5281_zenodo_16881392 |
| institution | Zenodo |
| language | eng |
| publishDate | 2025 |
| publisher | Zenodo |
| record_format | zenodo |
| spellingShingle | A UAV Positioning Software Repository Shafafi, Kamran UAV Wireless Technology POSITIONONH Unmanned Aerial Devices/instrumentation Telecommunication Network <h1>UAV Positioning System</h1> <h2>Description</h2> <p>This software implements an algorithm for optimal UAV placement in wireless communications scenarios. The system takes into account:</p> <ul> <li>Building obstacles and their heights</li> <li>Multiple User Equipment (UE) locations and their Signal-to-Noise Ratio (SNR) requirements</li> <li>Line-of-sight considerations using angle calculations</li> <li>Power optimization for the UAV transmitter</li> </ul> <p>The main features include:</p> <ul> <li>Automatic calculation of minimum required transmission power</li> <li>3D positioning that ensures line-of-sight with all UEs</li> <li>Building obstacle avoidance</li> <li>SNR requirement satisfaction for all connected UEs</li> </ul> <h2>User Manual</h2> <h3>File Structure</h3> <ol> <li><strong>obstacle</strong> - Contains building corner coordinates in format: <code>x, y, height</code> <ul> <li>Each line represents one corner of the building</li> <li>Coordinates must be listed in order to form a valid polygon</li> </ul> </li> <li><strong>UEs</strong> - Contains user equipment data in format: <code>ID, x, y, z, SNR</code> <ul> <li>ID: Unique identifier for each UE</li> <li>x, y, z: 3D coordinates of the UE</li> <li>SNR: Required Signal-to-Noise Ratio in dB</li> </ul> </li> </ol> <h3>Usage Instructions</h3> <ol> <li><strong>Setup Requirements</strong> <div> <div> <div><code>pip <span>install</span> numpy shapely gekko</code></div> <div> </div> </div> </div> </li> <li><strong>Input File Preparation</strong> <ul> <li>Create an <code>obstacle</code> file with building coordinates</li> <li>Create a <code>UEs</code> file with user equipment data</li> <li>Place both files in a directory named <code>UAVP</code></li> <li> </li> </ul> </li> <li><strong>Running the System</strong> <div> <div> <div><code>python app.py</code></div> </div> </div> </li> <li><strong>Output</strong> The system will output a tuple containing: <ul> <li>Optimal transmission power (PT) in dBm</li> <li>Optimal UAV position [x, y, z]</li> </ul> </li> </ol> <h3>Technical Notes</h3> <ul> <li>The system uses the GEKKO optimizer for solving the positioning problem</li> <li>Line-of-sight is guaranteed through angle calculations</li> <li>The algorithm iteratively increases transmission power until a valid solution is found</li> <li>The UAV will always be positioned above the maximum building height</li> </ul> <h3>Constraints</h3> <ul> <li>All UEs must have clear line-of-sight to the UAV</li> <li>The UAV must be positioned above the highest building</li> <li>Signal strength must meet SNR requirements for all UEs</li> </ul> <h3>Citation Requirements</h3> <p>As per the MIT License with Citation Requirement, when using this software, please cite:</p> <ul> <li>Author: Kamran Shafafi</li> <li>DOI: 10.5281/zenodo.14566274</li> </ul> |
| title | A UAV Positioning Software Repository |
| topic | UAV Wireless Technology POSITIONONH Unmanned Aerial Devices/instrumentation Telecommunication Network |
| url | https://doi.org/10.5281/zenodo.16881392 |