isac-plm
Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.
Science Score: 36.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: ieee.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.5%) to scientific vocabulary
Keywords
Repository
Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.
Basic Info
Statistics
- Stars: 104
- Watchers: 10
- Forks: 25
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
Integrated Sensing and Communication Physical Layer Model (ISAC-PLM)
Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.
![]()
![]()
Table of Contents
- Features
- Installation
- Requirements
- How to Run
- Examples Provided
- References
- Contributing
- Contact information
- Credits
- License
Features
- Support for IEEE 802.11ay including Single Carrier/OFDM waveform generation and spatial multiplexing schemes: SU-SISO, SU-MIMO, MU-MIMO.
- Comprehensive performance analysis tools: link-level BER, PER, data rate testing, and analytical SE bounds.
- Receiver algorithms for synchronization, channel estimation, carrier frequency offset (CFO) correction.
- Integrated sensing capabilities using both passive and active techniques.
- Sensing signal processing algorithms for clutter removal, 2D-CFAR, doppler processing, target detection, and range/velocity estimation.
- Sensing accuracy evaluated using Mean Squared Error (MSE) and Normalized Mean Squared Error (NMSE).
Installation
Downloading or cloning the repository is all that's requiredno further installation steps needed.
Requirements
- The software is developed in MATLAB and tested on MATLAB R2023b.
- Requires the MATLAB WLAN toolbox.
How to Run
- Navigate to
main.m, and modify the variablescenarioNameStrto match the name of your desired scenario folderscenarioFolderwithin.\examples. - Run
main.m
Documentation
Extensive documentation is provided in docs/isac-plm.pdf, detailing ISAC-PLM's architecture, functionalities, and usage guidelines.
Examples Provided
A collection of predefined examples demonstrating various configurations and scenarios is available in /src/examples/ .
The table below outlines the predefined examples along with their key configuration parameters:
| Example | Number of Rx | Streams/rx | Channel Model | Precoder | Packet | | :--- | :---: | :---: | :---: |:---: | :---: | | sisoOfdmAwgndata | 1 | 1 | AWGN | - | PSDU | | sisoScdata | 1 | 1 | Rayleigh | - | PSDU | | sisoOfdmdata| 1 | 1 | Rayleigh | - | PSDU | | sisoSc | 1 | 1 | Rayleigh | - | PPDU | | sisoOfdm | 1 | 1 | Rayleigh | - | PPDU | | mimoScdata | 1 | 2 | Rayleigh | RZF (Freq flat) | PSDU | | mimoOfdmdata| 1 | 2 | Rayleigh | RZF (Freq sel) | PSDU | | mimoSc | 1 | 2 | Rayleigh | RZF (Freq flat) | PPDU | | mimoOfdm | 1 | 2 | Rayleigh | RZF (Freq sel) | PPDU | | muMimoScdata | 2 | 2 | Rayleigh | ZF (Time domain) | PSDU | | muMimoOfdm_data | 2 | 2 | Rayleigh | RZF (Freq sel) | PSDU | | muMimoOfdm | 2 | 2 | Rayleigh | RZF (Freq sel) | PPDU | | pointTargetPassiveSensing | 1 | 1 | NIST QD | - | PPDU | | singleHumanTarget | 1 | 1 | NIST QD | - | PPDU | | pointTargetActiveSensing | 1 | 1 | NIST QD | - | TRN-R | | bistaticLivingRoomTRN-R| 1 | 1 | NIST QD | - | TRN-R | | bistaticLivingRoomTRN-T| 1 | 1 | NIST QD | - | TRN-T | | bistaticLivingRoomBeacon| 1 | 1 | NIST QD | - | Beacon | | thresholdSensing | 1 | 1 | NIST QD | - | PPDU | | vitalSignSensing | 1 | 1 | NIST Measurements | - | TRN-R |
References
- S. Blandino, et al, Low Overhead DMG Sensing for Vital Signs Detection, 2024 IEEE International Conference on Acoustics, Speech and Signal Processing (ICASSP).
- S. Blandino, T. Ropitault, C. R. C. M. da Silva, A. Sahoo and N. Golmie, IEEE 802.11bf DMG Sensing: Enabling High-Resolution mmWave Wi-Fi Sensing, 2023 IEEE Open Journal of Vehicular Technology.
- N. Varshney et al., Adaptive Channel-State-Information Feedback in Integrated Sensing and Communication Systems, 2023 IEEE Internet of Things Journal.
- J. Zhang, S. Blandino, N. Varshney, J. Wang, C. Gentile and N. Golmie, Multi-User MIMO Enabled Virtual Reality in IEEE 802.11ay WLAN, 2022 IEEE Wireless Communication and Networking Conference.
- S. Blandino, T.Ropitault, A. Sahoo and N. Golmie, Tools, Models and Dataset for IEEE 802.11ay CSI-based Sensing, 2022 IEEE Wireless Communication and Networking Conference.
IEEE 802.11bf contributions
- DMG/EDMG Link Level Simulation Platform
- Implementation of 60 GHz WLAN-SENS Physical Layer Model
- TGbf Channel Models for WLAN Sensing Systems
- TGbf Evaluation Methodology and Simulation Scenarios
Contributing
We welcome feedback and contributions! Please reach out to the repository administrator for collaboration or queries.
Contact information
Steve Blandino, NIST Communications Technology Laboratory, steve.blandino@nist.gov .
Credits
Special thanks to our contributors: - Steve Blandino - Neeraj Varshney - Jian Wang - Jiayi Zhang
Cite
If you use ISAC-PLM in your reseach, please see CITATION.cff and cite it as follows:
NIST Communications Technology Laboratory, Integrated Sensing and Communication Physical Layer Model (ISAC-PLM), https://github.com/wigig-tools/isac-plm.
License
Please refer to the NIST-License.md and MathWorks-Limited-License.md files in the license folder for more information.
Owner
- Name: WiGig Tools
- Login: wigig-tools
- Kind: organization
- Repositories: 2
- Profile: https://github.com/wigig-tools
A collection of open-source tools to simulate IEEE 802.11ad/ay WLAN networks in network simulator ns-3.
GitHub Events
Total
- Issues event: 4
- Watch event: 35
- Issue comment event: 1
- Fork event: 1
Last Year
- Issues event: 4
- Watch event: 35
- Issue comment event: 1
- Fork event: 1
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 2
- Total pull requests: 0
- Average time to close issues: 1 minute
- Average time to close pull requests: N/A
- Total issue authors: 1
- Total pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 2
- Pull requests: 0
- Average time to close issues: 1 minute
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- Xu665544 (2)