RML21 Dataset

Dataset generation code for modulation classification

Instructions to run the code.

1. Copy the files to a folder.
2. Copy the analog source .wav file from this link
3. Create a folder named "source_material" and push the file audio_source.wav to this folder.
4. $python Datasetgeneration_Fast.py generates four types of datasets for the following SNR and modulation types. 1000 frames are generated per modulation per SNR.
5. The four types of datasets are clean(no artifacts), with thermal noise only (AWGN), with thermal noise and clock effects(SRO/CFO) and the final one includes fading on top of all other artifacts.

Instructions to install GNURadio module and out-of-tree GR-MAPPER module. 🤠

1. conda create --name gnuradio
2. conda activate gnuradio
3. conda install -c conda-forge gnuradio=3.8.3
4. conda install -c conda-forge scipy
5. conda install -c conda-forge matplotlib
6. git clone https://github.com/myersw12/gr-mapper.git
7. cd gr-mapper && mkdir build && cd build
8. chmod -R 777 ../../
9. conda install -c conda-forge gnuradio-build-deps
10. conda activate $CONDA_DEFAULT_ENV
11. conda install -c conda-forge cppunit
12. cmake -G Ninja -DCMAKE_INSTALL_PREFIX=$CONDA_PREFIX -DCMAKE_PREFIX_PATH=$CONDA_PREFIX -DLIB_SUFFIX="" ..
13. cmake --build .
14. cmake --build . --target install

List of potential issues. 😕

1. Gr-mapper may or may not work with GNURadio 3.9 See details in link
2. The cmake instructions in this link does not work. Please do not use them. Please follow instructions given above which were taken from CondaInstall.
3. Any issues with cmake: good link to check out is this link "ryanvolz" user on github seems to respond to related queries.
4. If you are getting solving environment error, then do the following "conda config --set channel_priority false". This can help resolve the issue. link
5. If you encounter errors such as gr::vmcircbuf_sysv_shm: shmget (2): No space left on device, you might want to run the program only from command line and not an IDE. We have noticed issues such as low memory allocation when using an IDE that causes this issue. You can also potentially fix the issue by following instrucitons in this link