{"id":16513285,"url":"https://github.com/acconeer/acconeer-python-exploration","last_synced_at":"2025-05-15T11:01:42.712Z","repository":{"id":37458241,"uuid":"149458170","full_name":"acconeer/acconeer-python-exploration","owner":"acconeer","description":"Acconeer Exploration Tool","archived":false,"fork":false,"pushed_at":"2025-05-12T09:29:56.000Z","size":85675,"stargazers_count":187,"open_issues_count":0,"forks_count":66,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-05-12T10:43:43.276Z","etag":null,"topics":["a1","a111","a121","acconeer","evaluation","evaluation-kit","evk","pcr","pulsed","python","radar","raspberry-pi","sensor","xc112","xm112","xm122","xm132","xr112"],"latest_commit_sha":null,"homepage":"https://docs.acconeer.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/acconeer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-09-19T13:50:53.000Z","updated_at":"2025-05-12T09:29:55.000Z","dependencies_parsed_at":"2023-02-14T08:46:30.471Z","dependency_job_id":"e2b2a425-69d4-4e62-a0b6-1be5b6828203","html_url":"https://github.com/acconeer/acconeer-python-exploration","commit_stats":{"total_commits":3186,"total_committers":38,"mean_commits":83.84210526315789,"dds":0.6588198367859385,"last_synced_commit":"d844c727f36e2ffd76287e33f323dcf1dc5d534b"},"previous_names":[],"tags_count":119,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acconeer%2Facconeer-python-exploration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acconeer%2Facconeer-python-exploration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acconeer%2Facconeer-python-exploration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acconeer%2Facconeer-python-exploration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/acconeer","download_url":"https://codeload.github.com/acconeer/acconeer-python-exploration/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254328384,"owners_count":22052632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a1","a111","a121","acconeer","evaluation","evaluation-kit","evk","pcr","pulsed","python","radar","raspberry-pi","sensor","xc112","xm112","xm122","xm132","xr112"],"created_at":"2024-10-11T16:08:28.104Z","updated_at":"2025-05-15T11:01:37.513Z","avatar_url":"https://github.com/acconeer.png","language":"Python","readme":"# Acconeer Exploration Tool\n\n[![Supported Python versions](https://img.shields.io/pypi/pyversions/acconeer-exptool.svg?logo=python\u0026logoColor=FFE873)](https://pypi.org/project/acconeer-exptool/)\n[![PyPI version](https://img.shields.io/pypi/v/acconeer-exptool.svg?logo=pypi\u0026logoColor=FFE873)](https://pypi.org/project/acconeer-exptool/)\n[![PyPI downloads](https://img.shields.io/pypi/dm/acconeer-exptool.svg)](https://pypistats.org/packages/acconeer-exptool)\n\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Documentation Status](https://readthedocs.com/projects/acconeer-acconeer-python-exploration/badge/?version=latest)](https://docs.acconeer.com/en/latest/?badge=latest)\n\n_**Explore the Next Sense**_ with Acconeer Exploration Tool! Use one of our [evaluation kits](https://www.acconeer.com/products) together with our Python examples and start exploring the world of Acconeer's radar sensor technology. The Python scripts and the Application in this repository will help you to easily stream the radar sensor's data to your local machine to start radar sensor evaluation and/or algorithm development for your application.\n\nTo run the Python exploration scripts, you will need an [evaluation kit](https://www.acconeer.com/products) running the included Exploration or Module server, both of which are supplied with the [Acconeer SDK and Module SW](https://developer.acconeer.com/) image.\n\nThis release is developed for [Acconeer SDK and Module SW](https://developer.acconeer.com/)\n**A111-v2.15.4**\nand\n**A121-v1.10.0**.\nRunning this version is strongly recommended, as we continuously fix bugs and add features.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"The application in action\" src=\"https://raw.githubusercontent.com/acconeer/acconeer-python-exploration/8f633e02abac99ffec6fefec4339d13bc5c18388/docs/_static/gui.png\" width=85%\u003e\n\u003c/p\u003e\n\n## Quickstart for Windows\n\nThere is a portable version of the Acconeer Exploration Tool for Windows:\n\n* [Download](https://developer.acconeer.com/download/portable_exploration_tool/) the zip file and extract\n* Double click the `update.bat` file and wait for the installation to finish, which might take a couple of minutes\n* Double click the `run_app.bat`\n\nFor an in-depth evaluation, we recommend a full installation as described below.\n\n## Documentation\n\nDocumentation is available at [docs.acconeer.com](https://docs.acconeer.com),\nwhere you can also find the [FAQ](https://docs.acconeer.com/en/latest/exploration_tool/faq.html).\n\n## News\n\n* v7.4.0 released. See the [Changelog](https://docs.acconeer.com/en/latest/changelog.html).\n\n## Setting up your evaluation kit\n\n* [XM126](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/xm126.html)\n* [XM125](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/xm125.html)\n* [XC120 + XE121 (A121)](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/xc120_xe121.html)\n* [Raspberry Pi (A121 on XE121)](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/raspberry_a121_xe121.html)\n* [Raspberry Pi (A111 on XC111+XR111 or XC112+XR112)](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/raspberry_a111.html)\n* [XM112](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/xm112.html)\n* [XM122](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/xm122.html)\n* [XM132](https://docs.acconeer.com/en/latest/exploration_tool/evk_setup/xm132.html)\n\nFor additional resources, head over to the [Acconeer developer page](https://developer.acconeer.com/). There you will find both a getting started guide and a video showing you how to set up your evaluation kit. There you will also find the SDK download.\n\n## Setting up your local machine\n\n### Requirements\n\nPython 3.9 or newer. Older versions have limited or no support.\n\nTested on:\n\n* Python 3 (developed and tested on 3.9, 3.10, 3.11, 3.12 and 3.13)\n* Windows 10\n* Ubuntu 20.04\n\n### Setup\n\n#### Installing the `acconeer-exptool` package\n\nInstall from PyPI:\n```\npython -m pip install --upgrade acconeer-exptool[app]\n```\n\u003e *Depending on your environment, you might have to replace `python` with `python3` or `py`.*\n\nFor other options, have a look at\n[docs.acconeer.com](https://docs.acconeer.com/en/latest/exploration_tool/installation_and_setup.html).\n\n#### Windows COM port drivers\n\nIf no COM port is recognized when plugging in a module, you might need to install a driver.\nSee information about your specific module at\n[docs.acconeer.com](https://docs.acconeer.com/en/latest/exploration_tool/installation_and_setup.html#windows-setup)\n\n\n#### Linux setup\n\nAfter installing the `acconeer-exptool` package, you can run\n\n```\npython -m acconeer.exptool.setup\n```\n\u003e *Depending on your environment, you might have to replace `python` with `python3` or `py`.*\n\nwhich interactively configures your machine and downloads needed dependencies.\nThis is done in order for your machine to work at its best with Exploration tool.\n`acconeer.exptool.setup` performs the steps described in the\n[Linux setup section on docs.acconeer.com](https://docs.acconeer.com/en/latest/exploration_tool/installation_and_setup.html#linux-setup).\n\n\n## Application\n\nUsing the application is the easiest way to start exploring Acconeer's radar sensor and our application examples:\n```\npython -m acconeer.exptool.app\n```\n\u003e *Depending on your environment, you might have to replace `python` with `python3` or `py`.*\n\nIn the top right box of the application, named _Connection_, select the interface you wish to use\n- SPI: auto-detects an XM112 connected to USB2 (USB1 is also needed for power)\n- Socket: specify the IP address of your Raspberry Pi running the streaming server\n- Serial: specify the serial port that is assigned to the sensor\n\nConnections via *Serial* have the option of choosing a *Protocol*. The choices are\n**Module** and **Exploration**, where the protocol should match the server installed\non the module (*Module server* or *Exploration server*, respectively). Choosing the wrong\nprotocol will show an error.\n\nAfter pressing _Connect_, a connection should be established.\nIn the box below labelled _Scan controls_, select the service or processing example you want to test.\nNow you may tune the sensor and processing settings to your specific setup.\nOnce you press _Start measurement_, the application will start fetching data from the sensor and plotting the results.\nAfter pressing _Stop_, you can save (and later load data) or just replay the data stored in the buffer.\n\n### The ML interface *(no longer supported)*\n\nSupport for the Machine Learning interface in Exploration Tool has been dropped.\n\nIf you still need to use it, it is possible to use an old version of Exploration Tool.\n\nFrom the `acconeer-python-exploration` directory:\n\n```\ngit checkout v3\n```\n\nAnd follow the instructions in an old version of this document (`README.md`).\n\nNote that this version of Exploration Tool will not be actively supported. Compatibility with new\nRSS versions **is not guaranteed** .\n\n## Running an example script on your local machine\n\nIf you prefer using the command line for testing and evaluation of our examples you can use the following instructions.\n\nXC111+XR111 or XC112+XR112 (mounted on a Raspberry Pi):\n\n```\npython examples/a111/basic.py -s \u003cyour Raspberry Pi IP address\u003e\n```\n\nXM112+XB112 via SPI over USB:\n\n```\npython examples/a111/basic.py -spi\n```\n\nAny module via UART over USB, attempting to auto-detect the serial port:\n\n```\npython examples/a111/basic.py -u\n```\n\nAny module via UART over USB, using a specific serial port:\n\n```\npython examples/a111/basic.py -u \u003cthe serial port, for example COM3\u003e\n```\n\n\u003e *Depending on your environment, you might have to replace `python` with `python3` or `py`.*\n\nChoosing which sensor(s) to be used can be done by adding the argument `--sensor \u003cid 1\u003e [id 2] ...`. The default is the sensor on port 1. This is not applicable for the modules.\n\nScripts can be terminated by pressing Ctrl-C in the terminal.\n\n## Disclaimer\n\nHere you find the [disclaimer](https://docs.acconeer.com/en/latest/disclaimer.html).\n\n## FAQ and common issues\n\nSee the [FAQ at docs.acconeer.com](https://docs.acconeer.com/en/latest/exploration_tool/faq.html).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facconeer%2Facconeer-python-exploration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facconeer%2Facconeer-python-exploration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facconeer%2Facconeer-python-exploration/lists"}