From 4855b232d8f9ed4b9a2fe9224234ac8a5d1d0b23 Mon Sep 17 00:00:00 2001 From: Marco Dalla Tiezza Date: Sat, 31 Aug 2019 21:00:31 +0200 Subject: [PATCH 1/3] ACF Update --- README.md | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 5e210c9..c8d2993 100644 --- a/README.md +++ b/README.md @@ -66,7 +66,7 @@ The database (db.csv) is directly extracted from sigidwiki.com with a DB parser | 9 | Description | - | - | string | | 10 | Modulation | - | ✔ | string | | 11 | ID Code | - | - | integer | -| 12 | Auto-correlation function | ms | - | string | +| 12 | Auto-correlation function | ms | ✔ | string | ### Syntax @@ -99,17 +99,33 @@ The database (db.csv) is directly extracted from sigidwiki.com with a DB parser |:-:|:-:|:-:|:-:|:-:|:-:|:-:| | Trunked | Utility | Sat | Navigation | Interfering | Number Stations | Time Signal | -12. **Auto-correlation funtion (ACF)**: The ACF is an awesome discriminator when the signal is composed of redundant pattern that continouosly repeats. It is reported in **ms**. An extended description with an example signal analysis is available here: https://aresvalley.com/documentation/ +12. **Auto-correlation funtion (ACF)**: The ACF is an awesome discriminator when the signal is composed of redundant pattern that continouosly repeats. Unfortunately, for this reason, ACF is not always available. The time value is reported in **ms** and, in some cases, could have multiple values for a single signal. An extended description with an example signal analysis is available here: https://aresvalley.com/documentation/ + + +``` +... ID Code * ACF1 Value (in ms) - ACF1 Description ; ACF2 Value (in ms) - ACF2 Description ; ... +``` + +**Example 1 (D-STAR):** + +``` +... ID Code * 420 - Superframe ; 20 - Frame +``` +**Example 2 (EDACS):** + +``` +... ID Code * 60 - edacs48 ; 30 - edacs96 +``` ### Multiple Items fields (Location, Modulation) The necessity to manage a multiple Location/Modulation search pushed us to implement a fictitious 'secondary delimiter' chosen to be the `;` character. For instance: ``` -Band. Upper Limit * Location 1 ; Location 2 ; ... * sigidwiki URL +... Band. Upper Limit * Location 1 ; Location 2 ; ... * sigidwiki URL ... ``` or ``` -Description * Modulation 1 ; Modulation 2 ; ... * ID Code +... Description * Modulation 1 ; Modulation 2 ; ... * ID Code ... ``` ## Themes From d37c8e96d683c10b03cbecbea2e74de03b4a9eb0 Mon Sep 17 00:00:00 2001 From: Marco Dalla Tiezza Date: Sat, 31 Aug 2019 21:17:35 +0200 Subject: [PATCH 2/3] Updated thanks --- README.md | 6 +++--- spec_files/README.md | 6 +++--- unused_installation_scripts/README.md | 6 +++--- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index c8d2993..69a6649 100644 --- a/README.md +++ b/README.md @@ -145,6 +145,6 @@ You should have received a copy of the GNU General Public License along with thi * [**Alessandro Ceccato**](https://github.com/alessandro90 "GitHub profile") - *Artemis III lead developer* * **Paolo Romani (IZ1MLL)** - *Lead β Tester, RF specialist* * **Carl Colena** - *Sigidwiki admin, β Tester, Signals expert* -* **Marco Bortoli** - *macOS deployment, β Tester* -* **Pierpaolo Pravatto** - *Wiki page, β Tester* -* **Francesco Capostagno, Luca, Pietro** - *β Tester* +* [**Marco Bortoli**](https://github.com/marbort "GitHub profile") - *macOS deployment, β Tester* +* [**Pierpaolo Pravatto**](https://github.com/ppravatto "GitHub profile") - *Wiki page, β Tester* +* [**Francesco Capostagno**](https://github.com/fcapostagno "GitHub profile"), **Luca**, **Pietro** - *β Tester* diff --git a/spec_files/README.md b/spec_files/README.md index 0cb2564..aa018f3 100644 --- a/spec_files/README.md +++ b/spec_files/README.md @@ -46,6 +46,6 @@ You should have received a copy of the GNU General Public License along with thi * [**Alessandro Ceccato**](https://github.com/alessandro90 "GitHub profile") - *Artemis III lead developer* * **Paolo Romani (IZ1MLL)** - *Lead β Tester, RF specialist* * **Carl Colena** - *Sigidwiki admin, β Tester, Signals expert* -* **Marco Bortoli** - *macOS deployment, β Tester* -* **Pierpaolo Pravatto** - *Wiki page, β Tester* -* **Francesco Capostagno, Luca, Pietro** - *β Tester* +* [**Marco Bortoli**](https://github.com/marbort "GitHub profile") - *macOS deployment, β Tester* +* [**Pierpaolo Pravatto**](https://github.com/ppravatto "GitHub profile") - *Wiki page, β Tester* +* [**Francesco Capostagno**](https://github.com/fcapostagno "GitHub profile"), **Luca**, **Pietro** - *β Tester* diff --git a/unused_installation_scripts/README.md b/unused_installation_scripts/README.md index 0c598f6..3bf9e30 100644 --- a/unused_installation_scripts/README.md +++ b/unused_installation_scripts/README.md @@ -73,6 +73,6 @@ You should have received a copy of the GNU General Public License along with thi * [**Alessandro Ceccato**](https://github.com/alessandro90 "GitHub profile") - *Artemis III lead developer* * **Paolo Romani (IZ1MLL)** - *Lead β Tester, RF specialist* * **Carl Colena** - *Sigidwiki admin, β Tester, Signals expert* -* **Marco Bortoli** - *macOS deployment, β Tester* -* **Pierpaolo Pravatto** - *Wiki page, β Tester* -* **Francesco Capostagno, Luca, Pietro** - *β Tester* +* [**Marco Bortoli**](https://github.com/marbort "GitHub profile") - *macOS deployment, β Tester* +* [**Pierpaolo Pravatto**](https://github.com/ppravatto "GitHub profile") - *Wiki page, β Tester* +* [**Francesco Capostagno**](https://github.com/fcapostagno "GitHub profile"), **Luca**, **Pietro** - *β Tester* From d30a9b7aa9cae9659a5d1e849a99929f3f7557aa Mon Sep 17 00:00:00 2001 From: Marco Dalla Tiezza Date: Mon, 2 Sep 2019 00:17:32 +0200 Subject: [PATCH 3/3] GLIBC minimum requirements, ACF details on variable values --- README.md | 13 +++++++++++-- spec_files/README.md | 2 ++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 69a6649..ca8cdd2 100644 --- a/README.md +++ b/README.md @@ -28,10 +28,17 @@ Artemis 3 is entirely written in Python, so if you already have Python 3.7.0+ in **If you don't know what you want or you are not sure where to look, this is for you.** Basically, this is the easiest, smooth, and clean way to run Artemis 3. A Python installation is not required. -For more information, follow [the main page of Artemis 3](https://aresvalley.com/artemis/) (detailed documentation at the end of the main page) +For more information, follow [the main page of Artemis 3](https://aresvalley.com/artemis/) (detailed documentation at the end of the main page). + +**Requirements:** +- Windows 7/8/8.1/10 +- Linux: Ubuntu 16.04+, Mint 18+, Fedora 24+ and many other. **You need at least version 2.23 of the GLIBC system library** ([details](https://github.com/AresValley/Artemis/tree/master/spec_files)) +- macOS ### Run from source code -Run the software from the source code with the Python interpreter is the simplest and natural way to run Artemis 3. Requirements: +Run the software from the source code with the Python interpreter is the simplest and natural way to run Artemis 3. + +**Requirements:** - Python (ver. 3.7.0+) - Python libraries (in `requirements/requirements.txt`) @@ -117,6 +124,8 @@ The database (db.csv) is directly extracted from sigidwiki.com with a DB parser ... ID Code * 60 - edacs48 ; 30 - edacs96 ``` +**Special case:** variable ACFs are allowed and a brief explanation can be reported instead of ACF Value. A nice example is the * [SSTV](https://www.sigidwiki.com/wiki/Slow-Scan_Television_(SSTV) "SSTV") transmission where the ACF is directly related to the number of lines per minute. + ### Multiple Items fields (Location, Modulation) The necessity to manage a multiple Location/Modulation search pushed us to implement a fictitious 'secondary delimiter' chosen to be the `;` character. For instance: diff --git a/spec_files/README.md b/spec_files/README.md index aa018f3..619f87b 100644 --- a/spec_files/README.md +++ b/spec_files/README.md @@ -14,6 +14,8 @@ Artemis 3 .spec files are used by the package **pyinstaller** (https://www.pyins **IMPORTANT:** *To generate the standalone and the one-dir package, you must use an operating system that coincides with the target one (pyinstaller doesn't allow cross-compilation).* +**IMPORTANT (LINUX COMPILING):** *The executable that PyInstaller builds is not fully static, in that it still depends on the system libc. **Under Linux, the ABI of GLIBC is backward compatible, but not forward compatible. So if you link against a newer GLIBC, you can't run the resulting executable on an older system**. The supplied binary bootloader should work with older GLIBC. However, the libpython.so and other dynamic libraries still depend on the newer GLIBC. The solution is to compile the Python interpreter with its modules (and also probably bootloader) on the oldest system you have around so that it gets linked with the oldest version of GLIBC.* (Source: PyInstaller) + ## Package Building (standalone aka one-file, high portability, **suggested**) 1. Download a fresh copy of the git repository. 2. Choose the target OS in `spec_files` folder and copy the whole content (except the Artemis_onedir.spec file) into `src`