Albu: /* Project Overview */

2024-10-15T14:39:58Z

Project Overview

← Older revision		Revision as of 14:39, 15 October 2024
Line 4:		Line 4:
	* '''Mentors:''' Biljana Bojovic, Amir Ashtari, and Gabriel Ferreira		* '''Mentors:''' Biljana Bojovic, Amir Ashtari, and Gabriel Ferreira

	The project aims to integrate the two new channel models, NYUSIM and Fluctuating Two-Ray (FTR), into the NR module in a simplified and user-friendly manner. ~~Furthermore~~, some ~~undertake additional~~ tasks ~~that~~ will be ~~accomplished~~ during the implementation, such as testing the ~~implemented~~ code and creating ~~an example~~ that ~~utilizes these~~ implemented models.		The project aims to integrate the two new channel models, NYUSIM and Fluctuating Two-Ray (FTR), into the NR module in a simplified and user-friendly manner. Additionally, some tasks will be carried out during the implementation process, such as testing the code and creating examples that demonstrate the use of the implemented models.

	== Merge Requests and Project Details ==		== Merge Requests and Project Details ==
Line 63:		Line 63:

	== Addditional Features ==		== Addditional Features ==
	In addition to the proposed activities, I created a new API, NrChannelHelper, which allowed me to redesign how channels ~~are selected and configured by users~~. This API also enabled the extension to use legacy models not previously supported in the 5G-Lena module before my work. ~~For this~~, the ~~configuration~~ of ~~these~~ legacy ~~channels was allowed~~, and ~~antennas aligned with these~~ models ~~were used~~.		In addition to the proposed activities, I created a new API, NrChannelHelper, which allowed me to redesign how users select and configure channels. This API also enabled the extension to use all the legacy fading and propagation models not previously supported in the 5G-Lena module before my work. Additionally, the NrHelper API has been extended to enable the use of legacy antennas, which will be used in conjunction with the fading and propagation models present in ns-3.

	== My Experience ==		== My Experience ==

Albu: Created page with "= Project Overview = * '''Project Name:''' 5G NR Module Benchmark and Analysis for Distinct Channel Models * '''Student:''' Joao Albuquerque * '''Mentors:''' Biljana Bojovic, Amir Ashtari, and Gabriel Ferreira The project aims to integrate the two new channel models, NYUSIM and Fluctuating Two-Ray (FTR), into the NR module in a simplified and user-friendly manner. Furthermore, some undertake additional tasks that will be accomplished during the implementation, such as..."

2024-10-06T15:26:34Z

Created page with "= Project Overview = * '''Project Name:''' 5G NR Module Benchmark and Analysis for Distinct Channel Models * '''Student:''' Joao Albuquerque * '''Mentors:''' Biljana Bojovic, Amir Ashtari, and Gabriel Ferreira The project aims to integrate the two new channel models, NYUSIM and Fluctuating Two-Ray (FTR), into the NR module in a simplified and user-friendly manner. Furthermore, some undertake additional tasks that will be accomplished during the implementation, such as..."

New page

= Project Overview =
* '''Project Name:''' 5G NR Module Benchmark and Analysis for Distinct Channel Models
* '''Student:''' Joao Albuquerque
* '''Mentors:''' Biljana Bojovic, Amir Ashtari, and Gabriel Ferreira

The project aims to integrate the two new channel models, NYUSIM and Fluctuating Two-Ray (FTR), into the NR module in a simplified and user-friendly manner. Furthermore, some undertake additional tasks that will be accomplished during the implementation, such as testing the implemented code and creating an example that utilizes these implemented models.

== Merge Requests and Project Details ==

I maintained two branches to accomplish all the code written during GSoC: [https://gitlab.com/Allbu/nr/-/tree/bwp-interface-enhancement?ref_type=heads bwp-interface-enhancement] and [https://gitlab.com/Allbu/nr/-/tree/enable-non-su-mimo-second-imp?ref_type=heads enable-non-su-mimo].

Project Wiki Page: [https://www.nsnam.org/wiki/GSOC2024Channels5G GSOC2024Channels5G]

Proposal: [https://drive.google.com/file/d/1TSTStwfwm5o1ALHmnphOKejYse69ow-x/view?usp=sharing]

{| class="wikitable"
|+ Merge Requests
|-
! No. || Name || Status
|-
| [1] || [https://gitlab.com/cttc-lena/nr/-/merge_requests/174 Draft: GSoC 2024: Refactor band configuration and initialization with a modular approach (Enhancement)] || Draft
|-
| [2] || [https://gitlab.com/cttc-lena/nr/-/merge_requests/160 Draft: GSoC2024: Enable non-su-mimo channel models] || Draft
|}

== Community Bonding Period ==

During the bonding period, we discussed all the significant parts of the project before the implementation started. Therefore, I began to:

* Understand how the NYUSIM channel model interface was implemented in the mmWave module
* Read papers regarding the implementation of both NYUSIM and FTR
* Plan the user-friendly interface for channel model selection and configuration
* Discuss some issues that this implementation could generate in the code

== Coding Phase and Work Packages ==
As proposed for the coding period, we set some goals divided into work packages.

=== Work Package 1 ===
In the first one, four goals were decided upon:

''' Achieved in week 4''': [https://gitlab.com/Allbu/nr/-/commit/be2afa7d275677c79f58c9717987a9400b60eb4d]
* Prepare 5G-Lena for different channel models that may not have a spectrum channel matrix for SU-MIMO and create a merge request to 5G-Lena. [milestone 1]

''' Achieved in week 6''': [https://gitlab.com/cttc-lena/nr/-/merge_requests/167]
* Implement an interface for selecting the channel model via the NR helper class and create a merge request for 5G-Lena. [milestone 2]
* Create a conditional build depending on the NYU channel model available in ns-3 and create a merge request to 5G-Lena. [milestone 3] [https://gitlab.com/cttc-lena/nr/-/merge_requests/174/diffs?commit_id=846330277256bfc0bcd4486b1a231eb2cfa9a03f specific commit]
* Extend the NR helper to allow the configuration of 3GPP NTN channel models and create a merge request for 5G-Lena. [milestone 4] [https://gitlab.com/cttc-lena/nr/-/merge_requests/174/diffs?commit_id=225263e93b2164f6ef9368ba99b5630e0beebdd4 specific commit]

* '''NOTE:''' After discussing some points, we decided to improve our approach [https://gitlab.com/cttc-lena/nr/-/merge_requests/174]

=== Work Package 2 ===
In the second work package, we aim to evaluate the channel models by creating one example, test code, and plotting some physical metrics and key performance indicators (KPIs):

''' Achieved in week 13''': [https://gitlab.com/cttc-lena/nr/-/merge_requests/174/diffs?commit_id=be66c8687c60f6a0feb297824b5645bd88c16044]
* Identify and implement the appropriate scenario for all channel models

''' Achieved in week 17''': [https://docs.google.com/presentation/d/1kZrTYnL7pzd_cM9dEd7zOxT5TIFTvwXt4DfOrMWOG6c/edit?usp=sharing], [https://docs.google.com/presentation/d/1-mE9b6QE3P6S9kwvFGj2bwuvy6MQWe6QANcwXqFDGqo/edit#slide=id.g2e65c1385a2_0_195], [https://docs.google.com/presentation/d/19gSmb4aiG8TnCKcPNp-k8zL_2svV6ENttXVmgNvVj5Q/edit?usp=sharing]
* Prepare traces to be measured (e.g., entire simulation time, SINR, throughput, latency, etc.) and scripts for running and plotting based on the implemented example
* Analyze, evaluate, and plot the results of the accomplished example

''' Achieved in week 18''': [https://gitlab.com/cttc-lena/nr/-/merge_requests/174/diffs?commit_id=65fabc490829d123bc9d774ee1f90f8e769d97e9]
* Extend the example to be used as a test and create a merge request of the implemented test to 5G-Lena

== Addditional Features ==
In addition to the proposed activities, I created a new API, NrChannelHelper, which allowed me to redesign how channels are selected and configured by users. This API also enabled the extension to use legacy models not previously supported in the 5G-Lena module before my work. For this, the configuration of these legacy channels was allowed, and antennas aligned with these models were used.

== My Experience ==

=== Acknowledgements ===
I want to thank all my mentors, Biljana Bojovic, Gabriel Ferreira, and Amir Ashtari, for always helping me understand the code architecture and how to work with open source. I would also like to thank Tom Henderson, who, although not one of my mentors, played a crucial role in improving the developed code. Finally, a general thanks to the Google Summer of Code project and the 5G-Lena team.

=== Challenges Faced ===

In the implementation phase, more precisely, I faced challenges in modularizing the code so that the proposed channel models and the legacy models were included. Additionally, understanding the results at the physical and application layer levels for the FTR and NYUSIM models was challenging.

GSOC2024Channels5GFinalReport - Revision history

Albu: /* Project Overview */