# mmWrt
minimal raytracing for MIMO FMCW radar systems.
Intended usage:
1. educational
## Release Notes and Roadmap
### Released
v0.0.3: first release
* point targets only
* 1D compute of baseband if signal for scene
* 1D FFT, CFAR, peak grouping and target position error compute
* single reflections
v0.0.4:
* adding frequency estimator
* added speed processing
* added support for radar equation (RCS, distance, ...)
* antenna gains in azimumth, elevation and freq
### NEXT ()
* 2D (AoA)
* 2D FFT: range+velocity, range+AoA
* 2D peak grouping (by velocity sign)
* 3D position error compute
* 3D targets (at least spheres)
* medium attenuation
* 3D point clouds (i.e. over multiple CTI)
* multiple single reflections
Not planned yet but considered:
* reads and loads .bin
* record BB signals in .bin
* 3D targets and scene rendering with imaging side by side radar
* Swerling's scattering
## Example Code
Check on Google Colab the code:
[](https://colab.research.google.com/gist/matt-chv/bdd8b835c5cb7e739bb8b68d00257690/fmcw-radar-101.ipynb)
Or Read the Docs on [](https://mmwrt.readthedocs.io/en/latest/Intro.html)
## Release process
1. run pyroma
(should be 10/10)
> pyroma .
2. run flake8
runs with darglint settings for docstrings to numpy standard set in the .flake8 file
should yield 0 warnings or errors
> flake8
3. run pytest
should yield 100% pass
> pytest
4. run coverage
> coverage run -m pytest
5. run coverage report
(should be 100%)
> coverage report
6. run tox
7.run sphinx-api
`updates the *.rst in docs/ folder`
> sphinx-apidoc -f -o docs mmWrt
8. run sphinx-build
(updates the read_the_docs folder)
> sphinx-build -b html docs build/html
9. release to pypi-test
> python setup.py bdist_wheel
> twine upload -r testpypi dist\*
10. update on read_the_docs
11. check on Google Colab
(Google Colab requires py3.8 as off 2023-Jan-15)
11.a. if testing release-candidate need to spell out or will install latest stable version
```
!pip install -i https://test.pypi.org/simple/ mmWrt==0.0.5rc3
from mmWrt import __version__
print(__version__)
```
12. release on pypi
> twine upload -r pypi dist\*
Raw data
{
"_id": null,
"home_page": "https://github.com/matt-chv/mmWrt",
"name": "mmWrt",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "radar MIMO FMCW raytracing",
"author": "matt-chv",
"author_email": "contact@matthieuchevrier.com",
"download_url": "",
"platform": null,
"description": "# mmWrt\r\n\r\nminimal raytracing for MIMO FMCW radar systems.\r\n\r\nIntended usage:\r\n1. educational\r\n\r\n## Release Notes and Roadmap\r\n\r\n### Released\r\n\r\nv0.0.3: first release \r\n\r\n * point targets only\r\n * 1D compute of baseband if signal for scene\r\n * 1D FFT, CFAR, peak grouping and target position error compute\r\n * single reflections\r\n\r\nv0.0.4:\r\n\r\n * adding frequency estimator\r\n * added speed processing\r\n * added support for radar equation (RCS, distance, ...)\r\n * antenna gains in azimumth, elevation and freq\r\n\r\n### NEXT ()\r\n\r\n * 2D (AoA)\r\n * 2D FFT: range+velocity, range+AoA\r\n * 2D peak grouping (by velocity sign)\r\n * 3D position error compute\r\n * 3D targets (at least spheres)\r\n * medium attenuation\r\n * 3D point clouds (i.e. over multiple CTI)\r\n * multiple single reflections\r\n\r\nNot planned yet but considered:\r\n\r\n* reads and loads .bin\r\n * record BB signals in .bin\r\n * 3D targets and scene rendering with imaging side by side radar\r\n * Swerling's scattering\r\n\r\n## Example Code\r\n\r\nCheck on Google Colab the code:\r\n\r\n[](https://colab.research.google.com/gist/matt-chv/bdd8b835c5cb7e739bb8b68d00257690/fmcw-radar-101.ipynb)\r\n\r\nOr Read the Docs on [](https://mmwrt.readthedocs.io/en/latest/Intro.html)\r\n\r\n## Release process\r\n\r\n1. run pyroma\r\n(should be 10/10)\r\n\r\n> pyroma .\r\n\r\n2. run flake8 \r\nruns with darglint settings for docstrings to numpy standard set in the .flake8 file\r\nshould yield 0 warnings or errors\r\n\r\n> flake8\r\n\r\n3. run pytest\r\nshould yield 100% pass\r\n\r\n> pytest\r\n\r\n4. run coverage\r\n\r\n> coverage run -m pytest\r\n\r\n5. run coverage report\r\n(should be 100%)\r\n\r\n> coverage report\r\n\r\n6. run tox\r\n\r\n7.run sphinx-api \r\n`updates the *.rst in docs/ folder`\r\n\r\n> sphinx-apidoc -f -o docs mmWrt\r\n\r\n8. run sphinx-build\r\n(updates the read_the_docs folder)\r\n\r\n> sphinx-build -b html docs build/html\r\n\r\n9. release to pypi-test\r\n\r\n> python setup.py bdist_wheel\r\n\r\n> twine upload -r testpypi dist\\*\r\n\r\n10. update on read_the_docs\r\n\r\n\r\n\r\n11. check on Google Colab\r\n(Google Colab requires py3.8 as off 2023-Jan-15)\r\n\r\n11.a. if testing release-candidate need to spell out or will install latest stable version\r\n\r\n```\r\n!pip install -i https://test.pypi.org/simple/ mmWrt==0.0.5rc3\r\nfrom mmWrt import __version__\r\nprint(__version__)\r\n```\r\n\r\n12. release on pypi\r\n> twine upload -r pypi dist\\*\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "LICENSE",
"summary": "minimal raytracing code example for MIMO FMCW radar",
"version": "0.0.5",
"project_urls": {
"Bug Tracker": "https://github.com/matt-chv/mmWrt/issues",
"Homepage": "https://github.com/matt-chv/mmWrt"
},
"split_keywords": [
"radar",
"mimo",
"fmcw",
"raytracing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6360c19c4f1fe38fd60120b5eb2e47c31ca05f8fb83c4cd48d459810cabd13ba",
"md5": "4a650f80a1e433393f98799df0bd0f55",
"sha256": "a8e5be99c1e714b24f07020ddf48a8dcdd7e303a6ad94a04e5cbd4e58c1c88fd"
},
"downloads": -1,
"filename": "mmWrt-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4a650f80a1e433393f98799df0bd0f55",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 12254,
"upload_time": "2023-12-28T13:17:07",
"upload_time_iso_8601": "2023-12-28T13:17:07.637201Z",
"url": "https://files.pythonhosted.org/packages/63/60/c19c4f1fe38fd60120b5eb2e47c31ca05f8fb83c4cd48d459810cabd13ba/mmWrt-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-28 13:17:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "matt-chv",
"github_project": "mmWrt",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"tox": true,
"lcname": "mmwrt"
}
JSON
