Skip to content
richardrouil edited this page Oct 21, 2021 · 8 revisions

ns-3 Public Safety Communications psc-dev (10/20/2021)


The development branch is currently aligned with release v5.0 of the psc-ns3 repository.

Use psc_ns3@list.nist.gov to report any issue.


ns-3 Public Safety Communications v5.0 (10/20/2021)


This module provides extensions to the LTE including Device to Device (D2D) capabilities and Mission Critical Push-to-Talk (MCPTT), as well as new propagation models and applications related to public safety communications.

The current model is based on ns-3.33 release and supports the following features:

  • Extensive D2D model, supporting synchronization, discovery, and communication.
  • Support for UE-to-Network model
  • Various 3GPP based propagation models
  • On-network and Off-network MCPTT protocol
  • UAV mobility energy model
  • HTTP application model
  • Video streaming model
  • Large scale incident scenarios

Please refer to the following publications for further information about the LTE D2D and MCPTT capabilities, including the implementation and validation details:

  • R. Rouil, F. Cintron, A. Ben Mosbah and S. Gamboa, "Implementation and Validation of an LTE D2D Model for ns-3", Proceedings of the Workshop on ns-3 (WNS3 2017), June 2017, Porto, Portugal. (http://dl.acm.org/citation.cfm?id=3067668)
  • S. Gamboa, R. Thanigaivel and R. Rouil, "System Level Evaluation of UE-to-Network Relays in D2D-Enabled LTE Networks," 2019 IEEE 24th International Workshop on Computer Aided Modeling and Design of Communication Links and Networks (CAMAD), Limassol, Cyprus, 2019 (https://ieeexplore.ieee.org/document/8858441)
  • W. Garey, T. Henderson, Y. Sun, R. Rouil, and S. Gamboa, “Modeling MCPTT and User Behavior in ns-3,” in Proceedings of the 11th International Conference on Simulation and Modeling Methodologies, Technologies and Applications, 2021, pp. 30–41, doi: 10.5220/0010513200300041

If you use our models in your research, please cite the above-mentioned papers as applicable.

Future work:

The following features are intended to be added to the project in the future:

  • New Radio (NR) ProSe

Installation

The Public Safety Communications repository is a self-contained ns-3 repository and follows the same installation process as the main release of ns-3.

Documentation

The model documentation and user manuals for this release is available.

Link: https://github.com/usnistgov/psc-ns3/blob/psc-5.0/ns3-psc-documentation.pdf

Maintenance

Installation support

Due to limited resources, we will provide assistance only for issues related to the installation of this code. We strongly recommend to install the standard version of ns-3 prior to installing our code.

Link: https://www.nsnam.org/docs/tutorial/html/getting-started.html

Like that, the users can get support for any issue related to ns-3 installation from the ns-3 community.

Link: https://www.nsnam.org/support/mailing-list/

Afterwards, the user can install our project and report to us only the issues related to our model installation.

Bugs

If you find a bug when running the provided scenarios, please report it including detailed information about the scenario and error(s) observed.

Please report issues to psc_ns3@list.nist.gov

Enhancements

We welcome contributions to this module. To do so, please make a pull request against the psc-dev branch on the github repository.

License

This software was developed at the National Institute of Standards and Technology by employees of the Federal Government in the course of their official duties. Pursuant to titleElement 17 Section 105 of the United States Code this software is not subject to copyright protection and is in the public domain. NIST assumes no responsibility whatsoever for its use by other parties, and makes no guarantees, expressed or implied, about its quality, reliability, or any other characteristic.

We would appreciate acknowledgment if the software is used.

NIST ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS" CONDITION AND DISCLAIM ANY LIABILITY OF ANY KIND FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.

About the Model

The model is developed and maintained by the Public Safety Communication Project Group of the Wireless Networks Division (WND) at the Communication Thechnology Laboratory (CTL) of the National Institute of Standards and Technology (NIST) - U.S. Department of Commerce. For further information about the research conducted by the group, please refer to the following website: https://www.nist.gov/programs-projects/public-safety-communications

The integration of the initial ProSe module with the LTE and buildings module, as well as the creation of additional examples and tests, and contributions to on-network MCPTT support, was assisted by CTTC and the University of Washington. This work was performed under the financial assistance award 70NANB17H170 and 70NANB20H179 from U.S. Department of Commerce, National Institute of Standards and Technology.