Skip to content

Software packages useful for analysis of millimeter wave aerial networks. Includes functions for estimating atmopsheric path losses from International Telecommunications Union (ITU) reccomendations, antenna parameters, multi-user uplink capacities, and a bonus beam forming algorithm.

Notifications You must be signed in to change notification settings

travisCuvelier/mmWaveAerialNetworks

Repository files navigation

These scripts were used in the paper: https://arxiv.org/pdf/1804.03295.pdf also available at https://ieeexplore.ieee.org/document/8491045.
The arXiv version is as (finally) submitted modulo a small correction in equation (9) that I noticed after publication. 

If you use these scripts in research, please cite: 

T. Cuvelier and R. W. Heath, "MmWave MU-MIMO for Aerial Networks," Proceedings of the 15th International Symposium on Wireless Communication Systems (ISWCS), Lisbon, 2018, pp. 1-6. Available at: https://arxiv.org/pdf/1804.03295.pdf

Important Information:

1) This source code is freely redistributable under the terms of the GNU General Public License (GPL) as published by the Free Software Foundation.

2) If you are thinking of contacting us, please do not e-mail the author to ask for download instructions, installation guidelines, or the toolbox itself. 
The code itself is documented and the package contains a README.txt file providing the essential information about the software. 
Note that we will NOT help to debug user-generated code that was not included in the provided software package. 
If, however, you notice a bug in our code or a mistake in our documentation, please be so kind to contact Travis Cuvelier at tcuvelier@utexas.edu.

3) The software package is supplied "as is", without any accompanying support services, maintenance, or future updates. 

4) We make no warranties, explicit or implicit, that the software contained in this package is free of error or that it will meet your requirements for any particular application. 

5) This software should not be relied on for any purpose where incorrect results could result in loss of property, personal injury, liability or whatsoever. 
If you do use our software for any such purpose, it is at your own risk. 

6) The authors (Travis Cuvelier and Robert Heath Jr.), as well as the University of Texas at Austin, disclaim all liability of any kind, either direct or consequential, resulting from your use of these programs.

How to use this software:
(This guide is incomplete and under construction)

1) At least skim the paper. Specifically, read the "Analytical Framework" section. 

2) Clone the repo via calling on the terminal: git clone https://github.com/travisCuvelier/mmWaveAerialNetworks.git

3) The folder "mmWaveAerialNetworks" will appear in your directory.

4) To run experiments that estimate achievable rates in the uplink scenario described in our paper, add mmWaveAerialNetworks and all subfolders to your path in MATLAB. The way I do this is by navigating to 
the directory containing "mmWaveAerialNetworks", right clicking on the folder, and selecting "Add to Path" and then selecting "Selected Folders and Subfolders". Open the script "uplinkExperiments.m" 
in the "mmWaveAerialNetworks" folder, read the comments, set your parameters, and run the thing. The results for every iteration will appear in the "mmWaveAerialNetworks/results" as .mat files.

6) You can find scripts to compute atmospheric specific attenuation in "mmWaveAerialNetworks/atmospheric_specific_attenuation_formulae". You will find the functions in "mmWaveAerialNetworks/meteorological_conversions" 
useful. Furthermore, you can find an atmospheric model from the ITU in "mmWaveAerialNetworks/reference_atmospheres".

About

Software packages useful for analysis of millimeter wave aerial networks. Includes functions for estimating atmopsheric path losses from International Telecommunications Union (ITU) reccomendations, antenna parameters, multi-user uplink capacities, and a bonus beam forming algorithm.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages