https://github.com/kkonradpl/antpatt
Antenna radiation pattern real-time plotting and analysis software
https://github.com/kkonradpl/antpatt
antenna antenna-pattern rf
Last synced: 8 months ago
JSON representation
Antenna radiation pattern real-time plotting and analysis software
- Host: GitHub
- URL: https://github.com/kkonradpl/antpatt
- Owner: kkonradpl
- License: gpl-2.0
- Created: 2019-03-16T10:21:02.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-12T17:35:21.000Z (over 1 year ago)
- Last Synced: 2025-01-30T21:35:32.401Z (over 1 year ago)
- Topics: antenna, antenna-pattern, rf
- Language: C
- Homepage:
- Size: 1000 KB
- Stars: 9
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
antpatt
=======
Antenna pattern plotting and analysis software.
Copyright (C) 2017-2024 Konrad Kosmatka
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
# Build
In order to build antpatt you will need:
- CMake
- C compiler
You will also need several dependencies:
- GTK+ 3 & dependencies
- GSL
- JSON-C
- zlib
Once you have all the necessary dependencies, you can use scripts available in the `build` directory.
For Windows builds (binaries), see the [Releases](https://github.com/kkonradpl/antpatt/releases) page. To enable dark theme on Windows, run `antpatt.exe` with `-d` command line parameter.
# Installing
After a successful build, just use:
```sh
$ sudo make install
```
in the `build` directory. This will install both the executable file `antpatt` and icons.
# Supported data formats
- Radiomobile – `ANT`
- MMANA-GAL – `CSV`
- Planet – `MSI`
- XDR-GTK (legacy) – `XDRP`
The whole project can be saved as `.antp.gz` file (compressed `.antp`) which is simply a JSON file with all settings included and data samples embedded. See `examples` directory.
# Data from MMANA-GAL
MMANA-GAL can export CSV files that antpatt accepts. Use the following settings in MMANA-GAL: File → Table of Angle/Gain (*.csv) dialog to export the CSV:
# Interactive console mode
Interactive console mode (`-i` command line option) can be used for data streaming from another application for real-time antenna radiation pattern plotting. Commands consist of a single word and are case insensitive:
- `START` – create new measurement
- `STOP` – close current measurement
- `PUSH ` – add signal level sample
- `NAME ` – set plot name
- `FREQ ` – set plot frequency [kHz]
- `COLOR ` – set plot color (#XXXXXX)
- `AVG ` – set plot moving-average
- `FILL ` – set plot fill
- `REV ` – set plot reverse mode
Antpatt will send the following responses:
- `READY` – after application startup
- `BYE` – before application exit
- `OK` – after a successful command
- `ERROR` – after an incorrect command