isac-plm

Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.

https://github.com/wigig-tools/isac-plm

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

mmwave mmwave-communication mmwave-radar sensing wireless wlan
Last synced: 6 months ago · JSON representation

Repository

Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.

Basic Info
  • Host: GitHub
  • Owner: wigig-tools
  • Language: MATLAB
  • Default Branch: main
  • Homepage:
  • Size: 149 MB
Statistics
  • Stars: 104
  • Watchers: 10
  • Forks: 25
  • Open Issues: 0
  • Releases: 0
Topics
mmwave mmwave-communication mmwave-radar sensing wireless wlan
Created over 4 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License Citation

README.md

Integrated Sensing and Communication Physical Layer Model (ISAC-PLM)

Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.

drawing

drawing

Table of Contents

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 variable scenarioNameStr to match the name of your desired scenario folder scenarioFolder within .\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

IEEE 802.11bf contributions

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

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)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels